/src/boringssl/crypto/bio/hexdump.c

Source (jump to first uncovered line)
/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
 * All rights reserved.
 *
 * This package is an SSL implementation written
 * by Eric Young (eay@cryptsoft.com).
 * The implementation was written so as to conform with Netscapes SSL.
 *
 * This library is free for commercial and non-commercial use as long as
 * the following conditions are aheared to.  The following conditions
 * apply to all code found in this distribution, be it the RC4, RSA,
 * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
 * included with this distribution is covered by the same copyright terms
 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
 *
 * Copyright remains Eric Young's, and as such any Copyright notices in
 * the code are not to be removed.
 * If this package is used in a product, Eric Young should be given attribution
 * as the author of the parts of the library used.
 * This can be in the form of a textual message at program startup or
 * in documentation (online or textual) provided with the package.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *    "This product includes cryptographic software written by
 *     Eric Young (eay@cryptsoft.com)"
 *    The word 'cryptographic' can be left out if the rouines from the library
 *    being used are not cryptographic related :-).
 * 4. If you include any Windows specific code (or a derivative thereof) from
 *    the apps directory (application code) you must include an acknowledgement:
 *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
 *
 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * The licence and distribution terms for any publically available version or
 * derivative of this code cannot be changed.  i.e. this code cannot simply be
 * copied and put under another distribution licence
 * [including the GNU Public Licence.] */

#include <openssl/bio.h>

#include <limits.h>
#include <string.h>

#include "../internal.h"


// hexdump_ctx contains the state of a hexdump.
struct hexdump_ctx {
  BIO *bio;
  char right_chars[18];  // the contents of the right-hand side, ASCII dump.
  unsigned used;         // number of bytes in the current line.
  size_t n;              // number of bytes total.
  unsigned indent;
};

static void hexbyte(char *out, uint8_t b) {
  static const char hextable[] = "0123456789abcdef";
  out[0] = hextable[b>>4];
  out[1] = hextable[b&0x0f];
}

static char to_char(uint8_t b) {
  if (b < 32 || b > 126) {
          return '.';
  }
  return b;
}

// hexdump_write adds |len| bytes of |data| to the current hex dump described by
// |ctx|.
static int hexdump_write(struct hexdump_ctx *ctx, const uint8_t *data,
                         size_t len) {
  char buf[10];
  unsigned l;

  // Output lines look like:
  // 00000010  2e 2f 30 31 32 33 34 35  36 37 38 ... 3c 3d // |./0123456789:;<=|
  // ^ offset                          ^ extra space           ^ ASCII of line

  for (size_t i = 0; i < len; i++) {
    if (ctx->used == 0) {
      // The beginning of a line.
      BIO_indent(ctx->bio, ctx->indent, UINT_MAX);

      hexbyte(&buf[0], ctx->n >> 24);
      hexbyte(&buf[2], ctx->n >> 16);
      hexbyte(&buf[4], ctx->n >> 8);
      hexbyte(&buf[6], ctx->n);
      buf[8] = buf[9] = ' ';
      if (BIO_write(ctx->bio, buf, 10) < 0) {
        return 0;
      }
    }

    hexbyte(buf, data[i]);
    buf[2] = ' ';
    l = 3;
    if (ctx->used == 7) {
      // There's an additional space after the 8th byte.
      buf[3] = ' ';
      l = 4;
    } else if (ctx->used == 15) {
      // At the end of the line there's an extra space and the bar for the
      // right column.
      buf[3] = ' ';
      buf[4] = '|';
      l = 5;
    }

    if (BIO_write(ctx->bio, buf, l) < 0) {
      return 0;
    }
    ctx->right_chars[ctx->used] = to_char(data[i]);
    ctx->used++;
    ctx->n++;
    if (ctx->used == 16) {
      ctx->right_chars[16] = '|';
      ctx->right_chars[17] = '\n';
      if (BIO_write(ctx->bio, ctx->right_chars, sizeof(ctx->right_chars)) < 0) {
        return 0;
      }
      ctx->used = 0;
    }
  }

  return 1;
}

// finish flushes any buffered data in |ctx|.
static int finish(struct hexdump_ctx *ctx) {
  // See the comments in |hexdump| for the details of this format.
  const unsigned n_bytes = ctx->used;
  unsigned l;
  char buf[5];

  if (n_bytes == 0) {
    return 1;
  }

  OPENSSL_memset(buf, ' ', 4);
  buf[4] = '|';

  for (; ctx->used < 16; ctx->used++) {
    l = 3;
    if (ctx->used == 7) {
      l = 4;
    } else if (ctx->used == 15) {
      l = 5;
    }
    if (BIO_write(ctx->bio, buf, l) < 0) {
      return 0;
    }
  }

  ctx->right_chars[n_bytes] = '|';
  ctx->right_chars[n_bytes + 1] = '\n';
  if (BIO_write(ctx->bio, ctx->right_chars, n_bytes + 2) < 0) {
    return 0;
  }
  return 1;
}

int BIO_hexdump(BIO *bio, const uint8_t *data, size_t len, unsigned indent) {
  struct hexdump_ctx ctx;
  OPENSSL_memset(&ctx, 0, sizeof(ctx));
  ctx.bio = bio;
  ctx.indent = indent;

  if (!hexdump_write(&ctx, data, len) || !finish(&ctx)) {
    return 0;
  }

  return 1;
}

Coverage Report

Created: 2023-06-07 07:13

Line	Count	Source (jump to first uncovered line)
1		/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2		* All rights reserved.
3		*
4		* This package is an SSL implementation written
5		* by Eric Young (eay@cryptsoft.com).
6		* The implementation was written so as to conform with Netscapes SSL.
7		*
8		* This library is free for commercial and non-commercial use as long as
9		* the following conditions are aheared to. The following conditions
10		* apply to all code found in this distribution, be it the RC4, RSA,
11		* lhash, DES, etc., code; not just the SSL code. The SSL documentation
12		* included with this distribution is covered by the same copyright terms
13		* except that the holder is Tim Hudson (tjh@cryptsoft.com).
14		*
15		* Copyright remains Eric Young's, and as such any Copyright notices in
16		* the code are not to be removed.
17		* If this package is used in a product, Eric Young should be given attribution
18		* as the author of the parts of the library used.
19		* This can be in the form of a textual message at program startup or
20		* in documentation (online or textual) provided with the package.
21		*
22		* Redistribution and use in source and binary forms, with or without
23		* modification, are permitted provided that the following conditions
24		* are met:
25		* 1. Redistributions of source code must retain the copyright
26		* notice, this list of conditions and the following disclaimer.
27		* 2. Redistributions in binary form must reproduce the above copyright
28		* notice, this list of conditions and the following disclaimer in the
29		* documentation and/or other materials provided with the distribution.
30		* 3. All advertising materials mentioning features or use of this software
31		* must display the following acknowledgement:
32		* "This product includes cryptographic software written by
33		* Eric Young (eay@cryptsoft.com)"
34		* The word 'cryptographic' can be left out if the rouines from the library
35		* being used are not cryptographic related :-).
36		* 4. If you include any Windows specific code (or a derivative thereof) from
37		* the apps directory (application code) you must include an acknowledgement:
38		* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39		*
40		* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41		* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42		* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43		* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44		* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45		* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46		* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47		* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48		* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49		* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50		* SUCH DAMAGE.
51		*
52		* The licence and distribution terms for any publically available version or
53		* derivative of this code cannot be changed. i.e. this code cannot simply be
54		* copied and put under another distribution licence
55		* [including the GNU Public Licence.] */
56
57		#include <openssl/bio.h>
58
59		#include <limits.h>
60		#include <string.h>
61
62		#include "../internal.h"
63
64
65		// hexdump_ctx contains the state of a hexdump.
66		struct hexdump_ctx {
67		BIO *bio;
68		char right_chars[18]; // the contents of the right-hand side, ASCII dump.
69		unsigned used; // number of bytes in the current line.
70		size_t n; // number of bytes total.
71		unsigned indent;
72		};
73
74	0	static void hexbyte(char *out, uint8_t b) {
75	0	static const char hextable[] = "0123456789abcdef";
76	0	out[0] = hextable[b>>4];
77	0	out[1] = hextable[b&0x0f];
78	0	}
79
80	0	static char to_char(uint8_t b) {
81	0	if (b < 32 \|\| b > 126) {
82	0	return '.';
83	0	}
84	0	return b;
85	0	}
86
87		// hexdump_write adds \|len\| bytes of \|data\| to the current hex dump described by
88		// \|ctx\|.
89		static int hexdump_write(struct hexdump_ctx ctx, const uint8_t data,
90	0	size_t len) {
91	0	char buf[10];
92	0	unsigned l;
93
94		// Output lines look like:
95		// 00000010 2e 2f 30 31 32 33 34 35 36 37 38 ... 3c 3d // \|./0123456789:;<=\|
96		// ^ offset ^ extra space ^ ASCII of line
97
98	0	for (size_t i = 0; i < len; i++) {
99	0	if (ctx->used == 0) {
100		// The beginning of a line.
101	0	BIO_indent(ctx->bio, ctx->indent, UINT_MAX);
102
103	0	hexbyte(&buf[0], ctx->n >> 24);
104	0	hexbyte(&buf[2], ctx->n >> 16);
105	0	hexbyte(&buf[4], ctx->n >> 8);
106	0	hexbyte(&buf[6], ctx->n);
107	0	buf[8] = buf[9] = ' ';
108	0	if (BIO_write(ctx->bio, buf, 10) < 0) {
109	0	return 0;
110	0	}
111	0	}
112
113	0	hexbyte(buf, data[i]);
114	0	buf[2] = ' ';
115	0	l = 3;
116	0	if (ctx->used == 7) {
117		// There's an additional space after the 8th byte.
118	0	buf[3] = ' ';
119	0	l = 4;
120	0	} else if (ctx->used == 15) {
121		// At the end of the line there's an extra space and the bar for the
122		// right column.
123	0	buf[3] = ' ';
124	0	buf[4] = '\|';
125	0	l = 5;
126	0	}
127
128	0	if (BIO_write(ctx->bio, buf, l) < 0) {
129	0	return 0;
130	0	}
131	0	ctx->right_chars[ctx->used] = to_char(data[i]);
132	0	ctx->used++;
133	0	ctx->n++;
134	0	if (ctx->used == 16) {
135	0	ctx->right_chars[16] = '\|';
136	0	ctx->right_chars[17] = '\n';
137	0	if (BIO_write(ctx->bio, ctx->right_chars, sizeof(ctx->right_chars)) < 0) {
138	0	return 0;
139	0	}
140	0	ctx->used = 0;
141	0	}
142	0	}
143
144	0	return 1;
145	0	}
146
147		// finish flushes any buffered data in \|ctx\|.
148	0	static int finish(struct hexdump_ctx *ctx) {
149		// See the comments in \|hexdump\| for the details of this format.
150	0	const unsigned n_bytes = ctx->used;
151	0	unsigned l;
152	0	char buf[5];
153
154	0	if (n_bytes == 0) {
155	0	return 1;
156	0	}
157
158	0	OPENSSL_memset(buf, ' ', 4);
159	0	buf[4] = '\|';
160
161	0	for (; ctx->used < 16; ctx->used++) {
162	0	l = 3;
163	0	if (ctx->used == 7) {
164	0	l = 4;
165	0	} else if (ctx->used == 15) {
166	0	l = 5;
167	0	}
168	0	if (BIO_write(ctx->bio, buf, l) < 0) {
169	0	return 0;
170	0	}
171	0	}
172
173	0	ctx->right_chars[n_bytes] = '\|';
174	0	ctx->right_chars[n_bytes + 1] = '\n';
175	0	if (BIO_write(ctx->bio, ctx->right_chars, n_bytes + 2) < 0) {
176	0	return 0;
177	0	}
178	0	return 1;
179	0	}
180
181	0	int BIO_hexdump(BIO bio, const uint8_t data, size_t len, unsigned indent) {
182	0	struct hexdump_ctx ctx;
183	0	OPENSSL_memset(&ctx, 0, sizeof(ctx));
184	0	ctx.bio = bio;
185	0	ctx.indent = indent;
186
187	0	if (!hexdump_write(&ctx, data, len) \|\| !finish(&ctx)) {
188	0	return 0;
189	0	}
190
191	0	return 1;
192	0	}