Manual Pages for UNIX Operating System command usage for man sasl_server_new

Simple Authentication Security Layer Library Functions
                                           sasl_server_new(3SASL)



NAME
     sasl_server_new - create a new server authentication object

SYNOPSIS
     cc [ flag ... ] file ... -lsasl   [ library ... ]
     #include 

     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
     Use the sasl_server_new() 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  NULL,  use
                     gethostname(3C). The serverFQDN parameter is
                     useful for multi-homed servers.


     user_realm      The domain of the user agent. The user_realm
                     is  usually not necessary. The default value
                     of user_realm is NULL.


     iplocalport

                     The IP address and port of the local side of
                     the connection. The value of iplocalport may
                     be NULL. If iplocalport is NULL,  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
                                           sasl_server_new(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 NULL. See iplocalport.


     callbacks       Callbacks, for example: authorization, lang,
                     and new getopt context.


     flags           Usage  flags.   For   servers,   the   flags
                     SASL_NEED_PROXY  and  SASL_SUCCESS_DATA  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
     sasl_server_new() returns an integer that corresponds  to  a
     SASL error code.

ERRORS
     SASL_OK    The call to sasl_server_new() was successful.



     All other error codes indicate an error situation that  must
     be  handled,  or  the authentication session should be quit.
     See sasl_errors(3SASL) for information on SASL error codes.

ATTRIBUTES
     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
                                           sasl_server_new(3SASL)



_________________________________________________________________________
    |       ATTRIBUTE TYPE        |         ATTRIBUTE VALUE        |
    |_____________________________|________________________________|
    | Availability                | system/library/security/libsasl|
    |_____________________________|________________________________|
    | Interface Stability         | Committed                      |
    |_____________________________|________________________________|
    | MT-Level                    | MT-Safe                        |
    |_____________________________|________________________________|


SEE ALSO
     gethostname(3C), sasl_errors(3SASL), attributes(5)









































SunOS 5.11          Last change: 14 Oct 2003                    3






Simple Authentication Security Layer Library Functions
                                           sasl_server_new(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    4