2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2013 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
15 /* Portions Copyright (c) 1996 Regents of the University of Michigan.
16 * All rights reserved.
18 * Redistribution and use in source and binary forms are permitted
19 * provided that this notice is preserved and that due credit is given
20 * to the University of Michigan at Ann Arbor. The name of the University
21 * may not be used to endorse or promote products derived from this
22 * software without specific prior written permission. This software
23 * is provided ``as is'' without express or implied warranty.
29 #include <ldap_cdefs.h>
33 /* This is NOT a bogus extern declaration (unlike ldap_debug) */
34 LDAP_LDIF_V (int) ldif_debug;
36 #define LDIF_LINE_WIDTH 76 /* default maximum length of LDIF lines */
37 #define LDIF_LINE_WIDTH_MAX ((ber_len_t)-1) /* maximum length of LDIF lines */
38 #define LDIF_LINE_WIDTH_WRAP(wrap) ((wrap) == 0 ? LDIF_LINE_WIDTH : (wrap))
41 * Macro to calculate maximum number of bytes that the base64 equivalent
42 * of an item that is "len" bytes long will take up. Base64 encoding
43 * uses one byte for every six bits in the value plus up to two pad bytes.
45 #define LDIF_BASE64_LEN(len) (((len) * 4 / 3 ) + 3)
48 * Macro to calculate maximum size that an LDIF-encoded type (length
49 * tlen) and value (length vlen) will take up: room for type + ":: " +
50 * first newline + base64 value + continued lines. Each continued line
51 * needs room for a newline and a leading space character.
53 #define LDIF_SIZE_NEEDED(nlen,vlen) \
54 ((nlen) + 4 + LDIF_BASE64_LEN(vlen) \
55 + ((LDIF_BASE64_LEN(vlen) + (nlen) + 3) / LDIF_LINE_WIDTH * 2 ))
57 #define LDIF_SIZE_NEEDED_WRAP(nlen,vlen,wrap) \
58 ((nlen) + 4 + LDIF_BASE64_LEN(vlen) \
59 + ((wrap) == 0 ? ((LDIF_BASE64_LEN(vlen) + (nlen) + 3) / ( LDIF_LINE_WIDTH ) * 2 ) : \
60 ((wrap) == LDIF_LINE_WIDTH_MAX ? 0 : ((LDIF_BASE64_LEN(vlen) + (nlen) + 3) / (wrap) * 2 ))))
63 ldif_parse_line LDAP_P((
64 LDAP_CONST char *line,
70 ldif_parse_line2 LDAP_P((
77 ldif_open_url LDAP_P(( LDAP_CONST char *urlstr ));
80 ldif_fetch_url LDAP_P((
81 LDAP_CONST char *line,
86 ldif_getline LDAP_P(( char **next ));
89 ldif_countlines LDAP_P(( LDAP_CONST char *line ));
91 /* ldif_ropen, rclose, read_record - just for reading LDIF files,
92 * no special open/close needed to write LDIF files.
94 typedef struct LDIFFP {
99 LDAP_LDIF_F( LDIFFP * )
100 ldif_open LDAP_P(( LDAP_CONST char *file, LDAP_CONST char *mode ));
103 ldif_close LDAP_P(( LDIFFP * ));
106 ldif_read_record LDAP_P((
108 unsigned long *lineno,
113 ldif_must_b64_encode_register LDAP_P((
114 LDAP_CONST char *name,
115 LDAP_CONST char *oid ));
118 ldif_must_b64_encode_release LDAP_P(( void ));
120 #define LDIF_PUT_NOVALUE 0x0000 /* no value */
121 #define LDIF_PUT_VALUE 0x0001 /* value w/ auto detection */
122 #define LDIF_PUT_TEXT 0x0002 /* assume text */
123 #define LDIF_PUT_BINARY 0x0004 /* assume binary (convert to base64) */
124 #define LDIF_PUT_B64 0x0008 /* pre-converted base64 value */
126 #define LDIF_PUT_COMMENT 0x0010 /* comment */
127 #define LDIF_PUT_URL 0x0020 /* url */
128 #define LDIF_PUT_SEP 0x0040 /* separator */
134 LDAP_CONST char *name,
135 LDAP_CONST char *val,
139 ldif_sput_wrap LDAP_P((
142 LDAP_CONST char *name,
143 LDAP_CONST char *val,
147 LDAP_LDIF_F( char * )
150 LDAP_CONST char *name,
151 LDAP_CONST char *val,
154 LDAP_LDIF_F( char * )
155 ldif_put_wrap LDAP_P((
157 LDAP_CONST char *name,
158 LDAP_CONST char *val,
163 ldif_is_not_printable LDAP_P((
164 LDAP_CONST char *val,