home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / od.man < prev    next >
Encoding:
Text File  |  1993-06-13  |  7.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. OD(1L)                                                     OD(1L)
  5.  
  6.  
  7. NAME
  8.        od - dump files in octal and other formats
  9.  
  10. SYNOPSIS
  11.        od  [-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. DESCRIPTION
  19.        This manual page documents the  GNU  version  of  od.   od
  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, od prints the file
  26.        offsets  in octal and the file data as two-byte octal num-
  27.        bers.
  28.  
  29.  
  30.    OPTIONS
  31.        -A, --address-radix=radix
  32.               Select the base in which file offsets are  printed.
  33.               radix 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, --skip-bytes=bytes
  46.               Skip  bytes input bytes before formatting and writ-
  47.               ing.  If bytes 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, --read-bytes=bytes
  54.               Only output up to bytes bytes of each  input  file.
  55.               Any  prefixes and suffixes on bytes are interpreted
  56.               as for the -j option.
  57.  
  58.        -t, --format=type
  59.               Select the format in which to output the file data.
  60.               type  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 type string or
  75.               use this option more than once, od 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, --output-duplicates
  119.               Output  consecutive  lines  that are identical.  By
  120.               default, when two or more consecutive output  lines
  121.               would be equal, od 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, --strings[=bytes]
  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.               bytes  ASCII  graphic  (or  formatting) characters,
  141.               terminated by a  NUL.   If  bytes  is  omitted,  it
  142.               defaults to 3.
  143.  
  144.        -w, --width[=bytes]
  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 bytes is omitted, it defaults  to
  149.               32.   If  this  option is not given, it defaults to
  150.               16.
  151.  
  152.        --help Print a usage message and exit with a non-zero sta-
  153.               tus.
  154.  
  155.        --version
  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 od 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 oC.
  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 u2.
  173.  
  174.        -f     Output as floats.  Equivalent to -t fF.
  175.  
  176.        -h     Output as hexadecimal shorts.  Equivalent to -t x2.
  177.  
  178.        -i     Output as decimal shorts.  Equivalent to -t d2.
  179.  
  180.        -l     Output as decimal longs.  Equivalent to -t d4.
  181.  
  182.        -o     Output as octal shorts.  Equivalent to -t o2.
  183.  
  184.        -x     Output as hexadecimal shorts.  Equivalent to -t x2.
  185.  
  186.        -C, --compatible
  187.               Recognize  the  pre-POSIX non-option arguments that
  188.               some older versions of od accepted.  The  following
  189.               syntax
  190.               od -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, label.  By default, offset 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  offset 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  offset 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.