Return to mc68strip.1 CVS log

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

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

1.1     ! root        1: .TH MC68STRIP 1 "630 MTG"
        !             2: .SH NAME
        !             3: mc68strip \- strip symbolic information from MC68000 object file
        !             4: .SH SYNOPSIS
        !             5: .B mc68strip
        !             6: .RB [ \-l ]
        !             7: .RB [ \-m ]
        !             8: .RB [ \-x ]
        !             9: .RB [ \-r ]
        !            10: .RB [ \-s ]
        !            11: .if 'mc68'3b' \{\
        !            12: .RB [ \-f ]
        !            13: .\}
        !            14: .RB [ \-V ]
        !            15: file-names
        !            16: .SH DESCRIPTION
        !            17: The 
        !            18: .I mc68strip
        !            19: command
        !            20: strips the symbol table and line number information from
        !            21: Motorola 68000 object files,
        !            22: including archives.
        !            23: Once this has been done, no symbolic debugging access
        !            24: is available for that file; therefore, this command is
        !            25: normally run only on production modules that have
        !            26: been debugged and tested.
        !            27: .PP
        !            28: The amount of information stripped from the symbol table
        !            29: can be controlled by using the following options:
        !            30: .PP
        !            31: .TP 9
        !            32: .BR \-l
        !            33: Strips line number information only;
        !            34: does not strip any symbol table information.
        !            35: .PP
        !            36: .TP 9
        !            37: .BR \-m
        !            38: Strips symbol table information only;
        !            39: does not strip any relocation information.
        !            40: Used for 630 MTG applications which need relocation information for downloads,
        !            41: but do not neccesarily need symbol table information.
        !            42: This option does not work on archives.
        !            43: .PP
        !            44: .TP 9
        !            45: .B \-x
        !            46: Does not strip static or external symbol information.
        !            47: .PP
        !            48: .TP 9
        !            49: .B \-r
        !            50: Resets the relocation indices into the symbol table.
        !            51: .if 'mc68'3b' \{\
        !            52: .PP
        !            53: .TP 9
        !            54: .B \-f
        !            55: Removes the relocation information from an executable object file
        !            56: for all sections not of type COPY. Reset
        !            57: relocation indices into the symbol table for all retained relocation
        !            58: information.
        !            59: .\}
        !            60: .PP
        !            61: .TP 9
        !            62: .B \-s
        !            63: Resets the line number indices into the symbol table (does not remove).
        !            64: Resets the relocation indices into the symbol table.
        !            65: .PP
        !            66: .TP 9
        !            67: .B \-V
        !            68: Prints the version of the mc68strip command executing on the standard error output.
        !            69: .DT
        !            70: .br
        !            71: .PP
        !            72: If there are any relocation entries in the object file and any symbol
        !            73: table information is to be stripped,
        !            74: .I mc68strip
        !            75: will complain and terminate without stripping
        !            76: .I file-name
        !            77: unless the
        !            78: \f3\-r\f1 or \f3\-m\f1
        !            79: flags are used.
        !            80: .PP
        !            81: If the 
        !            82: .IR mc68strip
        !            83: command is executed on a common archive file [see
        !            84: .IR ar (4)]
        !            85: the archive symbol table will be removed.  The archive
        !            86: symbol table must be restored by executing the
        !            87: .IR mc68ar (1)
        !            88: command with the 
        !            89: .B s
        !            90: option before the archive can be
        !            91: link edited by the 
        !            92: .IR mc68ld (1)
        !            93: command.  
        !            94: .IR Mc68strip (1)
        !            95: will instruct the user with appropriate warning messages when this
        !            96: situation arises.
        !            97: .PP
        !            98: The purpose of this command is to reduce the file storage
        !            99: overhead taken by the object file.
        !           100: .SH "FILES"
        !           101: /usr/tmp/mc68str??????
        !           102: .SH "SEE ALSO"
        !           103: dmdcc(1),
        !           104: mc68ar(1),
        !           105: mc68as(1),
        !           106: mc68ld(1).
        !           107: .br
        !           108: a.out(4), ar(4) in the \f2UNIX System V Programmer's
        !           109: Reference Manual\f1.
        !           110: .SH "DIAGNOSTICS"
        !           111: .TP 9
        !           112: mc68strip:  name:  cannot open
        !           113: .br
        !           114:        if
        !           115: .I name
        !           116: cannot be read.
        !           117: .PP
        !           118: .TP 9
        !           119: mc68strip:  name:  bad magic 
        !           120: .br
        !           121:        if
        !           122: .I name
        !           123: is not a Motorola 68000 object file.
        !           124: .PP
        !           125: .TP 9
        !           126: mc68strip:  name:  relocation entries present; cannot strip 
        !           127: .br
        !           128:        if
        !           129: .I name
        !           130: contains relocation entries and the
        !           131: \f3\-r\f1 or \f3\-m\f1
        !           132: flag is not used,
        !           133: the symbol table information cannot be stripped.
        !           134: .PP
        !           135: .TP 9
        !           136: mc68strip:  name:  other options set with "m" option 
        !           137: .br
        !           138:        if
        !           139: other flags are used with the -m option which is mutually exclusive. 
        !           140: .PP
        !           141: .TP 9
        !           142: mc68strip:  "m" option not allowed on archive files 
        !           143: .br
        !           144:         if
        !           145: file name is an archive file.

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