File: sasl_checkpass.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 (56 lines) | stat: -rw-r--r-- 1,539 bytes parent folder | download | duplicates (6)
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
.. saslman:: sasl_checkpass(3)

.. _sasl-reference-manpages-library-sasl_checkpass:

===============================================
**sasl_checkpass** - Check a plaintext password
===============================================

Synopsis
========

.. code-block:: C

    #include <sasl/sasl.h>

    int sasl_checkpass(sasl_conn_t *conn,
                     const char *user,
                     unsigned userlen,
                     const char *pass,
                     unsigned passlen);

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

.. c:function:: int sasl_checkpass(sasl_conn_t *conn,
        const char *user,
        unsigned userlen,
        const char *pass,
        unsigned passlen)

        **sasl_checkpass**  will check a plaintext password. This is
        needed for protocols that had a login method  before  SASL
        (for  example  the LOGIN command in IMAP). The password is
        checked with the pwcheck_method. See :saslman:`sasl_callbacks(3)`  for
        information on how this parameter is set.


Return value
============

sasl_checkpass returns an integer which corresponds to one
of the following codes. :c:macro:`SASL_OK` indicates that the authentication  is  complete.  All  other  return codes indicate
errors and should either be handled or the  authentication
session  should  be quit.  See :saslman:`sasl_errors(3)` for meanings
of return codes.

Conforming to
=============

:rfc:`4422`

See Also
========

:saslman:`sasl(3)`, :saslman:`sasl_errors(3)`, :saslman:`sasl_callbacks(3)`,
:saslman:`sasl_setpass(3)`