util-linux/hexdump_xxd.c

   1 /* vi: set sw=4 ts=4: */
   2 /*
   3  * xxd implementation for busybox
   4  *
   5  * Copyright (c) 2017 Denys Vlasenko <vda.linux@gmail.com>
   6  *
   7  * Licensed under GPLv2, see file LICENSE in this source tree.
   8  */
   9 //config:config XXD
  10 //config:       bool "xxd"
  11 //config:       default y
  12 //config:       help
  13 //config:         The xxd utility is used to display binary data in a readable
  14 //config:         way that is comparable to the output from most hex editors.
  15
  16 //applet:IF_XXD(APPLET_NOEXEC(xxd, xxd, BB_DIR_USR_BIN, BB_SUID_DROP, xxd))
  17
  18 //kbuild:lib-$(CONFIG_XXD) += hexdump_xxd.o
  19
  20 // $ xxd --version
  21 // xxd V1.10 27oct98 by Juergen Weigert
  22 // $ xxd --help
  23 // Usage:
  24 //       xxd [options] [infile [outfile]]
  25 //    or
  26 //       xxd -r [-s [-]offset] [-c cols] [-ps] [infile [outfile]]
  27 // Options:
  28 //    -a          toggle autoskip: A single '*' replaces nul-lines. Default off.
  29 //    -b          binary digit dump (incompatible with -ps,-i,-r). Default hex.
  30 //    -c cols     format <cols> octets per line. Default 16 (-i: 12, -ps: 30).
  31 //    -E          show characters in EBCDIC. Default ASCII.
  32 //    -e          little-endian dump (incompatible with -ps,-i,-r).
  33 //    -g          number of octets per group in normal output. Default 2 (-e: 4).
  34 //    -i          output in C include file style.
  35 //    -l len      stop after <len> octets.
  36 //    -o off      add <off> to the displayed file position.
  37 //    -ps         output in postscript plain hexdump style.
  38 //    -r          reverse operation: convert (or patch) hexdump into binary.
  39 //    -r -s off   revert with <off> added to file positions found in hexdump.
  40 //    -s [+][-]seek  start at <seek> bytes abs. (or +: rel.) infile offset.
  41 //    -u          use upper case hex letters.
  42
  43 //usage:#define xxd_trivial_usage
  44 //usage:       "[OPTIONS] [FILE]"
  45 //usage:#define xxd_full_usage "\n\n"
  46 //usage:       "Hex dump FILE (or stdin)\n"
  47 //usage:     "\n        -g N            Bytes per group"
  48 //usage:     "\n        -c N            Bytes per line"
  49 // exactly the same help text lines in hexdump and xxd:
  50 //usage:     "\n        -l LENGTH       Interpret only LENGTH bytes of input"
  51 //usage:     "\n        -s OFFSET       Skip OFFSET bytes"
  52
  53 #include "libbb.h"
  54 #include "dump.h"
  55
  56 /* This is a NOEXEC applet. Be very careful! */
  57
  58 int xxd_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
  59 int xxd_main(int argc UNUSED_PARAM, char **argv)
  60 {
  61         char buf[80];
  62         dumper_t *dumper;
  63         char *opt_l, *opt_s;
  64         unsigned bytes = 2;
  65         unsigned cols = 0;
  66         unsigned opt;
  67
  68         dumper = alloc_dumper();
  69
  70 #define OPT_l (1 << 0)
  71 #define OPT_s (1 << 1)
  72 #define OPT_a (1 << 2)
  73         opt_complementary = "?1"; /* 1 argument max */
  74         opt = getopt32(argv, "l:s:ag:+c:+", &opt_l, &opt_s, &bytes, &cols);
  75         argv += optind;
  76
  77 //      dumper->dump_vflag = ALL; // default
  78 //      if (opt & OPT_a)
  79 //              dumper->dump_vflag = SKIPNUL; ..does not exist
  80         if (opt & OPT_l) {
  81                 dumper->dump_length = xstrtou_range(
  82                                 opt_l,
  83                                 /*base:*/ 0,
  84                                 /*lo:*/ 0, /*hi:*/ INT_MAX
  85                 );
  86         }
  87         if (opt & OPT_s) {
  88                 dumper->dump_skip = xstrtoull_range(
  89                                 opt_s,
  90                                 /*base:*/ 0,
  91                                 /*lo:*/ 0, /*hi:*/ OFF_T_MAX
  92                 );
  93                 //BUGGY for /proc/version (unseekable?)
  94         }
  95
  96         bb_dump_add(dumper, "\"%08.8_ax: \""); // "address: "
  97         if (cols == 0)
  98                 cols = 16;
  99         if (bytes < 1 || bytes >= cols) {
 100                 sprintf(buf, "%u/1 \"%%02x\"", cols); // cols * "xx"
 101                 bb_dump_add(dumper, buf);
 102         }
 103         else if (bytes == 1) {
 104                 sprintf(buf, "%u/1 \"%%02x \"", cols); // cols * "xx "
 105                 bb_dump_add(dumper, buf);
 106         }
 107         else {
 108 /* Format "print byte" with and without trailing space */
 109 #define BS "/1 \"%02x \""
 110 #define B  "/1 \"%02x\""
 111                 unsigned i;
 112                 char *bigbuf = xmalloc(1 + cols * (sizeof(BS)-1));
 113                 char *p = bigbuf;
 114                 for (i = 1; i <= cols; i++) {
 115                         if (i == cols || i % bytes)
 116                                 p = stpcpy(p, B);
 117                         else
 118                                 p = stpcpy(p, BS);
 119                 }
 120                 // for -g3, this results in B B BS B B BS... B = "xxxxxx xxxxxx .....xx"
 121                 // todo: can be more clever and use
 122                 // one "cols-1/B" format instead of many "B B B..." formats
 123                 //bb_error_msg("ADDED:'%s'", bigbuf);
 124                 bb_dump_add(dumper, bigbuf);
 125                 free(bigbuf);
 126         }
 127
 128         sprintf(buf, "\"  \"%u/1 \"%%_p\"\"\n\"", cols); // "  ASCII\n"
 129         bb_dump_add(dumper, buf);
 130
 131         return bb_dump_dump(dumper, argv);
 132 }