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 negotiated security layer (i.e. TLS).

              Parameters

                     • conn – is the SASL connection context

                     • propnum – is the identifier for the property requested

                     • pvalue –

                       contains  a pointer  to  the  data. It is the applications 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-2016, The Cyrus Team

2.1.28                                             2025-02-28                                    SASL_SETPROP(3)