authlib(3) [debian man page]

AUTHLIB(3)						      Double Precision, Inc.							AUTHLIB(3)

NAME

       authlib - Courier Authentication Library

SYNOPSIS

       courierauthconfig [[--ldflags] | [--cppflags]]

DESCRIPTION

       The Courier authentication library consists of two libraries:

       -lcourierauth
	   Authentication functions.

       -lcourierauthsasl
	   SASL authentication functions.

       courierauthconfig --cppflags produces on standard output any necessary compiler flags that are needed to access the courierauth.h and the
       courierauthsasl.h header files.	courierauthconfig --ldflags produces on standard output any necessary compiler flags that are needed to
       link against the courierauth or courierauthsasl libraries.

SEE ALSO

       auth_generic(3)[1], auth_login(3)[2], auth_getuserinfo(3)[3], auth_enumerate(3)[4], auth_passwd(3)[5], auth_sasl(3)[6].

NOTES

	1. auth_generic(3)
	   auth_generic.html

	2. auth_login(3)
	   auth_login.html

	3. auth_getuserinfo(3)
	   auth_getuserinfo.html

	4. auth_enumerate(3)
	   auth_enumerate.html

	5. auth_passwd(3)
	   auth_passwd.html

	6. auth_sasl(3)
	   auth_sasl.html

Double Precision, Inc.						    08/23/2008								AUTHLIB(3)

AUTH_ENUMERATE(3)					      Double Precision, Inc.						 AUTH_ENUMERATE(3)

NAME

       auth_enumerate - Obtain list of accounts

SYNOPSIS

	   #include <courierauth.h>

       auth_enumerate(int (*callback_func) (const char *, uid_t, gid_t, const char *, const char *, const char *, void *), void *callback_arg);

DESCRIPTION

       auth_enumerate enumerates all of the available accounts.  auth_enumerate repeatedly calls callback_func, once for each account.
       callback_func receives the following arguments:

       o   Account name.

       o   Account's numeric userid.

       o   Account's numeric groupid.

       o   Account's home directory.

       o   Account's mailbox (if defined, may be NULL, which indicates the default mailbox location).

       o   Account's options string (if defined, may be NULL)

       o    callback_arg, verbatim.

       After invoking callback_func for the last account, auth_enumerate invokes callback_func one more time with all parameters set to NULL or 0.

       If auth_enumerate encounters an error it will terminate without calling callback_func with all NULL or 0 parameters. This can be used to
       determine whether a partial list of accounts was received.

       Note
       Some back-end Courier authentication modules do not implement account enumeration, so this function may not be available in all
       configurations.

SEE ALSO

       authlib(3)[1], auth_generic(3)[2], auth_login(3)[3], auth_getuserinfo(3)[4], auth_passwd(3)[5].

NOTES

	1. authlib(3)
	   authlib.html

	2. auth_generic(3)
	   auth_generic.html

	3. auth_login(3)
	   auth_login.html

	4. auth_getuserinfo(3)
	   auth_getuserinfo.html

	5. auth_passwd(3)
	   auth_passwd.html

Double Precision, Inc.						    08/23/2008							 AUTH_ENUMERATE(3)