binutils/nlmconv.1

   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"
 193 nlmconv \- converts object code into an NLM.
 194 .SH "SYNOPSIS"
 195 nlmconv [ \-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
 204 reading \fIheaderfile\fR for NLM header information.  For instructions
 205 on writing the NLM command file language used in header files, see the
 206 \fBlinkers\fR section, \fBNLMLINK\fR in particular, of the \fINLM
 207 Development and Tools Overview\fR, which is part of the NLM Software
 208 Developer'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
 213 more than one object file for input if you list them in the definitions
 214 file (rather than simply specifying one input file on the command line).
 215 In 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
 219 Object format of the input file.  \f(CWnlmconv\fR can usually determine
 220 the 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
 223 Object format of the output file.  \f(CWnlmconv\fR infers the output
 224 format based on the input format, e.g. for a \fBi386\fR input file the
 225 output format is \fBnlm32-i386\fR.
 226 .Ip "\f(CW-T \fIheaderfile\fR\fR" 4
 227 .Ip "\f(CW--header-file=\fIheaderfile\fR\fR" 4
 228 Reads \fIheaderfile\fR for \s-1NLM\s0 header information.  For instructions on
 229 writing 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
 231 Overview\fR, which is part of the \s-1NLM\s0 Software Developer's Kit, available
 232 from Novell, Inc.
 233 .Ip "\f(CW-d\fR" 4
 234 .Ip "\f(CW--debug\fR" 4
 235 Displays (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
 238 Use \fIlinker\fR for any linking.  \fIlinker\fR can be an absolute or a
 239 relative pathname.
 240 .Ip "\f(CW-h\fR" 4
 241 .Ip "\f(CW--help\fR" 4
 242 Prints a usage summary.
 243 .Ip "\f(CW-V\fR" 4
 244 .Ip "\f(CW--version\fR" 4
 245 Prints the version number for \f(CWnlmconv\fR.
 246 .SH "SEE ALSO"
 247 the Info entries for \fIbinutils\fR.
 248 .SH "COPYRIGHT"
 249 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
 250 .PP
 251 Permission is granted to copy, distribute and/or modify this document
 252 under the terms of the GNU Free Documentation License, Version 1.1
 253 or any later version published by the Free Software Foundation;
 254 with no Invariant Sections, with no Front-Cover Texts, and with no
 255 Back-Cover Texts.  A copy of the license is included in the
 256 section 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