Annotation of researchv10dc/630/man/src/u_man/man1/mc68dump.1, revision 1.1.1.1

1.1       root        1: .TH MC68DUMP 1 "630 MTG" 
                      2: .tr ~
                      3: .SH NAME
                      4: mc68dump \- dump parts of an MC68000 object file
                      5: .SH SYNOPSIS
                      6: .B mc68dump
                      7: .RB [ \-acfghlorst ]
                      8: .RB [ \-z " name]"
                      9: files
                     10: .SH DESCRIPTION
                     11: The
                     12: .I mc68dump
                     13: command
                     14: dumps selected parts of each
                     15: of its object \fIfile\fP arguments.
                     16: .PP
                     17: This command
                     18: accepts both object files and archives of object files.
                     19: It 
                     20: processes each file argument according to one or more of the following 
                     21: options:
                     22: .TP \w'\fB\-d~number~~'u
                     23: .B \-a
                     24: Dumps the archive header of each member of each archive file
                     25: argument.
                     26: .TP
                     27: .B \-g
                     28: Dumps the global symbols in the symbol table of a 6.0 archive.
                     29: .TP
                     30: .B \-f
                     31: Dumps each file header.
                     32: .TP
                     33: .B \-o
                     34: Dumps each optional header.
                     35: .TP
                     36: .B \-h
                     37: Dumps section headers.
                     38: .TP
                     39: .B \-s
                     40: Dumps section contents.
                     41: .TP
                     42: .B \-r
                     43: Dumps relocation information.
                     44: .TP
                     45: .B \-l
                     46: Dumps line number information.
                     47: .TP
                     48: .B \-t
                     49: Dumps symbol table entries.
                     50: .TP
                     51: .BR \-z ~name
                     52: Dumps line number entries for the named function.
                     53: .TP
                     54: .BR \-c
                     55: Dumps the string table.
                     56: .PP
                     57: The following \fImodifiers\fP are used in conjunction with the options
                     58: listed above to modify their capabilities.
                     59: .TP \w'\fB\-d~number~~'u
                     60: .BR \-d ~number
                     61: Dumps the section number or range of sections starting at \fInumber\fP
                     62: and ending either at the last section number or \fInumber\fP specified by
                     63: .BR +d .
                     64: .TP
                     65: .BR +d ~number
                     66: Dumps sections in the range either beginning with 
                     67: first section or beginning
                     68: with section specified by \fB\-d\fP.
                     69: .TP
                     70: .BR \-n ~name
                     71: Dumps information pertaining only to the named entity.
                     72: This
                     73: .I modifier
                     74: applies to
                     75: .BR \-h ,
                     76: .BR \-s ,
                     77: .BR \-r ,
                     78: .BR \-l ,
                     79: and 
                     80: .BR \-t .
                     81: .TP
                     82: .B \-p
                     83: Suppresses printing of the headers.
                     84: .TP
                     85: .BR \-t ~index
                     86: Dumps only the indexed symbol table entry.
                     87: The 
                     88: \f3-t\f1,
                     89: used in conjunction with
                     90: .BR +t ,
                     91: specifies a range of symbol
                     92: table entries.
                     93: .TP
                     94: .BR +t ~index
                     95: Dumps the symbol table entries in the range ending with the indexed entry.
                     96: The range begins at the first symbol table entry or at the entry
                     97: specified by the 
                     98: .B \-t
                     99: option.
                    100: .TP
                    101: .B \-u
                    102: Underlines the name of the file for emphasis.
                    103: .TP
                    104: .B \-v
                    105: Dumps information in symbolic representation rather than numeric
                    106: (e.g.,
                    107: .SM C_STATIC
                    108: instead of 
                    109: .BR \s-10X02\s+1 ).
                    110: This \fImodifier\fP can be used with all the above options
                    111: except
                    112: .B \-s
                    113: and
                    114: .B \-o
                    115: options
                    116: of
                    117: .IR mc68dump.
                    118: .TP
                    119: .BR \-z ~name,number
                    120: Dumps line number entry or range of line numbers starting at
                    121: .I number
                    122: for the named function.
                    123: .TP
                    124: .BR \+z ~number
                    125: Dumps line numbers starting at either function
                    126: .IR name " or " number
                    127: specified 
                    128: by
                    129: .BR \-z,
                    130: up to
                    131: .I number
                    132: specified by
                    133: .BR +z .
                    134: .PP
                    135: .PP
                    136: Blanks separating an \fIoption\fP and its \fImodifier\fP are optional.
                    137: The comma separating the name from the number modifying the
                    138: .B \-z
                    139: option may
                    140: be replaced by a blank.
                    141: .PP
                    142: The
                    143: .B -z
                    144: and
                    145: .B -n
                    146: options that take a
                    147: .I name
                    148: modifier will only work with object files that have been compiled
                    149: with the
                    150: .B "dmdcc \-g"
                    151: option.
                    152: .PP
                    153: The
                    154: .I mc68dump
                    155: command
                    156: attempts to format the information it dumps in a meaningful way,
                    157: printing certain information in character,
                    158: hex, octal or decimal representation as appropriate.
                    159: .SH "SEE ALSO"
                    160: dmdcc(1).
                    161: .br
                    162: a.out(4), ar(4) in the \f2UNIX System V Programer's
                    163: Reference Manual\f1.
                    164: .tr ~~

unix.superglobalmegacorp.com

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