maint: use C99 int size specifiers rather than PRI.MAX defines
[coreutils.git] / src / od.c
blob538175af78560cf236c41bfb190a3685c4d113c2
1 /* od -- dump files in octal and other formats
2 Copyright (C) 1992-2023 Free Software Foundation, Inc.
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
17 /* Written by Jim Meyering. */
19 #include <config.h>
21 #include <stdckdint.h>
22 #include <stdio.h>
23 #include <getopt.h>
24 #include <sys/types.h>
25 #include "system.h"
26 #include "argmatch.h"
27 #include "assure.h"
28 #include "ftoastr.h"
29 #include "quote.h"
30 #include "stat-size.h"
31 #include "xbinary-io.h"
32 #include "xprintf.h"
33 #include "xstrtol.h"
34 #include "xstrtol-error.h"
36 /* The official name of this program (e.g., no 'g' prefix). */
37 #define PROGRAM_NAME "od"
39 #define AUTHORS proper_name ("Jim Meyering")
41 /* The default number of input bytes per output line. */
42 #define DEFAULT_BYTES_PER_BLOCK 16
44 #if HAVE_UNSIGNED_LONG_LONG_INT
45 typedef unsigned long long int unsigned_long_long_int;
46 #else
47 /* This is just a place-holder to avoid a few '#if' directives.
48 In this case, the type isn't actually used. */
49 typedef unsigned long int unsigned_long_long_int;
50 #endif
52 enum size_spec
54 NO_SIZE,
55 CHAR,
56 SHORT,
57 INT,
58 LONG,
59 LONG_LONG,
60 /* FIXME: add INTMAX support, too */
61 FLOAT_SINGLE,
62 FLOAT_DOUBLE,
63 FLOAT_LONG_DOUBLE,
64 N_SIZE_SPECS
67 enum output_format
69 SIGNED_DECIMAL,
70 UNSIGNED_DECIMAL,
71 OCTAL,
72 HEXADECIMAL,
73 FLOATING_POINT,
74 NAMED_CHARACTER,
75 CHARACTER
78 #define MAX_INTEGRAL_TYPE_SIZE sizeof (unsigned_long_long_int)
80 /* The maximum number of bytes needed for a format string, including
81 the trailing nul. Each format string expects a variable amount of
82 padding (guaranteed to be at least 1 plus the field width), then an
83 element that will be formatted in the field. */
84 enum
86 FMT_BYTES_ALLOCATED =
87 (sizeof "%*.99" + 1
88 + MAX (sizeof "ld",
89 MAX (sizeof "jd",
90 MAX (sizeof "jd",
91 MAX (sizeof "ju",
92 sizeof "jx")))))
95 /* Ensure that our choice for FMT_BYTES_ALLOCATED is reasonable. */
96 static_assert (MAX_INTEGRAL_TYPE_SIZE * CHAR_BIT / 3 <= 99);
98 /* Each output format specification (from '-t spec' or from
99 old-style options) is represented by one of these structures. */
100 struct tspec
102 enum output_format fmt;
103 enum size_spec size; /* Type of input object. */
104 /* FIELDS is the number of fields per line, BLANK is the number of
105 fields to leave blank. WIDTH is width of one field, excluding
106 leading space, and PAD is total pad to divide among FIELDS.
107 PAD is at least as large as FIELDS. */
108 void (*print_function) (size_t fields, size_t blank, void const *data,
109 char const *fmt, int width, int pad);
110 char fmt_string[FMT_BYTES_ALLOCATED]; /* Of the style "%*d". */
111 bool hexl_mode_trailer;
112 int field_width; /* Minimum width of a field, excluding leading space. */
113 int pad_width; /* Total padding to be divided among fields. */
116 /* Convert the number of 8-bit bytes of a binary representation to
117 the number of characters (digits + sign if the type is signed)
118 required to represent the same quantity in the specified base/type.
119 For example, a 32-bit (4-byte) quantity may require a field width
120 as wide as the following for these types:
121 11 unsigned octal
122 11 signed decimal
123 10 unsigned decimal
124 8 unsigned hexadecimal */
126 static char const bytes_to_oct_digits[] =
127 {0, 3, 6, 8, 11, 14, 16, 19, 22, 25, 27, 30, 32, 35, 38, 41, 43};
129 static char const bytes_to_signed_dec_digits[] =
130 {1, 4, 6, 8, 11, 13, 16, 18, 20, 23, 25, 28, 30, 33, 35, 37, 40};
132 static char const bytes_to_unsigned_dec_digits[] =
133 {0, 3, 5, 8, 10, 13, 15, 17, 20, 22, 25, 27, 29, 32, 34, 37, 39};
135 static char const bytes_to_hex_digits[] =
136 {0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32};
138 /* It'll be a while before we see integral types wider than 16 bytes,
139 but if/when it happens, this check will catch it. Without this check,
140 a wider type would provoke a buffer overrun. */
141 static_assert (MAX_INTEGRAL_TYPE_SIZE
142 < ARRAY_CARDINALITY (bytes_to_hex_digits));
144 /* Make sure the other arrays have the same length. */
145 static_assert (sizeof bytes_to_oct_digits == sizeof bytes_to_signed_dec_digits);
146 static_assert (sizeof bytes_to_oct_digits
147 == sizeof bytes_to_unsigned_dec_digits);
148 static_assert (sizeof bytes_to_oct_digits == sizeof bytes_to_hex_digits);
150 /* Convert enum size_spec to the size of the named type. */
151 static const int width_bytes[] =
154 sizeof (char),
155 sizeof (short int),
156 sizeof (int),
157 sizeof (long int),
158 sizeof (unsigned_long_long_int),
159 sizeof (float),
160 sizeof (double),
161 sizeof (long double)
164 /* Ensure that for each member of 'enum size_spec' there is an
165 initializer in the width_bytes array. */
166 static_assert (ARRAY_CARDINALITY (width_bytes) == N_SIZE_SPECS);
168 /* Names for some non-printing characters. */
169 static char const charname[33][4] =
171 "nul", "soh", "stx", "etx", "eot", "enq", "ack", "bel",
172 "bs", "ht", "nl", "vt", "ff", "cr", "so", "si",
173 "dle", "dc1", "dc2", "dc3", "dc4", "nak", "syn", "etb",
174 "can", "em", "sub", "esc", "fs", "gs", "rs", "us",
175 "sp"
178 /* Address base (8, 10 or 16). */
179 static int address_base;
181 /* The number of octal digits required to represent the largest
182 address value. */
183 #define MAX_ADDRESS_LENGTH \
184 ((sizeof (uintmax_t) * CHAR_BIT + CHAR_BIT - 1) / 3)
186 /* Width of a normal address. */
187 static int address_pad_len;
189 /* Minimum length when detecting --strings. */
190 static size_t string_min;
192 /* True when in --strings mode. */
193 static bool flag_dump_strings;
195 /* True if we should recognize the older non-option arguments
196 that specified at most one file and optional arguments specifying
197 offset and pseudo-start address. */
198 static bool traditional;
200 /* True if an old-style 'pseudo-address' was specified. */
201 static bool flag_pseudo_start;
203 /* The difference between the old-style pseudo starting address and
204 the number of bytes to skip. */
205 static uintmax_t pseudo_offset;
207 /* Function that accepts an address and an optional following char,
208 and prints the address and char to stdout. */
209 static void (*format_address) (uintmax_t, char);
211 /* The number of input bytes to skip before formatting and writing. */
212 static uintmax_t n_bytes_to_skip = 0;
214 /* When false, MAX_BYTES_TO_FORMAT and END_OFFSET are ignored, and all
215 input is formatted. */
216 static bool limit_bytes_to_format = false;
218 /* The maximum number of bytes that will be formatted. */
219 static uintmax_t max_bytes_to_format;
221 /* The offset of the first byte after the last byte to be formatted. */
222 static uintmax_t end_offset;
224 /* When true and two or more consecutive blocks are equal, format
225 only the first block and output an asterisk alone on the following
226 line to indicate that identical blocks have been elided. */
227 static bool abbreviate_duplicate_blocks = true;
229 /* An array of specs describing how to format each input block. */
230 static struct tspec *spec;
232 /* The number of format specs. */
233 static size_t n_specs;
235 /* The allocated length of SPEC. */
236 static size_t n_specs_allocated;
238 /* The number of input bytes formatted per output line. It must be
239 a multiple of the least common multiple of the sizes associated with
240 the specified output types. It should be as large as possible, but
241 no larger than 16 -- unless specified with the -w option. */
242 static size_t bytes_per_block;
244 /* Human-readable representation of *file_list (for error messages).
245 It differs from file_list[-1] only when file_list[-1] is "-". */
246 static char const *input_filename;
248 /* A null-terminated list of the file-arguments from the command line. */
249 static char const *const *file_list;
251 /* Initializer for file_list if no file-arguments
252 were specified on the command line. */
253 static char const *const default_file_list[] = {"-", nullptr};
255 /* The input stream associated with the current file. */
256 static FILE *in_stream;
258 /* If true, at least one of the files we read was standard input. */
259 static bool have_read_stdin;
261 /* Map the size in bytes to a type identifier. */
262 static enum size_spec integral_type_size[MAX_INTEGRAL_TYPE_SIZE + 1];
264 #define MAX_FP_TYPE_SIZE sizeof (long double)
265 static enum size_spec fp_type_size[MAX_FP_TYPE_SIZE + 1];
267 #ifndef WORDS_BIGENDIAN
268 # define WORDS_BIGENDIAN 0
269 #endif
271 /* Use native endianness by default. */
272 static bool input_swap;
274 static char const short_options[] = "A:aBbcDdeFfHhIij:LlN:OoS:st:vw::Xx";
276 /* For long options that have no equivalent short option, use a
277 non-character as a pseudo short option, starting with CHAR_MAX + 1. */
278 enum
280 TRADITIONAL_OPTION = CHAR_MAX + 1,
281 ENDIAN_OPTION,
284 enum endian_type
286 endian_little,
287 endian_big
290 static char const *const endian_args[] =
292 "little", "big", nullptr
295 static enum endian_type const endian_types[] =
297 endian_little, endian_big
300 static struct option const long_options[] =
302 {"skip-bytes", required_argument, nullptr, 'j'},
303 {"address-radix", required_argument, nullptr, 'A'},
304 {"read-bytes", required_argument, nullptr, 'N'},
305 {"format", required_argument, nullptr, 't'},
306 {"output-duplicates", no_argument, nullptr, 'v'},
307 {"strings", optional_argument, nullptr, 'S'},
308 {"traditional", no_argument, nullptr, TRADITIONAL_OPTION},
309 {"width", optional_argument, nullptr, 'w'},
310 {"endian", required_argument, nullptr, ENDIAN_OPTION },
312 {GETOPT_HELP_OPTION_DECL},
313 {GETOPT_VERSION_OPTION_DECL},
314 {nullptr, 0, nullptr, 0}
317 void
318 usage (int status)
320 if (status != EXIT_SUCCESS)
321 emit_try_help ();
322 else
324 printf (_("\
325 Usage: %s [OPTION]... [FILE]...\n\
326 or: %s [-abcdfilosx]... [FILE] [[+]OFFSET[.][b]]\n\
327 or: %s --traditional [OPTION]... [FILE] [[+]OFFSET[.][b] [+][LABEL][.][b]]\n\
329 program_name, program_name, program_name);
330 fputs (_("\n\
331 Write an unambiguous representation, octal bytes by default,\n\
332 of FILE to standard output. With more than one FILE argument,\n\
333 concatenate them in the listed order to form the input.\n\
334 "), stdout);
336 emit_stdin_note ();
338 fputs (_("\
340 If first and second call formats both apply, the second format is assumed\n\
341 if the last operand begins with + or (if there are 2 operands) a digit.\n\
342 An OFFSET operand means -j OFFSET. LABEL is the pseudo-address\n\
343 at first byte printed, incremented when dump is progressing.\n\
344 For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal;\n\
345 suffixes may be . for octal and b for multiply by 512.\n\
346 "), stdout);
348 emit_mandatory_arg_note ();
350 fputs (_("\
351 -A, --address-radix=RADIX output format for file offsets; RADIX is one\n\
352 of [doxn], for Decimal, Octal, Hex or None\n\
353 --endian={big|little} swap input bytes according the specified order\n\
354 -j, --skip-bytes=BYTES skip BYTES input bytes first\n\
355 "), stdout);
356 fputs (_("\
357 -N, --read-bytes=BYTES limit dump to BYTES input bytes\n\
358 -S BYTES, --strings[=BYTES] show only NUL terminated strings\n\
359 of at least BYTES (3) printable characters\n\
360 -t, --format=TYPE select output format or formats\n\
361 -v, --output-duplicates do not use * to mark line suppression\n\
362 -w[BYTES], --width[=BYTES] output BYTES bytes per output line;\n\
363 32 is implied when BYTES is not specified\n\
364 --traditional accept arguments in third form above\n\
365 "), stdout);
366 fputs (HELP_OPTION_DESCRIPTION, stdout);
367 fputs (VERSION_OPTION_DESCRIPTION, stdout);
368 fputs (_("\
371 Traditional format specifications may be intermixed; they accumulate:\n\
372 -a same as -t a, select named characters, ignoring high-order bit\n\
373 -b same as -t o1, select octal bytes\n\
374 -c same as -t c, select printable characters or backslash escapes\n\
375 -d same as -t u2, select unsigned decimal 2-byte units\n\
376 "), stdout);
377 fputs (_("\
378 -f same as -t fF, select floats\n\
379 -i same as -t dI, select decimal ints\n\
380 -l same as -t dL, select decimal longs\n\
381 -o same as -t o2, select octal 2-byte units\n\
382 -s same as -t d2, select decimal 2-byte units\n\
383 -x same as -t x2, select hexadecimal 2-byte units\n\
384 "), stdout);
385 fputs (_("\
388 TYPE is made up of one or more of these specifications:\n\
389 a named character, ignoring high-order bit\n\
390 c printable character or backslash escape\n\
391 "), stdout);
392 fputs (_("\
393 d[SIZE] signed decimal, SIZE bytes per integer\n\
394 f[SIZE] floating point, SIZE bytes per float\n\
395 o[SIZE] octal, SIZE bytes per integer\n\
396 u[SIZE] unsigned decimal, SIZE bytes per integer\n\
397 x[SIZE] hexadecimal, SIZE bytes per integer\n\
398 "), stdout);
399 fputs (_("\
401 SIZE is a number. For TYPE in [doux], SIZE may also be C for\n\
402 sizeof(char), S for sizeof(short), I for sizeof(int) or L for\n\
403 sizeof(long). If TYPE is f, SIZE may also be F for sizeof(float), D\n\
404 for sizeof(double) or L for sizeof(long double).\n\
405 "), stdout);
406 fputs (_("\
408 Adding a z suffix to any type displays printable characters at the end of\n\
409 each output line.\n\
410 "), stdout);
411 fputs (_("\
414 BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:\n\
415 b 512\n\
416 KB 1000\n\
417 K 1024\n\
418 MB 1000*1000\n\
419 M 1024*1024\n\
420 and so on for G, T, P, E, Z, Y, R, Q.\n\
421 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.\n\
422 "), stdout);
423 emit_ancillary_info (PROGRAM_NAME);
425 exit (status);
428 /* Define the print functions. */
430 #define PRINT_FIELDS(N, T, FMT_STRING_DECL, ACTION) \
431 static void \
432 N (size_t fields, size_t blank, void const *block, \
433 FMT_STRING_DECL, int width, int pad) \
435 T const *p = block; \
436 uintmax_t i; \
437 int pad_remaining = pad; \
438 for (i = fields; blank < i; i--) \
440 int next_pad = pad * (i - 1) / fields; \
441 int adjusted_width = pad_remaining - next_pad + width; \
442 T x; \
443 if (input_swap && sizeof (T) > 1) \
445 size_t j; \
446 union { \
447 T x; \
448 char b[sizeof (T)]; \
449 } u; \
450 for (j = 0; j < sizeof (T); j++) \
451 u.b[j] = ((char const *) p)[sizeof (T) - 1 - j]; \
452 x = u.x; \
454 else \
455 x = *p; \
456 p++; \
457 ACTION; \
458 pad_remaining = next_pad; \
462 #define PRINT_TYPE(N, T) \
463 PRINT_FIELDS (N, T, char const *fmt_string, \
464 xprintf (fmt_string, adjusted_width, x))
466 #define PRINT_FLOATTYPE(N, T, FTOASTR, BUFSIZE) \
467 PRINT_FIELDS (N, T, MAYBE_UNUSED char const *fmt_string, \
468 char buf[BUFSIZE]; \
469 FTOASTR (buf, sizeof buf, 0, 0, x); \
470 xprintf ("%*s", adjusted_width, buf))
472 PRINT_TYPE (print_s_char, signed char)
473 PRINT_TYPE (print_char, unsigned char)
474 PRINT_TYPE (print_s_short, short int)
475 PRINT_TYPE (print_short, unsigned short int)
476 PRINT_TYPE (print_int, unsigned int)
477 PRINT_TYPE (print_long, unsigned long int)
478 PRINT_TYPE (print_long_long, unsigned_long_long_int)
480 PRINT_FLOATTYPE (print_float, float, ftoastr, FLT_BUFSIZE_BOUND)
481 PRINT_FLOATTYPE (print_double, double, dtoastr, DBL_BUFSIZE_BOUND)
482 PRINT_FLOATTYPE (print_long_double, long double, ldtoastr, LDBL_BUFSIZE_BOUND)
484 #undef PRINT_TYPE
485 #undef PRINT_FLOATTYPE
487 static void
488 dump_hexl_mode_trailer (size_t n_bytes, char const *block)
490 fputs (" >", stdout);
491 for (size_t i = n_bytes; i > 0; i--)
493 unsigned char c = *block++;
494 unsigned char c2 = (isprint (c) ? c : '.');
495 putchar (c2);
497 putchar ('<');
500 static void
501 print_named_ascii (size_t fields, size_t blank, void const *block,
502 MAYBE_UNUSED char const *unused_fmt_string,
503 int width, int pad)
505 unsigned char const *p = block;
506 uintmax_t i;
507 int pad_remaining = pad;
508 for (i = fields; blank < i; i--)
510 int next_pad = pad * (i - 1) / fields;
511 int masked_c = *p++ & 0x7f;
512 char const *s;
513 char buf[2];
515 if (masked_c == 127)
516 s = "del";
517 else if (masked_c <= 040)
518 s = charname[masked_c];
519 else
521 buf[0] = masked_c;
522 buf[1] = 0;
523 s = buf;
526 xprintf ("%*s", pad_remaining - next_pad + width, s);
527 pad_remaining = next_pad;
531 static void
532 print_ascii (size_t fields, size_t blank, void const *block,
533 MAYBE_UNUSED char const *unused_fmt_string, int width,
534 int pad)
536 unsigned char const *p = block;
537 uintmax_t i;
538 int pad_remaining = pad;
539 for (i = fields; blank < i; i--)
541 int next_pad = pad * (i - 1) / fields;
542 unsigned char c = *p++;
543 char const *s;
544 char buf[4];
546 switch (c)
548 case '\0':
549 s = "\\0";
550 break;
552 case '\a':
553 s = "\\a";
554 break;
556 case '\b':
557 s = "\\b";
558 break;
560 case '\f':
561 s = "\\f";
562 break;
564 case '\n':
565 s = "\\n";
566 break;
568 case '\r':
569 s = "\\r";
570 break;
572 case '\t':
573 s = "\\t";
574 break;
576 case '\v':
577 s = "\\v";
578 break;
580 default:
581 sprintf (buf, (isprint (c) ? "%c" : "%03o"), c);
582 s = buf;
585 xprintf ("%*s", pad_remaining - next_pad + width, s);
586 pad_remaining = next_pad;
590 /* Convert a null-terminated (possibly zero-length) string S to an
591 int value. If S points to a non-digit set *P to S,
592 *VAL to 0, and return true. Otherwise, accumulate the integer value of
593 the string of digits. If the string of digits represents a value
594 larger than INT_MAX, don't modify *VAL or *P and return false.
595 Otherwise, advance *P to the first non-digit after S, set *VAL to
596 the result of the conversion and return true. */
598 static bool
599 simple_strtoi (char const *s, char const **p, int *val)
601 int sum;
603 for (sum = 0; ISDIGIT (*s); s++)
604 if (ckd_mul (&sum, sum, 10) || ckd_add (&sum, sum, *s - '0'))
605 return false;
606 *p = s;
607 *val = sum;
608 return true;
611 /* If S points to a single valid modern od format string, put
612 a description of that format in *TSPEC, make *NEXT point at the
613 character following the just-decoded format (if *NEXT is non-null),
614 and return true. If S is not valid, don't modify *NEXT or *TSPEC,
615 give a diagnostic, and return false. For example, if S were
616 "d4afL" *NEXT would be set to "afL" and *TSPEC would be
618 fmt = SIGNED_DECIMAL;
619 size = INT or LONG; (whichever integral_type_size[4] resolves to)
620 print_function = print_int; (assuming size == INT)
621 field_width = 11;
622 fmt_string = "%*d";
624 pad_width is determined later, but is at least as large as the
625 number of fields printed per row.
626 S_ORIG is solely for reporting errors. It should be the full format
627 string argument.
630 static bool ATTRIBUTE_NONNULL ()
631 decode_one_format (char const *s_orig, char const *s, char const **next,
632 struct tspec *tspec)
634 enum size_spec size_spec;
635 int size;
636 enum output_format fmt;
637 void (*print_function) (size_t, size_t, void const *, char const *,
638 int, int);
639 char const *p;
640 char c;
641 int field_width;
643 switch (*s)
645 case 'd':
646 case 'o':
647 case 'u':
648 case 'x':
649 c = *s;
650 ++s;
651 switch (*s)
653 case 'C':
654 ++s;
655 size = sizeof (char);
656 break;
658 case 'S':
659 ++s;
660 size = sizeof (short int);
661 break;
663 case 'I':
664 ++s;
665 size = sizeof (int);
666 break;
668 case 'L':
669 ++s;
670 size = sizeof (long int);
671 break;
673 default:
674 if (! simple_strtoi (s, &p, &size))
676 /* The integer at P in S would overflow an int.
677 A digit string that long is sufficiently odd looking
678 that the following diagnostic is sufficient. */
679 error (0, 0, _("invalid type string %s"), quote (s_orig));
680 return false;
682 if (p == s)
683 size = sizeof (int);
684 else
686 if (MAX_INTEGRAL_TYPE_SIZE < size
687 || integral_type_size[size] == NO_SIZE)
689 error (0, 0, _("invalid type string %s;\nthis system"
690 " doesn't provide a %d-byte integral type"),
691 quote (s_orig), size);
692 return false;
694 s = p;
696 break;
699 #define ISPEC_TO_FORMAT(Spec, Min_format, Long_format, Max_format) \
700 ((Spec) == LONG_LONG ? (Max_format) \
701 : ((Spec) == LONG ? (Long_format) \
702 : (Min_format))) \
704 size_spec = integral_type_size[size];
706 switch (c)
708 case 'd':
709 fmt = SIGNED_DECIMAL;
710 field_width = bytes_to_signed_dec_digits[size];
711 sprintf (tspec->fmt_string, "%%*%s",
712 ISPEC_TO_FORMAT (size_spec, "d", "ld", "jd"));
713 break;
715 case 'o':
716 fmt = OCTAL;
717 sprintf (tspec->fmt_string, "%%*.%d%s",
718 (field_width = bytes_to_oct_digits[size]),
719 ISPEC_TO_FORMAT (size_spec, "o", "lo", "jo"));
720 break;
722 case 'u':
723 fmt = UNSIGNED_DECIMAL;
724 field_width = bytes_to_unsigned_dec_digits[size];
725 sprintf (tspec->fmt_string, "%%*%s",
726 ISPEC_TO_FORMAT (size_spec, "u", "lu", "ju"));
727 break;
729 case 'x':
730 fmt = HEXADECIMAL;
731 sprintf (tspec->fmt_string, "%%*.%d%s",
732 (field_width = bytes_to_hex_digits[size]),
733 ISPEC_TO_FORMAT (size_spec, "x", "lx", "jx"));
734 break;
736 default:
737 unreachable ();
740 switch (size_spec)
742 case CHAR:
743 print_function = (fmt == SIGNED_DECIMAL
744 ? print_s_char
745 : print_char);
746 break;
748 case SHORT:
749 print_function = (fmt == SIGNED_DECIMAL
750 ? print_s_short
751 : print_short);
752 break;
754 case INT:
755 print_function = print_int;
756 break;
758 case LONG:
759 print_function = print_long;
760 break;
762 case LONG_LONG:
763 print_function = print_long_long;
764 break;
766 default:
767 affirm (false);
769 break;
771 case 'f':
772 fmt = FLOATING_POINT;
773 ++s;
774 switch (*s)
776 case 'F':
777 ++s;
778 size = sizeof (float);
779 break;
781 case 'D':
782 ++s;
783 size = sizeof (double);
784 break;
786 case 'L':
787 ++s;
788 size = sizeof (long double);
789 break;
791 default:
792 if (! simple_strtoi (s, &p, &size))
794 /* The integer at P in S would overflow an int.
795 A digit string that long is sufficiently odd looking
796 that the following diagnostic is sufficient. */
797 error (0, 0, _("invalid type string %s"), quote (s_orig));
798 return false;
800 if (p == s)
801 size = sizeof (double);
802 else
804 if (size > MAX_FP_TYPE_SIZE
805 || fp_type_size[size] == NO_SIZE)
807 error (0, 0,
808 _("invalid type string %s;\n"
809 "this system doesn't provide a %d-byte"
810 " floating point type"),
811 quote (s_orig), size);
812 return false;
814 s = p;
816 break;
818 size_spec = fp_type_size[size];
821 struct lconv const *locale = localeconv ();
822 size_t decimal_point_len =
823 (locale->decimal_point[0] ? strlen (locale->decimal_point) : 1);
825 switch (size_spec)
827 case FLOAT_SINGLE:
828 print_function = print_float;
829 field_width = FLT_STRLEN_BOUND_L (decimal_point_len);
830 break;
832 case FLOAT_DOUBLE:
833 print_function = print_double;
834 field_width = DBL_STRLEN_BOUND_L (decimal_point_len);
835 break;
837 case FLOAT_LONG_DOUBLE:
838 print_function = print_long_double;
839 field_width = LDBL_STRLEN_BOUND_L (decimal_point_len);
840 break;
842 default:
843 affirm (false);
846 break;
849 case 'a':
850 ++s;
851 fmt = NAMED_CHARACTER;
852 size_spec = CHAR;
853 print_function = print_named_ascii;
854 field_width = 3;
855 break;
857 case 'c':
858 ++s;
859 fmt = CHARACTER;
860 size_spec = CHAR;
861 print_function = print_ascii;
862 field_width = 3;
863 break;
865 default:
866 error (0, 0, _("invalid character '%c' in type string %s"),
867 *s, quote (s_orig));
868 return false;
871 tspec->size = size_spec;
872 tspec->fmt = fmt;
873 tspec->print_function = print_function;
875 tspec->field_width = field_width;
876 tspec->hexl_mode_trailer = (*s == 'z');
877 if (tspec->hexl_mode_trailer)
878 s++;
880 *next = s;
881 return true;
884 /* Given a list of one or more input filenames FILE_LIST, set the global
885 file pointer IN_STREAM and the global string INPUT_FILENAME to the
886 first one that can be successfully opened. Modify FILE_LIST to
887 reference the next filename in the list. A file name of "-" is
888 interpreted as standard input. If any file open fails, give an error
889 message and return false. */
891 static bool
892 open_next_file (void)
894 bool ok = true;
898 input_filename = *file_list;
899 if (input_filename == nullptr)
900 return ok;
901 ++file_list;
903 if (STREQ (input_filename, "-"))
905 input_filename = _("standard input");
906 in_stream = stdin;
907 have_read_stdin = true;
908 xset_binary_mode (STDIN_FILENO, O_BINARY);
910 else
912 in_stream = fopen (input_filename, (O_BINARY ? "rb" : "r"));
913 if (in_stream == nullptr)
915 error (0, errno, "%s", quotef (input_filename));
916 ok = false;
920 while (in_stream == nullptr);
922 if (limit_bytes_to_format && !flag_dump_strings)
923 setvbuf (in_stream, nullptr, _IONBF, 0);
925 return ok;
928 /* Test whether there have been errors on in_stream, and close it if
929 it is not standard input. Return false if there has been an error
930 on in_stream or stdout; return true otherwise. This function will
931 report more than one error only if both a read and a write error
932 have occurred. IN_ERRNO, if nonzero, is the error number
933 corresponding to the most recent action for IN_STREAM. */
935 static bool
936 check_and_close (int in_errno)
938 bool ok = true;
940 if (in_stream != nullptr)
942 if (!ferror (in_stream))
943 in_errno = 0;
944 if (STREQ (file_list[-1], "-"))
945 clearerr (in_stream);
946 else if (fclose (in_stream) != 0 && !in_errno)
947 in_errno = errno;
948 if (in_errno)
950 error (0, in_errno, "%s", quotef (input_filename));
951 ok = false;
954 in_stream = nullptr;
957 if (ferror (stdout))
959 error (0, 0, _("write error"));
960 ok = false;
963 return ok;
966 /* Decode the modern od format string S. Append the decoded
967 representation to the global array SPEC, reallocating SPEC if
968 necessary. Return true if S is valid. */
970 static bool ATTRIBUTE_NONNULL ()
971 decode_format_string (char const *s)
973 char const *s_orig = s;
975 while (*s != '\0')
977 char const *next;
979 if (n_specs_allocated <= n_specs)
980 spec = X2NREALLOC (spec, &n_specs_allocated);
982 if (! decode_one_format (s_orig, s, &next, &spec[n_specs]))
983 return false;
985 affirm (s != next);
986 s = next;
987 ++n_specs;
990 return true;
993 /* Given a list of one or more input filenames FILE_LIST, set the global
994 file pointer IN_STREAM to position N_SKIP in the concatenation of
995 those files. If any file operation fails or if there are fewer than
996 N_SKIP bytes in the combined input, give an error message and return
997 false. When possible, use seek rather than read operations to
998 advance IN_STREAM. */
1000 static bool
1001 skip (uintmax_t n_skip)
1003 bool ok = true;
1004 int in_errno = 0;
1006 if (n_skip == 0)
1007 return true;
1009 while (in_stream != nullptr) /* EOF. */
1011 struct stat file_stats;
1013 /* First try seeking. For large offsets, this extra work is
1014 worthwhile. If the offset is below some threshold it may be
1015 more efficient to move the pointer by reading. There are two
1016 issues when trying to seek:
1017 - the file must be seekable.
1018 - before seeking to the specified position, make sure
1019 that the new position is in the current file.
1020 Try to do that by getting file's size using fstat.
1021 But that will work only for regular files. */
1023 if (fstat (fileno (in_stream), &file_stats) == 0)
1025 bool usable_size = usable_st_size (&file_stats);
1027 /* The st_size field is valid for regular files.
1028 If the number of bytes left to skip is larger than
1029 the size of the current file, we can decrement n_skip
1030 and go on to the next file. Skip this optimization also
1031 when st_size is no greater than the block size, because
1032 some kernels report nonsense small file sizes for
1033 proc-like file systems. */
1034 if (usable_size && STP_BLKSIZE (&file_stats) < file_stats.st_size)
1036 if ((uintmax_t) file_stats.st_size < n_skip)
1037 n_skip -= file_stats.st_size;
1038 else
1040 if (fseeko (in_stream, n_skip, SEEK_CUR) != 0)
1042 in_errno = errno;
1043 ok = false;
1045 n_skip = 0;
1049 else if (!usable_size && fseeko (in_stream, n_skip, SEEK_CUR) == 0)
1050 n_skip = 0;
1052 /* If it's not a regular file with nonnegative size,
1053 or if it's so small that it might be in a proc-like file system,
1054 position the file pointer by reading. */
1056 else
1058 char buf[BUFSIZ];
1059 size_t n_bytes_read, n_bytes_to_read = BUFSIZ;
1061 while (0 < n_skip)
1063 if (n_skip < n_bytes_to_read)
1064 n_bytes_to_read = n_skip;
1065 n_bytes_read = fread (buf, 1, n_bytes_to_read, in_stream);
1066 n_skip -= n_bytes_read;
1067 if (n_bytes_read != n_bytes_to_read)
1069 if (ferror (in_stream))
1071 in_errno = errno;
1072 ok = false;
1073 n_skip = 0;
1074 break;
1076 if (feof (in_stream))
1077 break;
1082 if (n_skip == 0)
1083 break;
1086 else /* cannot fstat() file */
1088 error (0, errno, "%s", quotef (input_filename));
1089 ok = false;
1092 ok &= check_and_close (in_errno);
1094 ok &= open_next_file ();
1097 if (n_skip != 0)
1098 error (EXIT_FAILURE, 0, _("cannot skip past end of combined input"));
1100 return ok;
1103 static void
1104 format_address_none (MAYBE_UNUSED uintmax_t address,
1105 MAYBE_UNUSED char c)
1109 static void
1110 format_address_std (uintmax_t address, char c)
1112 char buf[MAX_ADDRESS_LENGTH + 2];
1113 char *p = buf + sizeof buf;
1114 char const *pbound;
1116 *--p = '\0';
1117 *--p = c;
1118 pbound = p - address_pad_len;
1120 /* Use a special case of the code for each base. This is measurably
1121 faster than generic code. */
1122 switch (address_base)
1124 case 8:
1126 *--p = '0' + (address & 7);
1127 while ((address >>= 3) != 0);
1128 break;
1130 case 10:
1132 *--p = '0' + (address % 10);
1133 while ((address /= 10) != 0);
1134 break;
1136 case 16:
1138 *--p = "0123456789abcdef"[address & 15];
1139 while ((address >>= 4) != 0);
1140 break;
1143 while (pbound < p)
1144 *--p = '0';
1146 fputs (p, stdout);
1149 static void
1150 format_address_paren (uintmax_t address, char c)
1152 putchar ('(');
1153 format_address_std (address, ')');
1154 if (c)
1155 putchar (c);
1158 static void
1159 format_address_label (uintmax_t address, char c)
1161 format_address_std (address, ' ');
1162 format_address_paren (address + pseudo_offset, c);
1165 /* Write N_BYTES bytes from CURR_BLOCK to standard output once for each
1166 of the N_SPEC format specs. CURRENT_OFFSET is the byte address of
1167 CURR_BLOCK in the concatenation of input files, and it is printed
1168 (optionally) only before the output line associated with the first
1169 format spec. When duplicate blocks are being abbreviated, the output
1170 for a sequence of identical input blocks is the output for the first
1171 block followed by an asterisk alone on a line. It is valid to compare
1172 the blocks PREV_BLOCK and CURR_BLOCK only when N_BYTES == BYTES_PER_BLOCK.
1173 That condition may be false only for the last input block. */
1175 static void
1176 write_block (uintmax_t current_offset, size_t n_bytes,
1177 char const *prev_block, char const *curr_block)
1179 static bool first = true;
1180 static bool prev_pair_equal = false;
1182 #define EQUAL_BLOCKS(b1, b2) (memcmp (b1, b2, bytes_per_block) == 0)
1184 if (abbreviate_duplicate_blocks
1185 && !first && n_bytes == bytes_per_block
1186 && EQUAL_BLOCKS (prev_block, curr_block))
1188 if (prev_pair_equal)
1190 /* The two preceding blocks were equal, and the current
1191 block is the same as the last one, so print nothing. */
1193 else
1195 printf ("*\n");
1196 prev_pair_equal = true;
1199 else
1201 prev_pair_equal = false;
1202 for (size_t i = 0; i < n_specs; i++)
1204 int datum_width = width_bytes[spec[i].size];
1205 int fields_per_block = bytes_per_block / datum_width;
1206 int blank_fields = (bytes_per_block - n_bytes) / datum_width;
1207 if (i == 0)
1208 format_address (current_offset, '\0');
1209 else
1210 printf ("%*s", address_pad_len, "");
1211 (*spec[i].print_function) (fields_per_block, blank_fields,
1212 curr_block, spec[i].fmt_string,
1213 spec[i].field_width, spec[i].pad_width);
1214 if (spec[i].hexl_mode_trailer)
1216 /* space-pad out to full line width, then dump the trailer */
1217 int field_width = spec[i].field_width;
1218 int pad_width = (spec[i].pad_width * blank_fields
1219 / fields_per_block);
1220 printf ("%*s", blank_fields * field_width + pad_width, "");
1221 dump_hexl_mode_trailer (n_bytes, curr_block);
1223 putchar ('\n');
1226 first = false;
1229 /* Read a single byte into *C from the concatenation of the input files
1230 named in the global array FILE_LIST. On the first call to this
1231 function, the global variable IN_STREAM is expected to be an open
1232 stream associated with the input file INPUT_FILENAME. If IN_STREAM
1233 is at end-of-file, close it and update the global variables IN_STREAM
1234 and INPUT_FILENAME so they correspond to the next file in the list.
1235 Then try to read a byte from the newly opened file. Repeat if
1236 necessary until EOF is reached for the last file in FILE_LIST, then
1237 set *C to EOF and return. Subsequent calls do likewise. Return
1238 true if successful. */
1240 static bool
1241 read_char (int *c)
1243 bool ok = true;
1245 *c = EOF;
1247 while (in_stream != nullptr) /* EOF. */
1249 *c = fgetc (in_stream);
1251 if (*c != EOF)
1252 break;
1254 ok &= check_and_close (errno);
1256 ok &= open_next_file ();
1259 return ok;
1262 /* Read N bytes into BLOCK from the concatenation of the input files
1263 named in the global array FILE_LIST. On the first call to this
1264 function, the global variable IN_STREAM is expected to be an open
1265 stream associated with the input file INPUT_FILENAME. If all N
1266 bytes cannot be read from IN_STREAM, close IN_STREAM and update
1267 the global variables IN_STREAM and INPUT_FILENAME. Then try to
1268 read the remaining bytes from the newly opened file. Repeat if
1269 necessary until EOF is reached for the last file in FILE_LIST.
1270 On subsequent calls, don't modify BLOCK and return true. Set
1271 *N_BYTES_IN_BUFFER to the number of bytes read. If an error occurs,
1272 it will be detected through ferror when the stream is about to be
1273 closed. If there is an error, give a message but continue reading
1274 as usual and return false. Otherwise return true. */
1276 static bool
1277 read_block (size_t n, char *block, size_t *n_bytes_in_buffer)
1279 bool ok = true;
1281 affirm (0 < n && n <= bytes_per_block);
1283 *n_bytes_in_buffer = 0;
1285 while (in_stream != nullptr) /* EOF. */
1287 size_t n_needed;
1288 size_t n_read;
1290 n_needed = n - *n_bytes_in_buffer;
1291 n_read = fread (block + *n_bytes_in_buffer, 1, n_needed, in_stream);
1293 *n_bytes_in_buffer += n_read;
1295 if (n_read == n_needed)
1296 break;
1298 ok &= check_and_close (errno);
1300 ok &= open_next_file ();
1303 return ok;
1306 /* Return the least common multiple of the sizes associated
1307 with the format specs. */
1309 ATTRIBUTE_PURE
1310 static int
1311 get_lcm (void)
1313 int l_c_m = 1;
1315 for (size_t i = 0; i < n_specs; i++)
1316 l_c_m = lcm (l_c_m, width_bytes[spec[i].size]);
1317 return l_c_m;
1320 /* If S is a valid traditional offset specification with an optional
1321 leading '+' return true and set *OFFSET to the offset it denotes. */
1323 static bool
1324 parse_old_offset (char const *s, uintmax_t *offset)
1326 int radix;
1328 if (*s == '\0')
1329 return false;
1331 /* Skip over any leading '+'. */
1332 if (s[0] == '+')
1333 ++s;
1335 /* Determine the radix we'll use to interpret S. If there is a '.',
1336 it's decimal, otherwise, if the string begins with '0X'or '0x',
1337 it's hexadecimal, else octal. */
1338 if (strchr (s, '.') != nullptr)
1339 radix = 10;
1340 else
1342 if (s[0] == '0' && (s[1] == 'x' || s[1] == 'X'))
1343 radix = 16;
1344 else
1345 radix = 8;
1348 return xstrtoumax (s, nullptr, radix, offset, "Bb") == LONGINT_OK;
1351 /* Read a chunk of size BYTES_PER_BLOCK from the input files, write the
1352 formatted block to standard output, and repeat until the specified
1353 maximum number of bytes has been read or until all input has been
1354 processed. If the last block read is smaller than BYTES_PER_BLOCK
1355 and its size is not a multiple of the size associated with a format
1356 spec, extend the input block with zero bytes until its length is a
1357 multiple of all format spec sizes. Write the final block. Finally,
1358 write on a line by itself the offset of the byte after the last byte
1359 read. Accumulate return values from calls to read_block and
1360 check_and_close, and if any was false, return false.
1361 Otherwise, return true. */
1363 static bool
1364 dump (void)
1366 char *block[2];
1367 uintmax_t current_offset;
1368 bool idx = false;
1369 bool ok = true;
1370 size_t n_bytes_read;
1372 block[0] = xnmalloc (2, bytes_per_block);
1373 block[1] = block[0] + bytes_per_block;
1375 current_offset = n_bytes_to_skip;
1377 if (limit_bytes_to_format)
1379 while (ok)
1381 size_t n_needed;
1382 if (current_offset >= end_offset)
1384 n_bytes_read = 0;
1385 break;
1387 n_needed = MIN (end_offset - current_offset,
1388 (uintmax_t) bytes_per_block);
1389 ok &= read_block (n_needed, block[idx], &n_bytes_read);
1390 if (n_bytes_read < bytes_per_block)
1391 break;
1392 affirm (n_bytes_read == bytes_per_block);
1393 write_block (current_offset, n_bytes_read,
1394 block[!idx], block[idx]);
1395 if (ferror (stdout))
1396 ok = false;
1397 current_offset += n_bytes_read;
1398 idx = !idx;
1401 else
1403 while (ok)
1405 ok &= read_block (bytes_per_block, block[idx], &n_bytes_read);
1406 if (n_bytes_read < bytes_per_block)
1407 break;
1408 affirm (n_bytes_read == bytes_per_block);
1409 write_block (current_offset, n_bytes_read,
1410 block[!idx], block[idx]);
1411 if (ferror (stdout))
1412 ok = false;
1413 current_offset += n_bytes_read;
1414 idx = !idx;
1418 if (n_bytes_read > 0)
1420 int l_c_m;
1421 size_t bytes_to_write;
1423 l_c_m = get_lcm ();
1425 /* Ensure zero-byte padding up to the smallest multiple of l_c_m that
1426 is at least as large as n_bytes_read. */
1427 bytes_to_write = l_c_m * ((n_bytes_read + l_c_m - 1) / l_c_m);
1429 memset (block[idx] + n_bytes_read, 0, bytes_to_write - n_bytes_read);
1430 write_block (current_offset, n_bytes_read, block[!idx], block[idx]);
1431 current_offset += n_bytes_read;
1434 format_address (current_offset, '\n');
1436 if (limit_bytes_to_format && current_offset >= end_offset)
1437 ok &= check_and_close (0);
1439 free (block[0]);
1441 return ok;
1444 /* STRINGS mode. Find each "string constant" in the input.
1445 A string constant is a run of at least 'string_min' ASCII
1446 graphic (or formatting) characters terminated by a null.
1447 Based on a function written by Richard Stallman for a
1448 traditional version of od. Return true if successful. */
1450 static bool
1451 dump_strings (void)
1453 size_t bufsize = MAX (100, string_min);
1454 char *buf = xmalloc (bufsize);
1455 uintmax_t address = n_bytes_to_skip;
1456 bool ok = true;
1458 while (true)
1460 size_t i;
1461 int c;
1463 /* See if the next 'string_min' chars are all printing chars. */
1464 tryline:
1466 if (limit_bytes_to_format
1467 && (end_offset < string_min || end_offset - string_min <= address))
1468 break;
1470 for (i = 0; i < string_min; i++)
1472 ok &= read_char (&c);
1473 address++;
1474 if (c < 0)
1476 free (buf);
1477 return ok;
1479 if (! isprint (c))
1480 /* Found a non-printing. Try again starting with next char. */
1481 goto tryline;
1482 buf[i] = c;
1485 /* We found a run of 'string_min' printable characters.
1486 Now see if it is terminated with a null byte. */
1487 while (!limit_bytes_to_format || address < end_offset)
1489 if (i == bufsize)
1491 buf = X2REALLOC (buf, &bufsize);
1493 ok &= read_char (&c);
1494 address++;
1495 if (c < 0)
1497 free (buf);
1498 return ok;
1500 if (c == '\0')
1501 break; /* It is; print this string. */
1502 if (! isprint (c))
1503 goto tryline; /* It isn't; give up on this string. */
1504 buf[i++] = c; /* String continues; store it all. */
1507 /* If we get here, the string is all printable and null-terminated,
1508 so print it. It is all in 'buf' and 'i' is its length. */
1509 buf[i] = 0;
1510 format_address (address - i - 1, ' ');
1512 for (i = 0; (c = buf[i]); i++)
1514 switch (c)
1516 case '\a':
1517 fputs ("\\a", stdout);
1518 break;
1520 case '\b':
1521 fputs ("\\b", stdout);
1522 break;
1524 case '\f':
1525 fputs ("\\f", stdout);
1526 break;
1528 case '\n':
1529 fputs ("\\n", stdout);
1530 break;
1532 case '\r':
1533 fputs ("\\r", stdout);
1534 break;
1536 case '\t':
1537 fputs ("\\t", stdout);
1538 break;
1540 case '\v':
1541 fputs ("\\v", stdout);
1542 break;
1544 default:
1545 putc (c, stdout);
1548 putchar ('\n');
1551 /* We reach this point only if we search through
1552 (max_bytes_to_format - string_min) bytes before reaching EOF. */
1554 free (buf);
1556 ok &= check_and_close (0);
1557 return ok;
1561 main (int argc, char **argv)
1563 int n_files;
1564 size_t i;
1565 int l_c_m;
1566 idx_t desired_width IF_LINT ( = 0);
1567 bool modern = false;
1568 bool width_specified = false;
1569 bool ok = true;
1570 size_t width_per_block = 0;
1571 static char const multipliers[] = "bEGKkMmPQRTYZ0";
1573 /* The old-style 'pseudo starting address' to be printed in parentheses
1574 after any true address. */
1575 uintmax_t pseudo_start IF_LINT ( = 0);
1577 initialize_main (&argc, &argv);
1578 set_program_name (argv[0]);
1579 setlocale (LC_ALL, "");
1580 bindtextdomain (PACKAGE, LOCALEDIR);
1581 textdomain (PACKAGE);
1583 atexit (close_stdout);
1585 for (i = 0; i <= MAX_INTEGRAL_TYPE_SIZE; i++)
1586 integral_type_size[i] = NO_SIZE;
1588 integral_type_size[sizeof (char)] = CHAR;
1589 integral_type_size[sizeof (short int)] = SHORT;
1590 integral_type_size[sizeof (int)] = INT;
1591 integral_type_size[sizeof (long int)] = LONG;
1592 #if HAVE_UNSIGNED_LONG_LONG_INT
1593 /* If 'long int' and 'long long int' have the same size, it's fine
1594 to overwrite the entry for 'long' with this one. */
1595 integral_type_size[sizeof (unsigned_long_long_int)] = LONG_LONG;
1596 #endif
1598 for (i = 0; i <= MAX_FP_TYPE_SIZE; i++)
1599 fp_type_size[i] = NO_SIZE;
1601 fp_type_size[sizeof (float)] = FLOAT_SINGLE;
1602 /* The array entry for 'double' is filled in after that for 'long double'
1603 so that if they are the same size, we avoid any overhead of
1604 long double computation in libc. */
1605 fp_type_size[sizeof (long double)] = FLOAT_LONG_DOUBLE;
1606 fp_type_size[sizeof (double)] = FLOAT_DOUBLE;
1608 n_specs = 0;
1609 n_specs_allocated = 0;
1610 spec = nullptr;
1612 format_address = format_address_std;
1613 address_base = 8;
1614 address_pad_len = 7;
1615 flag_dump_strings = false;
1617 while (true)
1619 uintmax_t tmp;
1620 enum strtol_error s_err;
1621 int oi = -1;
1622 int c = getopt_long (argc, argv, short_options, long_options, &oi);
1623 if (c == -1)
1624 break;
1626 switch (c)
1628 case 'A':
1629 modern = true;
1630 switch (optarg[0])
1632 case 'd':
1633 format_address = format_address_std;
1634 address_base = 10;
1635 address_pad_len = 7;
1636 break;
1637 case 'o':
1638 format_address = format_address_std;
1639 address_base = 8;
1640 address_pad_len = 7;
1641 break;
1642 case 'x':
1643 format_address = format_address_std;
1644 address_base = 16;
1645 address_pad_len = 6;
1646 break;
1647 case 'n':
1648 format_address = format_address_none;
1649 address_pad_len = 0;
1650 break;
1651 default:
1652 error (EXIT_FAILURE, 0,
1653 _("invalid output address radix '%c';"
1654 " it must be one character from [doxn]"),
1655 optarg[0]);
1656 break;
1658 break;
1660 case 'j':
1661 modern = true;
1662 s_err = xstrtoumax (optarg, nullptr, 0,
1663 &n_bytes_to_skip, multipliers);
1664 if (s_err != LONGINT_OK)
1665 xstrtol_fatal (s_err, oi, c, long_options, optarg);
1666 break;
1668 case 'N':
1669 modern = true;
1670 limit_bytes_to_format = true;
1672 s_err = xstrtoumax (optarg, nullptr, 0, &max_bytes_to_format,
1673 multipliers);
1674 if (s_err != LONGINT_OK)
1675 xstrtol_fatal (s_err, oi, c, long_options, optarg);
1676 break;
1678 case 'S':
1679 modern = true;
1680 if (optarg == nullptr)
1681 string_min = 3;
1682 else
1684 s_err = xstrtoumax (optarg, nullptr, 0, &tmp, multipliers);
1685 if (s_err != LONGINT_OK)
1686 xstrtol_fatal (s_err, oi, c, long_options, optarg);
1688 /* The minimum string length may be no larger than SIZE_MAX,
1689 since we may allocate a buffer of this size. */
1690 if (SIZE_MAX < tmp)
1691 error (EXIT_FAILURE, 0, _("%s is too large"), quote (optarg));
1693 string_min = tmp;
1695 flag_dump_strings = true;
1696 break;
1698 case 't':
1699 modern = true;
1700 ok &= decode_format_string (optarg);
1701 break;
1703 case 'v':
1704 modern = true;
1705 abbreviate_duplicate_blocks = false;
1706 break;
1708 case TRADITIONAL_OPTION:
1709 traditional = true;
1710 break;
1712 case ENDIAN_OPTION:
1713 switch (XARGMATCH ("--endian", optarg, endian_args, endian_types))
1715 case endian_big:
1716 input_swap = ! WORDS_BIGENDIAN;
1717 break;
1718 case endian_little:
1719 input_swap = WORDS_BIGENDIAN;
1720 break;
1722 break;
1724 /* The next several cases map the traditional format
1725 specification options to the corresponding modern format
1726 specs. GNU od accepts any combination of old- and
1727 new-style options. Format specification options accumulate.
1728 The obsolescent and undocumented formats are compatible
1729 with FreeBSD 4.10 od. */
1731 #define CASE_OLD_ARG(old_char,new_string) \
1732 case old_char: \
1733 ok &= decode_format_string (new_string); \
1734 break
1736 CASE_OLD_ARG ('a', "a");
1737 CASE_OLD_ARG ('b', "o1");
1738 CASE_OLD_ARG ('c', "c");
1739 CASE_OLD_ARG ('D', "u4"); /* obsolescent and undocumented */
1740 CASE_OLD_ARG ('d', "u2");
1741 case 'F': /* obsolescent and undocumented alias */
1742 CASE_OLD_ARG ('e', "fD"); /* obsolescent and undocumented */
1743 CASE_OLD_ARG ('f', "fF");
1744 case 'X': /* obsolescent and undocumented alias */
1745 CASE_OLD_ARG ('H', "x4"); /* obsolescent and undocumented */
1746 CASE_OLD_ARG ('i', "dI");
1747 case 'I': case 'L': /* obsolescent and undocumented aliases */
1748 CASE_OLD_ARG ('l', "dL");
1749 CASE_OLD_ARG ('O', "o4"); /* obsolescent and undocumented */
1750 case 'B': /* obsolescent and undocumented alias */
1751 CASE_OLD_ARG ('o', "o2");
1752 CASE_OLD_ARG ('s', "d2");
1753 case 'h': /* obsolescent and undocumented alias */
1754 CASE_OLD_ARG ('x', "x2");
1756 #undef CASE_OLD_ARG
1758 case 'w':
1759 modern = true;
1760 width_specified = true;
1761 if (optarg == nullptr)
1763 desired_width = 32;
1765 else
1767 intmax_t w_tmp;
1768 s_err = xstrtoimax (optarg, nullptr, 10, &w_tmp, "");
1769 if (s_err != LONGINT_OK || w_tmp <= 0)
1770 xstrtol_fatal (s_err, oi, c, long_options, optarg);
1771 if (ckd_add (&desired_width, w_tmp, 0))
1772 error (EXIT_FAILURE, 0, _("%s is too large"), quote (optarg));
1774 break;
1776 case_GETOPT_HELP_CHAR;
1778 case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS);
1780 default:
1781 usage (EXIT_FAILURE);
1782 break;
1786 if (!ok)
1787 return EXIT_FAILURE;
1789 if (flag_dump_strings && n_specs > 0)
1790 error (EXIT_FAILURE, 0,
1791 _("no type may be specified when dumping strings"));
1793 n_files = argc - optind;
1795 /* If the --traditional option is used, there may be from
1796 0 to 3 remaining command line arguments; handle each case
1797 separately.
1798 od [file] [[+]offset[.][b] [[+]label[.][b]]]
1799 The offset and label have the same syntax.
1801 If --traditional is not given, and if no modern options are
1802 given, and if the offset begins with + or (if there are two
1803 operands) a digit, accept only this form, as per POSIX:
1804 od [file] [[+]offset[.][b]]
1807 if (!modern || traditional)
1809 uintmax_t o1;
1810 uintmax_t o2;
1812 switch (n_files)
1814 case 1:
1815 if ((traditional || argv[optind][0] == '+')
1816 && parse_old_offset (argv[optind], &o1))
1818 n_bytes_to_skip = o1;
1819 --n_files;
1820 ++argv;
1822 break;
1824 case 2:
1825 if ((traditional || argv[optind + 1][0] == '+'
1826 || ISDIGIT (argv[optind + 1][0]))
1827 && parse_old_offset (argv[optind + 1], &o2))
1829 if (traditional && parse_old_offset (argv[optind], &o1))
1831 n_bytes_to_skip = o1;
1832 flag_pseudo_start = true;
1833 pseudo_start = o2;
1834 argv += 2;
1835 n_files -= 2;
1837 else
1839 n_bytes_to_skip = o2;
1840 --n_files;
1841 argv[optind + 1] = argv[optind];
1842 ++argv;
1845 break;
1847 case 3:
1848 if (traditional
1849 && parse_old_offset (argv[optind + 1], &o1)
1850 && parse_old_offset (argv[optind + 2], &o2))
1852 n_bytes_to_skip = o1;
1853 flag_pseudo_start = true;
1854 pseudo_start = o2;
1855 argv[optind + 2] = argv[optind];
1856 argv += 2;
1857 n_files -= 2;
1859 break;
1862 if (traditional && 1 < n_files)
1864 error (0, 0, _("extra operand %s"), quote (argv[optind + 1]));
1865 error (0, 0, "%s",
1866 _("compatibility mode supports at most one file"));
1867 usage (EXIT_FAILURE);
1871 if (flag_pseudo_start)
1873 if (format_address == format_address_none)
1875 address_base = 8;
1876 address_pad_len = 7;
1877 format_address = format_address_paren;
1879 else
1880 format_address = format_address_label;
1883 if (limit_bytes_to_format)
1885 end_offset = n_bytes_to_skip + max_bytes_to_format;
1886 if (end_offset < n_bytes_to_skip)
1887 error (EXIT_FAILURE, 0, _("skip-bytes + read-bytes is too large"));
1890 if (n_specs == 0)
1891 decode_format_string ("oS");
1893 if (n_files > 0)
1895 /* Set the global pointer FILE_LIST so that it
1896 references the first file-argument on the command-line. */
1898 file_list = (char const *const *) &argv[optind];
1900 else
1902 /* No files were listed on the command line.
1903 Set the global pointer FILE_LIST so that it
1904 references the null-terminated list of one name: "-". */
1906 file_list = default_file_list;
1909 /* open the first input file */
1910 ok = open_next_file ();
1911 if (in_stream == nullptr)
1912 goto cleanup;
1914 /* skip over any unwanted header bytes */
1915 ok &= skip (n_bytes_to_skip);
1916 if (in_stream == nullptr)
1917 goto cleanup;
1919 pseudo_offset = (flag_pseudo_start ? pseudo_start - n_bytes_to_skip : 0);
1921 /* Compute output block length. */
1922 l_c_m = get_lcm ();
1924 if (width_specified)
1926 if (desired_width != 0 && desired_width % l_c_m == 0)
1927 bytes_per_block = desired_width;
1928 else
1930 error (0, 0, _("warning: invalid width %td; using %d instead"),
1931 desired_width, l_c_m);
1932 bytes_per_block = l_c_m;
1935 else
1937 if (l_c_m < DEFAULT_BYTES_PER_BLOCK)
1938 bytes_per_block = l_c_m * (DEFAULT_BYTES_PER_BLOCK / l_c_m);
1939 else
1940 bytes_per_block = l_c_m;
1943 /* Compute padding necessary to align output block. */
1944 for (i = 0; i < n_specs; i++)
1946 int fields_per_block = bytes_per_block / width_bytes[spec[i].size];
1947 int block_width = (spec[i].field_width + 1) * fields_per_block;
1948 if (width_per_block < block_width)
1949 width_per_block = block_width;
1951 for (i = 0; i < n_specs; i++)
1953 int fields_per_block = bytes_per_block / width_bytes[spec[i].size];
1954 int block_width = spec[i].field_width * fields_per_block;
1955 spec[i].pad_width = width_per_block - block_width;
1958 #ifdef DEBUG
1959 printf ("lcm=%d, width_per_block=%zu\n", l_c_m, width_per_block);
1960 for (i = 0; i < n_specs; i++)
1962 int fields_per_block = bytes_per_block / width_bytes[spec[i].size];
1963 affirm (bytes_per_block % width_bytes[spec[i].size] == 0);
1964 affirm (1 <= spec[i].pad_width / fields_per_block);
1965 printf ("%d: fmt=\"%s\" in_width=%d out_width=%d pad=%d\n",
1966 i, spec[i].fmt_string, width_bytes[spec[i].size],
1967 spec[i].field_width, spec[i].pad_width);
1969 #endif
1971 ok &= (flag_dump_strings ? dump_strings () : dump ());
1973 cleanup:
1975 if (have_read_stdin && fclose (stdin) == EOF)
1976 error (EXIT_FAILURE, errno, _("standard input"));
1978 return ok ? EXIT_SUCCESS : EXIT_FAILURE;