sasl_setprop(3sasl)

1sasl_setprop(S3iSmApSlLe)Authentication Security Layer Library Funscatsilo_nssetprop(3SASL)
2
3
4

NAME

6       sasl_setprop - set a SASL property
7

SYNOPSIS

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

DESCRIPTION

16       Use  the  sasl_setprop() interface to set the value of a SASL property.
17       For example, an application can use sasl_setprop()  to  tell  the  SASL
18       liabrary about any external negotiated security layer like TLS.
19
20
21       sasl_setprop() uses the following flags.
22
23       SASL_AUTH_EXTERNAL    External  authentication  ID that is a pointer of
24                             type const char
25
26
27       SASL_SSF_EXTERNAL     External SSF active of type sasl_ssf_t
28
29
30       SASL_DEFUSERREALM     User realm that is a pointer of type const char
31
32
33       SASL_SEC_PROPS        sasl_security_properties_t,  that  can  be  freed
34                             after the call
35
36
37       SASL_IPLOCALPORT      A  string that describes the local ip and port in
38                             the form a.b.c.d:p or  [e:f:g:h:i:j:k:l]:port  or
39                             one    of   the   older   forms,   a.b.c.d;p   or
40                             e:f:g:j:i:j:k:l;port
41
42
43       SASL_IPREMOTEPORT     A string that describes the remote ip and port in
44                             the  form  a.b.c.d:p or [e:f:g:h:i:j:k:l]:port or
45                             one   of   the   older   forms,   a.b.c.d;p    or
46                             e:f:g:j:i:j:k:l;port
47
48

PARAMETERS

50       conn       The SASL connection context
51
52
53       propnum    The identifier for the property requested
54
55
56       pvalue     Contains  a pointer to the data. The application must ensure
57                  that the data type is correct, or the application can crash.
58
59

RETURN VALUES

61       sasl_setprop() returns an integer that  corresponds  to  a  SASL  error
62       code.
63

ERRORS

65       SASL_OK    The call to sasl_setprop() was successful.
66
67
68
69       See sasl_errors(3SASL) for information on SASL error codes.
70

ATTRIBUTES

72       See attributes(5) for descriptions of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │Availability                 │SUNWlibsasl                  │
81       ├─────────────────────────────┼─────────────────────────────┤
82       │Interface Stability          │Evolving                     │
83       ├─────────────────────────────┼─────────────────────────────┤
84       │MT-Level                     │MT-Safe                      │
85       └─────────────────────────────┴─────────────────────────────┘
86