Command-Line.html 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: Command Line</title>
  15. <meta name="description" content="Using as: Command Line">
  16. <meta name="keywords" content="Using as: Command Line">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="Overview.html#Overview" rel="up" title="Overview">
  25. <link href="Input-Files.html#Input-Files" rel="next" title="Input Files">
  26. <link href="Object-Formats.html#Object-Formats" rel="prev" title="Object Formats">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="Command-Line"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Input-Files.html#Input-Files" accesskey="n" rel="next">Input Files</a>, Previous: <a href="Object-Formats.html#Object-Formats" accesskey="p" rel="prev">Object Formats</a>, Up: <a href="Overview.html#Overview" accesskey="u" rel="up">Overview</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Command-Line-1"></a>
  64. <h3 class="section">1.4 Command Line</h3>
  65. <a name="index-command-line-conventions"></a>
  66. <p>After the program name <code>as</code>, the command line may contain
  67. options and file names. Options may appear in any order, and may be
  68. before, after, or between file names. The order of file names is
  69. significant.
  70. </p>
  71. <a name="index-standard-input_002c-as-input-file"></a>
  72. <a name="index-_002d_002d"></a>
  73. <p><samp>--</samp> (two hyphens) by itself names the standard input file
  74. explicitly, as one of the files for <code>as</code> to assemble.
  75. </p>
  76. <a name="index-options_002c-command-line"></a>
  77. <p>Except for &lsquo;<samp>--</samp>&rsquo; any command line argument that begins with a
  78. hyphen (&lsquo;<samp>-</samp>&rsquo;) is an option. Each option changes the behavior of
  79. <code>as</code>. No option changes the way another option works. An
  80. option is a &lsquo;<samp>-</samp>&rsquo; followed by one or more letters; the case of
  81. the letter is important. All options are optional.
  82. </p>
  83. <p>Some options expect exactly one file name to follow them. The file
  84. name may either immediately follow the option&rsquo;s letter (compatible
  85. with older assemblers) or it may be the next command argument (<small>GNU</small>
  86. standard). These two command lines are equivalent:
  87. </p>
  88. <div class="smallexample">
  89. <pre class="smallexample">as -o my-object-file.o mumble.s
  90. as -omy-object-file.o mumble.s
  91. </pre></div>
  92. </body>
  93. </html>