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.

Commercial Support

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

10. Create available-countries file


Configuration file for classifying domains and Definition of special MTAs

Configuration file available-countries is for classifying famous domains which are mainly used other country, and for definition of special MTAs. This configuration file will give the following features.

Control the classification of famous domains in other countries
It controls the classification of famous domains (e.g. and in Russia, and in Japan) which are used in other country.

For example, @MAIL.RU is the most famous free mail service in Russia, but it would not be famous like Gmail, Hotmail, and Yahoo! in other countries. The configuration file is for controlling classification of domains in other countries.
Define special MTAs
When you implement a perl module for special MTA (not famous MTA or service) which is not widely used in the world, The configuration file controls that whether mailboxparser command uses the module or not. In bounceHammer, The special MTA means the MTA which send the bounce message as a unknown format (bounceHammer's parser can not parse it).

Create and Edit available-countries

bounceHammer will work properly if this configuration file does not exist.

Configuration file available-coiuntries is a YAML formated file like other ones. Note that If there is any syntax error in the configuration file, bounceHammer will not work properly.

# cd /usr/local/bouncehammer/etc
# /bin/cp available-countries-example available-countries

How to configure available-domains


Key name Available values Note
webmail 0 or 1 Load Kanadzuchi::Mail::Group::2-char country code::WebMail
smartphone 0 or 1 Load Kanadzuchi::Mail::Group::2-char country code::Smartphone
cellphone 0 or 1 Load Kanadzuchi::Mail::Group::2-char country code::Cellphone
agents MTA name Load Kanadzuchi::MTA::2-char country code::MTA name

There are some keys in each key which is defined as 2-char country code such as JP=Japan, UK=United Kingdom. The values: 0 = Dont load, 1 = Load are available at these keys (webmail, smartphone, cellphone).

If you set the value 0 to these keys, The Hostgroup is set to various, and the provider is set to various in the parsed data which created by mailboxparser command.

Definition of special MTAs

The key name agents is for definition of special MTAs which send an unknown formatted bounce message (bounceHammer cannot parse it). The value is written as a YAML array. Listed MTAs will be loaded from bounceHammer as Kanadzuchi::MTA::2-char country code::MTA's name.

In the default settings of this file, aubyKDDI (Japanese cellular phone company) has been defined, bounceHammer will load INSTALL-DESTINATION/lib/Kanadzuchi/MTA/JP/ Module.

For Example, When you developed a module for your own MTA, and you installed the module into INSTALL-DESTINATION/lib/Kanadzuchi/MTA/UK/, bounceHammer load the module by the following settings.

  'cellphone': 1
  'smartphone': 1
  'webmail': 1
  'agents': [ 'aubyKDDI', 'OurMTA' ]

Next, proceed to Prepare WebUI page for setting up WebUI (browser based control panel).