1sasl_seterrorS(i3mSpAlSeL)Authentication Security Layer Library Fusnacstli_osnesterror(3SASL)
2
3
4

NAME

6       sasl_seterror - set the error string
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsasl   [ library ... ]
10       #include <sasl/sasl.h>
11
12       void sasl_seterror(sasl_conn_t *conn, unsigned flags,
13            const char *fmt, ...);
14
15

DESCRIPTION

17       The  sasl_seterror()  interface  sets  the  error  string  that will be
18       returned by sasl_errdetail(3SASL).  Use  syslog(3C)  style  formatting,
19       that is, use printf()—style with %m as the most recent errno error.
20
21
22       The  sasl_seterror()  interface  is  primarily  used by server callback
23       functions and internal plug-ins, for example, with the sasl_authorize_t
24       callback.  The  sasl_seterror()  interface  triggers a call to the SASL
25       logging callback, if any, with a level  of  SASL_LOG_FAIL,  unless  the
26       SASL_NOLOG flag is set.
27
28
29       Make  the  message string sensitive to the current language setting. If
30       there is no SASL_CB_LANGUAGE  callback,  message  strings  must  be  i-
31       default.  Otherwise,  UTF-8 is used. Use of RFC 2482 for mixed-language
32       text is encouraged.
33
34
35       If the value of conn is NULL, the sasl_seterror() interface fails.
36

PARAMETERS

38       conn     The sasl_conn_t for which the call to sasl_seterror() applies.
39
40
41       flags    If set to SASL_NOLOG,  the  call  to  sasl_seterror()  is  not
42                logged.
43
44
45       fmt      A syslog(3C) style format string.
46
47

RETURN VALUES

49       sasl_seterror() has no return values.
50

ATTRIBUTES

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

SEE ALSO

68       sasl_errdetail(3SASL), syslog(3C), attributes(5)
69
70
71       Whistler,  K. and Adams, G. RFC 2482, Language Tagging in Unicode Plain
72       Text. Network Working Group. January 1999.
73
74
75
76SunOS 5.11                        14 Oct 2003             sasl_seterror(3SASL)
Impressum