messagetoken

messagetoken - Generating 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

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 messages
$ messagetoken --help

Available Options

Options for Email Addresses

-a, --addresser Sender's Email Address
Specify a sender's email address. It is case insensitve and always required.
-r, --recipient Recipient's Email Address
Specify a recipients's email address. It is case insensitve and always required.

Other Options

-C, --conf /path/to/configuration 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 (Beginning with ver.2.1.0)
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 -

No TrackBacks

TrackBack URL: http://bouncehammer.jp/cgi-bin/mt/mt-tb.cgi/107

Leave a comment