SASL_SERVER_NEW(3) Cyrus SASL SASL_SERVER_NEW(3)
NAME
sasl_server_new - Cyrus SASL documentation
SYNOPSIS
#include <sasl/sasl.h>
int sasl_server_new(const char *service,
const char *serverFQDN,
const char *user_realm,
const char *iplocalport,
const char *ipremoteport,
const sasl_callback_t *callbacks,
unsigned flags,
sasl_conn_t ** pconn);
DESCRIPTION
int sasl_server_new(const char *service,
const char *serverFQDN,
const char *user_realm,
const char *iplocalport,
const char *ipremoteport,
const sasl_callback_t *callbacks,
unsigned flags,
sasl_conn_t ** pconn);
sasl_server_new() creates a new SASL context. This context will
be used for all SASL calls for one connection. It handles both
authentication and integrity/encryption layers after authenti-
cation.
Parameters
• service – is the registered name of the service (usu-
ally the protocol name) using SASL (e.g. “imap”).
• serverFQDN – is the fully qualified server domain
name. NULL means use gethostname(). This is useful
for multi-homed servers.
• user_realm – is the domain of the user agent. This is
usually not necessary (NULL is default)
• iplocalport –
is the IP and port of the local side of the connec-
tion, or NULL. If iplocalport is NULL it will disable
mechanisms that require IP address information. This
strings must be in one of the following formats:
• ”a.b.c.d;port” (IPv4),
• ”e:f:g:h:i:j:k:l;port” (IPv6), or
• ”e:f:g:h:i:j:a.b.c.d;port” (IPv6)
• ipremoteport – is the IP and port of the remote side of
the connection, or NULL (see iplocalport)
• flags – are connection flags (see below)
• pconn – is a pointer to the connection context allo-
cated by the library. This structure will be used for
all future SASL calls for this connection.
Connection flags
Flags that may be passed to sasl_server_new():
• SASL_SUCCESS_DATA: The protocol supports a server-last send
•
SASL_NEED_PROXY: Force the use of a mechanism that supports an
authorization id that is not the authentication id.
RETURN VALUE
SASL callback functions should return SASL return codes. See sasl.h
for a complete list. SASL_OK indicates success.
Other return codes indicate errors and should either be handled or the
authentication session should be quit.
SEE ALSO
RFC 4422,:saslman:sasl(3), sasl_server_init(3), sasl_server_start(3),
sasl_server_step(3), sasl_setprop(3), sasl_errors(3)
AUTHOR
The Cyrus Team
COPYRIGHT
1993-2022, The Cyrus Team
2.1.28 2022-11-22 SASL_SERVER_NEW(3)
Generated by dwww version 1.15 on Mon Jun 24 01:44:08 CEST 2024.