1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
.TH checkapoppw 8
.SH NAME
checkapoppw - checks APOP password against the file
.I ~/Maildir/.password
.SH SYNOPSIS
.B checkapoppw
.I prog
.SH DESCRIPTION
.B 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,
.B checkapoppw
exits 1.
If
.B checkapoppw
is misused, it may instead exit 2.
If there is a temporary problem checking the password,
.B checkapoppw
exits 111.
If the password is acceptable,
.B checkapoppw
runs
.IR prog .
.I prog
consists of one or more arguments.
.SH Compatible tools
There are other tools that offer the same interface as
.B checkapoppw
Note that these tools do not follow the
.I getopt
interface.
Optional features are controlled through
(1) the tool name and (2) environment variables.
.SH The password database
.B checkapoppw
checks the APOP password
against the content of the file
.I Maildir/.password
(not encrypted)
in the user's home directory corresponding to the login name.
.I Maildir
may be overidden through the environment variable
.IR $MAILDIR .
.SH Process-state changes
Before invoking
.IR prog ,
.B checkapoppw
sets up
.IR $USER ,
.IR $HOME ,
.IR $SHELL ,
its supplementary groups,
its gid,
its uid,
and its working directory.
.SH FILES
~/Maildir/.password
.SH SEE ALSO
checkpw(8),
qmail-popup(8),
qmail-pop3d(8)
.SH AUTHOR
This manual page was written by Gerrit Pape <pape@smarden.org>, for the
Debian GNU/Linux system.
|
