visus
/
toolchain-gcc-arm-embedded

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2020 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 the
Invariant Sections being "Funding Free Software", the Front-Cover
Texts being (a) (see below), and with the Back-Cover Texts being (b)
(see below).  A copy of the license is included in the section entitled
"GNU Free Documentation License".

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU
     software.  Copies published by the Free Software Foundation raise
     funds for GNU development. -->
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>PRU Options (Using the GNU Compiler Collection (GCC))</title>

<meta name="description" content="PRU Options (Using the GNU Compiler Collection (GCC))">
<meta name="keywords" content="PRU Options (Using the GNU Compiler Collection (GCC))">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Submodel-Options.html#Submodel-Options" rel="up" title="Submodel Options">
<link href="RISC_002dV-Options.html#RISC_002dV-Options" rel="next" title="RISC-V Options">
<link href="PowerPC-Options.html#PowerPC-Options" rel="prev" title="PowerPC Options">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
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.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="PRU-Options"></a>
<div class="header">
<p>
Next: <a href="RISC_002dV-Options.html#RISC_002dV-Options" accesskey="n" rel="next">RISC-V Options</a>, Previous: <a href="PowerPC-Options.html#PowerPC-Options" accesskey="p" rel="prev">PowerPC Options</a>, Up: <a href="Submodel-Options.html#Submodel-Options" accesskey="u" rel="up">Submodel Options</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="PRU-Options-1"></a>
<h4 class="subsection">3.19.41 PRU Options</h4>
<a name="index-PRU-Options"></a>

<p>These command-line options are defined for PRU target:
</p>
<dl compact="compact">
<dt><code>-minrt</code></dt>
<dd><a name="index-minrt-1"></a>
<p>Link with a minimum runtime environment, with no support for static
initializers and constructors.  Using this option can significantly reduce
the size of the final ELF binary.  Beware that the compiler could still
generate code with static initializers and constructors.  It is up to the
programmer to ensure that the source program will not use those features.
</p>
</dd>
<dt><code>-mmcu=<var>mcu</var></code></dt>
<dd><a name="index-mmcu-2"></a>
<p>Specify the PRU MCU variant to use.  Check Newlib for the exact list of
supported MCUs.
</p>
</dd>
<dt><code>-mno-relax</code></dt>
<dd><a name="index-mno_002drelax"></a>
<p>Make GCC pass the <samp>--no-relax</samp> command-line option to the linker
instead of the <samp>--relax</samp> option.
</p>
</dd>
<dt><code>-mloop</code></dt>
<dd><a name="index-mloop"></a>
<p>Allow (or do not allow) GCC to use the LOOP instruction.
</p>
</dd>
<dt><code>-mabi=<var>variant</var></code></dt>
<dd><a name="index-mabi-2"></a>
<p>Specify the ABI variant to output code for.  <samp>-mabi=ti</samp> selects the
unmodified TI ABI while <samp>-mabi=gnu</samp> selects a GNU variant that copes
more naturally with certain GCC assumptions.  These are the differences:
</p>
<dl compact="compact">
<dt>&lsquo;<samp>Function Pointer Size</samp>&rsquo;</dt>
<dd><p>TI ABI specifies that function (code) pointers are 16-bit, whereas GNU
supports only 32-bit data and code pointers.
</p>
</dd>
<dt>&lsquo;<samp>Optional Return Value Pointer</samp>&rsquo;</dt>
<dd><p>Function return values larger than 64 bits are passed by using a hidden
pointer as the first argument of the function.  TI ABI, though, mandates that
the pointer can be NULL in case the caller is not using the returned value.
GNU always passes and expects a valid return value pointer.
</p>
</dd>
</dl>

<p>The current <samp>-mabi=ti</samp> implementation simply raises a compile error
when any of the above code constructs is detected.  As a consequence
the standard C library cannot be built and it is omitted when linking with
<samp>-mabi=ti</samp>.
</p>
<p>Relaxation is a GNU feature and for safety reasons is disabled when using
<samp>-mabi=ti</samp>.  The TI toolchain does not emit relocations for QBBx
instructions, so the GNU linker cannot adjust them when shortening adjacent
LDI32 pseudo instructions.
</p>
</dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="RISC_002dV-Options.html#RISC_002dV-Options" accesskey="n" rel="next">RISC-V Options</a>, Previous: <a href="PowerPC-Options.html#PowerPC-Options" accesskey="p" rel="prev">PowerPC Options</a>, Up: <a href="Submodel-Options.html#Submodel-Options" accesskey="u" rel="up">Submodel Options</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>


</body>
</html>