mailauth - manipulate alternate authorization database for Post Office Pro-
tocol (POP), Internet Message Access Protocol (IMAP), and APOP users.
/usr/sbin/mailauth [-init] [-convert] [-list [-type POP | APOP | IMAP]]
[-delete name] [-user name [-type POP | APOP | IMAP]]
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.
[-list [-type POP | APOP | IMAP]
Used to list the entries in the mailauth database. If no type is speci-
fied, 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 specified using the -type option,
only entries for the corresponding type of user (POP, APOP, or IMAP)
will be displayed.
[-user name [-type POP | APOP | IMAP]
Used by the system administrator 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 data-
The mailauth program allows a POP, IMAP, or APOP (an alternate authentica-
tion method for POP) user to change the secret value used to generate 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 initialize or convert the
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 accordingly.
POP authorization database
Command: imapd(8), mailusradm(8), pop3d(8)