Provided by: checkpw_1.01-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)