Maintenance Procedures                             qmail-popup(8)



NNNNAAAAMMMMEEEE
     qmail-popup - read a POP username and password

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp _h_o_s_t_n_a_m_e _s_u_b_p_r_o_g_r_a_m

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp reads a POP username and password from the  net-
     work.  It then runs _s_u_b_p_r_o_g_r_a_m.

     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp is most commonly invoked from iiiinnnneeeettttdddd as

        qmail-popup CHANGEME checkpassword qmail-pop3d Maildir

     with CHANGEME replaced by the fully qualified domain name of
     the local host.

     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp expects descriptor 0 to read  from  the  network
     and  descriptor 1 to write to the network.  It reads a user-
     name and password from descriptor 0 in POP's USER-PASS style
     or  APOP  style.   It  invokes  _s_u_b_p_r_o_g_r_a_m,  with  the  same
     descriptors 0 and 1; descriptor 2 writing  to  the  network;
     and  descriptor  3 reading the username, a 0 byte, the pass-
     word, another 0 byte, an APOP timestamp derived  from  _h_o_s_t_-
     _n_a_m_e,  and  a final 0 byte.  qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp then waits for _s_u_b_-
     _p_r_o_g_r_a_m to finish.  It prints an error message if _s_u_b_p_r_o_g_r_a_m
     crashes or exits nonzero.

     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp should be used only  within  a  secure  network.
     Otherwise  an eavesdropper can steal passwords.  Even if you
     use APOP, an active attacker can still take over the connec-
     tion and wreak havoc.

     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp has a 20-minute idle timeout.

     qqqqmmmmaaaaiiiillll----ppppooooppppuuuupppp is based on a program contributed by  Russ  Nel-
     son.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     maildir(5), qmail-local(8), qmail-pop3d(8)















SunOS 5.11                Last change:                          1