unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



mailauth(8)							  mailauth(8)



NAME

  mailauth - manipulate	alternate authorization	database for Post Office Pro-
  tocol	(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

  -init
      Initialize the database. You must	be superuser to	use this option.

  -convert
      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.

  -delete name
      Used to delete the entry corresponding to	name from the mailauth data-
      base.

DESCRIPTION

  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
  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 accordingly.

FILES

  /etc/pop.auth.*
      POP authorization	database

SEE ALSO

  Command: imapd(8), mailusradm(8), pop3d(8)