
	courierpassd - remote change password utility


Courierpassd provides an interface to the password changing functionality
provided by the courier mail server package. Courierpassd acts as a server
which client programs connect to through a tcp socket. Courierpassd changes
the password of a user when provided with a user ID, old password, and
new password.

Courierpassd is designed to be run from a super-server such as tcpserver
or xinetd. The poppassd protocol is used to talk to client programs to
obtain authentication tokens.

Since courierpassd uses courier authentication modules to do the actual work,
courierpassd can affect only those user accounts accessable by courier.
Currently, courier includes authentication modules for passwd and shadow
files, db and gdbm files, PAM, LDAP, MySQL, and PostgreSQL. It also provides
a framework for creating new authentication modules.

Courierpassd requires the presence of the courier source tree to compile.

Features of courierpassd

  * ability to specify a service name associated with the user ID and password
    this value defaults to 'login'

  * ability to name a specific courier authentication module to use for
    password changes

  * a minimum uid can be set below which courierpassd will refuse to change
    passwords

  * a delay can be set which causes courierpassd to sleep for the specified
    number of seconds after a failed password change attempt

  * logging information can be directed to syslog or stderr


See the courierpassd(8) man page for a detailed description of courierpassd's
capabilities and usage.

Bug reports, suggestions, enhancements, and fully tested and debugged diffs
can be sent to:
		courierpassd@arda.homeunix.net

See the AUTHORS file for a list of credits.
