DragonFly On-Line Manual Pages

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

		     o service a is the registered name of the	service  (usu-
		       ally the protocol name) using SASL (e.g. aimapa).

		     o serverFQDN  a  is the  fully  qualified	server	domain
		       name.  NULL  means  use gethostname().  This is	useful
		       for multi-homed servers.

		     o user_realm  a is the domain of the user agent. This  is
		       usually not necessary (NULL is default)

		     o iplocalport a

		       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:

		       o aa.b.c.d;porta  (IPv4),

		       o ae:f:g:h:i:j:k:l;porta (IPv6), or

		       o ae:f:g:h:i:j:a.b.c.d;porta (IPv6)

		     o ipremoteport a is the IP and port of the remote side of
		       the connection, or NULL (see iplocalport)

		     o flags a are connection flags (see below)

		     o pconn a 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():

       o SASL_SUCCESS_DATA: The protocol supports a serveralast send

       o

	 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-2016, The Cyrus Team

2.1.27			       November 08, 2018	    SASL_SERVER_NEW(3)