configmail(1M) configmail(1M)
NAME
configmail - sendmail autoconfiguration script
SYNOPSIS
/usr/etc/configmail mode [ parameter ]
DESCRIPTION
configmail is called by the autoconfiguring sendmail.cf file shipped with
IRIX to obtain important information about the local mail environment.
configmail can also be executed by the user to display and/or modify that
information.
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 , 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 .
Page 1
configmail(1M) configmail(1M)
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 get mode is used to obtain the current value of the given parameter.
This is the mode used by the autoconfiguring sendmail.cf file to obtain
information about the local mail environment.
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.
Page 2
configmail(1M) configmail(1M)
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
Page 3