---
name: "sasl_setprop"
section: "3"
platform: "linux"
package: "libsasl2-dev"
version: "2.1.28+dfsg1-9"
release: "Debian 13 (Trixie)"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/sasl_setprop"
---

# sasl\_setprop(3)

Cyrus SASL documentation

## 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/3.md)*, *[sasl\_errors(3)](/sasl_errors/3.md)*

## AUTHOR

The Cyrus Team

## COPYRIGHT

1993-2016, The Cyrus Team