1sasl_getprop(S3iSmApSlLe)Authentication Security Layer Library Funscatsilo_ngsetprop(3SASL)
2
3
4

NAME

6       sasl_getprop - get a SASL property
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsasl   [ library ... ]
10       #include <sasl/sasl.h>
11
12       int sasl_getprop(sasl_conn_t *conn, int propnum, const void **pvalue);
13
14

DESCRIPTION

16       Use  the  sasl_getprop() interface to get the value of a SASL property.
17       For example, after successful authentication, a server may want to know
18       the  authorization  name.  Similarly,  a client application may want to
19       know the strength of the security level that was negotiated.
20

PARAMETERS

22       conn       The SASL connection context.
23
24
25       propnum    The identifier for the property requested.
26
27
28       pvalue     The value of the SASL property. This value is filled in upon
29                  a successful call. Possible SASL values include:
30
31                  SASL_USERNAME        A  pointer  to  a  null-terminated user
32                                       name.
33
34
35                  SASL_SSF             The security  layer  security  strength
36                                       factor.  If the value of SASL_SSF is 0,
37                                       a    call    to    sasl_encode()     or
38                                       sasl_decode() is unnecessary.
39
40
41                  SASL_MAXOUTBUF       The   maximum  size  of  output  buffer
42                                       returned by the selected security mech‐
43                                       anism
44
45
46                  SASL_DEFUSERREALM    Server authentication realm used.
47
48
49                  SASL_GETOPTCTX       The context for getopt() callback.
50
51
52                  SASL_IPLOCALPORT     Local address string.
53
54
55                  SASL_IPREMOTEPORT    Remote address string.
56
57
58                  SASL_SERVICE         Service passed on to sasl_*_new().
59
60
61                  SASL_SERVERFQDN      Server FQDN passed on to sasl_*_new().
62
63
64                  SASL_AUTHSOURCE      Name   of  authentication  source  last
65                                       used. Useful for failed  authentication
66                                       tracking.
67
68
69                  SASL_MECHNAME        Active mechanism name, if any.
70
71
72                  SASL_PLUGERR         Similar to sasl_errdetail().
73
74
75

ERRORS

77       SASL_OK    The call to sasl_getprop() was successful.
78
79
80
81       See sasl_errors(3SASL) for information on SASL error codes.
82

ATTRIBUTES

84       See attributes(5) for descriptions of the following attributes:
85
86
87
88
89       ┌─────────────────────────────┬─────────────────────────────┐
90       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
91       ├─────────────────────────────┼─────────────────────────────┤
92       │Availability                 │SUNWlibsasl                  │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │Interface Stability          │Evolving                     │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │MT-Level                     │MT-Safe                      │
97       └─────────────────────────────┴─────────────────────────────┘
98

SEE ALSO

100       sasl_errors(3SASL), attributes(5)
101
102
103
104SunOS 5.11                        14 Oct 2003              sasl_getprop(3SASL)