]> git.sur5r.net Git - openldap/blob - include/ldap_pvt.h
Added ldap_pvt_tls_destroy() to cleanup TLS library on shutdown
[openldap] / include / ldap_pvt.h
1 /* $OpenLDAP$ */
2 /*
3  * Copyright 1998-2001 The OpenLDAP Foundation, Redwood City, California, USA
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted only as authorized by the OpenLDAP
8  * Public License.  A copy of this license is available at
9  * http://www.OpenLDAP.org/license.html or in file LICENSE in the
10  * top-level directory of the distribution.
11  */
12 /*
13  * ldap-pvt.h - Header for ldap_pvt_ functions. These are meant to be used
14  *              by the OpenLDAP distribution only.
15  */
16
17 #ifndef _LDAP_PVT_H
18 #define _LDAP_PVT_H 1
19
20 #include <ldap_cdefs.h>
21 #include <lber.h>                               /* get ber_slen_t */
22
23 LDAP_BEGIN_DECL
24
25 #define LDAP_PROTO_TCP 1 /* ldap://  */
26 #define LDAP_PROTO_UDP 2 /* reserved */
27 #define LDAP_PROTO_IPC 3 /* ldapi:// */
28
29 LDAP_F ( int )
30 ldap_pvt_url_scheme2proto LDAP_P((
31         const char * ));
32 LDAP_F ( int )
33 ldap_pvt_url_scheme2tls LDAP_P((
34         const char * ));
35
36 struct ldap_url_desc; /* avoid pulling in <ldap.h> */
37
38 LDAP_F( int )
39 ldap_url_parse_ext LDAP_P((
40         LDAP_CONST char *url,
41         struct ldap_url_desc **ludpp ));
42
43 LDAP_F ( int )
44 ldap_pvt_domain2dn LDAP_P((
45         LDAP_CONST char *domain,
46         char **dn ));
47
48 struct hostent; /* avoid pulling in <netdb.h> */
49
50 LDAP_F( char * )
51 ldap_pvt_ctime LDAP_P((
52         const time_t *tp,
53         char *buf ));
54
55 LDAP_F( char *) ldap_pvt_get_fqdn LDAP_P(( char * ));
56
57 LDAP_F( int )
58 ldap_pvt_gethostbyname_a LDAP_P((
59         const char *name, 
60         struct hostent *resbuf,
61         char **buf,
62         struct hostent **result,
63         int *herrno_ptr ));
64
65 LDAP_F( int )
66 ldap_pvt_gethostbyaddr_a LDAP_P((
67         const char *addr,
68         int len,
69         int type,
70         struct hostent *resbuf,
71         char **buf,
72         struct hostent **result,
73         int *herrno_ptr ));
74
75
76 /* charray.c */
77
78 LDAP_F( int )
79 ldap_charray_add LDAP_P((
80     char        ***a,
81     char        *s ));
82
83 LDAP_F( int )
84 ldap_charray_merge LDAP_P((
85     char        ***a,
86     char        **s ));
87
88 LDAP_F( void )
89 ldap_charray_free LDAP_P(( char **a ));
90
91 LDAP_F( int )
92 ldap_charray_inlist LDAP_P((
93     char        **a,
94     char        *s ));
95
96 LDAP_F( char ** )
97 ldap_charray_dup LDAP_P(( char **a ));
98
99 LDAP_F( char ** )
100 ldap_str2charray LDAP_P((
101         const char *str,
102         const char *brkstr ));
103
104 LDAP_F( char * )
105 ldap_charray2str LDAP_P((
106         char **array, const char* sep ));
107
108 /* url.c */
109 LDAP_F (void) ldap_pvt_hex_unescape LDAP_P(( char *s ));
110 LDAP_F (int) ldap_pvt_unhex( int c );
111
112 /* these macros assume 'x' is an ASCII x */
113 #define LDAP_DNSEPARATOR(c)     ((c) == ',' || (c) == ';')
114 #define LDAP_SEPARATOR(c)       ((c) == ',' || (c) == ';' || (c) == '+')
115 #define LDAP_SPACE(c)           ((c) == ' ' || (c) == '\t' || (c) == '\n')
116
117 #define LDAP_LOWER(c)           ( (c) >= 'a' && (c) <= 'z' )
118 #define LDAP_UPPER(c)           ( (c) >= 'A' && (c) <= 'Z' )
119 #define LDAP_ALPHA(c)           ( LDAP_LOWER(c) || LDAP_UPPER(c) )
120 #define LDAP_DIGIT(c)           ( (c) >= '0' && (c) <= '9' )
121 #define LDAP_ALNUM(c)           ( LDAP_ALPHA(c) || LDAP_DIGIT(c) )
122
123 #define LDAP_LEADKEYCHAR(c)     ( LDAP_ALPHA(c) )
124 #define LDAP_KEYCHAR(c)         ( LDAP_ALNUM(c) || (c) == '-' )
125 #define LDAP_LEADOIDCHAR(c)     ( LDAP_DIGIT(c) )
126 #define LDAP_OIDCHAR(c)         ( LDAP_DIGIT(c) || (c) == '.' )
127
128 #define LDAP_LEADATTRCHAR(c)    ( LDAP_LEADKEYCHAR(c) || LDAP_LEADOIDCHAR(c) )
129 #define LDAP_ATTRCHAR(c)                ( LDAP_KEYCHAR(c) || LDAP_OIDCHAR(c) )
130
131 #define LDAP_NEEDSESCAPE(c)     ((c) == '\\' || (c) == '"')
132
133 #ifdef HAVE_CYRUS_SASL
134 /* cyrus.c */
135 struct sasl_security_properties; /* avoid pulling in <sasl.h> */
136 LDAP_F (int) ldap_pvt_sasl_secprops LDAP_P((
137         const char *in,
138         struct sasl_security_properties *secprops ));
139
140 LDAP_F (void *) ldap_pvt_sasl_mutex_new LDAP_P((void));
141 LDAP_F (int) ldap_pvt_sasl_mutex_lock LDAP_P((void *mutex));
142 LDAP_F (int) ldap_pvt_sasl_mutex_unlock LDAP_P((void *mutex));
143 LDAP_F (void) ldap_pvt_sasl_mutex_dispose LDAP_P((void *mutex));
144
145 struct sockbuf; /* avoid pulling in <lber.h> */
146 LDAP_F (int) ldap_pvt_sasl_install LDAP_P(( struct sockbuf *, void * ));
147 #endif /* HAVE_CYRUS_SASL */
148
149 #define LDAP_PVT_SASL_LOCAL_SSF 71      /* SSF for Unix Domain Sockets */
150
151 struct ldap;
152
153 LDAP_F (int) ldap_open_internal_connection LDAP_P((
154         struct ldap **ldp, ber_socket_t *fdp ));
155
156 /* search.c */
157 LDAP_F( char * )
158 ldap_pvt_find_wildcard LDAP_P(( const char *s ));
159
160 LDAP_F( ber_slen_t )
161 ldap_pvt_filter_value_unescape LDAP_P(( char *filter ));
162
163 /* string.c */
164 LDAP_F( char * )
165 ldap_pvt_str2upper LDAP_P(( char *str ));
166
167 LDAP_F( char * )
168 ldap_pvt_str2lower LDAP_P(( char *str ));
169
170 /* tls.c */
171 LDAP_F (int) ldap_pvt_tls_get_option LDAP_P(( struct ldap *ld,
172         int option, void *arg ));
173 LDAP_F (int) ldap_pvt_tls_set_option LDAP_P(( struct ldap *ld,
174         int option, void *arg ));
175
176 LDAP_F (void) ldap_pvt_tls_destroy LDAP_P(( void ));
177 LDAP_F (int) ldap_pvt_tls_init LDAP_P(( void ));
178 LDAP_F (int) ldap_pvt_tls_accept LDAP_P(( Sockbuf *sb, void *ctx_arg ));
179 LDAP_F (int) ldap_pvt_tls_inplace LDAP_P(( Sockbuf *sb ));
180 LDAP_F (void *) ldap_pvt_tls_get_ctx LDAP_P(( Sockbuf *sb ));
181
182 LDAP_F (int) ldap_pvt_tls_init_default_ctx LDAP_P(( void ));
183
184 LDAP_F (char *) ldap_pvt_tls_get_peer LDAP_P(( void *ctx ));
185 LDAP_F (char *) ldap_pvt_tls_get_peer_dn LDAP_P(( void *ctx ));
186 LDAP_F (int) ldap_pvt_tls_get_strength LDAP_P(( void *ctx ));
187
188 LDAP_END_DECL
189
190 #include "ldap_pvt_uc.h"
191
192 #endif
193