Provided by: checkpw_1.02-1.1_i386 bug

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)