NAME

       checkpw - checks password against the file ~/Maildir/.password

SYNOPSIS

       checkpw prog

DESCRIPTION

       checkpw  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  \0,  a  password
       terminated  by  \0,  a  timestamp  terminated by \0, and possibly more data.  There are no
       other restrictions on the form of the login name, password, and timestamp.

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

       If the password is acceptable, checkpw runs prog.

       prog consists of one or more arguments.

Compatible tools

       There are other tools that offer the same interface as checkpw

       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

       checkpw checks the password against the content  of  the  file  Maildir/.password  in  the
       user's home directory corresponding to the login name.

       Maildir may be overidden through the environment variable $MAILDIR.

Process-state changes

       Before  invoking prog, checkpw sets up $USER, $HOME, $SHELL, its supplementary groups, its
       gid, its uid, and its working directory.

FILES

       ~/Maildir/.password

SEE ALSO

       checkapoppw(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.

                                                                                       checkpw(8)