DragonFly On-Line Manual Pages

Search: Section:  

POPPWD(8)              DragonFly System Manager's Manual             POPPWD(8)


NAME

     poppwd - Eudora compatible password change server


SYNOPSIS

     poppwd [-Pv]


DESCRIPTION

     poppwd implements the Eudora password changing protocol. This allows
     Eudora compatible clients to change a users password via the network.
     poppwd is intended to be called from inetd(8).

     The following options are available:

     -P      Use PAM for authentication and to perform the password change.
             Without this option getpwnam(3) is used for authentication and
             pw(8) to perform the change.

     -v      Print the version string and copyright notice and then exit.

     Unless using PAM only non system users (by default, those with a UID
     greater than 1000 though this value may be changed at compilation time)
     can change their passwords via poppwd.  If using PAM these types of
     restrictions should be implemented via the PAM configuration.

   PAM
     PAM support can be enabled by passing the -P argument to poppwd.  The
     default PAM service name is pop3pw.  Only the auth and password PAM
     facilites are used. Both facilities must be configured to use the
     use_first_pass option. See EXAMPLES for an example of a basic PAM
     configuration file.


FILES

     /etc/inetd.conf    poppwd invocation
     /etc/pam.d/pop3pw  PAM configuration
     /etc/syslog.conf   logging specifications


EXAMPLES

     Assuming poppwd is installed in /usr/local/libexec an entry similar to
     the following could be made in /etc/inetd.conf. Append -P to enable PAM
     support.

     pop3pw stream tcp nowait root /usr/local/libexec/poppwd poppwd

     A valid PAM configuration file that has poppwd use the local system
     password database is as follows.

     auth            required        pam_unix.so     use_first_pass
     password        required        pam_unix.so     use_first_pass


DIAGNOSTICS

     Errors are logged to syslog(8) using the auth facility and are hopefully
     self explanatory.


SEE ALSO

     inetd(8), dovecot(8), pam(3), pw(8), syslogd(8)


HISTORY

     poppwd was written in response to a spate of error reports about pty
     handling in poppassd(8).  It looked easier to re-engineer than work out
     what was wrong with poppassd(8).  poppwd was developed under MacOS X and
     FreeBSD.


AUTHORS

     poppwd was written by Andrew Stevenson <andrew@ugh.net.au>.


BUGS

     See the accompanying README file.

UgH!                           January 12, 2001                           UgH!

Search: Section: