auth_getoption (3)

#include <courierauth.h>

char *value=auth_getoption(const char *options, const char *keyword);

This is a convenience function for parsing account options, as received by the callback function invoked by \m[blue]auth_generic(3)\m[]\s-2\u[1]\d\s+2, \m[blue]auth_login(3)\m[]\s-2\u[2]\d\s+2, \m[blue]auth_getuserinfo(3)\m[]\s-2\u[3]\d\s+2, and \m[blue]auth_passwd(3)\m[]\s-2\u[4]\d\s+2.

options is the options field from authinfo (which can be NULL). As described in \m[blue]auth_generic(3)\m[]\s-2\u[1]\d\s+2 (and the others), it is a comma-separated list of “keyword=value” pairs.

auth_getoption searches options for a keyword.

If options does not have the keyword, auth_getoption returns NULL with errno set to ENOENT. Otherwise auth_getoption allocates a buffer for value, and returns it. It is the caller's responsibility to free(3) the returned buffer.

auth_getoption returns NULL with errno set to ENOMEM if it cannot allocate a buffer.

\m[blue]authlib(3)\m[]\s-2\u[5]\d\s+2, \m[blue]auth_generic(3)\m[]\s-2\u[1]\d\s+2, \m[blue]auth_login(3)\m[]\s-2\u[2]\d\s+2, \m[blue]auth_getuserinfo(3)\m[]\s-2\u[3]\d\s+2.

1.

auth_generic(3)

[set $man.base.url.for.relative.links]/auth_generic.html

2.

auth_login(3)

[set $man.base.url.for.relative.links]/auth_login.html

3.

auth_getuserinfo(3)

[set $man.base.url.for.relative.links]/auth_getuserinfo.html

4.

auth_passwd(3)

[set $man.base.url.for.relative.links]/auth_passwd.html

5.

authlib(3)

[set $man.base.url.for.relative.links]/authlib.html