---
name: "sasl_getprop"
section: "3"
platform: "macos"
package: "passwordserver_sasl"
version: "215"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/sasl_getprop"
---

# sasl\_getprop(3)

Get a SASL property

## NAME

sasl\_getprop - Get a SASL property

## SYNOPSIS

```
#include <sasl/sasl.h>

int sasl_getprop(sasl_conn_t *conn,
			 int propnum,
			 const void ** pvalue);
```

## DESCRIPTION

**sasl\_getprop** gets the value of a SASL property. For example after successful 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 properties follows:

```
SASL_USERNAME     -  pointer to NUL terminated user name
SASL_SSF          -  security layer security strength factor,
                     if 0, call to sasl_encode, sasl_decode unnecessary
SASL_MAXOUTBUF    -  security layer max output buf unsigned
SASL_DEFUSERREALM -  server authentication realm used
SASL_GETOPTCTX    -  context for getopt callback
SASL_IPLOCALPORT  -  local address string
SASL_IPREMOTEPORT -  remote address string
SASL_SERVICE      -  service passed to sasl_*_new
SASL_SERVERFQDN   -  serverFQDN passed to sasl_*_new
SASL_AUTHSOURCE   -  name of auth source last used, useful for failed
                     authentication tracking
SASL_MECHNAME     -  active mechanism name, if any
SASL_PLUGERR      -  similar to sasl_errdetail
```

## RETURN VALUE

Returns SASL\_OK on success. SASL error code on failure.

## CONFORMING TO

RFC 4422

## SEE ALSO

[sasl(3)](/sasl/3.md), [sasl\_errors(3)](/sasl_errors/3.md), [sasl\_server\_new(3)](/sasl_server_new/3.md), [sasl\_client\_new(3)](/sasl_client_new/3.md)