[deliverable/binutils-gdb.git] / binutils / nlmconv.1

.\" Copyright (c) 1991, 1996  Free Software Foundation
.\" See section COPYING for conditions for redistribution
.TH nlmconv 1 "March 1996" "cygnus support" "GNU Development Tools"
.de BP
.sp
.ti \-.2i
\(**
..

.SH NAME
nlmconv \- converts object code into an NLM

.SH SYNOPSIS
.hy 0
.na
.TP
.B nlmconv
.RB "[\|" \-I\ \fIbfdname\fB\ |\ \-\-input\-target=\fIbfdname\fR "\|]" 
.RB "[\|" \-O\ \fIbfdname\fB\ |\ \-\-output\-target=\fIbfdname\fR "\|]" 
.RB "[\|" \-T\ \fIheaderfile\fB\ |\ \-\-header\-file=\fIheaderfile\fR "\|]" 
.RB "[\|" \-V\ |\ \-\-version\fR "\|]" 
.RB "[\|" \-\-help\fR "\|]" 
.B infile
.B outfile
.SH DESCRIPTION
.B nlmconv
converts the relocatable object file 
.B infile
into the NetWare Loadable Module 
.BR outfile ,
optionally reading 
.I headerfile
for NLM header information.  For instructions on writing the NLM
command file language used in header files, see 
.IR "The NetWare Tool Maker Specification Manual" ,
available from Novell, Inc.
.B nlmconv
currently works with i386 object files in 
.BR COFF ,
.BR ELF ,
or
.B a.out
format, and with SPARC object files in
.B ELF
or
.B a.out
format.
.br
.B nlmconv
uses the GNU Binary File Descriptor library to read 
.IR infile .
.SH OPTIONS
.TP
.B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
Consider the source file's object format to be 
.IR bfdname ,
rather than attempting to deduce it.
.TP
.B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
Write the output file using the object format 
.IR bfdname .
.B nlmconv
infers the output format based on the input format, e.g. for an i386
input file the output format is
.IR nlm32\-i386 .
.TP
.B \-T \fIheaderfile\fR, \fB\-\-header\-file=\fIheaderfile
Reads 
.I headerfile
for NLM header information.  For instructions on writing the NLM
command file language used in header files, see 
.IR "The NetWare Tool Maker Specification Manual" ,
available from Novell, Inc.
.TP
.B \-V\fR, \fB\-\-version
Show the version number of
.B nlmconv
and exit.
.TP
.B \-h\fR, \fB\-\-help
Show a summary of the options to
.B nlmconv
and exit.
.SH "SEE ALSO"
.RB "`\|" binutils "\|'" 
entry in 
.B
info\c
\&; 
.I
The GNU Binary Utilities\c
\&, Roland H. Pesch (June 1993).

.SH COPYING
Copyright (c) 1993 Free Software Foundation, Inc.
.PP
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
.PP
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
.PP
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in
the original English.
Commit	Line	Data
252b5132 RH	1	.\" Copyright (c) 1991, 1996 Free Software Foundation
	2	.\" See section COPYING for conditions for redistribution
	3	.TH nlmconv 1 "March 1996" "cygnus support" "GNU Development Tools"
	4	.de BP
	5	.sp
	6	.ti \-.2i
	7	\(**
	8	..
	9
	10	.SH NAME
	11	nlmconv \- converts object code into an NLM
	12
	13	.SH SYNOPSIS
	14	.hy 0
	15	.na
	16	.TP
	17	.B nlmconv
	18	.RB "[\\|" \-I\ \fIbfdname\fB\ \|\ \-\-input\-target=\fIbfdname\fR "\\|]"
	19	.RB "[\\|" \-O\ \fIbfdname\fB\ \|\ \-\-output\-target=\fIbfdname\fR "\\|]"
	20	.RB "[\\|" \-T\ \fIheaderfile\fB\ \|\ \-\-header\-file=\fIheaderfile\fR "\\|]"
	21	.RB "[\\|" \-V\ \|\ \-\-version\fR "\\|]"
	22	.RB "[\\|" \-\-help\fR "\\|]"
	23	.B infile
	24	.B outfile
	25	.SH DESCRIPTION
	26	.B nlmconv
	27	converts the relocatable object file
	28	.B infile
	29	into the NetWare Loadable Module
	30	.BR outfile ,
	31	optionally reading
	32	.I headerfile
	33	for NLM header information. For instructions on writing the NLM
	34	command file language used in header files, see
	35	.IR "The NetWare Tool Maker Specification Manual" ,
	36	available from Novell, Inc.
	37	.B nlmconv
	38	currently works with i386 object files in
	39	.BR COFF ,
	40	.BR ELF ,
	41	or
	42	.B a.out
	43	format, and with SPARC object files in
	44	.B ELF
	45	or
	46	.B a.out
	47	format.
	48	.br
	49	.B nlmconv
	50	uses the GNU Binary File Descriptor library to read
	51	.IR infile .
	52	.SH OPTIONS
	53	.TP
	54	.B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
	55	Consider the source file's object format to be
	56	.IR bfdname ,
	57	rather than attempting to deduce it.
	58	.TP
	59	.B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
	60	Write the output file using the object format
	61	.IR bfdname .
	62	.B nlmconv
	63	infers the output format based on the input format, e.g. for an i386
	64	input file the output format is
65	.IR nlm32\-i386 .
66	.TP
67	.B \-T \fIheaderfile\fR, \fB\-\-header\-file=\fIheaderfile
68	Reads
69	.I headerfile
70	for NLM header information. For instructions on writing the NLM
71	command file language used in header files, see
72	.IR "The NetWare Tool Maker Specification Manual" ,
73	available from Novell, Inc.
74	.TP
75	.B \-V\fR, \fB\-\-version
76	Show the version number of
77	.B nlmconv
78	and exit.
79	.TP
80	.B \-h\fR, \fB\-\-help
81	Show a summary of the options to
82	.B nlmconv
83	and exit.
84	.SH "SEE ALSO"
85	.RB "`\\|" binutils "\\|'"
86	entry in
87	.B
88	info\c
89	\&;
90	.I
91	The GNU Binary Utilities\c
92	\&, Roland H. Pesch (June 1993).
93
94	.SH COPYING
95	Copyright (c) 1993 Free Software Foundation, Inc.
96	.PP
97	Permission is granted to make and distribute verbatim copies of
98	this manual provided the copyright notice and this permission notice
99	are preserved on all copies.
100	.PP
101	Permission is granted to copy and distribute modified versions of this
102	manual under the conditions for verbatim copying, provided that the
103	entire resulting derived work is distributed under the terms of a
104	permission notice identical to this one.
105	.PP
106	Permission is granted to copy and distribute translations of this
107	manual into another language, under the above conditions for modified
108	versions, except that this permission notice may be included in
109	translations approved by the Free Software Foundation instead of in
110	the original English.