logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

auth_enumerate - Obtain list of accounts

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:

       •   Account name.

       •   Account's numeric userid.

       •   Account's numeric groupid.

       •   Account's home directory.

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

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

       •   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.

Name

       auth_enumerate - Obtain list of accounts

Notes

See Also

authlib(3)[1], auth_generic_meta(3)[2], auth_login_meta(3)[3], auth_getuserinfo_meta(3)[4],
       auth_passwd(3)[5].

Synopsis

       #include <courierauth.h>

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

See Also