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  \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, 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 corresponding 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)