nlmconv.html 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1991-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3
  6. or any later version published by the Free Software Foundation;
  7. with no Invariant Sections, with no Front-Cover Texts, and with no
  8. Back-Cover Texts. A copy of the license is included in the
  9. section entitled "GNU Free Documentation License".
  10. -->
  11. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  12. <head>
  13. <title>GNU Binary Utilities: nlmconv</title>
  14. <meta name="description" content="GNU Binary Utilities: nlmconv">
  15. <meta name="keywords" content="GNU Binary Utilities: nlmconv">
  16. <meta name="resource-type" content="document">
  17. <meta name="distribution" content="global">
  18. <meta name="Generator" content="makeinfo">
  19. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  20. <link href="index.html#Top" rel="start" title="Top">
  21. <link href="Binutils-Index.html#Binutils-Index" rel="index" title="Binutils Index">
  22. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  23. <link href="index.html#Top" rel="up" title="Top">
  24. <link href="windmc.html#windmc" rel="next" title="windmc">
  25. <link href="addr2line.html#addr2line" rel="prev" title="addr2line">
  26. <style type="text/css">
  27. <!--
  28. a.summary-letter {text-decoration: none}
  29. blockquote.smallquotation {font-size: smaller}
  30. div.display {margin-left: 3.2em}
  31. div.example {margin-left: 3.2em}
  32. div.indentedblock {margin-left: 3.2em}
  33. div.lisp {margin-left: 3.2em}
  34. div.smalldisplay {margin-left: 3.2em}
  35. div.smallexample {margin-left: 3.2em}
  36. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  37. div.smalllisp {margin-left: 3.2em}
  38. kbd {font-style:oblique}
  39. pre.display {font-family: inherit}
  40. pre.format {font-family: inherit}
  41. pre.menu-comment {font-family: serif}
  42. pre.menu-preformatted {font-family: serif}
  43. pre.smalldisplay {font-family: inherit; font-size: smaller}
  44. pre.smallexample {font-size: smaller}
  45. pre.smallformat {font-family: inherit; font-size: smaller}
  46. pre.smalllisp {font-size: smaller}
  47. span.nocodebreak {white-space:nowrap}
  48. span.nolinebreak {white-space:nowrap}
  49. span.roman {font-family:serif; font-weight:normal}
  50. span.sansserif {font-family:sans-serif; font-weight:normal}
  51. ul.no-bullet {list-style: none}
  52. -->
  53. </style>
  54. </head>
  55. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  56. <a name="nlmconv"></a>
  57. <div class="header">
  58. <p>
  59. Next: <a href="windmc.html#windmc" accesskey="n" rel="next">windmc</a>, Previous: <a href="addr2line.html#addr2line" accesskey="p" rel="prev">addr2line</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Binutils-Index.html#Binutils-Index" title="Index" rel="index">Index</a>]</p>
  60. </div>
  61. <hr>
  62. <a name="nlmconv-1"></a>
  63. <h2 class="chapter">11 nlmconv</h2>
  64. <p><code>nlmconv</code> converts a relocatable object file into a NetWare
  65. Loadable Module.
  66. </p>
  67. <blockquote>
  68. <p><em>Warning:</em> <code>nlmconv</code> is not always built as part of the binary
  69. utilities, since it is only useful for NLM targets.
  70. </p></blockquote>
  71. <div class="smallexample">
  72. <pre class="smallexample">nlmconv [<samp>-I</samp> <var>bfdname</var>|<samp>--input-target=</samp><var>bfdname</var>]
  73. [<samp>-O</samp> <var>bfdname</var>|<samp>--output-target=</samp><var>bfdname</var>]
  74. [<samp>-T</samp> <var>headerfile</var>|<samp>--header-file=</samp><var>headerfile</var>]
  75. [<samp>-d</samp>|<samp>--debug</samp>] [<samp>-l</samp> <var>linker</var>|<samp>--linker=</samp><var>linker</var>]
  76. [<samp>-h</samp>|<samp>--help</samp>] [<samp>-V</samp>|<samp>--version</samp>]
  77. <var>infile</var> <var>outfile</var>
  78. </pre></div>
  79. <p><code>nlmconv</code> converts the relocatable &lsquo;<samp>i386</samp>&rsquo; object file
  80. <var>infile</var> into the NetWare Loadable Module <var>outfile</var>, optionally
  81. reading <var>headerfile</var> for NLM header information. For instructions
  82. on writing the NLM command file language used in header files, see the
  83. &lsquo;<samp>linkers</samp>&rsquo; section, &lsquo;<samp>NLMLINK</samp>&rsquo; in particular, of the <cite>NLM
  84. Development and Tools Overview</cite>, which is part of the NLM Software
  85. Developer&rsquo;s Kit (&ldquo;NLM SDK&rdquo;), available from Novell, Inc.
  86. <code>nlmconv</code> uses the <small>GNU</small> Binary File Descriptor library to read
  87. <var>infile</var>;
  88. see <a href="http://sourceware.org/binutils/docs/ld/BFD.html#BFD">BFD</a> in <cite>Using LD</cite>, for more information.
  89. </p>
  90. <p><code>nlmconv</code> can perform a link step. In other words, you can list
  91. more than one object file for input if you list them in the definitions
  92. file (rather than simply specifying one input file on the command line).
  93. In this case, <code>nlmconv</code> calls the linker for you.
  94. </p>
  95. <dl compact="compact">
  96. <dt><code>-I <var>bfdname</var></code></dt>
  97. <dt><code>--input-target=<var>bfdname</var></code></dt>
  98. <dd><p>Object format of the input file. <code>nlmconv</code> can usually determine
  99. the format of a given file (so no default is necessary).
  100. See <a href="Target-Selection.html#Target-Selection">Target Selection</a>, for more information.
  101. </p>
  102. </dd>
  103. <dt><code>-O <var>bfdname</var></code></dt>
  104. <dt><code>--output-target=<var>bfdname</var></code></dt>
  105. <dd><p>Object format of the output file. <code>nlmconv</code> infers the output
  106. format based on the input format, e.g. for a &lsquo;<samp>i386</samp>&rsquo; input file the
  107. output format is &lsquo;<samp>nlm32-i386</samp>&rsquo;.
  108. See <a href="Target-Selection.html#Target-Selection">Target Selection</a>, for more information.
  109. </p>
  110. </dd>
  111. <dt><code>-T <var>headerfile</var></code></dt>
  112. <dt><code>--header-file=<var>headerfile</var></code></dt>
  113. <dd><p>Reads <var>headerfile</var> for NLM header information. For instructions on
  114. writing the NLM command file language used in header files, see&nbsp;see the
  115. &lsquo;<samp>linkers</samp>&rsquo; section, of the <cite>NLM Development and Tools
  116. Overview</cite>, which is part of the NLM Software Developer&rsquo;s Kit, available
  117. from Novell, Inc.
  118. </p>
  119. </dd>
  120. <dt><code>-d</code></dt>
  121. <dt><code>--debug</code></dt>
  122. <dd><p>Displays (on standard error) the linker command line used by <code>nlmconv</code>.
  123. </p>
  124. </dd>
  125. <dt><code>-l <var>linker</var></code></dt>
  126. <dt><code>--linker=<var>linker</var></code></dt>
  127. <dd><p>Use <var>linker</var> for any linking. <var>linker</var> can be an absolute or a
  128. relative pathname.
  129. </p>
  130. </dd>
  131. <dt><code>-h</code></dt>
  132. <dt><code>--help</code></dt>
  133. <dd><p>Prints a usage summary.
  134. </p>
  135. </dd>
  136. <dt><code>-V</code></dt>
  137. <dt><code>--version</code></dt>
  138. <dd><p>Prints the version number for <code>nlmconv</code>.
  139. </p></dd>
  140. </dl>
  141. <hr>
  142. <div class="header">
  143. <p>
  144. Next: <a href="windmc.html#windmc" accesskey="n" rel="next">windmc</a>, Previous: <a href="addr2line.html#addr2line" accesskey="p" rel="prev">addr2line</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Binutils-Index.html#Binutils-Index" title="Index" rel="index">Index</a>]</p>
  145. </div>
  146. </body>
  147. </html>