Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | .TH qmail-popup 8 |
2 | .SH NAME | |
3 | qmail-popup \- read a POP username and password | |
4 | .SH SYNOPSIS | |
5 | .B qmail-popup | |
6 | .I hostname | |
7 | .I subprogram | |
8 | .SH DESCRIPTION | |
9 | .B qmail-popup | |
10 | reads a POP username and password from the network. | |
11 | It then runs | |
12 | .IR subprogram . | |
13 | ||
14 | .B qmail-popup | |
15 | is most commonly invoked from | |
16 | .B inetd | |
17 | as | |
18 | ||
19 | .EX | |
20 | qmail-popup CHANGEME checkpassword qmail-pop3d Maildir | |
21 | .EE | |
22 | ||
23 | with | |
24 | CHANGEME | |
25 | replaced by the fully qualified domain name of the local host. | |
26 | ||
27 | .B qmail-popup | |
28 | expects descriptor 0 to read from the network | |
29 | and descriptor 1 to write to the network. | |
30 | It reads a username and password from descriptor 0 | |
31 | in POP's USER-PASS style or APOP style. | |
32 | It invokes | |
33 | .IR subprogram , | |
34 | with the same descriptors 0 and 1; | |
35 | descriptor 2 writing to the network; | |
36 | and descriptor 3 reading the username, a 0 byte, the password, | |
37 | another 0 byte, | |
38 | an APOP timestamp derived from | |
39 | .IR hostname , | |
40 | and a final 0 byte. | |
41 | .B qmail-popup | |
42 | then waits for | |
43 | .I subprogram | |
44 | to finish. | |
45 | It prints an error message if | |
46 | .I subprogram | |
47 | crashes or exits nonzero. | |
48 | ||
49 | .B qmail-popup | |
50 | should be used only within | |
51 | a secure network. | |
52 | Otherwise an eavesdropper can steal passwords. | |
53 | Even if you use APOP, | |
54 | an active attacker can still take over the connection | |
55 | and wreak havoc. | |
56 | ||
57 | .B qmail-popup | |
58 | has a 20-minute idle timeout. | |
59 | ||
60 | .B qmail-popup | |
61 | is based on a program contributed by Russ Nelson. | |
62 | .SH "SEE ALSO" | |
63 | maildir(5), | |
64 | qmail-local(8), | |
65 | qmail-pop3d(8) |