File: sasl_encode64.rst.txt

package info (click to toggle)
cyrus-sasl2 2.1.27%2Bdfsg-2.1%2Bdeb11u1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 19,940 kB
  • sloc: ansic: 58,942; javascript: 8,745; sh: 4,843; java: 1,614; xml: 1,498; makefile: 1,265; python: 342; perl: 199
file content (60 lines) | stat: -rw-r--r-- 1,636 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.. saslman:: sasl_encode64(3)

.. _sasl-reference-manpages-library-sasl_encode64:


========================================
**sasl_encode64** - Encode base64 string
========================================

Synopsis
========

.. code-block:: C

    #include <sasl/saslutil.h>

    int sasl_encode64(const char * input,
                    unsigned inputlen,
                    const char ** output,
                    unsigned outmax,
                    unsigned * outputlen);

Description
===========

Use the **sasl_encode64()** interface to convert an octet string into a base64
string. This routine is useful for SASL profiles that use base64, such as the
IMAP (IMAP4) and POP (POP_AUTH) profiles. The output is null‐terminated. If
outlen is non‐NULL, the length is placed in the outlen.

.. c:function:: int sasl_encode64(const char * input,
            unsigned inputlen,
            const char ** output,
            unsigned outmax,
            unsigned * outputlen);

    :param input: input data.

    :param inputlen: length of the input data.

    :param output: contains the decoded data. The value of out can be the
        same as in. However, there must be enough space.

    :param outputlen: length of `output`.

    :param outmax: The maximum size of the output buffer.

Return Value
============

SASL functions should return SASL return codes.
See sasl.h for a complete list. :c:macro:`SASL_OK` indicates success.

Other return codes indicate errors and should be handled.

See Also
========

:rfc:`4422`,:saslman:`sasl(3)`, :saslman:`sasl_decode64(3)`,
:saslman:`sasl_errors(3)`, :saslman:`sasl_encode(3)`