binutils/nlmconv.1

   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
  18 .RB "[\|" \-I\ \fIformat\fB\ |\ \-\-input\-format=\fIformat\fR "\|]"
  19 .RB "[\|" \-O\ \fIformat\fB\ |\ \-\-output\-format=\fIformat\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 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
  50 .B \-I \fIformat\fR, \fB\-\-input\-format=\fIformat
  51 Consider the source file's object format to be
  52 .IR format ,
  53 rather than attempting to deduce it.
  54 .TP
  55 .B \-O \fIformat\fR, \fB\-\-output\-format=\fIformat
  56 Write the output file using the object format
  57 .IR format .
  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.