1 2 3 4as(1) 1992 as(1) 5 6 7NNAAMMEE 8 GNU as--the portable GNU assembler. 9 10 11SSYYNNOOPPSSIISS 12 aass [--aa|--aall|--aass] [--DD] [--ff] [--II _p_a_t_h] [--KK] [--LL] [--oo _o_b_j_f_i_l_e] 13 [--RR] [--vv] [--ww] [---- | _f_i_l_e_s...] 14 15 _i_9_6_0-_o_n_l_y _o_p_t_i_o_n_s: 16 [--AACCAA|--AACCAA__AA|--AACCBB|--AACCCC|--AAKKAA|--AAKKBB|--AAKKCC|--AAMMCC] [--bb] 17 [--nnoorreellaaxx] 18 19 _m_6_8_0_x_0-_o_n_l_y _o_p_t_i_o_n_s: 20 [--ll] [--mmcc6688000000|--mmcc6688001100|--mmcc6688002200] 21 22 23DDEESSCCRRIIPPTTIIOONN 24 GNU aass is really a family of assemblers. If you use (or 25 have used) the GNU assembler on one architecture, you 26 should find a fairly similar environment when you use it 27 on another architecture. Each version has much in common 28 with the others, including object file formats, most 29 assembler directives (often called _p_s_e_u_d_o-_o_p_s) and 30 assembler syntax. 31 32 For information on the syntax and pseudo-ops used by GNU 33 aass, see `aass' entry in iinnffoo (or the manual _U_s_i_n_g _a_s: _T_h_e 34 _G_N_U _A_s_s_e_m_b_l_e_r). 35 36 aass is primarily intended to assemble the output of the GNU 37 C compiler ggcccc for use by the linker lldd. Nevertheless, 38 we've tried to make aass assemble correctly everything that 39 the native assembler would. This doesn't mean aass always 40 uses the same syntax as another assembler for the same 41 architecture; for example, we know of several incompatible 42 versions of 680x0 assembly language syntax. 43 44 Each time you run aass it assembles exactly one source 45 program. The source program is made up of one or more 46 files. (The standard input is also a file.) 47 48 If aass is given no file names it attempts to read one input 49 file from the aass standard input, which is normally your 50 terminal. You may have to type ccttll--DD to tell aass there is 51 no more program to assemble. Use `----' if you need to 52 explicitly name the standard input file in your command 53 line. 54 55 aass may write warnings and error messages to the standard 56 error file (usually your terminal). This should not 57 happen when aass is run automatically by a compiler. 58 Warnings report an assumption made so that aass could keep 59 assembling a flawed program; errors report a grave problem 60 that stops the assembly. 61 62 63 64January 21 1 65 66 67 68 69 70as(1) 1992 as(1) 71 72 73OOPPTTIIOONNSS 74 --aa|--aall|--aass 75 Turn on assembly listings; `--aall', listing only, 76 `--aass', symbols only, `--aa', everything. 77 78 --DD This option is accepted only for script 79 compatibility with calls to other assemblers; it 80 has no effect on aass. 81 82 --ff ``fast''--skip preprocessing (assume source is 83 compiler output). 84 85 --II _p_a_t_h 86 Add _p_a_t_h to the search list for ..iinncclluuddee 87 directives. 88 89 --KK Issue warnings when difference tables altered for 90 long displacements. 91 92 --LL Keep (in symbol table) local symbols, starting with 93 `LL' 94 95 --oo _o_b_j_f_i_l_e 96 Name the object-file output from aass 97 98 --RR Fold data section into text section 99 100 --vv Announce aass version 101 102 --WW Suppress warning messages 103 104 -- | _f_i_l_e_s... 105 Source files to assemble, or standard input (----) 106 107 --AA_v_a_r (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Specify which 108 variant of the 960 architecture is the target. 109 110 --bb (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Add code to 111 collect statistics about branches taken. 112 113 --nnoorreellaaxx 114 (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _I_n_t_e_l _9_6_0.) Do not alter 115 compare-and-branch instructions for long 116 displacements; error if necessary. 117 118 --ll (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _M_o_t_o_r_o_l_a _6_8_0_0_0). 119 Shorten references to undefined symbols, to one 120 word instead of two. 121 122 --mmcc6688000000|--mmcc6688001100|--mmcc6688002200 123 (_W_h_e_n _c_o_n_f_i_g_u_r_e_d _f_o_r _M_o_t_o_r_o_l_a _6_8_0_0_0). 124 Specify what processor in the 68000 family is the 125 target (default 68020) 126 127 128 129 130January 21 2 131 132 133 134 135 136as(1) 1992 as(1) 137 138 139 Options may be in any order, and may be before, after, or 140 between file names. The order of file names is 141 significant. 142 143 `----' (two hyphens) by itself names the standard input file 144 explicitly, as one of the files for aass to assemble. 145 146 Except for `----' any command line argument that begins with 147 a hyphen (`--') is an option. Each option changes the 148 behavior of aass. No option changes the way another option 149 works. An option is a `--' followed by one or more 150 letters; the case of the letter is important. All 151 options are optional. 152 153 The `--oo' option expects exactly one file name to follow. 154 The file name may either immediately follow the option's 155 letter (compatible with older assemblers) or it may be the 156 next command argument (GNU standard). 157 158 These two command lines are equivalent: 159 aass --oo mmyy--oobbjjeecctt--ffiillee..oo mmuummbbllee..ss 160 aass --oommyy--oobbjjeecctt--ffiillee..oo mmuummbbllee..ss 161 162 163SSEEEE AALLSSOO 164 `aass' entry in iinnffoo; _U_s_i_n_g _a_s: _T_h_e _G_N_U _A_s_s_e_m_b_l_e_r; ggcccc(11), 165 lldd(11). 166 167 168CCOOPPYYIINNGG 169 Copyright (c) 1991, 1992 Free Software Foundation, Inc. 170 171 Permission is granted to make and distribute verbatim 172 copies of this manual provided the copyright notice and 173 this permission notice are preserved on all copies. 174 175 Permission is granted to copy and distribute modified 176 versions of this manual under the conditions for verbatim 177 copying, provided that the entire resulting derived work 178 is distributed under the terms of a permission notice 179 identical to this one. 180 181 Permission is granted to copy and distribute translations 182 of this manual into another language, under the above 183 conditions for modified versions, except that this 184 permission notice may be included in translations approved 185 by the Free Software Foundation instead of in the original 186 English. 187 188 189 190 191 192 193 194 195 196January 21 3 197 198 199