home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / textutils-1.9-bin.lha / man / cat1 / od.0 < prev    next >
Text File  |  1993-12-07  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. OD(1L)                                                     OD(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        od - dump files in octal and other formats
  9.  
  10. SSYYNNOOPPSSIISS
  11.        oodd  [-abcCdfhiloxv] [-s[bytes]] [-w[bytes]] [-A radix] [-j
  12.        bytes]   [-N   bytes]   [-t   type]   [--skip-bytes=bytes]
  13.        [--address-radix=radix]    [--read-bytes=bytes]    [--for-
  14.        mat=type]    [--output-duplicates]     [--strings[=bytes]]
  15.        [--width[=bytes]]   [--compatible]   [--help]  [--version]
  16.        [file...]
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.        This manual page documents the  GNU  version  of  oodd.   oodd
  20.        writes  to  the  standard output the contents of the given
  21.        files, or of the standard input if the name `-' is  given.
  22.        Each  line  of  the  output  consists of the offset in the
  23.        input file in the leftmost column of each  line,  followed
  24.        by  one or more columns of data from the file, in a format
  25.        controlled by the options.  By default, oodd prints the file
  26.        offsets  in octal and the file data as two-byte octal num-
  27.        bers.
  28.  
  29.  
  30.    OOPPTTIIOONNSS
  31.        _-_A_, _-_-_a_d_d_r_e_s_s_-_r_a_d_i_x_=_r_a_d_i_x
  32.               Select the base in which file offsets are  printed.
  33.               _r_a_d_i_x can be one of the following:
  34.  
  35.               d      decimal
  36.  
  37.               o      octal
  38.  
  39.               x      hexadecimal
  40.  
  41.               n      none (do not print offsets)
  42.  
  43.        The default is octal.
  44.  
  45.        _-_j_, _-_-_s_k_i_p_-_b_y_t_e_s_=_b_y_t_e_s
  46.               Skip  _b_y_t_e_s input bytes before formatting and writ-
  47.               ing.  If bbyytteess begins with  `0x'  or  `0X',  it  is
  48.               interpreted in hexadecimal; otherwise, if it begins
  49.               with `0', in octal; otherwise, in decimal.  Append-
  50.               ing  `b' multiplies it by 512, `k' by 1024, and `m'
  51.               by 1048576.
  52.  
  53.        _-_N_, _-_-_r_e_a_d_-_b_y_t_e_s_=_b_y_t_e_s
  54.               Only output up to _b_y_t_e_s bytes of each  input  file.
  55.               Any  prefixes and suffixes on bbyytteess are interpreted
  56.               as for the _-_j option.
  57.  
  58.        _-_t_, _-_-_f_o_r_m_a_t_=_t_y_p_e
  59.               Select the format in which to output the file data.
  60.               _t_y_p_e  is  a string of one or more of the below type
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. OD(1L)                                                     OD(1L)
  71.  
  72.  
  73.               indicator characters.  If you include more than one
  74.               type indicator character in a single _t_y_p_e string or
  75.               use this option more than once, oodd writes one  copy
  76.               of  each  output  line using each of the data types
  77.               that you specified, in the order  that  you  speci-
  78.               fied.
  79.  
  80.               a      named character
  81.  
  82.               c      ASCII character or backslash escape
  83.  
  84.               d      signed decimal
  85.  
  86.               f      floating point
  87.  
  88.               o      octal
  89.  
  90.               u      unsigned decimal
  91.  
  92.               x      hexadecimal
  93.  
  94.        Except  for  types `a' and `c', you can specify the number
  95.        of bytes to use in interpreting each number in  the  given
  96.        data type by following the type indicator character with a
  97.        decimal integer.  Alternately, you can specify the size of
  98.        one  of  the C compiler's built-in data types by following
  99.        the type indicator character with  one  of  the  following
  100.        characters.  For integers (d, o, u, x):
  101.  
  102.               C      char
  103.  
  104.               S      short
  105.  
  106.               I      int
  107.  
  108.               L      long
  109.  
  110.        For floating point (f):
  111.  
  112.               F      float
  113.  
  114.               D      double
  115.  
  116.               L      long double
  117.  
  118.        _-_v_, _-_-_o_u_t_p_u_t_-_d_u_p_l_i_c_a_t_e_s
  119.               Output  consecutive  lines  that are identical.  By
  120.               default, when two or more consecutive output  lines
  121.               would be equal, oodd outputs only the first line, and
  122.               puts just an asterisk  on  the  following  line  to
  123.               indicate that identical lines have been elided.
  124.  
  125.        _-_s_, _-_-_s_t_r_i_n_g_s_[_=_b_y_t_e_s_]
  126.               Instead  of  the  normal output, output only string
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. OD(1L)                                                     OD(1L)
  137.  
  138.  
  139.               constants in the input, which are a run of at least
  140.               _b_y_t_e_s  ASCII  graphic  (or  formatting) characters,
  141.               terminated by a  NUL.   If  _b_y_t_e_s  is  omitted,  it
  142.               defaults to 3.
  143.  
  144.        _-_w_, _-_-_w_i_d_t_h_[_=_b_y_t_e_s_]
  145.               The  number  of  input  bytes  to format per output
  146.               line.  It must be a multiple of  the  least  common
  147.               multiple of the sizes associated with the specified
  148.               output types.  If _b_y_t_e_s is omitted, it defaults  to
  149.               32.   If  this  option is not given, it defaults to
  150.               16.
  151.  
  152.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  153.               tus.
  154.  
  155.        _-_-_v_e_r_s_i_o_n
  156.               Print  version  information  on standard error then
  157.               exit.
  158.  
  159.        The next several options map  the  old,  pre-POSIX  format
  160.        specification  options  to  the corresponding POSIX format
  161.        specs.  GNU oodd accepts any combination of  old-  and  new-
  162.        style options.  Format specification options accumulate.
  163.  
  164.        _-_a     Output as named characters.  Equivalent to _-_t _a.
  165.  
  166.        _-_b     Output as octal bytes.  Equivalent to _-_t _o_C.
  167.  
  168.        _-_c     Output  as  ASCII  characters or backslash escapes.
  169.               Equivalent to _-_t _c.
  170.  
  171.        _-_d     Output as unsigned decimal shorts.   Equivalent  to
  172.               _-_t _u_2.
  173.  
  174.        _-_f     Output as floats.  Equivalent to _-_t _f_F.
  175.  
  176.        _-_h     Output as hexadecimal shorts.  Equivalent to _-_t _x_2.
  177.  
  178.        _-_i     Output as decimal shorts.  Equivalent to _-_t _d_2.
  179.  
  180.        _-_l     Output as decimal longs.  Equivalent to _-_t _d_4.
  181.  
  182.        _-_o     Output as octal shorts.  Equivalent to _-_t _o_2.
  183.  
  184.        _-_x     Output as hexadecimal shorts.  Equivalent to _-_t _x_2.
  185.  
  186.        _-_C_, _-_-_c_o_m_p_a_t_i_b_l_e
  187.               Recognize  the  pre-POSIX non-option arguments that
  188.               some older versions of od accepted.  The  following
  189.               syntax
  190.               oodd -C [file] [[+]offset[.][b] [[+]label[.][b]]]
  191.               can  be  used  to  specify  at  most  one  file and
  192.               optional  arguments  specifying  an  offset  and  a
  193.  
  194.  
  195.  
  196. FSF                     GNU Text Utilities                      3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. OD(1L)                                                     OD(1L)
  203.  
  204.  
  205.               pseudo-start address, _l_a_b_e_l_.  By default, _o_f_f_s_e_t is
  206.               interpreted as an octal number specifying how  many
  207.               input  bytes to skip before formatting and writing.
  208.               The optional  trailing  decimal  point  forces  the
  209.               interpretation  of  _o_f_f_s_e_t as a decimal number.  If
  210.               no decimal is specified and the offset begins  with
  211.               `0x'  or  `0x'  it  is interpreted as a hexadecimal
  212.               number.  If there is a trailing `b', the number  of
  213.               bytes  skipped  will  be  _o_f_f_s_e_t multiplied by 512.
  214.               The label argument is interpreted just like offset,
  215.               but  it  specifies  an initial pseudo-address.  The
  216.               pseudo addresses are displayed in parentheses  fol-
  217.               lowing any normal address.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. FSF                     GNU Text Utilities                      4
  263.  
  264.  
  265.