Chbuild utility

Compile the MTA character set conversion tables, and  file.

Syntax
imsimta chbuild

Restrictions
Must have superuser privileges, or be logged in as the MTA user (see the  option in  )  in order to use this utility.

Parameters
None.

Description
The  utility compiles the character set  conversion tables and loads the resulting image file into shared memory. As of MS 7.0.5,   is also the means for  informing the MTA of an  updated   file---the new  file used as of MS 7.0.5 to store the IANA list of Top Level Domains.

The MTA ships with very complete character set tables so prior to MS 7.0.5, it was not normally necessary to run this utility. However, as of MS 7.0.5,   should be used whenever an updated    file has been fetched from IANA. (Note that to get updates to   to take effect, it is not  necessary to also do    after the   ---but it is necessary that  processes be new in order to see the newly compiled charset/TLD data.  So if in a hurry for the changes to take effect, issue an     command.)

Prior to MS 7.0.5, two MTA Tailor options were relevant for :    specified the default output image file, and   specified an option file adjusting charset internal table sizes. As of MS 7.0.5, these MTA Tailor options have been deleted, and hard-coded file paths are used instead, config-root and server-root, where server-root is the product install directory or the value of the   environment variable.

&#x5b; &#x5d;,
By default,  creates as output the image  file (formerly named by the    option of the  MTA tailor file)  CONFIGROOT. With the  switch, an alternate  file name may be specified. When the   switch is specified,   does not produce  an output image file; this switch is used in conjunction with the    switch to produce as output an option file  which specifies table sizes adequate to hold the tables required by the  processed input files.

,  (default)
When  is  specified, the file  SERVERROOT  is read, in addition to the charset option file (prior to MS 7.0.5 located via the   MTA Tailor option) CONFIGROOT. This  file specifies near maximum table sizes but does not  change any other charset option file  parameter settings. Only use the  switch if the current table sizes are inadequate. The   and   switches  should always be used in conjunction with this switch -- it makes no  sense to actually output the enormous configuration that is produced by  , but it does make sense to use    to get past size restrictions in order to build an updated  charset option file  containing proper size settings  so that a properly sized character set image  can be built with a subsequent   invocation.

&#x5b; &#x5d;,   (default)
can optionally produce a charset option file that contains correct table sizes to hold the character set conversion  tables which were just compiled (plus a little room for growth). The   switch causes this file to be output, whereas use of the    switch means that no option file  will be output. Note that   always reads any pre-existing charset option file  (first looking for CONFIGROOT, then CONFIGROOT , then finally SERVERROOT  -- or prior to MS 7.0.5, looking for the file named by the    MTA Tailor option)  -- use of the   switch does not affect reading the old charset option file -- however, specifying   causes    to also output an updated charset option file. By default, the output charset option file is updated to the same location where the utility found the input charset option file. The value on the   switch may be used to specify an alternate file name.

While the MTA ships with an initial SERVERROOT, it is recommended that  any site-generated   file instead be written to CONFIGROOT  (or at least to CONFIGROOT .  Thus the first time a site wishes to generate their own, modified  , the administrator should start by copying the distributed, initial   from the SERVERROOT  directory to the CONFIGROOT  directory.

The  switch may be used in conjunction with   to  cause   to read options from    in  addition to the charset option file. This  file specifies near maximum table sizes. Only use the   switch if the current table sizes are  quite inadequate, and only use it to create a new charset option file. The   switch should always be specified when    is specified since a maximum-size image would be  truly enormous and extremely wasteful.

Remove any existant compiled character set conversion table; i.e., remove the file   (prior to MS 7.0.5 located via the    MTA Tailor  option) CONFIGROOT.

,  (default)
The  switch instructs   to output information on the sizes of the uncompiled  character set tables.

,  (default)
The  switch instructs   to output information on the compiled conversion tables. These numbers give a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with  the   switch is needed.

Examples
The standard command used on UNIX to compile character set conversion tables is: Or if a drastically increased set of Top Level Domains (  file) or drastically increased set of character sets calls for a big increase in the size of the compiled charset set tables, then:
 * 1) imsimta chbuild
 * 1) # If a site has never before generated their own option_charset.dat,
 * 2) #    first copy the distributed option_charset.dat to the site&#x27;s config area
 * 3) cp SERVERROOT/lib/option_charset.dat CONFIGROOT/advanced/option_charset.dat
 * 4) # Now have the chbuild utility figure out what it needs to resize...
 * 5) imsimta chbuild -noimage -option_file -maximum
 * 6) # Finally, build new compiled charset tables...
 * 7) imsimta chbuild

See also:
 * imta_charset_option_file MTA Option
 * TLD comparison rewrites
 * MTA command line utilities