/* od -- dump files in octal and other formats Copyright (C) 1992, 1995 Free Software Foundation, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /* Written by Jim Meyering. */ /* AIX requires this to be the first thing in the file. */ #include #ifdef __GNUC__ #define alloca __builtin_alloca #else /* not __GNUC__ */ #if HAVE_ALLOCA_H #include #else /* not HAVE_ALLOCA_H */ #ifdef _AIX #pragma alloca #else /* not _AIX */ char *alloca (); #endif /* not _AIX */ #endif /* not HAVE_ALLOCA_H */ #endif /* not __GNUC__ */ #include #include #include #include #include "system.h" #include "version.h" #include "xstrtoul.h" #include "error.h" #if defined(__GNUC__) || defined(STDC_HEADERS) #include #endif #ifdef HAVE_LONG_DOUBLE typedef long double LONG_DOUBLE; #else typedef double LONG_DOUBLE; #endif #if HAVE_LIMITS_H # include #endif #ifndef SCHAR_MAX # define SCHAR_MAX 127 #endif #ifndef SCHAR_MIN # define SCHAR_MIN (-128) #endif #ifndef SHRT_MAX # define SHRT_MAX 32767 #endif #ifndef SHRT_MIN # define SHRT_MIN (-32768) #endif #ifndef ULONG_MAX # define ULONG_MAX ((unsigned long) ~(unsigned long) 0) #endif #ifndef OFF_T_MAX /* FIXME: is there a way to do this without relying on the `8 bits per byte' assumption? */ # define OFF_T_MAX (~((off_t)1 << (sizeof (off_t) * 8 - 1))) #endif #define STREQ(a,b) (strcmp((a), (b)) == 0) #ifndef MAX # define MAX(a, b) ((a) > (b) ? (a) : (b)) #endif #ifndef MIN # define MIN(a,b) (((a) < (b)) ? (a) : (b)) #endif /* The default number of input bytes per output line. */ #define DEFAULT_BYTES_PER_BLOCK 16 /* The number of decimal digits of precision in a float. */ #ifndef FLT_DIG # define FLT_DIG 7 #endif /* The number of decimal digits of precision in a double. */ #ifndef DBL_DIG # define DBL_DIG 15 #endif /* The number of decimal digits of precision in a long double. */ #ifndef LDBL_DIG # define LDBL_DIG DBL_DIG #endif char *xmalloc (); char *xrealloc (); enum size_spec { NO_SIZE, CHAR, SHORT, INT, LONG, FLOAT_SINGLE, FLOAT_DOUBLE, FLOAT_LONG_DOUBLE }; enum output_format { SIGNED_DECIMAL, UNSIGNED_DECIMAL, OCTAL, HEXADECIMAL, FLOATING_POINT, NAMED_CHARACTER, CHARACTER }; /* Each output format specification (from POSIX `-t spec' or from old-style options) is represented by one of these structures. */ struct tspec { enum output_format fmt; enum size_spec size; void (*print_function) (); char *fmt_string; }; /* The name this program was run with. */ char *program_name; /* Convert the number of 8-bit bytes of a binary representation to the number of characters (digits + sign if the type is signed) required to represent the same quantity in the specified base/type. For example, a 32-bit (4-byte) quantity may require a field width as wide as the following for these types: 11 unsigned octal 11 signed decimal 10 unsigned decimal 8 unsigned hexadecimal */ static const unsigned int bytes_to_oct_digits[] = {0, 3, 6, 8, 11, 14, 16, 19, 22, 25, 27, 30, 32, 35, 38, 41, 43}; static const unsigned int bytes_to_signed_dec_digits[] = {1, 4, 6, 8, 11, 13, 16, 18, 20, 23, 25, 28, 30, 33, 35, 37, 40}; static const unsigned int bytes_to_unsigned_dec_digits[] = {0, 3, 5, 8, 10, 13, 15, 17, 20, 22, 25, 27, 29, 32, 34, 37, 39}; static const unsigned int bytes_to_hex_digits[] = {0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32}; /* Convert enum size_spec to the size of the named type. */ static const int width_bytes[] = { -1, sizeof (char), sizeof (short int), sizeof (int), sizeof (long int), sizeof (float), sizeof (double), sizeof (LONG_DOUBLE) }; /* Names for some non-printing characters. */ static const char *const charname[33] = { "nul", "soh", "stx", "etx", "eot", "enq", "ack", "bel", "bs", "ht", "nl", "vt", "ff", "cr", "so", "si", "dle", "dc1", "dc2", "dc3", "dc4", "nak", "syn", "etb", "can", "em", "sub", "esc", "fs", "gs", "rs", "us", "sp" }; /* A printf control string for printing a file offset. */ static const char *output_address_fmt_string; /* FIXME: make this the number of octal digits in an unsigned long. */ #define MAX_ADDRESS_LENGTH 13 /* Space for a normal address, a space, a pseudo address, parentheses around the pseudo address, and a trailing zero byte. */ static char address_fmt_buffer[2 * MAX_ADDRESS_LENGTH + 4]; static char address_pad[MAX_ADDRESS_LENGTH + 1]; static unsigned long int string_min; static unsigned long int flag_dump_strings; /* Non-zero if we should recognize the pre-POSIX non-option arguments that specified at most one file and optional arguments specifying offset and pseudo-start address. */ static int traditional; /* Non-zero if an old-style `pseudo-address' was specified. */ static long int flag_pseudo_start; /* The difference between the old-style pseudo starting address and the number of bytes to skip. */ static long int pseudo_offset; /* Function to format an address and optionally an additional parenthesized pseudo-address; it returns the formatted string. */ static const char *(*format_address) (/* long unsigned int */); /* The number of input bytes to skip before formatting and writing. */ static off_t n_bytes_to_skip = 0; /* When non-zero, MAX_BYTES_TO_FORMAT is the maximum number of bytes to be read and formatted. Otherwise all input is formatted. */ static int limit_bytes_to_format = 0; /* The maximum number of bytes that will be formatted. This value is used only when LIMIT_BYTES_TO_FORMAT is non-zero. */ static off_t max_bytes_to_format; /* When non-zero and two or more consecutive blocks are equal, format only the first block and output an asterisk alone on the following line to indicate that identical blocks have been elided. */ static int abbreviate_duplicate_blocks = 1; /* An array of specs describing how to format each input block. */ static struct tspec *spec; /* The number of format specs. */ static unsigned int n_specs; /* The allocated length of SPEC. */ static unsigned int n_specs_allocated; /* The number of input bytes formatted per output line. It must be a multiple of the least common multiple of the sizes associated with the specified output types. It should be as large as possible, but no larger than 16 -- unless specified with the -w option. */ static unsigned int bytes_per_block; /* Human-readable representation of *file_list (for error messages). It differs from *file_list only when *file_list is "-". */ static char const *input_filename; /* A NULL-terminated list of the file-arguments from the command line. If no file-arguments were specified, this variable is initialized to { "-", NULL }. */ static char const *const *file_list; /* The input stream associated with the current file. */ static FILE *in_stream; /* If non-zero, at least one of the files we read was standard input. */ static int have_read_stdin; #define LONGEST_INTEGRAL_TYPE long int #define MAX_INTEGRAL_TYPE_SIZE sizeof(LONGEST_INTEGRAL_TYPE) static enum size_spec integral_type_size[MAX_INTEGRAL_TYPE_SIZE + 1]; #define MAX_FP_TYPE_SIZE sizeof(LONG_DOUBLE) static enum size_spec fp_type_size[MAX_FP_TYPE_SIZE + 1]; /* If non-zero, display usage information and exit. */ static int show_help; /* If non-zero, print the version on standard output then exit. */ static int show_version; static struct option const long_options[] = { /* POSIX options. */ {"skip-bytes", required_argument, NULL, 'j'}, {"address-radix", required_argument, NULL, 'A'}, {"read-bytes", required_argument, NULL, 'N'}, {"format", required_argument, NULL, 't'}, {"output-duplicates", no_argument, NULL, 'v'}, /* non-POSIX options. */ {"strings", optional_argument, NULL, 's'}, {"traditional", no_argument, NULL, 'B'}, {"width", optional_argument, NULL, 'w'}, {"help", no_argument, &show_help, 1}, {"version", no_argument, &show_version, 1}, {NULL, 0, NULL, 0} }; static void usage (int status) { if (status != 0) fprintf (stderr, _("Try `%s --help' for more information.\n"), program_name); else { printf (_("\ Usage: %s [OPTION]... [FILE]...\n\ or: %s --traditional [FILE] [[+]OFFSET [[+]LABEL]]\n\ "), program_name, program_name); printf (_("\ Write an unambiguous representation, octal bytes by default, of FILE\n\ to standard output. With no FILE, or when FILE is -, read standard input.\n\ \n\ -A, --address-radix=RADIX decide how file offsets are printed\n\ -N, --read-bytes=BYTES limit dump to BYTES input bytes per file\n\ -j, --skip-bytes=BYTES skip BYTES input bytes first on each file\n\ -s, --strings[=BYTES] output strings of at least BYTES graphic chars\n\ -t, --format=TYPE select output format or formats\n\ -v, --output-duplicates do not use * to mark line suppression\n\ -w, --width[=BYTES] output BYTES bytes per output line\n\ --traditional accept arguments in pre-POSIX form\n\ --help display this help and exit\n\ --version output version information and exit\n\ \n\ Pre-POSIX format specifications may be intermixed, they accumulate:\n\ -a same as -t a, select named characters\n\ -b same as -t oC, select octal bytes\n\ -c same as -t c, select ASCII characters or backslash escapes\n\ -d same as -t u2, select unsigned decimal shorts\n\ -f same as -t fF, select floats\n\ -h same as -t x2, select hexadecimal shorts\n\ -i same as -t d2, select decimal shorts\n\ -l same as -t d4, select decimal longs\n\ -o same as -t o2, select octal shorts\n\ -x same as -t x2, select hexadecimal shorts\n\ ")); printf (_("\ \n\ For older syntax (second call format), OFFSET means -j OFFSET. LABEL\n\ is the pseudo-address at first byte printed, incremented when dump is\n\ progressing. For OFFSET and LABEL, a 0x or 0X prefix indicates\n\ hexadecimal, suffixes maybe . for octal and b multiply by 512.\n\ \n\ TYPE is made up of one or more of these specifications:\n\ \n\ a named character\n\ c ASCII character or backslash escape\n\ d[SIZE] signed decimal, SIZE bytes per integer\n\ f[SIZE] floating point, SIZE bytes per integer\n\ o[SIZE] octal, SIZE bytes per integer\n\ u[SIZE] unsigned decimal, SIZE bytes per integer\n\ x[SIZE] hexadecimal, SIZE bytes per integer\n\ \n\ SIZE is a number. For TYPE in doux, SIZE may also be C for\n\ sizeof(char), S for sizeof(short), I for sizeof(int) or L for\n\ sizeof(long). If TYPE is f, SIZE may also be F for sizeof(float), D\n\ for sizeof(double) or L for sizeof(long double).\n\ \n\ RADIX is d for decimal, o for octal, x for hexadecimal or n for none.\n\ BYTES is hexadecimal with 0x or 0X prefix, it is multiplied by 512\n\ with b suffix, by 1024 with k and by 1048576 with m. -s without a\n\ number implies 3. -w without a number implies 32. By default, od\n\ uses -A o -t d2 -w 16.\n\ ")); } exit (status); } /* Compute the greatest common denominator of U and V using Euclid's algorithm. */ static unsigned int gcd (unsigned int u, unsigned int v) { unsigned int t; while (v != 0) { t = u % v; u = v; v = t; } return u; } /* Compute the least common multiple of U and V. */ static unsigned int lcm (unsigned int u, unsigned int v) { unsigned int t = gcd (u, v); if (t == 0) return 0; return u * v / t; } static void print_s_char (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes; i > 0; i--) { int tmp = (unsigned) *(const unsigned char *) block; if (tmp > SCHAR_MAX) tmp -= SCHAR_MAX - SCHAR_MIN + 1; assert (tmp <= SCHAR_MAX); printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned char); } } static void print_char (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes; i > 0; i--) { unsigned int tmp = *(const unsigned char *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned char); } } static void print_s_short (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (unsigned short); i > 0; i--) { int tmp = (unsigned) *(const unsigned short *) block; if (tmp > SHRT_MAX) tmp -= SHRT_MAX - SHRT_MIN + 1; assert (tmp <= SHRT_MAX); printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned short); } } static void print_short (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (unsigned short); i > 0; i--) { unsigned int tmp = *(const unsigned short *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned short); } } static void print_int (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (unsigned int); i > 0; i--) { unsigned int tmp = *(const unsigned int *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned int); } } static void print_long (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (unsigned long); i > 0; i--) { unsigned long tmp = *(const unsigned long *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned long); } } static void print_float (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (float); i > 0; i--) { float tmp = *(const float *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (float); } } static void print_double (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (double); i > 0; i--) { double tmp = *(const double *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (double); } } #ifdef HAVE_LONG_DOUBLE static void print_long_double (long unsigned int n_bytes, const char *block, const char *fmt_string) { int i; for (i = n_bytes / sizeof (LONG_DOUBLE); i > 0; i--) { LONG_DOUBLE tmp = *(const LONG_DOUBLE *) block; printf (fmt_string, tmp, (i == 1 ? '\n' : ' ')); block += sizeof (LONG_DOUBLE); } } #endif static void print_named_ascii (long unsigned int n_bytes, const char *block, const char *unused_fmt_string) { int i; for (i = n_bytes; i > 0; i--) { unsigned int c = *(const unsigned char *) block; unsigned int masked_c = (0x7f & c); const char *s; char buf[5]; if (masked_c == 127) s = "del"; else if (masked_c <= 040) s = charname[masked_c]; else { sprintf (buf, " %c", masked_c); s = buf; } printf ("%3s%c", s, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned char); } } static void print_ascii (long unsigned int n_bytes, const char *block, const char *unused_fmt_string) { int i; for (i = n_bytes; i > 0; i--) { unsigned int c = *(const unsigned char *) block; const char *s; char buf[5]; switch (c) { case '\0': s = " \\0"; break; case '\007': s = " \\a"; break; case '\b': s = " \\b"; break; case '\f': s = " \\f"; break; case '\n': s = " \\n"; break; case '\r': s = " \\r"; break; case '\t': s = " \\t"; break; case '\v': s = " \\v"; break; default: sprintf (buf, (ISPRINT (c) ? " %c" : "%03o"), c); s = (const char *) buf; } printf ("%3s%c", s, (i == 1 ? '\n' : ' ')); block += sizeof (unsigned char); } } /* Convert a null-terminated (possibly zero-length) string S to an unsigned long integer value. If S points to a non-digit set *P to S, *VAL to 0, and return 0. Otherwise, accumulate the integer value of the string of digits. If the string of digits represents a value larger than ULONG_MAX, don't modify *VAL or *P and return non-zero. Otherwise, advance *P to the first non-digit after S, set *VAL to the result of the conversion and return zero. */ static int simple_strtoul (const char *s, const char **p, long unsigned int *val) { unsigned long int sum; sum = 0; while (ISDIGIT (*s)) { unsigned int c = *s++ - '0'; if (sum > (ULONG_MAX - c) / 10) return 1; sum = sum * 10 + c; } *p = s; *val = sum; return 0; } /* If S points to a single valid POSIX-style od format string, put a description of that format in *TSPEC, make *NEXT point at the character following the just-decoded format (if *NEXT is non-NULL), and return zero. If S is not valid, don't modify *NEXT or *TSPEC and return non-zero. For example, if S were "d4afL" *NEXT would be set to "afL" and *TSPEC would be { fmt = SIGNED_DECIMAL; size = INT or LONG; (whichever integral_type_size[4] resolves to) print_function = print_int; (assuming size == INT) fmt_string = "%011d%c"; } */ static int decode_one_format (const char *s, const char **next, struct tspec *tspec) { enum size_spec size_spec; unsigned long int size; enum output_format fmt; const char *pre_fmt_string; char *fmt_string; void (*print_function) (); const char *p; unsigned int c; assert (tspec != NULL); switch (*s) { case 'd': case 'o': case 'u': case 'x': c = *s; ++s; switch (*s) { case 'C': ++s; size = sizeof (char); break; case 'S': ++s; size = sizeof (short); break; case 'I': ++s; size = sizeof (int); break; case 'L': ++s; size = sizeof (long int); break; default: if (simple_strtoul (s, &p, &size) != 0) return 1; if (p == s) size = sizeof (int); else { if (size > MAX_INTEGRAL_TYPE_SIZE || integral_type_size[size] == NO_SIZE) return 1; s = p; } break; } #define FMT_BYTES_ALLOCATED 9 fmt_string = xmalloc (FMT_BYTES_ALLOCATED); size_spec = integral_type_size[size]; switch (c) { case 'd': fmt = SIGNED_DECIMAL; sprintf (fmt_string, "%%%u%sd%%c", bytes_to_signed_dec_digits[size], (size_spec == LONG ? "l" : "")); break; case 'o': fmt = OCTAL; sprintf (fmt_string, "%%0%u%so%%c", bytes_to_oct_digits[size], (size_spec == LONG ? "l" : "")); break; case 'u': fmt = UNSIGNED_DECIMAL; sprintf (fmt_string, "%%%u%su%%c", bytes_to_unsigned_dec_digits[size], (size_spec == LONG ? "l" : "")); break; case 'x': fmt = HEXADECIMAL; sprintf (fmt_string, "%%0%u%sx%%c", bytes_to_hex_digits[size], (size_spec == LONG ? "l" : "")); break; default: abort (); } assert (strlen (fmt_string) < FMT_BYTES_ALLOCATED); switch (size_spec) { case CHAR: print_function = (fmt == SIGNED_DECIMAL ? print_s_char : print_char); break; case SHORT: print_function = (fmt == SIGNED_DECIMAL ? print_s_short : print_short); break; case INT: print_function = print_int; break; case LONG: print_function = print_long; break; default: abort (); } break; case 'f': fmt = FLOATING_POINT; ++s; switch (*s) { case 'F': ++s; size = sizeof (float); break; case 'D': ++s; size = sizeof (double); break; case 'L': ++s; size = sizeof (LONG_DOUBLE); break; default: if (simple_strtoul (s, &p, &size) != 0) return 1; if (p == s) size = sizeof (double); else { if (size > MAX_FP_TYPE_SIZE || fp_type_size[size] == NO_SIZE) return 1; s = p; } break; } size_spec = fp_type_size[size]; switch (size_spec) { case FLOAT_SINGLE: print_function = print_float; /* Don't use %#e; not all systems support it. */ pre_fmt_string = "%%%d.%de%%c"; fmt_string = xmalloc (strlen (pre_fmt_string)); sprintf (fmt_string, pre_fmt_string, FLT_DIG + 8, FLT_DIG); break; case FLOAT_DOUBLE: print_function = print_double; pre_fmt_string = "%%%d.%de%%c"; fmt_string = xmalloc (strlen (pre_fmt_string)); sprintf (fmt_string, pre_fmt_string, DBL_DIG + 8, DBL_DIG); break; #ifdef HAVE_LONG_DOUBLE case FLOAT_LONG_DOUBLE: print_function = print_long_double; pre_fmt_string = "%%%d.%dle%%c"; fmt_string = xmalloc (strlen (pre_fmt_string)); sprintf (fmt_string, pre_fmt_string, LDBL_DIG + 8, LDBL_DIG); break; #endif default: abort (); } break; case 'a': ++s; fmt = NAMED_CHARACTER; size_spec = CHAR; fmt_string = NULL; print_function = print_named_ascii; break; case 'c': ++s; fmt = CHARACTER; size_spec = CHAR; fmt_string = NULL; print_function = print_ascii; break; default: return 1; } tspec->size = size_spec; tspec->fmt = fmt; tspec->print_function = print_function; tspec->fmt_string = fmt_string; if (next != NULL) *next = s; return 0; } /* Decode the POSIX-style od format string S. Append the decoded representation to the global array SPEC, reallocating SPEC if necessary. Return zero if S is valid, non-zero otherwise. */ static int decode_format_string (const char *s) { assert (s != NULL); while (*s != '\0') { struct tspec tspec; const char *next; if (decode_one_format (s, &next, &tspec)) return 1; assert (s != next); s = next; if (n_specs >= n_specs_allocated) { n_specs_allocated = 1 + (3 * n_specs_allocated) / 2; spec = (struct tspec *) xrealloc (spec, (n_specs_allocated * sizeof (struct tspec))); } memcpy ((char *) &spec[n_specs], (char *) &tspec, sizeof (struct tspec)); ++n_specs; } return 0; } /* Given a list of one or more input filenames FILE_LIST, set the global file pointer IN_STREAM to position N_SKIP in the concatenation of those files. If any file operation fails or if there are fewer than N_SKIP bytes in the combined input, give an error message and return non-zero. When possible, use seek- rather than read operations to advance IN_STREAM. A file name of "-" is interpreted as standard input. */ static int skip (off_t n_skip) { int err; err = 0; for ( /* empty */ ; *file_list != NULL; ++file_list) { struct stat file_stats; int j; if (STREQ (*file_list, "-")) { input_filename = _("standard input"); in_stream = stdin; have_read_stdin = 1; } else { input_filename = *file_list; in_stream = fopen (input_filename, "r"); if (in_stream == NULL) { error (0, errno, "%s", input_filename); err = 1; continue; } } if (n_skip == 0) break; /* First try using fseek. For large offsets, this extra work is worthwhile. If the offset is below some threshold it may be more efficient to move the pointer by reading. There are two issues when trying to use fseek: - the file must be seekable. - before seeking to the specified position, make sure that the new position is in the current file. Try to do that by getting file's size using fstat(). But that will work only for regular files and dirs. */ if (fstat (fileno (in_stream), &file_stats)) { error (0, errno, "%s", input_filename); err = 1; continue; } /* The st_size field is valid only for regular files and directories. FIXME: is the preceding true? If the number of bytes left to skip is at least as large as the size of the current file, we can decrement n_skip and go on to the next file. */ if (S_ISREG (file_stats.st_mode) || S_ISDIR (file_stats.st_mode)) { if (n_skip >= file_stats.st_size) { n_skip -= file_stats.st_size; if (in_stream != stdin && fclose (in_stream) == EOF) { error (0, errno, "%s", input_filename); err = 1; } continue; } else { if (fseek (in_stream, n_skip, SEEK_SET) == 0) { n_skip = 0; break; } } } /* fseek didn't work or wasn't attempted; do it the slow way. */ for (j = n_skip / BUFSIZ; j >= 0; j--) { char buf[BUFSIZ]; size_t n_bytes_to_read = (j > 0 ? BUFSIZ : n_skip % BUFSIZ); size_t n_bytes_read; n_bytes_read = fread (buf, 1, n_bytes_to_read, in_stream); n_skip -= n_bytes_read; if (n_bytes_read != n_bytes_to_read) break; } if (n_skip == 0) break; } if (n_skip != 0) error (2, 0, _("cannot skip past end of combined input")); return err; } static const char * format_address_none (long unsigned int address) { return ""; } static const char * format_address_std (long unsigned int address) { const char *address_string; sprintf (address_fmt_buffer, output_address_fmt_string, address); address_string = address_fmt_buffer; return address_string; } static const char * format_address_label (long unsigned int address) { const char *address_string; assert (output_address_fmt_string != NULL); sprintf (address_fmt_buffer, output_address_fmt_string, address, address + pseudo_offset); address_string = address_fmt_buffer; return address_string; } /* Write N_BYTES bytes from CURR_BLOCK to standard output once for each of the N_SPEC format specs. CURRENT_OFFSET is the byte address of CURR_BLOCK in the concatenation of input files, and it is printed (optionally) only before the output line associated with the first format spec. When duplicate blocks are being abbreviated, the output for a sequence of identical input blocks is the output for the first block followed by an asterisk alone on a line. It is valid to compare the blocks PREV_BLOCK and CURR_BLOCK only when N_BYTES == BYTES_PER_BLOCK. That condition may be false only for the last input block -- and then only when it has not been padded to length BYTES_PER_BLOCK. */ static void write_block (long unsigned int current_offset, long unsigned int n_bytes, const char *prev_block, const char *curr_block) { static int first = 1; static int prev_pair_equal = 0; #define EQUAL_BLOCKS(b1, b2) (memcmp ((b1), (b2), bytes_per_block) == 0) if (abbreviate_duplicate_blocks && !first && n_bytes == bytes_per_block && EQUAL_BLOCKS (prev_block, curr_block)) { if (prev_pair_equal) { /* The two preceding blocks were equal, and the current block is the same as the last one, so print nothing. */ } else { printf ("*\n"); prev_pair_equal = 1; } } else { unsigned int i; prev_pair_equal = 0; for (i = 0; i < n_specs; i++) { printf ("%s ", (i == 0 ? format_address (current_offset) : address_pad)); (*spec[i].print_function) (n_bytes, curr_block, spec[i].fmt_string); } } first = 0; } /* Test whether there have been errors on in_stream, and close it if it is not standard input. Return non-zero if there has been an error on in_stream or stdout; return zero otherwise. This function will report more than one error only if both a read and a write error have occurred. */ static int check_and_close (void) { int err; err = 0; if (ferror (in_stream)) { error (0, errno, "%s", input_filename); if (in_stream != stdin) fclose (in_stream); err = 1; } else if (in_stream != stdin && fclose (in_stream) == EOF) { error (0, errno, "%s", input_filename); err = 1; } if (ferror (stdout)) { error (0, errno, _("standard output")); err = 1; } return err; } /* Read a single byte into *C from the concatenation of the input files named in the global array FILE_LIST. On the first call to this function, the global variable IN_STREAM is expected to be an open stream associated with the input file *FILE_LIST. If IN_STREAM is at end-of-file, close it and update the global variables IN_STREAM, FILE_LIST, and INPUT_FILENAME so they correspond to the next file in the list. Then try to read a byte from the newly opened file. Repeat if necessary until *FILE_LIST is NULL. When EOF is reached for the last file in FILE_LIST, set *C to EOF and return. Subsequent calls do likewise. The return value is non-zero if any errors occured, zero otherwise. */ static int read_char (int *c) { int err; if (*file_list == NULL) { *c = EOF; return 0; } err = 0; while (1) { *c = fgetc (in_stream); if (*c != EOF) return err; err |= check_and_close (); do { ++file_list; if (*file_list == NULL) return err; if (STREQ (*file_list, "-")) { input_filename = _("standard input"); in_stream = stdin; have_read_stdin = 1; } else { input_filename = *file_list; in_stream = fopen (input_filename, "r"); if (in_stream == NULL) { error (0, errno, "%s", input_filename); err = 1; } } } while (in_stream == NULL); } } /* Read N bytes into BLOCK from the concatenation of the input files named in the global array FILE_LIST. On the first call to this function, the global variable IN_STREAM is expected to be an open stream associated with the input file *FILE_LIST. On subsequent calls, if *FILE_LIST is NULL, don't modify BLOCK and return zero. If all N bytes cannot be read from IN_STREAM, close IN_STREAM and update the global variables IN_STREAM, FILE_LIST, and INPUT_FILENAME. Then try to read the remaining bytes from the newly opened file. Repeat if necessary until *FILE_LIST is NULL. Set *N_BYTES_IN_BUFFER to the number of bytes read. If an error occurs, it will be detected through ferror when the stream is about to be closed. If there is an error, give a message but continue reading as usual and return non-zero. Otherwise return zero. */ static int read_block (size_t n, char *block, size_t *n_bytes_in_buffer) { int err; assert (n > 0 && n <= bytes_per_block); *n_bytes_in_buffer = 0; if (n == 0) return 0; if (*file_list == NULL) return 0; /* EOF. */ err = 0; while (1) { size_t n_needed; size_t n_read; n_needed = n - *n_bytes_in_buffer; n_read = fread (block + *n_bytes_in_buffer, 1, n_needed, in_stream); *n_bytes_in_buffer += n_read; if (n_read == n_needed) return err; err |= check_and_close (); do { ++file_list; if (*file_list == NULL) return err; if (STREQ (*file_list, "-")) { input_filename = _("standard input"); in_stream = stdin; have_read_stdin = 1; } else { input_filename = *file_list; in_stream = fopen (input_filename, "r"); if (in_stream == NULL) { error (0, errno, "%s", input_filename); err = 1; } } } while (in_stream == NULL); } } /* Return the least common multiple of the sizes associated with the format specs. */ static int get_lcm (void) { unsigned int i; int l_c_m = 1; for (i = 0; i < n_specs; i++) l_c_m = lcm (l_c_m, width_bytes[(int) spec[i].size]); return l_c_m; } /* If S is a valid pre-POSIX offset specification with an optional leading '+' return the offset it denotes. Otherwise, return -1. */ off_t parse_old_offset (const char *s) { int radix; off_t offset; enum strtol_error s_err; long unsigned int tmp; if (*s == '\0') return -1; /* Skip over any leading '+'. */ if (s[0] == '+') ++s; /* Determine the radix we'll use to interpret S. If there is a `.', it's decimal, otherwise, if the string begins with `0X'or `0x', it's hexadecimal, else octal. */ if (strchr (s, '.') != NULL) radix = 10; else { if (s[0] == '0' && (s[1] == 'x' || s[1] == 'X')) radix = 16; else radix = 8; } s_err = xstrtoul (s, NULL, radix, &tmp, "Bb"); if (s_err != LONGINT_OK) { STRTOL_FAIL_WARN (s, _("old-style offset"), s_err); return -1; } offset = tmp; return offset; } /* Read a chunk of size BYTES_PER_BLOCK from the input files, write the formatted block to standard output, and repeat until the specified maximum number of bytes has been read or until all input has been processed. If the last block read is smaller than BYTES_PER_BLOCK and its size is not a multiple of the size associated with a format spec, extend the input block with zero bytes until its length is a multiple of all format spec sizes. Write the final block. Finally, write on a line by itself the offset of the byte after the last byte read. Accumulate return values from calls to read_block and check_and_close, and if any was non-zero, return non-zero. Otherwise, return zero. */ static int dump (void) { char *block[2]; off_t current_offset; off_t end_offset; int idx; int err; size_t n_bytes_read; #ifdef lint /* Suppress `used before initialized' warning. */ end_offset = 0; #endif block[0] = (char *) alloca (bytes_per_block); block[1] = (char *) alloca (bytes_per_block); current_offset = n_bytes_to_skip; idx = 0; err = 0; if (limit_bytes_to_format) { end_offset = n_bytes_to_skip + max_bytes_to_format; while (1) { size_t n_needed; if (current_offset >= end_offset) { n_bytes_read = 0; break; } n_needed = MIN (end_offset - current_offset, (off_t) bytes_per_block); err |= read_block (n_needed, block[idx], &n_bytes_read); if (n_bytes_read < bytes_per_block) break; assert (n_bytes_read == bytes_per_block); write_block (current_offset, n_bytes_read, block[!idx], block[idx]); current_offset += n_bytes_read; idx = !idx; } } else { while (1) { err |= read_block (bytes_per_block, block[idx], &n_bytes_read); if (n_bytes_read < bytes_per_block) break; assert (n_bytes_read == bytes_per_block); write_block (current_offset, n_bytes_read, block[!idx], block[idx]); current_offset += n_bytes_read; idx = !idx; } } if (n_bytes_read > 0) { int l_c_m; size_t bytes_to_write; l_c_m = get_lcm (); /* Make bytes_to_write the smallest multiple of l_c_m that is at least as large as n_bytes_read. */ bytes_to_write = l_c_m * (int) ((n_bytes_read + l_c_m - 1) / l_c_m); memset (block[idx] + n_bytes_read, 0, bytes_to_write - n_bytes_read); write_block (current_offset, bytes_to_write, block[!idx], block[idx]); current_offset += n_bytes_read; } if (output_address_fmt_string != NULL) printf ("%s\n", format_address (current_offset)); if (limit_bytes_to_format && current_offset > end_offset) err |= check_and_close (); return err; } /* STRINGS mode. Find each "string constant" in the input. A string constant is a run of at least `string_min' ASCII graphic (or formatting) characters terminated by a null. Based on a function written by Richard Stallman for a pre-POSIX version of od. Return non-zero if an error occurs. Otherwise, return zero. */ static int dump_strings (void) { size_t bufsize = MAX (100, string_min); char *buf = xmalloc (bufsize); off_t address = n_bytes_to_skip; int err; err = 0; while (1) { unsigned int i; int c; /* See if the next `string_min' chars are all printing chars. */ tryline: if (limit_bytes_to_format && address >= (n_bytes_to_skip + max_bytes_to_format - string_min)) break; for (i = 0; i < string_min; i++) { err |= read_char (&c); address++; if (c < 0) { free (buf); return err; } if (!ISPRINT (c)) /* Found a non-printing. Try again starting with next char. */ goto tryline; buf[i] = c; } /* We found a run of `string_min' printable characters. Now see if it is terminated with a null byte. */ while (!limit_bytes_to_format || address < n_bytes_to_skip + max_bytes_to_format) { if (i == bufsize) { bufsize = 1 + 3 * bufsize / 2; buf = xrealloc (buf, bufsize); } err |= read_char (&c); address++; if (c < 0) { free (buf); return err; } if (c == '\0') break; /* It is; print this string. */ if (!ISPRINT (c)) goto tryline; /* It isn't; give up on this string. */ buf[i++] = c; /* String continues; store it all. */ } /* If we get here, the string is all printable and null-terminated, so print it. It is all in `buf' and `i' is its length. */ buf[i] = 0; if (output_address_fmt_string != NULL) { printf ("%s ", format_address (address - i - 1)); } for (i = 0; (c = buf[i]); i++) { switch (c) { case '\007': fputs ("\\a", stdout); break; case '\b': fputs ("\\b", stdout); break; case '\f': fputs ("\\f", stdout); break; case '\n': fputs ("\\n", stdout); break; case '\r': fputs ("\\r", stdout); break; case '\t': fputs ("\\t", stdout); break; case '\v': fputs ("\\v", stdout); break; default: putc (c, stdout); } } putchar ('\n'); } /* We reach this point only if we search through (max_bytes_to_format - string_min) bytes before reachine EOF. */ free (buf); err |= check_and_close (); return err; } int main (int argc, char **argv) { int c; int n_files; unsigned int i; unsigned int l_c_m; unsigned int address_pad_len; unsigned long int desired_width; int width_specified = 0; int err; /* The old-style `pseudo starting address' to be printed in parentheses after any true address. */ long int pseudo_start; #ifdef lint /* Suppress `used before initialized' warning. */ pseudo_start = 0; #endif program_name = argv[0]; err = 0; for (i = 0; i <= MAX_INTEGRAL_TYPE_SIZE; i++) integral_type_size[i] = NO_SIZE; integral_type_size[sizeof (char)] = CHAR; integral_type_size[sizeof (short int)] = SHORT; integral_type_size[sizeof (int)] = INT; integral_type_size[sizeof (long int)] = LONG; for (i = 0; i <= MAX_FP_TYPE_SIZE; i++) fp_type_size[i] = NO_SIZE; fp_type_size[sizeof (float)] = FLOAT_SINGLE; /* The array entry for `double' is filled in after that for LONG_DOUBLE so that if `long double' is the same type or if long double isn't supported FLOAT_LONG_DOUBLE will never be used. */ fp_type_size[sizeof (LONG_DOUBLE)] = FLOAT_LONG_DOUBLE; fp_type_size[sizeof (double)] = FLOAT_DOUBLE; n_specs = 0; n_specs_allocated = 5; spec = (struct tspec *) xmalloc (n_specs_allocated * sizeof (struct tspec)); output_address_fmt_string = "%07o"; format_address = format_address_std; address_pad_len = 7; flag_dump_strings = 0; while ((c = getopt_long (argc, argv, "abcdfhilos::xw::A:j:N:t:v", long_options, (int *) 0)) != EOF) { unsigned long int tmp; enum strtol_error s_err; switch (c) { case 0: break; case 'A': switch (optarg[0]) { case 'd': output_address_fmt_string = "%07d"; format_address = format_address_std; address_pad_len = 7; break; case 'o': output_address_fmt_string = "%07o"; format_address = format_address_std; address_pad_len = 7; break; case 'x': output_address_fmt_string = "%06x"; format_address = format_address_std; address_pad_len = 6; break; case 'n': output_address_fmt_string = NULL; format_address = format_address_none; address_pad_len = 0; break; default: error (2, 0, _("invalid output address radix `%c'; it must be one character from [doxn]"), optarg[0]); break; } break; case 'j': s_err = xstrtoul (optarg, NULL, 0, &tmp, "bkm"); n_bytes_to_skip = tmp; if (s_err != LONGINT_OK) STRTOL_FATAL_ERROR (optarg, _("skip argument"), s_err); break; case 'N': limit_bytes_to_format = 1; /* FIXME: if off_t is long long and that's an 8-byte type, use xstrtouq here. */ s_err = xstrtoul (optarg, NULL, 0, &tmp, "bkm"); max_bytes_to_format = tmp; if (s_err != LONGINT_OK) STRTOL_FATAL_ERROR (optarg, _("limit argument"), s_err); if (tmp > OFF_T_MAX) error (2, 0, _("specified number of bytes `%s' is larger than \ the maximum\nrepresentable value of type off_t"), optarg); break; case 's': if (optarg == NULL) string_min = 3; else { s_err = xstrtoul (optarg, NULL, 0, &string_min, "bkm"); if (s_err != LONGINT_OK) STRTOL_FATAL_ERROR (optarg, _("minimum string length"), s_err); } ++flag_dump_strings; break; case 't': if (decode_format_string (optarg)) error (2, 0, _("invalid type string `%s'"), optarg); break; case 'v': abbreviate_duplicate_blocks = 0; break; case 'B': traditional = 1; break; /* The next several cases map the old, pre-POSIX format specification options to the corresponding POSIX format specs. GNU od accepts any combination of old- and new-style options. Format specification options accumulate. */ #define CASE_OLD_ARG(old_char,new_string) \ case old_char: \ { \ int tmp; \ tmp = decode_format_string (new_string); \ assert (tmp == 0); \ } \ break CASE_OLD_ARG ('a', "a"); CASE_OLD_ARG ('b', "oC"); CASE_OLD_ARG ('c', "c"); CASE_OLD_ARG ('d', "u2"); CASE_OLD_ARG ('f', "fF"); CASE_OLD_ARG ('h', "x2"); CASE_OLD_ARG ('i', "d2"); CASE_OLD_ARG ('l', "d4"); CASE_OLD_ARG ('o', "o2"); CASE_OLD_ARG ('x', "x2"); #undef CASE_OLD_ARG case 'w': width_specified = 1; if (optarg == NULL) { desired_width = 32; } else { s_err = xstrtoul (optarg, NULL, 10, &desired_width, NULL); if (s_err != LONGINT_OK) STRTOL_FATAL_ERROR (optarg, _("width specification"), s_err); } break; default: usage (1); break; } } if (show_version) { printf ("od - %s\n", version_string); exit (0); } if (show_help) usage (0); if (flag_dump_strings && n_specs > 0) error (2, 0, _("no type may be specified when dumping strings")); n_files = argc - optind; /* If the --backward-compatible option is used, there may be from 0 to 3 remaining command line arguments; handle each case separately. od [file] [[+]offset[.][b] [[+]label[.][b]]] The offset and pseudo_start have the same syntax. */ if (traditional) { off_t offset; if (n_files == 1) { if ((offset = parse_old_offset (argv[optind])) >= 0) { n_bytes_to_skip = offset; --n_files; ++argv; } } else if (n_files == 2) { off_t o1, o2; if ((o1 = parse_old_offset (argv[optind])) >= 0 && (o2 = parse_old_offset (argv[optind + 1])) >= 0) { n_bytes_to_skip = o1; flag_pseudo_start = 1; pseudo_start = o2; argv += 2; n_files -= 2; } else if ((o2 = parse_old_offset (argv[optind + 1])) >= 0) { n_bytes_to_skip = o2; --n_files; argv[optind + 1] = argv[optind]; ++argv; } else { error (0, 0, _("invalid second operand in compatibility mode `%s'"), argv[optind + 1]); usage (1); } } else if (n_files == 3) { off_t o1, o2; if ((o1 = parse_old_offset (argv[optind + 1])) >= 0 && (o2 = parse_old_offset (argv[optind + 2])) >= 0) { n_bytes_to_skip = o1; flag_pseudo_start = 1; pseudo_start = o2; argv[optind + 2] = argv[optind]; argv += 2; n_files -= 2; } else { error (0, 0, _("in compatibility mode the last 2 arguments must be offsets")); usage (1); } } else { error (0, 0, _("in compatibility mode there may be no more than 3 arguments")); usage (1); } if (flag_pseudo_start) { static char buf[10]; if (output_address_fmt_string == NULL) { output_address_fmt_string = "(%07o)"; format_address = format_address_std; } else { sprintf (buf, "%s (%s)", output_address_fmt_string, output_address_fmt_string); output_address_fmt_string = buf; format_address = format_address_label; } } } assert (address_pad_len <= MAX_ADDRESS_LENGTH); for (i = 0; i < address_pad_len; i++) address_pad[i] = ' '; address_pad[address_pad_len] = '\0'; if (n_specs == 0) { int d_err = decode_one_format ("o2", NULL, &(spec[0])); assert (d_err == 0); n_specs = 1; } if (n_files > 0) file_list = (char const *const *) &argv[optind]; else { /* If no files were listed on the command line, set up the global array FILE_LIST so that it contains the null-terminated list of one name: "-". */ static char const *const default_file_list[] = {"-", NULL}; file_list = default_file_list; } err |= skip (n_bytes_to_skip); if (in_stream == NULL) goto cleanup; pseudo_offset = (flag_pseudo_start ? pseudo_start - n_bytes_to_skip : 0); /* Compute output block length. */ l_c_m = get_lcm (); if (width_specified) { if (desired_width != 0 && desired_width % l_c_m == 0) bytes_per_block = desired_width; else { error (0, 0, _("warning: invalid width %lu; using %d instead"), desired_width, l_c_m); bytes_per_block = l_c_m; } } else { if (l_c_m < DEFAULT_BYTES_PER_BLOCK) bytes_per_block = l_c_m * (int) (DEFAULT_BYTES_PER_BLOCK / l_c_m); else bytes_per_block = l_c_m; } #ifdef DEBUG for (i = 0; i < n_specs; i++) { printf (_("%d: fmt=\"%s\" width=%d\n"), i, spec[i].fmt_string, width_bytes[spec[i].size]); } #endif err |= (flag_dump_strings ? dump_strings () : dump ()); cleanup:; if (have_read_stdin && fclose (stdin) == EOF) error (2, errno, _("standard input")); if (fclose (stdout) == EOF) error (2, errno, _("write error")); exit (err); }