bounceHammer has been EOL'ed on February 29, 2016

EOL on February 29, 2016

bounceHammer have been downloaded and used by many users and companies since the first release on March 2010 and has been EOL: End Of Life on February 29, 2016. Thanks for using bounceHammer for a long time. We are now providing Sisimai (the successor of bounceHammer, more faster, more higher precision of analysis) as a bounce mail parser library in BSD 2-Clause License.

Sisimai
Commercial Support

  • 1Setting Up Sisimai Your Server
  • 2Support developmenet using Sisimai
  • 3Support via Email
  • 4Support bounce management
  • 5Parsing your bounced emails

messagetoken/Generate Message Token

 

messagetoken - Generating a message token

messagetoken commnad of bounceHammer is for generating a messsage token.

The message token is a unique string (MD5 hash value) which is created from an Addresser (a sender's email address) and a Recipient (a recipient's email address), is an identifier of each record in a database.

This command has been installed in INSTALL-DESTINATION/bin directory.

Usage of this command

messagetoken command take 2 arguments: an Addresser (a sender's email address) and a Recipient (a recipient email address).

Generate a message token
$ messagetoken -a sender@example.jp -r recipient@example.org
75cda805dc105761e8db23305d845075
 
Show help message
$ messagetoken --help

Available Options

Options for Email Addresses

-a, --addresser SENDER-EMAIL-ADDRESS
Specify a sender's email address. It is case insensitve and always required.
-r, --recipient RECIPIENT-EMAIL-ADDRESS
Specify a recipients's email address. It is case insensitve and always required.

Other Options

-C, --conf CONFIG-FILE
Use an alternative bounceHammer's configuration file. If this option is omitted, the command will use INSTALL-DESTINATION/etc/bouncehammer.cf.
-T, --test
Runs as test mode. This option is equals to the option -C INSTALL-DESTINATION/etc/test-run.cf.
--silent
Turn silent mode on. This option makes the command quiet in spite of -v, --verbose option (described later). And when the command is called from a daemon (such as sendmail), the command will exit with status 0 in spite of an error. If an MTA process (e.g. /usr/sbin/sendmail) which is called the command without this --silent option stopped by an error, the command will exit with status 75(EX_TEMPFAIL).
-v, --verbose
Turn verbose mode ON.
--help
Display help messages of this command.
--version
Display the version number of this command.

Screenshot of the running command

messagetoken -vvvvv -a postmaster@example.jp -r user@example.com

The following screenshot shows that the command generates a message token from the Addresser(sender's): postmaster@example.jp and Recipient: user@example.com .

Alternatives

You will get the same message token string by using the printf program without using messagetoken command.

The format of a source string of bounceHammer's message token is the following:
STX(Start of Text) Addresser(Sender's email address) RS(Record Separator) Recipient(recipient email address) ETX(End of Text)

The message token is a MD5 hash value which created from the earlier text (All characters are written in lower case).

Use the md5sum program if the md5 program is not in your system.

$ printf '\x02%s\x1e%s\x03' sender@example.jp recipient@example.org | \
> tr '[A-Z]' '[a-z]' | md5
75cda805dc105761e8db23305d845075 -