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

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

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