Return to mc68nm.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/mc68nm.1, revision 1.1

1.1     ! root        1: .TH MC68NM 1 "630 MTG"
        !             2: .SH NAME
        !             3: mc68nm \- print name list of a MC68000 object file
        !             4: .SH SYNOPSIS
        !             5: \f3mc68nm [\f1 options \f3]\f1 file-names
        !             6: .SH DESCRIPTION
        !             7: The
        !             8: .I mc68nm\^
        !             9: command
        !            10: displays the symbol table of each
        !            11: Motorola 68000 object file
        !            12: .IR file-name .
        !            13: .I File-name\^
        !            14: may be a relocatable or absolute Motorola 68000 object file;
        !            15: or it may be an archive of relocatable or absolute Motorola 68000 object files.
        !            16: For each symbol, the following information is printed.
        !            17: For the \f3TYPE\f1, \f3SIZE\f1, or \f3LINE\f1 information,
        !            18: the object file must be compiled with the
        !            19: \f3-g\f1 option of the \f2dmdcc\f1(1) command.
        !            20: .PP
        !            21: .TP 9
        !            22: .B Name
        !            23: The name of the symbol.
        !            24: .TP 9
        !            25: .B Value
        !            26: Its value expressed as an offset or an address
        !            27: depending on its storage class.
        !            28: .TP 9
        !            29: .B Class
        !            30: Its storage class.
        !            31: .TP 9
        !            32: .B Type
        !            33: Its type and derived type.
        !            34: If the symbol is an instance of a structure or of a union, then the structure
        !            35: or union tag is given following the type (e.g. struct-tag).
        !            36: If the symbol is an array, then the array dimensions are given 
        !            37: following the type (eg.,
        !            38: .BR char[ n ][ m ] ).
        !            39: .TP 9
        !            40: .B Size
        !            41: Its size in bytes, if available.
        !            42: .TP 9
        !            43: .B Line
        !            44: The source line number at which it is defined, if available.
        !            45: .TP 9
        !            46: .B Section
        !            47: For storage classes static and external,
        !            48: the object file section containing the symbol (e.g., text, data or bss).
        !            49: .DT
        !            50: .br
        !            51: .PP
        !            52: The output of
        !            53: .I mc68nm
        !            54: may be controlled using the following options:
        !            55: .\" .if !'mc68'' \{\
        !            56: .\" .PP
        !            57: .\" .TP 9
        !            58: .\" .B \-a
        !            59: .\" Produce full output.  Redundant symbols (.text, .data, and .bss),
        !            60: .\" normally suppressed, are printed.
        !            61: .\" \}
        !            62: .PP
        !            63: .TP 9
        !            64: .B \-d
        !            65: Prints the value and size of a symbol in decimal (the default).
        !            66: .PP
        !            67: .TP 9
        !            68: .B \-o
        !            69: Prints the value and size of a symbol in octal instead of decimal.
        !            70: .PP
        !            71: .TP 9
        !            72: .B \-x
        !            73: Prints the value and size of a symbol in hexadecimal instead of decimal.
        !            74: .PP
        !            75: .TP 9
        !            76: .B \-h
        !            77: Does not display the output header data.
        !            78: .PP
        !            79: .TP 9
        !            80: .B \-v
        !            81: Sorts external symbols by value before they are printed.
        !            82: .PP
        !            83: .TP 9
        !            84: .B \-n
        !            85: Sorts external symbols by name before they are printed.
        !            86: .PP
        !            87: .TP 9
        !            88: .B \-e
        !            89: Prints only external and static symbols.
        !            90: .PP
        !            91: .TP 9
        !            92: .B \-f
        !            93: .\" .ie 'mc68'' \{\
        !            94: Produces full output.  Prints redundant symbols (.text, .data and .bss),
        !            95: that are normally suppressed.
        !            96: .\" \}
        !            97: .\" .el \{\
        !            98: .\" ``Fancy'' output is produced; that is, the symbol table information
        !            99: .\" is post-processed to reflect the block structure of the source code.
        !           100: .\" \}
        !           101: .bp
        !           102: .TP 9
        !           103: .B \-u
        !           104: Prints undefined symbols only.
        !           105: .PP
        !           106: .TP 9
        !           107: .B \-V
        !           108: Prints the version of the mc68nm command executing on the standard error output.
        !           109: .PP
        !           110: .TP 9
        !           111: .B \-T
        !           112: By default,
        !           113: .I mc68nm\^
        !           114: prints the entire name of the symbols listed.
        !           115: Since object files can have symbol names with an arbitrary number of 
        !           116: characters, a name that is longer than the width of the column set aside
        !           117: for names will overflow its column, forcing every column after the name
        !           118: to be misaligned.  The 
        !           119: .B \-T
        !           120: option causes
        !           121: .I mc68nm\^
        !           122: to truncate every name which would otherwise overflow its column and
        !           123: place an asterisk as the last character in the displayed name to mark
        !           124: it as truncated.
        !           125: .DT
        !           126: .br
        !           127: .PP
        !           128: Options may be used in any order, either singly or in combination,
        !           129: and may appear anywhere in the command line.
        !           130: Therefore, both 
        !           131: .B "mc68nm name \-e \-v"
        !           132: and
        !           133: .B "mc68nm \-ve name"
        !           134: print the static and external symbols in
        !           135: .IR name ,
        !           136: with external symbols sorted by value.
        !           137: .SH "FILES"
        !           138: /usr/tmp/nm??????
        !           139: .SH "SEE ALSO"
        !           140: dmdcc(1),
        !           141: mc68as(1),
        !           142: mc68ld(1).
        !           143: .br
        !           144: a.out(4), ar(4) in the \f2UNIX System V Programmer's Reference
        !           145: Manual\f1.
        !           146: .SH "DIAGNOSTICS"
        !           147: .TP 9
        !           148: ``mc68nm:  name:  cannot open''
        !           149: if
        !           150: .I name
        !           151: cannot be read.
        !           152: .PP
        !           153: .TP 9
        !           154: ``mc68nm:  name:  bad magic''
        !           155: if
        !           156: .I name
        !           157: is not an appropriate Motorola 68000 object file.
        !           158: .PP
        !           159: .TP 9
        !           160: ``mc68nm:  name:  no symbols''
        !           161: if the symbols have been stripped from
        !           162: .IR name .
        !           163: .SH "WARNINGS"
        !           164: When all the symbols are printed, they must be printed in the order they
        !           165: appear in the symbol table in order to preserve scoping information.
        !           166: Therefore, the
        !           167: .B \-v
        !           168: and
        !           169: .B \-n
        !           170: options should be used only in conjunction with the
        !           171: .B \-e 
        !           172: option.

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