Return to od.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / old / od

Annotation of 43BSDReno/old/od/od.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)od.1        6.1 (Berkeley) 4/29/85
        !             6: .\"
        !             7: .TH OD 1 "April 29, 1985"
        !             8: .UC 4
        !             9: .SH NAME
        !            10: od \- octal, decimal, hex, ascii dump
        !            11: .SH SYNOPSIS
        !            12: .B od
        !            13: [ \-format ] [ file ] [ [\fB+\fP]offset[\fB.\fP][\fBb\fP] [label] ]
        !            14: .SH DESCRIPTION
        !            15: .I Od
        !            16: displays
        !            17: .IR file ,
        !            18: or it's standard input,
        !            19: in one or more dump formats
        !            20: as selected by the first argument.
        !            21: If the first argument is missing,
        !            22: .B \-o
        !            23: is the default.
        !            24: Dumping continues until end-of-file.
        !            25: .PP
        !            26: The meanings of the format argument characters are:
        !            27: .TP 5
        !            28: .B  a
        !            29: Interpret bytes as characters and display them with their ACSII names.
        !            30: If the
        !            31: .B p
        !            32: character is given also, then bytes with even parity are underlined.
        !            33: The
        !            34: .B P
        !            35: character causes bytes with odd parity to be underlined.
        !            36: Otherwise the parity bit is ignored.
        !            37: .TP 5
        !            38: .B  b
        !            39: Interpret bytes as unsigned octal.
        !            40: .TP 5
        !            41: .B  c
        !            42: Interpret bytes as ASCII characters.
        !            43: Certain non-graphic characters appear as C escapes:
        !            44: null=\e0,
        !            45: backspace=\eb,
        !            46: formfeed=\ef,
        !            47: newline=\en,
        !            48: return=\er,
        !            49: tab=\et;
        !            50: others appear as 3-digit octal numbers.
        !            51: Bytes with the parity bit set are displayed in octal.
        !            52: .TP 5
        !            53: .B  d
        !            54: Interpret (short) words as unsigned decimal.
        !            55: .TP 5
        !            56: .B  f
        !            57: Interpret long words as floating point.
        !            58: .TP 5
        !            59: .B  h
        !            60: Interpret (short) words as unsigned hexadecimal.
        !            61: .TP 5
        !            62: .B  i
        !            63: Interpret (short) words as signed decimal.
        !            64: .TP 5
        !            65: .B  l
        !            66: Interpret long words as signed decimal.
        !            67: .TP 5
        !            68: .B  o
        !            69: Interpret (short) words as unsigned octal.
        !            70: .TP 5
        !            71: .BR s [n]
        !            72: Look for strings of ascii graphic characters, terminated with a null byte.
        !            73: .I N
        !            74: specifies the minimum length string to be recognized.
        !            75: By default, the minimum length is 3 characters.
        !            76: .TP 5
        !            77: .B  v
        !            78: Show all data. By default, display lines that are identical to the last
        !            79: line shown are not output, but are indicated with an ``*'' in column 1.
        !            80: .TP 5
        !            81: .BR w [n]
        !            82: Specifies the number of input bytes to be interpreted and displayed
        !            83: on each output line. If
        !            84: .B w
        !            85: is not specified, 16 bytes are read for each display line.
        !            86: If
        !            87: .I n
        !            88: is not specified, it defaults to 32.
        !            89: .TP 5
        !            90: .B  x
        !            91: Interpret (short) words as hexadecimal.
        !            92: .PP
        !            93: An upper case format character implies the long or double precision
        !            94: form of the object.
        !            95: .PP
        !            96: The
        !            97: .I offset
        !            98: argument specifies the byte offset
        !            99: into the file where dumping is to commence.
        !           100: By default this argument is interpreted in octal.
        !           101: A different radix can be specified;
        !           102: If ``\fB.\fR'' is appended to the argument, then
        !           103: .I offset
        !           104: is interpreted in decimal.
        !           105: If
        !           106: .I offset
        !           107: begins with ``\fBx\fP'' or ``\fB0x\fP'',
        !           108: it is interpreted in hexadecimal.
        !           109: If ``\fBb\fP'' (``\fBB\fP'') is appended, the offset is interpreted
        !           110: as a block count, where a block is 512 (1024) bytes.
        !           111: If the
        !           112: .I file
        !           113: argument is omitted, an
        !           114: .I offset
        !           115: argument must be preceded by
        !           116: .RB `` + ''.
        !           117: .PP
        !           118: The radix of the displayed address will be the same as the radix of the
        !           119: .IR offset ,
        !           120: if specified; otherwise it will be octal.
        !           121: .PP
        !           122: .I Label
        !           123: will be interpreted as a pseudo-address for the first byte displayed.
        !           124: It will be shown in ``()'' following the file offset.
        !           125: It is intended to be used with
        !           126: core images to indicate the real memory address.
        !           127: The syntax for
        !           128: .I label
        !           129: is identical to that for
        !           130: .IR offset .
        !           131: .SH "SEE ALSO"
        !           132: adb(1)
        !           133: .SH BUGS
        !           134: A file name argument can't start with ``+''.
        !           135: A hexadecimal offset can't be a block count.
        !           136: Only one file name argument can be given.
        !           137: .PP
        !           138: It is an historical botch to require specification of object, radix, and
        !           139: sign representation in a single character argument.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.