Home | History | Annotate | Line # | Download | only in isc
base32.c revision 1.2.2.2
      1 /*	$NetBSD: base32.c,v 1.2.2.2 2018/09/06 06:55:05 pgoyette Exp $	*/
      2 
      3 /*
      4  * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
      5  *
      6  * This Source Code Form is subject to the terms of the Mozilla Public
      7  * License, v. 2.0. If a copy of the MPL was not distributed with this
      8  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
      9  *
     10  * See the COPYRIGHT file distributed with this work for additional
     11  * information regarding copyright ownership.
     12  */
     13 
     14 
     15 /*! \file */
     16 
     17 #include <config.h>
     18 
     19 #include <isc/base32.h>
     20 #include <isc/buffer.h>
     21 #include <isc/lex.h>
     22 #include <isc/region.h>
     23 #include <isc/string.h>
     24 #include <isc/util.h>
     25 
     26 #define RETERR(x) do { \
     27 	isc_result_t _r = (x); \
     28 	if (_r != ISC_R_SUCCESS) \
     29 		return (_r); \
     30 	} while (/*CONSTCOND*/0)
     31 
     32 
     33 /*@{*/
     34 /*!
     35  * These static functions are also present in lib/dns/rdata.c.  I'm not
     36  * sure where they should go. -- bwelling
     37  */
     38 static isc_result_t
     39 str_totext(const char *source, isc_buffer_t *target);
     40 
     41 static isc_result_t
     42 mem_tobuffer(isc_buffer_t *target, void *base, unsigned int length);
     43 
     44 /*@}*/
     45 
     46 static const char base32[] =
     47 	 "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567=abcdefghijklmnopqrstuvwxyz234567";
     48 static const char base32hex[] =
     49 	"0123456789ABCDEFGHIJKLMNOPQRSTUV=0123456789abcdefghijklmnopqrstuv";
     50 
     51 static isc_result_t
     52 base32_totext(isc_region_t *source, int wordlength, const char *wordbreak,
     53 	      isc_buffer_t *target, const char base[], char pad)
     54 {
     55 	char buf[9];
     56 	unsigned int loops = 0;
     57 
     58 	if (wordlength >= 0 && wordlength < 8)
     59 		wordlength = 8;
     60 
     61 	memset(buf, 0, sizeof(buf));
     62 	while (source->length > 0) {
     63 		buf[0] = base[((source->base[0]>>3)&0x1f)];	/* 5 + */
     64 		if (source->length == 1) {
     65 			buf[1] = base[(source->base[0]<<2)&0x1c];
     66 			buf[2] = buf[3] = buf[4] = pad;
     67 			buf[5] = buf[6] = buf[7] = pad;
     68 			RETERR(str_totext(buf, target));
     69 			break;
     70 		}
     71 		buf[1] = base[((source->base[0]<<2)&0x1c)|	/* 3 = 8 */
     72 			      ((source->base[1]>>6)&0x03)];	/* 2 + */
     73 		buf[2] = base[((source->base[1]>>1)&0x1f)];	/* 5 + */
     74 		if (source->length == 2) {
     75 			buf[3] = base[(source->base[1]<<4)&0x10];
     76 			buf[4] = buf[5] = buf[6] = buf[7] = pad;
     77 			RETERR(str_totext(buf, target));
     78 			break;
     79 		}
     80 		buf[3] = base[((source->base[1]<<4)&0x10)|	/* 1 = 8 */
     81 			      ((source->base[2]>>4)&0x0f)];	/* 4 + */
     82 		if (source->length == 3) {
     83 			buf[4] = base[(source->base[2]<<1)&0x1e];
     84 			buf[5] = buf[6] = buf[7] = pad;
     85 			RETERR(str_totext(buf, target));
     86 			break;
     87 		}
     88 		buf[4] = base[((source->base[2]<<1)&0x1e)|	/* 4 = 8 */
     89 			      ((source->base[3]>>7)&0x01)];	/* 1 + */
     90 		buf[5] = base[((source->base[3]>>2)&0x1f)];	/* 5 + */
     91 		if (source->length == 4) {
     92 			buf[6] = base[(source->base[3]<<3)&0x18];
     93 			buf[7] = pad;
     94 			RETERR(str_totext(buf, target));
     95 			break;
     96 		}
     97 		buf[6] = base[((source->base[3]<<3)&0x18)|	/* 2 = 8 */
     98 			      ((source->base[4]>>5)&0x07)];	/* 3 + */
     99 		buf[7] = base[source->base[4]&0x1f];		/* 5 = 8 */
    100 		RETERR(str_totext(buf, target));
    101 		isc_region_consume(source, 5);
    102 
    103 		loops++;
    104 		if (source->length != 0 && wordlength >= 0 &&
    105 		    (int)((loops + 1) * 8) >= wordlength)
    106 		{
    107 			loops = 0;
    108 			RETERR(str_totext(wordbreak, target));
    109 		}
    110 	}
    111 	if (source->length > 0)
    112 		isc_region_consume(source, source->length);
    113 	return (ISC_R_SUCCESS);
    114 }
    115 
    116 isc_result_t
    117 isc_base32_totext(isc_region_t *source, int wordlength,
    118 		  const char *wordbreak, isc_buffer_t *target)
    119 {
    120 	return (base32_totext(source, wordlength, wordbreak, target,
    121 			      base32, '='));
    122 }
    123 
    124 isc_result_t
    125 isc_base32hex_totext(isc_region_t *source, int wordlength,
    126 		     const char *wordbreak, isc_buffer_t *target)
    127 {
    128 	return (base32_totext(source, wordlength, wordbreak, target,
    129 			      base32hex, '='));
    130 }
    131 
    132 isc_result_t
    133 isc_base32hexnp_totext(isc_region_t *source, int wordlength,
    134 		     const char *wordbreak, isc_buffer_t *target)
    135 {
    136 	return (base32_totext(source, wordlength, wordbreak, target,
    137 			      base32hex, 0));
    138 }
    139 
    140 /*%
    141  * State of a base32 decoding process in progress.
    142  */
    143 typedef struct {
    144 	int length;		/*%< Desired length of binary data or -1 */
    145 	isc_buffer_t *target;	/*%< Buffer for resulting binary data */
    146 	int digits;		/*%< Number of buffered base32 digits */
    147 	isc_boolean_t seen_end;	/*%< True if "=" end marker seen */
    148 	int val[8];
    149 	const char *base;	/*%< Which encoding we are using */
    150 	int seen_32;		/*%< Number of significant bytes if non zero */
    151 	isc_boolean_t pad;	/*%< Expect padding */
    152 } base32_decode_ctx_t;
    153 
    154 static inline void
    155 base32_decode_init(base32_decode_ctx_t *ctx, int length, const char base[],
    156 		   isc_boolean_t pad, isc_buffer_t *target)
    157 {
    158 	ctx->digits = 0;
    159 	ctx->seen_end = ISC_FALSE;
    160 	ctx->seen_32 = 0;
    161 	ctx->length = length;
    162 	ctx->target = target;
    163 	ctx->base = base;
    164 	ctx->pad = pad;
    165 }
    166 
    167 static inline isc_result_t
    168 base32_decode_char(base32_decode_ctx_t *ctx, int c) {
    169 	const char *s;
    170 	unsigned int last;
    171 
    172 	if (ctx->seen_end)
    173 		return (ISC_R_BADBASE32);
    174 	if ((s = strchr(ctx->base, c)) == NULL)
    175 		return (ISC_R_BADBASE32);
    176 	last = (unsigned int)(s - ctx->base);
    177 
    178 	/*
    179 	 * Handle lower case.
    180 	 */
    181 	if (last > 32)
    182 		last -= 33;
    183 
    184 	/*
    185 	 * Check that padding is contiguous.
    186 	 */
    187 	if (last != 32 && ctx->seen_32 != 0)
    188 		return (ISC_R_BADBASE32);
    189 
    190 	/*
    191 	 * If padding is not permitted flag padding as a error.
    192 	 */
    193 	if (last == 32 && !ctx->pad)
    194 		return (ISC_R_BADBASE32);
    195 
    196 	/*
    197 	 * Check that padding starts at the right place and that
    198 	 * bits that should be zero are.
    199 	 * Record how many significant bytes in answer (seen_32).
    200 	 */
    201 	if (last == 32 && ctx->seen_32 == 0)
    202 		switch (ctx->digits) {
    203 		case 0:
    204 		case 1:
    205 			return (ISC_R_BADBASE32);
    206 		case 2:
    207 			if ((ctx->val[1]&0x03) != 0)
    208 				return (ISC_R_BADBASE32);
    209 			ctx->seen_32 = 1;
    210 			break;
    211 		case 3:
    212 			return (ISC_R_BADBASE32);
    213 		case 4:
    214 			if ((ctx->val[3]&0x0f) != 0)
    215 				return (ISC_R_BADBASE32);
    216 			ctx->seen_32 = 3;
    217 			break;
    218 		case 5:
    219 			if ((ctx->val[4]&0x01) != 0)
    220 				return (ISC_R_BADBASE32);
    221 			ctx->seen_32 = 3;
    222 			break;
    223 		case 6:
    224 			return (ISC_R_BADBASE32);
    225 		case 7:
    226 			if ((ctx->val[6]&0x07) != 0)
    227 				return (ISC_R_BADBASE32);
    228 			ctx->seen_32 = 4;
    229 			break;
    230 		}
    231 
    232 	/*
    233 	 * Zero fill pad values.
    234 	 */
    235 	ctx->val[ctx->digits++] = (last == 32) ? 0 : last;
    236 
    237 	if (ctx->digits == 8) {
    238 		int n = 5;
    239 		unsigned char buf[5];
    240 
    241 		if (ctx->seen_32 != 0) {
    242 			ctx->seen_end = ISC_TRUE;
    243 			n = ctx->seen_32;
    244 		}
    245 		buf[0] = (ctx->val[0]<<3)|(ctx->val[1]>>2);
    246 		buf[1] = (ctx->val[1]<<6)|(ctx->val[2]<<1)|(ctx->val[3]>>4);
    247 		buf[2] = (ctx->val[3]<<4)|(ctx->val[4]>>1);
    248 		buf[3] = (ctx->val[4]<<7)|(ctx->val[5]<<2)|(ctx->val[6]>>3);
    249 		buf[4] = (ctx->val[6]<<5)|(ctx->val[7]);
    250 		RETERR(mem_tobuffer(ctx->target, buf, n));
    251 		if (ctx->length >= 0) {
    252 			if (n > ctx->length)
    253 				return (ISC_R_BADBASE32);
    254 			else
    255 				ctx->length -= n;
    256 		}
    257 		ctx->digits = 0;
    258 	}
    259 	return (ISC_R_SUCCESS);
    260 }
    261 
    262 static inline isc_result_t
    263 base32_decode_finish(base32_decode_ctx_t *ctx) {
    264 
    265 	if (ctx->length > 0)
    266 		return (ISC_R_UNEXPECTEDEND);
    267 	/*
    268 	 * Add missing padding if required.
    269 	 */
    270 	if (!ctx->pad && ctx->digits != 0) {
    271 		ctx->pad = ISC_TRUE;
    272 		do {
    273 			RETERR(base32_decode_char(ctx, '='));
    274 		} while (ctx->digits != 0);
    275 	}
    276 	if (ctx->digits != 0)
    277 		return (ISC_R_BADBASE32);
    278 	return (ISC_R_SUCCESS);
    279 }
    280 
    281 static isc_result_t
    282 base32_tobuffer(isc_lex_t *lexer, const char base[], isc_boolean_t pad,
    283 		isc_buffer_t *target, int length)
    284 {
    285 	base32_decode_ctx_t ctx;
    286 	isc_textregion_t *tr;
    287 	isc_token_t token;
    288 	isc_boolean_t eol;
    289 
    290 	base32_decode_init(&ctx, length, base, pad, target);
    291 
    292 	while (!ctx.seen_end && (ctx.length != 0)) {
    293 		unsigned int i;
    294 
    295 		if (length > 0)
    296 			eol = ISC_FALSE;
    297 		else
    298 			eol = ISC_TRUE;
    299 		RETERR(isc_lex_getmastertoken(lexer, &token,
    300 					      isc_tokentype_string, eol));
    301 		if (token.type != isc_tokentype_string)
    302 			break;
    303 		tr = &token.value.as_textregion;
    304 		for (i = 0; i < tr->length; i++)
    305 			RETERR(base32_decode_char(&ctx, tr->base[i]));
    306 	}
    307 	if (ctx.length < 0 && !ctx.seen_end)
    308 		isc_lex_ungettoken(lexer, &token);
    309 	RETERR(base32_decode_finish(&ctx));
    310 	return (ISC_R_SUCCESS);
    311 }
    312 
    313 isc_result_t
    314 isc_base32_tobuffer(isc_lex_t *lexer, isc_buffer_t *target, int length) {
    315 	return (base32_tobuffer(lexer, base32, ISC_TRUE, target, length));
    316 }
    317 
    318 isc_result_t
    319 isc_base32hex_tobuffer(isc_lex_t *lexer, isc_buffer_t *target, int length) {
    320 	return (base32_tobuffer(lexer, base32hex, ISC_TRUE, target, length));
    321 }
    322 
    323 isc_result_t
    324 isc_base32hexnp_tobuffer(isc_lex_t *lexer, isc_buffer_t *target, int length) {
    325 	return (base32_tobuffer(lexer, base32hex, ISC_FALSE, target, length));
    326 }
    327 
    328 static isc_result_t
    329 base32_decodestring(const char *cstr, const char base[], isc_boolean_t pad,
    330 		    isc_buffer_t *target)
    331 {
    332 	base32_decode_ctx_t ctx;
    333 
    334 	base32_decode_init(&ctx, -1, base, pad, target);
    335 	for (;;) {
    336 		int c = *cstr++;
    337 		if (c == '\0')
    338 			break;
    339 		if (c == ' ' || c == '\t' || c == '\n' || c== '\r')
    340 			continue;
    341 		RETERR(base32_decode_char(&ctx, c));
    342 	}
    343 	RETERR(base32_decode_finish(&ctx));
    344 	return (ISC_R_SUCCESS);
    345 }
    346 
    347 isc_result_t
    348 isc_base32_decodestring(const char *cstr, isc_buffer_t *target) {
    349 	return (base32_decodestring(cstr, base32, ISC_TRUE, target));
    350 }
    351 
    352 isc_result_t
    353 isc_base32hex_decodestring(const char *cstr, isc_buffer_t *target) {
    354 	return (base32_decodestring(cstr, base32hex, ISC_TRUE, target));
    355 }
    356 
    357 isc_result_t
    358 isc_base32hexnp_decodestring(const char *cstr, isc_buffer_t *target) {
    359 	return (base32_decodestring(cstr, base32hex, ISC_FALSE, target));
    360 }
    361 
    362 static isc_result_t
    363 base32_decoderegion(isc_region_t *source, const char base[],
    364 		    isc_boolean_t pad, isc_buffer_t *target)
    365 {
    366 	base32_decode_ctx_t ctx;
    367 
    368 	base32_decode_init(&ctx, -1, base, pad, target);
    369 	while (source->length != 0) {
    370 		int c = *source->base;
    371 		RETERR(base32_decode_char(&ctx, c));
    372 		isc_region_consume(source, 1);
    373 	}
    374 	RETERR(base32_decode_finish(&ctx));
    375 	return (ISC_R_SUCCESS);
    376 }
    377 
    378 isc_result_t
    379 isc_base32_decoderegion(isc_region_t *source, isc_buffer_t *target) {
    380 	return (base32_decoderegion(source, base32, ISC_TRUE, target));
    381 }
    382 
    383 isc_result_t
    384 isc_base32hex_decoderegion(isc_region_t *source, isc_buffer_t *target) {
    385 	return (base32_decoderegion(source, base32hex, ISC_TRUE, target));
    386 }
    387 
    388 isc_result_t
    389 isc_base32hexnp_decoderegion(isc_region_t *source, isc_buffer_t *target) {
    390 	return (base32_decoderegion(source, base32hex, ISC_FALSE, target));
    391 }
    392 
    393 static isc_result_t
    394 str_totext(const char *source, isc_buffer_t *target) {
    395 	unsigned int l;
    396 	isc_region_t region;
    397 
    398 	isc_buffer_availableregion(target, &region);
    399 	l = strlen(source);
    400 
    401 	if (l > region.length)
    402 		return (ISC_R_NOSPACE);
    403 
    404 	memmove(region.base, source, l);
    405 	isc_buffer_add(target, l);
    406 	return (ISC_R_SUCCESS);
    407 }
    408 
    409 static isc_result_t
    410 mem_tobuffer(isc_buffer_t *target, void *base, unsigned int length) {
    411 	isc_region_t tr;
    412 
    413 	isc_buffer_availableregion(target, &tr);
    414 	if (length > tr.length)
    415 		return (ISC_R_NOSPACE);
    416 	memmove(tr.base, base, length);
    417 	isc_buffer_add(target, length);
    418 	return (ISC_R_SUCCESS);
    419 }
    420