Poster of Linux kernelThe best gift for a Linux geek
AUTH_GETOPTION

AUTH_GETOPTION

Section: Double Precision, Inc. (3) Updated: 08/23/2008
Local index Up
 

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURNS
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 21:42:08 GMT, April 16, 2011