1 .\" <!-- $Id: auth_getoption.sgml,v 1.3 2007/04/01 00:21:34 mrsam Exp $ -->
2 .\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
3 .\" <!-- distribution information. -->
4 .\" Title: auth_getoption
6 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
8 .\" Manual: Double Precision, Inc.
9 .\" Source: Double Precision, Inc.
11 .TH "AUTH_GETOPTION" "3" "04/06/2007" "Double Precision, Inc." "Double Precision, Inc."
12 .\" disable hyphenation
14 .\" disable justification (adjust text to left margin only)
17 auth_getoption \- Search an option string
22 #include <courierauth.h>
26 .BI "char *value=auth_getoption(const\ char\ *" "options" ", const\ char\ *" "keyword" ");"
29 This is a convenience function for parsing account options, as received by the callback function invoked by
30 \fI\fBauth_generic\fR(3)\fR\&[1],
31 \fI\fBauth_login\fR(3)\fR\&[2],
32 \fI\fBauth_getuserinfo\fR(3)\fR\&[3], and
33 \fI\fBauth_passwd\fR(3)\fR\&[4].
42 NULL). As described in
43 \fI\fBauth_generic\fR(3)\fR\&[1]
44 (and the others), it is a comma\-separated list of
45 \(lq\fIkeyword\fR=\fIvalue\fR\(rq
68 allocates a buffer for
69 \fIvalue\fR, and returns it. It is the caller's responsibility to
81 if it cannot allocate a buffer.
85 \fI\fBauthlib\fR(3)\fR\&[5],
86 \fI\fBauth_generic\fR(3)\fR\&[1],
87 \fI\fBauth_login\fR(3)\fR\&[2],
88 \fI\fBauth_getuserinfo\fR(3)\fR\&[3].
101 \fBauth_getuserinfo\fR(3)
103 \%auth_getuserinfo.html