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