man auth_getoption (1): Search an option string

SYNOPSIS

#include <courierauth.h>

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

DESCRIPTION

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

options is the options field from authinfo (which can be NULL). As described in m[blue]auth_generic(3)m[][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.