debian man page for checkapoppw

checkapoppw(8)						      System Manager's Manual						    checkapoppw(8)

NAME
       checkapoppw - checks APOP password against the file ~/Maildir/.password

SYNOPSIS
       checkapoppw prog

DESCRIPTION
       checkapoppw  reads  descriptor  3  through end of file and then closes descriptor 3.  There must be at most 512 bytes of data before end of
       file.

       The information supplied on descriptor 3 is a login name terminated by , a password terminated by , a timestamp terminated by  ,  and
       possibly more data.  There are no other restrictions on the form of the login name, password, and timestamp.

       If  the	password is unacceptable, checkapoppw exits 1.	If checkapoppw is misused, it may instead exit 2.  If there is a temporary problem
       checking the password, checkapoppw exits 111.

       If the password is acceptable, checkapoppw runs prog.

       prog consists of one or more arguments.

Compatible tools
       There are other tools that offer the same interface as checkapoppw

       Note that these tools do not follow the getopt interface.  Optional features are controlled through (1) the tool name and  (2)  environment
       variables.

The password database
       checkapoppw  checks the APOP password against the content of the file Maildir/.password (not encrypted) in the user's home directory corre-
       sponding to the login name.

       Maildir may be overidden through the environment variable $MAILDIR.

Process-state changes
       Before invoking prog, checkapoppw sets up $USER, $HOME, $SHELL, its supplementary groups, its gid, its uid, and its working directory.

FILES
       ~/Maildir/.password

SEE ALSO
       checkpw(8), qmail-popup(8), qmail-pop3d(8)

AUTHOR
       This manual page was written by Gerrit Pape <pape@smarden.org>, for the Debian GNU/Linux system.

																    checkapoppw(8)