auth_getoption

Langue: en

Autres versions - même langue

Version: 04/06/2007 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

auth_getoption - 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 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].

REFERENCES

1.
auth_generic(3)
auth_generic.html
2.
auth_login(3)
auth_login.html
3.
auth_getuserinfo(3)
auth_getuserinfo.html
4.
auth_passwd(3)
auth_passwd.html
5.
authlib(3)
authlib.html