• Home
  • History
  • Annotate
  • Line#
  • Navigate
  • Raw
  • Download
  • only in /asuswrt-rt-n18u-9.0.0.4.380.2695/release/src-rt-6.x.4708/toolchains/hndtools-armeabi-2013.11/share/doc/arm-arm-none-eabi/html/binutils.html/
1<html lang="en">
2<head>
3<title>nlmconv - GNU Binary Utilities</title>
4<meta http-equiv="Content-Type" content="text/html">
5<meta name="description" content="GNU Binary Utilities">
6<meta name="generator" content="makeinfo 4.13">
7<link title="Top" rel="start" href="index.html#Top">
8<link rel="prev" href="addr2line.html#addr2line" title="addr2line">
9<link rel="next" href="windmc.html#windmc" title="windmc">
10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11<!--
12Copyright (C) 1991-2013 Free Software Foundation, Inc.
13
14Permission is granted to copy, distribute and/or modify this document
15under the terms of the GNU Free Documentation License, Version 1.3
16or any later version published by the Free Software Foundation;
17with no Invariant Sections, with no Front-Cover Texts, and with no
18Back-Cover Texts.  A copy of the license is included in the
19section entitled ``GNU Free Documentation License''.
20
21-->
22<meta http-equiv="Content-Style-Type" content="text/css">
23<style type="text/css"><!--
24  pre.display { font-family:inherit }
25  pre.format  { font-family:inherit }
26  pre.smalldisplay { font-family:inherit; font-size:smaller }
27  pre.smallformat  { font-family:inherit; font-size:smaller }
28  pre.smallexample { font-size:smaller }
29  pre.smalllisp    { font-size:smaller }
30  span.sc    { font-variant:small-caps }
31  span.roman { font-family:serif; font-weight:normal; } 
32  span.sansserif { font-family:sans-serif; font-weight:normal; } 
33--></style>
34<link rel="stylesheet" type="text/css" href="../cs.css">
35</head>
36<body>
37<div class="node">
38<a name="nlmconv"></a>
39<p>
40Next:&nbsp;<a rel="next" accesskey="n" href="windmc.html#windmc">windmc</a>,
41Previous:&nbsp;<a rel="previous" accesskey="p" href="addr2line.html#addr2line">addr2line</a>,
42Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
43<hr>
44</div>
45
46<h2 class="chapter">11 nlmconv</h2>
47
48<p><samp><span class="command">nlmconv</span></samp> converts a relocatable object file into a NetWare
49Loadable Module.
50
51   <blockquote>
52<em>Warning:</em> <samp><span class="command">nlmconv</span></samp> is not always built as part of the binary
53utilities, since it is only useful for NLM targets. 
54</blockquote>
55
56<!-- man title nlmconv converts object code into an NLM. -->
57<pre class="smallexample">     <!-- man begin SYNOPSIS nlmconv -->
58     nlmconv [<samp><span class="option">-I</span></samp> <var>bfdname</var>|<samp><span class="option">--input-target=</span></samp><var>bfdname</var>]
59             [<samp><span class="option">-O</span></samp> <var>bfdname</var>|<samp><span class="option">--output-target=</span></samp><var>bfdname</var>]
60             [<samp><span class="option">-T</span></samp> <var>headerfile</var>|<samp><span class="option">--header-file=</span></samp><var>headerfile</var>]
61             [<samp><span class="option">-d</span></samp>|<samp><span class="option">--debug</span></samp>] [<samp><span class="option">-l</span></samp> <var>linker</var>|<samp><span class="option">--linker=</span></samp><var>linker</var>]
62             [<samp><span class="option">-h</span></samp>|<samp><span class="option">--help</span></samp>] [<samp><span class="option">-V</span></samp>|<samp><span class="option">--version</span></samp>]
63             <var>infile</var> <var>outfile</var>
64     <!-- man end -->
65</pre>
66   <!-- man begin DESCRIPTION nlmconv -->
67   <p><samp><span class="command">nlmconv</span></samp> converts the relocatable &lsquo;<samp><span class="samp">i386</span></samp>&rsquo; object file
68<var>infile</var> into the NetWare Loadable Module <var>outfile</var>, optionally
69reading <var>headerfile</var> for NLM header information.  For instructions
70on writing the NLM command file language used in header files, see the
71&lsquo;<samp><span class="samp">linkers</span></samp>&rsquo; section, &lsquo;<samp><span class="samp">NLMLINK</span></samp>&rsquo; in particular, of the <cite>NLM
72Development and Tools Overview</cite>, which is part of the NLM Software
73Developer's Kit (&ldquo;NLM SDK&rdquo;), available from Novell, Inc. 
74<samp><span class="command">nlmconv</span></samp> uses the <span class="sc">gnu</span> Binary File Descriptor library to read
75<var>infile</var>;
76see <a href="../ld/BFD.html#BFD">BFD</a>, for more information.
77
78   <p><samp><span class="command">nlmconv</span></samp> can perform a link step.  In other words, you can list
79more than one object file for input if you list them in the definitions
80file (rather than simply specifying one input file on the command line). 
81In this case, <samp><span class="command">nlmconv</span></samp> calls the linker for you.
82
83<!-- man end -->
84<!-- man begin OPTIONS nlmconv -->
85     <dl>
86<dt><samp><span class="env">-I </span><var>bfdname</var></samp><dt><samp><span class="env">--input-target=</span><var>bfdname</var></samp><dd>Object format of the input file.  <samp><span class="command">nlmconv</span></samp> can usually determine
87the format of a given file (so no default is necessary). 
88See <a href="Target-Selection.html#Target-Selection">Target Selection</a>, for more information.
89
90     <br><dt><samp><span class="env">-O </span><var>bfdname</var></samp><dt><samp><span class="env">--output-target=</span><var>bfdname</var></samp><dd>Object format of the output file.  <samp><span class="command">nlmconv</span></samp> infers the output
91format based on the input format, e.g. for a &lsquo;<samp><span class="samp">i386</span></samp>&rsquo; input file the
92output format is &lsquo;<samp><span class="samp">nlm32-i386</span></samp>&rsquo;. 
93See <a href="Target-Selection.html#Target-Selection">Target Selection</a>, for more information.
94
95     <br><dt><samp><span class="env">-T </span><var>headerfile</var></samp><dt><samp><span class="env">--header-file=</span><var>headerfile</var></samp><dd>Reads <var>headerfile</var> for NLM header information.  For instructions on
96writing the NLM command file language used in header files, see see the
97&lsquo;<samp><span class="samp">linkers</span></samp>&rsquo; section, of the <cite>NLM Development and Tools
98Overview</cite>, which is part of the NLM Software Developer's Kit, available
99from Novell, Inc.
100
101     <br><dt><samp><span class="env">-d</span></samp><dt><samp><span class="env">--debug</span></samp><dd>Displays (on standard error) the linker command line used by <samp><span class="command">nlmconv</span></samp>.
102
103     <br><dt><samp><span class="env">-l </span><var>linker</var></samp><dt><samp><span class="env">--linker=</span><var>linker</var></samp><dd>Use <var>linker</var> for any linking.  <var>linker</var> can be an absolute or a
104relative pathname.
105
106     <br><dt><samp><span class="env">-h</span></samp><dt><samp><span class="env">--help</span></samp><dd>Prints a usage summary.
107
108     <br><dt><samp><span class="env">-V</span></samp><dt><samp><span class="env">--version</span></samp><dd>Prints the version number for <samp><span class="command">nlmconv</span></samp>. 
109</dl>
110
111<!-- man end -->
112   </body></html>
113
114