Manual Pages for UNIX Operating System command usage for man sasl_getprop

Simple Authentication Security Layer Library Functions
                                              sasl_getprop(3SASL)



NAME
     sasl_getprop - get a SASL property

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

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


DESCRIPTION
     Use the sasl_getprop() interface to get the value of a  SASL
     property.  For  example,  after successful authentication, a
     server may want to know the authorization name. Similarly, a
     client  application  may  want  to  know the strength of the
     security level that was negotiated.

PARAMETERS
     conn       The SASL connection context.


     propnum    The identifier for the property requested.


     pvalue     The value of the SASL  property.  This  value  is
                filled  in  upon a successful call. Possible SASL
                values include:

                SASL_USERNAME        A   pointer   to   a   null-
                                     terminated user name.


                SASL_SSF             The security layer  security
                                     strength   factor.   If  the
                                     value of SASL_SSF  is  0,  a
                                     call   to  sasl_encode()  or
                                     sasl_decode()  is   unneces-
                                     sary.


                SASL_MAXOUTBUF       The maximum size  of  output
                                     buffer   returned   by   the
                                     selected security mechanism


                SASL_DEFUSERREALM    Server authentication  realm
                                     used.


                SASL_GETOPTCTX       The  context  for   getopt()
                                     callback.



SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                              sasl_getprop(3SASL)



                SASL_IPLOCALPORT     Local address string.


                SASL_IPREMOTEPORT    Remote address string.


                SASL_SERVICE         Service   passed    on    to
                                     sasl_*_new().


                SASL_SERVERFQDN      Server  FQDN  passed  on  to
                                     sasl_*_new().


                SASL_AUTHSOURCE      Name    of    authentication
                                     source last used. Useful for
                                     failed authentication track-
                                     ing.


                SASL_MECHNAME        Active  mechanism  name,  if
                                     any.


                SASL_PLUGERR         Similar to sasl_errdetail().



ERRORS
     SASL_OK    The call to sasl_getprop() was successful.



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



_________________________________________________________________________
    |       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                    3






Simple Authentication Security Layer Library Functions
                                              sasl_getprop(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    4