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

# sasl\_getrealm\_t(3)

Realm Acquisition Callback

## NAME

sasl\_getrealm\_t - Realm Acquisition Callback

## SYNOPSIS

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

int sasl_getrealm_t(void *context, int id,
			 const char **availrealms,
                    const char **result)
```

## DESCRIPTION

**sasl\_getrealm\_t** is used when there is an interaction with SASL\_CB\_GETREALM as the type.

If a mechanism would use this callback, but it is not present, then the first realm listed is automatically selected.  (Note that a mechanism may still force the existence of a getrealm callback by SASL\_CB\_GETREALM to its required\_prompts list).

*context* context from the callback record

*id* callback ID (SASL\_CB\_GETREALM)

*availrealms* A string list of the available realms.  NULL terminated, may be empty.

*result* The chosen realm. (a NUL terminated string)

## RETURN VALUE

SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL\_OK indicates success.

## SEE ALSO

[sasl(3)](/sasl/3.md), [sasl\_callbacks(3)](/sasl_callbacks/3.md)