Update copyright date.
[deliverable/binutils-gdb.git] / binutils / nlmconv.1
... / ...
CommitLineData
1.rn '' }`
2''' $RCSfile$$Revision$$Date$
3'''
4''' $Log$
5''' Revision 1.5 2001/03/25 20:32:25 nickc
6''' Automate generate on man pages
7'''
8'''
9.de Sh
10.br
11.if t .Sp
12.ne 5
13.PP
14\fB\\$1\fR
15.PP
16..
17.de Sp
18.if t .sp .5v
19.if n .sp
20..
21.de Ip
22.br
23.ie \\n(.$>=3 .ne \\$3
24.el .ne 3
25.IP "\\$1" \\$2
26..
27.de Vb
28.ft CW
29.nf
30.ne \\$1
31..
32.de Ve
33.ft R
34
35.fi
36..
37'''
38'''
39''' Set up \*(-- to give an unbreakable dash;
40''' string Tr holds user defined translation string.
41''' Bell System Logo is used as a dummy character.
42'''
43.tr \(*W-|\(bv\*(Tr
44.ie n \{\
45.ds -- \(*W-
46.ds PI pi
47.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
48.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
49.ds L" ""
50.ds R" ""
51''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
52''' \*(L" and \*(R", except that they are used on ".xx" lines,
53''' such as .IP and .SH, which do another additional levels of
54''' double-quote interpretation
55.ds M" """
56.ds S" """
57.ds N" """""
58.ds T" """""
59.ds L' '
60.ds R' '
61.ds M' '
62.ds S' '
63.ds N' '
64.ds T' '
65'br\}
66.el\{\
67.ds -- \(em\|
68.tr \*(Tr
69.ds L" ``
70.ds R" ''
71.ds M" ``
72.ds S" ''
73.ds N" ``
74.ds T" ''
75.ds L' `
76.ds R' '
77.ds M' `
78.ds S' '
79.ds N' `
80.ds T' '
81.ds PI \(*p
82'br\}
83.\" If the F register is turned on, we'll generate
84.\" index entries out stderr for the following things:
85.\" TH Title
86.\" SH Header
87.\" Sh Subsection
88.\" Ip Item
89.\" X<> Xref (embedded
90.\" Of course, you have to process the output yourself
91.\" in some meaninful fashion.
92.if \nF \{
93.de IX
94.tm Index:\\$1\t\\n%\t"\\$2"
95..
96.nr % 0
97.rr F
98.\}
99.TH NLMCONV.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
100.UC
101.if n .hy 0
102.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
103.de CQ \" put $1 in typewriter font
104.ft CW
105'if n "\c
106'if t \\&\\$1\c
107'if n \\&\\$1\c
108'if n \&"
109\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110'.ft R
111..
112.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
113. \" AM - accent mark definitions
114.bd B 3
115. \" fudge factors for nroff and troff
116.if n \{\
117. ds #H 0
118. ds #V .8m
119. ds #F .3m
120. ds #[ \f1
121. ds #] \fP
122.\}
123.if t \{\
124. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
125. ds #V .6m
126. ds #F 0
127. ds #[ \&
128. ds #] \&
129.\}
130. \" simple accents for nroff and troff
131.if n \{\
132. ds ' \&
133. ds ` \&
134. ds ^ \&
135. ds , \&
136. ds ~ ~
137. ds ? ?
138. ds ! !
139. ds /
140. ds q
141.\}
142.if t \{\
143. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
144. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
145. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
146. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
147. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
148. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
149. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
150. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
151. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
152.\}
153. \" troff and (daisy-wheel) nroff accents
154.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
155.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
156.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
157.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
158.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
159.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
160.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
161.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
162.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
163.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
164.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
165.ds ae a\h'-(\w'a'u*4/10)'e
166.ds Ae A\h'-(\w'A'u*4/10)'E
167.ds oe o\h'-(\w'o'u*4/10)'e
168.ds Oe O\h'-(\w'O'u*4/10)'E
169. \" corrections for vroff
170.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
171.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
172. \" for low resolution devices (crt and lpr)
173.if \n(.H>23 .if \n(.V>19 \
174\{\
175. ds : e
176. ds 8 ss
177. ds v \h'-1'\o'\(aa\(ga'
178. ds _ \h'-1'^
179. ds . \h'-1'.
180. ds 3 3
181. ds o a
182. ds d- d\h'-1'\(ga
183. ds D- D\h'-1'\(hy
184. ds th \o'bp'
185. ds Th \o'LP'
186. ds ae ae
187. ds Ae AE
188. ds oe oe
189. ds Oe OE
190.\}
191.rm #[ #] #H #V #F C
192.SH "NAME"
193nlmconv \- converts object code into an NLM.
194.SH "SYNOPSIS"
195nlmconv [ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
196 [ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
197 [ \-T \fIheaderfile\fR | --header-file=\fIheaderfile\fR ]
198 [ \-d | --debug] [ \-l \fIlinker\fR | --linker=\fIlinker\fR ]
199 [ \-h | --help ] [ \-V | --version ]
200 \fIinfile\fR \fIoutfile\fR
201.SH "DESCRIPTION"
202\f(CWnlmconv\fR converts the relocatable \fBi386\fR object file
203\fIinfile\fR into the NetWare Loadable Module \fIoutfile\fR, optionally
204reading \fIheaderfile\fR for NLM header information. For instructions
205on writing the NLM command file language used in header files, see the
206\fBlinkers\fR section, \fBNLMLINK\fR in particular, of the \fINLM
207Development and Tools Overview\fR, which is part of the NLM Software
208Developer's Kit (``NLM SDK''), available from Novell, Inc.
209\f(CWnlmconv\fR uses the GNU Binary File Descriptor library to read
210\fIinfile\fR;
211.PP
212\f(CWnlmconv\fR can perform a link step. In other words, you can list
213more than one object file for input if you list them in the definitions
214file (rather than simply specifying one input file on the command line).
215In this case, \f(CWnlmconv\fR calls the linker for you.
216.SH "OPTIONS"
217.Ip "\f(CW-I \fIbfdname\fR\fR" 4
218.Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
219Object format of the input file. \f(CWnlmconv\fR can usually determine
220the format of a given file (so no default is necessary).
221.Ip "\f(CW-O \fIbfdname\fR\fR" 4
222.Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
223Object format of the output file. \f(CWnlmconv\fR infers the output
224format based on the input format, e.g. for a \fBi386\fR input file the
225output format is \fBnlm32-i386\fR.
226.Ip "\f(CW-T \fIheaderfile\fR\fR" 4
227.Ip "\f(CW--header-file=\fIheaderfile\fR\fR" 4
228Reads \fIheaderfile\fR for \s-1NLM\s0 header information. For instructions on
229writing the \s-1NLM\s0 command file language used in header files, see see the
230\fBlinkers\fR section, of the \fI\s-1NLM\s0 Development and Tools
231Overview\fR, which is part of the \s-1NLM\s0 Software Developer's Kit, available
232from Novell, Inc.
233.Ip "\f(CW-d\fR" 4
234.Ip "\f(CW--debug\fR" 4
235Displays (on standard error) the linker command line used by \f(CWnlmconv\fR.
236.Ip "\f(CW-l \fIlinker\fR\fR" 4
237.Ip "\f(CW--linker=\fIlinker\fR\fR" 4
238Use \fIlinker\fR for any linking. \fIlinker\fR can be an absolute or a
239relative pathname.
240.Ip "\f(CW-h\fR" 4
241.Ip "\f(CW--help\fR" 4
242Prints a usage summary.
243.Ip "\f(CW-V\fR" 4
244.Ip "\f(CW--version\fR" 4
245Prints the version number for \f(CWnlmconv\fR.
246.SH "SEE ALSO"
247the Info entries for \fIbinutils\fR.
248.SH "COPYRIGHT"
249Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
250.PP
251Permission is granted to copy, distribute and/or modify this document
252under the terms of the GNU Free Documentation License, Version 1.1
253or any later version published by the Free Software Foundation;
254with no Invariant Sections, with no Front-Cover Texts, and with no
255Back-Cover Texts. A copy of the license is included in the
256section entitled \*(L"GNU Free Documentation License\*(R".
257
258.rn }` ''
259.IX Title "NLMCONV.1 1"
260.IX Name "nlmconv - converts object code into an NLM."
261
262.IX Header "NAME"
263
264.IX Header "SYNOPSIS"
265
266.IX Header "DESCRIPTION"
267
268.IX Header "OPTIONS"
269
270.IX Item "\f(CW-I \fIbfdname\fR\fR"
271
272.IX Item "\f(CW--input-target=\fIbfdname\fR\fR"
273
274.IX Item "\f(CW-O \fIbfdname\fR\fR"
275
276.IX Item "\f(CW--output-target=\fIbfdname\fR\fR"
277
278.IX Item "\f(CW-T \fIheaderfile\fR\fR"
279
280.IX Item "\f(CW--header-file=\fIheaderfile\fR\fR"
281
282.IX Item "\f(CW-d\fR"
283
284.IX Item "\f(CW--debug\fR"
285
286.IX Item "\f(CW-l \fIlinker\fR\fR"
287
288.IX Item "\f(CW--linker=\fIlinker\fR\fR"
289
290.IX Item "\f(CW-h\fR"
291
292.IX Item "\f(CW--help\fR"
293
294.IX Item "\f(CW-V\fR"
295
296.IX Item "\f(CW--version\fR"
297
298.IX Header "SEE ALSO"
299
300.IX Header "COPYRIGHT"
301
This page took 0.022961 seconds and 4 git commands to generate.