auth_getoption

AUTH_GETOPTION(3)	    Double Precision, Inc.	    AUTH_GETOPTION(3)



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

NOTES
	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



Double Precision, Inc.		  08/23/2008		    AUTH_GETOPTION(3)