sasl_getrealm_t(3sasl)

1sasl_getrealmS_itm(p3lSeASALu)thentication Security Layer LibrarysFausnlc_tgieotnrsealm_t(3SASL)
2
3
4

NAME

6       sasl_getrealm_t - the realm acquisition callback function
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsasl   [ library ... ]
10       #include <sasl/sasl.h>
11
12       int sasl_getrealm_t(void *context, int id, const char **availrealms,
13            const char **result);
14
15

DESCRIPTION

17       Use  the  sasl_getrealm_t()  functionwhen  there is an interaction with
18       SASL_CB_GETREALM as the type.
19
20
21       If a mechanism would use this callback, but it is not present, then the
22       first  realm  listed  is  automatically selected. A mechanism can still
23       force the existence of a getrealm callback by SASL_CB_GETREALM  to  its
24       required_prompts list.
25

PARAMETERS

27       context        The context from the callback record
28
29
30       id             The callback ID (SASL_CB_GETREALM)
31
32
33       availrealms    A  string  list of the vailable realms. availrealms is a
34                      null-terminated sting that can be empty.
35
36
37       result         The chosen realm. result is a null-terminated string.
38
39

RETURN VALUES

41       Like other SASL callback functions, sasl_getrealm_t() returns an  inte‐
42       ger  that corresponds to a SASL error code. See <sasl.h> for a complete
43       list of SASL error codes.
44

ERRORS

46       SASL_OK    The call to sasl_getrealm_t() was successful.
47
48
49
50       See sasl_errors(3SASL) for information on SASL error codes.
51

ATTRIBUTES

53       See attributes(5) for descriptions of the following attributes:
54
55
56
57
58       ┌─────────────────────────────┬─────────────────────────────┐
59       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │Availability                 │SUNWlibsasl                  │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │Interface Stability          │Evolving                     │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │MT-Level                     │MT-Safe                      │
66       └─────────────────────────────┴─────────────────────────────┘
67