saslgetprop(10 July 2001) saslgetprop(10 July 2001)

NAME
       saslgetprop - Get a SASL property



SYNOPSIS
       ##iinncclluuddee <>


       iinntt ssaassllggeettpprroopp((ssaassllccoonnnntt *conn,,
                       iinntt propnum,,
                       ccoonnsstt vvooiidd **** pvalue));;


DESCRIPTION
       ssaassllggeettpprroopp  gets the value of a SASL property. For example after suc-
       cessful authentication a server may  wish  to  know  the  authorization
       name.  Or  a  client  application  may wish to know the strength of the
       negotiated security layer.

       conn is the SASL connection object.  propnum is the identifier for  the
       property  requested and pvalue is filled in on success. List of proper-
       ties follows:

       SASLUSERNAME     -  pointer to NUL terminated user name
       SASLSSF          -  security layer security strength factor,
                            if 0, call to saslencode, sasldecode unnecessary
       SASLMAXOUTBUF    -  security layer max output buf unsigned
       SASLDEFUSERREALM -  server authentication realm used
       SASLGETOPTCTX    -  context for getopt callback
       SASLIPLOCALPORT  -  local address string
       SASLIPREMOTEPORT -  remote address string
       SASLSERVICE      -  service passed to sasl*new
       SASLSERVERFQDN   -  serverFQDN passed to sasl*new
       SASLAUTHSOURCE   -  name of auth source last used, useful for failed
                            authentication tracking
       SASLMECHNAME     -  active mechanism name, if any
       SASLPLUGERR      -  similar to saslerrdetail




RREETTUURRNN VVAALLUUEE
       Returns SASLOK on success. SASL error code on failure.


CCOONNFFOORRMMIINNGG TTOO
       RFC 2222

SEE ALSO
       sasl(3), saslerrors(3), saslservernew(3), saslclientnew(3)



SASL man pages                       SASL           saslgetprop(10 July 2001)