mailadmin(1M)

mailadmin -- configure mail systems

Synopsis

/etc/mail/admin/mailadmin

/etc/mail/admin/mailadmin [-h host] command [arguments]

Description

The mailadmin utility edits the mail configuration files and is available in both graphical and command line modes. This manual page describes only the command line mode.

Executed without arguments, /etc/mail/admin/mailadmin starts up the graphical manager. For details of this mode, refer to ``The Mail Manager'' in Configuring mail and messaging.

The following list details the shell commands and their arguments. Multiple commands may be strung together on the command line: if any of them fail, no changes are made to the configuration files. Commands with a variable number of arguments may be terminated with a double hyphen (--).

sendmail restart: Stop and restart the sendmail daemon. sendmail should be restarted after all changes are completed (note that the GUI does this automatically). This operation is carried out by /etc/mail/sendmailrc.
uucp rebuild: Rebuilds /etc/mail/table/uucp.db from /usr/lib/uucp/Systems. This only needs to be done if a UUCP channel exists and the Systems file has been changed. (Note that the GUI does this automatically.)
add map name: Adds an NIS alias map or alias file entry. The permissible formats are nis:mapname or the full pathname of an alias file.
add altname name: Adds an alternate name for this host.
add channel name program type: Adds a new channel entry. The table type is one of DNS, UUCP, local, remote, baduser and file.
del map name: Deletes an alias map or alias file by name.
del altname name: Deletes an alternate name entry by name.
del channel name: Deletes a channel entry by name.
order maps list: Gives a new alias map order.
order altnames list: Gives a new alternate names order.
order channels list: Gives a new channel order. Channels using the baduser table type must be specified last, and there can be at most one such channel.
list maps: Lists alias map names in order.
list altnames: Lists alternate names in order.
list channels: Lists channel names in order.

The following commands deal with individual properties.

def propname: Sets a given property to its default value.
get propname: Displays the current value of the given property.
set propname value: Sets a given property to the given value.

Property names can be a single token or they can be a channel name, followed by a colon and then the property name. Valid property names and their values are as follows:

General mail properties

host
Host name. The default is to use the system name.

from
From domain name. Default (systemid) is used.

domain
TRUE/FALSE. Enables/disables Domain Table (/etc/mail/table/domain).
Message store (folder) properties

fdir
INBOX directory. A zero length string indicates that the user's home directory is to be used.

fname
INBOX name. A zero length string indicates that the user's login name is to be used.

fformat
MMDF/Sendmail: the default folder format.

fsync
TRUE/FALSE: enables/disables O_FSYNC on folders.

fccheck
TRUE/FALSE: enables/disables extended consistency checks.

fincore
TRUE/FALSE: enables/disables incore caching of entire mail folders.

fthreshold
A value in the range 0,...,100. Specifies the percentage of the file that must be maintained as valid. 100 means maximum compatibility, 50 for higher performance.

ftimeout
A value in the range 1,...,999. Specifies the file lock timeout for mail folders.

ffilelock
TRUE/FALSE: enable/disable file based locking on mail folders. folder.lock files will be used. Kernel locking is always enabled. This option adds file based locking.

fumask
A value in the range 0,...,0777. Sets the mask for mail folder and directory creation.
Channel properties (must be preceeded with channel name and a colon)

name
Channel name: no white space is permitted, domain is a reserved name, and names must be unique. baduser, badhost, multihome, and local are treated specially, as they are translated into local names in the GUI based on the locale.

program
Channel program (P=). Specify either a path name or ``[IPC]'' for SMTP.

args
Channel program arguments (A=). Note that $h (host part of recipient address) and $u (user name part of recipient address) are special to sendmail.

dir
Channel program execution directory. The default is /var/spool/mqueue.

table
One of DNS, UUCP, remote, local, file, baduser, or channel table type. The baduser channel is special: it must be specified last and there can be only one.

file
The channel table file, only used for channel tables of type file.

host
Specifies the host through which all mail for this channel will be routed. Set this option to a zero length string to remove this routing. This value is ignored for file table channels.

flags
Channel program flags (F=).

eol
Channel program end of line (usually \n, although SMTP requires \r\n).

maxmsg
The maximum message size. 0 means no maximum.

maxline
The maximum line size. 0 means no maximum. 990 is expected to be set for all channels that use SMTP, while most others use 0.

nice
A value in the range -20,...,20 (N=). The channel program nice increment. 0 is the default value.

user
user:group (U=). The user and group to be used to run the channel program. If set to zero length string, then bin:bin (1:1) is used.

rruleset
envelope[/header]. The envelope and header recipient rulesets. UnixWare defines ap822_re/ap822_rh for SMTP, ap975_re/ap976_rh for UUCP, and aplocal_re/aplocal_rh for local delivery. Custom channels will generally want the RFC822 rewriting rules.

sruleset
envelope[/header]. The envelope and header sender rulesets. UnixWare defines ap822_se/ap822_sh for SMTP, ap975_se/ap976_sh for UUCP, and aplocal_se/aplocal_sh for local delivery.

For a comprehensive reference to sendmail rulesets, mailer arguments and equate constructs, refer to sendmail, Bryan Costales with Eric Allman, O'Reilly & Associates, Inc., 1997.

References

Vacation Notification Manager in Vacation Notification Manager