Simple Authentication Security Layer Library Functions
                                              saslgetprop(3SASL)



NAME
     saslgetprop - get a SASL property

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

     int saslgetprop(saslconnt *conn, int propnum, const void **pvalue);


DESCRIPTION
     Use the saslgetprop() 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:

                SASLUSERNAME        A   pointer   to   a   null-
                                     terminated user name.


                SASLSF             The security layer  security
                                     strength   factor.   If  the
                                     value of SASLSF  is  0,  a
                                     call   to  saslencode()  or
                                     sasldecode()  is   unneces-
                                     sary.


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


                SASLDEFUSEREALM    Server authentication  realm
                                     used.


                SASLGETOPTCTX       The  context  for   getopt()
                                     callback.



SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                              saslgetprop(3SASL)



                SASLIPLOCALPORT     Local address string.


                SASLIPREMOTEPORT    Remote address string.


                SASLSERVICE         Service   passed    on    to
                                     sasl*new().


                SASLSERVERFQDN      Server  FQDN  passed  on  to
                                     sasl*new().


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


                SASLMECHNAME        Active  mechanism  name,  if
                                     any.


                SASLPLUGER         Similar to saslerrdetail().



ERORS
     SASLOK    The call to saslgetprop() was successful.



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

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




           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


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









































SunOS 5.11          Last change: 14 Oct 2003                    3






Simple Authentication Security Layer Library Functions
                                              saslgetprop(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    4