1SASL_DECODE(3)                    Cyrus SASL                    SASL_DECODE(3)
2
3
4

NAME

6       sasl_decode - Cyrus SASL documentation
7

SYNOPSIS

9       #include <sasl/sasl.h>
10
11       int sasl_decode(sasl_conn_t *conn,
12                      const char * input,
13                       unsigned inputlen,
14                      const char ** output,
15                      unsigned * outputlen);
16

DESCRIPTION

18       int sasl_decode(sasl_conn_t *conn,
19
20       const char * input,
21
22       unsigned inputlen,
23
24       const char ** output,
25
26       unsigned * outputlen);
27              sasl_decode decodes   data  received.  After  successful authen‐
28              tication this function should be called on all   data  received.
29              It   decodes   the  data  from encrypted or signed form to plain
30              data. If there was no security layer negotiated  the  output  is
31              identical to the input.
32
33              Parameters
34
35                     · conn – is the SASL connection context
36
37                     · output  –  contains  the  decoded  data  and  is  allo‐
38                       cated/freed by the library.
39
40                     · outputlen – length of output.
41
42              One should not give  sasl_decode  more  data  than  the  negoti‐
43              ated maxbufsize (see sasl_getprop(3)).
44
45              Note  that  sasl_decode  can  succeed and outputlen can be zero.
46              If this is the case  simply  wait  for   more   data   and  call
47              sasl_decode again.
48

RETURN VALUE

50       SASL   callback  functions should return SASL return codes.  See sasl.h
51       for a complete list. SASL_OK indicates success.
52
53       Other return codes indicate errors and should be handled.
54

SEE ALSO

56       RFC 4422,:saslman:sasl(3), sasl_encode(3), sasl_errors(3)
57

AUTHOR

59       The Cyrus Team
60

62       1993-2016, The Cyrus Team
63
64
65
66
672.1.27                         November 08, 2018                SASL_DECODE(3)
Impressum