mailauth(8)mailauth(8)NAMEmailauth - manipulate alternate authorization database for Post Office
Protocol (POP), Internet Message Access Protocol (IMAP), and APOP
users.
SYNOPSIS
/usr/sbin/mailauth [-init] [-convert] [-list [-type POP | APOP | IMAP]]
[-delete name] [-user name [-type POP | APOP | IMAP]]
OPTIONS
Initialize the database. You must be superuser to use this option.
Convert an existing APOP only database to the new format. You must be
superuser to use this option. Used to list the entries in the mailauth
database. If no type is specified, all entries in the database will be
displayed. The display will consist of one column corresponding to the
username and another column for the type of user. If a type is speci‐
fied using the -type option, only entries for the corresponding type of
user (POP, APOP, or IMAP) will be displayed. Used by the system admin‐
istrator to either add a user to the mailauth database, to change the
password for the user, or to change the type of user. The administrator
will be prompted for a new password and then a verification of the
password. If the type is not explicitly specified and a previous entry
does not exist, then it will default to APOP. Used to delete the entry
corresponding to name from the mailauth database.
DESCRIPTION
The mailauth program allows a POP, IMAP, or APOP (an alternate authen‐
tication method for POP) user to change the secret value used to gener‐
ate their authentication credentials. In addition, both the superuser
and the user pop may use this program to either add or remove a user,
or to print public information from it. Only the superuser may ini‐
tialize or convert the database.
A user can change their own passwords or add themselves to the mailauth
database by entering the mailauth command. If an entry already exists,
the user is first prompted to enter the old password. If the password
does not correspond with the one in the database, the transaction will
be ended. Otherwise, the user will be prompted for a new password and a
verification of the password. The user is not allowed to change the
type of user they are. For example, they cannot change themselves from
a user using the APOP command during the POP Authorization State to a
user using the Internet Message Access Protocol (IMAP). If an entry
does not already exist in the database, the user will be added as an
APOP user.
Under normal usage, mailauth prompts for a new secret, just like the
passwd program. It then updates the POP authorization database accord‐
ingly.
FILES
POP authorization database
SEE ALSO
Command: imapd(8), mailusradm(8), pop3d(8)mailauth(8)