/src/gnutls/lib/x509_b64.c
Line  | Count  | Source (jump to first uncovered line)  | 
1  |  | /*  | 
2  |  |  * Copyright (C) 2000-2012 Free Software Foundation, Inc.  | 
3  |  |  * Copyright (C) 2017 Red Hat, Inc.  | 
4  |  |  *  | 
5  |  |  * Author: Nikos Mavrogiannopoulos  | 
6  |  |  *  | 
7  |  |  * This file is part of GnuTLS.  | 
8  |  |  *  | 
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.  | 
13  |  |  *  | 
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.  | 
18  |  |  *  | 
19  |  |  * You should have received a copy of the GNU Lesser General Public License  | 
20  |  |  * along with this program.  If not, see <https://www.gnu.org/licenses/>  | 
21  |  |  *  | 
22  |  |  */  | 
23  |  |  | 
24  |  | /* Functions that relate to base64 encoding and decoding.  | 
25  |  |  */  | 
26  |  |  | 
27  |  | #include "gnutls_int.h"  | 
28  |  | #include "errors.h"  | 
29  |  | #include "datum.h"  | 
30  |  | #include "x509_b64.h"  | 
31  |  | #include <nettle/base64.h>  | 
32  |  |  | 
33  |  | #define INCR(what, size, max_len)                       \  | 
34  | 0  |   do {                                            \ | 
35  | 0  |     what += size;                           \  | 
36  | 0  |     if (what > max_len) {                   \ | 
37  | 0  |       gnutls_assert();                \  | 
38  | 0  |       gnutls_free(result->data);      \  | 
39  | 0  |       result->data = NULL;            \  | 
40  | 0  |       return GNUTLS_E_INTERNAL_ERROR; \  | 
41  | 0  |     }                                       \  | 
42  | 0  |   } while (0)  | 
43  |  |  | 
44  |  | /* encodes data and puts the result into result (locally allocated)  | 
45  |  |  * The result_size (including the null terminator) is the return value.  | 
46  |  |  */  | 
47  |  | int _gnutls_fbase64_encode(const char *msg, const uint8_t *data,  | 
48  |  |          size_t data_size, gnutls_datum_t *result)  | 
49  | 0  | { | 
50  | 0  |   int tmp;  | 
51  | 0  |   unsigned int i;  | 
52  | 0  |   uint8_t tmpres[66];  | 
53  | 0  |   uint8_t *ptr;  | 
54  | 0  |   char top[80];  | 
55  | 0  |   char bottom[80];  | 
56  | 0  |   size_t size, max, bytes;  | 
57  | 0  |   int pos, top_len = 0, bottom_len = 0;  | 
58  | 0  |   unsigned raw_encoding = 0;  | 
59  |  | 
  | 
60  | 0  |   if (msg == NULL || msg[0] == 0)  | 
61  | 0  |     raw_encoding = 1;  | 
62  |  | 
  | 
63  | 0  |   if (!raw_encoding) { | 
64  | 0  |     if (strlen(msg) > 50) { | 
65  | 0  |       gnutls_assert();  | 
66  | 0  |       return GNUTLS_E_BASE64_ENCODING_ERROR;  | 
67  | 0  |     }  | 
68  |  |  | 
69  | 0  |     _gnutls_str_cpy(top, sizeof(top), "-----BEGIN ");  | 
70  | 0  |     _gnutls_str_cat(top, sizeof(top), msg);  | 
71  | 0  |     _gnutls_str_cat(top, sizeof(top), "-----\n");  | 
72  |  | 
  | 
73  | 0  |     _gnutls_str_cpy(bottom, sizeof(bottom), "-----END ");  | 
74  | 0  |     _gnutls_str_cat(bottom, sizeof(bottom), msg);  | 
75  | 0  |     _gnutls_str_cat(bottom, sizeof(bottom), "-----\n");  | 
76  |  | 
  | 
77  | 0  |     top_len = strlen(top);  | 
78  | 0  |     bottom_len = strlen(bottom);  | 
79  | 0  |   }  | 
80  |  |  | 
81  | 0  |   max = B64FSIZE(top_len + bottom_len, data_size);  | 
82  |  | 
  | 
83  | 0  |   result->data = gnutls_malloc(max + 1);  | 
84  | 0  |   if (result->data == NULL) { | 
85  | 0  |     gnutls_assert();  | 
86  | 0  |     return GNUTLS_E_MEMORY_ERROR;  | 
87  | 0  |   }  | 
88  |  |  | 
89  | 0  |   bytes = 0;  | 
90  | 0  |   INCR(bytes, top_len, max);  | 
91  | 0  |   pos = top_len;  | 
92  |  | 
  | 
93  | 0  |   memcpy(result->data, top, top_len);  | 
94  |  | 
  | 
95  | 0  |   for (i = 0; i < data_size; i += 48) { | 
96  | 0  |     if (data_size - i < 48)  | 
97  | 0  |       tmp = data_size - i;  | 
98  | 0  |     else  | 
99  | 0  |       tmp = 48;  | 
100  |  | 
  | 
101  | 0  |     size = BASE64_ENCODE_RAW_LENGTH(tmp);  | 
102  | 0  |     if (sizeof(tmpres) < size)  | 
103  | 0  |       return gnutls_assert_val(  | 
104  | 0  |         GNUTLS_E_BASE64_ENCODING_ERROR);  | 
105  |  |  | 
106  | 0  |     base64_encode_raw((void *)tmpres, tmp, &data[i]);  | 
107  |  | 
  | 
108  | 0  |     INCR(bytes, size + 1, max);  | 
109  | 0  |     ptr = &result->data[pos];  | 
110  |  | 
  | 
111  | 0  |     memcpy(ptr, tmpres, size);  | 
112  | 0  |     ptr += size;  | 
113  | 0  |     pos += size;  | 
114  | 0  |     if (!raw_encoding) { | 
115  | 0  |       *ptr++ = '\n';  | 
116  | 0  |       pos++;  | 
117  | 0  |     } else { | 
118  | 0  |       bytes--;  | 
119  | 0  |     }  | 
120  | 0  |   }  | 
121  |  |  | 
122  | 0  |   INCR(bytes, bottom_len, max);  | 
123  |  |  | 
124  | 0  |   memcpy(&result->data[bytes - bottom_len], bottom, bottom_len);  | 
125  | 0  |   result->data[bytes] = 0;  | 
126  | 0  |   result->size = bytes;  | 
127  |  | 
  | 
128  | 0  |   return max + 1;  | 
129  | 0  | }  | 
130  |  |  | 
131  |  | /**  | 
132  |  |  * gnutls_pem_base64_encode:  | 
133  |  |  * @msg: is a message to be put in the header (may be %NULL)  | 
134  |  |  * @data: contain the raw data  | 
135  |  |  * @result: the place where base64 data will be copied  | 
136  |  |  * @result_size: holds the size of the result  | 
137  |  |  *  | 
138  |  |  * This function will convert the given data to printable data, using  | 
139  |  |  * the base64 encoding. This is the encoding used in PEM messages.  | 
140  |  |  *  | 
141  |  |  * The output string will be null terminated, although the output size will  | 
142  |  |  * not include the terminating null.  | 
143  |  |  *  | 
144  |  |  * Returns: On success %GNUTLS_E_SUCCESS (0) is returned,  | 
145  |  |  *   %GNUTLS_E_SHORT_MEMORY_BUFFER is returned if the buffer given is  | 
146  |  |  *   not long enough, or 0 on success.  | 
147  |  |  **/  | 
148  |  | int gnutls_pem_base64_encode(const char *msg, const gnutls_datum_t *data,  | 
149  |  |            char *result, size_t *result_size)  | 
150  | 0  | { | 
151  | 0  |   gnutls_datum_t res;  | 
152  | 0  |   int ret;  | 
153  |  | 
  | 
154  | 0  |   ret = _gnutls_fbase64_encode(msg, data->data, data->size, &res);  | 
155  | 0  |   if (ret < 0)  | 
156  | 0  |     return ret;  | 
157  |  |  | 
158  | 0  |   if (result == NULL || *result_size < (unsigned)res.size) { | 
159  | 0  |     gnutls_free(res.data);  | 
160  | 0  |     *result_size = res.size + 1;  | 
161  | 0  |     return GNUTLS_E_SHORT_MEMORY_BUFFER;  | 
162  | 0  |   } else { | 
163  | 0  |     memcpy(result, res.data, res.size);  | 
164  | 0  |     gnutls_free(res.data);  | 
165  | 0  |     *result_size = res.size;  | 
166  | 0  |   }  | 
167  |  |  | 
168  | 0  |   return 0;  | 
169  | 0  | }  | 
170  |  |  | 
171  |  | /**  | 
172  |  |  * gnutls_pem_base64_encode2:  | 
173  |  |  * @header: is a message to be put in the encoded header (may be %NULL)  | 
174  |  |  * @data: contains the raw data  | 
175  |  |  * @result: will hold the newly allocated encoded data  | 
176  |  |  *  | 
177  |  |  * This function will convert the given data to printable data, using  | 
178  |  |  * the base64 encoding.  This is the encoding used in PEM messages.  | 
179  |  |  * This function will allocate the required memory to hold the encoded  | 
180  |  |  * data.  | 
181  |  |  *  | 
182  |  |  * You should use gnutls_free() to free the returned data.  | 
183  |  |  *  | 
184  |  |  * Note, that prior to GnuTLS 3.4.0 this function was available  | 
185  |  |  * under the name gnutls_pem_base64_encode_alloc(). There is  | 
186  |  |  * compatibility macro pointing to this function.  | 
187  |  |  *  | 
188  |  |  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise  | 
189  |  |  *   an error code is returned.  | 
190  |  |  *  | 
191  |  |  * Since: 3.4.0  | 
192  |  |  **/  | 
193  |  | int gnutls_pem_base64_encode2(const char *header, const gnutls_datum_t *data,  | 
194  |  |             gnutls_datum_t *result)  | 
195  | 0  | { | 
196  | 0  |   int ret;  | 
197  |  | 
  | 
198  | 0  |   if (result == NULL)  | 
199  | 0  |     return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);  | 
200  |  |  | 
201  | 0  |   ret = _gnutls_fbase64_encode(header, data->data, data->size, result);  | 
202  | 0  |   if (ret < 0)  | 
203  | 0  |     return gnutls_assert_val(ret);  | 
204  |  |  | 
205  | 0  |   return 0;  | 
206  | 0  | }  | 
207  |  |  | 
208  |  | /* copies data to result but removes newlines and <CR>  | 
209  |  |  * returns the size of the data copied.  | 
210  |  |  *  | 
211  |  |  * It will fail with GNUTLS_E_BASE64_DECODING_ERROR if the  | 
212  |  |  * end-result is the empty string.  | 
213  |  |  */  | 
214  |  | inline static int cpydata(const uint8_t *data, int data_size,  | 
215  |  |         gnutls_datum_t *result)  | 
216  | 0  | { | 
217  | 0  |   int i, j;  | 
218  |  | 
  | 
219  | 0  |   result->data = gnutls_malloc(data_size + 1);  | 
220  | 0  |   if (result->data == NULL)  | 
221  | 0  |     return GNUTLS_E_MEMORY_ERROR;  | 
222  |  |  | 
223  | 0  |   for (j = i = 0; i < data_size; i++) { | 
224  | 0  |     if (data[i] == '\n' || data[i] == '\r' || data[i] == ' ' ||  | 
225  | 0  |         data[i] == '\t')  | 
226  | 0  |       continue;  | 
227  | 0  |     else if (data[i] == '-')  | 
228  | 0  |       break;  | 
229  | 0  |     result->data[j] = data[i];  | 
230  | 0  |     j++;  | 
231  | 0  |   }  | 
232  |  | 
  | 
233  | 0  |   result->size = j;  | 
234  | 0  |   result->data[j] = 0;  | 
235  |  | 
  | 
236  | 0  |   if (j == 0) { | 
237  | 0  |     gnutls_free(result->data);  | 
238  | 0  |     return gnutls_assert_val(GNUTLS_E_BASE64_DECODING_ERROR);  | 
239  | 0  |   }  | 
240  |  |  | 
241  | 0  |   return j;  | 
242  | 0  | }  | 
243  |  |  | 
244  |  | /* decodes data and puts the result into result (locally allocated).  | 
245  |  |  * Note that encodings of zero-length strings are being rejected  | 
246  |  |  * with GNUTLS_E_BASE64_DECODING_ERROR.  | 
247  |  |  *  | 
248  |  |  * The result_size is the return value.  | 
249  |  |  */  | 
250  |  | int _gnutls_base64_decode(const uint8_t *data, size_t data_size,  | 
251  |  |         gnutls_datum_t *result)  | 
252  | 0  | { | 
253  | 0  |   int ret;  | 
254  | 0  |   size_t size;  | 
255  | 0  |   gnutls_datum_t pdata;  | 
256  | 0  |   struct base64_decode_ctx ctx;  | 
257  |  | 
  | 
258  | 0  |   if (data_size == 0) { | 
259  | 0  |     result->data = (unsigned char *)gnutls_strdup(""); | 
260  | 0  |     if (result->data == NULL)  | 
261  | 0  |       return gnutls_assert_val(GNUTLS_E_MEMORY_ERROR);  | 
262  | 0  |     result->size = 0;  | 
263  | 0  |     return 0;  | 
264  | 0  |   }  | 
265  |  |  | 
266  | 0  |   ret = cpydata(data, data_size, &pdata);  | 
267  | 0  |   if (ret < 0) { | 
268  | 0  |     gnutls_assert();  | 
269  | 0  |     return ret;  | 
270  | 0  |   }  | 
271  |  |  | 
272  | 0  |   base64_decode_init(&ctx);  | 
273  |  | 
  | 
274  | 0  |   size = BASE64_DECODE_LENGTH(pdata.size);  | 
275  | 0  |   if (size == 0) { | 
276  | 0  |     ret = gnutls_assert_val(GNUTLS_E_BASE64_DECODING_ERROR);  | 
277  | 0  |     goto cleanup;  | 
278  | 0  |   }  | 
279  |  |  | 
280  | 0  |   result->data = gnutls_malloc(size);  | 
281  | 0  |   if (result->data == NULL) { | 
282  | 0  |     ret = gnutls_assert_val(GNUTLS_E_MEMORY_ERROR);  | 
283  | 0  |     goto cleanup;  | 
284  | 0  |   }  | 
285  |  |  | 
286  | 0  |   ret = base64_decode_update(&ctx, &size, result->data, pdata.size,  | 
287  | 0  |            (void *)pdata.data);  | 
288  | 0  |   if (ret == 0 || size == 0) { | 
289  | 0  |     gnutls_assert();  | 
290  | 0  |     ret = GNUTLS_E_BASE64_DECODING_ERROR;  | 
291  | 0  |     goto fail;  | 
292  | 0  |   }  | 
293  |  |  | 
294  | 0  |   ret = base64_decode_final(&ctx);  | 
295  | 0  |   if (ret != 1) { | 
296  | 0  |     ret = gnutls_assert_val(GNUTLS_E_BASE64_DECODING_ERROR);  | 
297  | 0  |     goto fail;  | 
298  | 0  |   }  | 
299  |  |  | 
300  | 0  |   result->size = size;  | 
301  |  | 
  | 
302  | 0  |   ret = size;  | 
303  | 0  |   goto cleanup;  | 
304  |  |  | 
305  | 0  | fail:  | 
306  | 0  |   gnutls_free(result->data);  | 
307  |  | 
  | 
308  | 0  | cleanup:  | 
309  | 0  |   gnutls_free(pdata.data);  | 
310  | 0  |   return ret;  | 
311  | 0  | }  | 
312  |  |  | 
313  |  | /* Searches the given string for ONE PEM encoded certificate, and  | 
314  |  |  * stores it in the result.  | 
315  |  |  *  | 
316  |  |  * The result_size (always non-zero) is the return value,  | 
317  |  |  * or a negative error code.  | 
318  |  |  */  | 
319  | 0  | #define ENDSTR "-----"  | 
320  |  | int _gnutls_fbase64_decode(const char *header, const uint8_t *data,  | 
321  |  |          size_t data_size, gnutls_datum_t *result)  | 
322  | 0  | { | 
323  | 0  |   int ret;  | 
324  | 0  |   static const char top[] = "-----BEGIN ";  | 
325  | 0  |   static const char bottom[] = "-----END ";  | 
326  | 0  |   uint8_t *rdata, *kdata;  | 
327  | 0  |   int rdata_size;  | 
328  | 0  |   char pem_header[128];  | 
329  |  | 
  | 
330  | 0  |   _gnutls_str_cpy(pem_header, sizeof(pem_header), top);  | 
331  | 0  |   if (header != NULL)  | 
332  | 0  |     _gnutls_str_cat(pem_header, sizeof(pem_header), header);  | 
333  |  | 
  | 
334  | 0  |   rdata = memmem(data, data_size, pem_header, strlen(pem_header));  | 
335  | 0  |   if (rdata == NULL) { | 
336  | 0  |     gnutls_assert();  | 
337  | 0  |     _gnutls_hard_log("Could not find '%s'\n", pem_header); | 
338  | 0  |     return GNUTLS_E_BASE64_UNEXPECTED_HEADER_ERROR;  | 
339  | 0  |   }  | 
340  |  |  | 
341  | 0  |   data_size -= MEMSUB(rdata, data);  | 
342  |  | 
  | 
343  | 0  |   if (data_size < 4 + strlen(bottom)) { | 
344  | 0  |     gnutls_assert();  | 
345  | 0  |     return GNUTLS_E_BASE64_DECODING_ERROR;  | 
346  | 0  |   }  | 
347  |  |  | 
348  | 0  |   kdata = memmem(rdata + 1, data_size - 1, ENDSTR, sizeof(ENDSTR) - 1);  | 
349  |  |   /* allow CR as well.  | 
350  |  |    */  | 
351  | 0  |   if (kdata == NULL) { | 
352  | 0  |     gnutls_assert();  | 
353  | 0  |     _gnutls_hard_log("Could not find '%s'\n", ENDSTR); | 
354  | 0  |     return GNUTLS_E_BASE64_DECODING_ERROR;  | 
355  | 0  |   }  | 
356  | 0  |   data_size -= strlen(ENDSTR);  | 
357  | 0  |   data_size -= MEMSUB(kdata, rdata);  | 
358  |  | 
  | 
359  | 0  |   rdata = kdata + strlen(ENDSTR);  | 
360  |  |  | 
361  |  |   /* position is now after the ---BEGIN--- headers */  | 
362  |  | 
  | 
363  | 0  |   kdata = memmem(rdata, data_size, bottom, strlen(bottom));  | 
364  | 0  |   if (kdata == NULL) { | 
365  | 0  |     gnutls_assert();  | 
366  | 0  |     return GNUTLS_E_BASE64_DECODING_ERROR;  | 
367  | 0  |   }  | 
368  |  |  | 
369  |  |   /* position of kdata is before the ----END--- footer   | 
370  |  |    */  | 
371  | 0  |   rdata_size = MEMSUB(kdata, rdata);  | 
372  |  | 
  | 
373  | 0  |   if (rdata_size < 4) { | 
374  | 0  |     gnutls_assert();  | 
375  | 0  |     return GNUTLS_E_BASE64_DECODING_ERROR;  | 
376  | 0  |   }  | 
377  |  |  | 
378  | 0  |   if ((ret = _gnutls_base64_decode(rdata, rdata_size, result)) < 0) { | 
379  | 0  |     gnutls_assert();  | 
380  | 0  |     return GNUTLS_E_BASE64_DECODING_ERROR;  | 
381  | 0  |   }  | 
382  |  |  | 
383  | 0  |   return ret;  | 
384  | 0  | }  | 
385  |  |  | 
386  |  | /**  | 
387  |  |  * gnutls_pem_base64_decode:  | 
388  |  |  * @header: A null terminated string with the PEM header (eg. CERTIFICATE)  | 
389  |  |  * @b64_data: contain the encoded data  | 
390  |  |  * @result: the place where decoded data will be copied  | 
391  |  |  * @result_size: holds the size of the result  | 
392  |  |  *  | 
393  |  |  * This function will decode the given encoded data.  If the header  | 
394  |  |  * given is non %NULL this function will search for "-----BEGIN header"  | 
395  |  |  * and decode only this part.  Otherwise it will decode the first PEM  | 
396  |  |  * packet found.  | 
397  |  |  *  | 
398  |  |  * Returns: On success %GNUTLS_E_SUCCESS (0) is returned,  | 
399  |  |  *   %GNUTLS_E_SHORT_MEMORY_BUFFER is returned if the buffer given is  | 
400  |  |  *   not long enough, or 0 on success.  | 
401  |  |  **/  | 
402  |  | int gnutls_pem_base64_decode(const char *header, const gnutls_datum_t *b64_data,  | 
403  |  |            unsigned char *result, size_t *result_size)  | 
404  | 0  | { | 
405  | 0  |   gnutls_datum_t res;  | 
406  | 0  |   int ret;  | 
407  |  | 
  | 
408  | 0  |   ret = _gnutls_fbase64_decode(header, b64_data->data, b64_data->size,  | 
409  | 0  |              &res);  | 
410  | 0  |   if (ret < 0)  | 
411  | 0  |     return gnutls_assert_val(ret);  | 
412  |  |  | 
413  | 0  |   if (result == NULL || *result_size < (unsigned)res.size) { | 
414  | 0  |     gnutls_free(res.data);  | 
415  | 0  |     *result_size = res.size;  | 
416  | 0  |     return GNUTLS_E_SHORT_MEMORY_BUFFER;  | 
417  | 0  |   } else { | 
418  | 0  |     memcpy(result, res.data, res.size);  | 
419  | 0  |     gnutls_free(res.data);  | 
420  | 0  |     *result_size = res.size;  | 
421  | 0  |   }  | 
422  |  |  | 
423  | 0  |   return 0;  | 
424  | 0  | }  | 
425  |  |  | 
426  |  | /**  | 
427  |  |  * gnutls_pem_base64_decode2:  | 
428  |  |  * @header: The PEM header (eg. CERTIFICATE)  | 
429  |  |  * @b64_data: contains the encoded data  | 
430  |  |  * @result: the location of decoded data  | 
431  |  |  *  | 
432  |  |  * This function will decode the given encoded data. The decoded data  | 
433  |  |  * will be allocated, and stored into result.  If the header given is  | 
434  |  |  * non null this function will search for "-----BEGIN header" and  | 
435  |  |  * decode only this part. Otherwise it will decode the first PEM  | 
436  |  |  * packet found.  | 
437  |  |  *  | 
438  |  |  * You should use gnutls_free() to free the returned data.  | 
439  |  |  *  | 
440  |  |  * Note, that prior to GnuTLS 3.4.0 this function was available  | 
441  |  |  * under the name gnutls_pem_base64_decode_alloc(). There is  | 
442  |  |  * compatibility macro pointing to this function.  | 
443  |  |  *  | 
444  |  |  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise  | 
445  |  |  *   an error code is returned.  | 
446  |  |  *  | 
447  |  |  * Since: 3.4.0  | 
448  |  |  **/  | 
449  |  | int gnutls_pem_base64_decode2(const char *header,  | 
450  |  |             const gnutls_datum_t *b64_data,  | 
451  |  |             gnutls_datum_t *result)  | 
452  | 0  | { | 
453  | 0  |   int ret;  | 
454  |  | 
  | 
455  | 0  |   if (result == NULL)  | 
456  | 0  |     return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);  | 
457  |  |  | 
458  | 0  |   ret = _gnutls_fbase64_decode(header, b64_data->data, b64_data->size,  | 
459  | 0  |              result);  | 
460  | 0  |   if (ret < 0)  | 
461  | 0  |     return gnutls_assert_val(ret);  | 
462  |  |  | 
463  | 0  |   return 0;  | 
464  | 0  | }  | 
465  |  |  | 
466  |  | /**  | 
467  |  |  * gnutls_base64_decode2:  | 
468  |  |  * @base64: contains the encoded data  | 
469  |  |  * @result: the location of decoded data  | 
470  |  |  *  | 
471  |  |  * This function will decode the given base64 encoded data. The decoded data  | 
472  |  |  * will be allocated, and stored into result.  | 
473  |  |  *  | 
474  |  |  * You should use gnutls_free() to free the returned data.  | 
475  |  |  *  | 
476  |  |  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise  | 
477  |  |  *   an error code is returned.  | 
478  |  |  *  | 
479  |  |  * Since: 3.6.0  | 
480  |  |  **/  | 
481  |  | int gnutls_base64_decode2(const gnutls_datum_t *base64, gnutls_datum_t *result)  | 
482  | 0  | { | 
483  | 0  |   int ret;  | 
484  |  | 
  | 
485  | 0  |   ret = _gnutls_base64_decode(base64->data, base64->size, result);  | 
486  | 0  |   if (ret < 0) { | 
487  | 0  |     return gnutls_assert_val(ret);  | 
488  | 0  |   }  | 
489  |  |  | 
490  | 0  |   return 0;  | 
491  | 0  | }  | 
492  |  |  | 
493  |  | /**  | 
494  |  |  * gnutls_base64_encode2:  | 
495  |  |  * @data: contains the raw data  | 
496  |  |  * @result: will hold the newly allocated encoded data  | 
497  |  |  *  | 
498  |  |  * This function will convert the given data to printable data, using  | 
499  |  |  * the base64 encoding. This function will allocate the required  | 
500  |  |  * memory to hold the encoded data.  | 
501  |  |  *  | 
502  |  |  * You should use gnutls_free() to free the returned data.  | 
503  |  |  *  | 
504  |  |  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise  | 
505  |  |  *   an error code is returned.  | 
506  |  |  *  | 
507  |  |  * Since: 3.6.0  | 
508  |  |  **/  | 
509  |  | int gnutls_base64_encode2(const gnutls_datum_t *data, gnutls_datum_t *result)  | 
510  | 0  | { | 
511  | 0  |   int ret;  | 
512  |  | 
  | 
513  | 0  |   if (result == NULL)  | 
514  | 0  |     return gnutls_assert_val(GNUTLS_E_INVALID_REQUEST);  | 
515  |  |  | 
516  | 0  |   ret = _gnutls_fbase64_encode(NULL, data->data, data->size, result);  | 
517  | 0  |   if (ret < 0)  | 
518  | 0  |     return gnutls_assert_val(ret);  | 
519  |  |  | 
520  | 0  |   return 0;  | 
521  | 0  | }  |