Simple Authentication Security Layer Library Functions
saslservernew(3SASL)
NAME
saslservernew - create a new server authentication object
SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include
int saslservernew(const char *service, const char *serverFQDN,
const char *userrealm, const char *iplocalport,
const char *ipremoteport, const saslcallbackt *callbacks,
unsigned flags, saslconnt **pconn);
DESCRIPTION
Use the saslservernew() interface to create a new SASL
context. This context will be used for all SASL calls for
one connection. The new SASL context handles both authenti-
cation and integrity or encryption layers after authentica-
tion.
PARAMETERS
service The registered name of the service that uses
SASL. The registered name is usually the
protocol name, for example, IMAP.
serverFQDN The fully-qualified server domain name. If
the value of serverFQDN is NUL, use
gethostname(3C). The serverFQDN parameter is
useful for multi-homed servers.
userrealm The domain of the user agent. The userrealm
is usually not necessary. The default value
of userrealm is NUL.
iplocalport
The IP address and port of the local side of
the connection. The value of iplocalport may
be NUL. If iplocalport is NUL, mechanisms
that require IP address information are dis-
abled. The iplocalport string must be in one
of the following formats:
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: 14 Oct 2003 1
Simple Authentication Security Layer Library Functions
saslservernew(3SASL)
The following older formats are also sup-
ported:
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)
ipremoteport The IP address and port of the remote side
of the connection. The value of ipremoteport
may be NUL. See iplocalport.
callbacks Callbacks, for example: authorization, lang,
and new getopt context.
flags Usage flags. For servers, the flags
SASLNEDPROXY and SASLSUCESDATA are
available.
pconn A pointer to the connection context allo-
cated by the library. This structure will be
used for all future SASL calls for this con-
nection.
RETURN VALUES
saslservernew() returns an integer that corresponds to a
SASL error code.
ERORS
SASLOK The call to saslservernew() was successful.
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: 14 Oct 2003 2
Simple Authentication Security Layer Library Functions
saslservernew(3SASL)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWlibsasl
Interface Stability Evolving
MT-Level MT-Safe
SEE ALSO
gethostname(3C), saslerrors(3SASL), attributes(5)
SunOS 5.11 Last change: 14 Oct 2003 3
Simple Authentication Security Layer Library Functions
saslservernew(3SASL)
SunOS 5.11 Last change: 14 Oct 2003 4
|
