chiark - git - mdw - qmail/blob - qmail-popup.8

   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)