binutils/nlmconv.1

   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.