imta chbuild

The imta chbuild command compiles the character set conversion tables and loads the resulting image file into shared memory. The IMTA ships with complete character set tables so you would not normally need to run this command.


Syntax

 
imta chbuild options
 

The options for this command are:

-image_file=file-spec
-noimage_file  

By default, imta chbuild creates as output the image file named by the IMTA_CHARSET_DATA option of the IMTA tailor file, /etc/opt/SUNWmail/imta/imta_tailor. With the -image_file option, an alternate file name may be specified. When the -noimage_file option is specified, imta chbuild does not produce an output image file. This qualifier is used in conjunction with the -option_file option to produce as output an option file that specifies table sizes adequate to hold the tables required by the processed input files.  

-maximum
-nomaximum  

The file /etc/opt/SUNWmail/imta/maximum_charset.dat is read in addition to the file named by the IMTA_CHARSET_OPTION_FILE option of the IMTA tailor file, /etc/opt/SUNWmail/imta/imta_tailor, when -maximum is specified. This file specifies near-maximum table sizes but does not change any other file parameter settings. Use this option only if the current table sizes are inadequate.

The -noimage and -option_file options should always be used in conjunction with this option--it makes no sense to output the enormous configuration that is produced by -maximum, but it does make sense to use -maximum to get past size restrictions in order to build a properly sized option file for use in building a manageable configuration with a subsequent imta chbuild invocation.  

-option_file=file-spec
-nooption_file  

imta chbuild can produce an option file that contains the correct table sizes to hold the conversion tables that were just compiled (plus a little room for growth). The -option_file option causes this file to be output. By default, this file is the file named by the IMTA_CHARSET_OPTION_FILE option of the IMTA tailor file, /etc/opt/SUNWmail/imta/imta_tailor.

The value of the -option_file option may be used to specify an alternate file name. If the -nooption_file option is given, then no option file is output. imta chbuild always reads any option file (for example, the file named by the IMTA_OPTION_FILE option of the IMTA tailor file) that is already present; use of this option does not alter this behavior.

However, use of the -maximum option causes imta chbuild to read options from maximum_charset.dat in addition to IMTA_CHARSET_OPTION_FILE. This file specifies near-maximum table sizes. Use this option only if the current table sizes are inadequate, and only use it to create a new option file. The -noimage_file option should always be specified with -maximum, since a maximum-size image would be enormous and inefficient.  

-remove  

Remove any existing compiled character set conversion table, for example, the file named by the IMTA_CHARSET_DATA option of the IMTA tailor file, /etc/opt/SUNWmail/imta/imta_tailor.  

-sizes
-nosizes  

The -sizes option instructs imta chbuild to output or suppress information on the sizes of the uncompiled conversion tables.  

-statistics
-nostatistics  

The -statistics option instructs imta chbuild to output or suppress 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 -option_file option is needed.  


Example

The standard command you use to compile character set conversion tables is:

 
% imta chbuild
 




Copyright © 1999 Sun Microsystems, Inc. All Rights Reserved.