dwww Home | Manual pages | Find package

SASL_SETPROP(3)                   Cyrus SASL                   SASL_SETPROP(3)

NAME
       sasl_setprop - Cyrus SASL documentation

SYNOPSIS
       #include <sasl/sasl.h>

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

DESCRIPTION
       int sasl_setprop(sasl_conn_t *conn,

       int propnum,

       const void * pvalue)
              sasl_setprop   sets the value of a SASL property. For example an
              application should tell the SASL library about  any external ne-
              gotiated security layer (i.e. TLS).

              Parametersconn – is the SASL connection context

                     • propnum – is the identifier for the property requested

                     • pvalue –

                       contains   a pointer  to  the  data. It is the applica-
                       tions job to make sure this type is correct. This is an
                       easy way to crash  a program.

                       • SASL_AUTH_EXTERNAL   -   external  authentication  ID
                         (const char *)

                       • SASL_SSF_EXTERNAL   -    external   SSF   active   --
                         (sasl_ssf_t)

                       • SASL_DEFUSERREALM - user realm (const char *)

                       • SASL_SEC_PROPS   -    sasl_security_properties_t (may
                         be freed after call)

                       •

                         SASL_IPLOCALPORT - string describing the local ip and
                         port in the form
                                ”a.b.c.d;p”, or “e:f:g:h:i:j:k:l;port”

                       •

                         SASL_IPREMOTEPORT  -  string describing the remote ip
                         and port in the form
                                ”a.b.c.d;p”, or “e:f:g:h:i:j:k:l;port”

RETURN VALUE
       SASL  callback  functions should return SASL return codes.  See  sasl.h
       for a complete list. SASL_OK indicates success.

       Other return codes indicate errors and should be handled.

SEE ALSO
       RFC 4422,:saslman:sasl(3), sasl_errors(3)

AUTHOR
       The Cyrus Team

COPYRIGHT
       1993-2022, The Cyrus Team

2.1.28                            2022-11-22                   SASL_SETPROP(3)

Generated by dwww version 1.15 on Mon Jun 24 01:32:34 CEST 2024.