sasl_checkpass(3sasl)

1sasl_checkpasSsi(m3pSlAeSLA)uthentication Security Layer Library Fsuansclt_icohnesckpass(3SASL)
2
3
4

NAME

6       sasl_checkpass - check a plaintext password
7

SYNOPSIS

9       cc [ flag ... ] file ... -lsasl   [ library ... ]
10       #include <sasl/sasl.h>
11
12       int sasl_checkpass(sasl_conn_t *conn, const char *user, unsigned userlen,
13            const char *pass, unsigned passlen);
14
15

DESCRIPTION

17       The   sasl_checkpass()  interface  checks  a  plaintext  password.  The
18       sasl_checkpass() interface is used  for  protocols  that  had  a  login
19       method  before  SASL, for example, the LOGIN command in IMAP. The pass‐
20       word is checked with the pwcheck_method.
21
22
23       The sasl_checkpass() interface is a server interface. You cannot use it
24       to check passwords from a client.
25
26
27       The sasl_checkpass() interface checks the posible repositories until it
28       succeeds    or    there    are     no     more     repositories.     If
29       sasl_server_userdb_checkpass_t is registered, sasl_checkpass() tries it
30       first.
31
32
33       Use the pwcheck_method SASL option to specify which pwcheck methods  to
34       use.
35
36
37       The  sasl_checkpass() interface supports the transition of passwords if
38       the SASL option auto_transition is on.
39
40
41       If user is NULL, check is plaintext passwords are enabled.
42

PARAMETERS

44       conn       The sasl_conn_t for which the request is being made
45
46
47       pass       Plaintext password to check
48
49
50       passlen    The length of pass
51
52
53       user       User to query in current user_domain
54
55
56       userlen    The length of username.
57
58

RETURN VALUES

60       sasl_checkpass() returns an integer that corresponds to  a  SASL  error
61       code.
62

ERRORS

64       SASL_OK    Indicates that the authentication is complete
65
66
67
68       All other error codes indicate an error situation that must be handled,
69       or the authentication session should be  quit.  See  sasl_errors(3SASL)
70       for information on SASL error codes.
71

ATTRIBUTES

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