NAME¶

auth_getoption - Search an option string

SYNOPSIS¶

#include <courierauth.h>

DESCRIPTION¶

This is a convenience function for parsing account options, as received by the callback function invoked by auth_generic(3)[1], auth_login(3)[2], auth_getuserinfo(3)[3], and auth_passwd(3)[4]. options is the options field from authinfo (which can be NULL). As described in auth_generic(3)[1] (and the others), it is a comma-separated list of “ keyword=value” pairs. auth_getoption searches options for a keyword.

RETURNS¶

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.

SEE ALSO¶

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

NOTES¶

1.

auth_generic(3)

2.

auth_login(3)

3.

auth_getuserinfo(3)

4.

auth_passwd(3)

5.

authlib(3)