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