bc: convert to "G trick" - this returns bc to zero bss increase
[oweals/busybox.git] / util-linux / hexdump.c
index f3878f44ffefb52d4543bfd1e84780a8a7952b07..719feaf4ef692713b558f69914af42b617346d36 100644 (file)
@@ -4,10 +4,63 @@
  * Based on code from util-linux v 2.11l
  *
  * Copyright (c) 1989
- *     The Regents of the University of California.  All rights reserved.
+ * The Regents of the University of California.  All rights reserved.
  *
- * Licensed under GPLv2 or later, see file License in this tarball for details.
+ * Licensed under GPLv2 or later, see file LICENSE in this source tree.
  */
+//config:config HEXDUMP
+//config:      bool "hexdump (8.8 kb)"
+//config:      default y
+//config:      help
+//config:      The hexdump utility is used to display binary data in a readable
+//config:      way that is comparable to the output from most hex editors.
+//config:
+//config:config FEATURE_HEXDUMP_REVERSE
+//config:      bool "Support -R, reverse of 'hexdump -Cv'"
+//config:      default y
+//config:      depends on HEXDUMP
+//config:      help
+//config:      The hexdump utility is used to display binary data in an ascii
+//config:      readable way. This option creates binary data from an ascii input.
+//config:      NB: this option is non-standard. It's unwise to use it in scripts
+//config:      aimed to be portable.
+//config:
+//config:config HD
+//config:      bool "hd (8 kb)"
+//config:      default y
+//config:      help
+//config:      hd is an alias to hexdump -C.
+
+//applet:IF_HEXDUMP(APPLET_NOEXEC(hexdump, hexdump, BB_DIR_USR_BIN, BB_SUID_DROP, hexdump))
+//applet:IF_HD(APPLET_NOEXEC(hd, hexdump, BB_DIR_USR_BIN, BB_SUID_DROP, hd))
+
+//kbuild:lib-$(CONFIG_HEXDUMP) += hexdump.o
+//kbuild:lib-$(CONFIG_HD) += hexdump.o
+
+//usage:#define hexdump_trivial_usage
+//usage:       "[-bcCdefnosvx" IF_FEATURE_HEXDUMP_REVERSE("R") "] [FILE]..."
+//usage:#define hexdump_full_usage "\n\n"
+//usage:       "Display FILEs (or stdin) in a user specified format\n"
+//usage:     "\n       -b              1-byte octal display"
+//usage:     "\n       -c              1-byte character display"
+//usage:     "\n       -d              2-byte decimal display"
+//usage:     "\n       -o              2-byte octal display"
+//usage:     "\n       -x              2-byte hex display"
+//usage:     "\n       -C              hex+ASCII 16 bytes per line"
+//usage:     "\n       -v              Show all (no dup folding)"
+//usage:     "\n       -e FORMAT_STR   Example: '16/1 \"%02x|\"\"\\n\"'"
+//usage:     "\n       -f FORMAT_FILE"
+// exactly the same help text lines in hexdump and xxd:
+//usage:     "\n       -n LENGTH       Show only first LENGTH bytes"
+//usage:     "\n       -s OFFSET       Skip OFFSET bytes"
+//usage:       IF_FEATURE_HEXDUMP_REVERSE(
+//usage:     "\n       -R              Reverse of 'hexdump -Cv'")
+// TODO: NONCOMPAT!!! move -R to xxd -r
+//usage:
+//usage:#define hd_trivial_usage
+//usage:       "FILE..."
+//usage:#define hd_full_usage "\n\n"
+//usage:       "hd is an alias for hexdump -C"
 
 #include "libbb.h"
 #include "dump.h"
@@ -32,24 +85,17 @@ static void bb_dump_addfile(dumper_t *dumper, char *name)
 }
 
 static const char *const add_strings[] = {
-       "\"%07.7_ax \" 16/1 \"%03o \" \"\\n\"",         /* b */
-       "\"%07.7_ax \" 16/1 \"%3_c \" \"\\n\"",         /* c */
-       "\"%07.7_ax \" 8/2 \"  %05u \" \"\\n\"",        /* d */
-       "\"%07.7_ax \" 8/2 \" %06o \" \"\\n\"",         /* o */
-       "\"%07.7_ax \" 8/2 \"   %04x \" \"\\n\"",       /* x */
+       "\"%07.7_ax \"16/1 \"%03o \"\"\n\"",   /* b */
+       "\"%07.7_ax \"16/1 \"%3_c \"\"\n\"",   /* c */
+       "\"%07.7_ax \"8/2 \"  %05u \"\"\n\"",  /* d */
+       "\"%07.7_ax \"8/2 \" %06o \"\"\n\"",   /* o */
+       "\"%07.7_ax \"8/2 \"   %04x \"\"\n\"", /* x */
 };
 
 static const char add_first[] ALIGN1 = "\"%07.7_Ax\n\"";
 
 static const char hexdump_opts[] ALIGN1 = "bcdoxCe:f:n:s:v" IF_FEATURE_HEXDUMP_REVERSE("R");
 
-static const struct suffix_mult suffixes[] = {
-       { "b", 512 },
-       { "k", 1024 },
-       { "m", 1024*1024 },
-       { "", 0 }
-};
-
 int hexdump_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 int hexdump_main(int argc, char **argv)
 {
@@ -61,7 +107,9 @@ int hexdump_main(int argc, char **argv)
        smallint rdump = 0;
 #endif
 
-       if (ENABLE_HD && !applet_name[2]) { /* we are "hd" */
+       if (ENABLE_HD
+        && (!ENABLE_HEXDUMP || !applet_name[2])
+       ) { /* we are "hd" */
                ch = 'C';
                goto hd_applet;
        }
@@ -79,9 +127,11 @@ int hexdump_main(int argc, char **argv)
                /* Save a little bit of space below by omitting the 'else's. */
                if (ch == 'C') {
  hd_applet:
-                       bb_dump_add(dumper, "\"%08.8_Ax\n\"");
-                       bb_dump_add(dumper, "\"%08.8_ax  \" 8/1 \"%02x \" \"  \" 8/1 \"%02x \" ");
-                       bb_dump_add(dumper, "\"  |\" 16/1 \"%_p\" \"|\\n\"");
+                       bb_dump_add(dumper, "\"%08.8_Ax\n\""); // final address line after dump
+                       //------------------- "address  "   8 * "xx "    "  "  8 * "xx "
+                       bb_dump_add(dumper, "\"%08.8_ax  \"8/1 \"%02x \"\"  \"8/1 \"%02x \"");
+                       //------------------- "  |ASCII...........|\n"
+                       bb_dump_add(dumper, "\"  |\"16/1 \"%_p\"\"|\n\"");
                }
                if (ch == 'e') {
                        bb_dump_add(dumper, optarg);
@@ -90,10 +140,15 @@ int hexdump_main(int argc, char **argv)
                        bb_dump_addfile(dumper, optarg);
                } /* else */
                if (ch == 'n') {
-                       dumper->dump_length = xatoi_u(optarg);
+                       dumper->dump_length = xatoi_positive(optarg);
                } /* else */
-               if (ch == 's') {
-                       dumper->dump_skip = xatoul_range_sfx(optarg, 0, LONG_MAX, suffixes);
+               if (ch == 's') { /* compat: -s accepts hex numbers too */
+                       dumper->dump_skip = xstrtoull_range_sfx(
+                               optarg,
+                               /*base:*/ 0,
+                               /*lo:*/ 0, /*hi:*/ OFF_T_MAX,
+                               bkm_suffixes
+                       );
                } /* else */
                if (ch == 'v') {
                        dumper->dump_vflag = ALL;
@@ -107,7 +162,7 @@ int hexdump_main(int argc, char **argv)
 
        if (!dumper->fshead) {
                bb_dump_add(dumper, add_first);
-               bb_dump_add(dumper, "\"%07.7_ax \" 8/2 \"%04x \" \"\\n\"");
+               bb_dump_add(dumper, "\"%07.7_ax \"8/2 \"%04x \"\"\n\"");
        }
 
        argv += optind;