Simple Authentication Security Layer Library Functions
saslclientnew(3SASL)
NAME
saslclientnew - create a new client authentication object
SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include
int saslclientnew(const char *service, const char *serverFQDN,
const char *iplocalport, const char *ipremoteport,
const saslcallbackt *promptsupp, unsigned flags,
saslconnt **pconn);
DESCRIPTION
Use the saslclientnew() interface to create a new SASL
context. This SASL context will be used for all SASL calls
for one connection. The context handles both authentication
and the integrity and encryption layers after authentica-
tion.
PARAMETERS
service The registered name of the service that uses
SASL, usually the protocol name, for exam-
ple, IMAP.
serverFQDN The fully qualified domain name of the
server, for example, serverhost.cmu.edu.
iplocalport
The IP and port of the local side of the
connection, or NUL. If iplocalport is NUL,
mechanisms that require IP address informa-
tion are disabled. The iplocalport string
must be in one of the following formats:
o a.b.c.d:port (IPv6)
o [e:f:g:h:i:j:k:l]:port (IPv6)
o [e:f:g:h:i:j:a.b.c.d]:port (IPv6)
o a.b.c.d;port (IPv4)
o e:f:g:h:i:j:k:l;port (IPv6)
o e:f:g:h:i:j:a.b.c.d;port (IPv6)
SunOS 5.11 Last change: 27 Aug 2003 1
Simple Authentication Security Layer Library Functions
saslclientnew(3SASL)
ipremoteport The IP and port of the remote side of the
connection, or NUL.
promptsupp A list of the client interactions supported
that are unique to this connection. If this
parameter is NUL, the global callbacks
specified in saslclientinit(3SASL) are
used.
flags Usage flags. For clients, the flag
SASLNEDPROXY is available.
pconn The connection context allocated by the
library. The pconn structure is used for all
future SASL calls for this connection.
RETURN VALUES
saslclientnew() returns an integer that corresponds to a
SASL error code.
ERORS
SASLOK The call to saslclientnew() was success-
ful.
SASLNOMECH No mechanishm meets the requested proper-
ties.
SASLBADPARAM There is an error in the configuration file
or passed parameters.
SASLNOMEM There is not enough memory to complete the
operation.
All other error codes indicate an error situation that must
be handled, or the authentication session should be quit.
See saslerrors(3SASL) for information on SASL error codes.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 27 Aug 2003 2
Simple Authentication Security Layer Library Functions
saslclientnew(3SASL)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWlibsasl
Interface Stability Evolving
MT-Level Safe
SEE ALSO
saslclientinit(3SASL), saslerrors(3SASL), attributes(5)
SunOS 5.11 Last change: 27 Aug 2003 3
Simple Authentication Security Layer Library Functions
saslclientnew(3SASL)
SunOS 5.11 Last change: 27 Aug 2003 4
|
