summaryrefslogtreecommitdiff
path: root/beecrypt/base64.h
blob: e775b9948dfaa76d6bd4006d249c6e7925054419 (plain)
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
/*
 * Copyright (c) 2000, 2002 Virtual Unlimited B.V.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

/*!\file base64.h
 * \brief Base64 encoding and decoding, headers.
 * \author Bob Deblier <bob.deblier@pandora.be>
 */

#ifndef _BASE64_H
#define _BASE64_H

#include "beecrypt.h"

/*!\
 * Decode white space character set (default).
 */
extern const char* b64decode_whitespace;
#define B64DECODE_WHITESPACE	" \f\n\r\t\v"

/*!\
 * Encode 72 characters per line (default).
 */
extern int b64encode_chars_per_line;
#define B64ENCODE_CHARS_PER_LINE	72

/*!\
 * Encode end-of-line string (default).
 */
extern const char* b64encode_eolstr;
#define B64ENCODE_EOLSTR	"\n"

#ifdef __cplusplus
extern "C" {
#endif

/*!
 * Encode chunks of 3 bytes of binary input into 4 bytes of base64 output.
 * \param data binary data
 * \param ns no. bytes of data (0 uses strlen(data))
 * \return (malloc'd) base64 string
 */
BEECRYPTAPI
char* b64encode(const void* data, size_t ns)
	/*@*/;

/*!
 * Encode crc of binary input data into 5 bytes of base64 output.
 * \param data binary data
 * \param ns no. bytes of binary data
 * \return (malloc'd) base64 string
 */
BEECRYPTAPI
char* b64crc(const unsigned char* data, size_t ns)
	/*@*/;

/*!
 * Decode chunks of 4 bytes of base64 input into 3 bytes of binary output.
 * \param s base64 string
 * \retval datap address of (malloc'd) binary data
 * \retval lenp	 address of no. bytes of binary data
 * \return 0 on success, 1: s == NULL, 2: bad length, 3: bad char
 */
BEECRYPTAPI
int b64decode(const char* s, void** datap, size_t* lenp)
	/*@modifies *datap, *lenp @*/;

/*!
 */
BEECRYPTAPI
char*		b64enc(const memchunk*)
	/*@*/;

/*!
 */
BEECRYPTAPI
memchunk*	b64dec(const char*)
	/*@*/;

#ifdef __cplusplus
}
#endif

#endif