Manual Pages for UNIX Operating System command usage for man sasl_setprop

Simple Authentication Security Layer Library Functions
                                              sasl_setprop(3SASL)



NAME
     sasl_setprop - set a SASL property

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

     int sasl_setprop(sasl_conn_t *conn, int propnum, const void *pvalue);


DESCRIPTION
     Use the sasl_setprop() interface to set the value of a  SASL
     property. For example, an application can use sasl_setprop()
     to tell the SASL  liabrary  about  any  external  negotiated
     security layer like TLS.


     sasl_setprop() uses the following flags.

     SASL_AUTH_EXTERNAL    External authentication ID that  is  a
                           pointer of type const char


     SASL_SSF_EXTERNAL     External SSF active of type sasl_ssf_t


     SASL_DEFUSERREALM     User realm that is a pointer  of  type
                           const char


     SASL_SEC_PROPS        sasl_security_properties_t,  that  can
                           be freed after the call


     SASL_IPLOCALPORT      A string that describes the  local  ip
                           and  port  in  the  form  a.b.c.d:p or
                           [e:f:g:h:i:j:k:l]:port or one  of  the
                           older      forms,     a.b.c.d;p     or
                           e:f:g:j:i:j:k:l;port


     SASL_IPREMOTEPORT     A string that describes the remote  ip
                           and  port  in  the  form  a.b.c.d:p or
                           [e:f:g:h:i:j:k:l]:port or one  of  the
                           older      forms,     a.b.c.d;p     or
                           e:f:g:j:i:j:k:l;port


PARAMETERS
     conn       The SASL connection context




SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                              sasl_setprop(3SASL)



     propnum    The identifier for the property requested


     pvalue     Contains a pointer to the data.  The  application
                must ensure that the data type is correct, or the
                application can crash.


RETURN VALUES
     sasl_setprop() returns an integer that corresponds to a SASL
     error code.

ERRORS
     SASL_OK    The call to sasl_setprop() was successful.



     See sasl_errors(3SASL) for information on SASL error codes.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



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


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
















SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                              sasl_setprop(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3