aarch64-linux-gnu-5.1/share/doc/as.html/Align.html - toolchains/linux-x86/gcc - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <!-- This file documents the GNU Assembler "as".

 Copyright (C) 1991-2015 Free Software Foundation, Inc.

 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3
 or any later version published by the Free Software Foundation;
 with no Invariant Sections, with no Front-Cover Texts, and with no
 Back-Cover Texts.  A copy of the license is included in the
 section entitled "GNU Free Documentation License".
  -->
 <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
 <head>
 <title>Using as: Align</title>

 <meta name="description" content="Using as: Align">
 <meta name="keywords" content="Using as: Align">
 <meta name="resource-type" content="document">
 <meta name="distribution" content="global">
 <meta name="Generator" content="makeinfo">
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <link href="index.html#Top" rel="start" title="Top">
 <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
 <link href="Pseudo-Ops.html#Pseudo-Ops" rel="up" title="Pseudo Ops">
 <link href="Altmacro.html#Altmacro" rel="next" title="Altmacro">
 <link href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" rel="prev" title="ABORT (COFF)">
 <style type="text/css">
 <!--
 a.summary-letter {text-decoration: none}
 blockquote.smallquotation {font-size: smaller}
 div.display {margin-left: 3.2em}
 div.example {margin-left: 3.2em}
 div.indentedblock {margin-left: 3.2em}
 div.lisp {margin-left: 3.2em}
 div.smalldisplay {margin-left: 3.2em}
 div.smallexample {margin-left: 3.2em}
 div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
 div.smalllisp {margin-left: 3.2em}
 kbd {font-style:oblique}
 pre.display {font-family: inherit}
 pre.format {font-family: inherit}
 pre.menu-comment {font-family: serif}
 pre.menu-preformatted {font-family: serif}
 pre.smalldisplay {font-family: inherit; font-size: smaller}
 pre.smallexample {font-size: smaller}
 pre.smallformat {font-family: inherit; font-size: smaller}
 pre.smalllisp {font-size: smaller}
 span.nocodebreak {white-space:nowrap}
 span.nolinebreak {white-space:nowrap}
 span.roman {font-family:serif; font-weight:normal}
 span.sansserif {font-family:sans-serif; font-weight:normal}
 ul.no-bullet {list-style: none}
 -->
 </style>


 </head>

 <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
 <a name="Align"></a>
 <div class="header">
 <p>
 Next: <a href="Altmacro.html#Altmacro" accesskey="n" rel="next">Altmacro</a>, Previous: <a href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" accesskey="p" rel="prev">ABORT (COFF)</a>, Up: <a href="Pseudo-Ops.html#Pseudo-Ops" accesskey="u" rel="up">Pseudo Ops</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>
 </div>
 <hr>
 <a name="g_t_002ealign-abs_002dexpr_002c-abs_002dexpr_002c-abs_002dexpr"></a>
 <h3 class="section">7.3 <code>.align <var>abs-expr</var>, <var>abs-expr</var>, <var>abs-expr</var></code></h3>

 <a name="index-padding-the-location-counter"></a>
 <a name="index-align-directive"></a>
 <p>Pad the location counter (in the current subsection) to a particular storage
 boundary.  The first expression (which must be absolute) is the alignment
 required, as described below.
 </p>
 <p>The second expression (also absolute) gives the fill value to be stored in the
 padding bytes.  It (and the comma) may be omitted.  If it is omitted, the
 padding bytes are normally zero.  However, on some systems, if the section is
 marked as containing code and the fill value is omitted, the space is filled
 with no-op instructions.
 </p>
 <p>The third expression is also absolute, and is also optional.  If it is present,
 it is the maximum number of bytes that should be skipped by this alignment
 directive.  If doing the alignment would require skipping more bytes than the
 specified maximum, then the alignment is not done at all.  You can omit the
 fill value (the second argument) entirely by simply using two commas after the
 required alignment; this can be useful if you want the alignment to be filled
 with no-op instructions when appropriate.
 </p>
 <p>The way the required alignment is specified varies from system to system.
 For the arc, hppa, i386 using ELF, i860, iq2000, m68k, or1k,
 s390, sparc, tic4x, tic80 and xtensa, the first expression is the
 alignment request in bytes.  For example &lsquo;<samp>.align 8</samp>&rsquo; advances
 the location counter until it is a multiple of 8.  If the location counter
 is already a multiple of 8, no change is needed.  For the tic54x, the
 first expression is the alignment request in words.
 </p>
 <p>For other systems, including ppc, i386 using a.out format, arm and
 strongarm, it is the
 number of low-order zero bits the location counter must have after
 advancement.  For example &lsquo;<samp>.align 3</samp>&rsquo; advances the location
 counter until it a multiple of 8.  If the location counter is already a
 multiple of 8, no change is needed.
 </p>
 <p>This inconsistency is due to the different behaviors of the various
 native assemblers for these systems which GAS must emulate.
 GAS also provides <code>.balign</code> and <code>.p2align</code> directives,
 described later, which have a consistent behavior across all
 architectures (but are specific to GAS).
 </p>
 <hr>
 <div class="header">
 <p>
 Next: <a href="Altmacro.html#Altmacro" accesskey="n" rel="next">Altmacro</a>, Previous: <a href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" accesskey="p" rel="prev">ABORT (COFF)</a>, Up: <a href="Pseudo-Ops.html#Pseudo-Ops" accesskey="u" rel="up">Pseudo Ops</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>
 </div>


 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<!-- This file documents the GNU Assembler "as".

	Copyright (C) 1991-2015 Free Software Foundation, Inc.

	Permission is granted to copy, distribute and/or modify this document
	under the terms of the GNU Free Documentation License, Version 1.3
	or any later version published by the Free Software Foundation;
	with no Invariant Sections, with no Front-Cover Texts, and with no
	Back-Cover Texts. A copy of the license is included in the
	section entitled "GNU Free Documentation License".
	-->
	<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
	<head>
	<title>Using as: Align</title>

	<meta name="description" content="Using as: Align">
	<meta name="keywords" content="Using as: Align">
	<meta name="resource-type" content="document">
	<meta name="distribution" content="global">
	<meta name="Generator" content="makeinfo">
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
	<link href="index.html#Top" rel="start" title="Top">
	<link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
	<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
	<link href="Pseudo-Ops.html#Pseudo-Ops" rel="up" title="Pseudo Ops">
	<link href="Altmacro.html#Altmacro" rel="next" title="Altmacro">
	<link href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" rel="prev" title="ABORT (COFF)">
	<style type="text/css">
	<!--
	a.summary-letter {text-decoration: none}
	blockquote.smallquotation {font-size: smaller}
	div.display {margin-left: 3.2em}
	div.example {margin-left: 3.2em}
	div.indentedblock {margin-left: 3.2em}
	div.lisp {margin-left: 3.2em}
	div.smalldisplay {margin-left: 3.2em}
	div.smallexample {margin-left: 3.2em}
	div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
	div.smalllisp {margin-left: 3.2em}
	kbd {font-style:oblique}
	pre.display {font-family: inherit}
	pre.format {font-family: inherit}
	pre.menu-comment {font-family: serif}
	pre.menu-preformatted {font-family: serif}
	pre.smalldisplay {font-family: inherit; font-size: smaller}
	pre.smallexample {font-size: smaller}
	pre.smallformat {font-family: inherit; font-size: smaller}
	pre.smalllisp {font-size: smaller}
	span.nocodebreak {white-space:nowrap}
	span.nolinebreak {white-space:nowrap}
	span.roman {font-family:serif; font-weight:normal}
	span.sansserif {font-family:sans-serif; font-weight:normal}
	ul.no-bullet {list-style: none}
	-->
	</style>


	</head>

	<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
	<a name="Align"></a>
	<div class="header">
	<p>
	Next: <a href="Altmacro.html#Altmacro" accesskey="n" rel="next">Altmacro</a>, Previous: <a href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" accesskey="p" rel="prev">ABORT (COFF)</a>, Up: <a href="Pseudo-Ops.html#Pseudo-Ops" accesskey="u" rel="up">Pseudo Ops</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>
	</div>
	<hr>
	<a name="g_t_002ealign-abs_002dexpr_002c-abs_002dexpr_002c-abs_002dexpr"></a>
	<h3 class="section">7.3 <code>.align <var>abs-expr</var>, <var>abs-expr</var>, <var>abs-expr</var></code></h3>

	<a name="index-padding-the-location-counter"></a>
	<a name="index-align-directive"></a>
	<p>Pad the location counter (in the current subsection) to a particular storage
	boundary. The first expression (which must be absolute) is the alignment
	required, as described below.
	</p>
	<p>The second expression (also absolute) gives the fill value to be stored in the
	padding bytes. It (and the comma) may be omitted. If it is omitted, the
	padding bytes are normally zero. However, on some systems, if the section is
	marked as containing code and the fill value is omitted, the space is filled
	with no-op instructions.
	</p>
	<p>The third expression is also absolute, and is also optional. If it is present,
	it is the maximum number of bytes that should be skipped by this alignment
	directive. If doing the alignment would require skipping more bytes than the
	specified maximum, then the alignment is not done at all. You can omit the
	fill value (the second argument) entirely by simply using two commas after the
	required alignment; this can be useful if you want the alignment to be filled
	with no-op instructions when appropriate.
	</p>
	<p>The way the required alignment is specified varies from system to system.
	For the arc, hppa, i386 using ELF, i860, iq2000, m68k, or1k,
	s390, sparc, tic4x, tic80 and xtensa, the first expression is the
	alignment request in bytes. For example ‘<samp>.align 8</samp>’ advances
	the location counter until it is a multiple of 8. If the location counter
	is already a multiple of 8, no change is needed. For the tic54x, the
	first expression is the alignment request in words.
	</p>
	<p>For other systems, including ppc, i386 using a.out format, arm and
	strongarm, it is the
	number of low-order zero bits the location counter must have after
	advancement. For example ‘<samp>.align 3</samp>’ advances the location
	counter until it a multiple of 8. If the location counter is already a
	multiple of 8, no change is needed.
	</p>
	<p>This inconsistency is due to the different behaviors of the various
	native assemblers for these systems which GAS must emulate.
	GAS also provides <code>.balign</code> and <code>.p2align</code> directives,
	described later, which have a consistent behavior across all
	architectures (but are specific to GAS).
	</p>
	<hr>
	<div class="header">
	<p>
	Next: <a href="Altmacro.html#Altmacro" accesskey="n" rel="next">Altmacro</a>, Previous: <a href="ABORT-_0028COFF_0029.html#ABORT-_0028COFF_0029" accesskey="p" rel="prev">ABORT (COFF)</a>, Up: <a href="Pseudo-Ops.html#Pseudo-Ops" accesskey="u" rel="up">Pseudo Ops</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>
	</div>



	</body>
	</html>