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: MSP430 Directives</title> 17 18<meta name="description" content="Using as: MSP430 Directives"> 19<meta name="keywords" content="Using as: MSP430 Directives"> 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="MSP430_002dDependent.html#MSP430_002dDependent" rel="up" title="MSP430-Dependent"> 28<link href="MSP430-Opcodes.html#MSP430-Opcodes" rel="next" title="MSP430 Opcodes"> 29<link href="MSP430-Floating-Point.html#MSP430-Floating-Point" rel="previous" title="MSP430 Floating Point"> 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="MSP430-Directives"></a> 64<div class="header"> 65<p> 66Next: <a href="MSP430-Opcodes.html#MSP430-Opcodes" accesskey="n" rel="next">MSP430 Opcodes</a>, Previous: <a href="MSP430-Floating-Point.html#MSP430-Floating-Point" accesskey="p" rel="previous">MSP430 Floating Point</a>, Up: <a href="MSP430_002dDependent.html#MSP430_002dDependent" accesskey="u" rel="up">MSP430-Dependent</a> [<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="MSP-430-Machine-Directives"></a> 70<h4 class="subsection">9.29.4 MSP 430 Machine Directives</h4> 71 72<a name="index-machine-directives_002c-MSP-430"></a> 73<a name="index-MSP-430-machine-directives"></a> 74<dl compact="compact"> 75<dd><a name="index-file-directive_002c-MSP-430"></a> 76</dd> 77<dt><code>.file</code></dt> 78<dd><p>This directive is ignored; it is accepted for compatibility with other 79MSP 430 assemblers. 80</p> 81<blockquote> 82<p><em>Warning:</em> in other versions of the <small>GNU</small> assembler, <code>.file</code> is 83used for the directive called <code>.app-file</code> in the MSP 430 support. 84</p></blockquote> 85 86<a name="index-line-directive_002c-MSP-430"></a> 87</dd> 88<dt><code>.line</code></dt> 89<dd><p>This directive is ignored; it is accepted for compatibility with other 90MSP 430 assemblers. 91</p> 92<a name="index-arch-directive_002c-MSP-430"></a> 93</dd> 94<dt><code>.arch</code></dt> 95<dd><p>Sets the target microcontroller in the same way as the <samp>-mmcu</samp> 96command-line option. 97</p> 98<a name="index-cpu-directive_002c-MSP-430"></a> 99</dd> 100<dt><code>.cpu</code></dt> 101<dd><p>Sets the target architecture in the same way as the <samp>-mcpu</samp> 102command-line option. 103</p> 104<a name="index-profiler-directive_002c-MSP-430"></a> 105</dd> 106<dt><code>.profiler</code></dt> 107<dd><p>This directive instructs assembler to add new profile entry to the object file. 108</p> 109<a name="index-refsym-directive_002c-MSP-430"></a> 110</dd> 111<dt><code>.refsym</code></dt> 112<dd><p>This directive instructs assembler to add an undefined reference to 113the symbol following the directive. The maximum symbol name length is 1141023 characters. No relocation is created for this symbol; it will 115exist purely for pulling in object files from archives. Note that 116this reloc is not sufficient to prevent garbage collection; use a 117KEEP() directive in the linker file to preserve such objects. 118</p> 119<a name="index-mspabi_005fattribute-directive_002c-MSP430"></a> 120</dd> 121<dt><code>.mspabi_attribute</code></dt> 122<dd><p>This directive tells the assembler what the MSPABI build attributes for this 123file are. This is used for validating the command line options passed to 124the assembler against the options the original source file was compiled with. 125The expected format is: 126‘<samp>.mspabi_attribute tag_name, tag_value</samp>’ 127For example, to set the tag <code>OFBA_MSPABI_Tag_ISA</code> to <code>MSP430X</code>: 128‘<samp>.mspabi_attribute 4, 2</samp>’ 129</p> 130<p>See the <cite>MSP430 EABI, document slaa534</cite> for the details on tag names and 131values. 132</p></dd> 133</dl> 134 135<hr> 136<div class="header"> 137<p> 138Next: <a href="MSP430-Opcodes.html#MSP430-Opcodes" accesskey="n" rel="next">MSP430 Opcodes</a>, Previous: <a href="MSP430-Floating-Point.html#MSP430-Floating-Point" accesskey="p" rel="previous">MSP430 Floating Point</a>, Up: <a href="MSP430_002dDependent.html#MSP430_002dDependent" accesskey="u" rel="up">MSP430-Dependent</a> [<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> 139</div> 140 141 142 143</body> 144</html> 145