Add `gnutls/dtls.h' to the distribution.
[gnutls.git] / lib / gnutls_str.h
blob39d9047eb120ee54ad3e5e173fba689692939ff0
1 /*
2 * Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009,
3 * 2010 Free Software Foundation, Inc.
5 * Author: Nikos Mavrogiannopoulos
7 * This file is part of GnuTLS.
9 * The GnuTLS is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public License
11 * as published by the Free Software Foundation; either version 2.1 of
12 * the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
22 * USA
26 #ifndef GNUTLS_STR_H
27 #define GNUTLS_STR_H
29 #include <gnutls_int.h>
30 #include <gnutls_datum.h>
32 void _gnutls_str_cpy (char *dest, size_t dest_tot_size, const char *src);
33 void _gnutls_mem_cpy (char *dest, size_t dest_tot_size, const char *src,
34 size_t src_size);
35 void _gnutls_str_cat (char *dest, size_t dest_tot_size, const char *src);
37 typedef struct
39 opaque *allocd; /* pointer to allocated data */
40 opaque *data; /* API: pointer to data to copy from */
41 size_t max_length;
42 size_t length; /* API: current length */
43 } gnutls_buffer_st;
45 void _gnutls_buffer_init (gnutls_buffer_st *);
46 void _gnutls_buffer_clear (gnutls_buffer_st *);
47 int _gnutls_buffer_resize (gnutls_buffer_st *, size_t new_size);
49 int _gnutls_buffer_append_str (gnutls_buffer_st *, const char *str);
50 int _gnutls_buffer_append_data (gnutls_buffer_st *, const void *data,
51 size_t data_size);
53 #include <gnutls_num.h>
55 void _gnutls_buffer_replace_data( gnutls_buffer_st * buf, gnutls_datum_t * data);
57 int _gnutls_buffer_append_prefix (gnutls_buffer_st * buf, int pfx_size, size_t data_size);
59 int _gnutls_buffer_append_mpi (gnutls_buffer_st * buf, int pfx_size, bigint_t, int lz);
61 int _gnutls_buffer_append_data_prefix (gnutls_buffer_st * buf, int pfx_size,
62 const void *data, size_t data_size);
63 void _gnutls_buffer_pop_data (gnutls_buffer_st *, void *, size_t * size);
64 void _gnutls_buffer_pop_datum (gnutls_buffer_st *, gnutls_datum_t *,
65 size_t max_size);
67 int _gnutls_buffer_pop_prefix (gnutls_buffer_st * buf, size_t * data_size,
68 int check);
70 int _gnutls_buffer_pop_data_prefix (gnutls_buffer_st * buf, void *data,
71 size_t * data_size);
73 int _gnutls_buffer_pop_datum_prefix (gnutls_buffer_st * buf,
74 gnutls_datum_t * data);
75 int _gnutls_buffer_to_datum (gnutls_buffer_st * str, gnutls_datum_t * data);
77 int _gnutls_buffer_escape (gnutls_buffer_st * dest,
78 const char *const invalid_chars);
79 int _gnutls_buffer_unescape (gnutls_buffer_st * dest);
81 #ifndef __attribute__
82 /* This feature is available in gcc versions 2.5 and later. */
83 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5)
84 #define __attribute__(Spec) /* empty */
85 #endif
86 #endif
88 int _gnutls_buffer_append_printf (gnutls_buffer_st * dest, const char *fmt,
89 ...)
90 __attribute__ ((format (printf, 2, 3)));
92 char *_gnutls_bin2hex (const void *old, size_t oldlen, char *buffer,
93 size_t buffer_size, const char *separator);
94 int _gnutls_hex2bin (const opaque * hex_data, int hex_size, opaque * bin_data,
95 size_t * bin_size);
97 int _gnutls_hostname_compare (const char *certname, size_t certnamesize,
98 const char *hostname);
99 #define MAX_CN 256
101 #define BUFFER_APPEND(b, x, s) { \
102 ret = _gnutls_buffer_append_data(b, x, s); \
103 if (ret < 0) { \
104 gnutls_assert(); \
105 return ret; \
109 #define BUFFER_APPEND_PFX(b, x, s) { \
110 ret = _gnutls_buffer_append_data_prefix(b, 32, x, s); \
111 if (ret < 0) { \
112 gnutls_assert(); \
113 return ret; \
117 #define BUFFER_APPEND_NUM(b, s) { \
118 ret = _gnutls_buffer_append_prefix(b, 32, s); \
119 if (ret < 0) { \
120 gnutls_assert(); \
121 return ret; \
126 #define BUFFER_POP(b, x, s) { \
127 size_t is = s; \
128 _gnutls_buffer_pop_data(b, x, &is); \
129 if (is != s) { \
130 ret = GNUTLS_E_PARSING_ERROR; \
131 gnutls_assert(); \
132 goto error; \
136 #define BUFFER_POP_DATUM(b, o) { \
137 gnutls_datum_t d; \
138 ret = _gnutls_buffer_pop_datum_prefix(b, &d); \
139 if (ret >= 0) \
140 ret = _gnutls_set_datum (o, d.data, d.size); \
141 if (ret < 0) { \
142 gnutls_assert(); \
143 goto error; \
147 #define BUFFER_POP_NUM(b, o) { \
148 size_t s; \
149 ret = _gnutls_buffer_pop_prefix(b, &s, 0); \
150 if (ret < 0) { \
151 gnutls_assert(); \
152 goto error; \
154 o = s; \
157 #endif