configmail(1M)

NAME
     configmail - sendmail autoconfiguration script

SYNOPSIS
     /usr/etc/configmail mode [ parameter ]

DESCRIPTION
     configmail is the historic interface to modifying parameters used in the
     sendmail.cf sendmail.cf file shipped with IRIX to obtain information
     about the local mail environment.  configmail can also be executed by the
     user to display and/or modify that information.

     configmail is no longer the primary way to configure the sendmail.cf
     file.   The correct way is to modify the sendmail.mc file.  configmail
     can be used to generate a new sendmail.cf from the information and
     settings in the sendmail.mc file.

     configmail can be run in one of several modes.  The modes help, get, set,
     unset, and percpu take an additional parameter argument.  The remaining
     modes, list , mc2cf, m4 , and setup, take no additional parameter
     argument.

     The parameter argument can be one of:

     forwarder      The name of the forwarder host.

     rootdomain     The common domain suffix of all domains to be considered
                    local.

     directdomains  The names of all domains for which this host is a relay or
                    exchanger host.

     localdomain    The name of the local domain.

     loglevel       The sendmail Loglevel.  Defaults to 1.

     pathalias      The location of the UUCP path-alias database.

     relayname      The hostname or alias used for all relay hosts.

     recsubdomains  Recognized subdomains.  This parameter only has effect
                    when the Gauntlet for IRIX product is installed on the
                    system.

     deadhosts      The list of all hosts in the local domain that no longer
                    exist or are otherwise permanently unreachable.  Note that
                    the contents of this parameter are actually determined by
                    an external file, /etc/sendmail.killed, and that the
                    deadhosts parameter can only be displayed and not modified
                    via configmail.

     numcpus        The number of cpus available for sendmail to use.  This
                    value is determined at run time, and can not be set.

     The percpu mode takes an argument of a positive intger, and will return
     that value times the value numcpus .

     The default value of each of the above parameters is calculated at
     runtime by configmail.  The values thus calculated, when read by the
     autoconfiguring sendmail.cf file, should result in a working sendmail
     configuration.  It may, however, be necessary to override the calculated
     default values of one or more parameters in some situations.  For this
     purpose, the set and setup modes have been provided.

     The set mode provides an interactive interface through which the user can
     override the calculated default value or change the current override
     setting of the given parameter.  If the user chooses to set a value for
     the parameter that is different from the calculated default, the new
     value is stored in a file with the name /etc/sendmail.params.  If the
     value of this parameter is changed as a result of the user's selection,
     configmail prompts the user to restart the sendmail daemon so that the
     new value of the parameter is honored.

     The setup mode takes no parameter argument.  It recursively calls
     configmail in the set mode to obtain settings for the most commonly
     overridden parameters.  It prompts the user to verify and possibly change
     the settings of any other parameters that are currently overridden.

     The unset mode is used to remove any override setting and restore the
     calculated default value of the given parameter.  As with the set and
     setup modes, if the value of the parameter is changed from its previous
     value, configmail prompts the user to restart the sendmail daemon so that
     the new value of the parameter is honored.

     The help mode takes a parameter argument and prints the available help
     text associated with that parameter.

     The list mode takes no arguments.  It displays the current settings of
     the various configurable parameters plus the values of some internal
     variables.  This mode is intended to be used as a debugging aid.

     The m4 mode is similar to the list mode, but it's output is intended to
     be parsed by the m4 macro processor.

     The mc2cf mode is used to generate a sendmail.cf file, applying the
     features and settings defined in the sendmail.mc file.

     The get mode is used to obtain the current value of the given parameter.

WARNING
     When called from sendmail.cf, configmail must be called in the get mode
     only.  The other modes are intended to be used by a human operator.
DIAGNOSTICS
     If an error is detected while running in the help, list, m4, or setup
     mode, configmail places an appropriate error message on standard output
     and exit with a nonzero value.

     If an error is detected while running in the get mode, configmail places
     a null string on standard output and exit with a value of 0.  The get
     mode never exits with a nonzero value.

     If an error is detected while running in the set or unset mode,
     configmail places a diagnostic message on standard output and exit with a
     value of 1.  If configmail successfully modifies the requested parameter,
     it exits with a value of 2.  If no error is detected, and the parameter
     is unchanged, configmail exits with a value of 0.

FILES
     /etc/sendmail.cf          the sendmail configuration file

     /etc/sendmail.killed      contains the names of the permanently
                               unreachable hosts in the local domain

     /etc/sendmail.params      created and maintained by configmail, contains
                               any override settings for the various
                               configuration parameters

SEE ALSO
     canonhost(1M), m4(1), sendmail(1M).

     IRIX Admin: Networking and Mail