![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mc68strip.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1|
Return to mc68strip.1 CVS log | Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1 |
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.