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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/* sasldb.h - SASLdb library header
* Rob Siemborski
* Tim Martin
*/
/*
* Copyright (c) 1998-2016 Carnegie Mellon University. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The name "Carnegie Mellon University" must not be used to
* endorse or promote products derived from this software without
* prior written permission. For permission or any other legal
* details, please contact
* Carnegie Mellon University
* Center for Technology Transfer and Enterprise Creation
* 4615 Forbes Avenue
* Suite 302
* Pittsburgh, PA 15213
* (412) 268-7393, fax: (412) 268-7395
* innovation@andrew.cmu.edu
*
* 4. Redistributions of any form whatsoever must retain the following
* acknowledgment:
* "This product includes software developed by Computing Services
* at Carnegie Mellon University (http://www.cmu.edu/computing/)."
*
* CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
* THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef SASLDB_H
#define SASLDB_H
#include "sasl.h"
#include "saslplug.h"
/*
* Note that some of these require a sasl_conn_t in order for
* the getcallback stuff to work correctly. This is great for
* when they are called from a plugin or the library but makes
* for much wierdness when an otherwise non-sasl application needs
* to make use of this functionality.
*/
int _sasldb_getdata(const sasl_utils_t *utils,
sasl_conn_t *conn,
const char *authid,
const char *realm,
const char *propName,
char *out, const size_t max_out, size_t *out_len);
/* pass NULL for data to delete it */
int _sasldb_putdata(const sasl_utils_t *utils,
sasl_conn_t *conn,
const char *authid,
const char *realm,
const char *propName,
const char *data, size_t data_len);
/* Should be run before any db access is attempted */
LIBSASL_API int _sasl_check_db(const sasl_utils_t *utils,
sasl_conn_t *conn);
/* These allow iterating through the keys of the database */
typedef void* sasldb_handle;
typedef int (* sasldb_list_callback_t) (const char *authid,
const char *realm,
const char *property,
void *rock);
LIBSASL_API sasldb_handle _sasldb_getkeyhandle(const sasl_utils_t *utils,
sasl_conn_t *conn);
LIBSASL_API int _sasldb_getnextkey(const sasl_utils_t *utils,
sasldb_handle handle, char *out,
const size_t max_out, size_t *out_len);
LIBSASL_API int _sasldb_releasekeyhandle(const sasl_utils_t *utils,
sasldb_handle handle);
LIBSASL_API int _sasldb_listusers(const sasl_utils_t *utils,
sasl_conn_t *context,
sasldb_list_callback_t callback,
void *callback_rock);
#if defined(KEEP_DB_OPEN)
void sasldb_auxprop_free (void *glob_context, const sasl_utils_t *utils);
#else
#define sasldb_auxprop_free NULL
#endif
/* The rest are implemented in allockey.c and individual drivers need not
* do so */
/* These two are aliases for getdata/putdata */
int _sasldb_getsecret(const sasl_utils_t *utils,
sasl_conn_t *context,
const char *auth_identity,
const char *realm,
sasl_secret_t ** secret);
int _sasldb_putsecret(const sasl_utils_t *utils,
sasl_conn_t *context,
const char *auth_identity,
const char *realm,
const sasl_secret_t * secret);
LIBSASL_API int _sasldb_parse_key(const char *key, const size_t key_len,
char *authid, const size_t max_authid,
char *realm, const size_t max_realm,
char *propName, const size_t max_propname);
/* This function is internal, but might be useful to have around */
int _sasldb_alloc_key(const sasl_utils_t *utils,
const char *auth_identity,
const char *realm,
const char *propName,
char **key,
size_t *key_len);
#endif /* SASLDB_H */
|
