.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "GCC 1"
.TH GCC 1 2026-08-07 gcc-16.2.0 GNU
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
gcc \- کامپایلر C و ++C پروژه گنو
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gcc [\fB\-c\fR|\fB\-S\fR|\fB\-E\fR] [\fB\-std=\fR\fIstandard\fR]
    [\fB\-g\fR] [\fB\-pg\fR] [\fB\-O\fR\fIlevel\fR]
    [\fB\-W\fR\fIwarn\fR...] [\fB\-Wpedantic\fR]
    [\fB\-I\fR\fIdir\fR...] [\fB\-L\fR\fIdir\fR...]
    [\fB\-D\fR\fImacro\fR[=\fIdefn\fR]...] [\fB\-U\fR\fImacro\fR]
    [\fB\-f\fR\fIoption\fR...] [\fB\-m\fR\fImachine\-option\fR...]
    [\fB\-o\fR \fIoutfile\fR] [@\fIfile\fR] \fIinfile\fR...
.PP
در اینجا تنها کاربردی‌ترین گزینه‌ها فهرست شده‌اند؛ برای سایر موارد به ادامه متن مراجعه کنید. \fBg++\fR بیشتر همان گزینه‌های \fBgcc\fR را می‌پذیرد.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
هنگامی که GCC را فراخوانی می‌کنید، معمولاً مراحل پیش‌پردازش، کامپایل، اسمبل و پیوندزدن (linking) را انجام می‌دهد. «گزینه‌های کلی» به شما این امکان را می‌دهند که این فرآیند را در یک مرحله میانی متوقف کنید. برای نمونه، گزینه \fB\-c\fR مشخص می‌کند که پیوندزن (linker) اجرا نشود. در این حالت خروجی شامل فایل‌های شیء (object files) حاصل از اسمبلر خواهد بود.
.PP
سایر گزینه‌ها به یک یا چند مرحله پردازش ارسال می‌شوند. برخی گزینه‌ها پیش‌پردازنده و برخی دیگر خود کامپایلر را کنترل می‌کنند. گزینه‌های دیگری نیز اسمبلر و پیوندزن را کنترل می‌کنند؛ بیشتر این موارد در اینجا مستند نشده‌اند، چرا که به ندرت به استفاده از آن‌ها نیاز پیدا خواهید کرد.
.PP
بیشتر گزینه‌های خط فرمانی که می‌توانید با GCC استفاده کنید برای برنامه‌های C کاربرد دارند؛ هنگامی که یک گزینه تنها برای زبان دیگری (معمولاً ++C) مفید باشد، در توضیحات صراحتاً به آن اشاره شده است. اگر در توضیحات یک گزینه خاص به زبان مبدأ اشاره‌ای نشده باشد، می‌توانید آن گزینه را برای تمام زبان‌های پشتیبانی‌شده به کار ببرید.
.PP
روش معمول برای اجرای GCC، اجرای فایل اجرایی با نام \fBgcc\fR، یا \&\fImachine\fR\fB\-gcc\fR هنگام کامپایل متقاطع (cross-compiling)، یا \&\fImachine\fR\fB\-gcc\-\fR\fIversion\fR برای اجرای یک نگارش مشخص از GCC است. هنگامی که برنامه‌های ++C را کامپایل می‌کنید، باید به جای آن GCC را به صورت \fBg++\fR فراخوانی کنید.
.PP
برنامه \fBgcc\fR گزینه‌ها و نام‌های فایل را به عنوان عملوند می‌پذیرد. بسیاری از گزینه‌ها نام‌های چندحرفی دارند؛ بنابراین چندین گزینه تک‌حرفی ممکن است قابل ادغام با یکدیگر \fIنباشند\fR: گزینه \fB\-dv\fR با \fB\-d\ \-v\fR بسیار متفاوت است.
.PP
می‌توانید گزینه‌ها و سایر آرگومان‌ها را با هم ترکیب کنید. در بیشتر موارد، ترتیبی که استفاده می‌کنید اهمیتی ندارد. ترتیب زمانی اهمیت پیدا می‌کند که از چندین گزینه هم‌نوع استفاده کنید؛ برای مثال، اگر \fB\-L\fR را بیش از یک بار مشخص کنید، دایرکتوری‌ها به همان ترتیبی که تعیین شده‌اند جستجو می‌شوند. همچنین، محل قرارگیری گزینه \fB\-l\fR مهم و تأثیرگذار است.
.PP
بسیاری از گزینه‌ها نام‌های بلندی دارند که با \fB\-f\fR یا با \&\fB\-W\fR آغاز می‌شوند؛ برای نمونه، \&\fB\-fmove\-loop\-invariants\fR، \fB\-Wformat\fR و مواردی از این دست. بیشتر این گزینه‌ها هم فرم مثبت دارند و هم منفی؛ فرم منفیِ \&\fB\-ffoo\fR به صورت \fB\-fno\-foo\fR است. این راهنما تنها یکی از این دو فرم را مستند می‌کند، یعنی هر کدام را که حالت پیش‌فرض نباشد.
.PP
برخی گزینه‌ها یک یا چند آرگومان می‌گیرند که معمولاً با یک فاصله یا با علامت مساوی (\fB=\fR) از نام گزینه جدا می‌شوند. مگر اینکه طور دیگری ذکر شده باشد، یک آرگومان می‌تواند عددی یا یک رشته باشد. آرگومان‌های عددی معمولاً باید اعداد صحیح ده‌دهی یا هگزادسیمال بدون علامت و کوچک باشند. آرگومان‌های هگزادسیمال باید با پیشوند \fB0x\fR آغاز شوند. آرگومان‌های مربوط به گزینه‌هایی که نوعی آستانه اندازه را مشخص می‌کنند، می‌توانند اعداد صحیح ده‌دهی یا هگزادسیمال به هر اندازه بزرگی باشند که پسوندی برای اندازه بایت به دنبال آن‌ها می‌آید و مضربی از بایت‌ها را نشان می‌دهد؛ مانند \f(CW\*(C`kB\*(C'\fR و \f(CW\*(C`KiB\*(C'\fR به ترتیب برای کیلوبایت و کیبی‌بایت، \&\f(CW\*(C`MB\*(C'\fR و \f(CW\*(C`MiB\*(C'\fR برای مگابایت و مبی‌بایت، \f(CW\*(C`GB\*(C'\fR و \&\f(CW\*(C`GiB\*(C'\fR برای گیگابایت و گیبی‌بایت و به همین ترتیب. این آرگومان‌ها در ادامه متن با \fIbyte\-size\fR مشخص شده‌اند. برای فهرست کامل و شرح پیشوندهای ده‌دهی و دودویی اندازه بایت، به استانداردهای NIST، IEC و سایر استانداردهای ملی و بین‌المللی مرتبط مراجعه کنید..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.SS "خلاصه گزینه‌ها (Option Summary)"
.IX Subsection "Option Summary"
در اینجا خلاصه‌ای از تمام گزینه‌ها، دسته‌بندی‌شده بر پایه نوع آمده است. توضیحات مربوطه در بخش‌های بعدی ارائه شده‌اند.
.IP "\fIگزینه‌های کلی (Overall Options)\fR" 4
.IX Item "Overall Options"
\&\fB\-c  \-S  \-E  \-o\fR \fIfile\fR
\&\fB\-dumpbase\fR \fIdumpbase\fR  \fB\-dumpbase\-ext\fR \fIauxdropsuf\fR
\&\fB\-dumpdir\fR \fIdumppfx\fR  \fB\-x\fR \fIlanguage\fR
\&\fB\-v  \-###  \-\-help\fR[\fB=\fR\fIclass\fR[\fB,...\fR]]  \fB\-\-target\-help  \-\-version
\&\-pass\-exit\-codes  \-pipe  \-wrapper
@\fR\fIfile\fR  \fB\-ffile\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR  \fB\-fcanon\-prefix\-map
\&\-fplugin=\fR\fIfile\fR  \fB\-fplugin\-arg\-\fR\fIname\fR\fB=\fR\fIarg\fR
\&\fB\-fdump\-ada\-spec\fR[\fB\-slim\fR]  \fB\-fada\-spec\-parent=\fR\fIunit\fR
\&\fB\-fdump\-go\-spec=\fR\fIfile\fR
\&\fB\-\-assemble  \-\-compile  \-\-dumpbase\fR \fIdumpbase\fR
\&\fB\-\-dumpbase\-ext\fR \fIauxdropsuf\fR  \fB\-\-dumpdir\fR \fIdumppfx\fR
\&\fB\-\-language=\fR\fIlanguage\fR  \fB\-\-output=\fR\fIfile\fR  \fB\-\-pass\-exit\-codes
\&\-\-pipe  \-\-preprocess  \-\-verbose\fR
.IP "\fIگزینه‌های زبان C (C Language Options)\fR" 4
.IX Item "C Language Options"
\&\fB\-ansi  \-std=\fR\fIstandard\fR  \fB\-aux\-info\fR \fIfilename\fR
\&\fB\-fno\-asm
\&\-fno\-builtin  \-fno\-builtin\-\fR\fIfunction\fR  \fB\-fcond\-mismatch
\&\-ffreestanding  \-fgimple  \-fgnu\-tm  \-fgnu89\-inline  \-fhosted
\&\-flax\-vector\-conversions  \-fms\-extensions
\&\-fpermitted\-flt\-eval\-methods=\fR\fIstandard\fR
\&\fB\-fplan9\-extensions  \-fsigned\-bitfields  \-funsigned\-bitfields
\&\-fsigned\-char  \-funsigned\-char  \-fstrict\-flex\-arrays[=\fR\fIn\fR\fB]
\&\-fsso\-struct=\fR\fIendianness\fR  \fB\-\-ansi\fR
.IP "\fIگزینه‌های زبان C++ (C++ Language Options)\fR" 4
.IX Item "C++ Language Options"
\&\fB\-\-compile\-std\-module
\&\-fabi\-compat\-version=\fR\fIn\fR  \fB\-fabi\-version=\fR\fIn\fR
\&\fB\-fno\-access\-control  \-faligned\-new=\fR[\fIn\fR]
\&\fB\-fno\-assume\-sane\-operators\-new\-delete
\&\-fchar8_t  \-fcheck\-new
\&\-fconcepts  \-fconcepts\-diagnostics\-depth=\fR\fIn\fR
\&\fB\-fconstexpr\-depth=\fR\fIn\fR  \fB\-fconstexpr\-cache\-depth=\fR\fIn\fR
\&\fB\-fconstexpr\-loop\-limit=\fR\fIn\fR  \fB\-fconstexpr\-ops\-limit=\fR\fIn\fR
\&\fB\-fcontracts
\&\-fcontract\-evaluation\-semantic=\fR[\fBignore\fR|\fBobserve\fR|\fBenforce\fR|\fBquick_enforce\fR]
\&\fB\-fcontracts\-conservative\-ipa  \-fcontract\-checks\-outlined
\&\-fcontract\-disable\-optimized\-checks
\&\-fcontracts\-client\-check=\fR[\fBnone\fR|\fBpre\fR|\fBall\fR]
\&\fB\-fcontracts\-definition\-check=\fR[\fBon\fR|\fBoff\fR]
\&\fB\-fcoroutines  \-fdiagnostics\-all\-candidates
\&\-fno\-elide\-constructors
\&\-fno\-enforce\-eh\-specs
\&\-fext\-numeric\-literals
\&\-fno\-gnu\-keywords
\&\-fno\-immediate\-escalation
\&\-fno\-implement\-inlines
\&\-fimplicit\-constexpr
\&\-fno\-implicit\-inline\-templates
\&\-fno\-implicit\-templates
\&\-fmodule\-header\fR[\fB=\fR\fIkind\fR]
\&\fB\-fmodule\-implicit\-inline
\&\-fno\-module\-lazy
\&\-fmodule\-mapper=\fR\fIspecification\fR
\&\fB\-fmodule\-only
\&\-fmodules
\&\-fms\-extensions
\&\-fnew\-inheriting\-ctors
\&\-fnew\-ttp\-matching
\&\-fno\-nonansi\-builtins  \-fnothrow\-opt  \-fno\-operator\-names
\&\-fno\-optional\-diags
\&\-fno\-pretty\-templates  \-frange\-for\-ext\-temps  \-freflection
\&\-fno\-rtti  \-fsized\-deallocation
\&\-fstrict\-enums  \-fstrong\-eval\-order\fR[\fB=\fR\fIkind\fR]
\&\fB\-ftemplate\-backtrace\-limit=\fR\fIn\fR
\&\fB\-ftemplate\-depth=\fR\fIn\fR
\&\fB\-fno\-threadsafe\-statics  \-fuse\-cxa\-atexit  \-fno\-use\-cxa\-get\-exception\-ptr
\&\-fno\-weak  \-nostdinc++
\&\-fvisibility\-inlines\-hidden
\&\-fvisibility\-ms\-compat
\&\-flang\-info\-include\-translate\fR[\fB=\fR\fIheader\fR]
\&\fB\-flang\-info\-include\-translate\-not
\&\-flang\-info\-module\-cmi\fR[\fB=\fR\fImodule\fR]
\&\fB\-stdlib=\fR\fIlibstdc++,libc++\fR
\&\fB\-Wabbreviated\-auto\-in\-template\-arg
\&\-Wabi\-tag  \-Waligned\-new\fR[\fB=\fR\fIkind\fR]
\&\fB\-Wcatch\-value  \-Wcatch\-value=\fR\fIn\fR
\&\fB\-Wno\-class\-conversion  \-Wclass\-memaccess
\&\-Wcomma\-subscript  \-Wconditionally\-supported
\&\-Wno\-conversion\-null  \-Wctad\-maybe\-unsupported
\&\-Wctor\-dtor\-privacy  \-Wdangling\-reference
\&\-Wno\-defaulted\-function\-deleted
\&\-Wno\-delete\-incomplete
\&\-Wdelete\-non\-virtual\-dtor  \-Wno\-deprecated\-array\-compare
\&\-Wdeprecated\-copy  \-Wdeprecated\-copy\-dtor
\&\-Wno\-deprecated\-enum\-enum\-conversion  \-Wno\-deprecated\-enum\-float\-conversion
\&\-Wno\-deprecated\-literal\-operator  \-Wdeprecated\-variadic\-comma\-omission
\&\-Weffc++  \-Wno\-elaborated\-enum\-base
\&\-Wno\-exceptions  \-Wno\-expose\-global\-module\-tu\-local  \-Wno\-external\-tu\-local
\&\-Wextra\-semi  \-Wno\-global\-module  \-Wno\-inaccessible\-base
\&\-Wno\-inherited\-variadic\-ctor  \-Wno\-init\-list\-lifetime
\&\-Winvalid\-constexpr  \-Winvalid\-imported\-macros
\&\-Wno\-invalid\-offsetof  \-Wno\-literal\-suffix
\&\-Wmismatched\-new\-delete  \-Wmismatched\-tags
\&\-Wmultiple\-inheritance  \-Wnamespaces  \-Wnarrowing
\&\-Wnoexcept  \-Wnoexcept\-type  \-Wnon\-virtual\-dtor
\&\-Wpessimizing\-move  \-Wno\-placement\-new  \-Wplacement\-new=\fR\fIn\fR
\&\fB\-Wrange\-loop\-construct  \-Wredundant\-move  \-Wredundant\-tags
\&\-Wreorder  \-Wregister  \-Wno\-sfinae\-incomplete
\&\-Wstrict\-null\-sentinel  \-Wno\-subobject\-linkage  \-Wtemplates
\&\-Wno\-non\-c\-typedef\-for\-linkage  \-Wno\-non\-template\-friend  \-Wold\-style\-cast
\&\-Woverloaded\-virtual  \-Wno\-pmf\-conversions  \-Wself\-move  \-Wsign\-promo
\&\-Wsized\-deallocation  \-Wsuggest\-final\-methods
\&\-Wsuggest\-final\-types  \-Wsuggest\-override  \-Wno\-template\-body
\&\-Wno\-template\-id\-cdtor  \-Wtemplate\-names\-tu\-local
\&\-Wno\-terminate  \-Wno\-vexing\-parse  \-Wvirtual\-inheritance
\&\-Wno\-virtual\-move\-assign  \-Wvolatile\fR
.IP "\fIگزینه‌های زبان‌های Objective\-C و Objective\-C++ (Objective\-C and Objective\-C++ Language Options)\fR" 4
.IX Item "Objective-C and Objective-C++ Language Options"
\&\fB\-fconstant\-string\-class=\fR\fIclass\-name\fR
\&\fB\-fgnu\-runtime  \-fnext\-runtime
\&\-fno\-nil\-receivers
\&\-fobjc\-abi\-version=\fR\fIn\fR
\&\fB\-fobjc\-call\-cxx\-cdtors
\&\-fobjc\-direct\-dispatch
\&\-fobjc\-exceptions
\&\-fobjc\-gc
\&\-fobjc\-nilcheck
\&\-fobjc\-std=objc1
\&\-fno\-local\-ivars
\&\-fivar\-visibility=\fR[\fBpublic\fR|\fBprotected\fR|\fBprivate\fR|\fBpackage\fR]
\&\fB\-freplace\-objc\-classes
\&\-fzero\-link
\&\-gen\-decls
\&\-Wassign\-intercept  \-Wno\-property\-assign\-default
\&\-Wno\-protocol  \-Wobjc\-root\-class  \-Wselector
\&\-Wstrict\-selector\-match
\&\-Wundeclared\-selector\fR
.IP "\fIگزینه‌های OpenMP و OpenACC (OpenMP and OpenACC Options)\fR" 4
.IX Item "OpenMP and OpenACC Options"
\&\fB\-foffload=\fR\fIarg\fR  \fB\-foffload\-options=\fR\fIarg\fR
\&\fB\-fopenacc  \-fopenacc\-dim=\fR\fIgeom\fR
\&\fB\-fopenmp  \-fopenmp\-simd  \-fopenmp\-target\-simd\-clone\fR[\fB=\fR\fIdevice\-type\fR]
.IP "\fIگزینه‌های قالب‌بندی پیام‌های تشخیصی (Diagnostic Message Formatting Options)\fR" 4
.IX Item "Diagnostic Message Formatting Options"
\&\fB\-fmessage\-length=\fR\fIn\fR
\&\fB\-fdiagnostics\-plain\-output
\&\-fdiagnostics\-show\-location=\fR[\fBonce\fR|\fBevery\-line\fR]
\&\fB\-fdiagnostics\-color=\fR[\fBauto\fR|\fBnever\fR|\fBalways\fR]
\&\fB\-fdiagnostics\-urls=\fR[\fBauto\fR|\fBnever\fR|\fBalways\fR]
\&\fB\-fdiagnostics\-format=\fR[\fBtext\fR|\fBsarif\-stderr\fR|\fBsarif\-file\fR]
\&\fB\-fdiagnostics\-add\-output=\fR\fIDIAGNOSTICS\-OUTPUT\-SPEC\fR
\&\fB\-fdiagnostics\-set\-output=\fR\fIDIAGNOSTICS\-OUTPUT\-SPEC\fR
\&\fB\-fno\-diagnostics\-json\-formatting
\&\-fno\-diagnostics\-show\-option  \-fno\-diagnostics\-show\-caret
\&\-fno\-diagnostics\-show\-event\-links
\&\-fno\-diagnostics\-show\-labels  \-fno\-diagnostics\-show\-line\-numbers
\&\-fno\-diagnostics\-show\-cwe
\&\-fno\-diagnostics\-show\-rules
\&\-fno\-diagnostics\-show\-highlight\-colors
\&\-fno\-diagnostics\-show\-nesting
\&\-fno\-diagnostics\-show\-nesting\-locations
\&\-fdiagnostics\-show\-nesting\-levels
\&\-fdiagnostics\-minimum\-margin\-width=\fR\fIwidth\fR
\&\fB\-fdiagnostics\-parseable\-fixits  \-fdiagnostics\-generate\-patch
\&\-fdiagnostics\-show\-template\-tree  \-fno\-elide\-type
\&\-fdiagnostics\-path\-format=\fR[\fBnone\fR|\fBseparate\-events\fR|\fBinline\-events\fR]
\&\fB\-fdiagnostics\-show\-path\-depths
\&\-fno\-show\-column
\&\-fdiagnostics\-column\-unit=\fR[\fBdisplay\fR|\fBbyte\fR]
\&\fB\-fdiagnostics\-column\-origin=\fR\fIorigin\fR
\&\fB\-fdiagnostics\-escape\-format=\fR[\fBunicode\fR|\fBbytes\fR]
\&\fB\-fdiagnostics\-text\-art\-charset=\fR[\fBnone\fR|\fBascii\fR|\fBunicode\fR|\fBemoji\fR]
\&\fB\-fdiagnostics\-show\-context\fR[\fB=\fR\fIdepth\fR]
.IP "\fIگزینه‌های هشدار (Warning Options)\fR" 4
.IX Item "Warning Options"
\&\fB\-fsyntax\-only  \-fmax\-errors=\fR\fIn\fR  \fB\-Wpedantic
\&\-pedantic\-errors  \-fpermissive
\&\-w  \-Wextra  \-Wall  \-Wabi=\fR\fIn\fR
\&\fB\-Waddress  \-Wno\-address\-of\-packed\-member  \-Waggregate\-return
\&\-Walloc\-size  \-Walloc\-size\-larger\-than=\fR\fIbyte\-size\fR  \fB\-Walloc\-zero
\&\-Walloca  \-Walloca\-larger\-than=\fR\fIbyte\-size\fR  \fB\-Wauto\-profile
\&\-Wno\-aggressive\-loop\-optimizations
\&\-Warith\-conversion
\&\-Warray\-bounds  \-Warray\-bounds=\fR\fIn\fR  \fB\-Warray\-compare
\&\-Warray\-parameter  \-Warray\-parameter=\fR\fIn\fR
\&\fB\-Wno\-attributes  \-Wattribute\-alias=\fR\fIn\fR  \fB\-Wno\-attribute\-alias
\&\-Wno\-attribute\-warning
\&\-Wbidi\-chars=\fR[\fBnone\fR|\fBunpaired\fR|\fBany\fR|\fBucn\fR]
\&\fB\-Wbool\-compare  \-Wbool\-operation
\&\-Wno\-builtin\-declaration\-mismatch
\&\-Wno\-builtin\-macro\-redefined  \-Wc90\-c99\-compat  \-Wc99\-c11\-compat
\&\-Wc11\-c23\-compat  \-Wc23\-c2y\-compat
\&\-Wc++\-compat  \-Wc++11\-compat  \-Wc++14\-compat  \-Wc++17\-compat
\&\-Wc++20\-compat  \-Wc++26\-compat
\&\-Wno\-c++11\-extensions  \-Wno\-c++14\-extensions  \-Wno\-c++17\-extensions
\&\-Wno\-c++20\-extensions  \-Wno\-c++23\-extensions
\&\-Wcalloc\-transposed\-args  \-Wcannot\-profile
\&\-Wcast\-align  \-Wcast\-align=strict  \-Wcast\-function\-type  \-Wcast\-qual
\&\-Wchar\-subscripts
\&\-Wclobbered  \-Wcomment
\&\-Wcompare\-distinct\-pointer\-types
\&\-Wno\-complain\-wrong\-lang
\&\-Wconversion  \-Wno\-coverage\-mismatch  \-Wno\-cpp
\&\-Wdangling\-else  \-Wdangling\-pointer  \-Wdangling\-pointer=\fR\fIn\fR
\&\fB\-Wdate\-time
\&\-Wno\-deprecated  \-Wno\-deprecated\-declarations  \-Wno\-designated\-init
\&\-Wno\-deprecated\-openmp
\&\-Wdisabled\-optimization
\&\-Wno\-discarded\-array\-qualifiers  \-Wno\-discarded\-qualifiers
\&\-Wno\-div\-by\-zero  \-Wdouble\-promotion
\&\-Wduplicated\-branches  \-Wduplicated\-cond
\&\-Wempty\-body  \-Wno\-endif\-labels  \-Wenum\-compare  \-Wenum\-conversion
\&\-Wenum\-int\-mismatch
\&\-Werror  \-Werror=*  \-Wexpansion\-to\-defined  \-Wfatal\-errors
\&\-Wflex\-array\-member\-not\-at\-end
\&\-Wfloat\-conversion  \-Wfloat\-equal  \-Wformat  \-Wformat=2
\&\-Wno\-format\-contains\-nul  \-Wno\-format\-diag  \-Wno\-format\-extra\-args
\&\-Wformat\-nonliteral  \-Wformat\-overflow=\fR\fIn\fR
\&\fB\-Wformat\-security  \-Wformat\-signedness  \-Wformat\-truncation=\fR\fIn\fR
\&\fB\-Wformat\-y2k  \-Wframe\-address
\&\-Wframe\-larger\-than=\fR\fIbyte\-size\fR  \fB\-Wno\-free\-nonheap\-object
\&\-Wheader\-guard  \-Wno\-if\-not\-aligned  \-Wno\-ignored\-attributes
\&\-Wignored\-qualifiers  \-Wno\-incompatible\-pointer\-types  \-Whardened
\&\-Wimplicit  \-Wimplicit\-fallthrough  \-Wimplicit\-fallthrough=\fR\fIn\fR
\&\fB\-Wno\-implicit\-function\-declaration  \-Wno\-implicit\-int
\&\-Winfinite\-recursion
\&\-Winit\-self  \-Winline  \-Wno\-int\-conversion  \-Wint\-in\-bool\-context
\&\-Wno\-int\-to\-pointer\-cast  \-Wno\-invalid\-memory\-model
\&\-Winvalid\-pch  \-Winvalid\-utf8  \-Wno\-unicode  \-Wjump\-misses\-init
\&\-Wkeyword\-macro
\&\-Wlarger\-than=\fR\fIbyte\-size\fR  \fB\-Wleading\-whitespace=\fR\fIkind\fR
\&\fB\-Wlogical\-not\-parentheses  \-Wlogical\-op
\&\-Wlong\-long  \-Wno\-lto\-type\-mismatch \-Wmain  \-Wmaybe\-uninitialized
\&\-Wmemset\-elt\-size  \-Wmemset\-transposed\-args
\&\-Wmisleading\-indentation  \-Wmissing\-attributes  \-Wmissing\-braces
\&\-Wmissing\-field\-initializers  \-Wmissing\-format\-attribute
\&\-Wmissing\-include\-dirs  \-Wmissing\-noreturn  \-Wmusttail\-local\-addr
\&\-Wmaybe\-musttail\-local\-addr  \-Wno\-missing\-profile
\&\-Wno\-multichar  \-Wmultistatement\-macros  \-Wnonnull  \-Wnonnull\-compare
\&\-Wnormalized=\fR[\fBnone\fR|\fBid\fR|\fBnfc\fR|\fBnfkc\fR]
\&\fB\-Wnull\-dereference  \-Wno\-odr
\&\-Wopenacc\-parallelism
\&\-Wopenmp  \-Wopenmp\-simd
\&\-Wno\-overflow  \-Woverlength\-strings  \-Wno\-override\-init\-side\-effects
\&\-Wpacked  \-Wno\-packed\-bitfield\-compat  \-Wpacked\-not\-aligned  \-Wpadded
\&\-Wparentheses  \-Wno\-pedantic\-ms\-format
\&\-Wpointer\-arith  \-Wno\-pointer\-compare  \-Wno\-pointer\-to\-int\-cast
\&\-Wno\-pragmas  \-Wno\-pragma\-once\-outside\-header  \-Wno\-prio\-ctor\-dtor
\&\-Wno\-psabi
\&\-Wredundant\-decls  \-Wrestrict
\&\-Wno\-return\-local\-addr  \-Wreturn\-type
\&\-Wno\-scalar\-storage\-order  \-Wsequence\-point
\&\-Wshadow  \-Wshadow=global  \-Wshadow=local  \-Wshadow=compatible\-local
\&\-Wno\-shadow\-ivar
\&\-Wno\-shift\-count\-negative  \-Wno\-shift\-count\-overflow
\&\-Wshift\-negative\-value  \-Wno\-shift\-overflow  \-Wshift\-overflow=\fR\fIn\fR
\&\fB\-Wsign\-compare  \-Wsign\-conversion
\&\-Wno\-sizeof\-array\-argument
\&\-Wsizeof\-array\-div
\&\-Wsizeof\-pointer\-div  \-Wsizeof\-pointer\-memaccess
\&\-Wstack\-protector  \-Wstack\-usage=\fR\fIbyte\-size\fR  \fB\-Wstrict\-aliasing
\&\-Wstrict\-aliasing=\fR\fIn\fR  \fB\-Wstrict\-overflow  \-Wstrict\-overflow=\fR\fIn\fR
\&\fB\-Wstring\-compare
\&\-Wno\-stringop\-overflow  \-Wno\-stringop\-overread
\&\-Wno\-stringop\-truncation  \-Wstrict\-flex\-arrays
\&\-Wsuggest\-attribute=\fR\fIattribute\-name\fR
\&\fB\-Wswitch  \-Wno\-switch\-bool  \-Wswitch\-default  \-Wswitch\-enum
\&\-Wno\-switch\-outside\-range  \-Wno\-switch\-unreachable  \-Wsync\-nand
\&\-Wsystem\-headers  \-Wtautological\-compare  \-Wtrailing\-whitespace
\&\-Wtrailing\-whitespace=\fR\fIkind\fR  \fB\-Wtrampolines  \-Wtrigraphs
\&\-Wtrivial\-auto\-var\-init  \-Wno\-tsan  \-Wtype\-limits  \-Wundef
\&\-Wuninitialized  \-Wunknown\-pragmas
\&\-Wunsuffixed\-float\-constants
\&\-Wunterminated\-string\-initialization
\&\-Wunused
\&\-Wunused\-but\-set\-parameter  \-Wunused\-but\-set\-parameter=\fR\fIn\fR
\&\fB\-Wunused\-but\-set\-variable  \-Wunused\-but\-set\-variable=\fR\fIn\fR
\&\fB\-Wunused\-const\-variable  \-Wunused\-const\-variable=\fR\fIn\fR
\&\fB\-Wunused\-function  \-Wunused\-label  \-Wunused\-local\-typedefs
\&\-Wunused\-macros
\&\-Wunused\-parameter  \-Wno\-unused\-result
\&\-Wunused\-value  \-Wunused\-variable
\&\-Wuse\-after\-free  \-Wuse\-after\-free=\fR\fIn\fR  \fB\-Wuseless\-cast
\&\-Wno\-varargs  \-Wvariadic\-macros
\&\-Wvector\-operation\-performance
\&\-Wvla  \-Wvla\-larger\-than=\fR\fIbyte\-size\fR  \fB\-Wno\-vla\-larger\-than
\&\-Wvolatile\-register\-var  \-Wwrite\-strings
\&\-Wno\-xor\-used\-as\-pow
\&\-Wzero\-as\-null\-pointer\-constant
\&\-Wzero\-length\-bounds
\&\-\-all\-warnings  \-\-extra\-warnings  \-\-no\-warnings
\&\-\-pedantic  \-\-pedantic\-errors\fR.IP "\fIگزینه‌های تحلیل‌گر ایستا\fR" 4
.IX Item "گزینه‌های تحلیل‌گر ایستا"
\&\fB\-fanalyzer
\&\-fanalyzer\-assume\-nothrow
\&\-fanalyzer\-call\-summaries
\&\-fanalyzer\-checker=\fR\fIname\fR
\&\fB\-fno\-analyzer\-feasibility
\&\-fanalyzer\-show\-events\-in\-system\-headers
\&\-fno\-analyzer\-state\-merge
\&\-fno\-analyzer\-state\-purge
\&\-fno\-analyzer\-suppress\-followups
\&\-fanalyzer\-transitivity
\&\-fno\-analyzer\-undo\-inlining
\&\-fanalyzer\-verbose\-edges
\&\-fanalyzer\-verbose\-state\-changes
\&\-fanalyzer\-verbosity=\fR\fIlevel\fR
\&\fB\-fdump\-analyzer
\&\-fdump\-analyzer\-callgraph
\&\-fdump\-analyzer\-exploded\-graph
\&\-fdump\-analyzer\-exploded\-nodes
\&\-fdump\-analyzer\-exploded\-nodes\-2
\&\-fdump\-analyzer\-exploded\-nodes\-3
\&\-fdump\-analyzer\-exploded\-paths
\&\-fdump\-analyzer\-feasibility
\&\-fdump\-analyzer\-infinite\-loop
\&\-fdump\-analyzer\-json
\&\-fdump\-analyzer\-state\-purge
\&\-fdump\-analyzer\-stderr
\&\-fdump\-analyzer\-supergraph
\&\-fdump\-analyzer\-untracked
\&\-Wno\-analyzer\-double\-fclose
\&\-Wno\-analyzer\-double\-free
\&\-Wno\-analyzer\-exposure\-through\-output\-file
\&\-Wno\-analyzer\-exposure\-through\-uninit\-copy
\&\-Wno\-analyzer\-fd\-access\-mode\-mismatch
\&\-Wno\-analyzer\-fd\-double\-close
\&\-Wno\-analyzer\-fd\-leak
\&\-Wno\-analyzer\-fd\-phase\-mismatch
\&\-Wno\-analyzer\-fd\-type\-mismatch
\&\-Wno\-analyzer\-fd\-use\-after\-close
\&\-Wno\-analyzer\-fd\-use\-without\-check
\&\-Wno\-analyzer\-file\-leak
\&\-Wno\-analyzer\-free\-of\-non\-heap
\&\-Wno\-analyzer\-imprecise\-fp\-arithmetic
\&\-Wno\-analyzer\-infinite\-loop
\&\-Wno\-analyzer\-infinite\-recursion
\&\-Wno\-analyzer\-jump\-through\-null
\&\-Wno\-analyzer\-malloc\-leak
\&\-Wno\-analyzer\-mismatching\-deallocation
\&\-Wno\-analyzer\-null\-argument
\&\-Wno\-analyzer\-null\-dereference
\&\-Wno\-analyzer\-out\-of\-bounds
\&\-Wno\-analyzer\-overlapping\-buffers
\&\-Wno\-analyzer\-possible\-null\-argument
\&\-Wno\-analyzer\-possible\-null\-dereference
\&\-Wno\-analyzer\-putenv\-of\-auto\-var
\&\-Wno\-analyzer\-shift\-count\-negative
\&\-Wno\-analyzer\-shift\-count\-overflow
\&\-Wno\-analyzer\-stale\-setjmp\-buffer
\&\-Wno\-analyzer\-tainted\-allocation\-size
\&\-Wno\-analyzer\-tainted\-assertion
\&\-Wno\-analyzer\-tainted\-array\-index
\&\-Wno\-analyzer\-tainted\-divisor
\&\-Wno\-analyzer\-tainted\-offset
\&\-Wno\-analyzer\-tainted\-size
\&\-Wno\-analyzer\-throw\-of\-unexpected\-type
\&\-Wanalyzer\-symbol\-too\-complex
\&\-Wanalyzer\-too\-complex
\&\-Wno\-analyzer\-undefined\-behavior\-ptrdiff
\&\-Wno\-analyzer\-undefined\-behavior\-strtok
\&\-Wno\-analyzer\-unsafe\-call\-within\-signal\-handler
\&\-Wno\-analyzer\-use\-after\-free
\&\-Wno\-analyzer\-use\-of\-pointer\-in\-stale\-stack\-frame
\&\-Wno\-analyzer\-use\-of\-uninitialized\-value
\&\-Wno\-analyzer\-va\-arg\-type\-mismatch
\&\-Wno\-analyzer\-va\-list\-exhausted
\&\-Wno\-analyzer\-va\-list\-leak
\&\-Wno\-analyzer\-va\-list\-use\-after\-va\-end
\&\-Wno\-analyzer\-write\-to\-const
\&\-Wno\-analyzer\-write\-to\-string\-literal\fR
.IP "\fIگزینه‌های هشدار ویژهٔ C و Objective\-C\fR" 4
.IX Item "گزینه‌های هشدار ویژهٔ C و Objective-C"
\&\fB\-Wbad\-function\-cast  \-Wdeprecated\-non\-prototype  \-Wfree\-labels
\&\-Wmissing\-declarations  \-Wmissing\-parameter\-name  \-Wmissing\-parameter\-type
\&\-Wdeclaration\-missing\-parameter\-type  \-Wmissing\-prototypes
\&\-Wmissing\-variable\-declarations
\&\-Wmultiple\-parameter\-fwd\-decl\-lists
\&\-Wnested\-externs  \-Wold\-style\-declaration
\&\-Wold\-style\-definition  \-Wstrict\-prototypes  \-Wtraditional
\&\-Wtraditional\-conversion  \-Wdeclaration\-after\-statement  \-Wpointer\-sign\fR
.IP "\fIگزینه‌های اشکال‌زدایی\fR" 4
.IX Item "گزینه‌های اشکال‌زدایی"
\&\fB\-g  \-g\fR\fIlevel\fR  \fB\-gdwarf  \-gdwarf\-\fR\fIversion\fR
\&\fB\-gbtf  \-gctf  \-gctf\fR\fIlevel\fR
\&\fB\-gno\-prune\-btf  \-ggdb  \-gno\-record\-gcc\-switches
\&\-gstrict\-dwarf  \-gas\-loc\-support  \-gas\-locview\-support
\&\-gcodeview  \-gcolumn\-info  \-gdwarf32  \-gdwarf64
\&\-gno\-statement\-frontiers
\&\-gno\-variable\-location\-views  \-gvariable\-location\-views=incompat5
\&\-ginternal\-reset\-location\-views  \-ginline\-points
\&\-gvms  \-gz\fR[\fB=\fR\fItype\fR]
\&\fB\-gsplit\-dwarf  \-gdescribe\-dies
\&\-fdebug\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR  \fB\-fdebug\-types\-section
\&\-fno\-eliminate\-unused\-debug\-types
\&\-femit\-struct\-debug\-baseonly  \-femit\-struct\-debug\-reduced
\&\-femit\-struct\-debug\-detailed\fR[\fB=\fR\fIspec\-list\fR]
\&\fB\-fno\-eliminate\-unused\-debug\-symbols  \-femit\-class\-debug\-always
\&\-fno\-merge\-debug\-strings  \-fno\-dwarf2\-cfi\-asm
\&\-fvar\-tracking  \-fvar\-tracking\-assignments  \-fvar\-tracking\-uninit
\&\-\-debug\fR
.IP "\fIگزینه‌های بهینه‌سازی\fR" 4
.IX Item "گزینه‌های بهینه‌سازی"
\&\fB\-faggressive\-loop\-optimizations
\&\-falign\-functions[=\fR\fIn\fR\fB[:\fR\fIm\fR\fB:[\fR\fIn2\fR\fB[:\fR\fIm2\fR\fB]]]]
\&\-falign\-jumps[=\fR\fIn\fR\fB[:\fR\fIm\fR\fB:[\fR\fIn2\fR\fB[:\fR\fIm2\fR\fB]]]]
\&\-falign\-labels[=\fR\fIn\fR\fB[:\fR\fIm\fR\fB:[\fR\fIn2\fR\fB[:\fR\fIm2\fR\fB]]]]
\&\-falign\-loops[=\fR\fIn\fR\fB[:\fR\fIm\fR\fB:[\fR\fIn2\fR\fB[:\fR\fIm2\fR\fB]]]]
\&\-fmin\-function\-alignment=[\fR\fIn\fR\fB]
\&\-fno\-allocation\-dce  \-fallow\-store\-data\-races
\&\-fassociative\-math  \-fauto\-profile  \-fauto\-profile[=\fR\fIpath\fR\fB]
\&\-fauto\-profile\-inlining  \-fauto\-inc\-dec  \-fbranch\-probabilities
\&\-fcaller\-saves
\&\-fcombine\-stack\-adjustments  \-fconserve\-stack
\&\-ffold\-mem\-offsets
\&\-fcompare\-elim  \-fcprop\-registers  \-fcrossjumping
\&\-fcse\-follow\-jumps  \-fcse\-skip\-blocks  \-fcx\-fortran\-rules
\&\-fcx\-limited\-range \-fcx\-method
\&\-fdata\-sections  \-fdce  \-fdelayed\-branch
\&\-fdelete\-null\-pointer\-checks  \-fdep\-fusion  \-fdevirtualize
\&\-fdevirtualize\-speculatively  \-fdevirtualize\-at\-ltrans  \-fdse
\&\-fearly\-inlining  \-fexcess\-precision=\fR\fIstyle\fR
\&\fB\-fexpensive\-optimizations  \-fext\-dce
\&\-ffast\-math  \-ffat\-lto\-objects  \-ffinite\-loops
\&\-ffinite\-math\-only  \-ffloat\-store
\&\-fforward\-propagate  \-ffp\-contract=\fR\fIstyle\fR  \fB\-ffp\-int\-builtin\-inexact
\&\-ffunction\-sections  \-ffuse\-ops\-with\-volatile\-access
\&\-fgcse  \-fgcse\-after\-reload  \-fgcse\-las  \-fgcse\-lm  \-fgraphite\-identity
\&\-fgcse\-sm  \-fhoist\-adjacent\-loads  \-fif\-conversion
\&\-fif\-conversion2  \-findirect\-inlining
\&\-finline\-atomics  \-finline\-functions  \-finline\-functions\-called\-once
\&\-finline\-limit=\fR\fIn\fR  \fB\-finline\-small\-functions
\&\-finline\-stringops\fR[\fB=\fR\fIfn\fR]
\&\fB\-fipa\-modref  \-fipa\-cp  \-fipa\-cp\-clone
\&\-fipa\-bit\-cp  \-fipa\-vrp  \-fipa\-pta  \-fipa\-profile  \-fipa\-pure\-const
\&\-fipa\-reference  \-fipa\-reference\-addressable  \-fipa\-reorder\-for\-locality
\&\-fipa\-sra  \-fipa\-stack\-alignment
\&\-fipa\-icf  \-fipa\-icf\-functions  \-fipa\-icf\-variables
\&\-fira\-algorithm=\fR\fIalgorithm\fR
\&\fB\-flate\-combine\-instructions  \-flifetime\-dse  \-flive\-patching=\fR\fIlevel\fR
\&\fB\-fira\-region=\fR\fIregion\fR  \fB\-fira\-hoist\-pressure
\&\-fira\-loop\-pressure  \-fno\-ira\-share\-save\-slots
\&\-fno\-ira\-share\-spill\-slots
\&\-fisolate\-erroneous\-paths\-dereference  \-fisolate\-erroneous\-paths\-attribute
\&\-fivopts  \-fkeep\-inline\-functions  \-fkeep\-static\-functions
\&\-fkeep\-static\-consts  \-flimit\-function\-alignment  \-flive\-range\-shrinkage
\&\-floop\-block  \-floop\-interchange  \-floop\-strip\-mine
\&\-floop\-unroll\-and\-jam  \-floop\-nest\-optimize
\&\-floop\-parallelize\-all  \-flra\-remat  \-flto  \-flto\-compression\-level=\fR\fIn\fR
\&\fB\-flto\-toplevel\-asm\-heuristics
\&\-flto\-partition=\fR\fIalg\fR  \fB\-flto\-incremental=\fR\fIpath\fR
\&\fB\-flto\-incremental\-cache\-size=\fR\fIn\fR  \fB\-fmalloc\-dce  \-fmerge\-all\-constants
\&\-fmerge\-constants  \-fmodulo\-sched  \-fmodulo\-sched\-allow\-regmoves
\&\-fmove\-loop\-invariants  \-fmove\-loop\-stores  \-fno\-branch\-count\-reg
\&\-fno\-defer\-pop  \-fno\-function\-cse
\&\-fno\-guess\-branch\-probability  \-fno\-inline  \-fno\-math\-errno  \-fno\-peephole
\&\-fno\-peephole2  \-fno\-printf\-return\-value  \-fno\-sched\-interblock
\&\-fno\-sched\-spec  \-fno\-signed\-zeros
\&\-fno\-toplevel\-reorder  \-fno\-trapping\-math  \-fno\-zero\-initialized\-in\-bss
\&\-fomit\-frame\-pointer  \-foptimize\-crc  \-foptimize\-sibling\-calls
\&\-fpartial\-inlining  \-fpeel\-loops  \-fpredictive\-commoning
\&\-fprefetch\-loop\-arrays
\&\-fprofile\-correction
\&\-fprofile\-use  \-fprofile\-use=\fR\fIpath\fR  \fB\-fprofile\-partial\-training
\&\-fprofile\-values  \-fprofile\-reorder\-functions
\&\-freciprocal\-math  \-free  \-frename\-registers  \-freorder\-blocks
\&\-freorder\-blocks\-algorithm=\fR\fIalgorithm\fR
\&\fB\-freorder\-blocks\-and\-partition  \-freorder\-functions
\&\-frerun\-cse\-after\-loop  \-freschedule\-modulo\-scheduled\-loops
\&\-frounding\-math  \-fsave\-optimization\-record
\&\-fsched2\-use\-superblocks  \-fsched\-pressure
\&\-fsched\-spec\-load  \-fsched\-spec\-load\-dangerous
\&\-fsched\-stalled\-insns\-dep[=\fR\fIn\fR\fB]  \-fsched\-stalled\-insns[=\fR\fIn\fR\fB]
\&\-fsched\-group\-heuristic  \-fsched\-critical\-path\-heuristic
\&\-fsched\-spec\-insn\-heuristic  \-fsched\-rank\-heuristic
\&\-fsched\-last\-insn\-heuristic  \-fsched\-dep\-count\-heuristic
\&\-fschedule\-fusion
\&\-fschedule\-insns  \-fschedule\-insns2  \-fsection\-anchors
\&\-fselective\-scheduling  \-fselective\-scheduling2
\&\-fsel\-sched\-pipelining  \-fsel\-sched\-pipelining\-outer\-loops
\&\-fsemantic\-interposition  \-fshrink\-wrap  \-fshrink\-wrap\-separate
\&\-fsignaling\-nans
\&\-fsingle\-precision\-constant  \-fsplit\-ivs\-in\-unroller  \-fsplit\-loops
\&\-fspeculatively\-call\-stored\-functions  \-fsplit\-paths
\&\-fsplit\-wide\-types  \-fsplit\-wide\-types\-early  \-fssa\-backprop  \-fssa\-phiopt
\&\-fstdarg\-opt  \-fstore\-merging  \-fstrict\-aliasing \-fipa\-strict\-aliasing
\&\-fthread\-jumps  \-ftracer  \-ftree\-bit\-ccp
\&\-ftree\-builtin\-call\-dce  \-ftree\-ccp  \-ftree\-ch  \-ftree\-coalesce\-vars
\&\-ftree\-copy\-prop  \-ftree\-cselim  \-ftree\-dce  \-ftree\-dominator\-opts
\&\-ftree\-dse  \-ftree\-forwprop  \-ftree\-fre  \-fcode\-hoisting
\&\-ftree\-loop\-if\-convert  \-ftree\-loop\-im
\&\-ftree\-phiprop  \-ftree\-loop\-distribution  \-ftree\-loop\-distribute\-patterns
\&\-ftree\-loop\-ivcanon  \-ftree\-loop\-linear  \-ftree\-loop\-optimize
\&\-ftree\-loop\-vectorize
\&\-ftree\-parallelize\-loops[=\fR\fIn\fR\fB]  \-ftree\-pre  \-ftree\-partial\-pre  \-ftree\-pta
\&\-ftree\-reassoc  \-ftree\-scev\-cprop  \-ftree\-sink  \-ftree\-slsr  \-ftree\-sra
\&\-ftree\-switch\-conversion  \-ftree\-tail\-merge
\&\-ftree\-ter  \-ftree\-vectorize  \-ftree\-vrp  \-ftrivial\-auto\-var\-init
\&\-funconstrained\-commons  \-funit\-at\-a\-time  \-funroll\-all\-loops
\&\-funroll\-loops  \-funsafe\-math\-optimizations  \-funswitch\-loops
\&\-fipa\-ra  \-fvariable\-expansion\-in\-unroller  \-fvect\-cost\-model  \-fvpt
\&\-fweb  \-fwhole\-program  \-fwpa  \-fuse\-linker\-plugin  \-fzero\-call\-used\-regs
\&\-O  \-O0  \-O1  \-O2  \-O3  \-Os  \-Ofast  \-Og  \-Oz  \-\-optimize\fR.IP "\fIگزینه‌های ابزارگذاری برنامه (Program Instrumentation Options)\fR" 4
.IX Item "گزینه‌های ابزارگذاری برنامه (Program Instrumentation Options)"
\&\fB\-p  \-pg  \-fprofile\-arcs  \-coverage  \-ftest\-coverage
\&\-fcondition\-coverage
\&\-fpath\-coverage
\&\-fprofile  \-fprofile\-abs\-path
\&\-fprofile\-dir=\fR\fIpath\fR  \fB\-fprofile\-generate  \-fprofile\-generate=\fR\fIpath\fR
\&\fB\-fprofile\-info\-section  \-fprofile\-info\-section=\fR\fIname\fR
\&\fB\-fprofile\-note=\fR\fIpath\fR  \fB\-fprofile\-prefix\-path=\fR\fIpath\fR
\&\fB\-fprofile\-update=\fR\fImethod\fR  \fB\-fprofile\-filter\-files=\fR\fIregex\fR
\&\fB\-fprofile\-exclude\-files=\fR\fIregex\fR
\&\fB\-fprofile\-reproducible=\fR[\fBmultithreaded\fR|\fBparallel\-runs\fR|\fBserial\fR]
\&\fB\-fsanitize=\fR\fIstyle\fR  \fB\-fsanitize\-recover  \-fsanitize\-recover=\fR\fIstyle\fR
\&\fB\-fsanitize\-trap   \-fsanitize\-trap=\fR\fIstyle\fR
\&\fB\-fasan\-shadow\-offset=\fR\fInumber\fR  \fB\-fsanitize\-sections=\fR\fIs1\fR\fB,\fR\fIs2\fR\fB,...
\&\-fsanitize\-undefined\-trap\-on\-error  \-fcf\-protection
\&\-fcf\-protection=\fR[\fBfull\fR|\fBbranch\fR|\fBreturn\fR|\fBnone\fR|\fBcheck\fR]
\&\fB\-fharden\-compares  \-fharden\-conditional\-branches  \-fhardened
\&\-fharden\-control\-flow\-redundancy  \-fhardcfr\-skip\-leaf
\&\-fhardcfr\-check\-exceptions  \-fhardcfr\-check\-returning\-calls
\&\-fhardcfr\-check\-noreturn\-calls=\fR[\fBalways\fR|\fBno\-xthrow\fR|\fBnothrow\fR|\fBnever\fR]
\&\fB\-fstack\-protector  \-fstack\-protector\-all  \-fstack\-protector\-strong
\&\-fstack\-protector\-explicit  \-fstack\-check
\&\-fstack\-limit\-register=\fR\fIreg\fR  \fB\-fstack\-limit\-symbol=\fR\fIsym\fR
\&\fB\-fno\-stack\-limit  \-fsplit\-stack
\&\-fstrub=disable  \-fstrub=strict  \-fstrub=relaxed
\&\-fstrub=all  \-fstrub=at\-calls  \-fstrub=internal
\&\-fvtable\-verify=\fR[\fBstd\fR|\fBpreinit\fR|\fBnone\fR]
\&\fB\-fvtv\-counts  \-fvtv\-debug
\&\-finstrument\-functions  \-finstrument\-functions\-once
\&\-finstrument\-functions\-exclude\-function\-list=\fR\fIsym\fR\fB,\fR\fIsym\fR\fB,...
\&\-finstrument\-functions\-exclude\-file\-list=\fR\fIfile\fR\fB,\fR\fIfile\fR\fB,...
\&\-fprofile\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR
\&\fB\-fpatchable\-function\-entry=\fR\fIN\fR[\fB,\fR\fIM\fR]
\&\fB\-\-coverage \-\-profile\fR
.IP "\fIگزینه‌های پیش‌پردازنده (Preprocessor Options)\fR" 4
.IX Item "گزینه‌های پیش‌پردازنده (Preprocessor Options)"
\&\fB\-C  \-CC  \-D\fR\fImacro\fR[\fB=\fR\fIdefn\fR]
\&\fB\-dD  \-dI  \-dM  \-dN  \-dU
\&\-fdebug\-cpp  \-fdirectives\-only  \-fdollars\-in\-identifiers
\&\-fexec\-charset=\fR\fIcharset\fR  \fB\-fextended\-identifiers
\&\-finput\-charset=\fR\fIcharset\fR
\&\fB\-fmacro\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR  \fB\-fmax\-include\-depth=\fR\fIdepth\fR
\&\fB\-fno\-canonical\-system\-headers  \-fpch\-deps  \-fpch\-preprocess
\&\-fpreprocessed  \-ftabstop=\fR\fIwidth\fR  \fB\-ftrack\-macro\-expansion
\&\-fwide\-exec\-charset=\fR\fIcharset\fR  \fB\-fworking\-directory
\&\-H  \-imacros\fR \fIfile\fR  \fB\-include\fR \fIfile\fR
\&\fB\-M  \-MD  \-MF  \-MG  \-MM  \-MMD  \-MP  \-MQ  \-MT \-Mno\-modules
\&\-no\-integrated\-cpp  \-P  \-pthread  \-remap
\&\-traditional  \-traditional\-cpp  \-trigraphs
\&\-U\fR\fImacro\fR  \fB\-undef
\&\-Wp,\fR\fIoption\fR  \fB\-Xpreprocessor\fR \fIoption\fR
\&\fB\-\-comments  \-\-comments\-in\-macros
\&\-\-define\-macro=\fR\fImacro\fR[\fB=\fR\fIdefn\fR]
\&\fB\-\-dependencies  \-\-dump=\fR\fIletters\fR
\&\fB\-\-imacros=\fR\fIfile\fR  \fB\-\-include=\fR\fIfile\fR
\&\fB\-\-no\-integrated\-cpp  \-\-no\-line\-commands
\&\-\-print\-missing\-file\-dependencies
\&\-\-traditional  \-\-traditional\-cpp  \-\-trigraphs  \-\-trace\-includes
\&\-\-undefine\-macro=\fR\fImacro\fR
\&\fB\-\-user\-dependencies  \-\-write\-dependencies  \-\-write\-user\-dependencies\fR
.IP "\fIگزینه‌های اسمبلر (Assembler Options)\fR" 4
.IX Item "گزینه‌های اسمبلر (Assembler Options)"
\&\fB\-Wa,\fR\fIoption\fR  \fB\-Xassembler\fR \fIoption\fR
\&\fB\-\-for\-assembler=\fR\fIoption\fR
.IP "\fIگزینه‌های پیونددهنده (Linker Options)\fR" 4
.IX Item "گزینه‌های پیونددهنده (Linker Options)"
\&\fIobject\-file\-name\fR  \fB\-flink\-libatomic  \-fuse\-ld=\fR\fIlinker\fR  \fB\-l\fR\fIlibrary\fR
\&\fB\-nostartfiles  \-nodefaultlibs  \-nolibc  \-nostdlib  \-nostdlib++
\&\-e\fR \fIentry\fR
\&\fB\-pie  \-pthread  \-r  \-rdynamic
\&\-s  \-static  \-static\-pie  \-static\-libgcc  \-static\-libstdc++
\&\-static\-libasan  \-static\-libhwasan  \-static\-liblsan
\&\-static\-libtsan  \-static\-libubsan
\&\-shared  \-shared\-libgcc  \-symbolic
\&\-T\fR \fIscript\fR  \fB\-Wl,\fR\fIoption\fR  \fB\-Xlinker\fR \fIoption\fR
\&\fB\-u\fR \fIsymbol\fR
\&\fB\-Tbss=\fR\fIaddr\fR  \fB\-Tdata=\fR\fIaddr\fR  \fB\-Ttext=\fR\fIaddr\fR
\&\fB\-N  \-n  \-t  \-Z  \-z\fR \fIkeyword\fR
\&\fB\-\-entry=\fR\fIentry\fR  \fB\-\-for\-linker=\fR\fIoption\fR
\&\fB\-\-force\-link=\fR\fIsymbol\fR  \fB\-\-no\-standard\-library
\&\-\-pie  \-\-static  \-\-static\-pie  \-\-symbolic\fR
.IP "\fIگزینه‌های دایرکتوری (Directory Options)\fR" 4
.IX Item "گزینه‌های دایرکتوری (Directory Options)"
\&\fB\-B\fR\fIprefix\fR  \fB\-I\fR\fIdir\fR  \fB\-I\-
\&\-idirafter\fR \fIdir\fR
\&\fB\-imacros\fR \fIfile\fR  \fB\-imultilib\fR \fIdir\fR  \fB\-imultiarch\fR \fIdir\fR
\&\fB\-iplugindir=\fR\fIdir\fR  \fB\-iprefix\fR \fIfile\fR
\&\fB\-iquote\fR \fIdir\fR  \fB\-isysroot\fR \fIdir\fR  \fB\-isystem\fR \fIdir\fR
\&\fB\-iwithprefix\fR \fIdir\fR  \fB\-iwithprefixbefore\fR \fIdir\fR
\&\fB\-L\fR\fIdir\fR  \fB\-no\-canonical\-prefixes  \-\-no\-sysroot\-suffix
\&\-nostdinc  \-nostdinc++
\&\-\-embed\-dir=\fR\fIdir\fR  \fB\-\-embed\-directory=\fR\fIdir\fR
\&\fB\-\-include\-barrier  \-\-include\-directory=\fR\fIdir\fR
\&\fB\-\-include\-directory\-after=\fR\fIdir\fR  \fB\-\-include\-prefix=\fR\fIprefix\fR
\&\fB\-\-include\-with\-prefix=\fR\fIprefix\fR  \fB\-\-include\-with\-prefix\-after=\fR\fIprefix\fR
\&\fB\-\-include\-with\-prefix\-before=\fR\fIprefix\fR
\&\fB\-\-no\-canonical\-prefixes  \-\-no\-standard\-includes
\&\-\-prefix=\fR\fIprefix\fR  \fB\-\-sysroot=\fR\fIdir\fR
.IP "\fIگزینه‌های تولید کد (Code Generation Options)\fR" 4
.IX Item "گزینه‌های تولید کد (Code Generation Options)"
\&\fB\-fcall\-saved\-\fR\fIreg\fR  \fB\-fcall\-used\-\fR\fIreg\fR
\&\fB\-ffixed\-\fR\fIreg\fR  \fB\-fexceptions
\&\-fnon\-call\-exceptions  \-fdelete\-dead\-exceptions  \-funwind\-tables
\&\-fasynchronous\-unwind\-tables
\&\-fno\-gnu\-unique
\&\-finhibit\-size\-directive  \-fcommon  \-fno\-ident
\&\-fpcc\-struct\-return  \-fpic  \-fPIC  \-fpie  \-fPIE  \-fno\-plt
\&\-fno\-jump\-tables  \-fno\-bit\-tests
\&\-frecord\-gcc\-switches
\&\-freg\-struct\-return  \-fshort\-enums  \-fshort\-wchar
\&\-fverbose\-asm  \-fpack\-struct[=\fR\fIn\fR\fB]
\&\-fleading\-underscore  \-ftls\-model=\fR\fImodel\fR
\&\fB\-fstack\-reuse=\fR\fIreuse_level\fR
\&\fB\-ftrampolines  \-ftrampoline\-impl=\fR[\fBstack\fR|\fBheap\fR]
\&\fB\-ftrapv  \-fwrapv  \-fwrapv\-pointer
\&\-fvisibility=\fR[\fBdefault\fR|\fBinternal\fR|\fBhidden\fR|\fBprotected\fR]
\&\fB\-fstrict\-volatile\-bitfields  \-fsync\-libcalls
\&\-fzero\-init\-padding\-bits=\fR\fIvalue\fR
\&\fB\-Qy  \-Qn\fR
.IP "\fIگزینه‌های توسعه‌دهنده (Developer Options)\fR" 4
.IX Item "گزینه‌های توسعه‌دهنده (Developer Options)"
\&\fB\-d\fR\fIletters\fR  \fB\-dumpspecs  \-dumpmachine  \-dumpversion
\&\-dumpfullversion  \-fcallgraph\-info\fR[\fB=su,da\fR]
\&\fB\-fchecking  \-fchecking=\fR\fIn\fR
\&\fB\-fdbg\-cnt\-list  \-fdbg\-cnt=\fR\fIcounter\-value\-list\fR
\&\fB\-fdisable\-ipa\-\fR\fIpass_name\fR
\&\fB\-fdisable\-rtl\-\fR\fIpass_name\fR
\&\fB\-fdisable\-rtl\-\fR\fIpass\-name\fR\fB=\fR\fIrange\-list\fR
\&\fB\-fdisable\-tree\-\fR\fIpass_name\fR
\&\fB\-fdisable\-tree\-\fR\fIpass\-name\fR\fB=\fR\fIrange\-list\fR
\&\fB\-fdump\-debug  \-fdump\-earlydebug
\&\-fdump\-noaddr  \-fdump\-unnumbered  \-fdump\-unnumbered\-links
\&\-fdump\-final\-insns\fR[\fB=\fR\fIfile\fR]
\&\fB\-fdump\-internal\-locations
\&\-fdump\-ipa\-all  \-fdump\-ipa\-cgraph  \-fdump\-ipa\-inline
\&\-fdump\-lang\-all
\&\-fdump\-lang\-\fR\fIswitch\fR
\&\fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR
\&\fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR
\&\fB\-fdump\-passes
\&\-fdump\-rtl\-\fR\fIpass\fR  \fB\-fdump\-rtl\-\fR\fIpass\fR\fB=\fR\fIfilename\fR
\&\fB\-fdump\-statistics
\&\-fdump\-tree\-all
\&\-fdump\-tree\-\fR\fIswitch\fR
\&\fB\-fdump\-tree\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR
\&\fB\-fdump\-tree\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR
\&\fB\-fcompare\-debug\fR[\fB=\fR\fIopts\fR]  \fB\-fcompare\-debug\-second
\&\-fenable\-\fR\fIkind\fR\fB\-\fR\fIpass\fR
\&\fB\-fenable\-\fR\fIkind\fR\fB\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR
\&\fB\-fira\-verbose=\fR\fIn\fR
\&\fB\-flto\-report  \-flto\-report\-wpa  \-fmem\-report\-wpa
\&\-fmem\-report  \-fpre\-ipa\-mem\-report  \-fpost\-ipa\-mem\-report
\&\-fopt\-info  \-fopt\-info\-\fR\fIoptions\fR[\fB=\fR\fIfile\fR]
\&\fB\-fmultiflags  \-fprofile\-report
\&\-frandom\-seed=\fR\fIstring\fR  \fB\-fsched\-verbose=\fR\fIn\fR
\&\fB\-fsel\-sched\-verbose  \-fsel\-sched\-dump\-cfg  \-fsel\-sched\-pipelining\-verbose
\&\-fstats  \-fstack\-usage  \-ftime\-report  \-ftime\-report\-details
\&\-fvar\-tracking\-assignments\-toggle  \-gtoggle
\&\-print\-autofdo\-gcov\-version
\&\-print\-file\-name=\fR\fIlibrary\fR  \fB\-print\-libgcc\-file\-name
\&\-print\-multi\-directory  \-print\-multi\-lib  \-print\-multi\-os\-directory
\&\-print\-multiarch
\&\-print\-prog\-name=\fR\fIprogram\fR  \fB\-print\-search\-dirs  \-Q
\&\-print\-sysroot  \-print\-sysroot\-headers\-suffix
\&\-save\-temps  \-save\-temps=cwd  \-save\-temps=obj
\&\-specs=\fR\fIfile\fR  \fB\-time\fR[\fB=\fR\fIfile\fR]
\&\fB\-\-dump=\fR\fIletters\fR
\&\fB\-\-print\-autofdo\-gcov\-version
\&\-\-print\-file\-name=\fR\fIlibrary\fR  \fB\-\-print\-libgcc\-file\-file\-name
\&\-\-print\-multi\-directory  \-\-print\-multi\-lib  \-\-print\-multi\-os\-directory
\&\-\-print\-multiarch  \-\-print\-prog\-name=\fR\fIprogram\fR
\&\fB\-\-print\-search\-dirs  \-\-print\-sysroot  \-\-print\-sysroot\-headers\-suffix
\&\-\-save\-temps  \-\-specs=\fR\fIfile\fR
\&\fB\-\-param\fR \fIname\fR\fB=\fR\fIvalue\fR\fB \fR
.IP "\fIگزینه‌های وابسته به مقصد (Target\-Specific Options)\fR" 4
.IX Item "گزینه‌های وابسته به مقصد (Target-Specific Options)"
\&\fIگزینه‌های AArch64\fR (\fBAArch64 Options\fR)
\&\fB\-mabi=\fR\fIname\fR  \fB\-mbig\-endian  \-mlittle\-endian
\&\-menable\-sysreg\-checking
\&\-mgeneral\-regs\-only
\&\-mcmodel=tiny  \-mcmodel=small  \-mcmodel=large
\&\-mstrict\-align  \-momit\-leaf\-frame\-pointer
\&\-mtls\-dialect=desc  \-mtls\-dialect=traditional
\&\-mtls\-size=\fR\fIsize\fR  \fB\-mtp=\fR\fIname\fR
\&\fB\-mfix\-cortex\-a53\-835769  \-mfix\-cortex\-a53\-843419
\&\-mlow\-precision\-recip\-sqrt  \-mlow\-precision\-sqrt  \-mlow\-precision\-div
\&\-mmax\-vectorization  \-mautovec\-preference=\fR\fIname\fR
\&\fB\-mpc\-relative\-literal\-loads
\&\-msign\-return\-address=\fR\fIscope\fR
\&\fB\-mbranch\-protection=\fR\fIfeatures\fR
\&\fB\-mharden\-sls=\fR\fIopts\fR
\&\fB\-march=\fR\fIname\fR  \fB\-mcpu=\fR\fIname\fR  \fB\-mtune=\fR\fIname\fR
\&\fB\-moverride=\fR\fIstring\fR
\&\fB\-mstack\-protector\-guard=\fR\fIguard\fR  \fB\-mstack\-protector\-guard\-reg=\fR\fIsysreg\fR
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR  \fB\-mtrack\-speculation
\&\-moutline\-atomics  \-mearly\-ra  \-mearly\-ldp\-fusion  \-mlate\-ldp\-fusion \-mnarrow\-gp\-writes
\&\-msve\-vector\-bits=\fR\fIbits\fR
.Sp
\&\fIگزینه‌های Adapteva Epiphany\fR (\fBAdapteva Epiphany Options\fR)
\&\fB\-mhalf\-reg\-file  \-mprefer\-short\-insn\-regs
\&\-mbranch\-cost=\fR\fInum\fR  \fB\-mcmove  \-mnops=\fR\fInum\fR  \fB\-msoft\-cmpsf
\&\-msplit\-lohi  \-mpost\-inc  \-mpost\-modify  \-mstack\-offset=\fR\fInum\fR
\&\fB\-mround\-nearest  \-mlong\-calls  \-mshort\-calls  \-msmall16
\&\-mfp\-mode=\fR\fImode\fR  \fB\-mmay\-round\-for\-trunc  \-mfp\-iarith
\&\-mvect\-double  \-max\-vect\-align=\fR\fInum\fR
\&\fB\-msplit\-vecmove\-early  \-m1reg\-\fR\fIreg\fR
.Sp
\&\fIگزینه‌های AMD GCN\fR (\fBAMD GCN Options\fR)
\&\fB\-march=\fR\fIgpu\fR  \fB\-mtune=\fR\fIgpu\fR
\&\fB\-mgang\-private\-size=\fR\fIbytes\fR
\&\fB\-msram\-ecc=\fR[\fBon\fR|\fBoff\fR|\fBany\fR]
\&\fB\-mxnack=\fR[\fBon\fR|\fBoff\fR|\fBany\fR]
\&\fB\-Wopenacc\-dims\fR
.Sp
\&\fIگزینه‌های ARC\fR (\fBARC Options\fR)
\&\fB\-mbarrel\-shifter  \-mjli\-always
\&\-mcpu=\fR\fIcpu\fR  \fB\-mA6  \-mARC600  \-mA7  \-mARC700
\&\-mdpfp  \-mdpfp\-compact  \-mdpfp\-fast  \-mno\-dpfp\-lrsr
\&\-mea  \-mmul32x16  \-mmul64  \-matomic
\&\-mnorm  \-mspfp  \-mspfp\-compact  \-mspfp\-fast  \-msimd  \-msoft\-float  \-mswap
\&\-mlock  \-mswape
\&\-mxy  \-misize  \-marclinux  \-marclinux_prof
\&\-mlong\-calls  \-mmedium\-calls  \-msdata  \-mirq\-ctrl\-saved
\&\-mrgf\-banked\-regs  \-mlpc\-width=\fR\fIwidth\fR  \fB\-G\fR \fInum\fR
\&\fB\-mvolatile\-cache  \-mtp\-regno=\fR\fIregno\fR
\&\fB\-mbitops  \-mcmem  \-munaligned\-access
\&\-mauto\-modify\-reg  \-mno\-brcc
\&\-mcase\-vector\-pcrel  \-mno\-cond\-exec  \-mearly\-cbranchsi
\&\-mindexed\-loads  \-mlra\-priority\-none
\&\-mlra\-priority\-compact \-mlra\-priority\-noncompact  \-mmillicode
\&\-msize\-level=\fR\fIlevel\fR
\&\fB\-mtune=\fR\fIcpu\fR  \fB\-mmultcost=\fR\fInum\fR  \fB\-mcode\-density\-frame
\&\-mmpy\-option=\fR\fImulto\fR
\&\fB\-mdiv\-rem  \-mcode\-density  \-mll64  \-mfpu=\fR\fIfpu\fR  \fB\-mrf16  \-mbranch\-index\fR
.Sp
\&\fIگزینه‌های ARM\fR (\fBARM Options\fR)
\&\fB\-mapcs\-frame  \-mapcs
\&\-mabi=\fR\fIname\fR
\&\fB\-mgeneral\-regs\-only  \-mno\-sched\-prolog
\&\-mlittle\-endian  \-mbig\-endian
\&\-mbe8  \-mbe32
\&\-mfloat\-abi=\fR\fIname\fR
\&\fB\-mfp16\-format=\fR\fIname\fR
\&\fB\-mthumb\-interwork
\&\-mcpu=\fR\fIname\fR  \fB\-march=\fR\fIname\fR  \fB\-mfpu=\fR\fIname\fR  \fB\-mtune=\fR\fIname\fR
\&\fB\-mstructure\-size\-boundary=\fR\fIn\fR
\&\fB\-mabort\-on\-noreturn  \-mlong\-calls
\&\-msingle\-pic\-base  \-mpic\-register=\fR\fIreg\fR
\&\fB\-mpic\-data\-is\-text\-relative
\&\-mnop\-fun\-dllimport
\&\-mpoke\-function\-name
\&\-mthumb  \-marm
\&\-mtpcs\-frame  \-mtpcs\-leaf\-frame
\&\-mcaller\-super\-interworking  \-mcallee\-super\-interworking
\&\-mtp=\fR\fIname\fR  \fB\-mtls\-dialect=\fR\fIdialect\fR
\&\fB\-mword\-relocations
\&\-mfix\-cortex\-m3\-ldrd
\&\-mfix\-cortex\-a57\-aes\-1742098
\&\-mfix\-cortex\-a72\-aes\-1655431
\&\-munaligned\-access
\&\-mslow\-flash\-data
\&\-masm\-syntax\-unified
\&\-mrestrict\-it
\&\-mpure\-code
\&\-mcmse
\&\-mfix\-cmse\-cve\-2021\-35465
\&\-mstack\-protector\-guard=\fR\fIguard\fR
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR
\&\fB\-mfdpic
\&\-mbranch\-protection=\fR\fIfeatures\fR
\&\fB\-mvectorize\-with\-neon\-quad  \-mvectorize\-with\-neon\-double\fR.Sp
\&\fIگزینه‌های AVR\fR (\fBAVR Options\fR)
\&\fB\-mmcu=\fR\fImcu\fR  \fB\-mabsdata  \-maccumulate\-args  \-mcvt
\&\-mbranch\-cost=\fR\fIcost\fR  \fB\-mfuse\-add=\fR\fIlevel\fR  \fB\-mfuse\-move=\fR\fIlevel\fR
\&\fB\-mfuse\-move2  \-mcall\-prologues  \-mgas\-isr\-prologues  \-mint8  \-mflmap
\&\-mdouble=\fR\fIbits\fR  \fB\-mlong\-double=\fR\fIbits\fR  \fB\-mno\-call\-main
\&\-mn_flash=\fR\fIsize\fR  \fB\-mfract\-convert\-truncate  \-mno\-interrupts
\&\-mmain\-is\-OS_task  \-mrelax  \-mpmem\-wrap\-around
\&\-mrmw  \-mstrict\-X  \-mtiny\-stack
\&\-mrodata\-in\-ram  \-msplit\-bit\-shift  \-msplit\-ldst  \-mshort\-calls
\&\-mskip\-bug  \-muse\-nonzero\-bits  \-nodevicelib  \-nodevicespecs
\&\-Waddr\-space\-convert  \-Wmisspelled\-isr\fR
.Sp
\&\fIگزینه‌های Blackfin\fR (\fBBlackfin Options\fR)
\&\fB\-mcpu=\fR\fIcpu\fR[\fB\-\fR\fIsirevision\fR]
\&\fB\-msim  \-momit\-leaf\-frame\-pointer
\&\-mspecld\-anomaly  \-mcsync\-anomaly
\&\-mlow\-64k  \-mstack\-check\-l1  \-mid\-shared\-library
\&\-mleaf\-id\-shared\-library
\&\-mshared\-library\-id=\fR\fIn\fR
\&\fB\-msep\-data  \-mlong\-calls
\&\-mfast\-fp  \-minline\-plt  \-mmulticore  \-mcorea  \-mcoreb  \-msdram
\&\-micplb\fR
.Sp
\&\fIگزینه‌های C6X\fR (\fBC6X Options\fR)
\&\fB\-mbig\-endian  \-mlittle\-endian  \-march=\fR\fIcpu\fR
\&\fB\-msim  \-msdata=\fR\fIsdata\-type\fR  \fB\-mdsbt  \-mlong\-calls\fR
.Sp
\&\fIگزینه‌های CRIS\fR (\fBCRIS Options\fR)
\&\fB\-mcpu=\fR\fIcpu\fR  \fB\-march=\fR\fIcpu\fR
\&\fB\-mtune=\fR\fIcpu\fR  \fB\-mmax\-stackframe=\fR\fIn\fR
\&\fB\-metrax4  \-metrax100  \-mpdebug  \-mcc\-init  \-mno\-side\-effects
\&\-mstack\-align  \-mdata\-align  \-mconst\-align
\&\-m32\-bit  \-m16\-bit  \-m8\-bit  \-mno\-prologue\-epilogue
\&\-mbest\-lib\-options  \-moverride\-best\-lib\-options
\&\-mtrap\-using\-break8  \-mtrap\-unaligned\-atomic
\&\-munaligned\-atomic\-may\-use\-library
\&\-sim  \-sim2
\&\-mmul\-bug\-workaround\fR
.Sp
\&\fIگزینه‌های C\-SKY\fR (\fBC\-SKY Options\fR)
\&\fB\-march=\fR\fIarch\fR  \fB\-mcpu=\fR\fIcpu\fR
\&\fB\-mbig\-endian  \-mlittle\-endian
\&\-mfpu=\fR\fIfpu\fR  \fB\-mdouble\-float  \-mfdivdu
\&\-mfloat\-abi=\fR\fIname\fR
\&\fB\-melrw  \-mistack  \-mmp  \-mcp  \-mcache  \-msecurity  \-mtrust
\&\-mdsp  \-medsp  \-mvdsp
\&\-mdiv  \-msmart  \-mhigh\-registers  \-manchor
\&\-mpushpop  \-mmultiple\-stld  \-mconstpool  \-mstack\-size  \-mccrt
\&\-mbranch\-cost=\fR\fIn\fR  \fB\-msched\-prolog  \-msim\fR
.Sp
\&\fIگزینه‌های Cygwin و MinGW\fR (\fBCygwin and MinGW Options\fR)
\&\fB\-mconsole  \-mcrtdll=\fR\fIlibrary\fR  \fB\-mdll
\&\-mnop\-fun\-dllimport  \-mthreads
\&\-municode  \-mwin32  \-mwindows  \-fno\-set\-stack\-executable
\&\-fwritable\-relocated\-rdata  \-mpe\-aligned\-commons
\&\-muse\-libstdc\-wrappers\fR
.Sp
\&\fIگزینه‌های Darwin\fR (\fBDarwin Options\fR)
\&\fB\-all_load  \-allowable_client  \-arch\fR \fIname\fR
\&\fB\-arch_errors_fatal  \-asm_macosx_version_min=\fR\fIversion\fR
\&\fB\-bind_at_load  \-bundle  \-bundle_loader
\&\-client_name  \-compatibility_version  \-current_version
\&\-dead_strip
\&\-dependency\-file  \-dylib_file  \-dylinker  \-dylinker_install_name
\&\-dynamic  \-dynamiclib  \-exported_symbols_list
\&\-fapple\-kext  \-fconstant\-cfstrings  \-ffix\-and\-continue
\&\-filelist  \-findirect\-data  \-flat_namespace  \-force_cpusubtype_ALL
\&\-force_flat_namespace  \-framework\fR \fIname\fR  \fB\-gfull  \-gused
\&\-headerpad_max_install_names  \-iframework
\&\-image_base  \-init\fR \fIsymbol\-name\fR  \fB\-install_name  \-keep_private_externs
\&\-matt\-stubs  \-mconstant\-cfstrings  \-mdynamic\-no\-pic
\&\-mfix\-and\-continue  \-mkernel  \-mmacosx\-version\-min=\fR\fIversion\fR
\&\fB\-mone\-byte\-bool  \-msymbol\-stubs  \-mtarget\-linker\fR[\fB=\fR]\fIversion\fR
\&\fB\-nodefaultexport  \-nodefaultrpaths
\&\-pagezero_size  \-preload  \-read_only_relocs
\&\-sectalign  \-sectcreate
\&\-seg_addr_table
\&\-seg1addr  \-segaddr
\&\-segprot  \-segs_read_only_addr  \-segs_read_write_addr
\&\-sub_library  \-sub_umbrella
\&\-twolevel_namespace  \-twolevel_namespace_hints
\&\-umbrella  \-undefined  \-unexported_symbols_list
\&\-weak_framework\fR \fIname\fR  \fB\-weak_reference_mismatches
\&\-whatsloaded  \-whyload
\&\-F  \-ObjC  \-ObjC++  \-Wnonportable\-cfstrings\fR
.Sp
\&\fIگزینه‌های DEC Alpha\fR (\fBDEC Alpha Options\fR)
\&\fB\-mno\-fp\-regs  \-msoft\-float
\&\-mieee  \-mieee\-with\-inexact  \-mieee\-conformant
\&\-mfp\-trap\-mode=\fR\fImode\fR  \fB\-mfp\-rounding\-mode=\fR\fImode\fR
\&\fB\-mtrap\-precision=\fR\fImode\fR  \fB\-mbuild\-constants
\&\-mcpu=\fR\fIcpu\-type\fR  \fB\-mtune=\fR\fIcpu\-type\fR
\&\fB\-mbwx  \-mmax  \-mfix  \-mcix
\&\-msafe\-bwa  \-msafe\-partial
\&\-mfloat\-vax  \-mfloat\-ieee
\&\-mexplicit\-relocs  \-msmall\-data  \-mlarge\-data
\&\-msmall\-text  \-mlarge\-text
\&\-mmemory\-latency=\fR\fItime\fR
\&\fB\-mtls\-kernel  \-mtls\-size=\fR\fIbitsize\fR
\&\fB\-mlong\-double\-128  \-mlong\-double\-64\fR
.Sp
\&\fIگزینه‌های eBPF\fR (\fBeBPF Options\fR)
\&\fB\-mbig\-endian  \-mlittle\-endian
\&\-mframe\-limit=\fR\fIbytes\fR  \fB\-mxbpf  \-mco\-re  \-mjmpext  \-mjmp32
\&\-malu32  \-mv3\-atomics  \-mbswap  \-msdiv  \-msmov  \-mcpu=\fR\fIversion\fR
\&\fB\-masm=\fR\fIdialect\fR  \fB\-minline\-memops\-threshold=\fR\fIbytes\fR
\&\fB\-Wco\-re\fR
.Sp
\&\fIگزینه‌های FR30\fR (\fBFR30 Options\fR)
\&\fB\-msmall\-model  \-mno\-lsim\fR
.Sp
\&\fIگزینه‌های FRV\fR (\fBFRV Options\fR)
\&\fB\-mgpr\-32  \-mgpr\-64  \-mfpr\-32  \-mfpr\-64
\&\-mhard\-float  \-msoft\-float
\&\-malloc\-cc  \-mfixed\-cc  \-mdword  \-mdouble  \-mmedia  \-mmuladd
\&\-mfdpic  \-minline\-plt  \-mgprel\-ro  \-multilib\-library\-pic
\&\-mlinked\-fp  \-mlong\-calls  \-malign\-labels
\&\-mlibrary\-pic  \-macc\-4  \-macc\-8
\&\-mpack  \-mno\-eflags  \-mno\-cond\-move
\&\-mno\-optimize\-membar  \-mno\-scc  \-mno\-cond\-exec
\&\-mno\-vliw\-branch  \-mno\-multi\-cond\-exec  \-mno\-nested\-cond\-exec
\&\-mtomcat\-stats
\&\-mTLS  \-mtls
\&\-mcpu=\fR\fIcpu\fR
.Sp
\&\fIگزینه‌های FT32\fR (\fBFT32 Options\fR)
\&\fB\-msim  \-mnodiv  \-mft32b  \-mcompress  \-mnopm\fR
.Sp
\&\fIگزینه‌های GNU/Linux\fR (\fBGNU/Linux Options\fR)
\&\fB\-mglibc  \-muclibc  \-mmusl  \-mbionic  \-mandroid
\&\-tno\-android\-cc  \-tno\-android\-ld\fR
.Sp
\&\fIگزینه‌های H8/300\fR (\fBH8/300 Options\fR)
\&\fB\-mrelax  \-mh  \-ms  \-mn  \-msx  \-ms2600
\&\-mquickcall  \-mslowbyte  \-mexr  \-mint32  \-malign\-300\fR
.Sp
\&\fIگزینه‌های HPPA\fR (\fBHPPA Options\fR)
\&\fB\-march=\fR\fIarchitecture\-type\fR
\&\fB\-mno\-atomic\-libcalls
\&\-mcaller\-copies  \-mdisable\-fpregs  \-mdisable\-indexing
\&\-mordered  \-mfast\-indirect\-calls  \-mgas  \-mgnu\-ld   \-mhp\-ld
\&\-mfixed\-range=\fR\fIregister\-range\fR
\&\fB\-mcoherent\-ldcw  \-mlinker\-opt  \-mlong\-calls
\&\-mlong\-load\-store
\&\-mno\-space\-regs  \-msoft\-float  \-mpa\-risc\-1\-0
\&\-mpa\-risc\-1\-1  \-mpa\-risc\-2\-0  \-mportable\-runtime
\&\-mschedule=\fR\fIcpu\-type\fR  \fB\-msoft\-mult  \-msio  \-mwsio
\&\-munix=\fR\fIunix\-std\fR  \fB\-nolibdld  \-static  \-threads\fR
.Sp
\&\fIگزینه‌های IA\-64\fR (\fBIA\-64 Options\fR)
\&\fB\-mbig\-endian  \-mlittle\-endian  \-mgnu\-as  \-mgnu\-ld  \-mno\-pic
\&\-mvolatile\-asm\-stop  \-mregister\-names  \-msdata
\&\-mconstant\-gp  \-mauto\-pic
\&\-minline\-float\-divide\-min\-latency
\&\-minline\-float\-divide\-max\-throughput
\&\-mno\-inline\-float\-divide
\&\-minline\-int\-divide\-min\-latency
\&\-minline\-int\-divide\-max\-throughput
\&\-mno\-inline\-int\-divide
\&\-minline\-sqrt\-min\-latency  \-minline\-sqrt\-max\-throughput
\&\-mno\-inline\-sqrt
\&\-mdwarf2\-asm  \-mearly\-stop\-bits
\&\-mfixed\-range=\fR\fIregister\-range\fR  \fB\-mtls\-size=\fR\fItls\-size\fR
\&\fB\-mtune=\fR\fIcpu\-type\fR  \fB\-milp32  \-mlp64
\&\-msched\-br\-data\-spec  \-msched\-ar\-data\-spec  \-msched\-control\-spec
\&\-msched\-br\-in\-data\-spec  \-msched\-ar\-in\-data\-spec  \-msched\-in\-control\-spec
\&\-msched\-spec\-ldc  \-msched\-spec\-control\-ldc
\&\-msched\-stop\-bits\-after\-every\-cycle  \-msched\-count\-spec\-in\-critical\-path
\&\-msel\-sched\-dont\-check\-control\-spec  \-msched\-fp\-mem\-deps\-zero\-cost
\&\-msched\-max\-memory\-insns\-hard\-limit  \-msched\-max\-memory\-insns=\fR\fImax\-insns\fR
.Sp
\&\fIگزینه‌های LM32\fR (\fBLM32 Options\fR)
\&\fB\-mbarrel\-shift\-enabled  \-mdivide\-enabled  \-mmultiply\-enabled
\&\-msign\-extend\-enabled  \-muser\-enabled\fR
.Sp
\&\fIگزینه‌های LoongArch\fR (\fBLoongArch Options\fR)
\&\fB\-march=\fR\fIarch\-type\fR  \fB\-mtune=\fR\fItune\-type\fR  \fB\-mabi=\fR\fIbase\-abi\-type\fR
\&\fB\-mfpu=\fR\fIfpu\-type\fR  \fB\-msimd=\fR\fIsimd\-type\fR
\&\fB\-msoft\-float  \-msingle\-float  \-mdouble\-float  \-mlsx  \-mlasx
\&\-mbranch\-cost=\fR\fIn\fR  \fB\-maddr\-reg\-reg\-cost=\fR\fIn\fR  \fB\-mcheck\-zero\-division
\&\-mbreak\-code=\fR\fIcode\fR
\&\fB\-mcond\-move\-int  \-mcond\-move\-float
\&\-memcpy  \-mstrict\-align  \-G\fR \fInum\fR
\&\fB\-mmax\-inline\-memcpy\-size=\fR\fIn\fR
\&\fB\-mexplicit\-relocs=\fR\fIstyle\fR  \fB\-mexplicit\-relocs  \-mno\-explicit\-relocs
\&\-mdirect\-extern\-access
\&\-mcmodel=\fR\fIcode\-model\fR  \fB\-mrelax  \-mpass\-mrelax\-to\-as
\&\-mrecip  \-mrecip=\fR\fIopt\fR  \fB\-mfrecipe  \-mdiv32
\&\-mlam\-bh  \-mlamcas  \-mld\-seq\-sa
\&\-mscq  \-mtls\-dialect=\fR\fIopt\fR
\&\fB\-mannotate\-tablejump\fR
.Sp
\&\fIگزینه‌های LynxOS\fR (\fBLynxOS Options\fR)
\&\fB\-mshared  \-mthreads  \-mlegacy\-threads\fR
.Sp
\&\fIگزینه‌های M32C\fR (\fBM32C Options\fR)
\&\fB\-mcpu=\fR\fIcpu\fR  \fB\-msim  \-memregs=\fR\fInumber\fR
.Sp
\&\fIگزینه‌های M32R/D\fR (\fBM32R/D Options\fR)
\&\fB\-m32r2  \-m32rx  \-m32r
\&\-mdebug
\&\-malign\-loops
\&\-missue\-rate=\fR\fInumber\fR
\&\fB\-mbranch\-cost=\fR\fInumber\fR
\&\fB\-mmodel=\fR\fIcode\-size\-model\-type\fR
\&\fB\-msdata=\fR\fIsdata\-type\fR
\&\fB\-mno\-flush\-func  \-mflush\-func=\fR\fIname\fR
\&\fB\-mno\-flush\-trap  \-mflush\-trap=\fR\fInumber\fR
\&\fB\-G\fR \fInum\fR
.Sp
\&\fIگزینه‌های M680x0\fR (\fBM680x0 Options\fR)
\&\fB\-march=\fR\fIarch\fR  \fB\-mcpu=\fR\fIcpu\fR  \fB\-mtune=\fR\fItune\fR
\&\fB\-m68000  \-m68020  \-m68020\-40  \-m68020\-60  \-m68030  \-m68040
\&\-m68060  \-m68302  \-m68332  \-m68851
\&\-mcpu32  \-mfidoa  \-m5200  \-m5206e  \-m528x  \-m5307  \-m5407
\&\-mcfv4e  \-mbitfield  \-mc68000  \-mc68020
\&\-mrtd  \-mdiv  \-mshort
\&\-mhard\-float  \-m68881  \-msoft\-float  \-mpcrel
\&\-malign\-int  \-mstrict\-align  \-msep\-data
\&\-mshared\-library\-id=\fR\fIn\fR  \fB\-mid\-shared\-library
\&\-mxgot  \-mxtls  \-mlong\-jump\-table\-offsets\fR
.Sp
\&\fIگزینه‌های MCore\fR (\fBMCore Options\fR)
\&\fB\-mhardlit  \-mdiv  \-mrelax\-immediates
\&\-mwide\-bitfields
\&\-m4byte\-functions  \-mcallgraph\-data
\&\-mslow\-bytes  \-mno\-lsim
\&\-mlittle\-endian  \-mbig\-endian  \-m210  \-m340  \-mstack\-increment\fR
.Sp
\&\fIگزینه‌های MicroBlaze\fR (\fBMicroBlaze Options\fR)
\&\fB\-msoft\-float  \-mhard\-float  \-msmall\-divides  \-mcpu=\fR\fIcpu\fR
\&\fB\-mmemcpy  \-mxl\-soft\-mul  \-mxl\-soft\-div  \-mxl\-barrel\-shift
\&\-mxl\-pattern\-compare  \-mxl\-gp\-opt
\&\-mxl\-multiply\-high  \-mxl\-float\-convert  \-mxl\-float\-sqrt
\&\-mbig\-endian  \-mlittle\-endian  \-mxl\-reorder  \-mxl\-mode\-\fR\fIapp\-model\fR
\&\fB\-mxl\-prefetch  \-mpic\-data\-is\-text\-relative\fR
.Sp
\&\fIگزینه‌های MIPS\fR (\fBMIPS Options\fR)
\&\fB\-EL  \-EB  \-mel  \-meb  \-march=\fR\fIarch\fR  \fB\-mtune=\fR\fIarch\fR
\&\fB\-mips1  \-mips2  \-mips3  \-mips4  \-mips32  \-mips32r2  \-mips32r3  \-mips32r5
\&\-mips32r6  \-mips64  \-mips64r2  \-mips64r3  \-mips64r5  \-mips64r6
\&\-mips16  \-mmips16e2  \-mflip\-mips16
\&\-minterlink\-compressed  \-minterlink\-mips16
\&\-mabi=\fR\fIabi\fR  \fB\-mabicalls  \-mshared  \-mplt  \-mxgot
\&\-mgp32  \-mgp64  \-mfp32  \-mfpxx  \-mfp64  \-mhard\-float  \-msoft\-float
\&\-mno\-float  \-msingle\-float  \-mdouble\-float  \-modd\-spreg
\&\-mabs=\fR\fImode\fR  \fB\-mnan=\fR\fIencoding\fR
\&\fB\-mdsp  \-mdspr2  \-mmcu  \-meva  \-mvirt  \-mxpa  \-mcrc  \-mginv
\&\-mmicromips  \-mmsa
\&\-mloongson\-mmi  \-mloongson\-ext  \-mloongson\-ext2
\&\-mfpu=\fR\fIfpu\-type\fR
\&\fB\-msmartmips  \-mpaired\-single  \-mdmx  \-mips3d  \-mmt  \-mllsc
\&\-mlong64  \-mlong32  \-msym32
\&\-G\fR\fInum\fR  \fB\-mno\-local\-sdata  \-mno\-extern\-sdata  \-mno\-gopt
\&\-membedded\-data  \-muninit\-const\-in\-rodata
\&\-mcode\-readable=\fR\fIsetting\fR  \fB\-mno\-data\-in\-code  \-mcode\-xonly
\&\-msplit\-addresses  \-mexplicit\-relocs  \-mexplicit\-relocs=\fR\fIrelease\fR
\&\fB\-mno\-check\-zero\-division  \-mdivide\-traps  \-mdivide\-breaks
\&\-mno\-load\-store\-pairs
\&\-mstrict\-align  \-mno\-unaligned\-access
\&\-mmemcpy  \-mlong\-calls
\&\-mmad  \-mimadd  \-mno\-fused\-madd  \-nocpp
\&\-mfix\-24k  \-mfix\-r4000  \-mfix\-r4400  \-mfix\-r5900
\&\-mfix\-r10000  \-mfix\-rm7000  \-mfix\-vr4120  \-mfix\-vr4130  \-mfix\-sb1
\&\-mfix4300  \-mr10k\-cache\-barrier=\fR\fIsetting\fR
\&\fB\-mflush\-func=\fR\fIfunc\fR  \fB\-mno\-flush\-func
\&\-mbranch\-cost=\fR\fInum\fR  \fB\-mbranch\-likely
\&\-mcompact\-branches=\fR\fIpolicy\fR
\&\fB\-mno\-fp\-exceptions  \-mvr4130\-align  \-msynci  \-mno\-lxc1\-sxc1  \-mno\-madd4
\&\-mno\-relax\-pic\-calls  \-mmcount\-ra\-address
\&\-mframe\-header\-opt\fR.Sp
\&\fIگزینه‌های MMIX\fR (\fBMMIX Options\fR)
\&\fB\-mlibfuncs  \-mepsilon  \-mabi=gnu  \-mabi=mmixware
\&\-mzero\-extend  \-mknuthdiv  \-mtoplevel\-symbols
\&\-melf  \-mbranch\-predict  \-mbase\-addresses
\&\-msingle\-exit  \-mset\-data\-start=\fR\fIaddress\fR
\&\fB\-mset\-program\-start=\fR\fIaddress\fR  \fB\-mno\-set\-program\-start\fR
.Sp
\&\fIگزینه‌های MN10300\fR (\fBMN10300 Options\fR)
\&\fB\-mmult\-bug  \-mno\-mult\-bug
\&\-mam33  \-mam33\-2  \-mam34
\&\-mtune=\fR\fIcpu\-type\fR
\&\fB\-mno\-return\-pointer\-on\-d0
\&\-mno\-crt0  \-mrelax  \-mno\-liw  \-mno\-setlb\fR
.Sp
\&\fIگزینه‌های Moxie\fR (\fBMoxie Options\fR)
\&\fB\-meb  \-mel  \-mmul.x  \-mno\-crt0\fR
.Sp
\&\fIگزینه‌های MSP430\fR (\fBMSP430 Options\fR)
\&\fB\-msim  \-masm\-hex  \-mmcu=\fR\fIname\fR  \fB\-mlarge  \-msmall  \-mrelax
\&\-mwarn\-mcu  \-mwarn\-devices\-csv
\&\-mcode\-region=\fR\fIwhere\fR  \fB\-mdata\-region=\fR\fIwhere\fR
\&\fB\-muse\-lower\-region\-prefix
\&\-msilicon\-errata=\fR\fIname\fR[\fB,\fR\fIname\fR\fB...\fR]
\&\fB\-msilicon\-errata\-warn=\fR\fIname\fR[\fB,\fR\fIname\fR\fB...\fR]
\&\fB\-mhwmult=\fR\fItype\fR  \fB\-minrt  \-mtiny\-printf  \-mmax\-inline\-shift=\fR\fIn\fR
.Sp
\&\fIگزینه‌های NDS32\fR (\fBNDS32 Options\fR)
\&\fB\-mbig\-endian  \-mlittle\-endian  \-EB  \-EL
\&\-mabi=\fR\fIname\fR  \fB\-mfloat\-abi=\fR\fIname\fR
\&\fB\-mreduced\-regs  \-mfull\-regs
\&\-malways\-align  \-malign\-functions
\&\-mfp\-as\-gp  \-mcmov  \-mhw\-abs
\&\-mext\-perf  \-mext\-perf2  \-mext\-string  \-mext\-dsp
\&\-mext\-fpu\-fma  \-mext\-fpu\-sp  \-mext\-fpu\-dp
\&\-mv3push  \-m16\-bit  \-mvh
\&\-misr\-vector\-size=\fR\fInum\fR  \fB\-misr\-secure=\fR\fInum\fR
\&\fB\-mcache\-block\-size=\fR\fInum\fR
\&\fB\-march=\fR\fIarch\fR  \fB\-mcpu=\fR\fIcpu\fR
\&\fB\-mconfig\-fpu=\fR\fInum\fR  \fB\-mconfig\-mul=\fR\fItype\fR
\&\fB\-mconfig\-register\-ports=\fR\fIkind\fR
\&\fB\-mcmodel=\fR\fIcode\-model\fR
\&\fB\-mctor\-dtor  \-mrelax  \-mrelax\-hint
\&\-msched\-prolog\-epilog  \-mno\-ret\-in\-naked\-func
\&\-malways\-save\-lp   \-munaligned\-access  \-minline\-asm\-r15\fR
.Sp
\&\fIگزینه‌های Nvidia PTX\fR (\fBNvidia PTX Options\fR)
\&\fB\-m64  \-march=\fR\fIarch\fR  \fB\-misa=\fR\fIarch\fR  \fB\-march\-map=\fR\fIarch\fR
\&\fB\-mptx=\fR\fIversion\fR  \fB\-mmainkernel  \-moptimize
\&\-msoft\-stack  \-msoft\-stack\-reserve\-local=\fR\fIsize\fR
\&\fB\-muniform\-simt  \-mgomp\fR
.Sp
\&\fIگزینه‌های OpenRISC\fR (\fBOpenRISC Options\fR)
\&\fB\-mboard=\fR\fIname\fR  \fB\-mhard\-mul  \-mhard\-div
\&\-msoft\-mul  \-msoft\-div
\&\-msoft\-float  \-mhard\-float  \-mdouble\-float \-munordered\-float
\&\-mcmov  \-mror  \-mrori  \-msext  \-msfimm  \-mshftimm
\&\-mcmodel=\fR\fIcode\-model\fR
.Sp
\&\fIگزینه‌های PDP\-11\fR (\fBPDP\-11 Options\fR)
\&\fB\-mfpu  \-msoft\-float  \-mac0  \-m40  \-m45  \-m10
\&\-mint32  \-mint16
\&\-msplit  \-munix\-asm  \-mdec\-asm  \-mgnu\-asm  \-mlra\fR
.Sp
\&\fIگزینه‌های Picolibc\fR (\fBPicolibc Options\fR)
\&\fB\-\-oslib=\fR\fIlibrary\fR \fB\-\-crt0=\fR[\fBnone\fR|\fBminimal\fR|\fBhosted\fR|\fBsemihost\fR]
\&\fB\-\-printf=\fR[\fBd\fR|\fBf\fR|\fBl\fR|\fBi\fR|\fBm\fR]  \fB\-\-scanf=\fR[\fBd\fR|\fBf\fR|\fBl\fR|\fBi\fR|\fBm\fR]
.Sp
\&\fIگزینه‌های PowerPC\fR
نگاه کنید به گزینه‌های RS/6000 و PowerPC.
.Sp
\&\fIگزینه‌های PRU\fR (\fBPRU Options\fR)
\&\fB\-mmcu=\fR\fImcu\fR  \fB\-minrt  \-mno\-relax  \-mloop
\&\-mmul  \-mfillzero  \-mabi=\fR\fIvariant\fR
.Sp
\&\fIگزینه‌های RISC\-V\fR (\fBRISC\-V Options\fR)
\&\fB\-mbranch\-cost=\fR\fIN\-instruction\fR
\&\fB\-mabi=\fR\fIABI\-string\fR
\&\fB\-mfdiv  \-mdiv
\&\-mno\-fence\-tso
\&\-misa\-spec=\fR\fIISA\-spec\-string\fR
\&\fB\-march=\fR[\fIISA\fR|\fIProfile\fR|\fIProfile_ISA\fR|\fIprocessor\-string\fR]
\&\fB\-mcpu=\fR\fIprocessor\-string\fR  \fB\-mtune=\fR\fIprocessor\-string\fR
\&\fB\-mpreferred\-stack\-boundary=\fR\fInum\fR
\&\fB\-msmall\-data\-limit=\fR\fIN\-bytes\fR
\&\fB\-msave\-restore  \-mno\-shorten\-memrefs
\&\-mstrict\-align  \-mscalar\-strict\-align  \-mno\-vector\-strict\-align
\&\-mcmodel=medlow  \-mcmodel=medany  \-mcmodel=large
\&\-mexplicit\-relocs  \-mrelax  \-mriscv\-attribute
\&\-malign\-data=\fR\fItype\fR
\&\fB\-mbig\-endian  \-mlittle\-endian
\&\-mstack\-protector\-guard=\fR\fIguard\fR  \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR
\&\fB\-mcsr\-check  \-momit\-leaf\-frame\-pointer  \-mmovcc
\&\-mno\-inline\-atomics  \-mno\-inline\-strlen
\&\-mno\-inline\-strcmp  \-mno\-inline\-strncmp
\&\-mstringop\-strategy=\fR\fIstrategy\fR
\&\fB\-mtls\-dialect=desc  \-mtls\-dialect=trad
\&\-mrvv\-vector\-bits=\fR\fIvalue\fR  \fB\-mrvv\-max\-lmul=\fR\fIvalue\fR
\&\fB\-madjust\-lmul\-cost  \-mmax\-vectorization  \-mno\-autovec\-segment\fR
.Sp
\&\fIگزینه‌های RL78\fR (\fBRL78 Options\fR)
\&\fB\-msim  \-mallregs  \-mrelax  \-mes0
\&\-mmul=none  \-mmul=g13  \-mmul=g14  \-mmul=rl78
\&\-mcpu=g10  \-mcpu=g13  \-mcpu=g14  \-mcpu=rl78
\&\-mg10  \-mg13  \-mg14  \-mrl78
\&\-msave\-mduc\-in\-interrupts\fR
.Sp
\&\fIگزینه‌های RS/6000 و PowerPC\fR (\fBRS/6000 and PowerPC Options\fR)
\&\fB\-mcpu=\fR\fIcpu\-type\fR
\&\fB\-mtune=\fR\fIcpu\-type\fR
\&\fB\-mcmodel=\fR\fIcode\-model\fR  \fB\-mprofile\-kernel
\&\-mpowerpc64
\&\-maltivec
\&\-mpowerpc\-gpopt  \-mpowerpc\-gfxopt  \-mmfcrf  \-mpopcntb  \-mpopcntd
\&\-mfprnd  \-mcmpb  \-mhard\-dfp
\&\-mfull\-toc  \-mminimal\-toc  \-mno\-fp\-in\-toc  \-mno\-sum\-in\-toc
\&\-maix64  \-maix32  \-m64  \-m32  \-mxl\-compat  \-mpe
\&\-malign\-power  \-malign\-natural
\&\-msoft\-float  \-mhard\-float  \-mmultiple  \-mupdate
\&\-mavoid\-indexed\-addresses
\&\-mfused\-madd  \-mbit\-align  \-mbit\-word
\&\-mstrict\-align  \-mrelocatable  \-mrelocatable\-lib
\&\-mlittle  \-mlittle\-endian  \-mbig  \-mbig\-endian
\&\-mdynamic\-no\-pic  \-msingle\-pic\-base
\&\-mprioritize\-restricted\-insns=\fR\fIpriority\fR
\&\fB\-msched\-costly\-dep=\fR\fIdependence_type\fR
\&\fB\-minsert\-sched\-nops=\fR\fIscheme\fR
\&\fB\-mcall\-aixdesc  \-mcall\-eabi  \-mcall\-freebsd
\&\-mcall\-linux  \-mcall\-netbsd  \-mcall\-openbsd
\&\-mcall\-sysv  \-mcall\-sysv\-eabi  \-mcall\-sysv\-noeabi
\&\-mtraceback=\fR\fItraceback_type\fR
\&\fB\-maix\-struct\-return  \-msvr4\-struct\-return
\&\-mabi=\fR\fIabi\-type\fR  \fB\-msecure\-plt  \-mbss\-plt
\&\-msplit\-patch\-nops
\&\-mregnames  \-mlongcall  \-mpltseq  \-mtls\-markers
\&\-mblock\-move\-inline\-limit=\fR\fInum\fR
\&\fB\-mblock\-compare\-inline\-limit=\fR\fInum\fR
\&\fB\-mblock\-compare\-inline\-loop\-limit=\fR\fInum\fR
\&\fB\-mblock\-ops\-unaligned\-vsx
\&\-mstring\-compare\-inline\-limit=\fR\fInum\fR
\&\fB\-misel  \-mvsx  \-mvrsave  \-mmulhw  \-mdlmzb  \-mprototype
\&\-msim  \-mmvme  \-mads  \-myellowknife  \-memb  \-meabi  \-msdata
\&\-msdata=\fR\fIopt\fR  \fB\-mreadonly\-in\-sdata  \-mvxworks  \-G\fR \fInum\fR
\&\fB\-mrecip  \-mrecip=\fR\fIopt\fR  \fB\-mno\-recip  \-mrecip\-precision
\&\-mveclibabi=\fR\fItype\fR  \fB\-mfriz
\&\-mpointers\-to\-nested\-functions  \-msave\-toc\-indirect  \-mpower8\-fusion
\&\-mcrypto  \-mhtm  \-mquad\-memory  \-mquad\-memory\-atomic
\&\-mcompat\-align\-parm
\&\-mfloat128  \-mfloat128\-hardware
\&\-mgnu\-attribute
\&\-mstack\-protector\-guard=\fR\fIguard\fR  \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR  \fB\-mprefixed
\&\-mpcrel  \-mmma  \-mdense\-math  \-mrop\-protect  \-mprivileged
\&\-mno\-splat\-word\-constant  \-mno\-splat\-float\-constant
\&\-mno\-ieee128\-constant  \-mno\-warn\-altivec\-long\fR
.Sp
\&\fIگزینه‌های RX\fR (\fBRX Options\fR)
\&\fB\-m64bit\-doubles  \-m32bit\-doubles  \-fpu  \-nofpu
\&\-mcpu=\fR\fIname\fR
\&\fB\-mbig\-endian\-data  \-mlittle\-endian\-data
\&\-msmall\-data\-limit=\fR\fIN\fR
\&\fB\-msim  \-mas100\-syntax  \-mrelax
\&\-mmax\-constant\-size=\fR\fIN\fR  \fB\-mint\-register=\fR\fIN\fR
\&\fB\-mpid  \-mno\-allow\-string\-insns  \-mjsr
\&\-mno\-warn\-multiple\-fast\-interrupts  \-msave\-acc\-in\-interrupts
\&\-mlra\fR
.Sp
\&\fIگزینه‌های S/390 و zSeries\fR (\fBS/390 and zSeries Options\fR)
\&\fB\-mtune=\fR\fIcpu\-type\fR  \fB\-march=\fR\fIcpu\-type\fR
\&\fB\-mhard\-float  \-msoft\-float  \-mhard\-dfp
\&\-mlong\-double\-64  \-mlong\-double\-128
\&\-mbackchain  \-mpacked\-stack
\&\-msmall\-exec  \-mmvcle
\&\-m64  \-m31  \-mdebug  \-mesa  \-mzarch
\&\-mhtm  \-mvx  \-mzvector
\&\-mtpf\-trace  \-mtpf\-trace\-skip  \-mmain
\&\-mfused\-madd  \-mno\-fused\-madd
\&\-mwarn\-framesize=\fR\fIframesize\fR  \fB\-mwarn\-dynamicstack
\&\-mstack\-size=\fR\fIstack\-size\fR  \fB\-mno\-stack\-size
\&\-mstack\-guard=\fR\fIstack\-guard\fR  \fB\-mno\-stack\-guard
\&\-mstack\-protector\-guard=\fR\fIguard\fR
\&\fB\-mstack\-protector\-guard\-record
\&\-mhotpatch=\fR\fIpre\-halfwords\fR\fB,\fR\fIpost\-halfwords\fR
\&\fB\-mno\-pic\-data\-is\-text\-relative
\&\-mindirect\-branch=\fR\fIchoice\fR
\&\fB\-mindirect\-branch\-jump=\fR\fIchoice\fR  \fB\-mindirect\-branch\-call=\fR\fIchoice\fR
\&\fB\-mfunction\-return=\fR\fIchoice\fR
\&\fB\-mfunction\-return\-mem=\fR\fIchoice\fR  \fB\-mfunction\-return\-reg=\fR\fIchoice\fR
\&\fB\-mindirect\-branch\-table
\&\-mfentry  \-mrecord\-mcount  \-mnop\-mcount
\&\-mpreserve\-args  \-munaliged\-symbols\fR
.Sp
\&\fIگزینه‌های SH\fR (\fBSH Options\fR)
\&\fB\-m1  \-m2  \-m2e
\&\-m2a  \-m2a\-nofpu  \-m2a\-single  \-m2a\-single\-only
\&\-m3  \-m3e
\&\-m4  \-m4\-nofpu  \-m4\-single  \-m4\-single\-only
\&\-m4\-100  \-m4\-100\-nofpu  \-m4\-100\-single  \-m4\-100\-single\-only
\&\-m4\-200  \-m4\-200\-nofpu  \-m4\-200\-single  \-m4\-200\-single\-only
\&\-m4\-300  \-m4\-300\-nofpu  \-m4\-300\-single  \-m4\-300\-single\-only
\&\-m4\-340  \-m4\-400  \-m4\-500
\&\-m4a  \-m4al  \-m4a\-nofpu  \-m4a\-single  \-m4a\-single\-only
\&\-mb  \-ml  \-mdalign  \-mrelax
\&\-mbigtable  \-mbitops  \-mfmovd  \-mrenesas  \-mnomacsave
\&\-mieee  \-misize  \-minline\-ic_invalidate
\&\-mprefergot  \-musermode  \-multcost=\fR\fInumber\fR  \fB\-mdiv=\fR\fIstrategy\fR
\&\fB\-mdivsi3_libfunc=\fR\fIname\fR  \fB\-mfixed\-range=\fR\fIregister\-range\fR
\&\fB\-maccumulate\-outgoing\-args
\&\-matomic\-model=\fR\fIatomic\-model\fR
\&\fB\-mbranch\-cost=\fR\fInum\fR  \fB\-mzdcbranch
\&\-mcbranch\-force\-delay\-slot
\&\-mfsca  \-mfsrra
\&\-mpretend\-cmove  \-mfdpic  \-mtas  \-mlra\fR
.Sp
\&\fIگزینه‌های Solaris 2\fR (\fBSolaris 2 Options\fR)
\&\fB\-mclear\-hwcap  \-mno\-clear\-hwcap  \-mimpure\-text  \-mno\-impure\-text
\&\-gsctf\fR
.Sp
\&\fIگزینه‌های SPARC\fR (\fBSPARC Options\fR)
\&\fB\-mcpu=\fR\fIcpu\-type\fR
\&\fB\-mtune=\fR\fIcpu\-type\fR
\&\fB\-mcmodel=\fR\fIcode\-model\fR
\&\fB\-mmemory\-model=\fR\fImem\-model\fR
\&\fB\-m32  \-m64  \-mptr32  \-mptr64  \-mapp\-regs
\&\-mfaster\-structs  \-mflat
\&\-mfpu  \-mhard\-float  \-msoft\-float
\&\-mhard\-quad\-float  \-msoft\-quad\-float
\&\-mstack\-bias  \-mstd\-struct\-return
\&\-munaligned\-doubles  \-muser\-mode
\&\-mv8plus  \-mvis
\&\-mvis2  \-mvis3  \-mvis3b  \-mvis4  \-mvis4b
\&\-mcbcond  \-mfmaf  \-mfsmuld  \-mpopc  \-msubxc
\&\-mfix\-at697f  \-mfix\-ut699  \-mfix\-ut700  \-mfix\-gr712rc\fR
.Sp
\&\fIگزینه‌های System V\fR (\fBSystem V Options\fR)
\&\fB\-YP,\fR\fIpaths\fR  \fB\-Ym,\fR\fIdir\fR
.Sp
\&\fIگزینه‌های V850\fR (\fBV850 Options\fR)
\&\fB\-mlong\-calls  \-mep
\&\-mprolog\-function  \-mspace
\&\-mtda=\fR\fIn\fR  \fB\-msda=\fR\fIn\fR  \fB\-mzda=\fR\fIn\fR
\&\fB\-mv850  \-mv850e3v5  \-m850e2v4  \-mv850e2v3
\&\-mv850e2  \-mv850e1  \-mv850es  \-mv850e
\&\-mdisable\-callt  \-mrelax  \-mlong\-jumps
\&\-msoft\-float  \-mhard\-float  \-mloop
\&\-mrh850\-abi  \-mghs  \-mgcc\-abi
\&\-m8byte\-align  \-mbig\-switch  \-mapp\-regs  \-msmall\-sld
\&\-mno\-strict\-align  \-mjump\-tables\-in\-data\-section\fR
.Sp
\&\fIگزینه‌های VAX\fR (\fBVAX Options\fR)
\&\fB\-munix  \-mgnu  \-md  \-md\-float  \-mg  \-mg\-float  \-mlra
\&\-mvaxc\-alignment  \-mqmath\fR.Sp
\&\fIگزینه‌های Visium\fR (\fBVisium Options\fR)
\&\fB\-mdebug  \-msim  \-mfpu  \-mhard\-float  \-msoft\-float
\&\-mcpu=\fR\fIcpu\-type\fR  \fB\-mtune=\fR\fIcpu\-type\fR  \fB\-msv\-mode  \-muser\-mode\fR
.Sp
\&\fIگزینه‌های VMS\fR (\fBVMS Options\fR)
\&\fB\-mvms\-return\-codes  \-mdebug\-main=\fR\fIprefix\fR  \fB\-mmalloc64
\&\-mpointer\-size=\fR\fIsize\fR
.Sp
\&\fIگزینه‌های VxWorks\fR (\fBVxWorks Options\fR)
\&\fB\-mrtp  \-msmp  \-mvthreads  \-non\-static  \-Bstatic  \-Bdynamic
\&\-Xbind\-lazy  \-Xbind\-now\fR
.Sp
\&\fIگزینه‌های x86\fR (\fBx86 Options\fR)
\&\fB\-mtune=\fR\fIcpu\-type\fR  \fB\-march=\fR\fIcpu\-type\fR
\&\fB\-mtune\-ctrl=\fR\fIfeature\-list\fR  \fB\-mdump\-tune\-features  \-mno\-default
\&\-mfpmath=\fR\fIunit\fR
\&\fB\-masm=\fR\fIdialect\fR  \fB\-mno\-fancy\-math\-387
\&\-mno\-fp\-ret\-in\-387  \-m80387  \-mhard\-float  \-msoft\-float  \-mieee\-fp
\&\-mrtd  \-malign\-double
\&\-mpreferred\-stack\-boundary=\fR\fInum\fR
\&\fB\-mincoming\-stack\-boundary=\fR\fInum\fR
\&\fB\-mcld  \-mcx16  \-msahf  \-mmovbe  \-mcrc32  \-mmwait
\&\-mrecip  \-mrecip=\fR\fIopt\fR
\&\fB\-mvzeroupper  \-mstv  \-mprefer\-avx128  \-mprefer\-vector\-width=\fR\fIopt\fR
\&\fB\-mpartial\-vector\-fp\-math
\&\-mmove\-max=\fR\fIbits\fR  \fB\-mstore\-max=\fR\fIbits\fR
\&\fB\-mnoreturn\-no\-callee\-saved\-registers
\&\-mmmx  \-msse  \-msse2  \-msse3  \-mssse3  \-msse4.1  \-msse4.2  \-msse4  \-mavx
\&\-mavx2  \-mavx512f  \-mavx512cd  \-mavx512vl
\&\-mavx512bw  \-mavx512dq  \-mavx512ifma  \-mavx512vbmi  \-msha  \-maes
\&\-mpclmul  \-mfsgsbase  \-mrdrnd  \-mf16c  \-mfma  \-mpconfig  \-mwbnoinvd
\&\-mptwrite  \-mclflushopt  \-mclwb  \-mxsavec  \-mxsaves
\&\-msse4a  \-m3dnow  \-m3dnowa  \-mpopcnt  \-mabm  \-mbmi  \-mtbm  \-mfma4  \-mxop
\&\-madx  \-mlzcnt  \-mbmi2  \-mfxsr  \-mxsave  \-mxsaveopt  \-mrtm  \-mhle  \-mlwp
\&\-mmwaitx  \-mclzero  \-mpku  \-mgfni  \-mvaes  \-mwaitpkg
\&\-mshstk  \-mmanual\-endbr  \-mcet\-switch  \-mforce\-indirect\-call
\&\-mavx512vbmi2  \-mavx512bf16  \-menqcmd
\&\-mvpclmulqdq  \-mavx512bitalg  \-mmovdiri  \-mmovdir64b  \-mavx512vpopcntdq
\&\-mavx512vnni  \-mprfchw  \-mrdpid
\&\-mrdseed  \-msgx  \-mavx512vp2intersect  \-mserialize  \-mtsxldtrk
\&\-mamx\-tile  \-mamx\-int8  \-mamx\-bf16  \-muintr  \-mhreset
\&\-mavxvnni  \-mamx\-fp8  \-mavx512fp16  \-mavxifma  \-mavxvnniint8
\&\-mavxneconvert  \-mcmpccxadd  \-mamx\-fp16  \-mprefetchi  \-mraoint
\&\-mamx\-complex  \-mavxvnniint16  \-msm3  \-msha512  \-msm4  \-mapxf
\&\-musermsr  \-mavx10.1  \-mavx10.2  \-mamx\-avx512  \-mamx\-tf32  \-mmovrs
\&\-mamx\-movrs  \-mavx512bmm  \-mcldemote  \-mms\-bitfields
\&\-mno\-align\-stringops  \-minline\-all\-stringops
\&\-minline\-stringops\-dynamically  \-mstringop\-strategy=\fR\fIalg\fR
\&\fB\-mkl  \-mwidekl
\&\-mmemcpy\-strategy=\fR\fIstrategy\fR  \fB\-mmemset\-strategy=\fR\fIstrategy\fR
\&\fB\-mpush\-args  \-maccumulate\-outgoing\-args  \-m128bit\-long\-double
\&\-m96bit\-long\-double  \-mlong\-double\-64  \-mlong\-double\-80  \-mlong\-double\-128
\&\-mregparm=\fR\fInum\fR  \fB\-msseregparm
\&\-mveclibabi=\fR\fItype\fR  \fB\-mvect8\-ret\-in\-mem
\&\-mpc32  \-mpc64  \-mpc80  \-mdaz\-ftz  \-mstackrealign  \-mstack\-arg\-probe
\&\-momit\-leaf\-frame\-pointer  \-mno\-red\-zone  \-mno\-tls\-direct\-seg\-refs
\&\-mcmodel=\fR\fIcode\-model\fR  \fB\-mabi=\fR\fIname\fR  \fB\-maddress\-mode=\fR\fImode\fR
\&\fB\-m32  \-m64  \-mx32  \-m16  \-miamcu  \-mlarge\-data\-threshold=\fR\fInum\fR
\&\fB\-msse2avx  \-mfentry  \-mrecord\-mcount  \-mnop\-mcount  \-m8bit\-idiv
\&\-minstrument\-return=\fR\fItype\fR  \fB\-mrecord\-return
\&\-mfentry\-name=\fR\fIname\fR  \fB\-mfentry\-section=\fR\fIname\fR
\&\fB\-mskip\-rax\-setup
\&\-mavx256\-split\-unaligned\-load  \-mavx256\-split\-unaligned\-store
\&\-malign\-data=\fR\fItype\fR  \fB\-mstack\-protector\-guard=\fR\fIguard\fR
\&\fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR
\&\fB\-mstack\-protector\-guard\-symbol=\fR\fIsymbol\fR
\&\fB\-mgeneral\-regs\-only  \-mcall\-ms2sysv\-xlogues  \-mtls\-dialect=\fR\fItype\fR
\&\fB\-mrelax\-cmpxchg\-loop
\&\-mindirect\-branch=\fR\fIchoice\fR  \fB\-mfunction\-return=\fR\fIchoice\fR
\&\fB\-mindirect\-branch\-register  \-mharden\-sls=\fR\fIchoice\fR
\&\fB\-mindirect\-branch\-cs\-prefix  \-mapx\-inline\-asm\-use\-gpr32
\&\-mgather  \-mscatter
\&\-mneeded  \-mno\-direct\-extern\-access
\&\-munroll\-only\-small\-loops  \-mdispatch\-scheduler  \-mlam=\fR\fIchoice\fR
.Sp
\&\fIگزینه‌های x86 Windows\fR
گزینه‌های Cygwin و MinGW را ببینید.
.Sp
\&\fIگزینه‌های Xstormy16\fR (\fBXstormy16 Options\fR)
\&\fB\-msim\fR
.Sp
\&\fIگزینه‌های Xtensa\fR (\fBXtensa Options\fR)
\&\fB\-mconst16  \-mforce\-no\-pic  \-mno\-serialize\-volatile
\&\-mtext\-section\-literals  \-mauto\-litpools  \-mno\-target\-align
\&\-mlongcalls  \-mabi=\fR\fIabi\-type\fR
\&\fB\-mextra\-l32r\-costs=\fR\fIcycles\fR  \fB\-mstrict\-align\fR
.Sp
\&\fIگزینه‌های zSeries\fR
گزینه‌های S/390 و zSeries را ببینید..SS "گزینه‌های کنترل نوع خروجی (Options Controlling the Kind of Output)"
.IX Subsection "Options Controlling the Kind of Output"
فرایند کامپایل می‌تواند شامل حداکثر چهار مرحله باشد: پیش‌پردازش، کامپایل
اصلی، اسمبلی و پیونددهی، که همواره به همین ترتیب انجام می‌شوند. کامپایلر GCC
می‌تواند چند فایل را پیش‌پردازش و کامپایل کرده و آن‌ها را به چند فایل
ورودی اسمبلر، یا به یک فایل ورودی اسمبلر تبدیل کند؛ سپس هر فایل
ورودی اسمبلر یک فایل شیء (object file) تولید می‌کند و پیونددهی تمامی
فایل‌های شیء (چه مواردی که تازه کامپایل شده‌اند و چه مواردی که به عنوان ورودی مشخص شده‌اند)
را در قالب یک فایل اجرایی با یکدیگر ترکیب می‌کند.
.PP
برای هر فایل ورودی مشخص، پسوند نام فایل تعیین می‌کند که چه نوع
کامپایلی انجام شود:
.IP \fIfile\fR\fB.c\fR 4
.IX Item "file.c"
کد منبع C که باید پیش‌پردازش شود.
.IP \fIfile\fR\fB.i\fR 4
.IX Item "file.i"
کد منبع C که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.ii\fR 4
.IX Item "file.ii"
کد منبع C++ که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.m\fR 4
.IX Item "file.m"
کد منبع Objective\-C. توجه داشته باشید که برای کارکرد یک برنامهٔ Objective\-C
باید آن را با کتابخانهٔ \fIlibobjc\fR پیوند دهید.
.IP \fIfile\fR\fB.mi\fR 4
.IX Item "file.mi"
کد منبع Objective\-C که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.mm\fR 4
.IX Item "file.mm"
.PD 0
.IP \fIfile\fR\fB.M\fR 4
.IX Item "file.M"
.PD
کد منبع Objective\-C++. توجه داشته باشید که برای کارکرد یک برنامهٔ Objective\-C++
باید آن را با کتابخانهٔ \fIlibobjc\fR پیوند دهید. توجه کنید که \fB.M\fR دقیقاً
به یک حرف بزرگ M اشاره دارد.
.IP \fIfile\fR\fB.mii\fR 4
.IX Item "file.mii"
کد منبع Objective\-C++ که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.h\fR 4
.IX Item "file.h"
فایل سرآیند C، C++، Objective\-C یا Objective\-C++ که باید به یک
سرآیند پیش‌کامپایل‌شده (پیش‌فرض) تبدیل شود، یا فایل سرآیند C و C++ که باید به یک
Ada spec (از طریق گزینهٔ \fB\-fdump\-ada\-spec\fR) تبدیل شود.
.IP \fIfile\fR\fB.cc\fR 4
.IX Item "file.cc"
.PD 0
.IP \fIfile\fR\fB.cp\fR 4
.IX Item "file.cp"
.IP \fIfile\fR\fB.cxx\fR 4
.IX Item "file.cxx"
.IP \fIfile\fR\fB.cpp\fR 4
.IX Item "file.cpp"
.IP \fIfile\fR\fB.CPP\fR 4
.IX Item "file.CPP"
.IP \fIfile\fR\fB.c++\fR 4
.IX Item "file.c++"
.IP \fIfile\fR\fB.C\fR 4
.IX Item "file.C"
.PD
کد منبع C++ که باید پیش‌پردازش شود. توجه داشته باشید که در \fB.cxx\fR،
دو حرف آخر هر دو باید دقیقاً \fBx\fR باشند. به همین ترتیب،
\&\fB.C\fR به یک حرف بزرگ C اشاره دارد.
.IP \fIfile\fR\fB.mm\fR 4
.IX Item "file.mm"
.PD 0
.IP \fIfile\fR\fB.M\fR 4
.IX Item "file.M"
.PD
کد منبع Objective\-C++ که باید پیش‌پردازش شود.
.IP \fIfile\fR\fB.mii\fR 4
.IX Item "file.mii"
کد منبع Objective\-C++ که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.hh\fR 4
.IX Item "file.hh"
.PD 0
.IP \fIfile\fR\fB.H\fR 4
.IX Item "file.H"
.IP \fIfile\fR\fB.hp\fR 4
.IX Item "file.hp"
.IP \fIfile\fR\fB.hxx\fR 4
.IX Item "file.hxx"
.IP \fIfile\fR\fB.hpp\fR 4
.IX Item "file.hpp"
.IP \fIfile\fR\fB.HPP\fR 4
.IX Item "file.HPP"
.IP \fIfile\fR\fB.h++\fR 4
.IX Item "file.h++"
.IP \fIfile\fR\fB.tcc\fR 4
.IX Item "file.tcc"
.PD
فایل سرآیند C++ که باید به یک سرآیند پیش‌کامپایل‌شده یا Ada spec تبدیل شود.
.IP \fIfile\fR\fB.f\fR 4
.IX Item "file.f"
.PD 0
.IP \fIfile\fR\fB.for\fR 4
.IX Item "file.for"
.IP \fIfile\fR\fB.ftn\fR 4
.IX Item "file.ftn"
.IP \fIfile\fR\fB.fi\fR 4
.IX Item "file.fi"
.PD
کد منبع فرترن با قالب ثابت (Fixed form) که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.F\fR 4
.IX Item "file.F"
.PD 0
.IP \fIfile\fR\fB.FOR\fR 4
.IX Item "file.FOR"
.IP \fIfile\fR\fB.fpp\fR 4
.IX Item "file.fpp"
.IP \fIfile\fR\fB.FPP\fR 4
.IX Item "file.FPP"
.IP \fIfile\fR\fB.FTN\fR 4
.IX Item "file.FTN"
.PD
کد منبع فرترن با قالب ثابت (Fixed form) که باید پیش‌پردازش شود (با
پیش‌پردازندهٔ سنتی).
.IP \fIfile\fR\fB.f90\fR 4
.IX Item "file.f90"
.PD 0
.IP \fIfile\fR\fB.f95\fR 4
.IX Item "file.f95"
.IP \fIfile\fR\fB.f03\fR 4
.IX Item "file.f03"
.IP \fIfile\fR\fB.f08\fR 4
.IX Item "file.f08"
.IP \fIfile\fR\fB.fii\fR 4
.IX Item "file.fii"
.PD
کد منبع فرترن با قالب آزاد (Free form) که نباید پیش‌پردازش شود.
.IP \fIfile\fR\fB.F90\fR 4
.IX Item "file.F90"
.PD 0
.IP \fIfile\fR\fB.F95\fR 4
.IX Item "file.F95"
.IP \fIfile\fR\fB.F03\fR 4
.IX Item "file.F03"
.IP \fIfile\fR\fB.F08\fR 4
.IX Item "file.F08"
.PD
کد منبع فرترن با قالب آزاد (Free form) که باید پیش‌پردازش شود (با
پیش‌پردازندهٔ سنتی).
.IP \fIfile\fR\fB.cob\fR 4
.IX Item "file.cob"
.PD 0
.IP \fIfile\fR\fB.COB\fR 4
.IX Item "file.COB"
.IP \fIfile\fR\fB.cbl\fR 4
.IX Item "file.cbl"
.IP \fIfile\fR\fB.CBL\fR 4
.IX Item "file.CBL"
.PD
کد منبع COBOL.
.IP \fIfile\fR\fB.go\fR 4
.IX Item "file.go"
کد منبع Go.
.IP \fIfile\fR\fB.d\fR 4
.IX Item "file.d"
کد منبع D.
.IP \fIfile\fR\fB.di\fR 4
.IX Item "file.di"
فایل رابط (interface) دی.
.IP \fIfile\fR\fB.dd\fR 4
.IX Item "file.dd"
کد مستندات D (موسوم به Ddoc).
.IP \fIfile\fR\fB.ads\fR 4
.IX Item "file.ads"
فایل کد منبع Ada که حاوی اعلان یک واحد کتابخانه‌ای (اعلان یک
بسته، زیربرنامه، یا جنریک، یا نمونه‌سازی از جنریک)، یا اعلان تغییر نام
یک واحد کتابخانه‌ای (اعلان تغییر نام یک بسته، جنریک، یا زیربرنامه) است.
به چنین فایل‌هایی \fIspecs\fR نیز می‌گویند.
.IP \fIfile\fR\fB.adb\fR 4
.IX Item "file.adb"
فایل کد منبع Ada شامل بدنهٔ یک واحد کتابخانه‌ای (بدنهٔ یک
زیربرنامه یا بسته). به چنین فایل‌هایی \fIbodies\fR نیز گفته می‌شود.
.IP \fIfile\fR\fB.s\fR 4
.IX Item "file.s"
کد اسمبلی (Assembler code)..IP \fIfile\fR\fB.S\fR 4
.IX Item "file.S"
.PD 0
.IP \fIfile\fR\fB.sx\fR 4
.IX Item "file.sx"
.PD
کد اسمبلی که باید پیش‌پردازش شود.
.IP \fIother\fR 4
.IX Item "other"
یک فایل شیء که مستقیماً به مرحلهٔ پیونددهی فرستاده می‌شود.
هر نام فایلی بدون پسوند شناخته‌شده به همین صورت مدیریت می‌شود.
.PP
می‌توانید زبان ورودی را صریحاً با گزینهٔ \fB\-x\fR مشخص کنید:
.IP "\fB\-x\fR \fIlanguage\fR" 4
.IX Item "-x language"
.PD 0
.IP \fB\-\-language=\fR\fIlanguage\fR 4
.IX Item "--language=language"
.IP "\fB\-\-language\fR \fIlanguage\fR" 4
.IX Item "--language language"
.PD
زبان (\fIlanguage\fR) را به‌طور صریح برای فایل‌های ورودی پس از آن مشخص می‌کند
(به‌جای اینکه کامپایلر بر اساس پسوند نام فایل، یک پیش‌فرض را انتخاب کند).
این گزینه بر تمام فایل‌های ورودی بعدی تا گزینهٔ بعدی \fB\-x\fR اعمال می‌شود.
مقادیر ممکن برای \fIlanguage\fR عبارتند از:
.Sp
.Vb 10
\&        c  c\-header  cpp\-output
\&        c++  c++\-header  c++\-system\-header c++\-user\-header c++\-cpp\-output
\&        c++\-system\-module
\&        objective\-c  objective\-c\-header  objective\-c\-cpp\-output  objc\-cpp\-output
\&        objective\-c++  objective\-c++\-header  objective\-c++\-cpp\-output
\&        objc++\-cpp\-output
\&        assembler  assembler\-with\-cpp
\&        ada  adascil  adawhy
\&        cobol
\&        d
\&        f77  f77\-cpp\-input  f95  f95\-cpp\-input
\&        go
\&        modula\-2  modula\-2\-cpp\-output
\&        rust
\&        algol68
\&        lto
.Ve
.Sp
توجه داشته باشید که \fB\-x\fR بر یک استاندارد زبانی خاص دلالت نمی‌کند.
برای نمونه، ممکن است \fB\-x f77\fR برای برخی از کدهای مبدأ قدیمی‌تر،
به گزینهٔ \fB\-std=legacy\fR نیز نیاز داشته باشد.
.IP "\fB\-x none\fR" 4
.IX Item "-x none"
هرگونه تعیین زبان را غیرفعال می‌کند، به‌طوری که فایل‌های پس از آن بر اساس
پسوند نام فایل‌هایشان پردازش می‌شوند (گویی اصلاً از \fB\-x\fR استفاده نشده است).
.PP
اگر تنها بخش‌هایی از مراحل کامپایل را می‌خواهید، می‌توانید از
\&\fB\-x\fR (یا پسوندهای نام فایل) استفاده کنید تا به \fBgcc\fR بگویید از کجا شروع کند، و
یکی از گزینه‌های \fB\-c\fR، \fB\-S\fR، یا \fB\-E\fR را به کار ببرید تا مشخص کنید
\&\fBgcc\fR کجا باید متوقف شود. توجه داشته باشید که برخی از ترکیب‌ها (برای نمونه،
\&\fB\-x cpp\-output \-E\fR) به \fBgcc\fR دستور می‌دهند که اصلاً هیچ کاری انجام ندهد.
.IP \fB\-c\fR 4
.IX Item "-c"
.PD 0
.IP \fB\-\-compile\fR 4
.IX Item "--compile"
.PD
فایل‌های مبدأ را کامپایل یا اسمبلی می‌کند، اما آن‌ها را پیوند نمی‌دهد. مرحلهٔ
پیونددهی انجام نمی‌شود. خروجی نهایی به‌صورت یک فایل شیء (object file)
به‌ازای هر فایل مبدأ خواهد بود.
.Sp
به‌طور پیش‌فرض، نام فایل شیء برای یک فایل مبدأ با جایگزین کردن
پسوندهای \fB.c\fR، \fB.i\fR، \fB.s\fR و غیره با \fB.o\fR ساخته می‌شود.
.Sp
فایل‌های ورودی ناشناخته که نیازی به کامپایل یا اسمبلی ندارند، نادیده گرفته می‌شوند.
.IP \fB\-S\fR 4
.IX Item "-S"
.PD 0
.IP \fB\-\-assemble\fR 4
.IX Item "--assemble"
.PD
پس از مرحلهٔ کامپایل واقعی متوقف می‌شود؛ عملیات اسمبلی را انجام نمی‌دهد. خروجی
به‌صورت یک فایل کد اسمبلی برای هر فایل ورودیِ غیر اسمبلیِ مشخص‌شده است.
.Sp
به‌طور پیش‌فرض، نام فایل اسمبلی برای یک فایل مبدأ با جایگزین کردن
پسوندهای \fB.c\fR، \fB.i\fR و غیره با \fB.s\fR ساخته می‌شود.
.Sp
فایل‌های ورودی که نیازی به کامپایل ندارند نادیده گرفته می‌شوند.
.IP \fB\-E\fR 4
.IX Item "-E"
.PD 0
.IP \fB\-\-preprocess\fR 4
.IX Item "--preprocess"
.PD
پس از مرحلهٔ پیش‌پردازش متوقف می‌شود؛ کامپایلر واقعی را اجرا نمی‌کند. خروجی
به‌صورت کد مبدأ پیش‌پردازش‌شده است که به خروجی استاندارد فرستاده می‌شود.
.Sp
فایل‌های ورودی که نیازی به پیش‌پردازش ندارند نادیده گرفته می‌شوند.
.IP "\fB\-o\fR \fIfile\fR" 4
.IX Item "-o file"
.PD 0
.IP \fB\-\-output=\fR\fIfile\fR 4
.IX Item "--output=file"
.IP "\fB\-\-output\fR \fIfile\fR" 4
.IX Item "--output file"
.PD
خروجی اصلی را در فایل \fIfile\fR قرار می‌دهد. این گزینه برای هر نوع خروجیِ
تولیدشده اعمال می‌شود، چه یک فایل اجرایی باشد، چه یک فایل شیء،
یک فایل اسمبلی، یا کد C پیش‌پردازش‌شده.
.Sp
اگر \fB\-o\fR مشخص نشود، پیش‌فرض این است که فایل اجرایی در \fIa.out\fR، فایل
شیءِ مربوط به \&\fIsource.suffix\fR در \fIsource.o\fR، فایل اسمبلی آن در \fIsource.s\fR،
فایل سرآیند پیش‌کامپایل‌شده در \&\fIsource.suffix.gch\fR، و تمام کدهای C پیش‌پردازش‌شده
در خروجی استاندارد قرار گیرند.
.Sp
اگرچه \fB\-o\fR تنها خروجی اصلی را نام‌گذاری می‌کند، اما بر نام‌گذاری خروجی‌های
کمکی (auxiliary) و خروجی‌های رونوشت (dump) نیز اثر می‌گذارد. مثال‌های زیر را ببینید.
مگر در صورت بازنویسی، هر دو خروجی کمکی و رونوشت در همان دایرکتوری خروجی
اصلی قرار می‌گیرند. در خروجی‌های کمکی، پسوند فایل ورودی با پسوند نوع فایل
خروجی کمکی جایگزین می‌شود؛ در خروجی‌های رونوشت، پسوند فایل رونوشت به انتهای
پسوند فایل ورودی اضافه می‌شود. در دستورات کامپایل، نام پایهٔ (base name) هر دو
خروجی کمکی و رونوشت همان نام خروجی اصلی است؛ در دستورات کامپایل و پیوند، نام
خروجی اصلی منهای پسوند اجرایی با نام فایل ورودی ترکیب می‌شود. اگر هر دو، بدون
در نظر گرفتن پسوند، نام پایهٔ یکسانی داشته باشند، نتیجهٔ ترکیب همان نام پایه
خواهد بود؛ در غیر این صورت، با یک خط تیره (\-) به یکدیگر متصل می‌شوند.
.Sp
.Vb 1
\&        gcc \-c foo.c ...
.Ve
.Sp
از \fIfoo.o\fR به‌عنوان خروجی اصلی استفاده می‌کند و خروجی‌های کمکی و
رونوشت را در کنار آن قرار می‌دهد؛ مثلاً فایل کمکی \fIfoo.dwo\fR برای
\&\fB\-gsplit\-dwarf\fR، و فایل رونوشت \fIfoo.c.???r.final\fR برای
\&\fB\-fdump\-rtl\-final\fR.
.Sp
اگر یک فایل خروجیِ غیر پیونددهنده صریحاً مشخص شده باشد، فایل‌های کمکی و رونوشت
به‌طور پیش‌فرض همان نام پایه را می‌گیرند:
.Sp
.Vb 1
\&        gcc \-c foo.c \-o dir/foobar.o ...
.Ve
.Sp
خروجی‌های کمکی را به نام \fIdir/foobar.*\fR و خروجی‌های رونوشت را
به نام \&\fIdir/foobar.c.*\fR نام‌گذاری خواهد کرد.
.Sp
در عوض، یک خروجی پیونددهنده به خروجی‌های کمکی و رونوشت پیشوند می‌زند:
.Sp
.Vb 1
\&        gcc foo.c bar.c \-o dir/foobar ...
.Ve
.Sp
عموماً خروجی‌های کمکی را به نام \fIdir/foobar\-foo.*\fR و
\&\fIdir/foobar\-bar.*\fR، و خروجی‌های رونوشت را به نام \fIdir/foobar\-foo.c.*\fR و
\&\fIdir/foobar\-bar.c.*\fR نام‌گذاری خواهد کرد.
.Sp
تنها استثنا در موارد بالا زمانی است که فایل اجرایی نام پایه‌ای یکسان
با تک ورودی داشته باشد:
.Sp
.Vb 1
\&        gcc foo.c \-o dir/foo ...
.Ve
.Sp
در این حالت، خروجی‌های کمکی با نام \fIdir/foo.*\fR و خروجی‌های رونوشت
با نام \fIdir/foo.c.*\fR نام‌گذاری می‌شوند.
.Sp
مکان و نام‌های خروجی‌های کمکی و رونوشت را می‌توان با گزینه‌های
\fB\-dumpbase\fR، \fB\-dumpbase\-ext\fR، \&\fB\-dumpdir\fR،
\&\fB\-save\-temps=cwd\fR و \&\fB\-save\-temps=obj\fR تنظیم کرد.
.IP "\fB\-dumpbase\fR \fIdumpbase\fR" 4
.IX Item "-dumpbase dumpbase"
.PD 0
.IP "\fB\-\-dumpbase\fR \fIdumpbase\fR" 4
.IX Item "--dumpbase dumpbase"
.PD
این گزینه نام پایه را برای فایل‌های خروجی کمکی و رونوشت (dump) تنظیم می‌کند.
این گزینه بر نام فایل خروجی اصلی تأثیری ندارد. خروجی‌های میانی،
در صورت نگهداری، به‌عنوان خروجی‌های اصلی محسوب نمی‌شوند، بلکه خروجی‌های
کمکی در نظر گرفته می‌شوند:
.Sp.Vb 1
\&        gcc \-save\-temps \-S foo.c
.Ve
.Sp
فایل پیش‌پردازش‌شدهٔ (دیگر غیر) موقت را در \fIfoo.i\fR ذخیره کرده و
سپس به فایل خروجی (ضمنی) \fIfoo.s\fR کامپایل می‌کند، در حالی که:
.Sp
.Vb 1
\&        gcc \-save\-temps \-dumpbase save\-foo \-c foo.c
.Ve
.Sp
پیش‌پردازش را در \fIsave\-foo.i\fR انجام می‌دهد، به \fIsave\-foo.s\fR (که اکنون
یک خروجی میانی و در نتیجه کمکی است) کامپایل می‌کند، و سپس به فایل
خروجی (ضمنی) \fIfoo.o\fR اسمبلی می‌کند.
.Sp
در نبود این گزینه، فایل‌های dump و aux نام خود را از فایل ورودی یا در
صورت تعیین صریح، از فایل خروجی (غیر پیونددهنده) می‌گیرند: فایل‌های خروجی
dump (برای نمونه مواردی که با گزینه‌های \fB\-fdump\-*\fR درخواست
شده‌اند) همراه با پسوند نام ورودی، و فایل‌های خروجی aux (مواردی که
با سایر گزینه‌های غیر dump درخواست شده‌اند، مانند \f(CW\*(C`\-save\-temps\*(C'\fR،
\&\f(CW\*(C`\-gsplit\-dwarf\*(C'\fR و \f(CW\*(C`\-fcallgraph\-info\*(C'\fR) بدون آن.
.Sp
تفکیک مشابه پسوند برای خروجی‌های dump و aux را می‌توان برای \fB\-dumpbase basename.suf\fR
که صریحاً مشخص شده است نیز با تعیین \&\fB\-dumpbase\-ext .suf\fR به دست آورد.
.Sp
اگر \fIdumpbase\fR به‌طور صریح با هر مؤلفه‌ای از دایرکتوری مشخص شود،
هرگونه تعیین \fIdumppfx\fR (مانند \fB\-dumpdir\fR یا
\&\fB\-save\-temps=*\fR) نادیده گرفته می‌شود و \fIdumpbase\fR به جای الحاق به
آن، کاملاً جایگزینش می‌شود:
.Sp
.Vb 2
\&        gcc foo.c \-c \-o dir/foo.o \-dumpbase alt/foo \e
\&          \-dumpdir pfx\- \-save\-temps=cwd ...
.Ve
.Sp
خروجی‌های کمکی و dump را با نام \fIalt/foo.*\fR ایجاد می‌کند، و
\&\fIdir/\fR در \fB\-o\fR، پیشوند \fI./\fR ضمنی ناشی از
\&\fB\-save\-temps=cwd\fR، و \fIpfx\-\fR در \fB\-dumpdir\fR را نادیده می‌گیرد.
.Sp
هنگامی که \fB\-dumpbase\fR در دستوری مشخص شود که چندین ورودی را
کامپایل می‌کند، یا کامپایل کرده و سپس پیوند می‌دهد، ممکن است همان‌طور که
ذیل \fB\-dumpdir\fR آمده است، با \&\fIdumppfx\fR ترکیب شود. آنگاه، هر فایل
ورودی با استفاده از \fIdumppfx\fR ترکیبی کامپایل می‌شود و مقادیر پیش‌فرض
برای \fIdumpbase\fR و \fIauxdropsuf\fR برای هر فایل ورودی محاسبه می‌گردد:
.Sp
.Vb 1
\&        gcc foo.c bar.c \-c \-dumpbase main ...
.Ve
.Sp
فایل‌های \fIfoo.o\fR و \fIbar.o\fR را به عنوان خروجی‌های اصلی ایجاد می‌کند، و
با استفاده از \fIdumpbase\fR به عنوان پیشوند، از بازنویسی خروجی‌های کمکی
و dump جلوگیری کرده و خروجی‌های کمکی و dump را به نام‌های \fImain\-foo.*\fR
و \fImain\-bar.*\fR می‌سازد.
.Sp
تعیین یک رشتهٔ خالی به عنوان \fIdumpbase\fR، از اثرگذاری نام پایهٔ خروجی
در نام‌گذاری خروجی‌های کمکی و dump در طول کامپایل جلوگیری می‌کند و
مقادیر پیش‌فرض را محاسبه می‌نماید:
.Sp
.Vb 1
\&        gcc \-c foo.c \-o dir/foobar.o \-dumpbase " ...
.Ve
.Sp
خروجی‌های aux را \fIdir/foo.*\fR و خروجی‌های dump را
\&\fIdir/foo.c.*\fR نام‌گذاری خواهد کرد. توجه کنید که چگونه نام‌های پایهٔ آن‌ها
از نام ورودی گرفته شده است، اما دایرکتوری همچنان به‌طور پیش‌فرض همان دایرکتوری
خروجی است.
.Sp
رشتهٔ خالی dumpbase مانع استفاده از نام پایهٔ خروجی برای خروجی‌های مرحلهٔ
پیونددهی نمی‌شود:
.Sp
.Vb 1
\&        gcc foo.c bar.c \-o dir/foobar \-dumpbase " \-flto ...
.Ve
.Sp
کامپایل فایل‌های مبدأ خروجی‌های کمکی را به نام‌های
\&\fIdir/foo.*\fR و \fIdir/bar.*\fR، و خروجی‌های dump را به نام‌های
\&\fIdir/foo.c.*\fR و \fIdir/bar.c.*\fR نام‌گذاری خواهد کرد. کامپایل مجدد LTO
در طول پیونددهی از \fIdir/foobar.\fR به عنوان پیشوند برای فایل‌های dump و
کمکی استفاده خواهد کرد.
.IP "\fB\-dumpbase\-ext\fR \fIauxdropsuf\fR" 4
.IX Item "-dumpbase-ext auxdropsuf"
.PD 0
.IP "\fB\-\-dumpbase\-ext\fR \fIauxdropsuf\fR" 4
.IX Item "--dumpbase-ext auxdropsuf"
.PD
هنگام شکل‌دهی به نام فایل خروجی کمکی (و نه خروجی dump)، پسوند انتهایی
\fIauxdropsuf\fR را قبل از افزودن هرگونه پسوندی از \fIdumpbase\fR حذف
می‌کند. در صورت عدم تعیین، این گزینه به‌طور پیش‌فرض به پسوند یک
\fIdumpbase\fR پیش‌فرض تبدیل می‌شود، یعنی پسوند فایل ورودی هنگامی که
\&\fB\-dumpbase\fR در خط فرمان وجود ندارد، یا زمانی که \fIdumpbase\fR با
\fIdumppfx\fR ترکیب شده باشد.
.Sp
.Vb 1
\&        gcc foo.c \-c \-o dir/foo.o \-dumpbase x\-foo.c \-dumpbase\-ext .c ...
.Ve
.Sp
\fIdir/foo.o\fR را به عنوان خروجی اصلی ایجاد می‌کند، و با استفاده از مکان
خروجی اصلی و حذف پسوند \fI.c\fR از \fIdumpbase\fR، خروجی‌های کمکی را در
\fIdir/x\-foo.*\fR تولید می‌نماید. خروجی‌های dump پسوند را حفظ می‌کنند:
\fIdir/x\-foo.c.*\fR.
.Sp
اگر این گزینه با پسوند یک \fIdumpbase\fR مشخص‌شده مطابقت نداشته باشد،
نادیده گرفته می‌شود، مگر به عنوان جایگزینی برای پسوند فایل اجرایی هنگام الحاق
نام پایهٔ خروجی پیونددهنده به \fIdumppfx\fR، به شرحی که در زیر آمده است:
.Sp
.Vb 1
\&        gcc foo.c bar.c \-o main.out \-dumpbase\-ext .out ...
.Ve
.Sp
\fImain.out\fR را به عنوان خروجی اصلی ایجاد کرده و با استفاده از نام فایل
اجرایی منهای \&\fIauxdropsuf\fR به عنوان پیشوند، از رونویسی خروجی‌های کمکی و
dump جلوگیری می‌کند، و خروجی‌های کمکی با نام‌های \&\fImain\-foo.*\fR و
\fImain\-bar.*\fR و خروجی‌های dump با نام‌های \&\fImain\-foo.c.*\fR و
\fImain\-bar.c.*\fR را ایجاد می‌نماید.
.IP "\fB\-dumpdir\fR \fIdumppfx\fR" 4
.IX Item "-dumpdir dumppfx"
.PD 0
.IP "\fB\-\-dumpdir\fR \fIdumppfx\fR" 4
.IX Item "--dumpdir dumppfx"
.PD
هنگام شکل‌دهی به نام فایل خروجی کمکی یا dump، از \&\fIdumppfx\fR به عنوان
پیشوند استفاده می‌کند:
.Sp
.Vb 1
\&        gcc \-dumpdir pfx\- \-c foo.c ...
.Ve
.Sp
\fIfoo.o\fR را به عنوان خروجی اصلی، و خروجی‌های کمکی را به نام \&\fIpfx\-foo.*\fR
ایجاد می‌کند، که \fIdumppfx\fR داده‌شده را با \fIdumpbase\fR پیش‌فرض مشتق‌شده
از خروجی اصلی پیش‌فرض (که آن هم به نوبهٔ خود از نام ورودی مشتق شده است)
ترکیب می‌نماید. خروجی‌های dump پسوند نام ورودی را نیز دریافت می‌کنند:
\&\fIpfx\-foo.c.*\fR.
.Sp
اگر قرار است از \fIdumppfx\fR به عنوان نام دایرکتوری استفاده شود، باید به یک
جداکنندهٔ دایرکتوری ختم گردد:
.Sp
.Vb 1
\&        gcc \-dumpdir dir/ \-c foo.c \-o obj/bar.o ...
.Ve
.Sp
\fIobj/bar.o\fR را به عنوان خروجی اصلی، و خروجی‌های کمکی را به نام
\fIdir/bar.*\fR ایجاد می‌کند، که \fIdumppfx\fR داده‌شده را با \fIdumpbase\fR
پیش‌فرض مشتق‌شده از نام خروجی اصلی ترکیب می‌نماید. خروجی‌های dump پسوند
نام ورودی را نیز دریافت می‌کنند: \fIdir/bar.c.*\fR.
.Sp
مقدار پیش‌فرض آن مکان فایل خروجی است، مگر اینکه فایل خروجی یک فایل ویژه مانند
\f(CW\*(C`/dev/null\*(C'\fR باشد. گزینه‌های \&\fB\-save\-temps=cwd\fR و
\fB\-save\-temps=obj\fR این پیش‌فرض را نادیده گرفته و بازنویسی می‌کنند، درست مانند
گزینهٔ صریح \fB\-dumpdir\fR. در صورتی که چندین گزینه از این دست داده شود،
آخرین گزینه اولویت خواهد داشت:
.Sp
.Vb 1
\&        gcc \-dumpdir pfx\- \-c foo.c \-save\-temps=obj ...
.Ve
.Sp
\fIfoo.o\fR را خروجی می‌دهد، با خروجی‌های کمکی به نام \fIfoo.*\fR زیرا
\&\fB\-save\-temps=*\fR جایگزین \fIdumppfx\fR داده‌شده توسط گزینهٔ پیشین
\&\fB\-dumpdir\fR می‌شود. فرقی نمی‌کند که \fB=obj\fR مقدار پیش‌فرض برای
\fB\-save\-temps\fR باشد، یا دایرکتوری خروجی به‌طور ضمنی همان دایرکتوری
جاری باشد. خروجی‌های dump به صورت \&\fIfoo.c.*\fR نام‌گذاری می‌شوند.
.Sp
هنگام کامپایل از چندین فایل ورودی، اگر \fB\-dumpbase\fR مشخص شده باشد،
\fIdumpbase\fR منهای پسوند \fIauxdropsuf\fR و یک خط تیره، به یک \fIdumppfx\fR
صریح یا پیش‌فرض الحاق می‌شوند (یا در صورت داشتن هرگونه مؤلفهٔ دایرکتوری،
کاملاً جایگزین آن می‌گردند)، به گونه‌ای که هر یک از کامپایل‌های چندگانه،
خروجی‌های aux و dump با نام‌های متفاوتی دریافت کنند.
.Sp
.Vb 1
\&        gcc foo.c bar.c \-c \-dumpdir dir/pfx\- \-dumpbase main ...
.Ve
.Sp
خروجی‌های کمکی dump را به صورت \fIdir/pfx\-main\-foo.*\fR و
\&\fIdir/pfx\-main\-bar.*\fR تولید می‌کند که \fIdumpbase\fR\- را به
\fIdumppfx\fR الحاق کرده است. خروجی‌های dump به ترتیب پسوند فایل ورودی را
حفظ می‌کنند: \fIdir/pfx\-main\-foo.c.*\fR و \fIdir/pfx\-main\-bar.c.*\fR. این
مورد را با کامپایل تک‌ورودی مقایسه کنید:
.Sp.Vb 1
\&        gcc foo.c \-c \-dumpdir dir/pfx\- \-dumpbase main ...
.Ve
.Sp
که با اعمال \fB\-dumpbase\fR روی یک فایل مبدأ منفرد، یک \fIdumpbase\fR جداگانه را به ازای هر فایل ورودی محاسبه و الحاق نمی‌کند. خروجی‌های کمکی و رونوشت (dump) آن در \fIdir/pfx\-main.*\fR قرار می‌گیرند.
.Sp
هنگام کامپایل و سپس پیوند دادن چند فایل ورودی، یک \fIdumppfx\fR پیش‌فرض یا صریحاً مشخص‌شده نیز تحت تبدیل \fIdumpbase\fR فوق قرار می‌گیرد (مانند کامپایل \fIfoo.c\fR و \&\fIbar.c\fR در بالا، ولی بدون \fB\-c\fR). اگر نه \&\fB\-dumpdir\fR و نه \fB\-dumpbase\fR مشخص نشده باشند، نام پایه خروجی پیونددهنده منهای \fIauxdropsuf\fR (در صورت مشخص بودن) یا پسوند اجرایی (در غیر این صورت)، به همراه یک خط پیوند به جای آن به \fIdumppfx\fR پیش‌فرض اضافه می‌شود. با این حال توجه داشته باشید که بر خلاف حالت‌های پیشین پیوند دادن:
.Sp
.Vb 1
\&        gcc foo.c bar.c \-dumpdir dir/pfx\- \-o main ...
.Ve
.Sp
نام خروجی \fImain\fR را به \fIdumppfx\fR الحاق نمی‌کند، زیرا \&\fB\-dumpdir\fR صریحاً مشخص شده است. هدف این است که \fIdumppfx\fR صریحاً مشخص‌شده بتواند در صورت تمایل، نام خروجی تعیین‌شده را به عنوان بخشی از پیشوند داشته باشد؛ تنها یک \&\fB\-dumpbase\fR صریحاً مشخص‌شده با آن ترکیب خواهد شد تا از نادیده گرفتن ساده یک گزینه معنادار جلوگیری شود.
.Sp
هنگام کامپایل و سپس پیوند دادن از یک فایل ورودی منفرد، نام پایه خروجی پیونددهنده تنها در صورتی همانند بالا به \fIdumppfx\fR پیش‌فرض اضافه خواهد شد که نام پایه مشترکی با نام فایل ورودی منفرد نداشته باشد. این مورد در حالت‌های پیوند تک‌ورودی بالا پوشش داده شد، اما نه با یک \fB\-dumpdir\fR صریح که مانع این ترکیب می‌شود، حتی اگر توسط \fB\-save\-temps=*\fR لغو شده باشد:
.Sp
.Vb 1
\&        gcc foo.c \-dumpdir alt/pfx\- \-o dir/main.exe \-save\-temps=cwd ...
.Ve
.Sp
خروجی‌های کمکی با نام \fIfoo.*\fR و خروجی‌های رونوشت با نام \&\fIfoo.c.*\fR در پوشه کاری جاری نام‌گذاری می‌شوند، همان‌طور که در نهایت توسط \fB\-save\-temps=cwd\fR درخواست شده است.
.Sp
برای جمع‌بندی همه این موارد در یک جریان داده شهودی اگرچه کمی غیردقیق: نام خروجی اولیه به یک بخش پوشه و یک بخش نام پایه شکسته می‌شود؛ \fIdumppfx\fR بر روی اولی تنظیم می‌شود، مگر اینکه توسط \&\fB\-dumpdir\fR یا \fB\-save\-temps=*\fR لغو شود، و \fIdumpbase\fR بر روی دومی تنظیم می‌گردد، مگر اینکه توسط \fB\-dumpbase\fR بازنویسی شود. چنانچه چندین ورودی وجود داشته باشد یا پیوند انجام گیرد، این \fIdumpbase\fR ممکن است با \&\fIdumppfx\fR ترکیب شده و از هر فایل ورودی گرفته شود. نام‌های خروجی کمکی برای هر ورودی با ترکیب \fIdumppfx\fR، \fIdumpbase\fR منهای پسوند، و پسوند خروجی کمکی شکل می‌گیرند؛ نام‌های خروجی رونوشت تنها از این جهت متفاوتند که پسوند \fIdumpbase\fR در آن‌ها حفظ می‌شود.
.Sp
هنگامی که صحبت از خروجی‌های کمکی و رونوشت ایجادشده در طی کامپایل مجدد LTO به میان می‌آید، ترکیبی از \fIdumppfx\fR و \fIdumpbase\fR، همان‌گونه که داده شده یا همان‌طور که از نام خروجی پیونددهنده (و نه ورودی‌ها) مشتق شده است، حتی در مواردی که این ترکیب در غیر این صورت بدین شکل به کار نمی‌رفت، به همراه یک نقطه انتهایی که جایگزین خط تیره اضافه‌شده توسط کامپایلر (در صورت وجود) می‌شود، به عنوان یک گزینه \fB\-dumpdir\fR به \fBlto\-wrapper\fR ارسال می‌شود؛ از آنجا که این برنامه در پیوند دادن درگیر است، معمولاً هیچ \&\fB\-dumpbase\fR و \fB\-dumpbase\-ext\fR دریافت نمی‌کند و آن‌ها را نادیده می‌گیرد.
.Sp
هنگام اجرای زیرکامپایلرها، \fBlto\-wrapper\fR نام مراحل LTO را به \fIdumppfx\fR دریافتی اضافه می‌کند، اطمینان حاصل می‌کند که شامل یک مؤلفه پوشه باشد تا بر هر \fB\-dumpdir\fR ارجحیت یابد، و آن را به عنوان \&\fB\-dumpbase\fR به زیرکامپایلرها ارسال می‌نماید.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
دستورهای اجراشده برای اجرای مراحل کامپایل را (در خروجی استاندارد خطا) چاپ می‌کند. همچنین شماره نگارش برنامه راه‌انداز کامپایلر، پیش‌پردازنده و خود کامپایلر را چاپ می‌کند.
.IP \fB\-###\fR 4
.IX Item "-###"
مانند \fB\-v\fR است، با این تفاوت که دستورها اجرا نمی‌شوند و آرگومان‌ها درون نقل‌قول قرار می‌گیرند، مگر اینکه فقط شامل نویسه‌های الفبایی‌عددی یا \f(CW\*(C`./\-_\*(C'\fR باشند. این گزینه برای اسکریپت‌های شل جهت دریافت خطوط فرمان تولیدشده توسط راه‌انداز مفید است.
.IP \fB\-\-help\fR 4
.IX Item "--help"
توضیحی از گزینه‌های خط فرمان قابل درک برای \fBgcc\fR را (در خروجی استاندارد) چاپ می‌کند. اگر گزینه \fB\-v\fR نیز مشخص شده باشد، آنگاه \fB\-\-help\fR به فرایندهای گوناگون فراخوانی‌شده توسط \fBgcc\fR نیز ارسال می‌شود تا بتوانند گزینه‌های خط فرمانی را که می‌پذیرند نمایش دهند. چنانچه گزینه \fB\-Wextra\fR نیز (پیش از گزینه \fB\-\-help\fR) مشخص شده باشد، گزینه‌های خط فرمانی که هیچ مستنداتی ندارند نیز نمایش داده می‌شوند.
.IP \fB\-\-target\-help\fR 4
.IX Item "--target-help"
توضیحی از گزینه‌های خط فرمان مختص مقصد (target) را برای هر ابزار (در خروجی استاندارد) چاپ می‌کند. برای برخی مقصدها ممکن است اطلاعات مختص مقصد بیشتری نیز چاپ شود.
.IP \fB\-\-help={\fR\fIclass\fR|[\fB^\fR]\fIqualifier\fR\fB}\fR[\fB,...\fR] 4
.IX Item "--help={class|[^]qualifier}[,...]"
توضیحی از گزینه‌های خط فرمان قابل فهم برای کامپایلر را (در خروجی استاندارد) چاپ می‌کند که در تمام رده‌ها و توصیف‌کننده‌های مشخص‌شده می‌گنجند. رده‌های پشتیبانی‌شده عبارتند از:
.RS 4
.IP \fBoptimizers\fR 4
.IX Item "optimizers"
تمام گزینه‌های بهینه‌سازی پشتیبانی‌شده توسط کامپایلر را نمایش می‌دهد.
.IP \fBwarnings\fR 4
.IX Item "warnings"
تمام گزینه‌های کنترل‌کننده پیام‌های هشدار تولیدشده توسط کامپایلر را نمایش می‌دهد.
.IP \fBtarget\fR 4
.IX Item "target"
گزینه‌های مختص مقصد را نمایش می‌دهد. با این حال بر خلاف گزینه \&\fB\-\-target\-help\fR، گزینه‌های مختص مقصد پیونددهنده و اسمبلر نمایش داده نمی‌شوند. زیرا آن ابزارها در حال حاضر از نحو گسترش‌یافته \fB\-\-help=\fR پشتیبانی نمی‌کنند.
.IP \fBparams\fR 4
.IX Item "params"
مقدارهای شناخته‌شده توسط گزینه \fB\-\-param\fR را نمایش می‌دهد.
.IP \fIlanguage\fR 4
.IX Item "language"
گزینه‌های پشتیبانی‌شده برای \fIlanguage\fR را نمایش می‌دهد، که در آن \&\fIlanguage\fR نام یکی از زبان‌های پشتیبانی‌شده در این نگارش GCC است. اگر گزینه‌ای توسط همه زبان‌ها پشتیبانی شود، باید رده \fBcommon\fR انتخاب گردد.
.IP \fBcommon\fR 4
.IX Item "common"
گزینه‌هایی را که بین تمام زبان‌ها مشترک هستند نمایش می‌دهد.
.RE
.RS 4
.Sp
توصیف‌کننده‌های پشتیبانی‌شده عبارتند از:
.IP \fBundocumented\fR 4
.IX Item "undocumented"
تنها گزینه‌هایی را نمایش می‌دهد که فاقد مستندات هستند.
.IP \fBjoined\fR 4
.IX Item "joined"
گزینه‌هایی را نمایش می‌دهد که آرگومانی می‌پذیرند که پس از یک علامت مساوی در همان قطعه متن پیوسته می‌آید، مانند:
\&\fB\-\-help=target\fR.
.IP \fBseparate\fR 4
.IX Item "separate"
گزینه‌هایی را نمایش می‌دهد که آرگومانی می‌پذیرند که به صورت یک واژه جداگانه به دنبال گزینه اصلی می‌آید، مانند: \fB\-o output\-file\fR.
.RE
.RS 4
.Sp
بنابراین برای نمونه جهت نمایش تمام سوییچ‌های مختص مقصد فاقد مستندات که توسط کامپایلر پشتیبانی می‌شوند، از این دستور استفاده کنید:
.Sp
.Vb 1
\&        \-\-help=target,undocumented
.Ve
.Sp
معنای یک توصیف‌کننده می‌تواند با افزودن نویسه \&\fB^\fR به ابتدای آن معکوس شود؛ بنابراین برای نمونه جهت نمایش تمام گزینه‌های هشدار دودویی (یعنی مواردی که یا روشن یا خاموش هستند و آرگومانی نمی‌پذیرند) که دارای توضیحات هستند، استفاده کنید از:
.Sp
.Vb 1
\&        \-\-help=warnings,^joined,^undocumented
.Ve
.Sp
آرگومان \fB\-\-help=\fR نباید صرفاً از توصیف‌کننده‌های معکوس‌شده تشکیل شود.
.Sp
ترکیب چند رده ممکن است، هرچند که این کار معمولاً خروجی را آن‌قدر محدود می‌کند که چیزی برای نمایش باقی نمی‌ماند. با این حال، یک حالت که در آن جواب می‌دهد، زمانی است که یکی از رده‌ها \&\fItarget\fR باشد. برای نمونه، جهت نمایش تمام گزینه‌های بهینه‌سازی مختص مقصد، استفاده کنید از:
.Sp
.Vb 1
\&        \-\-help=target,optimizers
.Ve
.Sp
گزینه \fB\-\-help=\fR می‌تواند در خط فرمان تکرار شود. هر بار استفاده متوالی، رده درخواستی گزینه‌های خود را نمایش می‌دهد و از مواردی که قبلاً نمایش داده شده‌اند صرف‌نظر می‌کند. اگر \fB\-\-help\fR نیز در هر کجای خط فرمان مشخص شده باشد، آنگاه نسبت به هر گزینه \fB\-\-help=\fR اولویت خواهد داشت.
.Sp
اگر گزینه \fB\-Q\fR در خط فرمان قبل از گزینه \&\fB\-\-help=\fR ظاهر شود، متن توصیفی نمایش‌داده‌شده توسط \&\fB\-\-help=\fR تغییر می‌کند. به جای شرح گزینه‌های نمایش‌یافته، نشان داده می‌شود که آیا گزینه فعال، غیرفعال یا روی یک مقدار معین تنظیم شده است (با این فرض که کامپایلر در نقطه‌ای که گزینه \fB\-\-help=\fR استفاده شده، از این موضوع آگاه باشد).
.Sp
در اینجا یک مثال خلاصه‌شده از پورت ARM برای \fBgcc\fR آورده شده است:
.Sp.Vb 5
\&          % gcc \-Q \-mabi=2 \-\-help=target \-c
\&          The following options are target specific:
\&          \-mabi=                                2
\&          \-mabort\-on\-noreturn                   [disabled]
\&          \-mapcs                                [disabled]
.Ve
.Sp
خروجی نسبت به اثرات گزینه‌های پیشین خط فرمان حساس است، بنابراین به عنوان مثال می‌توان با استفاده از دستور زیر دریافت که کدام بهینه‌سازی‌ها در \fB\-O2\fR فعال هستند:
.Sp
.Vb 1
\&        \-Q \-O2 \-\-help=optimizers
.Ve
.Sp
همچنین می‌توانید با استفاده از دستور زیر متوجه شوید که کدام بهینه‌سازی‌های دودویی توسط \fB\-O3\fR فعال می‌شوند:
.Sp
.Vb 3
\&        gcc \-c \-Q \-O3 \-\-help=optimizers > /tmp/O3\-opts
\&        gcc \-c \-Q \-O2 \-\-help=optimizers > /tmp/O2\-opts
\&        diff /tmp/O2\-opts /tmp/O3\-opts | grep enabled
.Ve
.RE
.IP \fB\-\-version\fR 4
.IX Item "--version"
شماره نسخه و کپی‌رایت‌های GCC فراخوانی‌شده را نمایش می‌دهد.
.IP \fB\-pass\-exit\-codes\fR 4
.IX Item "-pass-exit-codes"
.PD 0
.IP \fB\-\-pass\-exit\-codes\fR 4
.IX Item "--pass-exit-codes"
.PD
در حالت عادی، اگر هر فازی از کامپایلر یک کد بازگشتی ناموفق برگرداند، برنامه \fBgcc\fR با کد ۱ خارج می‌شود. اگر \&\fB\-pass\-exit\-codes\fR را مشخص کنید، برنامه \fBgcc\fR در عوض با بزرگ‌ترین کد خطای عددی ایجادشده توسط فازی که وضعیت خطا را اعلام کرده است، خارج می‌شود. فرانت‌اندهای C، C++‎ و Fortran در صورت مواجهه با خطای داخلی کامپایلر، کد ۴ را بازمی‌گردانند.
.IP \fB\-pipe\fR 4
.IX Item "-pipe"
.PD 0
.IP \fB\-\-pipe\fR 4
.IX Item "--pipe"
.PD
برای برقراری ارتباط میان مراحل مختلف کامپایل، به جای فایل‌های موقت از لوله‌ها (pipes) استفاده می‌کند. این گزینه روی برخی سیستم‌ها که در آن‌ها اسمبلر قادر به خواندن از لوله نیست با شکست مواجه می‌شود؛ اما اسمبلر GNU مشکلی در این زمینه ندارد.
.IP \fB\-wrapper\fR 4
.IX Item "-wrapper"
تمام زیردستورها را تحت یک برنامه پوشش‌دهنده (wrapper) فراخوانی می‌کند. نام برنامه پوشش‌دهنده و پارامترهای آن به صورت یک فهرست جداشده با کاما ارسال می‌شوند.
.Sp
.Vb 1
\&        gcc \-c t.c \-wrapper gdb,\-\-args
.Ve
.Sp
این کار تمام زیربرنامه‌های \fBgcc\fR را تحت \&\fBgdb \-\-args\fR فراخوانی می‌کند، بنابراین فراخوانی \fBcc1\fR به صورت \&\fBgdb \-\-args cc1 ...\fR خواهد بود.
.IP \fB\-ffile\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR 4
.IX Item "-ffile-prefix-map=old=new"
هنگام کامپایل فایل‌های واقع در دایرکتوری \fIold\fR، هرگونه ارجاع به آن‌ها را در نتیجه کامپایل به گونه‌ای ثبت می‌کند که گویی فایل‌ها در دایرکتوری \fInew\fR قرار دارند. مشخص کردن این گزینه معادل مشخص کردن تمام گزینه‌های تکی \&\fB\-f*\-prefix\-map\fR است. از این گزینه می‌توان برای ساخت‌های بازتولیدپذیر (reproducible builds) که مستقل از مکان هستند استفاده کرد. دایرکتوری‌هایی که توسط رهنمودها (directives) ارجاع داده می‌شوند تحت تأثیر این گزینه‌ها قرار نمی‌گیرند. همچنین گزینه‌های \&\fB\-fmacro\-prefix\-map\fR، \fB\-fdebug\-prefix\-map\fR، \&\fB\-fprofile\-prefix\-map\fR و \fB\-fcanon\-prefix\-map\fR را ببینید.
.IP \fB\-fcanon\-prefix\-map\fR 4
.IX Item "-fcanon-prefix-map"
برای گزینه‌های \fB\-f*\-prefix\-map\fR، در حالت عادی مقایسه پیشوند \fIold\fR با نام فایلی که معمولاً در نتیجه کامپایل به آن ارجاع داده می‌شود، با مقایسه متنی پیشوندها یا بدون در نظر گرفتن بزرگی و کوچکی حروف در سیستم‌های فایلی حساس نبودن به حروف بزرگ و کوچک، و یکسان دانستن اسلش و بک‌اسلش در سیستم‌های فایلی مبتنی بر DOS انجام می‌شود. گزینه \fB\-fcanon\-prefix\-map\fR باعث می‌شود این مقایسه‌ها روی مسیرهای استانداردشده (canonicalized) مربوط به \fIold\fR و نام فایل ارجاع‌داده‌شده انجام گیرد.
.IP \fB\-fplugin=\fR\fIname\fR\fB.so\fR 4
.IX Item "-fplugin=name.so"
کد افزونه (plugin) موجود در فایل \fIname\fR.so را بارگذاری می‌کند، با این فرض که یک شیء مشترک (shared object) است که باید توسط کامپایلر dlopen\*(Aq شود. نام پایه فایل شیء مشترک برای شناسایی افزونه به منظور تجزیه آرگومان‌ها استفاده می‌شود (به \&\fB\-fplugin\-arg\-\fR\fIname\fR\fB\-\fR\fIkey\fR\fB=\fR\fIvalue\fR در زیر مراجعه کنید). هر افزونه باید توابع بازخوانی (callback) مشخص‌شده در Plugins API را تعریف کند.
.IP \fB\-fplugin\-arg\-\fR\fIname\fR\fB\-\fR\fIkey\fR\fB=\fR\fIvalue\fR 4
.IX Item "-fplugin-arg-name-key=value"
یک آرگومان با نام \fIkey\fR و مقدار \fIvalue\fR برای افزونه‌ای با نام \fIname\fR تعریف می‌کند.
.IP \fB\-fdump\-ada\-spec\fR[\fB\-slim\fR] 4
.IX Item "-fdump-ada-spec[-slim]"
برای فایل‌های منبع و include در C و C++‎، مشخصات (specs) متناظر زبان Ada را تولید می‌کند.
.IP \fB\-fada\-spec\-parent=\fR\fIunit\fR 4
.IX Item "-fada-spec-parent=unit"
در ترکیب با گزینه \fB\-fdump\-ada\-spec\fR[\fB\-slim\fR] در بالا، مشخصات Ada را به عنوان واحدهای فرزند واحد والد \fIunit\fR تولید می‌کند.
.IP \fB\-fdump\-go\-spec=\fR\fIfile\fR 4
.IX Item "-fdump-go-spec=file"
برای فایل‌های ورودی در هر زبانی، اعلان‌های متناظر زبان Go را در \fIfile\fR تولید می‌کند. این گزینه اعلان‌های \f(CW\*(C`const\*(C'\fR، \&\f(CW\*(C`type\*(C'\fR، \f(CW\*(C`var\*(C'\fR و \f(CW\*(C`func\*(C'\fR در Go را تولید می‌کند که می‌تواند روشی مفید برای شروع نوشتن یک رابط Go به کدهای نوشته‌شده در سایر زبان‌ها باشد.
.IP \fB@\fR\fIfile\fR 4
.IX Item "@file"
گزینه‌های خط فرمان را از \fIfile\fR می‌خواند. گزینه‌های خوانده‌شده به جای گزینه اصلی @\fIfile\fR درج می‌شوند. اگر \fIfile\fR وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به صورت تحت‌اللفظی رفتار شده و حذف نمی‌شود.
.Sp
گزینه‌ها در \fIfile\fR توسط نویسه‌های فاصله خالی (whitespace) جدا می‌شوند. می‌توان یک نویسه فاصله خالی را با احاطه کردن کل گزینه در گیومه تکی یا دوتایی، درون گزینه قرار داد. هر نویسه‌ای (از جمله بک‌اسلش) می‌تواند با پیشوند کردن یک بک‌اسلش به آن درج شود. خود \fIfile\fR می‌تواند حاوی گزینه‌های @\fIfile\fR بیشتری باشد؛ هرکدام از این گزینه‌ها به صورت بازگشتی پردازش خواهند شد..SS "کامپایل برنامه‌های C++ (Compiling C++ Programs)"
.IX Subsection "Compiling C++ Programs"
فایل‌های منبع C++ به طور مرسوم از یکی از پسوندهای \fB.C\fR،
\&\fB.cc\fR، \fB.cpp\fR، \fB.CPP\fR، \fB.c++\fR، \fB.cp\fR یا
\&\fB.cxx\fR استفاده می‌کنند؛ فایل‌های سرآیند (header) C++ اغلب از \fB.hh\fR، \fB.hpp\fR،
\&\fB.H\fR یا (برای کدهای قالب اشتراکی) \fB.tcc\fR استفاده می‌کنند؛
فایل‌های پیش‌پردازش‌شده C++ از پسوند \fB.ii\fR استفاده می‌کنند؛ و واحدهای رابط ماژول C++20
گاهی از \fB.ixx\fR، \fB.cppm\fR، \fB.cxxm\fR، \fB.c++m\fR
یا \fB.ccm\fR بهره می‌برند.
.PP
کامپایلر GCC فایل‌هایی با این نام‌ها را تشخیص داده و آن‌ها را به عنوان برنامه‌های C++ کامپایل می‌کند، حتی اگر
کامپایلر را به همان شیوه‌ای که برای کامپایل برنامه‌های C به کار می‌برید فراخوانی کنید (معمولاً
با نام \fBgcc\fR).
.PP
با این حال، استفاده از \fBgcc\fR کتابخانه C++ را اضافه نمی‌کند.
\&\fBg++\fR برنامه‌ای است که GCC را فراخوانی کرده و به طور خودکار پیوند دادن (linking)
با کتابخانه C++ را مشخص می‌کند. این برنامه با فایل‌های \fB.c\fR،
\&\fB.h\fR و \fB.i\fR مانند فایل‌های منبع C++ به جای فایل‌های منبع C
رفتار می‌کند، مگر اینکه گزینه \fB\-x\fR استفاده شده باشد. این برنامه همچنین هنگام
پیش‌کامپایل کردن یک فایل سرآیند C با پسوند \fB.h\fR برای استفاده در کامپایل‌های C++
مفید است. در بسیاری از سیستم‌ها، \fBg++\fR با نام \fBc++\fR نیز
نصب می‌شود.
.PP
هنگامی که برنامه‌های C++ را کامپایل می‌کنید، می‌توانید بسیاری از همان
گزینه‌های خط فرمانی را که برای کامپایل برنامه‌ها در هر زبان دیگری به کار می‌برید، مشخص کنید؛
یا گزینه‌های خط فرمانی که برای C و زبان‌های مرتبط معنا دارند؛
یا گزینه‌هایی که منحصراً برای برنامه‌های C++ معنادار هستند.
.SS "گزینه‌های کنترل‌کننده گویش C (Options Controlling C Dialect)"
.IX Subsection "Options Controlling C Dialect"
گزینه‌های زیر گویش زبان C (یا زبان‌های مشتق‌شده
از C مانند C++، Objective\-C و Objective\-C++) را که کامپایلر
می‌پذیرد، کنترل می‌کنند:
.IP \fB\-ansi\fR 4
.IX Item "-ansi"
.PD 0
.IP \fB\-\-ansi\fR 4
.IX Item "--ansi"
.PD
در حالت C، این گزینه معادل \fB\-std=c90\fR است. در حالت C++، معادل
\&\fB\-std=c++98\fR است.
.IP \fB\-std=\fR 4
.IX Item "-std="
استاندارد زبان را تعیین می‌کند. این گزینه
در حال حاضر فقط هنگام کامپایل C یا C++ پشتیبانی می‌شود.
.Sp
کامپایلر می‌تواند چندین استاندارد پایه، مانند \fBc90\fR یا
\&\fBc++98\fR، و گویش‌های GNU از آن استانداردها مانند
\&\fBgnu90\fR یا \fBgnu++98\fR را بپذیرد. هنگامی که یک استاندارد پایه مشخص می‌شود،
کامپایلر تمام برنامه‌های منطبق با آن استاندارد به علاوه برنامه‌هایی را که
از افزونه‌های GNU استفاده می‌کنند و با آن در تناقض نیستند، می‌پذیرد. برای مثال،
\&\fB\-std=c90\fR قابلیت‌های خاصی از GCC را که با استاندارد ISO C90 ناسازگار
هستند خاموش می‌کند، مانند کلمات کلیدی \f(CW\*(C`asm\*(C'\fR و \f(CW\*(C`typeof\*(C'\fR،
اما سایر افزونه‌های GNU را که در ISO C90 معنایی ندارند غیرفعال نمی‌کند،
مانند حذف عبارت میانی در یک عبارت شرطی \f(CW\*(C`?:\*(C'\fR. از سوی دیگر، هنگامی که یک گویش GNU
از یک استاندارد مشخص می‌شود، تمام قابلیت‌های پشتیبانی‌شده توسط کامپایلر فعال می‌شوند، حتی زمانی
که این قابلیت‌ها معنای استاندارد پایه را تغییر دهند. در نتیجه، ممکن است برخی از
برنامه‌هایی که انطباق سخت‌گیرانه دارند رد شوند. این استاندارد خاص
توسط \fB\-Wpedantic\fR برای شناسایی این که کدام قابلیت‌ها بر اساس آن نسخه از استاندارد
افزونه‌های GNU محسوب می‌شوند، استفاده می‌گردد. برای مثال،
\&\fB\-std=gnu90 \-Wpedantic\fR درباره کامنت‌های سبک C++ با \fB//\fR
هشدار می‌دهد، در حالی که \fB\-std=gnu99 \-Wpedantic\fR هشداری نمی‌دهد.
.Sp
باید مقداری برای این گزینه مشخص شود؛ مقادیر ممکن عبارتند از:
.RS 4
.IP \fBc90\fR 4
.IX Item "c90"
.PD 0
.IP \fBc89\fR 4
.IX Item "c89"
.IP \fBiso9899:1990\fR 4
.IX Item "iso9899:1990"
.PD
پشتیبانی از تمام برنامه‌های ISO C90 (برخی افزونه‌های GNU که با
ISO C90 در تضاد هستند غیرفعال می‌شوند). همانند \fB\-ansi\fR برای کد C.
.IP \fBiso9899:199409\fR 4
.IX Item "iso9899:199409"
استاندارد ISO C90 همان‌گونه که در اصلاحیه ۱ (amendment 1) اصلاح شده است.
.IP \fBc99\fR 4
.IX Item "c99"
.PD 0
.IP \fBc9x\fR 4
.IX Item "c9x"
.IP \fBiso9899:1999\fR 4
.IX Item "iso9899:1999"
.IP \fBiso9899:199x\fR 4
.IX Item "iso9899:199x"
.PD
استاندارد ISO C99. این استاندارد اساساً به طور کامل پشتیبانی می‌شود، به جز
باگ‌ها و مسائل مربوط به ممیز شناور (floating\-point)
(عمدتاً، اما نه کاملاً، مرتبط با قابلیت‌های اختیاری C99 از
پیوست‌های F و G). برای اطلاعات بیشتر
<\fBhttps://gcc.gnu.org/projects/c\-status.html\fR> را ببینید.
نام‌های \fBc9x\fR و \fBiso9899:199x\fR منسوخ شده‌اند.
.IP \fBc11\fR 4
.IX Item "c11"
.PD 0
.IP \fBc1x\fR 4
.IX Item "c1x"
.IP \fBiso9899:2011\fR 4
.IX Item "iso9899:2011"
.PD
استاندارد ISO C11، بازبینی سال ۲۰۱۱ استاندارد ISO C. این استاندارد
اساساً به طور کامل پشتیبانی می‌شود، به جز باگ‌ها، مسائل ممیز شناور
(عمدتاً، اما نه کاملاً، مرتبط با قابلیت‌های اختیاری C11 از
پیوست‌های F و G) و پیوست‌های اختیاری K (رابط‌های بررسی حدود \- Bounds\-checking interfaces)
و L (تحلیل‌پذیری \- Analyzability). نام \fBc1x\fR منسوخ شده است.
.IP \fBc17\fR 4
.IX Item "c17"
.PD 0
.IP \fBc18\fR 4
.IX Item "c18"
.IP \fBiso9899:2017\fR 4
.IX Item "iso9899:2017"
.IP \fBiso9899:2018\fR 4
.IX Item "iso9899:2018"
.PD
استاندارد ISO C17، بازبینی سال ۲۰۱۷ استاندارد ISO C
(منتشر شده در سال ۲۰۱۸). این استاندارد به جز
اصلاح نقایص (که همگی با \fB\-std=c11\fR نیز اعمال
می‌شوند) و یک مقدار جدید برای
\&\f(CW\*(C`_\|_STDC_VERSION_\|_\*(C'\fR، همانند C11 است و بنابراین به همان میزان C11 پشتیبانی می‌شود.
.IP \fBc23\fR 4
.IX Item "c23"
.PD 0
.IP \fBc2x\fR 4
.IX Item "c2x"
.IP \fBiso9899:2024\fR 4
.IX Item "iso9899:2024"
.PD
استاندارد ISO C23، بازبینی سال ۲۰۲۳ استاندارد ISO C (منتشر شده در سال ۲۰۲۴). نام
\&\fBc2x\fR منسوخ شده است.
.IP \fBc2y\fR 4
.IX Item "c2y"
نسخه بعدی استاندارد ISO C که همچنان در حال توسعه است.
پشتیبانی از این نسخه آزمایشی و ناقص است.
.IP \fBgnu90\fR 4
.IX Item "gnu90"
.PD 0
.IP \fBgnu89\fR 4
.IX Item "gnu89"
.PD
گویش GNU از ISO C90 (شامل برخی از قابلیت‌های C99).
.IP \fBgnu99\fR 4
.IX Item "gnu99"
.PD 0
.IP \fBgnu9x\fR 4
.IX Item "gnu9x"
.PD
گویش GNU از ISO C99. نام \fBgnu9x\fR منسوخ شده است.
.IP \fBgnu11\fR 4
.IX Item "gnu11"
.PD 0
.IP \fBgnu1x\fR 4
.IX Item "gnu1x"
.PD
گویش GNU از ISO C11.
نام \fBgnu1x\fR منسوخ شده است.
.IP \fBgnu17\fR 4
.IX Item "gnu17"
.PD 0
.IP \fBgnu18\fR 4
.IX Item "gnu18"
.PD
گویش GNU از ISO C17.
.IP \fBgnu23\fR 4
.IX Item "gnu23"
.PD 0
.IP \fBgnu2x\fR 4
.IX Item "gnu2x"
.PD
گویش GNU از ISO C23. این مقدار پیش‌فرض برای کد C است. نام
\&\fBgnu2x\fR منسوخ شده است.
.IP \fBgnu2y\fR 4
.IX Item "gnu2y"
نسخه بعدی استاندارد ISO C که هنوز در حال توسعه است، به همراه
افزونه‌های GNU. پشتیبانی از این نسخه آزمایشی و
ناقص است. نام \fBgnu2x\fR منسوخ شده است.
.IP \fBc++98\fR 4
.IX Item "c++98".PD 0
.IP \fBc++03\fR 4
.IX Item "c++03"
.PD
استاندارد ISO C++ سال ۱۹۹۸ به‌همراه اصلاحیه فنی سال ۲۰۰۳ و برخی
گزارش‌های نقص (defect reports) تکمیلی. مشابه \fB\-ansi\fR برای کد C++.
.IP \fBgnu++98\fR 4
.IX Item "gnu++98"
.PD 0
.IP \fBgnu++03\fR 4
.IX Item "gnu++03"
.PD
گویش GNU از \fB\-std=c++98\fR.
.IP \fBc++11\fR 4
.IX Item "c++11"
.PD 0
.IP \fBc++0x\fR 4
.IX Item "c++0x"
.PD
استاندارد ISO C++ سال ۲۰۱۱ به‌همراه اصلاحیه‌ها.
نام \fBc++0x\fR منسوخ شده است.
.IP \fBgnu++11\fR 4
.IX Item "gnu++11"
.PD 0
.IP \fBgnu++0x\fR 4
.IX Item "gnu++0x"
.PD
گویش GNU از \fB\-std=c++11\fR.
نام \fBgnu++0x\fR منسوخ شده است.
.IP \fBc++14\fR 4
.IX Item "c++14"
.PD 0
.IP \fBc++1y\fR 4
.IX Item "c++1y"
.PD
استاندارد ISO C++ سال ۲۰۱۴ به‌همراه اصلاحیه‌ها.
نام \fBc++1y\fR منسوخ شده است.
.IP \fBgnu++14\fR 4
.IX Item "gnu++14"
.PD 0
.IP \fBgnu++1y\fR 4
.IX Item "gnu++1y"
.PD
گویش GNU از \fB\-std=c++14\fR.
نام \fBgnu++1y\fR منسوخ شده است.
.IP \fBc++17\fR 4
.IX Item "c++17"
.PD 0
.IP \fBc++1z\fR 4
.IX Item "c++1z"
.PD
استاندارد ISO C++ سال ۲۰۱۷ به‌همراه اصلاحیه‌ها.
نام \fBc++1z\fR منسوخ شده است.
.IP \fBgnu++17\fR 4
.IX Item "gnu++17"
.PD 0
.IP \fBgnu++1z\fR 4
.IX Item "gnu++1z"
.PD
گویش GNU از \fB\-std=c++17\fR.
نام \fBgnu++1z\fR منسوخ شده است.
.IP \fBc++20\fR 4
.IX Item "c++20"
.PD 0
.IP \fBc++2a\fR 4
.IX Item "c++2a"
.PD
استاندارد ISO C++ سال ۲۰۲۰ به‌همراه اصلاحیه‌ها.
پشتیبانی از ماژول‌های C++20 هنوز آزمایشی است و باید با
گزینهٔ \fB\-fmodules\fR فعال شود.
نام \fBc++2a\fR منسوخ شده است.
.IP \fBgnu++20\fR 4
.IX Item "gnu++20"
.PD 0
.IP \fBgnu++2a\fR 4
.IX Item "gnu++2a"
.PD
گویش GNU از \fB\-std=c++20\fR.
این مقدار پیش‌فرض برای کد C++ است.
پشتیبانی از ماژول‌های C++20 هنوز آزمایشی است و باید با
گزینهٔ \fB\-fmodules\fR فعال شود.
نام \fBgnu++2a\fR منسوخ شده است.
.IP \fBc++23\fR 4
.IX Item "c++23"
.PD 0
.IP \fBc++2b\fR 4
.IX Item "c++2b"
.PD
استاندارد ISO C++ سال ۲۰۲۳ به‌همراه اصلاحیه‌ها (منتشر شده در سال ۲۰۲۴).
پشتیبانی آزمایشی است و ممکن است در نگارش‌های آینده به شیوه‌هایی
ناسازگار تغییر کند.
نام \fBc++2b\fR منسوخ شده است.
.IP \fBgnu++23\fR 4
.IX Item "gnu++23"
.PD 0
.IP \fBgnu++2b\fR 4
.IX Item "gnu++2b"
.PD
گویش GNU از \fB\-std=c++23\fR.
پشتیبانی آزمایشی است و ممکن است در نگارش‌های آینده به شیوه‌هایی
ناسازگار تغییر کند.
نام \fBgnu++2b\fR منسوخ شده است.
.IP \fBc++2c\fR 4
.IX Item "c++2c"
.PD 0
.IP \fBc++26\fR 4
.IX Item "c++26"
.PD
بازنگری بعدی استاندارد ISO C++ که برای سال
۲۰۲۶ برنامه‌ریزی شده است. پشتیبانی بسیار آزمایشی است و تقریباً
به‌طور قطع در نگارش‌های آینده به شیوه‌هایی ناسازگار تغییر خواهد کرد.
.IP \fBgnu++2c\fR 4
.IX Item "gnu++2c"
.PD 0
.IP \fBgnu++26\fR 4
.IX Item "gnu++26"
.PD
گویش GNU از \fB\-std=c++2c\fR. پشتیبانی بسیار آزمایشی است
و تقریباً به‌طور قطع در نگارش‌های آینده به شیوه‌هایی ناسازگار تغییر
خواهد کرد.
.RE
.RS 4
.RE
.IP "\fB\-aux\-info\fR \fIfilename\fR" 4
.IX Item "-aux-info filename"
اعلان‌های دارای پیش‌نمونه (prototyped declarations) برای تمامی توابع
اعلام‌شده و/یا تعریف‌شده در یک واحد ترجمه (translation unit)، از جمله
توابع موجود در فایل‌های سرایند را در نام‌فایل ارائه‌شده می‌نویسد. این گزینه برای هر
زبانی جز C بدون هیچ هشداری نادیده گرفته می‌شود.
.Sp
علاوه بر اعلان‌ها، این فایل در قالب توضیح (comment) مبدأ هر اعلان
(فایل مبدأ و خط)، اینکه اعلان ضمنی، دارای پیش‌نمونه یا بدون پیش‌نمونه
بوده است (\fBI\fR، \fBN\fR برای جدید یا \&\fBO\fR برای قدیمی، به‌ترتیب، در
نخستین نویسه پس از شماره خط و دونقطه)، و اینکه آیا از یک اعلان ناشی شده یا یک
تعریف (\fBC\fR یا \fBF\fR، به‌ترتیب، در نویسهٔ بعدی) را مشخص می‌کند. در مورد
تعریف توابع، فهرستی از آرگومان‌ها به سبک K&R که اعلان‌هایشان در پی آن می‌آید نیز در داخل
توضیحات، پس از اعلان ارائه می‌شود.
.IP \fB\-fno\-asm\fR 4
.IX Item "-fno-asm"
کلمات \f(CW\*(C`asm\*(C'\fR، \f(CW\*(C`inline\*(C'\fR یا \f(CW\*(C`typeof\*(C'\fR را به عنوان
کلیدواژه شناسایی نمی‌کند تا کد بتواند از این واژه‌ها به عنوان شناسه استفاده کند.
در عوض می‌توانید از کلیدواژه‌های \f(CW\*(C`_\|_asm_\|_\*(C'\fR، \f(CW\*(C`_\|_inline_\|_\*(C'\fR و \f(CW\*(C`_\|_typeof_\|_\*(C'\fR
استفاده کنید. در C، گزینهٔ \fB\-ansi\fR مستلزم \fB\-fno\-asm\fR است.
.Sp
در C++، کلیدواژهٔ \f(CW\*(C`inline\*(C'\fR یک کلیدواژهٔ استاندارد است و تحت تأثیر این
کلید قرار نمی‌گیرد. ممکن است بخواهید در عوض از پرچم \fB\-fno\-gnu\-keywords\fR
استفاده کنید که \f(CW\*(C`typeof\*(C'\fR را غیرفعال می‌کند اما نه \f(CW\*(C`asm\*(C'\fR و
\&\f(CW\*(C`inline\*(C'\fR را. در حالت C99 (\fB\-std=c99\fR یا \fB\-std=gnu99\fR)،
این گزینه فقط بر کلیدواژه‌های \f(CW\*(C`asm\*(C'\fR و \f(CW\*(C`typeof\*(C'\fR اثر می‌گذارد،
زیرا \f(CW\*(C`inline\*(C'\fR یک کلیدواژهٔ استاندارد در ISO C99 است. در حالت C23
(\fB\-std=c23\fR یا \fB\-std=gnu23\fR)، این گزینه فقط
کلیدواژهٔ \f(CW\*(C`asm\*(C'\fR را تحت تأثیر قرار می‌دهد، زیرا \f(CW\*(C`typeof\*(C'\fR یک کلیدواژهٔ استاندارد در
ISO C23 است.
.IP \fB\-fno\-builtin\fR 4
.IX Item "-fno-builtin"
.PD 0
.IP \fB\-fno\-builtin\-\fR\fIfunction\fR 4
.IX Item "-fno-builtin-function"
.PD
توابع توکار (built\-in) را که با پیشوند
\&\fB_\|_builtin_\fR شروع نمی‌شوند شناسایی نمی‌کند.
.Sp
‏GCC معمولاً کدهای ویژه‌ای تولید می‌کند تا برخی توابع توکار را
کارآمدتر مدیریت کند؛ به عنوان مثال، فراخوانی‌های \f(CW\*(C`alloca\*(C'\fR ممکن است تبدیل به تک‌دستوراتی
شوند که مستقیماً پشته را تنظیم می‌کنند، و فراخوانی‌های \f(CW\*(C`memcpy\*(C'\fR
ممکن است تبدیل به حلقه‌های رونوشت درون‌خطی شوند. کد حاصل اغلب هم کوچک‌تر
و هم سریع‌تر است، اما از آنجا که فراخوانی‌های تابع دیگر به همان صورت در کد ظاهر نمی‌شوند،
نمی‌توانید روی آن فراخوانی‌ها نقطه توقف (breakpoint) بگذارید، و همچنین نمی‌توانید رفتار
توابع را با پیوند دادن به کتابخانه‌ای دیگر تغییر دهید. علاوه بر این،
هنگامی که تابعی به عنوان تابع توکار شناخته می‌شود، GCC ممکن است از
اطلاعات مربوط به آن تابع برای هشدار دادن درباره مشکلات فراخوانی آن،
یا تولید کد کارآمدتر بهره ببرد، حتی اگر کد حاصل هنوز حاوی فراخوانی‌های
آن تابع باشد. به عنوان مثال، هشدارهایی با \fB\-Wformat\fR برای فراخوانی‌های نادرست
\&\f(CW\*(C`printf\*(C'\fR داده می‌شود هنگامی که \f(CW\*(C`printf\*(C'\fR توکار است و مشخص است که
\&\f(CW\*(C`strlen\*(C'\fR حافظهٔ سراسری را تغییر نمی‌دهد.
.Sp
با گزینهٔ \fB\-fno\-builtin\-\fR\fIfunction\fR
تنها تابع توکار \fIfunction\fR غیرفعال
می‌شود. \fIfunction\fR نباید با \fB_\|_builtin_\fR شروع شود. اگر
تابعی نام برده شود که در این نسخه از GCC توکار نباشد، این
گزینه نادیده گرفته می‌شود. هیچ گزینهٔ معادل
\&\fB\-fbuiltin\-\fR\fIfunction\fR وجود ندارد؛ چنانچه مایلید توابع
توکار را هنگام استفاده از \fB\-fno\-builtin\fR یا
\&\fB\-ffreestanding\fR به‌صورت انتخابی فعال کنید، می‌توانید ماکروهایی مانند زیر تعریف نمایید:
.Sp.Vb 2
\&        #define abs(n)          _\|_builtin_abs ((n))
\&        #define strcpy(d, s)    _\|_builtin_strcpy ((d), (s))
.Ve
.IP \fB\-fcond\-mismatch\fR 4
.IX Item "-fcond-mismatch"
عبارت‌های شرطی با انواع ناهماهنگ در آرگومان‌های دوم و سوم را مجاز می‌داند. مقدار چنین عبارتی void است. این گزینه برای C++ پشتیبانی نمی‌شود.
.IP \fB\-ffreestanding\fR 4
.IX Item "-ffreestanding"
تصریح می‌کند که کامپایل یک محیط مستقل (freestanding) را هدف قرار می‌دهد. این گزینه مستلزم \fB\-fno\-builtin\fR است. محیط مستقل محیطی است که در آن ممکن است کتابخانهٔ استاندارد وجود نداشته باشد و نقطهٔ شروع برنامه لزوماً تابع \f(CW\*(C`main\*(C'\fR نباشد. واضح‌ترین مثال آن، کرنل یک سیستم‌عامل است. این گزینه معادل \fB\-fno\-hosted\fR است.
.IP \fB\-fgimple\fR 4
.IX Item "-fgimple"
تجزیهٔ تعاریف توابعی که با \f(CW\*(C`_\|_GIMPLE\*(C'\fR علامت‌گذاری شده‌اند را فعال می‌کند. این یک ویژگی آزمایشی است که امکان آزمایش واحد (unit testing) برای گذرگاه‌های GIMPLE را فراهم می‌سازد.
.IP \fB\-fgnu\-tm\fR 4
.IX Item "-fgnu-tm"
هنگامی که گزینهٔ \fB\-fgnu\-tm\fR مشخص شود، کامپایلر کدی برای نگارش لینوکسی سند مشخصات فعلی ABI حافظهٔ تراکنشی Intel (ویرایش ۱.۱، ۶ مه ۲۰۰۹) تولید می‌کند. این یک ویژگی آزمایشی است که رابط آن ممکن است در نگارش‌های آیندهٔ GCC همگام با تغییر مشخصات رسمی، دستخوش تغییر شود. لطفاً توجه داشته باشید که این ویژگی در همهٔ معماری‌ها پشتیبانی نمی‌شود.
.Sp
برای اطلاعات بیشتر دربارهٔ پشتیبانی GCC از حافظهٔ تراکنشی،
.Sp
توجه داشته باشید که ویژگی حافظهٔ تراکنشی با استثناهای غیرفراخوانی (\fB\-fnon\-call\-exceptions\fR) پشتیبانی نمی‌شود.
.IP \fB\-fgnu89\-inline\fR 4
.IX Item "-fgnu89-inline"
گزینهٔ \fB\-fgnu89\-inline\fR به GCC اعلام می‌کند که هنگام قرار داشتن در حالت C99، از معناشناسی سنتی GNU برای توابع \f(CW\*(C`inline\*(C'\fR استفاده کند.
.Sp
استفاده از این گزینه تقریباً معادل افزودن مشخصهٔ تابعی \&\f(CW\*(C`gnu_inline\*(C'\fR به تمامی توابع درون‌خطی است.
.Sp
گزینهٔ \fB\-fno\-gnu89\-inline\fR صراحتاً به GCC می‌گوید که در حالت C99 یا gnu99 از معناشناسی C99 برای \f(CW\*(C`inline\*(C'\fR استفاده کند (یعنی رفتار پیش‌فرض را تعیین می‌کند). این گزینه در حالت‌های \fB\-std=c90\fR یا \&\fB\-std=gnu90\fR پشتیبانی نمی‌شود.
.Sp
از ماکروهای پیش‌پردازندهٔ \f(CW\*(C`_\|_GNUC_GNU_INLINE_\|_\*(C'\fR و \&\f(CW\*(C`_\|_GNUC_STDC_INLINE_\|_\*(C'\fR می‌توان برای بررسی این‌که کدام معناشناسی برای توابع \f(CW\*(C`inline\*(C'\fR فعال است، استفاده کرد.
.IP \fB\-fhosted\fR 4
.IX Item "-fhosted"
تصریح می‌کند که کامپایل یک محیط میزبانی‌شده (hosted) را هدف قرار می‌دهد. این گزینه مستلزم \&\fB\-fbuiltin\fR است. محیط میزبانی‌شده محیطی است که در آن تمام کتابخانهٔ استاندارد در دسترس است و در آن نوع بازگشتی \f(CW\*(C`main\*(C'\fR برابر با \f(CW\*(C`int\*(C'\fR است. تقریباً همه چیز به جز یک کرنل مثال‌هایی از آن هستند. این گزینه معادل \fB\-fno\-freestanding\fR است.
.IP \fB\-flax\-vector\-conversions\fR 4
.IX Item "-flax-vector-conversions"
تبدیل‌های ضمنی بین بردارهایی با تعداد عناصر متفاوت و/یا انواع عناصر ناسازگار را مجاز می‌داند. از این گزینه نباید برای کدهای جدید استفاده شود.
.IP \fB\-fms\-extensions\fR 4
.IX Item "-fms-extensions"
برخی از ساختارهای غیراستاندارد به‌کاررفته در فایل‌های سرایند مایکروسافت را می‌پذیرد.
.Sp
در کد C++، این گزینه اجازه می‌دهد نام اعضا در ساختارها مشابه اعلان‌های قبلی نوع‌ها باشد.
.Sp
.Vb 4
\&        typedef int UOW;
\&        struct ABC {
\&          UOW UOW;
\&        };
.Ve
.Sp
برخی موارد فیلدهای بدون‌نام در ساختارها و اجتماع‌ها (unions) تنها با این گزینه پذیرفته می‌شوند.
.Sp
توجه داشته باشید که این گزینه برای تمام هدف‌ها خاموش است، به جز هدف‌های x86 که از ms\-abi استفاده می‌کنند.
.IP \fB\-fpermitted\-flt\-eval\-methods=\fR\fIstyle\fR 4
.IX Item "-fpermitted-flt-eval-methods=style"
استاندارد ISO/IEC TS 18661\-3 مقادیر مجاز جدیدی برای \&\f(CW\*(C`FLT_EVAL_METHOD\*(C'\fR تعریف می‌کند که نشان می‌دهند عملیات و مقادیر ثابتی که دارای یک نوع معنایی با قالب مبادله (interchange) یا توسعه‌یافته (extended) هستند، باید با دقت و دامنهٔ آن نوع ارزیابی شوند. این مقادیر جدید اَبَرمجموعه‌ای از مقادیر مجاز تحت C99/C11 هستند که معنای سایر مقادیر مثبت \f(CW\*(C`FLT_EVAL_METHOD\*(C'\fR را مشخص نکرده‌اند. به این ترتیب، کدهای منطبق بر C11 ممکن است با انتظار احتمال وجود مقادیر جدید نوشته نشده باشند.
.Sp
\&\fB\-fpermitted\-flt\-eval\-methods\fR مشخص می‌کند که آیا کامپایلر تنها باید مقادیر \f(CW\*(C`FLT_EVAL_METHOD\*(C'\fR مشخص‌شده در C99/C11 را مجاز بداند، یا مجموعهٔ توسعه‌یافته مقادیر مشخص‌شده در ISO/IEC TS 18661\-3 را.
.Sp
\&\fIstyle\fR بسته به مورد، \f(CW\*(C`c11\*(C'\fR یا \f(CW\*(C`ts\-18661\-3\*(C'\fR است.
.Sp
مقدار پیش‌فرض در حالت سازگار با استاندارد (\fB\-std=c11\fR یا مشابه آن)، \fB\-fpermitted\-flt\-eval\-methods=c11\fR است. پیش‌فرض در یک گویش GNU (\fB\-std=gnu11\fR یا مشابه آن)، \&\fB\-fpermitted\-flt\-eval\-methods=ts\-18661\-3\fR است.
.Sp
گزینه‌های \fB\-fdeps\-*\fR برای استخراج اطلاعات ساختاریافتهٔ وابستگی‌ها برای یک مبدأ به‌کار می‌روند. این امر شامل تعیین این است که چه منابع ارائه‌شده توسط سایر فایل‌های مبدأ برای کامپایل این مبدأ نیاز خواهد بود و همچنین چه منابعی توسط این مبدأ ارائه می‌شود. این اطلاعات می‌تواند برای افزودن وابستگی‌های مورد نیاز میان قواعد کامپایل مبداهای وابسته بر اساس محتوای آن‌ها استفاده شود، به‌جای آن‌که لازم باشد این اطلاعات در ابزارهای ساخت نیز بازتاب یابد.
.IP \fB\-fdeps\-file=\fR\fIfile\fR 4
.IX Item "-fdeps-file=file"
محل نوشتن اطلاعات ساختاریافتهٔ وابستگی‌ها.
.IP \fB\-fdeps\-format=\fR\fIformat\fR 4
.IX Item "-fdeps-format=format"
قالب مورد استفاده برای اطلاعات ساختاریافتهٔ وابستگی‌ها. در حال حاضر \fBp1689r5\fR تنها قالب پشتیبانی‌شده است. توجه داشته باشید هنگامی که این آرگومان مشخص شود، خروجی \fB\-MF\fR از برخی اطلاعات (به‌ویژه ماژول‌های C++) تهی می‌شود تا از نحو توسعه‌یافتهٔ makefile که برای بیشتر ابزارها قابل فهم نیست استفاده نکند.
.IP \fB\-fdeps\-target=\fR\fIfile\fR 4
.IX Item "-fdeps-target=file"
مشابه \fB\-MT\fR است اما برای اطلاعات ساختاریافتهٔ وابستگی‌ها. این گزینه مقصدی را مشخص می‌کند که در نهایت به هر یک از منابع مورد نیاز احتیاج خواهد داشت و هر منبع استخراج‌شده از مبدأ را که ممکن است مورد نیاز سایر منابع باشد فراهم می‌کند.
.IP \fB\-fplan9\-extensions\fR 4
.IX Item "-fplan9-extensions"
برخی از ساختارهای غیراستاندارد به‌کاررفته در کد Plan 9 را می‌پذیرد.
.Sp
این گزینه \fB\-fms\-extensions\fR را فعال می‌کند، اجازه می‌دهد اشاره‌گرها به ساختارهای با فیلدهای بی‌نام به توابعی که انتظار اشاره‌گر به عناصر از نوع فیلد را دارند ارسال شوند، و امکان ارجاع به فیلدهای بی‌نامِ اعلان‌شده با typedef را فراهم می‌کند. این گزینه تنها برای C پشتیبانی می‌شود، نه C++.
.IP \fB\-fsigned\-bitfields\fR 4
.IX Item "-fsigned-bitfields"
.PD 0
.IP \fB\-funsigned\-bitfields\fR 4
.IX Item "-funsigned-bitfields"
.IP \fB\-fno\-signed\-bitfields\fR 4
.IX Item "-fno-signed-bitfields"
.IP \fB\-fno\-unsigned\-bitfields\fR 4
.IX Item "-fno-unsigned-bitfields"
.PD
این گزینه‌ها تعیین می‌کنند که آیا یک میدان‌بیتی (bit-field) در حالتی که در اعلان آن از هیچ‌یک از \f(CW\*(C`signed\*(C'\fR یا \f(CW\*(C`unsigned\*(C'\fR استفاده نشده باشد، علامت‌دار باشد یا بی‌علامت. به‌طور پیش‌فرض، چنین میدان‌بیتی علامت‌دار است، زیرا سازگارتر است: انواع عدد صحیح پایه مانند \f(CW\*(C`int\*(C'\fR از انواع علامت‌دار هستند.
.IP \fB\-fsigned\-char\fR 4
.IX Item "-fsigned-char"
.PD 0
.IP \fB\-funsigned\-char\fR 4
.IX Item "-funsigned-char"
.PD
\&\fB\-fsigned\-char\fR اجازه می‌دهد نوع \f(CW\*(C`char\*(C'\fR مانند \f(CW\*(C`signed char\*(C'\fR علامت‌دار باشد، در حالی که \fB\-funsigned\-char\fR اجازه می‌دهد نوع \f(CW\*(C`char\*(C'\fR مانند \f(CW\*(C`unsigned char\*(C'\fR بی‌علامت باشد.
.Sp
توجه داشته باشید که \fB\-fsigned\-char\fR معادل \fB\-fno\-unsigned\-char\fR است که صورت نفی‌شدهٔ \fB\-funsigned\-char\fR می‌باشد. به همین ترتیب، گزینهٔ \&\fB\-fno\-signed\-char\fR معادل \fB\-funsigned\-char\fR است.
.Sp
هر مقصدی که توسط GCC پشتیبانی می‌شود دارای یک پیش‌فرض برای نوع \f(CW\*(C`char\*(C'\fR است، که معمولاً در سند ABI ویژهٔ پردازنده برای آن مقصد مشخص می‌شود. این نوع در حالت پیش‌فرض یا مانند \f(CW\*(C`unsigned char\*(C'\fR است یا مانند \f(CW\*(C`signed char\*(C'\fR.
.Sp
در حالت ایده‌آل، یک برنامهٔ پایاپذیر (portable) وقتی به علامت‌دار بودن یک شیء وابسته است، باید همیشه از \f(CW\*(C`signed char\*(C'\fR یا \&\f(CW\*(C`unsigned char\*(C'\fR استفاده کند. اما برنامه‌های بسیاری نوشته شده‌اند که از \f(CW\*(C`char\*(C'\fR ساده استفاده می‌کنند و بسته به ماشین‌هایی که برای آن‌ها نوشته شده‌اند، انتظار دارند علامت‌دار یا بی‌علامت باشد. این گزینه‌ها به شما اجازه می‌دهند چنین برنامه‌ای را با رفتار پیش‌فرض برعکس به‌کار بگیرید.
.Sp
نوع \f(CW\*(C`char\*(C'\fR همیشه نوعی متمایز از هر یک از \&\f(CW\*(C`signed char\*(C'\fR یا \f(CW\*(C`unsigned char\*(C'\fR است، هرچند که رفتار آن همواره دقیقاً شبیه یکی از این دو می‌باشد.
.IP "\fB\-fstrict\-flex\-arrays\fR (تنها C و C++)" 4
.IX Item "-fstrict-flex-arrays (C and C++ only)".PD 0
.IP "\fB\-fstrict\-flex\-arrays=\fR\fIlevel\fR\fB \fR(فقط C و C++)" 4
.IX Item "-fstrict-flex-arrays=level (C and C++ only)"
.PD
کنترل این‌که چه زمانی با آرایه انتهایی یک ساختار به منظور دسترسی به عناصر آن، به عنوان یک عضو آرایه انعطاف‌پذیر رفتار شود. مقدار \fIlevel\fR میزان سخت‌گیری را تعیین می‌کند.
.Sp
گزینه \&\fB\-fstrict\-flex\-arrays\fR معادل \&\fB\-fstrict\-flex\-arrays=3\fR است که سخت‌گیرانه‌ترین حالت می‌باشد؛ آرایه انتهایی تنها زمانی به عنوان یک عضو آرایه انعطاف‌پذیر در نظر گرفته می‌شود که طبق استاندارد C99 به بعد، به عنوان عضو آرایه انعطاف‌پذیر اعلان شده باشد.
.Sp
شکل منفی \fB\-fno\-strict\-flex\-arrays\fR معادل \&\fB\-fstrict\-flex\-arrays=0\fR است که کمترین سخت‌گیری را دارد. در این حالت تمام آرایه‌های انتهایی ساختارها به عنوان اعضای آرایه انعطاف‌پذیر در نظر گرفته می‌شوند.
.Sp
دو سطح دیگر بین 0 و 3 وجود دارد که برای پشتیبانی از کدهای قدیمی‌تر که از افزونه آرایه با طول صفر GCC (\fB[0]\fR) یا آرایه تک‌عنصری به عنوان اعضای آرایه انعطاف‌پذیر (\fB[1]\fR) استفاده می‌کنند، ارائه شده‌اند. هنگامی که \fIlevel\fR برابر 1 باشد، با آرایه انتهایی زمانی به عنوان عضو آرایه انعطاف‌پذیر رفتار می‌شود که به صورت \fB[]\fR، \&\fB[0]\fR یا \fB[1]\fR اعلان شده باشد. هنگامی که \fIlevel\fR برابر 2 باشد، با آرایه انتهایی زمانی به عنوان عضو آرایه انعطاف‌پذیر رفتار می‌شود که به صورت \&\fB[]\fR یا \fB[0]\fR اعلان شده باشد.
.Sp
می‌توانید این رفتار را برای یک فیلد آرایه انتهایی مشخص در یک ساختار، با استفاده از صفت متغیر \f(CW\*(C`strict_flex_array\*(C'\fR کنترل کنید.
.Sp
گزینه \fB\-fstrict_flex_arrays\fR با گزینه \&\fB\-Wstrict\-flex\-arrays\fR تعامل دارد.
.IP \fB\-fsso\-struct=\fR\fIendianness\fR 4
.IX Item "-fsso-struct=endianness"
ترتیب ذخیره‌سازی اسکالر پیش‌فرض برای ساختارها و اجتماع‌ها را روی ترتیب بایت (endianness) مشخص‌شده تنظیم می‌کند. مقادیر پذیرفته‌شده عبارتند از \fBbig\-endian\fR، \&\fBlittle\-endian\fR و \fBnative\fR برای ترتیب بایت بومی مقصد (پیش‌فرض). این گزینه برای C++ پشتیبانی نمی‌شود.
.Sp
\&\fBهشدار:\fR در صورتی که ترتیب بایت مشخص‌شده، ترتیب بایت بومی مقصد نباشد، سوییچ \fB\-fsso\-struct\fR باعث می‌شود GCC کدی تولید کند که با کد تولیدشده بدون این گزینه از نظر باینری سازگار نیست.
.SS "گزینه‌های کنترل گویش C++ (Options Controlling C++ Dialect)"
.IX Subsection "Options Controlling C++ Dialect"
این بخش گزینه‌های خط فرمانی را شرح می‌دهد که تنها برای برنامه‌های C++ معنی‌دار هستند. شما همچنین می‌توانید بیشتر گزینه‌های کامپایلر GNU را فارغ از زبانی که برنامه‌تان به آن نوشته شده است، به کار ببرید. برای مثال، ممکن است فایلی مانند \fIfirstClass.C\fR را به این صورت کامپایل کنید:
.PP
.Vb 1
\&        g++ \-g \-fstrict\-enums \-O \-c firstClass.C
.Ve
.PP
در این مثال، تنها \fB\-fstrict\-enums\fR گزینه‌ای است که منحصراً برای برنامه‌های C++ در نظر گرفته شده است؛ شما می‌توانید سایر گزینه‌ها را با هر زبانی که توسط GCC پشتیبانی می‌شود استفاده کنید.
.PP
برخی گزینه‌ها برای کامپایل برنامه‌های C، مانند \fB\-std\fR، برای برنامه‌های C++ نیز کاربرد دارند.
.PP
در ادامه فهرستی از گزینه‌هایی آمده است که \fIتنها\fR برای کامپایل برنامه‌های C++ هستند:
.IP \fB\-\-compile\-std\-module\fR 4
.IX Item "--compile-std-module"
پیش از کامپایل هر فایل منبعی که صراحتاً در خط فرمان مشخص شده است، رابط‌های ماژول کامپایل‌شده را برای واحد سرآیند \&\fB<bits/stdc++.h>\fR و ماژول‌های \fBstd\fR و \&\fBstd.compat\fR می‌سازد. این گزینه برای ساخت برنامه‌های ساده‌ای که از \fBimport std;\fR با یک دستور منفرد استفاده می‌کنند، مفید است.
.IP \fB\-fabi\-version=\fR\fIn\fR 4
.IX Item "-fabi-version=n"
از نسخه \fIn\fR از ABI مربوط به C++ استفاده می‌کند. مقدار پیش‌فرض نسخه 0 است.
.Sp
نسخه 0 به نسخه‌ای اشاره دارد که بیشترین انطباق را با مشخصات ABI در C++ دارد. بنابراین، ABI به‌دست‌آمده با استفاده از نسخه 0 با برطرف شدن باگ‌های ABI در نسخه‌های مختلف G++ تغییر خواهد کرد.
.Sp
نسخه 1، نسخه‌ای از ABI مربوط به C++ است که نخستین بار در G++ 3.2 ظاهر شد.
.Sp
نسخه 2، نسخه‌ای از ABI مربوط به C++ است که نخستین بار در G++ 3.4 ظاهر شد و تا G++ 4.9 نسخه پیش‌فرض بود.
.Sp
نسخه 3، خطایی را در نام‌گردانی (mangling) یک آدرس ثابت به عنوان آرگومان قالب اصلاح می‌کند.
.Sp
نسخه 4، که نخستین بار در G++ 4.5 ظاهر شد، نام‌گردانی استانداردی را برای انواع برداری پیاده‌سازی می‌کند.
.Sp
نسخه 5، که نخستین بار در G++ 4.6 ظاهر شد، نام‌گردانی صفت const/volatile را روی انواع اشاره‌گر به تابع، decltype یک اعلان ساده، و استفاده از یک پارامتر تابع در اعلان پارامتری دیگر را اصلاح می‌کند.
.Sp
نسخه 6، که نخستین بار در G++ 4.7 ظاهر شد، رفتار ارتقای نوع برای شمارش‌های محدوده‌دار (scoped enums) در C++11 و نام‌گردانی بسته‌های آرگومان قالب، const/static_cast، پیشوندهای ++ و \-\-، و تابع در محدوده کلاس استفاده‌شده به عنوان آرگومان قالب را اصلاح می‌کند.
.Sp
نسخه 7، که نخستین بار در G++ 4.8 ظاهر شد، با nullptr_t به عنوان یک نوع توکار رفتار کرده و نام‌گردانی لامبداها را در محدوده آرگومان‌های پیش‌فرض اصلاح می‌کند.
.Sp
نسخه 8، که نخستین بار در G++ 4.9 ظاهر شد، رفتار جایگزینی انواع توابع با توصیف‌کننده‌های cv تابع (function\-cv\-qualifiers) را اصلاح می‌کند.
.Sp
نسخه 9، که نخستین بار در G++ 5.2 ظاهر شد، هم‌ترازی \&\f(CW\*(C`nullptr_t\*(C'\fR را اصلاح می‌کند.
.Sp
نسخه 10، که نخستین بار در G++ 6.1 ظاهر شد، نام‌گردانی صفت‌هایی را که بر هویت نوع تأثیر می‌گذارند (مانند صفت‌های قرارداد فراخوانی ia32، نظیر \fBstdcall\fR) اضافه می‌کند.
.Sp
نسخه 11، که نخستین بار در G++ 7 ظاهر شد، نام‌گردانی عبارت‌های ...sizeof و نام‌های عملگر را اصلاح می‌کند. برای موجودیت‌های چندگانه با نام یکسان درون یک تابع که در محدوده‌های متفاوتی اعلان شده‌اند، نام‌گردانی از دوازدهمین رخداد به بعد تغییر می‌کند. همچنین این نسخه متضمن \fB\-fnew\-inheriting\-ctors\fR است.
.Sp
نسخه 12، که نخستین بار در G++ 8 ظاهر شد، قراردادهای فراخوانی را برای کلاس‌های خالی روی معماری مقصد x86_64 و برای کلاس‌هایی که فقط سازنده‌های کپی/انتقال حذف‌شده دارند، اصلاح می‌کند. این نسخه به طور ناخواسته قرارداد فراخوانی را برای کلاس‌هایی با سازنده کپی حذف‌شده و سازنده انتقال بدیهی تغییر می‌دهد.
.Sp
نسخه 13، که نخستین بار در G++ 8.2 ظاهر شد، تغییر ناخواسته در نسخه 12 را برطرف می‌کند.
.Sp
نسخه 14، که نخستین بار در G++ 10 ظاهر شد، نام‌گردانی عبارت nullptr را اصلاح می‌کند.
.Sp
نسخه 15، که نخستین بار در G++ 10.3 ظاهر شد، پس‌رفت برچسب ABI در G++ 10 را اصلاح می‌کند.
.Sp
نسخه 16، که نخستین بار در G++ 11 ظاهر شد، نام‌گردانی \&\f(CW\*(C`_\|_alignof_\|_\*(C'\fR را به‌گونه‌ای تغییر می‌دهد که از \f(CW\*(C`alignof\*(C'\fR و نام‌های عملگر وابسته متمایز باشد.
.Sp
نسخه 17، که نخستین بار در G++ 12 ظاهر شد، چینش کلاس‌هایی را که از کلاس‌های تجمیعی دارای مقداردهنده‌های اولیه عضو پیش‌فرض در C++14 به بالا ارث‌بری می‌کنند، تصحیح می‌کند.
.Sp
نسخه 18، که نخستین بار در G++ 13 ظاهر شد، نام‌گردانی‌های لامبداهایی را که زمینه اضافی دارند تصحیح می‌کند.
.Sp
نسخه 19، که نخستین بار در G++ 14 ظاهر شد، نام‌گردانی‌های مقیدسازی‌های ساختاریافته را جهت دربرگرفتن برچسب‌های ABI و مدیریت اعضای دارای توصیف‌کننده cv از [[no_unique_address]] تصحیح کرده و نام‌گردانی قیدهای C++20 را روی الگوهای توابع اضافه می‌کند.
.Sp
نسخه 20، که نخستین بار در G++ 15 ظاهر شد، نام‌گردانی‌های لامبداها را در مقداردهنده‌های اولیه اعضای داده‌ای ایستا تصحیح می‌کند.
.Sp
نسخه 21، که نخستین بار در G++ 16 ظاهر شد، تسخیرهای غیرضروری در لامبداهای noexcept ‏(c++/119764)، چینش کلاس پایه‌ای با تمامی سازنده‌های صراحتاً پیش‌فرض‌شده (c++/120012)، و نام‌گردانی اشیاء کلاس و آرایه با زیر‌اشیای غیرانتهایی دارای مقداردهی اولیه ضمنی صفر (c++/121231) را تصحیح می‌کند.
.Sp
همچنین ببینید: \fB\-Wabi\fR.
.IP \fB\-fabi\-compat\-version=\fR\fIn\fR 4
.IX Item "-fabi-compat-version=n"
در مقصدهایی که از نام‌های مستعار قوی (strong aliases) پشتیبانی می‌کنند، G++ با ایجاد یک نام مستعار با نام نام‌گردانی‌شده صحیح هنگام تعریف نمادی با نام نام‌گردانی‌شده نادرست، تغییرات نام‌گردانی را دور می‌زند. این سوییچ مشخص می‌کند که از کدام نسخه ABI برای این نام مستعار استفاده شود.
.Sp
با \fB\-fabi\-version=0\fR (پیش‌فرض)، این مقدار به طور پیش‌فرض 13 (سازگاری با GCC 8.2) است. اگر نسخه دیگری از ABI به صورت صریح انتخاب شود، این مقدار به طور پیش‌فرض 0 خواهد بود. برای سازگاری با نسخه‌های 3.2 تا 4.9 کامپایلر GCC، از \fB\-fabi\-compat\-version=2\fR استفاده کنید.
.Sp
اگر این گزینه مشخص نشود ولی \fB\-Wabi=\fR\fIn\fR مشخص گردد، از آن نسخه برای نام‌های مستعار سازگاری استفاده می‌شود. اگر این گزینه همراه با \fB\-Wabi\fR (بدون تعیین نسخه) مشخص شود، نسخه تعیین‌شده در این گزینه برای هشدار به کار می‌رود.
.IP \fB\-fno\-access\-control\fR 4
.IX Item "-fno-access-control"
تمام بررسی‌های کنترل دسترسی را غیرفعال می‌کند. این سوییچ عمدتاً برای دور زدن باگ‌ها در کد کنترل دسترسی کاربرد دارد.
.IP \fB\-faligned\-new\fR 4
.IX Item "-faligned-new"
.PD 0.IP \fB\-faligned\-new=\fR\fIalignment\fR 4
.IX Item "-faligned-new=alignment"
.PD
فعال‌سازی پشتیبانی از \f(CW\*(C`new\*(C'\fR در C++17 برای انواعی که به هم‌ترازی بیشتری نسبت به آنچه \f(CW\*(C`void* ::operator new(std::size_t)\*(C'\fR فراهم می‌کند نیاز دارند. یک آرگومان عددی مانند \f(CW\*(C`\-faligned\-new=32\*(C'\fR می‌تواند برای تعیین میزان هم‌ترازی (به بایت) ارائه‌شده توسط آن تابع استفاده شود، اما کاربران اندکی نیاز خواهند داشت مقدار پیش‌فرض
\&\f(CWalignof(std::max_align_t)\fR را بازنویسی کنند.
.Sp
این پرچم به‌طور پیش‌فرض برای \fB\-std=c++17\fR فعال است.
.IP \fB\-fno\-assume\-sane\-operators\-new\fR 4
.IX Item "-fno-assume-sane-operators-new"
استاندارد C++ اجازه می‌دهد عملگرهای سراسری \f(CW\*(C`new\*(C'\fR، \f(CW\*(C`new[]\*(C'\fR،
\&\f(CW\*(C`delete\*(C'\fR و \f(CW\*(C`delete[]\*(C'\fR جایگزین شوند، اگرچه بسیاری از برنامه‌های C++
آن‌ها را جایگزین نکرده و فقط از نسخه ارائه‌شده توسط پیاده‌سازی استفاده می‌کنند.
علاوه‌بر این، استاندارد C++ اجازه می‌دهد این فراخوانی‌ها در صورتی که از عبارات new یا delete
انجام شده باشند، حذف شوند (و به همین ترتیب، در صورت استفاده از توابع \f(CW\*(C`_\|_builtin_operator_new\*(C'\fR
یا \f(CW\*(C`_\|_builtin_operator_delete\*(C'\fR نیز همین فرض در نظر گرفته می‌شود).
این گزینه امکان کنترل روی برخی بهینه‌سازی‌ها پیرامون فراخوانی این عملگرها را فراهم می‌کند.
با گزینه \f(CW\*(C`\-fassume\-sane\-operators\-new\-delete\*(C'\fR ممکن است GCC فرض کند که
فراخوانی عملگرهای سراسری قابل‌جایگزینی از عبارات new یا delete یا از فراخوانی‌های
\f(CW\*(C`_\|_builtin_operator_new\*(C'\fR یا \f(CW\*(C`_\|_builtin_operator_delete\*(C'\fR هیچ متغیر سراسری
یا متغیرهایی را که آدرس آن‌ها می‌تواند به عملگرها سرایت کند (وضعیت سراسری یا global state؛
به‌جز \f(CW\*(C`errno\*(C'\fR برای عملگرهای \&\f(CW\*(C`new\*(C'\fR و \f(CW\*(C`new[]\*(C'\fR) نمی‌خوانند یا تغییر نمی‌دهند.
این امر اکثر بهینه‌سازی‌ها را در طول این فراخوانی‌ها ممکن می‌سازد و چیزی است که
عملگرهای ارائه‌شده توسط پیاده‌سازی آن را برآورده می‌کنند مگر اینکه جزئیات پیاده‌سازی \f(CW\*(C`malloc\*(C'\fR
در کد قابل‌مشاهده باشد یا قلاب‌های (hooks) \f(CW\*(C`malloc\*(C'\fR استفاده شوند، اما اگر برنامه‌ای
این عملگرها را جایگزین کند ممکن است برقرار نباشد. این رفتار به‌طور پیش‌فرض فعال است.
با گزینه \f(CW\*(C`\-fno\-assume\-sane\-operators\-new\-delete\*(C'\fR، کامپایلر GCC باید فرض کند
تمامی این فراخوانی‌ها (چه از عبارات new یا delete و چه فراخوانی مستقیم) ممکن است
وضعیت سراسری را بخوانند و بنویسند مگر خلاف آن ثابت شود (مثلاً هنگامی که GCC
پیاده‌سازی آن‌ها را کامپایل می‌کند). اگر آن عملگرها جایگزین شده‌اند یا ممکن است جایگزین شوند
و کد باید انتظار چنین رفتاری را داشته باشد، از این گزینه استفاده کنید.
.IP \fB\-fchar8_t\fR 4
.IX Item "-fchar8_t"
.PD 0
.IP \fB\-fno\-char8_t\fR 4
.IX Item "-fno-char8_t"
.PD
فعال‌سازی پشتیبانی از \f(CW\*(C`char8_t\*(C'\fR همان‌طور که برای C++20 تصویب شده است. این شامل
افزودن نوع پایه‌ای جدید \f(CW\*(C`char8_t\*(C'\fR، تغییراتی در انواع لیترال‌های نویسه و رشته‌ای UTF\-8،
امضاهای جدید برای لیترال‌های تعریف‌شده توسط کاربر (user\-defined literals)، به‌روزرسانی‌های
کتابخانه استاندارد مرتبط، و ماکروهای آزمون ویژگی جدید \&\f(CW\*(C`_\|_cpp_char8_t\*(C'\fR
و \f(CW\*(C`_\|_cpp_lib_char8_t\*(C'\fR است.
.Sp
این گزینه امکان سربارگذاری (overload) توابع را برای رشته‌های معمولی و UTF\-8 فراهم می‌کند:
.Sp
.Vb 4
\&        int f(const char *);    // #1
\&        int f(const char8_t *); // #2
\&        int v1 = f("text");     // Calls #1
\&        int v2 = f(u8"text");   // Calls #2
.Ve
.Sp
و امضاهای جدیدی را برای لیترال‌های تعریف‌شده توسط کاربر معرفی می‌کند:
.Sp
.Vb 6
\&        int operator""_udl1(char8_t);
\&        int v3 = u8\*(Aqx\*(Aq_udl1;
\&        int operator""_udl2(const char8_t*, std::size_t);
\&        int v4 = u8"text"_udl2;
\&        template<typename T, T...> int operator""_udl3();
\&        int v5 = u8"text"_udl3;
.Ve
.Sp
تغییر انواع لیترال‌های رشته‌ای و نویسه‌ای UTF\-8 ناسازگاری‌هایی با ISO C++11 و استانداردهای
پس از آن ایجاد می‌کند. به عنوان مثال، کد زیر بر اساس ISO C++11 خوش‌ساخت (well\-formed) است،
اما هنگام مشخص کردن \&\fB\-fchar8_t\fR بدساخت (ill\-formed) محسوب می‌شود.
.Sp
.Vb 11
\&        const char *cp = u8"xx";// error: invalid conversion from
\&                                //        \`const char8_t*\*(Aq to \`const char*\*(Aq
\&        int f(const char*);
\&        auto v = f(u8"xx");     // error: invalid conversion from
\&                                //        \`const char8_t*\*(Aq to \`const char*\*(Aq
\&        std::string s{u8"xx"};  // error: no matching function for call to
\&                                //        \`std::basic_string<char>::basic_string()\*(Aq
\&        using namespace std::literals;
\&        s = u8"xx"s;            // error: conversion from
\&                                //        \`basic_string<char8_t>\*(Aq to non\-scalar
\&                                //        type \`basic_string<char>\*(Aq requested
.Ve
.IP \fB\-fcheck\-new\fR 4
.IX Item "-fcheck-new"
بررسی اینکه اشاره‌گر بازگردانده شده توسط \f(CW\*(C`operator new\*(C'\fR قبل از تلاش برای تغییر
حافظه اختصاص‌یافته، غیرتهی (non\-null) باشد. این بررسی معمولاً غیرضروری است زیرا
استاندارد C++ مشخص می‌کند که \&\f(CW\*(C`operator new\*(C'\fR تنها در صورتی \f(CW0\fR را برمی‌گرداند
که به‌صورت \&\f(CWthrow()\fR اعلان شده باشد، که در این حالت کامپایلر حتی بدون این گزینه نیز
همیشه مقدار بازگشتی را بررسی می‌کند. در تمام موارد دیگر، زمانی که \&\f(CW\*(C`operator new\*(C'\fR
دارای مشخصات استثنای غیرخالی باشد، اتمام حافظه با پرتاب \f(CW\*(C`std::bad_alloc\*(C'\fR اعلام می‌شود.
همچنین ببینید: \&\fBnew (nothrow)\fR.
.IP \fB\-fconcepts\fR 4
.IX Item "-fconcepts"
فعال‌سازی پشتیبانی از ویژگی مفاهیم (Concepts) در C++ برای مقیدسازی آرگومان‌های الگو.
با \fB\-std=c++20\fR و بالاتر، ویژگی Concepts بخشی از استاندارد زبان است، بنابراین
\fB\-fconcepts\fR به‌طور پیش‌فرض فعال است.
.Sp
برخی از ساختارهایی که توسط مشخصات فنی پیشین «پسوندهای C++ برای مفاهیم» (ISO 19217 (2015))
مجاز بودند اما به استاندارد راه نیافتند، پیش‌تر می‌توانستند توسط \&\fB\-fconcepts\-ts\fR
فعال شوند. گزینه \fB\-fconcepts\-ts\fR در GCC 14 منسوخ و در GCC 15 حذف شد؛ از کاربران
انتظار می‌رود کدهای خود را به مفاهیم C++20 تبدیل کنند.
.IP \fB\-fconcepts\-diagnostics\-depth=\fR\fIn\fR 4
.IX Item "-fconcepts-diagnostics-depth=n"
تعیین حداکثر عمق بازپخش خطا در طول عیب‌یابی بازگشتیِ شکست در برآورده شدن قید.
پیش‌فرض 1 است.
.IP \fB\-fconstexpr\-depth=\fR\fIn\fR 4
.IX Item "-fconstexpr-depth=n"
تنظیم حداکثر عمق ارزیابی تو در تو برای توابع constexpr در C++11 به \fIn\fR. تعیین یک
محدودیت برای تشخیص بازگشت بی‌پایان در حین ارزیابی عبارات ثابت لازم است. حداقل مقدار
مشخص‌شده توسط استاندارد 512 است.
.IP \fB\-fconstexpr\-cache\-depth=\fR\fIn\fR 4
.IX Item "-fconstexpr-cache-depth=n"
تنظیم حداکثر سطح عمق ارزیابی تو در تو برای توابع constexpr در C++11 که حافظه نهان (کَش)
می‌شوند به \fIn\fR. این یک روش مکاشفه‌ای (heuristic) است که تعادلی میان سرعت کامپایل
(زمانی که حافظه نهان از محاسبات تکراری جلوگیری می‌کند) در برابر مصرف حافظه (زمانی که
حافظه نهان به دلیل ارزیابی‌های بسیار بازگشتی بسیار بزرگ می‌شود) برقرار می‌سازد. مقدار
پیش‌فرض 8 است. احتمالاً کاربران بسیار کمی نیاز به تغییر آن خواهند داشت، اما اگر کد شما
محاسبات سنگین constexpr انجام می‌دهد، ممکن است بخواهید برای یافتن مقداری که بهترین عملکرد
را دارد آزمایش کنید.
.IP \fB\-fconstexpr\-fp\-except\fR 4
.IX Item "-fconstexpr-fp-except"
پیوست F از استاندارد C مشخص می‌کند که استثناهای ممیز شناور IEC559 رخ‌داده در زمان کامپایل
نباید مانع از کامپایل شوند. کامپایلرهای C++ از گذشته این راهنما را دنبال نکرده‌اند و در عوض با
تقسیم ممیز شناور بر صفر با وجود داشتن مقداری کاملاً مشخص، به عنوان مقداری غیرثابت برخورد کرده‌اند.
این پرچم به کامپایلر می‌گوید که به پیوست F نسبت به سایر قوانینی که بیان می‌کنند یک عملیات
خاص تعریف‌نشده است، اولویت دهد.
.Sp
.Vb 1
\&        constexpr float inf = 1./0.; // OK with \-fconstexpr\-fp\-except
.Ve
.IP \fB\-fconstexpr\-loop\-limit=\fR\fIn\fR 4
.IX Item "-fconstexpr-loop-limit=n"
تنظیم حداکثر تعداد تکرارهای یک حلقه در توابع constexpr در C++14 به \fIn\fR. وجود یک
محدودیت برای تشخیص حلقه‌های بی‌پایان در حین ارزیابی عبارت ثابت الزامی است. پیش‌فرض
262144 (1<<18) است.
.IP \fB\-fconstexpr\-ops\-limit=\fR\fIn\fR 4
.IX Item "-fconstexpr-ops-limit=n"
تنظیم حداکثر تعداد عملیات‌ها در طول یک ارزیابی constexpr منفرد. حتی زمانی که تعداد
تکرارهای یک حلقه منفرد با حد بالا محدود شده باشد، چنانچه چندین حلقه تو در تو وجود
داشته باشد و هر یک دارای تکرارهای فراوان ولی کمتر از حد مذکور باشند، یا اگر در بدنه
یک حلقه یا حتی خارج از حلقه عبارات بسیار زیادی نیاز به ارزیابی داشته باشند، ارزیابی
constexpr حاصل ممکن است بسیار طولانی شود. پیش‌فرض 33554432 (1<<25) است.
.IP \fB\-fcontracts\fR 4
.IX Item "-fcontracts"
فعال‌سازی پشتیبانی از ویژگی قراردادها (Contracts) در C++، همان‌طور که در پیش‌نویس
کاری C++26 (سند N5003) مشخص شده است.
.Sp
در صورت نقض یک قرارداد اعمال‌شده (enforced) یا مشاهده‌شده (observed) (به
\fB\-fcontract\-evaluation\-semantic\fR در زیر مراجعه کنید)، یک گرداننده نقض
(violation handler) فراخوانی می‌شود؛ کتابخانه استاندارد یک گرداننده پیش‌فرض ارائه می‌دهد
که اطلاعات مربوط به قراردادی که ناموفق بوده است را منتشر می‌کند.
.Sp
کاربران می‌توانند با تعریف تابع زیر، گرداننده نقض پیش‌فرض را جایگزین کنند:
.Sp
.Vb 2
\&        void
\&        handle_contract_violation (const std::contracts::contract_violation&);
.Ve
.IP \fB\-fcontract\-evaluation\-semantic=\fR\fIsemantic\fR 4
.IX Item "-fcontract-evaluation-semantic=semantic"
تنظیم معنایی (semantic) که قراردادها با آن ارزیابی می‌شوند به \fIsemantic\fR.
.Sp
مقادیر موجود برای حالت ارزیابی عبارتند از:
.Sp
\&\*(Aq\f(CW\*(C`ignored\*(C'\fR\*(Aq بررسی‌های قرارداد نادیده گرفته می‌شوند، و هیچ بررسی‌ای در
زمان کامپایل یا زمان اجرا اضافه نخواهد شد.
.Sp
\&\*(Aq\f(CW\*(C`observed\*(C'\fR\*(Aq بررسی‌های قرارداد (در زمان اجرا) انجام می‌شوند و در صورت
شکست، یک گرداننده فراخوانی می‌شود که امکان اقداماتی مانند ثبت وقایع (logging) یا صدور
هشدارهای زمان اجرا را فراهم می‌کند. هنگامی که گرداننده بازمی‌گردد، اجرای کد ادامه خواهد یافت.
در زمان کامپایل، بررسی‌ها برای ارزیابی‌های \f(CW\*(C`constexpr\*(C'\fR انجام می‌شوند، که در این حالت
در صورت شکست بررسی، یک پیام تشخیصی صادر می‌شود.
.Sp
\&\*(Aq\f(CW\*(C`enforce\*(C'\fR\*(Aq بررسی‌های قرارداد انجام می‌شوند و در صورت شکست، گرداننده
فراخوانی می‌شود. با بازگشت گرداننده، اجرای کد خاتمه می‌یابد و از ادامه اجرای آن پس از مورد
ناموفق جلوگیری می‌شود. در زمان کامپایل، بررسی‌ها بر روی \f(CW\*(C`constexpr\*(C'\fR اعمال می‌شوند
و در صورت شکست، برنامه بدساخت (ill\-formed) تلقی شده و یک خطا صادر خواهد شد.
.Sp
\&\*(Aq\f(CW\*(C`quick_enforce\*(C'\fR\*(Aq بررسی‌های قرارداد (در زمان اجرا) انجام می‌شوند و در صورت
شکست، اجرا بلافاصله (بدون فراخوانی هیچ گرداننده‌ای) خاتمه می‌یابد. در زمان کامپایل، هیچ تفاوتی
در رفتار بین این گزینه و حالت \f(CW\*(C`enforce\*(C'\fR وجود ندارد، زیرا در زمان کامپایل هیچ
گرداننده‌ای فراخوانی نمی‌شود..IP \fB\-fcontracts\-conservative\-ipa\fR 4
.IX Item "-fcontracts-conservative-ipa"
این گزینه مانع از اقدام تحلیل میان‌رویه‌ای (inter\-procedural analysis) در زمانی می‌شود که بدنه یک تابع درون‌خطی (inline) در یک TU مشخص قابل مشاهده است. این امر شرایطی را پوشش می‌دهد که در آن ارزیابی شرایط قرارداد (contract) مجاز به تفاوت بین TUها باشد؛ بدین معنا که چنین اقداماتی بالقوه نادرست خواهند بود.
.IP \fB\-fcontract\-checks\-outlined\fR 4
.IX Item "-fcontract-checks-outlined"
به‌طور پیش‌فرض، بررسی‌های قرارداد برای شرایط \f(CW\*(C`pre\*(C'\fR و \f(CW\*(C`post\*(C'\fR به‌صورت درون‌خطی در بدنه توابع بسط می‌یابند. این گزینه باعث می‌شود در عوض یک تابع کوچک (حاوی بررسی‌ها) ایجاد شود که در موقعیت مربوطه فراخوانی می‌گردد. این کار اجازه می‌دهد معیارهای متفاوتی برای کامپایل بخش بررسی و باقی‌مانده بدنه تابع اعمال شود.
.IP \fB\-fcontract\-disable\-optimized\-checks\fR 4
.IX Item "-fcontract-disable-optimized-checks"
هنگامی که بررسی‌های شرایط \f(CW\*(C`pre\*(C'\fR و \f(CW\*(C`post\*(C'\fR برون‌خط (outlined) می‌شوند (با استفاده از \&\fB\-fcontract\-checks\-outlined\fR)، این گزینه مراحل بهینه‌سازی را برای آن توابع غیرفعال می‌کند که می‌تواند از حذف (elision) ناخواسته مراحل بررسی جلوگیری کند.
.IP \fB\-fcontracts\-client\-check=\fR\fImode\fR 4
.IX Item "-fcontracts-client-check=mode"
این گزینه درج بررسی‌ها را در محل‌های فراخوانی (بررسی سمت فراخواننده / caller\-side) فعال می‌کند.
.Sp
مقدار \fImode\fR مشخص می‌کند که کدام بررسی‌های قرارداد انجام شوند:
\&\*(Aq\f(CW\*(C`none\*(C'\fR\*(Aq بدون بررسی در سمت فراخواننده/کلاینت (پیش‌فرض)
.Sp
\&\*(Aq\f(CW\*(C`pre\*(C'\fR\*(Aq پیش‌شرط‌ها در سمت فراخواننده/کلاینت بررسی می‌شوند.
.Sp
\&\*(Aq\f(CW\*(C`all\*(C'\fR\*(Aq هم پیش‌شرط‌ها و هم پس‌شرط‌ها در سمت فراخواننده/کلاینت بررسی می‌شوند.
.IP \fB\-fcontracts\-definition\-check=\fR\fImode\fR 4
.IX Item "-fcontracts-definition-check=mode"
این گزینه امکان غیرفعال کردن بررسی‌های سمت فراخوانده/تعریف (callee/definition\-side) را فراهم می‌کند، که در صورت فعال بودن ویژگی قراردادها، در حالت عادی به‌طور پیش‌فرض فعال هستند.
.Sp
متغیر \fImode\fR دارای مقادیر \*(Aq\f(CW\*(C`on\*(C'\fR\*(Aq و \*(Aq\f(CW\*(C`off\*(C'\fR\*(Aq است.
.IP \fB\-fcoroutines\fR 4
.IX Item "-fcoroutines"
پشتیبانی از افزونه کوروتین‌های C++ را فعال می‌کند. با \fB\-std=c++20\fR و بالاتر، کوروتین‌ها بخشی از استاندارد زبان هستند، بنابراین \&\fB\-fcoroutines\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-fdiagnostics\-all\-candidates\fR 4
.IX Item "-fdiagnostics-all-candidates"
به فرانت‌اند C++ اجازه می‌دهد هنگام شکست در تفکیک سربارگذاری (overload resolution)، همه نامزدها را گزارش کند، از جمله زمانی که یک تابع حذف‌شده (deleted function) انتخاب شده باشد.
.IP \fB\-fdump\-lang\-\fR 4
.IX Item "-fdump-lang-"
.PD 0
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR 4
.IX Item "-fdump-lang-switch"
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR 4
.IX Item "-fdump-lang-switch-options"
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR 4
.IX Item "-fdump-lang-switch-options=filename"
.PD
تخلیه (dump) اطلاعات مختص به C++ را کنترل می‌کند. بخش‌های \fIoptions\fR و \fIfilename\fR همان‌طور که در گزینهٔ \&\fB\-fdump\-tree\fR شرح داده شده است رفتار می‌کنند. مقادیر \fIswitch\fR زیر پذیرفته می‌شوند:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
تمام موارد زیر را فعال می‌کند.
.IP \fBclass\fR 4
.IX Item "class"
اطلاعات سلسله‌مراتب کلاس را تخلیه می‌کند. اطلاعات جدول مجازی (virtual table) صادر می‌شود مگر اینکه \*(Aq\fBslim\fR\*(Aq مشخص شده باشد.
.IP \fBmodule\fR 4
.IX Item "module"
اطلاعات ماژول را تخلیه می‌کند. گزینه‌های \fBlineno\fR (مکان‌ها)، \&\fBgraph\fR (دسترس‌پذیری)، \fBblocks\fR (خوشه‌ها)، \&\fBuid\fR (سریال‌سازی)، \fBalias\fR (قابل ادغام)، \&\fBasmname\fR (مربوط به Elrond)، \fBeh\fR (نگاشت‌کننده) و \fBvops\fR (ماکروها) ممکن است اطلاعات تکمیلی ارائه دهند.
.IP \fBraw\fR 4
.IX Item "raw"
داده‌های خام درخت (tree) داخلی را تخلیه می‌کند.
.IP \fBtinst\fR 4
.IX Item "tinst"
دنباله نمونه‌سازی‌های قالب (template instantiations) را به‌صورت تورفته برای نمایش عمق بازگشت تخلیه می‌کند. گزینه \fBlineno\fR مکان منبعی را که نمونه‌سازی در آن رخ داده اضافه می‌کند، و گزینه \&\fBdetails\fR همچنین جایگزینی‌های پیش از نمونه‌سازی، مانند موارد انجام‌شده در حین استنتاج آرگومان قالب را تخلیه می‌کند.
.Sp
خطوط در خروجی تخلیه tinst. با \fBI\fR برای یک نمونه‌سازی، \&\fBS\fR برای یک جایگزینی دیگر، و \fBR[IS]\fR برای بافت بازگشایی‌شدهٔ یک نمونه‌سازی به‌تعویق‌افتاده شروع می‌شوند.
.RE
.RS 4
.RE
.IP \fB\-fno\-elide\-constructors\fR 4
.IX Item "-fno-elide-constructors"
استاندارد C++ به یک پیاده‌سازی اجازه می‌دهد از ایجاد شیء موقتی که تنها برای مقداردهی اولیه شیء دیگری از همان نوع استفاده می‌شود، صرف‌نظر کند. تعیین این گزینه آن بهینه‌سازی را غیرفعال کرده و G++ را مجبور می‌کند سازنده کپی (copy constructor) را در تمام موارد فراخوانی کند. این گزینه همچنین باعث می‌شود G++ توابع عضو بدیهی (trivial member functions) را که در غیر این صورت به‌صورت درون‌خطی بسط می‌یافتند، فراخوانی کند.
.Sp
در C++17، کامپایلر ملزم به صرف‌نظر کردن از این اشیاء موقت است، اما این گزینه همچنان بر توابع عضو بدیهی تأثیر می‌گذارد.
.IP \fB\-fno\-enforce\-eh\-specs\fR 4
.IX Item "-fno-enforce-eh-specs"
کدی برای بررسی نقض مشخصات استثنا (exception specifications) در زمان اجرا تولید نمی‌کند. این گزینه استاندارد C++ را نقض می‌کند، اما ممکن است برای کاهش اندازه کد در ساخت‌های نهایی مفید باشد، بسیار شبیه به تعریف کردن \&\f(CW\*(C`NDEBUG\*(C'\fR. این امر به کد کاربر اجازه پرتاب استثنا در نقض مشخصات استثنا را نمی‌دهد؛ کامپایلر همچنان بر اساس مشخصات بهینه‌سازی می‌کند، بنابراین پرتاب یک استثنای غیرمنتظره منجر به رفتار تعریف‌نشده (undefined behavior) در زمان اجرا می‌شود.
.IP \fB\-fextern\-tls\-init\fR 4
.IX Item "-fextern-tls-init"
.PD 0
.IP \fB\-fno\-extern\-tls\-init\fR 4
.IX Item "-fno-extern-tls-init"
.PD
استانداردهای C++11 و OpenMP به متغیرهای \f(CW\*(C`thread_local\*(C'\fR و \&\f(CW\*(C`threadprivate\*(C'\fR اجازه مقداردهی اولیه پویا (زمان اجرا) را می‌دهند. برای پشتیبانی از این ویژگی، هرگونه استفاده از چنین متغیری از طریق یک تابع پوششی (wrapper function) انجام می‌شود که هرگونه مقداردهی اولیه لازم را اجرا می‌کند. هنگامی که استفاده و تعریف متغیر در یک واحد ترجمه (translation unit) یکسان باشد، این بار اضافه (overhead) می‌تواند با بهینه‌سازی حذف شود، اما زمانی که استفاده در یک واحد ترجمه دیگر باشد، بار اضافه قابل توجهی وجود دارد حتی اگر متغیر واقعاً نیازی به مقداردهی اولیه پویا نداشته باشد. اگر برنامه‌نویس بتواند مطمئن باشد که هیچ استفاده‌ای از متغیر در یک TU غیرتعریف‌کننده نیازی به راه‌اندازی مقداردهی اولیه پویا ندارد (خواه به این دلیل که متغیر به‌صورت ایستا مقداردهی شده است، یا اینکه استفاده از متغیر در TU تعریف‌کننده پیش از هر استفاده‌ای در TU دیگر اجرا خواهد شد)، می‌تواند با استفاده از گزینهٔ \&\fB\-fno\-extern\-tls\-init\fR از این بار اضافه جلوگیری کند.
.Sp
در مقصدهایی که از نام‌های مستعار نماد (symbol aliases) پشتیبانی می‌کنند، پیش‌فرض \&\fB\-fextern\-tls\-init\fR است. در مقصدهایی که از نام‌های مستعار نماد پشتیبانی نمی‌کنند، پیش‌فرض \fB\-fno\-extern\-tls\-init\fR است.
.IP \fB\-ffold\-simple\-inlines\fR 4
.IX Item "-ffold-simple-inlines"
.PD 0
.IP \fB\-fno\-fold\-simple\-inlines\fR 4
.IX Item "-fno-fold-simple-inlines"
.PD
به فرانت‌اند C++ اجازه می‌دهد فراخوانی‌های \f(CW\*(C`std::move\*(C'\fR، \f(CW\*(C`std::forward\*(C'\fR، \&\f(CW\*(C`std::addressof\*(C'\fR، \f(CW\*(C`std::to_underlying\*(C'\fR و \f(CW\*(C`std::as_const\*(C'\fR را ساده‌سازی (fold) کند. برخلاف درون‌خطی‌سازی (inlining)، این بدان معناست که هیچ اطلاعات اشکال‌زدایی برای چنین فراخوانی‌هایی تولید نخواهد شد. از آنجا که این توابع به‌ندرت برای اشکال‌زدایی اهمیت دارند، این پرچم به‌طور پیش‌فرض فعال است مگر اینکه \fB\-fno\-inline\fR فعال باشد.
.IP \fB\-fno\-gnu\-keywords\fR 4
.IX Item "-fno-gnu-keywords"
کلمه \f(CW\*(C`typeof\*(C'\fR را به‌عنوان کلمه کلیدی شناسایی نمی‌کند تا کد بتواند از این کلمه به‌عنوان یک شناسه استفاده کند. می‌توانید در عوض از کلمه کلیدی \f(CW\*(C`_\|_typeof_\|_\*(C'\fR استفاده کنید. این گزینه توسط گویش‌های دقیق ISO C++ مانند \fB\-ansi\fR، \&\fB\-std=c++98\fR، \fB\-std=c++11\fR و غیره به‌طور ضمنی فعال می‌شود.
.IP \fB\-fno\-immediate\-escalation\fR 4
.IX Item "-fno-immediate-escalation"
ارتقای تابع فوری (immediate function escalation) را که به موجب آن توابع خاصی می‌توانند مطابق با مشخصات P2564R3 به consteval ارتقا یابند، فعال نمی‌کند. برای مثال:
.Sp
.Vb 1
\&        consteval int id(int i) { return i; }
\&        
\&        constexpr int f(auto t)
\&        {
\&          return t + id(t); // id causes f<int> to be promoted to consteval
\&        }
\&        
\&        void g(int i)
\&        {
\&          f (3);
\&        }
.Ve
.Sp
در C++20 کامپایل می‌شود: تابع \f(CW\*(C`f\*(C'\fR یک تابع با ارتقای فوری است (به دلیل \f(CW\*(C`auto\*(C'\fR یک قالب تابع بوده و به‌صورت \f(CW\*(C`constexpr\*(C'\fR اعلان شده است) و \f(CWid(t)\fR یک عبارت با ارتقای فوری است، بنابراین \f(CW\*(C`f\*(C'\fR به \f(CW\*(C`consteval\*(C'\fR ارتقا می‌یابد. در نتیجه، فراخوانی \f(CWid(t)\fR در یک زمینه فوری (immediate context) قرار دارد، بنابراین مجبور نیست یک مقدار ثابت تولید کند (این سازوکاری است که امکان ترکیب توابع consteval را فراهم می‌آورد). با این حال، با \fB\-fno\-immediate\-escalation\fR، تابع \f(CW\*(C`f\*(C'\fR به \&\f(CW\*(C`consteval\*(C'\fR ارتقا نمی‌یابد، و از آنجا که فراخوانی تابع consteval یعنی \f(CWid(t)\fR یک عبارت ثابت نیست، کامپایلر کد را رد می‌کند.
.Sp
این گزینه به‌طور پیش‌فرض فعال است؛ تنها در حالت C++20 یا بالاتر مؤثر است..IP \fB\-fimplicit\-constexpr\fR 4
.IX Item "-fimplicit-constexpr"
توابع inline را در صورتی که نیازمندی‌های یک تابع constexpr را برآورده کنند، به‌طور ضمنی constexpr در نظر می‌گیرد. این گزینه می‌تواند در حالت C++14 یا بالاتر استفاده شود. این امر می‌تواند منجر به تغییر مقداردهی اولیه از پویا (dynamic) به ایستا (static) و سایر بهینه‌سازی‌ها گردد.
.IP \fB\-fno\-implicit\-templates\fR 4
.IX Item "-fno-implicit-templates"
هرگز کدی برای الگوهای (templates) غیر inline که به‌طور ضمنی (یعنی بر اثر استفاده) نمونه‌سازی شده‌اند تولید نمی‌کند؛ تنها کدهایی را برای نمونه‌سازی‌های صریح تولید می‌کند. اگر از این گزینه استفاده می‌کنید، باید مراقب باشید که کد خود را به‌گونه‌ای ساختاربندی کنید که شامل تمام نمونه‌سازی‌های صریح لازم باشد تا در زمان پیوند با خطای نمادهای تعریف‌نشده مواجه نشوید.
.IP \fB\-fno\-implicit\-inline\-templates\fR 4
.IX Item "-fno-implicit-inline-templates"
برای نمونه‌سازی‌های ضمنی الگوهای inline نیز هیچ کدی تولید نمی‌کند. رفتار پیش‌فرض این است که با توابع inline به‌گونه متفاوتی رفتار شود تا کامپایل‌ها با بهینه‌سازی و بدون آن، به مجموعه یکسانی از نمونه‌سازی‌های صریح نیاز داشته باشند.
.IP \fB\-fno\-implement\-inlines\fR 4
.IX Item "-fno-implement-inlines"
برای صرفه‌جویی در فضا، نسخه‌های برون‌خط (out\-of\-line) توابع inline کنترل‌شده توسط \f(CW\*(C`#pragma implementation\*(C'\fR را تولید نمی‌کند. اگر این توابع در تمام جاهایی که فراخوانی شده‌اند درون‌خط نشوند، این کار باعث خطاهای پیونددهنده خواهد شد.
.IP \fB\-fmodules\fR 4
.IX Item "-fmodules"
.PD 0
.IP \fB\-fno\-modules\fR 4
.IX Item "-fno-modules"
.PD
پشتیبانی از ماژول‌های C++20 را فعال می‌کند. گزینه
\&\fB\-fno\-modules\fR معمولاً مورد نیاز نیست، زیرا حالت پیش‌فرض است. با وجود اینکه این یک ویژگی C++20 است، در حال حاضر با انتخاب آن نسخه استاندارد به‌طور ضمنی فعال نمی‌شود.
.IP \fB\-fmodule\-header\fR 4
.IX Item "-fmodule-header"
.PD 0
.IP \fB\-fmodule\-header=user\fR 4
.IX Item "-fmodule-header=user"
.IP \fB\-fmodule\-header=system\fR 4
.IX Item "-fmodule-header=system"
.PD
یک فایل سرآیند را برای ایجاد یک واحد سرآیند قابل وارد کردن (importable header unit) کامپایل می‌کند.
.IP \fB\-fmodule\-implicit\-inline\fR 4
.IX Item "-fmodule-implicit-inline"
توابع عضوی که درون تعریف کلاس خود تعریف شده‌اند، برای کدهای ماژولار به‌طور ضمنی inline نیستند. این تفاوت با رفتار سنتی C++، به دلایل موجهی است. با این حال، ممکن است در طول انتقال کد (code porting) مشکلاتی ایجاد کند. این گزینه چنین تعاریف تابعی را به‌طور ضمنی inline می‌کند. البته این کار ناسازگاری ABI ایجاد می‌کند، بنابراین باید از آن در همه‌جا یا هیچ‌کجا استفاده کنید. (چنین تعاریفی در خارج از یک ماژول نام‌گذاری‌شده، در هر حال به‌طور ضمنی inline باقی می‌مانند.)
.IP \fB\-fno\-module\-lazy\fR 4
.IX Item "-fno-module-lazy"
وارد کردن تنبل ماژول (lazy module importing) و ایجاد نگاشت‌گر ماژول (module mapper) را غیرفعال می‌کند.
.IP \fB\-fmodule\-mapper=\fR[\fIhostname\fR]\fB:\fR\fIport\fR[\fB?\fR\fIident\fR] 4
.IX Item "-fmodule-mapper=[hostname]:port[?ident]"
.PD 0
.IP "\fB\-fmodule\-mapper=|\fR\fIprogram\fR[\fB?\fR\fIident\fR]\fB \fR\fIargs...\fR" 4
.IX Item "-fmodule-mapper=|program[?ident] args..."
.IP \fB\-fmodule\-mapper==\fR\fIsocket\fR[\fB?\fR\fIident\fR] 4
.IX Item "-fmodule-mapper==socket[?ident]"
.IP \fB\-fmodule\-mapper=<>\fR[\fIinout\fR][\fB?\fR\fIident\fR] 4
.IX Item "-fmodule-mapper=<>[inout][?ident]"
.IP \fB\-fmodule\-mapper=<\fR\fIin\fR\fB>\fR\fIout\fR[\fB?\fR\fIident\fR] 4
.IX Item "-fmodule-mapper=<in>out[?ident]"
.IP \fB\-fmodule\-mapper=\fR\fIfile\fR[\fB?\fR\fIident\fR] 4
.IX Item "-fmodule-mapper=file[?ident]"
.PD
یک مرجع استعلام برای نگاشت نام ماژول به نام فایل. در صورت عدم تعیین، متغیر محیطی \fBCXX_MODULE_MAPPER\fR استفاده می‌شود، و اگر آن هم تنظیم نشده باشد، یک پیش‌فرض درون‌پردازشی ارائه می‌گردد.
.IP \fB\-fmodule\-only\fR 4
.IX Item "-fmodule-only"
تنها رابط ماژول کامپایل‌شده (Compiled Module Interface) را تولید می‌کند و از ایجاد هرگونه فایل شیء جلوگیری می‌نماید.
.IP \fB\-fms\-extensions\fR 4
.IX Item "-fms-extensions"
هشدارهای Wpedantic را درباره سازه‌های مورد استفاده در MFC، مانند int ضمنی و دریافت اشاره‌گر به تابع عضو از طریق نحو غیر استاندارد، غیرفعال می‌کند.
.IP \fB\-fnew\-inheriting\-ctors\fR 4
.IX Item "-fnew-inheriting-ctors"
تعدیل P0136 در معناشناسی وراثت سازنده‌های C++11 را فعال می‌کند. این بخشی از C++17 است اما همچنین یک گزارش نقص (Defect Report) برای C++11 و C++14 در نظر گرفته می‌شود. این پرچم به‌طور پیش‌فرض فعال است مگر اینکه \fB\-fabi\-version=10\fR یا پایین‌تر مشخص شده باشد.
.IP \fB\-fnew\-ttp\-matching\fR 4
.IX Item "-fnew-ttp-matching"
مصوبه P0522 برای مسئله ۱۵۰ هسته زبان (Core issue 150)، یعنی پارامترهای قالب-قالب (template template parameters) و آرگومان‌های پیش‌فرض را فعال می‌کند: این گزینه اجازه می‌دهد یک قالب با آرگومان‌های پیش‌فرض، به عنوان آرگومان برای یک پارامتر قالب-قالب با پارامترهای کمتر استفاده شود. این پرچم به‌طور پیش‌فرض برای \&\fB\-std=c++17\fR فعال است.
.IP \fB\-fno\-nonansi\-builtins\fR 4
.IX Item "-fno-nonansi-builtins"
اعلان‌های توکار (built\-in) توابعی را که توسط ANSI/ISO C الزامی نشده‌اند، غیرفعال می‌کند. این توابع شامل \f(CW\*(C`ffs\*(C'\fR، \f(CW\*(C`alloca\*(C'\fR، \f(CW\*(C`_exit\*(C'\fR، \&\f(CW\*(C`index\*(C'\fR، \f(CW\*(C`bzero\*(C'\fR، \f(CW\*(C`conjf\*(C'\fR و سایر توابع مرتبط هستند.
.IP \fB\-fnothrow\-opt\fR 4
.IX Item "-fnothrow-opt"
با مشخصه استثنای \f(CWthrow()\fR طوری رفتار می‌کند که گویی یک مشخصه \&\f(CW\*(C`noexcept\*(C'\fR است تا سربار اندازه کد اجرایی (text size) را در مقایسه با تابعی بدون مشخصه استثنا کاهش دهد یا حذف کند. اگر تابع دارای متغیرهای محلی از نوع‌هایی با مخرب‌های (destructors) غیربدیهی باشد، مشخصه استثنا در عمل تابع را کوچک‌تر می‌کند زیرا پاک‌سازی‌های مدیریت استثنا (EH) برای آن متغیرها می‌توانند با بهینه‌سازی حذف شوند. اثر معنایی این است که پرتاب استثنا از تابعی با چنین مشخصه استثنایی، به‌جای فراخوانی \f(CW\*(C`unexpected\*(C'\fR، منجر به فراخوانی \f(CW\*(C`terminate\*(C'\fR می‌شود.
.IP \fB\-fno\-operator\-names\fR 4
.IX Item "-fno-operator-names"
با کلمات کلیدی نام عملگرها مانند \f(CW\*(C`and\*(C'\fR، \f(CW\*(C`bitand\*(C'\fR، \&\f(CW\*(C`bitor\*(C'\fR، \f(CW\*(C`compl\*(C'\fR، \f(CW\*(C`not\*(C'\fR، \f(CW\*(C`or\*(C'\fR و \f(CW\*(C`xor\*(C'\fR به عنوان کلمات کلیدی مترادف رفتار نمی‌کند.
.IP \fB\-fno\-optional\-diags\fR 4
.IX Item "-fno-optional-diags"
پیام‌های تشخیصی که استاندارد می‌گوید نیازی به صدور آن‌ها توسط کامپایلر نیست را غیرفعال می‌کند. در حال حاضر، تنها پیام تشخیصی از این نوع که توسط G++ صادر می‌شود، مربوط به نامی است که در یک کلاس دارای چندین معنا باشد.
.IP \fB\-fno\-pretty\-templates\fR 4
.IX Item "-fno-pretty-templates"
هنگامی که یک پیام خطا به تخصیص (specialization) یک الگوی تابع اشاره دارد، کامپایلر معمولاً امضای الگو و به دنبال آن آرگومان‌های الگو و هرگونه typedef یا typename موجود در امضا را چاپ می‌کند (برای مثال \f(CW\*(C`void f(T) [with T = int]\*(C'\fR به‌جای \f(CW\*(C`void f(int)\*(C'\fR) تا مشخص باشد کدام الگو درگیر است. هنگامی که یک پیام خطا به تخصیص یک الگوی کلاس اشاره دارد، کامپایلر آرگومان‌های الگویی را که با آرگومان‌های پیش‌فرض آن الگو مطابقت دارند حذف می‌کند. اگر هر یک از این رفتارها به‌جای آسان‌تر کردن فهم پیام خطا، درک آن را دشوارتر می‌کنند، می‌توانید از \fB\-fno\-pretty\-templates\fR برای غیرفعال کردن آن‌ها استفاده کنید.
.IP \fB\-frange\-for\-ext\-temps\fR 4
.IX Item "-frange-for-ext-temps"
تمدید طول عمر اشیاء موقت را در حلقه‌های range-based for زبان C++ فعال می‌کند. در \fB\-std=c++23\fR و بالاتر، این مورد بخشی از استاندارد زبان است، بنابراین طول عمر اشیاء موقت به‌طور پیش‌فرض تا پایان حلقه تمدید می‌شود. این گزینه امکان فعال‌سازی این رفتار را در نسخه‌های پیشین استاندارد نیز فراهم می‌کند.
.IP \fB\-freflection\fR 4
.IX Item "-freflection"
ویژگی آزمایشی بازتاب (Reflection) در C++26 را فعال می‌کند.
.IP \fB\-fno\-rtti\fR 4
.IX Item "-fno-rtti"
تولید اطلاعات مربوط به هر کلاس دارای توابع مجازی را برای استفاده توسط ویژگی‌های شناسایی نوع در زمان اجرا (RTTI) در C++ (\f(CW\*(C`dynamic_cast\*(C'\fR و \f(CW\*(C`typeid\*(C'\fR) غیرفعال می‌کند. اگر از این بخش‌های زبان استفاده نمی‌کنید، می‌توانید با استفاده از این پرچم در فضا صرفه‌جویی کنید. توجه داشته باشید که مدیریت استثناها از همین اطلاعات استفاده می‌کند، اما G++ آن را در صورت نیاز تولید می‌نماید. عملگر \f(CW\*(C`dynamic_cast\*(C'\fR همچنان می‌تواند برای تبدیل‌هایی که نیازی به اطلاعات نوع در زمان اجرا ندارند، یعنی تبدیل به \f(CW\*(C`void *\*(C'\fR یا به کلاس‌های پایه بدون ابهام، استفاده شود.
.Sp
ترکیب کدهای کامپایل‌شده با \fB\-frtti\fR با کدهای کامپایل‌شده با \&\fB\-fno\-rtti\fR ممکن است کار نکند. برای مثال، اگر کلاسی که با \fB\-fno\-rtti\fR کامپایل شده به عنوان پایه برای کلاسی که با \fB\-frtti\fR کامپایل شده استفاده شود، ممکن است پیوند برنامه‌ها با شکست مواجه گردد.
.IP \fB\-fsized\-deallocation\fR 4
.IX Item "-fsized-deallocation"
اعلان‌های عمومی توکار را
.Sp
.Vb 2
\&        void operator delete (void *, std::size_t) noexcept;
\&        void operator delete[] (void *, std::size_t) noexcept;
.Ve
.Sp
همان‌طور که در C++14 معرفی شدند، فعال می‌کند. این قابلیت برای توابع آزادسازی حافظه (deallocation) جایگزین تعریف‌شده توسط کاربر که مثلاً از اندازه شیء برای تسریع آزادسازی استفاده می‌کنند، مفید است. این گزینه به‌طور پیش‌فرض تحت \&\fB\-std=c++14\fR و بالاتر فعال است. پرچم \fB\-Wsized\-deallocation\fR درباره مکان‌هایی که ممکن است نیاز به افزودن یک تعریف داشته باشند، هشدار می‌دهد.
.IP \fB\-fstrict\-enums\fR 4
.IX Item "-fstrict-enums"
به کامپایلر اجازه می‌دهد تا با این فرض بهینه‌سازی کند که مقدار یک نوع شمارشی (enumerated type) فقط می‌تواند یکی از مقادیر شمارش باشد (همان‌طور که در استاندارد C++ تعریف شده است؛ اساساً مقداری که می‌تواند در حداقل تعداد بیت‌های مورد نیاز برای نمایش تمام شناسه‌های شمارش نمایش یابد). این فرض در صورتی که برنامه از یک تبدیل صریح (cast) برای تبدیل یک مقدار صحیح دلخواه به نوع شمارشی استفاده کند، ممکن است معتبر نباشد. این گزینه برای نوع‌های شمارشی با نوع زیربنایی مشخص هیچ تأثیری ندارد.
.IP \fB\-fstrong\-eval\-order\fR 4
.IX Item "-fstrong-eval-order".PD 0
.IP \fB\-fstrong\-eval\-order=\fR\fIkind\fR 4
.IX Item "-fstrong-eval-order=kind"
.PD
ارزیابی دسترسی به اعضا، اندیس‌گذاری آرایه و عبارات شیفت به ترتیب از چپ به راست، و ارزیابی انتساب به ترتیب از راست به چپ، همان‌گونه که برای C++17 تصویب شده است. \fB\-fstrong\-eval\-order\fR معادل \&\fB\-fstrong\-eval\-order=all\fR است و به طور پیش‌فرض با \fB\-std=c++17\fR یا بالاتر فعال می‌شود.
.Sp
\&\fB\-fstrong\-eval\-order=some\fR تنها ترتیب ارزیابی دسترسی به اعضا و عبارات شیفت را فعال می‌کند و برای گویش‌های C++ پیش از C++17 پیش‌فرض است.
.Sp
\&\fB\-fstrong\-eval\-order=none\fR معادل \&\fB\-fno\-strong\-eval\-order\fR است.
.IP \fB\-ftemplate\-backtrace\-limit=\fR\fIn\fR 4
.IX Item "-ftemplate-backtrace-limit=n"
حداکثر تعداد یادداشت‌های نمونه‌سازی قالب (template instantiation notes) را برای یک هشدار یا خطای واحد روی \fIn\fR تنظیم می‌کند. مقدار پیش‌فرض ۱۰ است.
.IP \fB\-ftemplate\-depth=\fR\fIn\fR 4
.IX Item "-ftemplate-depth=n"
حداکثر عمق نمونه‌سازی را برای کلاس‌های قالب روی \fIn\fR تنظیم می‌کند. وجود محدودیت در عمق نمونه‌سازی قالب جهت تشخیص بازگشت‌های بی‌پایان در حین نمونه‌سازی کلاس‌های قالب ضروری است. برنامه‌های منطبق بر ANSI/ISO C++ نباید به حداکثر عمق بیشتر از ۱۷ (در C++11 به ۱۰۲۴ تغییر یافت) متکی باشند. مقدار پیش‌فرض ۹۰۰ است، زیرا در برخی شرایط ممکن است حافظهٔ پشتهٔ کامپایلر پیش از رسیدن به ۱۰۲۴ به پایان برسد.
.IP \fB\-fno\-threadsafe\-statics\fR 4
.IX Item "-fno-threadsafe-statics"
کد اضافی را برای استفاده از روتین‌های مشخص‌شده در C++ ABI جهت مقداردهی اولیهٔ امن در برابر ریسه‌ها (thread-safe) برای متغیرهای ایستای محلی تولید نکن. می‌توانید از این گزینه برای کاهش اندک حجم کد در برنامه‌هایی که نیازی به امنیت ریسه ندارند، استفاده کنید.
.IP \fB\-fuse\-cxa\-atexit\fR 4
.IX Item "-fuse-cxa-atexit"
مخرب‌ها را برای اشیائی با طول عمر ذخیره‌سازی ایستا (static storage duration)، به جای تابع \f(CW\*(C`atexit\*(C'\fR با تابع \&\f(CW\*(C`_\|_cxa_atexit\*(C'\fR ثبت کن. این گزینه برای مدیریت کاملاً منطبق بر استاندارد مخرب‌های ایستا الزامی است، اما تنها در صورتی کار می‌کند که کتابخانهٔ C شما از \&\f(CW\*(C`_\|_cxa_atexit\*(C'\fR پشتیبانی کند.
.IP \fB\-fno\-use\-cxa\-get\-exception\-ptr\fR 4
.IX Item "-fno-use-cxa-get-exception-ptr"
از روتین زمان اجرای \f(CW\*(C`_\|_cxa_get_exception_ptr\*(C'\fR استفاده نکن. این کار باعث نادرست عمل کردن \f(CW\*(C`std::uncaught_exception\*(C'\fR می‌شود، اما در صورتی که این روتین زمان اجرا در دسترس نباشد، ضروری است.
.IP \fB\-fvisibility\-inlines\-hidden\fR 4
.IX Item "-fvisibility-inlines-hidden"
این سوییچ مشخص می‌کند که کاربر تلاشی برای مقایسهٔ اشاره‌گرها به توابع درون‌خطی (inline) یا متدها در شرایطی که نشانی‌های دو تابع در اشیاء مشترک (shared objects) متفاوتی گرفته شده‌اند، انجام نمی‌دهد.
.Sp
اثر این گزینه این است که GCC می‌تواند در عمل متدهای درون‌خطی را با \&\f(CW\*(C`_\|_attribute_\|_ ((visibility ("hidden")))\*(C'\fR علامت‌گذاری کند تا در جدول صدور یک DSO ظاهر نشوند و هنگام استفاده در داخل DSO نیازی به ارجاع غیرمستقیم PLT نداشته باشند. فعال کردن این گزینه می‌تواند تأثیر چشمگیری بر زمان بارگذاری و پیوند یک DSO بگذارد، زیرا حجم جدول صدور پویا را در حالتی که کتابخانه استفادهٔ گسترده‌ای از قالب‌ها دارد به شدت کاهش می‌دهد.
.Sp
رفتار این سوییچ دقیقاً مشابه علامت‌گذاری مستقیم متدها به عنوان hidden نیست، زیرا بر متغیرهای ایستای محلی تابع تأثیری نمی‌گذارد و باعث نمی‌شود که کامپایلر استنباط کند تابع تنها در یک شیء مشترک تعریف شده است.
.Sp
می‌توانید یک متد را به صورت صریح با یک وضعیت دیداری مشخص علامت‌گذاری کنید تا اثر این سوییچ برای آن متد خنثی شود. به عنوان مثال، اگر قصد مقایسهٔ اشاره‌گرها به یک متد درون‌خطی خاص را دارید، می‌توانید آن را با دیداری پیش‌فرض (default) علامت‌گذاری کنید. مشخص کردن دیداری صریح برای کلاس دربرگیرنده هیچ اثری ندارد.
.Sp
متدهای درون‌خطی با نمونه‌سازی صریح (explicitly instantiated) تحت تأثیر این گزینه قرار نمی‌گیرند، چرا که پیونددهی آن‌ها در غیر این صورت ممکن است از مرز کتابخانهٔ مشترک عبور کند.
.IP \fB\-fvisibility\-ms\-compat\fR 4
.IX Item "-fvisibility-ms-compat"
این پرچم تلاش می‌کند با استفاده از تنظیمات دیداری (visibility)، مدل پیونددهی C++ در GCC را با Microsoft Visual Studio سازگار سازد.
.Sp
این پرچم تغییرات زیر را در مدل پیونددهی GCC اعمال می‌کند:
.RS 4
.IP 1. 4
.IX Item "1."
دیداری پیش‌فرض را مانند \&\fB\-fvisibility=hidden\fR روی \f(CW\*(C`hidden\*(C'\fR تنظیم می‌کند.
.IP 2. 4
.IX Item "2."
نوع‌ها (types)، به استثنای اعضای آن‌ها، به طور پیش‌فرض پنهان نمی‌شوند.
.IP 3. 4
.IX Item "3."
قاعدهٔ تعریف واحد (One Definition Rule یا ODR) برای نوع‌های فاقد مشخصات دیداری صریح که در بیش از یک شیء مشترک تعریف شده‌اند تسهیل می‌شود: این اعلان‌ها در صورتی مجاز هستند که در زمان عدم استفاده از این گزینه نیز مجاز باشند.
.RE
.RS 4
.Sp
در کدهای جدید بهتر است از \fB\-fvisibility=hidden\fR استفاده شود و کلاس‌هایی که قرار است از خارج قابل مشاهده باشند، صادر (export) شوند. متأسفانه این احتمال وجود دارد که کدها، شاید به طور تصادفی، به رفتار Visual Studio وابسته باشند.
.Sp
از جمله پیامدهای این تغییرات این است که اعضای داده‌ای ایستای یک نوع یکسان با نام یکسان اما تعریف‌شده در اشیاء مشترک متفاوت، از یکدیگر متمایز خواهند بود؛ بنابراین تغییر یکی باعث تغییر دیگری نمی‌شود؛ همچنین ممکن است مقایسهٔ برابری برای اشاره‌گرها به توابع عضوِ تعریف‌شده در اشیاء مشترک متفاوت، برابر ارزیابی نشود. هنگامی که این پرچم داده می‌شود، تعریف متفاوت نوع‌های هم‌نام نقض ODR محسوب می‌شود.
.RE
.IP \fB\-fno\-weak\fR 4
.IX Item "-fno-weak"
حتی در صورت پشتیبانی توسط پیونددهنده (linker)، از نمادهای ضعیف (weak symbols) استفاده نکن. به طور پیش‌فرض، G++ در صورت در دسترس بودن از نمادهای ضعیف استفاده می‌کند. این گزینه صرفاً برای آزمایش وجود دارد و نباید توسط کاربران نهایی استفاده شود؛ این کار منجر به تولید کدی ضعیف‌تر شده و هیچ مزیتی ندارد. این گزینه ممکن است در نسخه‌های بعدی G++ حذف شود.
.IP "\fB\-fext\-numeric\-literals\fR (C++ and Objective\-C++ only)" 4
.IX Item "-fext-numeric-literals (C++ and Objective-C++ only)"
پسوندهای لفظی عددی موهومی، ممیز ثابت یا تعریف‌شده توسط ماشین را به عنوان افزونه‌های GNU می‌پذیرد.
هنگامی که این گزینه غیرفعال باشد، با این پسوندها به عنوان پسوندهای لفظی عددی تعریف‌شده توسط کاربر در C++11 برخورد می‌شود.
این گزینه به طور پیش‌فرض برای تمام گویش‌های پیش از C++11 و تمام گویش‌های GNU فعال است:
\&\fB\-std=c++98\fR، \fB\-std=gnu++98\fR، \fB\-std=gnu++11\fR،
\&\fB\-std=gnu++14\fR.
این گزینه به طور پیش‌فرض برای ISO C++11 به بعد (\fB\-std=c++11\fR، ...) غیرفعال است.
.IP \fB\-nostdinc++\fR 4
.IX Item "-nostdinc++"
در دایرکتوری‌های استاندارد ویژهٔ C++ به دنبال فایل‌های سرآیند نگرد، اما سایر دایرکتوری‌های استاندارد را همچنان جستجو کن. (این گزینه هنگام ساخت کتابخانهٔ C++ استفاده می‌شود.)
.IP \fB\-flang\-info\-include\-translate\fR 4
.IX Item "-flang-info-include-translate"
.PD 0
.IP \fB\-flang\-info\-include\-translate\-not\fR 4
.IX Item "-flang-info-include-translate-not"
.IP \fB\-flang\-info\-include\-translate=\fR\fIheader\fR 4
.IX Item "-flang-info-include-translate=header"
.PD
دربارهٔ رویدادهای ترجمهٔ include اطلاع‌رسانی کن. شکل اول ترجمه‌های include پذیرفته‌شده را گزارش می‌دهد، شکل دوم ترجمه‌های include ردشده را ثبت می‌کند. شکل \fIheader\fR در مورد ترجمه‌های include مربوط به آن سرآیند خاص اطلاع‌رسانی می‌کند. اگر \fIheader\fR به صورت \f(CW"user"\fR یا \f(CW\*(C`<system>\*(C'\fR باشد، با استفاده از مسیر include به یک سرآیند کاربری یا سیستمی خاص تبدیل و آدرس‌دهی می‌شود.
.IP \fB\-flang\-info\-module\-cmi\fR 4
.IX Item "-flang-info-module-cmi"
.PD 0
.IP \fB\-flang\-info\-module\-cmi=\fR\fImodule\fR 4
.IX Item "-flang-info-module-cmi=module"
.PD
دربارهٔ نام مسیرهای رابط ماژول کامپایل‌شده (Compiled Module Interface یا CMI) اطلاع‌رسانی کن. شکل اول تمام نام مسیرهای CMI خوانده‌شده را ثبت می‌کند. شکل \fImodule\fR خواندن CMI یک ماژول خاص را گزارش می‌دهد. \fImodule\fR ممکن است یک ماژول نام‌گذاری‌شده یا یک واحد سرآیند (header-unit) باشد (مورد دوم یا با نام مسیری شامل جداکننده‌های دایرکتوری، یا با قرار گرفتن در \f(CW\*(C`<>\*(C'\fR یا \f(CW""\fR مشخص می‌شود).
.IP \fB\-stdlib=\fR\fIlibstdc++,libc++\fR 4
.IX Item "-stdlib=libstdc++,libc++"
هنگامی که G++ برای پشتیبانی از این گزینه پیکربندی شده باشد، امکان تعیین کتابخانه‌های زمان اجرای جایگزین C++ را فراهم می‌سازد. دو گزینه در دسترس است: \fIlibstdc++\fR (زمان اجرای بومی و پیش‌فرض C++ برای G++) و \fIlibc++\fR که کتابخانهٔ زمان اجرای C++ نصب‌شده روی برخی سیستم‌عامل‌ها است (مانند نسخه‌های Darwin از Darwin11 به بعد). این گزینه G++ را تغییر می‌دهد تا از سرآیندهای کتابخانهٔ مشخص‌شده استفاده کند و هنگام نیاز به زمان اجرای C++ برای مرحلهٔ پیوند، به ترتیب \f(CW\*(C`\-lstdc++\*(C'\fR یا \f(CW\*(C`\-lc++\*(C'\fR را صادر نماید.
.PP
علاوه بر این، این گزینه‌های هشدار تنها برای برنامه‌های C++ کاربرد دارند:
.IP "\fB\-Wabi\-tag\fR (C++ and Objective\-C++ only)" 4
.IX Item "-Wabi-tag (C++ and Objective-C++ only)"
هنگامی که یک نوع دارای برچسب ABI (ABI tag) در زمینه‌ای استفاده می‌شود که فاقد آن برچسب ABI است، هشدار بده. برای اطلاعات بیشتر دربارهٔ برچسب‌های ABI به \fBC++ Attributes\fR مراجعه کنید.
.IP \fB\-Wno\-abbreviated\-auto\-in\-template\-arg\fR 4
.IX Item "-Wno-abbreviated-auto-in-template-arg"
خطای مربوط به نوع جای‌نگهدار \f(CW\*(C`auto\*(C'\fR که درون یک فهرست آرگومان قالب برای اعلان یک الگوی تابع مختصرشدهٔ (abbreviated function template) C++20 استفاده شده است را غیرفعال کن، مانند:
.Sp
.Vb 1
\&        void f(S<auto>);
.Ve
.Sp
این ویژگی در Concepts TS پیشنهاد شده بود، اما در C++20 تصویب نشد؛ در استاندارد، یک جای‌نگهدار در اعلان پارامتر باید به عنوان یک decl\-specifier ظاهر شود. این خطا را می‌توان با استفاده از \fB\-fpermissive\fR یا \&\fB\-Wno\-error=abbreviated\-auto\-in\-template\-arg\fR به یک هشدار نیز تقلیل داد..IP "\fB\-Wcomma\-subscript\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wcomma-subscript (C++ and Objective-C++ only)"
دربارهٔ استفاده از عبارت کاما در داخل یک عبارت اندیس‌گذاری هشدار می‌دهد.
این کاربرد در C++20 منسوخ شده و در C++23 حذف خواهد شد.
با این حال، عبارت کامایی که در \f(CW\*(C`( )\*(C'\fR قرار گرفته باشد منسوخ نیست. مثال:
.Sp
.Vb 4
\&        void f(int *a, int b, int c) {
\&            a[b,c];     // deprecated in C++20, invalid in C++23
\&            a[(b,c)];   // OK
\&        }
.Ve
.Sp
در C++23 قرار دادن عبارت‌های جداشده با کاما درون اندیس در صورتی معتبر است که یک عملگر اندیس سربارگذاری‌شده یافت شود و از تعداد و انواع درست آرگومان‌ها پشتیبانی کند. کامپایلر G++ نحو قبلاً معتبری را برای کدهایی که در C++23 معتبر نیستند اما در C++20 معتبر ولی منسوخ بودند، با یک هشدار دقیق (pedantic) می‌پذیرد؛ این هشدار را می‌توان با \&\fB\-Wno\-comma\-subscript\fR غیرفعال کرد.
.Sp
به‌طور پیش‌فرض با \fB\-std=c++20\fR فعال است مگر آنکه \&\fB\-Wno\-deprecated\fR داده شود، و پس از \fB\-std=c++23\fR بدون در نظر گرفتن \&\fB\-Wno\-deprecated\fR فعال است. پیش از \fB\-std=c++20\fR، با \&\fB\-Wdeprecated\fR صریح فعال می‌شود.
.Sp
این هشدار با \fB\-pedantic\-errors\fR در حالت C++23 یا بالاتر به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wctad\-maybe\-unsupported\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wctad-maybe-unsupported (C++ and Objective-C++ only)"
هنگام انجام استنتاج آرگومان الگوی کلاس (CTAD) روی نوعی که هیچ راهنمای استنتاجِ صریحاً نوشته‌شده‌ای ندارد هشدار می‌دهد. این هشدار مواردی را مشخص می‌کند که CTAD تنها به این دلیل موفق شده است که کامپایلر راهنماهای استنتاج ضمنی را تولید کرده است، که ممکن است مقصود برنامه‌نویس نبوده باشد. برخی راهنماهای سبک کدنویسی CTAD را فقط برای انواعی مجاز می‌دانند که مشخصاً «opt\-in» کرده باشند؛ یعنی انواعی که برای پشتیبانی از CTAD طراحی شده‌اند. این هشدار را می‌توان با الگوی زیر فرونشاند:
.Sp
.Vb 6
\&        struct allow_ctad_t; // any name works
\&        template <typename T> struct S {
\&          S(T) { }
\&        };
\&        // Guide with incomplete parameter type will never be considered.
\&        S(allow_ctad_t) \-> S<void>;
.Ve
.IP "\fB\-Wctor\-dtor\-privacy\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wctor-dtor-privacy (C++ and Objective-C++ only)"
هنگامی که یک کلاس غیرقابل‌استفاده به نظر می‌رسد چون تمام سازنده‌ها یا مخرب‌های آن کلاس خصوصی هستند و کلاس فاقد توابع دوست (friend) یا توابع عضو استاتیک عمومی است، هشدار می‌دهد. همچنین اگر هیچ متد غیرخصوصی وجود نداشته باشد و حداقل یک تابع عضو خصوصی وجود داشته باشد که سازنده یا مخرب نباشد نیز هشدار می‌دهد.
.IP "\fB\-Wdangling\-reference\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdangling-reference (C++ and Objective-C++ only)"
هنگامی که یک ارجاع به یک شیء موقت که طول عمر آن به پایان رسیده متصل شود، هشدار می‌دهد.
برای مثال:
.Sp
.Vb 2
\&        int n = 1;
\&        const int& r = std::max(n \- 1, n + 1); // r is dangling
.Ve
.Sp
در مثال بالا، دو شیء موقت ایجاد می‌شود (یکی برای هر آرگومان) و ارجاعی به یکی از این اشیاء موقت بازگردانده می‌شود. با این حال، هر دو شیء موقت در پایان عبارت کامل تخریب می‌شوند، بنابراین ارجاع \f(CW\*(C`r\*(C'\fR معلق است. این هشدار همچنین ارجاع‌های معلق را در فهرست‌های مقداردهی اولیهٔ اعضا تشخیص می‌دهد:
.Sp
.Vb 5
\&        const int& f(const int& i) { return i; }
\&        struct S {
\&          const int &r; // r is dangling
\&          S() : r(f(10)) { }
\&        };
.Ve
.Sp
توابع عضو نیز بررسی می‌شوند، اما فقط آرگومان شیء آن‌ها:
.Sp
.Vb 4
\&        struct S {
\&           const S& self () { return *this; }
\&        };
\&        const S& s = S().self(); // s is dangling
.Ve
.Sp
برخی توابع از این جهت ایمن هستند، برای مثال \f(CW\*(C`std::use_facet\*(C'\fR:
آن‌ها یک ارجاع را دریافت کرده و بازمی‌گردانند، اما یکی از آرگومان‌های آن را برنمی‌گردانند، که می‌تواند این هشدار را گمراه کند. چنین توابعی را می‌توان با قرار دادنشان در یک \f(CW\*(C`#pragma\*(C'\fR از این هشدار مستثنی کرد:
.Sp
.Vb 4
\&        #pragma GCC diagnostic push
\&        #pragma GCC diagnostic ignored "\-Wdangling\-reference"
\&        const T& foo (const T&) { ... }
\&        #pragma GCC diagnostic pop
.Ve
.Sp
دستور \f(CW\*(C`#pragma\*(C'\fR همچنین می‌تواند کلاس را در بر بگیرد؛ در این حالت، هشدار برای تمام توابع عضو غیرفعال خواهد شد.
.Sp
همچنین \&\fB\-Wdangling\-reference\fR دربارهٔ کدهایی مانند زیر هشدار می‌دهد:
.Sp
.Vb 1
\&        auto p = std::minmax(1, 2);
.Ve
.Sp
که در آن \f(CW\*(C`std::minmax\*(C'\fR مقدار \f(CW\*(C`std::pair<const int&, const int&>\*(C'\fR را بازمی‌گرداند، و هر دو ارجاع پس از پایان عبارت کاملی که شامل فراخوانی \f(CW\*(C`std::minmax\*(C'\fR است، معلق می‌شوند.
.Sp
این هشدار برای کلاس‌های شبیه به \f(CW\*(C`std::span\*(C'\fR هشداری صادر نمی‌کند. ما کلاس‌هایی به شکل:
.Sp
.Vb 5
\&        template<typename T>
\&        struct Span {
\&          T* data_;
\&          std::size len_;
\&        };
.Ve
.Sp
را به عنوان کلاس‌های شبیه به \f(CW\*(C`std::span\*(C'\fR در نظر می‌گیریم؛ یعنی کلاسی غیر از union که دارای یک عضو داده‌ای اشاره‌گر و یک مخرب بدیهی باشد.
.Sp
این هشدار را می‌توان با استفاده از ویژگی \f(CW\*(C`gnu::no_dangling\*(C'\fR غیرفعال کرد.
.Sp
این هشدار با \fB\-Wextra\fR فعال می‌شود.
.IP "\fB\-Wdelete\-non\-virtual\-dtor\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdelete-non-virtual-dtor (C++ and Objective-C++ only)"
هنگامی که از \f(CW\*(C`delete\*(C'\fR برای تخریب نمونه‌ای از یک کلاس استفاده می‌شود که دارای توابع مجازی و مخرب غیرمجازی است، هشدار می‌دهد. در صورتی که کلاس پایه فاقد مخرب مجازی باشد، حذف نمونه‌ای از کلاس مشتق‌شده از طریق اشاره‌گری به کلاس پایه ناامن است. این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wdeprecated\-copy\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdeprecated-copy (C++ and Objective-C++ only)"
هشدار می‌دهد که در C++11 به بالا، در صورتی که کلاس دارای یک سازنده رونوشت یا عملگر انتساب رونوشت ارائه‌شده توسط کاربر باشد، اعلان ضمنی یک سازنده رونوشت یا عملگر انتساب رونوشت منسوخ است. این هشدار با \fB\-Wextra\fR فعال می‌شود.
.IP "\fB\-Wdeprecated\-copy\-dtor\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdeprecated-copy-dtor (C++ and Objective-C++ only)"
مشابه \fB\-Wdeprecated\-copy\fR است، اما در صورتی که کلاس دارای یک مخرب ارائه‌شده توسط کاربر نیز باشد، آن را منسوخ در نظر می‌گیرد.
.IP "\fB\-Wno\-deprecated\-enum\-enum\-conversion\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-deprecated-enum-enum-conversion (C++ and Objective-C++ only)"
غیرفعال کردن هشدار دربارهٔ حالتی که در آن تبدیل‌های حسابی معمول روی عملوندهایی اعمال می‌شوند که یکی از نوع شمارشی و دیگری از یک نوع شمارشی متفاوت است. این تبدیل در C++20 منسوخ شد. برای مثال:
.Sp
.Vb 3
\&        enum E1 { e };
\&        enum E2 { f };
\&        int k = f \- e;
.Ve
.Sp
گزینهٔ \&\fB\-Wdeprecated\-enum\-enum\-conversion\fR به‌طور پیش‌فرض با \&\fB\-std=c++20\fR فعال است. در گویش‌های پیش از C++20، این هشدار می‌تواند با \fB\-Wenum\-conversion\fR یا \fB\-Wdeprecated\fR فعال شود.
.IP "\fB\-Wno\-deprecated\-enum\-float\-conversion\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-deprecated-enum-float-conversion (C++ and Objective-C++ only)"
غیرفعال کردن هشدار دربارهٔ حالتی که در آن تبدیل‌های حسابی معمول روی عملوندهایی اعمال می‌شوند که یکی از نوع شمارشی و دیگری از نوع ممیز شناور است. این تبدیل در C++20 منسوخ شد. برای مثال:
.Sp
.Vb 3
\&        enum E1 { e };
\&        enum E2 { f };
\&        bool b = e <= 3.7;
.Ve
.Sp
گزینهٔ \&\fB\-Wdeprecated\-enum\-float\-conversion\fR به‌طور پیش‌فرض با \&\fB\-std=c++20\fR فعال است. در گویش‌های پیش از C++20، این هشدار می‌تواند با \fB\-Wenum\-conversion\fR یا \fB\-Wdeprecated\fR فعال شود.
.IP "\fB\-Wdeprecated\-literal\-operator\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdeprecated-literal-operator (C++ and Objective-C++ only)"
هشدار می‌دهد که اعلان یک عملگر لفظیِ تعریف‌شده توسط کاربر با یک فاصله پیش از پسوند منسوخ است. این هشدار به‌طور پیش‌فرض در C++23، یا با \fB\-Wdeprecated\fR صریح فعال می‌شود.
.Sp.Vb 2
\&        string operator "" _i18n(const char*, std::size_t); // deprecated
\&        string operator ""_i18n(const char*, std::size_t); // preferred
.Ve
.IP "\fB\-Wdeprecated\-variadic\-comma\-omission\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wdeprecated-variadic-comma-omission (C++ and Objective-C++ only)"
هشدار می‌دهد که حذف کاما (ویرگول) قبل از آرگومان‌های متغیر \f(CW\*(C`...\*(C'\fR در انتهای
فهرست پارامترهای تابع منسوخ شده است. این هشدار به‌طور پیش‌فرض در C++26
یا با مشخص کردن صریح \fB\-Wdeprecated\fR فعال می‌شود.
.Sp
.Vb 6
\&        void f1(int...); // deprecated
\&        void f1(int, ...); // preferred
\&        template <typename ...T>
\&        void f2(T...); // ok
\&        template <typename ...T>
\&        void f3(T......); // deprecated
.Ve
.IP \fB\-Wno\-elaborated\-enum\-base\fR 4
.IX Item "-Wno-elaborated-enum-base"
برای C++11 و بالاتر، در صورتی که یک enum\-base اضافی (نامعتبر) در یک
elaborated\-type\-specifier استفاده شود، هشدار می‌دهد. به این معنا که اگر یک enum با نوع
پایه‌ای مشخص و بدون فهرست شمارنده‌ها در اعلانی به غیر از یک اعلان مستقل از آن enum به کار
رود. به‌طور پیش‌فرض فعال است. این هشدار با \-pedantic\-errors به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wno\-init\-list\-lifetime\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-init-list-lifetime (C++ and Objective-C++ only)"
در مورد استفاده‌هایی از \f(CW\*(C`std::initializer_list\*(C'\fR که احتمالاً منجر به
ایجاد اشاره‌گرهای معلق (dangling pointers) می‌شوند، هشدار نمی‌دهد. از آنجا که آرایه زیرین یک
\&\f(CW\*(C`initializer_list\*(C'\fR مانند یک شیء موقت معمولی C++ مدیریت می‌شود، نگه‌داشتن ناخواسته
یک اشاره‌گر به آرایه پس از پایان طول عمر آن بسیار محتمل است. به عنوان مثال:
.RS 4
.IP * 4
اگر یک تابع یک \f(CW\*(C`initializer_list\*(C'\fR موقت یا یک متغیر محلی
\&\f(CW\*(C`initializer_list\*(C'\fR را بازگرداند، طول عمر آرایه در انتهای دستور return پایان می‌یابد،
بنابراین مقدار بازگردانده‌شده دارای یک اشاره‌گر معلق است.
.IP * 4
اگر یک عبارت new یک \f(CW\*(C`initializer_list\*(C'\fR ایجاد کند، آرایه تنها تا پایان
full\-expression دربرگیرنده زنده می‌ماند، بنابراین \f(CW\*(C`initializer_list\*(C'\fR موجود در heap
دارای یک اشاره‌گر معلق خواهد بود.
.IP * 4
هنگامی که به یک متغیر \f(CW\*(C`initializer_list\*(C'\fR از یک فهرست مقداردهی درون آکوالاد مقدار
اختصاص داده می‌شود، آرایه موقت ایجادشده برای سمت راست انتساب فقط تا پایان
full\-expression زنده می‌ماند، بنابراین در دستور بعدی متغیر \f(CW\*(C`initializer_list\*(C'\fR دارای
یک اشاره‌گر معلق خواهد بود.
.Sp
.Vb 6
\&        // li\*(Aqs initial underlying array lives as long as li
\&        std::initializer_list<int> li = { 1,2,3 };
\&        // assignment changes li to point to a temporary array
\&        li = { 4, 5 };
\&        // now the temporary is gone and li has a dangling pointer
\&        int i = li.begin()[0] // undefined behavior
.Ve
.IP * 4
هنگامی که یک سازنده فهرست (list constructor) اشاره‌گر \f(CW\*(C`begin\*(C'\fR را از آرگومان
\&\f(CW\*(C`initializer_list\*(C'\fR ذخیره می‌کند، این کار طول عمر آرایه را افزایش نمی‌دهد؛
بنابراین اگر متغیر یک کلاس از یک \f(CW\*(C`initializer_list\*(C'\fR موقت ساخته شود، اشاره‌گر
در پایان دستور اعلان متغیر معلق باقی می‌ماند.
.RE
.RS 4
.RE
.IP \fB\-Winvalid\-constexpr\fR 4
.IX Item "-Winvalid-constexpr"
هنگامی که یک تابع هرگز یک عبارت ثابت (constant expression) تولید نمی‌کند، هشدار می‌دهد. در C++20
و نسخه‌های پیشین، برای هر تابع و الگوی تابع \f(CW\*(C`constexpr\*(C'\fR، باید حداقل یک مجموعه از
آرگومان‌های تابع در دست‌کم یک نمونه‌سازی وجود داشته باشد به طوری که فراخوانی تابع یا سازنده
بتواند یک زیرعبارت ارزیابی‌شده از یک core constant expression باشد.
C++23 این محدودیت را حذف کرده است، بنابراین می‌توان تابع یا الگوی تابعی با برچسب
\&\f(CW\*(C`constexpr\*(C'\fR داشت که هیچ فراخوانی از آن شرایط یک core constant expression را برآورده نکند.
.Sp
این هشدار به‌طور پیش‌فرض در C++20 و نسخه‌های پیشین به عنوان یک هشدار سخت‌گیرانه (pedantic) فعال است.
در C++23، گزینه \fB\-Winvalid\-constexpr\fR را می‌توان فعال کرد که در این صورت یک هشدار معمولی خواهد بود.
برای مثال:
.Sp
.Vb 7
\&        void f (int& i);
\&        constexpr void
\&        g (int& i)
\&        {
\&          // Warns by default in C++20, in C++23 only with \-Winvalid\-constexpr.
\&          f(i);
\&        }
.Ve
.IP \fB\-Winvalid\-imported\-macros\fR 4
.IX Item "-Winvalid-imported-macros"
معتبر بودن تمام تعاریف ماکروهای واردشده (imported) را در پایان کامپایل بررسی می‌کند.
این گزینه به‌طور پیش‌فرض فعال نیست، زیرا بررسی آن نیازمند پردازش اضافی است. این گزینه ممکن
است هنگام آماده‌سازی مجموعه‌هایی از header\-unitها برای اطمینان از سازگاری ماکروها مفید باشد.
.IP "\fB\-Wno\-literal\-suffix\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-literal-suffix (C++ and Objective-C++ only)"
هنگامی که پس از یک لیترال رشته‌ای یا نویسه‌ای یک ud\-suffix قرار گیرد که با زیرخط (underscore)
شروع نمی‌شود، هشدار نمی‌دهد. به عنوان یک افزونه منطبق بر استاندارد، GCC با چنین پسوندهایی به عنوان
توکن‌های پیش‌پردازش جداگانه رفتار می‌کند تا سازگاری عقبرو با کدهایی که از ماکروهای قالب‌بندی
\&\f(CW\*(C`<inttypes.h>\*(C'\fR استفاده می‌کنند حفظ شود. برای مثال:
.Sp
.Vb 3
\&        #define _\|_STDC_FORMAT_MACROS
\&        #include <inttypes.h>
\&        #include <stdio.h>
\&        
\&        int main() {
\&          int64_t i64 = 123;
\&          printf("My int64: %" PRId64"\en", i64);
\&        }
.Ve
.Sp
در این مورد، با \f(CW\*(C`PRId64\*(C'\fR به عنوان یک توکن پیش‌پردازش جداگانه رفتار می‌شود.
.Sp
این گزینه همچنین هشدارهایی را کنترل می‌کند که هنگام اعلان عملگر لیترال تعریف‌شده توسط کاربر
با یک شناسه پسوند لیترال که با زیرخط شروع نمی‌شود، صادر می‌شوند. شناسه‌های پسوند لیترالی که با
زیرخط شروع نمی‌شوند برای استانداردسازی‌های آینده رزرو شده‌اند.
.Sp
این هشدارها به‌طور پیش‌فرض فعال هستند.
.IP "\fB\-Wno\-narrowing\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-narrowing (C++ and Objective-C++ only)"
برای استانداردهای C++11 و بالاتر، تبدیل‌های باریک‌کننده (narrowing conversions) همان‌طور که استاندارد
الزامی کرده، به‌طور پیش‌فرض تشخیص داده می‌شوند. یک تبدیل باریک‌کننده از یک مقدار ثابت منجر به خطا
و تبدیل باریک‌کننده از یک مقدار غیرثابت منجر به هشدار می‌شود، اما گزینه \fB\-Wno\-narrowing\fR این
پیام‌های تشخیصی را فرومی‌نشاند.
توجه داشته باشید که این گزینه بر معنای کدهای خوش‌ساخت (well\-formed) تأثیری ندارد؛
تبدیل‌های باریک‌کننده همچنان در زمینه‌های SFINAE بدساخت (ill\-formed) تلقی می‌شوند.
.Sp
با گزینه \fB\-Wnarrowing\fR در C++98، هرگاه تبدیل باریک‌کننده‌ای که در C++11 ممنوع شده درون
\&\fB{ }\fR رخ دهد، هشدار داده می‌شود؛ به عنوان مثال:
.Sp
.Vb 1
\&        int i = { 2.2 }; // error: narrowing from double to int
.Ve
.Sp
این پرچم در \fB\-Wall\fR و \fB\-Wc++11\-compat\fR گنجانده شده است.
.IP "\fB\-Wnoexcept\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wnoexcept (C++ and Objective-C++ only)"
هنگامی که یک noexcept\-expression به دلیل فراخوانی تابعی که فاقد مشخصه استثنای غیرپرتابی
(یعنی \f(CWthrow()\fR یا \f(CW\*(C`noexcept\*(C'\fR) است اما برای کامپایلر مشخص است که هرگز استثنا پرتاب
نمی‌کند به false ارزیابی می‌شود، هشدار می‌دهد.
.IP "\fB\-Wnoexcept\-type\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wnoexcept-type (C++ and Objective-C++ only)"
اگر قابلیت C++17 که \f(CW\*(C`noexcept\*(C'\fR را بخشی از نوع تابع قرار می‌دهد، نام درهم‌ریخته (mangled name)
یک نماد را نسبت به C++14 تغییر دهد، هشدار می‌دهد. فعال‌شده توسط \fB\-Wabi\fR
و \fB\-Wc++17\-compat\fR.
.Sp
به عنوان یک مثال:
.Sp
.Vb 3
\&        template <class T> void f(T t) { t(); };
\&        void g() noexcept;
\&        void h() { f(g); }
.Ve
.Sp
در C++14، تابع \f(CW\*(C`f\*(C'\fR تابع \f(CW\*(C`f<void(*)()>\*(C'\fR را فراخوانی می‌کند، اما در
C++17 تابع \f(CW\*(C`f<void(*)()noexcept>\*(C'\fR را فرامی‌خواند.
.IP "\fB\-Wclass\-memaccess\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wclass-memaccess (C++ and Objective-C++ only)"
هنگامی که مقصد فراخوانی یک تابع حافظه خام مانند \&\f(CW\*(C`memset\*(C'\fR یا \f(CW\*(C`memcpy\*(C'\fR یک شیء
از نوع کلاس باشد، و نوشتن در چنین شیئی ممکن است سازنده یا انتساب رونوشت (copy assignment) غیرساده
(non\-trivial) یا حذف‌شده (deleted) کلاس را دور بزند، درستیِ ثبات (const\-correctness) یا کپسوله‌سازی را نقض کند،
یا اشاره‌گرهای جدول مجازی را مخدوش سازد، هشدار می‌دهد. اصلاح بازنمایی چنین اشیایی ممکن است
ناورداهای (invariants) حفظ‌شده توسط توابع عضو کلاس را نقض کند. برای مثال، فراخوانی \f(CW\*(C`memset\*(C'\fR
در زیر رفتار تعریف‌نشده (undefined) دارد زیرا یک شیء کلاس غیرساده را تغییر می‌دهد و بنابراین پیام
تشخیصی صادر می‌شود. روش ایمن برای مقداردهی اولیه یا پاکسازی حافظه اشیایی از این دست، استفاده از
سازنده یا عملگر انتساب مناسب در صورت وجود است.
.Sp
.Vb 2
\&        std::string str = "abc";
\&        memset (&str, 0, sizeof str);
.Ve
.Sp
گزینه \fB\-Wclass\-memaccess\fR توسط \fB\-Wall\fR فعال می‌شود.
تبدیل صریح (cast) اشاره‌گر به شیء کلاس به \f(CW\*(C`void *\*(C'\fR یا به نوعی که بتواند با امنیت توسط
تابع حافظه خام مورد دسترسی قرار گیرد، این هشدار را فرومی‌نشاند..IP "\fB\-Wnon\-virtual\-dtor\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wnon-virtual-dtor (تنها C++ و Objective-C++)"
زمانی هشدار می‌دهد که یک کلاس دارای توابع مجازی و یک مخرب (destructor) غیرمجازیِ در دسترس در خود یا در یک کلاس پایهٔ چندریختیِ در دسترس باشد؛ در این حالت، حذف (delete کردن) یک نمونه از کلاس مشتق‌شده از طریق اشاره‌گری به خود کلاس یا کلاس پایه امکان‌پذیر ولی ناامن است. این هشدار در صورت تعیین \fB\-Weffc++\fR به‌طور خودکار فعال می‌شود. گزینهٔ \fB\-Wdelete\-non\-virtual\-dtor\fR (فعال‌شده با \fB\-Wall\fR) به دلیل هشدار دربارهٔ موارد ناامن بدون هشدارهای مثبت کاذب، باید ترجیح داده شود.
.IP "\fB\-Wregister\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wregister (تنها C++ و Objective-C++)"
در مورد استفاده از مشخص‌کنندهٔ کلاس حافظهٔ \f(CW\*(C`register\*(C'\fR هشدار می‌دهد، مگر زمانی که بخشی از افزونهٔ \fBExplicit Register Variables\fR گنو باشد. استفاده از کلیدواژهٔ \f(CW\*(C`register\*(C'\fR به عنوان مشخص‌کنندهٔ کلاس حافظه در C++11 منسوخ شده و در C++17 حذف شده است.
به‌طور پیش‌فرض با \fB\-std=c++17\fR فعال است.
.IP "\fB\-Wreorder\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wreorder (تنها C++ و Objective-C++)"
زمانی هشدار می‌دهد که ترتیب مقداردهنده‌های اولیهٔ اعضا که در کد آمده است با ترتیبی که باید اجرا شوند مطابقت نداشته باشد. برای نمونه:
.Sp
.Vb 5
\&        struct A {
\&          int i;
\&          int j;
\&          A(): j (0), i (1) { }
\&        };
.Ve
.Sp
کامپایلر مقداردهنده‌های اعضا را برای \f(CW\*(C`i\*(C'\fR و \f(CW\*(C`j\*(C'\fR بازآرایی می‌کند تا با ترتیب اعلان اعضا مطابقت پیدا کند و هشداری مبنی بر این موضوع صادر می‌کند. این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-pessimizing\-move\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-pessimizing-move (تنها C++ و Objective-C++)"
این هشدار زمانی اعلام می‌شود که فراخوانی \f(CW\*(C`std::move\*(C'\fR مانع از حذف کپی (copy elision) شود. سناریوی متداول برای رخ دادن حذف کپی، زمان بازگشت از تابعی با نوع بازگشتی از نوع کلاس است؛ در صورتی که عبارت بازگردانده‌شده نام یک شیء خودکار (automatic object) غیر\-volatile بوده، پارامتر تابع نباشد و نوع آن با نوع بازگشتی تابع یکسان باشد.
.Sp
.Vb 9
\&        struct T {
\&        ...
\&        };
\&        T fn()
\&        {
\&          T t;
\&          ...
\&          return std::move (t);
\&        }
.Ve
.Sp
اما در این مثال، فراخوانی \f(CW\*(C`std::move\*(C'\fR مانع از حذف کپی می‌شود.
.Sp
این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-redundant\-move\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-redundant-move (تنها C++ و Objective-C++)"
این هشدار دربارهٔ فراخوانی‌های زائد \f(CW\*(C`std::move\*(C'\fR هشدار می‌دهد؛ یعنی زمانی که حتی بدون فراخوانی \f(CW\*(C`std::move\*(C'\fR نیز عملیات انتقال انجام می‌شد. این وضعیت به این دلیل رخ می‌دهد که کامپایلر در شرایط خاصی مانند بازگرداندن یک متغیر محلی که در آن حذف کپی ممکن نیست، مجبور است با شیء به‌گونه‌ای رفتار کند که گویی یک rvalue است. مثال زیر را در نظر بگیرید:
.Sp
.Vb 8
\&        struct T {
\&        ...
\&        };
\&        T fn(T t)
\&        {
\&          ...
\&          return std::move (t);
\&        }
.Ve
.Sp
در اینجا، فراخوانی \f(CW\*(C`std::move\*(C'\fR زائد است. از آنجا که G++ مسئلهٔ بنیادین ۱۵۷۹ (Core Issue 1579) را پیاده‌سازی می‌کند، مثال دیگر به این صورت است:
.Sp
.Vb 12
\&        struct T { // convertible to U
\&        ...
\&        };
\&        struct U {
\&        ...
\&        };
\&        U fn()
\&        {
\&          T t;
\&          ...
\&          return std::move (t);
\&        }
.Ve
.Sp
در این مثال، حذف کپی قابل اعمال نیست زیرا نوع عبارت بازگردانده‌شده و نوع بازگشتی تابع متفاوت هستند، با این حال G++ با مقدار بازگشتی طوری رفتار می‌کند که گویی توسط یک rvalue مشخص شده است.
.Sp
این هشدار با \fB\-Wextra\fR فعال می‌شود.
.IP "\fB\-Wrange\-loop\-construct\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wrange-loop-construct (تنها C++ و Objective-C++)"
این هشدار زمانی اعلان می‌شود که یک حلقهٔ for بر پایهٔ بازه (range\-based for\-loop) در C++ یک کپی غیرضروری ایجاد کند. این حالت زمانی می‌تواند رخ دهد که اعلان بازه یک مرجع (reference) نباشد، در حالی که احتمالاً باید باشد. برای نمونه:
.Sp
.Vb 5
\&        struct S { char arr[128]; };
\&        void fn () {
\&          S arr[5];
\&          for (const auto x : arr) { ... }
\&        }
.Ve
.Sp
هنگامی که نوع کپی‌شده یک نوع با کپی‌برداری ساده (trivially\-copyable) باشد که اندازهٔ آن کمتر از ۶۴ بایت است، هشداری داده نمی‌شود.
.Sp
این هشدار همچنین زمانی که یک متغیر حلقه در یک حلقهٔ for مبتنی بر بازه با مقداری از نوع متفاوت مقداردهی اولیه شود که به کپی شدن بینجامد، هشدار می‌دهد. برای نمونه:
.Sp
.Vb 4
\&        void fn() {
\&          int arr[10];
\&          for (const double &x : arr) { ... }
\&        }
.Ve
.Sp
در مثال بالا، در هر تکرار حلقه یک مقدار موقت از نوع \f(CW\*(C`double\*(C'\fR ایجاد و نابود می‌شود که مرجع \&\f(CW\*(C`const double &\*(C'\fR به آن متصل می‌گردد.
.Sp
این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wredundant\-tags\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wredundant-tags (تنها C++ و Objective-C++)"
دربارهٔ class\-key و enum\-key زائد در ارجاع به نوع‌های کلاس و نوع‌های شمارشی در زمینه‌هایی که این کلید می‌تواند بدون ایجاد ابهام حذف شود، هشدار می‌دهد. برای نمونه:
.Sp
.Vb 2
\&        struct foo;
\&        struct foo *p;   // warn that keyword struct can be eliminated
.Ve
.Sp
از سوی دیگر، در این مثال هیچ هشداری داده نمی‌شود:
.Sp
.Vb 3
\&        struct foo;
\&        void foo ();   // "hides" struct foo
\&        void bar (struct foo&);  // no warning, keyword struct is necessary
.Ve
.IP "\fB\-Wno\-subobject\-linkage\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-subobject-linkage (تنها C++ و Objective-C++)"
اگر یک نوع کلاس دارای یک پایه یا فیلدی باشد که نوع آن از فضای نام ناشناس (anonymous namespace) استفاده می‌کند یا به نوعی بدون پیوند (no linkage) وابسته است، هشدار ندهد. اگر یک نوع A به یک نوع B بدون پیوند یا با پیوند درونی (internal linkage) وابسته باشد، تعریف آن در چندین واحد ترجمه (translation unit) نقض ODR (قاعدهٔ یک‌بار تعریف) خواهد بود، زیرا معنای B در هر واحد ترجمه متفاوت است. اگر A تنها در یک واحد ترجمه ظاهر شود، بهترین راه برای بی‌صدا کردن هشدار این است که با قرار دادن آن در یک فضای نام ناشناس، به آن نیز پیوند درونی داده شود. کامپایلر این هشدار را برای نوع‌های تعریف‌شده در فایل اصلی .C صادر نمی‌کند، زیرا بعید است که آن‌ها دارای تعاریف چندگانه باشند.
\&\fB\-Wsubobject\-linkage\fR به‌طور پیش‌فرض فعال است.
.IP "\fB\-Weffc++\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Weffc++ (تنها C++ و Objective-C++)"
دربارهٔ نقض رهنمودهای سبک زیر از مجموعه کتاب‌های \fIEffective C++\fR اثر اسکات مایرز (Scott Meyers) هشدار می‌دهد:
.RS 4
.IP * 4
برای کلاس‌هایی با حافظهٔ تخصیص‌یافته به‌طور پویا، یک سازندهٔ رونوشت (copy constructor) و یک عملگر انتساب (assignment operator) تعریف کنید.
.IP * 4
در سازنده‌ها، مقداردهی اولیه را به انتساب ترجیح دهید.
.IP * 4
کاری کنید که \f(CW\*(C`operator=\*(C'\fR مرجعی به \f(CW*this\fR بازگرداند.
.IP * 4
هنگامی که باید یک شیء را بازگردانید، سعی نکنید یک مرجع بازگردانید.
.IP * 4
بین شکل‌های پیشوندی و پسوندی عملگرهای افزایش و کاهش تمایز قائل شوید.
.IP * 4
هرگز \f(CW\*(C`&&\*(C'\fR، \f(CW\*(C`||\*(C'\fR، یا \f(CW\*(C`,\*(C'\fR را سربارگذاری نکنید.
.RE
.RS 4
.Sp
این گزینه همچنین \fB\-Wnon\-virtual\-dtor\fR را فعال می‌کند که آن هم یکی از توصیه‌های Effective C++ است. با این حال، این بررسی گسترش یافته است تا در مورد عدم وجود مخرب مجازی در کلاس‌های پایهٔ غیرچندریختیِ در دسترس نیز هشدار دهد.
.Sp
هنگام انتخاب این گزینه، توجه داشته باشید که سرآیندهای کتابخانهٔ استاندارد از همهٔ این رهنمودها پیروی نمی‌کنند؛ برای فیلتر کردن این هشدارها از \fBgrep \-v\fR استفاده کنید.
.RE.IP "\fB\-Wno\-exceptions\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-exceptions (C++ and Objective-C++ only)"
هشدار مربوط به حالتی که در آن یک گردانندهٔ استثنا (exception handler) توسط گردانندهٔ دیگری پوشانده (shadow) می‌شود را غیرفعال می‌کند؛ حالتی که می‌تواند نشان‌دهندهٔ ترتیب نادرست گرداننده‌های استثنا باشد.
.IP "\fB\-Wsfinae\-incomplete\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wsfinae-incomplete (C++ and Objective-C++ only)"
دربارهٔ کلاسی که ناقص (incomplete) تشخیص داده شده است، یا تابعی با نوع بازگشتی auto که نوع آن هنوز استنتاج نشده، در زمینه‌ای که به جای خطا موجب شکست در جایگزینی (substitution failure) می‌شود و سپس کلاس یا تابع بعداً در واحد ترجمه تعریف می‌گردد، هشدار می‌دهد. این مسئله مشکل‌ساز است چرا که نمونه‌سازی‌های الگو (template instantiations) یا بررسی‌های مفهوم (concept checks) در صورتی که قبل یا بعد از تعریف رخ دهند، ممکن است نتایج متفاوتی در بر داشته باشند.
.Sp
این هشدار به صورت پیش‌فرض فعال است. \fB\-Wsfinae\-incomplete=2\fR هشداری را در نقطهٔ شکست در جایگزینی اضافه می‌کند تا ردگیری مشکلات مشخص‌شده توسط حالت پیش‌فرض آسان‌تر شود.
.IP "\fB\-Wstrict\-null\-sentinel\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wstrict-null-sentinel (C++ and Objective-C++ only)"
دربارهٔ استفاده از \f(CW\*(C`NULL\*(C'\fR بدون تبدیل صریح نوع (uncasted) به عنوان نشانگر پایان (sentinel) هشدار می‌دهد. هنگام کامپایل تنها با GCC این یک نشانگر معتبر است، زیرا \f(CW\*(C`NULL\*(C'\fR به صورت \f(CW\*(C`_\|_null\*(C'\fR تعریف شده است. اگرچه این یک ثابت اشاره‌گر تهی است و نه یک اشاره‌گر تهی، اما تضمین می‌شود که اندازه‌ای برابر با یک اشاره‌گر داشته باشد. با این حال این استفاده در میان کامپایلرهای مختلف قابل‌حمل (portable) نیست.
.IP "\fB\-Wno\-non\-c\-typedef\-for\-linkage\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-non-c-typedef-for-linkage (C++ and Objective-C++ only)"
هشدار سخت‌گیرانه (pedwarn) را برای کلاس‌های بی‌نام دارای نام typedef با هدف پیونددهی (linkage) که حاوی اعضای خاص C++، کلاس‌های پایه، مقدارهای اولیهٔ پیش‌فرض عضو یا عبارت‌های لامبدا هستند (شامل موارد موجود در کلاس‌های عضو تو‌در‌تو)، غیرفعال می‌کند.
.Sp
.Vb 10
\&        typedef struct {
\&          int a; // non\-static data members are ok
\&          struct T { int b; }; // member classes too
\&          enum E { E1, E2, E3 }; // member enumerations as well
\&          int c = 42; // default member initializers are not ok
\&          struct U : A { int c; }; // classes with base classes are not ok
\&          typedef int V; // typedef is not ok
\&          using W = int; // using declaration is not ok
\&          decltype([](){}) x; // lambda expressions not ok
\&        } S;
.Ve
.Sp
در تمام این موارد، نام برچسب S باید پس از کلمهٔ کلیدی struct اضافه شود.
.IP "\fB\-Wno\-non\-template\-friend\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-non-template-friend (C++ and Objective-C++ only)"
هشدارهای مربوط به زمانی را که توابع دوست (friend) غیرالگویی در داخل یک الگو اعلان می‌شوند غیرفعال می‌کند. در نسخه‌های بسیار قدیمی GCC که پیش از پیاده‌سازی استاندارد ISO بودند، اعلان‌هایی مانند \&\fBfriend int foo(int)\fR که در آن‌ها نام دوست یک شناسهٔ بدون پیشوند و شرط (unqualified\-id) است، می‌توانستند به عنوان یک تخصیص خاص از یک تابع الگو تفسیر شوند؛ این هشدار برای تشخیص مشکلات سازگاری وجود دارد و به صورت پیش‌فرض فعال است.
.IP "\fB\-Wold\-style\-cast\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wold-style-cast (C++ and Objective-C++ only)"
در صورتی که تبدیل نوع به سبک قدیمی (سبک C) به نوعی غیر از void در یک برنامهٔ C++ به کار رود، هشدار می‌دهد. تبدیل نوع‌های سبک جدید (\f(CW\*(C`dynamic_cast\*(C'\fR، \&\f(CW\*(C`static_cast\*(C'\fR، \f(CW\*(C`reinterpret_cast\*(C'\fR و \f(CW\*(C`const_cast\*(C'\fR) کمتر در معرض اثرات ناخواسته هستند و جست‌وجوی آن‌ها بسیار آسان‌تر است.
.IP "\fB\-Woverloaded\-virtual\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Woverloaded-virtual (C++ and Objective-C++ only)"
.PD 0
.IP \fB\-Woverloaded\-virtual=\fR\fIn\fR 4
.IX Item "-Woverloaded-virtual=n"
.PD
زمانی که اعلان یک تابع موجب پنهان شدن توابع مجازی (virtual) یک کلاس پایه شود هشدار می‌دهد. برای نمونه در:
.Sp
.Vb 3
\&        struct A {
\&          virtual void f();
\&        };
\&        
\&        struct B: public A {
\&          void f(int); // does not override
\&        };
.Ve
.Sp
نسخهٔ کلاس \f(CW\*(C`A\*(C'\fR از تابع \f(CW\*(C`f\*(C'\fR در \f(CW\*(C`B\*(C'\fR پنهان می‌شود، و کدی مانند:
.Sp
.Vb 2
\&        B* b;
\&        b\->f();
.Ve
.Sp
در کامپایل با خطا مواجه می‌شود.
.Sp
در مواردی که تفاوت امضاها تصادفی نیست، ساده‌ترین راه‌حل افزودن یک اعلان using (using\-declaration) به کلاس مشتق‌شده است تا تابع کلاس پایه از حالت پنهان خارج شود؛ برای نمونه، افزودن \f(CW\*(C`using A::f;\*(C'\fR به \f(CW\*(C`B\*(C'\fR.
.Sp
پسوند سطح اختیاری، رفتار را زمانی کنترل می‌کند که همهٔ اعلان‌ها در کلاس مشتق‌شده توابع مجازی کلاس پایه را بازنویسی (override) می‌کنند، حتی اگر همهٔ توابع پایه بازنویسی نشده باشند:
.Sp
.Vb 4
\&        struct C {
\&          virtual void f();
\&          virtual void f(int);
\&        };
\&        
\&        struct D: public C {
\&          void f(int); // does override
\&        }
.Ve
.Sp
احتمال اینکه این الگو ناشی از یک اشتباه باشد کمتر است؛ اگر از D تنها به صورت مجازی استفاده شود، کاربر ممکن است تشخیص داده باشد که معناشناسی کلاس پایه برای برخی از سربارگذاری‌ها مناسب است.
.Sp
در سطح ۱، این حالت هشداری تولید نمی‌کند؛ در سطح ۲ هشدار می‌دهد. گزینهٔ \fB\-Woverloaded\-virtual\fR به تنهایی سطح ۲ را انتخاب می‌کند. سطح ۱ در \fB\-Wall\fR گنجانده شده است.
.IP "\fB\-Wno\-pmf\-conversions\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-pmf-conversions (C++ and Objective-C++ only)"
پیام تشخیصی برای تبدیل یک اشاره‌گر مقید به تابع عضو (bound pointer to member function) به یک اشاره‌گر ساده را غیرفعال می‌کند.
.IP "\fB\-Wsign\-promo\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wsign-promo (C++ and Objective-C++ only)"
زمانی که حل تفکیک سربارگذاری (overload resolution)، ترفیع از نوع بدون علامت یا نوع شمارشی به یک نوع علامت‌دار را بر تبدیل به یک نوع بدون علامت با همان اندازه ترجیح می‌دهد، هشدار می‌دهد. نسخه‌های پیشین G++ تلاش می‌کردند وضعیت بدون علامت بودن را حفظ کنند، اما استاندارد رفتار فعلی را الزامی کرده است.
.IP "\fB\-Wtemplates\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wtemplates (C++ and Objective-C++ only)"
هنگام مواجهه با اعلان یک الگوی اولیه (primary template) هشدار می‌دهد. برخی قواعد کدنویسی استفاده از الگوها را مجاز نمی‌دانند، و این گزینه ممکن است برای اعمال آن قانون استفاده شود. این هشدار در فایل‌های سرآیند سیستم مانند STL غیرفعال است، بنابراین همچنان می‌توان از STL بهره برد. همچنین می‌توان الگوها را نمونه‌سازی یا تخصیص (specialize) کرد.
.IP "\fB\-Wmismatched\-new\-delete\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wmismatched-new-delete (C++ and Objective-C++ only)"
دربارهٔ عدم تطابق میان فراخوانی‌های \f(CW\*(C`operator new\*(C'\fR یا \f(CW\*(C`operator
delete\*(C'\fR و فراخوانی متناظر آن‌ها با تابع تخصیص یا آزادسازی حافظه هشدار می‌دهد. این موضوع شامل فراخوانی‌های \f(CW\*(C`operator delete\*(C'\fR در C++ با اشاره‌گرهای بازگردانده‌شده از فرم‌های ناسازگار \f(CW\*(C`operator new\*(C'\fR، یا از سایر توابع تخصیص‌دهندهٔ شیءهایی است که \f(CW\*(C`operator delete\*(C'\fR برای آن‌ها آزادکنندهٔ مناسبی نیست، و همچنین فراخوانی سایر توابع آزادسازی با اشاره‌گرهای بازگردانده‌شده از \f(CW\*(C`operator new\*(C'\fR که تابع آزادسازی برای آن‌ها نامناسب است.
.Sp
برای نمونه، عبارت \f(CW\*(C`delete\*(C'\fR در تابع زیر گزارش می‌شود زیرا با فرم آرایه‌ای عبارت \f(CW\*(C`new\*(C'\fR که آرگومان اشاره‌گر از آن بازگردانده شده تطابق ندارد. به طور مشابه، فراخوانی \f(CW\*(C`free\*(C'\fR نیز گزارش می‌شود.
.Sp
.Vb 4
\&        void f ()
\&        {
\&          int *a = new int[n];
\&          delete a;   // warning: mismatch in array forms of expressions
\&        
\&          char *p = new char[n];
\&          free (p);   // warning: mismatch between new and free
\&        }
.Ve
.Sp
گزینهٔ مرتبط \fB\-Wmismatched\-dealloc\fR عدم تطابق‌های مربوط به توابع تخصیص و آزادسازی حافظه به غیر از \f(CW\*(C`operator
new\*(C'\fR و \f(CW\*(C`operator delete\*(C'\fR را گزارش می‌دهد.
.Sp
\&\fB\-Wmismatched\-new\-delete\fR در \fB\-Wall\fR گنجانده شده است.
.IP "\fB\-Wmismatched\-tags\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wmismatched-tags (C++ and Objective-C++ only)"
برای اعلان‌های structها، classها، و الگوهای کلاس و تخصیص‌های آن‌ها با یک class\-key که با تعریف، یا با اولین اعلان (در صورت عدم ارائهٔ تعریف) مطابقت ندارد هشدار می‌دهد.
.Sp
برای نمونه، اعلان \f(CW\*(C`struct Object\*(C'\fR در فهرست آرگومان‌های \f(CW\*(C`draw\*(C'\fR موجب تحریک هشدار می‌شود. برای جلوگیری از آن، یا class\-key زائد \f(CW\*(C`struct\*(C'\fR را حذف کنید یا آن را با \f(CW\*(C`class\*(C'\fR جایگزین نمایید تا با تعریف آن مطابقت داشته باشد.
.Sp
.Vb 5
\&        class Object {
\&        public:
\&          virtual ~Object () = 0;
\&        };
\&        void draw (struct Object*);
.Ve
.Sp
اعلان یک کلاس با class\-key به صورت \f(CW\*(C`struct\*(C'\fR همان‌طور که مثال بالا نشان می‌دهد اشتباه نیست. گزینهٔ \fB\-Wmismatched\-tags\fR به منظور کمک به دستیابی به سبکی یکدست در اعلان کلاس‌ها در نظر گرفته شده است. در کدهایی که قرار است به کامپایلرهای مبتنی بر Windows منتقل شوند، این هشدار به جلوگیری از خطاهای ارجاع حل‌نشده (unresolved references) ناشی از تفاوت در مغشوش‌سازی نام‌ها (mangling) برای نمادهای اعلان‌شده با class\-keyهای متفاوت کمک می‌کند. این گزینه می‌تواند به تنهایی یا همراه با \fB\-Wredundant\-tags\fR به کار رود..IP "\fB\-Wmultiple\-inheritance\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wmultiple-inheritance (تنها C++ و Objective-C++)"
هنگامی که کلاسی با چندین کلاس پایه مستقیم تعریف شود هشدار می‌دهد. برخی
قوانین کدنویسی وراثت چندگانه را منع می‌کنند، و می‌توان از این گزینه برای
اعمال آن قانون استفاده کرد. این هشدار در فایل‌های سرآیند سیستمی،
مانند STL، غیرفعال است؛ بنابراین همچنان می‌توان از STL استفاده کرد. همچنین
می‌توان کلاس‌هایی را تعریف کرد که به طور غیرمستقیم از وراثت چندگانه استفاده می‌کنند.
.IP \fB\-Wvirtual\-inheritance\fR 4
.IX Item "-Wvirtual-inheritance"
هنگامی که کلاسی با یک کلاس پایه مستقیم مجازی تعریف شود هشدار می‌دهد. برخی
قوانین کدنویسی وراثت چندگانه را منع می‌کنند، و می‌توان از این گزینه برای
اعمال آن قانون استفاده کرد. این هشدار در فایل‌های سرآیند سیستمی،
مانند STL، غیرفعال است؛ بنابراین همچنان می‌توان از STL استفاده کرد. همچنین
می‌توان کلاس‌هایی را تعریف کرد که به طور غیرمستقیم از وراثت مجازی استفاده می‌کنند.
.IP \fB\-Wno\-virtual\-move\-assign\fR 4
.IX Item "-Wno-virtual-move-assign"
هشدارهای مربوط به ارث‌بری از یک پایهٔ مجازی با عملگر انتساب انتقال غیربدیهی
در C++11 را نادیده می‌گیرد. این وضعیت خطرناک است زیرا اگر پایهٔ مجازی از بیش
از یک مسیر در دسترس باشد، چندین بار منتقل (move) می‌شود که می‌تواند به این
معنی باشد که هر دو شیء در وضعیت منتقل‌شده (moved\-from) قرار گیرند. اگر
عملگر انتساب انتقال به گونه‌ای نوشته شده باشد که از انتقال یک شیءِ از پیش
منتقل‌شده جلوگیری کند، می‌توان این هشدار را غیرفعال کرد.
.IP \fB\-Wnamespaces\fR 4
.IX Item "-Wnamespaces"
هنگامی که یک تعریف فضای نام (namespace) باز شود هشدار می‌دهد. برخی قوانین
کدنویسی فضاهای نام را منع می‌کنند، و می‌توان از این گزینه برای اعمال آن قانون
استفاده کرد. این هشدار در فایل‌های سرآیند سیستمی مانند STL غیرفعال است،
بنابراین همچنان می‌توان از STL استفاده کرد. همچنین می‌توان از دستورالعمل‌های
using و نام‌های واجد شرایط (qualified names) استفاده نمود.
.IP "\fB\-Wno\-template\-body\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-template-body (تنها C++ و Objective-C++)"
تشخیص خطاها را هنگام تجزیهٔ یک قالب (template) غیرفعال می‌کند و در عوض
خطا را تنها در زمان نمونه‌سازی (instantiation) قالب صادر می‌کند. این پرچم
همچنین می‌تواند برای تنزل دادن چنین خطاهایی به هشدار با \fBWno\-error=\fR یا
\&\fB\-fpermissive\fR به کار رود.
.IP "\fB\-Wno\-template\-id\-cdtor\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-template-id-cdtor (تنها C++ و Objective-C++)"
هشدار دربارهٔ استفاده از simple\-template\-id به عنوان declarator\-id یک
سازنده یا مخرب را که در C++20 از طریق DR 2237 نامعتبر شد، غیرفعال می‌کند.
برای نمونه:
.Sp
.Vb 4
\&        template<typename T> struct S {
\&          S<T>(); // should be S();
\&          ~S<T>();  // should be ~S();
\&        };
.Ve
.Sp
گزینهٔ \&\fB\-Wtemplate\-id\-cdtor\fR به طور پیش‌فرض با
\&\fB\-std=c++20\fR فعال است؛ همچنین توسط \fB\-Wc++20\-compat\fR فعال می‌شود.
.IP \fB\-Wtemplate\-names\-tu\-local\fR 4
.IX Item "-Wtemplate-names-tu-local"
هنگامی که بدنهٔ یک قالب، افشای یک موجودیت محلی واحد ترجمه (translation\-unit\-local)
را پنهان می‌کند هشدار می‌دهد. در بیشتر موارد، ارجاع به یک موجودیت محلیِ واحد ترجمه
(مانند اعلانی با پیوند درونی / internal linkage) درون موجودیتی که به CMI یک
ماژول صادر می‌شود خطا است. با این حال، درون مقداردهندهٔ اولیهٔ یک متغیر، یا در بدنهٔ
یک تابع غیربرخط (non\-inline)، این یک افشا به شمار نمی‌رود و هیچ خطایی صادر نمی‌گردد.
.Sp
این امر می‌تواند باعث شود قالب‌های متغیر یا تابع در صورت ارجاع به چنین موجودیتی به طور
تصادفی غیرقابل استفاده شوند، زیرا سایر واحدهای ترجمه‌ای که این قالب را درون‌ریزی
(import) می‌کنند هرگز قادر به نمونه‌سازی آن نخواهند بود. این هشدار تلاش می‌کند مواردی
را که این مسئله ممکن است رخ دهد شناسایی کند. وجود یک نمونه‌سازی صریح (explicit
instantiation) این هشدار را بی‌اثر می‌کند.
.Sp
این پرچم توسط \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wno\-expose\-global\-module\-tu\-local\fR 4
.IX Item "-Wno-expose-global-module-tu-local"
افشای یک موجودیت محلیِ واحد ترجمه از طریق یک رابط ماژول نامعتبر است، چرا که ممکن است
موجب نقض ODR شده و به صورت خطاهای پیونددهی یا رفتارهای غیرمنتظرهٔ دیگر نمایان شود.
با این حال، بسیاری از کتابخانه‌های موجود موجودیت‌های TU\-local را در رابط خود اعلان
می‌کنند و اجتناب از افشای این موجودیت‌ها در برخی موارد می‌تواند دشوار باشد.
.Sp
به عنوان یک افزونه، GCC افشای متغیرها و توابع درونی را که در قطعه‌ماژول سراسری
(global module fragment) اعلان شده‌اند مجاز می‌داند. این هشدار وقوع چنین افشای
نامعتبری را نشان می‌دهد، و می‌تواند با استفاده از عملگرهای راهنمای تشخیص (diagnostic pragmas)
چه در محل افشا و چه در نقطهٔ اعلان آن اعلان درونی بی‌اثر شود. این موضوع همچنین برای
اعلان‌های \f(CW\*(C`export using\*(C'\fR که چنین موجودیت‌هایی را نام می‌برند اعمال می‌گردد.
.Sp
هنگامی که این گزینه با \fB\-Wtemplate\-names\-tu\-local\fR ترکیب شود، GCC همچنین دربارهٔ
ارجاعات غیر افشاگرانه به موجودیت‌های TU\-local در بدنهٔ قالب‌ها هشدار خواهد داد. چنین
قالب‌هایی همچنان می‌توانند در سایر TUها نمونه‌سازی شوند، اما خطرات بالا در رابطه با
افشای موجودیت‌های محلی واحد ترجمه همچنان صادق است.
.Sp
این هشدار به طور پیش‌فرض فعال است و توسط \&\fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wno\-external\-tu\-local\fR 4
.IX Item "-Wno-external-tu-local"
هنگام نام بردن از یک موجودیت TU\-local در خارج از واحد ترجمه‌ای که در آن اعلان شده
است هشدار می‌دهد. چنین اعلان‌هایی در طول جستجوی نام (name lookup) نادیده گرفته خواهند
شد. این امر می‌تواند هنگام انجام ADL از قالبی اعلان‌شده در همان TU تابع درونی رخ دهد:
.Sp
.Vb 6
\&        export module M;
\&        template <typename T> void foo(T t) {
\&          bar(t);
\&        }
\&        struct S {} s;
\&        static void bar(S) {}  // internal linkage
\&        
\&        // instantiating foo(s) from outside this TU can see ::bar,
\&        // but naming it there is ill\-formed.
.Ve
.Sp
می‌توان این مشکل را با وابسته کردن \f(CW\*(C`bar\*(C'\fR به ماژول سراسری، با استفاده از
\f(CW\*(C`extern "C++"\*(C'\fR برطرف کرد.
.Sp
این هشدار به طور پیش‌فرض فعال است و توسط \&\fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wno\-terminate\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-terminate (تنها C++ و Objective-C++)"
هشدار دربارهٔ عبارت پرتابی (throw\-expression) را که فوراً منجر به فراخوانی
\f(CW\*(C`terminate\*(C'\fR می‌شود غیرفعال می‌کند.
.IP "\fB\-Wno\-vexing\-parse\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-vexing-parse (تنها C++ و Objective-C++)"
دربارهٔ ابهام نحوی آزاردهنده‌ترین تجزیه (most vexing parse) هشدار می‌دهد. این گزینه
دربارهٔ مواردی هشدار می‌دهد که در آن‌ها یک اعلان مانند تعریف یک متغیر به نظر می‌رسد،
اما زبان C++ ایجاب می‌کند که به عنوان اعلان تابع تفسیر شود. برای نمونه:
.Sp
.Vb 4
\&        void f(double a) {
\&          int i();        // extern int i (void);
\&          int n(int(a));  // extern int n (int);
\&        }
.Ve
.Sp
نمونه‌ای دیگر:
.Sp
.Vb 6
\&        struct S { S(int); };
\&        void f(double a) {
\&          S x(int(a));   // extern struct S x (int);
\&          S y(int());    // extern struct S y (int (*) (void));
\&          S z();         // extern struct S z (void);
\&        }
.Ve
.Sp
این هشدار گزینه‌هایی را برای چگونگی برخورد با چنین ابهامی پیشنهاد می‌کند؛ برای نمونه،
می‌تواند حذف پرانتزها یا استفاده از آکولاها به جای آن را پیشنهاد دهد.
.Sp
این هشدار به طور پیش‌فرض فعال است.
.IP "\fB\-Wno\-class\-conversion\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-class-conversion (تنها C++ و Objective-C++)"
هنگامی که یک تابع تبدیل شیئی را به همان نوع، به یک کلاس پایه از آن نوع، یا به
void تبدیل می‌کند هشدار نمی‌دهد؛ چنین تابع تبدیلی هرگز فراخوانی نخواهد شد.
.IP "\fB\-Wvolatile\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wvolatile (تنها C++ و Objective-C++)"
دربارهٔ کاربردهای منسوخ‌شدهٔ توصیف‌گر \f(CW\*(C`volatile\*(C'\fR هشدار می‌دهد. این شامل
عبارت‌های پسوندی و پیشوندی \f(CW\*(C`++\*(C'\fR و \f(CW\*(C`\-\-\*(C'\fR از انواع توصیف‌شده با
\&\f(CW\*(C`volatile\*(C'\fR، استفاده از انتساب‌های ساده در جایی که عملوند سمت چپ یک نوع
غیرکلاسیِ توصیف‌شده با \f(CW\*(C`volatile\*(C'\fR برای مقدار آن‌ها است، انتساب‌های مرکب که در
آن‌ها عملوند سمت چپ یک نوع غیرکلاسیِ توصیف‌شده با \f(CW\*(C`volatile\*(C'\fR است، نوع
بازگشتی تابع توصیف‌شده با \f(CW\*(C`volatile\*(C'\fR، نوع پارامتر توصیف‌شده با
\&\f(CW\*(C`volatile\*(C'\fR، و اتصالات ساختاریافته (structured bindings) از یک نوع
توصیف‌شده با \f(CW\*(C`volatile\*(C'\fR می‌شود. این کاربردها در C++20 منسوخ شده‌اند.
.Sp
به طور پیش‌فرض با \fB\-std=c++20\fR فعال می‌شود. پیش از
\&\fB\-std=c++20\fR، به صورت صریح با \fB\-Wdeprecated\fR فعال می‌گردد.
.IP \fB\-Waligned\-new\fR 4
.IX Item "-Waligned-new"
.PD 0
.IP \fB\-Waligned\-new=\fR[\fBnone\fR|\fBglobal\fR|\fBall\fR] 4
.IX Item "-Waligned-new=[none|global|all]"
.PD
دربارهٔ عبارت new از نوعی که به ترازبندی (alignment) بزرگ‌تری نسبت به
\f(CWalignof(std::max_align_t)\fR نیاز دارد اما از یک تابع تخصیص بدون پارامتر
ترازبندی صریح استفاده می‌کند، هشدار می‌دهد. این گزینه توسط \fB\-Wall\fR فعال می‌شود.
.Sp
به طور معمول این گزینه تنها دربارهٔ توابع تخصیص سراسری هشدار می‌دهد، اما
\&\fB\-Waligned\-new=all\fR دربارهٔ توابع تخصیص عضو کلاس نیز هشدار می‌دهد.
.IP \fB\-Wno\-placement\-new\fR 4
.IX Item "-Wno-placement-new"
.PD 0
.IP \fB\-Wplacement\-new=\fR\fIn\fR 4
.IX Item "-Wplacement-new=n".PD
هشدار درباره عبارت‌های placement new با رفتار تعریف‌نشده، مانند
ساخت یک شیء در بافری که از نوع آن شیء کوچک‌تر است. برای مثال،
عبارت placement new زیر تشخیص داده شده و هشدار دریافت می‌کند زیرا تلاش می‌کند
آرایه‌ای از ۶۴ عدد صحیح را در بافری با اندازه تنها ۶۴ بایت بسازد.
.Sp
.Vb 2
\&        char buf [64];
\&        new (buf) int[64];
.Ve
.Sp
این هشدار به‌طور پیش‌فرض فعال است.
.RS 4
.IP \fB\-Wplacement\-new=1\fR 4
.IX Item "-Wplacement-new=1"
این سطح هشدار پیش‌فرض \fB\-Wplacement\-new\fR است. در این
سطح، هشدار برای برخی ساختارهای اکیداً تعریف‌نشده که GCC آن‌ها را به عنوان
افزونه جهت سازگاری با کدهای قدیمی مجاز می‌داند، صادر نمی‌شود. برای مثال،
عبارت \f(CW\*(C`new\*(C'\fR زیر در این سطح تشخیص داده نمی‌شود حتی اگر طبق
استاندارد C++ رفتار تعریف‌نشده داشته باشد، چرا که فراتر از انتهای
آرایه تک‌عنصری می‌نویسد.
.Sp
.Vb 3
\&        struct S { int n, a[1]; };
\&        S *s = (S *)malloc (sizeof *s + 31 * sizeof s\->a[0]);
\&        new (s\->a)int [32]();
.Ve
.IP \fB\-Wplacement\-new=2\fR 4
.IX Item "-Wplacement-new=2"
در این سطح، علاوه بر تشخیص تمام ساختارهای مشابه سطح ۱، هشداری نیز
برای عبارت‌های placement new صادر می‌شود که شیئی را در آخرین عضو
ساختار می‌سازند، در حالی که نوع آن آرایه‌ای تک‌عنصری بوده و اندازه آن
کمتر از اندازه شیء در حال ساخت است. در حالی که مثال قبلی تشخیص داده
می‌شود، ساختار زیر از افزونه آرایه با عضو انعطاف‌پذیر (flexible member array)
برای جلوگیری از هشدار در سطح ۲ استفاده می‌کند.
.Sp
.Vb 3
\&        struct S { int n, a[]; };
\&        S *s = (S *)malloc (sizeof *s + 32 * sizeof s\->a[0]);
\&        new (s\->a)int [32]();
.Ve
.RE
.RS 4
.RE
.IP \fB\-Wcatch\-value\fR 4
.IX Item "-Wcatch-value"
.PD 0
.IP "\fB\-Wcatch\-value=\fR\fIn\fR\fB \fR(فقط C++ و Objective\-C++)" 4
.IX Item "-Wcatch-value=n (C++ and Objective-C++ only)"
.PD
هشدار درباره گرداننده‌های catch که از طریق ارجاع (reference) مقدار را دریافت نمی‌کنند.
با \fB\-Wcatch\-value=1\fR (یا به‌طور خلاصه \fB\-Wcatch\-value\fR)،
درباره انواع کلاس‌های چندریختی که با مقدار (by value) دریافت می‌شوند هشدار می‌دهد.
با \fB\-Wcatch\-value=2\fR درباره تمام انواع کلاس که با مقدار دریافت می‌شوند
هشدار می‌دهد. با \fB\-Wcatch\-value=3\fR درباره تمام انواعی که از طریق ارجاع
دریافت نمی‌شوند هشدار می‌دهد. \fB\-Wcatch\-value\fR توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wconditionally\-supported\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wconditionally-supported (C++ and Objective-C++ only)"
هشدار برای ساختارهای با پشتیبانی مشروط (C++11 [intro.defs]).
.IP "\fB\-Wno\-defaulted\-function\-deleted\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-defaulted-function-deleted (C++ and Objective-C++ only)"
هشدار هنگامی که یک تابع صریحاً پیش‌فرض‌شده (defaulted)، توسط کامپایلر حذف (delete)
می‌شود. این وضعیت می‌تواند زمانی رخ دهد که نوع اعلان‌شده تابع با نوع
تابعی که به‌طور ضمنی اعلان می‌شد مطابقت نداشته باشد. این هشدار
به‌طور پیش‌فرض فعال است.
.IP "\fB\-Wno\-delete\-incomplete\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-delete-incomplete (C++ and Objective-C++ only)"
هنگام delete کردن اشاره‌گری به یک نوع ناکامل (incomplete type)، که ممکن است موجب
رفتار تعریف‌نشده در زمان اجرا شود، هشدار نده. این هشدار به‌طور پیش‌فرض فعال است.
.IP "\fB\-Wextra\-semi\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wextra-semi (C++, Objective-C++ only)"
هشدار درباره نقطه‌ویرگول‌های اضافه. زمینه‌های گوناگونی وجود دارد که یک
نقطه‌ویرگول اضافی ممکن است در آن‌ها رخ دهد. یکی از آن‌ها نقطه‌ویرگول پس از تعاریف تابع درون‌کلاسی
است که در همه گویش‌های C++ معتبر است (و هرگز یک pedwarn محسوب نمی‌شود):
.Sp
.Vb 3
\&        struct S {
\&          void foo () {};
\&        };
.Ve
.Sp
دیگری نقطه‌ویرگول اضافی در محدوده فضای نام (namespace) است که از C++11
مجاز دانسته شده است (بنابراین در C++98 یک pedwarn است):
.Sp
.Vb 3
\&        struct S {
\&        };
\&        ;
.Ve
.Sp
و دیگری نقطه‌ویرگول اضافی درون تعاریف کلاس است که از C++11
مجاز دانسته شده است (بنابراین در C++98 یک pedwarn است):
.Sp
.Vb 4
\&        struct S {
\&          int a;
\&          ;
\&        };
.Ve
.IP "\fB\-Wno\-global\-module\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-global-module (C++ and Objective-C++ only)"
غیرفعال کردن پیام تشخیصی در صورتی که قطعه ماژول سراسری (global module fragment)
یک واحد ماژول، تنها متشکل از دستورات پیش‌پردازنده نباشد.
.IP "\fB\-Wno\-inaccessible\-base\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-inaccessible-base (C++, Objective-C++ only)"
این گزینه هشدارهایی را کنترل می‌کند
که هنگام غیرقابل‌دسترس بودن یک کلاس پایه در کلاسی که به دلیل
ابهام از آن مشتق شده است، صادر می‌شوند. این هشدار به‌طور پیش‌فرض فعال است.
توجه داشته باشید که هشدار برای کلاس‌های پایه مجازی
مبهم توسط گزینه \fB\-Wextra\fR فعال می‌شود.
.Sp
.Vb 1
\&        struct A { int a; };
\&        
\&        struct B : A { };
\&        
\&        struct C : B, A { };
.Ve
.IP \fB\-Wno\-inherited\-variadic\-ctor\fR 4
.IX Item "-Wno-inherited-variadic-ctor"
فرونشاندن هشدارها درباره استفاده از سازنده‌های ارث‌بری‌شده C++11 هنگامی که
کلاس پایه به ارث برده‌شده دارای سازنده با تعداد آرگومان متغیرِ نوع C (C variadic) باشد؛
این هشدار به‌طور پیش‌فرض روشن است زیرا علامت بیضی (...) به ارث برده نمی‌شود.
.IP "\fB\-Wno\-invalid\-offsetof\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-invalid-offsetof (C++ and Objective-C++ only)"
فرونشاندن هشدارها در هنگام اعمال ماکروی \f(CW\*(C`offsetof\*(C'\fR بر روی نوع غیر POD.
مطابق استاندارد ۲۰۱۴ ISO C++، اعمال \f(CW\*(C`offsetof\*(C'\fR بر روی نوعی که
چیدمان غیراستاندارد دارد (non\-standard\-layout) تعریف‌نشده است. با این حال، در
پیاده‌سازی‌های موجود C++، معمولاً \f(CW\*(C`offsetof\*(C'\fR نتایج معناداری ارائه می‌دهد.
این فلگ برای کاربرانی است که آگاهند کدی غیرقابل‌حمل می‌نویسند و عمداً
تصمیم گرفته‌اند هشدار مربوط به آن را نادیده بگیرند.
.Sp
محدودیت‌های مربوط به \f(CW\*(C`offsetof\*(C'\fR ممکن است در نسخه‌های آینده
استاندارد C++ کاهش یابد.
.IP "\fB\-Wsized\-deallocation\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wsized-deallocation (C++ and Objective-C++ only)"
هشدار درباره تعریف یک تابع آزادسازی حافظه بدون اندازه (unsized deallocation)
.Sp
.Vb 2
\&        void operator delete (void *) noexcept;
\&        void operator delete[] (void *) noexcept;
.Ve
.Sp
بدون تعریف تابع آزادسازی متناظر دارای اندازه (sized deallocation)
.Sp
.Vb 2
\&        void operator delete (void *, std::size_t) noexcept;
\&        void operator delete[] (void *, std::size_t) noexcept;
.Ve
.Sp
یا برعکس. توسط \fB\-Wextra\fR به همراه
\&\fB\-fsized\-deallocation\fR فعال می‌شود.
.IP \fB\-Wsuggest\-final\-types\fR 4
.IX Item "-Wsuggest-final-types"
هشدار درباره انواعی با متدهای مجازی که اگر نوع با مشخص‌کننده \f(CW\*(C`final\*(C'\fR
در C++11، یا در صورت امکان در یک فضای نام ناشناس (anonymous namespace)
اعلان می‌شد، کیفیت کد بهبود می‌یافت. این به GCC اجازه می‌دهد تا فراخوانی‌های
چندریختی را با تهاجم بیشتری مجازی‌زدایی (devirtualize) کند. این هشدار در هنگام
بهینه‌سازی زمان پیوند (link\-time optimization) که اطلاعات مربوط به گراف سلسله‌مراتب
کلاس‌ها کامل‌تر است، اثربخشی بیشتری دارد.
.IP \fB\-Wsuggest\-final\-methods\fR 4
.IX Item "-Wsuggest-final-methods"
هشدار درباره متدهای مجازی که اگر متد با مشخص‌کننده \f(CW\*(C`final\*(C'\fR در C++11
اعلان می‌شد، یا در صورت امکان، نوع آن در یک فضای نام ناشناس یا با مشخص‌کننده
\f(CW\*(C`final\*(C'\fR اعلان می‌گردید، کیفیت کد بهبود می‌یافت. این هشدار در هنگام
بهینه‌سازی زمان پیوند که اطلاعات مربوط به گراف سلسله‌مراتب کلاس‌ها کامل‌تر است،
اثربخشی بیشتری دارد. توصیه می‌شود ابتدا پیشنهادهای \fB\-Wsuggest\-final\-types\fR
را بررسی کرده و سپس با نشانه‌گذاری‌های جدید، برنامه را مجدداً بسازید.
.IP \fB\-Wsuggest\-override\fR 4
.IX Item "-Wsuggest-override"
هشدار درباره بازنویسی (override کردن) توابع مجازی که با کلمه
کلیدی \&\f(CW\*(C`override\*(C'\fR نشانه‌گذاری نشده‌اند.
.IP "\fB\-Wno\-conversion\-null\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-conversion-null (C++ and Objective-C++ only)"
برای تبدیل‌های بین \f(CW\*(C`NULL\*(C'\fR و انواع غیر اشاره‌گر
هشدار نده. \fB\-Wconversion\-null\fR به‌طور پیش‌فرض فعال است..SS "گزینه‌های کنترل‌کنندهٔ گویش‌های Objective\-C و Objective\-C++"
.IX Subsection "Options Controlling Objective-C and Objective-C++ Dialects"
(نکته: این راهنما خودِ زبان‌های Objective\-C و Objective\-C++ را شرح نمی‌دهد.)
.PP
این بخش گزینه‌های خط فرمانی را شرح می‌دهد که تنها برای برنامه‌های
Objective\-C و Objective\-C++ معنادار هستند. شما همچنین می‌توانید از
بیشتر گزینه‌های مستقل از زبانِ کامپایلر GNU استفاده کنید.
برای نمونه، ممکن است فایلی مانند \fIsome_class.m\fR را این‌گونه کامپایل کنید:
.PP
.Vb 1
\&        gcc \-g \-fgnu\-runtime \-O \-c some_class.m
.Ve
.PP
در این مثال، \fB\-fgnu\-runtime\fR گزینه‌ای است که تنها برای
برنامه‌های Objective\-C و Objective\-C++ در نظر گرفته شده است؛ می‌توانید
سایر گزینه‌ها را با هر زبانی که توسط GCC پشتیبانی می‌شود استفاده کنید.
.PP
توجه داشته باشید که از آنجا که Objective\-C الحاقیه‌ای از زبان C است،
کامپایل‌های Objective\-C همچنین می‌توانند از گزینه‌های ویژهٔ پیشانهٔ
(front\-end) زبان C استفاده کنند (مانند \&\fB\-Wtraditional\fR). به همین شکل،
کامپایل‌های Objective\-C++ نیز می‌توانند گزینه‌های خاص C++ را به کار گیرند
(مانند \fB\-Wabi\fR).
.PP
در ادامه فهرستی از گزینه‌هایی آمده است که \fIتنها\fR برای کامپایل
برنامه‌های Objective\-C و Objective\-C++ کاربرد دارند:
.IP \fB\-fconstant\-string\-class=\fR\fIclass\-name\fR 4
.IX Item "-fconstant-string-class=class-name"
از \fIclass\-name\fR به عنوان نام کلاسی که باید برای هر رشتهٔ مصرح
(literal string) مشخص‌شده با نحو \f(CW\*(C`@"..."\*(C'\fR نمونه‌سازی شود،
استفاده می‌کند. در صورت استفاده از زمان اجرای GNU، نام کلاس پیش‌فرض
\f(CW\*(C`NXConstantString\*(C'\fR است و اگر از زمان اجرای NeXT استفاده شود،
\&\f(CW\*(C`NSConstantString\*(C'\fR خواهد بود (پایین‌تر را ببینید). در سکوهای
Darwin / macOS، گزینهٔ \fB\-fconstant\-cfstrings\fR، در صورت حضور،
تنظیمات \fB\-fconstant\-string\-class\fR را لغو کرده و سبب می‌شود تا
مقادیر مصرح \&\f(CW\*(C`@"..."\*(C'\fR به عنوان رشته‌های ثابت CoreFoundation
چیده شوند. توجه داشته باشید که \fB\-fconstant\-cfstrings\fR نام مستعاری برای
گزینهٔ معادل و وابسته به هدفِ \&\fB\-mconstant\-cfstrings\fR است.
.IP \fB\-fgnu\-runtime\fR 4
.IX Item "-fgnu-runtime"
تولید کد شیء (object code) سازگار با زمان اجرای استاندارد GNU Objective\-C.
این حالت پیش‌فرض برای اکثر انواع سیستم‌ها است.
.IP \fB\-fnext\-runtime\fR 4
.IX Item "-fnext-runtime"
تولید خروجی سازگار با زمان اجرای NeXT. این پیش‌فرض برای سیستم‌های
مبتنی بر NeXT، از جمله Darwin / macOS است. ماکروی
\&\f(CW\*(C`_\|_NEXT_RUNTIME_\|_\*(C'\fR تعریف می‌شود اگر (و تنها اگر) از این
گزینه استفاده شود.
.IP \fB\-fno\-nil\-receivers\fR 4
.IX Item "-fno-nil-receivers"
فرض می‌کند که تمامی ارسال‌های پیام در Objective\-C (\f(CW\*(C`[receiver
message:arg]\*(C'\fR) در این واحد ترجمه، تضمین می‌کنند که گیرنده
\f(CW\*(C`nil\*(C'\fR نیست. این کار اجازه می‌دهد نقاط ورود کارآمدتری در
زمان اجرا مورد استفاده قرار گیرند. این گزینه تنها در ترکیب با
زمان اجرای NeXT و نسخهٔ 0 یا 1 از ABI در دسترس است.
.IP \fB\-fobjc\-abi\-version=\fR\fIn\fR 4
.IX Item "-fobjc-abi-version=n"
استفاده از نسخهٔ \fIn\fR از ABI مربوط به Objective\-C برای زمان اجرای
انتخاب‌شده. این گزینه در حال حاضر تنها برای زمان اجرای NeXT پشتیبانی
می‌شود. در آن حالت، نسخهٔ 0 همان ABI سنتی (۳۲ بیتی) بدون پشتیبانی از
خصوصیات (properties) و دیگر افزوده‌های Objective\-C 2.0 است. نسخهٔ 1
همان ABI سنتی (۳۲ بیتی) به همراه پشتیبانی از خصوصیات و دیگر افزوده‌های
Objective\-C 2.0 است. نسخهٔ 2 همان ABI مدرن (۶۴ بیتی) است. اگر چیزی
مشخص نشده باشد، پیش‌فرض روی ماشین‌های هدف ۳۲ بیتی، نسخهٔ 0 و روی
ماشین‌های هدف ۶۴ بیتی، نسخهٔ 2 است.
.IP \fB\-fobjc\-call\-cxx\-cdtors\fR 4
.IX Item "-fobjc-call-cxx-cdtors"
برای هر کلاس Objective\-C، بررسی می‌کند که آیا متغیرهای نمونهٔ آن
یک شیء C++ با سازندهٔ پیش‌فرض غیربدیهی (non\-trivial) هستند یا خیر.
در این صورت، یک متد نمونهٔ ویژه به نام \f(CW\*(C`\- (id) .cxx_construct\*(C'\fR
ایجاد می‌کند که سازنده‌های پیش‌فرض غیربدیهی را روی هر یک از این متغیرهای
نمونه، به ترتیب، اجرا کرده و سپس \f(CW\*(C`self\*(C'\fR را بازمی‌گرداند. به همین
ترتیب، بررسی می‌کند که آیا متغیر نمونه‌ای یک شیء C++ با یک مخرب غیربدیهی
است یا خیر، و در این صورت، متد ویژهٔ \f(CW\*(C`\- (void) .cxx_destruct\*(C'\fR
را ایجاد می‌کند که تمام این مخرب‌های پیش‌فرض را به ترتیب معکوس اجرا می‌نماید.
.Sp
متدهای \f(CW\*(C`\- (id) .cxx_construct\*(C'\fR و \f(CW\*(C`\- (void) .cxx_destruct\*(C'\fR
که بدین صورت تولید می‌شوند، فقط روی متغیرهای نمونهٔ اعلان‌شده در کلاس
Objective\-C فعلی عمل می‌کنند، نه متغیرهایی که از ابرکلاس‌ها به ارث رسیده‌اند.
فراخوانی همهٔ این متدها در سلسله‌مراتب ارث‌بری یک شیء بر عهدهٔ زمان اجرای
Objective\-C است. متدهای \f(CW\*(C`\- (id) .cxx_construct\*(C'\fR بلافاصله پس
از تخصیص نمونهٔ شیء جدید توسط زمان اجرا فراخوانی می‌شوند؛ متدهای
\f(CW\*(C`\- (void) .cxx_destruct\*(C'\fR بلافاصله پیش از آزادسازی نمونهٔ شیء
توسط زمان اجرا فراخوانی می‌گردند.
.Sp
تا زمان این نوشته، تنها زمان اجرای NeXT روی Mac OS X 10.4 و جدیدتر از
فراخوانی متدهای \f(CW\*(C`\- (id) .cxx_construct\*(C'\fR و
\&\f(CW\*(C`\- (void) .cxx_destruct\*(C'\fR پشتیبانی دارد.
.IP \fB\-fobjc\-direct\-dispatch\fR 4
.IX Item "-fobjc-direct-dispatch"
اجازه به پرش‌های سریع به ارسال‌کننده پیام (message dispatcher).
در Darwin این کار از طریق comm page انجام می‌شود.
.IP \fB\-fobjc\-exceptions\fR 4
.IX Item "-fobjc-exceptions"
فعال‌سازی پشتیبانی نحوی برای رسیدگی به استثناهای ساختاریافته در
Objective\-C، مشابه آنچه توسط C++ ارائه می‌شود. این گزینه برای
استفاده از کلیدواژه‌های \f(CW@try\fR، \&\f(CW@throw\fR،
\f(CW@catch\fR، \f(CW@finally\fR و \&\f(CW@synchronized\fR در
Objective\-C ضروری است. این گزینه هم با زمان اجرای GNU و هم با
زمان اجرای NeXT قابل استفاده است (اما در ترکیب با زمان اجرای
NeXT روی Mac OS X 10.2 و قبل‌تر در دسترس نیست).
.IP \fB\-fobjc\-gc\fR 4
.IX Item "-fobjc-gc"
فعال کردن زباله‌روبی (GC) در برنامه‌های Objective\-C و Objective\-C++.
این گزینه تنها با زمان اجرای NeXT در دسترس است؛ زمان اجرای GNU
پیاده‌سازی زباله‌روبی متفاوتی دارد که نیازی به پرچم‌های خاص کامپایلر ندارد.
.IP \fB\-fobjc\-nilcheck\fR 4
.IX Item "-fobjc-nilcheck"
برای زمان اجرای NeXT با نسخهٔ 2 از ABI، قبل از انجام فراخوانی واقعی متد،
بررسی می‌کند که آیا گیرنده در فراخوانی‌های متد nil است یا خیر. این حالت
پیش‌فرض است و می‌توان آن را با استفاده از \&\fB\-fno\-objc\-nilcheck\fR
غیرفعال کرد. متدهای کلاس و فراخوانی‌های super، صرف‌نظر از مقدار این پرچم،
هرگز برای nil بدین صورت بررسی نمی‌شوند. در حال حاضر هنگام استفاده از
زمان اجرای GNU یا نسخهٔ قدیمی‌تر ABI زمان اجرای NeXT، این پرچم هیچ اثری ندارد.
.IP \fB\-fobjc\-std=objc1\fR 4
.IX Item "-fobjc-std=objc1"
پیروی از نحو زبان Objective\-C 1.0، زبانی که توسط GCC 4.0 شناسایی
می‌شد. این مورد تنها بر الحاقات Objective\-C به زبان C/C++ اثر می‌گذارد؛
این گزینه تأثیری بر انطباق با استانداردهای C/C++، که توسط پرچم‌های جداگانهٔ
گزینه‌های گویش C/C++ کنترل می‌شوند، ندارد. هنگامی که از این گزینه با
کامپایلر Objective\-C یا Objective\-C++ استفاده شود، هرگونه نحو Objective\-C
که توسط GCC 4.0 شناخته نشود رد می‌شود. این امر زمانی مفید است که بخواهید
اطمینان حاصل کنید کد Objective\-C شما با نسخه‌های قدیمی‌تر GCC قابل کامپایل است.
.IP \fB\-freplace\-objc\-classes\fR 4
.IX Item "-freplace-objc-classes"
صدور یک نشانگر ویژه که به \fBld\|(1)\fR دستور می‌دهد فایل شیء حاصل را به طور
ایستا پیوند نزند و به جای آن به \fBdyld\|(1)\fR اجازه دهد آن را در زمان اجرا
بارگذاری کند. این گزینه در ترکیب با حالت اشکال‌زدایی Fix\-and\-Continue به کار
می‌رود، که در آن فایل شیء مورد نظر ممکن است در جریان اجرای برنامه، بدون نیاز
به راه‌اندازی دوبارهٔ خود برنامه، بازکامپایل شده و به طور پویا بازبارگذاری شود.
در حال حاضر، کارکرد Fix\-and\-Continue تنها در ترکیب با زمان اجرای NeXT روی
Mac OS X 10.3 و جدیدتر در دسترس است.
.IP \fB\-fzero\-link\fR 4
.IX Item "-fzero-link"
هنگام کامپایل برای زمان اجرای NeXT، کامپایلر به طور معمول فراخوانی‌های
\f(CWobjc_getClass("...")\fR را (در حالتی که نام کلاس در زمان کامپایل معلوم است)
با ارجاعات ایستای کلاسی که در زمان بارگذاری مقداردهی اولیه می‌شوند جایگزین
می‌کند، که این امر کارایی زمان اجرا را بهبود می‌بخشد. مشخص کردن پرچم
\fB\-fzero\-link\fR این رفتار را لغو کرده و سبب می‌شود فراخوانی‌های
\f(CWobjc_getClass("...")\fR حفظ شوند. این قابلیت در حالت اشکال‌زدایی
Zero\-Link مفید است، زیرا اجازه می‌دهد پیاده‌سازی‌های کلاس‌های مجزا در طول
اجرای برنامه تغییر داده شوند. زمان اجرای GNU در حال حاضر همیشه و بدون
در نظر گرفتن گزینه‌های خط فرمان، فراخوانی‌های \f(CWobjc_get_class("...")\fR
را حفظ می‌کند.
.IP \fB\-fno\-local\-ivars\fR 4
.IX Item "-fno-local-ivars"
به‌طور پیش‌فرض، متغیرهای نمونه در Objective\-C را می‌توان به‌گونه‌ای که
گویی متغیرهای محلی هستند از درون متدهای کلاسی که در آن اعلان شده‌اند در
دسترس قرار داد. این امر می‌تواند منجر به سایه‌اندازی بین متغیرهای نمونه و
متغیرهای دیگری شود که یا به‌طور محلی درون یک متد کلاس، یا به‌طور سراسری با
همان نام اعلان شده‌اند. مشخص کردن پرچم \fB\-fno\-local\-ivars\fR این رفتار را
غیرفعال کرده و بنابراین از مشکلات سایه‌اندازی متغیرها جلوگیری می‌کند.
.IP \fB\-fivar\-visibility=\fR[\fBpublic\fR|\fBprotected\fR|\fBprivate\fR|\fBpackage\fR] 4
.IX Item "-fivar-visibility=[public|protected|private|package]"
تنظیم میزان پدیداریِ پیش‌فرض متغیر نمونه روی گزینهٔ مشخص‌شده، به‌طوری که
متغیرهای نمونهٔ اعلان‌شده در خارج از حوزهٔ هر دستورِ اصلاح‌گر دسترسی،
به طور پیش‌فرض دارای پدیداریِ مشخص‌شده باشند.
.IP \fB\-gen\-decls\fR 4
.IX Item "-gen-decls"
تخلیهٔ اعلان‌های واسط برای تمام کلاس‌های دیده‌شده در فایل منبع، در
فایلی به نام \fIsourcename.decl\fR.
.IP "\fB\-Wassign\-intercept\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wassign-intercept (Objective-C and Objective-C++ only)"
هشدار در زمانی که یک انتساب Objective\-C توسط زباله‌روب رهگیری می‌شود.
.IP "\fB\-Wno\-property\-assign\-default\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wno-property-assign-default (Objective-C and Objective-C++ only)"
عدم صدور هشدار در صورتی که برای یک خصوصیتِ شیء Objective\-C،
معناشناسیِ انتساب (assign semantics) مشخص نشده باشد.
.IP "\fB\-Wno\-protocol\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wno-protocol (Objective-C and Objective-C++ only)"
اگر کلاسی اعلان کند که یک پروتکل را پیاده‌سازی می‌کند، برای هر متدی در آن
پروتکل که توسط کلاس پیاده‌سازی نشده باشد، یک هشدار صادر می‌شود. رفتار
پیش‌فرض این است که برای هر متدی که صریحاً در کلاس پیاده‌سازی نشده است
هشدار صادر شود، حتی اگر پیاده‌سازی یک متد از ابرکلاس به ارث رسیده باشد.
اگر از گزینهٔ \fB\-Wno\-protocol\fR استفاده کنید، متدهای به ارث رسیده از
ابرکلاس به عنوان پیاده‌سازی‌شده تلقی می‌شوند و هیچ هشداری برای آنها صادر نمی‌شود..IP "\fB\-Wobjc\-root\-class\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wobjc-root-class (Objective-C and Objective-C++ only)"
هشدار می‌دهد اگر یک واسط کلاس فاقد ابرکلاس باشد. برای نمونه، بیشتر کلاس‌ها از \f(CW\*(C`NSObject\*(C'\fR (یا \f(CW\*(C`Object\*(C'\fR) ارث‌بری می‌کنند. هنگام اعلان کلاس‌هایی که قرار است کلاس ریشه باشند، می‌توان با نشانه‌گذاری واسط آن‌ها با \f(CW\*(C`_\|_attribute_\|_((objc_root_class))\*(C'\fR از این هشدار صرف‌نظر کرد.
.IP "\fB\-Wselector\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wselector (Objective-C and Objective-C++ only)"
هشدار می‌دهد اگر در طول همگردانی، چندین متد با نوع‌های متفاوت برای یک سلکتور مشابه یافت شوند. این بررسی روی فهرست متدها در مرحله نهایی همگردانی انجام می‌شود. علاوه بر این، برای هر سلکتوری که در عبارت \f(CW@selector(...)\fR ظاهر شده و متد متناظری برای آن در طول همگردانی یافت شده باشد، بررسی انجام می‌گیرد. از آنجا که این بررسی‌ها جدول متدها را تنها در انتهای همگردانی پیمایش می‌کنند، چنانچه مرحله نهایی همگردانی به دست نیاید (برای نمونه به دلیل بروز خطا حین همگردانی، یا استفاده از گزینه \fB\-fsyntax\-only\fR)، این هشدارها تولید نمی‌شوند.
.IP "\fB\-Wstrict\-selector\-match\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wstrict-selector-match (Objective-C and Objective-C++ only)"
هشدار می‌دهد اگر هنگام ارسال پیام با استفاده از این سلکتور به دریافت‌کننده‌ای از نوع \f(CW\*(C`id\*(C'\fR یا \f(CW\*(C`Class\*(C'\fR، چندین متد با نوع‌های آرگومان و/یا نوع‌های بازگشتی متفاوت برای یک سلکتور مشخص یافت شود. هنگامی که این پرچم خاموش است (که رفتار پیش‌فرض است)، کامپایلر چنانچه هرگونه تفاوت یافت‌شده محدود به نوع‌هایی با اندازه و ترازبندی یکسان باشد، از چنین هشدارهایی چشم‌پوشی می‌کند.
.IP "\fB\-Wundeclared\-selector\fR (فقط Objective\-C و Objective\-C++)" 4
.IX Item "-Wundeclared-selector (Objective-C and Objective-C++ only)"
هشدار می‌دهد اگر عبارت \f(CW@selector(...)\fR به یک سلکتور اعلان‌نشده اشاره کند. یک سلکتور در صورتی اعلان‌نشده در نظر گرفته می‌شود که هیچ متدی با آن نام پیش از عبارت \&\f(CW@selector(...)\fR، چه به‌صورت صریح در یک اعلان \&\f(CW@interface\fR یا \f(CW@protocol\fR، و چه به‌صورت ضمنی در یک بخش \f(CW@implementation\fR، اعلان نشده باشد. این گزینه بررسی‌های خود را همیشه به محض یافتن عبارت \f(CW@selector(...)\fR انجام می‌دهد، در حالی که \fB\-Wselector\fR بررسی‌های خود را تنها در مرحله نهایی همگردانی به انجام می‌رساند. این گزینه همچنین قرارداد سبک کدنویسی مبنی بر اعلان متدها و سلکتورها پیش از استفاده را اعمال می‌کند.
.IP \fB\-print\-objc\-runtime\-info\fR 4
.IX Item "-print-objc-runtime-info"
سرآیند C که بزرگ‌ترین ساختار پاس‌داده‌شده با مقدار را (در صورت وجود) توصیف می‌کند، تولید می‌کند.
.SS "گزینه‌های کنترل OpenMP و OpenACC (Options Controlling OpenMP and OpenACC)"
.IX Subsection "Options Controlling OpenMP and OpenACC"
کامپایلر GCC از افزونه‌های OpenMP برای زبان‌های C، C++‎ و Fortran با استفاده از گزینه \fB\-fopenmp\fR پشتیبانی می‌کند. به طور مشابه، افزونه‌های OpenACC نیز در هر سه زبان با گزینه \fB\-fopenacc\fR پشتیبانی می‌شوند.
.IP \fB\-foffload=disable\fR 4
.IX Item "-foffload=disable"
.PD 0
.IP \fB\-foffload=default\fR 4
.IX Item "-foffload=default"
.IP \fB\-foffload=\fR\fItarget\-list\fR 4
.IX Item "-foffload=target-list"
.PD
مشخص می‌کند که کد برای کدام اهداف برون‌سپاری (offload) در OpenMP و OpenACC باید تولید شود. رفتار پیش‌فرض که معادل \fB\-foffload=default\fR است، تولید کد برای تمامی اهداف برون‌سپاری پشتیبانی‌شده است. حالت \fB\-foffload=disable\fR کد را تنها برای میزبان پشتیبان (host fallback) تولید می‌کند، در حالی که \&\fB\-foffload=\fR\fItarget\-list\fR کد را فقط برای فهرست مشخص‌شده‌ای از اهداف برون‌سپاری که با کاما از هم جدا شده‌اند، تولید می‌نماید.
.Sp
اهداف برون‌سپاری در قالب سه‌گانه هدف (target\-triplet) داخلی GCC مشخص می‌شوند. می‌توانید کامپایلر را با گزینه \fB\-v\fR اجرا کنید تا فهرست اهداف برون‌سپاری پیکربندی‌شده در زیر \f(CW\*(C`OFFLOAD_TARGET_NAMES\*(C'\fR نمایش داده شود.
.IP \fB\-foffload\-options=\fR\fIoptions\fR 4
.IX Item "-foffload-options=options"
.PD 0
.IP \fB\-foffload\-options=\fR\fItarget\-triplet\-list\fR\fB=\fR\fIoptions\fR 4
.IX Item "-foffload-options=target-triplet-list=options"
.PD
با گزینه \fB\-foffload\-options=\fR\fIoptions\fR، کامپایلر GCC گزینه‌های مشخص‌شده در \&\fIoptions\fR را به کامپایلرهای مربوط به تمامی اهداف برون‌سپاری فعال ارسال می‌کند. می‌توان با استفاده از ساختار \fB\-foffload\-options=\fR\fItarget\-list\fR\fB=\fR\fIoptions\fR گزینه‌هایی را مشخص کرد که تنها روی یک هدف یا اهدافی خاص اعمال شوند. بخش \&\fItarget\-list\fR فهرستی جداشده با کاما در همان قالب گزینه \&\fB\-foffload=\fR است.
.Sp
خط‌های فرمان نمونه عبارتند از:
.Sp
.Vb 3
\&        \-foffload\-options=\*(Aq\-fno\-math\-errno \-ffinite\-math\-only\*(Aq \e
\&                \-foffload\-options=nvptx\-none=\-latomic
\&        \-foffload\-options=amdgcn\-amdhsa=\-march=gfx906
.Ve
.IP \fB\-fopenacc\fR 4
.IX Item "-fopenacc"
پردازش دستورالعمل‌های OpenACC شامل \fB#pragma acc\fR در C/C++‎ و \&\fB!$acc\fR در شکل آزاد Fortran و \&\fB!$acc\fR، \fBc$acc\fR و \&\fB*$acc\fR در شکل ثابت Fortran را فعال می‌کند. این گزینه مستلزم \fB\-pthread\fR است، بنابراین تنها روی مقصدهایی پشتیبانی می‌شود که از \fB\-pthread\fR پشتیبانی می‌کنند.
.IP \fB\-fopenacc\-dim=\fR\fIgeom\fR 4
.IX Item "-fopenacc-dim=geom"
ابعاد محاسباتی پیش‌فرض را برای نواحی برون‌سپاری موازی که صریحاً آن‌ها را تعیین نکرده‌اند، مشخص می‌کند. مقدار \fIgeom\fR سه‌گانه‌ای از اندازه‌های جداشده با \fB:\fR به ترتیب \fIgang\fR، \fIworker\fR و \fIvector\fR است. می‌توان یک اندازه را حذف کرد تا از مقدار پیش‌فرض مختص مقصد استفاده شود.
.IP \fB\-fopenmp\fR 4
.IX Item "-fopenmp"
پردازش دستورالعمل‌های OpenMP شامل \fB#pragma omp\fR، \&\fB[[omp::decl(...)]]\fR، \fB[[omp::directive(...)]]\fR و \fB[[omp::sequence(...)]]\fR در C/C++‎ را فعال می‌کند. در Fortran، گزینه \&\fB!$omp\fR و نشانگر همگردانی شرطی \fB!$\fR را فعال می‌کند. در کد مبدأ با قالب ثابت Fortran، نشانگرها همچنین می‌توانند با \&\fBc\fR یا \fB*\fR آغاز شوند.
.Sp
این گزینه متضمن \fB\-pthread\fR است، بنابراین فقط روی مقصدهایی که از \fB\-pthread\fR پشتیبانی دارند، کار می‌کند. همچنین \fB\-fopenmp\fR متضمن \fB\-fopenmp\-simd\fR است.
.IP \fB\-fopenmp\-simd\fR 4
.IX Item "-fopenmp-simd"
پردازش دستورالعمل‌های \f(CW\*(C`simd\*(C'\fR، \f(CW\*(C`declare simd\*(C'\fR، \&\f(CW\*(C`declare reduction\*(C'\fR، \f(CW\*(C`assume\*(C'\fR، \f(CW\*(C`ordered\*(C'\fR، \f(CW\*(C`scan\*(C'\fR و \f(CW\*(C`loop\*(C'\fR از OpenMP، و دستورالعمل‌های ترکیبی یا چندگانه با جزء \&\f(CW\*(C`simd\*(C'\fR را با \f(CW\*(C`#pragma omp\*(C'\fR، \&\f(CW\*(C`[[omp::directive(...)]]\*(C'\fR، \f(CW\*(C`[[omp::sequence(...)]]\*(C'\fR و \&\f(CW\*(C`[[omp::decl(...)]]\*(C'\fR در C/C++‎ و \f(CW\*(C`!$omp\*(C'\fR در Fortran فعال می‌کند. همچنین نشانگر همگردانی شرطی \fB!$\fR را در Fortran فعال می‌سازد. در کد مبدأ با قالب ثابت Fortran، نشانگرها می‌توانند با \&\fBc\fR یا \fB*\fR نیز شروع شوند. سایر دستورالعمل‌های OpenMP نادیده گرفته می‌شوند. مگر اینکه \fB\-fopenmp\fR نیز افزون بر آن مشخص شده باشد، ناحیه \f(CW\*(C`loop\*(C'\fR بدون توجه به بند \f(CW\*(C`bind\*(C'\fR تعیین‌شده، به ناحیه وظیفه جاری پیوند می‌خورد.
.IP \fB\-fopenmp\-target\-simd\-clone\fR 4
.IX Item "-fopenmp-target-simd-clone"
.PD 0
.IP \fB\-fopenmp\-target\-simd\-clone=\fR\fIdevice\-type\fR 4
.IX Item "-fopenmp-target-simd-clone=device-type"
.PD
علاوه بر ایجاد کلون‌های SIMD برای توابع نشانه‌گذاری‌شده با دستورالعمل \&\f(CW\*(C`declare simd\*(C'\fR، کامپایلر GCC هنگام فعال بودن این گزینه، برای توابع نشانه‌گذاری‌شده با دستورالعمل OpenMP به نام \f(CW\*(C`declare target\*(C'\fR که برای برداری‌سازی مناسب هستند نیز کلون ایجاد می‌کند. مقدار \&\fIdevice\-type\fR می‌تواند یکی از مقادیر \f(CW\*(C`none\*(C'\fR، \f(CW\*(C`host\*(C'\fR، \f(CW\*(C`nohost\*(C'\fR و \f(CW\*(C`any\*(C'\fR باشد که با کلیدواژه‌های بند \f(CW\*(C`device_type\*(C'\fR در دستورالعمل \f(CW\*(C`declare target\*(C'\fR مطابقت دارند؛ کلون‌ها برای اشتراک دستگاه‌های مشخص‌شده ایجاد می‌شوند. گزینه \&\fB\-fopenmp\-target\-simd\-clone\fR معادل با \&\fB\-fopenmp\-target\-simd\-clone=any\fR و \&\fB\-fno\-openmp\-target\-simd\-clone\fR معادل با \&\fB\-fopenmp\-target\-simd\-clone=none\fR است.
.Sp
در سطح بهینه‌سازی \fB\-O2\fR و بالاتر (به جز \fB\-Os\fR یا \fB\-Og\fR) این بهینه‌سازی به‌طور پیش‌فرض به \fB\-fopenmp\-target\-simd\-clone=nohost\fR تنظیم می‌شود؛ در غیر این صورت، به‌طور پیش‌فرض غیرفعال است..SS "گزینه‌های کنترل قالب‌بندی پیام‌های عیب‌یابی (Options to Control Diagnostic Messages Formatting)"
.IX Subsection "Options to Control Diagnostic Messages Formatting"
به‌طور سنتی، پیام‌های عیب‌یابی بدون در نظر گرفتن ویژگی‌های دستگاه خروجی (مانند عرض آن و...) قالب‌بندی شده‌اند. می‌توانید از گزینه‌هایی که در ادامه شرح داده شده‌اند برای کنترل الگوریتم قالب‌بندی پیام‌های عیب‌یابی استفاده کنید، مانند تعداد نویسه‌ها در هر خط یا بسامد گزارش اطلاعات مکان در کد مبدأ. توجه داشته باشید که ممکن است برخی از فرانت‌اند‌های زبان‌ها این گزینه‌ها را رعایت نکنند.
.IP \fB\-fmessage\-length=\fR\fIn\fR 4
.IX Item "-fmessage-length=n"
تلاش می‌کند پیام‌های خطا را به‌گونه‌ای قالب‌بندی کند که در خطوطی با حدود \&\fIn\fR نویسه جای گیرند. اگر \&\fIn\fR صفر باشد، هیچ شکستن خطی انجام نمی‌شود؛ هر پیام خطا در یک خط واحد ظاهر خواهد شد. این مقدار پیش‌فرض برای تمام فرانت‌اندها است.
.Sp
نکته \- این گزینه همچنین بر نمایش دستورالعمل‌های پیش‌پردازندهٔ \fB#error\fR و \&\fB#warning\fR، و صفت منسوخ‌شدهٔ \fBdeprecated\fR برای توابع/انواع/متغیرها تأثیر می‌گذارد. با این حال، بر پراگماهای \&\fBpragma GCC warning\fR و \fBpragma GCC error\fR تأثیری ندارد.
.IP \fB\-fdiagnostics\-plain\-output\fR 4
.IX Item "-fdiagnostics-plain-output"
این گزینه درخواست می‌کند که خروجی عیب‌یابی تا جای ممکن ساده و بی‌آلایش به نظر برسد؛ این امر ممکن است هنگام اجرای \fBdejagnu\fR یا ابزارهای دیگری که باید خروجی عیب‌یابی را تجزیه کنند و ترجیح می‌دهند این خروجی در گذر زمان پایدار بماند، مفید باشد.
\&\fB\-fdiagnostics\-plain\-output\fR در حال حاضر معادل گزینه‌های زیر است:
\&\fB\-fno\-diagnostics\-show\-caret
\&\-fno\-diagnostics\-show\-line\-numbers
\&\-fdiagnostics\-color=never
\&\-fdiagnostics\-urls=never
\&\-fdiagnostics\-path\-format=separate\-events
\&\-fdiagnostics\-text\-art\-charset=none
\&\-fno\-diagnostics\-show\-event\-links
\&\-fno\-diagnostics\-show\-nesting\fR
در آینده، اگر GCC ظاهر پیش‌فرض خروجی عیب‌یابی خود را تغییر دهد، گزینهٔ متناظر برای غیرفعال کردن رفتار جدید به این فهرست افزوده خواهد شد.
.IP \fB\-fdiagnostics\-show\-location=once\fR 4
.IX Item "-fdiagnostics-show-location=once"
تنها در حالت شکستن خط معنی‌دار است. به گزارشگر پیام‌های عیب‌یابی دستور می‌دهد که اطلاعات مکان در مبدأ را \fIیک بار\fR منتشر کند؛ یعنی در صورتی که پیام برای قرار گرفتن در یک خط فیزیکی بیش از حد طولانی باشد و شکسته شود، اطلاعات مکان در مبدأ دوباره (به‌عنوان پیشوند) و مکرراً در خطوط ادامه‌دار بعدی چاپ نخواهد شد. این رفتار پیش‌فرض است.
.IP \fB\-fdiagnostics\-show\-location=every\-line\fR 4
.IX Item "-fdiagnostics-show-location=every-line"
تنها در حالت شکستن خط معنی‌دار است. به گزارشگر پیام‌های عیب‌یابی دستور می‌دهد که همان اطلاعات مکان در مبدأ را (به‌عنوان پیشوند) برای خطوط فیزیکی حاصل از شکستن پیامی که در یک خط جا نشده است، منتشر کند.
.IP \fB\-fdiagnostics\-color[=\fR\fIWHEN\fR\fB]\fR 4
.IX Item "-fdiagnostics-color[=WHEN]"
.PD 0
.IP \fB\-fno\-diagnostics\-color\fR 4
.IX Item "-fno-diagnostics-color"
.PD
استفاده از رنگ در پیام‌های عیب‌یابی. مقدار \fIWHEN\fR می‌تواند \fBnever\fR، \fBalways\fR یا \fBauto\fR باشد. مقدار پیش‌فرض بستگی به نحوهٔ پیکربندی کامپایلر دارد؛ می‌تواند هر یک از گزینه‌های \fIWHEN\fR بالا باشد، یا اگر متغیر محیطی \fBGCC_COLORS\fR در محیط وجود نداشته باشد، برابر با \fBnever\fR، و در غیر این صورت \fBauto\fR باشد.
\&\fBauto\fR باعث می‌شود GCC تنها زمانی از رنگ استفاده کند که خروجی خطای استاندارد به یک پایانه متصل باشد، و در یک پوستهٔ emacs اجرا نشود.
صورت‌های \fB\-fdiagnostics\-color\fR و \fB\-fno\-diagnostics\-color\fR به‌ترتیب نام‌های مستعار برای \fB\-fdiagnostics\-color=always\fR و \&\fB\-fdiagnostics\-color=never\fR هستند.
.Sp
رنگ‌ها توسط متغیر محیطی \fBGCC_COLORS\fR تعریف می‌شوند. مقدار آن فهرستی از قابلیت‌ها و زیررشته‌های Select Graphic Rendition (SGR) است که با دو‌نقطه از هم جدا شده‌اند. دستورات SGR توسط پایانه یا شبیه‌ساز پایانه تفسیر می‌شوند. (برای مقادیر مجاز و معانی آن‌ها به‌عنوان صفت‌های نویسه، بخش مربوطه در مستندات پایانهٔ متنی خود را ببینید.) این مقادیر زیررشته، اعدادی صحیح در نمایش ده‌دهی هستند و می‌توانند با نقطه‌ویرگول ترکیب شوند.
مقادیر متداول برای ترکیب عبارتند از:
\&\fB1\fR برای پررنگ (bold)،
\&\fB4\fR برای زیرخط (underline)،
\&\fB5\fR برای چشمک‌زن (blink)،
\&\fB7\fR برای نگاتیو/معکوس (inverse)،
\&\fB39\fR برای رنگ پیش‌فرض پیش‌زمینه،
\&\fB30\fR تا \fB37\fR برای رنگ‌های پیش‌زمینه،
\&\fB90\fR تا \fB97\fR برای رنگ‌های پیش‌زمینه در حالت ۱۶ رنگ،
\&\fB38;5;0\fR تا \fB38;5;255\fR
برای رنگ‌های پیش‌زمینه در حالت‌های ۸۸ رنگ و ۲۵۶ رنگ،
\&\fB49\fR برای رنگ پیش‌فرض پس‌زمینه،
\&\fB40\fR تا \fB47\fR برای رنگ‌های پس‌زمینه،
\&\fB100\fR تا \fB107\fR برای رنگ‌های پس‌زمینه در حالت ۱۶ رنگ،
و \fB48;5;0\fR تا \fB48;5;255\fR
برای رنگ‌های پس‌زمینه در حالت‌های ۸۸ رنگ و ۲۵۶ رنگ.
.Sp
مقدار پیش‌فرض \fBGCC_COLORS\fR برابر است با:
.Sp
.Vb 5
\&        error=01;31:warning=01;35:note=01;36:range1=32:range2=34:locus=01:\e
\&        quote=01:path=01;36:fixit\-insert=32:fixit\-delete=31:\e
\&        diff\-filename=01:diff\-hunk=32:diff\-delete=31:diff\-insert=32:\e
\&        type\-diff=01;32:fnname=01;32:targs=35:valid=01;31:invalid=01;32\e
\&        highlight\-a=01;32:highlight\-b=01;34
.Ve
.Sp
که در آن \fB01;31\fR قرمز پررنگ، \fB01;35\fR سرخابی پررنگ،
\&\fB01;36\fR فیروزه‌ای پررنگ، \fB32\fR سبز، \fB34\fR آبی،
\&\fB01\fR پررنگ، و \fB31\fR قرمز است.
تنظیم \fBGCC_COLORS\fR روی یک رشتهٔ خالی رنگ‌ها را غیرفعال می‌کند.
قابلیت‌های پشتیبانی‌شده به شرح زیر هستند:
.RS 4
.ie n .IP """error=""" 4
.el .IP \f(CWerror=\fR 4
.IX Item "error="
زیررشتهٔ SGR برای نشانگرهای :error.
.ie n .IP """warning=""" 4
.el .IP \f(CWwarning=\fR 4
.IX Item "warning="
زیررشتهٔ SGR برای نشانگرهای :warning.
.ie n .IP """note=""" 4
.el .IP \f(CWnote=\fR 4
.IX Item "note="
زیررشتهٔ SGR برای نشانگرهای :note.
.ie n .IP """path=""" 4
.el .IP \f(CWpath=\fR 4
.IX Item "path="
زیررشتهٔ SGR برای رنگ‌آمیزی مسیرهای رویدادهای جریان کنترل آن‌طور که توسط \fB\-fdiagnostics\-path\-format=\fR چاپ می‌شوند، مانند شناسه‌های رویدادهای مجزا و خطوط نشان‌دهندهٔ فراخوانی‌ها و بازگشت‌های بین‌رویه‌ای.
.ie n .IP """range1=""" 4
.el .IP \f(CWrange1=\fR 4
.IX Item "range1="
زیررشتهٔ SGR برای نخستین محدودهٔ اضافی.
.ie n .IP """range2=""" 4
.el .IP \f(CWrange2=\fR 4
.IX Item "range2="
زیررشتهٔ SGR برای دومین محدودهٔ اضافی.
.ie n .IP """locus=""" 4
.el .IP \f(CWlocus=\fR 4
.IX Item "locus="
زیررشتهٔ SGR برای اطلاعات مکان، \&\fBfile:line\fR یا \&\fBfile:line:column\fR و غیره.
.ie n .IP """quote=""" 4
.el .IP \f(CWquote=\fR 4
.IX Item "quote="
زیررشتهٔ SGR برای اطلاعاتی که درون گیومه چاپ می‌شوند.
.ie n .IP """fnname=""" 4
.el .IP \f(CWfnname=\fR 4
.IX Item "fnname="
زیررشتهٔ SGR برای نام توابع ++C.
.ie n .IP """targs=""" 4
.el .IP \f(CWtargs=\fR 4
.IX Item "targs="
زیررشتهٔ SGR برای مقیدسازی پارامترهای الگوی توابع ++C.
.ie n .IP """fixit\-insert=""" 4
.el .IP \f(CWfixit\-insert=\fR 4
.IX Item "fixit-insert="
زیررشتهٔ SGR برای راهنمایی‌های fix\-it که متن پیشنهادی برای درج یا جایگزینی را مشخص می‌کنند.
.ie n .IP """fixit\-delete=""" 4
.el .IP \f(CWfixit\-delete=\fR 4
.IX Item "fixit-delete="
زیررشتهٔ SGR برای راهنمایی‌های fix\-it که متن پیشنهادی برای حذف را مشخص می‌کنند.
.ie n .IP """diff\-filename=""" 4
.el .IP \f(CWdiff\-filename=\fR 4
.IX Item "diff-filename="
زیررشتهٔ SGR برای سرایندهای نام فایل درون وصله‌های تولیدشده.
.ie n .IP """diff\-hunk=""" 4
.el .IP \f(CWdiff\-hunk=\fR 4
.IX Item "diff-hunk="
زیررشتهٔ SGR برای آغاز قطعه‌ها (hunkها) درون وصله‌های تولیدشده.
.ie n .IP """diff\-delete=""" 4
.el .IP \f(CWdiff\-delete=\fR 4
.IX Item "diff-delete="
زیررشتهٔ SGR برای خطوط حذف‌شده درون وصله‌های تولیدشده.
.ie n .IP """diff\-insert=""" 4
.el .IP \f(CWdiff\-insert=\fR 4
.IX Item "diff-insert="
زیررشتهٔ SGR برای خطوط درج‌شده درون وصله‌های تولیدشده.
.ie n .IP """type\-diff=""" 4
.el .IP \f(CWtype\-diff=\fR 4
.IX Item "type-diff="
زیررشتهٔ SGR برای برجسته‌سازی انواع ناهمخوان درون آرگومان‌های الگو در فرانت‌اند ++C.
.ie n .IP """valid=""" 4
.el .IP \f(CWvalid=\fR 4
.IX Item "valid="
زیررشتهٔ SGR برای برجسته‌سازی عناصر معتبر درون دیاگرام‌های هنر متنی (text art).
.ie n .IP """invalid=""" 4
.el .IP \f(CWinvalid=\fR 4
.IX Item "invalid="
زیررشتهٔ SGR برای برجسته‌سازی عناصر نامعتبر درون دیاگرام‌های هنر متنی.
.ie n .IP """highlight\-a=""" 4
.el .IP \f(CWhighlight\-a=\fR 4
.IX Item "highlight-a=".PD 0
.ie n .IP """highlight\-b=""" 4
.el .IP \f(CWhighlight\-b=\fR 4
.IX Item "highlight-b="
.PD
زیررشته‌های SGR برای ایجاد تمایز میان دو چیز متفاوت درون پیام‌های تشخیصی،
مانند یک جفت از نوع‌های ناهماهنگ.
بخش \fB\-fdiagnostics\-show\-highlight\-colors\fR را ببینید.
.RE
.RS 4
.RE
.IP \fB\-fdiagnostics\-urls[=\fR\fIWHEN\fR\fB]\fR 4
.IX Item "-fdiagnostics-urls[=WHEN]"
استفاده از توالی‌های گریز (escape sequences) برای جاسازی پیوندها (URLها) در پیام‌های تشخیصی. برای نمونه، هنگامی که
\&\fB\-fdiagnostics\-show\-option\fR متنی را منتشر می‌کند که گزینه خط فرمانی
کنترل‌کننده پیام تشخیصی را نشان می‌دهد، یک پیوند برای مستندات آن گزینه
جاسازی می‌شود.
.Sp
مقدار \&\fIWHEN\fR برابر با \fBnever\fR، \fBalways\fR یا \fBauto\fR است.
مقدار \&\fBauto\fR باعث می‌شود GCC تنها زمانی از توالی‌های گریز URL استفاده کند که خروجی خطای استاندارد
یک ترمینال باشد، و در یک پوسته emacs یا هر ترمینال گرافیکی که
ناسازگاری آن با این قابلیت شناخته شده است اجرا نشود؛ توضیحات زیر را ببینید.
.Sp
مقدار پیش‌فرض بستگی به نحوه پیکربندی کامپایلر دارد.
می‌تواند هر یک از مقدارهای \fIWHEN\fR در بالا باشد.
.Sp
همچنین می‌توان GCC را (از طریق گزینه زمان پیکربندی
\&\fB\-\-with\-diagnostics\-urls=auto\-if\-env\fR)
به‌گونه‌ای پیکربندی کرد که مقدار پیش‌فرض تحت تأثیر متغیرهای محیطی قرار گیرد.
تحت چنین پیکربندی، چنانچه هر یک از متغیرهای محیطی \fBGCC_URLS\fR یا \fBTERM_URLS\fR
در محیط کامپایلر وجود داشته و غیرخالی باشند، مقدار پیش‌فرض GCC به \fBauto\fR تغییر می‌کند،
یا در صورتی که هیچ‌کدام وجود نداشته باشند به \fBnever\fR تبدیل می‌شود.
.Sp
با این حال، حتی با \fB\-fdiagnostics\-urls=always\fR نیز این رفتار
وابسته به متغیرهای محیطی یادشده است:
اگر \fBGCC_URLS\fR روی مقدار خالی یا \fBno\fR تنظیم شده باشد، پیوندهای URL در پیام‌های تشخیصی
جاسازی نمی‌شوند. اگر روی \fBst\fR تنظیم شود، پیوندها از توالی‌های گریز ST استفاده می‌کنند.
اگر روی \fBbel\fR (پیش‌فرض) تنظیم شود، پیوندها از توالی‌های گریز BEL استفاده می‌کنند.
هر مقدار غیرخالی دیگری این قابلیت را فعال می‌کند.
اگر \fBGCC_URLS\fR تنظیم نشده باشد، از \fBTERM_URLS\fR به‌عنوان جایگزین استفاده می‌شود.
نکته: ST یک توالی گریز ANSI، یعنی پایان‌دهنده رشته \fBESC \e\fR است؛
BEL یک نویسه ASCII یعنی CTRL\-G است که معمولاً صدایی مانند بوق (beep) ایجاد می‌کند.
.Sp
در حال حاضر GCC تلاش می‌کند چند ترمینال را نیز شناسایی کند که مشخص شده
قابلیت URL را پیاده‌سازی نکرده‌اند و دارای باگ هستند یا دست‌کم در برخی نسخه‌هایی
که هنوز استفاده می‌شوند باگ داشته‌اند؛ به‌گونه‌ای که احتمال می‌رود توالی‌های گریز URL در آن‌ها
رفتار نادرستی نشان دهند، یعنی نویسه‌های نامفهوم روی صفحه نمایش چاپ کنند.
این فهرست در حال حاضر شامل xfce4\-terminal، برخی نسخه‌های gnome\-terminal که باگ آن‌ها
شناخته شده است، کنسول لینوکس (linux console) و mingw است.
این بررسی را می‌توان با \fB\-fdiagnostics\-urls=always\fR نادیده گرفت.
.IP \fB\-fno\-diagnostics\-show\-option\fR 4
.IX Item "-fno-diagnostics-show-option"
به‌طور پیش‌فرض، هر پیام تشخیصی منتشرشده شامل متنی است که گزینه خط فرمانی
کنترل‌کننده مستقیم آن پیام تشخیصی را نشان می‌دهد (در صورتی که چنین گزینه‌ای
برای سازوکار تشخیص خطا شناخته شده باشد). مشخص کردن پرچم
\&\fB\-fno\-diagnostics\-show\-option\fR این رفتار را متوقف می‌کند.
.IP \fB\-fno\-diagnostics\-show\-caret\fR 4
.IX Item "-fno-diagnostics-show-caret"
به‌طور پیش‌فرض، هر پیام تشخیصی منتشرشده شامل خط اصلی سورس‌کد و
یک علامت هشتک (caret) \fB^\fR برای نشان دادن ستون است. این گزینه این اطلاعات را
حذف می‌کند. چنانچه گزینه \fB\-fmessage\-length=n\fR مشخص شده باشد،
خط منبع به \fIn\fR نویسه بریده می‌شود. هنگامی که خروجی به ترمینال فرستاده می‌شود،
عرض خط به عرض داده‌شده توسط متغیر محیطی \&\fBCOLUMNS\fR، یا در صورت تنظیم نشدن، به عرض ترمینال محدود می‌شود.
.IP \fB\-fno\-diagnostics\-show\-labels\fR 4
.IX Item "-fno-diagnostics-show-labels"
به‌طور پیش‌فرض، هنگام چاپ سورس‌کد (از طریق \fB\-fdiagnostics\-show\-caret\fR)،
پیام‌های تشخیصی می‌توانند محدوده‌هایی از کد منبع را با اطلاعات مرتبط برچسب‌گذاری کنند، مانند
نوع عبارت‌ها:
.Sp
.Vb 4
\&            printf ("foo %s bar", long_i + long_j);
\&                         ~^       ~~~~~~~~~~~~~~~
\&                          |              |
\&                          char *         long int
.Ve
.Sp
این گزینه از چاپ این برچسب‌ها جلوگیری می‌کند (در مثال بالا،
خط‌های عمودی و متن‌های "char *" و "long int").
.IP \fB\-fno\-diagnostics\-show\-event\-links\fR 4
.IX Item "-fno-diagnostics-show-event-links"
به‌طور پیش‌فرض، هنگام چاپ مسیرهای اجرا (از طریق
\&\fB\-fdiagnostics\-path\-format=inline\-events\fR)، GCC خطوطی را برای
متصل کردن رویدادهای مرتبط چاپ می‌کند، مانند خطی که رویدادهای ۱ و ۲ را در نمونه زیر به هم پیوند می‌دهد:
.Sp
.Vb 10
\&            3 |   if (p)
\&              |       ^
\&              |       |
\&              |       (1) following \`false\*(Aq branch (when \`p\*(Aq is NULL)... \->\-+
\&              |                                                             |
\&              |                                                             |
\&              |+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
\&            4 ||    return 0;
\&            5 ||  return *p;
\&              ||         ~
\&              ||         |
\&              |+\-\-\-\-\-\-\-\->(2) ...to here
\&              |          (3) dereference of NULL \`p\*(Aq
.Ve
.Sp
این گزینه چاپ چنین خطوط اتصال‌دهنده‌ای را متوقف می‌کند.
.IP \fB\-fno\-diagnostics\-show\-cwe\fR 4
.IX Item "-fno-diagnostics-show-cwe"
پیام‌های تشخیصی می‌توانند به صورت اختیاری یک شناسه مرتبط با
CWE (\f(CW\*(C`https://cwe.mitre.org/index.html\*(C'\fR) داشته باشند.
خود GCC این فراداده را تنها برای برخی از پیام‌های تشخیصی \fB\-fanalyzer\fR
ارائه می‌دهد. همچنین افزایه‌های GCC نیز ممکن است پیام‌های تشخیصی همراه با چنین فراداده‌ای ارائه دهند.
به‌طور پیش‌فرض، اگر این اطلاعات موجود باشد، همراه با پیام تشخیصی چاپ خواهد شد.
این گزینه از چاپ این فراداده جلوگیری می‌کند.
.IP \fB\-fno\-diagnostics\-show\-rules\fR 4
.IX Item "-fno-diagnostics-show-rules"
پیام‌های تشخیصی می‌توانند به‌طور اختیاری قواعدی وابسته به خود داشته باشند، مانند
قواعدی برگرفته از یک استاندارد کدنویسی یا یک مشخصات فنی.
خود GCC این کار را برای هیچ‌یک از پیام‌های تشخیصی خود انجام نمی‌دهد، اما افزایه‌ها ممکن است چنین کنند.
به‌طور پیش‌فرض، چنانچه این اطلاعات موجود باشد، همراه با پیام تشخیصی چاپ خواهد شد.
این گزینه چاپ این فراداده را متوقف می‌کند.
.IP \fB\-fno\-diagnostics\-show\-highlight\-colors\fR 4
.IX Item "-fno-diagnostics-show-highlight-colors"
کامپایلر GCC می‌تواند هنگام چاپ پیام‌های تشخیصی و نقل کد منبع کاربر،
از رنگ‌ها برای تأکید و ایجاد تمایز استفاده کند.
.Sp
برای نمونه، در:
.Sp
.Vb 7
\&        demo.c: In function \`test_bad_format_string_args\*(Aq:
\&        ../../src/demo.c:25:18: warning: format \`%i\*(Aq expects argument of type \`int\*(Aq, but argument 2 has type \`const char *\*(Aq [\-Wformat=]
\&           25 |   printf("hello %i", msg);
\&              |                 ~^   ~~~
\&              |                  |   |
\&              |                  int const char *
\&              |                 %s
.Ve
.RS 4
.IP * 4
عبارت‌های \f(CW%i\fR و \f(CW\*(C`int\*(C'\fR در پیام و \f(CW\*(C`int\*(C'\fR در کد منبع
نقل‌شده، با استفاده از \f(CW\*(C`highlight\-a\*(C'\fR (به‌طور پیش‌فرض سبز برجسته) رنگ‌آمیزی می‌شوند،
و
.IP * 4
عبارت‌های \f(CW\*(C`const char *\*(C'\fR در پیام و در کد منبع نقل‌شده، هر دو
با استفاده از \f(CW\*(C`highlight\-b\*(C'\fR (به‌طور پیش‌فرض آبی برجسته) رنگ‌آمیزی می‌شوند.
.RE
.RS 4
.Sp
هدف از این کار جلب نگاه خواننده به روابط میان جنبه‌های مختلف
پیام تشخیصی و کد منبع است، با بهره‌گیری از رنگ برای گروه‌بندی عناصر مرتبط
و متمایز ساختن موارد ناهمخوان.
.Sp
این رنگ‌آمیزی اضافی در صورتی که چاپ رنگی فعال باشد (مطابق با \fB\-fdiagnostics\-color=\fR)
به‌طور پیش‌فرض فعال است، اما می‌توان آن را به‌طور جداگانه از طریق \fB\-fno\-diagnostics\-show\-highlight\-colors\fR
غیرفعال کرد.
.RE
.IP \fB\-fno\-diagnostics\-show\-line\-numbers\fR 4
.IX Item "-fno-diagnostics-show-line-numbers"
به‌طور پیش‌فرض، هنگام چاپ سورس‌کد (از طریق \fB\-fdiagnostics\-show\-caret\fR)،
حاشیه سمت چپی چاپ می‌شود که شماره خطوط را نشان می‌دهد. این گزینه این
حاشیه سمت چپ را حذف می‌کند.
.IP \fB\-fdiagnostics\-minimum\-margin\-width=\fR\fIwidth\fR 4
.IX Item "-fdiagnostics-minimum-margin-width=width"
این گزینه کمینه عرض حاشیه سمت چپ چاپ‌شده توسط
\&\fB\-fdiagnostics\-show\-line\-numbers\fR را کنترل می‌کند. مقدار پیش‌فرض آن 6 است.
.IP \fB\-fdiagnostics\-show\-context[=\fR\fIdepth\fR\fB]\fR 4
.IX Item "-fdiagnostics-show-context[=depth]"
.PD 0
.IP \fB\-fno\-diagnostics\-show\-context\fR 4
.IX Item "-fno-diagnostics-show-context"
.PD
با این گزینه، کامپایلر ممکن است زنجیره جریان کنترل مهمی را که محافظ
بلوک پایه دستور دارای هشدار است، چاپ کند.
\&\fIdepth\fR حداکثر عمق زنجیره جریان کنترل است.
در حال حاضر، فهرست گزینه‌های هشدار متأثر شامل این موارد است:
\&\fB\-Warray\-bounds\fR، \fB\-Wstringop\-overflow\fR،
\&\fB\-Wstringop\-overread\fR، \fB\-Wstringop\-truncation\fR
و \fB\-Wrestrict\fR.
ممکن است گزینه‌های هشدار بیشتری در نگارش‌های آینده به این فهرست افزوده شوند.
شکل‌های \fB\-fdiagnostics\-show\-context\fR و
\&\fB\-fno\-diagnostics\-show\-context\fR به ترتیب نام‌های مستعار برای
\&\fB\-fdiagnostics\-show\-context=1\fR و
\&\fB\-fdiagnostics\-show\-context=0\fR هستند..IP \fB\-fdiagnostics\-parseable\-fixits\fR 4
.IX Item "-fdiagnostics-parseable-fixits"
راهنماهای اصلاح (fix\-it hints) را در قالبی با قابلیت تجزیه توسط ماشین که برای استفاده در محیط‌های توسعه (IDE) مناسب است صادر می‌کند. برای هر اصلاح، خطی پس از پیام تشخیصِ مربوطه چاپ خواهد شد که با رشته‌ی "fix\-it:" آغاز می‌شود. برای مثال:
.Sp
.Vb 1
\&        fix\-it:"test.c":{45:3\-45:21}:"gtk_widget_show_all"
.Ve
.Sp
موقعیت به صورت یک بازه‌ی نیمه‌باز بر حسب تعداد بایت‌ها مشخص می‌شود که از بایت ۱ برای ستون ابتدایی شروع می‌گردد. در مثال فوق، بایت‌های ۳ تا ۲۰ از خط ۴۵ فایل "test.c" باید با رشته‌ی داده‌شده جایگزین شوند:
.Sp
.Vb 5
\&        00000000011111111112222222222
\&        12345678901234567890123456789
\&          gtk_widget_showall (dlg);
\&          ^^^^^^^^^^^^^^^^^^
\&          gtk_widget_show_all
.Ve
.Sp
نام فایل و رشته‌ی جایگزین، نویسه‌ی بک‌اسلش را با "\e\e"، نویسه‌ی تب را با "\et"، خط جدید را با "\en"، نقل‌قول دوگانه را با "\e""، و نویسه‌های غیرقابل‌چاپ را با مبنای هشت (مثلاً تب عمودی با "\e013") گریز می‌دهند (escape می‌کنند).
.Sp
یک رشته‌ی جایگزینِ خالی نشان می‌دهد که بازه‌ی مشخص‌شده باید حذف گردد. یک بازه‌ی خالی (مانند "45:3\-45:3") نشان می‌دهد که رشته باید در موقعیت داده‌شده درج شود.
.IP \fB\-fdiagnostics\-generate\-patch\fR 4
.IX Item "-fdiagnostics-generate-patch"
راهنماهای اصلاح را پس از چاپ هر پیام تشخیصی، در قالب تفاضل یکپارچه (unified diff) در stderr چاپ می‌کند. برای مثال:
.Sp
.Vb 3
\&        \-\-\- test.c
\&        +++ test.c
\&        @ \-42,5 +42,5 @
\&        
\&         void show_cb(GtkDialog *dlg)
\&         {
\&        \-  gtk_widget_showall(dlg);
\&        +  gtk_widget_show_all(dlg);
\&         }
.Ve
.Sp
خروجی diff بسته به همان قواعد مربوط به پیام‌های تشخیص، ممکن است رنگی باشد یا نباشد (به \fB\-fdiagnostics\-color\fR مراجعه کنید).
.IP \fB\-fdiagnostics\-show\-template\-tree\fR 4
.IX Item "-fdiagnostics-show-template-tree"
در فرانت‌اند C++، هنگام چاپ پیام‌های تشخیصی که عدم تطابق نوع‌های الگو (template) را نشان می‌دهند، مانند:
.Sp
.Vb 2
\&          could not convert \*(Aqstd::map<int, std::vector<double> >()\*(Aq
\&            from \*(Aqmap<[...],vector<double>>\*(Aq to \*(Aqmap<[...],vector<float>>
.Ve
.Sp
پرچم \fB\-fdiagnostics\-show\-template\-tree\fR چاپ یک ساختار درخت‌مانند را فعال می‌کند که بخش‌های مشترک و متمایز این نوع‌ها را نشان می‌دهد، مانند:
.Sp
.Vb 4
\&          map<
\&            [...],
\&            vector<
\&              [double != float]>>
.Ve
.Sp
بخش‌هایی که تفاوت دارند با رنگ برجسته می‌شوند (در این مورد "double" و "float").
.IP \fB\-fno\-elide\-type\fR 4
.IX Item "-fno-elide-type"
به‌طور پیش‌فرض، هنگامی که فرانت‌اند C++ پیام‌های تشخیصی حاوی عدم تطابق نوع‌های الگو را چاپ می‌کند، بخش‌های مشترک نوع‌ها به صورت "[...]" چاپ می‌شوند تا پیام خطا ساده‌تر شود. برای مثال:
.Sp
.Vb 2
\&          could not convert \*(Aqstd::map<int, std::vector<double> >()\*(Aq
\&            from \*(Aqmap<[...],vector<double>>\*(Aq to \*(Aqmap<[...],vector<float>>
.Ve
.Sp
تعیین پرچم \fB\-fno\-elide\-type\fR مانع این رفتار می‌شود. این پرچم همچنین بر خروجی پرچم
\&\fB\-fdiagnostics\-show\-template\-tree\fR تأثیر می‌گذارد.
.IP \fB\-fdiagnostics\-path\-format=\fR\fIKIND\fR 4
.IX Item "-fdiagnostics-path-format=KIND"
نحوه‌ی چاپ مسیرهای رویدادهای جریان کنترل را برای پیام‌های تشخیصی که دارای چنین مسیری هستند، مشخص می‌کند.
.Sp
مقدار \&\fIKIND\fR می‌تواند \fBnone\fR، \fBseparate\-events\fR، یا حالت پیش‌فرض \fBinline\-events\fR باشد.
.Sp
مقدار \&\fBnone\fR به این معناست که مسیرهای تشخیص چاپ نشوند.
.Sp
مقدار \&\fBseparate\-events\fR به این معناست که برای هر رویداد در جریان تشخیص، یک پیام تشخیصی جداگانه از نوع "note" چاپ شود. برای مثال:
.Sp
.Vb 4
\&        test.c:29:5: error: passing NULL as argument 1 to \*(AqPyList_Append\*(Aq which requires a non\-NULL parameter
\&        test.c:25:10: note: (1) when \*(AqPyList_New\*(Aq fails, returning NULL
\&        test.c:27:3: note: (2) when \*(Aqi < count\*(Aq
\&        test.c:29:5: note: (3) when calling \*(AqPyList_Append\*(Aq, passing NULL from (1) as argument 1
.Ve
.Sp
مقدار \&\fBinline\-events\fR به این معناست که رویدادها به‌صورت «درون‌خطی» (inline) در داخل کد منبع چاپ شوند. این نما تلاش می‌کند رویدادها را در توالی‌هایی از رویدادهای به حد کافی نزدیک به هم ادغام کرده و آن‌ها را به‌صورت بازه‌های برچسب‌دار در کد منبع چاپ کند.
.Sp
برای مثال، همان رویدادهای بالا ممکن است به این صورت چاپ شوند:
.Sp
.Vb 10
\&          \*(Aqtest\*(Aq: events 1\-3
\&           25 |   list = PyList_New(0);
\&              |          ^~~~~~~~~~~~~
\&              |          |
\&              |          (1) when \*(AqPyList_New\*(Aq fails, returning NULL
\&           26 |
\&           27 |   for (i = 0; i < count; i++) {
\&              |   ~~~
\&              |   |
\&              |   (2) when \*(Aqi < count\*(Aq
\&           28 |     item = PyLong_FromLong(random());
\&           29 |     PyList_Append(list, item);
\&              |     ~~~~~~~~~~~~~~~~~~~~~~~~~
\&              |     |
\&              |     (3) when calling \*(AqPyList_Append\*(Aq, passing NULL from (1) as argument 1
.Ve
.Sp
جریان کنترل بین‌رویه‌ای (interprocedural) با گروه‌بندی رویدادها بر اساس قاب پشته (stack frame) و استفاده از تورفتگی جهت نمایش چگونگی تودرتو شدن، درج در پشته (push) و خروج از پشته (pop) قاب‌های پشته نمایش داده می‌شود.
.Sp
برای مثال:
.Sp
.Vb 10
\&          \*(Aqtest\*(Aq: events 1\-2
\&            |
\&            |  133 | {
\&            |      | ^
\&            |      | |
\&            |      | (1) entering \*(Aqtest\*(Aq
\&            |  134 |   boxed_int *obj = make_boxed_int (i);
\&            |      |                    ~~~~~~~~~~~~~~~~~~
\&            |      |                    |
\&            |      |                    (2) calling \*(Aqmake_boxed_int\*(Aq
\&            |
\&            +\-\-> \*(Aqmake_boxed_int\*(Aq: events 3\-4
\&                   |
\&                   |  120 | {
\&                   |      | ^
\&                   |      | |
\&                   |      | (3) entering \*(Aqmake_boxed_int\*(Aq
\&                   |  121 |   boxed_int *result = (boxed_int *)wrapped_malloc (sizeof (boxed_int));
\&                   |      |                                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\&                   |      |                                    |
\&                   |      |                                    (4) calling \*(Aqwrapped_malloc\*(Aq
\&                   |
\&                   +\-\-> \*(Aqwrapped_malloc\*(Aq: events 5\-6
\&                          |
\&                          |    7 | {
\&                          |      | ^
\&                          |      | |
\&                          |      | (5) entering \*(Aqwrapped_malloc\*(Aq
\&                          |    8 |   return malloc (size);
\&                          |      |          ~~~~~~~~~~~~~
\&                          |      |          |
\&                          |      |          (6) calling \*(Aqmalloc\*(Aq
\&                          |
\&            <\-\-\-\-\-\-\-\-\-\-\-\-\-+
\&            |
\&         \*(Aqtest\*(Aq: event 7
\&            |
\&            |  138 |   free_boxed_int (obj);
\&            |      |   ^~~~~~~~~~~~~~~~~~~~
\&            |      |   |
\&            |      |   (7) calling \*(Aqfree_boxed_int\*(Aq
\&            |
\&        (etc)
.Ve.IP \fB\-fdiagnostics\-show\-path\-depths\fR 4
.IX Item "-fdiagnostics-show-path-depths"
این گزینه هنگام چاپ مسیرهای جریان کنترل مربوط به یک پیام تشخیصی، اطلاعات تکمیلی ارائه می‌دهد.
.Sp
اگر این گزینه مشخص شود، عمق پشته برای هر توالی از رویدادها درون \fB\-fdiagnostics\-path\-format=inline\-events\fR چاپ خواهد شد. اگر همراه با \fB\-fdiagnostics\-path\-format=separate\-events\fR مشخص شود، عمق پشته و اعلان تابع هنگام چاپ هر رویداد ضمیمه خواهد شد.
.Sp
این گزینه برای استفادهٔ توسعه‌دهندگان GCC و توسعه‌دهندگان افزونه‌ها هنگام اشکال‌زدایی پیام‌های تشخیصی که جریان کنترل بین‌روالی را گزارش می‌دهند در نظر گرفته شده است.
.IP \fB\-fno\-show\-column\fR 4
.IX Item "-fno-show-column"
از چاپ شماره‌های ستون در پیام‌های تشخیصی خودداری می‌کند. این امر ممکن است در مواردی که پیام‌های تشخیصی توسط برنامه‌ای پیمایش می‌شوند که شماره‌های ستون را درک نمی‌کند، مانند \fBdejagnu\fR، ضروری باشد.
.IP \fB\-fdiagnostics\-column\-unit=\fR\fIUNIT\fR 4
.IX Item "-fdiagnostics-column-unit=UNIT"
واحدهای مربوط به شمارهٔ ستون را مشخص می‌کند. این گزینه بر پیام‌های تشخیصی سنتی (در نبود \fB\-fno\-show\-column\fR) اثر می‌گذارد.
.Sp
مقدار پیش‌فرض \fIUNIT\fR، یعنی \fBdisplay\fR، تعداد ستون‌های نمایشی اشغال‌شده توسط هر نویسه را در نظر می‌گیرد. این مقدار در مورد نویسه‌های برگه (tab) می‌تواند بزرگ‌تر از تعداد بایت‌های موردنیاز برای کدگذاری نویسه باشد، یا در مورد نویسه‌های چندبایتی کوچک‌تر باشد. برای مثال، نویسهٔ «GREEK SMALL LETTER PI (U+03C0)» یک ستون نمایش را اشغال می‌کند و کدگذاری UTF\-8 آن به دو بایت نیاز دارد؛ نویسهٔ «SLIGHTLY SMILING FACE (U+1F642)» دو ستون نمایش را اشغال کرده و کدگذاری UTF\-8 آن به چهار بایت احتیاج دارد.
.Sp
تنظیم \fIUNIT\fR روی \fBbyte\fR، شمارهٔ ستون را در همهٔ موارد به تعداد بایت‌های خام تغییر می‌دهد، همان‌گونه که در GCC پیش از نگارش 11.1.0 به‌صورت سنتی چاپ می‌شد.
.IP \fB\-fdiagnostics\-column\-origin=\fR\fIORIGIN\fR 4
.IX Item "-fdiagnostics-column-origin=ORIGIN"
مبدأ شماره‌های ستون، یعنی شمارهٔ ستون اختصاص‌یافته به ستون نخست را تعیین می‌کند. مقدار پیش‌فرض 1 با رفتار سنتی GCC و راهنمای نگارش GNU مطابقت دارد. برخی ابزارها ممکن است با مبدأ 0 عملکرد بهتری داشته باشند؛ هر مقدار غیرمنفی را می‌توان مشخص کرد.
.IP \fB\-fdiagnostics\-escape\-format=\fR\fIFORMAT\fR 4
.IX Item "-fdiagnostics-escape-format=FORMAT"
هنگامی که GCC خطوط مبدأ مربوط به یک پیام تشخیصی را چاپ می‌کند، معمولاً سعی می‌کند بایت‌های مبدأ را مستقیماً چاپ کند. با این حال، برخی از پیام‌های تشخیصی به مشکلات کدگذاری در فایل مبدأ مربوط می‌شوند، مانند UTF\-8 ناصحیح (malformed)، یا مشکلات مربوط به نرمال‌سازی Unicode. این پیام‌های تشخیصی علامت‌گذاری می‌شوند تا GCC هنگام چاپ خطوط مبدأ مرتبط، بایت‌هایی را که نویسه‌های ASCII قابل‌چاپ نیستند، نویسه‌گردانی (escape) کند.
.Sp
این گزینه نحوهٔ نویسه‌گردانی چنین بایت‌هایی را واپایش می‌کند.
.Sp
مقدار پیش‌فرض \fIFORMAT\fR، یعنی \fBunicode\fR، نویسه‌های Unicode غیرقابل‌چاپ در ASCII را به شکل \fB<U+XXXX>\fR نمایش می‌دهد، و بایت‌هایی که با یک نویسهٔ Unicode با کدگذاری معتبر در UTF\-8 تطابق ندارند به‌صورت شانزده‌شانزدهی و به شکل \fB<XX>\fR نمایش داده خواهند شد.
.Sp
برای مثال، یک خط مبدأ شامل رشتهٔ \fBbefore\fR و به دنبال آن نویسهٔ Unicode با شناسهٔ U+03C0 («GREEK SMALL LETTER PI» با کدگذاری UTF\-8 به‌صورت 0xCF 0x80) و به دنبال آن بایت 0xBF (یک بایت پایانی سرگردان در UTF\-8)، و سپس رشتهٔ \fBafter\fR، برای چنین پیام تشخیصی‌ای به صورت زیر چاپ خواهد شد:
.Sp
.Vb 1
\&         before<U+03C0><BF>after
.Ve
.Sp
تنظیم \fIFORMAT\fR روی \fBbytes\fR تمامی بایت‌های غیرقابل‌چاپ ASCII را به شکل \fB<XX>\fR نمایش می‌دهد، و بدین ترتیب کدگذاری زیرین نویسه‌های یونیکد غیر-ASCII را نشان می‌دهد. برای مثال بالا، خروجی زیر چاپ خواهد شد:
.Sp
.Vb 1
\&         before<CF><80><BF>after
.Ve
.IP \fB\-fdiagnostics\-text\-art\-charset=\fR\fICHARSET\fR 4
.IX Item "-fdiagnostics-text-art-charset=CHARSET"
برخی پیام‌های تشخیصی می‌توانند شامل نمودارهای «هنر متنی» (text art) باشند: مصورسازی‌هایی که از متن ساخته شده‌اند و هدف آن‌ها نمایش در قلم‌هایی با عرض ثابت (monospaced) است.
.Sp
این گزینه مشخص می‌کند که در صورت وجود، چه نویسه‌هایی باید برای چاپ چنین نمودارهایی استفاده شوند. مقدار \fICHARSET\fR برابر با \fBnone\fR، \fBascii\fR، \fBunicode\fR، یا \fBemoji\fR است.
.Sp
مقدار \fBnone\fR چاپ چنین نمودارهایی را متوقف می‌کند. مقدار \fBascii\fR تضمین می‌کند که این نمودارها صرفاً از ASCII تشکیل شوند («هنر ASCII»). مقدار \fBunicode\fR امکان استفادهٔ محافظه‌کارانه از نویسه‌های ترسیمی یونیکد (مانند نویسه‌های رسم جعبه) را فراهم می‌کند. مقدار \fBemoji\fR امکان افزودن ایموجی به خروجی را نیز مهیا می‌سازد (مانند درج U+26A0 WARNING SIGN و به دنبال آن U+FE0F VARIATION SELECTOR\-16 جهت انتخاب نگارش ایموجی آن نویسه).
.Sp
مقدار پیش‌فرض \fBemoji\fR است، مگر زمانی که متغیر محیطی \fBLANG\fR روی \fBC\fR تنظیم شده باشد، که در این صورت پیش‌فرض \fBascii\fR خواهد بود.
.IP \fB\-fno\-diagnostics\-show\-nesting\fR 4
.IX Item "-fno-diagnostics-show-nesting"
برخی از پیام‌های تشخیصی GCC ساختار درونی درخت‌مانندی از پیام‌های تشخیصی فرعی تودرتو دارند، مانند مواردی که در هنگام نمونه‌سازی الگوهای ++C رخ می‌دهند.
.Sp
به‌طور پیش‌فرض، GCC از تورفتگی و نشانه‌های نقطه‌ای (bullet points) در خروجی متنی خود برای نمایش ساختار تودرتوی این پیام‌های تشخیصی استفاده می‌کند، اطلاعات مکان را به خطوط جداگانه منتقل می‌کند تا ساختار خواناتر شود، و اطلاعات تکراری و زائد را حذف می‌کند.
.Sp
انتخاب \fB\-fno\-diagnostics\-show\-nesting\fR این تورفتگی، تغییر قالب‌بندی و حذف اطلاعات زائد را متوقف کرده و «نمای» قدیمی‌تر پیام‌های تشخیصی را بازیابی می‌کند.
.IP \fB\-fno\-diagnostics\-show\-nesting\-locations\fR 4
.IX Item "-fno-diagnostics-show-nesting-locations"
هنگامی که \fBfdiagnostics\-show\-nesting\fR فعال باشد، نام فایل‌ها و شماره‌های خط و ستون در خطوطی جدا از متن پیام‌ها نمایش داده می‌شوند. این اطلاعات مکانی را می‌توان به‌طور کامل با \&\fB\-fno\-diagnostics\-show\-nesting\-locations\fR غیرفعال کرد. این گزینه برای استفادهٔ توسعه‌دهندگان GCC هنگام نگارش موارد آزمون DejaGnu در نظر گرفته شده است.
.IP \fB\-fdiagnostics\-show\-nesting\-levels\fR 4
.IX Item "-fdiagnostics-show-nesting-levels"
هنگامی که \fBfdiagnostics\-show\-nesting\fR فعال باشد، از \&\fBfdiagnostics\-show\-nesting\-levels\fR برای نمایش شماره‌هایی که عمق تودرتویی را نشان می‌دهند نیز استفاده کنید. این گزینه برای استفادهٔ توسعه‌دهندگان GCC جهت اشکال‌زدایی پیام‌های تشخیصی تودرتو ایجاد شده است، اما ممکن است برای توسعه‌دهندگان افزونه‌ها نیز سودمند باشد.
.IP \fB\-fdiagnostics\-format=\fR\fIFORMAT\fR 4
.IX Item "-fdiagnostics-format=FORMAT"
قالب دیگری را برای چاپ پیام‌های تشخیصی انتخاب می‌کند. مقدار \&\fIFORMAT\fR یکی از موارد \fBtext\fR، \fBsarif\-stderr\fR یا \fBsarif\-file\fR است.
.Sp
استفاده از این گزینه، هر «مقصد خروجی» اضافی اضافه شده با \&\fB\-fdiagnostics\-add\-output=\fR یا مقدار تنظیم شده با \&\fB\-fdiagnostics\-set\-output=\fR را جایگزین می‌کند.
.Sp
مقدار پیش‌فرض \fBtext\fR است.
.Sp
قالب‌های \fBsarif\-stderr\fR و \fBsarif\-file\fR هر دو پیام‌های تشخیصی را در قالب SARIF Version 2.1.0، به ترتیب در stderr یا در فایلی به نام \fIsource.sarif\fR ارسال می‌کنند.
.IP \fB\-fdiagnostics\-add\-output=\fR\fIDIAGNOSTICS\-OUTPUT\-SPEC\fR 4
.IX Item "-fdiagnostics-add-output=DIAGNOSTICS-OUTPUT-SPEC"
یک «مقصد خروجی» اضافی برای ارسال پیام‌های تشخیصی اضافه می‌کند.
.Sp
مقدار \&\fIDIAGNOSTICS\-OUTPUT\-SPEC\fR باید یک طرح‌واره (scheme) را مشخص کند که به‌صورت اختیاری با \f(CW\*(C`:\*(C'\fR و یک یا چند جفت \fIKEY\fR=\fIVALUE\fR دنبال می‌شود، به این صورت:
.Sp
.Vb 3
\&        <SCHEME>
\&        <SCHEME>:<KEY>=<VALUE>
\&        <SCHEME>:<KEY>=<VALUE>,<KEY2>=<VALUE2>
.Ve
.Sp
و غیره.
.Sp
طرح‌واره‌ها، کلیدها یا مقادیری که نام آن‌ها با پیشوند «experimental» آغاز می‌شود ممکن است بدون اعلان قبلی تغییر یابند یا حذف شوند. کلیدها می‌توانند مختص هر طرح‌واره باشند یا به کل GCC ارتباط داشته باشند.
.Sp
مقدار \&\fISCHEME\fR می‌تواند موارد زیر باشد:
.RS 4
.IP \fBtext\fR 4
.IX Item "text"
ارسال پیام‌های تشخیصی به stderr با استفاده از قالب خروجی متنی کلاسیک GCC.
.Sp
کلیدهای پشتیبانی‌شده برای طرح‌وارهٔ \f(CW\*(C`text\*(C'\fR عبارتند از:
.RS 4
.IP \fBcolor=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "color=[yes|no]"
تنظیمات رنگ‌آمیزی حاصل از \fB\-fdiagnostics\-color\fR را برای این خروجی متنی لغو (override) می‌کند.
.IP \fBshow\-nesting=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-nesting=[yes|no]"
حالتی را فعال می‌کند که روابط سلسله‌مراتبی درون پیام‌های تشخیصی را مطابق با \fB\-fdiagnostics\-show\-nesting\fR برجسته می‌سازد. مقدار پیش‌فرض \f(CW\*(C`yes\*(C'\fR است.
.IP \fBshow\-nesting\-locations=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-nesting-locations=[yes|no]"
اگر \f(CW\*(C`show\-nesting=yes\*(C'\fR باشد، مکان‌ها به‌طور پیش‌فرض نمایش داده می‌شوند؛ این کلید را روی \f(CW\*(C`no\*(C'\fR تنظیم کنید تا چاپ این مکان‌ها غیرفعال گردد. این ویژگی برای استفادهٔ توسعه‌دهندگان GCC هنگام نگارش موارد آزمون DejaGnu وجود دارد.
.IP \fBshow\-nesting\-levels=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-nesting-levels=[yes|no]"
این یک گزینهٔ اشکال‌زدایی برای استفاده به همراه \f(CW\*(C`show\-nesting=yes\*(C'\fR است. این کلید را روی \f(CW\*(C`yes\*(C'\fR تنظیم کنید تا سطوح تودرتویی صریح در خروجی چاپ شود. این ویژگی برای استفادهٔ توسعه‌دهندگان GCC در نظر گرفته شده است.
.RE
.RS 4
.RE.IP \fBsarif\fR 4
.IX Item "sarif"
ارسال اطلاعات عیب‌یابی به یک فایل در قالب SARIF.
.Sp
کلیدهای پشتیبانی‌شده برای طرح‌وارهٔ \f(CW\*(C`sarif\*(C'\fR عبارت‌اند از:
.RS 4
.IP \fBfile=\fR\fIFILENAME\fR 4
.IX Item "file=FILENAME"
تعیین نام فایلی که خروجی SARIF در آن نوشته می‌شود، که می‌تواند با یک
مسیر مطلق یا نسبی در ابتدا همراه باشد. در صورت عدم تعیین، مقدار پیش‌فرض
\&\fIsource.sarif\fR خواهد بود.
.IP \fBserialization=\fR[\fBjson\fR] 4
.IX Item "serialization=[json]"
تعیین قالب سریال‌سازی برای استفاده هنگام نوشتن SARIF.
در حال حاضر این مقدار تنها می‌تواند \f(CW\*(C`json\*(C'\fR باشد، اما به عنوان یک
نقطهٔ گسترش برای آزمایش سایر روش‌های سریال‌سازی تعبیه شده است.
.IP \fBversion=\fR[\fB2.1\fR|\fB2.2\-prerelease\fR] 4
.IX Item "version=[2.1|2.2-prerelease]"
تعیین نگارش SARIF برای استفاده در خروجی. در صورت عدم تعیین،
مقدار پیش‌فرض 2.1 است. \f(CW\*(C`2.2\-prerelease\*(C'\fR از یک پیش‌نویس غیررسمی مشخصات
آیندهٔ SARIF 2.2 استفاده می‌کند و در این انتشار تنها باید برای امور آزمایشی
استفاده شود.
.RE
.RS 4
.Sp
همچنین این کلید برای استفادهٔ توسعه‌دهندگان GCC به جای کاربران
نهایی در نظر گرفته شده است و ممکن است بدون اطلاع قبلی تغییر کند یا حذف شود:
.IP \fBstate\-graphs=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "state-graphs=[yes|no]"
این یک ویژگی اشکال‌زدایی است و مقدار پیش‌فرض آن \f(CW\*(C`no\*(C'\fR است.
اگر \f(CW\*(C`state\-graphs=yes\*(C'\fR باشد، تلاش می‌شود اطلاعات تفصیلی وضعیت
از \fB\-fanalyzer\fR در SARIF تولیدشده ثبت شود.
.RE
.RS 4
.RE
.IP \fBexperimental\-html\fR 4
.IX Item "experimental-html"
ارسال اطلاعات عیب‌یابی به یک فایل در قالب HTML. این طرح‌واره آزمایشی است
و ممکن است در نگارش‌های آیندهٔ GCC حذف شود. کلیدها و جزئیات خروجی
نیز ممکن است تغییر کنند.
.Sp
کلیدهای پشتیبانی‌شده برای طرح‌وارهٔ \f(CW\*(C`experimental\-html\*(C'\fR عبارت‌اند از:
.RS 4
.IP \fBcss=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "css=[yes|no]"
افزودن یک <style> درون‌ریزی‌شده به HTML تولیدشده. مقدار پیش‌فرض yes است.
.IP \fBfile=\fR\fIFILENAME\fR 4
.IX Item "file=FILENAME"
تعیین نام فایلی که خروجی HTML در آن نوشته می‌شود، که می‌تواند با یک
مسیر مطلق یا نسبی در ابتدا همراه باشد. در صورت عدم تعیین، مقدار پیش‌فرض
\&\fIsource.html\fR خواهد بود.
.IP \fBjavascript=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "javascript=[yes|no]"
افزودن یک <script> درون‌ریزی‌شده به HTML تولیدشده که یک واسط کاربری (UI)
ساده و ابتدایی را برای مشاهدهٔ نتایج فراهم می‌کند. مقدار پیش‌فرض yes است.
.RE
.RS 4
.Sp
همچنین این کلیدها برای استفادهٔ توسعه‌دهندگان GCC به جای کاربران
نهایی در نظر گرفته شده‌اند و ممکن است بدون اطلاع قبلی تغییر کنند یا حذف شوند:
.IP \fBshow\-state\-diagrams=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-state-diagrams=[yes|no]"
این یک ویژگی اشکال‌زدایی است و مقدار پیش‌فرض آن \f(CW\*(C`no\*(C'\fR است.
اگر \f(CW\*(C`show\-state\-diagrams=yes\*(C'\fR باشد، تلاش می‌شود با استفاده از \fBdot\fR نمودارهای
SVG در HTML تولیدشده ایجاد شوند تا وضعیت را در هر رویداد از مسیر عیب‌یابی
به تصویر بکشند.
این نمودارها با فشردن «j» و «k» برای حرکت گام‌به‌گام به جلو و
عقب در میان رویدادها قابل مشاهده هستند. فعال‌سازی این گزینه روند
تولید HTML را کُند خواهد کرد.
.IP \fBshow\-graph\-dot\-src=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-graph-dot-src=[yes|no]"
این یک ویژگی اشکال‌زدایی است و مقدار پیش‌فرض آن \f(CW\*(C`no\*(C'\fR است.
اگر \f(CW\*(C`show\-graph\-dot\-src=yes\*(C'\fR باشد
و \f(CW\*(C`show\-state\-diagrams=yes\*(C'\fR برقرار باشد،
نمودارهای وضعیت تولیدشده همچنین ورودی سورس ‎.dot به GraphViz را که
برای تولید نمودار استفاده شده نشان خواهند داد.
.IP \fBshow\-graph\-sarif=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "show-graph-sarif=[yes|no]"
این یک ویژگی اشکال‌زدایی است و مقدار پیش‌فرض آن \f(CW\*(C`no\*(C'\fR است.
اگر \f(CW\*(C`show\-graph\-sarif=yes\*(C'\fR باشد
و \f(CW\*(C`show\-state\-diagrams=yes\*(C'\fR برقرار باشد، نمودارهای وضعیت تولیدشده
همچنین بازنمایی SARIF از وضعیت را نشان خواهند داد.
.RE
.RS 4
.RE
.RE
.RS 4
.Sp
علاوه بر کلیدهای ویژه‌ٔ هر طرح‌واره، کلید مرتبط با GCC زیر بر روی
مقصدهای خروجی (sinks) متعلق به هر طرح‌واره‌ای قابل استفاده است:
.IP \fBcfgs=\fR[\fByes\fR|\fBno\fR] 4
.IX Item "cfgs=[yes|no]"
اگر برای یک مقصد خروجی مقدار \f(CW\*(C`cfgs=yes\*(C'\fR تنظیم شده باشد، GCC تلاش خواهد کرد
اطلاعات مربوط به گراف‌های جریان کنترل را برای توابعی که در حال کامپایل آن‌هاست به آن مقصد ارسال کند.
مقصدهای متنی این اطلاعات را نادیده می‌گیرند. مقصدهای SARIF این گراف‌ها را در
\&\f(CW\*(C`theRun.graphs\*(C'\fR اضافه خواهند کرد. مقصدهای HTML تصاویری در قالب SVG برای نمایش گراف‌ها تولید خواهند کرد.
شکل دقیق این اطلاعات ممکن است بدون اطلاع قبلی تغییر کند.
.RE
.RS 4
.Sp
برای مثال،
.Sp
.Vb 2
\&        \-fdiagnostics\-add\-output=sarif:version=2.1,file=foo.2.1.sarif
\&        \-fdiagnostics\-add\-output=sarif:version=2.2\-prerelease,file=foo.2.2.sarif
.Ve
.Sp
یک جفت خروجی اضافه می‌کند که هر کدام در فایلی متفاوت نوشته شده و
به ترتیب از نگارش‌های 2.1 و 2.2 استاندارد SARIF استفاده می‌کنند.
.Sp
به صورت EBNF:
.Sp
.Vb 2
\&        <diagnostics\-output\-specifier> = <diagnostics\-output\-name>
\&                                           | <diagnostics\-output\-name>, ":", <key\-value\-pairs>;
\&        
\&        <diagnostics\-output\-name> = "text" | "sarif" | "experimental\-html";
\&        
\&        <key\-value\-pairs> = <key\-value\-pair>
\&                              | <key\-value\-pair> "," <key\-value\-pairs>;
\&        
\&        <key\-value\-pair> = <key> "=" <value>;
\&        
\&        <key> = ? string without a \*(Aq=\*(Aq ? ;
\&        <value> = ? string without a \*(Aq,\*(Aq ? ;
.Ve
.RE
.IP \fB\-fdiagnostics\-set\-output=\fR\fIDIAGNOSTICS\-OUTPUT\-SPEC\fR 4
.IX Item "-fdiagnostics-set-output=DIAGNOSTICS-OUTPUT-SPEC"
این گزینه مشابه \fB\-fdiagnostics\-add\-output=\fR عمل می‌کند، با این تفاوت
که به جای افزودن یک «مقصد خروجی» اضافی برای عیب‌یابی‌ها،
تمام مقصدهای خروجی موجود، مانند مقصدهای ناشی از \fB\-fdiagnostics\-format=\fR،
\&\fB\-fdiagnostics\-add\-output=\fR، یا فراخوانی پیشین
\&\fB\-fdiagnostics\-set\-output=\fR را جایگزین می‌کند.
.IP \fB\-fno\-diagnostics\-json\-formatting\fR 4
.IX Item "-fno-diagnostics-json-formatting"
به طور پیش‌فرض، هنگامی که JSON برای عیب‌یابی‌ها منتشر می‌شود (از طریق
\&\fB\-fdiagnostics\-format=sarif\-stderr\fR یا
\&\fB\-fdiagnostics\-format=sarif\-file\fR)،
GCC خطوط جدید و تورفتگی‌هایی اضافه می‌کند تا ساختار سلسله‌مراتبی
JSON را به صورت بصری برجسته سازد.
.Sp
از \fB\-fno\-diagnostics\-json\-formatting\fR برای حذف این فاصله‌های خالی استفاده کنید.
این گزینه باید پیش از گزینه‌ای که قرار است بر آن تأثیر بگذارد مشخص شود.
.Sp
این قابلیت برای سازگاری با ابزارهایی طراحی شده است که انتظار ندارند خروجی
شامل خطوط جدید باشد، همانند خروجی‌های منتشرشده توسط نگارش‌های قدیمی‌تر GCC..SS "گزینه‌های درخواست یا مهار هشدارها (Options to Request or Suppress Warnings)"
.IX Subsection "Options to Request or Suppress Warnings"
هشدارها پیام‌های تشخیصی هستند که ساختارهایی را گزارش می‌کنند که
ذاتاً نادرست نیستند، اما مخاطره‌آمیز بوده یا حاکی از احتمال وقوع
یک خطا هستند.
.PP
گزینه‌های مستقل از زبان زیر، هشدارهای خاصی را فعال نمی‌کنند، بلکه
انواع پیام‌های تشخیصی تولیدشده توسط GCC را کنترل می‌کنند.
.IP \fB\-fsyntax\-only\fR 4
.IX Item "-fsyntax-only"
کد را تنها از نظر خطاهای نحوی بررسی می‌کند، اما کاری فراتر از آن انجام نمی‌دهد.
.IP \fB\-fmax\-errors=\fR\fIn\fR 4
.IX Item "-fmax-errors=n"
حداکثر تعداد پیام‌های خطا را به \fIn\fR محدود می‌کند؛ در این نقطه GCC به‌جای
تلاش برای ادامهٔ پردازش کد منبع، کار را متوقف می‌کند. اگر \fIn\fR برابر با 0 باشد
(پیش‌فرض)، محدودیتی در تعداد پیام‌های خطای تولیدشده وجود نخواهد داشت.
اگر \fB\-Wfatal\-errors\fR نیز مشخص شده باشد، آن‌گاه \fB\-Wfatal\-errors\fR
نسبت به این گزینه اولویت دارد.
.IP \fB\-w\fR 4
.IX Item "-w"
.PD 0
.IP \fB\-\-no\-warnings\fR 4
.IX Item "--no-warnings"
.PD
تمام پیام‌های هشدار را مهار (غیرفعال) می‌کند.
.IP \fB\-Werror\fR 4
.IX Item "-Werror"
تمام هشدارها را به خطا تبدیل می‌کند.
.IP \fB\-Werror=\fR 4
.IX Item "-Werror="
هشدار مشخص‌شده را به خطا تبدیل می‌کند. مشخص‌کنندهٔ هشدار به انتها پیوست می‌شود؛
برای نمونه \fB\-Werror=switch\fR هشدارهای کنترل‌شده توسط \fB\-Wswitch\fR را
به خطا تبدیل می‌کند. این گزینه شکلی منفی نیز می‌پذیرد که برای نفی \fB\-Werror\fR
برای هشدارهای خاص به کار می‌رود؛ برای نمونه \fB\-Wno\-error=switch\fR باعث می‌شود
هشدارهای \&\fB\-Wswitch\fR حتی در صورت فعال بودن \fB\-Werror\fR خطا نباشند.
.Sp
پیام هشدار برای هر هشدارِ قابل کنترل، شامل گزینه‌ای است که آن هشدار را
کنترل می‌کند. آن گزینه را می‌توان طبق توضیحات بالا با \&\fB\-Werror=\fR و
\fB\-Wno\-error=\fR به کار برد. (چاپ شدن گزینه در پیام هشدار را می‌توان با استفاده
از پرچم \&\fB\-fno\-diagnostics\-show\-option\fR غیرفعال کرد.)
.Sp
توجه داشته باشید که مشخص کردن \fB\-Werror=\fR\fIfoo\fR به‌طور خودکار
مستلزم \&\fB\-W\fR\fIfoo\fR است. با این حال، \fB\-Wno\-error=\fR\fIfoo\fR
هیچ مفهوم ضمنی دیگری در بر ندارد.
.IP \fB\-Wfatal\-errors\fR 4
.IX Item "-Wfatal-errors"
این گزینه باعث می‌شود کامپایلر با وقوع اولین خطا، به‌جای تلاش برای ادامه و
چاپ پیام‌های خطای بیشتر، کامپایل را متوقف سازد.
.PP
می‌توانید هشدارهای خاص بسیاری را با گزینه‌هایی که با \&\fB\-W\fR آغاز می‌شوند درخواست کنید؛
برای نمونه \fB\-Wunused\-variable\fR برای درخواست هشدار در مورد اعلان متغیرهایی که
هرگز استفاده نمی‌شوند. هر یک از این گزینه‌های هشدار خاص دارای یک حالت منفی نیز هست
که با \fB\-Wno\-\fR شروع می‌شود تا هشدارها را غیرفعال کند؛ برای نمونه،
\fB\-Wno\-unused\-variable\fR. این راهنما تنها یکی از این دو حالت را فهرست می‌کند،
هر کدام که پیش‌فرض نباشد. برای گزینه‌های خاص زبان‌های دیگر، به بخش‌های
\fBC++ Dialect Options\fR و \&\fBObjective\-C and Objective\-C++ Dialect Options\fR
نیز مراجعه کنید. هشدارهای تکمیلی را می‌توان با فعال کردن تحلیل‌گر ایستای کد تولید کرد؛
.PP
برخی گزینه‌ها، مانند \fB\-Wall\fR و \fB\-Wextra\fR، گزینه‌های دیگر نظیر
\fB\-Wunused\fR را فعال می‌کنند که ممکن است خود گزینه‌های بیشتری مانند
\fB\-Wunused\-variable\fR را فعال سازد. اثر ترکیبی حالت‌های مثبت و منفی این است که
گزینه‌های خاص‌تر، بدون در نظر گرفتن موقعیتشان در خط فرمان، نسبت به گزینه‌های با عمومیت
بیشتر اولویت دارند. برای گزینه‌هایی با درجهٔ اختصاصی یکسان، آخرین گزینه اعمال می‌شود.
گزینه‌های فعال یا غیرفعال‌شده از طریق pragmaها، به‌گونه‌ای اعمال می‌شوند که گویی در
انتهای خط فرمان درج شده‌اند.
.PP
هنگامی که یک گزینهٔ هشدار ناشناخته درخواست شود (مانند \&\fB\-Wunknown\-warning\fR)،
GCC خطایی صادر کرده و بیان می‌کند که گزینه شناخته‌شده نیست. با این حال، اگر حالت
\fB\-Wno\-\fR استفاده شود، رفتار اندکی متفاوت است: برای \fB\-Wno\-unknown\-warning\fR
هیچ پیام تشخیصی صادر نمی‌شود مگر اینکه پیام‌های تشخیصی دیگری نیز در حال تولید باشند.
این ویژگی امکان استفاده از گزینه‌های جدید \fB\-Wno\-\fR را در کامپایلرهای قدیمی‌تر
فراهم می‌آورد، اما در صورتی که مشکلی رخ دهد، کامپایلر هشدار می‌دهد که یک گزینهٔ
ناشناخته وجود دارد.
.PP
اثربخشی برخی هشدارها به فعال بودن بهینه‌سازی‌ها بستگی دارد. برای نمونه،
\fB\-Wsuggest\-final\-types\fR با بهینه‌سازی زمان پیوند مؤثرتر است. برخی هشدارهای
دیگر ممکن است تا زمانی که بهینه‌سازی فعال نباشد اصلاً صادر نشوند. در حالی که بهینه‌سازی
به‌طور کلی کارایی هشدارها را در مورد مشکلات جریان کنترل و داده بهبود می‌بخشد،
در برخی موارد ممکن است موجب هشدارهای مثبت کاذب نیز بشود.
.IP \fB\-Wpedantic\fR 4
.IX Item "-Wpedantic"
.PD 0
.IP \fB\-pedantic\fR 4
.IX Item "-pedantic"
.IP \fB\-\-pedantic\fR 4
.IX Item "--pedantic"
.PD
تمام هشدارهای خواسته‌شده توسط استانداردهای سخت‌گیرانهٔ ISO C و ISO C++ را صادر می‌کند؛
تمام برنامه‌هایی را که از افزونه‌های ممنوع استفاده می‌کنند و برخی برنامه‌های دیگر را که
از ISO C و ISO C++ پیروی نمی‌کنند، تشخیص داده و گزارش می‌دهد. این رفتار از نسخهٔ استاندارد
ISO C یا C++ که توسط هر گزینهٔ \fB\-std\fR به کار رفته مشخص شده، پیروی می‌کند.
.Sp
برنامه‌های معتبر ISO C و ISO C++ باید بدون توجه به وجود یا عدم وجود این گزینه به‌درستی
کامپایل شوند (هرچند تعداد نادری به \fB\-ansi\fR یا یک گزینهٔ \&\fB\-std\fR برای تعیین
نسخهٔ استاندارد نیاز دارند). با این حال، بدون این گزینه، برخی از افزونه‌های GNU و
قابلیت‌های سنتی C و C++ نیز پشتیبانی می‌شوند. با فعال بودن این گزینه، آن‌ها گزارش می‌شوند
(یا با \fB\-pedantic\-errors\fR رد می‌شوند).
.Sp
گزینهٔ \&\fB\-Wpedantic\fR برای استفاده از کلمات کلیدی جایگزینی که نام آن‌ها با \fB_\|_\fR
آغاز و پایان می‌یابد، پیام هشداری صادر نمی‌کند. این قالب جایگزین همچنین می‌تواند برای
غیرفعال کردن هشدارها برای انواع غیر استاندارد ISO یعنی \fB_\|_intN\fR (به صورت
\fB_\|_intN_\|_\fR) استفاده شود. هشدارهای وسواس‌گونه (pedantic) در عبارتی که پس از
\&\f(CW\*(C`_\|_extension_\|_\*(C'\fR می‌آید نیز غیرفعال می‌شوند. با این حال، فقط
فایل‌های سرآیند سیستمی باید از این راه‌های فرار استفاده کنند؛ برنامه‌های کاربردی باید
از آن‌ها اجتناب ورزند.
.Sp
برخی هشدارها در مورد برنامه‌های ناسازگار با استاندارد، توسط گزینه‌هایی غیر از
\fB\-Wpedantic\fR کنترل می‌شوند؛ در بسیاری از موارد آن‌ها به‌صورت ضمنی با
\&\fB\-Wpedantic\fR فعال می‌شوند، اما می‌توان آن‌ها را به‌طور جداگانه با گزینهٔ
خاص خودشان غیرفعال کرد، مانند \fB\-Wpedantic \-Wno\-pointer\-sign\fR.
.Sp
در جایی که استاندارد مشخص‌شده با \fB\-std\fR بیانگر یک گویش گسترش‌یافتهٔ GNU از C باشد،
مانند \fBgnu90\fR یا \fBgnu99\fR، یک \fIاستاندارد پایه\fR متناظر وجود دارد، یعنی نسخهٔ
ISO C که گویش گسترش‌یافتهٔ GNU بر پایهٔ آن استوار است. هشدارهای ناشی از \fB\-Wpedantic\fR
در مواردی صادر می‌شوند که توسط استاندارد پایه الزامی شده باشند. (منطقی نیست که چنین
هشدارهایی فقط برای قابلیت‌هایی صادر شوند که در گویش GNU C مشخص‌شده نیستند، چرا که بنا به
تعریف، گویش‌های GNU C شامل تمام قابلیت‌هایی هستند که کامپایلر با گزینهٔ داده‌شده
پشتیبانی می‌کند و چیزی برای هشدار دادن وجود نخواهد داشت.)
.IP \fB\-pedantic\-errors\fR 4
.IX Item "-pedantic-errors"
.PD 0
.IP \fB\-\-pedantic\-errors\fR 4
.IX Item "--pedantic-errors"
.PD
هرگاه \fIاستاندارد پایه\fR (نگاه کنید به \fB\-Wpedantic\fR) به پیامی تشخیصی نیاز داشته
باشد، در برخی موارد که رفتار تعریف‌نشده در زمان کامپایل وجود دارد، و در برخی موارد
دیگر که مانع کامپایل برنامه‌های معتبر طبق استاندارد نمی‌شوند، یک خطا صادر می‌کند. این معادل
\fB\-Werror=pedantic\fR نیست: گزینهٔ اخیر بعید است مفید واقع شود، زیرا تنها پیام‌های
تشخیصی کنترل‌شده توسط \&\fB\-Wpedantic\fR را به خطا تبدیل می‌کند، در حالی که این گزینه
بر پیام‌های تشخیصی الزامی که همیشه فعال هستند یا توسط گزینه‌هایی غیر از \fB\-Wpedantic\fR
کنترل می‌شوند نیز تأثیر می‌گذارد.
.Sp
اگر می‌خواهید پیام‌های تشخیصی الزامی که به‌طور پیش‌فرض هشدار هستند تبدیل به خطا شوند،
اما مایل نیستید هشدارهای \fB\-Wpedantic\fR نیز فعال گردند، می‌توانید
\fB\-pedantic\-errors \-Wno\-pedantic\fR را مشخص کنید (یا
\fB\-pedantic\-errors \-Wno\-error=pedantic\fR برای فعال کردن آن‌ها اما فقط در قالب هشدار).
.Sp
برخی از پیام‌های تشخیصی الزامی به‌طور پیش‌فرض خطا هستند، اما می‌توان با استفاده از
\fB\-fpermissive\fR یا گزینهٔ هشدار اختصاصی آن‌ها، مثلاً \fB\-Wno\-error=narrowing\fR،
آن‌ها را به هشدار تقلیل داد.
.Sp
برخی پیام‌های تشخیصی برای رویکردهای غیر استاندارد ISO توسط گزینه‌های هشدار خاصی غیر از
\fB\-Wpedantic\fR کنترل می‌شوند، اما با \fB\-pedantic\-errors\fR نیز تبدیل به خطا
می‌گردند. برای نمونه:
.Sp
\&\fB\-Wattributes\fR (برای ویژگی‌های استاندارد)
\&\fB\-Wchanges\-meaning\fR (در C++)
\&\fB\-Wcomma\-subscript\fR (در C++23 یا بالاتر)
\&\fB\-Wdeclaration\-after\-statement\fR (در C90 یا قبل‌تر)
\&\fB\-Welaborated\-enum\-base\fR (در C++11 یا بالاتر)
\&\fB\-Wimplicit\-int\fR (در C99 یا بالاتر)
\&\fB\-Wimplicit\-function\-declaration\fR (در C99 یا بالاتر)
\&\fB\-Wincompatible\-pointer\-types
\&\-Wint\-conversion
\&\-Wlong\-long\fR (در C90 یا قبل‌تر)
\&\fB\-Wmain
\&\-Wnarrowing\fR (در C++11 یا بالاتر)
\&\fB\-Wpointer\-arith
\&\-Wpointer\-sign
\&\-Wincompatible\-pointer\-types
\&\-Wregister\fR (در C++17 یا بالاتر)
\&\fB\-Wvla\fR (در C90 یا قبل‌تر)
\&\fB\-Wwrite\-strings\fR (در C++11 یا بالاتر)\fB \fR
.IP \fB\-fpermissive\fR 4
.IX Item "-fpermissive"
برخی از پیام‌های تشخیصی الزامی در مورد کدهای ناسازگار با استاندارد را از خطا به هشدار
تنزل می‌دهد. بدین ترتیب، استفاده از \fB\-fpermissive\fR اجازه می‌دهد برخی از کدهای
ناسازگار کامپایل شوند. برخی پیام‌های تشخیصی C++ تنها توسط این پرچم کنترل می‌شوند، اما
این گزینه همچنین برخی پیام‌های تشخیصی C و C++ را که پرچم اختصاصی خود را دارند تنزل می‌دهد:
.Sp
\&\fB\-Wabbreviated\-auto\-in\-template\-arg\fR (تنها C++ و Objective\-C++)
\&\fB\-Wdeclaration\-missing\-parameter\-type\fR (تنها C و Objective\-C)
\&\fB\-Wimplicit\-function\-declaration\fR (تنها C و Objective\-C)
\&\fB\-Wimplicit\-int\fR (تنها C و Objective\-C)
\&\fB\-Wincompatible\-pointer\-types\fR (تنها C و Objective\-C)
\&\fB\-Wint\-conversion\fR (تنها C و Objective\-C)
\&\fB\-Wnarrowing\fR (تنها C++ و Objective\-C++)
\&\fB\-Wreturn\-mismatch\fR (تنها C و Objective\-C)
\&\fB\-Wtemplate\-body\fR (تنها C++ و Objective\-C++)\fB \fR
.Sp
گزینهٔ \fB\-fpermissive\fR برای حالت‌های تاریخی زبان C حالت پیش‌فرض است
(\fB\-std=c89\fR، \fB\-std=gnu89\fR، \fB\-std=c90\fR،
\&\fB\-std=gnu90\fR)..IP \fB\-Wall\fR 4
.IX Item "-Wall"
.PD 0
.IP \fB\-\-all\-warnings\fR 4
.IX Item "--all-warnings"
.PD
این گزینه تمام هشدارهایی را درباره ساختارهایی که برخی کاربران مشکوک می‌دانند و اجتناب از آن‌ها (یا اصلاح کد برای جلوگیری از هشدار) حتی در صورت استفاده همراه با ماکروها آسان است، فعال می‌کند. این گزینه همچنین برخی هشدارهای مختص زبان را که در \fBC++ Dialect Options\fR و \fBObjective\-C and Objective\-C++ Dialect Options\fR شرح داده شده‌اند، فعال می‌سازد.
.Sp
\&\fB\-Wall\fR پرچم‌های هشدار زیر را روشن می‌کند:
.Sp
\&\fB\-Waddress
\&\-Waligned\-new\fR (تنها C++ و Objective\-C++)
\&\fB\-Warray\-bounds=1\fR (تنها با\fB \fR\fB\-O2\fR)
\&\fB\-Warray\-compare
\&\-Warray\-parameter=2
\&\-Wbool\-compare
\&\-Wbool\-operation
\&\-Wc++11\-compat  \-Wc++14\-compat  \-Wc++17compat  \-Wc++20compat
\&\-Wcatch\-value\fR (تنها C++ و Objective\-C++)
\&\fB\-Wchar\-subscripts
\&\-Wclass\-memaccess\fR (تنها C++ و Objective\-C++)
\&\fB\-Wcomment
\&\-Wdangling\-else
\&\-Wdangling\-pointer=2
\&\-Wdelete\-non\-virtual\-dtor\fR (تنها C++ و Objective\-C++)
\&\fB\-Wduplicate\-decl\-specifier\fR (تنها C و Objective\-C)
\&\fB\-Wenum\-compare\fR (در C/ObjC؛ این مورد به‌طور پیش‌فرض در C++ فعال است)
\&\fB\-Wenum\-int\-mismatch\fR (تنها C و Objective\-C)
\&\fB\-Wformat=1
\&\-Wformat\-contains\-nul
\&\-Wformat\-diag
\&\-Wformat\-extra\-args
\&\-Wformat\-overflow=1
\&\-Wformat\-truncation=1
\&\-Wformat\-zero\-length
\&\-Wframe\-address
\&\-Wimplicit\fR (تنها C و Objective\-C)
\&\fB\-Wimplicit\-function\-declaration\fR (تنها C و Objective\-C)
\&\fB\-Wimplicit\-int\fR (تنها C و Objective\-C)
\&\fB\-Winfinite\-recursion
\&\-Winit\-self\fR (تنها C++ و Objective\-C++)
\&\fB\-Wint\-in\-bool\-context
\&\-Wlogical\-not\-parentheses
\&\-Wmain\fR (تنها برای C/ObjC و مگر در صورت استفاده از\fB \fR\fB\-ffreestanding\fR)
\&\fB\-Wmaybe\-uninitialized
\&\-Wmemset\-elt\-size
\&\-Wmemset\-transposed\-args
\&\-Wmisleading\-indentation\fR (تنها برای C/C++)
\&\fB\-Wmismatched\-dealloc
\&\-Wmismatched\-new\-delete\fR (تنها C++ و Objective\-C++)
\&\fB\-Wmissing\-attributes
\&\-Wmissing\-braces\fR (تنها برای C/ObjC)
\&\fB\-Wmultistatement\-macros
\&\-Wnarrowing\fR  (تنها C++ و Objective\-C++)
\&\fB\-Wnonnull
\&\-Wnonnull\-compare
\&\-Wopenmp\-simd\fR (تنها C و C++)
\&\fB\-Woverloaded\-virtual=1\fR (تنها C++ و Objective\-C++)
\&\fB\-Wpacked\-not\-aligned
\&\-Wparentheses
\&\-Wpessimizing\-move\fR (تنها C++ و Objective\-C++)
\&\fB\-Wpointer\-sign\fR (تنها برای C/ObjC)
\&\fB\-Wrange\-loop\-construct\fR (تنها C++ و Objective\-C++)
\&\fB\-Wreorder\fR (تنها C++ و Objective\-C++)
\&\fB\-Wrestrict
\&\-Wreturn\-type
\&\-Wself\-move\fR (تنها C++ و Objective\-C++)
\&\fB\-Wsequence\-point
\&\-Wsign\-compare\fR (تنها C++ و Objective\-C++)
\&\fB\-Wsizeof\-array\-div
\&\-Wsizeof\-pointer\-div
\&\-Wsizeof\-pointer\-memaccess
\&\-Wstrict\-aliasing
\&\-Wstrict\-overflow=1
\&\-Wswitch
\&\-Wtautological\-compare
\&\-Wtrigraphs
\&\-Wuninitialized
\&\-Wunknown\-pragmas
\&\-Wunused
\&\-Wunused\-but\-set\-variable
\&\-Wunused\-const\-variable=1\fR (تنها برای C/ObjC)
\&\fB\-Wunused\-function
\&\-Wunused\-label
\&\-Wunused\-local\-typedefs
\&\-Wunused\-value
\&\-Wunused\-variable
\&\-Wuse\-after\-free=2
\&\-Wvla\-parameter
\&\-Wvolatile\-register\-var
\&\-Wzero\-length\-bounds\fR
.Sp
توجه داشته باشید که برخی از پرچم‌های هشدار توسط \fB\-Wall\fR فعال نمی‌شوند. برخی از آن‌ها در مورد ساختارهایی هشدار می‌دهند که کاربران عموماً آن‌ها را مشکوک تلقی نمی‌کنند، اما ممکن است گاهی تمایل به بررسی آن‌ها داشته باشید؛ برخی دیگر در مورد ساختارهایی هشدار می‌دهند که در بعضی شرایط ضروری هستند یا اجتناب از آن‌ها دشوار است، و هیچ راه ساده‌ای برای اصلاح کد جهت نادیده گرفتن هشدار وجود ندارد. بعضی از آن‌ها با \fB\-Wextra\fR فعال می‌شوند، اما بسیاری از آن‌ها باید به صورت جداگانه فعال گردند.
.IP \fB\-Wextra\fR 4
.IX Item "-Wextra"
.PD 0
.IP \fB\-\-extra\-warnings\fR 4
.IX Item "--extra-warnings"
.PD
این گزینه برخی پرچم‌های هشدار اضافی را که توسط \fB\-Wall\fR فعال نشده‌اند، فعال می‌کند. (این گزینه در گذشته \fB\-W\fR نامیده می‌شد. نام قدیمی‌تر همچنان پشتیبانی می‌شود، اما نام جدید توصیفی‌تر و گویاتر است.)
.Sp
\&\fB\-Wabsolute\-value\fR (تنها برای C/ObjC)
\&\fB\-Walloc\-size
\&\-Wcalloc\-transposed\-args
\&\-Wcast\-function\-type
\&\-Wclobbered
\&\-Wdangling\-reference\fR (تنها C++)
\&\fB\-Wdeprecated\-copy\fR (تنها C++ و Objective\-C++)
\&\fB\-Wempty\-body
\&\-Wenum\-conversion\fR (تنها برای C/ObjC)
\&\fB\-Wexpansion\-to\-defined
\&\-Wignored\-qualifiers\fR  (تنها برای C/C++)
\&\fB\-Wimplicit\-fallthrough=3
\&\-Wmaybe\-uninitialized
\&\-Wmissing\-field\-initializers
\&\-Wmissing\-parameter\-name\fR (تنها C/ObjC)
\&\fB\-Wmissing\-parameter\-type\fR (تنها C/ObjC)
\&\fB\-Wold\-style\-declaration\fR (تنها C/ObjC)
\&\fB\-Wmultiple\-parameter\-fwd\-decl\-lists\fR (تنها C/ObjC)
\&\fB\-Woverride\-init\fR (تنها C/ObjC)
\&\fB\-Wredundant\-move\fR (تنها C++ و Objective\-C++)
\&\fB\-Wshift\-negative\-value\fR (در C++11 تا C++17 و در C99 و جدیدتر)
\&\fB\-Wsign\-compare\fR (تنها C++ و Objective\-C++)
\&\fB\-Wsized\-deallocation\fR (تنها C++ و Objective\-C++)
\&\fB\-Wstring\-compare
\&\-Wtype\-limits
\&\-Wuninitialized
\&\-Wunterminated\-string\-initialization\fR (تنها C/ObjC)
\&\fB\-Wunused\-parameter\fR (تنها با\fB \fR\fB\-Wunused\fR\fB \fRیا\fB \fR\fB\-Wall\fR)
\&\fB\-Wunused\-but\-set\-parameter\fR (تنها با\fB \fR\fB\-Wunused\fR\fB \fRیا\fB \fR\fB\-Wall\fR)
.Sp
گزینه \fB\-Wextra\fR همچنین برای موارد زیر پیام هشدار چاپ می‌کند:
.RS 4
.IP * 4
یک اشاره‌گر با استفاده از \f(CW\*(C`<\*(C'\fR، \f(CW\*(C`<=\*(C'\fR، \&\f(CW\*(C`>\*(C'\fR یا \f(CW\*(C`>=\*(C'\fR با عدد صحیح صفر مقایسه شود.
.IP * 4
(تنها C++) یک شمارش‌شونده (enumerator) و یک غیرشمارش‌شونده هر دو در یک عبارت شرطی ظاهر شوند.
.IP * 4
(تنها C++) کلاس‌های پایه مجازی مبهم.
.IP * 4
(تنها C++) اندیس‌گذاری آرایه‌ای که با \f(CW\*(C`register\*(C'\fR اعلان شده است.
.IP * 4
(تنها C++) گرفتن آدرس متغیری که با \&\f(CW\*(C`register\*(C'\fR اعلان شده است.
.IP * 4
(تنها C++) یک کلاس پایه در سازنده رونوشت یک کلاس مشتق‌شده مقداردهی اولیه نشود.
.RE
.RS 4
.RE
.IP "\fB\-Wabi\fR (تنها در C، Objective\-C، C++ و Objective\-C++)" 4
.IX Item "-Wabi (C, Objective-C, C++ and Objective-C++ only)"
در مورد کدهایی که تحت تأثیر تغییرات ABI قرار گرفته‌اند هشدار می‌دهد. این شامل کدهایی می‌شود که ممکن است با C++ ABI بی‌طرف از فروشنده (vendor-neutral) و همچنین psABI برای معماری مقصد خاص سازگار نباشد. هشدارهای مورد دوم همچنین به‌صورت جداگانه توسط \fB\-Wpsabi\fR کنترل می‌شوند که توسط \fB\-Wabi\fR نیز به‌طور ضمنی فعال می‌گردد.
.Sp
از آنجا که اکنون G++ به‌طور پیش‌فرض در هر انتشار عمده اقدام به به‌روزرسانی ABI می‌کند، معمولاً \fB\-Wabi\fR فقط در صورتی در مورد مشکلات سازگاری C++ ABI هشدار می‌دهد که در یک سری از انتشارها، پس از کشف مشکل ABI از زمان انتشار اولیه، بررسی جدیدی اضافه شده باشد. اگر یک نسخه قدیمی‌تر ABI (با \&\fB\-fabi\-version=\fR\fIn\fR) انتخاب شود، \fB\-Wabi\fR درباره موارد بیشتری هشدار می‌دهد.
.Sp
\&\fB\-Wabi\fR همچنین می‌تواند با یک شماره نسخه صریح استفاده شود تا درباره سازگاری C++ ABI با سطح خاصی از \fB\-fabi\-version\fR هشدار دهد؛ به عنوان مثال \fB\-Wabi=2\fR برای هشدار درباره تغییرات نسبت به \&\fB\-fabi\-version=2\fR.
.Sp
اگر یک شماره نسخه صریح ارائه شده باشد و \&\fB\-fabi\-compat\-version\fR مشخص نشده باشد، از شماره نسخه این گزینه برای نام‌های مستعار سازگاری استفاده می‌شود. اگر هیچ شماره نسخه صریحی با این گزینه ارائه نشده باشد، اما \&\fB\-fabi\-compat\-version\fR مشخص شده باشد، از آن شماره نسخه برای هشدارهای C++ ABI استفاده می‌شود.
.Sp
اگرچه تلاش شده است تا درباره تمام این موارد هشدار داده شود، اما احتمالاً مواردی وجود دارد که با وجود تولید کد ناسازگار توسط G++، هشداری برای آن‌ها داده نمی‌شود. همچنین ممکن است مواردی وجود داشته باشد که با وجود سازگار بودن کد تولید شده، هشدار صادر شود.
.Sp
اگر نگران این موضوع هستید که کد تولیدشده توسط G++ ممکن است از نظر باینری با کد تولیدشده توسط کامپایلرهای دیگر سازگار نباشد، باید کد خود را برای اجتناب از این هشدارها بازنویسی کنید.
.Sp
ناسازگاری‌های شناخته‌شده در \fB\-fabi\-version=2\fR (که از GCC 3.4 تا 4.9 پیش‌فرض بود) عبارتند از:
.RS 4.IP * 4
الگویی با یک پارامتر الگوی غیرنوعی از نوع مرجع، به نادرستی درهم‌سازی می‌شد:
.Sp
.Vb 3
\&        extern int N;
\&        template <int &> struct S {};
\&        void n (S<N>) {2}
.Ve
.Sp
این مورد در \fB\-fabi\-version=3\fR برطرف شد.
.IP * 4
نوع‌های برداری SIMD که با استفاده از \f(CW\*(C`_\|_attribute ((vector_size))\*(C'\fR اعلان شده بودند، به روشی غیراستاندارد درهم‌سازی می‌شدند که اجازهٔ سربارگذاری توابعی که بردارهایی با اندازه‌های مختلف می‌گیرند را نمی‌داد.
.Sp
نحوهٔ درهم‌سازی در \fB\-fabi\-version=4\fR تغییر داده شد.
.IP * 4
\&\f(CW\*(C`_\|_attribute ((const))\*(C'\fR و \f(CW\*(C`noreturn\*(C'\fR به‌صورت توصیف‌کننده‌های نوع درهم‌سازی می‌شدند، و \f(CW\*(C`decltype\*(C'\fR مربوط به یک اعلان ساده حذف می‌شد.
.Sp
این مشکلات درهم‌سازی در \fB\-fabi\-version=5\fR برطرف شدند.
.IP * 4
شمارنده‌های دامنه‌دار (Scoped enumerators) که به‌عنوان آرگومان به یک تابع با تعداد متغیر آرگومان (variadic) ارسال می‌شوند، همانند شمارنده‌های بدون دامنه ارتقا می‌یابند و موجب خطای \f(CW\*(C`va_arg\*(C'\fR می‌شوند. در بیشتر معماری‌های هدف، این امر عملاً تأثیری بر ABI ارسال پارامتر ندارد، زیرا راهی برای ارسال یک آرگومان کوچک‌تر از \f(CW\*(C`int\*(C'\fR وجود ندارد.
.Sp
همچنین، ABI نحوهٔ درهم‌سازی بسته‌های آرگومان الگو (template argument packs)، \&\f(CW\*(C`const_cast\*(C'\fR، \f(CW\*(C`static_cast\*(C'\fR، افزایش/کاهش پیشوندی، و یک تابع در حوزهٔ کلاس را که به‌عنوان آرگومان الگو استفاده شده بود، تغییر داد.
.Sp
این مسائل در \fB\-fabi\-version=6\fR اصلاح شدند.
.IP * 4
توابع لامبدا در حوزهٔ آرگومان پیش‌فرض به نادرستی درهم‌سازی می‌شدند، و ABI نحوهٔ درهم‌سازی \f(CW\*(C`nullptr_t\*(C'\fR را تغییر داد.
.Sp
این مسائل در \fB\-fabi\-version=7\fR اصلاح شدند.
.IP * 4
هنگام درهم‌سازی یک نوع تابع با توصیف‌کننده‌های cv تابع (function-cv-qualifiers)، نوع تابعِ بدون توصیف‌کننده به نادرستی به‌عنوان یک نامزد جایگزینی در نظر گرفته می‌شد.
.Sp
این مورد در \fB\-fabi\-version=8\fR، مقدار پیش‌فرض برای GCC 5.1، برطرف شد.
.IP * 4
\&\f(CWdecltype(nullptr)\fR به نادرستی دارای ترازبندی ۱ بود که منجر به دسترسی‌های ناتراز می‌شد. توجه داشته باشید که این مسئله روی ABI تابعی با پارامتر \f(CW\*(C`nullptr_t\*(C'\fR تأثیری نداشت، زیرا پارامترها دارای حداقل ترازبندی هستند.
.Sp
این مورد در \fB\-fabi\-version=9\fR، مقدار پیش‌فرض برای GCC 5.2، برطرف شد.
.IP * 4
ویژگی‌های مختص به معماری هدف که بر هویت یک نوع تأثیر می‌گذارند، مانند قراردادهای فراخوانی ia32 روی یک نوع تابع (مانند stdcall، regparm و غیره)، روی نام درهم‌سازی‌شده تأثیری نمی‌گذاشتند، که هنگام استفاده از اشاره‌گرهای تابع به‌عنوان آرگومان‌های الگو، منجر به تداخل نام‌ها می‌شد.
.Sp
این مورد در \fB\-fabi\-version=10\fR، مقدار پیش‌فرض برای GCC 6.1، برطرف شد.
.RE
.RS 4
.RE
.IP "\fB\-Wpsabi\fR (تنها C، Objective\-C، C++ و Objective\-C++)" 4
.IX Item "-Wpsabi (C, Objective-C, C++ and Objective-C++ only)"
\&\fB\-Wpsabi\fR هشدارهایی را دربارهٔ تغییرات ABI مختص به پردازنده، مانند تغییرات در نیازمندی‌های ترازبندی یا نحوهٔ ارسال آرگومان‌های تابع، فعال می‌کند. در چندین معماری هدف، از جمله AArch64، ARM، x86، MIPS، RS6000/PowerPC و S/390، این جزئیات میان نسخه‌های مختلف GCC و/یا نسخه‌های مختلف استانداردهای زبان C یا C++ به شیوه‌هایی تغییر کرده‌اند که بر سازگاری باینری کدهای کامپایل‌شده تأثیر می‌گذارند. با \fB\-Wpsabi\fR، کامپایلر GCC می‌تواند کاربردهای بالقوه ناسازگار را تشخیص داده و دربارهٔ آن‌ها هشدار دهد.
.Sp
\&\fB\-Wpsabi\fR به‌طور پیش‌فرض فعال است، و همچنین توسط \&\fB\-Wabi\fR نیز اعمال می‌شود.
.IP "\fB\-Wno\-changes\-meaning\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wno-changes-meaning (C++ and Objective-C++ only)"
زبان C++ الزامی کرده است که استفاده‌های نامقید از یک نام در درون یک کلاس، باید در سرتاسر دامنهٔ کامل آن کلاس معنای یکسانی داشته باشند؛ بنابراین اعلان یک نام پس از استفاده از آن، ساختاری نامعتبر (ill-formed) محسوب می‌شود:
.Sp
.Vb 3
\&        struct A;
\&        struct B1 { A a; typedef A A; }; // warning, \*(AqA\*(Aq changes meaning
\&        struct B2 { A a; struct A { }; }; // error, \*(AqA\*(Aq changes meaning
.Ve
.Sp
به‌طور پیش‌فرض، حالت B1 تنها یک هشدار است زیرا هر دو اعلان نوع یکسانی دارند، در حالی که حالت B2 یک خطا است. هر دو پیام عیب‌یابی را می‌توان با \fB\-Wno\-changes\-meaning\fR غیرفعال کرد. همچنین، حالت خطا را می‌توان با استفاده از \&\fB\-Wno\-error=changes\-meaning\fR یا \fB\-fpermissive\fR به یک هشدار تقلیل داد.
.Sp
هر دو پیام عیب‌یابی همچنین توسط \fB\-fms\-extensions\fR فرونشانی می‌شوند.
.IP \fB\-Wchar\-subscripts\fR 4
.IX Item "-Wchar-subscripts"
اگر یک اندیس آرایه از نوع \f(CW\*(C`char\*(C'\fR باشد، هشدار می‌دهد. این یک علت شایع خطا است، زیرا برنامه‌نویسان اغلب فراموش می‌کنند که این نوع روی برخی ماشین‌ها علامت‌دار (signed) است. به \f(CW@xref\fR{Characters implementation} و \&\fR\f(CB\*(C`char\*(C'\fR\fB type signedness\fR مراجعه کنید.
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود. در صورت فعال بودن، این هشدار صرف‌نظر از اینکه \f(CW\*(C`char\*(C'\fR به‌طور پیش‌فرض روی سیستم مقصد بدون علامت است یا خیر صادر می‌شود، و همچنین تحت تأثیر گزینه‌های \fB\-fsigned\-char\fR یا \fB\-funsigned\-char\fR قرار نمی‌گیرد.
.IP \fB\-Wno\-coverage\-mismatch\fR 4
.IX Item "-Wno-coverage-mismatch"
چنانچه هنگام استفاده از گزینهٔ \&\fB\-fprofile\-use\fR، پروفایل‌های بازخورد تطابق نداشته باشند، هشدار می‌دهد.
اگر یک فایل منبع در فاصلهٔ بین کامپایل با \fB\-fprofile\-generate\fR و کامپایل با \fB\-fprofile\-use\fR تغییر کند، فایل‌های حاوی بازخورد پروفایل ممکن است با فایل منبع همخوانی نداشته باشند و GCC نتواند از اطلاعات بازخورد پروفایل استفاده کند. به‌طور پیش‌فرض، این هشدار فعال است و به‌صورت یک خطا در نظر گرفته می‌شود. از \fB\-Wno\-coverage\-mismatch\fR می‌توان برای غیرفعال کردن هشدار، یا از \fB\-Wno\-error=coverage\-mismatch\fR برای غیرفعال کردن خطا استفاده کرد. غیرفعال کردن خطا برای این هشدار می‌تواند منجر به تولید کدهای ضعیف بهینه‌سازی‌شده شود و تنها در مواردی با تغییرات بسیار جزئی مانند رفع باگ‌ها در یک پایه‌کد موجود کاربرد دارد. غیرفعال‌سازی کامل این هشدار توصیه نمی‌شود.
.IP \fB\-Wno\-coverage\-too\-many\-conditions\fR 4
.IX Item "-Wno-coverage-too-many-conditions"
چنانچه از \fB\-fcondition\-coverage\fR استفاده شود و یک عبارت دارای جملات بیش از حد باشد و GCC از پوشش (coverage) صرف‌نظر کند، هشدار می‌دهد. صرف‌نظر کردن از پوشش زمانی رخ می‌دهد که تعداد عبارات شرطی بیشتر از تعداد بیت‌های موجود در یک \f(CW\*(C`gcov_type_unsigned\*(C'\fR باشد. این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-Wno\-coverage\-too\-many\-paths\fR 4
.IX Item "-Wno-coverage-too-many-paths"
چنانچه از \fB\-fpath\-coverage\fR استفاده شود و یک تابع دارای مسیرهای بیش از حد باشد و GCC از پوشش صرف‌نظر کند، هشدار می‌دهد. صرف‌نظر کردن توسط \&\fB\-fpath\-coverage\-limit\fR کنترل می‌شود. این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-Wno\-coverage\-invalid\-line\-number\fR 4
.IX Item "-Wno-coverage-invalid-line-number"
در صورتی که یک تابع به دلیل ماکروهای نامعتبر شماره خط (linenum) زودتر از زمان شروع خود به پایان برسد، هشدار می‌دهد. این هشدار تنها در صورت فعال بودن \fB\-\-coverage\fR صادر می‌شود.
.Sp
به‌طور پیش‌فرض، این هشدار فعال است و به‌صورت یک خطا در نظر گرفته می‌شود. از \fB\-Wno\-coverage\-invalid\-line\-number\fR می‌توان برای غیرفعال کردن هشدار، یا از \fB\-Wno\-error=coverage\-invalid\-line\-number\fR برای غیرفعال کردن خطا استفاده کرد.
.IP "\fB\-Wno\-cpp\fR (تنها C، Objective\-C، C++، Objective\-C++ و Fortran)" 4
.IX Item "-Wno-cpp (C, Objective-C, C++, Objective-C++ and Fortran only)"
پیام‌های هشدار صادرشده توسط دستورالعمل‌های \f(CW\*(C`#warning\*(C'\fR را فرونشانی می‌کند.
.IP "\fB\-Wdouble\-promotion\fR (تنها C، C++، Objective\-C و Objective\-C++)" 4
.IX Item "-Wdouble-promotion (C, C++, Objective-C and Objective-C++ only)"
هنگامی که مقداری از نوع \f(CW\*(C`float\*(C'\fR به‌طور ضمنی به \f(CW\*(C`double\*(C'\fR ارتقا می‌یابد، یک هشدار صادر می‌کند. پردازنده‌های دارای واحد ممیز شناور ۳۲ بیتی «دقت یگانه» (single-precision)، نوع \f(CW\*(C`float\*(C'\fR را به‌صورت سخت‌افزاری پیاده‌سازی می‌کنند، اما \f(CW\*(C`double\*(C'\fR را به‌صورت نرم‌افزاری شبیه‌سازی می‌نمایند. در چنین ماشین‌هایی، انجام محاسبات با استفاده از مقادیر \f(CW\*(C`double\*(C'\fR به دلیل بار پردازشی ناشی از شبیه‌سازی نرم‌افزاری، بسیار پرهزینه‌تر است.
.Sp
انجام تصادفی محاسبات با \f(CW\*(C`double\*(C'\fR بسیار آسان است، زیرا مقادیر لفظی ممیز شناور به‌طور ضمنی از نوع \f(CW\*(C`double\*(C'\fR هستند. به‌عنوان مثال در:
.Sp
.Vb 4
\&        float area(float radius)
\&        {
\&           return 3.14159 * radius * radius;
\&        }
.Ve
.Sp
کامپایلر کل محاسبات را با \f(CW\*(C`double\*(C'\fR انجام می‌دهد زیرا مقدار لفظی ممیز شناور از نوع \f(CW\*(C`double\*(C'\fR است.
.IP "\fB\-Wduplicate\-decl\-specifier\fR (تنها C و Objective\-C)" 4
.IX Item "-Wduplicate-decl-specifier (C and Objective-C only)"
چنانچه یک اعلان دارای مشخص‌کنندهٔ تکراریِ \f(CW\*(C`const\*(C'\fR، \f(CW\*(C`volatile\*(C'\fR، \&\f(CW\*(C`restrict\*(C'\fR یا \f(CW\*(C`_Atomic\*(C'\fR باشد، هشدار می‌دهد. این هشدار توسط \&\fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wformat\fR 4
.IX Item "-Wformat"
.PD 0
.IP \fB\-Wformat=\fR\fIn\fR 4
.IX Item "-Wformat=n"
.PD
فراخوانی‌های \f(CW\*(C`printf\*(C'\fR، \f(CW\*(C`scanf\*(C'\fR و غیره را بررسی می‌کند تا اطمینان حاصل شود که آرگومان‌های ارائه‌شده دارای انواعی متناسب با رشتهٔ قالب‌بندی مشخص‌شده هستند، و تبدیل‌های مشخص‌شده در رشتهٔ قالب‌بندی معنادار می‌باشند. این بررسی شامل توابع استاندارد و سایر توابع مشخص‌شده توسط ویژگی‌های format، در خانواده‌های \f(CW\*(C`printf\*(C'\fR، \&\f(CW\*(C`scanf\*(C'\fR، \f(CW\*(C`strftime\*(C'\fR و \f(CW\*(C`strfmon\*(C'\fR (یک افزونهٔ X/Open، که در استاندارد C وجود ندارد) (یا سایر خانواده‌های مختص به معماری هدف) می‌شود. اینکه کدام توابع بدون مشخص شدن ویژگی‌های format بررسی شوند، بستگی به نسخهٔ استاندارد انتخاب‌شده دارد، و این‌گونه بررسی‌های توابع بدون ویژگی مشخص‌شده با گزینه‌های \&\fB\-ffreestanding\fR یا \fB\-fno\-builtin\fR غیرفعال می‌شوند.
.Sp
قالب‌ها بر اساس قابلیت‌های قالب‌بندی پشتیبانی‌شده توسط نسخهٔ 2.2 از GNU libc بررسی می‌شوند. این قابلیت‌ها شامل تمام ویژگی‌های ISO C90 و C99 و همچنین ویژگی‌هایی از مشخصات Single Unix و برخی افزونه‌های BSD و GNU است. سایر پیاده‌سازی‌های کتابخانه ممکن است از تمام این قابلیت‌ها پشتیبانی نکنند؛ GCC از هشدار دادن دربارهٔ قابلیت‌هایی که فراتر از محدودیت‌های یک کتابخانهٔ خاص هستند پشتیبانی نمی‌کند. با این حال، اگر \fB\-Wpedantic\fR به همراه \fB\-Wformat\fR استفاده شود، دربارهٔ قابلیت‌های قالب‌بندی که در نسخهٔ استاندارد انتخاب‌شده نیستند هشدار داده می‌شود (اما نه برای قالب‌های \f(CW\*(C`strfmon\*(C'\fR، زیرا آن‌ها در هیچ نسخه‌ای از استاندارد C قرار ندارند).
.RS 4.IP \fB\-Wformat=1\fR 4
.IX Item "-Wformat=1"
.PD 0
.IP \fB\-Wformat\fR 4
.IX Item "-Wformat"
.PD
گزینهٔ \fB\-Wformat\fR معادل \fB\-Wformat=1\fR، و
\&\fB\-Wno\-format\fR معادل \fB\-Wformat=0\fR است. از آنجا که
\&\fB\-Wformat\fR همچنین آرگومان‌های قالب تهی (null) را برای چندین
تابع بررسی می‌کند، \fB\-Wformat\fR به‌طور ضمنی \fB\-Wnonnull\fR را نیز در بر دارد. برخی
جنبه‌های این سطح از بررسی قالب را می‌توان با این
گزینه‌ها غیرفعال کرد: \fB\-Wno\-format\-contains\-nul\fR، \fB\-Wno\-format\-diag\fR،
\&\fB\-Wno\-format\-extra\-args\fR و \fB\-Wno\-format\-zero\-length\fR.
\&\fB\-Wformat\fR توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wformat=2\fR 4
.IX Item "-Wformat=2"
\fB\-Wformat\fR را به‌علاوهٔ بررسی‌های قالب اضافی فعال می‌کند. در حال حاضر
معادل \fB\-Wformat \-Wformat\-nonliteral \-Wformat\-security
\&\-Wformat\-y2k\fR است.
.RE
.RS 4
.RE
.IP \fB\-Wno\-format\-contains\-nul\fR 4
.IX Item "-Wno-format-contains-nul"
در صورت مشخص شدن \fB\-Wformat\fR، دربارهٔ رشته‌های قالبی که
حاوی بایت‌های NUL هستند هشدار نده.
.IP \fB\-Wno\-format\-diag\fR 4
.IX Item "-Wno-format-diag"
در صورت مشخص شدن \fB\-Wformat\fR، دربارهٔ رشته‌های قالبی که
برای پیام‌های تشخیصی GCC نامناسب هستند هشدار نده.
.IP \fB\-Wno\-format\-extra\-args\fR 4
.IX Item "-Wno-format-extra-args"
در صورت مشخص شدن \fB\-Wformat\fR، دربارهٔ آرگومان‌های اضافی یک
تابع قالب \f(CW\*(C`printf\*(C'\fR یا \f(CW\*(C`scanf\*(C'\fR هشدار نده. استاندارد C مشخص
می‌کند که چنین آرگومان‌هایی نادیده گرفته می‌شوند.
.Sp
در جایی که آرگومان‌های استفاده‌نشده میان آرگومان‌های استفاده‌شده‌ای قرار دارند که
با مشخص‌کننده‌های شماره عملوند \fB$\fR مشخص شده‌اند، معمولاً
همچنان هشدار داده می‌شود، زیرا پیاده‌سازی نمی‌تواند بداند چه
نوعی را باید به \f(CW\*(C`va_arg\*(C'\fR فرستاد تا از آرگومان‌های استفاده‌نشده رد شود. با این حال،
در مورد قالب‌های \f(CW\*(C`scanf\*(C'\fR، این گزینه در صورتی که همهٔ آرگومان‌های استفاده‌نشده اشاره‌گر باشند،
هشدار را فرومی‌نشاند، چرا که استاندارد Single Unix مشخص می‌کند
که چنین آرگومان‌های استفاده‌نشده‌ای مجاز هستند.
.IP \fB\-Wformat\-overflow\fR 4
.IX Item "-Wformat-overflow"
.PD 0
.IP \fB\-Wformat\-overflow=\fR\fIlevel\fR 4
.IX Item "-Wformat-overflow=level"
.PD
دربارهٔ فراخوانی‌های توابع ورودی/خروجی قالب‌بندی‌شده مانند \f(CW\*(C`sprintf\*(C'\fR
و \f(CW\*(C`vsprintf\*(C'\fR که ممکن است بافر مقصد را سرریز کنند هشدار می‌دهد. هنگامی که
تعداد دقیق بایت‌های نوشته‌شده توسط یک راهنمای قالب را نتوان در
زمان کامپایل تعیین کرد، بر اساس روش‌های اکتشافی وابسته به
آرگومان \fIlevel\fR و بهینه‌سازی تخمین زده می‌شود. در حالی که فعال‌سازی بهینه‌سازی
در بیشتر موارد دقت هشدار را بهبود می‌بخشد، ممکن است به
موارد مثبت کاذب نیز منجر شود.
.RS 4
.IP \fB\-Wformat\-overflow\fR 4
.IX Item "-Wformat-overflow"
.PD 0
.IP \fB\-Wformat\-overflow=1\fR 4
.IX Item "-Wformat-overflow=1"
.PD
سطح \fI1\fR از \fB\-Wformat\-overflow\fR که توسط \fB\-Wformat\fR فعال می‌شود،
رویکردی محتاطانه در پیش می‌گیرد که تنها دربارهٔ فراخوانی‌هایی هشدار می‌دهد که به احتمال
بسیار زیاد بافر را سرریز می‌کنند. در این سطح، فرض می‌شود آرگومان‌های عددی راهنماهای قالب
با مقادیر نامعلوم دارای مقدار یک هستند، و رشته‌های با طول نامعلوم
خالی فرض می‌شوند. آرگومان‌های عددی که مشخص است به زیرمجموعه‌ای از نوع خود محدود شده‌اند،
یا آرگومان‌های رشته‌ای که خروجی آن‌ها چه با دقت راهنما و چه با مجموعه‌ای متناهی از رشته‌های
تحت‌اللفظی محدود شده است، فرض می‌شود مقداری در آن بازه می‌گیرند که
بیشترین بایت را در خروجی تولید می‌کند. برای مثال، فراخوانی \f(CW\*(C`sprintf\*(C'\fR
زیر خطا تشخیص داده می‌شود زیرا حتی در صورتی که هر دو \fIa\fR و \fIb\fR برابر با صفر باشند،
نویسهٔ NUL پایانی (\f(CW\*(Aq\e0\*(Aq\fR) که توسط تابع به انتهای بافر مقصد
پیوست می‌شود، فراتر از انتهای آن نوشته خواهد شد. افزایش
اندازهٔ بافر به میزان تنها یک بایت برای جلوگیری از
هشدار کافی است، اگرچه ممکن است برای جلوگیری از سرریز کافی نباشد.
.Sp
.Vb 5
\&        void f (int a, int b)
\&        {
\&          char buf [13];
\&          sprintf (buf, "a = %i, b = %i\en", a, b);
\&        }
.Ve
.IP \fB\-Wformat\-overflow=2\fR 4
.IX Item "-Wformat-overflow=2"
سطح \fI2\fR همچنین دربارهٔ فراخوانی‌هایی هشدار می‌دهد که در صورت وجود آرگومانی با
طول یا بزرگی کافی، ممکن است بافر مقصد را سرریز کنند. در سطح
\&\fI2\fR، آرگومان‌های عددی نامعلوم دارای کمترین مقدار قابل‌نمایش برای
انواع علامت‌دار با دقتی بیشتر از ۱، و در غیر این صورت بیشترین مقدار قابل‌نمایش فرض می‌شوند. آرگومان‌های رشته‌ای نامعلومی
که نمی‌توان فرض کرد طول آن‌ها توسط دقت راهنما،
یا توسط مجموعه‌ای متناهی از رشته‌های تحت‌اللفظی که ممکن است به آن‌ها ارزیابی شوند، یا آرایه نویسه‌ای که ممکن است به آن اشاره کنند محدود است،
با طول ۱ نویسه در نظر گرفته می‌شوند.
.Sp
در سطح \fI2\fR، فراخوانی در مثال بالا مجدداً تشخیص داده می‌شود، اما
این بار به این دلیل که با برابر بودن \fIa\fR با یک \f(CW\*(C`INT_MIN\*(C'\fR ۳۲ بیتی، نخستین
راهنمای \f(CW%i\fR برخی از ارقام خود را فراتر از انتهای
بافر مقصد خواهد نوشت. برای ایمن‌سازی فراخوانی صرف‌نظر از مقادیر
این دو متغیر، اندازهٔ بافر مقصد باید به حداقل ۳۴ بایت افزایش
یابد. GCC حداقل اندازهٔ بافر را در یک یادداشت اطلاعاتی پس از هشدار می‌آورد.
.Sp
یک راهکار جایگزین برای افزایش اندازهٔ بافر مقصد، محدود کردن
دامنهٔ مقادیر قالب‌بندی‌شده است. حداکثر طول آرگومان‌های رشته‌ای را
می‌توان با مشخص کردن دقت در راهنمای قالب محدود کرد. هنگامی که بتوان
فرض کرد آرگومان‌های عددی راهنماهای قالب به مقداری کمتر از دقت نوع خود محدود
هستند، انتخاب یک اصلاح‌کنندهٔ طول مناسب برای مشخص‌کنندهٔ قالب،
اندازهٔ مورد نیاز بافر را کاهش می‌دهد. برای مثال، اگر در مثال بالا
بتوان فرض کرد که \fIa\fR و \fIb\fR در محدودهٔ دقت
نوع \f(CW\*(C`short int\*(C'\fR هستند، استفاده از راهنمای قالب \f(CW%hi\fR
یا تبدیل صریح آرگومان به \f(CW\*(C`short\*(C'\fR، حداکثر اندازهٔ
مورد نیاز بافر را به ۲۴ بایت کاهش می‌دهد.
.Sp
.Vb 5
\&        void f (int a, int b)
\&        {
\&          char buf [23];
\&          sprintf (buf, "a = %hi, b = %i\en", a, (short)b);
\&        }
.Ve
.RE
.RS 4
.RE
.IP \fB\-Wno\-format\-zero\-length\fR 4
.IX Item "-Wno-format-zero-length"
در صورت مشخص شدن \fB\-Wformat\fR، دربارهٔ قالب‌های با طول صفر هشدار نده.
استاندارد C مشخص می‌کند که قالب‌های با طول صفر مجاز هستند.
.IP \fB\-Wformat\-nonliteral\fR 4
.IX Item "-Wformat-nonliteral"
در صورت مشخص شدن \fB\-Wformat\fR، همچنین اگر رشتهٔ قالب یک
رشتهٔ تحت‌اللفظی نباشد و در نتیجه نتوان آن را بررسی کرد هشدار بده، مگر این که تابع قالب
آرگومان‌های قالب خود را به‌صورت یک \f(CW\*(C`va_list\*(C'\fR دریافت کند.
.IP \fB\-Wformat\-security\fR 4
.IX Item "-Wformat-security"
در صورت مشخص شدن \fB\-Wformat\fR، همچنین دربارهٔ استفاده از توابع
قالبی که بیانگر مشکلات امنیتی احتمالی هستند هشدار بده. در حال حاضر، این گزینه
دربارهٔ فراخوانی‌های توابع \f(CW\*(C`printf\*(C'\fR و \f(CW\*(C`scanf\*(C'\fR که در آن‌ها
رشتهٔ قالب یک رشتهٔ تحت‌اللفظی نیست و هیچ آرگومان قالبی وجود ندارد،
مانند \f(CW\*(C`printf (foo);\*(C'\fR هشدار می‌دهد. این امر در صورتی که رشتهٔ قالب
از ورودی غیرقابل‌اعتماد آمده باشد و حاوی \fR\f(CB%n\fR\fB\fR باشد، ممکن است یک رخنهٔ امنیتی ایجاد کند. (این
در حال حاضر زیرمجموعه‌ای از مواردی است که \fB\-Wformat\-nonliteral\fR دربارهٔ آن‌ها هشدار می‌دهد، اما
در آینده ممکن است هشدارهایی به \fB\-Wformat\-security\fR افزوده شوند که در
\fB\-Wformat\-nonliteral\fR گنجانده نشده باشند.)
.IP \fB\-Wformat\-signedness\fR 4
.IX Item "-Wformat-signedness"
در صورت مشخص شدن \fB\-Wformat\fR، همچنین اگر رشتهٔ قالب نیازمند
یک آرگومان بدون علامت باشد و آرگومان علامت‌دار باشد، یا برعکس، هشدار بده.
.IP \fB\-Wformat\-truncation\fR 4
.IX Item "-Wformat-truncation"
.PD 0
.IP \fB\-Wformat\-truncation=\fR\fIlevel\fR 4
.IX Item "-Wformat-truncation=level"
.PD
دربارهٔ فراخوانی‌های توابع ورودی/خروجی قالب‌بندی‌شده مانند \f(CW\*(C`snprintf\*(C'\fR
و \f(CW\*(C`vsnprintf\*(C'\fR که ممکن است به بریده شدن خروجی منجر شوند هشدار می‌دهد. هنگامی که تعداد دقیق
بایت‌های نوشته‌شده توسط یک راهنمای قالب را نتوان در
زمان کامپایل تعیین کرد، بر اساس روش‌های اکتشافی وابسته به
آرگومان \fIlevel\fR و بهینه‌سازی تخمین زده می‌شود. در حالی که فعال‌سازی بهینه‌سازی
در بیشتر موارد دقت هشدار را بهبود می‌بخشد، ممکن است به موارد
مثبت کاذب نیز منجر شود. به جز مواردی که خلاف آن ذکر شده باشد، این گزینه از همان
منطق \fB\-Wformat\-overflow\fR استفاده می‌کند.
.RS 4
.IP \fB\-Wformat\-truncation\fR 4
.IX Item "-Wformat-truncation"
.PD 0
.IP \fB\-Wformat\-truncation=1\fR 4
.IX Item "-Wformat-truncation=1"
.PD
سطح \fI1\fR از \fB\-Wformat\-truncation\fR که توسط \fB\-Wformat\fR فعال می‌شود،
رویکردی محتاطانه در پیش می‌گیرد که تنها دربارهٔ فراخوانی‌های توابع کران‌داری هشدار می‌دهد
که مقدار بازگشتی آن‌ها استفاده نشده است و به احتمال بسیار زیاد منجر به
بریده شدن خروجی خواهند شد.
.IP \fB\-Wformat\-truncation=2\fR 4
.IX Item "-Wformat-truncation=2"
سطح \fI2\fR همچنین دربارهٔ فراخوانی‌های توابع کران‌داری هشدار می‌دهد که مقدار
بازگشتی آن‌ها استفاده شده است و در صورت وجود آرگومانی با طول یا بزرگی کافی
ممکن است به بریده شدن خروجی بیانجامند.
.RE
.RS 4
.RE.IP \fB\-Wformat\-y2k\fR 4
.IX Item "-Wformat-y2k"
اگر \fB\-Wformat\fR مشخص شده باشد، دربارهٔ قالب‌های \f(CW\*(C`strftime\*(C'\fR که ممکن است تنها یک سال دو رقمی تولید کنند نیز هشدار می‌دهد.
.IP \fB\-Wnonnull\fR 4
.IX Item "-Wnonnull"
دربارهٔ ارسال یک اشاره‌گر تهی (null pointer) برای آرگومان‌هایی که با مشخصهٔ تابعی \f(CW\*(C`nonnull\*(C'\fR نیازمند مقداری غیرتهی تعیین شده‌اند، هشدار می‌دهد.
.Sp
\&\fB\-Wnonnull\fR در \fB\-Wall\fR و \fB\-Wformat\fR گنجانده شده است. این گزینه می‌تواند با گزینهٔ \fB\-Wno\-nonnull\fR غیرفعال شود.
.IP \fB\-Wnonnull\-compare\fR 4
.IX Item "-Wnonnull-compare"
هنگامی که درون تابع، آرگومان علامت‌گذاری‌شده با مشخصهٔ تابعی \f(CW\*(C`nonnull\*(C'\fR با null مقایسه شود، هشدار می‌دهد.
.Sp
\&\fB\-Wnonnull\-compare\fR در \fB\-Wall\fR گنجانده شده است. این گزینه می‌تواند با گزینهٔ \fB\-Wno\-nonnull\-compare\fR غیرفعال شود.
.IP \fB\-Wnull\-dereference\fR 4
.IX Item "-Wnull-dereference"
اگر کامپایلر مسیرهایی را شناسایی کند که به دلیل ارجاع‌زدایی از یک اشاره‌گر تهی (null)، موجب بروز خطا یا رفتار تعریف‌نشده (undefined behavior) می‌شوند، هشدار می‌دهد. این گزینه تنها زمانی فعال است که \fB\-fdelete\-null\-pointer\-checks\fR فعال باشد، که در بیشتر هدف‌ها با فعال‌سازی بهینه‌سازی‌ها فعال می‌شود. دقت این هشدارها به گزینه‌های بهینه‌سازی استفاده‌شده بستگی دارد.
.IP \fB\-Wno\-musttail\-local\-addr\fR 4
.IX Item "-Wno-musttail-local-addr"
دربارهٔ ارسال اشاره‌گر (یا در C++، یک ارجاع) به متغیر محلی یا برچسب به عنوان آرگومان یک فراخوانی \f(CW\*(C`musttail\*(C'\fR هشدار نمی‌دهد. این متغیرها قبل از دستور فراخوانی دم (tail call) از حوزهٔ دید (scope) خارج می‌شوند.
.IP \fB\-Wmaybe\-musttail\-local\-addr\fR 4
.IX Item "-Wmaybe-musttail-local-addr"
هنگامی که آدرس یک متغیر محلی بتواند به یک فراخوانی \f(CW\*(C`musttail\*(C'\fR نشت پیدا کند (escape)، هشدار می‌دهد، مگر آنکه پیش از فراخوانی \f(CW\*(C`musttail\*(C'\fR از حوزه خارج شده باشد.
.Sp
.Vb 1
\&        int foo (int *);
\&        
\&        int
\&        bar (int *x)
\&        {
\&          if (x[0] == 1)
\&            {
\&              int a = 42;
\&              foo (&a);
\&              /* Without the C<musttail> attribute this call would not
\&                 be tail called, because address of the C<a> variable escapes
\&                 and the second foo call could dereference it.  With the attribute
\&                 the local variables are assumed to go out of scope immediately
\&                 before the tail call instruction and the compiler warns about
\&                 this.  */
\&              [[gnu::musttail]] return foo (nullptr);
\&            }
\&          else
\&            {
\&              {
\&                int a = 42;
\&                foo (&a);
\&              }
\&              /* The C<a> variable isn\*(Aqt already in scope, so even when it
\&                 escaped, even without C<musttail> attribute it would be
\&                 undefined behavior to dereference it and the compiler could
\&                 turn this into a tail call.  No warning is diagnosed here.  */
\&              [[gnu::musttail]] return foo (nullptr);
\&            }
\&        }
.Ve
.Sp
این هشدار با \fB\-Wextra\fR فعال می‌شود.
.IP "\fB\-Wnrvo\fR (تنها C++ و Objective\-C++)" 4
.IX Item "-Wnrvo (C++ and Objective-C++ only)"
اگر کامپایلر رونوشت از یک متغیر محلی به مقدار بازگشتی تابع را در شرایطی که طبق [class.copy.elision] مجاز است حذف نکند (elide)، هشدار می‌دهد. این حذف رونوشت معمولاً با عنوان بهینه‌سازی مقدار بازگشتی نام‌گذاری‌شده (Named Return Value Optimization) شناخته می‌شود. برای نمونه، در مثال زیر کامپایلر نمی‌تواند رونوشت را از هر دو v1 و v2 حذف کند، بنابراین هیچ‌کدام را حذف نمی‌کند.
.Sp
.Vb 7
\&        std::vector<int> f()
\&        {
\&          std::vector<int> v1, v2;
\&          // ...
\&          if (cond) return v1;
\&          else return v2; // warning: not eliding copy
\&        }
.Ve
.IP \fB\-Winfinite\-recursion\fR 4
.IX Item "-Winfinite-recursion"
دربارهٔ فراخوانی‌های بازگشتی بی‌نهایت هشدار می‌دهد. این هشدار در تمام سطوح بهینه‌سازی کارایی دارد، اما برای تشخیص بازگشت بی‌نهایت در فراخوانی‌های میان دو یا چند تابع، به بهینه‌سازی نیاز دارد.
\&\fB\-Winfinite\-recursion\fR در \fB\-Wall\fR گنجانده شده است.
.Sp
این گزینه را با \fB\-Wanalyzer\-infinite\-recursion\fR مقایسه کنید که تشخیصی مشابه ارائه می‌دهد، اما به شیوه‌ای متفاوت (به عنوان بخشی از \fB\-fanalyzer\fR) پیاده‌سازی شده است.
.IP "\fB\-Winit\-self\fR (تنها C، C++، Objective\-C و Objective\-C++)" 4
.IX Item "-Winit-self (C, C++, Objective-C and Objective-C++ only)"
دربارهٔ متغیرهای مقداردهی‌نشده‌ای که با خودشان مقداردهی اولیه می‌شوند هشدار می‌دهد.
توجه داشته باشید که این گزینه تنها می‌تواند همراه با گزینهٔ \fB\-Wuninitialized\fR استفاده شود.
.Sp
برای مثال، GCC در قطعه‌کد زیر تنها زمانی دربارهٔ مقداردهی‌نشده بودن \f(CW\*(C`i\*(C'\fR هشدار می‌دهد که \fB\-Winit\-self\fR مشخص شده باشد:
.Sp
.Vb 5
\&        int f()
\&        {
\&          int i = i;
\&          return i;
\&        }
.Ve
.Sp
این هشدار در C++ توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-implicit\-int\fR (تنها C و Objective\-C)" 4
.IX Item "-Wno-implicit-int (C and Objective-C only)"
این گزینه هشدارهای مربوط به مواردی را که یک اعلان نوعی را مشخص نمی‌کند، کنترل می‌کند.
این هشدار به طور پیش‌فرض، به صورت یک خطا، در C99 و گویش‌های پس از آن در C، و همچنین توسط \fB\-Wall\fR فعال است. این خطا می‌تواند با استفاده از \fB\-fpermissive\fR (همراه با برخی خطاهای دیگر)، یا منحصراً برای این خطا با \fB\-Wno\-error=implicit\-int\fR، به یک هشدار تنزل داده شود.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wno\-implicit\-function\-declaration\fR (تنها C و Objective\-C)" 4
.IX Item "-Wno-implicit-function-declaration (C and Objective-C only)"
این گزینه هشدارهای مربوط به مواردی را که یک تابع پیش از اعلان شدن استفاده می‌شود، کنترل می‌کند.
این هشدار به طور پیش‌فرض، به صورت یک خطا، در C99 و گویش‌های پس از آن در C، و همچنین توسط \fB\-Wall\fR فعال است. این خطا می‌تواند با استفاده از \fB\-fpermissive\fR (همراه با برخی خطاهای دیگر)، یا منحصراً برای این خطا با
\&\fB\-Wno\-error=implicit\-function\-declaration\fR به یک هشدار تنزل داده شود.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wimplicit\fR (تنها C و Objective\-C)" 4
.IX Item "-Wimplicit (C and Objective-C only)"
مشابه \fB\-Wimplicit\-int\fR و \fB\-Wimplicit\-function\-declaration\fR است.
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Whardened\fR 4
.IX Item "-Whardened"
هنگامی که \fB\-fhardened\fR گزینه‌ای از مجموعهٔ خود را فعال نکرده باشد هشدار می‌دهد (برای این مجموعه به \fB\-fhardened\fR مراجعه کنید). برای نمونه، استفادهٔ هم‌زمان از \fB\-fhardened\fR و \fB\-fstack\-protector\fR در خط فرمان باعث می‌شود که \fB\-Whardened\fR هشدار دهد؛ زیرا \fB\-fstack\-protector\-strong\fR توسط \fB\-fhardened\fR فعال نخواهد شد.
.Sp
این هشدار به طور پیش‌فرض فعال است و تنها زمانی اثر دارد که \fB\-fhardened\fR فعال باشد.
.IP \fB\-Wimplicit\-fallthrough\fR 4
.IX Item "-Wimplicit-fallthrough"
\&\fB\-Wimplicit\-fallthrough\fR همانند \fB\-Wimplicit\-fallthrough=3\fR است
و \fB\-Wno\-implicit\-fallthrough\fR همانند
\&\fB\-Wimplicit\-fallthrough=0\fR می‌باشد.
.IP \fB\-Wimplicit\-fallthrough=\fR\fIn\fR 4
.IX Item "-Wimplicit-fallthrough=n"
هنگامی که یک case در عبارت switch به مورد بعدی سرریز کند (fall through)، هشدار می‌دهد. برای نمونه:
.Sp
.Vb 11
\&        switch (cond)
\&          {
\&          case 1:
\&            a = 1;
\&            break;
\&          case 2:
\&            a = 2;
\&          case 3:
\&            a = 3;
\&            break;
\&          }
.Ve
.Sp
این گزینه زمانی که آخرین دستور یک case نتواند سرریز کند، مثلاً زمانی که یک عبارت return یا فراخوانی تابعی با صفت noreturn وجود داشته باشد، هشدار نمی‌دهد. همچنین \fB\-Wimplicit\-fallthrough=\fR دستورهای کنترل جریان، مانند ifها، را در نظر می‌گیرد و تنها در موارد مقتضی هشدار می‌دهد. برای نمونه:
.Sp
.Vb 10
\&        switch (cond)
\&          {
\&          case 1:
\&            if (i > 3) {
\&              bar (5);
\&              break;
\&            } else if (i < 1) {
\&              bar (0);
\&            } else
\&              return;
\&          default:
\&            ...
\&          }
.Ve
.Sp
از آن‌جا که مواردی وجود دارد که در آن‌ها سرریز شدن case در switch مطلوب است، GCC مشخصه‌ای با نام \f(CW\*(C`_\|_attribute_\|_ ((fallthrough))\*(C'\fR فراهم کرده است که باید همراه با یک عبارت تهی (null statement) استفاده شود تا از هشداری که در حالت عادی رخ می‌داد، جلوگیری کند:
.Sp.Vb 8
\&        switch (cond)
\&          {
\&          case 1:
\&            bar (0);
\&            _\|_attribute_\|_ ((fallthrough));
\&          default:
\&            ...
\&          }
.Ve
.Sp
استانداردهای C++17 و C23 یک روش استاندارد برای فرونشانی هشدار \fB\-Wimplicit\-fallthrough\fR با استفاده از \f(CW\*(C`[[fallthrough]];\*(C'\fR به‌جای صفت GNU ارائه می‌دهند. در C++11 یا C++14، کاربران می‌توانند از \f(CW\*(C`[[gnu::fallthrough]];\*(C'\fR استفاده کنند که یک افزونهٔ GNU است. به‌جای این صفت‌ها، همچنین امکان افزودن یک کامنت fallthrough برای فرونشاندن هشدار وجود دارد. کل بدنهٔ کامنت به سبک C یا C++ باید با عبارت‌های منظم فهرست‌شده در زیر مطابقت داشته باشد. آرگومان گزینهٔ \fIn\fR مشخص می‌کند چه نوع کامنت‌هایی پذیرفته می‌شوند:
.RS 4
.IP "*<\fB\-Wimplicit\-fallthrough=0\fR هشدار را به‌کلی غیرفعال می‌کند.>" 4
.IX Item "*<-Wimplicit-fallthrough=0 disables the warning altogether.>"
.PD 0
.ie n .IP "*<\fB\-Wimplicit\-fallthrough=1\fR با عبارت منظم "".*"" تطابق می‌یابد>" 4
.el .IP "*<\fB\-Wimplicit\-fallthrough=1\fR با عبارت منظم \f(CW.*\fR تطابق می‌یابد>" 4
.IX Item "*<-Wimplicit-fallthrough=1 matches .* regular>"
.PD
و هر کامنتی به‌عنوان کامنت fallthrough استفاده می‌شود.
.IP "*<\fB\-Wimplicit\-fallthrough=2\fR بدون حساسیت به حروف کوچک و بزرگ با>" 4
.IX Item "*<-Wimplicit-fallthrough=2 case insensitively matches>"
عبارت منظم \&\f(CW\*(C`.*falls?[ \et\-]*thr(ough|u).*\*(C'\fR تطابق دارد.
.IP "*<\fB\-Wimplicit\-fallthrough=3\fR با حساسیت به حروف کوچک و بزرگ با یکی از>" 4
.IX Item "*<-Wimplicit-fallthrough=3 case sensitively matches one of the>"
عبارت‌های منظم زیر تطابق می‌یابد:
.RS 4
.ie n .IP "*<""\-fallthrough"">" 4
.el .IP *<\f(CW\-fallthrough\fR> 4
.IX Item "*<-fallthrough>"
.PD 0
.ie n .IP "*<""@fallthrough@"">" 4
.el .IP *<\f(CW@fallthrough@\fR> 4
.IX Item "*<@fallthrough@>"
.ie n .IP "*<""lint \-fallthrough[ \et]*"">" 4
.el .IP "*<\f(CWlint \-fallthrough[ \et]*\fR>" 4
.IX Item "*<lint -fallthrough[ t]*>"
.ie n .IP "*<""[ \et.!]*(ELSE,? |INTENTIONAL(LY)? )?FALL(S | |\-)?THR(OUGH|U)[ \et.!]*(\-[^\en\er]*)?"">" 4
.el .IP "*<\f(CW[ \et.!]*(ELSE,? |INTENTIONAL(LY)? )?FALL(S | |\-)?THR(OUGH|U)[ \et.!]*(\-[^\en\er]*)?\fR>" 4
.IX Item "*<[ t.!]*(ELSE,? |INTENTIONAL(LY)? )?FALL(S | |-)?THR(OUGH|U)[ t.!]*(-[^nr]*)?>"
.ie n .IP "*<""[ \et.!]*(Else,? |Intentional(ly)? )?Fall((s | |\-)[Tt]|t)hr(ough|u)[ \et.!]*(\-[^\en\er]*)?"">" 4
.el .IP "*<\f(CW[ \et.!]*(Else,? |Intentional(ly)? )?Fall((s | |\-)[Tt]|t)hr(ough|u)[ \et.!]*(\-[^\en\er]*)?\fR>" 4
.IX Item "*<[ t.!]*(Else,? |Intentional(ly)? )?Fall((s | |-)[Tt]|t)hr(ough|u)[ t.!]*(-[^nr]*)?>"
.ie n .IP "*<""[ \et.!]*([Ee]lse,? |[Ii]ntentional(ly)? )?fall(s | |\-)?thr(ough|u)[ \et.!]*(\-[^\en\er]*)?"">" 4
.el .IP "*<\f(CW[ \et.!]*([Ee]lse,? |[Ii]ntentional(ly)? )?fall(s | |\-)?thr(ough|u)[ \et.!]*(\-[^\en\er]*)?\fR>" 4
.IX Item "*<[ t.!]*([Ee]lse,? |[Ii]ntentional(ly)? )?fall(s | |-)?thr(ough|u)[ t.!]*(-[^nr]*)?>"
.PD
.RE
.RS 4
.RE
.IP "*<\fB\-Wimplicit\-fallthrough=4\fR با حساسیت به حروف کوچک و بزرگ با یکی از>" 4
.IX Item "*<-Wimplicit-fallthrough=4 case sensitively matches one of the>"
عبارت‌های منظم زیر تطابق می‌یابد:
.RS 4
.ie n .IP "*<""\-fallthrough"">" 4
.el .IP *<\f(CW\-fallthrough\fR> 4
.IX Item "*<-fallthrough>"
.PD 0
.ie n .IP "*<""@fallthrough@"">" 4
.el .IP *<\f(CW@fallthrough@\fR> 4
.IX Item "*<@fallthrough@>"
.ie n .IP "*<""lint \-fallthrough[ \et]*"">" 4
.el .IP "*<\f(CWlint \-fallthrough[ \et]*\fR>" 4
.IX Item "*<lint -fallthrough[ t]*>"
.ie n .IP "*<""[ \et]*FALLTHR(OUGH|U)[ \et]*"">" 4
.el .IP "*<\f(CW[ \et]*FALLTHR(OUGH|U)[ \et]*\fR>" 4
.IX Item "*<[ t]*FALLTHR(OUGH|U)[ t]*>"
.PD
.RE
.RS 4
.RE
.IP "*<\fB\-Wimplicit\-fallthrough=5\fR هیچ کامنتی را به‌عنوان کامنت fallthrough>" 4
.IX Item "*<-Wimplicit-fallthrough=5 doesn't recognize any comments as>"
تشخیص نمی‌دهد؛ تنها صفت‌ها هشدار را غیرفعال می‌کنند.
.RE
.RS 4
.Sp
کامنت باید پس از فاصله‌های خالی و کامنت‌های دیگر اختیاری، با کلیدواژه‌های \f(CW\*(C`case\*(C'\fR یا \f(CW\*(C`default\*(C'\fR، یا با یک برچسب کاربر (user label) که پیش از یک برچسب \f(CW\*(C`case\*(C'\fR یا \f(CW\*(C`default\*(C'\fR قرار دارد دنبال شود.
.Sp
.Vb 8
\&        switch (cond)
\&          {
\&          case 1:
\&            bar (0);
\&            /* FALLTHRU */
\&          default:
\&            ...
\&          }
.Ve
.Sp
هشدار \fB\-Wimplicit\-fallthrough=3\fR با \fB\-Wextra\fR فعال می‌شود.
.RE
.IP "\fB\-Wno\-if\-not\-aligned\fR (فقط C، C++، Objective\-C و Objective\-C++)" 4
.IX Item "-Wno-if-not-aligned (C, C++, Objective-C and Objective-C++ only)"
تعیین می‌کند که آیا هشدارهای صادرشده توسط صفت \f(CW\*(C`warn_if_not_aligned\*(C'\fR باید ایجاد شوند یا خیر. این هشدارها به‌طور پیش‌فرض فعال هستند.
.IP "\fB\-Wignored\-qualifiers\fR (فقط C و C++)" 4
.IX Item "-Wignored-qualifiers (C and C++ only)"
هشدار می‌دهد اگر نوع بازگشتی یک تابع دارای توصیف‌گر نوع (type qualifier) مانند \f(CW\*(C`const\*(C'\fR باشد. برای استاندارد ISO C چنین توصیف‌گری هیچ اثری ندارد، زیرا مقدار بازگردانده‌شده توسط یک تابع یک lvalue نیست. برای C++، این هشدار تنها برای انواع اسکالر یا \f(CW\*(C`void\*(C'\fR صادر می‌شود. استاندارد ISO C انواع بازگشتی مقیدشدهٔ \f(CW\*(C`void\*(C'\fR را در تعاریف توابع ممنوع کرده است، بنابراین چنین انواع بازگشتی حتی بدون این گزینه نیز همیشه یک هشدار دریافت می‌کنند.
.Sp
این هشدار همچنین با \fB\-Wextra\fR فعال می‌شود.
.IP "\fB\-Wno\-ignored\-attributes\fR (فقط C و C++)" 4
.IX Item "-Wno-ignored-attributes (C and C++ only)"
این گزینه هشدارهای مربوط به زمان نادیده گرفته شدن یک صفت را کنترل می‌کند. تفاوت این گزینه با گزینهٔ
\&\fB\-Wattributes\fR در این است که هر زمان کامپایلر تصمیم به نادیده گرفتن (حذف) یک صفت بگیرد هشدار می‌دهد، نه زمانی که صفت ناشناخته باشد، در جای نادرست استفاده شده باشد و غیره. این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-Wmain\fR 4
.IX Item "-Wmain"
هشدار می‌دهد اگر نوع \f(CW\*(C`main\*(C'\fR مشکوک باشد. \f(CW\*(C`main\*(C'\fR باید تابعی با پیوند خارجی (external linkage) باشد که int بازمی‌گرداند و صفر، دو یا سه آرگومان با نوع‌های مناسب می‌گیرد. این هشدار در C++ به‌طور پیش‌فرض فعال است و توسط \fB\-Wall\fR یا \fB\-Wpedantic\fR فعال می‌شود.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wmisleading\-indentation\fR (فقط C و C++)" 4
.IX Item "-Wmisleading-indentation (C and C++ only)"
هنگامی که تورفتگی کد ساختار بلوکی آن را منعکس نمی‌کند هشدار می‌دهد. به‌طور مشخص، برای عبارت‌های \f(CW\*(C`if\*(C'\fR، \f(CW\*(C`else\*(C'\fR، \f(CW\*(C`while\*(C'\fR و
\&\f(CW\*(C`for\*(C'\fR با دستور محافظت‌شده‌ای که از آکوالاد استفاده نمی‌کند و به دنبال آن یک دستور محافظت‌نشده با همان تورفتگی آمده است، هشدار صادر می‌شود.
.Sp
در مثال زیر، فراخوانی «bar» به‌طور گمراه‌کننده‌ای تورفتگی دارد، گویی که تحت شرط «if» محافظت شده است.
.Sp
.Vb 3
\&          if (some_condition ())
\&            foo ();
\&            bar ();  /* Gotcha: this is not guarded by the "if".  */
.Ve
.Sp
در صورت ترکیب تب‌ها و فاصله‌ها، این هشدار از گزینهٔ
\&\fB\-ftabstop=\fR برای تعیین هم‌تراز بودن دستورها استفاده می‌کند
(مقدار پیش‌فرض 8 است).
.Sp
این هشدار برای کدهایی که شامل منطق چندخطی پیش‌پردازنده هستند، مانند مثال زیر، صادر نمی‌شود.
.Sp
.Vb 6
\&          if (flagA)
\&            foo (0);
\&        #if SOME_CONDITION_THAT_DOES_NOT_HOLD
\&          if (flagB)
\&        #endif
\&            foo (1);
.Ve
.Sp
این هشدار پس از یک دستورالعمل \f(CW\*(C`#line\*(C'\fR صادر نمی‌شود، زیرا معمولاً نشان‌دهندهٔ کد خودکار تولیدشده است و نمی‌توان فرضی دربارهٔ چیدمان فایلی که این دستورالعمل به آن ارجاع می‌دهد داشت.
.Sp
این هشدار با \fB\-Wall\fR در C و C++ فعال می‌شود.
.IP \fB\-Wmissing\-attributes\fR 4
.IX Item "-Wmissing-attributes"
هشدار می‌دهد هنگامی که در اعلان یک تابع، یک یا چند صفت که یک تابع مرتبط با آن‌ها اعلان شده است وجود نداشته باشد و غیاب آن‌ها ممکن است بر درستی یا کارایی کد تولیدشده تأثیر نامطلوب بگذارد. برای مثال، این هشدار برای اعلان نام‌های مستعاری (alias) صادر می‌شود که از صفت‌ها برای مشخص کردن الزامات کم‌محدودکننده‌تر نسبت به اهداف خود استفاده می‌کنند. این امر معمولاً نشان‌دهندهٔ یک فرصت بهینه‌سازی بالقوه است. در مقابل، گزینهٔ \fB\-Wattribute\-alias=2\fR هشدارهای صادرشده در هنگامی که نام مستعار محدودکننده‌تر از هدف باشد را کنترل می‌کند، که می‌تواند به تولید کد نادرست منجر شود. صفت‌های مورد بررسی شامل \f(CW\*(C`alloc_align\*(C'\fR، \f(CW\*(C`alloc_size\*(C'\fR،
\&\f(CW\*(C`cold\*(C'\fR، \f(CW\*(C`const\*(C'\fR، \f(CW\*(C`hot\*(C'\fR، \f(CW\*(C`leaf\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR،
\&\f(CW\*(C`nonnull\*(C'\fR، \f(CW\*(C`noreturn\*(C'\fR، \f(CW\*(C`nothrow\*(C'\fR، \f(CW\*(C`pure\*(C'\fR،
\&\f(CW\*(C`returns_nonnull\*(C'\fR و \f(CW\*(C`returns_twice\*(C'\fR هستند.
.Sp
در C++، این هشدار زمانی صادر می‌شود که یک تخصیص صریح (explicit specialization) از یک الگوی اصلی که با صفت‌های \f(CW\*(C`alloc_align\*(C'\fR، \f(CW\*(C`alloc_size\*(C'\fR،
\&\f(CW\*(C`assume_aligned\*(C'\fR، \f(CW\*(C`format\*(C'\fR، \f(CW\*(C`format_arg\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR
یا \f(CW\*(C`nonnull\*(C'\fR اعلان شده، بدون آن صفت اعلان شود. صفت‌های \f(CW\*(C`deprecated\*(C'\fR،
\&\f(CW\*(C`error\*(C'\fR و \f(CW\*(C`warning\*(C'\fR این هشدار را فرونشانی می‌کنند.
.Sp
می‌توانید از صفت \f(CW\*(C`copy\*(C'\fR برای اعمال همان مجموعه صفت‌ها روی یک اعلان مشابه اعلان دیگر بدون شمارش صریح صفت‌ها استفاده کنید. این صفت را می‌توان برای اعلان‌های توابع، متغیرها یا انواع اعمال کرد. \fBCommon Attributes\fR.
.Sp
گزینهٔ \&\fB\-Wmissing\-attributes\fR با \fB\-Wall\fR فعال می‌شود.
.Sp
برای مثال، از آنجا که اعلان الگوی تابع اصلی زیر از هر دو صفت \f(CW\*(C`malloc\*(C'\fR و \f(CW\*(C`alloc_size\*(C'\fR استفاده می‌کند، اعلان تخصیص صریح الگو به دلیل نداشتن یکی از صفت‌ها مشمول هشدار می‌شود.
.Sp.Vb 3
\&        template <class T>
\&        T* _\|_attribute_\|_ ((malloc, alloc_size (1)))
\&        allocate (size_t);
\&        
\&        template <>
\&        void* _\|_attribute_\|_ ((malloc))   // missing alloc_size
\&        allocate<void> (size_t);
.Ve
.IP \fB\-Wmissing\-braces\fR 4
.IX Item "-Wmissing-braces"
اگر مقداردهندهٔ اولیهٔ یک دادهٔ تجمیعی (aggregate) یا union به‌طور کامل درون آکولاد قرار نگرفته باشد، هشدار می‌دهد. در مثال زیر، مقداردهندهٔ اولیه برای \f(CW\*(C`a\*(C'\fR به‌طور کامل درون آکولاد قرار نگرفته است، اما برای \f(CW\*(C`b\*(C'\fR کاملاً درون آکولاد است.
.Sp
.Vb 2
\&        int a[2][2] = { 0, 1, 2, 3 };
\&        int b[2][2] = { { 0, 1 }, { 2, 3 } };
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wmissing\-include\-dirs\fR (فقط C، C++، Objective\-C، Objective\-C++ و Fortran)" 4
.IX Item "-Wmissing-include-dirs (C, C++, Objective-C, Objective-C++ and Fortran only)"
اگر یک دایرکتوری include ارائه‌شده توسط کاربر وجود نداشته باشد، هشدار می‌دهد. این گزینه به‌طور پیش‌فرض برای C، C++، Objective\-C و Objective\-C++ غیرفعال است. برای Fortran، به‌طور پیش‌فرض تا حدی فعال است و فقط برای \-I و \-J هشدار می‌دهد.
.IP \fB\-Wno\-missing\-profile\fR 4
.IX Item "-Wno-missing-profile"
این گزینه هشدارهای مربوط به در دسترس نبودن پروفایل‌های بازخورد را هنگام استفاده از گزینهٔ \fB\-fprofile\-use\fR کنترل می‌کند.
این گزینه مواردی را شناسایی می‌کند که بین کامپایل با \fB\-fprofile\-generate\fR و \fB\-fprofile\-use\fR، یک تابع جدید یا فایل جدید اضافه شده باشد، بدون اینکه پروفایل‌ها مجدداً تولید شوند.
در این موارد، فایل‌های دادهٔ بازخورد پروفایل به ترتیب هیچ اطلاعات بازخورد پروفایلی برای تابع یا فایل تازه اضافه شده ندارند. همچنین در صورتی که فایل‌های داده‌های شمارش پروفایل (.gcda) حذف شوند، GCC نمی‌تواند از هیچ‌گونه اطلاعات بازخورد پروفایل استفاده کند. در تمام این موارد، هشدارهایی صادر می‌شود تا اطلاع دهد که زمان انجام مرحلهٔ تولید پروفایل فرارسیده است.
نادیده گرفتن این هشدار می‌تواند به تولید کدی با بهینه‌سازی ضعیف منجر شود.
می‌توان از \fB\-Wno\-missing\-profile\fR برای غیرفعال کردن هشدار استفاده کرد، اما این کار توصیه نمی‌شود و تنها در صورتی باید انجام شود که نبودِ داده‌های پروفایل توجیه‌پذیر باشد.
.IP \fB\-Wmismatched\-dealloc\fR 4
.IX Item "-Wmismatched-dealloc"
برای فراخوانی توابع آزادسازی حافظه با آرگومان‌های اشاره‌گری که از توابع تخصیصی برگردانده شده‌اند که تابع اولی آزادساز مناسبی برای آن‌ها نیست، هشدار می‌دهد. یک جفت تابع را می‌توان با استفاده از مشخصهٔ \f(CW\*(C`malloc\*(C'\fR به عنوان تخصیص‌دهنده و آزادساز متناظر با یکدیگر پیوند داد. به جز در مواردی که با گزینهٔ \fB\-fno\-builtin\fR غیرفعال شده باشد، توابع استاندارد \f(CW\*(C`calloc\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR، \f(CW\*(C`realloc\*(C'\fR و \f(CW\*(C`free\*(C'\fR، و همچنین شکل‌های متناظر \f(CW\*(C`operator new\*(C'\fR و \f(CW\*(C`operator delete\*(C'\fR در C++ به‌طور ضمنی به عنوان تخصیص‌دهنده و آزادساز منطبق با یکدیگر در نظر گرفته می‌شوند. در مثال زیر \f(CW\*(C`mydealloc\*(C'\fR تابع آزادساز برای اشاره‌گرهای بازگردانده شده از \f(CW\*(C`myalloc\*(C'\fR است.
.Sp
.Vb 1
\&        void mydealloc (void*);
\&        
\&        _\|_attribute_\|_ ((malloc (mydealloc, 1))) void*
\&        myalloc (size_t);
\&        
\&        void f (void)
\&        {
\&          void *p = myalloc (32);
\&          // ...use p...
\&          free (p);   // warning: not a matching deallocator for myalloc
\&          mydealloc (p);   // ok
\&        }
.Ve
.Sp
در C++، گزینهٔ مرتبط \fB\-Wmismatched\-new\-delete\fR عدم تطابق‌های مربوط به \f(CW\*(C`operator new\*(C'\fR یا \f(CW\*(C`operator delete\*(C'\fR را شناسایی می‌کند.
.Sp
گزینهٔ \fB\-Wmismatched\-dealloc\fR در \fB\-Wall\fR گنجانده شده است.
.IP \fB\-Wmultistatement\-macros\fR 4
.IX Item "-Wmultistatement-macros"
دربارهٔ ماکروهای چنددستوری ناامن که به نظر می‌رسد توسط بندی مانند \f(CW\*(C`if\*(C'\fR، \f(CW\*(C`else\*(C'\fR، \f(CW\*(C`for\*(C'\fR، \f(CW\*(C`switch\*(C'\fR یا \f(CW\*(C`while\*(C'\fR محافظت شده‌اند، اما در عمل پس از باز شدن ماکرو تنها دستور اول محافظت می‌شود، هشدار می‌دهد.
.Sp
برای مثال:
.Sp
.Vb 3
\&        #define DOIT x++; y++
\&        if (c)
\&          DOIT;
.Ve
.Sp
مقدار \f(CW\*(C`y\*(C'\fR را بدون قیدوشرط افزایش خواهد داد، نه فقط زمانی که شرط \f(CW\*(C`c\*(C'\fR برقرار باشد.
این مشکل معمولاً با قرار دادن ماکرو درون یک حلقهٔ do\-while برطرف می‌شود:
.Sp
.Vb 3
\&        #define DOIT do { x++; y++; } while (0)
\&        if (c)
\&          DOIT;
.Ve
.Sp
این هشدار در C و C++ توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wparentheses\fR 4
.IX Item "-Wparentheses"
اگر پرانتزها در زمینه‌های خاصی حذف شده باشند هشدار می‌دهد؛ مانند زمانی که در جایی که یک مقدار درستی (truth value) انتظار می‌رود یک انتساب قرار گیرد، یا زمانی که عملگرهایی که تقدم آن‌ها اغلب باعث سردرگمی افراد می‌شود به صورت تو در تو به کار روند.
.Sp
همچنین در صورت ظاهر شدن مقایسه‌ای مانند \f(CW\*(C`x<=y<=z\*(C'\fR هشدار می‌دهد؛ این عبارت معادل \f(CW\*(C`(x<=y ? 1 : 0) <= z\*(C'\fR است که با برداشت معمول از نمادگذاری ریاضی تفاوت دارد.
.Sp
همچنین دربارهٔ استفاده‌های خطرناک از افزونهٔ GNU برای عملگر \f(CW\*(C`?:\*(C'\fR با عملوند میانی حذف‌شده هشدار می‌دهد. هنگامی که شرط در عملگر \f(CW\*(C`?:\*(C'\fR یک عبارت بولی باشد، مقدار حذف‌شده همواره 1 است. در اغلب موارد برنامه‌نویسان انتظار دارند مقداری باشد که درون عبارت شرطی محاسبه شده است.
.Sp
برای C++ این گزینه همچنین برای برخی موارد وجود پرانتزهای غیرضروری در اعلان‌ها، که می‌تواند نشان‌دهندهٔ تلاش برای فراخوانی تابع به جای یک اعلان باشد، هشدار می‌دهد:
.Sp
.Vb 5
\&        {
\&          // Declares a local variable called mymutex.
\&          std::unique_lock<std::mutex> (mymutex);
\&          // User meant std::unique_lock<std::mutex> lock (mymutex);
\&        }
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-self\-move\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-self-move (C++ and Objective-C++ only)"
این گزینه زمانی که مقداری با استفاده از \f(CW\*(C`std::move\*(C'\fR به خودش انتقال داده (move) می‌شود، هشدار می‌دهد. چنین عمل \f(CW\*(C`std::move\*(C'\fR معمولاً هیچ اثری ندارد.
.Sp
.Vb 9
\&        struct T {
\&        ...
\&        };
\&        void fn()
\&        {
\&          T t;
\&          ...
\&          t = std::move (t);
\&        }
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wsequence\-point\fR 4
.IX Item "-Wsequence-point"
دربارهٔ کدهایی که ممکن است به دلیل نقض قواعد نقاط توالی (sequence point) در استانداردهای C و C++ معنای تعریف‌نشده داشته باشند، هشدار می‌دهد.
.Sp
استانداردهای C و C++ ترتیب ارزیابی عبارات در یک برنامه را بر حسب \fIنقاط توالی\fR تعریف می‌کنند که نشان‌دهندهٔ یک ترتیب جزئی بین اجرای بخش‌های برنامه است: بخش‌هایی که قبل از نقطهٔ توالی اجرا می‌شوند و بخش‌هایی که پس از آن اجرا می‌شوند. این نقاط پس از ارزیابی یک عبارت کامل (عبارتی که بخشی از یک عبارت بزرگ‌تر نیست)، پس از ارزیابی عملوند اولِ عملگرهای \f(CW\*(C`&&\*(C'\fR، \f(CW\*(C`||\*(C'\fR، \f(CW\*(C`? :\*(C'\fR یا \f(CW\*(C`,\*(C'\fR (کاما)، پیش از فراخوانی یک تابع (اما پس از ارزیابی آرگومان‌های آن و عبارتی که تابع فراخوانی‌شده را مشخص می‌کند)، و در برخی نقاط دیگر رخ می‌دهند. به غیر از آنچه توسط قواعد نقاط توالی بیان شده است، ترتیب ارزیابی زیرعبارت‌های یک عبارت مشخص نشده است. همهٔ این قواعد تنها یک ترتیب جزئی را توصیف می‌کنند نه یک ترتیب کامل، چرا که به عنوان مثال اگر دو تابع درون یک عبارت فراخوانی شوند بدون اینکه هیچ نقطهٔ توالی بین آن‌ها باشد، ترتیب فراخوانی توابع نامشخص است. با این حال، کمیتهٔ استانداردها تصویب کرده‌اند که فراخوانی توابع نباید همپوشانی داشته باشد.
.Sp
مشخص نشده است که در فاصلهٔ بین نقاط توالی، اعمال تغییرات روی مقادیر اشیاء دقیقاً چه زمانی اثرگذار می‌شود. برنامه‌هایی که رفتار آن‌ها به این موضوع وابسته است، رفتار تعریف‌نشده دارند؛ استانداردهای C و C++ تصریح می‌کنند که: «بین نقطهٔ توالی قبلی و بعدی، مقدار ذخیره‌شدهٔ یک شیء در اثر ارزیابی یک عبارت باید حداکثر یک بار تغییر کند. علاوه بر این، مقدار قبلی تنها باید برای تعیین مقداری که قرار است ذخیره شود خوانده شود.» اگر برنامه‌ای این قواعد را نقض کند، نتایج در هر پیاده‌سازی خاص کاملاً غیرقابل‌پیش‌بینی است.
.Sp
نمونه‌هایی از کدهایی با رفتار تعریف‌نشده عبارتند از \f(CW\*(C`a = a++;\*(C'\fR، \f(CW\*(C`a[n] = b[n++]\*(C'\fR و \f(CW\*(C`a[i++] = i;\*(C'\fR. برخی از موارد پیچیده‌تر توسط این گزینه شناسایی نمی‌شوند، و ممکن است گهگاه نتیجهٔ مثبت کاذب (false positive) بدهد، اما به‌طور کلی مشخص شده که در تشخیص این نوع مشکل در برنامه‌ها نسبتاً مؤثر است.
.Sp
استاندارد C++17 ترتیب ارزیابی عملوندها را در موارد بیشتری تعریف خواهد کرد: به‌ویژه الزام می‌کند که سمت راست یک انتساب باید پیش از سمت چپ آن ارزیابی شود، بنابراین مثال‌های بالا دیگر رفتار تعریف‌نشده نخواهند داشت. اما این گزینه همچنان دربارهٔ آن‌ها هشدار خواهد داد، تا به افراد کمک کند از نوشتن کدهایی که در C و نگارش‌های قبلی C++ تعریف‌نشده هستند خودداری کنند.
.Sp
متن استاندارد به صورتی گیج‌کننده بیان شده است، بنابراین دربارهٔ معنای دقیق قواعد نقاط توالی در موارد ظریف و پیچیده بحث‌هایی وجود دارد. پیوندهایی به گفتگوهای مربوط به این موضوع، شامل تعاریف رسمی پیشنهادی، را می‌توان در صفحهٔ مطالب GCC در <\fBhttps://gcc.gnu.org/readings.html\fR> یافت.
.Sp
این هشدار برای C و C++ توسط \fB\-Wall\fR فعال می‌شود..IP \fB\-Wno\-return\-local\-addr\fR 4
.IX Item "-Wno-return-local-addr"
درباره بازگرداندن اشاره‌گر (یا در C++، مرجع) به متغیری که پس از بازگشت تابع از دامنه خارج می‌شود، هشدار نده.
.IP \fB\-Wreturn\-mismatch\fR 4
.IX Item "-Wreturn-mismatch"
درباره دستورهای return بدون عبارت در توابعی که مقدار \f(CW\*(C`void\*(C'\fR بازنمی‌گردانند هشدار می‌دهد. همچنین درباره دستور \f(CW\*(C`return\*(C'\fR همراه با یک عبارت در تابعی که نوع بازگشتی آن \f(CW\*(C`void\*(C'\fR است، هشدار می‌دهد، مگر اینکه نوع عبارت نیز \f(CW\*(C`void\*(C'\fR باشد. به عنوان یک افزونه گنو (GNU extension)، مورد دوم بدون هشدار پذیرفته می‌شود مگر اینکه \fB\-Wpedantic\fR به کار رود.
.Sp
تلاش برای استفاده از مقدار بازگشتی یک تابع غیر \f(CW\*(C`void\*(C'\fR به‌جز \f(CW\*(C`main\*(C'\fR که با رسیدن به آکولاد پایانی تابع، اجرای آن به پایان می‌رسد، رفتاری تعریف‌نشده است.
.Sp
این هشدار مخصوص C بوده و به طور پیش‌فرض فعال است. در گویش‌های زبان C99 و جدیدتر، به عنوان یک خطا در نظر گرفته می‌شود. می‌توان آن را با استفاده از \fB\-fpermissive\fR (همراه با هشدارهای دیگر)، یا تنها برای این هشدار با \fB\-Wno\-error=return\-mismatch\fR به یک هشدار تنزل داد.
.IP \fB\-Wreturn\-type\fR 4
.IX Item "-Wreturn-type"
هرگاه تابعی با نوع بازگشتی تعریف شود که به طور پیش‌فرض \f(CW\*(C`int\*(C'\fR باشد هشدار می‌دهد (مگر اینکه \fB\-Wimplicit\-int\fR فعال باشد که اولویت دارد). همچنین در صورتی که اجرای برنامه به پایان بدنه تابع برسد، یا اگر تابع اصلاً حاوی هیچ دستور return نباشد، هشدار می‌دهد.
.Sp
تلاش برای استفاده از مقدار بازگشتی یک تابع غیر \f(CW\*(C`void\*(C'\fR به‌جز \f(CW\*(C`main\*(C'\fR که با رسیدن به آکولاد پایانی تابع، اجرای آن به پایان می‌رسد، رفتاری تعریف‌نشده است.
.Sp
برخلاف C، در C++ رسیدن اجرای یک تابع غیر \f(CW\*(C`void\*(C'\fR به‌جز \f(CW\*(C`main\*(C'\fR به پایان بدنه آن، حتی زمانی که مقدار تابع استفاده نشود، منجر به رفتار تعریف‌نشده (undefined behavior) می‌شود.
.Sp
این هشدار در C++ به طور پیش‌فرض فعال است و در غیر این صورت با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wno\-shift\-count\-negative\fR 4
.IX Item "-Wno-shift-count-negative"
هشدارهای مربوط به منفی بودن مقدار شیفت را کنترل می‌کند.
این هشدار به طور پیش‌فرض فعال است.
.IP \fB\-Wno\-shift\-count\-overflow\fR 4
.IX Item "-Wno-shift-count-overflow"
هشدارهای مربوط به بزرگ‌تر یا مساوی بودن مقدار شیفت نسبت به پهنای بیتی نوع داده را کنترل می‌کند. این هشدار به طور پیش‌فرض فعال است.
.IP \fB\-Wshift\-negative\-value\fR 4
.IX Item "-Wshift-negative-value"
در صورت شیفت به چپ یک مقدار منفی هشدار می‌دهد. این هشدار توسط \fB\-Wextra\fR در حالت‌های C99 (و جدیدتر) و C++11 تا C++17 فعال می‌شود.
.IP \fB\-Wno\-shift\-overflow\fR 4
.IX Item "-Wno-shift-overflow"
.PD 0
.IP \fB\-Wshift\-overflow=\fR\fIn\fR 4
.IX Item "-Wshift-overflow=n"
.PD
این گزینه‌ها هشدارهای مربوط به سرریزهای شیفت به چپ را کنترل می‌کنند.
.RS 4
.IP \fB\-Wshift\-overflow=1\fR 4
.IX Item "-Wshift-overflow=1"
این سطح هشدار \fB\-Wshift\-overflow\fR است و به طور پیش‌فرض در حالت‌های C99 و C++11 (و جدیدتر) فعال است. این سطح هشدار درباره شیفت به چپ مقدار 1 به درون بیت علامت (sign bit) هشدار نمی‌دهد. (با این حال، در C، چنین سرریزی همچنان در زمینه‌هایی که یک عبارت ثابت صحیح الزامی است، پذیرفته نمی‌شود.) در حالت C++20 (و جدیدتر) هیچ هشداری صادر نمی‌شود، زیرا شیفت‌های به چپ علامت‌دار همیشه سرریز چرخشی دارند (wrap می‌شوند).
.IP \fB\-Wshift\-overflow=2\fR 4
.IX Item "-Wshift-overflow=2"
این سطح هشدار همچنین درباره شیفت به چپ مقدار 1 به درون بیت علامت هشدار می‌دهد، مگر اینکه حالت C++14 (یا جدیدتر) فعال باشد.
.RE
.RS 4
.RE
.IP \fB\-Wswitch\fR 4
.IX Item "-Wswitch"
هرگاه یک دستور \f(CW\*(C`switch\*(C'\fR اندیسی از نوع شمارشی داشته باشد و برای یک یا چند کد نام‌گذاری‌شده از آن شمارش فاقد \f(CW\*(C`case\*(C'\fR باشد، هشدار می‌دهد. (حضور برچسب \f(CW\*(C`default\*(C'\fR مانع از این هشدار می‌شود.) برچسب‌های \f(CW\*(C`case\*(C'\fR که با مقادیر شمارشی همخوانی ندارند نیز هنگام استفاده از این گزینه موجب هشدار می‌شوند، مگر اینکه شمارش با مشخصه \f(CW\*(C`flag_enum\*(C'\fR علامت‌گذاری شده باشد.
این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wswitch\-default\fR 4
.IX Item "-Wswitch-default"
هرگاه یک دستور \f(CW\*(C`switch\*(C'\fR فاقد مورد \f(CW\*(C`default\*(C'\fR باشد، هشدار می‌دهد.
.IP \fB\-Wswitch\-enum\fR 4
.IX Item "-Wswitch-enum"
هرگاه یک دستور \f(CW\*(C`switch\*(C'\fR اندیسی از نوع شمارشی داشته باشد و برای یک یا چند کد نام‌گذاری‌شده از آن شمارش فاقد \f(CW\*(C`case\*(C'\fR باشد، هشدار می‌دهد. برچسب‌های \f(CW\*(C`case\*(C'\fR که با مقادیر شمارشی همخوانی ندارند نیز هنگام استفاده از این گزینه موجب هشدار می‌شوند، مگر اینکه شمارش با مشخصه \f(CW\*(C`flag_enum\*(C'\fR مشخص شده باشد. تنها تفاوت بین \fB\-Wswitch\fR و این گزینه در این است که این گزینه حتی در صورت وجود برچسب \f(CW\*(C`default\*(C'\fR نیز درباره کد شمارشی از قلم افتاده هشدار می‌دهد.
.IP \fB\-Wno\-switch\-bool\fR 4
.IX Item "-Wno-switch-bool"
زمانی که یک دستور \f(CW\*(C`switch\*(C'\fR اندیسی از نوع بولی (boolean) دارد و مقادیر case خارج از محدوده نوع بولی هستند، هشدار نده. می‌توان این هشدار را با تبدیل نوع عبارت کنترلی به نوعی غیر از \f(CW\*(C`bool\*(C'\fR فرونشاند. برای نمونه:
.Sp
.Vb 4
\&        switch ((int) (a == 4))
\&          {
\&          ...
\&          }
.Ve
.Sp
این هشدار به طور پیش‌فرض برای برنامه‌های C و C++ فعال است.
.IP \fB\-Wno\-switch\-outside\-range\fR 4
.IX Item "-Wno-switch-outside-range"
این گزینه هشدارهایی را کنترل می‌کند که در آن‌ها یک case در دستور \f(CW\*(C`switch\*(C'\fR دارای مقداری خارج از محدوده نوع مربوطه خود باشد. این هشدار به طور پیش‌فرض برای برنامه‌های C و C++ فعال است.
.IP \fB\-Wno\-switch\-unreachable\fR 4
.IX Item "-Wno-switch-unreachable"
زمانی که یک دستور \f(CW\*(C`switch\*(C'\fR حاوی دستورهایی بین عبارت کنترلی و نخستین برچسب case باشد که هرگز اجرا نخواهند شد، هشدار نده. برای نمونه:
.Sp
.Vb 7
\&        switch (cond)
\&          {
\&           i = 15;
\&          ...
\&           case 5:
\&          ...
\&          }
.Ve
.Sp
اگر دستور بین عبارت کنترلی و نخستین برچسب case صرفاً یک اعلان باشد، \fB\-Wswitch\-unreachable\fR هشداری صادر نمی‌کند:
.Sp
.Vb 8
\&        switch (cond)
\&          {
\&           int i;
\&          ...
\&           case 5:
\&           i = 5;
\&          ...
\&          }
.Ve
.Sp
این هشدار به طور پیش‌فرض برای برنامه‌های C و C++ فعال است.
.IP "\fB\-Wsync\-nand\fR (C and C++ only)" 4
.IX Item "-Wsync-nand (C and C++ only)"
زمانی که توابع توکار \f(CW\*(C`_\|_sync_fetch_and_nand\*(C'\fR و \f(CW\*(C`_\|_sync_nand_and_fetch\*(C'\fR استفاده شوند، هشدار می‌دهد. معناشناسی این توابع در GCC 4.4 تغییر کرده است.
.IP \fB\-Wtrivial\-auto\-var\-init\fR 4
.IX Item "-Wtrivial-auto-var-init"
زمانی که \f(CW\*(C`\-ftrivial\-auto\-var\-init\*(C'\fR نتواند متغیر خودکار را مقداردهی اولیه کند، هشدار می‌دهد. یک وضعیت معمول، متغیر خودکاری است که بین عبارت کنترلی و نخستین برچسب case در یک دستور \f(CW\*(C`switch\*(C'\fR اعلان شده باشد.
.IP \fB\-Wunused\-but\-set\-parameter\fR 4
.IX Item "-Wunused-but-set-parameter"
گزینه \fB\-Wunused\-but\-set\-parameter\fR همانند \fB\-Wunused\-but\-set\-parameter=3\fR و \fB\-Wno\-unused\-but\-set\-parameter\fR همانند \fB\-Wunused\-but\-set\-parameter=0\fR است.
.IP \fB\-Wunused\-but\-set\-parameter=\fR\fIn\fR 4
.IX Item "-Wunused-but-set-parameter=n"
هرگاه به یک پارامتر تابع مقداری انتساب داده شود، اما در غیر این صورت (به جز در اعلان آن) استفاده نشود، هشدار می‌دهد.
.Sp
برای فرونشاندن این هشدار از مشخصه \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.Sp
گزینه \fB\-Wunused\-but\-set\-parameter=0\fR این هشدار را غیرفعال می‌کند.
با \fB\-Wunused\-but\-set\-parameter=1\fR تمام استفاده‌ها به جز مقداردهی اولیه و سمت چپ انتسابی که دیگر استفاده نشود، هشدار را غیرفعال می‌کنند.
با \fB\-Wunused\-but\-set\-parameter=2\fR علاوه بر این، استفاده از پارامتر در عملگرهای \f(CW\*(C`++\*(C'\fR و \f(CW\*(C`\-\-\*(C'\fR به عنوان استفاده به شمار نمی‌آید.
و سرانجام با \fB\-Wunused\-but\-set\-parameter=3\fR علاوه بر این، استفاده در \fIparm\fR \f(CW\*(C`\fR\f(CI@\fR\f(CW=\*(C'\fR \fIrhs\fR خارج از \fIrhs\fR به عنوان استفاده به شمار نمی‌آید. برای دیدن مثال‌ها گزینه \fB\-Wunused\-but\-set\-variable=\fR\fIn\fR را ببینید.
.Sp
این هشدار \fB\-Wunused\-but\-set\-parameter=3\fR همچنین توسط \fB\-Wunused\fR همراه با \fB\-Wextra\fR فعال می‌شود..IP \fB\-Wunused\-but\-set\-variable\fR 4
.IX Item "-Wunused-but-set-variable"
گزینهٔ \fB\-Wunused\-but\-set\-variable\fR مشابه
\&\fB\-Wunused\-but\-set\-variable=3\fR و
\&\fB\-Wno\-unused\-but\-set\-variable\fR مشابه
\&\fB\-Wunused\-but\-set\-variable=0\fR است.
.IP \fB\-Wunused\-but\-set\-variable=\fR\fIn\fR 4
.IX Item "-Wunused-but-set-variable=n"
هروقت به یک متغیر محلی مقداری انتساب داده شود، اما در غیر این صورت (به‌جز اعلان آن) استفاده نشود، هشدار می‌دهد.
این هشدار \fB\-Wunused\-but\-set\-variable=3\fR با \fB\-Wall\fR فعال می‌شود.
.Sp
برای فرونشاندن این هشدار از صفت \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.Sp
گزینهٔ \fB\-Wunused\-but\-set\-variable=0\fR هشدار را غیرفعال می‌کند.
با \fB\-Wunused\-but\-set\-variable=1\fR تمام استفاده‌ها به‌جز مقداردهی اولیه
و سمت چپ انتسابی که دیگر استفاده نمی‌شود، هشدار را غیرفعال
می‌کنند.
با \fB\-Wunused\-but\-set\-variable=2\fR علاوه بر این، استفاده از متغیر
در عملگرهای \f(CW\*(C`++\*(C'\fR و \f(CW\*(C`\-\-\*(C'\fR به عنوان استفاده به شمار نمی‌آیند.
و در نهایت با \fB\-Wunused\-but\-set\-variable=3\fR افزون بر موارد پیشین،
استفاده در \fIparm\fR \f(CW\*(C`\fR\f(CI@\fR\f(CW=\*(C'\fR \fIrhs\fR در خارج از \fIrhs\fR به عنوان
استفاده به شمار نمی‌آیند.
.Sp
این هشدار \fB\-Wunused\-but\-set\-variable=3\fR همچنین با
\&\fB\-Wunused\fR که خود توسط \fB\-Wall\fR فعال می‌شود، فعال می‌گردد.
.Sp
.Vb 10
\&        void foo (void)
\&        {
\&          int a = 1; // B<\-Wunused\-variable> warning
\&          int b = 0; // Warning for <n> >= 1
\&          b = 1; b = 2;
\&          int c = 0; // Warning for <n> >= 2
\&          ++c; c\-\-; \-\-c; c++;
\&          int d = 0; // Warning for <n> >= 3
\&          d += 4;
\&          int e = 0; // No warning, cast to void
\&          (void) e;
\&          int f = 0; // No warning, f used
\&          int g = f = 5;
\&          (void) g;
\&          int h = 0; // No warning, preincrement result used
\&          int i = ++h;
\&          (void) i;
\&          int j = 0; // No warning, postdecrement result used
\&          int k = j\-\-;
\&          (void) k;
\&          int l = 0; // No warning, l used
\&          int m = l |= 2;
\&          (void) m;
\&        }
.Ve
.IP \fB\-Wunused\-function\fR 4
.IX Item "-Wunused-function"
هروقت یک تابع static اعلان شده اما تعریف نشده باشد، یا یک تابع
static غیرِ inline استفاده نشده باشد، هشدار می‌دهد.
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wunused\-label\fR 4
.IX Item "-Wunused-label"
هروقت یک برچسب اعلان شده اما استفاده نشده باشد، هشدار می‌دهد.
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.Sp
برای فرونشاندن این هشدار از صفت \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.IP "\fB\-Wunused\-local\-typedefs\fR (فقط C، Objective\-C، C++ و Objective\-C++)" 4
.IX Item "-Wunused-local-typedefs (C, Objective-C, C++ and Objective-C++ only)"
هنگامی که یک typedef که به‌صورت محلی در یک تابع تعریف شده استفاده نشود، هشدار می‌دهد.
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wunused\-parameter\fR 4
.IX Item "-Wunused-parameter"
هروقت یک پارامتر تابع به‌جز در اعلان آن استفاده نشود، هشدار می‌دهد.
این گزینه توسط \f(CW\*(C`\-Wunused\*(C'\fR فعال نمی‌شود مگر اینکه \f(CW\*(C`\-Wextra\*(C'\fR نیز
مشخص شده باشد.
.Sp
برای فرونشاندن این هشدار از صفت \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.IP \fB\-Wno\-unused\-result\fR 4
.IX Item "-Wno-unused-result"
اگر فراخوانندهٔ تابعی که با صفت
\&\f(CW\*(C`warn_unused_result\*(C'\fR علامت‌گذاری شده از مقدار
بازگشتی آن استفاده نکند، هشدار نمی‌دهد. پیش‌فرض \fB\-Wunused\-result\fR است.
.IP \fB\-Wunused\-variable\fR 4
.IX Item "-Wunused-variable"
هروقت یک متغیر محلی یا static به‌جز در اعلان آن استفاده نشود،
هشدار می‌دهد. این گزینه برای C متضمن \fB\-Wunused\-const\-variable=1\fR است،
اما نه برای C++. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.Sp
برای فرونشاندن این هشدار از صفت \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.IP \fB\-Wunused\-const\-variable\fR 4
.IX Item "-Wunused-const-variable"
.PD 0
.IP \fB\-Wunused\-const\-variable=\fR\fIn\fR 4
.IX Item "-Wunused-const-variable=n"
.PD
هروقت یک متغیر static ثابت (const) به‌جز در اعلان آن استفاده نشود، هشدار می‌دهد.
.Sp
برای فرونشاندن این هشدار از صفت \f(CW\*(C`unused\*(C'\fR استفاده کنید.
.RS 4
.IP \fB\-Wunused\-const\-variable=1\fR 4
.IX Item "-Wunused-const-variable=1"
دربارهٔ متغیرهای static const استفاده‌نشده که در واحد ترجمهٔ اصلی تعریف شده‌اند
هشدار می‌دهد، اما دربارهٔ متغیرهای static const اعلان‌شده در سرآیندهای
گنجانده‌شده هشدار نمی‌دهد.
.Sp
گزینهٔ \fB\-Wunused\-const\-variable=1\fR توسط هر یک از
\&\fB\-Wunused\-variable\fR یا \fB\-Wunused\fR برای C فعال می‌شود، اما نه برای
C++. در C این کار فضای ذخیره‌سازی متغیر را اعلان می‌کند، اما در C++ این یک
خطا نیست زیرا متغیرهای const جای \f(CW\*(C`#define\*(C'\fRها را می‌گیرند.
.IP \fB\-Wunused\-const\-variable=2\fR 4
.IX Item "-Wunused-const-variable=2"
این سطح هشدار همچنین برای متغیرهای static ثابتِ استفاده‌نشده در
سرآیندها (به‌جز سرآیندهای سیستمی) هشدار می‌دهد. این سطح معادل شکل کوتاه
\&\fB\-Wunused\-const\-variable\fR است. این سطح باید صریحاً
در هر دو زبان C و C++ درخواست شود زیرا ممکن است پاک‌سازی تمام
سرآیندهای گنجانده‌شده دشوار باشد.
.RE
.RS 4
.RE
.IP \fB\-Wunused\-value\fR 4
.IX Item "-Wunused-value"
هروقت یک گزاره نتیجه‌ای را محاسبه کند که صراحتاً استفاده
نمی‌شود، هشدار می‌دهد. برای فرونشاندن این هشدار عبارت استفاده‌نشده را به
\&\f(CW\*(C`void\*(C'\fR تبدیل نوع کنید. این شامل یک گزاره-عبارت یا سمت چپ
یک عبارت کاما است که فاقد عوارض جانبی باشد. برای نمونه،
عبارتی مانند \f(CW\*(C`x[i,j]\*(C'\fR موجب هشدار می‌شود، در حالی که
\&\f(CW\*(C`x[(void)i,j]\*(C'\fR هشداری ایجاد نمی‌کند.
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wunused\fR 4
.IX Item "-Wunused"
تمام گزینه‌های \fB\-Wunused\fR بالا به همراه یکدیگر، به‌جز مواردی که مستند
شده است باید صریحاً مشخص شوند.
.Sp
برای دریافت هشدار دربارهٔ یک پارامتر استفاده‌نشدهٔ تابع، باید
یا \fB\-Wextra \-Wunused\fR را مشخص کنید (توجه داشته باشید که \fB\-Wall\fR متضمن
\&\fB\-Wunused\fR است)، یا به‌طور جداگانه \fB\-Wunused\-parameter\fR و/یا
\&\fB\-Wunused\-but\-set\-parameter\fR را مشخص نمایید.
.Sp
گزینهٔ \fB\-Wunused\fR تنها \fB\-Wunused\-const\-variable=1\fR را به جای
\&\fB\-Wunused\-const\-variable\fR فعال می‌کند، و آن هم فقط برای C، نه C++.
.IP "\fB\-Wuse\-after\-free\fR (فقط C، Objective\-C، C++ و Objective\-C++)" 4
.IX Item "-Wuse-after-free (C, Objective-C, C++ and Objective-C++ only)"
.PD 0
.IP \fB\-Wuse\-after\-free=\fR\fIn\fR 4
.IX Item "-Wuse-after-free=n"
.PD
دربارهٔ استفاده از اشاره‌گرها به اشیایی که به‌صورت پویا تخصیص یافته‌اند و بر اثر
فراخوانی یک تابع آزادسازی حافظه، به وضعیت نامعین درآمده‌اند، هشدار می‌دهد.
این هشدار در تمام سطوح بهینه‌سازی فعال است، اما ممکن است در حالت با بهینه‌سازی
نسبت به بدون بهینه‌سازی نتایج متفاوتی حاصل کند.
گزینهٔ \fB\-Wuse\-after\-free\fR معادل با \fB\-Wuse\-after\-free=1\fR است.
.RS 4
.IP \fB\-Wuse\-after\-free=1\fR 4
.IX Item "-Wuse-after-free=1"
در سطح ۱، این هشدار تلاش می‌کند فقط استفاده‌های غیرمشروط از اشاره‌گرهایی را
تشخیص دهد که در اثر فراخوانی آزادسازی یا یک فراخوانی موفق به \f(CW\*(C`realloc\*(C'\fR
نامعین شده‌اند، صرف‌نظر از اینکه فراخوانی به بازتخصیص واقعی حافظه انجامیده باشد یا خیر.
این مورد شامل فراخوانی‌های مضاعف \f(CW\*(C`free\*(C'\fR و همچنین استفاده در عبارات
حسابی و رابطه‌ای می‌شود. هرچند رفتار نامعین است، اما استفاده از اشاره‌گرهای نامعین
در عبارات برابری (یا نابرابری) در این سطح تشخیص داده نمی‌شود.
.IP \fB\-Wuse\-after\-free=2\fR 4
.IX Item "-Wuse-after-free=2"
در سطح ۲، علاوه بر استفاده‌های غیرمشروط، این هشدار استفاده‌های مشروط از اشاره‌گرهایی
را نیز که با فراخوانی آزادسازی نامعین شده‌اند تشخیص می‌دهد.
همانند سطح ۲، استفاده در عبارات برابری (یا نابرابری) تشخیص داده
نمی‌شود. برای نمونه، دومین فراخوانی به \f(CW\*(C`free\*(C'\fR در تابع زیر
در این سطح تشخیص داده می‌شود:
.Sp
.Vb 1
\&        struct A { int refcount; void *data; };
\&        
\&        void release (struct A *p)
\&        {
\&          int refcount = \-\-p\->refcount;
\&          free (p);
\&          if (refcount == 0)
\&            free (p\->data);   // warning: p may be used after free
\&        }
.Ve
.IP \fB\-Wuse\-after\-free=3\fR 4
.IX Item "-Wuse-after-free=3"
در سطح ۳، این هشدار استفاده از اشاره‌گرهای نامعین در عبارات برابری را نیز
تشخیص می‌دهد. تمام استفاده‌ها از اشاره‌گرهای نامعین تعریف‌نشده هستند
اما آزمون‌های برابری گاهی پس از فراخوانی‌های \f(CW\*(C`realloc\*(C'\fR ظاهر می‌شوند
تا مشخص کنند آیا فراخوانی منجر به جابه‌جایی شیء به یک نشانی دیگر شده است یا خیر.
آن‌ها در سطحی جداگانه تشخیص داده می‌شوند تا به گذار تدریجی کدهای قدیمی به جایگزین‌های
امن کمک کنند. برای نمونه، آزمون برابری در تابع زیر در این سطح تشخیص داده می‌شود:
.Sp.Vb 1
\&        void adjust_pointers (int**, int);
\&        
\&        void grow (int **p, int n)
\&        {
\&          int **q = (int**)realloc (p, n *= 2);
\&          if (q == p)
\&            return;
\&          adjust_pointers ((int**)q, n);
\&        }
.Ve
.Sp
برای جلوگیری از اخطار در این سطح، به جای اشاره‌گرها، آفست‌ها را در حافظه تخصیص‌یافته ذخیره کنید. این رویکرد نیاز به تنظیم اشاره‌گرهای ذخیره‌شده پس از تخصیص مجدد حافظه را برطرف می‌کند.
.RE
.RS 4
.Sp
\&\fB\-Wuse\-after\-free=2\fR در \fB\-Wall\fR گنجانده شده است.
.RE
.IP "\fB\-Wuseless\-cast\fR (تنها در C، Objective\-C، C++ و Objective\-C++)" 4
.IX Item "-Wuseless-cast (C, Objective-C, C++ and Objective-C++ only)"
هنگامی که یک عبارت به نوع خودش تبدیل (cast) می‌شود، هشدار می‌دهد. این هشدار زمانی که یک شیء کلاس به نوعی غیرمرجع تبدیل شود رخ نمی‌دهد، زیرا این روشی برای ایجاد یک شیء موقت است:
.Sp
.Vb 6
\&        struct S { };
\&        void g (S&&);
\&        void f (S&& arg)
\&        {
\&          g (S(arg)); // make arg prvalue so that it can bind to S&&
\&        }
.Ve
.IP \fB\-Wuninitialized\fR 4
.IX Item "-Wuninitialized"
اگر شیئی با طول عمر ذخیره‌سازی خودکار (automatic) یا تخصیص‌یافته (allocated) بدون مقداردهی اولیه استفاده شود، هشدار می‌دهد. در C++، همچنین در صورتی که یک ارجاع غیرایستا (non\-static) یا عضو غیرایستای \f(CW\*(C`const\*(C'\fR در کلاسی بدون سازنده (constructor) ظاهر شود، هشدار می‌دهد.
.Sp
علاوه بر این، ارسال یک اشاره‌گر (یا در C++، یک ارجاع) به شیء مقداردهی‌نشده به یک آرگومان واجد شرایط \f(CW\*(C`const\*(C'\fR در توابع توکار (built\-in) که مشخص است شیء را می‌خوانند، توسط این هشدار تشخیص داده می‌شود.
(\fB\-Wmaybe\-uninitialized\fR برای توابع معمولی صادر می‌شود.)
.Sp
اگر می‌خواهید درباره کدی که از مقدار مقداردهی‌نشده متغیر در مقداردهی اولیه خودش استفاده می‌کند هشدار دریافت کنید، از گزینه \fB\-Winit\-self\fR استفاده نمایید.
.Sp
این هشدارها هم برای تک‌تک عناصر مقداردهی‌نشده متغیرهای ساختار (structure)، اجتماع (union) یا آرایه‌ها و هم برای متغیرهایی که به‌طور کامل مقداردهی اولیه نشده‌اند رخ می‌دهند. آنها برای متغیرها یا عناصری که به عنوان \f(CW\*(C`volatile\*(C'\fR اعلان شده‌اند، رخ نمی‌دهند. از آنجا که این هشدارها به بهینه‌سازی وابسته‌اند، متغیرها یا عناصر دقیقی که برای آن‌ها هشدار صادر می‌شود، به گزینه‌های بهینه‌سازی دقیق و نسخه GCC مورد استفاده بستگی دارند.
.Sp
توجه داشته باشید که ممکن است برای متغیری که تنها برای محاسبه مقداری به کار رفته که خودش هرگز استفاده نمی‌شود هیچ هشداری داده نشود، زیرا چنین محاسباتی ممکن است پیش از چاپ هشدارها توسط تحلیل جریان داده (data flow analysis) حذف شوند.
.Sp
در C++، این گزینه همچنین درباره استفاده از اشیاء مقداردهی‌نشده در فهرست‌های مقداردهی اولیه اعضا (member\-initializer\-lists) هشدار می‌دهد. برای نمونه، GCC درباره مقداردهی‌نشده بودن \f(CW\*(C`b\*(C'\fR در قطعه‌کد زیر هشدار می‌دهد:
.Sp
.Vb 5
\&        struct A {
\&          int a;
\&          int b;
\&          A() : a(b) { }
\&        };
.Ve
.IP \fB\-Wno\-invalid\-memory\-model\fR 4
.IX Item "-Wno-invalid-memory-model"
این گزینه هشدارهای مربوط به فراخوانی‌های \fB_\|_atomic Builtins\fR، \fB_\|_sync Builtins\fR، و توابع عمومی اتمیک C11 را که با آرگومان سازگاری حافظه (memory consistency) همراه هستند و برای آن عملیات نامعتبر است یا خارج از محدوده مقادیر شمارشی (enumeration) \f(CW\*(C`memory_order\*(C'\fR قرار دارد، کنترل می‌کند. به عنوان مثال، از آنجا که توابع توکار \f(CW\*(C`_\|_atomic_store\*(C'\fR و \f(CW\*(C`_\|_atomic_store_n\*(C'\fR تنها برای ترتیبات حافظه relaxed، release و sequentially consistent تعریف شده‌اند، کد زیر تشخیص داده می‌شود:
.Sp
.Vb 4
\&        void store (int *i)
\&        {
\&          _\|_atomic_store_n (i, 0, memory_order_consume);
\&        }
.Ve
.Sp
گزینه \fB\-Winvalid\-memory\-model\fR به طور پیش‌فرض فعال است.
.IP \fB\-Wmaybe\-uninitialized\fR 4
.IX Item "-Wmaybe-uninitialized"
برای شیئی با طول عمر ذخیره‌سازی خودکار یا تخصیص‌یافته، اگر مسیری از ورودی تابع تا استفاده‌ای از شیء که مقداردهی شده است وجود داشته باشد، اما مسیرهای دیگری نیز باشند که شیء در آن‌ها مقداردهی اولیه نشده باشد، کامپایلر در صورتی که نتواند اثبات کند مسیرهای مقداردهی‌نشده در زمان اجرا اجرا نمی‌شوند، هشداری صادر می‌کند.
.Sp
علاوه بر این، ارسال یک اشاره‌گر (یا در C++، یک ارجاع) به شیء مقداردهی‌نشده به یک آرگومان تابع واجد شرایط \f(CW\*(C`const\*(C'\fR نیز توسط این هشدار تشخیص داده می‌شود. (\fB\-Wuninitialized\fR برای توابع توکاری که مشخص است شیء را می‌خوانند صادر می‌شود.) نشانه‌گذاری تابع با ویژگی (attribute) \&\f(CW\*(C`access (none)\*(C'\fR نشان می‌دهد که از آرگومان برای دسترسی به شیء استفاده نمی‌شود و از هشدار جلوگیری می‌کند.
.Sp
این هشدارها تنها در کامپایل با بهینه‌سازی امکان‌پذیرند، زیرا در غیر این صورت GCC وضعیت متغیرها را ردیابی نمی‌کند. از طرف دیگر، مشخص شده است که \fB\-Wmaybe\-uninitialized\fR در بسیاری از موقعیت‌ها به دلیل بهینه‌سازی‌هایی که از تعریف‌نشده بودن استفاده‌های مقداردهی‌نشده بهره می‌برند (مانند انتشار ثابت یا constant propagation)، هشداری صادر نمی‌کند (منفی کاذب).
.Sp
این هشدارها اختیاری در نظر گرفته شده‌اند زیرا ممکن است GCC نتواند تشخیص دهد چه زمانی کد با وجود داشتن ظاهر خطادار، در واقع صحیح است. در اینجا نمونه‌ای از چگونگی رخ دادن این حالت آورده شده است:
.Sp
.Vb 12
\&        {
\&          int x;
\&          switch (y)
\&            {
\&            case 1: x = 1;
\&              break;
\&            case 2: x = 4;
\&              break;
\&            case 3: x = 5;
\&            }
\&          foo (x);
\&        }
.Ve
.Sp
اگر مقدار \f(CW\*(C`y\*(C'\fR همیشه ۱، ۲ یا ۳ باشد، آنگاه \f(CW\*(C`x\*(C'\fR همیشه مقداردهی اولیه شده است، اما GCC این موضوع را نمی‌داند. برای فرونشاندن هشدار، باید یک حالت default با \fBassert\fR\|(0) یا کدی مشابه فراهم کنید.
.Sp
این گزینه همچنین زمانی هشدار می‌دهد که یک متغیر خودکار non\-volatile ممکن است با فراخوانی \f(CW\*(C`longjmp\*(C'\fR تغییر کند. کامپایلر تنها فراخوانی‌های \f(CW\*(C`setjmp\*(C'\fR را می‌بیند. کامپایلر نمی‌تواند بداند \f(CW\*(C`longjmp\*(C'\fR در کجا فراخوانی خواهد شد؛ در واقع، یک گرداننده سیگنال (signal handler) می‌تواند آن را در هر نقطه‌ای از کد فراخوانی کند. در نتیجه، ممکن است حتی زمانی که در واقع مشکلی وجود ندارد هشدار دریافت کنید، زیرا در عمل \f(CW\*(C`longjmp\*(C'\fR نمی‌تواند در مکانی فراخوانی شود که باعث ایجاد مشکل گردد.
.Sp
می‌توان از برخی هشدارهای کاذب جلوگیری کرد، اگر تمامی توابعی را که استفاده می‌کنید و هرگز بازنمی‌گردند به صورت \f(CW\*(C`noreturn\*(C'\fR اعلان نمایید.
.Sp
این هشدار توسط \fB\-Wall\fR یا \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wunknown\-pragmas\fR 4
.IX Item "-Wunknown-pragmas"
زمانی که با یک رهنمود \f(CW\*(C`#pragma\*(C'\fR مواجه شود که برای GCC قابل درک نیست، هشدار می‌دهد. اگر از این گزینه خط فرمان استفاده شود، هشدارها حتی برای pragmaهای ناشناخته در فایل‌های سرآیند سیستمی نیز صادر می‌شوند. این امر در صورتی که هشدارها صرفاً با گزینه خط فرمان \fB\-Wall\fR فعال شده باشند رخ نمی‌دهد.
.IP \fB\-Wno\-pragmas\fR 4
.IX Item "-Wno-pragmas"
درباره استفاده‌های نادرست از pragmaها، مانند پارامترهای نادرست، نحو (syntax) نامعتبر، یا تداخل بین pragmaها هشدار ندهد. همچنین به \fB\-Wunknown\-pragmas\fR مراجعه کنید.
.IP \fB\-Wno\-pragma\-once\-outside\-header\fR 4
.IX Item "-Wno-pragma-once-outside-header"
زمانی که از \f(CW\*(C`#pragma once\*(C'\fR در فایلی استفاده می‌شود که یک فایل سرآیند نیست (مانند فایل اصلی)، هشدار ندهد.
.IP \fB\-Wno\-prio\-ctor\-dtor\fR 4
.IX Item "-Wno-prio-ctor-dtor"
اگر اولویتی از 0 تا 100 برای سازنده (constructor) یا نابودکننده (destructor) استفاده شود، هشدار ندهد. استفاده از مشخصه‌های constructor و destructor به شما امکان می‌دهد اولویتی را به سازنده/نابودکننده اختصاص دهید تا ترتیب اجرای آن پیش از فراخوانی \f(CW\*(C`main\*(C'\fR یا پس از بازگشت از آن کنترل شود. مقادیر اولویت باید بزرگ‌تر از 100 باشند، زیرا کامپایلر مقادیر اولویت بین 0\-\-100 را برای پیاده‌سازی رزرو می‌کند.
.IP \fB\-Wstrict\-aliasing\fR 4
.IX Item "-Wstrict-aliasing"
این گزینه تنها زمانی فعال است که \fB\-fstrict\-aliasing\fR فعال باشد. درباره کدی که ممکن است قوانین strict aliasing مورد استفاده کامپایلر برای بهینه‌سازی را نقض کند هشدار می‌دهد. این هشدار همه موارد را پوشش نمی‌دهد، اما تلاش می‌کند خطاهای رایج‌تر را شناسایی کند. این گزینه در \fB\-Wall\fR گنجانده شده است. معادل با \fB\-Wstrict\-aliasing=3\fR است..IP \fB\-Wstrict\-aliasing=\fR\fIn\fR 4
.IX Item "-Wstrict-aliasing=n"
این گزینه تنها زمانی فعال است که \fB\-fstrict\-aliasing\fR فعال باشد.
درباره کدهایی هشدار می‌دهد که ممکن است قواعد strict aliasing (نام مستعار دقیق) را که
کامپایلر برای بهینه‌سازی به کار می‌گیرد نقض کنند.
سطوح بالاتر با دقت بالاتر (مثبت‌های کاذب کمتر) متناظر هستند.
سطوح بالاتر همچنین به تلاش و تحلیل بیشتری نیاز دارند، شبیه به نحوه
عملکرد \fB\-O\fR.
گزینه \&\fB\-Wstrict\-aliasing\fR معادل \fB\-Wstrict\-aliasing=3\fR است.
.Sp
سطح ۱: تهاجمی‌ترین، سریع، کمترین دقت.
احتمالاً زمانی مفید است که سطوح بالاتر
هشدار نمی‌دهند اما \fB\-fstrict\-aliasing\fR همچنان کد را دچار مشکل می‌کند، زیرا این سطح منفی‌های
کاذب بسیار اندکی دارد. هرچند، مثبت‌های کاذب فراوانی دارد.
برای تمام تبدیل‌های اشاره‌گر بین انواع احتمالاً ناسازگار،
حتی اگر هرگز ارجاع‌زدایی نشوند، هشدار می‌دهد. تنها در فرانت‌اند (front end) اجرا می‌شود.
.Sp
سطح ۲: تهاجمی، سریع، نه‌چندان دقیق.
ممکن است همچنان مثبت‌های کاذب زیادی داشته باشد (البته نه به اندازه سطح ۱)،
و منفی‌های کاذب اندک (اما احتمالاً بیشتر از سطح ۱).
برخلاف سطح ۱، تنها زمانی هشدار می‌دهد که آدرس گرفته شده باشد. درباره انواع
ناقص (incomplete types) هشدار می‌دهد. تنها در فرانت‌اند اجرا می‌شود.
.Sp
سطح ۳ (پیش‌فرض برای \fB\-Wstrict\-aliasing\fR):
باید مثبت‌های کاذب بسیار کم و منفی‌های کاذب
اندکی داشته باشد. در صورت فعال بودن بهینه‌سازی، اندکی از سطوح ۱ یا ۲ کندتر است.
الگوی رایج pun+dereference را در فرانت‌اند بررسی می‌کند:
\&\f(CW\*(C`*(int*)&some_float\*(C'\fR.
اگر بهینه‌سازی فعال باشد، در بک‌اند (back end) نیز اجرا می‌شود، جایی که با استفاده
از اطلاعات points\-to وابسته به جریان داده (flow\-sensitive)، با موارد چندعبارتی سر و کار دارد.
تنها زمانی هشدار می‌دهد که اشاره‌گرِ تبدیل‌شده ارجاع‌زدایی شود.
درباره انواع ناقص هشدار نمی‌دهد.
.IP \fB\-Wstrict\-overflow\fR 4
.IX Item "-Wstrict-overflow"
.PD 0
.IP \fB\-Wstrict\-overflow=\fR\fIn\fR 4
.IX Item "-Wstrict-overflow=n"
.PD
این گزینه تنها زمانی فعال است که سرریز علامت‌دار (signed overflow) تعریف‌نشده باشد.
درباره مواردی هشدار می‌دهد که کامپایلر بر اساس این فرض که سرریز علامت‌دار
رخ نمی‌دهد، بهینه‌سازی می‌کند. توجه داشته باشید که این گزینه درباره همه مواردی که
ممکن است کد دچار سرریز شود هشدار نمی‌دهد؛ بلکه فقط درباره مواردی هشدار می‌دهد
که کامپایلر نوعی بهینه‌سازی روی آن‌ها اعمال می‌کند. بنابراین
این هشدار به سطح بهینه‌سازی وابسته است.
.Sp
بهینه‌سازی‌ای که فرض می‌کند سرریز علامت‌دار رخ نمی‌دهد،
در صورتی کاملاً ایمن است که مقادیر متغیرهای درگیر به‌گونه‌ای باشند که
سرریز در عمل هرگز رخ ندهد. بنابراین این هشدار به‌سادگی می‌تواند
یک مثبت کاذب ایجاد کند: هشداری درباره کدی که در واقعیت
مشکلی ندارد. برای کمک به تمرکز روی مسائل مهم، چندین
سطح هشدار تعریف شده است. هیچ هشداری برای استفاده از سرریز علامت‌دارِ تعریف‌نشده
هنگام تخمین تعداد تکرارهای مورد نیاز یک حلقه صادر نمی‌شود، به‌ویژه در
تعیین این‌که آیا یک حلقه اصلاً اجرا خواهد شد یا خیر.
.RS 4
.IP \fB\-Wstrict\-overflow=1\fR 4
.IX Item "-Wstrict-overflow=1"
درباره مواردی هشدار می‌دهد که هم جای تردید دارند و هم اجتناب از آن‌ها آسان است. برای
مثال کامپایلر
\&\f(CW\*(C`x + 1 > x\*(C'\fR را به \f(CW1\fR ساده‌سازی می‌کند. این سطح از
\&\fB\-Wstrict\-overflow\fR توسط \fB\-Wall\fR فعال می‌شود؛ سطوح بالاتر
به این صورت فعال نمی‌شوند و باید صراحتاً درخواست شوند.
.IP \fB\-Wstrict\-overflow=2\fR 4
.IX Item "-Wstrict-overflow=2"
همچنین درباره موارد دیگری هشدار می‌دهد که در آن‌ها یک مقایسه به یک
ثابت ساده‌سازی می‌شود. برای مثال: \f(CW\*(C`abs (x) >= 0\*(C'\fR. این مورد تنها زمانی
قابل ساده‌سازی است که سرریز عدد صحیح علامت‌دار تعریف‌نشده باشد، زیرا
\&\f(CW\*(C`abs (INT_MIN)\*(C'\fR به \f(CW\*(C`INT_MIN\*(C'\fR سرریز می‌کند، که کمتر از
صفر است. گزینه \&\fB\-Wstrict\-overflow\fR (بدون تعیین سطح) مشابه
\&\fB\-Wstrict\-overflow=2\fR است.
.IP \fB\-Wstrict\-overflow=3\fR 4
.IX Item "-Wstrict-overflow=3"
همچنین درباره موارد دیگری هشدار می‌دهد که در آن‌ها یک مقایسه ساده‌سازی می‌شود. برای
مثال: \f(CW\*(C`x + 1 > 1\*(C'\fR به \f(CW\*(C`x > 0\*(C'\fR ساده‌سازی می‌شود.
.IP \fB\-Wstrict\-overflow=4\fR 4
.IX Item "-Wstrict-overflow=4"
همچنین درباره ساده‌سازی‌های دیگری هشدار می‌دهد که تحت پوشش موارد بالا قرار نمی‌گیرند.
برای مثال: \f(CW\*(C`(x * 10) / 5\*(C'\fR به \f(CW\*(C`x * 2\*(C'\fR ساده‌سازی می‌شود.
.IP \fB\-Wstrict\-overflow=5\fR 4
.IX Item "-Wstrict-overflow=5"
همچنین درباره مواردی هشدار می‌دهد که در آن‌ها کامپایلر بزرگی قدرمطلق یک
ثابت درگیر در مقایسه را کاهش می‌دهد. برای مثال: \f(CW\*(C`x + 2 > y\*(C'\fR به
\&\f(CW\*(C`x + 1 >= y\*(C'\fR ساده می‌شود. این وضعیت تنها در
بالاترین سطح هشدار گزارش می‌شود زیرا این ساده‌سازی برای مقایسه‌های متعددی
اعمال می‌گردد، در نتیجه این سطح هشدار تعداد بسیار زیادی از
مثبت‌های کاذب تولید می‌کند.
.RE
.RS 4
.RE
.IP \fB\-Wstring\-compare\fR 4
.IX Item "-Wstring-compare"
برای فراخوانی‌هایی از \f(CW\*(C`strcmp\*(C'\fR و \f(CW\*(C`strncmp\*(C'\fR هشدار می‌دهد که در آزمون‌های
چنین برابری‌هایی، نتیجه به دلیل بیشتر بودن طول یک آرگومان از اندازه آرایه‌ای که
آرگومان دیگر در آن ذخیره شده (یا کران در مورد \f(CW\*(C`strncmp\*(C'\fR)، صفر یا غیر صفر
تعیین می‌شود. چنین فراخوانی‌هایی ممکن است اشتباه باشند. برای مثال،
فراخوانی \f(CW\*(C`strcmp\*(C'\fR در ادامه گزارش می‌شود زیرا نتیجه آن
صرف‌نظر از محتوای آرایه \f(CW\*(C`a\*(C'\fR لزوماً غیر صفر است.
.Sp
.Vb 8
\&        extern char a[4];
\&        void f (char *d)
\&        {
\&          strcpy (d, "string");
\&          ...
\&          if (0 == strcmp (a, d))   // cannot be true
\&            puts ("a and d are the same");
\&        }
.Ve
.Sp
گزینه \&\fB\-Wstring\-compare\fR توسط \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wno\-stringop\-overflow\fR 4
.IX Item "-Wno-stringop-overflow"
.PD 0
.IP \fB\-Wstringop\-overflow\fR 4
.IX Item "-Wstringop-overflow"
.IP \fB\-Wstringop\-overflow=\fR\fItype\fR 4
.IX Item "-Wstringop-overflow=type"
.PD
درباره کدهایی که می‌توان به‌طور ایستا تعیین کرد که باعث سرریز بافر یا
تجاوز از محدوده حافظه می‌شوند هشدار می‌دهد؛ مانند فراخوانی‌هایی به \f(CW\*(C`memcpy\*(C'\fR و
\&\f(CW\*(C`strcpy\*(C'\fR که موجب سرریز بافر مقصد می‌شوند. آرگومان
اختیاری، یک واحد بزرگ‌تر از نوع بررسی اندازه شیء (Object Size Checking) است که باید
برای تعیین اندازه مقصد انجام شود.
این آرگومان تنها برای توابع رشته‌ای که روی آرایه‌های نویسه‌ای عمل می‌کنند
معنادار است؛ توابع حافظه خام مانند \f(CW\*(C`memcpy\*(C'\fR
همواره از Object Size Checking نوع صفر استفاده می‌کنند.
.Sp
این گزینه همچنین برای فراخوانی‌هایی هشدار می‌دهد که اندازه‌ای
بیش از بزرگ‌ترین شیء ممکن یا نهایتاً \f(CW\*(C`SIZE_MAX / 2\*(C'\fR بایت را مشخص می‌کنند.
.Sp
این گزینه با فعال بودن بهینه‌سازی بهترین نتایج را ایجاد می‌کند، اما می‌تواند
زیرمجموعه کوچکی از سرریزهای بافر ساده را حتی بدون بهینه‌سازی در
فراخوانی توابع درونی (built\-in) کامپایلر GCC مانند \f(CW\*(C`_\|_builtin_memcpy\*(C'\fR که
متناظر با توابع استاندارد هستند تشخیص دهد. در هر حال، این گزینه تنها درباره
زیرمجموعه‌ای از سرریزهای بافر هشدار می‌دهد که توسط توابع درونی متناظر بررسی سرریز،
مانند \f(CW\*(C`_\|_builtin_\|_\|_memcpy_chk\*(C'\fR، شناسایی می‌شوند؛ توابعی که می‌توانند در صورتی که دسترسی در زمان کامپایل ایمن تشخیص داده نشود،
بررسی زمان اجرا را انجام دهند.
.Sp
برای مثال، این گزینه برای فراخوانی \f(CW\*(C`strcpy\*(C'\fR
در زیر هشداری صادر می‌کند، زیرا حداقل ۵ نویسه
(رشته \f(CW"blue"\fR شامل NUL پایانی) را درون بافری
به اندازه ۴ کپی می‌کند.
.Sp
.Vb 11
\&        enum Color { blue, purple, yellow };
\&        const char* f (enum Color clr)
\&        {
\&          static char buf [4];
\&          const char *str;
\&          switch (clr)
\&            {
\&              case blue: str = "blue"; break;
\&              case purple: str = "purple"; break;
\&              case yellow: str = "yellow"; break;
\&            }
\&        
\&          return strcpy (buf, str);   // warning here
\&        }
.Ve
.Sp
اثر این گزینه به توابع دستکاری رشته یا حافظه
محدود نمی‌شود. در این مثال، هشداری صادر می‌شود
زیرا یک آرایه ۱\-عنصری به تابعی فرستاده شده است که حداقل به یک
آرگومان آرایه ۴\-عنصری نیاز دارد:
.Sp
.Vb 1
\&        void f (int[static 4]);
\&        
\&        void g (void)
\&        {
\&          int *p = (int *) malloc (1 * sizeof(int));
\&          f (p);   // warning here
\&        }
.Ve
.Sp
گزینه \fB\-Wstringop\-overflow=2\fR به‌طور پیش‌فرض فعال است.
.RS 4
.IP \fB\-Wstringop\-overflow\fR 4
.IX Item "-Wstringop-overflow".PD 0
.IP \fB\-Wstringop\-overflow=1\fR 4
.IX Item "-Wstringop-overflow=1"
.PD
گزینهٔ \fB\-Wstringop\-overflow=1\fR از «بررسی اندازهٔ شیء نوع صفر» برای تعیین اندازهٔ اشیاء مقصد استفاده می‌کند. در این تنظیم، این گزینه برای نوشتن فراتر از انتهای زیر‌اشیاءِ اشیاء بزرگ‌تری که با اشاره‌گرها به آن‌ها دسترسی پیدا شده است هشداری نمی‌دهد، مگر اینکه اندازهٔ بزرگ‌ترین شیءِ دربرگیرنده مشخص باشد. هنگامی که مقصد ممکن است یکی از چندین شیء باشد، بزرگ‌ترینِ آن‌ها فرض می‌شود. در سیستم‌های لینوکس، زمانی که بهینه‌سازی در این تنظیم فعال باشد، این گزینه برای همان کدهایی هشدار می‌دهد که ماکروی \f(CW\*(C`_FORTIFY_SOURCE\*(C'\fR با مقداری غیر صفر تعریف شده باشد.
.IP \fB\-Wstringop\-overflow=2\fR 4
.IX Item "-Wstringop-overflow=2"
گزینهٔ \fB\-Wstringop\-overflow=2\fR از «بررسی اندازهٔ شیء نوع یک» برای تعیین اندازهٔ اشیاء مقصد استفاده می‌کند. در این تنظیم، این گزینه دربارهٔ سرریزها هنگام نوشتن در اعضای بزرگ‌ترین اشیاء کاملی که اندازهٔ دقیق آن‌ها مشخص است هشدار می‌دهد. با این حال، برای نوشتن‌های بیش از اندازه در اعضای مشابه از اشیاء نامشخصی که با اشاره‌گر به آن‌ها ارجاع داده شده هشداری نمی‌دهد، زیرا ممکن است به آرایه‌هایی با تعداد نامشخصی از عناصر اشاره کنند. این تنظیمِ پیش‌فرض گزینه است.
.IP \fB\-Wstringop\-overflow=3\fR 4
.IX Item "-Wstringop-overflow=3"
گزینهٔ \fB\-Wstringop\-overflow=3\fR از «بررسی اندازهٔ شیء نوع دو» برای تعیین اندازهٔ اشیاء مقصد استفاده می‌کند. در این تنظیم، این گزینه دربارهٔ سرریز شدن از کوچک‌ترین شیء یا عضو داده هشدار می‌دهد. این سخت‌گیرانه‌ترین تنظیم این گزینه است که ممکن است به ایجاد هشدارهایی برای کدهای امن منجر شود.
.IP \fB\-Wstringop\-overflow=4\fR 4
.IX Item "-Wstringop-overflow=4"
گزینهٔ \fB\-Wstringop\-overflow=4\fR از «بررسی اندازهٔ شیء نوع سه» برای تعیین اندازهٔ اشیاء مقصد استفاده می‌کند. در این تنظیم، این گزینه دربارهٔ سرریز شدن از هر یک از اعضای داده هشدار می‌دهد، و زمانی که مقصد یکی از چندین شیء باشد، از اندازهٔ بزرگ‌ترینِ آن‌ها برای تصمیم‌گیری دربارهٔ صدور هشدار استفاده می‌کند. مشابه با \fB\-Wstringop\-overflow=3\fR، این تنظیم ممکن است هشدارهایی برای کدهای بی‌پیرایه و بی‌خطر ایجاد کند.
.RE
.RS 4
.RE
.IP \fB\-Wno\-stringop\-overread\fR 4
.IX Item "-Wno-stringop-overread"
دربارهٔ فراخوانی توابع دستکاری رشته مانند \f(CW\*(C`memchr\*(C'\fR یا \&\f(CW\*(C`strcpy\*(C'\fR که مشخص شده است فراتر از انتهای توالی مبدأ می‌خوانند، هشدار می‌دهد.
.Sp
گزینهٔ \fB\-Wstringop\-overread\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-Wno\-stringop\-truncation\fR 4
.IX Item "-Wno-stringop-truncation"
برای فراخوانی توابع کران‌دارِ دستکاری رشته مانند \f(CW\*(C`strncat\*(C'\fR، \&\f(CW\*(C`strncpy\*(C'\fR و \f(CW\*(C`stpncpy\*(C'\fR که ممکن است رشتهٔ رونوشت‌شده را کوتاه کرده یا مقصد را دست‌نخورده باقی بگذارند، هشدار نده.
.Sp
در مثال زیر، فراخوانی \f(CW\*(C`strncat\*(C'\fR کرانی را مشخص می‌کند که از طول رشتهٔ مبدأ کمتر است. در نتیجه، رونوشت مبدأ کوتاه خواهد شد و بنابراین این فراخوانی تشخیص داده شده و هشدار دریافت می‌کند. برای جلوگیری از این هشدار، از \f(CW\*(C`bufsize \- strlen (buf) \- 1)\*(C'\fR به عنوان کران استفاده کنید.
.Sp
.Vb 4
\&        void append (char *buf, size_t bufsize)
\&        {
\&          strncat (buf, ".txt", 3);
\&        }
.Ve
.Sp
به عنوان مثالی دیگر، فراخوانی زیر به \f(CW\*(C`strncpy\*(C'\fR منجر به رونوشت تنها نویسه‌های قبل از \f(CW\*(C`NUL\*(C'\fR پایانی به \f(CW\*(C`d\*(C'\fR می‌شود، بدون آنکه \f(CW\*(C`NUL\*(C'\fR به انتهای آن اضافه شود. این فرض که نتیجهٔ \f(CW\*(C`strncpy\*(C'\fR لزوماً یک رشتهٔ پایان‌یافته با \f(CW\*(C`NUL\*(C'\fR است یک اشتباه متداول است، و بنابراین فراخوانی شناسایی می‌شود. برای اجتناب از این هشدار در صورتی که انتظار نمی‌رود نتیجه با \f(CW\*(C`NUL\*(C'\fR پایان یابد، به جای آن \f(CW\*(C`memcpy\*(C'\fR را فراخوانی کنید.
.Sp
.Vb 4
\&        void copy (char *d, const char *s)
\&        {
\&          strncpy (d, s, strlen (s));
\&        }
.Ve
.Sp
در مثال زیر، فراخوانی \f(CW\*(C`strncpy\*(C'\fR اندازهٔ بافر مقصد را به عنوان کران تعیین می‌کند. اگر طول رشتهٔ مبدأ بزرگ‌تر یا مساوی این اندازه باشد، نتیجهٔ رونوشت با \f(CW\*(C`NUL\*(C'\fR خاتمه نخواهد یافت. بنابراین، فراخوانی شناسایی و گزارش می‌شود. برای جلوگیری از این هشدار، \f(CW\*(C`sizeof buf \- 1\*(C'\fR را به عنوان کران تعیین کرده و آخرین عنصر بافر را روی \f(CW\*(C`NUL\*(C'\fR تنظیم کنید.
.Sp
.Vb 6
\&        void copy (const char *s)
\&        {
\&          char buf[80];
\&          strncpy (buf, s, sizeof buf);
\&          ...
\&        }
.Ve
.Sp
در شرایطی که هدف یک آرایهٔ نویسه‌ای، ذخیره‌سازی توالی‌ای از بایت‌ها بدون \f(CW\*(C`NUL\*(C'\fR پایانی است، می‌توان چنین آرایه‌ای را با صفت \f(CW\*(C`nonstring\*(C'\fR نشانه‌گذاری کرد تا از این هشدار جلوگیری شود. با این حال، چنین آرایه‌هایی آرگومان‌های مناسبی برای توابعی که انتظار رشته‌های پایان‌یافته با \&\f(CW\*(C`NUL\*(C'\fR را دارند نیستند. برای کمک به تشخیص استفاده‌های نادرست تصادفی از چنین آرایه‌هایی، GCC هشدارهایی صادر می‌کند مگر اینکه بتواند امن بودن استفاده را اثبات نماید.
.IP "\fB\-Wstrict\-flex\-arrays\fR (فقط C و C++)" 4
.IX Item "-Wstrict-flex-arrays (C and C++ only)"
دربارهٔ استفاده‌های نادرست از اعضای آرایهٔ انعطاف‌پذیر با توجه به \fIlevel\fR صفت \f(CW\*(C`strict_flex_array (\fR\f(CIlevel\fR\f(CW)\*(C'\fR پیوست‌شده به فیلد آرایهٔ انتهاییِ یک ساختار در صورت موجود بودن، و در غیر این صورت بر اساس \fIlevel\fR گزینهٔ \&\fB\-fstrict\-flex\-arrays=\fR\fIlevel\fR هشدار می‌دهد. گزینهٔ \f(CW\*(C`\-Wstrict\-flex\-arrays\*(C'\fR تنها زمانی مؤثر است که \fIlevel\fR بزرگ‌تر از 0 باشد.
.Sp
هنگامی که \fIlevel\fR=1 باشد، اگر به آرایهٔ انتهاییِ ساختاری با ۲ عنصر یا بیشتر به عنوان عضو آرایهٔ انعطاف‌پذیر ارجاع داده شود، هشدار صادر می‌شود.
.Sp
هنگامی که \fIlevel\fR=2 باشد، علاوه بر \fIlevel\fR=1، اگر به آرایهٔ انتهاییِ تک‌عنصریِ یک ساختار به عنوان عضو آرایهٔ انعطاف‌پذیر ارجاع داده شود، هشدارهای بیشتری صادر می‌شود.
.Sp
هنگامی که \fIlevel\fR=3 باشد، علاوه بر \fIlevel\fR=2، اگر به آرایهٔ انتهاییِ با طول صفر در یک ساختار به عنوان عضو آرایهٔ انعطاف‌پذیر ارجاع داده شود، هشدارهای بیشتری صادر می‌شود.
.Sp
این گزینه زمانی که \fB\-ftree\-vrp\fR فعال باشد کارایی بیشتری دارد (حالت پیش‌فرض برای \fB\-O2\fR و بالاتر)، اما برخی هشدارها ممکن است حتی بدون بهینه‌سازی نیز تشخیص داده شوند.
.IP \fB\-Wsuggest\-attribute=\fR\fIattribute\-name\fR 4
.IX Item "-Wsuggest-attribute=attribute-name"
در مواردی که افزودن یک صفت ممکن است سودمند باشد هشدار می‌دهد. مقادیر \fIattribute\-name\fR که در حال حاضر پشتیبانی می‌شوند در زیر فهرست شده‌اند.
.RS 4
.IP \fB\-Wsuggest\-attribute=pure\fR 4
.IX Item "-Wsuggest-attribute=pure"
.PD 0
.IP \fB\-Wsuggest\-attribute=const\fR 4
.IX Item "-Wsuggest-attribute=const"
.IP \fB\-Wsuggest\-attribute=noreturn\fR 4
.IX Item "-Wsuggest-attribute=noreturn"
.IP \fB\-Wmissing\-noreturn\fR 4
.IX Item "-Wmissing-noreturn"
.IP \fB\-Wsuggest\-attribute=malloc\fR 4
.IX Item "-Wsuggest-attribute=malloc"
.IP \fB\-Wsuggest\-attribute=returns_nonnull\fR 4
.IX Item "-Wsuggest-attribute=returns_nonnull"
.PD
دربارهٔ توابعی که ممکن است نامزد صفت‌های \&\f(CW\*(C`pure\*(C'\fR، \f(CW\*(C`const\*(C'\fR، \f(CW\*(C`noreturn\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR یا \&\f(CW\*(C`returns_nonnull\*(C'\fR باشند هشدار می‌دهد. کامپایلر تنها برای توابعی که در سایر واحدهای ترجمه قابل مشاهده هستند، یا (در مورد \&\f(CW\*(C`pure\*(C'\fR و \f(CW\*(C`const\*(C'\fR) اگر نتواند اثبات کند که تابع به‌طور عادی بازمی‌گردد، هشدار صادر می‌کند. یک تابع زمانی به‌طور عادی بازمی‌گردد که فاقد حلقهٔ بی‌نهایت باشد یا با پرتاب استثنا، فراخوانی \f(CW\*(C`abort\*(C'\fR یا به دام افتادن به‌طور غیرعادی خارج نشود. این تحلیل نیازمند گزینهٔ \fB\-fipa\-pure\-const\fR است که به‌طور پیش‌فرض در \&\fB\-O\fR و بالاتر فعال است. سطوح بالاتر بهینه‌سازی دقت تحلیل را بهبود می‌بخشند.
.IP \fB\-Wsuggest\-attribute=format\fR 4
.IX Item "-Wsuggest-attribute=format"
.PD 0
.IP \fB\-Wmissing\-format\-attribute\fR 4
.IX Item "-Wmissing-format-attribute"
.PD
دربارهٔ اشاره‌گرهای تابعی که ممکن است نامزد صفت‌های \f(CW\*(C`format\*(C'\fR باشند هشدار می‌دهد. توجه داشته باشید که این‌ها تنها نامزدهای احتمالی هستند، نه قطعی. ‏GCC حدس می‌زند اشاره‌گرهای تابعی با صفت‌های \f(CW\*(C`format\*(C'\fR که در انتساب، مقداردهی اولیه، ارسال پارامتر یا عبارت‌های بازگشت استفاده می‌شوند، باید صفت متناظر \f(CW\*(C`format\*(C'\fR را در نوع حاصل داشته باشند؛ یعنی برای جلوگیری از این هشدار، سمت چپِ انتساب یا مقداردهی اولیه، نوع متغیر پارامتر، یا نوع بازگشتی تابع دربرگیرنده به ترتیب باید دارای صفت \f(CW\*(C`format\*(C'\fR باشند.
.Sp
‏GCC همچنین دربارهٔ تعاریف توابعی که ممکن است نامزد صفت‌های \f(CW\*(C`format\*(C'\fR باشند هشدار می‌دهد. مجدداً، این‌ها تنها نامزدهای احتمالی هستند. GCC حدس می‌زند که صفت‌های \f(CW\*(C`format\*(C'\fR ممکن است برای هر تابعی که تابعی مانند \&\f(CW\*(C`vprintf\*(C'\fR یا \f(CW\*(C`vscanf\*(C'\fR را فراخوانی می‌کند مناسب باشد، اما این موضوع همیشه صادق نیست، و ممکن است برخی از توابعی که صفت‌های \f(CW\*(C`format\*(C'\fR برای آن‌ها مناسب است شناسایی نشوند.
.IP \fB\-Wsuggest\-attribute=cold\fR 4
.IX Item "-Wsuggest-attribute=cold"
دربارهٔ توابعی که ممکن است نامزد صفت \f(CW\*(C`cold\*(C'\fR باشند هشدار می‌دهد. این هشدار بر اساس تحلیل ایستا است و عموماً تنها برای توابعی صادر می‌شود که همواره به فراخوانی تابع \f(CW\*(C`cold\*(C'\fR دیگری می‌انجامند، مانند پوشش‌دهنده‌های دستور \f(CW\*(C`throw\*(C'\fR در ++C یا توابع گزارش خطای مهلک که منجر به فراخوانی \f(CW\*(C`abort\*(C'\fR می‌شوند.
.RE
.RS 4
.RE.IP \fB\-Walloc\-size\fR 4
.IX Item "-Walloc-size"
درباره فراخوانی‌های توابع تخصیص حافظه که با صفت
\&\f(CW\*(C`alloc_size\*(C'\fR آراسته شده‌اند و اندازه‌ای ناکافی برای نوع مقصد
اشاره‌گری که نتیجه به آن انتساب داده می‌شود تعیین می‌کنند، هشدار می‌دهد؛ از جمله فراخوانی‌های
فرم‌های توکار توابع \f(CW\*(C`aligned_alloc\*(C'\fR، \f(CW\*(C`alloca\*(C'\fR،
\&\f(CW\*(C`calloc\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR و \f(CW\*(C`realloc\*(C'\fR.
.IP \fB\-Walloc\-zero\fR 4
.IX Item "-Walloc-zero"
درباره فراخوانی‌های توابع تخصیص حافظه مزین به صفت
\&\f(CW\*(C`alloc_size\*(C'\fR که مقدار صفر بایت را مشخص می‌کنند هشدار می‌دهد، از جمله فراخوانی‌های
فرم‌های توکار توابع \f(CW\*(C`aligned_alloc\*(C'\fR، \f(CW\*(C`alloca\*(C'\fR، \f(CW\*(C`calloc\*(C'\fR،
\&\f(CW\*(C`malloc\*(C'\fR و \f(CW\*(C`realloc\*(C'\fR. از آنجا که رفتار این توابع
هنگام فراخوانی با اندازه صفر در پیاده‌سازی‌های مختلف متفاوت است (و در مورد
\f(CW\*(C`realloc\*(C'\fR منسوخ شده است)، اتکا به آن ممکن است منجر به باگ‌های
پنهان در قابلیت حمل شده و باید از آن اجتناب گردد.
.IP \fB\-Wcalloc\-transposed\-args\fR 4
.IX Item "-Wcalloc-transposed-args"
درباره فراخوانی‌های توابع تخصیص حافظه دارای صفت
\&\f(CW\*(C`alloc_size\*(C'\fR با دو آرگومان هشدار می‌دهد، که در آن‌ها از عملگر \f(CW\*(C`sizeof\*(C'\fR
به عنوان آرگومان اندازه اول استفاده شده و در آرگومان اندازه دوم استفاده نشده است.
این یک هشدار سبک کدنویسی است. آرگومان اول \f(CW\*(C`calloc\*(C'\fR طبق
مستندات تعداد عناصر در آرایه است، در حالی که آرگومان دوم اندازه هر عنصر
است، بنابراین \f(CW\*(C`calloc (\fR\f(CIn\fR\f(CW, sizeof (int))\*(C'\fR بر
\f(CW\*(C`calloc (sizeof (int), \fR\f(CIn\fR\f(CW)\*(C'\fR ترجیح داده می‌شود. اگر استفاده از \f(CW\*(C`sizeof\*(C'\fR در
آرگومان اول و نه در دومی عمدی باشد، هشدار را می‌توان با استفاده از
\f(CW\*(C`calloc (sizeof (struct \fR\f(CIS\fR\f(CW) + 0, n)\*(C'\fR یا
\&\f(CW\*(C`calloc (1 * sizeof (struct \fR\f(CIS\fR\f(CW), 4)\*(C'\fR یا استفاده از \f(CW\*(C`sizeof\*(C'\fR در
آرگومان دوم فرونشاند.
.IP \fB\-Walloc\-size\-larger\-than=\fR\fIbyte\-size\fR 4
.IX Item "-Walloc-size-larger-than=byte-size"
درباره فراخوانی‌های توابع دارای صفت \f(CW\*(C`alloc_size\*(C'\fR که تلاش
می‌کنند اشیائی بزرگ‌تر از تعداد بایت مشخص‌شده تخصیص دهند، یا جایی که
نتیجه محاسبه اندازه در یک نوع عدد صحیح با دقت نامتناهی از مقدار \fBPTRDIFF_MAX\fR
در مقصد فراتر می‌رود، هشدار می‌دهد.
\&\fB\-Walloc\-size\-larger\-than=\fR\fBPTRDIFF_MAX\fR به‌طور پیش‌فرض فعال است.
هشدارهای کنترل‌شده توسط این گزینه را می‌توان با مشخص کردن \&\fIbyte\-size\fR به
میزان \fBSIZE_MAX\fR یا بیشتر، یا با استفاده از
\&\fB\-Wno\-alloc\-size\-larger\-than\fR غیرفعال کرد.
.IP \fB\-Wno\-alloc\-size\-larger\-than\fR 4
.IX Item "-Wno-alloc-size-larger-than"
هشدارهای \fB\-Walloc\-size\-larger\-than=\fR را غیرفعال می‌کند. این گزینه
معادل \fB\-Walloc\-size\-larger\-than=\fR\fBSIZE_MAX\fR یا
بزرگ‌تر است.
.IP \fB\-Walloca\fR 4
.IX Item "-Walloca"
این گزینه در مورد تمامی استفاده‌ها از \f(CW\*(C`alloca\*(C'\fR در کد منبع هشدار می‌دهد.
.IP \fB\-Wauto\-profile\fR 4
.IX Item "-Wauto-profile"
هشدارهایی را درباره ناهمخوانی‌های auto\-profile نمایش می‌دهد.
.IP \fB\-Wcannot\-profile\fR 4
.IX Item "-Wcannot-profile"
هنگامی که ابزارگذاری پروفایل‌سازی درخواست شده باشد، اما نتوان آن را روی
یک تابع خاص اعمال کرد، هشدار می‌دهد.
.IP \fB\-Walloca\-larger\-than=\fR\fIbyte\-size\fR 4
.IX Item "-Walloca-larger-than=byte-size"
این گزینه در مورد فراخوانی‌های \f(CW\*(C`alloca\*(C'\fR با یک آرگومان عدد صحیح که
مقدار آن صفر است یا توسط یک گزاره کنترلی که مقدار آن را حداکثر
به \fIbyte\-size\fR محدود کند مقید نشده است، هشدار می‌دهد. همچنین برای فراخوانی‌هایی
به \f(CW\*(C`alloca\*(C'\fR که مقدار کران در آن‌ها نامشخص است هشدار صادر می‌کند. آرگومان‌هایی
از انواع غیر عدد صحیح حتی اگر به نظر برسد به محدوده مورد انتظار مقید
شده‌اند، نامقید در نظر گرفته می‌شوند.
.Sp
برای نمونه، یک حالت مقید از \f(CW\*(C`alloca\*(C'\fR می‌تواند چنین باشد:
.Sp
.Vb 9
\&        void func (size_t n)
\&        {
\&          void *p;
\&          if (n <= 1000)
\&            p = alloca (n);
\&          else
\&            p = malloc (n);
\&          f (p);
\&        }
.Ve
.Sp
در مثال بالا، ارسال \f(CW\*(C`\-Walloca\-larger\-than=1000\*(C'\fR هشداری صادر
نخواهد کرد، زیرا مشخص است که فراخوانی \f(CW\*(C`alloca\*(C'\fR حداکثر
۱۰۰۰ بایت است. با این حال، اگر \f(CW\*(C`\-Walloca\-larger\-than=500\*(C'\fR داده می‌شد،
کامپایلر هشداری صادر می‌کرد.
.Sp
از سوی دیگر، کاربردهای نامقید استفاده‌هایی از \f(CW\*(C`alloca\*(C'\fR بدون هیچ
گزاره کنترلی محدودکننده آرگومان عدد صحیح آن هستند. برای نمونه:
.Sp
.Vb 5
\&        void func ()
\&        {
\&          void *p = alloca (n);
\&          f (p);
\&        }
.Ve
.Sp
اگر \f(CW\*(C`\-Walloca\-larger\-than=500\*(C'\fR داده می‌شد، کد بالا باعث ایجاد یک
هشدار می‌شد، اما این بار به دلیل فقدان بررسی کران‌ها.
.Sp
توجه داشته باشید که حتی کدی به ظاهر درست شامل اعداد صحیح علامت‌دار نیز
می‌تواند موجب بروز هشدار شود:
.Sp
.Vb 8
\&        void func (signed int n)
\&        {
\&          if (n < 500)
\&            {
\&              p = alloca (n);
\&              f (p);
\&            }
\&        }
.Ve
.Sp
در مثال بالا، \fIn\fR می‌تواند منفی باشد، که باعث می‌شود آرگومانی بزرگ‌تر از
حد انتظار به‌طور ضمنی به فراخوانی \f(CW\*(C`alloca\*(C'\fR تبدیل نوع شود.
.Sp
این گزینه همچنین زمانی که \f(CW\*(C`alloca\*(C'\fR در یک حلقه استفاده شود هشدار می‌دهد.
.Sp
\&\fB\-Walloca\-larger\-than=\fR\fBPTRDIFF_MAX\fR به‌طور پیش‌فرض فعال است
اما معمولاً تنها زمانی مؤثر است که \fB\-ftree\-vrp\fR فعال باشد (پیش‌فرض
برای \fB\-O2\fR و بالاتر).
.Sp
همچنین ببینید: \fB\-Wvla\-larger\-than=\fR\fBbyte\-size\fR.
.IP \fB\-Wno\-alloca\-larger\-than\fR 4
.IX Item "-Wno-alloca-larger-than"
هشدارهای \fB\-Walloca\-larger\-than=\fR را غیرفعال می‌کند. این گزینه
معادل \fB\-Walloca\-larger\-than=\fR\fBSIZE_MAX\fR یا بزرگ‌تر است.
.IP \fB\-Warith\-conversion\fR 4
.IX Item "-Warith-conversion"
درباره تبدیل‌های ضمنی ناشی از عملیات حسابی هشدار می‌دهد، حتی زمانی
که تبدیل عملوندها به همان نوع نتواند مقادیر آن‌ها را تغییر دهد.
این گزینه بر هشدارهای ناشی از \fB\-Wconversion\fR،
\&\fB\-Wfloat\-conversion\fR و \fB\-Wsign\-conversion\fR اثر می‌گذارد.
.Sp
.Vb 5
\&        void f (char c, int i)
\&        {
\&          c = c + i; // warns with B<\-Wconversion>
\&          c = c + 1; // only warns with B<\-Warith\-conversion>
\&        }
.Ve
.IP \fB\-Warray\-bounds\fR 4
.IX Item "-Warray-bounds"
.PD 0
.IP \fB\-Warray\-bounds=\fR\fIn\fR 4
.IX Item "-Warray-bounds=n"
.PD
درباره اندیس‌ها یا آفست‌های خارج از محدوده در آرایه‌ها هشدار می‌دهد. این هشدار
توسط \fB\-Wall\fR فعال می‌شود. این گزینه زمانی که \fB\-ftree\-vrp\fR
فعال باشد مؤثرتر است (پیش‌فرض برای \fB\-O2\fR و بالاتر)، اما زیرمجموعه‌ای از
موارد حتی بدون بهینه‌سازی نیز صادر می‌شوند.
.Sp
به‌طور پیش‌فرض، آرایه پایانی یک ساختار در صورتی توسط \fB\-Warray\-bounds\fR یا
\fB\-Warray\-bounds=\fR\fIn\fR به‌عنوان عضو آرایه انعطاف‌پذیر تلقی می‌شود
که طبق استاندارد C99 به بعد به‌صورت عضو آرایه انعطاف‌پذیر (\fB[]\fR)،
افزونه آرایه با طول صفر در GCC (\fB[0]\fR)، یا یک آرایه تک‌عنصری
(\fB[1]\fR) اعلان شده باشد. در نتیجه، درباره اندیس‌ها یا آفست‌های خارج از محدوده
در آرایه‌های با طول صفر یا تک‌عنصری به‌طور پیش‌فرض هشداری داده نمی‌شود.
.Sp
می‌توانید گزینه \fB\-fstrict\-flex\-arrays\fR یا
\&\fB\-fstrict\-flex\-arrays=\fR\fIlevel\fR را اضافه کنید تا نحوه برخورد
این گزینه با آرایه پایانی ساختار به‌عنوان عضو آرایه انعطاف‌پذیر را کنترل کنید:
.Sp
هنگامی که \fIlevel\fR<=1 باشد، تغییری در رفتار پیش‌فرض ایجاد نمی‌شود.
.Sp
هنگامی که \fIlevel\fR=2 باشد، هشدارهای بیشتری برای اندیس‌ها یا
آفست‌های خارج از محدوده در آرایه‌های تک‌عنصری صادر خواهد شد؛
.Sp
هنگامی که \fIlevel\fR=3 باشد، علاوه بر \fIlevel\fR=2، هشدارهای بیشتری
برای اندیس‌ها یا آفست‌های خارج از محدوده در آرایه‌های با طول صفر صادر خواهد شد.
.RS 4
.IP \fB\-Warray\-bounds=1\fR 4
.IX Item "-Warray-bounds=1"
این سطح پیش‌فرض هشدار برای \fB\-Warray\-bounds\fR است و توسط
\fB\-Wall\fR فعال می‌شود؛ سطوح بالاتر فعال نمی‌شوند و باید به‌طور صریح درخواست شوند.
.IP \fB\-Warray\-bounds=2\fR 4
.IX Item "-Warray-bounds=2"
این سطح هشدار همچنین درباره نتایج میانی محاسبات اشاره‌گر که ممکن است
مقادیر خارج از محدوده تولید کنند هشدار می‌دهد. این سطح هشدار ممکن است
تعداد بیشتری موارد مثبت کاذب تولید کند و به‌طور پیش‌فرض غیرفعال است.
.RE
.RS 4
.RE.IP "\fB\-Wunterminated\-string\-initialization\fR (فقط C و Objective\-C)" 4
.IX Item "-Wunterminated-string-initialization (C and Objective-C only)"
دربارهٔ آرایه‌های نویسه‌ای که با یک رشتهٔ لفظی به‌صورت دنباله‌های نویسه‌ای بدون پایان‌دهنده مقداردهی اولیه می‌شوند هشدار می‌دهد، مگر آنکه اعلان در حال مقداردهی دارای صفت \f(CW\*(C`nonstring\*(C'\fR باشد.
برای نمونه:
.Sp
.Vb 2
\&        char arr[3] = "foo"; /* Warning.  */
\&        char arr2[3] _\|_attribute_\|_((nonstring)) = "bar"; /* No warning.  */
.Ve
.Sp
این هشدار با \fB\-Wextra\fR فعال می‌شود. اگر \fB\-Wc++\-compat\fR فعال باشد، عبارت‌بندی هشدار کمی متفاوت خواهد بود و حتی در صورتی که اعلان در حال مقداردهی دارای صفت \f(CW\*(C`nonstring\*(C'\fR باشد نیز هشدار می‌دهد، چرا که در C++ چنین مقداردهی‌هایی یک خطا هستند.
.IP \fB\-Warray\-compare\fR 4
.IX Item "-Warray-compare"
دربارهٔ مقایسه‌های برابری و رابطه‌ای بین دو عملوند از نوع آرایه هشدار می‌دهد. این مقایسه در C++20 منسوخ شده است. برای نمونه:
.Sp
.Vb 3
\&        int arr1[5];
\&        int arr2[5];
\&        bool same = arr1 == arr2;
.Ve
.Sp
گزینهٔ \&\fB\-Warray\-compare\fR با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Warray\-parameter\fR 4
.IX Item "-Warray-parameter"
.PD 0
.IP \fB\-Warray\-parameter=\fR\fIn\fR 4
.IX Item "-Warray-parameter=n"
.PD
دربارهٔ اعلان‌های مجدد توابع شامل پارامترهایی از نوع آرایه یا اشاره‌گر با شکل‌ها یا گونه‌های ناهمخوان هشدار می‌دهد، و امکان تشخیص دسترسی‌های خارج از محدوده به چنین پارامترهایی را توسط هشدارهایی مانند \&\fB\-Warray\-bounds\fR فعال می‌کند.
.Sp
اگر نخستین اعلان تابع از شکل آرایه‌ای برای اعلان پارامتر استفاده کند، حد مشخص‌شده در آرایه به عنوان حداقل تعداد عناصر مورد انتظار در فراخوانی‌های تابع و حداکثر تعداد عناصر قابل دسترس توسط آن فرض می‌شود. عدم ارائهٔ آرگومان‌هایی با اندازهٔ کافی یا دسترسی به بیش از حداکثر تعداد عناصر ممکن است توسط هشدارهایی مانند \fB\-Warray\-bounds\fR یا \fB\-Wstringop\-overflow\fR تشخیص داده شود.
در سطح ۱، این هشدار ناهمخوانی‌های مربوط به پارامترهای آرایه‌ای اعلان‌شده با شکل \f(CW\*(C`T[static N]\*(C'\fR را تشخیص می‌دهد.
.Sp
برای نمونه، این هشدار برای دومین اعلان \f(CW\*(C`f\*(C'\fR فعال می‌شود زیرا اولین اعلان با کلمهٔ کلیدی \f(CW\*(C`static\*(C'\fR مشخص می‌کند که آرگومان آرایه باید حداقل چهار عنصر داشته باشد، در حالی که اعلان دوم اجازه می‌دهد آرایه‌ای با هر اندازه‌ای به \f(CW\*(C`f\*(C'\fR ارسال شود.
.Sp
.Vb 2
\&        void f (int[static 4]);
\&        void f (int[]);           // warning (inconsistent array form)
\&        
\&        void g (void)
\&        {
\&          int *p = (int *)malloc (1 * sizeof (int));
\&          f (p);                  // warning (array too small)
\&          ...
\&        }
.Ve
.Sp
در سطح ۲، این هشدار همچنین برای اعلان‌های مجدد شامل هرگونه ناهمخوانی دیگر در شکل‌های آرگومان آرایه یا اشاره‌گر که بیانگر اندازهٔ آرایه هستند، فعال می‌شود. اشاره‌گرها و آرایه‌های با کران نامشخص، یکسان در نظر گرفته می‌شوند و هشداری ایجاد نمی‌کنند.
.Sp
.Vb 3
\&        void g (int*);
\&        void g (int[]);     // no warning
\&        void g (int[8]);    // warning (inconsistent array bound)
.Ve
.Sp
گزینهٔ \&\fB\-Warray\-parameter=2\fR در \fB\-Wall\fR گنجانده شده است. گزینهٔ \&\fB\-Wvla\-parameter\fR هشدارهایی را برای ناهمخوانی‌های مشابه شامل آرگومان‌های آرایه با طول متغیر (Variable Length Array) فعال می‌کند.
.Sp
شکل کوتاه گزینهٔ \fB\-Warray\-parameter\fR معادل \&\fB\-Warray\-parameter=2\fR است. شکل منفی \fB\-Wno\-array\-parameter\fR معادل \fB\-Warray\-parameter=0\fR است.
.IP \fB\-Wattribute\-alias=\fR\fIn\fR 4
.IX Item "-Wattribute-alias=n"
.PD 0
.IP \fB\-Wno\-attribute\-alias\fR 4
.IX Item "-Wno-attribute-alias"
.PD
دربارهٔ اعلان‌هایی که از صفت‌های \f(CW\*(C`alias\*(C'\fR و موارد مشابه استفاده می‌کنند و هدف آن‌ها با نوع نام مستعار ناسازگار است، هشدار می‌دهد.
.RS 4
.IP \fB\-Wattribute\-alias=1\fR 4
.IX Item "-Wattribute-alias=1"
سطح هشدار پیش‌فرض گزینهٔ \fB\-Wattribute\-alias\fR، ناسازگاری‌های بین نوع اعلان نام مستعار و نوع هدف آن را تشخیص می‌دهد. چنین ناسازگاری‌هایی معمولاً نشان‌دهندهٔ اشکالات برنامه‌نویسی هستند.
.IP \fB\-Wattribute\-alias=2\fR 4
.IX Item "-Wattribute-alias=2"
در این سطح، \fB\-Wattribute\-alias\fR مواردی را نیز تشخیص می‌دهد که در آن‌ها صفت‌های اعلان نام مستعار محدودکننده‌تر از صفت‌های اعمال‌شده بر هدف آن باشند. این عدم تطابق‌ها بالقوه می‌توانند به تولید کد نادرست بینجامند. در موارد دیگر ممکن است بی‌خطر باشند و صرفاً با افزودن صفت جاافتاده به هدف برطرف شوند. برای مقایسه، گزینهٔ \fB\-Wmissing\-attributes\fR را ببینید که موارد تشخیصی را هنگامی که اعلان نام مستعار محدودیت کمتری نسبت به هدف دارد، کنترل می‌کند.
.Sp
صفت‌های بررسی‌شده شامل \f(CW\*(C`alloc_align\*(C'\fR، \f(CW\*(C`alloc_size\*(C'\fR،
\&\f(CW\*(C`cold\*(C'\fR، \f(CW\*(C`const\*(C'\fR، \f(CW\*(C`hot\*(C'\fR، \f(CW\*(C`leaf\*(C'\fR، \f(CW\*(C`malloc\*(C'\fR،
\&\f(CW\*(C`nonnull\*(C'\fR، \f(CW\*(C`noreturn\*(C'\fR، \f(CW\*(C`nothrow\*(C'\fR، \f(CW\*(C`pure\*(C'\fR،
\&\f(CW\*(C`returns_nonnull\*(C'\fR و \f(CW\*(C`returns_twice\*(C'\fR هستند.
.RE
.RS 4
.Sp
گزینهٔ \&\fB\-Wattribute\-alias\fR معادل \fB\-Wattribute\-alias=1\fR است.
این مقدار پیش‌فرض است. می‌توانید این هشدارها را با \fB\-Wno\-attribute\-alias\fR یا \fB\-Wattribute\-alias=0\fR غیرفعال کنید.
.RE
.IP \fB\-Wbidi\-chars=\fR[\fBnone\fR|\fBunpaired\fR|\fBany\fR|\fBucn\fR] 4
.IX Item "-Wbidi-chars=[none|unpaired|any|ucn]"
دربارهٔ نویسه‌های کنترلی دوجهتهٔ احتمالاً گمراه‌کننده در UTF\-8 در کامنت‌ها، رشته‌های لفظی، ثوابت نویسه‌ای و شناسه‌ها هشدار می‌دهد. چنین نویسه‌هایی می‌توانند جهت نوشتن از چپ به راست را به راست به چپ (و برعکس) تغییر دهند، که می‌تواند باعث سردرگمی میان ترتیب منطقی و ترتیب دیداری شود. این مسئله می‌تواند خطرناک باشد؛ برای نمونه، ممکن است به نظر برسد بخشی از کد کامنت نشده است، در حالی که در واقع کامنت است.
.Sp
سه سطح هشدار توسط GCC پشتیبانی می‌شود. پیش‌فرض \fB\-Wbidi\-chars=unpaired\fR است که دربارهٔ بافت‌های دوجهته که به درستی پایان نیافته‌اند هشدار می‌دهد. گزینهٔ \fB\-Wbidi\-chars=none\fR هشدار را غیرفعال می‌کند. گزینهٔ \fB\-Wbidi\-chars=any\fR دربارهٔ هرگونه استفاده از نویسه‌های کنترلی دوجهته هشدار می‌دهد.
.Sp
به‌طور پیش‌فرض، این هشدار دربارهٔ UCNها اخطار نمی‌دهد. با این حال، می‌توان چنین بررسی را با استفاده از \fB\-Wbidi\-chars=unpaired,ucn\fR یا \&\fB\-Wbidi\-chars=any,ucn\fR فعال کرد. استفاده از \fB\-Wbidi\-chars=ucn\fR معتبر است، و در صورتی که پیش‌تر \fB\-Wbidi\-chars=any\fR مشخص نشده باشد، معادل \fB\-Wbidi\-chars=unpaired,ucn\fR خواهد بود.
.IP \fB\-Wbool\-compare\fR 4
.IX Item "-Wbool-compare"
دربارهٔ مقایسهٔ عبارت بولی با یک مقدار عددی صحیح متفاوت با \&\f(CW\*(C`true\*(C'\fR/\f(CW\*(C`false\*(C'\fR هشدار می‌دهد. برای نمونه، مقایسهٔ زیر همیشه نادرست (false) است:
.Sp
.Vb 3
\&        int n = 5;
\&        ...
\&        if ((n > 1) == 2) { ... }
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wbool\-operation\fR 4
.IX Item "-Wbool-operation"
دربارهٔ عملیات‌های مشکوک روی عبارت‌هایی از نوع بولی هشدار می‌دهد. برای نمونه، نقیض بیتی (bitwise negation) یک مقدار بولی بسیار محتمل است که یک اشکال در برنامه باشد. برای زبان C، این هشدار همچنین در مورد افزایش یا کاهش یک مقدار بولی اخطار می‌دهد که به‌ندرت معقول است. (در C++، کاهش دادن یک متغیر بولی همیشه نامعتبر است. افزایش دادن یک مقدار بولی در C++17 نامعتبر و در سایر نسخه‌ها منسوخ است.)
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wduplicated\-branches\fR 4
.IX Item "-Wduplicated-branches"
هنگامی که یک ساختار if\-else دارای شاخه‌های یکسان باشد هشدار می‌دهد. این هشدار مواردی مانند زیر را تشخیص می‌دهد:
.Sp
.Vb 4
\&        if (p != NULL)
\&          return 0;
\&        else
\&          return 0;
.Ve
.Sp
اگر هر دو شاخه تنها شامل یک دستور تهی باشند هشدار نمی‌دهد. این هشدار همچنین برای عملگرهای شرطی عمل می‌کند:
.Sp
.Vb 1
\&          int i = x ? *p : *p;
.Ve
.IP \fB\-Wduplicated\-cond\fR 4
.IX Item "-Wduplicated-cond"
دربارهٔ شرط‌های تکراری در یک زنجیرهٔ if\-else\-if هشدار می‌دهد. برای نمونه، برای کد زیر هشدار می‌دهد:
.Sp.Vb 2
\&        if (p\->q != NULL) { ... }
\&        else if (p\->q != NULL) { ... }
.Ve
.IP \fB\-Wframe\-address\fR 4
.IX Item "-Wframe-address"
هنگامی که \fB_\|_builtin_frame_address\fR یا \fB_\|_builtin_return_address\fR با یک آرگومان بزرگ‌تر از 0 فراخوانی شوند، هشدار می‌دهد. چنین فراخوانی‌هایی ممکن است مقادیر نامعینی برگردانند یا باعث خرابی (crash) برنامه شوند. این هشدار در \fB\-Wall\fR گنجانده شده است.
.IP "\fB\-Wno\-discarded\-qualifiers\fR (فقط C و Objective\-C)" 4
.IX Item "-Wno-discarded-qualifiers (C and Objective-C only)"
اگر توصیف‌کننده‌های نوع (type qualifiers) روی اشاره‌گرها نادیده گرفته شوند، هشدار نمی‌دهد. به‌طور معمول، کامپایلر زمانی که یک متغیر \f(CW\*(C`const char *\*(C'\fR به تابعی ارسال شود که پارامتر \f(CW\*(C`char *\*(C'\fR می‌پذیرد، هشدار می‌دهد. از این گزینه می‌توان برای جلوگیری از نمایش چنین هشداری استفاده کرد.
.IP "\fB\-Wno\-discarded\-array\-qualifiers\fR (فقط C و Objective\-C)" 4
.IX Item "-Wno-discarded-array-qualifiers (C and Objective-C only)"
اگر توصیف‌کننده‌های نوع روی آرایه‌هایی که هدف اشاره‌گر هستند نادیده گرفته شوند، هشدار نمی‌دهد. به‌طور معمول، کامپایلر زمانی که یک متغیر \f(CW\*(C`const int (*)[]\*(C'\fR به تابعی ارسال شود که پارامتر \f(CW\*(C`int (*)[]\*(C'\fR می‌پذیرد، هشدار می‌دهد. از این گزینه می‌توان برای جلوگیری از چنین هشداری استفاده کرد.
.IP "\fB\-Wno\-incompatible\-pointer\-types\fR (فقط C و Objective\-C)" 4
.IX Item "-Wno-incompatible-pointer-types (C and Objective-C only)"
هنگامی که تبدیلی میان اشاره‌گرهایی با انواع ناسازگار رخ می‌دهد، هشدار نمی‌دهد. این هشدار برای مواردی است که تحت پوشش \fB\-Wno\-pointer\-sign\fR قرار نمی‌گیرند؛ گزینه‌ای که برای ارسال آرگومان‌های اشاره‌گر یا انتساب با علامت‌داری (signedness) متفاوت هشدار می‌دهد.
.Sp
به‌طور پیش‌فرض، در C99 و گویش‌های بعدی C، کامپایلر GCC با این مسئله مانند یک خطا برخورد می‌کند. این خطا می‌تواند با استفاده از \fB\-fpermissive\fR (همراه با برخی خطاهای دیگر)، یا فقط برای این خطا به‌تنهایی با \fB\-Wno\-error=incompatible\-pointer\-types\fR به یک هشدار تنزل داده شود.
.Sp
این هشدار توسط \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wno\-int\-conversion\fR (فقط C و Objective\-C)" 4
.IX Item "-Wno-int-conversion (C and Objective-C only)"
درباره تبدیلات ناسازگار عدد صحیح به اشاره‌گر و اشاره‌گر به عدد صحیح هشدار نمی‌دهد. این هشدار مربوط به تبدیلات ضمنی (implicit) است؛ برای تبدیلات صریح (explicit) می‌توان از هشدارهای \fB\-Wno\-int\-to\-pointer\-cast\fR و \fB\-Wno\-pointer\-to\-int\-cast\fR استفاده کرد.
.Sp
به‌طور پیش‌فرض، در C99 و گویش‌های بعدی C، کامپایلر GCC با این مسئله مانند یک خطا برخورد می‌کند. این خطا می‌تواند با استفاده از \fB\-fpermissive\fR (همراه با برخی خطاهای دیگر)، یا فقط برای این خطا به‌تنهایی با \fB\-Wno\-error=int\-conversion\fR به یک هشدار تنزل داده شود.
.Sp
این هشدار توسط \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wzero\-as\-null\-pointer\-constant\fR 4
.IX Item "-Wzero-as-null-pointer-constant"
هنگامی که از یک لیترال \fB0\fR به‌عنوان ثابت اشاره‌گر تهی (null pointer constant) استفاده شود، هشدار می‌دهد.
.IP \fB\-Wzero\-length\-bounds\fR 4
.IX Item "-Wzero-length-bounds"
درباره دسترسی به عناصر اعضای آرایه‌ای با طول صفر که ممکن است با سایر اعضای همان شیء همپوشانی داشته باشند هشدار می‌دهد. اعلان آرایه‌های با طول صفرِ درونی توصیه نمی‌شود، زیرا دسترسی به آن‌ها تعریف‌نشده (undefined) است.
.Sp
برای مثال، دو ذخیره‌سازی نخست در تابع \f(CW\*(C`bad\*(C'\fR تشخیص داده می‌شوند زیرا عناصر آرایه با اعضای بعدی \f(CW\*(C`b\*(C'\fR و \f(CW\*(C`c\*(C'\fR همپوشانی دارند. ذخیره‌سازی سوم توسط \fB\-Warray\-bounds\fR تشخیص داده می‌شود زیرا خارج از محدوده شیء دربرگیرنده است.
.Sp
.Vb 2
\&        struct X { int a[0]; int b, c; };
\&        struct X x;
\&        
\&        void bad (void)
\&        {
\&          x.a[0] = 0;   // \-Wzero\-length\-bounds
\&          x.a[1] = 1;   // \-Wzero\-length\-bounds
\&          x.a[2] = 2;   // \-Warray\-bounds
\&        }
.Ve
.Sp
گزینه \fB\-Wzero\-length\-bounds\fR توسط \fB\-Warray\-bounds\fR فعال می‌شود.
.IP \fB\-Wno\-div\-by\-zero\fR 4
.IX Item "-Wno-div-by-zero"
درباره تقسیم بر صفر عدد صحیح در زمان کامپایل هشدار نمی‌دهد. درباره تقسیم بر صفر ممیز شناور هشداری داده نمی‌شود، زیرا می‌تواند روشی معتبر برای به‌دست آوردن مقادیر بی‌نهایت (infinities) و NaN باشد.
.IP \fB\-Wsystem\-headers\fR 4
.IX Item "-Wsystem-headers"
پیام‌های هشدار را برای ساختارهایی که در فایل‌های سرآیند سیستم (system headers) یافت می‌شوند، چاپ می‌کند. هشدارهای مربوط به سرآیندهای سیستم معمولاً با این فرض نادیده گرفته می‌شوند که نشان‌دهنده مشکلات واقعی نیستند و تنها خواندن خروجی کامپایلر را دشوارتر می‌کنند. استفاده از این گزینه خط فرمان به GCC می‌گوید هشدارهای سرآیندهای سیستم را به گونه‌ای صادر کند که گویی در کد کاربر رخ داده‌اند. با این حال، توجه داشته باشید که استفاده از \fB\-Wall\fR همراه با این گزینه، درباره پراگماهای ناشناخته در سرآیندهای سیستم هشدار \fIنمی‌دهد\fR\-\-\-برای این منظور، باید از \fB\-Wunknown\-pragmas\fR نیز استفاده شود.
.IP \fB\-Wtautological\-compare\fR 4
.IX Item "-Wtautological-compare"
اگر یک مقایسه با خود (self-comparison) همواره به true یا false ارزیابی شود، هشدار می‌دهد. این هشدار خطاهای گوناگونی را تشخیص می‌دهد، مانند:
.Sp
.Vb 3
\&        int i = 1;
\&        ...
\&        if (i > i) { ... }
.Ve
.Sp
این هشدار همچنین درباره مقایسه‌های بیتی که همیشه به true یا false ارزیابی می‌شوند هشدار می‌دهد؛ برای نمونه:
.Sp
.Vb 1
\&        if ((a & 16) == 10) { ... }
.Ve
.Sp
همواره false خواهد بود.
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wtrailing\-whitespace\fR 4
.IX Item "-Wtrailing-whitespace"
.PD 0
.IP \fB\-Wtrailing\-whitespace=\fR\fIkind\fR 4
.IX Item "-Wtrailing-whitespace=kind"
.PD
درباره فاصله‌های خالی انتهایی (trailing whitespace) در پایان خطوط، از جمله درون کامنت‌ها، اما به استثنای فاصله‌های خالی انتهایی در لیترال‌های رشته‌ای خام، هشدار می‌دهد.
\&\f(CW\*(C`\-Wtrailing\-whitespace\*(C'\fR معادل \f(CW\*(C`\-Wtrailing\-whitespace=blanks\*(C'\fR است و تنها درباره نویسه‌های فاصله و تب افقی در انتهای خط هشدار می‌دهد. \f(CW\*(C`\-Wtrailing\-whitespace=any\*(C'\fR درباره این موارد یا نویسه‌های form feed و تب عمودی انتهایی هشدار می‌دهد.
\&\f(CW\*(C`\-Wno\-trailing\-whitespace\*(C'\fR یا \f(CW\*(C`\-Wtrailing\-whitespace=none\*(C'\fR این هشدار را غیرفعال می‌کند که وضعیت پیش‌فرض است.
این یک هشدار مربوط به سبک کدنویسی است.
.IP \fB\-Wleading\-whitespace=\fR\fIkind\fR 4
.IX Item "-Wleading-whitespace=kind"
درباره مسائل مربوط به سبک در فاصله‌های خالی ابتدای سطر (leading whitespace)، اما نه مقدار تورفتگی، هشدار می‌دهد. برخی پروژه‌ها از سبک‌های کدنویسی استفاده می‌کنند که در آن‌ها فقط از فاصله‌ها برای تورفتگی استفاده می‌شود، برخی دیگر فقط از تب‌ها، و برخی دیگر از صفر یا چند تب (برای مضارب \f(CW\*(C`\-ftabstop=\fR\f(CIn\fR\f(CW\*(C'\fR) و به دنبال آن صفر یا کمتر از \fIn\fR فاصله استفاده می‌کنند. روی خطوطی که منحصراً شامل فضای خالی هستند هشداری صادر نمی‌شود (اگرچه ممکن است هشدار \f(CW\*(C`\-Wtrailing\-whitespace=\*(C'\fR صادر شود)، و درون لیترال‌های رشته‌ای خام نیز هشداری صادر نمی‌شود. همچنین برای فاصله‌های خالی ابتدایی درون کامنت‌های چندخطی هشدار صادر می‌شود.
\&\f(CW\*(C`\-Wleading\-whitespace=spaces\*(C'\fR برای پروژه‌هایی که می‌خواهند تورفتگی را فقط با فاصله‌ها اعمال کنند، درباره فاصله‌های خالی ابتدایی غیر از فاصله هشدار می‌دهد.
\&\f(CW\*(C`\-Wleading\-whitespace=tabs\*(C'\fR برای پروژه‌هایی که می‌خواهند تورفتگی را فقط با تب‌های افقی اعمال کنند، درباره فاصله‌های خالی ابتدایی غیر از تب‌های افقی هشدار می‌دهد.
\&\f(CW\*(C`\-Wleading\-whitespace=blanks\*(C'\fR درباره فاصله‌های خالی ابتدایی غیر از فاصله و تب افقی، یا درباره تب افقی پس از یک فاصله در ابتدای سطر، یا درباره \fIn\fR یا بیشتر فاصله متوالی در فاصله‌های ابتدایی هشدار می‌دهد (که در آن \fIn\fR آرگومان \f(CW\*(C`\-ftabstop=\fR\f(CIn\fR\f(CW\*(C'\fR است و به‌طور پیش‌فرض 8 می‌باشد).
\&\f(CW\*(C`\-Wleading\-whitespace=none\*(C'\fR این هشدار را غیرفعال می‌کند که حالت پیش‌فرض است.
این یک هشدار مربوط به سبک کدنویسی است.
.IP \fB\-Wtrampolines\fR 4
.IX Item "-Wtrampolines"
درباره ترامپولین‌های (trampolines) تولیدشده برای اشاره‌گرهای به توابع تودرتو هشدار می‌دهد. ترامپولین قطعه کوچکی از داده یا کد است که در زمان اجرا، هنگامی که نشانی یک تابع تودرتو گرفته می‌شود روی پشته (stack) ایجاد می‌گردد و برای فراخوانی غیرمستقیم تابع تودرتو استفاده می‌شود. برای برخی هدف‌ها، ترامپولین تنها از داده تشکیل شده است و بنابراین به رفتار خاصی نیاز ندارد. اما برای بیشتر هدف‌ها، از کد تشکیل شده است و بنابراین مستلزم آن است که پشته قابل‌اجرا شود تا برنامه به درستی کار کند.
.IP \fB\-Wfloat\-equal\fR 4
.IX Item "-Wfloat-equal"
اگر از مقادیر ممیز شناور در مقایسه‌های برابری استفاده شود، هشدار می‌دهد.
.Sp
ایده پشت این هشدار این است که گاهی (برای برنامه‌نویس) مناسب‌تر است که مقادیر ممیز شناور را تقریب‌هایی از اعداد حقیقی با دقت نامحدود در نظر بگیرد. اگر چنین می‌کنید، باید (با تحلیل کد یا روشی دیگر) حداکثر یا حداکثر خطای احتمالی ناشی از محاسبات را حساب کرده و هنگام مقایسه‌ها آن را در نظر بگیرید (و همچنین هنگام تولید خروجی، اما آن مسئله دیگری است). به‌ویژه، به‌جای بررسی برابری دقیق، باید بررسی کنید که آیا این دو مقدار دارای بازه‌های همپوشان هستند یا خیر؛ و این کار با عملگرهای رابطه‌ای انجام می‌شود، بنابراین مقایسه‌های برابری احتمالاً اشتباه هستند.
.IP "\fB\-Wtraditional\fR (فقط C و Objective\-C)" 4
.IX Item "-Wtraditional (C and Objective-C only)"
درباره ساختارهای خاصی که در C سنتی و ISO C رفتار متفاوتی دارند هشدار می‌دهد. همچنین درباره ساختارهای ISO C که معادلی در C سنتی ندارند، و/یا ساختارهای مسئله‌داری که باید از آن‌ها اجتناب شود، هشدار می‌دهد.
.RS 4
.IP * 4
پارامترهای ماکرو که درون لیترال‌های رشته‌ای در بدنه ماکرو ظاهر می‌شوند. در C سنتی، جایگزینی ماکرو درون لیترال‌های رشته‌ای انجام می‌شود، اما در ISO C چنین نیست..IP * 4
در C سنتی، برخی دستورالعمل‌های پیش‌پردازنده وجود نداشتند.
پیش‌پردازنده‌های سنتی تنها در صورتی یک خط را به عنوان دستورالعمل در نظر می‌گرفتند
که \fB#\fR در ستون ۱ خط ظاهر می‌شد. بنابراین
\&\fB\-Wtraditional\fR دربارهٔ دستورالعمل‌هایی هشدار می‌دهد که C سنتی
درک می‌کند اما چون \fB#\fR به عنوان نخستین نویسهٔ خط ظاهر نشده است نادیده می‌گیرد.
همچنین پیشنهاد می‌کند دستورالعمل‌هایی مانند
\&\f(CW\*(C`#pragma\*(C'\fR را که در C سنتی پشتیبانی نمی‌شوند، با ایجاد تورفتگی پنهان کنید. برخی
پیاده‌سازی‌های سنتی \f(CW\*(C`#elif\*(C'\fR را بازشناسی نمی‌کنند، بنابراین این گزینه
پیشنهاد می‌کند به طور کلی از آن اجتناب شود.
.IP * 4
ماکروی تابع‌گونه‌ای که بدون آرگومان ظاهر شود.
.IP * 4
پسوند ثابت عدد صحیح \fBU\fR، یا پسوندهای ثابت ممیز شناور \fBF\fR یا \fBL\fR.
(C سنتی از پسوند \fBL\fR روی ثابت‌های عدد صحیح پشتیبانی می‌کند.)
توجه داشته باشید که این پسوندها در ماکروهای تعریف‌شده در سرآیندهای سیستمی اکثر سامانه‌های نوین ظاهر می‌شوند،
مانند ماکروهای \fB_MIN\fR/\fB_MAX\fR در \f(CW\*(C`<limits.h>\*(C'\fR.
استفاده از این ماکروها در کد کاربر ممکن است به طور معمول منجر به هشدارهای کاذب شود،
با این وجود پیش‌پردازندهٔ یکپارچهٔ GCC زمینهٔ کافی برای اجتناب از صدور هشدار در این موارد را دارد.
.IP * 4
تابعی که در یک بلوک به صورت خارجی (external) اعلان شده و سپس پس از پایان آن بلوک استفاده شده است.
.IP * 4
یک دستور \f(CW\*(C`switch\*(C'\fR که عملوندی از نوع \f(CW\*(C`long\*(C'\fR دارد.
.IP * 4
اعلان یک تابع غیر \f(CW\*(C`static\*(C'\fR که پس از یک اعلان \f(CW\*(C`static\*(C'\fR بیاید.
این ساختار توسط برخی کامپایلرهای C سنتی پذیرفته نمی‌شود.
.IP * 4
نوع ISO یک ثابت عدد صحیح، پهنا یا علامت‌داری متفاوتی نسبت به نوع سنتی آن داشته باشد.
این هشدار تنها در صورتی صادر می‌شود که مبنای عدد ثابت ۱۰ باشد؛
یعنی دربارهٔ مقادیر هگزادسیمال یا اوکتال، که معمولاً الگوهای بیتی را نشان می‌دهند، هشداری صادر نمی‌شود.
.IP * 4
استفاده از الحاق رشتهٔ ISO تشخیص داده شود.
.IP * 4
مقداردهی اولیهٔ ساختارهای تجمعی (aggregates) خودکار.
.IP * 4
تداخل شناسه‌ها با برچسب‌ها (labels). C سنتی فاقد فضای نام مجزا برای برچسب‌ها است.
.IP * 4
مقداردهی اولیهٔ اجتماع‌ها (unions). اگر مقداردهندهٔ اولیه صفر باشد، از هشدار صرف‌نظر می‌شود.
این کار با این فرض انجام می‌گیرد که مقداردهی صفر در کد کاربر، مشروط به مواردی مانند
\f(CW\*(C`_\|_STDC_\|_\*(C'\fR قرار گرفته تا از هشدارهای مقداردهندهٔ اولیهٔ مفقود جلوگیری شود
و در حالت C سنتی به مقداردهی اولیهٔ پیش‌فرض به صفر متکی است.
.IP * 4
تبدیل‌های ناشی از پیش‌نمونه‌ها (prototypes) میان مقادیر ممیز ثابت/شناور و برعکس.
نبود این پیش‌نمونه‌ها هنگام کامپایل با C سنتی باعث بروز مشکلات جدی می‌شود.
این زیرمجموعه‌ای از هشدارهای تبدیل ممکن است؛ برای مجموعهٔ کامل از \fB\-Wtraditional\-conversion\fR استفاده کنید.
.IP * 4
استفاده از تعاریف توابع به سبک ISO C. این هشدار عمداً برای اعلان‌های پیش‌نمونه
یا توابع با تعداد متغیر آرگومان (variadic) صادر \fIنمی‌شود\fR،
چرا که این ویژگی‌های ISO C هنگام استفاده از ماکروهای سازگاری با C سنتی در libiberty،
یعنی \f(CW\*(C`PARAMS\*(C'\fR و \&\f(CW\*(C`VPARAMS\*(C'\fR، در کد شما ظاهر می‌شوند.
این هشدار همچنین برای توابع تو در تو نادیده گرفته می‌شود، زیرا آن ویژگی خود یک پسوند GCC بوده
و بنابراین به سازگاری با C سنتی مربوط نمی‌شود.
.RE
.RS 4
.RE
.IP "\fB\-Wtraditional\-conversion\fR (فقط C و Objective\-C)" 4
.IX Item "-Wtraditional-conversion (C and Objective-C only)"
هشدار در صورتی که یک پیش‌نمونه باعث تبدیل نوعی شود که با آنچه برای همان آرگومان در نبود پیش‌نمونه رخ می‌داد تفاوت داشته باشد.
این شامل تبدیل‌های ممیز ثابت به ممیز شناور و برعکس، و تبدیل‌هایی است که پهنا یا علامت‌داری یک آرگومان ممیز ثابت را تغییر می‌دهند،
مگر زمانی که همانند ارتقای پیش‌فرض باشد.
.IP "\fB\-Wdeclaration\-after\-statement\fR (فقط C و Objective\-C)" 4
.IX Item "-Wdeclaration-after-statement (C and Objective-C only)"
هشدار زمانی که یک اعلان بعد از یک دستور در یک بلوک قرار گیرد.
این ساختار، که از C++ شناخته شده است، با ISO C99 معرفی شد و به طور پیش‌فرض در GCC مجاز است.
این ساختار توسط ISO C90 پشتیبانی نمی‌شود.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wshadow\fR 4
.IX Item "-Wshadow"
هشدار در هر زمانی که یک متغیر محلی یا اعلان نوع، متغیر، پارامتر، نوع، عضو کلاس (در C++) یا متغیر نمونه (در Objective\-C)
دیگری را سایه‌اندازی (shadow) کند، یا هر زمان که یک تابع توکار سایه‌اندازی شود.
توجه داشته باشید که در C++، اگر یک متغیر محلی یک typedef صریح را سایه‌اندازی کند کامپایلر هشدار می‌دهد،
اما اگر یک struct/class/enum را سایه‌اندازی کند هشداری صادر نمی‌کند.
اگر این هشدار فعال شود، شامل تمام موارد سایه‌اندازی محلی نیز می‌شود.
این بدان معناست که در صورت استفاده از \&\fB\-Wshadow\fR، گزینه‌های \fB\-Wno\-shadow=local\fR
و \fB\-Wno\-shadow=compatible\-local\fR نادیده گرفته می‌شوند.
همانند \fB\-Wshadow=global\fR است.
.IP "\fB\-Wno\-shadow\-ivar\fR (فقط Objective\-C)" 4
.IX Item "-Wno-shadow-ivar (Objective-C only)"
هنگامی که یک متغیر محلی، متغیر نمونه‌ای را در یک متد Objective\-C سایه‌اندازی می‌کند، هشدار داده نشود.
.IP \fB\-Wshadow=global\fR 4
.IX Item "-Wshadow=global"
هشدار برای هر گونه سایه‌اندازی.
همانند \fB\-Wshadow\fR است.
.IP \fB\-Wshadow=local\fR 4
.IX Item "-Wshadow=local"
هشدار هنگامی که یک متغیر محلی، متغیر محلی یا پارامتر دیگری را سایه‌اندازی کند.
.IP \fB\-Wshadow=compatible\-local\fR 4
.IX Item "-Wshadow=compatible-local"
هشدار هنگامی که یک متغیر محلی، متغیر محلی یا پارامتر دیگری را سایه‌اندازی کند که نوع آن با نوع متغیر سایه‌انداز سازگار است.
در C++، سازگاری نوع در اینجا به این معناست که نوع متغیر سایه‌انداز می‌تواند به نوع متغیر سایه‌انداخته‌شده تبدیل شود.
ایجاد این پرچم (علاوه بر \fB\-Wshadow=local\fR) بر اساس این ایده است که وقتی یک متغیر محلی، متغیر دیگری با نوع ناسازگار را سایه‌اندازی می‌کند،
به احتمال زیاد عمدی بوده و یک باگ یا غلط تایپی نیست، همان‌طور که در مثال زیر نشان داده شده است:
.Sp
.Vb 8
\&        for (SomeIterator i = SomeObj.begin(); i != SomeObj.end(); ++i)
\&        {
\&          for (int i = 0; i < N; ++i)
\&          {
\&            ...
\&          }
\&          ...
\&        }
.Ve
.Sp
از آنجا که دو متغیر \f(CW\*(C`i\*(C'\fR در مثال بالا انواع ناسازگاری دارند، تنها با فعال کردن \fB\-Wshadow=compatible\-local\fR هشداری صادر نمی‌شود.
از آنجا که نوع‌های آن‌ها ناسازگار است، اگر برنامه‌نویسی تصادفاً از یکی به جای دیگری استفاده کند، انتظار می‌رود که بررسی نوع (type checking) آن را گرفته و خطا یا هشداری صادر کند.
استفاده از این پرچم به جای \fB\-Wshadow=local\fR احتمالاً می‌تواند تعداد هشدارهای ناشی از سایه‌اندازی عمدی را کاهش دهد.
توجه داشته باشید که این همچنین بدان معناست که سایه‌اندازی \f(CW\*(C`const char *i\*(C'\fR توسط
\&\f(CW\*(C`char *i\*(C'\fR هشداری صادر نمی‌کند.
.Sp
این هشدار همچنین توسط \fB\-Wshadow=local\fR فعال می‌شود.
.IP \fB\-Wlarger\-than=\fR\fIbyte\-size\fR 4
.IX Item "-Wlarger-than=byte-size"
هشدار در هر زمانی که شیئی تعریف شود که اندازه‌اش از \fIbyte\-size\fR فراتر رود.
\&\fB\-Wlarger\-than=\fR\fBPTRDIFF_MAX\fR به طور پیش‌فرض فعال است.
هشدارهای کنترل‌شده توسط این گزینه می‌توانند یا با تعیین \fIbyte\-size\fR برابر با \fBSIZE_MAX\fR یا بیشتر، یا با \fB\-Wno\-larger\-than\fR غیرفعال شوند.
.Sp
همچنین برای فراخوانی توابع کران‌دار مانند \f(CW\*(C`memchr\*(C'\fR یا
\&\f(CW\*(C`strnlen\*(C'\fR که کرانی بزرگ‌تر از بزرگ‌ترین شیء ممکن (که به طور پیش‌فرض \fBPTRDIFF_MAX\fR بایت است) مشخص می‌کنند هشدار می‌دهد.
این هشدارها تنها توسط \fB\-Wno\-larger\-than\fR می‌توانند غیرفعال شوند.
.IP \fB\-Wno\-larger\-than\fR 4
.IX Item "-Wno-larger-than"
غیرفعال کردن هشدارهای \fB\-Wlarger\-than=\fR. این گزینه معادل
\fB\-Wlarger\-than=\fR\fBSIZE_MAX\fR یا بزرگ‌تر است.
.IP \fB\-Wframe\-larger\-than=\fR\fIbyte\-size\fR 4
.IX Item "-Wframe-larger-than=byte-size"
هشدار در صورتی که اندازهٔ چارچوب (frame) یک تابع از \fIbyte\-size\fR فراتر رود.
محاسبات انجام‌شده برای تعیین اندازهٔ چارچوب پشته تقریبی بوده و محتاطانه نیست.
نیازمندی‌های واقعی ممکن است تا حدی بیشتر از \fIbyte\-size\fR باشند حتی اگر هشداری دریافت نکنید.
علاوه بر این، هر فضایی که از طریق \f(CW\*(C`alloca\*(C'\fR، آرایه‌های با طول متغیر یا ساختارهای مرتبط تخصیص یابد،
هنگام تعیین صدور یا عدم صدور هشدار توسط کامپایلر لحاظ نمی‌شود.
\&\fB\-Wframe\-larger\-than=\fR\fBPTRDIFF_MAX\fR به طور پیش‌فرض فعال است.
هشدارهای کنترل‌شده توسط این گزینه می‌توانند با مشخص کردن \fIbyte\-size\fR برابر با \fBSIZE_MAX\fR یا بیشتر،
یا با \&\fB\-Wno\-frame\-larger\-than\fR غیرفعال شوند.
.IP \fB\-Wno\-frame\-larger\-than\fR 4
.IX Item "-Wno-frame-larger-than"
غیرفعال کردن هشدارهای \fB\-Wframe\-larger\-than=\fR. این گزینه معادل
\fB\-Wframe\-larger\-than=\fR\fBSIZE_MAX\fR یا بزرگ‌تر است.
.IP \fB\-Wfree\-nonheap\-object\fR 4
.IX Item "-Wfree-nonheap-object"
هشدار هنگام تلاش برای آزادسازی شیئی که یا در هیپ (heap) تخصیص نیافته است،
یا با استفاده از اشاره‌گری که از فراخوانی پیشین تابع تخصیص متناظر بازگردانده نشده است.
به عنوان مثال، از آنجا که فراخوانی \f(CW\*(C`stpcpy\*(C'\fR اشاره‌گری به نویسهٔ پایانی nul بازمی‌گرداند
و نه به ابتدای شیء، فراخوانی \f(CW\*(C`free\*(C'\fR در زیر تشخیص داده شده و هشدار می‌گیرد.
.Sp
.Vb 6
\&        void f (char *p)
\&        {
\&          p = stpcpy (p, "abc");
\&          // ...
\&          free (p);   // warning
\&        }
.Ve
.Sp
\&\fB\-Wfree\-nonheap\-object\fR در \fB\-Wall\fR گنجانده شده است..IP \fB\-Wstack\-usage=\fR\fIbyte\-size\fR 4
.IX Item "-Wstack-usage=byte-size"
اگر میزان استفاده از پشته (stack) در یک تابع ممکن است از \fIbyte\-size\fR فراتر رود، هشدار می‌دهد.
محاسبات انجام‌شده برای تعیین میزان استفاده از پشته، محافظه‌کارانه است.
هر فضای تخصیص‌یافته از طریق \f(CW\*(C`alloca\*(C'\fR، آرایه‌های با طول متغیر (variable-length arrays)،
یا ساختارهای مرتبط هنگام تعیین صدور یا عدم صدور هشدار توسط کامپایلر
لحاظ می‌شود.
.Sp
پیام هشدار با خروجی \fB\-fstack\-usage\fR همخوانی دارد.
.RS 4
.IP * 4
اگر استفاده از پشته کاملاً ایستا (static) باشد اما از مقدار مشخص‌شده فراتر رود:
.Sp
.Vb 1
\&          warning: stack usage is 1120 bytes
.Ve
.IP * 4
اگر استفاده از پشته (تا حدی) پویا اما محدود (bounded) باشد:
.Sp
.Vb 1
\&          warning: stack usage might be 1648 bytes
.Ve
.IP * 4
اگر استفاده از پشته (تا حدی) پویا و نامحدود باشد:
.Sp
.Vb 1
\&          warning: stack usage might be unbounded
.Ve
.RE
.RS 4
.Sp
گزینهٔ \&\fB\-Wstack\-usage=\fR\fBPTRDIFF_MAX\fR به صورت پیش‌فرض فعال است.
هشدارهای تحت کنترل این گزینه را می‌توان یا با مشخص کردن
\&\fIbyte\-size\fR برابر با \fBSIZE_MAX\fR یا بیشتر، یا با استفاده از
\&\fB\-Wno\-stack\-usage\fR غیرفعال کرد.
.RE
.IP \fB\-Wno\-stack\-usage\fR 4
.IX Item "-Wno-stack-usage"
هشدارهای \fB\-Wstack\-usage=\fR را غیرفعال می‌کند. این گزینه معادل
با \fB\-Wstack\-usage=\fR\fBSIZE_MAX\fR یا بزرگ‌تر است.
.IP \fB\-Wunsafe\-loop\-optimizations\fR 4
.IX Item "-Wunsafe-loop-optimizations"
اگر حلقه نتواند بهینه‌سازی شود به این دلیل که کامپایلر نمی‌تواند هیچ فرضی
دربارهٔ کران‌های شاخص‌های حلقه داشته باشد، هشدار می‌دهد. به همراه
\&\fB\-funsafe\-loop\-optimizations\fR، در صورتی که کامپایلر چنین فرضیاتی
را در نظر بگیرد، هشدار می‌دهد.
.IP "\fB\-Wno\-pedantic\-ms\-format\fR (تنها در مقصدهای MinGW)" 4
.IX Item "-Wno-pedantic-ms-format (MinGW targets only)"
هنگامی که در ترکیب با \fB\-Wformat\fR
و \fB\-pedantic\fR بدون افزونه‌های GNU استفاده شود، این گزینه
هشدارهای مربوط به مشخص‌کننده‌های عرض قالب غیر ISO در \f(CW\*(C`printf\*(C'\fR / \f(CW\*(C`scanf\*(C'\fR
شامل \f(CW\*(C`I32\*(C'\fR، \f(CW\*(C`I64\*(C'\fR و \f(CW\*(C`I\*(C'\fR مورد استفاده در مقصدهای Windows (که
به زمان اجرای MS وابسته‌اند) را غیرفعال می‌کند.
.IP \fB\-Wpointer\-arith\fR 4
.IX Item "-Wpointer-arith"
دربارهٔ هر چیزی که به «اندازهٔ» (size of) یک نوع تابع یا
\f(CW\*(C`void\*(C'\fR وابسته باشد، هشدار می‌دهد. کامپایلر GNU C برای راحتی در
محاسبات با اشاره‌گرهای \f(CW\*(C`void *\*(C'\fR و اشاره‌گرها به توابع، اندازهٔ این نوع‌ها
را ۱ تعیین می‌کند. در C++‎، همچنین زمانی که یک عمل حسابی شامل
\&\f(CW\*(C`NULL\*(C'\fR باشد، هشدار می‌دهد. این هشدار با \fB\-Wpedantic\fR نیز فعال می‌شود.
.Sp
این هشدار با استفاده از \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wno\-pointer\-compare\fR 4
.IX Item "-Wno-pointer-compare"
اگر اشاره‌گری با یک ثابت نویسه‌ای صفر مقایسه شود، هشدار نمی‌دهد. این وضعیت معمولاً
به این معنی است که هدف برنامه‌نویس ارجاع‌زدایی (dereference) از اشاره‌گر بوده است. برای نمونه:
.Sp
.Vb 3
\&        const char *p = foo ();
\&        if (p == \*(Aq\e0\*(Aq)
\&          return 42;
.Ve
.Sp
توجه داشته باشید که کد بالا در C++11 نامعتبر است.
.Sp
این هشدار به صورت پیش‌فرض فعال است.
.IP \fB\-Wno\-tsan\fR 4
.IX Item "-Wno-tsan"
هشدارهای مربوط به قابلیت‌های پشتیبانی‌نشده در ThreadSanitizer را غیرفعال می‌کند.
.Sp
ابزار ThreadSanitizer از \f(CW\*(C`std::atomic_thread_fence\*(C'\fR پشتیبانی نمی‌کند و
ممکن است موارد مثبت کاذب (false positive) گزارش کند.
.IP \fB\-Wtype\-limits\fR 4
.IX Item "-Wtype-limits"
اگر مقایسه‌ای به دلیل بازهٔ محدود نوع داده همیشه درست (true) یا همیشه نادرست (false)
باشد، هشدار می‌دهد؛ اما برای عبارت‌های ثابت هشداری صادر نمی‌کند. برای نمونه،
اگر یک متغیر بدون علامت (unsigned) با استفاده از
\&\f(CW\*(C`<\*(C'\fR یا \f(CW\*(C`>=\*(C'\fR با صفر مقایسه شود، هشدار می‌دهد. این هشدار با
\&\fB\-Wextra\fR نیز فعال می‌شود.
.IP "\fB\-Wabsolute\-value\fR (تنها در C و Objective\-C)" 4
.IX Item "-Wabsolute-value (C and Objective-C only)"
هنگام فراخوانی توابع استانداردی که قدر مطلق (absolute value) یک آرگومان را
محاسبه می‌کنند، در صورتی که تابع استاندارد مناسب‌تری در دسترس باشد، هشدار می‌دهد.
برای نمونه، فراخوانی \f(CWabs(3.14)\fR این هشدار را صادر می‌کند زیرا تابع مناسب
برای محاسبهٔ قدر مطلق یک آرگومان از نوع double، تابع \f(CW\*(C`fabs\*(C'\fR است. این
گزینه همچنین زمانی که آرگومانِ یک فراخوانی به چنین تابعی دارای نوع بدون علامت
(unsigned) باشد، هشدار می‌دهد. این هشدار را می‌توان با تبدیل نوع صریح (explicit type cast)
مهار کرد و همچنین با \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wcomment\fR 4
.IX Item "-Wcomment"
.PD 0
.IP \fB\-Wcomments\fR 4
.IX Item "-Wcomments"
.PD
هرگاه توالی شروع کامنت \fB/*\fR درون یک کامنت \fB/*\fR ظاهر شود،
یا هرگاه یک بک‌اسلش-خط‌جدید (backslash-newline) درون یک کامنت \fB//\fR قرار گیرد، هشدار می‌دهد.
این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wtrigraphs\fR 4
.IX Item "-Wtrigraphs"
اگر با هر سه‌نویسه‌ای (trigraph) مواجه شود که ممکن است معنای برنامه را تغییر دهد،
هشدار می‌دهد. دربارهٔ سه‌نویسه‌های درون کامنت‌ها هشداری داده نمی‌شود،
به جز مواردی که یک خط جدید گریزدار (escaped newline) ایجاد کنند.
.Sp
این گزینه به صورت ضمنی توسط \fB\-Wall\fR فعال می‌شود. اگر \fB\-Wall\fR مشخص
نشده باشد، این گزینه همچنان فعال است مگر اینکه trigraphها فعال شده باشند. برای
تبدیل trigraph بدون دریافت هشدار، اما دریافت سایر هشدارهای
\&\fB\-Wall\fR، از \fB\-trigraphs \-Wall \-Wno\-trigraphs\fR استفاده کنید.
.IP \fB\-Wundef\fR 4
.IX Item "-Wundef"
اگر یک شناسهٔ تعریف‌نشده در یک دستور \f(CW\*(C`#if\*(C'\fR ارزیابی شود، هشدار می‌دهد.
چنین شناسه‌هایی با صفر جایگزین می‌شوند.
.IP \fB\-Wexpansion\-to\-defined\fR 4
.IX Item "-Wexpansion-to-defined"
هرگاه \fBdefined\fR در بسط (expansion) یک ماکرو ظاهر شود
(شامل حالتی که ماکرو توسط یک دستور \fB#if\fR باز می‌شود)، هشدار می‌دهد.
چنین کاربردی غیرقابل‌حمل (non-portable) است.
این هشدار با \fB\-Wpedantic\fR و \fB\-Wextra\fR نیز فعال می‌شود.
.IP \fB\-Wunused\-macros\fR 4
.IX Item "-Wunused-macros"
دربارهٔ ماکروهای تعریف‌شده در فایل اصلی که بلااستفاده مانده‌اند هشدار می‌دهد. یک ماکرو
در صورتی \fIاستفاده‌شده\fR تلقی می‌شود که دست‌کم یک‌بار بسط داده شود یا وجود آن بررسی گردد.
پیش‌پردازنده همچنین در صورتی که ماکرو در زمان بازتعریف (redefinition) یا لغو تعریف (undefinition)
استفاده نشده باشد، هشدار می‌دهد.
.Sp
دربارهٔ ماکروهای توکار (built-in)، ماکروهای تعریف‌شده در خط فرمان، و ماکروهای
تعریف‌شده در فایل‌های include هشداری داده نمی‌شود.
.Sp
\&\fIنکته:\fR اگر ماکرویی واقعاً استفاده شده باشد، اما صرفاً درون بلوک‌های شرطی
نادیده‌گرفته‌شده (skipped) قرار داشته باشد، پیش‌پردازنده آن را به عنوان استفاده‌نشده گزارش می‌کند. برای
جلوگیری از هشدار در چنین مواردی، می‌توانید حوزهٔ تعریف ماکرو را بهبود ببخشید؛
مثلاً با انتقال آن به اولین بلوک نادیده‌گرفته‌شده. در غیر این صورت، می‌توانید
یک کاربرد صوری (dummy use) شبیه به عبارت زیر فراهم کنید:
.Sp
.Vb 2
\&        #if defined the_macro_causing_the_warning
\&        #endif
.Ve
.IP \fB\-Wno\-endif\-labels\fR 4
.IX Item "-Wno-endif-labels"
هرگاه متنی در ادامهٔ یک \f(CW\*(C`#else\*(C'\fR یا یک \f(CW\*(C`#endif\*(C'\fR بیاید، هشدار نمی‌دهد.
این وضعیت گاهی در برنامه‌های قدیمی‌تر با کدهایی به شکل زیر رخ می‌دهد:
.Sp
.Vb 5
\&        #if FOO
\&        ...
\&        #else FOO
\&        ...
\&        #endif FOO
.Ve
.Sp
دومین و سومین \f(CW\*(C`FOO\*(C'\fR باید درون کامنت قرار گیرند.
این هشدار به طور پیش‌فرض فعال است.
.IP "\fB\-Wbad\-function\-cast\fR (تنها در C و Objective\-C)" 4
.IX Item "-Wbad-function-cast (C and Objective-C only)"
هنگامی که فراخوانی یک تابع به نوعی ناسازگار تبدیل (cast) شود، هشدار می‌دهد.
برای نمونه، اگر فراخوانی تابعی که یک نوع عدد صحیح را برمی‌گرداند به
یک نوع اشاره‌گر تبدیل شود، هشدار می‌دهد.
.IP "\fB\-Wc90\-c99\-compat\fR (تنها در C و Objective\-C)" 4
.IX Item "-Wc90-c99-compat (C and Objective-C only)"
دربارهٔ قابلیت‌هایی که در ISO C90 وجود ندارند، اما در ISO C99 موجودند، هشدار می‌دهد.
برای نمونه، دربارهٔ استفاده از آرایه‌های با طول متغیر (variable length arrays)، نوع \f(CW\*(C`long long\*(C'\fR،
نوع \f(CW\*(C`bool\*(C'\fR، مقدارهای لفظی مرکب (compound literals)، مقداردهنده‌های اولیه‌ٔ معین (designated initializers)
و غیره هشدار می‌دهد. این گزینه مستقل از حالت استانداردها است. هشدارها
در عبارتی که پس از \f(CW\*(C`_\|_extension_\|_\*(C'\fR می‌آید، غیرفعال می‌شوند.
.IP "\fB\-Wc99\-c11\-compat\fR (تنها در C و Objective\-C)" 4
.IX Item "-Wc99-c11-compat (C and Objective-C only)"
دربارهٔ قابلیت‌هایی که در ISO C99 وجود ندارند، اما در ISO C11 موجودند، هشدار می‌دهد.
برای نمونه، دربارهٔ استفاده از ساختارها و اجتماعات بی‌نام (anonymous structures and unions)،
توصیف‌کنندهٔ نوع \&\f(CW\*(C`_Atomic\*(C'\fR، مشخص‌کنندهٔ ردهٔ حافظهٔ \f(CW\*(C`_Thread_local\*(C'\fR،
مشخص‌کنندهٔ \&\f(CW\*(C`_Alignas\*(C'\fR، عملگر \f(CW\*(C`Alignof\*(C'\fR، کلیدواژهٔ \f(CW\*(C`_Generic\*(C'\fR
و غیره هشدار می‌دهد. این گزینه مستقل از حالت استانداردها است. هشدارها
در عبارتی که پس از \f(CW\*(C`_\|_extension_\|_\*(C'\fR می‌آید، غیرفعال می‌شوند..IP "\fB\-Wc11\-c23\-compat\fR (فقط C و Objective\-C)" 4
.IX Item "-Wc11-c23-compat (C and Objective-C only)"
.PD 0
.IP "\fB\-Wc11\-c2x\-compat\fR (فقط C و Objective\-C)" 4
.IX Item "-Wc11-c2x-compat (C and Objective-C only)"
.PD
درباره ویژگی‌هایی هشدار می‌دهد که در ISO C11 موجود نیستند، اما در ISO C23 وجود دارند.
به‌عنوان مثال، درباره حذف رشته در \f(CW\*(C`_Static_assert\*(C'\fR،
استفاده از نحو \fB[[]]\fR برای صفت‌ها (attributes)، استفاده از انواع
ممیز شناور ده‌دهی و غیره هشدار می‌دهد. این گزینه مستقل از
حالت استاندارد است. هشدارها در عبارتی که پس از
\&\f(CW\*(C`_\|_extension_\|_\*(C'\fR می‌آید غیرفعال می‌شوند. نام \fB\-Wc11\-c2x\-compat\fR
منسوخ شده است.
.Sp
هنگامی که کامپایل در حالت C23 انجام نمی‌شود، این هشدارها توسط
\fB\-pedantic\-errors\fR به خطا ارتقا می‌یابند.
.IP "\fB\-Wc23\-c2y\-compat\fR (فقط C و Objective\-C)" 4
.IX Item "-Wc23-c2y-compat (C and Objective-C only)"
.PD 0
.IP "\fB\-Wc23\-c2y\-compat\fR (فقط C و Objective\-C)" 4
.IX Item "-Wc23-c2y-compat (C and Objective-C only)"
.PD
درباره ویژگی‌هایی هشدار می‌دهد که در ISO C23 موجود نیستند، اما در ISO C2Y وجود دارند.
به‌عنوان مثال، درباره انتخاب با یک نام نوع به‌جای یک عبارت
در \f(CW\*(C`_Generic\*(C'\fR هشدار می‌دهد. این گزینه مستقل از حالت
استاندارد است. هشدارها در عبارتی که پس از
\&\f(CW\*(C`_\|_extension_\|_\*(C'\fR می‌آید غیرفعال می‌شوند.
.Sp
هنگامی که کامپایل در حالت C2Y انجام نمی‌شود، این هشدارها توسط
\fB\-pedantic\-errors\fR به خطا ارتقا می‌یابند.
.IP "\fB\-Wc++\-compat\fR (فقط C و Objective\-C)" 4
.IX Item "-Wc++-compat (C and Objective-C only)"
درباره ساختارهای ISO C که خارج از زیرمجموعه مشترک
ISO C و ISO C++ هستند هشدار می‌دهد؛ مانند درخواست برای تبدیل ضمنی از
\&\f(CW\*(C`void *\*(C'\fR به یک اشاره‌گر به نوع غیر\-\f(CW\*(C`void\*(C'\fR.
.IP "\fB\-Wc++11\-compat\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wc++11-compat (C++ and Objective-C++ only)"
درباره ساختارهای C++ که معنای آن‌ها بین ISO C++ 1998
و ISO C++ 2011 تفاوت دارد هشدار می‌دهد؛ مانند شناسه‌هایی در ISO C++ 1998 که در
ISO C++ 2011 کلمه کلیدی هستند. این هشدار \fB\-Wnarrowing\fR را روشن می‌کند و
توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wc++14\-compat\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wc++14-compat (C++ and Objective-C++ only)"
درباره ساختارهای C++ که معنای آن‌ها بین ISO C++ 2011
و ISO C++ 2014 تفاوت دارد هشدار می‌دهد. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wc++17\-compat\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wc++17-compat (C++ and Objective-C++ only)"
درباره ساختارهای C++ که معنای آن‌ها بین ISO C++ 2014
و ISO C++ 2017 تفاوت دارد هشدار می‌دهد. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wc++20\-compat\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wc++20-compat (C++ and Objective-C++ only)"
درباره ساختارهای C++ که معنای آن‌ها بین ISO C++ 2017
و ISO C++ 2020 تفاوت دارد هشدار می‌دهد. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wc++26\-compat\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wc++26-compat (C++ and Objective-C++ only)"
درباره ساختارهای C++ که معنای آن‌ها بین ISO C++ 2023
و استاندارد آینده ISO C++ 2026 تفاوت دارد هشدار می‌دهد. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-c++11\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++11-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++11 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++11
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP "\fB\-Wno\-c++14\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++14-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++14 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++14
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP "\fB\-Wno\-c++17\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++17-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++17 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++17
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP "\fB\-Wno\-c++20\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++20-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++20 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++20
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP "\fB\-Wno\-c++23\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++23-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++23 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++23
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP "\fB\-Wno\-c++26\-extensions\fR (فقط C++ و Objective\-C++)" 4
.IX Item "-Wno-c++26-extensions (C++ and Objective-C++ only)"
درباره ساختارهای C++26 در کدی که با استفاده از
یک استاندارد قدیمی‌تر C++ کامپایل می‌شود، هشدار نمی‌دهد. حتی بدون این گزینه، برخی از ساختارهای C++26
تنها در صورتی تشخیص داده می‌شوند که از \fB\-Wpedantic\fR استفاده شود.
.IP \fB\-Wcast\-qual\fR 4
.IX Item "-Wcast-qual"
هر زمان که یک اشاره‌گر طوری تبدیل نوع (cast) شود که یک توصیف‌کننده نوع را از
نوع مقصد حذف کند، هشدار می‌دهد. به عنوان مثال، اگر یک \f(CW\*(C`const char *\*(C'\fR به
یک \f(CW\*(C`char *\*(C'\fR معمولی تبدیل نوع شود، هشدار می‌دهد.
.Sp
همچنین هنگام انجام تبدیلی که یک توصیف‌کننده نوع را به روشی
ناامن وارد می‌کند، هشدار می‌دهد. به عنوان مثال، تبدیل نوع \f(CW\*(C`char **\*(C'\fR به \f(CW\*(C`const char **\*(C'\fR
ناامن است، همانند این مثال:
.Sp
.Vb 6
\&          /* p is char ** value.  */
\&          const char **q = (const char **) p;
\&          /* Assignment of readonly string to const char * is OK.  */
\&          *q = "string";
\&          /* Now char** pointer points to read\-only memory.  */
\&          **p = \*(Aqb\*(Aq;
.Ve
.IP \fB\-Wcast\-align\fR 4
.IX Item "-Wcast-align"
هر زمان که یک اشاره‌گر طوری تبدیل نوع شود که هم‌ترازی (alignment) مورد نیاز
مقصد افزایش یابد، هشدار می‌دهد. برای نمونه، اگر یک \f(CW\*(C`char *\*(C'\fR به
یک \f(CW\*(C`int *\*(C'\fR در ماشین‌هایی که اعداد صحیح در آن‌ها فقط در مرزهای دو یا چهار بایتی قابل دسترسی هستند تبدیل نوع شود، هشدار می‌دهد.
.Sp
هر زمان که یک اشاره‌گر طوری تبدیل نوع شود که هم‌ترازی مورد نیاز
مقصد افزایش یابد، هشدار می‌دهد. برای نمونه، اگر یک \f(CW\*(C`char *\*(C'\fR صرف‌نظر
از ماشین مقصد به یک \f(CW\*(C`int *\*(C'\fR تبدیل نوع شود، هشدار می‌دهد.
.IP \fB\-Wcast\-function\-type\fR 4
.IX Item "-Wcast-function-type"
هنگامی که یک اشاره‌گر تابع به یک اشاره‌گر تابع ناسازگار تبدیل نوع شود، هشدار می‌دهد.
در تبدیل نوعی که شامل انواع تابع با فهرست متغیر آرگومان‌ها باشد، فقط
انواع آرگومان‌های اولیه‌ای که مشخص شده‌اند در نظر گرفته می‌شوند.
هر پارامتری از نوع اشاره‌گر با هر نوع اشاره‌گر دیگری مطابقت دارد. هرگونه تفاوت
بی‌ضرر در انواع صحیح نادیده گرفته می‌شود، مانند \f(CW\*(C`int\*(C'\fR در برابر \f(CW\*(C`long\*(C'\fR
در مقصدهای ILP32. به همین ترتیب توصیف‌کننده‌های نوع نادیده گرفته می‌شوند. نوع
تابع \f(CW\*(C`void (*) (void)\*(C'\fR ویژه است و با همه چیز مطابقت دارد که می‌توان
از آن برای فرونشاندن این هشدار استفاده کرد.
در تبدیل نوعی که شامل اشاره‌گر به انواع عضو باشد، این هشدار هر زمان که
تبدیل نوع باعث تغییر اشاره‌گر به نوع عضو شود هشدار می‌دهد.
این هشدار توسط \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wcast\-user\-defined\fR 4
.IX Item "-Wcast-user-defined"
هنگامی که یک تبدیل نوع به نوع ارجاعی (reference type) شامل تبدیل تعریف‌شده توسط کاربر
که برنامه‌نویس ممکن است انتظار فراخوانی آن را داشته باشد نباشد، هشدار می‌دهد.
.Sp
.Vb 2
\&        struct A { operator const int&(); } a;
\&        auto r = (int&)a; // warning
.Ve
.Sp
این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-Wwrite\-strings\fR 4
.IX Item "-Wwrite-strings"
هنگام کامپایل C، به ثوابت رشته‌ای نوع \f(CW\*(C`const
char[\fR\f(CIlength\fR\f(CW]\*(C'\fR را اختصاص می‌دهد تا کپی کردن نشانی یکی از آن‌ها در یک اشاره‌گر
غیر\-\f(CW\*(C`const\*(C'\fR از نوع \f(CW\*(C`char *\*(C'\fR هشداری تولید کند. این
هشدارها به شما کمک می‌کنند در زمان کامپایل کدی را پیدا کنید که می‌تواند سعی در نوشتن
روی یک ثابت رشته‌ای داشته باشد، اما این تنها زمانی است که در استفاده
از \f(CW\*(C`const\*(C'\fR در اعلان‌ها و پیش‌نمونه‌ها (prototypes) بسیار دقت کرده باشید. در غیر این صورت،
صرفاً ایجاد مزاحمت می‌کند. به همین دلیل است که ما \fB\-Wall\fR را ملزم به درخواست
این هشدارها نکرده‌ایم.
.Sp
هنگام کامپایل C++، درباره تبدیل منسوخ از لفظ‌های رشته‌ای (string
literals) به \f(CW\*(C`char *\*(C'\fR هشدار می‌دهد. این هشدار به‌طور پیش‌فرض برای برنامه‌های
C++ فعال است.
.Sp
این هشدار در حالت C++11 یا بالاتر توسط \fB\-pedantic\-errors\fR
به یک خطا ارتقا می‌یابد.
.IP \fB\-Wclobbered\fR 4
.IX Item "-Wclobbered"
درباره متغیرهایی که ممکن است توسط \f(CW\*(C`longjmp\*(C'\fR یا
\&\f(CW\*(C`vfork\*(C'\fR تغییر کنند هشدار می‌دهد. این هشدار همچنین توسط \fB\-Wextra\fR فعال می‌شود.
.IP \fB\-Wno\-complain\-wrong\-lang\fR 4
.IX Item "-Wno-complain-wrong-lang"
به‌طور پیش‌فرض، فرانت‌اندهای زبان زمانی که یک گزینه خط فرمان معتبر باشد
اما برای آن فرانت‌اند قابل اعمال نباشد، پیام اخطار می‌دهند.
این رفتار را می‌توان با \fB\-Wno\-complain\-wrong\-lang\fR غیرفعال کرد
که بیشتر هنگام فراخوانی یک درایور کامپایلر واحد برای
چندین فایل منبع نوشته‌شده به زبان‌های مختلف سودمند است، برای مثال:
.Sp
.Vb 1
\&        $ g++ \-fno\-rtti a.cc b.f90
.Ve
.Sp
درایور \fIg++\fR فرانت‌اند C++ را برای کامپایل \fIa.cc\fR
و فرانت‌اند Fortran را برای کامپایل \fIb.f90\fR فراخوانی می‌کند.
فرانت‌اند دوم اخطار زیر را صادر می‌کند:
\&\fBf951: Warning: command\-line option \*(Aq\-fno\-rtti\*(Aq is valid for C++/D/ObjC++ but not for Fortran\fR،
که می‌توان آن را با \fB\-Wno\-complain\-wrong\-lang\fR غیرفعال کرد.
.Sp
این گزینه همچنین می‌تواند برای غیرفعال کردن هشدارهایی نظیر:
\&\fBcc1plus: note: CTF debug info requested, but not supported for \*(AqGNU C++20\*(Aq frontend\fR
که توسط \fB\-gctf\fR یا \fB\-gsctf\fR برای زبان‌های پشتیبانی‌نشده تولید می‌شوند، استفاده شود..IP "\fB\-Wcompare\-distinct\-pointer\-types\fR (فقط C و Objective\-C)" 4
.IX Item "-Wcompare-distinct-pointer-types (C and Objective-C only)"
در صورتی که اشاره‌گرهایی از انواع متمایز بدون تبدیل نوع صریح (cast) مقایسه شوند، هشدار می‌دهد. این
هشدار به طور پیش‌فرض فعال است.
.IP \fB\-Wconversion\fR 4
.IX Item "-Wconversion"
درباره تبدیل‌های ضمنی (implicit conversions) که ممکن است مقدار را تغییر دهند، هشدار می‌دهد. این شامل
تبدیل‌های بین حقیقی و عدد صحیح است، مانند \f(CW\*(C`abs (x)\*(C'\fR هنگامی که
\&\f(CW\*(C`x\*(C'\fR از نوع \f(CW\*(C`double\*(C'\fR باشد؛ تبدیل‌های بین علامت‌دار و بدون علامت،
مانند \f(CW\*(C`unsigned ui = \-1\*(C'\fR؛ و تبدیل‌ها به انواع کوچک‌تر، مانند
\&\f(CW\*(C`sqrtf (M_PI)\*(C'\fR. برای تبدیل‌های صریح مانند \f(CW\*(C`abs
((int) x)\*(C'\fR و \f(CW\*(C`ui = (unsigned) \-1\*(C'\fR، یا اگر مقدار توسط
تبدیل تغییر نکند مانند \f(CW\*(C`abs (2.0)\*(C'\fR، هشداری صادر نمی‌شود. هشدارهای مربوط به
تبدیل‌های بین اعداد صحیح علامت‌دار و بدون علامت را می‌توان با
استفاده از \fB\-Wno\-sign\-conversion\fR غیرفعال کرد.
.Sp
برای C++، همچنین درباره تفکیک بارگذاری بیش از حد (overload resolution) گمراه‌کننده برای تبدیل‌های
تعریف‌شده توسط کاربر؛ و تبدیل‌هایی که هرگز از یک عملگر تبدیل نوع استفاده نمی‌کنند هشدار می‌دهد: تبدیل‌ها به \f(CW\*(C`void\*(C'\fR، همان نوع، یک کلاس پایه یا یک
ارجاع به آن‌ها. هشدارهای مربوط به تبدیل‌های میان اعداد صحیح علامت‌دار و
بدون علامت در C++ به طور پیش‌فرض غیرفعال هستند، مگر اینکه
\&\fB\-Wsign\-conversion\fR به صراحت فعال شده باشد.
.Sp
هشدارهای مربوط به تبدیل از عملیات حسابی روی یک نوع کوچک به همان
نوع، تنها با \fB\-Warith\-conversion\fR ارائه می‌شوند.
.IP \fB\-Wdangling\-else\fR 4
.IX Item "-Wdangling-else"
درباره ساختارهایی که ممکن است در آنها ابهام وجود داشته باشد که یک شاخه
\&\f(CW\*(C`else\*(C'\fR به کدام دستور \f(CW\*(C`if\*(C'\fR تعلق دارد، هشدار می‌دهد. در اینجا مثالی از
چنین موردی آمده است:
.Sp
.Vb 7
\&        {
\&          if (a)
\&            if (b)
\&              foo ();
\&          else
\&            bar ();
\&        }
.Ve
.Sp
در C/C++، هر شاخه \f(CW\*(C`else\*(C'\fR به درونی‌ترین دستور ممکن
\&\f(CW\*(C`if\*(C'\fR تعلق دارد، که در این مثال \f(CW\*(C`if (b)\*(C'\fR است. این
اغلب آن چیزی نیست که برنامه‌نویس انتظار داشته، همان‌طور که در مثال
بالا با تورفتگی انتخابی برنامه‌نویس نشان داده شده است. هنگامی که پتانسیل
این سردرگمی وجود داشته باشد، در صورت مشخص بودن این پرچم، GCC هشدار صادر می‌کند.
برای برطرف کردن هشدار، آکولادهای صریح در اطراف درونی‌ترین دستور \f(CW\*(C`if\*(C'\fR
اضافه کنید تا هیچ راهی وجود نداشته باشد که \f(CW\*(C`else\*(C'\fR بتواند به \f(CW\*(C`if\*(C'\fR
دربرگیرنده تعلق گیرد. کد حاصل بدین صورت
خواهد بود:
.Sp
.Vb 9
\&        {
\&          if (a)
\&            {
\&              if (b)
\&                foo ();
\&              else
\&                bar ();
\&            }
\&        }
.Ve
.Sp
این هشدار توسط \fB\-Wparentheses\fR فعال می‌شود.
.IP \fB\-Wdangling\-pointer\fR 4
.IX Item "-Wdangling-pointer"
.PD 0
.IP \fB\-Wdangling\-pointer=\fR\fIn\fR 4
.IX Item "-Wdangling-pointer=n"
.PD
درباره استفاده از اشاره‌گرها (یا ارجاع‌های C++) به اشیایی با مدت زمان
ذخیره‌سازی خودکار (automatic storage duration) پس از پایان طول عمر آن‌ها هشدار می‌دهد. این شامل
متغیرهای محلی اعلان‌شده در بلوک‌های تودرتو، لیترال‌های ترکیبی (compound literals) و سایر اشیاء موقت
بدون نام می‌شود. علاوه بر این، درباره ذخیره آدرس چنین اشیایی در اشاره‌گرهای نشت‌کرده (escaped pointers) هشدار می‌دهد. این هشدار در تمام سطوح بهینه‌سازی
فعال است، اما ممکن است با بهینه‌سازی نتایج متفاوتی نسبت به حالت بدون بهینه‌سازی تولید کند.
.RS 4
.IP \fB\-Wdangling\-pointer=1\fR 4
.IX Item "-Wdangling-pointer=1"
در سطح ۱، این هشدار تنها استفاده‌های بدون شرط از اشاره‌گرهای معلق (dangling pointers) را تشخیص می‌دهد.
.IP \fB\-Wdangling\-pointer=2\fR 4
.IX Item "-Wdangling-pointer=2"
در سطح ۲، این هشدار علاوه بر استفاده‌های بدون شرط، استفاده‌های
مشروط از اشاره‌گرهای معلق را نیز تشخیص می‌دهد.
.RE
.RS 4
.Sp
فرم کوتاه \fB\-Wdangling\-pointer\fR معادل
\&\fB\-Wdangling\-pointer=2\fR است، در حالی که گزینه‌های \fB\-Wno\-dangling\-pointer\fR و
\&\fB\-Wdangling\-pointer=0\fR تأثیر یکسانی در غیرفعال کردن هشدارها دارند.
\&\fB\-Wdangling\-pointer=2\fR در \fB\-Wall\fR گنجانده شده است.
.Sp
این مثال هشدار را در سطح ۱ فعال می‌کند؛ آدرس شیء موقت
بدون نام به طور بدون شرط در خارج از حوزه دید (scope) آن مورد ارجاع قرار گرفته است.
.Sp
.Vb 9
\&        char f (char c1, char c2, char c3)
\&        {
\&          char *p;
\&          {
\&            p = (char[]) { c1, c2, c3 };
\&          }
\&          // warning: using dangling pointer \*(Aqp\*(Aq to an unnamed temporary
\&          return *p;
\&        }
.Ve
.Sp
در تابع زیر، ذخیره آدرس متغیر محلی
\&\f(CW\*(C`x\*(C'\fR در اشاره‌گر فرارکرده \f(CW*p\fR هشدار را در
سطح ۱ فعال می‌کند.
.Sp
.Vb 6
\&        void g (int **p)
\&        {
\&          int x = 7;
\&          // warning: storing the address of local variable \*(Aqx\*(Aq in \*(Aq*p\*(Aq
\&          *p = &x;
\&        }
.Ve
.Sp
در این مثال، هنگام استفاده از اشاره‌گر \fIs\fR، آرایه \fIa\fR خارج از
حوزه دید قرار دارد. از آنجا که کدی که \f(CW\*(C`s\*(C'\fR را مقداردهی می‌کند
شرطی است، هشدار در سطح ۲ فعال می‌شود.
.Sp
.Vb 11
\&        extern void frob (const char *);
\&        void h (char *s)
\&        {
\&          if (!s)
\&            {
\&              char a[12] = "tmpname";
\&              s = a;
\&            }
\&          // warning: dangling pointer \*(Aqs\*(Aq to \*(Aqa\*(Aq may be used
\&          frob (s);
\&        }
.Ve
.RE
.IP \fB\-Wdate\-time\fR 4
.IX Item "-Wdate-time"
هنگامی که ماکروهای \f(CW\*(C`_\|_TIME_\|_\*(C'\fR، \f(CW\*(C`_\|_DATE_\|_\*(C'\fR یا \f(CW\*(C`_\|_TIMESTAMP_\|_\*(C'\fR
مشاهده شوند هشدار می‌دهد، چرا که ممکن است مانع کامپایل‌های بازتولیدپذیر با
تطابق بیت‌به‌بیت شوند.
.IP \fB\-Wempty\-body\fR 4
.IX Item "-Wempty-body"
اگر بدنه خالی در یک دستور \f(CW\*(C`if\*(C'\fR، \f(CW\*(C`else\*(C'\fR یا \f(CW\*(C`do
while\*(C'\fR وجود داشته باشد، هشدار می‌دهد. این هشدار توسط \fB\-Wextra\fR نیز فعال می‌شود.
.IP \fB\-Wno\-endif\-labels\fR 4
.IX Item "-Wno-endif-labels"
درباره نشانه‌های سرگردان پس از \f(CW\*(C`#else\*(C'\fR و \f(CW\*(C`#endif\*(C'\fR هشدار نمی‌دهد.
.IP \fB\-Wenum\-compare\fR 4
.IX Item "-Wenum-compare"
درباره مقایسه بین مقادیر از انواع شمارشی (enumerated types) متفاوت هشدار می‌دهد.
در C++، عدم تطابق انواع شمارشی در عبارات شرطی نیز
تشخیص داده می‌شود و هشدار به طور پیش‌فرض فعال است. در C این هشدار
توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wenum\-conversion\fR 4
.IX Item "-Wenum-conversion"
هنگامی که مقداری از نوع شمارشی به طور ضمنی به یک نوع
شمارشی متفاوت تبدیل شود، هشدار می‌دهد. این هشدار توسط \fB\-Wextra\fR
در C فعال می‌شود.
.IP "\fB\-Wenum\-int\-mismatch\fR (فقط C و Objective\-C)" 4
.IX Item "-Wenum-int-mismatch (C and Objective-C only)"
درباره عدم تطابق بین یک نوع شمارشی و یک نوع عدد صحیح در
اعلان‌ها هشدار می‌دهد. برای نمونه:
.Sp
.Vb 3
\&        enum E { l = \-1, z = 0, g = 1 };
\&        int foo(void);
\&        enum E foo(void);
.Ve
.Sp
در C، یک نوع شمارشی با \f(CW\*(C`char\*(C'\fR، یک نوع عدد صحیح
علامت‌دار، یا یک نوع عدد صحیح بدون علامت سازگار است. با این حال، از آنجا که انتخاب
نوع زیربنایی (underlying type) یک نوع شمارشی وابسته به پیاده‌سازی (implementation-defined) است،
چنین عدم تطابق‌هایی ممکن است باعث مشکلات قابلیت حمل شود. در C++، چنین عدم تطابق‌هایی
یک خطا محسوب می‌شوند. در C، این هشدار توسط \fB\-Wall\fR و
\&\fB\-Wc++\-compat\fR فعال می‌شود.
.IP "\fB\-Wjump\-misses\-init\fR (فقط C و Objective\-C)" 4
.IX Item "-Wjump-misses-init (C, Objective-C only)"
اگر یک دستور \f(CW\*(C`goto\*(C'\fR یا یک دستور \f(CW\*(C`switch\*(C'\fR
به جلو و از روی مقداردهی اولیه یک متغیر جهش کند، یا به عقب و به سمتی از یک
برچسب پس از مقداردهی اولیه متغیر جهش نماید، هشدار می‌دهد. این هشدار تنها درباره
متغیرهایی صادر می‌شود که هنگام اعلانشان مقداردهی اولیه شده باشند. این هشدار
فقط برای C و Objective\-C پشتیبانی می‌شود؛ در C++ این نوع انشعاب در هر
صورت یک خطا است.
.Sp
\&\fB\-Wjump\-misses\-init\fR در \fB\-Wc++\-compat\fR گنجانده شده است. این
هشدار را می‌توان با گزینه \fB\-Wno\-jump\-misses\-init\fR غیرفعال کرد..IP \fB\-Wsign\-compare\fR 4
.IX Item "-Wsign-compare"
هنگامی که مقایسه میان مقادیر علامت‌دار و بدون علامت، در صورت تبدیل مقدار علامت‌دار به بدون علامت، ممکن است نتیجه نادرستی ایجاد کند، هشدار می‌دهد. در C++ این هشدار با \fB\-Wall\fR نیز فعال می‌شود. در C این هشدار با \fB\-Wextra\fR نیز فعال می‌شود.
.IP \fB\-Wsign\-conversion\fR 4
.IX Item "-Wsign-conversion"
برای تبدیل‌های ضمنی که ممکن است علامت یک مقدار عدد صحیح را تغییر دهند (مانند انتساب یک عبارت صحیح علامت‌دار به یک متغیر صحیح بدون علامت) هشدار می‌دهد. یک تبدیل نوع صریح (cast) این هشدار را بی‌اثر می‌کند. در C این گزینه با \fB\-Wconversion\fR نیز فعال می‌شود.
.IP "\fB\-Wflex\-array\-member\-not\-at\-end\fR (تنها در C و C++)" 4
.IX Item "-Wflex-array-member-not-at-end (C and C++ only)"
هنگامی که یک ساختار حاوی یک عضو آرایه انعطاف‌پذیر C99 به عنوان آخرین فیلد، در انتهای ساختار دیگری قرار نگرفته باشد، هشدار می‌دهد.
این هشدار به عنوان مثال در مورد زیر هشدار می‌دهد:
.Sp
.Vb 2
\&        struct flex  { int length; char data[]; };
\&        struct mid_flex { int m; struct flex flex_data; int n; };
.Ve
.IP \fB\-Wfloat\-conversion\fR 4
.IX Item "-Wfloat-conversion"
برای تبدیل‌های ضمنی که دقت یک مقدار حقیقی را کاهش می‌دهند هشدار می‌دهد. این شامل تبدیل از حقیقی به عدد صحیح، و از مقادیر حقیقی با دقت بالاتر به مقادیر حقیقی با دقت پایین‌تر است. این گزینه همچنین توسط \&\fB\-Wconversion\fR فعال می‌شود.
.IP \fB\-Wno\-scalar\-storage\-order\fR 4
.IX Item "-Wno-scalar-storage-order"
در مورد ساختارهای مشکوک مربوط به ترتیب ذخیره‌سازی معکوس اسکالر (reverse scalar storage order) هشدار نده.
.IP \fB\-Wsizeof\-array\-div\fR 4
.IX Item "-Wsizeof-array-div"
در مورد تقسیم دو عملگر sizeof هنگامی که اولی روی یک آرایه اعمال شده و مقسوم‌علیه با اندازه عنصر آرایه برابر نیست، هشدار می‌دهد. در چنین حالتی، محاسبه تعداد عناصر آرایه را که احتمالاً هدف کاربر بوده است، به دست نخواهد داد. این هشدار به عنوان مثال در مورد زیر هشدار می‌دهد:
.Sp
.Vb 5
\&        int fn ()
\&        {
\&          int arr[10];
\&          return sizeof (arr) / sizeof (short);
\&        }
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wsizeof\-pointer\-div\fR 4
.IX Item "-Wsizeof-pointer-div"
در مورد تقسیم‌های مشکوک دو عبارت sizeof که اندازه اشاره‌گر را بر اندازه عنصر تقسیم می‌کنند، هشدار می‌دهد؛ این روش معمول برای محاسبه اندازه آرایه است اما با اشاره‌گرها به درستی کار نخواهد کرد. این هشدار برای نمونه در مورد \f(CW\*(C`sizeof (ptr) / sizeof (ptr[0])\*(C'\fR چنانچه \f(CW\*(C`ptr\*(C'\fR یک اشاره‌گر باشد و نه آرایه، هشدار می‌دهد. این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wsizeof\-pointer\-memaccess\fR 4
.IX Item "-Wsizeof-pointer-memaccess"
در مورد پارامترهای طول مشکوک در توابع توکار (built-in) مشخص رشته و حافظه، در صورتی که آرگومان از \f(CW\*(C`sizeof\*(C'\fR استفاده کند، هشدار می‌دهد. این هشدار برای نمونه برای \f(CW\*(C`memset (ptr, 0, sizeof (ptr));\*(C'\fR در صورتی که \f(CW\*(C`ptr\*(C'\fR یک اشاره‌گر باشد و نه آرایه فعال می‌شود و یک اصلاح احتمالی را پیشنهاد می‌کند، یا در مورد \&\f(CW\*(C`memcpy (&foo, ptr, sizeof (&foo));\*(C'\fR. گزینه \fB\-Wsizeof\-pointer\-memaccess\fR همچنین در مورد فراخوانی توابع کپی محدود رشته مانند \f(CW\*(C`strncat\*(C'\fR یا \f(CW\*(C`strncpy\*(C'\fR که عبارت \f(CW\*(C`sizeof\*(C'\fR آرایه مبدأ را به عنوان حد مشخص می‌کنند، هشدار می‌دهد. به عنوان مثال، در تابع زیر فراخوانی \&\f(CW\*(C`strncat\*(C'\fR اندازه رشته مبدأ را به عنوان کران تعیین می‌کند. این کار تقریباً بدون شک یک اشتباه است و در نتیجه فراخوانی خطاگیری می‌شود.
.Sp
.Vb 7
\&        void make_file (const char *name)
\&        {
\&          char path[PATH_MAX];
\&          strncpy (path, name, sizeof path \- 1);
\&          strncat (path, ".text", sizeof ".text");
\&          ...
\&        }
.Ve
.Sp
گزینه \fB\-Wsizeof\-pointer\-memaccess\fR با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wno\-sizeof\-array\-argument\fR 4
.IX Item "-Wno-sizeof-array-argument"
هنگامی که عملگر \f(CW\*(C`sizeof\*(C'\fR روی پارامتری اعمال می‌شود که در تعریف تابع به عنوان یک آرایه اعلان شده است، هشدار نده. این هشدار به طور پیش‌فرض برای برنامه‌های C و C++ فعال است.
.IP \fB\-Wmemset\-elt\-size\fR 4
.IX Item "-Wmemset-elt-size"
در مورد فراخوانی‌های مشکوک به تابع توکار \f(CW\*(C`memset\*(C'\fR هشدار می‌دهد، چنانچه آرگومان نخست به یک آرایه ارجاع دهد، و آرگومان سوم عددی برابر با تعداد عناصر باشد اما با اندازه آرایه در حافظه برابر نباشد. این نشان می‌دهد که کاربر ضرب در اندازه عنصر را جا انداخته است. این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wmemset\-transposed\-args\fR 4
.IX Item "-Wmemset-transposed-args"
در مورد فراخوانی‌های مشکوک به تابع توکار \f(CW\*(C`memset\*(C'\fR که در آن‌ها آرگومان دوم صفر نیست و آرگومان سوم صفر است هشدار می‌دهد. به عنوان مثال، فراخوانی \f(CW\*(C`memset (buf, sizeof buf, 0)\*(C'\fR مورد هشدار قرار می‌گیرد زیرا در عوض \&\f(CW\*(C`memset (buf, 0, sizeof buf)\*(C'\fR مد نظر بوده است. این اعلان تنها در صورتی صادر می‌شود که آرگومان سوم یک لیترال صفر باشد. در غیر این صورت، اگر عبارتی باشد که به صفر خلاصه (fold) شده، یا تبدیل نوع صفر به نوعی دیگر باشد، احتمال این که آرگومان‌ها به اشتباه جابه‌جا شده باشند بسیار کمتر است و هشداری صادر نمی‌شود. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Waddress\fR 4
.IX Item "-Waddress"
در مورد استفاده‌های مشکوک از عبارت‌های آدرس هشدار می‌دهد. این موارد شامل مقایسه آدرس یک تابع یا یک شیء اعلان‌شده با ثابت اشاره‌گر تهی (null pointer constant) است، مانند:
.Sp
.Vb 6
\&        void f (void);
\&        void g (void)
\&        {
\&          if (!f)   // warning: expression evaluates to false
\&            abort ();
\&        }
.Ve
.Sp
مقایسه یک اشاره‌گر با یک رشته‌واژه (string literal)، مانند:
.Sp
.Vb 5
\&        void f (const char *x)
\&        {
\&          if (x == "abc")   // warning: expression evaluates to false
\&            puts ("equal");
\&        }
.Ve
.Sp
و بررسی برابری نتیجه جمع یا تفریق اشاره‌گر با null، مانند:
.Sp
.Vb 4
\&        void f (const int *p, int i)
\&        {
\&          return p + i == NULL;
\&        }
.Ve
.Sp
چنین استفاده‌هایی معمولاً بیانگر خطای برنامه‌نویس است: آدرس بیشتر توابع و اشیاء لزوماً برابر با true ارزیابی می‌شود (استثنا نمادهای ضعیف یا weak symbols هستند)، بنابراین استفاده از آن‌ها در یک عبارت شرطی ممکن است نشان‌دهنده جا افتادن پرانتزها در فراخوانی تابع یا عدم ارجاع‌زدایی (dereference) در یک عبارت آرایه باشد. زیرمجموعه این هشدار برای اشاره‌گرهای شیء را می‌توان با تبدیل نوع عملوند اشاره‌گر به یک نوع عدد صحیح مانند \f(CW\*(C`intptr_t\*(C'\fR یا \f(CW\*(C`uintptr_t\*(C'\fR نادیده گرفت. مقایسه در برابر رشته‌واژه‌ها به رفتار نامشخص (unspecified behavior) منجر می‌شود و قابل‌حمل نیست، و نشان می‌دهد که احتمالاً قصد فراخوانی \f(CW\*(C`strcmp\*(C'\fR بوده است. اگر عبارت مشکوک نتیجه بسط یک ماکرو باشد، این هشدار صادر نمی‌شود. هشدار \&\fB\-Waddress\fR با \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wno\-address\-of\-packed\-member\fR 4
.IX Item "-Wno-address-of-packed-member"
هنگامی که آدرس عضوی با بسته‌بندی فشرده (packed) از یک struct یا union گرفته می‌شود (که معمولاً منجر به یک مقدار اشاره‌گر ترازنشده می‌شود)، هشدار نده. این گزینه به طور پیش‌فرض فعال است.
.IP \fB\-Wlogical\-op\fR 4
.IX Item "-Wlogical-op"
در مورد استفاده‌های مشکوک از عملگرهای منطقی در عبارت‌ها هشدار می‌دهد. این شامل استفاده از عملگرهای منطقی در بافت‌هایی است که احتمالاً انتظار یک عملگر بیتی می‌رود. همچنین زمانی که عملوندهای یک عملگر منطقی یکسان باشند هشدار می‌دهد:
.Sp
.Vb 2
\&        extern int a;
\&        if (a < 0 && a < 0) { ... }
.Ve
.IP \fB\-Wlogical\-not\-parentheses\fR 4
.IX Item "-Wlogical-not-parentheses"
در مورد استفاده از نقیض منطقی (logical not) در عملوند سمت چپ یک مقایسه هشدار می‌دهد. اگر عملوند سمت راست یک عبارت بولی در نظر گرفته شود، این گزینه هشدار نمی‌دهد. هدف آن شناسایی کدهای مشکوکی مانند زیر است:
.Sp
.Vb 3
\&        int a;
\&        ...
\&        if (!a > 1) { ... }
.Ve
.Sp
می‌توان با قرار دادن عملوند سمت چپ درون پرانتز، این هشدار را برطرف کرد:
.Sp
.Vb 1
\&        if ((!a) > 1) { ... }
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود..IP \fB\-Waggregate\-return\fR 4
.IX Item "-Waggregate-return"
اگر توابعی که ساختارها (structures) یا اجتماع‌ها (unions) را بازمی‌گردانند تعریف یا فراخوانی شوند، هشدار می‌دهد. (در زبان‌هایی که امکان بازگرداندن آرایه وجود دارد، این مورد نیز موجب ایجاد هشدار می‌شود.)
.IP \fB\-Wno\-aggressive\-loop\-optimizations\fR 4
.IX Item "-Wno-aggressive-loop-optimizations"
اگر کامپایلر رفتار تعریف‌نشده‌ای (undefined behavior) در حلقه‌ای با تعداد تکرار ثابت شناسایی کند، هشدار نمی‌دهد. گزینهٔ \fB\-Waggressive\-loop\-optimizations\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-Wno\-attributes\fR 4
.IX Item "-Wno-attributes"
اگر یک \f(CW\*(C`_\|_attribute_\|_\*(C'\fR غیرمنتظره استفاده شود، مانند صفت‌های (attributes) ناشناخته، صفت‌های تابع اعمال‌شده روی متغیرها و غیره، هشدار نمی‌دهد. این گزینه مانع از ایجاد خطا برای استفادهٔ نادرست از صفت‌های پشتیبانی‌شده نمی‌شود.
.Sp
هشدارهای مربوط به استفاده‌های ناصحیح (ill\-formed) از صفت‌های استاندارد، با \fB\-pedantic\-errors\fR به خطا تبدیل می‌شوند.
.Sp
علاوه بر این، با استفاده از \fB\-Wno\-attributes=\fR، فرونشاندن هشدارهای مربوط به صفت‌های دارای حوزه (scoped attributes) ناشناخته (در C++11 و C23) امکان‌پذیر است. برای نمونه، \&\fB\-Wno\-attributes=vendor::attr\fR هشدار دربارهٔ اعلان زیر را غیرفعال می‌کند:
.Sp
.Vb 1
\&        [[vendor::attr]] void f();
.Ve
.Sp
همچنین می‌توان با استفاده از \fB\-Wno\-attributes=vendor::\fR، هشدار دربارهٔ تمام صفت‌های موجود در یک فضای‌نام (namespace) را غیرفعال کرد که از هشدار برای هر دوی این اعلان‌ها جلوگیری می‌کند:
.Sp
.Vb 2
\&        [[vendor::safe]] void f();
\&        [[vendor::unsafe]] void f2();
.Ve
.Sp
توجه داشته باشید که \fB\-Wno\-attributes=\fR به معنای فعال شدن \fB\-Wno\-attributes\fR نیست.
.IP \fB\-Wno\-builtin\-declaration\-mismatch\fR 4
.IX Item "-Wno-builtin-declaration-mismatch"
اگر یک تابع توکار (built\-in) با امضایی ناسازگار یا به عنوان یک غیر-تابع اعلان شود، یا هنگامی که یک تابع توکار اعلان‌شده با نوعی فاقد پیش‌نمونه (prototype)، با آرگومان‌هایی فراخوانی گردد که نوع‌های ارتقایافتهٔ آن‌ها با نوع‌های مورد انتظار تابع مطابقت ندارد، هشدار می‌دهد. زمانی که \fB\-Wextra\fR مشخص شده باشد، اگر یک تابع توکار آرگومان‌پذیر بدون پیش‌نمونه اعلان شود نیز هشدار می‌دهد. هشدار \fB\-Wbuiltin\-declaration\-mismatch\fR به‌طور پیش‌فرض فعال است. برای جلوگیری از این هشدار، سرایند مناسب را بگنجانید تا پیش‌نمونه‌های توابع توکار وارد حوزه شوند.
.Sp
برای نمونه، فراخوانی \f(CW\*(C`memset\*(C'\fR در زیر توسط این هشدار شناسایی می‌شود زیرا تابع انتظار مقداری از نوع \f(CW\*(C`size_t\*(C'\fR را به عنوان آرگومان خود دارد، اما نوع \f(CW32\fR برابر با \f(CW\*(C`int\*(C'\fR است. با \fB\-Wextra\fR، اعلان تابع نیز خطاگیری می‌شود.
.Sp
.Vb 5
\&        extern void* memset ();
\&        void f (void *d)
\&        {
\&          memset (d, \*(Aq\e0\*(Aq, 32);
\&        }
.Ve
.IP \fB\-Wno\-builtin\-macro\-redefined\fR 4
.IX Item "-Wno-builtin-macro-redefined"
اگر ماکروهای توکار (built\-in) خاصی بازتعریف شوند، هشدار نمی‌دهد. این گزینه هشدارهای مربوط به بازتعریف \f(CW\*(C`_\|_TIMESTAMP_\|_\*(C'\fR، \f(CW\*(C`_\|_TIME_\|_\*(C'\fR، \&\f(CW\*(C`_\|_DATE_\|_\*(C'\fR، \f(CW\*(C`_\|_FILE_\|_\*(C'\fR و \f(CW\*(C`_\|_BASE_FILE_\|_\*(C'\fR را فرومی‌نشاند.
.IP \fB\-Wkeyword\-macro\fR 4
.IX Item "-Wkeyword-macro"
اگر یک کلمهٔ کلیدی به عنوان یک ماکرو تعریف یا لغو تعریف (undefine) شود، هشدار می‌دهد. برای C++، شناسه‌های دارای معنای خاص یا شناسه‌های صفت‌های استاندارد نیز بررسی می‌شوند. در صورت فعال بودن \f(CW\*(C`\-Wpedantic\*(C'\fR، این هشدار به‌طور پیش‌فرض برای C++26 فعال است و در آن حالت یک pedwarn صادر می‌کند.
.IP "\fB\-Wfree\-labels\fR (فقط C و Objective\-C)" 4
.IX Item "-Wfree-labels (C and Objective-C only)"
اگر یک برچسب (label) روی یک غیر-دستور (non\-statement) اعمال شود، یا در پایان یک دستور مرکب (compound statement) قرار گیرد، هشدار می‌دهد. چنین برچسب‌هایی توسط C23 و گویش‌های بعدی C مجاز هستند و در تمام گویش‌های دیگر به عنوان یک افزونهٔ GCC در دسترس قرار دارند.
.Sp
این هشدار با \fB\-Wc11\-c23\-compat\fR نیز فعال می‌شود. در صورت ساخت برای نسخه‌ای از C قبل از C23، توسط \&\fB\-pedantic\-errors\fR به یک خطا تبدیل می‌شود.
.IP \fB\-Wheader\-guard\fR 4
.IX Item "-Wheader-guard"
اگر یک محافظ گنجاندن چندبارهٔ معتبر سرایند در پیش‌پردازنده (multiple inclusion guard)، بلافاصله پس از دستور \f(CW\*(C`#ifndef\*(C'\fR یا \f(CW\*(C`#if !defined\*(C'\fR مربوط به محافظ گنجاندن چندباره، دارای یک دستور \f(CW\*(C`#define\*(C'\fR باشد که ماکرویی متفاوت از ماکروی محافظ با نامی مشابه را تعریف کند، و ماکروی محافظ واقعی در دستور متناظر با \f(CW\*(C`#ifndef\*(C'\fR در انتهای سرایند تعریف نشده باشد، و دستور \f(CW\*(C`#define\*(C'\fR یک ماکروی شیء‌گونه (object\-like) با تعریفی خالی تعریف کند، هشدار می‌دهد. در چنین مواردی، معمولاً این تنها یک غلط املایی در نام محافظ است، چه در دستور \f(CW\*(C`#ifndef\*(C'\fR یا \f(CW\*(C`#if !defined\*(C'\fR و چه در دستور بعدی \f(CW\*(C`#define\*(C'\fR. این هشدار با \fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wstrict\-prototypes\fR (فقط C و Objective\-C)" 4
.IX Item "-Wstrict-prototypes (C and Objective-C only)"
اگر تابعی بدون تعیین نوع آرگومان‌ها اعلان یا تعریف شود، هشدار می‌دهد. (تعریف تابع به سبک قدیمی در صورتی که پیش از آن اعلانی باشد که نوع آرگومان‌ها را مشخص می‌کند، بدون هشدار مجاز است.)
.IP "\fB\-Wold\-style\-declaration\fR (فقط C و Objective\-C)" 4
.IX Item "-Wold-style-declaration (C and Objective-C only)"
دربارهٔ کاربردهای منسوخ‌شده بر اساس استاندارد C در یک اعلان هشدار می‌دهد. برای نمونه، اگر مشخص‌کننده‌های کلاس ذخیره‌سازی (storage\-class specifiers) مانند \&\f(CW\*(C`static\*(C'\fR اولین بخش در یک اعلان نباشند، هشدار می‌دهد. این هشدار با \fB\-Wextra\fR نیز فعال می‌شود.
.IP "\fB\-Wold\-style\-definition\fR (فقط C و Objective\-C)" 4
.IX Item "-Wold-style-definition (C and Objective-C only)"
اگر از یک تعریف تابع به سبک قدیمی استفاده شود، هشدار می‌دهد. حتی در صورت وجود یک پیش‌نمونهٔ قبلی نیز هشدار صادر می‌شود. تعریفی که از \fB()\fR استفاده می‌کند در حالت C23 به عنوان تعریف سبک قدیمی در نظر گرفته نمی‌شود، زیرا در آن حالت معادل \fB(void)\fR است، اما برای استانداردهای قدیمی‌تر تعریفی به سبک قدیمی به شمار می‌رود.
.IP "\fB\-Wmultiple\-parameter\-fwd\-decl\-lists\fR (فقط C و Objective\-C)" 4
.IX Item "-Wmultiple-parameter-fwd-decl-lists (C and Objective-C only)"
اگر بیش از یک فهرست از اعلان‌های پیشین (forward declarations) پارامترها در یک پیش‌نمونهٔ تابع ظاهر شود، هشدار می‌دهد. این هشدار با \fB\-Wextra\fR نیز فعال می‌شود.
.IP "\fB\-Wdeprecated\-non\-prototype\fR (فقط C و Objective\-C)" 4
.IX Item "-Wdeprecated-non-prototype (C and Objective-C only)"
اگر تابعی که با فهرست پارامتر خالی \fB()\fR اعلان شده است با یک یا چند آرگومان فراخوانی شود، یا اگر پس از چنین اعلانی، تعریفی از تابع با یک یا چند پارامتر مشاهده گردد، هشدار می‌دهد. هر دو مورد در C23 و گویش‌های بعدی C خطا محسوب می‌شوند.
.Sp
این هشدار با \fB\-Wc11\-c23\-compat\fR نیز فعال می‌شود.
.IP "\fB\-Wmissing\-parameter\-name\fR (فقط C و Objective\-C)" 4
.IX Item "-Wmissing-parameter-name (C and Objective-C only)"
اگر یک تعریف تابع، نام پارامتر را حذف کرده و تنها نوع آن را مشخص کند، هشدار می‌دهد. این ویژگی می‌تواند برای مستندسازی استفاده نشدن یک پارامتر در تعریف تابع به کار رود. این بخش جزئی از C23 و گویش‌های بعدی C است، و در تمام گویش‌های دیگر به عنوان افزونهٔ GCC در دسترس قرار دارد.
.Sp
این هشدار با \fB\-Wc11\-c23\-compat\fR نیز فعال می‌شود. در صورت ساخت برای نسخه‌ای از C قبل از C23، توسط \&\fB\-pedantic\-errors\fR به یک خطا تبدیل می‌شود.
.IP "\fB\-Wmissing\-parameter\-type\fR (فقط C و Objective\-C)" 4
.IX Item "-Wmissing-parameter-type (C and Objective-C only)"
در توابع به سبک K&R، اگر پارامتر تابع بدون مشخص‌کنندهٔ نوع اعلان شود، هشدار می‌دهد:
.Sp
.Vb 1
\&        void foo(bar) { }
.Ve
.Sp
این هشدار با \fB\-Wextra\fR نیز فعال می‌شود.
.IP "\fB\-Wno\-declaration\-missing\-parameter\-type\fR (فقط C و Objective\-C)" 4
.IX Item "-Wno-declaration-missing-parameter-type (C and Objective-C only)"
اگر یک اعلان تابع شامل نام پارامتر بدون نوع باشد، هشدار نمی‌دهد. چنین اعلان‌های تابعی پیش‌نمونهٔ تابع را ارائه نمی‌دهند و از بیشتر بررسی‌های نوع در فراخوانی‌های تابع جلوگیری می‌کنند.
.Sp
این هشدار به‌طور پیش‌فرض فعال است. در C99 و گویش‌های بعدی C، این مورد به عنوان خطا در نظر گرفته می‌شود. این خطا را می‌توان با استفاده از \&\fB\-fpermissive\fR (به همراه برخی خطاهای دیگر) یا صرفاً برای همین خطا با \fB\-Wno\-error=declaration\-missing\-parameter\-type\fR به یک هشدار تنزل داد.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP "\fB\-Wmissing\-prototypes\fR (فقط C و Objective\-C)" 4
.IX Item "-Wmissing-prototypes (C and Objective-C only)"
اگر یک تابع سراسری (global) بدون اعلان پیش‌نمونهٔ قبلی تعریف شود، هشدار می‌دهد. این هشدار حتی در صورتی که خودِ تعریفْ یک پیش‌نمونه ارائه دهد نیز صادر می‌شود. از این گزینه برای شناسایی توابع سراسری که فاقد اعلان پیش‌نمونهٔ متناظر در یک فایل سرایند هستند، استفاده کنید. این گزینه برای C++ معتبر نیست زیرا همهٔ اعلان‌های توابعْ پیش‌نمونه ارائه می‌دهند و یک اعلان نامطابق، به جای تداخل با اعلانی پیشین، یک بارگذاری اضافی (overload) اعلان می‌کند. برای شناسایی اعلان‌های ناموجود در C++، از \fB\-Wmissing\-declarations\fR استفاده کنید.
.IP "\fB\-Wmissing\-variable\-declarations\fR (فقط C و Objective\-C)" 4
.IX Item "-Wmissing-variable-declarations (C and Objective-C only)"
اگر یک متغیر سراسری بدون اعلان قبلی تعریف شود، هشدار می‌دهد. از این گزینه برای شناسایی متغیرهای سراسری که فاقد اعلان \f(CWextern\fR متناظر در یک فایل سرایند هستند، استفاده کنید.
.IP \fB\-Wmissing\-declarations\fR 4
.IX Item "-Wmissing-declarations"
اگر یک تابع سراسری بدون اعلان قبلی تعریف شود، هشدار می‌دهد. این کار حتی اگر خودِ تعریفْ یک پیش‌نمونه ارائه دهد نیز انجام می‌شود. از این گزینه برای شناسایی توابع سراسری که در فایل‌های سرایند اعلان نشده‌اند استفاده کنید. در C، هیچ هشداری برای توابعی که دارای اعلان‌های غیر-پیش‌نمونه‌ای قبلی هستند صادر نمی‌شود؛ برای شناسایی پیش‌نمونه‌های ناموجود از \fB\-Wmissing\-prototypes\fR استفاده کنید. در C++، هیچ هشداری برای الگوهای توابع (function templates)، یا برای توابع درون‌خطی (inline)، یا برای توابع درون فضاهای نام گمنام (anonymous namespaces) صادر نمی‌شود..IP \fB\-Wmissing\-field\-initializers\fR 4
.IX Item "-Wmissing-field-initializers"
اگر در مقداردهی اولیه‌ی یک ساختار (structure) برخی فیلدها جا افتاده باشند، هشدار می‌دهد. برای مثال، کد زیر موجب چنین هشداری می‌شود، زیرا \&\f(CW\*(C`x.h\*(C'\fR به صورت ضمنی صفر است:
.Sp
.Vb 2
\&        struct s { int f, g, h; };
\&        struct s x = { 3, 4 };
.Ve
.Sp
در C این گزینه برای مقداردهنده‌های اختصاصی (designated initializers) هشدار نمی‌دهد، بنابراین تغییر زیر هشداری ایجاد نمی‌کند:
.Sp
.Vb 2
\&        struct s { int f, g, h; };
\&        struct s x = { .f = 3, .g = 4 };
.Ve
.Sp
در C این گزینه برای مقداردهی اولیه‌ی صفر فراگیر \&\fB{ 0 }\fR هشدار نمی‌دهد:
.Sp
.Vb 2
\&        struct s { int f, g, h; };
\&        struct s x = { 0 };
.Ve
.Sp
به همین ترتیب، در C++ این گزینه درباره مقداردهی اولیه‌ی خالی { } هشدار نمی‌دهد، برای مثال:
.Sp
.Vb 2
\&        struct s { int f, g, h; };
\&        s x = { };
.Ve
.Sp
این هشدار در \fB\-Wextra\fR گنجانده شده است. برای دریافت سایر هشدارهای \fB\-Wextra\fR بدون این هشدار، از \fB\-Wextra \-Wno\-missing\-field\-initializers\fR استفاده کنید.
.IP \fB\-Wno\-missing\-requires\fR 4
.IX Item "-Wno-missing-requires"
به طور پیش‌فرض، کامپایلر درباره ظاهر شدن یک concept\-id به عنوان یک simple\-requirement در C++20 هشدار می‌دهد:
.Sp
.Vb 1
\&        bool satisfied = requires { C<T> };
.Ve
.Sp
در اینجا اگر \fBC<T>\fR یک عبارت معتبر باشد، مقدار \fBsatisfied\fR برابر با true خواهد بود، که این امر برای تمام Tها صادق است. احتمالاً منظور کاربر نوشتن این بوده است:
.Sp
.Vb 1
\&        bool satisfied = requires { requires C<T> };
.Ve
.Sp
به طوری که \fBsatisfied\fR تنها در صورتی true باشد که مفهوم (concept) \fBC\fR برای نوع \fBT\fR ارضا شده باشد.
.Sp
این هشدار می‌تواند با \fB\-Wno\-missing\-requires\fR غیرفعال شود.
.IP \fB\-Wno\-missing\-template\-keyword\fR 4
.IX Item "-Wno-missing-template-keyword"
اگر شیء والد وابسته (dependent) باشد و عضوی که نام برده می‌شود یک قالب (template) باشد، نشانه‌های دسترسی به عضو .، \-> و :: باید با کلمه کلیدی \f(CW\*(C`template\*(C'\fR همراه شوند.
.Sp
.Vb 6
\&        template <class X>
\&        void DoStuff (X x)
\&        {
\&          x.template DoSomeOtherStuff<X>(); // Good.
\&          x.DoMoreStuff<X>(); // Warning, x is dependent.
\&        }
.Ve
.Sp
در موارد نادر ممکن است هشدارهای مثبت کاذب (false positive) رخ دهد. برای خاموش کردن این هشدار، عبارت را داخل پرانتز قرار دهید. برای مثال، مورد زیر به عنوان یک قالب در نظر گرفته می‌شود، حتی در حالتی که m و N اعداد صحیح هستند:
.Sp
.Vb 3
\&        void NotATemplate (my_class t)
\&        {
\&          int N = 5;
\&        
\&          bool test = t.m < N > (0); // Treated as a template.
\&          test = (t.m < N) > (0); // Same meaning, but not treated as a template.
\&        }
.Ve
.Sp
این هشدار می‌تواند با \fB\-Wno\-missing\-template\-keyword\fR غیرفعال شود.
.IP \fB\-Wno\-multichar\fR 4
.IX Item "-Wno-multichar"
در صورت استفاده از یک ثابت چندنویسه‌ای (\fB\*(AqFOOF\*(Aq\fR) هشدار نده.
معمولاً این موارد نشان‌دهنده غلط املایی در کد کاربر هستند، زیرا مقادیر آن‌ها وابسته به پیاده‌سازی (implementation\-defined) است و نباید در کدهای قابل‌حمل استفاده شوند.
.IP \fB\-Wnormalized=\fR[\fBnone\fR|\fBid\fR|\fBnfc\fR|\fBnfkc\fR] 4
.IX Item "-Wnormalized=[none|id|nfc|nfkc]"
در ISO C و ISO C++، دو شناسه در صورتی متفاوت هستند که دنباله‌های متفاوتی از نویسه‌ها باشند. با این حال، گاهی اوقات هنگام استفاده از نویسه‌های خارج از مجموعه نویسه‌های اصلی ASCII، ممکن است دو دنباله نویسه‌ای متفاوت داشته باشید که یکسان به نظر برسند. برای جلوگیری از سردرگمی، استاندارد ISO 10646 مجموعه‌ای از \fIقواعد نرمال‌سازی\fR را تعریف کرده است که با اعمال آن‌ها اطمینان حاصل می‌شود دو دنباله با ظاهر یکسان به یک دنباله یکسان تبدیل شوند. GCC می‌تواند در صورت استفاده از شناسه‌هایی که نرمال‌سازی نشده‌اند هشدار دهد؛ این گزینه آن هشدار را کنترل می‌کند.
.Sp
چهار سطح هشدار توسط GCC پشتیبانی می‌شود. مقدار پیش‌فرض \&\fB\-Wnormalized=nfc\fR است که درباره هر شناسه‌ای که در فرم نرمال‌سازی شده "C" از ISO 10646 یعنی \fINFC\fR نباشد هشدار می‌دهد. فرم NFC برای بیشتر کاربردها توصیه می‌شود و معادل \&\fB\-Wnormalized\fR است.
.Sp
متأسفانه، برخی نویسه‌ها وجود دارند که در شناسه‌ها طبق ISO C و ISO C++ مجاز هستند، اما وقتی به NFC تبدیل می‌شوند دیگر در شناسه‌ها مجاز نیستند. یعنی هیچ راهی وجود ندارد که این نمادها را در ISO C یا C++ قابل‌حمل به کار برد و در عین حال تمام شناسه‌ها در قالب NFC باشند. گزینه \&\fB\-Wnormalized=id\fR هشدار مربوط به این نویسه‌ها را سرکوب می‌کند. امید می‌رود که نسخه‌های آینده استانداردهای مربوطه این مسئله را اصلاح کنند، و به همین دلیل است که این گزینه حالت پیش‌فرض نیست.
.Sp
می‌توانید با نوشتن \&\fB\-Wnormalized=none\fR یا \&\fB\-Wno\-normalized\fR این هشدار را برای تمام نویسه‌ها غیرفعال کنید. تنها زمانی باید این کار را انجام دهید که از طرح نرمال‌سازی دیگری (مانند "D") استفاده می‌کنید، زیرا در غیر این صورت ممکن است به سادگی باگ‌هایی ایجاد کنید که به معنای واقعی کلمه با چشم دیده نمی‌شوند.
.Sp
برخی نویسه‌ها در ISO 10646 معانی متمایزی دارند اما در برخی قلم‌ها یا روش‌های نمایش، به ویژه پس از اعمال قالب‌بندی، کاملاً یکسان به نظر می‌رسند. برای مثال \f(CW\*(C`\eu207F\*(C'\fR یا "SUPERSCRIPT LATIN SMALL LETTER N"، دقیقاً مانند یک \f(CW\*(C`n\*(C'\fR معمولی نمایش داده می‌شود که در بالانویس قرار گرفته است. استاندارد ISO 10646 طرح نرمال‌سازی \fINFKC\fR را نیز برای تبدیل همه این موارد به یک فرم استاندارد تعریف کرده است، و اگر از \&\fB\-Wnormalized=nfkc\fR استفاده کنید، در صورتی که کد شما در قالب NFKC نباشد GCC هشدار می‌دهد. این هشدار شبیه به هشدار دادن درباره هر شناسه‌ای است که حاوی حرف O باشد فقط به این دلیل که ممکن است با رقم 0 اشتباه گرفته شود، به همین دلیل پیش‌فرض نیست؛ اما اگر محیط برنامه‌نویسی نتواند برای نمایش متمایز این نویسه‌ها اصلاح شود، ممکن است به عنوان یک قاعده‌ی کدنویسی محلی مفید باشد.
.IP \fB\-Wno\-attribute\-warning\fR 4
.IX Item "-Wno-attribute-warning"
درباره استفاده از توابعی که با صفت \f(CW\*(C`warning\*(C'\fR اعلان شده‌اند هشدار نده. به طور پیش‌فرض، این هشدار فعال است. \fB\-Wno\-attribute\-warning\fR می‌تواند برای غیرفعال کردن هشدار، یا \fB\-Wno\-error=attribute\-warning\fR برای جلوگیری از خطا شدن آن هنگام کامپایل با پرچم \fB\-Werror\fR به کار رود.
.IP \fB\-Wno\-deprecated\fR 4
.IX Item "-Wno-deprecated"
درباره استفاده از ویژگی‌های منسوخ‌شده هشدار نده.
.Sp
در C++، مشخص کردن صریح \fB\-Wdeprecated\fR همچنین هشدارهایی را درباره برخی از امکاناتی که در استانداردهای بعدی زبان منسوخ شده‌اند فعال می‌کند، به ویژه \fB\-Wcomma\-subscript\fR، \&\fB\-Wvolatile\fR، \fB\-Wdeprecated\-enum\-float\-conversion\fR، \&\fB\-Wdeprecated\-enum\-enum\-conversion\fR، \&\fB\-Wdeprecated\-literal\-operator\fR و \&\fB\-Wdeprecated\-variadic\-comma\-omission\fR.
.IP \fB\-Wno\-deprecated\-declarations\fR 4
.IX Item "-Wno-deprecated-declarations"
درباره استفاده از توابع، متغیرها یا انواع نشانه‌گذاری‌شده با صفت \f(CW\*(C`deprecated\*(C'\fR هشدار نده.
.IP \fB\-Wno\-deprecated\-openmp\fR 4
.IX Item "-Wno-deprecated-openmp"
درباره کدهای منسوخ‌شده OpenMP هشدار نده.
.IP \fB\-Wno\-overflow\fR 4
.IX Item "-Wno-overflow"
درباره سرریز زمان کامپایل در عبارت‌های ثابت هشدار نده.
.IP \fB\-Wno\-odr\fR 4
.IX Item "-Wno-odr"
درباره نقض‌های قاعده یک تعریف (One Definition Rule) در طول بهینه‌سازی زمان پیوند هشدار می‌دهد. به طور پیش‌فرض فعال است.
.IP \fB\-Wopenacc\-parallelism\fR 4
.IX Item "-Wopenacc-parallelism"
درباره انتخاب‌های بالقوه نامطلوب و غیربهینه مرتبط با موازی‌سازی OpenACC هشدار می‌دهد.
.IP \fB\-Wno\-openmp\fR 4
.IX Item "-Wno-openmp"
درباره کدهای مشکوک در OpenMP هشدار می‌دهد.
.IP \fB\-Wopenmp\-simd\fR 4
.IX Item "-Wopenmp-simd"
اگر مدل هزینه بردارساز (vectorizer cost model) دستورالعمل simd مربوط به OpenMP تنظیم‌شده توسط کاربر را نادیده بگیرد، هشدار می‌دهد. گزینه \fB\-fsimd\-cost\-model=unlimited\fR می‌تواند برای تعدیل مدل هزینه استفاده شود.
.IP "\fB\-Woverride\-init\fR (تنها در C و Objective\-C)" 4
.IX Item "-Woverride-init (C and Objective-C only)"
اگر هنگام استفاده از مقداردهنده‌های اختصاصی، یک فیلد مقداردهی‌شده‌ی بدون اثر جانبی بازنویسی شود، هشدار می‌دهد.
.Sp
این هشدار در \fB\-Wextra\fR گنجانده شده است. برای دریافت سایر هشدارهای \&\fB\-Wextra\fR بدون این مورد، از \&\fB\-Wextra \-Wno\-override\-init\fR استفاده کنید..IP "\fB\-Wno\-override\-init\-side\-effects\fR (تنها C و Objective\-C)" 4
.IX Item "-Wno-override-init-side-effects (C and Objective-C only)"
اگر هنگام استفاده از مقداردهنده‌های اولیه‌ی معین (designated initializers)، یک فیلد مقداردهی‌شده که دارای عوارض جانبی (side effects) است بازنویسی شود، هشدار نده. این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-Wpacked\fR 4
.IX Item "-Wpacked"
هشدار می‌دهد اگر به یک ساختار ویژگی packed داده شود، اما این ویژگی packed هیچ تأثیری بر ساختاربندی یا اندازهٔ ساختار نداشته باشد. چنین ساختارهایی ممکن است با سود اندک دچار ناهم‌ترازی شوند. برای نمونه، در این کد، متغیر \f(CW\*(C`f.x\*(C'\fR در \f(CW\*(C`struct bar\*(C'\fR ناهم‌تراز است با اینکه خود \f(CW\*(C`struct bar\*(C'\fR ویژگی packed را ندارد:
.Sp
.Vb 8
\&        struct foo {
\&          int x;
\&          char a, b, c, d;
\&        } _\|_attribute_\|_((packed));
\&        struct bar {
\&          char z;
\&          struct foo f;
\&        };
.Ve
.IP \fB\-Wnopacked\-bitfield\-compat\fR 4
.IX Item "-Wnopacked-bitfield-compat"
سری‌های ۴.۱، ۴.۲ و ۴.۳ از GCC ویژگی \f(CW\*(C`packed\*(C'\fR را روی میدان‌های بیتی (bit-fields) از نوع \f(CW\*(C`char\*(C'\fR نادیده می‌گیرند. این مشکل در GCC 4.4 برطرف شد اما این تغییر می‌تواند منجر به تفاوت‌هایی در چیدمان ساختار شود. GCC زمانی که آفست چنین فیلدی در GCC 4.4 تغییر کرده باشد به شما اطلاع می‌دهد. برای نمونه، در این ساختار دیگر یک فاصله‌گذاری (padding) ۴ بیتی بین فیلد \f(CW\*(C`a\*(C'\fR و \f(CW\*(C`b\*(C'\fR وجود ندارد:
.Sp
.Vb 5
\&        struct foo
\&        {
\&          char a:4;
\&          char b:8;
\&        } _\|_attribute_\|_ ((packed));
.Ve
.Sp
این هشدار به‌طور پیش‌فرض فعال است. برای غیرفعال کردن این هشدار از \&\fB\-Wno\-packed\-bitfield\-compat\fR استفاده کنید.
.IP "\fB\-Wpacked\-not\-aligned\fR (تنها C، C++، Objective\-C و Objective\-C++)" 4
.IX Item "-Wpacked-not-aligned (C, C++, Objective-C and Objective-C++ only)"
هشدار می‌دهد اگر فیلدی از ساختار با هم‌ترازی مشخص‌شدهٔ صریح، در یک struct یا union فشرده‌شده (packed) ناهم‌تراز باشد. برای نمونه، در این کد هشداری برای \f(CW\*(C`struct S\*(C'\fR به شکل \f(CW\*(C`warning: alignment 1 of \&\*(Aqstruct S\*(Aq is less than 8\*(C'\fR صادر خواهد شد:
.Sp
.Vb 4
\&        struct _\|_attribute_\|_ ((aligned (8))) S8 { char a[8]; };
\&        struct _\|_attribute_\|_ ((packed)) S {
\&          struct S8 s8;
\&        };
.Ve
.Sp
این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wpadded\fR 4
.IX Item "-Wpadded"
هشدار می‌دهد اگر فاصله‌گذاری (padding) در یک ساختار گنجانده شود، چه برای هم‌تراز کردن عنصری از ساختار یا هم‌تراز کردن کل ساختار. گاهی اوقات هنگامی که این رخ می‌دهد، بازآرایی فیلدهای ساختار جهت کاهش فاصله‌گذاری و در نتیجه کوچک‌تر ساختن ساختار امکان‌پذیر است.
.IP \fB\-Wredundant\-decls\fR 4
.IX Item "-Wredundant-decls"
هشدار می‌دهد اگر چیزی بیش از یک بار در همان حوزه (scope) اعلان شود، حتی در مواردی که اعلان چندگانه معتبر است و چیزی را تغییر نمی‌دهد.
.IP \fB\-Wrestrict\fR 4
.IX Item "-Wrestrict"
هشدار می‌دهد هنگامی که شیئی با ارجاع از یک پارامتر دارای توصیف‌گر \f(CW\*(C`restrict\*(C'\fR (یا در C++، پارامتر با توصیف‌گر \f(CW\*(C`_\|_restrict\*(C'\fR) توسط آرگومان دیگری نام مستعار (alias) شود، یا زمانی که رونوشت‌ها بین چنین اشیائی هم‌پوشانی داشته باشند. برای نمونه، فراخوانی تابع \f(CW\*(C`strcpy\*(C'\fR در زیر تلاش می‌کند با جایگزین کردن نویسه‌های آغازین رشته با چهار نویسهٔ پایانی، آن را کوتاه کند. با این حال، چون این فراخوانی نویسهٔ پایانی NUL را درون \f(CW\*(C`a[4]\*(C'\fR می‌نویسد، رونوشت‌ها هم‌پوشانی پیدا کرده و خطا در این فراخوانی تشخیص داده می‌شود.
.Sp
.Vb 6
\&        void foo (void)
\&        {
\&          char a[] = "abcd1234";
\&          strcpy (a, a + 4);
\&          ...
\&        }
.Ve
.Sp
گزینهٔ \fB\-Wrestrict\fR حتی بدون بهینه‌سازی برخی نمونه‌های هم‌پوشانی ساده را تشخیص می‌دهد، اما در \fB\-O2\fR و بالاتر بهترین عملکرد را دارد. این گزینه در \fB\-Wall\fR گنجانده شده است.
.IP "\fB\-Wnested\-externs\fR (تنها C و Objective\-C)" 4
.IX Item "-Wnested-externs (C and Objective-C only)"
هشدار می‌دهد اگر یک اعلان \f(CW\*(C`extern\*(C'\fR درون یک تابع دیده شود.
.IP \fB\-Winline\fR 4
.IX Item "-Winline"
هشدار می‌دهد اگر تابعی که به عنوان inline اعلان شده، نتواند درون‌خط (inline) شود. حتی با این گزینه، کامپایلر دربارهٔ عدم موفقیت در درون‌خط‌سازی توابعی که در سرآیندهای سیستمی اعلان شده‌اند هشداری نمی‌دهد.
.Sp
کامپایلر از روش‌های اکتشافی (heuristics) متعددی برای تعیین درون‌خط‌سازی یا عدم درون‌خط‌سازی یک تابع استفاده می‌کند. برای نمونه، کامپایلر اندازهٔ تابعی که قرار است درون‌خط شود و میزان درون‌خط‌سازی انجام‌شده در تابع کنونی را در نظر می‌گیرد. بنابراین، تغییرات ظاهراً ناچیز در برنامهٔ منبع می‌توانند سبب ظاهر شدن یا ناپدید شدن هشدارهای تولید‌شده توسط \fB\-Winline\fR شوند.
.IP \fB\-Winterference\-size\fR 4
.IX Item "-Winterference-size"
.PD 0
.IP \fB\-Wno\-interference\-size\fR 4
.IX Item "-Wno-interference-size"
.PD
دربارهٔ استفاده‌های شبهه‌برانگیز از متغیرهای \f(CW\*(C`constexpr\*(C'\fR در C++17 یعنی \&\f(CW\*(C`std::hardware_destructive_interference_size\*(C'\fR و \&\f(CW\*(C`std::hardware_constructive_interference_size\*(C'\fR هشدار می‌دهد.
.Sp
این متغیرها برای کنترل چیدمان کلاس به منظور اجتناب از اشتراک کاذب (false sharing) در کدهای همروند در نظر گرفته شده‌اند:
.Sp
.Vb 6
\&        struct independent_fields {
\&          alignas(std::hardware_destructive_interference_size)
\&            std::atomic<int> one;
\&          alignas(std::hardware_destructive_interference_size)
\&            std::atomic<int> two;
\&        };
.Ve
.Sp
در اینجا هدف این است که \fBone\fR و \fBtwo\fR به اندازهٔ کافی از یکدیگر فاصله داشته باشند تا نوشتن در یکی، دسترسی‌ها به دیگری را ملزم به بارگذاری مجدد خط حافظهٔ نهان (cache line) نکند.
.Sp
به‌طور پیش‌فرض، به این متغیرها بر اساس گزینهٔ جاری \fB\-mtune\fR مقادیری اختصاص می‌یابد؛ معمولاً به اندازهٔ خط حافظهٔ نهان L1 برای پردازندهٔ مقصد خاص، و گاهی به یک محدوده در صورتی که تنظیم برای یک هدف عمومی باشد. بنابراین تمام واحدهای ترجمه‌ای (translation units) که برای استفاده از این متغیرها به سازگاری ABI وابسته هستند، باید با همان \fB\-mtune\fR (یا \fB\-mcpu\fR) کامپایل شوند.
.Sp
اگر پایداری ABI اهمیت دارد، مانند زمانی که کاربرد در یک سرآیند برای کتابخانه است، احتمالاً اصلاً نباید از متغیرهای اندازهٔ تداخل سخت‌افزاری استفاده کنید.
.Sp
این هشدارها به‌طور پیش‌فرض فعال هستند. اگر مطمئن هستید که استفادهٔ شما از این متغیرها بر ABI خارج از یک ساخت مجزای پروژه‌تان تأثیر نمی‌گذارد، می‌توانید هشدار را با \fB\-Wno\-interference\-size\fR خاموش کنید.
.IP \fB\-Wint\-in\-bool\-context\fR 4
.IX Item "-Wint-in-bool-context"
برای استفاده‌های مشکوک از مقادیر صحیح در مواردی که مقادیر بولی مورد انتظار است هشدار می‌دهد؛ مانند عبارت‌های شرطی (?:) با استفاده از ثابت‌های صحیح غیربولی در بافتار بولی، نظیر \f(CW\*(C`if (a <= b ? 2 : 3)\*(C'\fR؛ یا شیفت به چپ اعداد صحیح علامت‌دار در بافتار بولی، نظیر \f(CW\*(C`for (a = 0; 1 << a; a++);\*(C'\fR. به همین ترتیب برای تمامی انواع ضرب‌ها صرف‌نظر از نوع داده. این هشدار توسط \fB\-Wall\fR فعال می‌شود.
.IP \fB\-Wno\-int\-to\-pointer\-cast\fR 4
.IX Item "-Wno-int-to-pointer-cast"
هشدارهای ناشی از تبدیل نوع (cast) عدد صحیح با اندازه‌ای متفاوت به نوع اشاره‌گر را بازمی‌دارد. در C++، تبدیل نوع به یک نوع اشاره‌گر با اندازهٔ کوچک‌تر یک خطا است. \fBWint\-to\-pointer\-cast\fR به‌طور پیش‌فرض فعال است.
.IP "\fB\-Wno\-pointer\-to\-int\-cast\fR (تنها C و Objective\-C)" 4
.IX Item "-Wno-pointer-to-int-cast (C and Objective-C only)"
هشدارهای ناشی از تبدیل نوع (cast) از یک اشاره‌گر به نوع عدد صحیح با اندازه‌ای متفاوت را بازمی‌دارد.
.IP \fB\-Winvalid\-pch\fR 4
.IX Item "-Winvalid-pch"
هشدار می‌دهد اگر یک سرآیند از پیش کامپایل‌شده (precompiled header) در مسیر جستجو یافت شود اما نتوان از آن استفاده کرد.
.IP \fB\-Winvalid\-utf8\fR 4
.IX Item "-Winvalid-utf8"
هشدار می‌دهد اگر یک نویسهٔ نامعتبر UTF\-8 یافت شود. این هشدار در C++23 در صورت استفاده از \fB\-finput\-charset=UTF\-8\fR به‌طور پیش‌فرض روشن است و با \fB\-pedantic\-errors\fR به خطا تبدیل می‌شود.
.IP \fB\-Wno\-unicode\fR 4
.IX Item "-Wno-unicode"
شکل‌های نامعتبر توالی‌های گریز (escape sequences) نام‌دار یا مرزبندی‌شده را که به‌عنوان توکن‌های مجزا پردازش می‌شوند تشخیص نده. \fBWunicode\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-Wlong\-long\fR 4
.IX Item "-Wlong-long"
هشدار می‌دهد اگر از نوع \f(CW\*(C`long long\*(C'\fR استفاده شود. این گزینه توسط هر یک از \&\fB\-Wpedantic\fR یا \fB\-Wtraditional\fR در حالت‌های ISO C90 و C++98 فعال می‌شود. برای جلوگیری از پیام‌های هشدار، از \fB\-Wno\-long\-long\fR استفاده کنید.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد..IP \fB\-Wvariadic\-macros\fR 4
.IX Item "-Wvariadic-macros"
اگر ماکروهای با تعداد آرگومان متغیر (variadic macros) در حالت ISO C90 استفاده شوند، یا ساختار جایگزین GNU در حالت ISO C99 به کار رود، هشدار می‌دهد. این گزینه توسط هر یک از \&\fB\-Wpedantic\fR یا \fB\-Wtraditional\fR فعال می‌شود. برای جلوگیری از پیام‌های هشدار، از \fB\-Wno\-variadic\-macros\fR استفاده کنید.
.IP \fB\-Wno\-varargs\fR 4
.IX Item "-Wno-varargs"
در صورت استفاده مشکوک از ماکروهای مدیریت آرگومان‌های متغیر مانند \f(CW\*(C`va_start\*(C'\fR، هشدار نده. این هشدارها به‌طور پیش‌فرض فعال هستند.
.IP \fB\-Wvector\-operation\-performance\fR 4
.IX Item "-Wvector-operation-performance"
اگر یک عملیات برداری از طریق قابلیت‌های SIMD معماری پیاده‌سازی نشود، هشدار می‌دهد. عمدتاً برای تنظیم و بهبود کارایی مفید است. عملیات برداری می‌تواند به‌صورت \f(CW\*(C`piecewise\*(C'\fR (تکه‌به‌تکه) پیاده‌سازی شود، به این معنی که عملیات اسکالر روی هر عنصر بردار انجام می‌شود؛ \&\f(CW\*(C`in parallel\*(C'\fR (موازی)، به این معنی که عملیات برداری با استفاده از اسکالرهای از نوع عریض‌تر پیاده‌سازی می‌شود، که معمولاً از نظر کارایی بهینه‌تر است؛ و \f(CW\*(C`as a single scalar\*(C'\fR (به‌عنوان یک اسکالر منفرد)، به این معنی که بردار در یک نوع اسکالر جا می‌شود.
.IP \fB\-Wvla\fR 4
.IX Item "-Wvla"
اگر یک آرایه با طول متغیر (variable\-length array) در کد استفاده شود، هشدار می‌دهد.
\&\fB\-Wno\-vla\fR از هشدار \fB\-Wpedantic\fR برای آرایه‌های با طول متغیر جلوگیری می‌کند.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wvla\-larger\-than=\fR\fIbyte\-size\fR 4
.IX Item "-Wvla-larger-than=byte-size"
اگر از این گزینه استفاده شود، کامپایلر برای اعلان آرایه‌های با طول متغیری که اندازه آن‌ها نامحدود است، یا محدود به آرگومانی است که اجازه می‌دهد اندازه آرایه از \fIbyte\-size\fR بایت فراتر رود، هشدار می‌دهد. این شبیه به نحوه کارکرد \fB\-Walloca\-larger\-than=\fR\fIbyte\-size\fR است، اما برای آرایه‌های با طول متغیر.
.Sp
توجه داشته باشید که GCC ممکن است آرایه‌های با طول متغیر کوچک با مقدار مشخص را به آرایه‌های معمولی بهینه‌سازی کند، بنابراین ممکن است این هشدار برای چنین آرایه‌هایی صادر نشود.
.Sp
گزینه \&\fB\-Wvla\-larger\-than=\fR\fBPTRDIFF_MAX\fR به‌طور پیش‌فرض فعال است اما معمولاً تنها زمانی مؤثر است که \fB\-ftree\-vrp\fR فعال باشد (پیش‌فرض برای \fB\-O2\fR و بالاتر).
.Sp
همچنین ببینید: \fB\-Walloca\-larger\-than=\fR\fIbyte\-size\fR.
.IP \fB\-Wno\-vla\-larger\-than\fR 4
.IX Item "-Wno-vla-larger-than"
هشدارهای \fB\-Wvla\-larger\-than=\fR را غیرفعال می‌کند. این گزینه معادل \fB\-Wvla\-larger\-than=\fR\fBSIZE_MAX\fR یا بزرگ‌تر است.
.IP \fB\-Wvla\-parameter\fR 4
.IX Item "-Wvla-parameter"
درباره اعلان‌های مجدد توابعی که شامل آرگومان‌هایی از نوع آرایه با طول متغیر (VLA) با انواع یا اَشکال ناهمسان هستند هشدار می‌دهد، و امکان تشخیص دسترسی‌های خارج از محدوده به چنین پارامترهایی را توسط هشدارهایی مانند \&\fB\-Warray\-bounds\fR فعال می‌کند.
.Sp
اگر نخستین اعلان تابع از شکل VLA استفاده کند، کران مشخص‌شده در آرایه به عنوان حداقل تعداد عناصر مورد انتظار برای ارائه در فراخوانی‌های تابع و حداکثر تعداد عناصری که توسط آن قابل دسترسی است در نظر گرفته می‌شود. عدم ارائه آرگومان‌هایی با اندازه کافی یا دسترسی به بیش از حداکثر تعداد عناصر ممکن است شناسایی شود.
.Sp
به عنوان مثال، هشدار برای اعلان‌های مجدد زیر فعال می‌شود زیرا اولی اجازه می‌دهد آرایه‌ای با هر اندازه‌ای به \f(CW\*(C`f\*(C'\fR ارسال شود در حالی که دومی مشخص می‌کند آرگومان آرایه باید حداقل \f(CW\*(C`n\*(C'\fR عنصر داشته باشد. علاوه بر این، فراخوانی \f(CW\*(C`f\*(C'\fR با پارامتر کران VLA مرتبط فراتر از کران واقعی VLA نیز باعث صدور هشدار می‌شود.
.Sp
.Vb 3
\&        void f (int n, int[n]);
\&        // warning: argument 2 previously declared as a VLA
\&        void f (int, int[]);
\&        
\&        void g (int n)
\&        {
\&            if (n > 4)
\&              return;
\&            int a[n];
\&            // warning: access to a by f may be out of bounds
\&            f (sizeof a, a);
\&          ...
\&        }
.Ve
.Sp
گزینه \&\fB\-Wvla\-parameter\fR در \fB\-Wall\fR گنجانده شده است. گزینه \&\fB\-Warray\-parameter\fR هشدارهایی را برای مشکلات مشابه شامل آرگومان‌های آرایه معمولی فعال می‌کند.
.IP \fB\-Wvolatile\-register\-var\fR 4
.IX Item "-Wvolatile-register-var"
اگر یک متغیر ثبات (register) به‌صورت volatile اعلان شود، هشدار می‌دهد. اصلاح‌کننده volatile از تمام بهینه‌سازی‌هایی که ممکن است خواندن و/یا نوشتن روی متغیرهای ثبات را حذف کنند جلوگیری نمی‌کند. این هشدار توسط \&\fB\-Wall\fR فعال می‌شود.
.IP "\fB\-Wno\-xor\-used\-as\-pow\fR (تنها C، C++، Objective\-C و Objective\-C++)" 4
.IX Item "-Wno-xor-used-as-pow (C, C++, Objective-C and Objective-C++ only)"
هشدارهای مربوط به استفاده از \f(CW\*(C`^\*(C'\fR (عملگر XOR) را در مواردی که به نظر می‌رسد منظور کد توان‌رسانی بوده است، غیرفعال می‌کند. به طور خاص، هشدار زمانی رخ می‌دهد که سمت چپ ثابت ده‌دهی ۲ یا ۱۰ باشد و سمت راست نیز یک ثابت ده‌دهی باشد.
.Sp
در C و C++، عملگر \f(CW\*(C`^\*(C'\fR به معنای XOR است، در حالی که در برخی زبان‌های دیگر (مانند TeX و برخی نگارش‌های BASIC) به معنای توان‌رسانی است.
.Sp
این هشدار را می‌توان با تبدیل یکی از عملوندها به هگزادسیمال و همچنین با کامپایل کردن با \fB\-Wno\-xor\-used\-as\-pow\fR بی‌صدا کرد.
.IP \fB\-Wdisabled\-optimization\fR 4
.IX Item "-Wdisabled-optimization"
اگر یک مرحله (pass) بهینه‌سازی درخواستی غیرفعال شده باشد، هشدار می‌دهد. این هشدار عموماً به این معنا نیست که مشکلی در کد شما وجود دارد؛ بلکه صرفاً نشان می‌دهد که بهینه‌سازهای GCC قادر به مدیریت مؤثر کد نیستند. اغلب، مشکل این است که کد شما بسیار بزرگ یا بیش از حد پیچیده است؛ GCC زمانی که احتمال داده شود خودِ بهینه‌سازی زمان فوق‌العاده زیادی صرف خواهد کرد، از بهینه‌سازی برنامه‌ها خودداری می‌کند.
.IP "\fB\-Wpointer\-sign\fR (تنها C و Objective\-C)" 4
.IX Item "-Wpointer-sign (C and Objective-C only)"
برای ارسال یا انتساب آرگومان‌های اشاره‌گر با علامت‌داری (signedness) متفاوت، هشدار می‌دهد. این گزینه تنها برای C و Objective\-C پشتیبانی می‌شود. این هشدار به طور ضمنی توسط \&\fB\-Wall\fR و \fB\-Wpedantic\fR فعال می‌شود، و می‌توان آن را با \&\fB\-Wno\-pointer\-sign\fR غیرفعال کرد.
.Sp
این هشدار با \fB\-pedantic\-errors\fR به یک خطا ارتقا می‌یابد.
.IP \fB\-Wstack\-protector\fR 4
.IX Item "-Wstack-protector"
این گزینه تنها زمانی فعال است که \fB\-fstack\-protector\fR فعال باشد. این گزینه درباره توابعی که در برابر تخریب پشته (stack smashing) محافظت نشده‌اند هشدار می‌دهد.
.IP \fB\-Woverlength\-strings\fR 4
.IX Item "-Woverlength-strings"
درباره ثابت‌های رشته‌ای که از طول «حداقلِ حداکثر» مشخص‌شده در استاندارد C طولانی‌تر هستند هشدار می‌دهد. کامپایلرهای مدرن معمولاً اجازه می‌دهند ثابت‌های رشته‌ای بسیار طولانی‌تر از حد مجاز استاندارد باشند، اما برنامه‌های بسیار قابل‌حمل (portable) باید از استفاده از رشته‌های طولانی‌تر خودداری کنند.
.Sp
این محدودیت \fIپس از\fR الحاق ثابت‌های رشته‌ای اعمال می‌شود، و نویسه تهی پایانی (NUL) را به حساب نمی‌آورد. در C90، این محدودیت ۵۰۹ نویسه بود؛ در C99، به ۴۰۹۵ افزایش یافت. C++98 یک حداقلِ حداکثرِ هنجاری تعیین نمی‌کند، بنابراین رشته‌های با طول بیش از حد در C++ بررسی نمی‌شوند.
.Sp
این گزینه به طور ضمنی توسط \fB\-Wpedantic\fR فعال می‌شود، و می‌توان آن را با \&\fB\-Wno\-overlength\-strings\fR غیرفعال کرد.
.IP "\fB\-Wunsuffixed\-float\-constants\fR (تنها C و Objective\-C)" 4
.IX Item "-Wunsuffixed-float-constants (C and Objective-C only)"
برای هر ثابت ممیز شناوری که فاقد پسوند است یک هشدار صادر می‌کند. هنگامی که همراه با \fB\-Wsystem\-headers\fR استفاده شود، درباره چنین ثابت‌هایی در فایل‌های سرآیند سیستم نیز هشدار می‌دهد. این گزینه می‌تواند هنگام آماده‌سازی کد برای استفاده با پراگمای \f(CW\*(C`FLOAT_CONST_DECIMAL64\*(C'\fR از افزونه ممیز شناور ده‌دهی در C99 مفید باشد.
.IP \fB\-Wno\-lto\-type\-mismatch\fR 4
.IX Item "-Wno-lto-type-mismatch"
در طول بهینه‌سازی زمان پیوند (LTO)، درباره عدم تطابق نوع در اعلان‌های سراسری از واحدهای کامپایل مختلف هشدار نده. نیازمند فعال بودن \fB\-flto\fR است. به‌طور پیش‌فرض فعال است.
.IP "\fB\-Wno\-designated\-init\fR (تنها C و Objective\-C)" 4
.IX Item "-Wno-designated-init (C and Objective-C only)"
هنگامی که از یک مقداردهی اولیه‌کننده موضعی (positional initializer) برای مقداردهی ساختاری که با مشخصه \f(CW\*(C`designated_init\*(C'\fR نشانه‌گذاری شده است استفاده می‌شود، هشدارها را فرو می‌نشاند..SS "گزینه‌های واپایش تحلیل ایستا (Options That Control Static Analysis)"
.IX Subsection "Options That Control Static Analysis"
.IP \fB\-fanalyzer\fR 4
.IX Item "-fanalyzer"
این گزینه یک تحلیل ایستا را بر روی جریان برنامه فعال می‌کند که به دنبال
مسیرهای بین‌روالی (interprocedural) «جالب» درون کد می‌گردد
و برای مشکلات یافت‌شده در آن‌ها هشدار صادر می‌کند.
.Sp
این تحلیل نسبت به سایر هشدارهای GCC پردازش بسیار سنگین‌تر و پرهزینه‌تری دارد.
.Sp
از دید فنی، این گزینه یک اجرای نمادین مبتنی بر پوشش (coverage\-guided symbolic execution)
را روی کد در حال کامپایل انجام می‌دهد. این تحلیل نه معتبر (sound) است و نه کامل (complete):
می‌تواند دارای مثبت کاذب (false positive) و منفی کاذب (false negative) باشد.
این ابزار به جای اثبات درستی برنامه، ابزاری برای باگ‌یابی است.
.Sp
این تحلیل‌گر در این نگارش تنها برای استفاده بر روی کد C مناسب است.
.Sp
فعال‌سازی این گزینه به‌طور مؤثر هشدارهای زیر را فعال می‌کند:
.Sp
\&\fB\-Wanalyzer\-allocation\-size
\&\-Wanalyzer\-deref\-before\-check
\&\-Wanalyzer\-double\-fclose
\&\-Wanalyzer\-double\-free
\&\-Wanalyzer\-exposure\-through\-output\-file
\&\-Wanalyzer\-exposure\-through\-uninit\-copy
\&\-Wanalyzer\-fd\-access\-mode\-mismatch
\&\-Wanalyzer\-fd\-double\-close
\&\-Wanalyzer\-fd\-leak
\&\-Wanalyzer\-fd\-phase\-mismatch
\&\-Wanalyzer\-fd\-type\-mismatch
\&\-Wanalyzer\-fd\-use\-after\-close
\&\-Wanalyzer\-fd\-use\-without\-check
\&\-Wanalyzer\-file\-leak
\&\-Wanalyzer\-free\-of\-non\-heap
\&\-Wanalyzer\-imprecise\-fp\-arithmetic
\&\-Wanalyzer\-infinite\-loop
\&\-Wanalyzer\-infinite\-recursion
\&\-Wanalyzer\-jump\-through\-null
\&\-Wanalyzer\-malloc\-leak
\&\-Wanalyzer\-mismatching\-deallocation
\&\-Wanalyzer\-null\-argument
\&\-Wanalyzer\-null\-dereference
\&\-Wanalyzer\-out\-of\-bounds
\&\-Wanalyzer\-overlapping\-buffers
\&\-Wanalyzer\-possible\-null\-argument
\&\-Wanalyzer\-possible\-null\-dereference
\&\-Wanalyzer\-putenv\-of\-auto\-var
\&\-Wanalyzer\-shift\-count\-negative
\&\-Wanalyzer\-shift\-count\-overflow
\&\-Wanalyzer\-stale\-setjmp\-buffer
\&\-Wanalyzer\-tainted\-allocation\-size
\&\-Wanalyzer\-tainted\-array\-index
\&\-Wanalyzer\-tainted\-assertion
\&\-Wanalyzer\-tainted\-divisor
\&\-Wanalyzer\-tainted\-offset
\&\-Wanalyzer\-tainted\-size
\&\-Wanalyzer\-throw\-of\-unexpected\-type
\&\-Wanalyzer\-undefined\-behavior\-ptrdiff
\&\-Wanalyzer\-undefined\-behavior\-strtok
\&\-Wanalyzer\-unsafe\-call\-within\-signal\-handler
\&\-Wanalyzer\-use\-after\-free
\&\-Wanalyzer\-use\-of\-pointer\-in\-stale\-stack\-frame
\&\-Wanalyzer\-use\-of\-uninitialized\-value
\&\-Wanalyzer\-va\-arg\-type\-mismatch
\&\-Wanalyzer\-va\-list\-exhausted
\&\-Wanalyzer\-va\-list\-leak
\&\-Wanalyzer\-va\-list\-use\-after\-va\-end
\&\-Wanalyzer\-write\-to\-const
\&\-Wanalyzer\-write\-to\-string\-literal\fR
.Sp
این گزینه تنها زمانی در دسترس است که GCC با پشتیبانی فعال از تحلیل‌گر (analyzer)
پیکربندی شده باشد.
.IP \fB\-Wanalyzer\-symbol\-too\-complex\fR 4
.IX Item "-Wanalyzer-symbol-too-complex"
اگر \fB\-fanalyzer\fR فعال باشد، تحلیل‌گر از روش‌های اکتشافی (heuristics)
گوناگونی برای تلاش در جهت ردیابی وضعیت حافظه استفاده می‌کند،
اما کدهای بیش از حد پیچیده می‌توانند این سازوکارها را ناکام بگذارند.
.Sp
به‌طور پیش‌فرض، اگر عبارت‌ها از یک حد درونی فراتر روند، تحلیل بدون اعلام خطا
ردیابی مقادیر آن‌ها را متوقف کرده و برای چنین عبارت‌هایی به یک نمایش نادقیق برمی‌گردد.
گزینهٔ \fB\-Wanalyzer\-symbol\-too\-complex\fR در صورت رخ دادن این موضوع هشدار می‌دهد.
.IP \fB\-Wanalyzer\-too\-complex\fR 4
.IX Item "-Wanalyzer-too-complex"
اگر \fB\-fanalyzer\fR فعال باشد، تحلیل‌گر از روش‌های اکتشافی گوناگونی برای
تلاش در جهت کاوش جریان کنترل و جریان داده در برنامه استفاده می‌کند،
اما کدهای بیش از حد پیچیده می‌توانند این سازوکارها را با شکست مواجه کنند.
.Sp
به‌طور پیش‌فرض، اگر کد بیش از اندازه پیچیده باشد به‌گونه‌ای که تحلیل‌گر نتواند
آن را به‌طور کامل کاوش کند و به یک سقف درونی برسد، تحلیل بدون اعلام پیام متوقف می‌شود.
گزینهٔ \fB\-Wanalyzer\-too\-complex\fR در صورت وقوع این حالت هشدار می‌دهد.
.IP \fB\-Wno\-analyzer\-allocation\-size\fR 4
.IX Item "-Wno-analyzer-allocation-size"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-allocation\-size\fR استفاده کنید.
.Sp
این پیام تشخیصی دربارهٔ مسیرهایی در کد هشدار می‌دهد که در آن‌ها یک اشاره‌گر به یک
بافر طوری مقداردهی می‌شود که به بافری با اندازه‌ای اشاره کند که
مضربی از \f(CW\*(C`sizeof (*pointer)\*(C'\fR نیست.
.Sp
ببینید:  CWE\-131: Incorrect Calculation of Buffer Size (\f(CW\*(C`https://cwe.mitre.org/data/definitions/131.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-deref\-before\-check\fR 4
.IX Item "-Wno-analyzer-deref-before-check"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-deref\-before\-check\fR
استفاده کنید.
.Sp
این پیام تشخیصی برای مسیرهایی در کد هشدار می‌دهد که در آن‌ها یک اشاره‌گر
*پس از* ارجاع‌زدایی (dereference) شدن، برای مقدار \f(CW\*(C`NULL\*(C'\fR بررسی می‌شود؛
این موضوع نشان می‌دهد که اشاره‌گر احتمالاً می‌توانسته NULL باشد.
چنین مواردی بیانگر آن است که بررسی برای NULL یا زائد است،
یا باید به پیش از ارجاع‌زدایی اشاره‌گر منتقل شود.
.Sp
این پیام تشخیصی همچنین مقادیر ارسالی به آرگومان تابعی را که با
\f(CW\*(C`_\|_attribute_\|_((nonnull))\*(C'\fR مشخص شده‌اند، نیازمند مقدار غیر\-NULL در نظر می‌گیرد؛
بنابراین اگر چنین مقادیری پس از بازگشت از فراخوانی آن تابع برای \f(CW\*(C`NULL\*(C'\fR بررسی شوند،
هشدار صادر می‌کند.
.Sp
احتمال گزارش این پیام تشخیصی در صورت فعال بودن هر سطحی از بهینه‌سازی کم است،
چرا که منطق بهینه‌سازی GCC به‌طور معمول چنین بررسی‌هایی را برای NULL زائد در نظر گرفته
و پیش از آن‌که تحلیل‌گر آن‌ها را «ببیند»، با بهینه‌سازی حذفشان می‌کند.
از این رو هنگام تلاش برای راه‌اندازی این پیام تشخیصی، بهینه‌سازی باید غیرفعال باشد.
.IP \fB\-Wno\-analyzer\-double\-fclose\fR 4
.IX Item "-Wno-analyzer-double-fclose"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-double\-fclose\fR استفاده کنید.
.Sp
این پیام تشخیصی دربارهٔ مسیرهایی در کد هشدار می‌دهد که در آن‌ها ممکن است
تابع \f(CW\*(C`fclose\*(C'\fR بیش از یک بار روی یک \f(CW\*(C`FILE *\*(C'\fR فراخوانی شود.
.Sp
ببینید:  CWE\-1341: Multiple Releases of Same Resource or Handle (\f(CW\*(C`https://cwe.mitre.org/data/definitions/1341.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-double\-free\fR 4
.IX Item "-Wno-analyzer-double-free"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-double\-free\fR استفاده کنید.
.Sp
این پیام تشخیصی برای مسیرهایی در کد هشدار می‌دهد که در آن‌ها ممکن است یک تابع
آزادسازی (deallocator) بیش از یک بار روی یک اشاره‌گر فراخوانی شود؛ خواه این تابع \f(CW\*(C`free\*(C'\fR
باشد و خواه یک آزادساز که با صفت \f(CW\*(C`malloc\*(C'\fR مشخص شده است.
.Sp
ببینید:  CWE\-415: Double Free (\f(CW\*(C`https://cwe.mitre.org/data/definitions/415.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-exposure\-through\-output\-file\fR 4
.IX Item "-Wno-analyzer-exposure-through-output-file"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-exposure\-through\-output\-file\fR
استفاده کنید.
.Sp
این پیام تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها یک
مقدار حساس از نظر امنیتی در یک فایل خروجی نوشته می‌شود
(مانند نوشتن گذرواژه در یک فایل لاگ).
.Sp
ببینید:  CWE\-532: Information Exposure Through Log Files (\f(CW\*(C`https://cwe.mitre.org/data/definitions/532.html\*(C'\fR).
.IP \fB\-Wanalyzer\-exposure\-through\-uninit\-copy\fR 4
.IX Item "-Wanalyzer-exposure-through-uninit-copy"
این هشدار هم به \fB\-fanalyzer\fR و هم به استفاده از یک پلاگین نیاز دارد
تا تابعی را مشخص کند که داده‌ها را از میان یک «مرز اعتماد» کپی می‌کند. برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-exposure\-through\-uninit\-copy\fR استفاده کنید.
.Sp
این پیام تشخیصی دربارهٔ «نشت اطلاعات» (infoleaks) هشدار می‌دهد \- مسیرهایی درون کد که در آن‌ها
مقادیر مقداردهی‌نشده از میان یک مرز امنیتی کپی می‌شوند
(مانند کدی در هستهٔ سیستم‌عامل که یک ساختار با مقداردهی اولیهٔ ناقص را از روی پشته به فضای کاربر کپی می‌کند).
.Sp
ببینید:  CWE\-200: Exposure of Sensitive Information to an Unauthorized Actor (\f(CW\*(C`https://cwe.mitre.org/data/definitions/200.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-fd\-access\-mode\-mismatch\fR 4
.IX Item "-Wno-analyzer-fd-access-mode-mismatch"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-fd\-access\-mode\-mismatch\fR
استفاده کنید.
.Sp
این پیام تشخیصی برای مسیرهایی درون کد هشدار می‌دهد که در آن‌ها تلاش شده
یک \&\f(CW\*(C`read\*(C'\fR روی یک توصیف‌گر فایل فقط‌نوشتنی انجام شود، یا برعکس.
.Sp
این پیام تشخیصی همچنین دربارهٔ مسیرهایی از کد هشدار می‌دهد که در آن‌ها تابعی با صفت
\&\f(CW\*(C`fd_arg_read (N)\*(C'\fR همراه با توصیف‌گر فایلی که با
\&\f(CW\*(C`O_WRONLY\*(C'\fR باز شده در آرگومان ارجاع‌شدهٔ \f(CW\*(C`N\*(C'\fR فراخوانی شده است، یا تابعی با صفت
\&\f(CW\*(C`fd_arg_write (N)\*(C'\fR همراه با توصیف‌گر فایلی که با
\&\f(CW\*(C`O_RDONLY\*(C'\fR باز شده در آرگومان ارجاع‌شدهٔ \fIN\fR فراخوانی شده است.
.IP \fB\-Wno\-analyzer\-fd\-double\-close\fR 4
.IX Item "-Wno-analyzer-fd-double-close"
این هشدار به \fB\-fanalyzer\fR نیاز دارد که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-fd\-double\-close\fR
استفاده کنید.
.Sp
این پیام تشخیصی برای مسیرهایی درون کد هشدار می‌دهد که در آن‌ها ممکن است یک
توصیف‌گر فایل بیش از یک بار بسته شود.
.Sp
ببینید:  CWE\-1341: Multiple Releases of Same Resource or Handle (\f(CW\*(C`https://cwe.mitre.org/data/definitions/1341.html\*(C'\fR)..IP \fB\-Wno\-analyzer\-fd\-leak\fR 4
.IX Item "-Wno-analyzer-fd-leak"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-fd\-leak\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها یک توصیف‌گر فایل (file descriptor) باز نشت پیدا کرده است.
.Sp
ببینید CWE\-775: Missing Release of File Descriptor or Handle after Effective Lifetime (\f(CW\*(C`https://cwe.mitre.org/data/definitions/775.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-fd\-phase\-mismatch\fR 4
.IX Item "-Wno-analyzer-fd-phase-mismatch"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-fd\-phase\-mismatch\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها عملیاتی در فاز (مرحله) نادرستی از چرخه حیات توصیف‌گر فایل انجام شده است.
به عنوان مثال، در صورت تلاش برای فراخوانی \f(CW\*(C`accept\*(C'\fR روی یک سوکت جریانی (stream socket) که هنوز \f(CW\*(C`listen\*(C'\fR با موفقیت روی آن فراخوانی نشده است، هشدار می‌دهد.
.Sp
ببینید CWE\-666: Operation on Resource in Wrong Phase of Lifetime (\f(CW\*(C`https://cwe.mitre.org/data/definitions/666.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-fd\-type\-mismatch\fR 4
.IX Item "-Wno-analyzer-fd-type-mismatch"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-fd\-type\-mismatch\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها عملیاتی روی نوع نادرستی از توصیف‌گر فایل انجام شده است.
به عنوان مثال، در صورت تلاش برای استفاده از عملیات سوکت روی توصیف‌گر فایلی که از طریق \f(CW\*(C`open\*(C'\fR به دست آمده است، یا هنگام تلاش برای استفاده از عملیات سوکت جریانی روی یک سوکت داده‌گرام (datagram socket)، هشدار می‌دهد.
.IP \fB\-Wno\-analyzer\-fd\-use\-after\-close\fR 4
.IX Item "-Wno-analyzer-fd-use-after-close"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-fd\-use\-after\-close\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها خواندن یا نوشتن روی یک توصیف‌گر فایل بسته شده فراخوانی می‌شود.
.Sp
این پیام تشخیصی همچنین درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها تابعی با مشخصه \f(CW\*(C`fd_arg (N)\*(C'\fR یا \f(CW\*(C`fd_arg_read (N)\*(C'\fR یا \f(CW\*(C`fd_arg_write (N)\*(C'\fR با یک توصیف‌گر فایل بسته شده در آرگومان ارجاع‌شده \f(CW\*(C`N\*(C'\fR فراخوانی شود.
.IP \fB\-Wno\-analyzer\-fd\-use\-without\-check\fR 4
.IX Item "-Wno-analyzer-fd-use-without-check"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-fd\-use\-without\-check\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها از یک توصیف‌گر فایل بدون بررسی معتبر بودن آن استفاده شده است.
.Sp
این پیام تشخیصی همچنین درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها تابعی با مشخصه \f(CW\*(C`fd_arg (N)\*(C'\fR یا \f(CW\*(C`fd_arg_read (N)\*(C'\fR یا \f(CW\*(C`fd_arg_write (N)\*(C'\fR با یک توصیف‌گر فایل در آرگومان ارجاع‌شده \f(CW\*(C`N\*(C'\fR بدون بررسی معتبر بودن آن فراخوانی شود.
.IP \fB\-Wno\-analyzer\-file\-leak\fR 4
.IX Item "-Wno-analyzer-file-leak"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-file\-leak\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها یک شیء جریان \f(CW\*(C`<stdio.h>\*(C'\fR \f(CW\*(C`FILE *\*(C'\fR نشت پیدا کرده است.
.Sp
ببینید CWE\-775: Missing Release of File Descriptor or Handle after Effective Lifetime (\f(CW\*(C`https://cwe.mitre.org/data/definitions/775.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-free\-of\-non\-heap\fR 4
.IX Item "-Wno-analyzer-free-of-non-heap"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-free\-of\-non\-heap\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها \f(CW\*(C`free\*(C'\fR روی یک اشاره‌گر غیرِ هیپ (غیر heap) فراخوانی می‌شود (مانند یک بافر روی پشته، یا یک متغیر سراسری).
.Sp
ببینید CWE\-590: Free of Memory not on the Heap (\f(CW\*(C`https://cwe.mitre.org/data/definitions/590.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-imprecise\-fp\-arithmetic\fR 4
.IX Item "-Wno-analyzer-imprecise-fp-arithmetic"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-imprecise\-fp\-arithmetic\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها محاسبات ممیز شناور (floating\-point) در مکان‌هایی که به محاسبات دقیق نیاز است استفاده شده است. این پیام تشخیصی در حال حاضر فقط در صورت استفاده از عملوندهای ممیز شناور درون محاسبه اندازه تخصیص حافظه هشدار می‌دهد.
.IP \fB\-Wno\-analyzer\-infinite\-loop\fR 4
.IX Item "-Wno-analyzer-infinite-loop"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-infinite\-loop\fR به کار ببرید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که به نظر می‌رسد به یک حلقه بی‌نهایت منجر می‌شوند.
.Sp
به‌طور خاص، تحلیل‌گر زمانی این هشدار را صادر می‌کند که حلقه‌ای را «مشاهده کند» که در آن:
.RS 4
.IP * 4
هیچ کار قابل‌مشاهده‌ای از بیرون در داخل حلقه انجام نشود
.IP * 4
هیچ راهی برای خروج از حلقه وجود نداشته باشد
.IP * 4
تحلیل‌گر به اندازه کافی درباره وضعیت برنامه در سرتاسر حلقه اطمینان داشته باشد که بداند موارد فوق درست هستند
.RE
.RS 4
.Sp
یک حالت برای صدور این هشدار زمانی است که یک مسیر اجرایی در حلقه وجود داشته باشد که طی کردن آن مسیر در یک دور حلقه (iteration) به این معنی باشد که همان مسیر در تمام دورهای بعدی نیز پیموده خواهد شد.
.Sp
به عنوان مثال، قطعه‌کد زیر را در نظر بگیرید:
.Sp
.Vb 10
\&          while (1)
\&            {
\&              char opcode = *cpu_state.pc;
\&              switch (opcode)
\&               {
\&               case OPCODE_FOO:
\&                 handle_opcode_foo (&cpu_state);
\&                 break;
\&               case OPCODE_BAR:
\&                 handle_opcode_bar (&cpu_state);
\&                 break;
\&               }
\&            }
.Ve
.Sp
تحلیل‌گر در مورد حالت بالا اخطار خواهد داد زیرا اگر \f(CW\*(C`opcode\*(C'\fR با هیچ‌یک از حالات تطابق نداشته باشد، دستور \f(CW\*(C`switch\*(C'\fR حالت ضمنی \f(CW\*(C`default\*(C'\fR را طی می‌کند، که باعث می‌شود بدنه حلقه با بدون تغییر ماندن \f(CW\*(C`cpu_state.pc\*(C'\fR به یک «دستور بی‌اثر» (no\-op) تبدیل شود، و در نتیجه از همان مقدار \f(CW\*(C`opcode\*(C'\fR در تمام تکرارهای بعدی استفاده شده و منجر به یک حلقه بی‌نهایت می‌شود.
.Sp
ببینید CWE\-835: Loop with Unreachable Exit Condition (\*(AqInfinite Loop\*(Aq) (\f(CW\*(C`https://cwe.mitre.org/data/definitions/835.html\*(C'\fR).
.RE
.IP \fB\-Wno\-analyzer\-infinite\-recursion\fR 4
.IX Item "-Wno-analyzer-infinite-recursion"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-infinite\-recursion\fR به کار ببرید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که به نظر می‌رسد به بازگشت بی‌نهایت (infinite recursion) منجر می‌شوند.
.Sp
به‌طور خاص، هنگامی که تحلیل‌گر یک فراخوانی بازگشتی را «مشاهده می‌کند»، وضعیت حافظه در ورودی چارچوب (frame) جدید را با وضعیت آن در ورودی چارچوب قبلی آن تابع روی پشته مقایسه می‌کند. در صورتی که به نظر برسد هیچ چیزی در حافظه تغییر نمی‌کند، این هشدار صادر می‌شود؛ هرگونه تغییر مشاهده‌شده در پارامترها یا متغیرهای سراسری به عنوان عواملی فرض می‌شوند که به پایان بازگشت ختم شده و در نتیجه مانع از صدور هشدار می‌شوند.
.Sp
این پیام تشخیصی احتمالاً مواردی از بازگشت بی‌نهایت را که پیش از آنکه تحلیل‌گر آن‌ها را «ببیند» توسط بهینه‌ساز (optimizer) به تکرار (iteration) تبدیل شده‌اند از دست می‌دهد. از این رو، هنگام تلاش برای فعال‌سازی این بررسی تشخیصی، بهینه‌سازی باید غیرفعال شود.
.Sp
با \fB\-Winfinite\-recursion\fR مقایسه شود، که بررسی تشخیصی مشابهی ارائه می‌دهد، اما به شیوه متفاوتی پیاده‌سازی شده است.
.Sp
ببینید CWE\-674: Uncontrolled Recursion (\f(CW\*(C`https://cwe.mitre.org/data/definitions/674.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-jump\-through\-null\fR 4
.IX Item "-Wno-analyzer-jump-through-null"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-jump\-through\-null\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها یک اشاره‌گر تابع \f(CW\*(C`NULL\*(C'\fR فراخوانی می‌شود.
.IP \fB\-Wno\-analyzer\-malloc\-leak\fR 4
.IX Item "-Wno-analyzer-malloc-leak"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-malloc\-leak\fR
استفاده کنید.
.Sp
این پیام تشخیصی درباره مسیرهایی در کد هشدار می‌دهد که در آن‌ها اشاره‌گری که از طریق یک تخصیص‌دهنده (allocator) تخصیص یافته نشت پیدا کرده است: چه \f(CW\*(C`malloc\*(C'\fR، و چه تابعی که با مشخصه \f(CW\*(C`malloc\*(C'\fR علامت‌گذاری شده است.
.Sp
ببینید CWE\-401: Missing Release of Memory after Effective Lifetime (\f(CW\*(C`https://cwe.mitre.org/data/definitions/401.html\*(C'\fR)..IP \fB\-Wno\-analyzer\-mismatching\-deallocation\fR 4
.IX Item "-Wno-analyzer-mismatching-deallocation"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-mismatching\-deallocation\fR
استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها بر اساس
تابعی که برای تخصیص مقدار اشاره‌گر به کار رفته، تابع آزادسازی اشتباهی روی
آن فراخوانی شده است. این پیام تشخیصی در مورد عدم تطابق بین \f(CW\*(C`free\*(C'\fR، عملگر اسکالر \f(CW\*(C`delete\*(C'\fR
و عملگر برداری \f(CW\*(C`delete[]\*(C'\fR، و مواردی که با استفاده از مشخصهٔ \f(CW\*(C`malloc\*(C'\fR
به عنوان جفت‌های تخصیص‌دهنده/آزادساز مشخص شده‌اند هشدار خواهد داد.
.Sp
ببینید: CWE\-762: Mismatched Memory Management Routines (\f(CW\*(C`https://cwe.mitre.org/data/definitions/762.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-out\-of\-bounds\fR 4
.IX Item "-Wno-analyzer-out-of-bounds"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-out\-of\-bounds\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها قطعاً
خواندن یا نوشتن خارج از محدودهٔ بافر رخ می‌دهد. این پیام تشخیصی در
مواردی اعمال می‌شود که تحلیل‌گر قادر به تعیین یک آفست ثابت باشد و برای
دسترسی‌های فراتر از انتهای بافر، ظرفیت ثابتی را نیز تعیین کند. افزون بر این،
هنگامی که آفست و ظرفیت هر دو نمادین (symbolic) باشند، تحلیل‌گر بررسی‌های
محدودی را برای دسترسی‌های فراتر از انتها انجام می‌دهد.
.Sp
ببینید: CWE\-119: Improper Restriction of Operations within the Bounds of a Memory Buffer (\f(CW\*(C`https://cwe.mitre.org/data/definitions/119.html\*(C'\fR).
.Sp
در مواردی که تحلیل‌گر قادر باشد، یک نمودار متنی (text art) تولید می‌کند که
رابطهٔ مکانی بین ناحیهٔ حافظه‌ای که تحلیل‌گر پیش‌بینی می‌کند به آن دسترسی
یافته می‌شود را در برابر محدودهٔ مجاز حافظه برای دسترسی به تصویر می‌کشد:
اینکه آیا همپوشانی دارند، مماس هستند، نزدیک یا دور از هم هستند؛ کدام‌یک
در حافظه قبل یا بعد از دیگری است، اندازه‌های نسبی مربوطه، جهت دسترسی
(خواندن در برابر نوشتن)، و در برخی موارد، مقادیر داده‌های درگیر.
این نمودار را می‌توان با استفاده از \fB\-fdiagnostics\-text\-art\-charset=none\fR غیرفعال کرد.
.IP \fB\-Wno\-analyzer\-overlapping\-buffers\fR 4
.IX Item "-Wno-analyzer-overlapping-buffers"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-overlapping\-buffers\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
بافرهای همپوشا به یک API فرستاده می‌شوند که رفتار آن در مورد چنین بافرهایی
تعریف‌نشده (undefined) است.
.Sp
به‌طور مشخص، این هشدار تشخیصی هنگام فراخوانی توابع زیر رخ می‌دهد:
.RS 4
.ie n .IP "*<""memcpy"">" 4
.el .IP *<\f(CWmemcpy\fR> 4
.IX Item "*<memcpy>"
.PD 0
.ie n .IP "*<""strcat"">" 4
.el .IP *<\f(CWstrcat\fR> 4
.IX Item "*<strcat>"
.ie n .IP "*<""strcpy"">" 4
.el .IP *<\f(CWstrcpy\fR> 4
.IX Item "*<strcpy>"
.PD
.RE
.RS 4
.Sp
در مواردی که مشخص باشد بافرها با یکدیگر همپوشانی دارند.
.RE
.IP \fB\-Wno\-analyzer\-possible\-null\-argument\fR 4
.IX Item "-Wno-analyzer-possible-null-argument"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-possible\-null\-argument\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
مقداری با احتمال NULL بودن، به آرگومان تابعی فرستاده می‌شود که با مشخصهٔ
\f(CW\*(C`_\|_attribute_\|_((nonnull))\*(C'\fR به عنوان آرگومانی که به مقدار
غیر\-NULL نیاز دارد علامت‌گذاری شده است.
.Sp
ببینید: CWE\-690: Unchecked Return Value to NULL Pointer Dereference (\f(CW\*(C`https://cwe.mitre.org/data/definitions/690.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-possible\-null\-dereference\fR 4
.IX Item "-Wno-analyzer-possible-null-dereference"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-possible\-null\-dereference\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
از مقداری با احتمال NULL بودن ارجاع‌زدایی (dereference) می‌شود.
.Sp
ببینید: CWE\-690: Unchecked Return Value to NULL Pointer Dereference (\f(CW\*(C`https://cwe.mitre.org/data/definitions/690.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-null\-argument\fR 4
.IX Item "-Wno-analyzer-null-argument"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-null\-argument\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
مقداری که قطعاً NULL است، به آرگومان تابعی فرستاده می‌شود که با مشخصهٔ
\f(CW\*(C`_\|_attribute_\|_((nonnull))\*(C'\fR به عنوان آرگومانی که به مقدار
غیر\-NULL نیاز دارد علامت‌گذاری شده است.
.Sp
ببینید: CWE\-476: NULL Pointer Dereference (\f(CW\*(C`https://cwe.mitre.org/data/definitions/476.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-null\-dereference\fR 4
.IX Item "-Wno-analyzer-null-dereference"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-null\-dereference\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
از مقداری که قطعاً NULL است ارجاع‌زدایی می‌شود.
.Sp
ببینید: CWE\-476: NULL Pointer Dereference (\f(CW\*(C`https://cwe.mitre.org/data/definitions/476.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-putenv\-of\-auto\-var\fR 4
.IX Item "-Wno-analyzer-putenv-of-auto-var"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-putenv\-of\-auto\-var\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها در فراخوانی
\f(CW\*(C`putenv\*(C'\fR، اشاره‌گری به یک متغیر محلی خودکار (automatic)
یا یک بافر روی پشته (on\-stack) فرستاده شده است.
.Sp
ببینید: POS34\-C. Do not call \fBputenv()\fR with a pointer to an automatic variable as the argument (\f(CW\*(C`https://wiki.sei.cmu.edu/confluence/x/6NYxBQ\*(C'\fR).
.IP \fB\-Wno\-analyzer\-shift\-count\-negative\fR 4
.IX Item "-Wno-analyzer-shift-count-negative"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-shift\-count\-negative\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
عمل شیفت با تعداد منفی تلاش شده است. این گزینه مشابه پیام تشخیصی
\fB\-Wshift\-count\-negative\fR پیاده‌سازی‌شده در فرانت‌اندهای C/C++ است،
اما به جای تجزیهٔ صِرف درخت نحو (syntax tree)، بر پایهٔ تحلیل مسیرهای
میان‌رویه‌ای (interprocedural) پیاده شده است. با این حال، تحلیل‌گر اولویتی
برای تشخیص چنین مسیرهایی قائل نمی‌شود، بنابراین نتایج منفی کاذب
(false negatives) در مقایسه با سایر هشدارها محتمل‌تر است.
.IP \fB\-Wno\-analyzer\-shift\-count\-overflow\fR 4
.IX Item "-Wno-analyzer-shift-count-overflow"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-shift\-count\-overflow\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها عمل شیفت
با تعدادی بزرگ‌تر یا برابر با دقت نوع عملوند تلاش شده است. این گزینه مشابه پیام
تشخیصی \fB\-Wshift\-count\-overflow\fR پیاده‌سازی‌شده در فرانت‌اندهای C/C++
است، اما به جای تجزیهٔ صِرف درخت نحو، بر پایهٔ تحلیل مسیرهای میان‌رویه‌ای
پیاده‌سازی شده است. با این حال، تحلیل‌گر اولویتی برای تشخیص چنین مسیرهایی
قائل نمی‌شود، بنابراین نتایج منفی کاذب در مقایسه با سایر هشدارها محتمل‌تر است.
.IP \fB\-Wno\-analyzer\-stale\-setjmp\-buffer\fR 4
.IX Item "-Wno-analyzer-stale-setjmp-buffer"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-stale\-setjmp\-buffer\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها
\&\f(CW\*(C`longjmp\*(C'\fR برای بازگشت به یک \f(CW\*(C`jmp_buf\*(C'\fR مربوط
به یک فراخوانی \f(CW\*(C`setjmp\*(C'\fR در تابعی که بازگشته است (returned)، فراخوانی می‌شود.
.Sp
هنگامی که \f(CW\*(C`setjmp\*(C'\fR روی یک \f(CW\*(C`jmp_buf\*(C'\fR برای ثبت موقعیت
بازگشت فراخوانی می‌شود، فریم پشته (stack frame) را ثبت می‌کند. وقتی تابعی
که شامل فراخوانی \f(CW\*(C`setjmp\*(C'\fR است بازمی‌گردد، این فریم پشته نامعتبر می‌شود.
تلاش برای بازگشت به آن از طریق \f(CW\*(C`longjmp\*(C'\fR به فریم پشته‌ای ارجاع می‌دهد
که دیگر وجود ندارد و احتمالاً منجر به فروپاشی (crash) برنامه (یا بدتر از آن) خواهد شد.
.IP \fB\-Wno\-analyzer\-tainted\-allocation\-size\fR 4
.IX Item "-Wno-analyzer-tainted-allocation-size"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-allocation\-size\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها مقداری
که می‌تواند تحت کنترل یک مهاجم باشد، بدون اعتبارسنجی و پاک‌سازی (sanitize) به عنوان
اندازهٔ تخصیص حافظه استفاده شده است، به‌طوری که مهاجم می‌تواند یک تخصیص
بیش از اندازه بزرگ را تزریق کند و به‌طور بالقوه باعث حملهٔ منع سرویس (DoS) شود.
.Sp
ببینید: CWE\-789: Memory Allocation with Excessive Size Value (\f(CW\*(C`https://cwe.mitre.org/data/definitions/789.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-tainted\-assertion\fR 4
.IX Item "-Wno-analyzer-tainted-assertion"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-assertion\fR استفاده کنید.
.Sp
این هشدار تشخیصی دربارهٔ مسیرهایی درون کد هشدار می‌دهد که در آن‌ها مقداری
که می‌تواند تحت کنترل مهاجم باشد، بدون اینکه ابتدا پاک‌سازی و اعتبارسنجی شود
به عنوان بخشی از یک شرط استفاده شده است، و آن شرط از فراخوانی تابعی با
مشخصهٔ \f(CW\*(C`noreturn\*(C'\fR (مانند تابع \f(CW\*(C`_\|_builtin_unreachable\*(C'\fR)
محافظت می‌کند. چنین توابعی معمولاً نشان‌دهندهٔ پایان غیرعادی برنامه هستند،
مانند گرداننده‌های شکست ادعا (assertion failure handlers). برای نمونه:
.Sp
.Vb 1
\&        assert (some_tainted_value < SOME_LIMIT);
.Ve
.Sp
در چنین مواردی:
.RS 4.IP * 4
هنگامی که بررسی ادعاها (assertion\-checking) فعال است: مهاجم می‌تواند با تزریق
یک شکست ادعا (assertion failure)، باعث بروز منع خدمت (denial of service) شود.
.IP * 4
هنگامی که بررسی ادعاها غیرفعال است، مانند زمان تعریف \f(CW\*(C`NDEBUG\*(C'\fR،
مهاجم می‌تواند داده‌هایی را تزریق کند که فرایند را دچار تخریب کند، زیرا احتمالاً
پیش‌شرطی را که توسط کد فرض شده است نقض می‌کند.
.RE
.RS 4
.Sp
توجه داشته باشید که در صورت غیرفعال بودن بررسی ادعاها، assertionها معمولاً
پیش از آنکه تحلیل‌گر شانس «دیدن» آن‌ها را داشته باشد توسط پیش‌پردازنده حذف می‌شوند؛
بنابراین این اعلان تشخیصی تنها می‌تواند در ساخت‌هایی که بررسی ادعاها در آن‌ها فعال است
هشدار تولید کند.
.Sp
به منظور این هشدار، هر تابعی که دارای صفت \&\f(CW\*(C`noreturn\*(C'\fR باشد،
از جمله \f(CW\*(C`_\|_builtin_unreachable\*(C'\fR، به عنوان یک گردانندهٔ احتمالی
شکست ادعا در نظر گرفته می‌شود. توجه داشته باشید که این توابع گاهی پیش از آنکه تحلیل‌گر
آن‌ها را «ببیند»، توسط بهینه‌ساز حذف می‌شوند. از این رو، هنگام تلاش برای فعال‌سازی
این هشدار، بهینه‌سازی باید غیرفعال باشد.
.Sp
ببینید:  CWE\-617: Reachable Assertion (\f(CW\*(C`https://cwe.mitre.org/data/definitions/617.html\*(C'\fR).
.Sp
این هشدار همچنین می‌تواند ساختارهای مشکل‌داری مانند نمونهٔ زیر را گزارش دهد:
.Sp
.Vb 4
\&        switch (some_tainted_value) {
\&        case 0:
\&          /* [...etc; various valid cases omitted...] */
\&          break;
\&        
\&        default:
\&          _\|_builtin_unreachable (); /* BUG: attacker can trigger this  */
\&        }
.Ve
.Sp
اگرچه مورد بالا، به بیان دقیق، یک شکست ادعا نیست.
.RE
.IP \fB\-Wno\-analyzer\-tainted\-array\-index\fR 4
.IX Item "-Wno-analyzer-tainted-array-index"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-array\-index\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها مقداری که ممکن است تحت کنترل
مهاجم باشد، بدون پاک‌سازی و اعتبارسنجی به عنوان اندیس دسترسی به یک آرایه استفاده شود،
به طوری که مهاجم بتواند یک دسترسی خارج از محدوده (out\-of\-bounds access) را تزریق کند.
.Sp
ببینید:  CWE\-129: Improper Validation of Array Index (\f(CW\*(C`https://cwe.mitre.org/data/definitions/129.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-tainted\-divisor\fR 4
.IX Item "-Wno-analyzer-tainted-divisor"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-divisor\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها مقداری که ممکن است تحت کنترل
مهاجم باشد، بدون پاک‌سازی به عنوان مقسوم‌علیه در یک عملیات تقسیم یا باقی‌مانده (modulus)
به کار رود، به طوری که مهاجم بتواند یک تقسیم بر صفر (division\-by\-zero) را تزریق کند.
.Sp
ببینید:  CWE\-369: Divide By Zero (\f(CW\*(C`https://cwe.mitre.org/data/definitions/369.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-tainted\-offset\fR 4
.IX Item "-Wno-analyzer-tainted-offset"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-offset\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها مقداری که ممکن است تحت کنترل
مهاجم باشد، بدون پاک‌سازی به عنوان آفست اشاره‌گر (pointer offset) استفاده شود،
به طوری که مهاجم بتواند یک دسترسی خارج از محدوده را تزریق کند.
.Sp
ببینید:  CWE\-823: Use of Out\-of\-range Pointer Offset (\f(CW\*(C`https://cwe.mitre.org/data/definitions/823.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-tainted\-size\fR 4
.IX Item "-Wno-analyzer-tainted-size"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-tainted\-size\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها مقداری که ممکن است تحت کنترل
مهاجم باشد، بدون پاک‌سازی به عنوان اندازهٔ عملیاتی مانند \f(CW\*(C`memset\*(C'\fR به کار رود،
به طوری که مهاجم بتواند یک دسترسی خارج از محدوده را تزریق کند.
.Sp
ببینید:  CWE\-129: Improper Validation of Array Index (\f(CW\*(C`https://cwe.mitre.org/data/definitions/129.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-throw\-of\-unexpected\-type\fR 4
.IX Item "-Wno-analyzer-throw-of-unexpected-type"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛
برای غیرفعال کردن آن از \fB\-Wno\-analyzer\-throw\-of\-unexpected\-type\fR استفاده کنید.
مشخصات استثنای پویا (dynamic exception specification) فقط در C++14 و پیش از آن در دسترس است.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها یک استثنا از تابعی با مشخصات
استثنای پویا پرتاب می‌شود، در حالی که استثنا با آن مشخصات سازگار نیست.
.IP \fB\-Wno\-analyzer\-undefined\-behavior\-ptrdiff\fR 4
.IX Item "-Wno-analyzer-undefined-behavior-ptrdiff"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-undefined\-behavior\-ptrdiff\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها تفریق اشاره‌گرها در شرایطی رخ می‌دهد
که اشاره‌گرها به قطعه‌های متفاوتی از حافظه ارجاع دارند. چنین کدی به رفتار تعریف‌نشده
(undefined behavior) متکی است، زیرا تفریق اشاره‌گر تنها برای حالاتی تعریف شده است
که هر دو اشاره‌گر به درون (یا دقیقاً بعد از) یک آرایه اشاره کنند.
.Sp
ببینید:  CWE\-469: Use of Pointer Subtraction to Determine Size (\f(CW\*(C`https://cwe.mitre.org/data/definitions/469.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-undefined\-behavior\-strtok\fR 4
.IX Item "-Wno-analyzer-undefined-behavior-strtok"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-undefined\-behavior\-strtok\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها یک فراخوانی با رفتار تعریف‌نشده
به \f(CW\*(C`strtok\*(C'\fR انجام می‌گیرد.
.Sp
به‌طور خاص، ارسال NULL به عنوان پارامتر نخست در اولین فراخوانی \f(CW\*(C`strtok\*(C'\fR
در طول یک فرایند، دارای رفتار تعریف‌نشده است.
.IP \fB\-Wno\-analyzer\-unsafe\-call\-within\-signal\-handler\fR 4
.IX Item "-Wno-analyzer-unsafe-call-within-signal-handler"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-unsafe\-call\-within\-signal\-handler\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها تابعی که ناامن برای سیگنال‌های
ناهمگام (async\-signal\-unsafe) شناخته شده است (مانند \f(CW\*(C`fprintf\*(C'\fR)، از درون یک
گردانندهٔ سیگنال (signal handler) فراخوانی شود.
.Sp
ببینید:  CWE\-479: Signal Handler Use of a Non\-reentrant Function (\f(CW\*(C`https://cwe.mitre.org/data/definitions/479.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-use\-after\-free\fR 4
.IX Item "-Wno-analyzer-use-after-free"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-use\-after\-free\fR استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها یک اشاره‌گر پس از فراخوانی
یک تابع آزادساز روی آن، مورد استفاده قرار می‌گیرد: چه \f(CW\*(C`free\*(C'\fR باشد،
و چه تابع آزادسازی که با صفت \f(CW\*(C`malloc\*(C'\fR ارجاع داده شده است.
.Sp
ببینید:  CWE\-416: Use After Free (\f(CW\*(C`https://cwe.mitre.org/data/definitions/416.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-use\-of\-pointer\-in\-stale\-stack\-frame\fR 4
.IX Item "-Wno-analyzer-use-of-pointer-in-stale-stack-frame"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-use\-of\-pointer\-in\-stale\-stack\-frame\fR
استفاده کنید.
.Sp
این هشدار برای مسیرهایی در کد صادر می‌شود که در آن‌ها اشاره‌گری که به یک
متغیر در یک قاب پشتهٔ منقضی‌شده (stale stack frame) اشاره دارد، ارجاع‌زدایی می‌شود.
.IP \fB\-Wno\-analyzer\-va\-arg\-type\-mismatch\fR 4
.IX Item "-Wno-analyzer-va-arg-type-mismatch"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-va\-arg\-type\-mismatch\fR
استفاده کنید.
.Sp
این هشدار برای مسیرهای میان‌رواله‌ای در کد صادر می‌شود که در آن‌ها تحلیل‌گر تلاشی
برای استفاده از \f(CW\*(C`va_arg\*(C'\fR به منظور استخراج مقداری که به یک فراخوانی با
تعداد آرگومان متغیر (variadic) ارسال شده شناسایی می‌کند، اما نوع داده‌ای استفاده شده
با نوع عبارت ارسال‌شده به فراخوانی همخوانی ندارد.
.Sp
ببینید:  CWE\-686: Function Call With Incorrect Argument Type (\f(CW\*(C`https://cwe.mitre.org/data/definitions/686.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-va\-list\-exhausted\fR 4
.IX Item "-Wno-analyzer-va-list-exhausted"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-va\-list\-exhausted\fR
استفاده کنید.
.Sp
این هشدار برای مسیرهای میان‌رواله‌ای در کد صادر می‌شود که در آن‌ها تحلیل‌گر تلاشی
برای استفاده از \f(CW\*(C`va_arg\*(C'\fR جهت دسترسی به مقدار بعدیِ ارسال‌شده به یک
فراخوانی با تعداد آرگومان متغیر را تشخیص می‌دهد، در حالی که همهٔ مقادیر موجود در
\&\f(CW\*(C`va_list\*(C'\fR از قبل مصرف شده‌اند.
.Sp
ببینید:  CWE\-685: Function Call With Incorrect Number of Arguments (\f(CW\*(C`https://cwe.mitre.org/data/definitions/685.html\*(C'\fR).
.IP \fB\-Wno\-analyzer\-va\-list\-leak\fR 4
.IX Item "-Wno-analyzer-va-list-leak"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-va\-list\-leak\fR
استفاده کنید.
.Sp
این هشدار برای مسیرهای میان‌رواله‌ای در کد صادر می‌شود که در آن‌ها تحلیل‌گر تشخیص
می‌دهد \f(CW\*(C`va_start\*(C'\fR یا \f(CW\*(C`va_copy\*(C'\fR روی یک \f(CW\*(C`va_list\*(C'\fR فراخوانی شده،
بدون اینکه فراخوانی متناظری برای \f(CW\*(C`va_end\*(C'\fR صورت گرفته باشد.
.IP \fB\-Wno\-analyzer\-va\-list\-use\-after\-va\-end\fR 4
.IX Item "-Wno-analyzer-va-list-use-after-va-end"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-va\-list\-use\-after\-va\-end\fR
استفاده کنید.
.Sp
این هشدار برای مسیرهای میان‌رواله‌ای در کد صادر می‌شود که در آن‌ها تحلیل‌گر
تلاشی برای استفاده از یک \f(CW\*(C`va_list\*(C'\fR را پس از آنکه
\&\f(CW\*(C`va_end\*(C'\fR روی آن فراخوانی شده است تشخیص می‌دهد.
\&\f(CW\*(C`va_list\*(C'\fR..IP \fB\-Wno\-analyzer\-write\-to\-const\fR 4
.IX Item "-Wno-analyzer-write-to-const"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-write\-to\-const\fR
استفاده کنید.
.Sp
این گزارش تشخیصی دربارهٔ مسیرهایی در کد هشدار می‌دهد که تحلیل‌گر در
آن‌ها تلاشی برای نوشتن از طریق یک اشاره‌گر روی شیء \f(CW\*(C`const\*(C'\fR را تشخیص دهد.
با این حال، تحلیل‌گر اولویتی برای تشخیص چنین مسیرهایی قائل نمی‌شود،
بنابراین رخداد منفی کاذب در مقایسه با سایر هشدارها محتمل‌تر است.
.IP \fB\-Wno\-analyzer\-write\-to\-string\-literal\fR 4
.IX Item "-Wno-analyzer-write-to-string-literal"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از
\&\fB\-Wno\-analyzer\-write\-to\-string\-literal\fR
استفاده کنید.
.Sp
این گزارش تشخیصی دربارهٔ مسیرهایی در کد هشدار می‌دهد که تحلیل‌گر در
آن‌ها تلاشی برای نوشتن از طریق یک اشاره‌گر روی یک لیترال رشته‌ای را تشخیص دهد.
با این حال، تحلیل‌گر اولویتی برای تشخیص چنین مسیرهایی قائل نمی‌شود،
بنابراین رخداد منفی کاذب در مقایسه با سایر هشدارها محتمل‌تر است.
.IP \fB\-Wno\-analyzer\-use\-of\-uninitialized\-value\fR 4
.IX Item "-Wno-analyzer-use-of-uninitialized-value"
این هشدار نیازمند \fB\-fanalyzer\fR است که آن را فعال می‌کند؛ برای
غیرفعال کردن آن از \&\fB\-Wno\-analyzer\-use\-of\-uninitialized\-value\fR استفاده کنید.
.Sp
این گزارش تشخیصی دربارهٔ مسیرهایی در کد هشدار می‌دهد که در آن‌ها از یک
مقدار مقداردهی‌نشده استفاده می‌شود.
.Sp
نگاه کنید به CWE\-457: Use of Uninitialized Variable (\f(CW\*(C`https://cwe.mitre.org/data/definitions/457.html\*(C'\fR).
.PP
تحلیل‌گر دانشی توکار دربارهٔ رفتار توابع مدیریت حافظهٔ زیر دارد:
.ie n .IP "*<""alloca"">" 4
.el .IP *<\f(CWalloca\fR> 4
.IX Item "*<alloca>"
.PD 0
.ie n .IP "*<توابع توکار ""_\|_builtin_alloc""،>" 4
.el .IP "*<توابع توکار \f(CW_\|_builtin_alloc\fR،>" 4
.IX Item "*<The built-in functions __builtin_alloc,>"
.PD
\&\f(CW\*(C`_\|_builtin_alloc_with_align\*(C'\fR، \f(CW@item\fR \f(CW\*(C`_\|_builtin_calloc\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_free\*(C'\fR، \f(CW\*(C`_\|_builtin_malloc\*(C'\fR، \f(CW\*(C`_\|_builtin_memcpy\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_memcpy_chk\*(C'\fR، \f(CW\*(C`_\|_builtin_memset\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_memset_chk\*(C'\fR، \f(CW\*(C`_\|_builtin_realloc\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_stack_restore\*(C'\fR، و \f(CW\*(C`_\|_builtin_stack_save\*(C'\fR
.ie n .IP "*<""calloc"">" 4
.el .IP *<\f(CWcalloc\fR> 4
.IX Item "*<calloc>"
.PD 0
.ie n .IP "*<""free"">" 4
.el .IP *<\f(CWfree\fR> 4
.IX Item "*<free>"
.ie n .IP "*<""malloc"">" 4
.el .IP *<\f(CWmalloc\fR> 4
.IX Item "*<malloc>"
.ie n .IP "*<""memset"">" 4
.el .IP *<\f(CWmemset\fR> 4
.IX Item "*<memset>"
.ie n .IP "*<""operator delete"">" 4
.el .IP "*<\f(CWoperator delete\fR>" 4
.IX Item "*<operator delete>"
.ie n .IP "*<""operator delete []"">" 4
.el .IP "*<\f(CWoperator delete []\fR>" 4
.IX Item "*<operator delete []>"
.ie n .IP "*<""operator new"">" 4
.el .IP "*<\f(CWoperator new\fR>" 4
.IX Item "*<operator new>"
.ie n .IP "*<""operator new []"">" 4
.el .IP "*<\f(CWoperator new []\fR>" 4
.IX Item "*<operator new []>"
.ie n .IP "*<""realloc"">" 4
.el .IP *<\f(CWrealloc\fR> 4
.IX Item "*<realloc>"
.ie n .IP "*<""strdup"">" 4
.el .IP *<\f(CWstrdup\fR> 4
.IX Item "*<strdup>"
.ie n .IP "*<""strndup"">" 4
.el .IP *<\f(CWstrndup\fR> 4
.IX Item "*<strndup>"
.PD
.PP
دربارهٔ توابع زیر برای کار با توصیف‌کننده‌های فایل:
.ie n .IP "*<""open"">" 4
.el .IP *<\f(CWopen\fR> 4
.IX Item "*<open>"
.PD 0
.ie n .IP "*<""close"">" 4
.el .IP *<\f(CWclose\fR> 4
.IX Item "*<close>"
.ie n .IP "*<""creat"">" 4
.el .IP *<\f(CWcreat\fR> 4
.IX Item "*<creat>"
.ie n .IP "*<""dup""، ""dup2"" و ""dup3"">" 4
.el .IP "*<\f(CWdup\fR، \f(CWdup2\fR و \f(CWdup3\fR>" 4
.IX Item "*<dup, dup2 and dup3>"
.ie n .IP "*<""isatty"">" 4
.el .IP *<\f(CWisatty\fR> 4
.IX Item "*<isatty>"
.ie n .IP "*<""pipe"" و ""pipe2"">" 4
.el .IP "*<\f(CWpipe\fR و \f(CWpipe2\fR>" 4
.IX Item "*<pipe, and pipe2>"
.ie n .IP "*<""read"">" 4
.el .IP *<\f(CWread\fR> 4
.IX Item "*<read>"
.ie n .IP "*<""write"">" 4
.el .IP *<\f(CWwrite\fR> 4
.IX Item "*<write>"
.ie n .IP "*<""socket""، ""bind""، ""listen""، ""accept"" و ""connect"">" 4
.el .IP "*<\f(CWsocket\fR، \f(CWbind\fR، \f(CWlisten\fR، \f(CWaccept\fR و \f(CWconnect\fR>" 4
.IX Item "*<socket, bind, listen, accept, and connect>"
.PD
.PP
دربارهٔ توابع زیر برای کار با جریان‌های \f(CW\*(C`<stdio.h>\*(C'\fR:
.ie n .IP "*<توابع توکار ""_\|_builtin_fprintf""،>" 4
.el .IP "*<توابع توکار \f(CW_\|_builtin_fprintf\fR،>" 4
.IX Item "*<The built-in functions __builtin_fprintf,>"
\&\f(CW\*(C`_\|_builtin_fprintf_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_fputc\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_fputc_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_fputs\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_fputs_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_fwrite\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_fwrite_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_printf\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_printf_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_putc\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_putchar\*(C'\fR، \f(CW\*(C`_\|_builtin_putchar_unlocked\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_putc_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_puts\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_puts_unlocked\*(C'\fR، \f(CW\*(C`_\|_builtin_vfprintf\*(C'\fR، و
\&\f(CW\*(C`_\|_builtin_vprintf\*(C'\fR
.ie n .IP "*<""fopen"">" 4
.el .IP *<\f(CWfopen\fR> 4
.IX Item "*<fopen>"
.PD 0
.ie n .IP "*<""fclose"">" 4
.el .IP *<\f(CWfclose\fR> 4
.IX Item "*<fclose>"
.ie n .IP "*<""ferror"">" 4
.el .IP *<\f(CWferror\fR> 4
.IX Item "*<ferror>"
.ie n .IP "*<""fgets"">" 4
.el .IP *<\f(CWfgets\fR> 4
.IX Item "*<fgets>"
.ie n .IP "*<""fgets_unlocked"">" 4
.el .IP *<\f(CWfgets_unlocked\fR> 4
.IX Item "*<fgets_unlocked>"
.ie n .IP "*<""fileno"">" 4
.el .IP *<\f(CWfileno\fR> 4
.IX Item "*<fileno>"
.ie n .IP "*<""fread"">" 4
.el .IP *<\f(CWfread\fR> 4
.IX Item "*<fread>"
.ie n .IP "*<""getc"">" 4
.el .IP *<\f(CWgetc\fR> 4
.IX Item "*<getc>"
.ie n .IP "*<""getchar"">" 4
.el .IP *<\f(CWgetchar\fR> 4
.IX Item "*<getchar>"
.ie n .IP "*<""fprintf"">" 4
.el .IP *<\f(CWfprintf\fR> 4
.IX Item "*<fprintf>"
.ie n .IP "*<""printf"">" 4
.el .IP *<\f(CWprintf\fR> 4
.IX Item "*<printf>"
.ie n .IP "*<""fwrite"">" 4
.el .IP *<\f(CWfwrite\fR> 4
.IX Item "*<fwrite>"
.PD
.PP
و دربارهٔ توابع زیر:
.ie n .IP "*<توابع توکار ""_\|_builtin_expect""،>" 4
.el .IP "*<توابع توکار \f(CW_\|_builtin_expect\fR،>" 4
.IX Item "*<The built-in functions __builtin_expect,>"
\&\f(CW\*(C`_\|_builtin_expect_with_probability\*(C'\fR، \f(CW\*(C`_\|_builtin_strchr\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_strcpy\*(C'\fR، \f(CW\*(C`_\|_builtin_strcpy_chk\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_strlen\*(C'\fR، \f(CW\*(C`_\|_builtin_va_copy\*(C'\fR، و
\&\f(CW\*(C`_\|_builtin_va_start\*(C'\fR
.ie n .IP "*<افزونه‌های گنو ""error"" و ""error_at_line"">" 4
.el .IP "*<افزونه‌های گنو \f(CWerror\fR و \f(CWerror_at_line\fR>" 4
.IX Item "*<The GNU extensions error and error_at_line>"
.PD 0
.ie n .IP "*<""getpass"">" 4
.el .IP *<\f(CWgetpass\fR> 4
.IX Item "*<getpass>"
.ie n .IP "*<""longjmp"">" 4
.el .IP *<\f(CWlongjmp\fR> 4
.IX Item "*<longjmp>"
.ie n .IP "*<""putenv"">" 4
.el .IP *<\f(CWputenv\fR> 4
.IX Item "*<putenv>"
.ie n .IP "*<""setjmp"">" 4
.el .IP *<\f(CWsetjmp\fR> 4
.IX Item "*<setjmp>"
.ie n .IP "*<""siglongjmp"">" 4
.el .IP *<\f(CWsiglongjmp\fR> 4
.IX Item "*<siglongjmp>"
.ie n .IP "*<""signal"">" 4
.el .IP *<\f(CWsignal\fR> 4
.IX Item "*<signal>"
.ie n .IP "*<""sigsetjmp"">" 4
.el .IP *<\f(CWsigsetjmp\fR> 4
.IX Item "*<sigsetjmp>"
.ie n .IP "*<""strcat"">" 4
.el .IP *<\f(CWstrcat\fR> 4
.IX Item "*<strcat>"
.ie n .IP "*<""strchr"">" 4
.el .IP *<\f(CWstrchr\fR> 4
.IX Item "*<strchr>"
.ie n .IP "*<""strlen"">" 4
.el .IP *<\f(CWstrlen\fR> 4
.IX Item "*<strlen>".PD
.PP
علاوه بر این، توابع گوناگون با پیشوند \f(CW\*(C`_\|_analyzer_\*(C'\fR معنای ویژه‌ای برای تحلیل‌گر دارند که در کتابچهٔ راهنمای GCC Internals شرح داده شده‌اند. پارامترهای داخلی گوناگونی که از طریق \fB\-\-param\fR قابل تنظیم هستند، برای کنترل پیمایش به کار می‌روند؛ این موارد نیز در راهنمای GCC Internals مستند شده‌اند.
.PP
گزینه‌های زیر تحلیل‌گر را کنترل می‌کنند.
.IP \fB\-fanalyzer\-assume\-nothrow\fR 4
.IX Item "-fanalyzer-assume-nothrow"
به‌طور پیش‌فرض، اگر \fB\-fexceptions\fR فعال باشد، تحلیل‌گر فرض می‌کند که فراخوانی هر تابعی بدون مشخصهٔ \f(CW\*(C`nothrow\*(C'\fR می‌تواند یک استثنا پرتاب کند. این امر می‌تواند به شناسایی مسیرهای اجرایی که به دلیل دور زدن کدهای پاک‌سازی توسط استثناها دچار نشت حافظه می‌شوند کمک کند، اما ممکن است هنگام استفاده از هدرهایی که نویسنده مشخصهٔ \f(CW\*(C`nothrow\*(C'\fR را به آن‌ها اضافه نکرده است، منجر به هشدارهای مثبت کاذب شود.
.Sp
اگر \fB\-fanalyzer\-assume\-nothrow\fR فعال باشد، تحلیل‌گر فرض خواهد کرد که توابع خارجی استثنایی پرتاب نمی‌کنند. این ممکن است برای کاهش «نویز» تحلیل‌گر هنگام فعال کردن \fB\-fexceptions\fR روی کدهای C مفید باشد، اما اگر استثنایی توسط مواردی که کد C فراخوانی می‌کند ایجاد شود، می‌تواند مشکلات واقعی را پنهان کند.
.IP \fB\-fanalyzer\-call\-summaries\fR 4
.IX Item "-fanalyzer-call-summaries"
تحلیل بین‌روال‌ها را با محاسبهٔ اثر فراخوانی‌های خاص ساده‌سازی می‌کند، به جای این‌که تمام مسیرهای درون تابع را از نقطهٔ فراخوانی تا هر بازگشت ممکن پیمایش کند.
.Sp
در صورت فعال بودن، خلاصه‌های فراخوانی تنها برای توابعی با بیش از یک نقطهٔ فراخوانی و به اندازهٔ کافی پیچیده استفاده می‌شوند.
.IP \fB\-fanalyzer\-checker=\fR\fIname\fR 4
.IX Item "-fanalyzer-checker=name"
تحلیل‌گر را تنها به اجرای بررسی‌کنندهٔ (checker) نام‌برده‌شده محدود کرده و آن را فعال می‌کند.
.IP \fB\-fanalyzer\-debug\-text\-art\-headings\fR 4
.IX Item "-fanalyzer-debug-text-art-headings"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است. در صورت فعال بودن، تحلیل‌گر حاشیه‌نویسی‌های اضافی را به نمودارهایی که تولید می‌کند می‌افزاید.
.IP \fB\-fno\-analyzer\-feasibility\fR 4
.IX Item "-fno-analyzer-feasibility"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
به‌طور پیش‌فرض تحلیل‌گر بررسی می‌کند که برای هر گزارش خطایی که صادر می‌کند، یک مسیر جریان کنترل امکان‌پذیر وجود داشته باشد: به این معنی که شرایط برقرارشده مانعة‌الجمع نباشند. گزارش‌هایی که هیچ مسیر امکان‌پذیری برای آن‌ها یافت نشود رد می‌شوند. این فیلتر کردن را می‌توان با \fB\-fno\-analyzer\-feasibility\fR برای اشکال‌زدایی مشکلات این بخش از کد غیرفعال کرد.
.IP \fB\-fanalyzer\-fine\-grained\fR 4
.IX Item "-fanalyzer-fine-grained"
کاری انجام نمی‌دهد. برای سازگاری با گذشته حفظ شده است.
.IP \fB\-fanalyzer\-show\-duplicate\-count\fR 4
.IX Item "-fanalyzer-show-duplicate-count"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است: اگر چند گزارش خطا به عنوان موارد تکراری یکدیگر شناسایی شده باشند، هنگام گزارش بهترین پیام تشخیصی، یادداشتی صادر می‌کند که تعداد گزارش‌های اضافی نادیده‌گرفته‌شده توسط منطق حذف موارد تکراری را نشان می‌دهد.
.IP \fB\-fanalyzer\-show\-events\-in\-system\-headers\fR 4
.IX Item "-fanalyzer-show-events-in-system-headers"
به‌طور پیش‌فرض تحلیل‌گر با پنهان کردن رویدادهایی که به‌طور کامل درون یک هدر سیستمی قرار دارند، مسیرهای تشخیصی ساده‌سازی‌شده‌ای صادر می‌کند. با \fB\-fanalyzer\-show\-events\-in\-system\-headers\fR این رویدادها دیگر پنهان نمی‌شوند.
.IP \fB\-fno\-analyzer\-simplify\-supergraph\fR 4
.IX Item "-fno-analyzer-simplify-supergraph"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
به‌طور پیش‌فرض، تحلیل‌گر قبل از تحلیل گراف بالادست (supergraph) برنامه، ساده‌سازی‌های مختلفی را روی آن انجام می‌دهد. با \fB\-fno\-analyzer\-simplify\-supergraph\fR این ساده‌سازی را می‌توان برای اشکال‌زدایی مشکلات مربوط به آن غیرفعال کرد.
.IP \fB\-fno\-analyzer\-state\-merge\fR 4
.IX Item "-fno-analyzer-state-merge"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
به‌طور پیش‌فرض تحلیل‌گر هنگام ساختن «گراف منفجرشده» (exploded graph) خود، تلاش می‌کند با ادغام وضعیت‌های به اندازهٔ کافی مشابه در هر نقطه از برنامه، تحلیل را ساده‌سازی کند. با \fB\-fno\-analyzer\-state\-merge\fR این ادغام را می‌توان برای اشکال‌زدایی مشکلات مربوط به مدیریت وضعیت غیرفعال کرد.
.IP \fB\-fno\-analyzer\-state\-purge\fR 4
.IX Item "-fno-analyzer-state-purge"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
به‌طور پیش‌فرض تحلیل‌گر تلاش می‌کند با پاک‌سازی جنبه‌هایی از وضعیت در هر نقطه از برنامه که به نظر می‌رسد دیگر مرتبط نیستند، تحلیل را ساده‌تر کند؛ مانند مقادیر متغیرهای محلی که در ادامهٔ تابع به آن‌ها دسترسی پیدا نمی‌شود و به تحلیل نشت ارتباطی ندارند.
.Sp
با \fB\-fno\-analyzer\-state\-purge\fR این پاک‌سازی وضعیت را می‌توان برای اشکال‌زدایی مشکلات مدیریت وضعیت غیرفعال کرد.
.IP \fB\-fno\-analyzer\-suppress\-followups\fR 4
.IX Item "-fno-analyzer-suppress-followups"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
به‌طور پیش‌فرض تحلیل‌گر پس از مواجهه با برخی خطاهای تشخیصی خاص، پیمایش یک مسیر اجرایی را متوقف می‌کند تا از صدور آبشاری از پیام‌های تشخیصی بعدی جلوگیری کند.
.Sp
پیام‌های تشخیصی که تحلیل را در طول یک مسیر متوقف می‌کنند عبارتند از:
.RS 4
.IP *<\fB\-Wanalyzer\-null\-argument\fR> 4
.IX Item "*<-Wanalyzer-null-argument>"
.PD 0
.IP *<\fB\-Wanalyzer\-null\-dereference\fR> 4
.IX Item "*<-Wanalyzer-null-dereference>"
.IP *<\fB\-Wanalyzer\-use\-after\-free\fR> 4
.IX Item "*<-Wanalyzer-use-after-free>"
.IP *<\fB\-Wanalyzer\-use\-of\-pointer\-in\-stale\-stack\-frame\fR> 4
.IX Item "*<-Wanalyzer-use-of-pointer-in-stale-stack-frame>"
.IP *<\fB\-Wanalyzer\-use\-of\-uninitialized\-value\fR> 4
.IX Item "*<-Wanalyzer-use-of-uninitialized-value>"
.PD
.RE
.RS 4
.Sp
با \fB\-fno\-analyzer\-suppress\-followups\fR تحلیل‌گر حتی پس از چنین خطاهایی به پیمایش مسیرها ادامه می‌دهد، که ممکن است برای اشکال‌زدایی مشکلات در تحلیل‌گر یا برای معیارسنجی‌های خرد (microbenchmarks) جهت شناسایی رفتار تعریف‌نشده مفید باشد.
.RE
.IP \fB\-fanalyzer\-transitivity\fR 4
.IX Item "-fanalyzer-transitivity"
این گزینه ویژگی تعدی (transitivity) قیدها را در تحلیل‌گر فعال می‌کند.
.IP \fB\-fno\-analyzer\-undo\-inlining\fR 4
.IX Item "-fno-analyzer-undo-inlining"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.Sp
\&\fB\-fanalyzer\fR در مقایسه با سایر ابزارهای تحلیل کد نسبتاً دیر اجرا می‌شود و برخی بهینه‌سازی‌ها پیش‌تر روی کد اعمال شده‌اند. به‌ویژه ممکن است درون‌خط‌سازی توابع (inlining) رخ داده باشد، که باعث می‌شود مسیرهای اجرایی بین‌روال‌ها صادرشده توسط تحلیل‌گر حاوی فریم‌های تابعی باشند که با موارد موجود در کد مبدأ اصلی مطابقت ندارند.
.Sp
به‌طور پیش‌فرض تحلیل‌گر تلاش می‌کند فریم‌های تابع اصلی را بازسازی کرده و رویدادهایی را برای نشان دادن فراخوانی‌های درون‌خط‌شده صادر کند.
.Sp
با \fB\-fno\-analyzer\-undo\-inlining\fR می‌توان این تلاش برای بازسازی اطلاعات فریم اصلی را غیرفعال کرد، که ممکن است هنگام اشکال‌زدایی مشکلات درون تحلیل‌گر مفید باشد.
.IP \fB\-fanalyzer\-verbose\-edges\fR 4
.IX Item "-fanalyzer-verbose-edges"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است. این گزینه جزئیات پرگوتر و سطح‌پایین‌تری را در توصیف جریان کنترل درون مسیرهای تشخیصی فعال می‌کند.
.IP \fB\-fanalyzer\-verbose\-state\-changes\fR 4
.IX Item "-fanalyzer-verbose-state-changes"
این گزینه برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است. این گزینه جزئیات پرگوتر و سطح‌پایین‌تری را در توصیف رویدادهای مربوط به ماشین‌های وضعیت درون مسیرهای تشخیصی فعال می‌کند.
.IP \fB\-fanalyzer\-verbosity=\fR\fIlevel\fR 4
.IX Item "-fanalyzer-verbosity=level"
این گزینه پیچیدگی مسیرهای جریان کنترلی را که برای پیام‌های تشخیصی تحلیل‌گر صادر می‌شوند کنترل می‌کند.
.Sp
مقدار \fIlevel\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
در این سطح، رویدادهای فراخوانی و بازگشت بین‌روال‌ها همراه با مرتبط‌ترین رویدادهای تغییر وضعیت مربوط به یک پیام تشخیصی نمایش داده می‌شوند. برای مثال، برای خطای آزادسازی مضاعف (\f(CW\*(C`free\*(C'\fR دوگانه)، هر دو فراخوانی به \f(CW\*(C`free\*(C'\fR نشان داده خواهند شد.
.IP \fB1\fR 4
.IX Item "1"
همانند سطح قبل، اما علاوه بر آن رویدادهای مربوط به ورود به هر تابع را نیز نشان می‌دهد.
.IP \fB2\fR 4
.IX Item "2"
همانند سطح قبل، اما علاوه بر آن رویدادهای مربوط به جریان کنترلی را که در تحریک مشکل نقش اساسی دارند نیز نشان می‌دهد (مانند «طی شدن مسیر شرط درست» در یک گزارهٔ شرطی).
.Sp
این سطح حالت پیش‌فرض است.
.IP \fB3\fR 4
.IX Item "3"
همانند سطح قبل، اما تمامی رویدادهای جریان کنترل را نشان می‌دهد، نه فقط رویدادهای مهم را.
.IP \fB4\fR 4
.IX Item "4"
این سطح برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است؛ رویدادهای متفرقهٔ دیگری را که برای اشکال‌زدایی تحلیل‌گر کاربرد دارند اضافه می‌کند.
.RE
.RS 4
.RE.IP \fB\-fdump\-analyzer\fR 4
.IX Item "-fdump-analyzer"
جزئیات درونی مربوط به اقدامات تحلیل‌گر را در
\&\fIfile.analyzer.txt\fR تخلیه می‌کند.
گزینهٔ \&\fB\-fdump\-analyzer\-stderr\fR بر این گزینه اولویت دارد.
.IP \fB\-fdump\-analyzer\-stderr\fR 4
.IX Item "-fdump-analyzer-stderr"
جزئیات درونی مربوط به اقدامات تحلیل‌گر را در stderr تخلیه می‌کند.
این گزینه بر \fB\-fdump\-analyzer\fR اولویت دارد.
.IP \fB\-fdump\-analyzer\-callgraph\fR 4
.IX Item "-fdump-analyzer-callgraph"
نمایشی از نمودار فراخوانی (call graph) مناسب برای مشاهده با
GraphViz را در \fIfile.callgraph.dot\fR تخلیه می‌کند.
.IP \fB\-fdump\-analyzer\-exploded\-graph\fR 4
.IX Item "-fdump-analyzer-exploded-graph"
نمایشی از «exploded graph» مناسب برای مشاهده با
GraphViz را در \fIfile.eg.dot\fR تخلیه می‌کند.
گره‌ها بر اساس وضعیت‌های ماشین حالت با رنگ کدگذاری شده‌اند تا بر
تغییرات حالت تأکید شود.
.IP \fB\-fdump\-analyzer\-exploded\-nodes\fR 4
.IX Item "-fdump-analyzer-exploded-nodes"
پیام‌های تشخیصی صادر می‌کند که نشان می‌دهند گره‌های موجود در «exploded graph» در
کجای کد منبع برنامه قرار دارند.
.IP \fB\-fdump\-analyzer\-exploded\-nodes\-2\fR 4
.IX Item "-fdump-analyzer-exploded-nodes-2"
نمایشی متنی از «exploded graph» را در
\&\fIfile.eg.txt\fR تخلیه می‌کند.
.IP \fB\-fdump\-analyzer\-exploded\-nodes\-3\fR 4
.IX Item "-fdump-analyzer-exploded-nodes-3"
نمایشی متنی از «exploded graph» را به‌ازای هر گره در یک فایل تخلیه،
در \fIfile.eg\-id.txt\fR تخلیه می‌کند.
این کار معمولاً منجر به تعداد زیادی فایل تخلیه می‌شود.
.IP \fB\-fdump\-analyzer\-exploded\-paths\fR 4
.IX Item "-fdump-analyzer-exploded-paths"
نمایشی متنی از «exploded path» را به‌ازای هر
پیام تشخیصی در \fIfile.idx.kind.epath.txt\fR تخلیه می‌کند.
.IP \fB\-fdump\-analyzer\-feasibility\fR 4
.IX Item "-fdump-analyzer-feasibility"
جزئیات درونی مربوط به جستجوی تحلیل‌گر برای مسیرهای شدنی (feasible paths) را تخلیه می‌کند.
جزئیات به قالبی مناسب جهت مشاهده با GraphViz در
فایل‌هایی با قالب نام‌گذاری \fIfile.*.fg.dot\fR،
\&\fIfile.*.tg.dot\fR و \fIfile.*.fpath.txt\fR نوشته می‌شوند.
.IP \fB\-fdump\-analyzer\-infinite\-loop\fR 4
.IX Item "-fdump-analyzer-infinite-loop"
جزئیات درونی مربوط به جستجوی تحلیل‌گر برای حلقه‌های بی‌نهایت را تخلیه می‌کند.
جزئیات به قالبی مناسب جهت مشاهده با GraphViz در
فایل‌هایی با قالب نام‌گذاری \fIfile.*.infinite\-loop.dot\fR نوشته می‌شوند.
.IP \fB\-fdump\-analyzer\-json\fR 4
.IX Item "-fdump-analyzer-json"
نمایشی فشرده‌شده در قالب JSON از جزئیات درونی تحلیل‌گر را در
\&\fIfile.analyzer.json.gz\fR تخلیه می‌کند. قالب دقیق آن دستخوش
تغییر است.
.IP \fB\-fdump\-analyzer\-state\-purge\fR 4
.IX Item "-fdump-analyzer-state-purge"
مطابق با \fB\-fdump\-analyzer\-supergraph\fR، نمایشی از
«supergraph» مناسب برای مشاهده با GraphViz را تخلیه می‌کند، اما
نمودار را با اطلاعاتی مبنی بر اینکه چه وضعیتی در هر گره پاکسازی خواهد شد حاشیه‌نویسی می‌کند.
این نمودار در \fIfile.state\-purge.dot\fR نوشته می‌شود.
.IP \fB\-fdump\-analyzer\-supergraph\fR 4
.IX Item "-fdump-analyzer-supergraph"
نمایش‌هایی از «supergraph» مناسب برای مشاهده با
GraphViz را در \fIfile.supergraph.index.kind.dot\fR تخلیه می‌کند.
این نمایش‌ها تمام نمودارهای جریان کنترل را در برنامه، در مراحل گوناگونِ
تحلیل نشان می‌دهند. مجموعهٔ دقیق فایل‌های تخلیه‌شده و آنچه نمایش می‌دهند دستخوش
تغییر است.
.IP \fB\-fdump\-analyzer\-untracked\fR 4
.IX Item "-fdump-analyzer-untracked"
هشدارهای سفارشی همراه با جزئیات درونی صادر می‌کند که برای توسعه‌دهندگان تحلیل‌گر در نظر گرفته شده است.
.SS "گزینه‌های اشکال‌زدایی برنامه (Options for Debugging Your Program)"
.IX Subsection "Options for Debugging Your Program"
برای اینکه به GCC بگویید اطلاعات اضافی را جهت استفاده توسط یک اشکال‌زدا صادر کند، تقریباً
در همهٔ موارد تنها کافی است \fB\-g\fR را به سایر گزینه‌های خود اضافه کنید. برخی قالب‌های اشکال‌زدایی
می‌توانند هم‌زمان وجود داشته باشند (مانند DWARF همراه با CTF)، زمانی که هر یک از آن‌ها
به‌طور صریح با افزودن گزینهٔ خط فرمان مربوطه به دیگر گزینه‌هایتان فعال شده باشند.
.PP
کامپایلر GCC به شما اجازه می‌دهد از \fB\-g\fR به همراه
\&\fB\-O\fR استفاده کنید. میان‌برهایی که توسط کد بهینه‌شده اعمال می‌شوند ممکن است گهگاه
غافلگیرکننده باشند: ممکن است برخی متغیرهایی که تعریف کرده‌اید اصلاً وجود نداشته
باشند؛ جریان کنترل ممکن است لحظه‌ای به جایی برود که انتظارش را نداشتید؛
برخی دستورها ممکن است اجرا نشوند زیرا نتایج ثابتی را محاسبه می‌کنند
یا مقادیر آن‌ها از پیش آماده است؛ برخی دستورها ممکن است
در مکان‌های متفاوتی اجرا شوند چون به بیرون از حلقه‌ها منتقل شده‌اند.
با این وجود، اشکال‌زدایی خروجی بهینه‌شده امکان‌پذیر است. این امر
استفاده از بهینه‌ساز را برای برنامه‌هایی که ممکن است باگ داشته باشند منطقی می‌سازد.
.PP
اگر از گزینهٔ بهینه‌سازی دیگری استفاده نمی‌کنید، استفاده از
\&\fB\-Og\fR را همراه با \fB\-g\fR مد نظر قرار دهید.
در نبود هیچ گزینهٔ \fB\-O\fR، برخی از گذرهای کامپایلر که اطلاعاتِ
مفید برای اشکال‌زدایی را جمع‌آوری می‌کنند اصلاً اجرا نمی‌شوند؛ در نتیجه
\&\fB\-Og\fR ممکن است به تجربهٔ اشکال‌زدایی بهتری منجر شود.
.IP \fB\-g\fR 4
.IX Item "-g"
.PD 0
.IP \fB\-\-debug\fR 4
.IX Item "--debug"
.PD
اطلاعات اشکال‌زدایی را در قالب بومی سیستم‌عامل
(stabs، COFF، XCOFF یا DWARF) تولید می‌کند. GDB می‌تواند با این اطلاعات
اشکال‌زدایی کار کند.
.Sp
در بیشتر سیستم‌هایی که از قالب stabs استفاده می‌کنند، \fB\-g\fR استفاده از اطلاعات
اشکال‌زدایی اضافی را فعال می‌کند که تنها GDB قادر به استفاده از آن است؛ این اطلاعات اضافی
باعث کارکرد بهتر اشکال‌زدایی در GDB می‌شود اما احتمالاً موجب کرش کردن یا امتناع سایر
اشکال‌زداها از خواندن برنامه می‌گردد. اگر می‌خواهید با قطعیت مشخص کنید که آیا
اطلاعات اضافی تولید شوند یا خیر، از \fB\-gvms\fR استفاده کنید (پایین را ببینید).
.IP \fB\-ggdb\fR 4
.IX Item "-ggdb"
اطلاعات اشکال‌زدایی را برای استفاده توسط GDB تولید می‌کند. این بدان معناست که از
ویژه‌ترین و گویاترین قالب موجود (DWARF، stabs، یا در صورت عدم پشتیبانی از هیچ‌یک از آن‌ها، قالب بومی)
استفاده می‌شود، از جمله الحاقات GDB در صورت امکان.
.IP \fB\-gdwarf\fR 4
.IX Item "-gdwarf"
.PD 0
.IP \fB\-gdwarf\-\fR\fIversion\fR 4
.IX Item "-gdwarf-version"
.PD
اطلاعات اشکال‌زدایی را در قالب DWARF تولید می‌کند (در صورتی که پشتیبانی شود).
مقدار \fIversion\fR می‌تواند 2، 3، 4 یا 5 باشد؛ نسخهٔ پیش‌فرض
برای بیشتر مقصدها برابر 5 است (به‌استثنای VxWorks، TPF و
Darwin / macOS که پیش‌فرض آن‌ها نسخهٔ 2 است، و AIX که پیش‌فرض آن
نسخهٔ 4 است).
.Sp
توجه داشته باشید که در DWARF نسخهٔ 2، برخی درگاه‌ها در جداول بازپیچی (unwind tables) نیازمند
استفاده همیشگی از برخی الحاقات سازگار DWARF 3 هستند.
.Sp
نسخهٔ 4 ممکن است برای بیشترین کارایی به GDB 7.0 و \fB\-fvar\-tracking\-assignments\fR
نیاز داشته باشد. نسخهٔ 5 نیازمند GDB 8.0 یا بالاتر است.
.Sp
کامپایلر GCC دیگر از DWARF نسخهٔ 1، که تفاوتی اساسی با نسخهٔ 2
و پس از آن دارد، پشتیبانی نمی‌کند. بنا به دلایل تاریخی، برخی گزینه‌های
دیگرِ مرتبط با DWARF نظیر
\&\fB\-fno\-dwarf2\-cfi\-asm\fR ارجاع به DWARF نسخهٔ 2 را در
نام خود حفظ کرده‌اند، اما بر تمام نسخه‌های پشتیبانی‌شدهٔ فعلیِ DWARF اعمال می‌شوند.
.IP \fB\-gbtf\fR 4
.IX Item "-gbtf"
اطلاعات اشکال‌زدایی BTF را درخواست می‌کند. قالب BTF قالب پیش‌فرض اشکال‌زدایی برای مقصد
eBPF است. در سایر مقصدها، مانند x86، اطلاعات اشکال‌زدایی BTF می‌تواند در کنار اطلاعات اشکال‌زدایی DWARF
تولید شود، هنگامی که هر دو قالب اشکال‌زدایی به‌طور صریح از طریق گزینه‌های خط فرمان مربوطه
فعال شده باشند.
.IP \fB\-gprune\-btf\fR 4
.IX Item "-gprune-btf"
.PD 0
.IP \fB\-gno\-prune\-btf\fR 4
.IX Item "-gno-prune-btf"
.PD
هرس کردن اطلاعات BTF پیش از صدور. هنگام هرس کردن، تنها اطلاعات
نوع برای انواع استفاده‌شده توسط متغیرهای سراسری و توابع در دامنهٔ فایل (file\-scope)
صادر خواهند شد. در صورت کامپایل برای مقصد BPF همراه با BPF CO\-REِ
فعال، اطلاعات نوع برای انواع استفاده‌شده در بازنشانی‌های BPF
CO\-RE نیز صادر خواهند شد. افزون بر این، انواع struct و union که تنها
از طریق اشاره‌گرها از اعضای دیگر انواع struct یا union به آن‌ها ارجاع داده شده است،
هرس شده و با BTF_KIND_FWD جایگزین می‌شوند، گویی آن انواع تنها به‌صورت
اعلان‌های روبه‌جلو (forward declarations) در ورودی حضور داشته‌اند.
.Sp
این گزینه اندازهٔ اطلاعات BTF تولیدشده را به میزان قابل‌توجهی کاهش می‌دهد،
اما با از دست رفتن چشمگیر در میزان اطلاعات تفصیلی نوع همراه است.
این گزینه در درجه اول هنگام کامپایل برای مقصد BPF سودمند است، تا اندازهٔ
شیء خروجی را به حداقل برساند و اطلاعات BTF را که فوراً مرتبط
با فرایند بارگذاری برنامهٔ BPF نیستند حذف نماید.
.Sp
این گزینه به‌طور پیش‌فرض برای مقصد BPF هنگام تولید اطلاعات
BTF فعال است.
.IP \fB\-gctf\fR 4
.IX Item "-gctf"
.PD 0
.IP \fB\-gctf\fR\fIlevel\fR 4
.IX Item "-gctflevel"
.PD
اطلاعات اشکال‌زدایی CTF را درخواست می‌کند و از level برای مشخص کردن میزان اطلاعات اشکال‌زدایی
تولیدشده استفاده می‌کند. اگر \fB\-gctf\fR بدون مقداری برای level مشخص
شود، سطح پیش‌فرض اطلاعات اشکال‌زدایی CTF برابر 2 خواهد بود.
.Sp
اطلاعات اشکال‌زدایی CTF را می‌توان در کنار اطلاعات اشکال‌زدایی DWARF تولید کرد، مشروط بر اینکه
هر دو قالب اشکال‌زدایی به‌طور صریح از طریق گزینه‌های خط فرمان مربوطه
فعال شده باشند.
.Sp
سطح 0 به‌هیچ‌وجه اطلاعات اشکال‌زدایی CTF تولید نمی‌کند؛ بنابراین، \fB\-gctf0\fR
اثر \fB\-gctf\fR را خنثی می‌کند.
.Sp
سطح 1 اطلاعات CTF را تنها برای ردگیری‌ها (tracebacks) تولید می‌کند. این شامل اطلاعات
محل فراخوانی (callsite) می‌شود، اما اطلاعات نوع را در بر نمی‌گیرد.
.Sp
سطح 2 اطلاعات نوع را فقط برای موجودیت‌ها (توابع، اشیاء داده و غیره)
در دامنهٔ فایل (file\-scope) یا دامنهٔ سراسری (global\-scope) تولید می‌کند..IP \fB\-gvms\fR 4
.IX Item "-gvms"
تولید اطلاعات اشکال‌زدایی در قالب اشکال‌زدایی Alpha/VMS (در صورت پشتیبانی). این قالبی است که توسط DEBUG در سیستم‌های Alpha/VMS استفاده می‌شود.
.IP \fB\-gcodeview\fR 4
.IX Item "-gcodeview"
تولید اطلاعات اشکال‌زدایی در قالب اشکال‌زدایی CodeView (در صورت پشتیبانی). این قالبی است که توسط Microsoft Visual C++ در Windows استفاده می‌شود.
.IP \fB\-g\fR\fIlevel\fR 4
.IX Item "-glevel"
.PD 0
.IP \fB\-ggdb\fR\fIlevel\fR 4
.IX Item "-ggdblevel"
.IP \fB\-gvms\fR\fIlevel\fR 4
.IX Item "-gvmslevel"
.PD
درخواست اطلاعات اشکال‌زدایی و همچنین استفاده از \fIlevel\fR برای تعیین میزان اطلاعات. سطح پیش‌فرض ۲ است.
.Sp
سطح ۰ اصلاً هیچ اطلاعات اشکال‌زدایی تولید نمی‌کند. بنابراین، \fB\-g0\fR گزینهٔ \&\fB\-g\fR را خنثی می‌کند.
.Sp
سطح ۱ اطلاعات حداقلی تولید می‌کند، به میزانی که برای گرفتن ردپای پشته (backtrace) در بخش‌هایی از برنامه که قصد اشکال‌زدایی آن‌ها را ندارید کافی باشد. این اطلاعات شامل توصیف توابع و متغیرهای خارجی و جدول‌های شماره سطر است، اما هیچ اطلاعاتی دربارهٔ متغیرهای محلی ارائه نمی‌دهد.
.Sp
سطح ۲ تنظیم معمول برای تولید کد قابل اشکال‌زدایی است. خروجی اشکال‌زدایی شامل تمام اطلاعات سطح ۱، به همراه اطلاعات مربوط به متغیرهای محلی و typedefها است تا امکان گام برداشتن در کد (stepping) و بررسی وضعیت آن فراهم شود. برای کدهای C++، اطلاعات اضافی نیز برای کمک به اشکال‌زدایی توابع فضای نام (namespace)، کلاس و الگو (template) صادر می‌شود.
.Sp
سطح ۳ شامل اطلاعات اضافی مانند تمام تعاریف ماکرو موجود در برنامه است. برخی از اشکال‌زداها هنگام استفاده از \fB\-g3\fR از گسترش ماکروها (macro expansion) پشتیبانی می‌کنند.
.Sp
اگر از چندین گزینهٔ \fB\-g\fR، همراه با شماره سطح یا بدون آن استفاده کنید، آخرین گزینه از این میان مؤثر خواهد بود.
.Sp
گزینهٔ \&\fB\-gdwarf\fR برای جلوگیری از سردرگمی با \fB\-gdwarf\-\fR\fIlevel\fR، سطح اشکال‌زدایی متصل را نمی‌پذیرد. در عوض از یک گزینهٔ اضافی \fB\-g\fR\fIlevel\fR برای تغییر سطح اشکال‌زدایی برای DWARF استفاده کنید.
.IP \fB\-fno\-eliminate\-unused\-debug\-symbols\fR 4
.IX Item "-fno-eliminate-unused-debug-symbols"
به‌طور پیش‌فرض، برای نمادهایی (symbols) که عملاً استفاده نمی‌شوند هیچ اطلاعات اشکال‌زدایی تولید نمی‌شود. اگر می‌خواهید اطلاعات اشکال‌زدایی برای همهٔ نمادها تولید شود، از این گزینه استفاده کنید.
.IP \fB\-femit\-class\-debug\-always\fR 4
.IX Item "-femit-class-debug-always"
به جای صدور اطلاعات اشکال‌زدایی برای یک کلاس C++ تنها در یک فایل هدف (object file)، آن را در تمام فایل‌های هدفی که از کلاس استفاده می‌کنند صادر می‌کند. این گزینه فقط باید با اشکال‌زداهایی استفاده شود که قادر به مدیریت روش معمول GCC در صدور اطلاعات اشکال‌زدایی برای کلاس‌ها نیستند، زیرا استفاده از این گزینه اندازهٔ اطلاعات اشکال‌زدایی را تا دو برابر افزایش می‌دهد.
.IP \fB\-fno\-merge\-debug\-strings\fR 4
.IX Item "-fno-merge-debug-strings"
به پیونددهنده هدایت می‌دهد که رشته‌های یکسان در اطلاعات اشکال‌زدایی فایل‌های هدف مختلف را با یکدیگر ادغام نکند. ادغام توسط همهٔ اسمبلرها یا پیونددهنده‌ها پشتیبانی نمی‌شود. ادغام حجم اطلاعات اشکال‌زدایی در فایل خروجی را به قیمت افزایش زمان پردازش پیوند کاهش می‌دهد. ادغام به‌طور پیش‌فرض فعال است.
.IP \fB\-fdebug\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR 4
.IX Item "-fdebug-prefix-map=old=new"
هنگام کامپایل فایل‌های مستقر در پوشهٔ \fIold\fR، اطلاعات اشکال‌زدایی را طوری ثبت می‌کند که گویی فایل‌ها در پوشهٔ \fInew\fR قرار دارند. این گزینه می‌تواند برای جایگزینی مسیر زمان ساخت با مسیر زمان نصب در اطلاعات اشکال‌زدایی استفاده شود. همچنین می‌توان با استفاده از \&\fI.\fR برای \fInew\fR، یک مسیر مطلق را به یک مسیر نسبی تغییر داد. این کار می‌تواند ساخت‌های بازتولیدپذیرتری (reproducible builds) ارائه دهد که مستقل از مکان هستند، اما ممکن است نیاز به یک دستور اضافی برای اطلاع به GDB جهت یافتن فایل‌های منبع داشته باشد. همچنین گزینه‌های \fB\-ffile\-prefix\-map\fR و \fB\-fcanon\-prefix\-map\fR را ببینید.
.IP \fB\-fvar\-tracking\fR 4
.IX Item "-fvar-tracking"
گذرگاه رهگیری متغیرها (variable tracking pass) را اجرا می‌کند. این گذرگاه محاسبه می‌کند که متغیرها در هر موقعیت از کد کجا ذخیره شده‌اند. سپس اطلاعات اشکال‌زدایی بهتری تولید می‌شود (در صورتی که قالب اطلاعات اشکال‌زدایی از این اطلاعات پشتیبانی کند).
.Sp
این گزینه به‌طور پیش‌فرض هنگام کامپایل با بهینه‌سازی (\fB\-Os\fR، \&\fB\-O\fR، \fB\-O2\fR، ...) و اطلاعات اشکال‌زدایی (\fB\-g\fR) فعال است، مشروط بر اینکه قالب اطلاعات اشکال‌زدایی از آن پشتیبانی کند.
.IP \fB\-fvar\-tracking\-assignments\fR 4
.IX Item "-fvar-tracking-assignments"
انتساب‌ها به متغیرهای کاربر را در اوایل فرایند کامپایل حاشیه‌نویسی (annotate) می‌کند و تلاش می‌کند این یادداشت‌ها را در سرتاسر فرایند کامپایل تا انتها حفظ کند تا اطلاعات اشکال‌زدایی در حین بهینه‌سازی بهبود یابند. استفاده از \fB\-gdwarf\-4\fR همراه با آن توصیه می‌شود.
.Sp
این گزینه حتی در صورت غیرفعال بودن var\-tracking نیز می‌تواند فعال شود، که در این حالت حاشیه‌نویسی‌ها ایجاد و نگهداری می‌شوند اما در پایان دور انداخته می‌شوند. به‌طور پیش‌فرض، این پرچم همراه با \fB\-fvar\-tracking\fR فعال است، به جز زمانی که selective scheduling فعال باشد.
.IP \fB\-fvar\-tracking\-uninit\fR 4
.IX Item "-fvar-tracking-uninit"
.PD 0
.IP \fB\-fno\-var\-tracking\-uninit\fR 4
.IX Item "-fno-var-tracking-uninit"
.PD
رهگیری متغیرها را انجام می‌دهد و همچنین متغیرهای مقداردهی‌نشده را در اطلاعات اشکال‌زدایی علامت‌گذاری می‌کند.
این پرچم به‌طور پیش‌فرض توسط \fB\-fvar\-tracking\fR فعال می‌شود؛ همچنین به معنای فعال‌سازی ضمنی \fB\-fvar\-tracking\fR نیز هست.
برای انجام رهگیری متغیرها بدون علامت‌گذاری متغیرهای مقداردهی‌نشده، از \&\fB\-fvar\-tracking\fR \fB\-fno\-var\-tracking\-uninit\fR استفاده کنید.
.IP \fB\-gsplit\-dwarf\fR 4
.IX Item "-gsplit-dwarf"
اگر اطلاعات اشکال‌زدایی DWARF فعال باشد، تا حد امکان اطلاعات اشکال‌زدایی را به یک فایل خروجی جداگانه با پسوند \&\fI.dwo\fR تفکیک می‌کند. این گزینه به سیستم ساخت اجازه می‌دهد از پیوند دادن فایل‌ها با اطلاعات اشکال‌زدایی اجتناب کند. برای سودمند بودن، این گزینه نیازمند اشکال‌زدایی است که توانایی خواندن فایل‌های \fI.dwo\fR را داشته باشد.
.IP \fB\-gdwarf32\fR 4
.IX Item "-gdwarf32"
.PD 0
.IP \fB\-gdwarf64\fR 4
.IX Item "-gdwarf64"
.PD
اگر اطلاعات اشکال‌زدایی DWARF فعال باشد، گزینهٔ \fB\-gdwarf32\fR قالب ۳۲ بیتی DWARF و گزینهٔ \fB\-gdwarf64\fR قالب ۶۴ بیتی DWARF را انتخاب می‌کند. پیش‌فرض وابسته به معماری مقصد (target) است، هرچند در بیشتر مقصدها \&\fB\-gdwarf32\fR است. قالب ۳۲ بیتی DWARF کم‌حجم‌تر است، اما نمی‌تواند بیش از ۲ گیبی‌بایت اطلاعات اشکال‌زدایی را در هر یک از بخش‌های اطلاعات اشکال‌زدایی DWARF پشتیبانی کند. قالب ۶۴ بیتی DWARF اطلاعات اشکال‌زدایی بزرگ‌تری را ممکن می‌سازد و ممکن است هنوز به خوبی توسط همهٔ مصرف‌کنندگان پشتیبانی نشود.
.IP \fB\-gdescribe\-dies\fR 4
.IX Item "-gdescribe-dies"
صفت‌های توصیفی را به برخی از DIEهای DWARF که صفت نام ندارند اضافه می‌کند، مانند متغیرهای مصنوعی (artificial variables)، ارجاع‌های خارجی و DIEهای پارامتر نقطهٔ فراخوانی (call site).
.IP \fB\-gpubnames\fR 4
.IX Item "-gpubnames"
بخش‌های \f(CW\*(C`.debug_pubnames\*(C'\fR و \f(CW\*(C`.debug_pubtypes\*(C'\fR مربوط به DWARF را تولید می‌کند.
.IP \fB\-ggnu\-pubnames\fR 4
.IX Item "-ggnu-pubnames"
بخش‌های \f(CW\*(C`.debug_pubnames\*(C'\fR و \f(CW\*(C`.debug_pubtypes\*(C'\fR را در قالبی مناسب برای تبدیل به نمایهٔ GDB (index) تولید می‌کند. این گزینه تنها با پیونددهنده‌ای مفید است که بتواند نسخهٔ ۷ نمایهٔ GDB را تولید کند.
.IP \fB\-gno\-pubnames\fR 4
.IX Item "-gno-pubnames"
بخش‌های \f(CW\*(C`.debug_pubnames\*(C'\fR و \f(CW\*(C`.debug_pubtypes\*(C'\fR مربوط به DWARF را تولید نمی‌کند.
.IP \fB\-fdebug\-types\-section\fR 4
.IX Item "-fdebug-types-section"
هنگام استفاده از DWARF نسخهٔ ۴ یا بالاتر، DIEهای نوع می‌توانند به جای اینکه بخشی از بخش \&\f(CW\*(C`.debug_info\*(C'\fR باشند، در بخش اختصاصی خود به نام \f(CW\*(C`.debug_types\*(C'\fR قرار گیرند. قرار دادن آن‌ها در یک بخش مجزای comdat کارآمدتر است زیرا پیونددهنده می‌تواند موارد تکراری را حذف کند. اما همهٔ مصرف‌کنندگان DWARF هنوز از بخش‌های \f(CW\*(C`.debug_types\*(C'\fR پشتیبانی نمی‌کنند و در برخی شیءها، \f(CW\*(C`.debug_types\*(C'\fR به جای کوچک‌تر کردن، اطلاعات اشکال‌زدایی بزرگ‌تری تولید می‌کند.
.IP \fB\-grecord\-gcc\-switches\fR 4
.IX Item "-grecord-gcc-switches"
.PD 0
.IP \fB\-gno\-record\-gcc\-switches\fR 4
.IX Item "-gno-record-gcc-switches"
.PD
این سوئیچ باعث می‌شود گزینه‌های خط فرمانی که برای فراخوانی کامپایلر استفاده شده‌اند و ممکن است بر تولید کد تأثیر بگذارند، به صفت DW_AT_producer در اطلاعات اشکال‌زدایی DWARF پیوست شوند. گزینه‌ها با فاصله از یکدیگر و از نسخهٔ کامپایلر جدا شده و متصل می‌گردند.
این گزینه به‌طور پیش‌فرض فعال است.
همچنین \fB\-frecord\-gcc\-switches\fR را برای روش دیگری از ذخیره‌سازی گزینه‌های کامپایلر در فایل هدف ببینید.
.IP \fB\-gstrict\-dwarf\fR 4
.IX Item "-gstrict-dwarf"
استفاده از افزونه‌های نسخه‌های بعدی استاندارد DWARF نسبت به نسخهٔ انتخاب‌شده با \fB\-gdwarf\-\fR\fIversion\fR را غیرمجاز می‌کند. در بیشتر مقصدها، استفاده از افزونه‌های غیرمتعارض DWARF از نسخه‌های بعدی استاندارد مجاز است.
.IP \fB\-gno\-strict\-dwarf\fR 4
.IX Item "-gno-strict-dwarf"
اجازهٔ استفاده از افزونه‌های نسخه‌های بعدی استاندارد DWARF نسبت به نسخهٔ انتخاب‌شده با \&\fB\-gdwarf\-\fR\fIversion\fR را می‌دهد.
.IP \fB\-gas\-loc\-support\fR 4
.IX Item "-gas-loc-support"
به کامپایلر اطلاع می‌دهد که اسمبلر از دستورالعمل‌های \f(CW\*(C`.loc\*(C'\fR پشتیبانی می‌کند. سپس کامپایلر می‌تواند از آن‌ها استفاده کند تا اسمبلر جدول‌های شماره سطر DWARF2+ را تولید کند.
.Sp
این کار معمولاً مطلوب است، زیرا جدول‌های شماره سطر تولیدشده توسط اسمبلر بسیار فشرده‌تر از جدول‌هایی هستند که خود کامپایلر می‌تواند تولید کند.
.Sp
این گزینه به‌طور پیش‌فرض فعال است اگر در زمان پیکربندی GCC مشخص شود که اسمبلر از چنین دستورالعمل‌هایی پشتیبانی می‌کند..IP \fB\-gno\-as\-loc\-support\fR 4
.IX Item "-gno-as-loc-support"
مجبور کردن GCC به تولید داخلی جدول‌های شماره خط DWARF2+، چنانچه قرار باشد جدول‌های شماره خط DWARF2+ تولید شوند.
.IP \fB\-gas\-locview\-support\fR 4
.IX Item "-gas-locview-support"
به کامپایلر اطلاع می‌دهد که اسمبلر از انتساب \f(CW\*(C`view\*(C'\fR و بازنشانی بررسی ادعا (assertion checking) در دستورالعمل‌های \f(CW\*(C`.loc\*(C'\fR پشتیبانی می‌کند.
.Sp
این گزینه به طور پیش‌فرض فعال است اگر در زمان پیکربندی GCC مشخص شود که اسمبلر از آن‌ها پشتیبانی می‌کند.
.IP \fB\-gno\-as\-locview\-support\fR 4
.IX Item "-gno-as-locview-support"
مجبور کردن GCC به انتساب داخلی شماره‌های view، در صورتی که \&\fB\-gvariable\-location\-views\fR صراحتاً درخواست شده باشد.
.IP \fB\-gcolumn\-info\fR 4
.IX Item "-gcolumn-info"
.PD 0
.IP \fB\-gno\-column\-info\fR 4
.IX Item "-gno-column-info"
.PD
اطلاعات ستون موقعیت را به جای صرفاً فایل و خط، در اطلاعات اشکال‌زدایی DWARF درج می‌کند.
این گزینه به طور پیش‌فرض فعال است.
.IP \fB\-gstatement\-frontiers\fR 4
.IX Item "-gstatement-frontiers"
.PD 0
.IP \fB\-gno\-statement\-frontiers\fR 4
.IX Item "-gno-statement-frontiers"
.PD
این گزینه باعث می‌شود GCC در بازنمود داخلی خود نشانگرهایی در ابتدای دستورها ایجاد کند و آن‌ها را در طول فرایند کامپایل تقریباً در جای خود نگه دارد، تا از آن‌ها برای هدایت خروجی نشانگرهای \f(CW\*(C`is_stmt\*(C'\fR در جدول شماره خط استفاده کند. این گزینه هنگام کامپایل با بهینه‌سازی (\fB\-Os\fR، \fB\-O1\fR، \fB\-O2\fR و \&...) و تولید اطلاعات اشکال‌زدایی DWARF 2 در سطح عادی، به طور پیش‌فرض فعال است.
.IP \fB\-gvariable\-location\-views\fR 4
.IX Item "-gvariable-location-views"
.PD 0
.IP \fB\-gvariable\-location\-views=incompat5\fR 4
.IX Item "-gvariable-location-views=incompat5"
.IP \fB\-gno\-variable\-location\-views\fR 4
.IX Item "-gno-variable-location-views"
.PD
فهرست‌های موقعیت متغیر را با شماره‌های view فزاینده که از جدول شماره خط استنباط می‌شوند تکمیل می‌کند. این کار به مصرف‌کنندگان اطلاعات اشکال‌زدایی امکان می‌دهد تا وضعیت را در نقاط خاصی از برنامه بررسی کنند، حتی اگر هیچ دستورالعمل مرتبط با موقعیت‌های کد مبدأ مربوطه در آن نقطه وجود نداشته باشد. اگر اسمبلر فاقد پشتیبانی از شماره‌های view در جدول‌های شماره خط باشد، این امر موجب می‌شود کامپایلر جدول شماره خط را خود صادر کند، که معمولاً فشردگی آن‌ها را تا حدی کاهش می‌دهد. جدول‌های شماره خط و فهرست‌های موقعیت تکمیل‌شده کاملاً سازگار با گذشته هستند، بنابراین مصرف‌کنندگان اطلاعات اشکال‌زدایی که از این افزونه‌ها آگاه نیستند نیز می‌توانند آن‌ها را بخوانند، هرچند بهره‌ای هم از آن‌ها نخواهند برد.
.Sp
این گزینه به طور پیش‌فرض هنگام تولید اطلاعات اشکال‌زدایی DWARF 2 در سطح عادی فعال است، مادامی که پشتیبانی اسمبلر وجود داشته باشد، \&\fB\-fvar\-tracking\-assignments\fR فعال باشد و \&\fB\-gstrict\-dwarf\fR فعال نباشد. هنگامی که پشتیبانی اسمبلر در دسترس نباشد، این گزینه ممکن است همچنان فعال شود، اما GCC را مجبور به صدور جدول‌های شماره خط داخلی می‌کند، و اگر \&\fB\-ginternal\-reset\-location\-views\fR فعال نباشد، این امر به احتمال بسیار قوی به عدم تطابق بی‌سروصدای نماهای موقعیت منجر خواهد شد.
.Sp
یک بازنمود پیشنهادی برای شماره‌های view وجود دارد که با قالب فهرست موقعیت معرفی‌شده در DWARF 5 سازگار با گذشته نیست؛ این بازنمود را می‌توان با \fB\-gvariable\-location\-views=incompat5\fR فعال کرد. این گزینه ممکن است در آینده حذف شود و صرفاً به عنوان یک پیاده‌سازی مرجع از بازنمود پیشنهادی ارائه شده است. انتظار نمی‌رود مصرف‌کنندگان اطلاعات اشکال‌زدایی از این قالب گسترش‌یافته پشتیبانی کنند و آن‌ها از رمزگشایی فهرست‌های موقعیتی که از آن استفاده می‌کنند ناتوان خواهند بود.
.IP \fB\-ginternal\-reset\-location\-views\fR 4
.IX Item "-ginternal-reset-location-views"
.PD 0
.IP \fB\-gno\-internal\-reset\-location\-views\fR 4
.IX Item "-gno-internal-reset-location-views"
.PD
تلاش برای تعیین نماهای موقعیتی که می‌توان آن‌ها را از فهرست‌های نمای موقعیت حذف کرد. این کار مستلزم آن است که کامپایلر تخمین‌های بسیار دقیقی از طول دستورالعمل‌ها داشته باشد که همیشه این‌طور نیست، و ممکن است هنگام استفاده از اسمبلری که از فهرست‌های نمای موقعیت پشتیبانی نمی‌کند، باعث تولید خاموش فهرست‌های نمای نادرست شود. اسمبلر گنو هرگونه خطایی از این دست را با برچسب \f(CW\*(C`view number mismatch\*(C'\fR مشخص می‌کند. این گزینه فقط در پورت‌هایی فعال است که یک تابع تخمین قابل اعتماد تعریف کرده باشند.
.IP \fB\-ginline\-points\fR 4
.IX Item "-ginline-points"
.PD 0
.IP \fB\-gno\-inline\-points\fR 4
.IX Item "-gno-inline-points"
.PD
اطلاعات اشکال‌زدایی گسترش‌یافته را برای توابع درون‌خطی‌شده تولید می‌کند. نشانگرهای ردیابی نمای موقعیت در نقاط ورود درون‌خطی درج می‌شوند تا بتوان آدرس و شماره‌های view را محاسبه کرده و در اطلاعات اشکال‌زدایی خروجی داد. این قابلیت را می‌توان مستقل از نماهای موقعیت فعال کرد که در این صورت شماره‌های view در خروجی قرار نخواهند گرفت، اما تنها همراه با مرزهای دستور (statement frontiers) قابل فعال‌سازی است و به طور پیش‌فرض تنها در صورتی فعال می‌شود که نماهای موقعیت فعال باشند.
.IP \fB\-gz\fR[\fB=\fR\fItype\fR] 4
.IX Item "-gz[=type]"
تولید بخش‌های اشکال‌زدایی فشرده در قالب DWARF، در صورت پشتیبانی شدن. اگر \fItype\fR مشخص نشود، نوع پیش‌فرض به قابلیت‌های اسمبلر و پیونددهنده مورد استفاده بستگی دارد. \fItype\fR می‌تواند یکی از مقادیر \&\fBnone\fR (بخش‌های اشکال‌زدایی فشرده نشوند)، \fBzlib\fR (استفاده از فشرده‌سازی zlib در قالب ELF gABI) یا \fBzstd\fR (استفاده از فشرده‌سازی zstd در قالب ELF gABI) باشد. اگر پیونددهنده از نوشتن بخش‌های اشکال‌زدایی فشرده پشتیبانی نکند، گزینه رد می‌شود. در غیر این صورت، چنانچه اسمبلر از آن‌ها پشتیبانی نکند، \fB\-gz\fR هنگام تولید فایل‌های شیء بدون هشدار نادیده گرفته می‌شود.
.IP \fB\-femit\-struct\-debug\-baseonly\fR 4
.IX Item "-femit-struct-debug-baseonly"
اطلاعات اشکال‌زدایی را برای انواع ساختارمانند تنها زمانی صادر می‌کند که نام پایه فایل منبع کامپایل با نام پایه فایلی که ساختار در آن تعریف شده است مطابقت داشته باشد.
.Sp
این گزینه اندازه اطلاعات اشکال‌زدایی را به میزان قابل توجهی کاهش می‌دهد، اما با احتمال از دست رفتن چشمگیر اطلاعات نوع برای دیباگر همراه است. برای گزینه‌ای با شدت کمتر، به \fB\-femit\-struct\-debug\-reduced\fR مراجعه کنید. برای کنترل دقیق‌تر، به \fB\-femit\-struct\-debug\-detailed\fR مراجعه کنید.
.Sp
این گزینه تنها با خروجی اشکال‌زدایی DWARF کار می‌کند.
.IP \fB\-femit\-struct\-debug\-reduced\fR 4
.IX Item "-femit-struct-debug-reduced"
اطلاعات اشکال‌زدایی را برای انواع ساختارمانند تنها زمانی صادر می‌کند که نام پایه فایل منبع کامپایل با نام پایه فایلی که نوع در آن تعریف شده است مطابقت داشته باشد، مگر اینکه ساختار یک قالب (template) باشد یا در یک سرایند سیستمی تعریف شده باشد.
.Sp
این گزینه اندازه اطلاعات اشکال‌زدایی را به طور چشمگیری کاهش می‌دهد، همراه با مقداری احتمال از دست رفتن اطلاعات نوع برای دیباگر. برای گزینه‌ای با شدت بیشتر، به \fB\-femit\-struct\-debug\-baseonly\fR مراجعه کنید. برای کنترل دقیق‌تر، به \fB\-femit\-struct\-debug\-detailed\fR مراجعه کنید.
.Sp
این گزینه تنها با خروجی اشکال‌زدایی DWARF کار می‌کند.
.IP \fB\-femit\-struct\-debug\-detailed\fR[\fB=\fR\fIspec\-list\fR] 4
.IX Item "-femit-struct-debug-detailed[=spec-list]"
مشخص کردن انواع ساختارمانندی که کامپایلر برای آن‌ها اطلاعات اشکال‌زدایی تولید می‌کند. هدف، کاهش اطلاعات اشکال‌زدایی تکراری ساختارها میان فایل‌های شیء مختلف در همان برنامه است.
.Sp
این گزینه نسخه با جزئیات بیشتر از \&\fB\-femit\-struct\-debug\-reduced\fR و \fB\-femit\-struct\-debug\-baseonly\fR است که پاسخگوی بیشتر نیازهاست.
.Sp
یک مشخصه دارای نحو [\fBdir:\fR|\fBind:\fR][\fBord:\fR|\fBgen:\fR](\fBany\fR|\fBsys\fR|\fBbase\fR|\fBnone\fR) است.
.Sp
کلمه اختیاری نخست، مشخصات را به ساختارهایی محدود می‌کند که مستقیماً استفاده شده‌اند (\fBdir:\fR) یا به طور غیرمستقیم استفاده شده‌اند (\fBind:\fR). یک نوع ساختار زمانی به طور مستقیم استفاده می‌شود که نوع یک متغیر یا عضو باشد. کاربردهای غیرمستقیم از طریق اشاره‌گرها به ساختارها حاصل می‌شوند. یعنی هنگامی که استفاده از یک ساختار ناقص معتبر باشد، آن استفاده غیرمستقیم است. به عنوان مثال:
\&\fBstruct one direct; struct two * indirect;\fR.
.Sp
کلمه اختیاری دوم، مشخصات را به ساختارهای معمولی (\fBord:\fR) یا ساختارهای جنریک (\fBgen:\fR) محدود می‌کند. توضیح ساختارهای جنریک کمی پیچیده است. برای ++C، این‌ها تخصیص‌های غیرصریح از کلاس‌های قالب یا کلاس‌های غیرقالب درون موارد بالا هستند. زبان‌های برنامه‌نویسی دیگر دارای generics هستند، اما \fB\-femit\-struct\-debug\-detailed\fR هنوز آن‌ها را پیاده‌سازی نکرده است.
.Sp
کلمه سوم، فایل‌های منبع را برای آن دسته از ساختارهایی تعیین می‌کند که کامپایلر باید اطلاعات اشکال‌زدایی‌شان را صادر کند. مقادیر \fBnone\fR و \fBany\fR معنای معمول را دارند. مقدار \fBbase\fR به این معنی است که نام پایه فایلی که اعلان نوع در آن ظاهر می‌شود باید با نام پایه فایل اصلی کامپایل مطابقت داشته باشد. در عمل، این بدان معناست که هنگام کامپایل \fIfoo.c\fR، اطلاعات اشکال‌زدایی برای انواع اعلان‌شده در آن فایل و \fIfoo.h\fR تولید می‌شود، اما برای سایر فایل‌های سرایند تولید نمی‌گردد. مقدار \fBsys\fR به معنای انواعی است که شرایط \fBbase\fR را برآورده می‌کنند یا در سرایندهای سیستمی یا کامپایلر اعلان شده‌اند.
.Sp
ممکن است برای تعیین بهترین تنظیمات برای برنامه خود نیاز به آزمون و آزمایش داشته باشید.
.Sp
مقدار پیش‌فرض \fB\-femit\-struct\-debug\-detailed=all\fR است.
.Sp
این گزینه تنها با خروجی اشکال‌زدایی DWARF کار می‌کند.
.IP \fB\-fno\-dwarf2\-cfi\-asm\fR 4
.IX Item "-fno-dwarf2-cfi-asm"
صادر کردن اطلاعات unwind مربوط به DWARF به عنوان بخش \f(CW\*(C`.eh_frame\*(C'\fR تولیدشده توسط کامپایلر به جای استفاده از دستورالعمل‌های \f(CW\*(C`.cfi_*\*(C'\fR در GAS..IP \fB\-fno\-eliminate\-unused\-debug\-types\fR 4
.IX Item "-fno-eliminate-unused-debug-types"
به‌طور معمول، هنگام تولید خروجی DWARF، کامپایلر GCC از تولید نمادهای اشکال‌زدایی برای نوع‌هایی که در هیچ کجای فایل منبعِ در حال کامپایل استفاده نشده‌اند، خودداری می‌کند. گاهی اوقات مفید است که GCC اطلاعات اشکال‌زدایی را برای تمام انواع اعلان‌شده در یک واحد ترجمه (compilation unit) صادر کند، فارغ از اینکه در عمل در آن واحد استفاده شده باشند یا خیر؛ برای نمونه زمانی که در اشکال‌زدا (debugger) بخواهید مقداری را به نوعی که عملاً در برنامه‌تان استفاده نشده (اما اعلان شده است) تبدیل نوع (cast) کنید. با این حال، در اغلب موارد این کار باعث هدر رفتن حجم قابل توجهی از فضا می‌شود.
.SS "گزینه‌های کنترل بهینه‌سازی (Options That Control Optimization)"
.IX Subsection "Options That Control Optimization"
این گزینه‌ها انواع مختلفی از بهینه‌سازی‌ها را کنترل می‌کنند.
.PP
بدون تعیین هیچ گزینه بهینه‌سازی، هدف کامپایلر کاهش هزینه و زمان کامپایل و فراهم کردن شرایطی است که اشکال‌زدایی نتایج مورد انتظار را حاصل کند. در این حالت دستورها مستقل هستند: اگر برنامه را با یک نقطه توقف (breakpoint) بین دستورها متوقف کنید، می‌توانید مقداری جدید به هر متغیری نسبت دهید یا شمارنده برنامه (program counter) را به هر دستور دیگری در تابع هدایت کنید و دقیقاً همان نتایجی را بگیرید که از کد منبع انتظار دارید.
.PP
فعال کردن پرچم‌های بهینه‌سازی باعث می‌شود کامپایلر تلاش کند تا کارایی و/یا اندازه کد را به بهای افزایش زمان کامپایل و احتمالاً کاهش توانایی اشکال‌زدایی برنامه بهبود بخشد.
.PP
کامپایلر بهینه‌سازی را بر پایه شناختی که از برنامه دارد انجام می‌دهد. کامپایل چندین فایل به‌طور هم‌زمان در قالب یک فایل خروجی واحد به کامپایلر اجازه می‌دهد تا هنگام کامپایل هر کدام از فایل‌ها، از اطلاعات به‌دست‌آمده از تمامی فایل‌ها استفاده کند.
.PP
همه بهینه‌سازی‌ها مستقیماً با یک پرچم کنترل نمی‌شوند. در این بخش فقط بهینه‌سازی‌هایی فهرست شده‌اند که دارای پرچم اختصاصی هستند.
.PP
بیشتر بهینه‌سازی‌ها در سطح \fB\-O0\fR یا در صورتی که سطح \&\fB\-O\fR در خط فرمان مشخص نشده باشد، کاملاً غیرفعال می‌شوند؛ حتی اگر پرچم‌های بهینه‌سازی منفرد به‌طور جداگانه تعیین شده باشند. به‌طور مشابه، \fB\-Og\fR نیز بسیاری از مراحل (passes) بهینه‌سازی را متوقف می‌کند.
.PP
بسته به معماری مقصد و نحوه پیکربندی GCC، ممکن است در هر سطح \fB\-O\fR مجموعه‌ای کمی متفاوت از بهینه‌سازی‌ها نسبت به موارد ذکر شده در اینجا فعال شود. می‌توانید GCC را با دستور \fB\-Q \-\-help=optimizers\fR اجرا کنید تا از مجموعه دقیق بهینه‌سازی‌های فعال در هر سطح مطلع شوید.
.IP \fB\-O\fR 4
.IX Item "-O"
.PD 0
.IP \fB\-O1\fR 4
.IX Item "-O1"
.IP \fB\-\-optimize\fR 4
.IX Item "--optimize"
.PD
بهینه‌سازی. کامپایل با بهینه‌سازی زمان بیشتری می‌برد و برای توابع بزرگ، حافظه بسیار بیشتری مصرف می‌کند.
.Sp
با گزینه \fB\-O\fR، کامپایلر تلاش می‌کند تا اندازه کد و زمان اجرا را بدون اجرای بهینه‌سازی‌هایی که زمان کامپایل بالایی می‌طلبند، کاهش دهد.
.Sp
گزینه \&\fB\-O\fR سطح بهینه‌سازی توصیه‌شده برای کدهای بزرگِ تولیدشده توسط ماشین است، چرا که تعادلی معقول میان زمان صرف‌شده برای کامپایل و مصرف حافظه برقرار می‌کند: سطوح بالاتر بهینه‌سازی، عملیات را با پیچیدگی الگوریتمی بیشتری نسبت به \fB\-O\fR انجام می‌دهند.
.Sp
گزینه \&\fB\-O\fR پرچم‌های بهینه‌سازی زیر را فعال می‌کند:
.Sp
\&\fB\-fauto\-inc\-dec
\&\-fbranch\-count\-reg
\&\-fcombine\-stack\-adjustments
\&\-fcompare\-elim
\&\-fcprop\-registers
\&\-fdce
\&\-fdefer\-pop
\&\-fdelayed\-branch
\&\-fdse
\&\-fforward\-propagate
\&\-fguess\-branch\-probability
\&\-fif\-conversion
\&\-fif\-conversion2
\&\-finline\-functions\-called\-once
\&\-fipa\-modref
\&\-fipa\-profile
\&\-fipa\-pure\-const
\&\-fipa\-reference
\&\-fipa\-reference\-addressable
\&\-fivopts
\&\-fmerge\-constants
\&\-fmove\-loop\-invariants
\&\-fmove\-loop\-stores
\&\-fomit\-frame\-pointer
\&\-freorder\-blocks
\&\-fshrink\-wrap
\&\-fshrink\-wrap\-separate
\&\-fsplit\-wide\-types
\&\-fssa\-backprop
\&\-fssa\-phiopt
\&\-ftree\-bit\-ccp
\&\-ftree\-ccp
\&\-ftree\-ch
\&\-ftree\-coalesce\-vars
\&\-ftree\-copy\-prop
\&\-ftree\-dce
\&\-ftree\-dominator\-opts
\&\-ftree\-dse
\&\-ftree\-forwprop
\&\-ftree\-fre
\&\-ftree\-phiprop
\&\-ftree\-pta
\&\-ftree\-scev\-cprop
\&\-ftree\-sink
\&\-ftree\-slsr
\&\-ftree\-sra
\&\-ftree\-ter
\&\-funit\-at\-a\-time\fR
.IP \fB\-O2\fR 4
.IX Item "-O2"
بهینه‌سازی حتی بیشتر. کامپایلر GCC تقریباً تمامی بهینه‌سازی‌های پشتیبانی‌شده را که مستلزم مصالحه میان فضا و سرعت نیستند، انجام می‌دهد. در مقایسه با \fB\-O\fR، این گزینه هم زمان کامپایل و هم کارایی کد تولیدشده را افزایش می‌دهد.
.Sp
گزینه \&\fB\-O2\fR تمامی پرچم‌های بهینه‌سازی تعیین‌شده توسط \fB\-O1\fR را روشن می‌کند. این گزینه همچنین پرچم‌های بهینه‌سازی زیر را نیز فعال می‌سازد:
.Sp
\&\fB\-falign\-functions  \-falign\-jumps
\&\-falign\-labels  \-falign\-loops
\&\-fcaller\-saves
\&\-fcode\-hoisting
\&\-fcrossjumping
\&\-fcse\-follow\-jumps  \-fcse\-skip\-blocks
\&\-fdelete\-null\-pointer\-checks \-fdep\-fusion
\&\-fdevirtualize  \-fdevirtualize\-speculatively
\&\-fexpensive\-optimizations
\&\-ffinite\-loops
\&\-fgcse  \-fgcse\-lm
\&\-fhoist\-adjacent\-loads
\&\-finline\-functions
\&\-finline\-small\-functions
\&\-findirect\-inlining
\&\-fipa\-bit\-cp  \-fipa\-cp  \-fipa\-icf
\&\-fipa\-ra  \-fipa\-sra  \-fipa\-vrp
\&\-fisolate\-erroneous\-paths\-dereference
\&\-flra\-remat
\&\-foptimize\-crc
\&\-foptimize\-sibling\-calls
\&\-foptimize\-strlen
\&\-fpartial\-inlining
\&\-fpeephole2
\&\-freorder\-blocks\-algorithm=stc
\&\-freorder\-blocks\-and\-partition  \-freorder\-functions
\&\-frerun\-cse\-after\-loop
\&\-fschedule\-insns  \-fschedule\-insns2
\&\-fsched\-interblock  \-fsched\-spec
\&\-fspeculatively\-call\-stored\-functions
\&\-fstore\-merging
\&\-fstrict\-aliasing
\&\-fthread\-jumps
\&\-ftree\-builtin\-call\-dce
\&\-ftree\-loop\-vectorize
\&\-ftree\-pre
\&\-ftree\-slp\-vectorize
\&\-ftree\-switch\-conversion  \-ftree\-tail\-merge
\&\-ftree\-vrp
\&\-fvect\-cost\-model=very\-cheap\fR
.Sp
لطفاً به هشدار ذیل \fB\-fgcse\fR در رابطه با اجرای \fB\-O2\fR برای برنامه‌هایی که از دستورهای پرش محاسبه‌شده (computed gotos) استفاده می‌کنند، توجه داشته باشید.
.IP \fB\-O3\fR 4
.IX Item "-O3"
بهینه‌سازی باز هم بیشتر. گزینه \fB\-O3\fR تمام بهینه‌سازی‌های مشخص‌شده توسط \fB\-O2\fR را روشن کرده و علاوه بر آن، پرچم‌های بهینه‌سازی زیر را نیز فعال می‌کند:
.Sp
\&\fB\-fgcse\-after\-reload
\&\-fipa\-cp\-clone
\&\-floop\-interchange
\&\-floop\-unroll\-and\-jam
\&\-fpeel\-loops
\&\-fpredictive\-commoning
\&\-fsplit\-loops
\&\-fsplit\-paths
\&\-ftree\-loop\-distribution
\&\-ftree\-partial\-pre
\&\-funswitch\-loops
\&\-fvect\-cost\-model=dynamic
\&\-fversion\-loops\-for\-strides\fR.IP \fB\-O0\fR 4
.IX Item "-O0"
کاهش زمان کامپایل و تولید نتایج مورد انتظار در خطایابی. این حالت پیش‌فرض است.
.Sp
در سطح \fB\-O0\fR، کامپایلر GCC بیشتر مراحل بهینه‌سازی را به‌طور کامل غیرفعال می‌کند؛ این مراحل حتی اگر صراحتاً در خط فرمان فعال شوند، یا توسط \fB\-Q \-\-help=optimizers\fR به‌عنوان گزینه‌های فعالِ پیش‌فرض فهرست شده باشند، اجرا نخواهند شد. بسیاری از بهینه‌سازی‌های انجام‌شده توسط GCC به مراحل تحلیل کد یا استانداردسازی وابسته هستند که با \fB\-O\fR فعال می‌شوند، و اجرای مجزای هر مرحله بهینه‌سازی به تنهایی مفید نخواهد بود.
.IP \fB\-Os\fR 4
.IX Item "-Os"
بهینه‌سازی برای اندازه کد. \fB\-Os\fR تمام بهینه‌سازی‌های \fB\-O2\fR را فعال می‌کند به جز مواردی که اغلب باعث افزایش اندازه کد می‌شوند:
.Sp
\&\fB\-falign\-functions  \-falign\-jumps
\&\-falign\-labels  \-falign\-loops
\&\-fprefetch\-loop\-arrays  \-freorder\-blocks\-algorithm=stc\fR
.Sp
این گزینه همچنین \fB\-finline\-functions\fR را فعال می‌کند، کامپایلر را وادار می‌سازد تا به‌جای سرعت اجرا برای اندازه کد تنظیم شود، و بهینه‌سازی‌های بیشتری را که برای کاهش حجم کد طراحی شده‌اند انجام می‌دهد.
.IP \fB\-Ofast\fR 4
.IX Item "-Ofast"
نادیده گرفتن انطباق دقیق با استانداردها. \fB\-Ofast\fR تمام بهینه‌سازی‌های \fB\-O3\fR را فعال می‌کند. همچنین بهینه‌سازی‌هایی را فعال می‌کند که برای همه برنامه‌های منطبق بر استاندارد معتبر نیستند.
این گزینه پرچم‌های \fB\-ffast\-math\fR، \fB\-fallow\-store\-data\-races\fR و پرچم ویژه Fortran یعنی \fB\-fstack\-arrays\fR (مگر اینکه \fB\-fmax\-stack\-var\-size\fR مشخص شده باشد) و همچنین \fB\-fno\-protect\-parens\fR را فعال می‌سازد.
این پرچم گزینه \fB\-fsemantic\-interposition\fR را غیرفعال می‌کند.
.IP \fB\-Og\fR 4
.IX Item "-Og"
بهینه‌سازی با در نظر داشتن تجربه خطایابی (دیباگ).
\&\fB\-Og\fR باید سطح بهینه‌سازی انتخابی برای چرخه استاندارد ویرایش\-کامپایل\-دیباگ باشد، که ترکیبی معقول از بهینه‌سازی، کامپایل سریع و تجربه خطایابی مناسب را به‌ویژه برای کدهایی با بار انتزاعی بالا ارائه می‌دهد. برخلاف \fB\-O0\fR، این گزینه \fB\-fvar\-tracking\-assignments\fR و \&\fB\-fvar\-tracking\fR را فعال می‌کند که اطلاعات خطایابی را در مقدمه (prologue) و مؤخره (epilogue) توابع بهتر از \fB\-O0\fR مدیریت می‌کنند.
.Sp
همانند \fB\-O0\fR، گزینه \fB\-Og\fR تعدادی از مراحل بهینه‌سازی را به‌طور کامل نادیده می‌گیرد تا گزینه‌های مجزای کنترل‌کننده آن‌ها هیچ تأثیری نداشته باشند. در غیر این صورت، \fB\-Og\fR تمام پرچم‌های بهینه‌سازی \fB\-O1\fR را به جز مواردی که تداخل زیادی با خطایابی دارند فعال می‌کند:
.Sp
\&\fB\-fbranch\-count\-reg  \-fdelayed\-branch
\&\-fdse  \-fif\-conversion  \-fif\-conversion2
\&\-finline\-functions\-called\-once
\&\-fmove\-loop\-invariants  \-fmove\-loop\-stores  \-fssa\-phiopt
\&\-ftree\-bit\-ccp  \-ftree\-dse  \-ftree\-pta  \-ftree\-sra\fR
.IP \fB\-Oz\fR 4
.IX Item "-Oz"
بهینه‌سازی تهاجمی برای اندازه به‌جای سرعت. این عمل در صورتی که دستورالعمل‌ها به بایت‌های کمتری برای کدگذاری نیاز داشته باشند، ممکن است تعداد دستورالعمل‌های اجراشده را افزایش دهد. \fB\-Oz\fR رفتاری مشابه با \fB\-Os\fR دارد، از جمله فعال‌سازی اکثر بهینه‌سازی‌های \fB\-O2\fR.
.PP
اگر از چندین گزینه \fB\-O\fR، همراه با شماره سطح یا بدون آن استفاده کنید، آخرین گزینه اثرگذار خواهد بود.
.PP
گزینه‌هایی به شکل \fB\-f\fR\fIflag\fR پرچم‌های مستقل از ماشین را مشخص می‌کنند. بیشتر پرچم‌ها دارای هر دو فرم مثبت و منفی هستند؛ فرم منفی \fB\-ffoo\fR به‌صورت \fB\-fno\-foo\fR است. در جدول زیر، تنها یکی از فرم‌ها فهرست شده است\-\-\-همان فرمی که معمولاً استفاده می‌کنید. می‌توانید فرم دیگر را با حذف یا افزودن \fBno\-\fR مشخص کنید.
.PP
گزینه‌های زیر بهینه‌سازی‌های خاصی را کنترل می‌کنند. آن‌ها یا توسط گزینه‌های \fB\-O\fR فعال می‌شوند یا مرتبط با گزینه‌های فعال‌شده هستند. در موارد نادری که «تنظیم دقیق» بهینه‌سازی‌های انجام‌شونده مورد نظر است، می‌توانید از پرچم‌های زیر استفاده کنید.
.IP \fB\-fno\-defer\-pop\fR 4
.IX Item "-fno-defer-pop"
برای ماشین‌هایی که باید آرگومان‌ها را پس از فراخوانی تابع از پشته بردارند (pop کنند)، همیشه به محض بازگشت هر تابع، آرگومان‌ها را بردارید.
در سطوح \fB\-O1\fR و بالاتر، \fB\-fdefer\-pop\fR حالت پیش‌فرض است؛ این ویژگی به کامپایلر اجازه می‌دهد تا آرگومان‌ها را برای چندین فراخوانی تابع روی پشته انباشته کند و همه آن‌ها را یک‌جا بردارد.
.IP \fB\-fforward\-propagate\fR 4
.IX Item "-fforward-propagate"
انجام یک مرحله انتشار رو به جلو روی RTL. این مرحله سعی می‌کند دو دستورالعمل را ترکیب کرده و بررسی کند که آیا نتیجه می‌تواند ساده‌تر شود یا خیر. اگر باز کردن حلقه فعال باشد، دو مرحله انجام می‌شود و مرحله دوم پس از باز کردن حلقه زمان‌بندی خواهد شد.
.Sp
این گزینه به‌طور پیش‌فرض در سطوح بهینه‌سازی \fB\-O1\fR، \&\fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-favoid\-store\-forwarding\fR 4
.IX Item "-favoid-store-forwarding"
.PD 0
.IP \fB\-fno\-avoid\-store\-forwarding\fR 4
.IX Item "-fno-avoid-store-forwarding"
.PD
بسیاری از CPUها هنگامی که یک بارگذاری (load) تا حدی به ذخیره‌سازی‌های (store) کوچکتری پیشین وابسته باشد، چرخه‌های متعددی متوقف می‌شوند (stall). این مرحله سعی می‌کند چنین مواردی را تشخیص داده و با تغییر ترتیب بارگذاری و ذخیره‌سازی و سپس اصلاح مقدار بارگذاری‌شده، از این جریمه زمانی جلوگیری کند.
.Sp
به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-ffp\-contract=\fR\fIstyle\fR 4
.IX Item "-ffp-contract=style"
\&\fB\-ffp\-contract=off\fR ادغام عبارات ممیز شناور را غیرفعال می‌کند.
\&\fB\-ffp\-contract=fast\fR ادغام عبارات ممیز شناور مانند ایجاد عملیات ضرب و جمع ادغام‌شده (fused multiply-add) را در صورتی که مقصد از آن‌ها پشتیبانی بومی داشته باشد، فعال می‌کند.
\&\fB\-ffp\-contract=on\fR ادغام عبارات ممیز شناور را در صورت مجاز بودن طبق استاندارد زبان فعال می‌کند. این قابلیت برای C و C++ پیاده‌سازی شده است که در آن، ادغام درون یک عبارت مجاز است، اما بین دستورهای مجزا مجاز نیست.
.Sp
پیش‌فرض برای C در حالت منطبق بر استاندارد (\fB\-std=c11\fR یا مشابه آن) \fB\-ffp\-contract=off\fR است، و در غیر این صورت \fB\-ffp\-contract=fast\fR خواهد بود.
.IP \fB\-ffp\-int\-builtin\-inexact\fR 4
.IX Item "-ffp-int-builtin-inexact"
به توابع داخلی \f(CW\*(C`ceil\*(C'\fR، \f(CW\*(C`floor\*(C'\fR، \&\f(CW\*(C`round\*(C'\fR و \f(CW\*(C`trunc\*(C'\fR، و انواع \f(CW\*(C`float\*(C'\fR و \f(CW\*(C`long double\*(C'\fR آن‌ها اجازه می‌دهد کدی تولید کنند که برای آرگومان‌های غیرصحیح، استثنای ممیز شناور «inexact» را فعال کند. استانداردهای ISO C99 و C11 به این توابع اجازه ایجاد استثنای «inexact» را می‌دهند، اما ISO/IEC TS 18661\-1:2014، اتصالات C به IEEE 754\-2008 همان‌گونه که در ISO C23 ادغام شده است، به این توابع چنین اجازه‌ای نمی‌دهد.
.Sp
حالت پیش‌فرض \fB\-fno\-fp\-int\-builtin\-inexact\fR است که ایجاد این استثنا را غیرمجاز می‌داند، مگر اینکه C17 یا استانداردی قدیمی‌تر از C انتخاب شده باشد. این گزینه هیچ اثری ندارد مگر اینکه \fB\-ftrapping\-math\fR فعال باشد.
.Sp
حتی اگر \fB\-fno\-fp\-int\-builtin\-inexact\fR استفاده شود، در صورتی که توابع یک فراخوانی کتابخانه‌ای ایجاد کنند و پیاده‌سازی کتابخانه از TS 18661 پیروی نکند، ممکن است استثنای «inexact» ایجاد شود.
.IP \fB\-fomit\-frame\-pointer\fR 4
.IX Item "-fomit-frame-pointer"
حذف اشاره‌گر فریم در توابعی که به آن نیازی ندارند. این کار از دستورالعمل‌های ذخیره، راه‌اندازی و بازیابی اشاره‌گر فریم جلوگیری می‌کند؛ در بسیاری از معماری‌های مقصد همچنین یک ثبات اضافی را در دسترس قرار می‌دهد.
.Sp
در برخی از معماری‌های مقصد این پرچم تأثیری ندارد زیرا توالی فراخوانی استاندارد همیشه از یک اشاره‌گر فریم استفاده می‌کند، بنابراین نمی‌توان آن را حذف کرد.
.Sp
توجه داشته باشید که \fB\-fno\-omit\-frame\-pointer\fR تضمین نمی‌کند اشاره‌گر فریم در همه توابع استفاده شود. چندین معماری مقصد همیشه اشاره‌گر فریم را در توابع برگ (leaf functions) حذف می‌کنند.
.Sp
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-foptimize\-crc\fR 4
.IX Item "-foptimize-crc"
تشخیص حلقه‌های محاسبه‌کننده CRC (انجام تقسیم طولانی چندجمله‌ای) و جایگزینی آن‌ها با یک پیاده‌سازی سریع‌تر. تشخیص CRCهای ۸، ۱۶، ۳۲ و ۶۴ بیتی با چندجمله‌ای ثابت بدون بیت ۱ پیشرو، برای هر دو حالت ترتیب بیت رو به جلو و بیت معکوس.
اگر معماری مقصد از دستورالعمل CRC پشتیبانی کند و چندجمله‌ای استفاده‌شده در کد منبع با چندجمله‌ای دستورالعمل CRC مطابقت داشته باشد، آن دستورالعمل CRC تولید می‌شود. در غیر این صورت، اگر مقصد از دستورالعمل ضرب بدون رقم نقلی (carry-less-multiplication) پشتیبانی کند، CRC با استفاده از آن تولید می‌شود؛ در غیر این صورت، CRC مبتنی بر جدول تولید خواهد شد.
.Sp
به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-foptimize\-sibling\-calls\fR 4
.IX Item "-foptimize-sibling-calls"
بهینه‌سازی فراخوانی‌های هم‌سطح (sibling) و بازگشتی دمی (tail recursive).
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-foptimize\-strlen\fR 4
.IX Item "-foptimize-strlen"
بهینه‌سازی توابع مختلف استاندارد رشته‌ای C (مانند \f(CW\*(C`strlen\*(C'\fR، \&\f(CW\*(C`strchr\*(C'\fR یا \f(CW\*(C`strcpy\*(C'\fR) و معادل‌های \f(CW\*(C`_FORTIFY_SOURCE\*(C'\fR آن‌ها به جایگزین‌های سریع‌تر.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال است.
.IP \fB\-finline\-atomics\fR 4
.IX Item "-finline-atomics"
.PD 0
.IP \fB\-fno\-inline\-atomics\fR 4
.IX Item "-fno-inline-atomics"
.PD
درون‌خطی‌سازی عملیات‌های \fB_\|_atomic\fR در صورت در دسترس بودن توالی دستورالعمل‌های بدون قفل (lock-free). این بهینه‌سازی به‌طور پیش‌فرض فعال است.
.IP \fB\-finline\-stringops\fR[\fB=\fR\fIfn\fR] 4
.IX Item "-finline-stringops[=fn]"
بسط درون‌خطی عملیات‌های حافظه و رشته (در حال حاضر تنها \f(CW\*(C`memset\*(C'\fR)، حتی زمانی که طول متغیر باشد یا به اندازه‌ای بزرگ باشد که نیاز به حلقه داشته باشد. این گزینه بیشترین کاربرد را همراه با \fB\-ffreestanding\fR و \&\fB\-fno\-builtin\fR دارد.
.Sp
در برخی شرایط، این گزینه به کامپایلر اجازه می‌دهد کدی تولید کند که از تراز و مضارب طول شناخته‌شده بهره می‌برد، اما حتی در آن صورت هم ممکن است کارایی کمتری نسبت به پیاده‌سازی‌های بهینه‌شده زمان اجرا داشته باشد، و حجم کد را چنان افزایش دهد که حتی یک پیاده‌سازی مشترک با کارایی کمتر، به دلیل استفاده بهتر از حافظه‌های نهان کد (code caches)، سریع‌تر اجرا شود. این گزینه به‌طور پیش‌فرض غیرفعال است..IP \fB\-fno\-inline\fR 4
.IX Item "-fno-inline"
هیچ تابعی را به‌صورت درون‌خطی (inline) بسط نده، مگر توابعی که با مشخصهٔ
\f(CW\*(C`always_inline\*(C'\fR علامت‌گذاری شده باشند. در صورت عدم بهینه‌سازی، این
رفتار پیش‌فرض است.
.Sp
می‌توان با علامت‌گذاری توابع منفرد با مشخصهٔ \f(CW\*(C`noinline\*(C'\fR، آن‌ها را از
درون‌خطی شدن معاف کرد.
.IP \fB\-finline\-small\-functions\fR 4
.IX Item "-finline-small-functions"
هنگامی که بدنهٔ توابع کوچک‌تر از کد مورد انتظار برای فراخوانی تابع باشد، آن‌ها
را در فراخواننده‌هایشان ادغام کن (به طوری که اندازهٔ کلی برنامه کوچک‌تر شود).
کامپایلر با روش‌های ابتکاری (heuristic) تصمیم می‌گیرد که کدام توابع به اندازهٔ
کافی ساده هستند که ارزش ادغام به این روش را داشته باشند. این درون‌خطی‌سازی
برای تمامی توابع اعمال می‌شود، حتی توابعی که به‌صورت inline اعلان نشده‌اند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-findirect\-inlining\fR 4
.IX Item "-findirect-inlining"
فراخوانی‌های غیرمستقیمی را که به لطف درون‌خطی‌سازی‌های پیشین مشخص شده که در زمان
کامپایل شناخته‌شده هستند نیز درون‌خطی کن. این گزینه تنها زمانی اثرگذار است
که خودِ درون‌خطی‌سازی با گزینه‌های \fB\-finline\-functions\fR یا
\fB\-finline\-small\-functions\fR فعال شده باشد.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-finline\-functions\fR 4
.IX Item "-finline-functions"
تمام توابع را برای درون‌خطی‌سازی در نظر بگیر، حتی اگر به‌صورت inline اعلان
نشده باشند. کامپایلر با روش‌های ابتکاری تصمیم می‌گیرد که ادغام کدام توابع
به این شیوه ارزش دارد.
.Sp
اگر تمام فراخوانی‌ها به یک تابع داده‌شده ادغام شوند و تابع به‌صورت
\f(CW\*(C`static\*(C'\fR اعلان شده باشد، در حالت عادی کد اسمیلی مستقلی برای
آن تابع تولید نمی‌شود.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است. همچنین توسط
\fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌گردد.
.IP \fB\-finline\-functions\-called\-once\fR 4
.IX Item "-finline-functions-called-once"
تمام توابع \f(CW\*(C`static\*(C'\fR را که تنها یک بار فراخوانی شده‌اند، برای درون‌خطی
شدن در فراخواننده‌شان در نظر بگیر، حتی اگر با \f(CW\*(C`inline\*(C'\fR مشخص نشده
باشند. اگر فراخوانی به یک تابع معین ادغام شود، آن تابع به‌تنهایی در خروجی کد
اسمبلی قرار نمی‌گیرد.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است،
اما در \fB\-Og\fR خیر.
.IP \fB\-fearly\-inlining\fR 4
.IX Item "-fearly-inlining"
توابع مشخص‌شده با \f(CW\*(C`always_inline\*(C'\fR و توابعی که اندازهٔ بدنهٔ آن‌ها
کوچک‌تر از سربار فراخوانی تابع به نظر می‌رسد را زودهنگام و پیش از انجام
ابزارگذاری (instrumentation) با \fB\-fprofile\-generate\fR و گذر واقعی
درون‌خطی‌سازی، درون‌خطی کن. این عمل سربار ارزیابی کارایی (profiling) را به
میزان چشمگیری کاهش می‌دهد و معمولاً سرعت درون‌خطی‌سازی را در برنامه‌هایی که
دارای زنجیره‌های طولانی از توابع پوششی (wrapper) تو‌در‌تو هستند افزایش می‌دهد.
.Sp
به‌طور پیش‌فرض فعال است.
.IP \fB\-fipa\-sra\fR 4
.IX Item "-fipa-sra"
جایگزینی اسکالر بین‌روالی ساختارها (aggregates)، حذف پارامترهای بی‌استفاده،
و جایگزینی پارامترهای ارجاعی با پارامترهای مقداری را انجام بده.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-finline\-limit=\fR\fIn\fR 4
.IX Item "-finline-limit=n"
کامپایلر GCC به‌طور پیش‌فرض اندازهٔ توابعی که می‌توانند درون‌خطی شوند را محدود
می‌کند. این پرچم امکان کنترل کلی این محدودیت را فراهم می‌سازد. \fIn\fR اندازهٔ
توابعی است که می‌توانند بر حسب تعداد شبه‌دستورها درون‌خطی شوند.
.Sp
درون‌خطی‌سازی در عمل توسط مجموعه‌ای از پارامترهای داخلی کنترل می‌شود که در
مستندات GCC Internals تشریح شده‌اند و معمولاً نباید مستقیماً تغییر داده شوند.
.Sp
\&\fIنکته:\fR ممکن است هیچ مقداری برای \fB\-finline\-limit\fR وجود نداشته
باشد که دقیقاً نتیجه‌ای معادل رفتار پیش‌فرض داشته باشد.
.Sp
\&\fIنکته:\fR شبه‌دستور در این زمینهٔ خاص، معیاری انتزاعی از اندازهٔ تابع
را نشان می‌دهد. این مفهوم به‌هیچ‌وجه به معنای شمارش دستورالعمل‌های اسمبلی
نیست و از این رو ممکن است تعریف دقیق آن از یک نسخه به نسخهٔ دیگر تغییر کند.
.IP \fB\-fno\-keep\-inline\-dllexport\fR 4
.IX Item "-fno-keep-inline-dllexport"
این یک نگارش ریزدانه‌تر از \fB\-fkeep\-inline\-functions\fR است که فقط برای
توابعی اعمال می‌شود که با مشخصه یا declspec مربوط به \f(CW\*(C`dllexport\*(C'\fR
اعلان شده باشند.
.IP \fB\-fkeep\-inline\-functions\fR 4
.IX Item "-fkeep-inline-functions"
در C، توابع \f(CW\*(C`static\*(C'\fR اعلان‌شده با \f(CW\*(C`inline\*(C'\fR را حتی اگر در
تمام فراخواننده‌هایشان درون‌خطی شده باشند، در فایل شیء درج کن. این سوییچ بر
توابعی که از افزونهٔ \f(CW\*(C`extern inline\*(C'\fR در GNU C90 استفاده می‌کنند تأثیری
ندارد. در C++، همه و تک‌تک توابع درون‌خطی را در فایل شیء درج کن.
.IP \fB\-fkeep\-static\-functions\fR 4
.IX Item "-fkeep-static-functions"
توابع \f(CW\*(C`static\*(C'\fR را حتی در صورتی که هرگز استفاده نشده باشند،
در فایل شیء درج کن.
.IP \fB\-fkeep\-static\-consts\fR 4
.IX Item "-fkeep-static-consts"
هنگامی که بهینه‌سازی غیرفعال است، متغیرهای اعلان‌شده به‌صورت \f(CW\*(C`static const\*(C'\fR
را در فایل شیء درج کن، حتی اگر هیچ ارجاعی به آن‌ها وجود نداشته باشد.
.Sp
کامپایلر GCC این گزینه را به‌طور پیش‌فرض فعال می‌کند. اگر می‌خواهید کامپایلر
را وادار کنید تا مستقل از فعال بودن یا نبودن بهینه‌سازی، ارجاع داده شدن به متغیر
را بررسی کند، از گزینهٔ \fB\-fno\-keep\-static\-consts\fR استفاده کنید.
.IP \fB\-fmerge\-constants\fR 4
.IX Item "-fmerge-constants"
تلاش برای ادغام ثابت‌های یکسان (ثابت‌های رشته‌ای و ممیز شناور) در میان واحدهای
ترجمه (compilation units).
.Sp
در صورتی که اسمبلر و پیونددهنده پشتیبانی کنند، این گزینه در کامپایل‌های بهینه‌شده
به‌طور پیش‌فرض فعال است. برای جلوگیری از این رفتار، از \fB\-fno\-merge\-constants\fR
استفاده کنید.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fmerge\-all\-constants\fR 4
.IX Item "-fmerge-all-constants"
تلاش برای ادغام ثابت‌های یکسان و متغیرهای یکسان.
.Sp
این گزینه به معنای به‌کارگیری \fB\-fmerge\-constants\fR نیز هست. این گزینه علاوه
بر موارد تحت پوشش \fB\-fmerge\-constants\fR، مواردی چون آرایه‌های با مقدار اولیهٔ
ثابت یا متغیرهای با مقدار اولیهٔ ثابت با انواع صحیح یا ممیز شناور را نیز لحاظ
می‌کند. زبان‌هایی مانند C یا C++ ایجاب می‌کنند که هر متغیر، از جمله نمونه‌های متعدد
از متغیری یکسان در فراخوانی‌های بازگشتی، آدرس‌های حافظهٔ مجزایی داشته باشند؛ بنابراین
استفاده از این گزینه منجر به رفتاری ناسازگار با استاندارد (non\-conforming) می‌شود.
.IP \fB\-fmodulo\-sched\fR 4
.IX Item "-fmodulo-sched"
زمان‌بندی مدولو چرخشی (swing modulo scheduling) را بلافاصله قبل از نخستین گذر
زمان‌بندی اجرا کن. این گذر درونی‌ترین حلقه‌ها را بررسی کرده و با همپوشانی تکرارهای
مختلف، دستورالعمل‌های آن‌ها را بازآرایی می‌کند.
.IP \fB\-fmodulo\-sched\-allow\-regmoves\fR 4
.IX Item "-fmodulo-sched-allow-regmoves"
زمان‌بندی مدولو تهاجمی‌تر مبتنی بر SMS را با مجاز دانستن جابه‌جایی ثبات‌ها
(register moves) انجام بده. با تنظیم این پرچم، برخی یال‌های پادوابستگی
(anti\-dependences) حذف می‌شوند که موجب تولید reg\-moveها بر اساس تحلیل
محدودهٔ حیات (life\-range analysis) می‌گردد. این گزینه تنها در صورت فعال
بودن \fB\-fmodulo\-sched\fR مؤثر خواهد بود.
.IP \fB\-fno\-branch\-count\-reg\fR 4
.IX Item "-fno-branch-count-reg"
گذر بهینه‌سازی بررسی فرصت‌های استفاده از دستورالعمل‌های \(lqکاهش و انشعاب\(rq
روی ثبات شمارنده به جای توالی دستورالعمل‌هایی که ثبات را کاهش داده، با صفر
مقایسه کرده و سپس بر اساس نتیجه انشعاب ایجاد می‌کنند را غیرفعال کن. این گزینه
فقط در معماری‌هایی که از چنین دستورالعمل‌هایی پشتیبانی می‌کنند معنادار است،
از جمله x86، PowerPC، IA\-64 و S/390. توجه داشته باشید که گزینهٔ
\fB\-fno\-branch\-count\-reg\fR دستورالعمل‌های کاهش و انشعاب تولیدشده توسط
سایر گذرهای بهینه‌سازی را از جریان دستورالعمل‌ها حذف نمی‌کند.
.Sp
پیش‌فرض در \fB\-O1\fR و بالاتر، به جز \fB\-Og\fR، گزینهٔ \fB\-fbranch\-count\-reg\fR است.
.IP \fB\-fno\-function\-cse\fR 4
.IX Item "-fno-function-cse"
آدرس‌های توابع را در ثبات‌ها قرار نده؛ کاری کن که هر دستورالعمل فراخوانندهٔ یک
تابع ثابت، صراحتاً حاوی آدرس آن تابع باشد.
.Sp
این گزینه منجر به کدی با کارایی کمتر می‌شود، اما برخی ترفندهای خاص که خروجی
اسمبلر را دستکاری می‌کنند ممکن است در صورت عدم استفاده از این گزینه با
بهینه‌سازی‌های اعمال‌شده تداخل پیدا کنند.
.Sp
پیش‌فرض \fB\-ffunction\-cse\fR است.
.IP \fB\-ffuse\-ops\-with\-volatile\-access\fR 4
.IX Item "-ffuse-ops-with-volatile-access"
بهینه‌سازی محدود عملیاتِ دارای دسترسی به حافظهٔ فرّار (volatile) را در صورتی که
موجب تغییر معناشناسی تشریح‌شده در نشود، مجاز بدار.
.Sp
پیش‌فرض \fB\-ffuse\-ops\-with\-volatile\-access\fR است.
.IP \fB\-fno\-zero\-initialized\-in\-bss\fR 4
.IX Item "-fno-zero-initialized-in-bss"
اگر مقصد از بخش BSS پشتیبانی کند، GCC به‌طور پیش‌فرض متغیرهایی که با صفر
مقداردهی اولیه شده‌اند را درون BSS قرار می‌دهد. این کار می‌تواند فضای مورد نیاز
در کد خروجی را کاهش دهد.
.Sp
این گزینه رفتار فوق را غیرفعال می‌کند زیرا برخی برنامه‌ها صراحتاً وابسته به قرارگیری
متغیرها در بخش data هستند؛ به عنوان مثال، برای این که فایل اجرایی نهایی بتواند
ابتدای آن بخش را پیدا کرده و/یا فرضیاتی بر اساس آن بنا کند.
.Sp
پیش‌فرض، به جز در زبان Ada، گزینهٔ \fB\-fzero\-initialized\-in\-bss\fR است.
.IP \fB\-fthread\-jumps\fR 4
.IX Item "-fthread-jumps"
بهینه‌سازی‌هایی را انجام بده که بررسی می‌کنند آیا یک پرش به مکانی انشعاب پیدا
می‌کند که در آنجا مقایسهٔ دیگری تحت پوشش مقایسهٔ اول قرار دارد یا خیر. در این
صورت، بسته به اینکه مشخص شود شرط صحیح است یا غلط، انشعاب نخست به مقصد انشعاب
دوم یا نقطه‌ای بلافاصله پس از آن هدایت می‌شود.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است..IP \fB\-fsplit\-wide\-types\fR 4
.IX Item "-fsplit-wide-types"
هنگام استفاده از نوعی که چند ثبات را اشغال می‌کند، مانند \f(CW\*(C`long
long\*(C'\fR در یک سیستم ۳۲\-بیتی، ثبات‌ها را تفکیک کرده و آن‌ها را
به‌طور مستقل تخصیص می‌دهد. این کار معمولاً کد بهتری برای این نوع‌ها
تولید می‌کند، اما ممکن است اشکال‌زدایی را دشوارتر سازد.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR،
\&\fB\-Os\fR فعال است.
.IP \fB\-fsplit\-wide\-types\-early\fR 4
.IX Item "-fsplit-wide-types-early"
انواع عریض را در مراحل اولیه به‌طور کامل تفکیک می‌کند، به جای این‌که خیلی دیر انجام شود.
این گزینه هیچ تأثیری ندارد مگر اینکه \fB\-fsplit\-wide\-types\fR فعال باشد.
.Sp
این حالت در برخی مقاصد پیش‌فرض است.
.IP \fB\-fcse\-follow\-jumps\fR 4
.IX Item "-fcse-follow-jumps"
در حذف عبارات فرعی مشترک (CSE)، دستورالعمل‌های پرش را هنگامی که مقصد پرش
از هیچ مسیر دیگری در دسترس نیست، پیمایش می‌کند. برای مثال، زمانی که CSE با
یک عبارت \f(CW\*(C`if\*(C'\fR دارای بند
\&\f(CW\*(C`else\*(C'\fR مواجه می‌شود، هنگام نادرست بودن شرط مورد آزمایش، پرش را دنبال می‌کند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-fcse\-skip\-blocks\fR 4
.IX Item "-fcse-skip-blocks"
این گزینه مشابه \fB\-fcse\-follow\-jumps\fR است، اما باعث می‌شود که CSE
پرش‌هایی را دنبال کند که به‌طور مشروط از روی بلوک‌ها رد می‌شوند. هنگامی که CSE
با یک عبارت سادهٔ \f(CW\*(C`if\*(C'\fR بدون بند else مواجه می‌شود،
\&\fB\-fcse\-skip\-blocks\fR باعث می‌شود CSE پرش اطراف بدنهٔ \f(CW\*(C`if\*(C'\fR را دنبال کند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-frerun\-cse\-after\-loop\fR 4
.IX Item "-frerun-cse-after-loop"
اجرای مجدد حذف عبارات فرعی مشترک پس از انجام بهینه‌سازی‌های حلقه.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-fgcse\fR 4
.IX Item "-fgcse"
یک گام حذف عبارات فرعی مشترک سراسری انجام می‌دهد.
این گام همچنین انتشار سراسری ثابت و کپی را انجام می‌دهد.
.Sp
\&\fIنکته:\fR هنگام کامپایل برنامه‌ای که از computed gotos (یکی از افزونه‌های GCC)
استفاده می‌کند، در صورت غیرفعال کردن گام حذف عبارات فرعی مشترک سراسری
با افزودن \fB\-fno\-gcse\fR به خط فرمان، ممکن است کارایی زمان اجرای بهتری به دست آورید.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-fgcse\-lm\fR 4
.IX Item "-fgcse-lm"
هنگامی که \fB\-fgcse\-lm\fR فعال باشد، حذف عبارات فرعی مشترک سراسری
تلاش می‌کند بارگذاری‌هایی (loads) را که فقط توسط ذخیره‌سازی‌های (stores) درون خودشان
باطل می‌شوند، منتقل کند. این کار اجازه می‌دهد یک حلقه حاوی دنبالهٔ بارگذاری/ذخیره‌سازی به
یک بارگذاری در خارج از حلقه، و یک کپی/ذخیره‌سازی درون حلقه تبدیل شود.
.Sp
به‌طور پیش‌فرض زمانی که \fB\-fgcse\fR فعال باشد، فعال است.
.IP \fB\-fgcse\-sm\fR 4
.IX Item "-fgcse-sm"
هنگامی که \fB\-fgcse\-sm\fR فعال باشد، یک گام انتقال ذخیره‌سازی (store motion) پس از
حذف عبارات فرعی مشترک سراسری اجرا می‌شود. این گام تلاش می‌کند تا ذخیره‌سازی‌ها را
به خارج از حلقه‌ها منتقل کند. هنگامی که در ترکیب با \fB\-fgcse\-lm\fR استفاده شود،
حلقه‌های حاوی توالی بارگذاری/ذخیره‌سازی می‌توانند به یک بارگذاری پیش از حلقه
و یک ذخیره‌سازی پس از حلقه تغییر یابند.
.Sp
در هیچ سطح بهینه‌سازی فعال نیست.
.IP \fB\-fgcse\-las\fR 4
.IX Item "-fgcse-las"
هنگامی که \fB\-fgcse\-las\fR فعال باشد، گام حذف عبارات فرعی مشترک سراسری،
بارگذاری‌های زائدی را که پس از ذخیره‌سازی در همان مکان حافظه رخ می‌دهند
حذف می‌کند (هم افزونگی‌های جزئی و هم کامل).
.Sp
در هیچ سطح بهینه‌سازی فعال نیست.
.IP \fB\-fgcse\-after\-reload\fR 4
.IX Item "-fgcse-after-reload"
هنگامی که \fB\-fgcse\-after\-reload\fR فعال باشد، یک گام حذف بارگذاری‌های زائد
پس از reload انجام می‌شود. هدف این گام پاک‌سازی سرریزهای ثبات (spilling) زائد است.
.Sp
توسط \fB\-O3\fR، \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-faggressive\-loop\-optimizations\fR 4
.IX Item "-faggressive-loop-optimizations"
این گزینه به بهینه‌ساز حلقه می‌گوید که از قیدهای زبان برنامه‌نویسی برای
به دست آوردن حدود شمار تکرارهای یک حلقه استفاده کند. این گزینه فرض می‌کند که
کد حلقه رفتار تعریف‌نشده (undefined behavior) ایجاد نمی‌کند؛ مانند ایجاد سرریز
عدد صحیح علامت‌دار یا دسترسی به آرایه فراتر از محدوده. حدود شمار تکرارهای یک حلقه
برای هدایت باز کردن حلقه (unrolling)، پوسته‌کنی حلقه (peeling) و
بهینه‌سازی‌های آزمون خروج از حلقه به کار می‌رود.
این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-funconstrained\-commons\fR 4
.IX Item "-funconstrained-commons"
این گزینه به کامپایلر اعلام می‌کند که متغیرهای تعریف‌شده در بلوک‌های عمومی (common blocks،
مانند زبان Fortran) ممکن است بعداً با آرایه‌های دنباله‌دار طولانی‌تر رونویسی شوند. این کار
مانع از بهینه‌سازی‌های خاصی می‌شود که وابسته به دانستن حدود آرایه هستند.
.IP \fB\-fcrossjumping\fR 4
.IX Item "-fcrossjumping"
تبدیل پرش متقاطع (cross\-jumping) را انجام می‌دهد.
این تبدیل کدهای یکسان را یکپارچه کرده و اندازهٔ کد را کاهش می‌دهد. عملکرد
کد حاصل ممکن است بهتر از حالت بدون پرش متقاطع باشد یا نباشد.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-fauto\-inc\-dec\fR 4
.IX Item "-fauto-inc-dec"
افزایش یا کاهش آدرس‌ها را با دسترسی‌های حافظه ترکیب می‌کند.
این گام در معماری‌هایی که فاقد دستورالعمل‌های پشتیبانی از این ویژگی هستند
همواره نادیده گرفته می‌شود. در معماری‌هایی که از این ویژگی پشتیبانی می‌کنند،
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fdce\fR 4
.IX Item "-fdce"
حذف کدهای مرده (DCE) را روی RTL انجام می‌دهد.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fdse\fR 4
.IX Item "-fdse"
حذف ذخیره‌سازی‌های مرده (DSE) را روی RTL انجام می‌دهد.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fif\-conversion\fR 4
.IX Item "-fif-conversion"
تلاش می‌کند تا پرش‌های شرطی را به معادل‌های بدون انشعاب تبدیل کند. این مورد شامل
استفاده از دستورالعمل‌های انتقال شرطی، min، max، تنظیم پرچم‌ها و abs، و
برخی ترفندهای قابل انجام با محاسبات استاندارد است. استفاده از اجرای شرطی
روی تراشه‌هایی که این ویژگی در آن‌ها در دسترس است، توسط \fB\-fif\-conversion2\fR کنترل می‌شود.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است، اما
نه با \fB\-Og\fR.
.IP \fB\-fif\-conversion2\fR 4
.IX Item "-fif-conversion2"
استفاده از اجرای شرطی (در صورت در دسترس بودن) برای تبدیل پرش‌های شرطی به
معادل‌های بدون انشعاب.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است، اما
نه با \fB\-Og\fR.
.IP \fB\-fdeclone\-ctor\-dtor\fR 4
.IX Item "-fdeclone-ctor-dtor"
استاندارد C++ ABI نیازمند چندین نقطهٔ ورود برای سازنده‌ها و ویران‌کننده‌ها است:
یکی برای زیرشیء پایه، یکی برای شیء کامل، و یکی برای ویران‌کنندهٔ مجازی که
پس از آن operator delete را فراخوانی می‌کند. برای سلسله‌مراتبی با پایه‌های مجازی،
انواع پایه و کامل همزاد (clone) یکدیگرند، که به معنای دو نسخه از تابع است.
با این گزینه، انواع پایه و کامل به thunkهایی تبدیل می‌شوند که یک پیاده‌سازی مشترک
را فراخوانی می‌کنند.
.Sp
توسط \fB\-Os\fR فعال می‌شود.
.IP \fB\-fdelete\-null\-pointer\-checks\fR 4
.IX Item "-fdelete-null-pointer-checks"
فرض می‌کند که برنامه‌ها نمی‌توانند به‌طور ایمن اشاره‌گرهای تهی (null) را مبنازدایی کنند، و
هیچ عنصر کد یا داده‌ای در نشانی صفر قرار ندارد. این گزینه بهینه‌سازی‌های سادهٔ
ادغام ثابت‌ها را در تمام سطوح بهینه‌سازی فعال می‌کند. علاوه بر این، سایر
گام‌های بهینه‌سازی در GCC از این پرچم برای کنترل تحلیل‌های جریان دادهٔ سراسری
استفاده می‌کنند که بررسی‌های بیهوده برای اشاره‌گرهای تهی را حذف می‌نمایند؛
این فرض بر این اساس است که دسترسی حافظه به نشانی صفر همیشه به یک trap منجر می‌شود،
بنابراین اگر اشاره‌گری پس از این‌که قبلاً مبنازدایی شده بررسی شود،
نمی‌تواند تهی باشد.
.Sp
با این حال توجه داشته باشید که در برخی محیط‌ها این فرض درست نیست.
برای برنامه‌هایی که به آن رفتار وابسته‌اند، از \fB\-fno\-delete\-null\-pointer\-checks\fR
برای غیرفعال کردن این بهینه‌سازی استفاده کنید.
.Sp
این گزینه به‌طور پیش‌فرض در بیشتر مقاصد فعال است.
در AVR و MSP430، این گزینه به‌طور کامل غیرفعال است.
.Sp
گام‌هایی که از اطلاعات جریان داده استفاده می‌کنند
به‌طور مستقل در سطوح مختلف بهینه‌سازی فعال می‌شوند.
.IP \fB\-fdevirtualize\fR 4
.IX Item "-fdevirtualize"
تلاش می‌کند تا فراخوانی توابع مجازی را به فراخوانی‌های مستقیم تبدیل کند. این کار
هم درون یک رویه و هم بین رویه‌ها به عنوان بخشی از درون‌خطی‌سازی غیرمستقیم
(\fB\-findirect\-inlining\fR) و انتشار ثوابت بین‌رویه‌ای (\fB\-fipa\-cp\fR) انجام می‌شود.
در سطوح \fB\-O2\fR، \fB\-O3\fR، \fB\-Os\fR فعال است.
.IP \fB\-fdevirtualize\-speculatively\fR 4
.IX Item "-fdevirtualize-speculatively"
تلاش می‌کند تا فراخوانی توابع مجازی را به فراخوانی‌های مستقیم حدسی تبدیل کند.
بر اساس تحلیل گراف وراثت نوع، برای یک فراخوانی مشخص مجموعه‌ای از مقاصد محتمل
تعیین می‌شود. اگر این مجموعه کوچک باشد (ترجیحاً با اندازهٔ ۱)، فراخوانی را به یک
دستور شرطی تبدیل می‌کند که بین فراخوانی مستقیم و غیرمستقیم تصمیم می‌گیرد. فراخوانی‌های
حدسی بهینه‌سازی‌های بیشتری مانند درون‌خطی‌سازی را ممکن می‌سازند. هنگامی که پس از بهینه‌سازی‌های
بیشتر بی‌فایده به نظر برسند، دوباره به شکل اولیه برگردانده می‌شوند.
.IP \fB\-fdevirtualize\-at\-ltrans\fR 4
.IX Item "-fdevirtualize-at-ltrans"
اطلاعات اضافی مورد نیاز برای مجازی‌زدایی تهاجمی را هنگام اجرای بهینه‌ساز زمان پیوند
در حالت تبدیلات محلی جاری‌سازی می‌کند.
این گزینه امکان مجازی‌زدایی بیشتری را فراهم می‌کند اما
حجم داده‌های جاری‌سازی‌شده را به میزان قابل توجهی افزایش می‌دهد. به همین دلیل
به‌طور پیش‌فرض غیرفعال است..IP \fB\-fexpensive\-optimizations\fR 4
.IX Item "-fexpensive-optimizations"
انجام تعدادی بهینه‌سازی جزئی که از نظر محاسباتی نسبتاً پرهزینه‌اند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال می‌شود.
.IP \fB\-fext\-dce\fR 4
.IX Item "-fext-dce"
.PD 0
.IP \fB\-fno\-ext\-dce\fR 4
.IX Item "-fno-ext-dce"
.PD
انجام حذف کد مرده (dead code elimination) روی بسط‌های صفر و علامت، با استفاده از تحلیل ویژهٔ جریان داده (dataflow analysis).
.IP \fB\-free\fR 4
.IX Item "-free"
تلاش برای حذف دستورالعمل‌های بسطِ (extension) زاید. این گزینه به‌ویژه برای معماری x86\-64 سودمند است که پس از نوشتن در نیمهٔ ۳۲ بیتی پایینی ثبات‌های ۶۴ بیتی، به‌طور ضمنی آنها را با صفر بسط می‌دهد (zero-extends).
.Sp
برای Alpha، AArch64، LoongArch، PowerPC، RISC\-V، SPARC، h83000 و x86 در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fno\-lifetime\-dse\fR 4
.IX Item "-fno-lifetime-dse"
در ++C مقدار یک شیء تنها تحت تأثیر تغییراتی است که در طول عمر (lifetime) آن رخ می‌دهد: زمانی که سازنده (constructor) آغاز می‌شود، شیء دارای مقداری نامشخص است و هر تغییری در طول عمر شیء، پس از نابود شدن شیء مرده (dead) تلقی می‌شود. در حالت معمول حذف ذخیره‌های مرده (dead store elimination) از این موضوع بهره می‌برد؛ اگر کد شما متکی بر ماندگاری مقدار حافظهٔ شیء فراتر از طول عمر شیء است، می‌توانید با این پرچم این بهینه‌سازی را غیرفعال کنید. برای حفظ ذخیره‌ها پیش از آغاز سازنده (برای نمونه به این دلیل که operator new شما فضای ذخیره‌سازی شیء را پاک‌سازی می‌کند) اما همچنان مرده در نظر گرفتن شیء پس از ویرانگر (destructor)، می‌توانید از \fB\-flifetime\-dse=1\fR استفاده کنید. رفتار پیش‌فرض را می‌توان به‌صراحت با \fB\-flifetime\-dse=2\fR تعیین کرد.
\&\fB\-flifetime\-dse=0\fR معادل \fB\-fno\-lifetime\-dse\fR است.
.IP \fB\-flive\-range\-shrinkage\fR 4
.IX Item "-flive-range-shrinkage"
تلاش برای کاهش فشار ثبات (register pressure) از طریق کوچک کردن بازهٔ حیات ثبات (live range shrinkage). این گزینه برای پردازنده‌های سریعی با مجموعه‌های ثبات کوچک یا متوسط سودمند است.
.IP \fB\-fira\-algorithm=\fR\fIalgorithm\fR 4
.IX Item "-fira-algorithm=algorithm"
استفاده از الگوریتم رنگ‌آمیزی مشخص‌شده برای تخصیص‌دهندهٔ یکپارچهٔ ثبات (IRA). آرگومان \fIalgorithm\fR می‌تواند \fBpriority\fR باشد که بیانگر رنگ‌آمیزی اولویت Chow است، یا \fBCB\fR که رنگ‌آمیزی Chaitin\-Briggs را مشخص می‌کند. رنگ‌آمیزی Chaitin\-Briggs برای همهٔ معماری‌ها پیاده‌سازی نشده است، اما برای مقاصدی که از آن پشتیبانی می‌کنند به دلیل تولید کد بهتر، پیش‌فرض است.
.IP \fB\-fira\-region=\fR\fIregion\fR 4
.IX Item "-fira-region=region"
استفاده از ناحیه‌های مشخص‌شده برای تخصیص‌دهندهٔ یکپارچهٔ ثبات. آرگومان \&\fIregion\fR باید یکی از موارد زیر باشد:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
استفاده از همهٔ حلقه‌ها به عنوان ناحیه‌های تخصیص ثبات.
این حالت می‌تواند بهترین نتایج را برای ماشین‌هایی با مجموعه ثبات‌های کوچک یا نامنظم ارائه دهد.
.IP \fBmixed\fR 4
.IX Item "mixed"
استفاده از همهٔ حلقه‌ها، به جز حلقه‌هایی با فشار ثبات اندک، به عنوان ناحیه. این مقدار معمولاً در اکثر موارد و برای بیشتر معماری‌ها بهترین نتایج را می‌دهد و در هنگام کامپایل با بهینه‌سازی سرعت (\fB\-O\fR، \fB\-O2\fR، ...) به‌طور پیش‌فرض فعال است.
.IP \fBone\fR 4
.IX Item "one"
استفاده از کل تابع به عنوان یک ناحیهٔ واحد.
این مقدار معمولاً کمترین اندازهٔ کد را به همراه دارد و به‌طور پیش‌فرض برای \&\fB\-Os\fR یا \fB\-O0\fR فعال است.
.RE
.RS 4
.RE
.IP \fB\-fira\-hoist\-pressure\fR 4
.IX Item "-fira-hoist-pressure"
استفاده از IRA برای ارزیابی فشار ثبات در مرحلهٔ بالابردن کد (code hoisting pass) به منظور تصمیم‌گیری در بالابردن عبارات. این گزینه معمولاً منجر به کد کوچک‌تر می‌شود، اما می‌تواند سرعت کامپایلر را کاهش دهد.
.Sp
این گزینه در سطح \fB\-Os\fR برای همهٔ مقاصد فعال است.
.IP \fB\-fira\-loop\-pressure\fR 4
.IX Item "-fira-loop-pressure"
استفاده از IRA برای ارزیابی فشار ثبات در حلقه‌ها به منظور تصمیم‌گیری در انتقال مقادیر پایای حلقه (loop invariants). این گزینه معمولاً روی ماشین‌هایی با پرونده‌های ثبات بزرگ (>= ۳۲ ثبات) به تولید کدی سریع‌تر و کوچک‌تر می‌انجامد، اما می‌تواند سرعت کامپایلر را کاهش دهد.
.Sp
این گزینه در سطح \fB\-O3\fR برای برخی از مقاصد فعال است.
.IP \fB\-fno\-ira\-share\-save\-slots\fR 4
.IX Item "-fno-ira-share-save-slots"
غیرفعال کردن اشتراک‌گذاری جایگاه‌های پشته (stack slots) مورد استفاده برای ذخیرهٔ ثبات‌های سخت‌افزاریِ دستخوش تغییر در فراخوانی (call-used) که در طول فراخوانی پابرجا می‌مانند. به هر ثبات سخت‌افزاری یک جایگاه پشتهٔ جداگانه تعلق می‌گیرد و در نتیجه چارچوب‌های پشتهٔ تابع (stack frames) بزرگ‌تر می‌شوند.
.IP \fB\-fno\-ira\-share\-spill\-slots\fR 4
.IX Item "-fno-ira-share-spill-slots"
غیرفعال کردن اشتراک‌گذاری جایگاه‌های پشتهٔ تخصیص‌یافته به شبه‌ثبات‌ها (pseudo-registers). به هر شبه‌ثباتی که ثبات سخت‌افزاری دریافت نکند، یک جایگاه پشتهٔ جداگانه تعلق می‌گیرد و در نتیجه چارچوب‌های پشتهٔ تابع بزرگ‌تر می‌شوند.
.IP \fB\-flra\-remat\fR 4
.IX Item "-flra-remat"
فعال‌سازی بازتولید (rematerialization) حساس به گراف جریان کنترل (CFG) در LRA. به‌جای بارگذاری مقادیر شبه‌ثبات‌های سرریز‌شده، اگر سودمند باشد LRA تلاش می‌کند مقادیر را دوباره بازتولید (محاسبهٔ مجدد) کند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fdelayed\-branch\fR 4
.IX Item "-fdelayed-branch"
در صورت پشتیبانی در ماشین مقصد، تلاش برای بازآرایی دستورالعمل‌ها به منظور بهره‌گیری از شکاف‌های دستورالعمل (instruction slots) موجود پس از دستورالعمل‌های پرش با تأخیر (delayed branch).
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است، اما در \fB\-Og\fR فعال نیست.
.IP \fB\-fschedule\-insns\fR 4
.IX Item "-fschedule-insns"
در صورت پشتیبانی در ماشین مقصد، تلاش برای بازآرایی دستورالعمل‌ها به منظور حذف وقفه‌های اجرایی (execution stalls) ناشی از دردسترس نبودن داده‌های مورد نیاز. این کار با امکان صدور دستورالعمل‌های دیگر تا زمان نیاز به نتیجهٔ بارگذاری حافظه یا دستور ممیز شناور، به ماشین‌هایی که دستورالعمل‌های کند ممیز شناور یا بارگذاری حافظه دارند کمک می‌کند.
.Sp
به‌طور سنتی در سطوح بهینه‌سازی \fB\-O2\fR و \fB\-O3\fR فعال است. با این حال، بسیاری از مقاصد این رفتار را لغو می‌کنند؛ برای نمونه، روی x86 در همهٔ سطوح غیرفعال است، در حالی که در AArch64 فقط در \fB\-O3\fR فعال می‌شود.
.IP \fB\-fschedule\-insns2\fR 4
.IX Item "-fschedule-insns2"
مشابه \fB\-fschedule\-insns\fR است، اما یک مرحلهٔ زمان‌بندی دستورالعمل اضافی پس از انجام تخصیص ثبات درخواست می‌کند. این گزینه به‌ویژه روی ماشین‌هایی با تعداد نسبتاً کم ثبات و در شرایطی که دستورالعمل‌های بارگذاری حافظه بیش از یک چرخه زمان می‌برند، سودمند است.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fno\-sched\-interblock\fR 4
.IX Item "-fno-sched-interblock"
غیرفعال کردن زمان‌بندی دستورالعمل‌ها در میان بلوک‌های پایه (basic blocks)، که معمولاً در زمان‌بندی پیش از تخصیص ثبات (یعنی با \fB\-fschedule\-insns\fR یا در \fB\-O2\fR یا بالاتر) فعال است.
.IP \fB\-fno\-sched\-spec\fR 4
.IX Item "-fno-sched-spec"
غیرفعال کردن انتقال حدسی (speculative motion) دستورالعمل‌های غیربارگذاری، که معمولاً در زمان‌بندی پیش از تخصیص ثبات (یعنی با \fB\-fschedule\-insns\fR یا در \fB\-O2\fR یا بالاتر) فعال است.
.IP \fB\-fsched\-pressure\fR 4
.IX Item "-fsched-pressure"
فعال کردن زمان‌بندی دستورالعمل‌های حساس به فشار ثبات پیش از تخصیص ثبات. این گزینه تنها زمانی کاربرد دارد که زمان‌بندی پیش از تخصیص ثبات فعال باشد (یعنی با \fB\-fschedule\-insns\fR یا در \&\fB\-O2\fR یا بالاتر). استفاده از این گزینه می‌تواند با جلوگیری از افزایش فشار ثبات به بیش از تعداد ثبات‌های سخت‌افزاری موجود و سرریزهای (spills) متعاقب در تخصیص ثبات، کد تولیدشده را بهبود بخشیده و اندازهٔ آن را کاهش دهد.
.IP \fB\-fsched\-spec\-load\fR 4
.IX Item "-fsched-spec-load"
اجازه دادن به جابه‌جایی حدسی برخی از دستورالعمل‌های بارگذاری (load). این گزینه تنها زمانی کاربرد دارد که زمان‌بندی پیش از تخصیص ثبات فعال باشد (یعنی با \&\fB\-fschedule\-insns\fR یا در \fB\-O2\fR یا بالاتر).
.IP \fB\-fsched\-spec\-load\-dangerous\fR 4
.IX Item "-fsched-spec-load-dangerous"
اجازه دادن به جابه‌جایی حدسی دستورالعمل‌های بارگذاری بیشتر. این گزینه تنها زمانی کاربرد دارد که زمان‌بندی پیش از تخصیص ثبات فعال باشد (یعنی با \&\fB\-fschedule\-insns\fR یا در \fB\-O2\fR یا بالاتر).
.IP \fB\-fsched\-stalled\-insns\fR 4
.IX Item "-fsched-stalled-insns"
.PD 0
.IP \fB\-fsched\-stalled\-insns=\fR\fIn\fR 4
.IX Item "-fsched-stalled-insns=n"
.PD
تعیین اینکه در طول مرحلهٔ دوم زمان‌بندی چه تعداد دستورالعمل (در صورت وجود) می‌توانند پیش از موعد از صف دستورالعمل‌های متوقف‌شده (stalled) به فهرست آماده (ready list) منتقل شوند.
\&\fB\-fno\-sched\-stalled\-insns\fR به این معنی است که هیچ دستورالعملی پیش از موعد منتقل نمی‌شود؛ \fB\-fsched\-stalled\-insns=0\fR به این معنی است که هیچ محدودیتی در تعداد دستورالعمل‌های صف‌بندی‌شده که می‌توانند پیش از موعد منتقل شوند وجود ندارد.
\&\fB\-fsched\-stalled\-insns\fR بدون مقدار، معادل \&\fB\-fsched\-stalled\-insns=1\fR است.
.IP \fB\-fsched\-stalled\-insns\-dep\fR 4
.IX Item "-fsched-stalled-insns-dep"
.PD 0
.IP \fB\-fsched\-stalled\-insns\-dep=\fR\fIn\fR 4
.IX Item "-fsched-stalled-insns-dep=n".PD
تعیین می‌کند چه تعداد از گروه‌های دستورالعمل (چرخه‌ها) برای وابستگی به
یک دستورالعمل معلق که کاندیدای حذف زودهنگام از صف دستورالعمل‌های
معلق است، بررسی شوند. این گزینه تنها در طول گذر دوم زمان‌بندی
و تنها در صورت استفاده از \fB\-fsched\-stalled\-insns\fR تأثیر دارد.
\&\fB\-fno\-sched\-stalled\-insns\-dep\fR معادل با
\&\fB\-fsched\-stalled\-insns\-dep=0\fR است.
\&\fB\-fsched\-stalled\-insns\-dep\fR بدون مقدار، معادل با
\&\fB\-fsched\-stalled\-insns\-dep=1\fR است.
.IP \fB\-fsched2\-use\-superblocks\fR 4
.IX Item "-fsched2-use-superblocks"
هنگام زمان‌بندی پس از تخصیص ثبات، از زمان‌بندی ابربلوک (superblock) استفاده می‌کند.
این کار اجازهٔ جابه‌جایی از مرزهای بلوک پایه را داده و
منجر به زمان‌بندی‌های سریع‌تر می‌شود. این گزینه آزمایشی است، چرا که تمام توصیف‌های ماشین
مورد استفاده توسط GCC، پردازنده (CPU) را آن‌قدر دقیق مدل‌سازی نمی‌کنند که از نتایج غیرقابل‌اطمینان
این الگوریتم جلوگیری شود.
.Sp
این گزینه تنها هنگام زمان‌بندی پس از تخصیص ثبات معنا دارد، یعنی همراه با
\&\fB\-fschedule\-insns2\fR یا در \fB\-O2\fR یا بالاتر.
.IP \fB\-fsched\-group\-heuristic\fR 4
.IX Item "-fsched-group-heuristic"
هیوریستیک گروهی را در زمان‌بند فعال می‌کند. این هیوریستیک
دستورالعملی را که متعلق به یک گروه زمان‌بندی است ترجیح می‌دهد. این گزینه
به‌طور پیش‌فرض در صورت فعال بودن زمان‌بندی، یعنی همراه با \fB\-fschedule\-insns\fR
یا \fB\-fschedule\-insns2\fR یا در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fsched\-critical\-path\-heuristic\fR 4
.IX Item "-fsched-critical-path-heuristic"
هیوریستیک مسیر بحرانی را در زمان‌بند فعال می‌کند. این هیوریستیک
دستورالعمل‌های روی مسیر بحرانی را ترجیح می‌دهد. این گزینه به‌طور پیش‌فرض در صورت
فعال بودن زمان‌بندی، یعنی همراه با \fB\-fschedule\-insns\fR
یا \fB\-fschedule\-insns2\fR یا در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fsched\-spec\-insn\-heuristic\fR 4
.IX Item "-fsched-spec-insn-heuristic"
هیوریستیک دستورالعمل‌های گمانه‌زنانه را در زمان‌بند فعال می‌کند. این
هیوریستیک، دستورالعمل‌های گمانه‌زن با ضعف وابستگی بیشتر را ترجیح می‌دهد.
این گزینه به‌طور پیش‌فرض در صورت فعال بودن زمان‌بندی، یعنی
همراه با \fB\-fschedule\-insns\fR یا \fB\-fschedule\-insns2\fR
یا در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fsched\-rank\-heuristic\fR 4
.IX Item "-fsched-rank-heuristic"
هیوریستیک رتبه را در زمان‌بند فعال می‌کند. این هیوریستیک
دستورالعمل متعلق به یک بلوک پایه با اندازه یا بسامد بزرگ‌تر را ترجیح می‌دهد.
این گزینه به‌طور پیش‌فرض در صورت فعال بودن زمان‌بندی، یعنی
همراه با \fB\-fschedule\-insns\fR یا \fB\-fschedule\-insns2\fR یا
در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fsched\-last\-insn\-heuristic\fR 4
.IX Item "-fsched-last-insn-heuristic"
هیوریستیک آخرین دستورالعمل را در زمان‌بند فعال می‌کند. این هیوریستیک
دستورالعملی را که وابستگی کمتری به آخرین دستورالعمل زمان‌بندی‌شده دارد ترجیح می‌دهد.
این گزینه به‌طور پیش‌فرض در صورت فعال بودن زمان‌بندی،
یعنی همراه با \fB\-fschedule\-insns\fR یا \fB\-fschedule\-insns2\fR یا
در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fsched\-dep\-count\-heuristic\fR 4
.IX Item "-fsched-dep-count-heuristic"
هیوریستیک تعداد وابستگی را در زمان‌بند فعال می‌کند. این هیوریستیک
دستورالعملی را که دستورالعمل‌های بیشتری به آن وابسته‌اند ترجیح می‌دهد.
این گزینه به‌طور پیش‌فرض در صورت فعال بودن زمان‌بندی، یعنی
همراه با \fB\-fschedule\-insns\fR یا \fB\-fschedule\-insns2\fR یا
در \fB\-O2\fR یا بالاتر، فعال است.
.IP \fB\-fspeculatively\-call\-stored\-functions\fR 4
.IX Item "-fspeculatively-call-stored-functions"
تلاش می‌کند فراخوانی‌های غیرمستقیم اشاره‌گرهای تابع به اشاره‌گرهای بارگذاری‌شده
از یک فیلد ساختار را در صورتی که تمام ذخیره‌سازی‌های قابل‌مشاهده در آن فیلد،
تنها یک کاندیدای منفرد را ذخیره کنند، تبدیل کند. هنگام انجام این کار، فراخوانی به یک
عبارت شرطی تبدیل می‌شود که بین فراخوانی مستقیم و فراخوانی غیرمستقیم اولیه تصمیم‌گیری می‌کند.
این فراخوانی‌های گمانه‌زنانه اغلب بهینه‌سازی‌های بیشتری مانند درون‌خطی‌سازی (inlining) را
امکان‌پذیر می‌سازند. چنانچه پس از بهینه‌سازی‌های بیشتر بی‌فایده به نظر برسند، دوباره به
شکل اولیه بازگردانده می‌شوند.
.IP \fB\-freschedule\-modulo\-scheduled\-loops\fR 4
.IX Item "-freschedule-modulo-scheduled-loops"
زمان‌بندی پیمانه‌ای (modulo scheduling) پیش از زمان‌بندی سنتی انجام می‌شود. اگر یک حلقه
به‌صورت پیمانه‌ای زمان‌بندی شود، گذرهای بعدی زمان‌بندی ممکن است زمان‌بندی آن را تغییر دهند.
از این گزینه برای کنترل این رفتار استفاده کنید.
.IP \fB\-fselective\-scheduling\fR 4
.IX Item "-fselective-scheduling"
دستورالعمل‌ها را با استفاده از الگوریتم زمان‌بندی گزینشی زمان‌بندی می‌کند. زمان‌بندی
گزینشی به‌جای گذر اول زمان‌بند اجرا می‌شود.
.IP \fB\-fselective\-scheduling2\fR 4
.IX Item "-fselective-scheduling2"
دستورالعمل‌ها را با استفاده از الگوریتم زمان‌بندی گزینشی زمان‌بندی می‌کند. زمان‌بندی
گزینشی به‌جای گذر دوم زمان‌بند اجرا می‌شود.
.IP \fB\-fsel\-sched\-pipelining\fR 4
.IX Item "-fsel-sched-pipelining"
خط‌لوله‌سازی نرم‌افزاری درونی‌ترین حلقه‌ها را در طول زمان‌بندی گزینشی فعال می‌کند.
این گزینه هیچ تأثیری ندارد مگر اینکه یکی از گزینه‌های \fB\-fselective\-scheduling\fR یا
\&\fB\-fselective\-scheduling2\fR فعال باشد.
.IP \fB\-fsel\-sched\-pipelining\-outer\-loops\fR 4
.IX Item "-fsel-sched-pipelining-outer-loops"
هنگام خط‌لوله‌سازی حلقه‌ها در طول زمان‌بندی گزینشی، حلقه‌های بیرونی را نیز خط‌لوله‌سازی می‌کند.
این گزینه هیچ تأثیری ندارد مگر آنکه \fB\-fsel\-sched\-pipelining\fR فعال باشد.
.IP \fB\-fsemantic\-interposition\fR 4
.IX Item "-fsemantic-interposition"
برخی از قالب‌های شیء مانند ELF، امکان مداخله/جایگزینی نمادها (interposition) را توسط
پیونددهندهٔ پویا فراهم می‌کنند.
این بدان معناست که برای نمادهای صادرشده از DSO، کامپایلر نمی‌تواند انتشار بین‌رویه‌ای،
درون‌خطی‌سازی و سایر بهینه‌سازی‌ها را با این احتمال که ممکن است تابع یا متغیر
مورد نظر تغییر کند، انجام دهد. اگرچه این قابلیت، به عنوان مثال برای بازنویسی
توابع تخصیص حافظه با یک پیاده‌سازی اشکال‌زدایی مفید است، اما از نظر کیفیت کد هزینهٔ بالایی دارد.
با \fB\-fno\-semantic\-interposition\fR کامپایلر فرض می‌کند که
اگر مداخله برای توابع رخ دهد، تابع جایگزین دقیقاً همان معناشناسی (و عوارض جانبی)
را خواهد داشت. به همین ترتیب اگر مداخله برای متغیرها رخ دهد،
سازندهٔ متغیر یکسان خواهد بود. این پرچم هیچ اثری بر روی توابعی که صراحتاً
به‌صورت inline اعلان شده‌اند ندارد
(جایی که هرگز به مداخله اجازه داده نمی‌شود معناشناسی را تغییر دهد)
و بر روی نمادهایی که صراحتاً weak اعلان شده‌اند نیز بی‌اثر است.
.IP \fB\-fshrink\-wrap\fR 4
.IX Item "-fshrink-wrap"
مقدمهٔ تابع (prologue) را تنها پیش از بخش‌هایی از تابع که به آن نیاز دارند،
به‌جای ابتدای تابع، صادر می‌کند. این پرچم به‌طور پیش‌فرض در
\&\fB\-O\fR و بالاتر فعال است.
.IP \fB\-fshrink\-wrap\-separate\fR 4
.IX Item "-fshrink-wrap-separate"
بخش‌های مجزای مقدمه و مؤخره را به‌طور جداگانه بسته‌بندی انقباضی (shrink-wrap) می‌کند تا
آن بخش‌ها تنها در صورت نیاز اجرا شوند.
این گزینه به‌طور پیش‌فرض روشن است، اما اثری ندارد مگر اینکه \fB\-fshrink\-wrap\fR
نیز فعال باشد و هدف مورد نظر از آن پشتیبانی کند.
.IP \fB\-fcaller\-saves\fR 4
.IX Item "-fcaller-saves"
تخصیص مقادیر به ثبات‌هایی را که در اثر فراخوانی توابع تخریب می‌شوند، با صادر کردن
دستورالعمل‌های اضافه برای ذخیره و بازیابی ثبات‌ها در اطراف چنین فراخوانی‌هایی ممکن می‌سازد.
چنین تخصیصی تنها در صورتی انجام می‌شود که به نظر برسد به تولید کد بهتری منجر خواهد شد.
.Sp
این گزینه در برخی ماشین‌ها همواره به‌طور پیش‌فرض فعال است؛ معمولاً
ماشین‌هایی که هیچ ثبات نگه‌دارندهٔ وضعیت فراخوانی (call\-preserved) برای استفادهٔ جایگزین ندارند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fcombine\-stack\-adjustments\fR 4
.IX Item "-fcombine-stack-adjustments"
تنظیمات پشته (push و pop) و ارجاعات حافظهٔ پشته را ردیابی کرده
و سپس تلاش می‌کند روش‌هایی برای ادغام آن‌ها بیابد.
.Sp
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-ra\fR 4
.IX Item "-fipa-ra"
از ثبات‌های caller-save برای تخصیص استفاده می‌کند اگر آن ثبات‌ها توسط
هیچ تابع فراخوانی‌شده‌ای استفاده نشوند. در این حالت نیازی به ذخیره و بازیابی
آن‌ها در اطراف فراخوانی‌ها نیست. این کار تنها در صورتی امکان‌پذیر است که توابع فراخوانی‌شده
بخشی از همان واحد ترجمه (compilation unit) تابع جاری بوده و پیش از آن کامپایل شده باشند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است؛ با این حال این گزینه
در صورتی که کد تولیدشده برای پروفایل‌سازی ابزاربندی شود
(\fB\-p\fR یا \fB\-pg\fR)، یا اگر استفادهٔ callee از ثبات‌ها نتواند به‌طور دقیق
مشخص شود (این اتفاق در اهدافی رخ می‌دهد که مقدمه‌ها و مؤخره‌ها را در RTL آشکار نمی‌کنند)،
غیرفعال است.
.IP \fB\-fconserve\-stack\fR 4
.IX Item "-fconserve-stack"
تلاش می‌کند مصرف پشته را به حداقل برساند. کامپایلر تلاش می‌کند فضای کمتری
از پشته را مصرف کند، حتی اگر این کار باعث کندتر شدن برنامه شود. این گزینه
مستلزم تنظیم پارامتر \fBlarge\-stack\-frame\fR روی 100
و پارامتر \fBlarge\-stack\-frame\-growth\fR روی 400 است.
.IP \fB\-ftree\-reassoc\fR 4
.IX Item "-ftree-reassoc"
بازشرکت‌پذیری (reassociation) را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض
در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fcode\-hoisting\fR 4
.IX Item "-fcode-hoisting"
بالا بردن کد (code hoisting) را انجام می‌دهد. بالا بردن کد تلاش می‌کند ارزیابی
عباراتی را که در تمام مسیرها تا خروج تابع اجرا می‌شوند، تا حد امکان
به مراحل اولیه منتقل کند. این کار به‌ویژه برای بهینه‌سازی اندازهٔ کد مفید است،
اما اغلب به سرعت اجرای کد نیز کمک می‌کند.
این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-ftree\-pre\fR 4
.IX Item "-ftree-pre"
حذف افزونگی جزئی (PRE) را روی درخت‌ها انجام می‌دهد. این پرچم
به‌طور پیش‌فرض در \fB\-O2\fR و \fB\-O3\fR فعال است.
.IP \fB\-ftree\-partial\-pre\fR 4
.IX Item "-ftree-partial-pre"
حذف افزونگی جزئی (PRE) را تهاجمی‌تر می‌کند. این پرچم
به‌طور پیش‌فرض در \fB\-O3\fR فعال است.
.IP \fB\-ftree\-forwprop\fR 4
.IX Item "-ftree-forwprop"
انتشار به جلو (forward propagation) را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض
در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-fre\fR 4
.IX Item "-ftree-fre"
حذف افزونگی کامل (FRE) را روی درخت‌ها انجام می‌دهد. تفاوت
بین FRE و PRE این است که FRE تنها عباراتی را در نظر می‌گیرد
که در تمامی مسیرهای منتهی به محاسبهٔ افزونه محاسبه شده باشند.
این تحلیل سریع‌تر از PRE است، اگرچه افزونگی‌های کمتری را شناسایی می‌کند.
این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است..IP \fB\-ftree\-phiprop\fR 4
.IX Item "-ftree-phiprop"
بالا کشیدن بارگذاری‌ها از اشاره‌گرهای شرطی را روی درخت‌ها انجام می‌دهد. این
گذر به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fhoist\-adjacent\-loads\fR 4
.IX Item "-fhoist-adjacent-loads"
بارگذاری‌ها از هر دو شاخه یک if\-then\-else را در صورتی که بارگذاری‌ها از
مکان‌های مجاور در یک ساختار یکسان باشند و معماری مقصد دستورالعمل انتقال شرطی
داشته باشد، به‌صورت گمانه‌زنانه به بالا منتقل می‌کند. این پرچم به‌طور پیش‌فرض
در \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-ftree\-copy\-prop\fR 4
.IX Item "-ftree-copy-prop"
انتشار رونوشت (copy propagation) را روی درخت‌ها انجام می‌دهد. این گذر
عملیات‌های کپی غیرضروری را حذف می‌کند. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR
و بالاتر فعال است.
.IP \fB\-fipa\-pure\-const\fR 4
.IX Item "-fipa-pure-const"
توابعی را که خالص (pure) یا ثابت (constant) هستند شناسایی می‌کند.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-reference\fR 4
.IX Item "-fipa-reference"
متغیرهای ایستایی (static) را که از واحد کامپایل خارج نمی‌شوند، شناسایی
می‌کند.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-reference\-addressable\fR 4
.IX Item "-fipa-reference-addressable"
متغیرهای ایستای فقط‌خواندنی، فقط‌نوشتنی و غیرقابل‌آدرس‌دهی را شناسایی می‌کند.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-reorder\-for\-locality\fR 4
.IX Item "-fipa-reorder-for-locality"
زنجیره‌های فراخوانی را در چیدمان باینری نزدیک به هم گروه‌بندی می‌کند تا موضعیت
کد بهبود یافته و فواصل پرش بین توابعی که مرتباً فراخوانی می‌شوند به حداقل
برسد. برخلاف \fB\-freorder\-functions\fR، این گذر زنجیره‌های فراخوانی بین
توابع را در نظر گرفته و آن‌ها را با یکدیگر گروه‌بندی می‌کند، به‌جای اینکه همه
توابع داغ/عادی/سرد/هرگز اجرا‌نشده را در بخش‌های جداگانه قرار دهد. برخلاف
\fB\-fprofile\-reorder\-functions\fR، هدف آن بهبود موضعیت کد در طول کل
زمان اجرای برنامه است، به‌جای اینکه تنها بر زمان راه‌اندازی برنامه تمرکز کند.
این گزینه با گزینه صریح \&\fB\-flto\-partition=\fR ناسازگار است، چرا که
یک طرح پارتیشن‌بندی سفارشی را اعمال می‌کند. در صورت استفاده از این گزینه،
توصیه می‌شود از بازخورد پروفایل (profile feedback) نیز استفاده شود، اما در
غیر این صورت این گزینه به‌طور پیش‌فرض فعال نیست.
.IP \fB\-fipa\-stack\-alignment\fR 4
.IX Item "-fipa-stack-alignment"
تراز پشته (stack alignment) را در جایگاه‌های فراخوانی در صورت امکان کاهش می‌دهد.
به‌طور پیش‌فرض فعال است.
.IP \fB\-fipa\-pta\fR 4
.IX Item "-fipa-pta"
تحلیل بینارویه‌ای اشاره‌گر و تحلیل بینارویه‌ای تغییر و ارجاع را انجام می‌دهد.
این گزینه می‌تواند در واحدهای کامپایل بزرگ باعث مصرف بیش‌ازحد حافظه و زمان
کامپایل شود. این گزینه در هیچ سطح بهینه‌سازی به‌طور پیش‌فرض فعال نیست.
.IP \fB\-fipa\-profile\fR 4
.IX Item "-fipa-profile"
انتشار بینارویه‌ای پروفایل را انجام می‌دهد. توابعی که تنها از توابع سرد
فراخوانی می‌شوند، به‌عنوان سرد (cold) علامت‌گذاری می‌شوند. همچنین توابعی
که یک‌بار اجرا می‌شوند (مانند \&\f(CW\*(C`cold\*(C'\fR، \f(CW\*(C`noreturn\*(C'\fR،
سازنده‌ها یا نابودکننده‌های ایستا) شناسایی می‌شوند. سپس توابع سرد و
بخش‌های فاقد حلقه از توابعی که یک‌بار اجرا می‌شوند، برای اندازه بهینه‌سازی
می‌گردند.
به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-modref\fR 4
.IX Item "-fipa-modref"
تحلیل بینارویه‌ای mod/ref را انجام می‌دهد. این بهینه‌سازی عوارض جانبی
توابع (مکان‌هایی از حافظه که تغییر یافته یا به آن‌ها ارجاع داده می‌شود)
را تحلیل کرده و بهینه‌سازی بهتری را در مرزهای فراخوانی تابع ممکن می‌سازد.
این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fipa\-cp\fR 4
.IX Item "-fipa-cp"
انتشار بینارویه‌ای مقادیر ثابت را انجام می‌دهد.
این بهینه‌سازی برنامه را تحلیل می‌کند تا مشخص شود چه زمانی مقادیر ارسالی
به توابع ثابت هستند و سپس بر این اساس بهینه‌سازی می‌کند.
این بهینه‌سازی در صورتی که برنامه مقادیر ثابتی داشته باشد که به توابع
ارسال می‌شوند، می‌تواند کارایی را به‌میزان قابل‌توجهی افزایش دهد.
این پرچم به‌طور پیش‌فرض در \fB\-O2\fR، \fB\-Os\fR و \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR نیز فعال می‌شود.
.IP \fB\-fipa\-cp\-clone\fR 4
.IX Item "-fipa-cp-clone"
شبیه‌سازی تابع (function cloning) را انجام می‌دهد تا انتشار بینارویه‌ای مقادیر
ثابت قوی‌تر شود. در زمان فعال بودن، انتشار بینارویه‌ای مقادیر ثابت هنگامی
که تابعی با دید بیرونی بتواند با آرگومان‌های ثابت فراخوانی شود، شبیه‌سازی
تابع را انجام می‌دهد. از آنجا که این بهینه‌سازی می‌تواند چندین رونوشت از
توابع ایجاد کند، ممکن است اندازه کد را به‌میزان چشمگیری افزایش دهد.
این پرچم به‌طور پیش‌فرض در \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR نیز فعال می‌شود.
.IP \fB\-fipa\-bit\-cp\fR 4
.IX Item "-fipa-bit-cp"
در صورت فعال بودن، انتشار بیتی بینارویه‌ای مقادیر ثابت را انجام می‌دهد.
این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و توسط \fB\-fprofile\-use\fR و
\fB\-fauto\-profile\fR فعال است.
این گزینه نیازمند فعال بودن \fB\-fipa\-cp\fR است.
.IP \fB\-fipa\-vrp\fR 4
.IX Item "-fipa-vrp"
در صورت فعال بودن، انتشار بینارویه‌ای بازه‌های مقادیر را انجام می‌دهد.
این پرچم به‌طور پیش‌فرض در \fB\-O2\fR فعال است. این گزینه نیازمند
فعال بودن \fB\-fipa\-cp\fR است.
.IP \fB\-fipa\-icf\-functions\fR 4
.IX Item "-fipa-icf-functions"
.PD 0
.IP \fB\-fipa\-icf\-variables\fR 4
.IX Item "-fipa-icf-variables"
.IP \fB\-fipa\-icf\fR 4
.IX Item "-fipa-icf"
.PD
تاکردن کدهای یکسان (Identical Code Folding) را برای توابع (\fB\-fipa\-icf\-functions\fR)،
متغیرهای فقط‌خواندنی (\fB\-fipa\-icf\-variables\fR)، یا هر دو
(\fB\-fipa\-icf\fR) انجام می‌دهد.
این بهینه‌سازی اندازه کد را کاهش می‌دهد و ممکن است با جایگزین کردن
یک تابع با تابعی معادل با نامی متفاوت، پشته‌های بازگشایی (unwind stacks)
را دچار اختلال کند. این بهینه‌سازی زمانی که بهینه‌سازی زمان پیوند فعال
باشد، مؤثرتر عمل می‌کند.
.Sp
اگرچه رفتار آن مشابه بهینه‌سازی ICF در Gold Linker است، اما ICF در GCC
در سطوح متفاوتی عمل می‌کند و بنابراین بهینه‌سازی‌ها یکسان نیستند \- هم‌ارزی‌هایی
وجود دارند که تنها توسط GCC یافت می‌شوند و هم‌ارزی‌هایی که تنها توسط Gold پیدا می‌شوند.
.Sp
\&\fB\-fipa\-icf\fR به‌طور پیش‌فرض در \fB\-O2\fR و \fB\-Os\fR فعال است.
.IP \fB\-flate\-combine\-instructions\fR 4
.IX Item "-flate-combine-instructions"
دو گذر ترکیب دستورالعمل‌ها را که نسبتاً در مراحل پایانی فرایند کامپایل
اجرا می‌شوند فعال می‌کند. یکی از گذرها پیش از تخصیص ثبات‌ها و دیگری
پس از تخصیص ثبات‌ها اجرا می‌شود. هدف اصلی این گذرها جایگزینی تعاریف
در تمام موارد استفاده است.
.Sp
بیشتر معماری‌های مقصد این پرچم را به‌طور پیش‌فرض در \fB\-O2\fR و \fB\-Os\fR
فعال می‌کنند.
.IP \fB\-flive\-patching=\fR\fIlevel\fR 4
.IX Item "-flive-patching=level"
بهینه‌سازی‌های GCC را برای تولید خروجی مناسب برای وصله‌زنی زنده (live\-patching)
کنترل می‌کند.
.Sp
اگر بهینه‌سازی کامپایلر از بدنه یک تابع یا اطلاعات استخراج‌شده از بدنه آن
برای بهینه‌سازی/تغییر تابعی دیگر استفاده کند، به تابع دوم یک تابع متأثر
از تابع اول گفته می‌شود. اگر یک تابع وصله شود، توابع متأثر آن نیز باید
وصله شوند.
.Sp
توابع متأثر توسط بهینه‌سازی‌های بینارویه‌ای کامپایلر تعیین می‌شوند.
برای نمونه، یک فراخواننده متأثر می‌شود هنگامی که یک تابع درون فراخواننده‌اش
درون‌خط‌سازی شود، تابعی شبیه‌سازی شده و فراخواننده آن تغییر کند تا این
کلون جدید را فراخوانی کند، یا اطلاعات خالص/ثابت بودن تابع استخراج شود تا
فراخواننده‌های مستقیم یا غیرمستقیم آن بهینه‌سازی شوند، و غیره.
.Sp
معمولاً هر چه بهینه‌سازی‌های IPA بیشتری فعال باشند، تعداد توابع متأثر
برای هر تابع بیشتر خواهد بود. به‌منظور کنترل تعداد توابع متأثر و محاسبه
آسان‌تر فهرست توابع متأثر، بهینه‌سازی‌های IPA می‌توانند به‌صورت جزئی
در دو سطح مختلف فعال شوند.
.Sp
آرگومان \fIlevel\fR باید یکی از موارد زیر باشد:
.RS 4
.IP \fBinline\-clone\fR 4
.IX Item "inline-clone"
تنها بهینه‌سازی‌های درون‌خط‌سازی و شبیه‌سازی را فعال می‌کند، که شامل
درون‌خط‌سازی، شبیه‌سازی، جایگزینی اسکالر بینارویه‌ای تجمیع‌ها و
درون‌خط‌سازی جزئی است. در نتیجه، هنگام وصله‌زنی یک تابع، تمام فراخواننده‌های
آن و فراخواننده‌های کلون‌های آن متأثر می‌شوند، بنابراین لازم است آن‌ها نیز
وصله شوند.
.Sp
گزینه \&\fB\-flive\-patching=inline\-clone\fR پرچم‌های بهینه‌سازی زیر را
غیرفعال می‌کند:
\&\fB\-fwhole\-program  \-fipa\-pta  \-fipa\-reference  \-fipa\-ra
\&\-fipa\-icf  \-fipa\-icf\-functions  \-fipa\-icf\-variables
\&\-fipa\-bit\-cp  \-fipa\-vrp  \-fipa\-pure\-const
\&\-fipa\-reference\-addressable
\&\-fipa\-stack\-alignment \-fipa\-modref\fR
.IP \fBinline\-only\-static\fR 4
.IX Item "inline-only-static"
تنها درون‌خط‌سازی توابع ایستا را فعال می‌کند.
در نتیجه، هنگام وصله‌زنی یک تابع ایستا، تمام فراخواننده‌های آن متأثر شده
و بنابراین لازم است آن‌ها نیز وصله شوند.
.Sp
علاوه بر تمام پرچم‌هایی که \fB\-flive\-patching=inline\-clone\fR غیرفعال
می‌کند، \&\fB\-flive\-patching=inline\-only\-static\fR پرچم‌های بهینه‌سازی
اضافی زیر را نیز غیرفعال می‌کند:
\&\fB\-fipa\-cp\-clone  \-fipa\-sra  \-fpartial\-inlining  \-fipa\-cp\fR
.RE
.RS 4
.Sp
هنگامی که \fB\-flive\-patching\fR بدون مشخص کردن هیچ مقداری تعیین شود،
مقدار پیش‌فرض \fIinline\-clone\fR است.
.Sp
این پرچم به‌طور پیش‌فرض غیرفعال است.
.Sp
توجه داشته باشید که \fB\-flive\-patching\fR همراه با بهینه‌سازی زمان
پیوند (\fB\-flto\fR) پشتیبانی نمی‌شود.
.RE.IP \fB\-fisolate\-erroneous\-paths\-dereference\fR 4
.IX Item "-fisolate-erroneous-paths-dereference"
مسیرهایی را شناسایی می‌کند که به دلیل ارجاع‌زدایی از یک اشاره‌گر تهی (در صورت فعال بودن \fB\-fdelete\-null\-pointer\-checks\fR) یا تقسیم بر صفر، رفتارهای نادرست یا تعریف‌نشده ایجاد می‌کنند. این مسیرها را از جریان اصلی کنترل جدا کرده و دستور دارای رفتار نادرست یا تعریف‌نشده را به یک تله (trap) تبدیل می‌کند. این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-fisolate\-erroneous\-paths\-attribute\fR 4
.IX Item "-fisolate-erroneous-paths-attribute"
مسیرهایی را شناسایی می‌کند که به دلیل استفاده از یک مقدار تهی به روشی که توسط صفت \f(CW\*(C`returns_nonnull\*(C'\fR یا \f(CW\*(C`nonnull\*(C'\fR منع شده است، رفتار نادرست یا تعریف‌نشده ایجاد می‌کنند. این مسیرها را از جریان اصلی کنترل جدا کرده و دستور دارای رفتار نادرست یا تعریف‌نشده را به یک تله (trap) تبدیل می‌کند. این گزینه در حال حاضر فعال نیست، اما ممکن است در آینده در \fB\-O2\fR فعال شود.
.IP \fB\-ftree\-sink\fR 4
.IX Item "-ftree-sink"
انتقال رو به جلوی ذخیره‌سازی (forward store motion) را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-bit\-ccp\fR 4
.IX Item "-ftree-bit-ccp"
انتشار ثابت بیتی شرطی پراکنده را روی درخت‌ها انجام داده و اطلاعات هم‌ترازی اشاره‌گر را منتشر می‌کند.
این گذر فقط روی متغیرهای اسکالر محلی عمل می‌کند و به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر، به جز \fB\-Og\fR، فعال است.
این گزینه نیازمند فعال بودن \fB\-ftree\-ccp\fR است.
.IP \fB\-ftree\-ccp\fR 4
.IX Item "-ftree-ccp"
انتشار ثابت شرطی پراکنده (CCP) را روی درخت‌ها انجام می‌دهد. این گذر فقط روی متغیرهای اسکالر محلی عمل می‌کند و به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fssa\-backprop\fR 4
.IX Item "-fssa-backprop"
اطلاعات مربوط به استفاده‌های یک مقدار را در طول زنجیرهٔ تعریف به سمت بالا منتشر می‌کند تا تعاریف را ساده‌تر سازد. برای مثال، اگر علامت یک مقدار هرگز اهمیتی نداشته باشد، این گذر عملیات علامت را حذف می‌کند. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fssa\-phiopt\fR 4
.IX Item "-fssa-phiopt"
تطبیق الگو را روی گره‌های SSA PHI برای بهینه‌سازی کد شرطی انجام می‌دهد. این گذر به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر، به جز \fB\-Og\fR، فعال است.
.IP \fB\-ftree\-switch\-conversion\fR 4
.IX Item "-ftree-switch-conversion"
تبدیل مقداردهی‌های اولیهٔ ساده در یک switch به مقداردهی‌های اولیه از یک آرایهٔ اسکالر را انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-ftree\-tail\-merge\fR 4
.IX Item "-ftree-tail-merge"
دنبال دنباله‌های کُد یکسان می‌گردد. در صورت یافتن، یکی را با یک پرش به دیگری جایگزین می‌کند. این بهینه‌سازی به عنوان ادغام دنباله (tail merging) یا پرش متقاطع (cross jumping) شناخته می‌شود. این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است. زمان کامپایل در این گذر را می‌توان با استفاده از پارامتر \fBmax\-tail\-merge\-comparisons\fR و پارامتر \&\fBmax\-tail\-merge\-iterations\fR محدود کرد.
.IP \fB\-ftree\-cselim\fR 4
.IX Item "-ftree-cselim"
حذف ذخیره‌سازی شرطی را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر در مقصدهایی که دارای دستورالعمل‌های جابه‌جایی شرطی (conditional move) هستند فعال است.
.IP \fB\-ftree\-dce\fR 4
.IX Item "-ftree-dce"
حذف کد مرده (DCE) را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-builtin\-call\-dce\fR 4
.IX Item "-ftree-builtin-call-dce"
حذف کد مردهٔ (DCE) شرطی را برای فراخوانی‌های توابع توکار (built\-in) انجام می‌دهد که ممکن است \f(CW\*(C`errno\*(C'\fR را مقداردهی کنند ولی در غیر این صورت فاقد اثر جانبی هستند. این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است، در صورتی که \fB\-Os\fR نیز مشخص نشده باشد.
.IP \fB\-ffinite\-loops\fR 4
.IX Item "-ffinite-loops"
فرض می‌کند که یک حلقه با شرط خروج، سرانجام خارج خواهد شد و بی‌نهایت تکرار نمی‌شود. این کار به کامپایلر اجازه می‌دهد حلقه‌هایی را که در غیر این صورت اثر جانبی ندارند حذف کند و احتمال تکرار بی‌پایان را به عنوان اثر جانبی در نظر نگیرد.
.Sp
این گزینه به‌طور پیش‌فرض در \fB\-O2\fR برای ++C با std=c++11\- یا بالاتر فعال است.
.IP \fB\-ftree\-dominator\-opts\fR 4
.IX Item "-ftree-dominator-opts"
مجموعه‌ای از پاک‌سازی‌های سادهٔ اسکالر (انتشار ثابت/رونوشت، حذف افزونگی، انتشار بازه و ساده‌سازی عبارت) را بر پایهٔ پیمایش درخت تسلط (dominator tree) انجام می‌دهد. این گزینه همچنین رزوه‌کشی پرش (jump threading) را برای کاهش پرش‌های متوالی انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-dse\fR 4
.IX Item "-ftree-dse"
حذف ذخیره‌سازی مرده (DSE) را روی درخت‌ها انجام می‌دهد. ذخیره‌سازی مرده، ذخیره‌سازی در مکانی از حافظه است که بعداً بدون هیچ بارگذاری میانی توسط ذخیره‌سازی دیگری بازنویسی می‌شود. در این حالت می‌توان ذخیره‌سازی پیشین را حذف کرد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-ch\fR 4
.IX Item "-ftree-ch"
رونوشت‌برداری از سرآیند حلقه را روی درخت‌ها انجام می‌دهد. این عمل سودمند است زیرا کارایی بهینه‌سازی‌های جابه‌جایی کد را افزایش می‌دهد. همچنین باعث صرفه‌جویی در یک پرش می‌شود. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است. این گزینه برای \fB\-Os\fR فعال نیست، زیرا معمولاً اندازهٔ کد را افزایش می‌دهد.
.IP \fB\-ftree\-loop\-optimize\fR 4
.IX Item "-ftree-loop-optimize"
بهینه‌سازی‌های حلقه را روی درخت‌ها انجام می‌دهد. این پرچم به‌طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-loop\-linear\fR 4
.IX Item "-ftree-loop-linear"
.PD 0
.IP \fB\-floop\-strip\-mine\fR 4
.IX Item "-floop-strip-mine"
.IP \fB\-floop\-block\fR 4
.IX Item "-floop-block"
.PD
بهینه‌سازی‌های حلقه‌های تودرتو را انجام می‌دهد. همانند \&\fB\-floop\-nest\-optimize\fR عمل می‌کند. برای استفاده از این دگرگونی کد، GCC باید با \fB\-\-with\-isl\fR پیکربندی شده باشد تا زیرساخت دگرگونی حلقهٔ Graphite فعال گردد.
.IP \fB\-fgraphite\-identity\fR 4
.IX Item "-fgraphite-identity"
دگرگونی همانی (identity transformation) را برای graphite فعال می‌کند. برای هر SCoP نمایش چندوجهی را تولید کرده و آن را دوباره به gimple تبدیل می‌کند. با استفاده از \&\fB\-fgraphite\-identity\fR می‌توان هزینه‌ها یا مزایای دگرگونی GIMPLE \-> GRAPHITE \-> GIMPLE را بررسی کرد. برخی بهینه‌سازی‌های جزئی نیز توسط تولیدکنندهٔ کد isl انجام می‌شود، مانند تفکیک نمایه و حذف کد مرده در حلقه‌ها.
.IP \fB\-floop\-nest\-optimize\fR 4
.IX Item "-floop-nest-optimize"
بهینه‌ساز حلقه‌های تودرتوی مبتنی بر isl را فعال می‌کند. این یک بهینه‌ساز عمومی حلقه‌های تودرتو بر پایهٔ الگوریتم‌های بهینه‌سازی Pluto است. این گزینه ساختار حلقه‌ای را محاسبه می‌کند که برای محلی بودن داده‌ها و موازی‌سازی بهینه شده است. این گزینه آزمایشی است.
.IP \fB\-floop\-parallelize\-all\fR 4
.IX Item "-floop-parallelize-all"
از تحلیل وابستگی دادهٔ Graphite برای شناسایی حلقه‌هایی که قابلیت موازی‌سازی دارند استفاده می‌کند. تمام حلقه‌هایی را که پس از تحلیل مشخص شود فاقد وابستگی‌های وابسته به دور حلقه (loop-carried dependences) هستند، بدون بررسی سودبخش بودن موازی‌سازی آن‌ها، موازی می‌کند.
.IP \fB\-ftree\-coalesce\-vars\fR 4
.IX Item "-ftree-coalesce-vars"
هنگام انتقال برنامه به خارج از نمایش SSA، با ادغام کردن نسخه‌های متغیرهای گوناگون تعریف‌شده توسط کاربر به‌جای متغیرهای موقت کامپایلر، برای کاهش رونوشت‌برداری تلاش می‌کند. این کار ممکن است توانایی اشکال‌زدایی برنامه‌ای بهینه‌شده را که با \&\fB\-fno\-var\-tracking\-assignments\fR کامپایل شده است، به‌شدت محدود کند. در حالت نفی، این پرچم از ادغام متغیرهای کاربر در SSA جلوگیری می‌کند. این گزینه در صورت فعال بودن بهینه‌سازی، به‌طور پیش‌فرض فعال است و در غیر این صورت کار چندانی انجام نمی‌دهد.
.IP \fB\-ftree\-loop\-if\-convert\fR 4
.IX Item "-ftree-loop-if-convert"
تلاش می‌کند تا پرش‌های شرطی در درونی‌ترین حلقه‌ها را به معادل‌های بدون انشعاب تبدیل کند. هدف، حذف جریان کنترل از درونی‌ترین حلقه‌ها است تا توانایی گذر بردارسازی (vectorization pass) برای مدیریت این حلقه‌ها بهبود یابد. این پرچم در صورت فعال بودن بردارسازی، به‌طور پیش‌فرض فعال است.
.IP \fB\-ftree\-loop\-distribution\fR 4
.IX Item "-ftree-loop-distribution"
توزیع حلقه را انجام می‌دهد. این پرچم می‌تواند کارایی حافظهٔ پنهان را روی بدنه‌های بزرگ حلقه بهبود داده و امکان اعمال بهینه‌سازی‌های بیشتر روی حلقه، مانند موازی‌سازی یا بردارسازی را فراهم کند. برای نمونه، حلقهٔ
.Sp
.Vb 4
\&        DO I = 1, N
\&          A(I) = B(I) + C
\&          D(I) = E(I) * F
\&        ENDDO
.Ve
.Sp
تبدیل می‌شود به
.Sp
.Vb 6
\&        DO I = 1, N
\&           A(I) = B(I) + C
\&        ENDDO
\&        DO I = 1, N
\&           D(I) = E(I) * F
\&        ENDDO
.Ve
.Sp
این پرچم به‌طور پیش‌فرض در \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-ftree\-loop\-distribute\-patterns\fR 4
.IX Item "-ftree-loop-distribute-patterns"
توزیع الگوهایی از حلقه را انجام می‌دهد که می‌توانند با فراخوانی‌هایی به یک کتابخانه کد تولید کنند. این پرچم به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر، و توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال است.
.Sp
این گذر حلقه‌های مقداردهی اولیه را توزیع کرده و فراخوانی به memset صفر تولید می‌کند. برای نمونه، حلقهٔ
.Sp.Vb 4
\&        DO I = 1, N
\&          A(I) = 0
\&          B(I) = A(I) + I
\&        ENDDO
.Ve
.Sp
تبدیل می‌شود به
.Sp
.Vb 6
\&        DO I = 1, N
\&           A(I) = 0
\&        ENDDO
\&        DO I = 1, N
\&           B(I) = A(I) + I
\&        ENDDO
.Ve
.Sp
و حلقه مقداردهی اولیه به یک فراخوانی memset با صفر تبدیل می‌شود.
.IP \fB\-floop\-interchange\fR 4
.IX Item "-floop-interchange"
تعویض حلقه (loop interchange) را بیرون از graphite انجام می‌دهد. این پرچم می‌تواند کارایی حافظه نهان (کَش) را در حلقه‌های تو در تو بهبود بخشیده و اجازه دهد بهینه‌سازی‌های بیشتری روی حلقه‌ها، مانند برداری‌سازی (vectorization)، صورت گیرد. برای مثال، حلقه
.Sp
.Vb 4
\&        for (int i = 0; i < N; i++)
\&          for (int j = 0; j < N; j++)
\&            for (int k = 0; k < N; k++)
\&              c[i][j] = c[i][j] + a[i][k]*b[k][j];
.Ve
.Sp
تبدیل می‌شود به
.Sp
.Vb 4
\&        for (int i = 0; i < N; i++)
\&          for (int k = 0; k < N; k++)
\&            for (int j = 0; j < N; j++)
\&              c[i][j] = c[i][j] + a[i][k]*b[k][j];
.Ve
.Sp
این پرچم به طور پیش‌فرض در \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-floop\-unroll\-and\-jam\fR 4
.IX Item "-floop-unroll-and-jam"
تبدیل‌های باز کردن و ادغام حلقه (unroll and jam) را روی حلقه‌های امکان‌پذیر اعمال می‌کند. در حلقه‌های تو در تو، این کار حلقه بیرونی را با یک ضریب باز کرده و چندین حلقه درونی حاصل را با یکدیگر ادغام می‌کند. این پرچم به طور پیش‌فرض در \fB\-O3\fR فعال است. همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-ftree\-loop\-im\fR 4
.IX Item "-ftree-loop-im"
انتقال عبارات ناوردا در حلقه (loop invariant motion) را روی درخت‌ها انجام می‌دهد. این گذر فقط ناورداهایی را جابه‌جا می‌کند که مدیریت آن‌ها در سطح RTL دشوار است (فراخوانی‌های توابع، عملیاتی که به دنباله‌های غیربدیهی از دستورالعمل‌ها (insns) گسترش می‌یابند). همراه با \fB\-funswitch\-loops\fR، این گزینه همچنین عملوندهای شروطی که ناوردا هستند را به بیرون از حلقه منتقل می‌کند تا بتوان در تعویض شاخه حلقه (loop unswitching) تنها از تحلیل ناوردایی ساده استفاده کرد. این گذر شامل انتقال ذخیره‌سازی (store motion) نیز می‌شود.
.IP \fB\-ftree\-loop\-ivcanon\fR 4
.IX Item "-ftree-loop-ivcanon"
یک شمارنده متعارف (canonical) برای تعداد تکرار در حلقه‌هایی ایجاد می‌کند که تعیین تعداد تکرار آن‌ها نیازمند تحلیلی پیچیده است. پس از آن، بهینه‌سازی‌های بعدی می‌توانند این تعداد را به آسانی تعیین کنند. این قابلیت به ویژه در ارتباط با باز کردن حلقه (unrolling) مفید است.
.IP \fB\-ftree\-scev\-cprop\fR 4
.IX Item "-ftree-scev-cprop"
جایگزینی مقدار نهایی (final value replacement) را انجام می‌دهد. اگر متغیری در یک حلقه به گونه‌ای تغییر یابد که مقدار آن هنگام خروج از حلقه تنها با استفاده از مقدار اولیه و تعداد تکرارهای حلقه قابل محاسبه باشد، استفاده‌ها از مقدار نهایی را با چنین محاسباتی جایگزین می‌کند، به شرطی که هزینه محاسباتی آن به قدر کافی کم باشد. این امر وابستگی‌های داده‌ای را کاهش داده و ممکن است ساده‌سازی‌های بیشتری را میسر سازد. به طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-fivopts\fR 4
.IX Item "-fivopts"
بهینه‌سازی‌های متغیر القایی (کاهش توان محاسباتی (strength reduction)، ادغام متغیر القایی و حذف متغیر القایی) را روی درخت‌ها انجام می‌دهد. به طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-parallelize\-loops\fR 4
.IX Item "-ftree-parallelize-loops"
.PD 0
.IP \fB\-ftree\-parallelize\-loops=\fR\fIn\fR 4
.IX Item "-ftree-parallelize-loops=n"
.PD
حلقه‌ها را موازی‌سازی می‌کند، یعنی فضای تکرار آن‌ها را برای اجرا در چندین ریسه (thread) تقسیم می‌کند. این بهینه‌سازی تنها برای حلقه‌هایی ممکن است که تکرارهای آن‌ها مستقل از یکدیگر بوده و ترتیب اجرای آن‌ها به طور دلخواه قابل جابه‌جایی باشد. این بهینه‌سازی تنها روی ماشین‌های چندپردازنده‌ای و برای حلقه‌هایی که از نظر پردازشی سنگین هستند (CPU\-intensive)، نه حلقه‌هایی که مثلاً با پهنای باند حافظه محدود شده‌اند، سودمند است. این گزینه متضمن \fB\-pthread\fR است و از این رو تنها روی مقصدهایی پشتیبانی می‌شود که از \fB\-pthread\fR پشتیبانی می‌کنند.
.Sp
هنگامی که یک مقدار مثبت \fIn\fR مشخص شود، تعداد ریسه‌ها در زمان کامپایل ثابت شده و پس از کامپایل قابل تغییر نیست. کامپایلر عبارت "#pragma omp parallel num_threads(\fIn\fR)" را تولید می‌کند.
.Sp
هنگامی که بدون \f(CW\*(C`=\fR\f(CIn\fR\f(CW\*(C'\fR استفاده شود (یعنی \fB\-ftree\-parallelize\-loops\fR)، تعداد ریسه‌ها در زمان اجرای برنامه از طریق متغیر محیطی \fBOMP_NUM_THREADS\fR تعیین می‌شود. اگر \fBOMP_NUM_THREADS\fR تنظیم نشده باشد، محیط زمان اجرای OpenMP به طور خودکار تعداد پردازنده‌های در دسترس را شناسایی کرده و از آن مقدار استفاده می‌کند. این ویژگی امکان ساخت باینری‌هایی را فراهم می‌کند که بدون نیاز به کامپایل مجدد با پیکربندی‌های سخت‌افزاری مختلف سازگار می‌شوند.
.IP \fB\-ftree\-pta\fR 4
.IX Item "-ftree-pta"
تحلیل اشاره‌گری محلی به تابع (function\-local points\-to analysis) را روی درخت‌ها انجام می‌دهد. این پرچم به طور پیش‌فرض در \fB\-O1\fR و بالاتر، به جز در \fB\-Og\fR، فعال است.
.IP \fB\-ftree\-sra\fR 4
.IX Item "-ftree-sra"
جایگزینی اسکالر ساختارها (scalar replacement of aggregates) را انجام می‌دهد. این گذر ارجاع‌های به ساختار را با متغیرهای اسکالر جایگزین می‌کند تا از ارسال زودهنگام ساختارها به حافظه جلوگیری کند. این پرچم به طور پیش‌فرض در \fB\-O1\fR و بالاتر، به جز در \fB\-Og\fR، فعال است.
.IP \fB\-fstore\-merging\fR 4
.IX Item "-fstore-merging"
ادغام ذخیره‌سازی‌های باریک در آدرس‌های حافظه متوالی را انجام می‌دهد. این گذر ذخیره‌سازی‌های پیوسته مقادیر بی‌واسطه که باریک‌تر از یک کلمه (word) هستند را در ذخیره‌سازی‌های عریض‌تر اما با تعداد کمتر ادغام می‌کند تا تعداد دستورالعمل‌ها کاهش یابد. این پرچم به طور پیش‌فرض در \fB\-O2\fR و بالاتر و همچنین در \fB\-Os\fR فعال است.
.IP \fB\-ftree\-ter\fR 4
.IX Item "-ftree-ter"
جایگزینی عبارات موقت را در طول مرحله SSA\->normal انجام می‌دهد. متغیرهای موقتی که تک‌بار تعریف و تک‌بار استفاده شده‌اند در محل استفاده‌شان با عبارت تعریف‌کننده جایگزین می‌شوند. این عمل به ایجاد کدی غیر از GIMPLE منجر می‌شود، اما درخت‌های بسیار پیچیده‌تری را برای کار در اختیار بسط‌دهنده‌ها (expanders) قرار می‌دهد که به تولید کد بهتر در RTL می‌انجامد. این پرچم به طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-slsr\fR 4
.IX Item "-ftree-slsr"
کاهش توان محاسباتی در خط مستقیم (straight\-line strength reduction) را روی درخت‌ها انجام می‌دهد. این عمل عبارات مرتبط شامل ضرب را شناسایی کرده و در صورت امکان آن‌ها را با محاسبات ارزان‌تر جایگزین می‌کند. این پرچم به طور پیش‌فرض در \fB\-O1\fR و بالاتر فعال است.
.IP \fB\-ftree\-vectorize\fR 4
.IX Item "-ftree-vectorize"
برداری‌سازی (vectorization) را روی درخت‌ها انجام می‌دهد. این پرچم در صورت عدم تعیین صریح، گزینه‌های \fB\-ftree\-loop\-vectorize\fR و \fB\-ftree\-slp\-vectorize\fR را فعال می‌کند.
.IP \fB\-ftree\-loop\-vectorize\fR 4
.IX Item "-ftree-loop-vectorize"
برداری‌سازی حلقه را روی درخت‌ها انجام می‌دهد. این پرچم به طور پیش‌فرض در \fB\-O2\fR و توسط گزینه‌های \fB\-ftree\-vectorize\fR، \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-ftree\-slp\-vectorize\fR 4
.IX Item "-ftree-slp-vectorize"
برداری‌سازی بلوک پایه (basic block vectorization) را روی درخت‌ها انجام می‌دهد. این پرچم به طور پیش‌فرض در \fB\-O2\fR و توسط گزینه‌های \fB\-ftree\-vectorize\fR، \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-ftrivial\-auto\-var\-init=\fR\fIchoice\fR 4
.IX Item "-ftrivial-auto-var-init=choice"
متغیرهای خودکار یا اشیاء موقت را با یک الگو یا با صفر مقداردهی اولیه می‌کند تا با جلوگیری از افشا و استفاده از حافظه مقداردهی‌نشده، امنیت و پیش‌بینی‌پذیری برنامه افزایش یابد.
GCC همچنان متغیر خودکاری را که فاقد مقدارده اولیه صریح است مقداردهی‌نشده در نظر می‌گیرد؛ گزینه‌های \fB\-Wuninitialized\fR و \fB\-Wanalyzer\-use\-of\-uninitialized\-value\fR همچنان پیام‌های هشدار را در مورد چنین متغیرهای خودکار یا اشیاء موقتی گزارش خواهند داد و کامپایلر بهینه‌سازی‌ها را به گونه‌ای انجام می‌دهد که گویی متغیر مقداردهی اولیه نشده است.
با این گزینه، GCC همچنین هرگونه لایه پرکننده (padding) مربوط به متغیرهای خودکار یا اشیاء موقتی را که دارای نوع داده ساختار (structure) یا اجتماع (union) هستند، با صفر مقداردهی اولیه می‌کند.
با این حال، پیاده‌سازی فعلی نمی‌تواند متغیرهای خودکاری را که مقداردهی اولیه آن‌ها از طریق دستورات \f(CW\*(C`switch\*(C'\fR یا \f(CW\*(C`goto\*(C'\fR دور زده شده است، مقداردهی اولیه کند. از گزینه \fB\-Wtrivial\-auto\-var\-init\fR برای گزارش تمام چنین مواردی استفاده کنید.
.Sp
سه مقدار ممکن برای \fIchoice\fR عبارتند از:
.RS 4
.IP * 4
\&\fBuninitialized\fR هیچ متغیر خودکاری را مقداردهی اولیه نمی‌کند.
.IP * 4
\&\fBpattern\fR متغیرهای خودکار را با مقادیری مقداردهی اولیه می‌کند که به احتمال زیاد باگ‌های منطقی را در ادامه مسیر به از کار افتادن برنامه (crash) تبدیل می‌کنند، در گزارش‌های خرابی (crash dump) به آسانی قابل تشخیص هستند و مقادیری نیستند که برنامه‌نویسان بتوانند برای رفتارهای مفید برنامه به آن‌ها تکیه کنند.
مقدار فعلی الگویی تکرارشونده در سطح بایت با مقدار "0xFE" است.
مقادیر استفاده‌شده برای مقداردهی اولیه با الگو ممکن است در آینده تغییر کنند.
.IP * 4
\&\fBzero\fR متغیرهای خودکار را با صفر مقداردهی اولیه می‌کند.
.RE
.RS 4
.Sp
حالت پیش‌فرض \fBuninitialized\fR است به جز در C++26، که در این حالت اگر \fB\-ftrivial\-auto\-var\-init=\fR به کلی مشخص نشده باشد، متغیرهای خودکار یا اشیاء موقت با صفر مقداردهی اولیه می‌شوند، اما مقداردهی اولیه بیت‌های پرکننده با صفر صورت نمی‌گیرد.
.Sp
توجه داشته باشید که مقادیر اولیه، چه \fBzero\fR و چه \fBpattern\fR، به شیوه نمایش داده‌ها (در حافظه یا ثبات‌های ماشین) اشاره دارند و نه به تفسیر آن‌ها به عنوان مقادیر عددی. این تمایز ممکن است در زبان‌هایی که از انواع دارای انحراف (bias) یا ضرایب ضمنی پشتیبانی می‌کنند و با افزونه‌هایی نظیر \fBhardbool\fR اهمیت داشته باشد. برای مثال، متغیری که از ۸ بیت برای نمایش مقادیر (دارای انحراف) در \f(CW\*(C`range 160..400\*(C'\fR استفاده می‌کند، بسته به \fIchoice\fR با الگوهای بیتی \f(CW0x00\fR یا \f(CW0xFE\fR مقداردهی اولیه می‌شود؛ چه این نمایش‌ها نشان‌دهنده مقادیری در آن محدوده باشند یا خیر، و حتی اگر باشند، تفسیر مقدار موجود در متغیر به انحراف بستگی خواهد داشت. متغیر \fBhardbool\fR که فرضا از \f(CW0x5A\fR و \f(CW0xA5\fR به ترتیب برای \f(CW\*(C`false\*(C'\fR و \f(CW\*(C`true\*(C'\fR استفاده می‌کند، با هر یک از مقادیر انتخابی (\fBchoice\fR) مقدارده اولیه بدیهی متوقف می‌شود (trap)؛ یعنی مقداردهی اولیه \fBzero\fR به نمایش \f(CW\*(C`false\*(C'\fR تبدیل نمی‌شود، حتی اگر برای یک متغیر \f(CW\*(C`static\*(C'\fR از همان نوع چنین تبدیلی رخ دهد. این یعنی الگوی مقدارده اولیه به طور کلی به نوع متغیر مقداردهی‌شده وابسته نیست. یک استثنای قابل توجه این است که متغیرهای بولی (غیرمقاوم‌سازی‌شده) که درون ثبات‌ها جا می‌گیرند، حتی در صورت درخواست \fBpattern\fR، با مقدار \f(CW\*(C`false\*(C'\fR (صفر) مقداردهی اولیه می‌شوند.
.Sp
می‌توانید این رفتار را برای متغیری خاص با استفاده از ویژگی استاندارد متغیر \f(CW\*(C`uninitialized\*(C'\fR یا ویژگی استاندارد در C++26 یعنی \f(CW\*(C`[[indeterminate]]\*(C'\fR کنترل کنید.
.RE.IP \fB\-fvect\-cost\-model=\fR\fImodel\fR 4
.IX Item "-fvect-cost-model=model"
مدل هزینه مورد استفاده برای برداری‌سازی (vectorization) را تغییر می‌دهد. آرگومان \fImodel\fR
باید یکی از مقادیر \fBunlimited\fR، \fBdynamic\fR، \fBcheap\fR یا
\&\fBvery\-cheap\fR باشد.
با مدل \fBunlimited\fR فرض می‌شود که مسیر کد برداری‌شده سودمند است، در حالی
که در مدل \fBdynamic\fR یک بررسی زمان اجرا از مسیر کد برداری‌شده محافظت می‌کند تا تنها
برای تعداد تکرارهایی فعال شود که احتمالاً سریع‌تر از اجرای حلقه اسکالر اصلی اجرا می‌شوند.
مدل \fBcheap\fR برداری‌سازی حلقه‌هایی را که انجام آن هزینه‌بر و غیراقتصادی است (برای نمونه
به دلیل بررسی‌های زمان اجرای لازم برای وابستگی داده‌ها یا ترازسازی) غیرفعال می‌کند،
اما در غیر این صورت معادل مدل \fBdynamic\fR است. مدل \fBvery\-cheap\fR در صورتی
که هرگونه بررسی زمان اجرا برای وابستگی داده یا ترازسازی نیاز باشد، برداری‌سازی حلقه‌ها را
غیرفعال می‌سازد؛ این مدل همچنین برداری‌سازی حلقه‌های موخره (epilogue) را نیز غیرفعال
می‌کند، اما در غیر این صورت معادل مدل \fBcheap\fR است.
.Sp
مدل هزینه پیش‌فرض به سایر پرچم‌های بهینه‌سازی بستگی دارد و یکی از مقادیر
\fBdynamic\fR یا \fBcheap\fR است.
.IP \fB\-fsimd\-cost\-model=\fR\fImodel\fR 4
.IX Item "-fsimd-cost-model=model"
مدل هزینه مورد استفاده برای برداری‌سازی حلقه‌های نشانه‌گذاری‌شده با رهنمود
simd در OpenMP را تغییر می‌دهد. آرگومان \fImodel\fR باید یکی از مقادیر
\&\fBunlimited\fR، \fBdynamic\fR یا \fBcheap\fR باشد. تمامی مقادیر \fImodel\fR
همان معنای شرح داده شده در \fB\-fvect\-cost\-model\fR را دارند و به‌طور
پیش‌فرض از مدل هزینه تعریف‌شده با \fB\-fvect\-cost\-model\fR استفاده می‌شود.
.IP \fB\-ftree\-vrp\fR 4
.IX Item "-ftree-vrp"
انتشار بازه مقادیر (Value Range Propagation) را روی درخت‌ها انجام می‌دهد. این
عملیات مشابه گذر انتشار مقادیر ثابت (constant propagation) است، اما به جای
مقادیر، بازه‌ای از مقادیر منتشر می‌شوند. این امر به بهینه‌سازها امکان می‌دهد تا بررسی‌های
بازه غیرضروری مانند بررسی مرزهای آرایه و بررسی‌های اشاره‌گر تهی (null pointer) را
حذف کنند. این گزینه به‌طور پیش‌فرض در \fB\-O2\fR و بالاتر فعال است. حذف بررسی
اشاره‌گر تهی تنها در صورتی انجام می‌شود که \fB\-fdelete\-null\-pointer\-checks\fR
فعال باشد.
.IP \fB\-fsplit\-paths\fR 4
.IX Item "-fsplit-paths"
مسیرهای منتهی به یال‌های بازگشتی (backedges) حلقه را تقسیم می‌کند. این می‌تواند
حذف کدهای مرده (dead code elimination) و حذف زیرعبارت‌های مشترک
(common subexpression elimination) را بهبود بخشد. این گزینه به‌طور پیش‌فرض
در \fB\-O3\fR و بالاتر فعال است.
.IP \fB\-fsplit\-ivs\-in\-unroller\fR 4
.IX Item "-fsplit-ivs-in-unroller"
بیان مقادیر متغیرهای القایی (induction variables) را در تکرارهای بعدی حلقه
بازشده، با استفاده از مقدار موجود در اولین تکرار فعال می‌کند. این کار زنجیره‌های
طولانی وابستگی را می‌شکند و در نتیجه کارایی گذرهای زمان‌بندی (scheduling) را
بهبود می‌بخشد.
.Sp
ترکیبی از \fB\-fweb\fR و CSE اغلب برای دستیابی به همین نتیجه کافی است. با این حال،
در مواردی که بدنه حلقه پیچیده‌تر از یک بلوک پایه منفرد باشد، قابل اعتماد نیست. همچنین در
برخی معماری‌ها به دلیل محدودیت‌های موجود در گذر CSE اصلاً کار نمی‌کند.
.Sp
این بهینه‌سازی به‌طور پیش‌فرض فعال است.
.IP \fB\-fvariable\-expansion\-in\-unroller\fR 4
.IX Item "-fvariable-expansion-in-unroller"
با این گزینه، کامپایلر هنگام باز کردن یک حلقه، چندین رونوشت از برخی متغیرهای
محلی ایجاد می‌کند که می‌تواند به کدی با کارایی برتر منجر شود.
.Sp
این بهینه‌سازی به‌طور پیش‌فرض برای اهداف PowerPC فعال است، اما در غیر این صورت
به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-fpartial\-inlining\fR 4
.IX Item "-fpartial-inlining"
بخش‌هایی از توابع را درون‌خطی (inline) می‌کند. این گزینه تنها زمانی اثرگذار است
که درون‌خطی‌سازی از طریق گزینه‌های \fB\-finline\-functions\fR یا
\fB\-finline\-small\-functions\fR فعال شده باشد.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fpredictive\-commoning\fR 4
.IX Item "-fpredictive-commoning"
بهینه‌سازی اشتراک‌پیش‌بینانه (predictive commoning) را انجام می‌دهد؛ یعنی استفاده
مجدد از محاسباتی (به‌ویژه بارگذاری‌ها و ذخیره‌سازی‌های حافظه) که در تکرارهای قبلی
حلقه‌ها انجام شده‌اند.
.Sp
این گزینه در سطح \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR نیز فعال می‌شود.
.IP \fB\-fprefetch\-loop\-arrays\fR 4
.IX Item "-fprefetch-loop-arrays"
در صورت پشتیبانی توسط ماشین مقصد، دستورالعمل‌هایی برای پیش‌واکشی (prefetch)
حافظه تولید می‌کند تا عملکرد حلقه‌هایی که به آرایه‌های بزرگ دسترسی دارند بهبود یابد.
.Sp
این گزینه ممکن است کد بهتر یا بدتری تولید کند؛ نتایج به‌شدت به ساختار حلقه‌ها
درون کد منبع بستگی دارد.
.Sp
در سطح \fB\-Os\fR غیرفعال است.
.IP \fB\-fno\-printf\-return\-value\fR 4
.IX Item "-fno-printf-return-value"
مقادیر ثابت را جایگزین مقدار بازگشتی شناخته‌شده توابع خروجی قالب‌بندی‌شده مانند
\f(CW\*(C`sprintf\*(C'\fR، \f(CW\*(C`snprintf\*(C'\fR، \f(CW\*(C`vsprintf\*(C'\fR و
\&\f(CW\*(C`vsnprintf\*(C'\fR (اما نه \f(CW\*(C`printf\*(C'\fR یا \f(CW\*(C`fprintf\*(C'\fR) نمی‌کند. این
تبدیل به GCC امکان می‌دهد تا شاخه‌ها را بر اساس مقدار بازگشتی معلوم این توابع، در
صورتی که با آرگومان‌های ثابت یا آرگومان‌هایی فراخوانی شوند که مشخصاً مقادیر آن‌ها در
بازه‌ای قرار دارد که تعیین مقدار بازگشتی دقیق را امکان‌پذیر می‌سازد، بهینه‌سازی کرده یا حتی
حذف کند. به عنوان مثال، هنگامی که \&\fB\-fprintf\-return\-value\fR فعال باشد،
هم شاخه و هم بدنه دستور \f(CW\*(C`if\*(C'\fR (اما نه فراخوانی \f(CW\*(C`snprint\*(C'\fR) می‌توانند
در صورتی که \f(CW\*(C`i\*(C'\fR یک عدد صحیح ۳۲ بیتی یا کوچک‌تر باشد به طور کامل حذف شوند،
زیرا تضمین می‌شود که مقدار بازگشتی حداکثر ۸ خواهد بود.
.Sp
.Vb 3
\&        char buf[9];
\&        if (snprintf (buf, "%08x", i) >= sizeof buf)
\&          ...
.Ve
.Sp
گزینه \fB\-fprintf\-return\-value\fR به بهینه‌سازی‌های دیگر متکی است و در
سطح \fB\-O2\fR و بالاتر بهترین نتایج را ارائه می‌دهد. این گزینه همراه با گزینه‌های
\fB\-Wformat\-overflow\fR و \fB\-Wformat\-truncation\fR عمل می‌کند.
گزینه \fB\-fprintf\-return\-value\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-fno\-peephole\fR 4
.IX Item "-fno-peephole"
.PD 0
.IP \fB\-fno\-peephole2\fR 4
.IX Item "-fno-peephole2"
.PD
هرگونه بهینه‌سازی روزنه‌ای (peephole) وابسته به ماشین را غیرفعال می‌کند. تفاوت بین
\fB\-fno\-peephole\fR و \fB\-fno\-peephole2\fR در نحوه پیاده‌سازی آن‌ها در
کامپایلر است؛ برخی معماری‌های مقصد از یکی، برخی از دیگری و تعداد معدودی از هر دو استفاده می‌کنند.
.Sp
\&\fB\-fpeephole\fR به‌طور پیش‌فرض فعال است.
\&\fB\-fpeephole2\fR در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fno\-guess\-branch\-probability\fR 4
.IX Item "-fno-guess-branch-probability"
احتمالات شاخه‌بندی را با استفاده از روش‌های ابتکاری (heuristics) حدس نمی‌زند.
.Sp
اگر احتمالات شاخه‌بندی توسط بازخورد پروفایل‌سازی (\fB\-fprofile\-arcs\fR) ارائه نشده
باشند، GCC از روش‌های ابتکاری برای حدس زدن آن‌ها استفاده می‌کند. این روش‌های ابتکاری
مبتنی بر گراف جریان کنترل (control flow graph) هستند. اگر برخی از احتمالات شاخه‌بندی
توسط \f(CW\*(C`_\|_builtin_expect\*(C'\fR مشخص شده باشند، از روش‌های ابتکاری برای
حدس زدن احتمالات شاخه‌بندی سایر بخش‌های گراف جریان کنترل، با در نظر گرفتن اطلاعات
\f(CW\*(C`_\|_builtin_expect\*(C'\fR، استفاده می‌شود. تعامل بین روش‌های ابتکاری و
\f(CW\*(C`_\|_builtin_expect\*(C'\fR می‌تواند پیچیده باشد، و در برخی موارد، غیرفعال کردن
روش‌های ابتکاری ممکن است سودمند باشد تا فهم اثرات \f(CW\*(C`_\|_builtin_expect\*(C'\fR
آسان‌تر شود.
.Sp
همچنین می‌توان با استفاده از تابع توکار \f(CW\*(C`_\|_builtin_expect_with_probability\*(C'\fR
احتمال مورد انتظار عبارت را مشخص کرد.
.Sp
پیش‌فرض در سطوح \&\fB\-O\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR گزینه
\fB\-fguess\-branch\-probability\fR است.
.IP \fB\-freorder\-blocks\fR 4
.IX Item "-freorder-blocks"
بلوک‌های پایه را در تابع کامپایل‌شده بازآرایی می‌کند تا تعداد شاخه‌های پرش‌شده (taken branches)
را کاهش داده و محلی‌بودن کد (code locality) را بهبود بخشد.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-freorder\-blocks\-algorithm=\fR\fIalgorithm\fR 4
.IX Item "-freorder-blocks-algorithm=algorithm"
از الگوریتم مشخص‌شده برای بازآرایی بلوک‌های پایه استفاده می‌کند. آرگومان
\&\fIalgorithm\fR می‌تواند \fBsimple\fR باشد که حجم کد را افزایش نمی‌دهد
(به جز مواردی که به دلیل اثرات ثانویه مانند ترازسازی رخ می‌دهد)، یا \fBstc\fR باشد که
همان الگوریتم "software trace cache" است و تلاش می‌کند تمام کدهای پرکاربرد را در
کنار یکدیگر قرار دهد و با ایجاد رونوشت‌های اضافی از کد، تعداد شاخه‌های اجراشده را به
حداقل برساند.
.Sp
پیش‌فرض در سطوح \fB\-O1\fR و \fB\-Os\fR برابر با \fBsimple\fR است، و
در سطوح \fB\-O2\fR و \fB\-O3\fR برابر با \&\fBstc\fR است.
.IP \fB\-freorder\-blocks\-and\-partition\fR 4
.IX Item "-freorder-blocks-and-partition"
علاوه بر بازآرایی بلوک‌های پایه در تابع کامپایل‌شده به منظور کاهش تعداد شاخه‌های پرش‌شده،
بلوک‌های پایه داغ (hot) و سرد (cold) را به بخش‌های جداگانه‌ای در فایل‌های اسمبلی و
\fI.o\fR افراز (partition) می‌کند تا کارایی صفحه‌بندی (paging) و محلی‌بودن حافظه نهان (cache locality)
بهبود یابد.
.Sp
این بهینه‌سازی در حضور مدیریت استثنا یا جدول‌های بازپیچی (unwind tables) (در مقاصدی که
از setjump/longjump یا طرح‌های مختص مقصد استفاده می‌کنند)، برای بخش‌های linkonce،
برای توابعی با مشخصه بخش تعریف‌شده توسط کاربر، و در هر معماری که از بخش‌های نام‌گذاری‌شده
پشتیبانی نمی‌کند، به‌طور خودکار خاموش می‌شود. هنگامی که \fB\-fsplit\-stack\fR استفاده می‌شود،
این گزینه به‌طور پیش‌فرض فعال نیست (برای جلوگیری از خطاهای پیونددهنده)، اما می‌تواند به‌صراحت
فعال شود (در صورت استفاده از یک پیونددهنده سازگار).
.Sp
برای x86 در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-freorder\-functions\fR 4
.IX Item "-freorder-functions"
توابع را در فایل هدف (object file) بازآرایی می‌کند تا محلی‌بودن کد را بهبود بخشد. برخلاف
\fB\-fipa\-reorder\-for\-locality\fR، این گزینه گروه‌بندی تمامی توابع درون یک دسته
(داغ/عادی/سرد/هرگز اجرا نشده) را در کنار هم در اولویت قرار می‌دهد. این کار با استفاده از
زیربخش‌های ویژه \f(CW\*(C`.text.hot\*(C'\fR برای پرکاربردترین توابع و \f(CW\*(C`.text.unlikely\*(C'\fR
برای توابعی که بعید است اجرا شوند پیاده‌سازی می‌شود. بازآرایی توسط پیونددهنده انجام می‌گیرد،
بنابراین قالب فایل هدف باید از بخش‌های نام‌گذاری‌شده پشتیبانی کند و پیونددهنده باید آن‌ها را
به شکلی مناسب جای‌گذاری نماید.
.Sp
این گزینه اثری نخواهد داشت مگر اینکه بازخورد پروفایل‌سازی ارائه دهید (برای جزئیات
\fB\-fprofile\-arcs\fR را ببینید) یا توابع را به صورت دستی با مشخصه‌های
\&\f(CW\*(C`hot\*(C'\fR یا \f(CW\*(C`cold\*(C'\fR نشانه‌گذاری کنید.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است..IP \fB\-fstrict\-aliasing\fR 4
.IX Item "-fstrict-aliasing"
به کامپایلر اجازه می‌دهد سخت‌گیرانه‌ترین قواعد نام‌مستعار (aliasing) قابل اعمال بر
زبانی که در حال کامپایل است را فرض کند. برای C (و ++C)، این گزینه
بهینه‌سازی‌ها را بر پایهٔ نوع عبارات فعال می‌کند. به‌ویژه، دسترسی به
یک شیء از یک نوع از طریق عبارتی از نوعی متفاوت مجاز نیست،
مگر اینکه نوع‌ها \fIانواع سازگار\fR (\fIcompatible types\fR) باشند، تنها در علامت‌دار بودن یا
توصیف‌کننده‌ها (qualifiers) تفاوت داشته باشند، یا عبارت دارای نوع نویسه‌ای (character type) باشد. دسترسی
به اشیای اسکالر از طریق یک نوع برداری متناظر نیز مجاز است.
.Sp
برای نمونه، یک \f(CW\*(C`unsigned int\*(C'\fR می‌تواند برای یک \f(CW\*(C`int\*(C'\fR نام‌مستعار باشد، اما نه
برای یک \&\f(CW\*(C`void*\*(C'\fR یا یک \f(CW\*(C`double\*(C'\fR. یک نوع نویسه‌ای می‌تواند برای هر نوع دیگری نام‌مستعار واقع شود.
.Sp
به کدهایی از این دست توجه ویژه داشته باشید:
.Sp
.Vb 4
\&        union a_union {
\&          int i;
\&          double d;
\&        };
\&        
\&        int f() {
\&          union a_union t;
\&          t.d = 3.0;
\&          return t.i;
\&        }
.Ve
.Sp
شیوهٔ خواندن از عضوی از union غیر از آن که اخیراً درونش
نوشته شده است (که «type\-punning» نامیده می‌شود) متداول است. حتی با
\&\fB\-fstrict\-aliasing\fR نیز استفاده از type\-punning در C مجاز است، به شرطی که حافظه
از طریق نوع union مورد دسترسی قرار گیرد. در ISO C++، عمل type\-punning از طریق نوع union
رفتاری تعریف‌نشده (undefined behavior) است، اما GCC آن را به عنوان یک افزونه (extension) پشتیبانی می‌کند. بنابراین، کد
بالا طبق انتظار کار می‌کند. با این حال، کد زیر ممکن است این‌گونه نباشد:
.Sp
.Vb 7
\&        int f() {
\&          union a_union t;
\&          int* ip;
\&          t.d = 3.0;
\&          ip = &t.i;
\&          return *ip;
\&        }
.Ve
.Sp
به همین ترتیب، دسترسی از طریق گرفتن آدرس، تبدیل نوع (cast) اشاره‌گر حاصل
و ارجاع‌زدایی (dereference) نتیجه دارای رفتاری تعریف‌نشده است، حتی اگر تبدیل نوع
از یک نوع union استفاده کند، مانند:
.Sp
.Vb 4
\&        int f() {
\&          double d = 3.0;
\&          return ((union a_union *) &d)\->i;
\&        }
.Ve
.Sp
گزینهٔ \fB\-fstrict\-aliasing\fR در سطوح
\&\fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال می‌شود.
.IP \fB\-fipa\-strict\-aliasing\fR 4
.IX Item "-fipa-strict-aliasing"
کنترل می‌کند که آیا قواعد \fB\-fstrict\-aliasing\fR در سرتاسر
مرزهای توابع اعمال شوند یا خیر. توجه داشته باشید که اگر چندین تابع در یک
تابع منفرد درون‌خطی (inline) شوند، دسترسی‌های حافظه دیگر عبور از مرز
تابع محسوب نمی‌شوند.
.Sp
گزینهٔ \fB\-fipa\-strict\-aliasing\fR به صورت پیش‌فرض فعال است و
تنها در ترکیب با \fB\-fstrict\-aliasing\fR مؤثر واقع می‌شود.
.IP \fB\-falign\-functions\fR 4
.IX Item "-falign-functions"
.PD 0
.IP \fB\-falign\-functions=\fR\fIn\fR 4
.IX Item "-falign-functions=n"
.IP \fB\-falign\-functions=\fR\fIn\fR\fB:\fR\fIm\fR 4
.IX Item "-falign-functions=n:m"
.IP \fB\-falign\-functions=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR 4
.IX Item "-falign-functions=n:m:n2"
.IP \fB\-falign\-functions=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR\fB:\fR\fIm2\fR 4
.IX Item "-falign-functions=n:m:n2:m2"
.PD
شروع توابع را در توانِ دوِ بعدی که بزرگ‌تر یا مساوی
\fIn\fR است هم‌تراز می‌کند، با صرف‌نظر کردن از حداکثر \fIm\fR\-1 بایت. این کار تضمین می‌کند که
دست‌کم \fIm\fR بایت ابتدایی تابع بتواند توسط پردازنده
بدون عبور از مرز هم‌ترازیِ \fIn\fR بایتی واکشی (fetch) شود.
این یک بهینه‌سازی برای کارایی کد است و از هم‌ترازی برای
توابعی که سرد (cold) در نظر گرفته شوند صرف‌نظر می‌شود. اگر هم‌ترازی برای تمام توابع الزامی است،
از \fB\-fmin\-function\-alignment\fR استفاده کنید.
.Sp
اگر \fIm\fR تعیین نشده باشد، مقدار پیش‌فرض آن \fIn\fR خواهد بود.
.Sp
مثال‌ها: \fB\-falign\-functions=32\fR توابع را در مرز ۳۲ بایتی
بعدی هم‌تراز می‌کند، \fB\-falign\-functions=24\fR تنها در صورتی در مرز
۳۲ بایتی بعدی هم‌تراز می‌کند که این کار با رد کردن ۲۳ بایت یا کمتر امکان‌پذیر باشد،
و \&\fB\-falign\-functions=32:7\fR تنها زمانی در مرز
۳۲ بایتی بعدی هم‌تراز می‌کند که این کار با رد کردن ۶ بایت یا کمتر میسر باشد.
.Sp
جفت دوم از مقادیر \fIn2\fR:\fIm2\fR به شما امکان می‌دهد
یک هم‌ترازی ثانویه تعیین کنید: \fB\-falign\-functions=64:7:32:3\fR در صورتی که
امکان رد کردن ۶ بایت یا کمتر وجود داشته باشد در مرز ۶۴ بایتی بعدی هم‌تراز می‌کند،
در غیر این صورت اگر این کار با رد کردن ۲ بایت یا کمتر میسر باشد، در مرز
۳۲ بایتی بعدی هم‌تراز می‌کند.
اگر \fIm2\fR تعیین نشده باشد، مقدار پیش‌فرض آن برابر با \fIn2\fR خواهد بود.
.Sp
برخی از اسمبلرها تنها زمانی از این پرچم پشتیبانی می‌کنند که \fIn\fR توانی از دو باشد؛
در آن صورت، مقدار به بالا گرد می‌شود.
.Sp
گزینه‌های \&\fB\-fno\-align\-functions\fR و \fB\-falign\-functions=1\fR
معادل یکدیگرند و به این معنی هستند که توابع هم‌تراز نمی‌شوند.
.Sp
اگر \fIn\fR مشخص نشده یا صفر باشد، از یک مقدار پیش‌فرض وابسته به ماشین استفاده می‌شود.
حداکثر مقدار مجاز برای گزینهٔ \fIn\fR برابر با ۶۵۵۳۶ است.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال می‌شود.
.IP \fB\-flimit\-function\-alignment\fR 4
.IX Item "-flimit-function-alignment"
اگر این گزینه فعال باشد، کامپایلر تلاش می‌کند از هم‌ترازی بیش‌از‌حد
و غیرضروری توابع خودداری کند. کامپایلر سعی می‌کند به اسمبلر دستور دهد به میزانی
که توسط \fB\-falign\-functions\fR مشخص شده هم‌ترازی را انجام دهد، اما
بیشتر از اندازهٔ خود تابع بایت رد نکند.
.IP \fB\-falign\-labels\fR 4
.IX Item "-falign-labels"
.PD 0
.IP \fB\-falign\-labels=\fR\fIn\fR 4
.IX Item "-falign-labels=n"
.IP \fB\-falign\-labels=\fR\fIn\fR\fB:\fR\fIm\fR 4
.IX Item "-falign-labels=n:m"
.IP \fB\-falign\-labels=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR 4
.IX Item "-falign-labels=n:m:n2"
.IP \fB\-falign\-labels=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR\fB:\fR\fIm2\fR 4
.IX Item "-falign-labels=n:m:n2:m2"
.PD
تمام مقصدهای انشعاب (branch targets) را روی یک مرز توانِ دو هم‌تراز می‌کند.
.Sp
پارامترهای این گزینه مشابه گزینهٔ \fB\-falign\-functions\fR هستند.
\&\fB\-fno\-align\-labels\fR و \fB\-falign\-labels=1\fR
معادل یکدیگرند و به این معنی هستند که برچسب‌ها هم‌تراز نمی‌شوند.
.Sp
اگر \fB\-falign\-loops\fR یا \fB\-falign\-jumps\fR قابل اعمال بوده و
بزرگ‌تر از این مقدار باشند، آن‌گاه از مقادیر آن‌ها به جای آن استفاده می‌شود.
.Sp
اگر \fIn\fR مشخص نشده یا صفر باشد، از یک پیش‌فرض وابسته به ماشین استفاده می‌شود
که به احتمال زیاد \fB1\fR است، یعنی بدون هم‌ترازی.
حداکثر مقدار مجاز برای گزینهٔ \fIn\fR برابر با ۶۵۵۳۶ است.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال می‌شود.
.IP \fB\-falign\-loops\fR 4
.IX Item "-falign-loops"
.PD 0
.IP \fB\-falign\-loops=\fR\fIn\fR 4
.IX Item "-falign-loops=n"
.IP \fB\-falign\-loops=\fR\fIn\fR\fB:\fR\fIm\fR 4
.IX Item "-falign-loops=n:m"
.IP \fB\-falign\-loops=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR 4
.IX Item "-falign-loops=n:m:n2"
.IP \fB\-falign\-loops=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR\fB:\fR\fIm2\fR 4
.IX Item "-falign-loops=n:m:n2:m2"
.PD
حلقه‌ها را روی یک مرز توانِ دو هم‌تراز می‌کند. اگر حلقه‌ها به
دفعات زیادی اجرا شوند، این کار هرگونه اجرای دستورالعمل‌های لایهٔ پرکنندهٔ ساختگی (dummy padding)
را جبران می‌کند.
این یک بهینه‌سازی برای کارایی کد است و از هم‌ترازی برای
حلقه‌هایی که سرد (cold) در نظر گرفته شوند صرف‌نظر می‌شود.
.Sp
اگر مقدار \fB\-falign\-labels\fR بزرگ‌تر از این مقدار باشد، به جای آن
از مقدار آن استفاده خواهد شد.
.Sp
پارامترهای این گزینه مشابه گزینهٔ \fB\-falign\-functions\fR هستند.
\&\fB\-fno\-align\-loops\fR و \fB\-falign\-loops=1\fR
معادل یکدیگرند و به این معنی هستند که حلقه‌ها هم‌تراز نمی‌شوند.
حداکثر مقدار مجاز برای گزینهٔ \fIn\fR برابر با ۶۵۵۳۶ است.
.Sp
اگر \fIn\fR مشخص نشده یا صفر باشد، از یک مقدار پیش‌فرض وابسته به ماشین استفاده می‌شود.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال می‌شود.
.IP \fB\-falign\-jumps\fR 4
.IX Item "-falign-jumps"
.PD 0
.IP \fB\-falign\-jumps=\fR\fIn\fR 4
.IX Item "-falign-jumps=n"
.IP \fB\-falign\-jumps=\fR\fIn\fR\fB:\fR\fIm\fR 4
.IX Item "-falign-jumps=n:m".IP \fB\-falign\-jumps=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR 4
.IX Item "-falign-jumps=n:m:n2"
.IP \fB\-falign\-jumps=\fR\fIn\fR\fB:\fR\fIm\fR\fB:\fR\fIn2\fR\fB:\fR\fIm2\fR 4
.IX Item "-falign-jumps=n:m:n2:m2"
.PD
تراز کردن مقصدهای انشعاب بر روی مرز توان دو، برای مقصدهای انشعابی که
تنها از طریق پرش قابل دسترسی هستند. در این حالت، نیازی به اجرای
هیچ دستور ساختگی نیست.
این یک بهینه‌سازی کارایی کد است و از ترازسازی برای پرش‌هایی که سرد (cold)
در نظر گرفته می‌شوند، صرف‌نظر می‌شود.
.Sp
اگر \fB\-falign\-labels\fR بزرگ‌تر از این مقدار باشد، مقدار آن
به‌جای این مقدار استفاده می‌شود.
.Sp
پارامترهای این گزینه مشابه با گزینهٔ \fB\-falign\-functions\fR هستند.
\&\fB\-fno\-align\-jumps\fR و \fB\-falign\-jumps=1\fR معادل یکدیگرند
و به این معنا هستند که حلقه‌ها تراز نمی‌شوند.
.Sp
اگر \fIn\fR مشخص نشده باشد یا صفر باشد، از یک پیش‌فرض وابسته به ماشین استفاده می‌شود.
حداکثر مقدار مجاز برای گزینهٔ \fIn\fR برابر با 65536 است.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال می‌شود.
.IP \fB\-fmin\-function\-alignment\fR 4
.IX Item "-fmin-function-alignment"
تعیین حداقل تراز توابع به توان دوی بعدی که بزرگ‌تر یا مساوی با
\fIn\fR باشد. بر خلاف \fB\-falign\-functions\fR، این ترازسازی برای
همهٔ توابع (حتی توابعی که سرد در نظر گرفته شده‌اند) نیز اعمال می‌شود. این ترازسازی همچنین
تحت تأثیر \fB\-flimit\-function\-alignment\fR قرار نمی‌گیرد.
.IP \fB\-fno\-allocation\-dce\fR 4
.IX Item "-fno-allocation-dce"
تخصیص‌های بدون استفادهٔ ++C (با استفاده از عملگر \f(CW\*(C`new\*(C'\fR و عملگر \f(CW\*(C`delete\*(C'\fR)
را در فرایند حذف کدهای مرده (dead code elimination) حذف نکنید.
.Sp
همچنین \fB\-fmalloc\-dce\fR را ببینید.
.IP \fB\-fallow\-store\-data\-races\fR 4
.IX Item "-fallow-store-data-races"
به کامپایلر اجازه می‌دهد بهینه‌سازی‌هایی را انجام دهد که ممکن است شرایط رقابتی داده‌ای (data races)
جدیدی را روی عملیات ذخیره‌سازی ایجاد کند، بدون اینکه اثبات شود متغیر نمی‌تواند به‌طور
هم‌روند توسط ریسمان‌های دیگر مورد دسترسی قرار گیرد. بر بهینه‌سازی داده‌های محلی تأثیری ندارد.
اگر مشخص باشد که داده‌های سراسری توسط چندین ریسمان مورد دسترسی قرار نخواهند گرفت،
استفاده از این گزینه ایمن است.
.Sp
نمونه‌هایی از بهینه‌سازی‌های فعال‌شده توسط \fB\-fallow\-store\-data\-races\fR شامل
بالا کشیدن (hoisting) یا تبدیل‌های شرطی (if\-conversions) است که ممکن است باعث شود مقداری که قبلاً
در حافظه بوده است، مجدداً با همان مقدار بازنویسی شود. چنین بازنویسی‌ای در یک زمینهٔ تک‌ریسمانی
ایمن است اما ممکن است در یک زمینهٔ چندریسمانی ناامن باشد. توجه داشته باشید که در
برخی پردازنده‌ها، ممکن است تبدیل‌های شرطی برای فعال‌سازی برداری‌سازی (vectorization) الزامی باشند.
.Sp
در سطح \fB\-Ofast\fR فعال می‌شود.
.IP \fB\-funit\-at\-a\-time\fR 4
.IX Item "-funit-at-a-time"
این گزینه صرفاً جهت سازگاری باقی مانده است. \fB\-funit\-at\-a\-time\fR
هیچ تأثیری ندارد، در حالی که \fB\-fno\-unit\-at\-a\-time\fR متضمن گزینه‌های
\&\fB\-fno\-toplevel\-reorder\fR و \fB\-fno\-section\-anchors\fR است.
.Sp
به‌طور پیش‌فرض فعال است.
.IP \fB\-fno\-toplevel\-reorder\fR 4
.IX Item "-fno-toplevel-reorder"
توابع، متغیرها و عبارات \f(CW\*(C`asm\*(C'\fR سطح بالا (top\-level) را بازآرایی
نکنید. آن‌ها را به همان ترتیبی که در فایل ورودی ظاهر می‌شوند در خروجی قرار دهید.
هنگامی که از این گزینه استفاده می‌شود، متغیرهای ایستای (static) بدون ارجاع
حذف نمی‌شوند. هدف این گزینه پشتیبانی از کدهای موجودی است که به ترتیبی خاص
متکی هستند. برای کدهای جدید، بهتر است در صورت امکان از صفت‌ها (attributes) استفاده شود.
.Sp
\&\fB\-ftoplevel\-reorder\fR در سطوح \fB\-O1\fR و بالاتر، و
همچنین در \fB\-O0\fR در صورتی که \fB\-fsection\-anchors\fR به‌صراحت درخواست شده باشد، پیش‌فرض است.
علاوه بر این، \fB\-fno\-toplevel\-reorder\fR متضمن
\&\fB\-fno\-section\-anchors\fR نیز است.
.IP \fB\-funreachable\-traps\fR 4
.IX Item "-funreachable-traps"
با این گزینه، کامپایلر فراخوانی‌های
\&\f(CW\*(C`_\|_builtin_unreachable\*(C'\fR را به‌جای استفاده برای بهینه‌سازی،
به تله‌ها (traps) تبدیل می‌کند. این امر همچنین بر تمام فراخوانی‌های از این دست که
به‌طور ضمنی توسط کامپایلر تولید شده باشد اثر می‌گذارد.
.Sp
این گزینه اثری مشابه با \fB\-fsanitize=unreachable
\&\-fsanitize\-trap=unreachable\fR دارد، اما مقادیر آن گزینه‌ها را
تغییر نمی‌دهد. اگر \fB\-fsanitize=unreachable\fR فعال باشد، آن گزینه
بر این گزینه اولویت دارد.
.Sp
این گزینه به‌طور پیش‌فرض در \fB\-O0\fR و \fB\-Og\fR فعال است.
.IP \fB\-fweb\fR 4
.IX Item "-fweb"
تارهای وب (webs) را آن‌طور که معمولاً برای مقاصد تخصیص ثبات به کار می‌رود می‌سازد
و به هر وب یک شبه‌ثبات جداگانه اختصاص می‌دهد. این کار به مرحلهٔ تخصیص ثبات
اجازه می‌دهد مستقیماً روی شبه‌ثبات‌ها عمل کند، اما همچنین چندین مرحلهٔ بهینه‌سازی دیگر
مانند CSE، بهینه‌ساز حلقه و حذف‌کنندهٔ کدهای مردهٔ بدیهی را تقویت می‌نماید. با این حال،
می‌تواند اشکال‌زدایی را غیرممکن کند، چرا که متغیرها دیگر در یک «ثبات مبنا» (home register)
باقی نمی‌مانند.
.Sp
به‌طور پیش‌فرض با \fB\-funroll\-loops\fR فعال می‌شود.
.IP \fB\-fwhole\-program\fR 4
.IX Item "-fwhole-program"
فرض را بر این می‌گذارد که واحد ترجمهٔ فعلی، نمایانگر کل برنامهٔ در حال
کامپایل است. تمامی توابع و متغیرهای عمومی به استثنای \f(CW\*(C`main\*(C'\fR
و مواردی که با صفت \f(CW\*(C`externally_visible\*(C'\fR مشخص شده‌اند به توابع ایستا تبدیل می‌شوند
و در عمل با تهاجم بیشتری توسط بهینه‌سازهای بین‌رویه‌ای بهینه‌سازی می‌گردند.
.Sp
همراه با \fB\-flto\fR این گزینه کاربرد محدودی دارد. در اغلب موارد
فهرست دقیق نمادهای استفاده‌شده یا صادرشده از فایل باینری، از اطلاعات تفکیک
ارسال‌شده به بهینه‌ساز زمان پیوند توسط افزونهٔ پیونددهنده شناخته می‌شود. این گزینه در صورتی که
از هیچ افزونهٔ پیونددهنده‌ای استفاده نشود یا در طول مرحلهٔ پیوند تدریجی هنگام تولید کد نهایی
(با \fB\-flto\fR \&\fB\-flinker\-output=nolto\-rel\fR)، همچنان سودمند است.
.IP \fB\-flto[=\fR\fIn\fR\fB]\fR 4
.IX Item "-flto[=n]"
این گزینه بهینه‌ساز استاندارد زمان پیوند را اجرا می‌کند. هنگامی که
همراه با کد منبع فراخوانی شود، GIMPLE (یکی از نمایش‌های داخلی
GCC) را تولید کرده و آن را در بخش‌های ویژهٔ ELF در فایل هدف
می‌نویسد. هنگامی که فایل‌های هدف به یکدیگر پیوند داده می‌شوند، بدنهٔ تمامی توابع
از این بخش‌های ELF خوانده شده و به گونه‌ای نمونه‌سازی می‌شوند که گویی
همگی بخشی از همان واحد ترجمه بوده‌اند.
.Sp
برای استفاده از بهینه‌ساز زمان پیوند، \fB\-flto\fR و گزینه‌های بهینه‌سازی
باید هم در زمان کامپایل و هم در طول پیوند نهایی مشخص شوند.
توصیه می‌شود تمام فایل‌های حاضر در یک پیوند را با گزینه‌های یکسان کامپایل کنید
و همچنین آن گزینه‌ها را در زمان پیوند نیز مشخص نمایید.
برای مثال:
.Sp
.Vb 3
\&        gcc \-c \-O2 \-flto foo.c
\&        gcc \-c \-O2 \-flto bar.c
\&        gcc \-o myprog \-flto \-O2 foo.o bar.o
.Ve
.Sp
دو فراخوانی نخست GCC یک نمایش بایت‌کدی از GIMPLE را در بخش‌های ویژهٔ ELF
درون \fIfoo.o\fR و \&\fIbar.o\fR ذخیره می‌کنند. فراخوانی نهایی، بایت‌کد GIMPLE را از
\&\fIfoo.o\fR و \fIbar.o\fR می‌خواند، این دو فایل را در یک تصویر داخلی واحد ادغام
کرده و نتیجه را طبق روال معمول کامپایل می‌کند. از آنجا که هر دوی
\&\fIfoo.o\fR و \fIbar.o\fR در یک تصویر واحد ادغام شده‌اند، این امر سبب می‌شود
تمام تحلیل‌ها و بهینه‌سازی‌های بین‌رویه‌ای در GCC در سرتاسر هر دو فایل چنان عمل کنند
که گویی یک فایل واحد هستند. برای مثال این بدان معناست که جای‌گذار درون‌خطی
می‌تواند توابع موجود در \&\fIbar.o\fR را درون توابع موجود در \fIfoo.o\fR
و برعکس به‌صورت درون‌خطی قرار دهد.
.Sp
یک راه دیگر (ساده‌تر) برای فعال‌سازی بهینه‌سازی زمان پیوند عبارت است از:
.Sp
.Vb 1
\&        gcc \-o myprog \-flto \-O2 foo.c bar.c
.Ve
.Sp
دستور بالا بایت‌کد را برای \fIfoo.c\fR و \fIbar.c\fR تولید می‌کند،
آن‌ها را با یکدیگر در یک نمایش GIMPLE واحد ادغام کرده و طبق روال معمول
آن‌ها را بهینه‌سازی می‌کند تا \fImyprog\fR تولید شود.
.Sp
نکتهٔ مهمی که باید به خاطر سپرد این است که برای فعال‌سازی بهینه‌سازی‌های زمان پیوند
باید از راه‌انداز GCC برای اجرای مرحلهٔ پیوند استفاده کنید.
اگر هر یک از فایل‌های هدف درگیر با گزینهٔ خط فرمانی \fB\-flto\fR کامپایل شده باشند،
GCC به‌طور خودکار بهینه‌سازی زمان پیوند را انجام می‌دهد. شما همیشه می‌توانید
با ارسال \fB\-fno\-lto\fR به دستور پیوند، این تصمیم خودکار را
برای انجام بهینه‌سازی زمان پیوند لغو کنید.
.Sp
برای کارآمد ساختن بهینه‌سازی کل برنامه، در نظر گرفتن فرضیات معینی ضروری است.
کامپایلر باید بداند چه توابع و متغیرهایی ممکن است توسط کتابخانه‌ها و زمان‌اجرا
خارج از واحد بهینه‌سازی‌شده در زمان پیوند مورد دسترسی قرار گیرند. هنگامی که توسط پیونددهنده
پشتیبانی شود، افزونهٔ پیونددهنده (گزینهٔ \fB\-fuse\-linker\-plugin\fR را ببینید) اطلاعات مربوط
به نمادهای استفاده‌شده و نمادهای نمایان از بیرون را به کامپایلر ارسال می‌کند. هنگامی که
افزونهٔ پیونددهنده در دسترس نیست، باید از \fB\-fwhole\-program\fR استفاده شود
تا به کامپایلر اجازهٔ در نظر گرفتن این فرضیات داده شود، که خود به
تصمیم‌گیری‌های بهینه‌سازی تهاجمی‌تری منجر می‌گردد.
.Sp
هنگامی که فایلی با \fB\-flto\fR بدون \&\fB\-fuse\-linker\-plugin\fR کامپایل می‌شود،
فایل هدف تولیدشده بزرگ‌تر از یک فایل هدف معمولی است چرا که حاوی بایت‌کدهای GIMPLE
و کد نهایی معمول است (گزینهٔ \fB\-ffat\-lto\-objects\fR را ببینید). این بدان معناست که
فایل‌های هدف دارای اطلاعات LTO می‌توانند مانند فایل‌های هدف عادی پیوند داده شوند؛
اگر \fB\-fno\-lto\fR به پیونددهنده ارسال شود، هیچ بهینه‌سازی بین‌رویه‌ای اعمال نمی‌شود.
توجه داشته باشید که وقتی \&\fB\-fno\-fat\-lto\-objects\fR فعال باشد، مرحلهٔ کامپایل سریع‌تر است
اما نمی‌توانید یک پیوند معمولی و غیر LTO روی آن‌ها انجام دهید.
.Sp
هنگام تولید فایل باینری نهایی، GCC بهینه‌سازی‌های زمان پیوند را تنها روی آن دسته
از فایل‌هایی اعمال می‌کند که حاوی بایت‌کد باشند. بنابراین، می‌توانید فایل‌های هدف و
کتابخانه‌های دارای بایت‌کدهای GIMPLE را با کد هدف نهایی ترکیب و هم‌نشین کنید.
GCC به‌طور خودکار انتخاب می‌کند که کدام فایل‌ها در حالت LTO بهینه‌سازی شوند
و کدام فایل‌ها بدون پردازش بیشتر پیوند داده شوند.
.Sp
به‌طور کلی، گزینه‌های مشخص‌شده در زمان پیوند بر گزینه‌های مشخص‌شده در زمان کامپایل
اولویت دارند، هرچند در برخی موارد GCC تلاش می‌کند گزینه‌های زمان پیوند را
از تنظیمات به‌کاررفته در کامپایل فایل‌های ورودی استنباط کند.
.Sp
اگر در زمان پیوند، گزینهٔ سطح بهینه‌سازی \fB\-O\fR را مشخص نکنید،
GCC از بالاترین سطح بهینه‌سازی استفاده‌شده هنگام کامپایل فایل‌های هدف
استفاده می‌کند. توجه داشته باشید که مشخص کردن گزینهٔ سطح بهینه‌سازی صرفاً در زمان پیوند
و نه در زمان کامپایل، عموماً بی‌اثر است و این موضوع دو دلیل دارد: نخست آنکه کامپایل
بدون بهینه‌سازی، مراحلی از کامپایلر را متوقف می‌کند که اطلاعات مورد نیاز برای بهینه‌سازی مؤثر
در زمان پیوند را جمع‌آوری می‌کنند. دوم آنکه برخی از مراحل آغازین بهینه‌سازی را فقط می‌توان
در زمان کامپایل اجرا کرد و نه در زمان پیوند.
.Sp
برخی از پرچم‌های تولید کد وجود دارند که هنگام تولید بایت‌کدها توسط GCC حفظ می‌شوند،
چرا که باید در طول پیوند نهایی مورد استفاده قرار گیرند. در حال حاضر، گزینه‌های
زیر و تنظیمات آن‌ها از اولین فایل هدفی گرفته می‌شوند که صراحتاً آن‌ها را مشخص کرده باشد:
\&\fB\-fcommon\fR، \fB\-fexceptions\fR، \fB\-fnon\-call\-exceptions\fR،
\&\fB\-fgnu\-tm\fR و تمامی پرچم‌های مقصد \fB\-m\fR.
.Sp
گزینه‌های زیر یعنی \fB\-fPIC\fR، \fB\-fpic\fR، \fB\-fpie\fR و
\&\fB\-fPIE\fR بر اساس طرح زیر با یکدیگر ترکیب می‌شوند:
.Sp.Vb 6
\&        B<\-fPIC> + B<\-fpic> = B<\-fpic>
\&        B<\-fPIC> + B<\-fno\-pic> = B<\-fno\-pic>
\&        B<\-fpic/\-fPIC> + (بدون گزینه) = (بدون گزینه)
\&        B<\-fPIC> + B<\-fPIE> = B<\-fPIE>
\&        B<\-fpic> + B<\-fPIE> = B<\-fpie>
\&        B<\-fPIC/\-fpic> + B<\-fpie> = B<\-fpie>
.Ve
.Sp
برخی پرچم‌های تغییردهندهٔ ABI باید در تمام واحدهای ترجمه یکسان باشند و تلاش برای بازنویسی آن‌ها در زمان پیوند با یک مقدار ناسازگار نادیده گرفته می‌شود. این موارد شامل گزینه‌هایی چون \fB\-freg\-struct\-return\fR و \fB\-fpcc\-struct\-return\fR است.
.Sp
سایر گزینه‌ها مانند \fB\-ffp\-contract\fR، \fB\-fno\-strict\-overflow\fR، \&\fB\-fwrapv\fR، \fB\-fno\-trapv\fR یا \fB\-fno\-strict\-aliasing\fR به مرحلهٔ پیوند ارسال شده و برای واحدهای ترجمهٔ متناقض، به‌طور محافظه‌کارانه ادغام می‌شوند. به‌طور مشخص، \&\fB\-fno\-strict\-overflow\fR، \fB\-fwrapv\fR و \fB\-fno\-trapv\fR اولویت دارند؛ و برای نمونه \fB\-ffp\-contract=off\fR بر \fB\-ffp\-contract=fast\fR ارجحیت دارد. شما می‌توانید آن‌ها را در زمان پیوند بازنویسی کنید.
.Sp
گزینه‌های تشخیصی مانند \fB\-Wstringop\-overflow\fR به مرحلهٔ پیوند منتقل می‌شوند و تنظیمات آن‌ها با مرحلهٔ کامپایل در سطح دانه‌بندی تابع مطابقت دارد. توجه داشته باشید که این موضوع تنها برای پیام‌های تشخیصی صادرشده در حین بهینه‌سازی اهمیت دارد. همچنین توجه داشته باشید که تبدیلات کد مانند درونی‌سازی (inlining) می‌تواند منجر به فعال یا غیرفعال شدن هشدارها برای بخش‌هایی از کد شود، چنانچه با تنظیمات زمان کامپایل سازگار نباشد.
.Sp
هنگامی که نیاز دارید گزینه‌هایی را از طریق \fB\-Wa\fR یا \&\fB\-Xassembler\fR به اسمبلر ارسال کنید، مطمئن شوید که یا چنین واحدهای ترجمه‌ای را با \fB\-fno\-lto\fR کامپایل می‌کنید یا به‌طور یکدست از همان گزینه‌های اسمبلر در تمام واحدهای ترجمه استفاده می‌نمایید. متناوباً می‌توانید گزینه‌های اسمبلر را در زمان پیوند LTO نیز مشخص کنید.
.Sp
برای فعال‌سازی تولید اطلاعات اشکال‌زدایی باید \fB\-g\fR را در زمان کامپایل ارائه دهید. اگر هر یک از فایل‌های ورودی در زمان پیوند با تولید اطلاعات اشکال‌زداییِ فعال ساخته شده باشند، پیونددهنده نیز تولید اطلاعات اشکال‌زدایی را فعال خواهد کرد. هرگونه تنظیمات دقیقِ اطلاعات اشکال‌زدایی مانند سطح dwarf در \fB\-gdwarf\-5\fR باید صراحتاً در خط فرمان پیونددهنده تکرار شود و ترکیب تنظیمات متفاوت در واحدهای ترجمهٔ مختلف توصیه نمی‌شود.
.Sp
اگر LTO با اشیائی با پیوند C (C linkage) مواجه شود که با انواع ناسازگار در واحدهای ترجمهٔ جداگانه‌ای اعلان شده‌اند و قرار است به هم پیوند داده شوند (رفتار تعریف‌نشده بر اساس ISO C99 6.2.7)، ممکن است یک پیام تشخیصی غیرکشنده صادر شود. این رفتار در زمان اجرا همچنان تعریف‌نشده است. هشدارهای تشخیصی مشابهی ممکن است برای سایر زبان‌ها نیز صادر شود.
.Sp
ویژگی دیگر LTO این است که می‌توان بهینه‌سازی‌های بین‌روالی را بر روی فایل‌های نوشته‌شده به زبان‌های مختلف اعمال کرد:
.Sp
.Vb 4
\&        gcc \-c \-flto foo.c
\&        g++ \-c \-flto bar.cc
\&        gfortran \-c \-flto baz.f90
\&        g++ \-o myprog \-flto \-O3 foo.o bar.o baz.o \-lgfortran
.Ve
.Sp
توجه داشته باشید که پیوند نهایی با \fBg++\fR انجام می‌شود تا کتابخانه‌های زمان اجرای C++ دریافت شوند و \fB\-lgfortran\fR نیز برای دریافت کتابخانه‌های زمان اجرای Fortran اضافه شده است. به‌طور کلی، هنگام ترکیب زبان‌ها در حالت LTO، باید از همان گزینه‌های دستور پیوند استفاده کنید که هنگام ترکیب زبان‌ها در کامپایل معمولی (غیر LTO) به کار می‌برید.
.Sp
اگر فایل‌های شیءِ حاوی بایت‌کد GIMPLE در یک بایگانی کتابخانه، مانند \&\fIlibfoo.a\fR ذخیره شده باشند، در صورتی که از پیونددهنده‌ای با پشتیبانی از پلاگین استفاده می‌کنید، استخراج و استفاده از آن‌ها در یک پیوند LTO امکان‌پذیر است. برای ایجاد کتابخانه‌های ایستا مناسب برای LTO، به‌جای \fBar\fR و \fBranlib\fR از \fBgcc\-ar\fR و \fBgcc\-ranlib\fR استفاده کنید؛ برای نمایش نمادهای فایل‌های شیءِ دارای بایت‌کد GIMPLE، از \&\fBgcc\-nm\fR بهره بگیرید. این دستورها مستلزم آن هستند که \fBar\fR، \fBranlib\fR و \fBnm\fR با پشتیبانی از پلاگین کامپایل شده باشند. در زمان پیوند، از پرچم \fB\-fuse\-linker\-plugin\fR استفاده کنید تا اطمینان حاصل شود که کتابخانه در فرایند بهینه‌سازی LTO شرکت می‌کند:
.Sp
.Vb 1
\&        gcc \-o myprog \-O2 \-flto \-fuse\-linker\-plugin a.o b.o \-lfoo
.Ve
.Sp
با فعال بودن پلاگین پیونددهنده، پیونددهنده فایل‌های GIMPLE مورد نیاز را از \fIlibfoo.a\fR استخراج می‌کند و آن‌ها را به GCC در حال اجرا تحویل می‌دهد تا بخشی از تصویر تجمیع‌شدهٔ GIMPLE برای بهینه‌سازی شوند.
.Sp
اگر از پیونددهنده‌ای با پشتیبانی از پلاگین استفاده نمی‌کنید و/یا پلاگین پیونددهنده را فعال نمی‌کنید، اشیاءِ درون \fIlibfoo.a\fR طبق روال معمول استخراج و پیوند داده می‌شوند، اما در فرایند بهینه‌سازی LTO شرکت نمی‌کنند. برای اینکه یک کتابخانهٔ ایستا هم برای بهینه‌سازی LTO و هم برای پیوند معمول مناسب باشد، فایل‌های شیءِ آن را با \&\fB\-flto\fR \fB\-ffat\-lto\-objects\fR کامپایل کنید.
.Sp
بهینه‌سازی‌های زمان پیوند برای عمل‌کردن نیازی به حضور کل برنامه ندارند. اگر برنامه نیازی به برون‌دهی هیچ نمادی نداشته باشد، ترکیب \fB\-flto\fR و \fB\-fwhole\-program\fR ممکن است تا به بهینه‌سازهای بین‌روالی اجازه دهد فرضیات جسورانه‌تری را به کار گیرند که می‌تواند منجر به فرصت‌های بهینه‌سازی بهتری شود. هنگامی که پلاگین پیونددهنده فعال است، نیازی به استفاده از \fB\-fwhole\-program\fR نیست (نگاه کنید به \fB\-fuse\-linker\-plugin\fR).
.Sp
پیاده‌سازی فعلی LTO هیچ تلاشی برای تولید بایت‌کدِ قابل‌حمل میان انواع مختلف میزبان‌ها نمی‌کند. فایل‌های بایت‌کد دارای نگارش هستند و بررسی سخت‌گیرانه‌ای روی نگارش انجام می‌شود، بنابراین فایل‌های بایت‌کد تولیدشده در یک نگارش GCC با نگارش قدیمی‌تر یا جدیدتر GCC کار نمی‌کنند.
.Sp
بهینه‌سازی زمان پیوند با تولید اطلاعات اشکال‌زدایی روی سیستم‌هایی به جز سیستم‌هایی که از ترکیب ELF و DWARF استفاده می‌کنند، به‌خوبی کار نمی‌کند.
.Sp
اگر مقدار اختیاری \fIn\fR را مشخص کنید، بهینه‌سازی و تولید کد انجام‌شده در زمان پیوند با بهره‌گیری از یک برنامهٔ \fBmake\fR نصب‌شده، با استفاده از \fIn\fR وظیفهٔ موازی اجرا می‌شود. متغیر محیطی \fBMAKE\fR می‌تواند برای لغو یا تغییر برنامهٔ مورد استفاده به کار رود.
.Sp
همچنین می‌توانید \fB\-flto=jobserver\fR را تعیین کنید تا از حالت job server در GNU make برای تعیین تعداد وظایف موازی استفاده شود. این قابلیت زمانی مفید است که Makefile فراخوانندهٔ GCC از قبل به‌صورت موازی در حال اجرا باشد. برای کارکرد این قابلیت باید یک \fB+\fR به ابتدای دستور در Makefile والد اضافه کنید. این گزینه احتمالاً تنها در صورتی کار می‌کند که \fBMAKE\fR از نوع GNU make باشد. حتی بدون مقدار این گزینه، GCC تلاش می‌کند یک job server در حال اجرای GNU make را به‌طور خودکار شناسایی کند.
.Sp
از \fB\-flto=auto\fR برای استفاده از job server در GNU make (در صورت وجود) استفاده کنید، یا در غیر این صورت به شناسایی خودکار تعداد رشته‌های (threads) پردازندهٔ موجود در سیستم شما رجوع می‌شود.
.IP \fB\-flto\-partition=\fR\fIalg\fR 4
.IX Item "-flto-partition=alg"
الگوریتم افرازبندیِ استفاده‌شده توسط بهینه‌ساز زمان پیوند را مشخص می‌کند. این مقدار می‌تواند \fB1to1\fR برای تعیین افرازبندی آینه‌ای از فایل‌های منبع اصلی باشد، یا \fBbalanced\fR برای تعیین افرازبندی به بخش‌هایی با اندازهٔ برابر (در صورت امکان)، یا \fBmax\fR برای ایجاد افراز جدید برای هر نماد در صورت امکان، یا \fBcache\fR برای متعادل ساختن اندازهٔ بخش‌ها در عین کنار هم نگه‌داشتن نمادهای مرتبط جهت حافظه‌نهان‌سازی بهتر در LTO افزایشی. تعیین \fBnone\fR به‌عنوان الگوریتم، افرازبندی و جاری‌سازی (streaming) را به‌طور کامل غیرفعال می‌کند. مقدار پیش‌فرض \fBbalanced\fR است. اگرچه می‌توان از \fB1to1\fR به‌عنوان راهکاری برای مشکلات مختلف ترتیب کد استفاده کرد، اما افرازبندی \fBmax\fR صرفاً برای آزمایش‌های داخلی در نظر گرفته شده است. مقدار \fBone\fR مشخص می‌کند که دقیقاً یک افراز باید استفاده شود، در حالی که مقدار \fBnone\fR از افرازبندی صرف‌نظر کرده و مرحلهٔ بهینه‌سازی زمان پیوند را مستقیماً از فاز WPA اجرا می‌کند.
.IP \fB\-flto\-incremental=\fR\fIpath\fR 4
.IX Item "-flto-incremental=path"
فعال‌سازی LTO افزایشی، با قرارگیری حافظهٔ نهان آن در دایرکتوری موجودِ مشخص‌شده. می‌تواند چرخه‌های ویرایش\-کامپایل را با LTO به‌میزان قابل‌توجهی کوتاه‌تر کند.
.Sp
هنگامی که با LTO (\fB\-flto\fR) استفاده شود، خروجی واحدهای ترجمه در داخل LTO در حافظهٔ نهان ذخیره می‌شود. واحدهای ترجمهٔ ذخیره‌شده در حافظهٔ نهان به احتمال زیاد هنگام کامپایل مجدد با تغییرات کوچک کد دوباره استفاده خواهند شد که منجر به کاهش زمان کامپایل مجدد می‌شود.
.Sp
چندین نمونه از GCC می‌توانند به‌طور موازی از یک حافظهٔ نهان یکسان استفاده کنند.
.IP \fB\-flto\-incremental\-cache\-size=\fR\fIn\fR 4
.IX Item "-flto-incremental-cache-size=n"
تعداد مدخل‌های حافظهٔ نهان در LTO افزایشی را مشخص می‌کند که پس از آن، مدخل‌های قدیمی هرس می‌شوند. این یک حد ملایم (soft limit) است و موقتاً ممکن است مدخل‌های بیشتری وجود داشته باشد.
.IP \fB\-flto\-compression\-level=\fR\fIn\fR 4
.IX Item "-flto-compression-level=n"
این گزینه سطح فشرده‌سازیِ استفاده‌شده برای زبان واسط نوشته‌شده در فایل‌های شیء LTO را مشخص می‌کند و تنها همراه با حالت LTO (\fB\-flto\fR) معنا دارد. در حال حاضر GCC از دو الگوریتم فشرده‌سازی LTO پشتیبانی می‌کند. برای zstd، مقادیر معتبر از 0 (بدون فشرده‌سازی) تا 19 (بیشترین فشرده‌سازی) است، در حالی که zlib از مقادیر 0 تا 9 پشتیبانی می‌کند. مقادیر خارج از این محدوده به حداقل یا حداکثر مقادیر پشتیبانی‌شده محدود می‌شوند. اگر این گزینه ارائه نشود، تنظیم پیش‌فرض فشرده‌سازی متوازن استفاده می‌شود.
.IP \fB\-flto\-toplevel\-asm\-heuristics\fR 4
.IX Item "-flto-toplevel-asm-heuristics"
روش‌های مکاشفه‌ای را برای یافتن نمادهای استفاده‌شده در \f(CW\*(C`asm\*(C'\fR پایه در سطح بالا فعال می‌کند. این امر بهینه‌سازی‌های زمان پیوند را که ممکن است باعث تغییر نام یا حذف این نمادها شده و به خطاهای نماد مفقود توسط پیونددهنده منجر شود، محدود می‌کند.
.Sp
این پرچم برای پروژه‌هایی در نظر گرفته شده که هنوز به استفاده از \f(CW\*(C`asm\*(C'\fR گسترش‌یافته در سطح بالا روی نیاورده‌اند، که کاربرد را مستقیماً بدون هیچ مثبت کاذبی مشخص می‌کند.
.Sp
این روش‌های مکاشفه‌ای ساده هستند و کد اسمبلی را تجزیه نمی‌کنند. روش‌های مکاشفه‌ای کل اسمبلی سطح بالا را برای تمام شناسه‌های ممکن بررسی می‌کنند؛ اگر شناسه‌ای در میان نمادهای اعلان‌شده یافت شود، نماد برای محدود کردن بهینه‌سازی‌های زمان پیوند علامت‌گذاری می‌شود. نمادهای ایستا (static) بهینه‌سازی‌های بیشتری را غیرفعال می‌کنند. همچنین شناسه‌هایی که پس از آن‌ها \*(Aq:\*(Aq آمده است بهینه‌سازی‌های بیشتری را غیرفعال می‌کنند، زیرا ممکن است نمادی باشند که به‌صورت محلی در اسمبلی تعریف شده است، حتی اگر اعلان آن با \*(Aqextern\*(Aq مشخص شده باشد..IP \fB\-fuse\-linker\-plugin\fR 4
.IX Item "-fuse-linker-plugin"
استفاده از افزایهٔ پیونددهنده (linker plugin) را در حین بهینه‌سازی زمان پیوند فعال می‌کند. این
گزینه به پشتیبانی پیونددهنده از افزایه وابسته است، که در gold
یا GNU ld نسخهٔ 2.21 یا جدیدتر در دسترس است.
.Sp
این گزینه استخراج فایل‌های شیء دارای بایت‌کد GIMPLE را از
آرشیوهای کتابخانه فعال می‌کند. این امر با در معرض قرار دادن کدهای
بیشتر برای بهینه‌ساز زمان پیوند، کیفیت بهینه‌سازی را بهبود می‌بخشد. این اطلاعات مشخص
می‌کند که چه نمادهایی می‌توانند به صورت خارجی (توسط شیء غیر LTO یا در طول
پیوند پویا) در دسترس باشند. بهبود حاصل‌شده در کیفیت کد برای باینری‌ها (و کتابخانه‌های
اشتراکی که از دید پنهان یا hidden visibility استفاده می‌کنند) مشابه \fB\-fwhole\-program\fR است.
برای شرح اثر این پرچم و نحوهٔ استفاده از آن، \fB\-flto\fR را ببینید.
.Sp
این گزینه زمانی که پشتیبانی از LTO در GCC فعال باشد و GCC برای استفاده با
یک پیونددهندهٔ پشتیبانی‌کننده از افزایه‌ها (GNU ld نسخهٔ 2.21 یا جدیدتر، یا gold)
پیکربندی شده باشد، به طور پیش‌فرض فعال است.
.IP \fB\-ffat\-lto\-objects\fR 4
.IX Item "-ffat-lto-objects"
اشیای فربهِ LTO (یا Fat LTO objects) فایل‌های شیئی هستند که هم زبان میانی
و هم کد شیء را در بر دارند. این ویژگی آن‌ها را هم برای پیوند LTO و هم برای پیوند
معمولی قابل استفاده می‌سازد. این گزینه تنها هنگام کامپایل با \fB\-flto\fR مؤثر است
و در زمان پیوند نادیده گرفته می‌شود.
.Sp
\&\fB\-fno\-fat\-lto\-objects\fR زمان کامپایل را نسبت به LTO ساده بهبود می‌بخشد، اما
نیازمند آن است که کل زنجیرهٔ ابزار از LTO آگاه باشد. این گزینه برای عملکردهای پایه
به پیونددهنده‌ای با پشتیبانی از افزایهٔ پیونددهنده نیاز دارد. علاوه بر این،
\&\fBnm\fR، \fBar\fR و \fBranlib\fR
باید از افزایه‌های پیونددهنده پشتیبانی کنند تا یک محیط ساخت کامل
(با قابلیت ساخت کتابخانه‌های ایستا و غیره) فراهم شود. کامپایلر GCC پوشش‌های \fBgcc\-ar\fR،
\&\fBgcc\-nm\fR و \fBgcc\-ranlib\fR را برای ارسال گزینه‌های مناسب به این ابزارها
فراهم می‌کند. با LTO غیرفربه، فایل‌های makefile باید برای استفاده از آن‌ها تغییر یابند.
.Sp
توجه داشته باشید که binutils مدرن سازوکار بارگذاری خودکار افزایه را ارائه می‌دهد.
نصب افزایهٔ پیونددهنده در \fR\f(CI$libdir\fR\fI/bfd\-plugins\fR اثری مشابه با
استفاده از پوشش‌های دستوری (\fBgcc\-ar\fR، \fBgcc\-nm\fR و
\&\fBgcc\-ranlib\fR) دارد.
.Sp
پیش‌فرض در مقصدهایی با پشتیبانی از افزایهٔ پیونددهنده، \fB\-fno\-fat\-lto\-objects\fR
است.
.IP \fB\-fcompare\-elim\fR 4
.IX Item "-fcompare-elim"
پس از تخصیص ثبات‌ها و تفکیک دستورالعمل‌های پس از تخصیص ثبات،
دستورالعمل‌های حسابی را که پرچم‌های پردازنده را مشابه یک عملیات مقایسه
بر اساس آن حساب محاسبه می‌کنند، شناسایی می‌کند. در صورت امکان، عملیات
مقایسهٔ صریح حذف می‌شود.
.Sp
این گذرگاه فقط برای مقصدهای خاصی اعمال می‌شود که نمی‌توانند عملیات
مقایسه را پیش از تکمیل تخصیص ثبات به صورت صریح نمایش دهند.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-ffold\-mem\-offsets\fR 4
.IX Item "-ffold-mem-offsets"
.PD 0
.IP \fB\-fno\-fold\-mem\-offsets\fR 4
.IX Item "-fno-fold-mem-offsets"
.PD
سعی می‌کند دستورالعمل‌های add را با ادغام در بارگذاری‌ها/ذخیره‌سازی‌های حافظه حذف کند.
.Sp
در سطوح \fB\-O2\fR و \fB\-O3\fR فعال است.
.IP \fB\-fcprop\-registers\fR 4
.IX Item "-fcprop-registers"
پس از تخصیص ثبات‌ها و تفکیک دستورالعمل‌های پس از تخصیص ثبات،
یک گذرگاه انتشار کپی (copy\-propagation) را اجرا می‌کند تا وابستگی‌های زمان‌بندی
کاهش یافته و در مواردی کپی حذف شود.
.Sp
در سطوح \fB\-O1\fR، \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال است.
.IP \fB\-fprofile\-correction\fR 4
.IX Item "-fprofile-correction"
پروفایل‌های جمع‌آوری‌شده با استفاده از یک باینری مجهز‌شده برای برنامه‌های چندنخی ممکن است
به دلیل از دست رفتن به‌روزرسانی‌های شمارنده ناهمگون باشند. هنگامی که این گزینه مشخص شود،
GCC از روش‌های اکتشافی (heuristics) برای تصحیح یا هموارسازی این ناهمگونی‌ها بهره می‌برد.
به طور پیش‌فرض، GCC هنگام شناسایی پروفایل ناهمگون یک پیام خطا صادر می‌کند.
.Sp
این گزینه توسط \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-fprofile\-partial\-training\fR 4
.IX Item "-fprofile-partial-training"
با \f(CW\*(C`\-fprofile\-use\*(C'\fR، تمام بخش‌هایی از برنامه که در طول اجرای آزمایشی (آموزش)
اجرا نشده‌اند، به شدت برای اندازه به جای سرعت بهینه‌سازی می‌شوند.
در برخی موارد آموزش تمام مسیرهای داغ (hot paths) ممکن در برنامه عملی نیست.
(برای مثال، برنامه ممکن است شامل توابعی مخصوص یک سخت‌افزار خاص باشد و آموزش
ممکن است تمام پیکربندی‌های سخت‌افزاری را که برنامه بعداً روی آن‌ها اجرا می‌شود پوشش ندهد.)
با \f(CW\*(C`\-fprofile\-partial\-training\*(C'\fR، بازخورد پروفایل برای تمام توابعی که در طول
اجرای آزمایشی اجرا نشده‌اند نادیده گرفته می‌شود، و باعث می‌شود آنها به گونه‌ای بهینه‌سازی شوند
که گویی بدون بازخورد پروفایل کامپایل شده‌اند. این امر زمانی که آموزش نمایندهٔ رفتار واقعی برنامه
نباشد، به قیمت اندازهٔ کد به طور قابل توجهی بزرگ‌تر، منجر به عملکرد بهتر می‌شود.
.IP \fB\-fprofile\-use\fR 4
.IX Item "-fprofile-use"
.PD 0
.IP \fB\-fprofile\-use=\fR\fIpath\fR 4
.IX Item "-fprofile-use=path"
.PD
بهینه‌سازی‌های هدایت‌شده با بازخورد پروفایل، و بهینه‌سازی‌های زیر را فعال می‌کند
که بسیاری از آن‌ها معمولاً تنها با در دسترس بودن بازخورد پروفایل
سودمند هستند:
.Sp
\&\fB\-fbranch\-probabilities  \-fprofile\-values
\&\-funroll\-loops  \-fpeel\-loops  \-ftracer  \-fvpt
\&\-finline\-functions  \-fipa\-cp  \-fipa\-cp\-clone  \-fipa\-bit\-cp
\&\-fpredictive\-commoning  \-fsplit\-loops  \-funswitch\-loops
\&\-fgcse\-after\-reload  \-ftree\-loop\-vectorize  \-ftree\-slp\-vectorize
\&\-fvect\-cost\-model=dynamic  \-ftree\-loop\-distribute\-patterns
\&\-fprofile\-reorder\-functions\fR
.Sp
پیش از آنکه بتوانید از این گزینه استفاده کنید، ابتدا باید اطلاعات پروفایل‌سازی را تولید نمایید.
.Sp
به طور پیش‌فرض، اگر پروفایل‌های بازخورد با کد منبع مطابقت نداشته باشند، GCC
یک پیام خطا صادر می‌کند. این خطا را می‌توان با استفاده از
\&\fB\-Wno\-error=coverage\-mismatch\fR به یک هشدار تبدیل کرد. توجه داشته باشید که این کار
ممکن است منجر به تولید کدی با بهینه‌سازی ضعیف شود. علاوه بر این، به طور پیش‌فرض، GCC در صورت
عدم وجود پروفایل‌های بازخورد نیز یک پیام هشدار صادر می‌کند (\fB\-Wmissing\-profile\fR را ببینید).
.Sp
اگر \fIpath\fR مشخص شده باشد، GCC برای یافتن فایل‌های دادهٔ بازخورد پروفایل
به \fIpath\fR نگاه می‌کند. \fB\-fprofile\-dir\fR را ببینید.
.IP \fB\-fauto\-profile\fR 4
.IX Item "-fauto-profile"
.PD 0
.IP \fB\-fauto\-profile=\fR\fIpath\fR 4
.IX Item "-fauto-profile=path"
.PD
بهینه‌سازی‌های هدایت‌شده با بازخورد مبتنی بر نمونه‌برداری،
و بهینه‌سازی‌های زیر را فعال می‌کند،
که بسیاری از آن‌ها معمولاً تنها با در دسترس بودن بازخورد پروفایل سودمند هستند:
.Sp
\&\fB\-fbranch\-probabilities  \-fprofile\-values
\&\-funroll\-loops  \-fpeel\-loops  \-ftracer  \-fvpt
\&\-finline\-functions  \-fipa\-cp  \-fipa\-cp\-clone  \-fipa\-bit\-cp
\&\-fpredictive\-commoning  \-fsplit\-loops  \-funswitch\-loops
\&\-fgcse\-after\-reload  \-ftree\-loop\-vectorize  \-ftree\-slp\-vectorize
\&\-fvect\-cost\-model=dynamic  \-ftree\-loop\-distribute\-patterns
\&\-fprofile\-correction\fR
.Sp
\&\fIpath\fR نام فایلی است که اطلاعات پروفایل AutoFDO را در بر دارد.
در صورت حذف، مقدار پیش‌فرض آن \fIfbdata.afdo\fR در دایرکتوری جاری است.
.Sp
تولید یک فایل دادهٔ پروفایل AutoFDO نیازمند اجرای برنامهٔ شما
با ابزار کاربردی \fBperf\fR روی یک سیستم مقصد GNU/Linux پشتیبانی‌شده است.
برای اطلاعات بیشتر، <\fBhttps://perfwiki.github.io/main\fR> را ببینید.
.Sp
برای مثال:
.Sp
.Vb 2
\&        perf record \-e br_inst_retired:near_taken \-b \-o perf.data \e
\&            \-\- your_program
.Ve
.Sp
سپس از ابزار \fBcreate_gcov\fR برای تبدیل داده‌های خام پروفایل
به قالبی که برای GCC قابل استفاده باشد، بهره بگیرید. همچنین باید باینری
برهنه‌نشدهٔ (unstripped) برنامهٔ خود را در اختیار این ابزار قرار دهید.
<\fBhttps://github.com/google/autofdo\fR> را ببینید.
.Sp
برای مثال:
.Sp
.Vb 2
\&        create_gcov \-\-binary=your_program.unstripped \-\-profile=perf.data \e
\&            \-\-gcov=profile.afdo
.Ve
.IP \fB\-fauto\-profile\-inlining\fR 4
.IX Item "-fauto-profile-inlining"
هنگامی که auto\-profile در دسترس است، پیش از خواندن بازخورد پروفایل، تمام توابع
مرتبطی را که در اجرای آزمایشی (آموزش) درون‌خط شده بودند، درون‌خط می‌کند. این امر
حساسیت زمینه‌ایِ (context sensitivity) پروفایل را بهبود می‌بخشد. به طور پیش‌فرض فعال است.
.PP
گزینه‌های زیر رفتار کامپایلر را در رابطه با محاسبات ممیز شناور کنترل می‌کنند.
این گزینه‌ها تعادلی میان سرعت و درستی برقرار می‌سازند.
همهٔ آن‌ها باید به طور صریح فعال شوند.
.IP \fB\-fexcess\-precision=\fR\fIstyle\fR 4
.IX Item "-fexcess-precision=style"
این گزینه امکان کنترل دقت مضاعف (excess precision) را در ماشین‌هایی فراهم می‌کند
که عملیات ممیز شناور در آن‌ها در قالبی با دقت یا دامنهٔ بیشتر از استاندارد IEEE
و انواع ممیز شناور تبادلی انجام می‌گیرد.
نمونه‌ای از چنین مقصدی ممیز شناور x87 در پردازنده‌های x86 است
که در داخل به جای قالب ۶۴ بیتی IEEE از نمایش ۸۰ بیتی استفاده می‌کند.
برای بیشتر برنامه‌ها، دقت مضاعف بی‌ضرر است،
اما برخی برنامه‌ها ممکن است به الزامات استانداردهای زبان C یا C++
برای مدیریت مقادیر IEEE وابسته باشند.
.Sp
به طور پیش‌فرض، \fB\-fexcess\-precision=fast\fR برقرار است؛ این بدان معناست که
عملیات ممکن است در دقتی بیشتر از انواع مشخص‌شده در منبع انجام شوند، اگر این امر
منجر به تولید کدی سریع‌تر شود، و زمان گرد کردن به انواع مشخص‌شده در کد منبع غیرقابل پیش‌بینی است.
هنگام کامپایل C یا C++، در صورتی که \fB\-fexcess\-precision=standard\fR مشخص شده باشد،
دقت مضاعف از قوانین مشخص‌شده در ISO C99 یا C++ پیروی می‌کند؛
به ویژه،
هر دو تبدیل نوع (casts) و انتساب‌ها باعث می‌شوند مقادیر به انواع معنایی خود
گرد شوند (در حالی که \fB\-ffloat\-store\fR تنها بر
انتساب‌ها اثر می‌گذارد). این گزینه برای C یا C++ در صورت استفاده از یک گزینهٔ انطباق دقیق
مانند \fB\-std=c99\fR یا \fB\-std=c++17\fR به طور پیش‌فرض فعال است.
\&\fB\-ffast\-math\fR صرف‌نظر از اینکه گزینهٔ انطباق دقیق استفاده شده باشد یا خیر،
به طور پیش‌فرض \fB\-fexcess\-precision=fast\fR را فعال می‌کند.
اگر \fB\-fexcess\-precision=16\fR مشخص شود، مقادیر ثابت و نتایج عبارات
با انواع \f(CW\*(C`_Float16\*(C'\fR و \f(CW\*(C`_\|_bf16\*(C'\fR
بدون دقت مضاعف محاسبه می‌شوند.
.Sp
\&\fB\-fexcess\-precision=standard\fR برای زبان‌هایی غیر از C یا C++ پیاده‌سازی
نشده است. در x86، اگر \fB\-mfpmath=sse\fR یا \fB\-mfpmath=sse+387\fR
مشخص شده باشد هیچ اثری ندارد؛ در حالت نخست، معناشناسی IEEE بدون دقت مضاعف
اعمال می‌شود و در حالت دوم، گرد کردن غیرقابل پیش‌بینی است..IP \fB\-ffloat\-store\fR 4
.IX Item "-ffloat-store"
متغیرهای ممیز شناور را در ثبات‌ها ذخیره نمی‌کند و از گزینه‌های دیگری که
ممکن است خوانده شدن مقدار ممیز شناور از ثبات یا حافظه را تغییر دهند،
جلوگیری می‌کند. این گزینه عموماً جای خود را به
\&\fB\-fexcess\-precision=standard\fR داده است که عام‌تر است. در صورت استفاده
از \&\fB\-ffloat\-store\fR، ممکن است نیاز باشد برنامه‌تان را تغییر دهید تا
محاسبات میانی را صریحاً در متغیرهای موقت ذخیره کند، زیرا
\&\fB\-ffloat\-store\fR گرد کردن به قالب IEEE را بر خلاف
\&\fB\-fexcess\-precision=standard\fR، تنها در انتساب‌ها اعمال می‌کند و نه در
تبدیل نوع‌ها (casts).
.IP \fB\-ffast\-math\fR 4
.IX Item "-ffast-math"
گزینه‌های \fB\-fno\-math\-errno\fR، \fB\-funsafe\-math\-optimizations\fR،
\&\fB\-ffinite\-math\-only\fR، \fB\-fno\-rounding\-math\fR،
\&\fB\-fno\-signaling\-nans\fR، \fB\-fcx\-limited\-range\fR و
\&\fB\-fexcess\-precision=fast\fR را فعال می‌کند.
.Sp
این گزینه باعث تعریف ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_FAST_MATH_\|_\*(C'\fR می‌شود.
.Sp
این گزینه توسط هیچ‌یک از گزینه‌های \fB\-O\fR به‌جز
\&\fB\-Ofast\fR فعال نمی‌شود، زیرا می‌تواند منجر به خروجی نادرست برای
برنامه‌هایی شود که به پیاده‌سازی دقیق قواعد یا مشخصات IEEE یا ISO برای
توابع ریاضی وابسته‌اند. با این حال، ممکن است برای برنامه‌هایی که به ضمانت‌های
این مشخصات نیازی ندارند، کُد سریع‌تری تولید کند.
.IP \fB\-fno\-math\-errno\fR 4
.IX Item "-fno-math-errno"
پس از فراخوانی توابع ریاضی که با یک دستورالعمل منفرد اجرا می‌شوند (مانند
\f(CW\*(C`sqrt\*(C'\fR)، مقدار \f(CW\*(C`errno\*(C'\fR را تنظیم نمی‌کند. برنامه‌ای که برای
مدیریت خطای ریاضی به استثناهای IEEE متکی است، ممکن است بخواهد برای افزایش
سرعت ضمن حفظ سازگاری محاسباتی با IEEE از این پرچم استفاده کند.
.Sp
این گزینه توسط هیچ‌یک از گزینه‌های \fB\-O\fR به‌جز
\&\fB\-Ofast\fR فعال نمی‌شود، زیرا می‌تواند منجر به خروجی نادرست
برای برنامه‌هایی شود که به پیاده‌سازی دقیق قواعد یا مشخصات IEEE یا
ISO برای توابع ریاضی وابسته‌اند. با این حال، ممکن است برای برنامه‌هایی
که به ضمانت‌های این مشخصات نیازی ندارند، کُد سریع‌تری تولید کند.
.Sp
پیش‌فرض \fB\-fmath\-errno\fR است.
.Sp
در سیستم‌های Darwin، کتابخانهٔ ریاضی هرگز \f(CW\*(C`errno\*(C'\fR را تنظیم نمی‌کند؛
بنابراین دلیلی ندارد که کامپایلر چنین احتمالی را در نظر بگیرد، و
\fB\-fno\-math\-errno\fR حالت پیش‌فرض است.
.IP \fB\-funsafe\-math\-optimizations\fR 4
.IX Item "-funsafe-math-optimizations"
بهینه‌سازی‌هایی را برای محاسبات ممیز شناور مجاز می‌کند که (الف) فرض می‌کنند
آرگومان‌ها و نتایج معتبر هستند و (ب) ممکن است استانداردهای IEEE یا
ANSI را نقض کنند. در صورت استفاده در زمان پیوند، ممکن است کتابخانه‌ها
یا فایل‌های راه‌اندازی‌ای را شامل شود که واژهٔ کنترلی پیش‌فرض FPU یا سایر
بهینه‌سازی‌های مشابه را تغییر می‌دهند.
.Sp
این گزینه توسط هیچ‌یک از گزینه‌های \fB\-O\fR به‌جز
\&\fB\-Ofast\fR فعال نمی‌شود، زیرا می‌تواند منجر به خروجی نادرست
برای برنامه‌هایی شود که به پیاده‌سازی دقیق قواعد یا مشخصات IEEE
یا ISO برای توابع ریاضی وابسته‌اند. با این حال، ممکن است برای برنامه‌هایی
که به ضمانت‌های این مشخصات نیازی ندارند، کُد سریع‌تری تولید کند.
گزینه‌های \fB\-fno\-signed\-zeros\fR، \fB\-fno\-trapping\-math\fR،
\&\fB\-fassociative\-math\fR و \fB\-freciprocal\-math\fR را فعال می‌کند.
.Sp
پیش‌فرض \fB\-fno\-unsafe\-math\-optimizations\fR است.
.IP \fB\-fassociative\-math\fR 4
.IX Item "-fassociative-math"
شرکت‌پذیری مجدد (re-association) عملوندها را در دنباله‌ای از عملیات ممیز شناور
مجاز می‌کند. این کار استانداردهای زبان ISO C و C++ را با تغییر احتمالی در نتیجهٔ
محاسبات نقض می‌کند. توجه: بازآرایی ممکن است علامت صفر را تغییر دهد، مقادیر
NaN را نادیده بگیرد، و سرریز زیرین یا سرریز زبرین را مهار کند یا به وجود آورد
(و بنابراین نباید در کُدهایی که به رفتار گرد کردن وابسته هستند، مانند
\&\f(CW\*(C`(x + 2**52) \- 2**52\*(C'\fR، استفاده شود). همچنین ممکن است مقایسه‌های
ممیز شناور را بازآرایی کند و بنابراین نباید در جایی که مقایسه‌های ترتیبی (ordered)
لازم است به کار رود. این گزینه مستلزم آن است که هر دو گزینهٔ
\fB\-fno\-signed\-zeros\fR و \&\fB\-fno\-trapping\-math\fR فعال باشند.
علاوه بر این، همراه با \fB\-frounding\-math\fR کاربرد چندانی ندارد. برای Fortran،
این گزینه زمانی که هر دو گزینهٔ \fB\-fno\-signed\-zeros\fR و
\&\fB\-fno\-trapping\-math\fR فعال باشند، به طور خودکار فعال می‌شود.
.Sp
پیش‌فرض \fB\-fno\-associative\-math\fR است.
.IP \fB\-freciprocal\-math\fR 4
.IX Item "-freciprocal-math"
اجازه می‌دهد در صورتی که بهینه‌سازی‌ها را ممکن سازد، به جای تقسیم بر یک مقدار
از معکوس آن مقدار استفاده شود؛ برای نمونه \f(CW\*(C`x / y\*(C'\fR می‌تواند با
\f(CW\*(C`x * (1/y)\*(C'\fR جایگزین شود که در صورتی مفید است که \f(CW\*(C`(1/y)\*(C'\fR
مشمول حذف زیرعبارت‌های مشترک شود. توجه داشته باشید که این کار دقت را کاهش داده
و تعداد فلاپس‌ها (flops) را در عملیات روی مقدار افزایش می‌دهد.
.Sp
پیش‌فرض \fB\-fno\-reciprocal\-math\fR است.
.IP \fB\-ffinite\-math\-only\fR 4
.IX Item "-ffinite-math-only"
بهینه‌سازی‌هایی را برای محاسبات ممیز شناور مجاز می‌کند که فرض می‌کنند
آرگومان‌ها و نتایج NaN یا +\-Inf نیستند.
.Sp
این گزینه توسط هیچ‌یک از گزینه‌های \fB\-O\fR به‌جز
\&\fB\-Ofast\fR فعال نمی‌شود، زیرا می‌تواند منجر به خروجی نادرست
برای برنامه‌هایی شود که به پیاده‌سازی دقیق قواعد یا مشخصات IEEE یا
ISO برای توابع ریاضی وابسته‌اند. با این حال، ممکن است برای برنامه‌هایی
که به ضمانت‌های این مشخصات نیازی ندارند، کُد سریع‌تری تولید کند.
.Sp
پیش‌فرض \fB\-fno\-finite\-math\-only\fR است.
.IP \fB\-fno\-signed\-zeros\fR 4
.IX Item "-fno-signed-zeros"
بهینه‌سازی‌هایی را برای محاسبات ممیز شناور مجاز می‌کند که علامت‌دار بودن
صفر را نادیده می‌گیرند. محاسبات IEEE رفتار مقادیر متمایز +0.0 و \-0.0 را
مشخص می‌کند که مانع از ساده‌سازی عباراتی مانند x+0.0 یا 0.0*x (حتی با
\fB\-ffinite\-math\-only\fR) می‌شود. این گزینه بدین معناست که علامت نتیجهٔ
صفر اهمیت ندارد.
.Sp
پیش‌فرض \fB\-fsigned\-zeros\fR است.
.IP \fB\-fno\-trapping\-math\fR 4
.IX Item "-fno-trapping-math"
کُد را با این فرض کامپایل می‌کند که عملیات‌های ممیز شناور نمی‌توانند تله‌های
(traps) قابل رؤیت برای کاربر تولید کنند. این تله‌ها شامل تقسیم بر صفر، سرریز زبرین،
سرریز زیرین، نتیجهٔ غیردقیق و عملیات نامعتبر هستند. این گزینه مستلزم آن است که
\fB\-fno\-signaling\-nans\fR فعال باشد. تنظیم این گزینه در صورتی که مثلاً بر محاسبات
IEEE «بدون توقف» (non\-stop) تکیه شود، ممکن است امکان تولید کُد سریع‌تر را فراهم کند.
.Sp
این گزینه توسط هیچ‌یک از گزینه‌های \fB\-O\fR به‌جز
\&\fB\-Ofast\fR فعال نمی‌شود، زیرا می‌تواند منجر به خروجی نادرست برای
برنامه‌هایی شود که به پیاده‌سازی دقیق قواعد یا مشخصات IEEE یا ISO برای توابع
ریاضی وابسته‌اند.
.Sp
پیش‌فرض \fB\-ftrapping\-math\fR است.
.Sp
نسخه‌های آیندهٔ GCC ممکن است کنترل دقیق‌تری بر این تنظیم با استفاده از
پراگمای \f(CW\*(C`FENV_ACCESS\*(C'\fR در C99 ارائه دهند. این گزینهٔ خط فرمان
به همراه \fB\-frounding\-math\fR برای تعیین حالت پیش‌فرض برای
\f(CW\*(C`FENV_ACCESS\*(C'\fR استفاده خواهد شد.
.IP \fB\-frounding\-math\fR 4
.IX Item "-frounding-math"
تبدیل‌ها و بهینه‌سازی‌هایی را که رفتار پیش‌فرض گرد کردن ممیز شناور
(گرد کردن به نزدیک‌ترین مقدار) را فرض می‌کنند، غیرفعال می‌کند.
این گزینه باید برای برنامه‌هایی مشخص شود که حالت گرد کردن ممیز شناور را
به صورت پویا تغییر می‌دهند، یا ممکن است با یک حالت گرد کردن غیرپیش‌فرض
اجرا شوند. این گزینه ادغام مقادیر ثابت (constant folding) عبارات ممیز شناور
را در زمان کامپایل (که ممکن است تحت تأثیر حالت گرد کردن قرار گیرد) و تبدیلات
محاسباتی را که در حضور حالت‌های گرد کردن وابسته به علامت ناامن هستند،
غیرفعال می‌کند.
.Sp
پیش‌فرض \fB\-fno\-rounding\-math\fR است.
.Sp
این گزینه آزمایشی است و در حال حاضر تضمین نمی‌کند که تمام بهینه‌سازی‌های GCC
که تحت تأثیر حالت گرد کردن هستند را غیرفعال کند.
نسخه‌های آیندهٔ GCC ممکن است کنترل دقیق‌تری بر این تنظیم با استفاده از
پراگمای \f(CW\*(C`FENV_ACCESS\*(C'\fR در C99 ارائه دهند. این گزینهٔ خط فرمان
همراه با \fB\-ftrapping\-math\fR برای تعیین حالت پیش‌فرض برای
\f(CW\*(C`FENV_ACCESS\*(C'\fR استفاده خواهد شد.
.IP \fB\-fsignaling\-nans\fR 4
.IX Item "-fsignaling-nans"
کُد را با این فرض کامپایل می‌کند که signaling NaNهای IEEE ممکن است در حین
عملیات‌های ممیز شناور، تله‌های قابل رؤیت برای کاربر تولید کنند. تنظیم این گزینه،
بهینه‌سازی‌هایی را که ممکن است تعداد استثناهای قابل رؤیت با signaling NaNها
را تغییر دهند، غیرفعال می‌کند. این گزینه مستلزم \fB\-ftrapping\-math\fR است.
.Sp
این گزینه باعث می‌شود که ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_SUPPORT_SNAN_\|_\*(C'\fR
تعریف شود.
.Sp
پیش‌فرض \fB\-fno\-signaling\-nans\fR است.
.Sp
این گزینه آزمایشی است و در حال حاضر تضمین نمی‌کند که تمام بهینه‌سازی‌های GCC
متأثر از رفتار signaling NaN را غیرفعال کند.
.IP \fB\-fsingle\-precision\-constant\fR 4
.IX Item "-fsingle-precision-constant"
با ثابت‌های ممیز شناور به عنوان دقت منفرد (single precision) رفتار می‌کند
به جای این که آن‌ها را به صورت ضمنی به ثابت‌های با دقت مضاعف (double\-precision)
تبدیل کند.
.IP \fB\-fcx\-limited\-range\fR 4
.IX Item "-fcx-limited-range"
در صورت فعال بودن، این گزینه بیان می‌کند که هنگام انجام تقسیم مختلط به مرحلهٔ
کاهش دامنه نیازی نیست. همچنین بررسی نمی‌شود که آیا حاصل ضرب یا تقسیم
مختلط \f(CW\*(C`NaN + I*NaN\*(C'\fR است یا خیر، و تلاشی برای بهبود وضعیت در
آن حالت انجام نمی‌گیرد. این گزینه توسط \fB\-ffast\-math\fR فعال می‌شود.
.Sp
این گزینه تنظیم پیش‌فرض پراگمای \f(CW\*(C`CX_LIMITED_RANGE\*(C'\fR در
ISO C99 را کنترل می‌کند. با این حال، این گزینه برای همهٔ زبان‌ها اعمال می‌شود.
.IP \fB\-fcx\-fortran\-rules\fR 4
.IX Item "-fcx-fortran-rules"
ضرب و تقسیم مختلط از قواعد Fortran پیروی می‌کنند. کاهش دامنه به عنوان بخشی
از تقسیم مختلط انجام می‌شود، اما هیچ بررسی‌ای برای اینکه آیا حاصل ضرب یا
تقسیم مختلط \f(CW\*(C`NaN + I*NaN\*(C'\fR است یا خیر، و تلاشی برای بهبود وضعیت
در آن حالت صورت نمی‌گیرد..IP \fB\-fcx\-method=\fR\fImethod\fR 4
.IX Item "-fcx-method=method"
ضرب و تقسیم اعداد مختلط از \fImethod\fR مشخص‌شده پیروی می‌کنند. آرگومان \fImethod\fR باید یکی از مقادیر \fBlimited\-range\fR، \fBfortran\fR یا \fBstdc\fR باشد.
.Sp
حالت پیش‌فرض، رعایت محدودیت‌های خاص زبان است که به معنای \fBfortran\fR برای زبان Fortran و در غیر این صورت \fBstdc\fR خواهد بود.
.PP
گزینه‌های زیر بهینه‌سازی‌هایی را کنترل می‌کنند که ممکن است عملکرد را بهبود ببخشند، اما توسط هیچ‌یک از گزینه‌های \fB\-O\fR فعال نمی‌شوند. این بخش شامل گزینه‌های آزمایشی است که ممکن است کدهای معیوب تولید کنند.
.IP \fB\-fbranch\-probabilities\fR 4
.IX Item "-fbranch-probabilities"
پس از اجرای برنامه‌ای که با \fB\-fprofile\-arcs\fR کامپایل شده است، می‌توانید آن را بار دوم با استفاده از \fB\-fbranch\-probabilities\fR کامپایل کنید تا بهینه‌سازی‌ها بر اساس تعداد دفعاتی که هر انشعاب طی شده است، ارتقا یابند. هنگامی که برنامه‌ای کامپایل‌شده با \fB\-fprofile\-arcs\fR خارج می‌شود، تعداد دفعات اجرای کمان‌ها (arcs) را برای هر فایل مبدأ در فایلی به نام \fIsourcename.gcda\fR ذخیره می‌کند. اطلاعات موجود در این فایل داده به شدت وابسته به ساختار کد تولید شده است، بنابراین باید برای هر دو کامپایل از همان کد مبدأ و همان گزینه‌های بهینه‌سازی استفاده کنید. جزئیات نام‌گذاری فایل را در \fB\-fprofile\-arcs\fR ببینید.
.Sp
با \fB\-fbranch\-probabilities\fR، کامپایلر GCC یک یادداشت \fBREG_BR_PROB\fR روی هر \fBJUMP_INSN\fR و \fBCALL_INSN\fR قرار می‌دهد. این‌ها می‌توانند برای بهبود بهینه‌سازی استفاده شوند. در حال حاضر، آن‌ها فقط در یک نقطه استفاده می‌شوند: در \fIreorg.cc\fR، به جای حدس زدن اینکه یک انشعاب به احتمال زیاد کدام مسیر را طی می‌کند، مقادیر \fBREG_BR_PROB\fR برای تعیین دقیق مسیری که بیشتر پیموده می‌شود به کار می‌روند.
.Sp
توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-fprofile\-values\fR 4
.IX Item "-fprofile-values"
اگر با \fB\-fprofile\-arcs\fR ترکیب شود، کدهایی را اضافه می‌کند تا داده‌هایی درباره مقادیر عبارات در برنامه جمع‌آوری شوند.
.Sp
همراه با \fB\-fbranch\-probabilities\fR، داده‌های جمع‌آوری‌شده از پروفایل‌سازی مقادیر عبارات را برای استفاده در بهینه‌سازی‌ها بازخوانی می‌کند.
.Sp
توسط \fB\-fprofile\-generate\fR، \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-fprofile\-reorder\-functions\fR 4
.IX Item "-fprofile-reorder-functions"
بازآرایی توابع بر اساس ابزار دقیق پروفایل (profile instrumentation)، زمان نخستین اجرای هر تابع را جمع‌آوری کرده و این توابع را به ترتیب صعودی مرتب می‌کند؛ هدف آن بهینه‌سازی زمان راه‌اندازی برنامه از طریق بارگذاری کارآمدتر بخش‌های متن (text segments) است.
.Sp
با \fB\-fprofile\-use\fR فعال می‌شود.
.IP \fB\-fvpt\fR 4
.IX Item "-fvpt"
اگر با \fB\-fprofile\-arcs\fR ترکیب شود، این گزینه به کامپایلر دستور می‌دهد کدهایی برای جمع‌آوری اطلاعات درباره مقادیر عبارات اضافه کند.
.Sp
همراه با \fB\-fbranch\-probabilities\fR، داده‌های جمع‌آوری‌شده را بازخوانی کرده و عملاً بهینه‌سازی‌ها را بر پایه آن‌ها اعمال می‌کند. در حال حاضر این بهینه‌سازی‌ها شامل تخصیص‌یافتگی عملیات تقسیم با استفاده از دانش مربوط به مقدار مخرج است.
.Sp
با \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-frename\-registers\fR 4
.IX Item "-frename-registers"
تلاش می‌کند تا با استفاده از ثبات‌های (registers) باقی‌مانده پس از تخصیص ثبات، از وابستگی‌های کاذب در کدهای زمان‌بندی‌شده جلوگیری کند. این بهینه‌سازی بیشترین سود را برای پردازنده‌هایی با ثبات‌های زیاد به همراه دارد. با این حال، بسته به قالب اطلاعات اشکال‌زدایی اتخاذشده توسط هدف، این کار می‌تواند اشکال‌زدایی را غیرممکن کند، زیرا متغیرها دیگر در یک «home register» باقی نمی‌مانند.
.Sp
به‌طور پیش‌فرض همراه با \fB\-funroll\-loops\fR فعال می‌شود.
.IP \fB\-fschedule\-fusion\fR 4
.IX Item "-fschedule-fusion"
یک گذر وابسته به معماری هدف را روی جریان دستورالعمل‌ها انجام می‌دهد تا دستورالعمل‌های هم‌نوع را در کنار یکدیگر زمان‌بندی کند، زیرا ماشین هدف می‌تواند در صورت مجاور بودن آن‌ها در جریان دستورالعمل، آن‌ها را با کارایی بیشتری اجرا کند.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال می‌شود.
.IP \fB\-fdep\-fusion\fR 4
.IX Item "-fdep-fusion"
جفت‌های ادغام‌پذیر کلان‌دستور (macro\-op fusible pairs) متشکل از دستورالعمل‌های تک‌کاربرده و موارد استفاده آن‌ها را شناسایی کرده و این جفت‌ها را در جریان دستورالعمل‌ها کنار هم قرار می‌دهد تا فرصت‌های ادغام در سخت‌افزار افزایش یابد. این گذر یک بار پیش از تخصیص ثبات و بار دیگر پیش از بازنام‌گذاری ثبات اجرا می‌شود.
.Sp
در سطوح \fB\-O2\fR، \fB\-O3\fR و \fB\-Os\fR فعال می‌شود.
.IP \fB\-ftracer\fR 4
.IX Item "-ftracer"
تکثیر دم (tail duplication) را برای بزرگ‌تر کردن اندازه سوپربلاک (superblock) انجام می‌دهد. این تبدیل، جریان کنترل تابع را ساده کرده و به دیگر بهینه‌سازی‌ها اجازه می‌دهد کارایی بهتری داشته باشند.
.Sp
توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-funroll\-loops\fR 4
.IX Item "-funroll-loops"
حلقه‌هایی را که تعداد تکرارهای آن‌ها را می‌توان در زمان کامپایل یا هنگام ورود به حلقه تعیین کرد، باز (unroll) می‌کند. گزینه \fB\-funroll\-loops\fR به معنای فعال‌سازی ضمنی گزینه‌های \fB\-frerun\-cse\-after\-loop\fR، \fB\-fweb\fR و \fB\-frename\-registers\fR است. این گزینه همچنین لایه‌برداری کامل حلقه (complete loop peeling، یعنی حذف کامل حلقه‌های با تعداد تکرار ثابت و اندک) را فعال می‌کند. این گزینه اندازه کد را بزرگ‌تر می‌کند و ممکن است اجرای آن را سریع‌تر بکند یا نکند.
.Sp
توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-funroll\-all\-loops\fR 4
.IX Item "-funroll-all-loops"
تمام حلقه‌ها را باز می‌کند، حتی اگر تعداد تکرارهای آن‌ها در هنگام ورود به حلقه نامشخص باشد. این کار معمولاً باعث کندتر اجرا شدن برنامه‌ها می‌شود. گزینه \fB\-funroll\-all\-loops\fR گزینه‌هایی مشابه با \fB\-funroll\-loops\fR را به‌طور ضمنی به همراه دارد.
.IP \fB\-fpeel\-loops\fR 4
.IX Item "-fpeel-loops"
حلقه‌هایی را که اطلاعات کافی مبنی بر کم بودن تکرار آن‌ها وجود دارد (از طریق بازخورد پروفایل یا تحلیل ایستا)، لایه‌برداری (peel) می‌کند. همچنین لایه‌برداری کامل حلقه (حذف کامل حلقه‌هایی با تعداد تکرار ثابت و کم) را فعال می‌سازد.
.Sp
توسط \fB\-O3\fR، \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-fmalloc\-dce\fR 4
.IX Item "-fmalloc-dce"
کنترل می‌کند که آیا \f(CW\*(C`malloc\*(C'\fR (و گونه‌های آن مانند \f(CW\*(C`calloc\*(C'\fR یا \f(CW\*(C`strdup\*(C'\fR) در صورتی که مقدار بازگشتی آن‌ها فقط به عنوان پارامتر فراخوانی \f(CW\*(C`free\*(C'\fR استفاده شده یا با \f(CW\*(C`NULL\*(C'\fR مقایسه شده باشد، قابل حذف از طریق بهینه‌سازی هستند یا خیر. اگر از \fB\-fmalloc\-dce=1\fR استفاده شود، فقط فراخوانی‌های \f(CW\*(C`free\*(C'\fR مجاز هستند، در حالی که با \fB\-fmalloc\-dce=2\fR مقایسه‌ها با اشاره‌گر \f(CW\*(C`NULL\*(C'\fR نیز برای حذف ایمن در نظر گرفته می‌شوند.
.Sp
مقدار پیش‌فرض \fB\-fmalloc\-dce=2\fR است. همچنین به \fB\-fallocation\-dce\fR مراجعه کنید.
.IP \fB\-fmove\-loop\-invariants\fR 4
.IX Item "-fmove-loop-invariants"
گذر جابه‌جایی مقادیر پایا در حلقه (loop invariant motion) را در بهینه‌ساز حلقه RTL فعال می‌کند. در سطح \fB\-O1\fR و بالاتر، به جز \fB\-Og\fR فعال است.
.IP \fB\-fmove\-loop\-stores\fR 4
.IX Item "-fmove-loop-stores"
گذر جابه‌جایی ذخیره‌سازی‌های حلقه (loop store motion) را در بهینه‌ساز حلقه GIMPLE فعال می‌کند. این کار ذخیره‌سازی‌های پایا را در ازای انتقال مقدار ذخیره‌شده در یک ثبات در طول تکرار، به بعد از پایان حلقه منتقل می‌کند. توجه داشته باشید که برای اثرگذاری این گزینه، \fB\-ftree\-loop\-im\fR نیز باید فعال باشد. در سطح \fB\-O1\fR و بالاتر، به جز \fB\-Og\fR فعال است.
.IP \fB\-fsplit\-loops\fR 4
.IX Item "-fsplit-loops"
اگر حلقه‌ای دارای شرطی باشد که همواره برای یک طرف از فضای تکرار صادق و برای طرف دیگر کاذب است، آن را به دو حلقه تقسیم می‌کند.
.Sp
توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-funswitch\-loops\fR 4
.IX Item "-funswitch-loops"
انشعاب‌های با شرط‌های پایای حلقه را به خارج از حلقه منتقل می‌کند، به همراه نسخه‌های تکراری از حلقه در هر دو شاخه (که بر اساس نتیجه شرط اصلاح شده‌اند).
.Sp
توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-fversion\-loops\-for\-strides\fR 4
.IX Item "-fversion-loops-for-strides"
اگر یک حلقه روی آرایه‌ای با گام (stride) متغیر تکرار شود، نسخه دیگری از حلقه ایجاد می‌کند که فرض می‌کند گام همیشه یک است. برای نمونه:
.Sp
.Vb 2
\&        for (int i = 0; i < n; ++i)
\&          x[i * stride] = ...;
.Ve
.Sp
تبدیل می‌شود به:
.Sp
.Vb 6
\&        if (stride == 1)
\&          for (int i = 0; i < n; ++i)
\&            x[i] = ...;
\&        else
\&          for (int i = 0; i < n; ++i)
\&            x[i * stride] = ...;
.Ve
.Sp
این گزینه به‌ویژه برای آرایه‌های assumed\-shape در زبان Fortran کاربرد دارد که (برای نمونه) با فرض دسترسی‌های متوالی، برداری‌سازی (vectorization) بهتری را امکان‌پذیر می‌سازد.
این پرچم به‌طور پیش‌فرض در \fB\-O3\fR فعال است.
همچنین توسط \fB\-fprofile\-use\fR و \fB\-fauto\-profile\fR فعال می‌شود.
.IP \fB\-ffunction\-sections\fR 4
.IX Item "-ffunction-sections"
.PD 0.IP \fB\-fdata\-sections\fR 4
.IX Item "-fdata-sections"
.PD
هر تابع یا قلم داده (data item) را در صورتی که مقصد از بخش‌های دلخواه (arbitrary sections) پشتیبانی کند، در بخش اختصاصی خودش در فایل خروجی قرار می‌دهد. نام تابع یا نام قلم داده، نام بخش مربوطه در فایل خروجی را مشخص می‌کند.
.Sp
از این گزینه‌ها در سیستم‌هایی استفاده کنید که پیونددهنده (linker) می‌تواند برای بهبود محلی‌بودن ارجاع (locality of reference) در فضای دستورالعمل‌ها، بهینه‌سازی‌هایی انجام دهد. بیشتر سیستم‌هایی که از قالب شیء ELF استفاده می‌کنند، پیونددهنده‌هایی با چنین بهینه‌سازی‌هایی دارند. در AIX، پیونددهنده بخش‌ها (CSECTها) را بر پایه گراف فراخوانی بازآرایی می‌کند. تأثیر بر کارایی متغیر است.
.Sp
این گزینه‌ها به همراه بازیافت بخش‌های زائد توسط پیونددهنده (گزینه \fB\-\-gc\-sections\fR پیونددهنده) ممکن است (پس از پیراستن یا strip کردن) به فایل‌های اجرایی پیوند ایستا (statically-linked) کوچک‌تری منجر شوند.
.Sp
در سیستم‌های ELF/DWARF این گزینه‌ها کیفیت اطلاعات اشکال‌زدایی را کاهش نمی‌دهند. با این حال ممکن است با سایر قالب‌های فایل شیء/اطلاعات اشکال‌زدایی مشکلاتی وجود داشته باشد.
.Sp
تنها زمانی از این گزینه‌ها استفاده کنید که مزایای قابل‌توجهی داشته باشند. هنگامی که این گزینه‌ها را مشخص می‌کنید، اسمبلر و پیونددهنده فایل‌های شیء و اجرایی بزرگ‌تری ایجاد می‌کنند و همچنین کندتر عمل می‌کنند. این گزینه‌ها روی تولید کد تأثیر می‌گذارند. آن‌ها مانع از بهینه‌سازی‌هایی توسط کامپایلر و اسمبلر می‌شوند که از مکان‌های نسبی درون یک واحد ترجمه (translation unit) استفاده می‌کنند، زیرا مکان‌ها تا زمان پیوند ناشناخته هستند. نمونه‌ای از چنین بهینه‌سازی‌هایی، تعدیل فراخوانی‌ها به دستورالعمل‌های فراخوانی کوتاه است.
.IP \fB\-fstdarg\-opt\fR 4
.IX Item "-fstdarg-opt"
پیش‌درآمد (prologue) توابع با تعداد آرگومان متغیر (variadic argument) را با توجه به نحوه استفاده از آن آرگومان‌ها بهینه‌سازی می‌کند.
.IP \fB\-fsection\-anchors\fR 4
.IX Item "-fsection-anchors"
تلاش می‌کند تا با استفاده از نمادهای مشترک «لنگر» (anchor) برای آدرس‌دهی به اشیاء مجاور، تعداد محاسبات آدرس نمادین را کاهش دهد. این تبدیل می‌تواند به کاهش تعداد مدخل‌های GOT و دسترسی‌های GOT در برخی از مقصدها کمک کند.
.Sp
برای مثال، پیاده‌سازی تابع زیر \f(CW\*(C`foo\*(C'\fR:
.Sp
.Vb 2
\&        static int a, b, c;
\&        int foo (void) { return a + b + c; }
.Ve
.Sp
معمولاً آدرس‌های هر سه متغیر را محاسبه می‌کند، اما اگر آن را با \fB\-fsection\-anchors\fR کامپایل کنید، در عوض از یک نقطه لنگر مشترک به متغیرها دسترسی پیدا می‌کند. اثر آن شبیه به شبه‌کد زیر است (که کد معتبر C نیست):
.Sp
.Vb 5
\&        int foo (void)
\&        {
\&          register int *xr = &x;
\&          return xr[&a \- &x] + xr[&b \- &x] + xr[&c \- &x];
\&        }
.Ve
.Sp
همه مقصدها از این گزینه پشتیبانی نمی‌کنند.
.IP \fB\-fzero\-call\-used\-regs=\fR\fIchoice\fR 4
.IX Item "-fzero-call-used-regs=choice"
ثبات‌های مورداستفاده در فراخوانی (call-used registers) را در هنگام بازگشت از تابع صفر می‌کند تا با کاهش حملات برنامه‌نویسی مبتنی بر بازگشت (ROP) یا جلوگیری از نشت اطلاعات از طریق ثبات‌ها، امنیت برنامه افزایش یابد.
.Sp
مقادیر مجاز برای \fIchoice\fR همانند مقادیر مشخصه \f(CW\*(C`zero_call_used_regs\*(C'\fR هستند.
پیش‌فرض \fBskip\fR است.
.Sp
می‌توانید این رفتار را برای یک تابع خاص با استفاده از مشخصه تابع \f(CW\*(C`zero_call_used_regs\*(C'\fR کنترل کنید.
.SS "گزینه‌های ابزارگذاری برنامه (Program Instrumentation Options)"
.IX Subsection "Program Instrumentation Options"
‏GCC از تعدادی گزینه خط فرمان پشتیبانی می‌کند که افزودن ابزارگذاری زمان اجرا (run-time instrumentation) را به کدی که به‌طور عادی تولید می‌کند، کنترل می‌نمایند. برای نمونه، یک هدف از ابزارگذاری، جمع‌آوری آمار پروفایل‌سازی برای استفاده در یافتن نقاط داغ برنامه (hot spots)، تحلیل پوشش کد، یا بهینه‌سازی‌های هدایت‌شده با پروفایل است. دسته دیگری از ابزارگذاری برنامه، افزودن بررسی‌های زمان اجرا برای تشخیص خطاهای برنامه‌نویسی مانند ارجاع به اشاره‌گرهای نامعتبر یا دسترسی‌های خارج از محدوده آرایه‌ها، و همچنین حملات خصمانه عمدی مانند درهم‌شکستن پشته (stack smashing) یا ربودن جدول مجازی (vtable) در ++C است. همچنین یک قلاب (hook) عمومی وجود دارد که می‌تواند برای پیاده‌سازی اشکال دیگری از ردگیری (tracing) یا ابزارگذاری در سطح تابع برای اهداف اشکال‌زدایی یا تحلیل برنامه استفاده شود.
.IP \fB\-p\fR 4
.IX Item "-p"
.PD 0
.IP \fB\-\-profile\fR 4
.IX Item "--profile"
.IP \fB\-fprofile\fR 4
.IX Item "-fprofile"
.IP \fB\-pg\fR 4
.IX Item "-pg"
.PD
کد اضافی برای نوشتن اطلاعات پروفایل‌سازی مناسب برای برنامه تحلیل‌گر \fBprof\fR (برای \fB\-p\fR، \fB\-\-profile\fR، و \fB\-fprofile\fR) یا \fBgprof\fR (برای \fB\-pg\fR) تولید می‌کند. باید از این گزینه هنگام کامپایل کردن فایل‌های منبعی که داده‌های آن‌ها را می‌خواهید استفاده کنید، و همچنین باید آن را در هنگام پیوند دادن نیز به کار ببرید.
.Sp
هنگام کامپایل با این گزینه‌ها، می‌توانید از مشخصه تابع \f(CW\*(C`no_instrument_function\*(C'\fR برای صرف‌نظر از پروفایل‌سازی توابع مشخص استفاده کنید.
.IP \fB\-fprofile\-arcs\fR 4
.IX Item "-fprofile-arcs"
کدی اضافه می‌کند تا کمان‌های جریان برنامه (\fIarcs\fR) ابزارگذاری شوند. در حین اجرا، برنامه ثبت می‌کند که هر شاخه و فراخوانی چند بار اجرا شده و چند بار منشعب شده یا بازگشته است. در مقصدهایی که از سازنده‌ها (constructors) با اولویت پشتیبانی می‌کنند، پروفایل‌سازی به درستی سازنده‌ها، مخرب‌ها (destructors) و سازنده‌های ++C (و مخرب‌های) کلاس‌هایی را که به عنوان نوعی از یک متغیر سراسری استفاده می‌شوند، مدیریت می‌کند.
.Sp
هنگامی که برنامه کامپایل‌شده خارج می‌شود، این داده‌ها را در فایلی به نام \fIauxname.gcda\fR برای هر فایل منبع ذخیره می‌کند. این داده‌ها می‌توانند برای بهینه‌سازی‌های هدایت‌شده با پروفایل (\fB\-fbranch\-probabilities\fR) یا برای تحلیل پوشش آزمون (\fB\-ftest\-coverage\fR) استفاده شوند. نام کمکی (\fIauxname\fR) هر فایل شیء از روی نام فایل خروجی (در صورتی که صراحتاً مشخص شده باشد و فایل اجرایی نهایی نباشد) تولید می‌شود، در غیر این صورت نام پایه (basename) فایل منبع است. در هر دو حالت، هر پسوندی حذف می‌شود (مثلاً \fIfoo.gcda\fR برای فایل ورودی \fIdir/foo.c\fR، یا \fIdir/foo.gcda\fR برای فایل خروجی مشخص‌شده به صورت \fB\-o dir/foo.o\fR).
.Sp
توجه داشته باشید که اگر یک خط فرمان مستقیماً فایل‌های منبع را پیوند دهد، نام فایل خروجی بدون پسوند به عنوان پیشوند فایل‌های \fI.gcda\fR مربوطه قرار خواهد گرفت. برای مثال \f(CW\*(C`gcc a.c b.c \-o binary\*(C'\fR فایل‌های \fIbinary\-a.gcda\fR و \fIbinary\-b.gcda\fR را تولید می‌کند.
.IP \fB\-fcondition\-coverage\fR 4
.IX Item "-fcondition-coverage"
کدی اضافه می‌کند تا شرایط برنامه ابزارگذاری شوند. در طول اجرا، برنامه ثبت می‌کند چه عباراتی در یک شرط در یک تصمیم‌گیری نقش داشته‌اند، که می‌توان از آن برای راستی‌آزمایی این که همه عبارات در یک تابع بولی آزمایش شده و تأثیر مستقلی بر نتیجه تصمیم‌گیری دارند استفاده کرد. نتیجه را می‌توان با \f(CW\*(C`gcov \-\-conditions\*(C'\fR خواند.
.IP \fB\-fpath\-coverage\fR 4
.IX Item "-fpath-coverage"
کدی اضافه می‌کند تا مسیرهای طی‌شده ردگیری شوند. در طول اجرا، برنامه مسیرهای اول طی‌شده (prime paths) را ثبت می‌کند. تعداد مسیرها با افزایش پیچیدگی بسیار سریع رشد می‌کند، و GCC برای جلوگیری از انفجار زمان کامپایل، در صورتی که تعداد تقریبی مسیرها از حد مجاز تعیین‌شده توسط \fB\-fpath\-coverage\-limit\fR فراتر رود، از ابزارگذاری صرف‌نظر می‌کند. نتیجه را می‌توان با \f(CW\*(C`gcov \-\-prime\-paths \-\-prime\-paths\-lines \-\-prime\-paths\-source\*(C'\fR خواند.
.IP \fB\-fpath\-coverage\-limit=\fR\fIlimit\fR 4
.IX Item "-fpath-coverage-limit=limit"
آستانه‌ای که در آن \fB\-fpath\-coverage\fR از ابزارگذاری یک تابع صرف‌نظر می‌کند. این محدودیت تقریبی و محافظه‌کارانه است، زیرا GCC از یک روش ابتکاری بدبینانه استفاده می‌کند که تعداد مسیرهای در حال پردازش را اندکی بیش از حد واقعی می‌شمارد، و در صورتی که پیش از یافتن همه مسیرها به آستانه برسد، کار را متوقف می‌کند. این گزینه برای کنترل دقیق و ریزدانه روی این که کدام توابع ابزارگذاری شوند نیست \- بلکه برای محدود کردن اثر انفجار مسیر و منطقی نگه داشتن زمان کامپایل در نظر گرفته شده است. مقدار پیش‌فرض \fI250000\fR است.
.IP \fB\-\-coverage\fR 4
.IX Item "--coverage"
.PD 0
.IP \fB\-coverage\fR 4
.IX Item "-coverage"
.PD
این گزینه برای کامپایل و پیوند کدهای ابزارگذاری‌شده جهت تحلیل پوشش کد استفاده می‌شود. گزینه‌های \fB\-coverage\fR و \fB\-\-coverage\fR معادل یکدیگرند؛ هر دو مترادفی برای \fB\-fprofile\-arcs\fR و \fB\-ftest\-coverage\fR (هنگام کامپایل) و \fB\-lgcov\fR (هنگام پیوند) هستند. برای جزئیات بیشتر به مستندات آن گزینه‌ها مراجعه کنید.
.RS 4
.IP * 4
فایل‌های منبع را با \fB\-fprofile\-arcs\fR به همراه گزینه‌های بهینه‌سازی و تولید کد کامپایل کنید. برای تحلیل پوشش آزمون، از گزینه اضافی \fB\-ftest\-coverage\fR استفاده نمایید. نیازی نیست همه فایل‌های منبع یک برنامه را پروفایل‌سازی کنید.
.IP * 4
فایل‌های منبع را علاوه بر این با \fB\-fprofile\-abs\-path\fR کامپایل کنید تا نام مسیرهای مطلق در فایل‌های \fI.gcno\fR ایجاد شوند. این امر به \fBgcov\fR اجازه می‌دهد در پروژه‌هایی که کامپایل با دایرکتوری‌های کاری متفاوتی انجام می‌شود، منابع درست را پیدا کند.
.IP * 4
فایل‌های شیء خود را با \fB\-lgcov\fR یا \fB\-fprofile\-arcs\fR پیوند دهید (دومی اولی را نیز در بر دارد)..IP * 4
برنامه را روی یک بار کاری شاخص اجرا کنید تا اطلاعات پروفایل کمان‌ها تولید شود.
این کار می‌تواند به هر تعداد دفعات تکرار شود. شما می‌توانید نمونه‌های هم‌روند
برنامه خود را اجرا کنید، و به شرطی که فایل‌سیستم از قفل‌گذاری پشتیبانی کند،
فایل‌های داده به‌درستی به‌روزرسانی خواهند شد. مگر اینکه یک گزینه سخت‌گیرانه برای
گویش ISO C فعال باشد، فراخوانی‌های \f(CW\*(C`fork\*(C'\fR شناسایی شده و بدون شمارش مضاعف،
به‌درستی مدیریت می‌شوند.
.Sp
علاوه بر این، یک فایل شیء می‌تواند چندین بار بازکامپایل شود و تا زمانی که فایل منبع
و گزینه‌های کامپایلر تغییر نکرده باشند، فایل \fI.gcda\fR مربوطه ادغام می‌شود.
.IP * 4
برای بهینه‌سازی‌های مبتنی بر پروفایل، فایل‌های منبع را مجدداً با همان گزینه‌های
بهینه‌سازی و تولید کد، به علاوهٔ \&\fB\-fbranch\-probabilities\fR کامپایل کنید.
.IP * 4
برای تحلیل پوشش آزمون، از \fBgcov\fR برای تولید اطلاعات خوانا برای انسان از
فایل‌های \fI.gcno\fR و \fI.gcda\fR استفاده کنید. برای اطلاعات بیشتر به مستندات
\&\fBgcov\fR مراجعه نمایید.
.RE
.RS 4
.Sp
با \fB\-fprofile\-arcs\fR، برای هر تابع از برنامه شما، GCC یک گراف جریان برنامه
ایجاد می‌کند، سپس یک درخت پوشا برای گراف می‌یابد. تنها کمان‌هایی که روی درخت
پوشا نیستند باید مجهزسازی شوند: کامپایلر کدی برای شمارش تعداد دفعات اجرای این
کمان‌ها اضافه می‌کند. هنگامی که یک کمان تنها خروجی یا تنها ورودی یک بلوک باشد،
کد مجهزسازی را می‌توان به همان بلوک افزود؛ در غیر این صورت، برای نگهداری کد
مجهزسازی باید یک بلوک پایه جدید ایجاد شود.
.Sp
با \fB\-fcondition\-coverage\fR، برای هر عبارت شرطی در برنامه شما، GCC یک مجموعه بیتی
ایجاد می‌کند و مقادیر بولیِ اجراشده‌ای را که تأثیر مستقلی بر نتیجه آن عبارت دارند
ثبت می‌نماید.
.Sp
با \fB\-fpath\-coverage\fR،‏ GCC مسیرهای اول (prime paths) پیموده‌شده هر تابع را یافته،
شمارش و ثبت می‌کند، مگر آنکه تعداد مسیرها از حد کنترل‌شده توسط
\fB\-fpath\-coverage\-limit\fR فراتر رود. در صورت فراتر رفتن از حد مجاز، تابع
مجهزسازی نخواهد شد، درست مانند اینکه از \&\fB\-fpath\-coverage\fR استفاده نشده باشد.
یک مسیر اول، طولانی‌ترین دنباله از بلوک‌های یکتا (به‌جز احتمالاً اولی و آخری) است
که زیرمسیری از هیچ مسیر دیگری نباشد.
.RE
.IP \fB\-ftest\-coverage\fR 4
.IX Item "-ftest-coverage"
یک فایل یادداشت تولید می‌کند که ابزار سنجش پوشش کد \fBgcov\fR می‌تواند برای نمایش
میزان پوشش برنامه از آن استفاده کند. فایل یادداشت هر فایل منبع،
\&\fIauxname.gcno\fR نام دارد. برای توضیحات در مورد \fIauxname\fR و دستورالعمل‌های
نحوه تولید داده‌های پوشش آزمون، به گزینه \fB\-fprofile\-arcs\fR در بالا مراجعه کنید.
اگر برنامه را بهینه‌سازی نکنید، داده‌های پوشش با دقت بیشتری با فایل‌های منبع
تطابق خواهند داشت.
.IP \fB\-fprofile\-abs\-path\fR 4
.IX Item "-fprofile-abs-path"
نام‌های نسبی فایل‌های منبع را به‌طور خودکار در فایل‌های \fI.gcno\fR به مسیرهای
مطلق تبدیل می‌کند. این به \fBgcov\fR امکان می‌دهد در پروژه‌هایی که کامپایل در
دایرکتوری‌های کاری متفاوتی انجام می‌شود، فایل‌های منبع صحیح را پیدا کند.
.IP \fB\-fprofile\-dir=\fR\fIpath\fR 4
.IX Item "-fprofile-dir=path"
دایرکتوری جستجو برای فایل‌های داده پروفایل را به \fIpath\fR تنظیم می‌کند.
این گزینه فقط بر داده‌های پروفایل تولیدشده توسط
\&\fB\-fprofile\-generate\fR،‏ \fB\-ftest\-coverage\fR،‏ \fB\-fprofile\-arcs\fR
و داده‌های استفاده‌شده توسط \fB\-fprofile\-use\fR،‏ \fB\-fbranch\-probabilities\fR
و گزینه‌های مرتبط با آن تأثیر می‌گذارد. هر دو مسیر مطلق و نسبی قابل استفاده هستند.
به‌طور پیش‌فرض، GCC از دایرکتوری جاری به عنوان \fIpath\fR استفاده می‌کند، بنابراین
فایل داده پروفایل در همان دایرکتوریِ فایل شیء ظاهر می‌شود. به منظور جلوگیری از تداخل
نام فایل‌ها، اگر نام فایل شیء یک مسیر مطلق نباشد، مسیر مطلق فایل
\&\fIsourcename.gcda\fR دگرگون (mangle) شده و به عنوان نام فایل یک فایل
\&\fI.gcda\fR استفاده می‌شود. جزئیات نام‌گذاری فایل را در \fB\-fprofile\-arcs\fR ببینید.
گزینه مشابه \fB\-fprofile\-note\fR را نیز ملاحظه کنید.
.Sp
هنگامی که یک فایل اجرایی در یک محیط بسیار موازی اجرا می‌شود، توصیه می‌شود که
پروفایل در پوشه‌های متفاوتی ذخیره گردد. این کار را می‌توان با متغیرهایی در
\fIpath\fR انجام داد که در زمان اجرا مقداردهی (export) می‌شوند:
.RS 4
.ie n .IP \fR\fB%p\fR\fB\fR 4
.el .IP \fR\f(CB%p\fR\fB\fR 4
.IX Item "%p"
شناسه فرایند (PID).
.ie n .IP \fR\fB%q\fR\fB{VAR}\fR 4
.el .IP \fR\f(CB%q\fR\fB{VAR}\fR 4
.IX Item "%q{VAR}"
مقدار متغیر محیطی \fIVAR\fR
.RE
.RS 4
.RE
.IP \fB\-fprofile\-generate\fR 4
.IX Item "-fprofile-generate"
.PD 0
.IP \fB\-fprofile\-generate=\fR\fIpath\fR 4
.IX Item "-fprofile-generate=path"
.PD
گزینه‌هایی را فعال می‌کند که معمولاً برای مجهزسازی برنامه جهت تولید پروفایلِ مفید
برای بازکامپایل بعدی با بهینه‌سازی مبتنی بر بازخورد پروفایل به کار می‌روند. شما باید
\fB\-fprofile\-generate\fR را هم هنگام کامپایل و هم هنگام پیوند زدن برنامه خود
به کار ببرید.
.Sp
گزینه‌های زیر فعال می‌شوند:
\&\fB\-fprofile\-arcs\fR،‏ \fB\-fprofile\-values\fR،‏
\&\fB\-finline\-functions\fR و \fB\-fipa\-bit\-cp\fR.
.Sp
اگر \fIpath\fR مشخص شده باشد، GCC برای یافتن فایل‌های داده بازخورد پروفایل به
\fIpath\fR نگاه می‌کند. به \fB\-fprofile\-dir\fR مراجعه کنید.
.Sp
برای بهینه‌سازی برنامه بر اساس اطلاعات پروفایل جمع‌آوری‌شده، از
\&\fB\-fprofile\-use\fR استفاده کنید.
.IP \fB\-fprofile\-info\-section\fR 4
.IX Item "-fprofile-info-section"
.PD 0
.IP \fB\-fprofile\-info\-section=\fR\fIname\fR 4
.IX Item "-fprofile-info-section=name"
.PD
اطلاعات پروفایل را به جای استفاده از سازنده/ویرانگر، در بخش (section) مشخص‌شده
ثبت می‌کند. اگر \fIname\fR مشخص شده باشد نام بخش همان است، در غیر این صورت نام بخش
به طور پیش‌فرض به \f(CW\*(C`.gcov_info\*(C'\fR تغییر می‌یابد. برای هر واحد ترجمه،
اشاره‌گری به اطلاعات پروفایل تولیدشده توسط \fB\-fprofile\-arcs\fR در بخش مشخص‌شده
قرار می‌گیرد. این گزینه ثبت اطلاعات پروفایل از طریق یک سازنده را غیرفعال کرده و
پردازش اطلاعات پروفایل از طریق یک ویرانگر را نیز غیرفعال می‌سازد. این گزینه برای
استفاده در محیط‌های میزبانی‌شده مانند GNU/Linux در نظر گرفته نشده است. هدف آن
محیط‌های مستقل (برای مثال سامانه‌های تعبیه‌شده) با منابع محدود است که از
سازنده‌ها/ویرانگرها یا ورودی/خروجی فایل کتابخانه C پشتیبانی نمی‌کنند.
.Sp
پیونددهنده می‌تواند بخش‌های ورودی را در یک بلوک پیوسته از حافظه جمع‌آوری کرده
و نمادهای آغاز و پایان را تعریف نماید. نمونه‌ای از اسکریپت پیونددهنده GNU که یک
بخش خروجی پیونددهنده را تعریف می‌کند در ادامه آمده است:
.Sp
.Vb 6
\&          .gcov_info      :
\&          {
\&            PROVIDE (_\|_gcov_info_start = .);
\&            KEEP (*(.gcov_info))
\&            PROVIDE (_\|_gcov_info_end = .);
\&          }
.Ve
.Sp
برنامه می‌تواند اطلاعات پروفایل ثبت‌شده در این مجموعه پیونددهنده را مثلاً به این
صورت تخلیه (dump) کند:
.Sp
.Vb 3
\&        #include <gcov.h>
\&        #include <stdio.h>
\&        #include <stdlib.h>
\&        
\&        extern const struct gcov_info *const _\|_gcov_info_start[];
\&        extern const struct gcov_info *const _\|_gcov_info_end[];
\&        
\&        static void
\&        dump (const void *d, unsigned n, void *arg)
\&        {
\&          const unsigned char *c = d;
\&        
\&          for (unsigned i = 0; i < n; ++i)
\&            printf ("%02x", c[i]);
\&        }
\&        
\&        static void
\&        filename (const char *f, void *arg)
\&        {
\&          _\|_gcov_filename_to_gcfn (f, dump, arg );
\&        }
\&        
\&        static void *
\&        allocate (unsigned length, void *arg)
\&        {
\&          return malloc (length);
\&        }
\&        
\&        static void
\&        dump_gcov_info (void)
\&        {
\&          const struct gcov_info *const *info = _\|_gcov_info_start;
\&          const struct gcov_info *const *end = _\|_gcov_info_end;
\&        
\&          /* Obfuscate variable to prevent compiler optimizations.  */
\&          _\|_asm_\|_ ("" : "+r" (info));
\&        
\&          while (info != end)
\&          {
\&            void *arg = NULL;
\&            _\|_gcov_info_to_gcda (*info, filename, dump, allocate, arg);
\&            putchar (\*(Aq\en\*(Aq);
\&            ++info;
\&          }
\&        }
\&        
\&        int
\&        main (void)
\&        {
\&          dump_gcov_info ();
\&          return 0;
\&        }
.Ve
.Sp
زیرفرمان \fBmerge\-stream\fR از \fBgcov\-tool\fR می‌تواند برای بازسازی داده‌ها
(deserialize) از جریان داده تولیدشده توسط توابع
\f(CW\*(C`_\|_gcov_filename_to_gcfn\*(C'\fR و
\&\f(CW\*(C`_\|_gcov_info_to_gcda\*(C'\fR و ادغام اطلاعات پروفایل در فایل‌های
\&\fI.gcda\fR روی فایل‌سیستم میزبان به کار رود..IP \fB\-fprofile\-note=\fR\fIpath\fR 4
.IX Item "-fprofile-note=path"
اگر \fIpath\fR مشخص شده باشد، GCC فایل \fI.gcno\fR را در مکان \fIpath\fR ذخیره می‌کند. اگر این گزینه را با چندین فایل مبدأ ترکیب کنید، فایل \fI.gcno\fR بازنویسی خواهد شد.
.IP \fB\-fprofile\-prefix\-path=\fR\fIpath\fR 4
.IX Item "-fprofile-prefix-path=path"
این گزینه می‌تواند در ترکیب با \&\fBprofile\-generate=\fR\fIprofile_dir\fR و
\&\fBprofile\-use=\fR\fIprofile_dir\fR برای آگاه‌سازی GCC از مکان دایرکتوری پایهٔ
درخت مبدأ ساخته‌شده به کار رود. به‌طور پیش‌فرض، \fIprofile_dir\fR شامل فایل‌هایی با
مسیرهای مطلق درهم‌ریخته (mangled) از تمامی فایل‌های شیء پروژهٔ ساخته‌شده خواهد بود.
این وضعیت زمانی که دایرکتوری مورد استفاده برای ساخت دودویی سنجش‌شده (instrumented)
با دایرکتوری مورد استفاده برای ساخت دودویی بهینه‌شده با بازخورد پروفایل تفاوت داشته باشد
مطلوب نیست؛ زیرا داده‌های پروفایل در طول ساخت بهینه‌شده پیدا نخواهند شد. در چنین
شرایطی، می‌توان از \fB\-fprofile\-prefix\-path=\fR\fIpath\fR در حالی که \fIpath\fR به
دایرکتوری پایهٔ ساخت اشاره دارد، برای حذف بخش نامربوط مسیر و نسبی نگه‌داشتن تمامی
نام‌های فایل نسبت به دایرکتوری اصلی ساخت استفاده کرد.
.IP \fB\-fprofile\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR 4
.IX Item "-fprofile-prefix-map=old=new"
هنگام کامپایل فایل‌های مستقر در دایرکتوری \fIold\fR، اطلاعات پروفایل‌سازی (با \fB\-\-coverage\fR)
را به‌گونه‌ای ثبت می‌کند که گویی آن فایل‌ها در دایرکتوری \fInew\fR قرار دارند.
همچنین \fB\-ffile\-prefix\-map\fR و \fB\-fcanon\-prefix\-map\fR را ببینید.
.IP \fB\-fprofile\-update=\fR\fImethod\fR 4
.IX Item "-fprofile-update=method"
روش به‌روزرسانی را برای برنامه‌ای که برای بهینه‌سازی مبتنی بر بازخورد پروفایل سنجش
شده است، تغییر می‌دهد. آرگومان \fImethod\fR باید یکی از مقادیر \&\fBsingle\fR،
\fBatomic\fR یا \fBprefer\-atomic\fR باشد. مقدار اول برای برنامه‌های تک‌نخی
مفید است، در حالی که مقدار دوم با تولید کد امن از نظر نخ‌ها (thread\-safe)، از خراب
شدن پروفایل جلوگیری می‌کند.
.Sp
\&\fBهشدار:\fR هنگامی که یک برنامه تمام نخ‌ها را به‌درستی الحاق (join) نکند
(یا یک نخ جداشده/detached ایجاد کند)، فایل پروفایل همچنان ممکن است مخدوش شود.
.Sp
استفاده از \fBprefer\-atomic\fR در صورت پشتیبانی توسط معماری مقصد به \fBatomic\fR
و در غیر این صورت به \fBsingle\fR تبدیل می‌شود. گردانندهٔ GCC زمانی که \fB\-pthread\fR
در خط فرمان موجود باشد، به‌طور خودکار \fBprefer\-atomic\fR را انتخاب می‌کند؛ در غیر این
صورت روش پیش‌فرض \fBsingle\fR است.
.Sp
اگر \fBatomic\fR انتخاب شود، اطلاعات پروفایل با استفاده از عملیات اتمیک بر اساس
حداکثر تلاش (best\-effort) به‌روزرسانی می‌شوند. در حالت ایده‌آل، اطلاعات پروفایل
از طریق عملیات اتمیک در سخت‌افزار به‌روزرسانی می‌گردند. اما اگر سکوی مقصد از عملیات
اتمیک مورد نیاز در سخت‌افزار پشتیبانی نکند ولی \fIlibatomic\fR در دسترس باشد، اطلاعات
پروفایل از طریق فراخوانی‌های \&\fIlibatomic\fR به‌روزرسانی می‌شوند. چنانچه سکوی مقصد
نه از عملیات اتمیک سخت‌افزاری لازم پشتیبانی کند و نه از \fIlibatomic\fR، اطلاعات
پروفایل به‌صورت اتمیک به‌روز نخواهد شد و هشداری صادر می‌شود. در این حالت، اطلاعات
پروفایلِ به‌دست‌آمده برای برنامه‌های چندنخی ممکن است نامعتبر یا مخدوش باشد.
.Sp
به دلایل کارایی، اگر از شمارنده‌های ۶۴ بیتی برای اطلاعات پروفایل استفاده شود و سکوی
مقصد تنها از عملیات اتمیک ۳۲ بیتی در سخت‌افزار پشتیبانی کند، به‌روزرسانی‌های حساس به
کارایی پروفایل با استفاده از دو عملیات اتمیک ۳۲ بیتی برای هر به‌روزرسانی شمارنده
انجام می‌شوند. اگر سیگنالی این دو عملیات به‌روزرسانی شمارنده را قطع کند، اطلاعات
پروفایل ممکن است در وضعیتی ناهمگون قرار گیرند.
.IP \fB\-fprofile\-filter\-files=\fR\fIregex\fR 4
.IX Item "-fprofile-filter-files=regex"
تنها توابعی از فایل‌هایی را مورد سنجش قرار می‌دهد که نام آن‌ها با هر یک از عبارت‌های
باقاعده (که با نقطه‌ویرگول از یکدیگر جدا شده‌اند) مطابقت داشته باشد.
.Sp
برای مثال، \fB\-fprofile\-filter\-files=main\e.c;module.*\e.c\fR تنها \fImain.c\fR
و تمام فایل‌های C که با \*(Aqmodule\*(Aq آغاز می‌شوند را می‌سنجد.
.IP \fB\-fprofile\-exclude\-files=\fR\fIregex\fR 4
.IX Item "-fprofile-exclude-files=regex"
تنها توابعی از فایل‌هایی را مورد سنجش قرار می‌دهد که نام آن‌ها با هیچ‌یک از
عبارت‌های باقاعده (که با نقطه‌ویرگول از یکدیگر جدا شده‌اند) مطابقت نداشته باشد.
.Sp
برای مثال، \fB\-fprofile\-exclude\-files=/usr/.*\fR از سنجش تمامی فایل‌هایی که در
پوشهٔ \fI/usr/\fR قرار دارند جلوگیری می‌کند.
.IP \fB\-fprofile\-reproducible=\fR[\fBmultithreaded\fR|\fBparallel\-runs\fR|\fBserial\fR] 4
.IX Item "-fprofile-reproducible=[multithreaded|parallel-runs|serial]"
سطح تکرارپذیری پروفایل جمع‌آوری‌شده توسط \&\f(CW\*(C`\-fprofile\-generate\*(C'\fR را
کنترل می‌کند. این امکان را فراهم می‌سازد که برنامه را با نتیجهٔ یکسان بازسازی کرد
که برای مثال در بسته‌های توزیع مفید است.
.Sp
با \fB\-fprofile\-reproducible=serial\fR، پروفایل جمع‌آوری‌شده توسط
\&\fB\-fprofile\-generate\fR تکرارپذیر خواهد بود به شرطی که برنامهٔ آموزش‌داده‌شده
در هر بار فراخوانی اجرای آموزشی رفتار یکسانی داشته باشد، چندنخی نباشد و جریان داده‌های
پروفایل همیشه با ترتیبی یکسان انجام شود. توجه داشته باشید که جریان داده‌های پروفایل
در پایان اجرای برنامه و همچنین پیش از فراخوانی تابع \f(CW\*(C`fork\*(C'\fR صورت می‌گیرد.
.Sp
توجه داشته باشید که بسیار معمول است که تعداد دفعات اجرای برخی از بخش‌های برنامه‌ها
به عنوان مثال به طول نام‌های فایل‌های موقت یا تصادفی‌سازی فضای حافظه (که ممکن است
بر نرخ برخورد در جدول هش تأثیر بگذارد) بستگی داشته باشد. چنین بخش‌های غیرتکرارپذیری
از برنامه‌ها را می‌توان با صفت تابع \&\f(CW\*(C`no_instrument_function\*(C'\fR
حاشیه‌نویسی کرد. ابزار \fBgcov\-dump\fR همراه با \&\fB\-l\fR می‌تواند برای تخلیهٔ
داده‌های جمع‌آوری‌شده و راستی‌آزمایی تکرارپذیر بودن واقعی آن‌ها به کار رود.
.Sp
با \fB\-fprofile\-reproducible=parallel\-runs\fR، پروفایل جمع‌آوری‌شده صرف‌نظر از
ترتیب جریان داده‌ها به درون فایل‌های gcda، تکرارپذیر می‌ماند. این تنظیم امکان اجرای
موازی چندین نمونه از برنامهٔ سنجش‌شده را فراهم می‌کند (مانند اجرا با
\f(CW\*(C`make \-j\*(C'\fR). این کار کیفیت داده‌های جمع‌آوری‌شده را، به‌ویژه در
پروفایل‌سازی فراخوانی‌های غیرمستقیم، کاهش می‌دهد.
.IP \fB\-fsanitize=address\fR 4
.IX Item "-fsanitize=address"
فعال‌سازی AddressSanitizer، یک آشکارساز سریع خطاهای حافظه.
دستورالعمل‌های دسترسی به حافظه برای تشخیص باگ‌های خارج از محدوده (out\-of\-bounds)
و استفاده پس از آزادسازی (use\-after\-free) مورد سنجش قرار می‌گیرند.
این گزینه \fB\-fsanitize\-address\-use\-after\-scope\fR را فعال می‌کند.
برای جزئیات بیشتر به <\fBhttps://github.com/google/sanitizers/wiki/AddressSanitizer\fR>
مراجعه کنید. رفتار زمان اجرا را می‌توان با استفاده از متغیر محیطی \&\fBASAN_OPTIONS\fR
تحت تأثیر قرار داد. هنگامی که روی \f(CW\*(C`help=1\*(C'\fR تنظیم شود، گزینه‌های موجود
در زمان راه‌اندازی برنامهٔ سنجش‌شده نمایش داده می‌شوند. برای فهرستی از گزینه‌های پشتیبانی‌شده
به <\fBhttps://github.com/google/sanitizers/wiki/AddressSanitizerFlags#run\-time\-flags\fR>
مراجعه کنید.
این گزینه نمی‌تواند با \fB\-fsanitize=thread\fR یا \&\fB\-fsanitize=hwaddress\fR
ترکیب شود. توجه داشته باشید که تنها مقصدهایی که \&\fB\-fsanitize=hwaddress\fR در حال حاضر
روی آن‌ها پشتیبانی می‌شود عبارتند از x86\-64 (تنها با گزینه‌های \f(CW\*(C`\-mlam=u48\*(C'\fR
یا \f(CW\*(C`\-mlam=u57\*(C'\fR) و AArch64، در هر دو مورد تنها در ABIهای با اشاره‌گرهای
۶۴ بیتی. به‌طور مشابه، \&\fB\-fsanitize=memtag\-stack\fR در حال حاضر تنها روی ABIهای
AArch64 با اشاره‌گرهای ۶۴ بیتی پشتیبانی می‌شود.
.Sp
هنگام کامپایل با \fB\-fsanitize=address\fR، باید از \fB\-g\fR نیز استفاده کنید
تا خروجی پرمعناتری تولید شود. برای دریافت ردگیری‌های پشته (stack traces) دقیق‌تر،
می‌توان از گزینه‌هایی مانند \&\fB\-O0\fR، \fB\-O1\fR یا \fB\-Og\fR (که مثلاً مانع بیشتر
درون‌خطی‌سازی‌های توابع می‌شوند)، \fB\-fno\-optimize\-sibling\-calls\fR (که مانع
بهینه‌سازی فراخوانی‌های هم‌سطح و بازگشتی پایانی می‌شود؛ این گزینه برای \&\fB\-O0\fR،
\fB\-O1\fR یا \fB\-Og\fR ضمنی است)، یا \fB\-fno\-ipa\-icf\fR (که Identical Code Folding
را برای توابع غیرفعال می‌کند) استفاده کرد. استفاده از \fB\-fno\-omit\-frame\-pointer\fR
نیز ردگیری‌های پشته را بهبود می‌بخشد. از آنجا که به دلیل ASLR (تصادفی‌سازی چیدمان
فضای آدرس)، چندین بار اجرای برنامه ممکن است ردگیری‌های برگشتی (backtraces) با
آدرس‌های متفاوتی تولید کنند، ممکن است خاموش کردن ASLR مطلوب باشد. در لینوکس، این کار
با \fBsetarch \`uname \-m\` \-R ./prog\fR قابل انجام است.
.IP \fB\-fsanitize=kernel\-address\fR 4
.IX Item "-fsanitize=kernel-address"
فعال‌سازی AddressSanitizer برای هستهٔ لینوکس.
برای جزئیات بیشتر به <\fBhttps://github.com/google/kernel\-sanitizers\fR> مراجعه کنید.
.IP \fB\-fsanitize=hwaddress\fR 4
.IX Item "-fsanitize=hwaddress"
فعال‌سازی Hardware\-assisted AddressSanitizer، که از یک قابلیت سخت‌افزاری برای نادیده
گرفتن بایت بالایی (top byte) یک اشاره‌گر استفاده می‌کند تا امکان تشخیص خطاهای حافظه را با
سربار حافظهٔ اندک فراهم سازد.
دستورالعمل‌های دسترسی به حافظه برای تشخیص باگ‌های خارج از محدوده و استفاده پس از آزادسازی
مورد سنجش قرار می‌گیرند.
این گزینه \fB\-fsanitize\-address\-use\-after\-scope\fR را فعال می‌کند.
برای جزئیات بیشتر به
<\fBhttps://clang.llvm.org/docs/HardwareAssistedAddressSanitizerDesign.html\fR>
مراجعه کنید. رفتار زمان اجرا را می‌توان با استفاده از متغیر محیطی \&\fBHWASAN_OPTIONS\fR
تحت تأثیر قرار داد. هنگامی که روی \f(CW\*(C`help=1\*(C'\fR تنظیم شود، گزینه‌های موجود
در هنگام راه‌اندازی برنامهٔ سنجش‌شده نمایش داده می‌شوند.
این گزینه نمی‌تواند با \fB\-fsanitize=thread\fR یا \&\fB\-fsanitize=address\fR
ترکیب شود، و در حال حاضر تنها روی AArch64 در دسترس است.
.IP \fB\-fsanitize=kernel\-hwaddress\fR 4
.IX Item "-fsanitize=kernel-hwaddress"
فعال‌سازی Hardware\-assisted AddressSanitizer برای کامپایل هستهٔ لینوکس.
مشابه \fB\-fsanitize=kernel\-address\fR اما با استفاده از یک روش سنجش جایگزین،
و مشابه \fB\-fsanitize=hwaddress\fR اما با تفاوت‌های سنجشی که برای کامپایل هستهٔ
لینوکس ضروری است. این تفاوت‌ها برای اجتناب از فراخوانی‌های راه‌اندازی اولیهٔ
کتابخانهٔ hwasan و در نظر گرفتن داشتن مقداری متفاوت در بایت بالایی اشاره‌گر پشته هستند.
.Sp
\&\fIنکته:\fR این گزینه مقادیر پیش‌فرض متفاوتی نسبت به \&\fB\-fsanitize=hwaddress\fR دارد.
سنجش پشته و فراخوانی‌های alloca به‌طور پیش‌فرض فعال نیستند.
استفاده از برچسب تصادفی فریم (random frame tag) برای سنجش هسته پیاده‌سازی نشده است.
.IP \fB\-fsanitize=memtag\-stack\fR 4
.IX Item "-fsanitize=memtag-stack"
استفاده از دستورالعمل‌های Memory Tagging Extension به جای سنجش کد برای فراهم کردن
امکان تشخیص خطاهای حافظه. مشابه HWASAN، این نیز یک روش احتمالی (probabilistic) است.
این گزینه تنها روی آن دسته از معماری‌های AArch64 در دسترس است که از
Memory Tagging Extensions پشتیبانی می‌کنند.
.IP \fB\-fsanitize=pointer\-compare\fR 4
.IX Item "-fsanitize=pointer-compare"
سنجش عملیات مقایسه (<، <=، >، >=) با عملوندهای اشاره‌گر.
این گزینه باید با \fB\-fsanitize=kernel\-address\fR یا \&\fB\-fsanitize=address\fR
ترکیب شود.
این گزینه نمی‌تواند با \fB\-fsanitize=thread\fR ترکیب شود.
نکته: به‌طور پیش‌فرض این بررسی در هنگام اجرا غیرفعال است. برای فعال کردن آن،
\f(CW\*(C`detect_invalid_pointer_pairs=2\*(C'\fR را به متغیر محیطی \&\fBASAN_OPTIONS\fR
اضافه کنید. استفاده از \f(CW\*(C`detect_invalid_pointer_pairs=1\*(C'\fR عملیات نامعتبر را
تنها زمانی تشخیص می‌دهد که هر دو اشاره‌گر غیرتهی (non\-null) باشند..IP \fB\-fsanitize=pointer\-subtract\fR 4
.IX Item "-fsanitize=pointer-subtract"
ابزارگذاری عملیات تفریق با عملوندهای اشاره‌گر.
این گزینه باید با \fB\-fsanitize=kernel\-address\fR یا
\&\fB\-fsanitize=address\fR ترکیب شود.
این گزینه نمی‌تواند با \fB\-fsanitize=thread\fR ترکیب شود.
نکته: این بررسی به‌طور پیش‌فرض در زمان اجرا غیرفعال است. برای فعال‌سازی آن،
\f(CW\*(C`detect_invalid_pointer_pairs=2\*(C'\fR را به متغیر محیطی
\&\fBASAN_OPTIONS\fR اضافه کنید. استفاده از \f(CW\*(C`detect_invalid_pointer_pairs=1\*(C'\fR عملیات
نامعتبر را تنها زمانی که هر دو اشاره‌گر غیرتهی (non\-null) باشند تشخیص می‌دهد.
.IP \fB\-fsanitize=shadow\-call\-stack\fR 4
.IX Item "-fsanitize=shadow-call-stack"
فعال‌سازی ShadowCallStack، سازوکاری برای بهبود امنیت به منظور محافظت از
برنامه‌ها در برابر بازنویسی آدرس بازگشت (مانند سرریزهای بافر پشته).
این سازوکار با ذخیره آدرس بازگشت تابع در یک پشته فراخوانی سایه با تخصیص جداگانه
در مقدمه تابع (prologue) و بازیابی آدرس بازگشت از پشته فراخوانی سایه در مؤخره
تابع (epilogue) کار می‌کند. ابزارگذاری تنها در توابعی رخ می‌دهد که نیاز به
ذخیره آدرس بازگشت در پشته دارند.
.Sp
در حال حاضر این سازوکار تنها از بستر aarch64 پشتیبانی می‌کند. این ویژگی به‌طور خاص
برای هسته‌های لینوکسی طراحی شده است که گزینه CONFIG_SHADOW_CALL_STACK را فعال کرده‌اند.
برای برنامه‌های فضای کاربری، پشتیبانی زمان اجرا در حال حاضر در libc و libgcc
فراهم نشده است. کاربرانی که می‌خواهند از این ویژگی در فضای کاربری استفاده کنند باید
پشتیبانی زمان اجرای خودشان را فراهم سازند. باید توجه داشت که این کار ممکن است
باعث نقض قواعد ABI شود.
.Sp
در aarch64، ابزارگذاری از ثبات بستری \f(CW\*(C`x18\*(C'\fR استفاده می‌کند.
این عموماً بدین معناست که هر کدی که ممکن است در همان ریسه‌ای اجرا شود که کد
کامپایل‌شده با ShadowCallStack اجرا می‌شود، باید با پرچم
\&\fB\-ffixed\-x18\fR کامپایل شود؛ در غیر این صورت توابعی که بدون
\&\fB\-ffixed\-x18\fR کامپایل شده‌اند ممکن است \f(CW\*(C`x18\*(C'\fR را مخدوش کرده
و اشاره‌گر پشته سایه را خراب کنند.
.Sp
همچنین، به دلیل عدم وجود پشتیبانی زمان اجرا در فضای کاربری، کدهای کامپایل‌شده با
ShadowCallStack نمی‌توانند از مدیریت استثناها استفاده کنند. برای غیرفعال کردن استثناها
از \fB\-fno\-exceptions\fR استفاده کنید.
.Sp
برای جزئیات بیشتر به <\fBhttps://clang.llvm.org/docs/ShadowCallStack.html\fR> مراجعه
کنید.
.IP \fB\-fsanitize=thread\fR 4
.IX Item "-fsanitize=thread"
فعال‌سازی ThreadSanitizer، یک آشکارساز سریع رقابت داده‌ای (data race).
دستورالعمل‌های دسترسی به حافظه برای تشخیص باگ‌های رقابت داده‌ای ابزارگذاری
می‌شوند. برای جزئیات بیشتر به <\fBhttps://github.com/google/sanitizers/wiki#threadsanitizer\fR>
مراجعه کنید. رفتار زمان اجرا را می‌توان با استفاده از متغیر محیطی \fBTSAN_OPTIONS\fR
تحت تأثیر قرار داد؛ برای فهرستی از گزینه‌های پشتیبانی‌شده به
<\fBhttps://github.com/google/sanitizers/wiki/ThreadSanitizerFlags\fR> مراجعه کنید.
این گزینه نمی‌تواند با \fB\-fsanitize=address\fR یا
\&\fB\-fsanitize=leak\fR ترکیب شود.
.Sp
هنگام کامپایل با \fB\-fsanitize=thread\fR، باید از
\&\fB\-g\fR نیز برای تولید خروجی معنادارتر استفاده کنید.
.Sp
توجه داشته باشید که توابع درونی اتمیک پالایش‌شده هنگام کار روی آدرس‌های
حافظه نامعتبر با استثناهای غیرفراخوانی (\fB\-fnon\-call\-exceptions\fR)،
نمی‌توانند استثنا پرتاب کنند.
.IP \fB\-fsanitize=leak\fR 4
.IX Item "-fsanitize=leak"
فعال‌سازی LeakSanitizer، یک آشکارساز نشت حافظه.
این گزینه تنها برای پیوند دادن (linking) فایل‌های اجرایی اهمیت دارد.
فایل اجرایی با کتابخانه‌ای پیوند می‌یابد که تابع \f(CW\*(C`malloc\*(C'\fR
و سایر توابع تخصیص‌دهنده را بازنویسی می‌کند. برای جزئیات بیشتر به
<\fBhttps://github.com/google/sanitizers/wiki/AddressSanitizerLeakSanitizer\fR> مراجعه
کنید. رفتار زمان اجرا را می‌توان با استفاده از متغیر محیطی
\&\fBLSAN_OPTIONS\fR تحت تأثیر قرار داد.
این گزینه نمی‌تواند با \fB\-fsanitize=thread\fR ترکیب شود.
.IP \fB\-fsanitize=undefined\fR 4
.IX Item "-fsanitize=undefined"
فعال‌سازی UndefinedBehaviorSanitizer، یک آشکارساز سریع رفتار تعریف‌نشده.
محاسبات گوناگون برای تشخیص رفتار تعریف‌نشده در زمان اجرا ابزارگذاری
می‌شوند. برای جزئیات بیشتر به <\fBhttps://clang.llvm.org/docs/UndefinedBehaviorSanitizer.html\fR> مراجعه کنید. رفتار زمان اجرا را می‌توان با استفاده از متغیر محیطی
\&\fBUBSAN_OPTIONS\fR تحت تأثیر قرار داد. زیرگزینه‌های کنونی عبارتند از:
.RS 4
.IP \fB\-fsanitize=shift\fR 4
.IX Item "-fsanitize=shift"
این گزینه بررسی اینکه نتیجه عملیات شیفت تعریف‌نشده نباشد را فعال می‌کند.
توجه داشته باشید که آنچه دقیقاً تعریف‌نشده تلقی می‌شود بین C و ++C و
همچنین بین ISO C90 و C99 و غیره اندکی تفاوت دارد.
این گزینه دو زیرگزینه دارد: \fB\-fsanitize=shift\-base\fR و
\&\fB\-fsanitize=shift\-exponent\fR.
.IP \fB\-fsanitize=shift\-exponent\fR 4
.IX Item "-fsanitize=shift-exponent"
این گزینه بررسی منفی نبودن آرگومان دوم عملیات شیفت و کوچک‌تر بودن آن از دقتِ
آرگومان اولِ ارتقایافته را فعال می‌کند.
.IP \fB\-fsanitize=shift\-base\fR 4
.IX Item "-fsanitize=shift-base"
اگر آرگومان دوم یک عملیات شیفت در محدوده مجاز باشد، بررسی می‌کند که
نتیجه عملیات شیفت تعریف‌نشده نباشد. توجه داشته باشید که آنچه دقیقاً
تعریف‌نشده تلقی می‌شود بین C و ++C و همچنین بین ISO C90 و C99 و غیره
اندکی متفاوت است.
.IP \fB\-fsanitize=integer\-divide\-by\-zero\fR 4
.IX Item "-fsanitize=integer-divide-by-zero"
تشخیص تقسیم صحیح بر صفر.
.IP \fB\-fsanitize=unreachable\fR 4
.IX Item "-fsanitize=unreachable"
با این گزینه، کامپایلر فراخوانی \f(CW\*(C`_\|_builtin_unreachable\*(C'\fR
را در عوض به یک فراخوانی پیام خطایابی تبدیل می‌کند. هنگام رسیدن به
فراخوانی \&\f(CW\*(C`_\|_builtin_unreachable\*(C'\fR، رفتار برنامه تعریف‌نشده است.
.IP \fB\-fsanitize=vla\-bound\fR 4
.IX Item "-fsanitize=vla-bound"
این گزینه به کامپایلر دستور می‌دهد تا مثبت بودن اندازه یک آرایه
با طول متغیر را بررسی کند.
.IP \fB\-fsanitize=null\fR 4
.IX Item "-fsanitize=null"
این گزینه بررسی اشاره‌گرها را فعال می‌کند. به‌طور مشخص، برنامه‌ای که
با این گزینه فعال ساخته شود، در صورت تلاش برای ارجاع‌زدایی یک اشاره‌گر NULL،
یا اگر یک ارجاع (احتمالاً یک ارجاع rvalue) به یک اشاره‌گر NULL مقید شود،
یا اگر متدی روی شیئی که توسط یک اشاره‌گر NULL نشانه رفته فراخوانی شود،
یک پیام خطا صادر خواهد کرد.
.IP \fB\-fsanitize=return\fR 4
.IX Item "-fsanitize=return"
این گزینه بررسی دستور بازگشت (return) را فعال می‌کند. برنامه‌هایی که با
این گزینه فعال ساخته شوند، در صورتی که به پایان یک تابع غیر-void بدون
بازگرداندن واقعی یک مقدار برسند، یک پیام خطا صادر خواهند کرد. این گزینه تنها
در ++C کار می‌کند.
.IP \fB\-fsanitize=signed\-integer\-overflow\fR 4
.IX Item "-fsanitize=signed-integer-overflow"
این گزینه بررسی سرریز اعداد صحیح علامت‌دار را فعال می‌کند. بررسی می‌شود که
نتیجه \f(CW\*(C`+\*(C'\fR، \f(CW\*(C`*\*(C'\fR و هر دو عملگر یگانی و دودویی \f(CW\*(C`\-\*(C'\fR
در محاسبات علامت‌دار دچار سرریز نشود. این گزینه همچنین تقسیم علامت‌دار
\&\f(CW\*(C`INT_MIN / \-1\*(C'\fR را تشخیص می‌دهد. توجه داشته باشید که قواعد
ارتقای اعداد صحیح را باید در نظر گرفت؛ یعنی مورد زیر یک سرریز محسوب
نمی‌شود:
.Sp
.Vb 2
\&        signed char a = SCHAR_MAX;
\&        a++;
.Ve
.IP \fB\-fsanitize=bounds\fR 4
.IX Item "-fsanitize=bounds"
این گزینه ابزارگذاری کران‌های آرایه را فعال می‌کند. دسترسی‌های خارج از محدوده
گوناگون شناسایی می‌شوند. اعضای آرایه انعطاف‌پذیر، آرایه‌های شبیه به عضو آرایه
انعطاف‌پذیر و مقداردهنده‌های اولیه‌ی متغیرها با حافظه ایستا ابزارگذاری نمی‌شوند؛
به استثنای آرایه‌های شبیه به عضو آرایه انعطاف‌پذیر که گزینه‌های
\f(CW\*(C`\-fstrict\-flex\-arrays\*(C'\fR یا \f(CW\*(C`\-fstrict\-flex\-arrays=\*(C'\fR
یا صفات \f(CW\*(C`strict_flex_array\*(C'\fR مشخص کنند که نباید با آن‌ها مانند
آرایه‌های شبیه به عضو آرایه انعطاف‌پذیر رفتار شود.
.IP \fB\-fsanitize=bounds\-strict\fR 4
.IX Item "-fsanitize=bounds-strict"
این گزینه ابزارگذاری سخت‌گیرانه کران‌های آرایه را فعال می‌کند. بیشتر دسترسی‌های
خارج از محدوده، از جمله آرایه‌های شبیه به عضو آرایه انعطاف‌پذیر، شناسایی می‌شوند.
مقداردهنده‌های اولیه‌ی متغیرها با حافظه ایستا ابزارگذاری نمی‌شوند.
.IP \fB\-fsanitize=alignment\fR 4
.IX Item "-fsanitize=alignment"
این گزینه بررسی ترازبندی اشاره‌گرها را هنگام ارجاع‌زدایی، یا هنگام مقید شدن یک
ارجاع به مقصدی با ترازبندی ناکافی، یا هنگام فراخوانی یک متد یا سازنده روی
شیئی با ترازبندی ناکافی فعال می‌کند.
.IP \fB\-fsanitize=object\-size\fR 4
.IX Item "-fsanitize=object-size"
این گزینه ابزارگذاری ارجاعات حافظه را با استفاده از تابع
\&\f(CW\*(C`_\|_builtin_dynamic_object_size\*(C'\fR فعال می‌کند. دسترسی‌های خارج از محدوده
گوناگون توسط اشاره‌گرها شناسایی می‌شوند.
.IP \fB\-fsanitize=float\-divide\-by\-zero\fR 4
.IX Item "-fsanitize=float-divide-by-zero"
تشخیص تقسیم ممیز شناور بر صفر. برخلاف سایر گزینه‌های مشابه،
\&\fB\-fsanitize=float\-divide\-by\-zero\fR توسط
\&\fB\-fsanitize=undefined\fR فعال نمی‌شود، چرا که تقسیم ممیز شناور بر صفر
می‌تواند روشی معتبر برای دستیابی به مقادیر بی‌نهایت و NaNها باشد.
.IP \fB\-fsanitize=float\-cast\-overflow\fR 4
.IX Item "-fsanitize=float-cast-overflow"
این گزینه بررسی تبدیل نوع ممیز شناور به عدد صحیح را فعال می‌کند.
بررسی می‌شود که نتیجه تبدیل دچار سرریز نشود.
برخلاف سایر گزینه‌های مشابه، \fB\-fsanitize=float\-cast\-overflow\fR
توسط \fB\-fsanitize=undefined\fR فعال نمی‌شود.
این گزینه با فعال بودن استثناهای \f(CW\*(C`FE_INVALID\*(C'\fR به خوبی کار نمی‌کند.
.IP \fB\-fsanitize=nonnull\-attribute\fR 4
.IX Item "-fsanitize=nonnull-attribute"
این گزینه ابزارگذاری فراخوانی‌ها را فعال کرده و بررسی می‌کند که مقادیر تهی به
آرگومان‌هایی که توسط صفت تابعی \&\f(CW\*(C`nonnull\*(C'\fR به عنوان نیازمند مقدار غیرتهی
مشخص شده‌اند، ارسال نشوند.
.IP \fB\-fsanitize=returns\-nonnull\-attribute\fR 4
.IX Item "-fsanitize=returns-nonnull-attribute"
این گزینه ابزارگذاری دستورات بازگشت را در توابعی که با صفت تابعی
\f(CW\*(C`returns_nonnull\*(C'\fR مشخص شده‌اند فعال می‌کند، تا بازگرداندن
مقادیر تهی از چنین توابعی را شناسایی کند.
.IP \fB\-fsanitize=bool\fR 4
.IX Item "-fsanitize=bool"
این گزینه ابزارگذاری بارگذاری‌ها از bool را فعال می‌کند. اگر مقداری غیر
از 0 یا 1 بارگذاری شود، یک خطای زمان اجرا صادر می‌شود..IP \fB\-fsanitize=enum\fR 4
.IX Item "-fsanitize=enum"
این گزینه ابزاردقیق (instrumentation) بارگذاری‌ها از یک نوع enum را فعال می‌کند. اگر
مقداری خارج از محدودهٔ مقادیر نوع enum بارگذاری شود،
یک خطای زمان اجرا صادر می‌شود.
.IP \fB\-fsanitize=vptr\fR 4
.IX Item "-fsanitize=vptr"
این گزینه ابزاردقیق فراخوانی توابع عضو C++، دسترسی‌های اعضا
و برخی تبدیل‌ها میان اشاره‌گرهای کلاس‌های پایه و مشتق‌شده را فعال می‌کند
تا اطمینان حاصل شود شیء ارجاع‌شده نوع پویای درستی دارد.
.IP \fB\-fsanitize=pointer\-overflow\fR 4
.IX Item "-fsanitize=pointer-overflow"
این گزینه ابزاردقیق محاسبات اشاره‌گر را فعال می‌کند. اگر محاسبات اشاره‌گر
دچار سرریز شود، یک خطای زمان اجرا صادر می‌شود.
.IP \fB\-fsanitize=builtin\fR 4
.IX Item "-fsanitize=builtin"
این گزینه ابزاردقیق آرگومان‌های توابع توکار (builtin) منتخب را فعال می‌کند. اگر
مقدار نامعتبری به چنین آرگومان‌هایی فرستاده شود، یک خطای زمان اجرا
صادر می‌شود؛ برای مثال، فرستادن 0 به‌عنوان آرگومان به \f(CW\*(C`_\|_builtin_ctz\*(C'\fR
یا \f(CW\*(C`_\|_builtin_clz\*(C'\fR رفتار تعریف‌نشده ایجاد می‌کند و
توسط این گزینه شناسایی می‌شود.
.RE
.RS 4
.Sp
توجه داشته باشید که بهسازها (sanitizers) تمایل دارند نرخ هشدارهای مثبت کاذب
را افزایش دهند، به‌ویژه هشدارهای پیرامون \fB\-Wmaybe\-uninitialized\fR.
ما ترکیب \fB\-Werror\fR و [استفاده از]
بهسازها را توصیه نمی‌کنیم.
.Sp
در حالی که \fB\-ftrapv\fR باعث ایجاد تله‌ها (traps) برای سرریزهای علامت‌دار می‌شود،
\&\fB\-fsanitize=undefined\fR یک پیام تشخیصی ارائه می‌دهد.
این ویژگی در حال حاضر تنها برای خانوادهٔ زبان‌های C کار می‌کند.
.RE
.IP \fB\-fno\-sanitize=all\fR 4
.IX Item "-fno-sanitize=all"
این گزینه تمام بهسازهای قبلاً فعال‌شده را غیرفعال می‌کند.
استفاده از \&\fB\-fsanitize=all\fR مجاز نیست، چرا که برخی بهسازها نمی‌توانند
هم‌زمان استفاده شوند.
.IP \fB\-fasan\-shadow\-offset=\fR\fInumber\fR 4
.IX Item "-fasan-shadow-offset=number"
این گزینه GCC را وادار می‌کند تا در بررسی‌های AddressSanitizer از آفست سایهٔ سفارشی استفاده کند.
این ویژگی برای آزمایش با چیدمان‌های حافظهٔ سایهٔ گوناگون در
Kernel AddressSanitizer مفید است.
.IP \fB\-fsanitize\-sections=\fR\fIs1\fR\fB,\fR\fIs2\fR\fB,...\fR 4
.IX Item "-fsanitize-sections=s1,s2,..."
بهسازی متغیرهای سراسری در بخش‌های کاربری (sections) منتخب. \fIsi\fR می‌تواند
شامل نویسه‌های عام (wildcards) باشد.
.IP \fB\-fsanitize\-recover\fR[\fB=\fR\fIopts\fR] 4
.IX Item "-fsanitize-recover[=opts]"
گزینهٔ \&\fB\-fsanitize\-recover=\fR حالت بازیابی از خطا را برای بهسازهای
ذکرشده در فهرست جداشده با کامای \fIopts\fR کنترل می‌کند. فعال‌سازی این گزینه
برای یک مؤلفهٔ بهساز باعث می‌شود که برنامه طوری به اجرای خود ادامه دهد
که گویی خطایی رخ نداده است. این بدان معناست که چندین
خطای زمان اجرا را می‌توان در یک بار اجرای برنامه گزارش کرد، و کد خروج
برنامه ممکن است حتی در صورت گزارش خطاها نشان‌دهندهٔ موفقیت
باشد. از گزینهٔ \fB\-fno\-sanitize\-recover=\fR می‌توان برای تغییر
این رفتار استفاده کرد: فقط نخستین خطای شناسایی‌شده گزارش می‌شود
و سپس برنامه با یک کد خروج غیرصفر پایان می‌یابد.
.Sp
در حال حاضر این ویژگی تنها برای \fB\-fsanitize=undefined\fR (و زیرگزینه‌های آن
به‌جز \fB\-fsanitize=unreachable\fR و \fB\-fsanitize=return\fR)،
\&\fB\-fsanitize=float\-cast\-overflow\fR، \fB\-fsanitize=float\-divide\-by\-zero\fR،
\&\fB\-fsanitize=bounds\-strict\fR،
\&\fB\-fsanitize=kernel\-address\fR و \fB\-fsanitize=address\fR کار می‌کند.
برای این بهسازها بازیابی از خطا به‌طور پیش‌فرض فعال است،
به‌جز \fB\-fsanitize=address\fR که این ویژگی برای آن آزمایشی است.
\&\fB\-fsanitize\-recover=all\fR و \fB\-fno\-sanitize\-recover=all\fR نیز
پذیرفته می‌شوند، اولی بازیابی را برای تمام بهسازهای پشتیبانی‌کننده فعال،
و دومی بازیابی را برای تمام بهسازهای پشتیبانی‌کننده غیرفعال می‌کند.
.Sp
حتی اگر حالت بازیابی در سمت کامپایلر فعال باشد، باید در
سمت کتابخانهٔ زمان اجرا نیز فعال شود، در غیر این صورت خرابی‌ها همچنان مهلک هستند.
پیش‌فرض کتابخانهٔ زمان اجرا برای ThreadSanitizer و UndefinedBehaviorSanitizer
برابر با \f(CW\*(C`halt_on_error=0\*(C'\fR است، در حالی که مقدار پیش‌فرض برای
AddressSanitizer برابر \f(CW\*(C`halt_on_error=1\*(C'\fR است. این مقدار را می‌توان با
تنظیم پرچم \f(CW\*(C`halt_on_error\*(C'\fR در متغیر محیطی مربوطه بازنویسی (override) کرد.
.Sp
نحو دستوری بدون پارامتر صریح \fIopts\fR منسوخ شده است. این معادل
مشخص کردن فهرست \fIopts\fR زیر است:
.Sp
.Vb 1
\&        undefined,float\-cast\-overflow,float\-divide\-by\-zero,bounds\-strict
.Ve
.IP \fB\-fsanitize\-address\-use\-after\-scope\fR 4
.IX Item "-fsanitize-address-use-after-scope"
بهسازی متغیرهای محلی را برای شناسایی باگ‌های استفاده پس از پایان حوزه (use\-after\-scope) فعال می‌کند.
این گزینه \fB\-fstack\-reuse\fR را روی \fBnone\fR قرار می‌دهد.
.IP \fB\-fsanitize\-trap\fR[\fB=\fR\fIopts\fR] 4
.IX Item "-fsanitize-trap[=opts]"
گزینهٔ \fB\-fsanitize\-trap=\fR به کامپایلر دستور می‌دهد تا برای
بهسازهای ذکرشده در فهرست جداشده با کامای \fIopts\fR،
رفتار تعریف‌نشده را به جای یک روتین کتابخانه‌ای \f(CW\*(C`libubsan\*(C'\fR، با استفاده از \f(CW\*(C`_\|_builtin_trap\*(C'\fR
گزارش کند. اگر این گزینه برای بهساز خاصی فعال شود،
نسبت به \fB\-fsanitizer\-recover=\fR برای آن بهساز اولویت دارد،
\&\f(CW\*(C`_\|_builtin_trap\*(C'\fR صادر خواهد شد و صرف نظر از اینکه بازیابی
با استفاده از \fB\-fsanitize\-recover=\fR فعال باشد یا غیرفعال، مهلک خواهد بود.
.Sp
مزیت این روش آن است که نیازی به کتابخانهٔ \f(CW\*(C`libubsan\*(C'\fR نیست
و پیوند (link) داده نمی‌شود، بنابراین حتی در محیط‌های مستقل (freestanding) نیز قابل استفاده است.
.Sp
در حال حاضر این ویژگی با \fB\-fsanitize=undefined\fR (و زیرگزینه‌های آن
به‌جز \fB\-fsanitize=vptr\fR)، \fB\-fsanitize=float\-cast\-overflow\fR،
\&\fB\-fsanitize=float\-divide\-by\-zero\fR و
\&\fB\-fsanitize=bounds\-strict\fR کار می‌کند. همچنین می‌توان \f(CW\*(C`\-fsanitize\-trap=all\*(C'\fR
را مشخص کرد که آن را برای زیرگزینه‌های \f(CW\*(C`undefined\*(C'\fR،
\&\fB\-fsanitize=float\-cast\-overflow\fR،
\&\fB\-fsanitize=float\-divide\-by\-zero\fR و
\&\fB\-fsanitize=bounds\-strict\fR فعال می‌کند.
اگر از \f(CW\*(C`\-fsanitize\-trap=undefined\*(C'\fR یا \f(CW\*(C`\-fsanitize\-trap=all\*(C'\fR استفاده شود
و \f(CW\*(C`\-fsanitize=vptr\*(C'\fR در خط فرمان فعال باشد،
ابزاردقیق در سکوت نادیده گرفته می‌شود چرا که همیشه به
پشتیبانی \&\f(CW\*(C`libubsan\*(C'\fR نیاز دارد؛ \fB\-fsanitize\-trap=vptr\fR مجاز نیست.
.IP \fB\-fsanitize\-undefined\-trap\-on\-error\fR 4
.IX Item "-fsanitize-undefined-trap-on-error"
گزینهٔ \fB\-fsanitize\-undefined\-trap\-on\-error\fR معادل منسوخ‌شدهٔ
\&\fB\-fsanitize\-trap=all\fR است.
.IP \fB\-fsanitize\-coverage=trace\-pc\fR 4
.IX Item "-fsanitize-coverage=trace-pc"
ابزاردقیق کد را برای آزمون فاز هدایت‌شده با پوشش (coverage\-guided fuzzing) فعال می‌کند.
یک فراخوانی به \f(CW\*(C`_\|_sanitizer_cov_trace_pc\*(C'\fR در هر بلوک پایه درج می‌کند.
.IP \fB\-fsanitize\-coverage=trace\-cmp\fR 4
.IX Item "-fsanitize-coverage=trace-cmp"
ابزاردقیق کد را برای آزمون فاز هدایت‌شده با جریان داده (dataflow guided fuzzing) فعال می‌کند.
یک فراخوانی به \f(CW\*(C`_\|_sanitizer_cov_trace_cmp1\*(C'\fR،
\&\f(CW\*(C`_\|_sanitizer_cov_trace_cmp2\*(C'\fR، \f(CW\*(C`_\|_sanitizer_cov_trace_cmp4\*(C'\fR یا
\&\f(CW\*(C`_\|_sanitizer_cov_trace_cmp8\*(C'\fR برای مقایسهٔ اعداد صحیح هنگامی که هر دو عملوند
متغیر هستند، یا \f(CW\*(C`_\|_sanitizer_cov_trace_const_cmp1\*(C'\fR،
\&\f(CW\*(C`_\|_sanitizer_cov_trace_const_cmp2\*(C'\fR،
\&\f(CW\*(C`_\|_sanitizer_cov_trace_const_cmp4\*(C'\fR یا
\&\f(CW\*(C`_\|_sanitizer_cov_trace_const_cmp8\*(C'\fR برای مقایسهٔ اعداد صحیح با یک
عملوند ثابت، \f(CW\*(C`_\|_sanitizer_cov_trace_cmpf\*(C'\fR یا
\&\f(CW\*(C`_\|_sanitizer_cov_trace_cmpd\*(C'\fR برای مقایسه‌های float یا double، و
\&\f(CW\*(C`_\|_sanitizer_cov_trace_switch\*(C'\fR برای دستورات switch درج می‌کند.
.IP \fB\-fcf\-protection=\fR[\fBfull\fR|\fBbranch\fR|\fBreturn\fR|\fBnone\fR|\fBcheck\fR] 4
.IX Item "-fcf-protection=[full|branch|return|none|check]"
.PD 0
.IP \fB\-fcf\-protection\fR 4
.IX Item "-fcf-protection"
.PD
ابزاردقیق کد را برای افزایش امنیت
برنامه از طریق بررسی معتبر بودن آدرس‌های مقصد دستورهای انتقال جریان
کنترل (مانند فراخوانی تابع غیرمستقیم، بازگشت تابع،
پرش غیرمستقیم) فعال می‌کند. این کار از انحراف جریان کنترل
به مقصدی غیرمنتظره جلوگیری می‌کند. این قابلیت با هدف محافظت در برابر تهدیداتی
همچون برنامه‌نویسی مبتنی بر بازگشت (ROP)، و به‌طور مشابه
برنامه‌نویسی مبتنی بر فراخوانی/پرش (COP/JOP) طراحی شده است.
.Sp
کلمات کلیدی \fB\-fcf\-protection=\fR به‌صورت زیر تفسیر می‌شوند:
.Sp
مقدار \f(CW\*(C`branch\*(C'\fR به کامپایلر دستور می‌دهد تا بررسی
اعتبار انتقال جریان کنترل را در نقطهٔ دستورهای شاخه‌بندی غیرمستقیم، یعنی دستورهای call/jmp پیاده‌سازی کند.
.Sp
مقدار \f(CW\*(C`return\*(C'\fR بررسی اعتبار را در نقطهٔ
بازگشت از یک تابع پیاده‌سازی می‌کند.
.Sp
مقدار \f(CW\*(C`full\*(C'\fR یک نام مستعار برای مشخص کردن هم‌زمان هر دو مقدار
\&\f(CW\*(C`branch\*(C'\fR و \f(CW\*(C`return\*(C'\fR است.
.Sp
مقدار \f(CW\*(C`check\*(C'\fR برای پیوند نهایی همراه با بهینه‌سازی
زمان پیوند (LTO) به کار می‌رود. اگر فایل‌های شیء LTO با مقادیر
متفاوت \fB\-fcf\-protection\fR کامپایل شده باشند، یک خطا صادر می‌شود. مقدار
\&\f(CW\*(C`check\*(C'\fR در زمان کامپایل نادیده گرفته می‌شود.
.Sp
مقدار \f(CW\*(C`none\*(C'\fR ابزاردقیق را غیرفعال می‌کند.
.Sp
گزینهٔ \&\fB\-fcf\-protection\fR نام مستعاری برای \fB\-fcf\-protection=full\fR است.
برای بازنویسی گزینهٔ قبلی \fB\-fcf\-protection\fR در خط
فرمان، ابتدا \fB\-fcf\-protection=none\fR و سپس
\&\fB\-fcf\-protection=\fR\fIkind\fR را اضافه کنید.
.Sp
ماکروی \f(CW\*(C`_\|_CET_\|_\*(C'\fR هنگامی که \fB\-fcf\-protection\fR استفاده
شود تعریف می‌شود. بیت نخست \f(CW\*(C`_\|_CET_\|_\*(C'\fR برای مقدار
\&\f(CW\*(C`branch\*(C'\fR روی 1 تنظیم می‌شود و بیت دوم \f(CW\*(C`_\|_CET_\|_\*(C'\fR برای
\&\f(CW\*(C`return\*(C'\fR روی 1 قرار می‌گیرد.
.Sp
همچنین می‌توانید از صفت \f(CW\*(C`nocf_check\*(C'\fR برای مشخص کردن
توابع و فراخوانی‌هایی که باید از ابزاردقیق مستثنی شوند استفاده کنید.
.Sp
در حال حاضر هدف x86 GNU/Linux پیاده‌سازی مبتنی
بر Intel Control\-flow Enforcement Technology (CET) را ارائه می‌دهد که برای
پردازنده‌های i686 یا جدیدتر قابل استفاده است..IP \fB\-fharden\-compares\fR 4
.IX Item "-fharden-compares"
به ازای هر آزمون منطقی که از بهینه‌سازی‌های gimple باقی می‌ماند و شرطی در یک انشعاب شرطی \fIنیست\fR (برای نمونه، شرایطی که برای جابه‌جایی‌های شرطی یا برای ذخیره در متغیرهای بولی بررسی می‌شوند)، کد اضافی برای محاسبه و تأیید شرط معکوس و فراخوانی \f(CW\*(C`_\|_builtin_trap\*(C'\fR در صورت عدم تطابق نتایج، تولید می‌کند. از این گزینه همراه با \fB\-fharden\-conditional\-branches\fR برای پوشش دادن تمام عبارات شرطی استفاده کنید.
.IP \fB\-fharden\-conditional\-branches\fR 4
.IX Item "-fharden-conditional-branches"
به ازای هر انشعاب شرطی غیربرداری که از بهینه‌سازی‌های gimple باقی می‌ماند، کد اضافی برای محاسبه و بررسی شرط معکوس و فراخوانی \f(CW\*(C`_\|_builtin_trap\*(C'\fR در صورت غیرمنتظره بودن نتیجه، تولید می‌کند. از این گزینه همراه با \fB\-fharden\-compares\fR برای پوشش دادن تمام عبارات شرطی استفاده کنید.
.IP \fB\-fharden\-control\-flow\-redundancy\fR 4
.IX Item "-fharden-control-flow-redundancy"
کد اضافی تولید می‌کند تا هنگام ورود به بلوک‌های پایه‌ای (basic blocks)، متغیرهای بولی تنظیم شوند و در هنگام خروج از تابع، چنانچه متغیرهای بولی مسیر اجرایی سازگاری با گراف جریان کنترل تشکیل ندهند، بررسی انجام شده و trap فراخوانی شود.
.Sp
اعتبارسنجی پیش از بازگشت‌ها، پیش از فراخوانی‌های دنباله‌ای اجباری (در ادامه ببینید) و به‌طور اختیاری، پیش از خروج استثناها با \&\fB\-fhardcfr\-check\-exceptions\fR، پیش از فراخوانی‌های بازگرداننده با \&\fB\-fhardcfr\-check\-returning\-calls\fR، و پیش از فراخوانی‌های noreturn با \&\fB\-fhardcfr\-check\-noreturn\-calls\fR انجام می‌شود).
.Sp
بهینه‌سازی فراخوانی دنباله‌ای (tail call) بسیار دیر انجام می‌شود و نمی‌تواند بر افزونگی جریان کنترل تأثیر بگذارد، اما برای فراخوانی‌هایی که توسط فرانت‌اند‌های زبان به‌عنوان فراخوانی‌های دنباله‌ای اجباری علامت‌گذاری شده‌اند، و هر فراخوانی که به اندازه کافی زود به‌عنوان فراخوانی دنباله‌ای بالقوه مشخص شده باشد، اعتبارسنجی پیش از فراخوانی صادر خواهد شد؛ هرچند این احتمالات صرفاً نظری هستند، چرا که این شرایط تنها هنگام استفاده از افزایه‌های سفارشی کامپایلر محقق می‌شوند.
.IP \fB\-fhardcfr\-skip\-leaf\fR 4
.IX Item "-fhardcfr-skip-leaf"
گزینه \fB\-fharden\-control\-flow\-redundancy\fR را در توابع برگ (leaf functions) غیرفعال می‌کند.
.IP \fB\-fhardcfr\-check\-exceptions\fR 4
.IX Item "-fhardcfr-check-exceptions"
هنگامی که \fB\-fharden\-control\-flow\-redundancy\fR فعال است، مسیر اجرای ثبت‌شده را در نقاط فرار استثنا در برابر گراف جریان کنترل بررسی می‌کند؛ درست مانند اینکه بدنه تابع در یک گرداننده پاکسازی (cleanup handler) پیچیده شده باشد که بررسی را انجام داده و استثنا را مجدداً پرتاب (reraise) می‌کند. این گزینه به‌طور پیش‌فرض فعال است؛ برای غیرفعال کردن آن از \fB\-fno\-hardcfr\-check\-exceptions\fR استفاده کنید.
.IP \fB\-fhardcfr\-check\-returning\-calls\fR 4
.IX Item "-fhardcfr-check-returning-calls"
هنگامی که \fB\-fharden\-control\-flow\-redundancy\fR فعال است، مسیر اجرای ثبت‌شده را در برابر گراف جریان کنترل پیش از هر فراخوانی تابعی که بلافاصله بازگشت نتیجه آن (در صورت وجود) را در پی دارد بررسی می‌کند، تا مانع بهینه‌سازی فراخوانی دنباله‌ای (tail\-call) نشود، صرف‌نظر از اینکه آیا در نهایت به فراخوانی دنباله‌ای بهینه‌سازی می‌شود یا خیر.
.Sp
این گزینه هر زمان که بهینه‌سازی‌های فراخوانی همزاد (sibling call optimizations) فعال باشند به‌طور پیش‌فرض فعال است (به \fB\-foptimize\-sibling\-calls\fR مراجعه کنید)، اما می‌توان آن را فارغ از بهینه‌سازی‌ها به‌طور صریح فعال (یا با استفاده از شکل نفی آن، غیرفعال) کرد.
.IP \fB\-fhardcfr\-check\-noreturn\-calls=\fR[\fBalways\fR|\fBno\-xthrow\fR|\fBnothrow\fR|\fBnever\fR] 4
.IX Item "-fhardcfr-check-noreturn-calls=[always|no-xthrow|nothrow|never]"
هنگامی که \fB\-fharden\-control\-flow\-redundancy\fR فعال است، مسیر اجرای ثبت‌شده را پیش از فراخوانی‌های \f(CW\*(C`noreturn\*(C'\fR در برابر گراف جریان کنترل بررسی می‌کند؛ خواه همه آن‌ها (\fBalways\fR)، آن‌هایی که انتظار نمی‌رود کنترل را از طریق یک استثنا به فراخواننده بازگردانند (\fBno\-xthrow\fR، پیش‌فرض)، آن‌هایی که همچنین ممکن نیست کنترل را از طریق یک استثنا به فراخواننده بازگردانند (\fBnothrow\fR)، یا هیچ‌کدام از آن‌ها (\fBnever\fR).
.Sp
بررسی پیش از یک تابع \f(CW\*(C`noreturn\*(C'\fR که ممکن است کنترل را از طریق یک استثنا به فراخواننده بازگرداند، در صورتی که استثنا در فراخواننده (خواه توسط یک گرداننده یا یک پاکسازی) گرفته شود، ممکن است باعث شود بررسی بیش از یک بار انجام گیرد. هنگامی که \fB\-fhardcfr\-check\-exceptions\fR نیز فعال باشد، کامپایلر از مرتبط کردن فراخوانی \f(CW\*(C`noreturn\*(C'\fR با گرداننده پاکسازیِ به‌طور ضمنی اضافه‌شده خودداری می‌کند، چرا که نسبت به بررسی انجام‌شده پیش از فراخوانی تکراری خواهد بود؛ اما سایر گرداننده‌ها یا پاکسازی‌ها در تابع، در صورت فعال شدن، مسیر اجرای ثبت‌شده را تغییر داده و با رسیدن به نقطه بازرسی (checkpoint) دیگر، آن را دوباره بررسی می‌کنند. این نقطه بازرسی حتی ممکن است یک فراخوانی \f(CW\*(C`noreturn\*(C'\fR دیگر باشد، بنابراین ممکن است بررسی در نهایت چندین بار انجام شود.
.Sp
بهینه‌سازهای گوناگون ممکن است باعث شوند فراخوانی‌ها حتی در صورت نبود ویژگی‌های متناظر، به‌عنوان \f(CW\*(C`noreturn\*(C'\fR و/یا \f(CW\*(C`nothrow\*(C'\fR علامت‌گذاری شوند که می‌تواند بر جای‌گذاری بررسی‌ها پیش از فراخوانی‌ها و همچنین افزودن گرداننده‌های پاکسازی ضمنی برای آن‌ها اثر بگذارد. این غیرقابل‌پیش‌بینی بودن، و این واقعیت که پرتاب کردن و پرتاب دوباره استثناها غالباً به منزله فراخوانی ضمنی توابع \f(CW\*(C`noreturn\*(C'\fR است، \fBno\-xthrow\fR را به تنظیم پیش‌فرض برای این گزینه تبدیل کرده است: این حالت از رفتار \f(CW\*(C`noreturn\*(C'\fR تنها توابع داخلی مورد استفاده برای پرتاب (دوباره) استثناها را که تحت تأثیر این بهینه‌سازی‌ها قرار نمی‌گیرند، مستثنی می‌کند.
.IP \fB\-fhardened\fR 4
.IX Item "-fhardened"
مجموعه‌ای از پرچم‌ها را برای C و C++ فعال می‌کند که امنیت کد تولیدشده را بدون تأثیر بر ABI آن بهبود می‌بخشند. پرچم‌های دقیق فعال‌شده ممکن است بین نگارش‌های اصلی GCC تغییر کنند، اما در حال حاضر عبارتند از:
.Sp
\&\fB\-D_FORTIFY_SOURCE=3
\&\-D_GLIBCXX_ASSERTIONS
\&\-ftrivial\-auto\-var\-init=zero
\&\-fPIE  \-pie  \-Wl,\-z,relro,\-z,now
\&\-fstack\-protector\-strong
\&\-fstack\-clash\-protection
\&\-fcf\-protection=full\fR (تنها در x86 GNU/Linux)\fB \fR
.Sp
فهرست گزینه‌های فعال‌شده توسط \fB\-fhardened\fR را می‌توان با استفاده از گزینه \fB\-\-help=hardened\fR به دست آورد.
.Sp
هنگامی که glibc سیستم قدیمی‌تر از 2.35 باشد، به‌جای آن از \fB\-D_FORTIFY_SOURCE=2\fR استفاده می‌شود.
.Sp
این گزینه برای استفاده در ساخت‌های نهایی (production) در نظر گرفته شده است، نه صرفاً در ساخت‌های اشکال‌زدایی.
.Sp
در حال حاضر، \fB\-fhardened\fR تنها بر روی مقصدهای GNU/Linux پشتیبانی می‌شود.
.Sp
\&\fB\-fhardened\fR تنها در صورتی یک گزینه خاص را فعال می‌کند که از پیش در هیچ جای خط فرمان مشخص نشده باشد. برای نمونه، \&\fB\-fhardened\fR \fB\-fstack\-protector\fR تنها \&\fB\-fstack\-protector\fR را فعال خواهد کرد، اما \&\fB\-fstack\-protector\-strong\fR را فعال نمی‌کند.
.IP \fB\-fstack\-protector\fR 4
.IX Item "-fstack-protector"
برای بررسی سرریز بافر (buffer overflow)، مانند حملات خرد کردن پشته (stack smashing)، کد اضافی تولید می‌کند. این کار با افزودن یک متغیر نگهبان به توابع دارای شیء‌های آسیب‌پذیر انجام می‌شود. این شامل توابعی است که \f(CW\*(C`alloca\*(C'\fR را فراخوانی می‌کنند، و توابعی با بافرهای بزرگ‌تر یا مساوی ۸ بایت. نگهبان‌ها هنگام ورود به تابع مقداردهی اولیه شده و هنگام خروج تابع بررسی می‌شوند. اگر بررسی نگهبان با شکست مواجه شود، یک پیام خطا چاپ شده و برنامه پایان می‌یابد. تنها متغیرهایی که واقعاً روی پشته تخصیص یافته باشند در نظر گرفته می‌شوند؛ متغیرهای حذف‌شده با بهینه‌سازی یا متغیرهای تخصیص‌یافته در ثبات‌ها به حساب نمی‌آیند.
.IP \fB\-fstack\-protector\-all\fR 4
.IX Item "-fstack-protector-all"
مانند \fB\-fstack\-protector\fR است با این تفاوت که تمام توابع محافظت می‌شوند.
.IP \fB\-fstack\-protector\-strong\fR 4
.IX Item "-fstack-protector-strong"
مانند \fB\-fstack\-protector\fR است اما توابع بیشتری را برای محافظت در بر می‌گیرد \-\-\- توابعی که تعاریف آرایه محلی دارند، یا ارجاعاتی به نشانی‌های قاب محلی (local frame) دارند. تنها متغیرهایی که واقعاً روی پشته تخصیص یافته باشند در نظر گرفته می‌شوند؛ متغیرهای حذف‌شده با بهینه‌سازی یا متغیرهای تخصیص‌یافته در ثبات‌ها به حساب نمی‌آیند.
.IP \fB\-fstack\-protector\-explicit\fR 4
.IX Item "-fstack-protector-explicit"
مانند \fB\-fstack\-protector\fR است اما تنها از توابعی محافظت می‌کند که ویژگی \f(CW\*(C`stack_protect\*(C'\fR را داشته باشند.
.IP \fB\-fstack\-check\fR 4
.IX Item "-fstack-check"
کدی تولید می‌کند تا اطمینان حاصل شود که از مرز پشته فراتر نمی‌روید. اگر در محیطی با چند رشته (چندریسمانی) اجرا می‌شوید، باید این پرچم را مشخص کنید، اما در یک محیط تک‌رشته‌ای به ندرت نیازی به مشخص کردن آن دارید، چرا که اگر تنها یک پشته وجود داشته باشد، سرریز پشته تقریباً در تمام سیستم‌ها به‌طور خودکار شناسایی می‌شود.
.Sp
توجه داشته باشید که این سوییچ در واقع باعث انجام بررسی نمی‌شود؛ سیستم‌عامل یا محیط زمان اجرای زبان باید این کار را انجام دهد. این سوییچ باعث تولید کدی می‌شود تا مطمئن شود آن‌ها گسترش پشته را می‌بینند.
.Sp
علاوه بر این می‌توانید یک پارامتر رشته‌ای مشخص کنید: \fBno\fR به معنای عدم بررسی است، \fBgeneric\fR به معنای اجبار به استفاده از بررسی به سبک قدیمی است، و \&\fBspecific\fR به معنای استفاده از بهترین روش بررسی بوده و معادل \fB\-fstack\-check\fR خالی است.
.Sp
بررسی به سبک قدیمی یک سازوکار عمومی است که به هیچ پشتیبانی ویژه مقصد در کامپایلر نیاز ندارد، اما دارای معایب زیر است:
.RS 4
.IP 1. 4
.IX Item "1."
راهبرد تخصیص تغییریافته برای شیء‌های بزرگ: اگر اندازه آن‌ها از یک آستانه ثابت فراتر رود، همواره به‌صورت پویا تخصیص می‌یابند. توجه داشته باشید که این ممکن است معناشناسی برخی کدها را تغییر دهد.
.IP 2. 4
.IX Item "2."
محدودیت ثابت در اندازه قاب ایستا (static frame) توابع: هنگامی که یک تابع خاص از آن فراتر می‌رود، بررسی پشته قابل اعتماد نیست و هشداری توسط کامپایلر صادر می‌شود.
.IP 3. 4
.IX Item "3."
ناکارآمدی: هم به دلیل راهبرد تخصیص تغییریافته و هم به دلیل پیاده‌سازی عمومی، کارایی کد دچار افت می‌شود.
.RE
.RS 4
.Sp
توجه داشته باشید که بررسی پشته به سبک قدیمی، روش جایگزین (fallback) برای \&\fBspecific\fR نیز هست، در صورتی که هیچ پشتیبانی از مقصد در کامپایلر افزوده نشده باشد.
.Sp
گزینه \&\fB\-fstack\-check=\fR برای نیازهای زبان Ada جهت تشخیص بازگشت بی‌نهایت و سرریزهای پشته طراحی شده است. \fBspecific\fR هنگام کامپایل کد Ada انتخابی عالی است. این گزینه عموماً برای محافظت در برابر حملات برخورد پشته (stack\-clash) کافی نیست. برای محافظت در برابر آن‌ها باید از \fB\-fstack\-clash\-protection\fR استفاده کنید.
.RE.IP \fB\-fstack\-clash\-protection\fR 4
.IX Item "-fstack-clash-protection"
تولید کد برای جلوگیری از حملات به سبک تداخل پشته (stack clash). هنگامی که این گزینه
فعال باشد، کامپایلر در هر زمان تنها یک صفحه از فضای پشته را تخصیص می‌دهد
و به هر صفحه بلافاصله پس از تخصیص دسترسی پیدا می‌شود. بدین ترتیب، این گزینه از جهش
تخصیص‌ها روی صفحات محافظ پشته ارائه‌شده توسط سیستم‌عامل جلوگیری می‌کند.
.Sp
بیشتر هدف‌ها به‌طور کامل از محافظت در برابر stack clash پشتیبانی نمی‌کنند. با این حال، در
آن هدف‌ها \fB\-fstack\-clash\-protection\fR از تخصیص‌های پویای پشته محافظت خواهد
کرد. همچنین اگر هدف از \&\fB\-fstack\-check=specific\fR پشتیبانی کند،
\fB\-fstack\-clash\-protection\fR ممکن است محافظت محدودی برای تخصیص‌های ایستای
پشته نیز ارائه دهد.
.IP \fB\-fstack\-limit\-register=\fR\fIreg\fR 4
.IX Item "-fstack-limit-register=reg"
.PD 0
.IP \fB\-fstack\-limit\-symbol=\fR\fIsym\fR 4
.IX Item "-fstack-limit-symbol=sym"
.IP \fB\-fno\-stack\-limit\fR 4
.IX Item "-fno-stack-limit"
.PD
تولید کد برای اطمینان از این‌که پشته فراتر از یک مقدار مشخص رشد نکند، که این مقدار
می‌تواند مقدار یک ثبات یا آدرس یک نماد باشد. در صورتی که به پشته بزرگ‌تری نیاز
باشد، یک سیگنال در زمان اجرا ارسال (raise) می‌شود. برای بیشتر هدف‌ها، این سیگنال
پیش از اینکه پشته از مرز فراتر رود ارسال می‌شود، بنابراین امکان دریافت (catch) سیگنال
بدون اتخاذ تدابیر ویژه وجود دارد.
.Sp
برای نمونه، اگر پشته از آدرس مطلق \fB0x80000000\fR شروع شده و رو به پایین رشد کند،
می‌توانید از پرچم‌های \&\fB\-fstack\-limit\-symbol=_\|_stack_limit\fR و
\&\fB\-Wl,\-\-defsym,_\|_stack_limit=0x7ffe0000\fR برای اعمال محدودیت پشته
۱۲۸ کیلوبایتی استفاده کنید. توجه داشته باشید که این ممکن است تنها با پیونددهنده GNU کار کند.
.Sp
می‌توانید بررسی محدودیت پشته را به‌صورت محلی با استفاده از مشخصه تابع
\&\f(CW\*(C`no_stack_limit\*(C'\fR لغو (override) کنید.
.IP \fB\-fsplit\-stack\fR 4
.IX Item "-fsplit-stack"
تولید کد برای تقسیم خودکار پشته پیش از سرریز شدن آن.
برنامه حاصل دارای یک پشته ناپیوسته است که تنها در صورتی ممکن است سرریز
شود که برنامه قادر به تخصیص حافظه بیشتر نباشد. این قابلیت هنگام اجرای
برنامه‌های چندنخی (threaded) بیشترین کاربرد را دارد، زیرا دیگر نیازی به
محاسبه اندازه مناسب پشته برای هر نخ نخواهد بود. این قابلیت در حال حاضر
تنها برای هدف‌های x86 که گنو/لینوکس را اجرا می‌کنند پیاده‌سازی شده است.
.Sp
هنگامی که کد کامپایل‌شده با \fB\-fsplit\-stack\fR کدی را فراخوانی می‌کند که
بدون \fB\-fsplit\-stack\fR کامپایل شده است، ممکن است فضای پشته چندانی برای اجرای
کد دوم در دسترس نباشد. اگر کامپایل کردن تمام کدها، از جمله کد کتابخانه‌ها، با
\fB\-fsplit\-stack\fR مقدور نباشد، پیونددهنده می‌تواند این فراخوانی‌ها را به‌گونه‌ای
اصلاح کند که کد کامپایل‌شده بدون \fB\-fsplit\-stack\fR همیشه پشته بزرگی در اختیار
داشته باشد. پشتیبانی از این قابلیت در پیونددهنده gold در نگارش 2.21 به بعد
GNU Binutils پیاده‌سازی شده است.
.IP \fB\-fstrub=disable\fR 4
.IX Item "-fstrub=disable"
غیرفعال کردن کامل پاک‌سازی پشته (stack scrubbing)، با نادیده گرفتن تمام مشخصه‌های \f(CW\*(C`strub\*(C'\fR.
.IP \fB\-fstrub=strict\fR 4
.IX Item "-fstrub=strict"
حالت پیش‌فرض توابع را به \f(CW\*(C`disabled\*(C'\fR برای \f(CW\*(C`strub\*(C'\fR تغییر می‌دهد، و این
محدودیت را به‌طور \fBسخت‌گیرانه\fR اعمال می‌کند که تنها توابع مرتبط با حالت‌های
\&\f(CW\*(C`strub\*(C'\fR\-\f(CW\*(C`callable\*(C'\fR (شامل \f(CW\*(C`at\-calls\*(C'\fR، \f(CW\*(C`callable\*(C'\fR و
\&\f(CW\*(C`always_inline\*(C'\fR \f(CW\*(C`internal\*(C'\fR) توسط توابعی با حالت‌های فعال‌شده برای
\&\f(CW\*(C`strub\*(C'\fR (شامل \f(CW\*(C`at\-calls\*(C'\fR و \f(CW\*(C`internal\*(C'\fR) قابل فراخوانی (\f(CW\*(C`callable\*(C'\fR) باشند.
.IP \fB\-fstrub=relaxed\fR 4
.IX Item "-fstrub=relaxed"
بازگرداندن تنظیمات پیش‌فرض پاک‌سازی پشته (\f(CW\*(C`strub\*(C'\fR)، بدین صورت که
\&\f(CW\*(C`strub\*(C'\fR تنها بنا بر نیاز مشخصه‌های \f(CW\*(C`strub\*(C'\fR مرتبط با انواع تابع و داده فعال
می‌شود. \f(CW\*(C`Relaxed\*(C'\fR بدین معناست که زمینه‌های strub تنها از فراخوانی توابعی بازداشته
می‌شوند که صراحتاً با حالت \f(CW\*(C`disabled\*(C'\fR برای \f(CW\*(C`strub\*(C'\fR مرتبط شده‌اند. این گزینه تنها
برای لغو سایر گزینه‌های \fB\-fstrub=*\fR که در خط فرمان پیش از آن آمده‌اند کاربرد دارد.
.IP \fB\-fstrub=at\-calls\fR 4
.IX Item "-fstrub=at-calls"
فعال کردن حالت \f(CW\*(C`at\-calls\*(C'\fR برای \f(CW\*(C`strub\*(C'\fR در صورت امکان‌پذیر بودن. کاربرد
اصلی این گزینه برای آزمایش است. این گزینه سازوکار \f(CW\*(C`strub\*(C'\fR را در سناریوهایی
که کاملاً محلی برای یک واحد ترجمه (translation unit) هستند به کار می‌گیرد. این حالت
\&\f(CW\*(C`strub\*(C'\fR واسط‌های تابع را تغییر می‌دهد، بنابراین هر تابعی که برای سایر واحدهای
ترجمه قابل مشاهده باشد، یا آدرس آن گرفته شده باشد، تحت تأثیر این گزینه قرار \fIنخواهد گرفت\fR.
گزینه‌های بهینه‌سازی نیز ممکن است بر امکان‌پذیری تأثیر بگذارند. برای جزئیات مربوط به
نیازمندی‌های امکان‌پذیری و واجد شرایط بودن، مستندات مشخصه \f(CW\*(C`strub\*(C'\fR را ببینید.
.IP \fB\-fstrub=internal\fR 4
.IX Item "-fstrub=internal"
فعال کردن حالت \f(CW\*(C`internal\*(C'\fR برای \f(CW\*(C`strub\*(C'\fR در صورت امکان‌پذیر بودن. کاربرد
اصلی این گزینه برای آزمایش است. این گزینه با هدف آزمودن دقیق بخش‌هایی از سازوکار
\&\f(CW\*(C`strub\*(C'\fR طراحی شده است که حالت کم‌بازده‌تر اما نگه‌دارنده واسط \f(CW\*(C`strub\*(C'\fR را
پیاده‌سازی می‌کنند. توابعی که تحت تأثیر این گزینه قرار نگیرند بسیار نادر هستند.
.IP \fB\-fstrub=all\fR 4
.IX Item "-fstrub=all"
فعال کردن یکی از حالت‌های \f(CW\*(C`strub\*(C'\fR در صورت امکان‌پذیر بودن. هنگامی که هر دو حالت
strub امکان‌پذیر باشند، \f(CW\*(C`at\-calls\*(C'\fR ترجیح داده می‌شود. گزینه \fB\-fdump\-ipa\-strubm\fR
مشخصه‌های تابعی را اضافه می‌کند که نشان می‌دهند کدام حالت برای هر تابع انتخاب شده است.
کاربرد اصلی این گزینه برای آزمایش و سنجش کامل سازوکار \f(CW\*(C`strub\*(C'\fR است.
.IP \fB\-fvtable\-verify=\fR[\fBstd\fR|\fBpreinit\fR|\fBnone\fR] 4
.IX Item "-fvtable-verify=[std|preinit|none]"
این گزینه تنها هنگام کامپایل کد ++C در دسترس است.
این گزینه قابلیت امنیتی‌ای را روشن (یا در صورت استفاده از \fB\-fvtable\-verify=none\fR خاموش)
می‌کند که در زمان اجرا، برای هر فراخوانی مجازی، تأیید می‌کند اشاره‌گر vtable که فراخوانی
از طریق آن انجام می‌شود برای نوع شیء معتبر بوده و دستکاری یا بازنویسی نشده باشد.
اگر اشاره‌گر vtable نامعتبری در زمان اجرا شناسایی شود، خطایی گزارش شده و اجرای
برنامه بلافاصله متوقف می‌شود.
.Sp
این گزینه باعث می‌شود که در زمان راه‌اندازی برنامه، ساختارهای داده زمان اجرا ساخته
شوند که برای اعتبارسنجی اشاره‌گرهای vtable استفاده می‌شوند.
گزینه‌های \fBstd\fR و \fBpreinit\fR زمان ساخته شدن این ساختارهای داده را کنترل می‌کنند.
در هر دو حالت، این ساختارهای داده قبل از رسیدن اجرا به \f(CW\*(C`main\*(C'\fR ساخته می‌شوند. استفاده
از \&\fB\-fvtable\-verify=std\fR باعث می‌شود ساختارهای داده پس از بارگذاری و مقداردهی
اولیه کتابخانه‌های اشتراکی ساخته شوند.
\&\fB\-fvtable\-verify=preinit\fR باعث می‌شود آن‌ها پیش از بارگذاری و مقداردهی
اولیه کتابخانه‌های اشتراکی ساخته شوند.
.Sp
اگر این گزینه چندین بار با مقادیر مختلف در خط فرمان مشخص شود، \fBnone\fR بیشترین اولویت
را نسبت به هر دو مقدار \fBstd\fR و \&\fBpreinit\fR دارد؛ \fBpreinit\fR نیز بر \fBstd\fR اولویت دارد.
.IP \fB\-fvtv\-debug\fR 4
.IX Item "-fvtv-debug"
هنگامی که همراه با \fB\-fvtable\-verify=std\fR یا \&\fB\-fvtable\-verify=preinit\fR
استفاده شود، باعث فراخوانی نسخه‌های اشکال‌زدایی از توابع زمان اجرا برای قابلیت اعتبارسنجی
vtable می‌شود. این پرچم همچنین باعث می‌شود کامپایلر اطلاعات مربوط به اشاره‌گرهای
vtableای را که برای هر کلاس پیدا می‌کند ثبت کند.
این اطلاعات در فایلی به نام \fIvtv_set_ptr_data.log\fR در دایرکتوری تعیین‌شده توسط
متغیر محیطی \fBVTV_LOGS_DIR\fR در صورت تعریف بودن، یا در غیر این صورت در دایرکتوری کاری
جاری نوشته می‌شود.
.Sp
نکته: این ویژگی داده‌ها را به فایل لاگ \fIالحاق می‌کند\fR (append). اگر فایلی تازه
می‌خواهید، حتماً هر فایل موجود را از پیش حذف کنید.
.IP \fB\-fvtv\-counts\fR 4
.IX Item "-fvtv-counts"
این یک پرچم اشکال‌زدایی است. هنگامی که همراه با \&\fB\-fvtable\-verify=std\fR یا
\&\fB\-fvtable\-verify=preinit\fR استفاده شود، باعث می‌شود کامپایلر تعداد کل فراخوانی‌های
مجازی را که با آن‌ها مواجه می‌شود و تعداد اعتبارسنجی‌هایی را که درج می‌کند، پیگیری نماید.
همچنین تعداد فراخوانی‌های توابع خاصی از کتابخانه زمان اجرا را که درج می‌کند شمارش کرده
و این اطلاعات را برای هر واحد کامپایل ثبت می‌کند.
کامپایلر این اطلاعات را در فایلی به نام \&\fIvtv_count_data.log\fR در دایرکتوری
تعیین‌شده توسط متغیر محیطی \fBVTV_LOGS_DIR\fR در صورت تعریف بودن، یا در غیر این صورت
در دایرکتوری کاری جاری می‌نویسد. همچنین اندازه مجموعه‌های اشاره‌گر vtable را برای هر کلاس
شمارش کرده و این اطلاعات را در \fIvtv_class_set_sizes.log\fR در همان دایرکتوری می‌نویسد.
.Sp
نکته: این ویژگی داده‌ها را به فایل‌های لاگ \fIالحاق می‌کند\fR. برای داشتن فایل‌های لاگ تازه،
حتماً هر فایل موجود را از پیش حذف کنید.
.IP \fB\-finstrument\-functions\fR 4
.IX Item "-finstrument-functions"
تولید فراخوانی‌های سنجش کد (instrumentation) برای ورود به توابع و خروج از آن‌ها. دقیقاً
پس از ورود به تابع و دقیقاً پیش از خروج از تابع، توابع پروفایل‌سازی زیر با آدرس تابع جاری
و محل فراخوانی آن فراخوانده می‌شوند. (در برخی پلتفرم‌ها،
\&\f(CW\*(C`_\|_builtin_return_address\*(C'\fR فراتر از تابع جاری کار نمی‌کند، بنابراین ممکن است
اطلاعات محل فراخوانی در غیر این صورت برای توابع پروفایل‌سازی در دسترس نباشد.)
.Sp
.Vb 4
\&        void _\|_cyg_profile_func_enter (void *this_fn,
\&                                       void *call_site);
\&        void _\|_cyg_profile_func_exit  (void *this_fn,
\&                                       void *call_site);
.Ve
.Sp
آرگومان نخست، آدرس آغازین تابع جاری است که می‌توان آن را دقیقاً در جدول نمادها جستجو کرد.
.Sp
این سنجش کد همچنین برای توابعی که به‌صورت درون‌خطی (inline) در سایر توابع بسط یافته‌اند
نیز انجام می‌پذیرد. فراخوانی‌های پروفایل‌سازی نشان می‌دهند که تابع درون‌خطی به‌طور مفهومی
در کجا وارد و خارج شده است. این بدان معناست که نسخه‌های آدرس‌پذیر از چنین توابعی باید موجود
باشند. اگر تمام استفاده‌های شما از یک تابع به‌صورت درون‌خطی بسط داده شده باشند، این امر
ممکن است باعث افزایش بیشتر اندازه کد شود. اگر در کد C خود از \f(CW\*(C`extern inline\*(C'\fR
استفاده می‌کنید، باید نسخه‌ای آدرس‌پذیر از چنین توابعی ارائه شود. (معمولاً در هر حال این‌گونه
است، اما اگر خوش‌شانس باشید و بهینه‌ساز همواره توابع را درون‌خطی بسط دهد، ممکن بود بتوانید
بدون ارائه نسخه‌های ایستا کار را پیش ببرید.)
.Sp
می‌توان به یک تابع مشخصه \f(CW\*(C`no_instrument_function\*(C'\fR را داد، که در این حالت این
سنجش کد برای آن انجام نمی‌شود. این قابلیت می‌تواند برای نمونه، برای توابع پروفایل‌سازی
فهرست‌شده در بالا، روتین‌های وقفه با اولویت بالا، و هر تابعی که توابع پروفایل‌سازی نمی‌توانند
به‌طور ایمن از آن فراخوانی شوند (احتمالاً گرداننده‌های سیگنال، در صورتی که روتین‌های
پروفایل‌سازی خروجی تولید کنند یا حافظه تخصیص دهند) استفاده شود..IP \fB\-finstrument\-functions\-once\fR 4
.IX Item "-finstrument-functions-once"
این گزینه مشابه \fB\-finstrument\-functions\fR است، با این تفاوت که توابع پروفایل‌سازی (profiling) برای هر تابع ابزاردقیق‌شده تنها یک‌بار فراخوانی می‌شوند؛ بدین معنا که نخستین تابع پروفایل‌سازی پس از اولین ورود به تابع ابزاردقیق‌شده فراخوانی می‌شود و دومین تابع پروفایل‌سازی پیش از خروج متناظر با این ورودِ اول صدا زده می‌شود.
.Sp
تعریف \f(CW\*(C`once\*(C'\fR (یک‌بار) برای اهداف این گزینه تا حدی مبهم است، زیرا پیاده‌سازی آن در برابر تداخل داده‌ها (data races) محافظت نشده است. در نتیجه، این پیاده‌سازی تنها تضمین می‌کند که توابع پروفایل‌سازی \fIحداقل\fR یک‌بار به‌ازای هر فرایند و \fIحداکثر\fR یک‌بار به‌ازای هر رشته (thread) فراخوانی شوند، اما فراخوانی‌ها همواره جفت‌شده هستند؛ یعنی اگر یک رشته تابع اول را فراخوانی کند، تابع دوم را نیز فراخوانی خواهد کرد، مگر آنکه هرگز به نقطهٔ خروج از تابع ابزاردقیق‌شده نرسد.
.IP \fB\-finstrument\-functions\-exclude\-file\-list=\fR\fIfile\fR\fB,\fR\fIfile\fR\fB,...\fR 4
.IX Item "-finstrument-functions-exclude-file-list=file,file,..."
فهرست توابعی را تعیین می‌کند که از ابزاردقیق‌سازی (instrumentation) مستثنی می‌شوند (توضیحات مربوط به \fB\-finstrument\-functions\fR را ببینید). اگر فایلی که شامل تعریف یک تابع است با یکی از مقادیر \fIfile\fR تطابق داشته باشد، آن تابع ابزاردقیق نمی‌شود. این تطبیق بر روی زیررشته‌ها صورت می‌گیرد: چنانچه پارامتر \fIfile\fR زیررشته‌ای از نام فایل باشد، منطبق در نظر گرفته می‌شود.
.Sp
برای نمونه:
.Sp
.Vb 1
\&        \-finstrument\-functions\-exclude\-file\-list=/bits/stl,include/sys
.Ve
.Sp
هر تابع درون‌خطی (inline) تعریف‌شده در فایل‌هایی را که مسیر آن‌ها شامل \fI/bits/stl\fR یا \fIinclude/sys\fR باشد، مستثنی می‌کند.
.Sp
اگر به هر دلیلی می‌خواهید نویسهٔ \fB,\fR را در یکی از \&\fIsym\fR بگنجانید، \fB,\fR را بنویسید. برای نمونه،
\&\fB\-finstrument\-functions\-exclude\-file\-list=\*(Aq,,tmp\*(Aq\fR
(به علامت نقل‌قول تکی در اطراف گزینه دقت کنید).
.IP \fB\-finstrument\-functions\-exclude\-function\-list=\fR\fIsym\fR\fB,\fR\fIsym\fR\fB,...\fR 4
.IX Item "-finstrument-functions-exclude-function-list=sym,sym,..."
این گزینه مشابه \fB\-finstrument\-functions\-exclude\-file\-list\fR است، با این تفاوت که فهرست نام توابعی را تعیین می‌کند که باید از ابزاردقیق‌سازی مستثنی شوند. نام تابعی که باید مطابقت داده شود، نامِ قابل‌مشاهده برای کاربر است؛ مانند \f(CW\*(C`vector<int> blah(const vector<int> &)\*(C'\fR، نه نام درهم‌ریختهٔ درونی (mangled name) آن (مانند \f(CW\*(C`_Z4blahRSt6vectorIiSaIiEE\*(C'\fR). تطبیق بر روی زیررشته‌ها انجام می‌شود: اگر پارامتر \fIsym\fR زیررشته‌ای از نام تابع باشد، تطابق در نظر گرفته می‌شود. برای شناسه‌های گسترش‌یافتهٔ C99 و ++C، نام تابع باید در قالب UTF\-8 ارائه شود، نه با استفاده از نام‌های نویسهٔ همگانی (universal character names).
.IP \fB\-fpatchable\-function\-entry=\fR\fIN\fR\fB[,\fR\fIM\fR\fB]\fR 4
.IX Item "-fpatchable-function-entry=N[,M]"
تولید \fIN\fR دستور NOP درست در ابتدای هر تابع، به‌طوری که نقطهٔ ورود تابع پیش از \fIM\fRاُمین NOP قرار گیرد. اگر \fIM\fR حذف شود، مقدار پیش‌فرض آن \f(CW0\fR خواهد بود تا نقطهٔ ورود تابع دقیقاً به نشانی نخستین NOP اشاره کند. دستورهای NOP فضای اضافی رزرو می‌کنند که در صورت قابل‌نوشتن بودن بخش کد (code segment)، می‌توان از آن برای اعمال هرگونه ابزاردقیق دلخواه (وصله‌کردن / patch) در زمان اجرا استفاده کرد. مقدار فضا به‌صورت غیرمستقیم از طریق تعداد NOPها قابل کنترل است؛ دستور NOP استفاده‌شده متناظر با دستوری است که توسط رابط داخلی پشتیبان (back\-end) کامپایلر GCC یعنی \f(CW\*(C`gen_nop\*(C'\fR صادر می‌شود. این رفتار وابسته به معماری مقصد (target\-specific) است و ممکن است به گونهٔ معماری و/یا سایر گزینه‌های کامپایل نیز وابسته باشد.
.Sp
برای شناسایی در زمان اجرا، نشانی‌های آغازین این نواحی—که متناظر با نقطهٔ ورود توابع مربوطه منهای \fIM\fR است—علاوه بر این در بخش \f(CW\*(C`_\|_patchable_function_entries\*(C'\fR از باینری حاصل گردآوری می‌شوند.
.Sp
توجه داشته باشید که مقدار \f(CW\*(C`_\|_attribute_\|_ ((patchable_function_entry (N,M)))\*(C'\fR نسبت به گزینهٔ خط فرمان \&\fB\-fpatchable\-function\-entry=N,M\fR اولویت دارد. از این ویژگی می‌توان برای افزایش اندازهٔ ناحیه یا حذف کامل آن در یک تابع منفرد استفاده کرد. اگر \f(CW\*(C`N=0\*(C'\fR باشد، هیچ مکانی برای لایه‌گذاری (pad location) ثبت نمی‌شود.
.Sp
دستورهای NOP در نشانی ورود تابع—و بسته به \&\fIM\fR، شاید پیش از آن—حتی پیش از پیش‌درآمد (prologue) درج می‌شوند. در PowerPC با ELFv2 ABI، برای تابعی با نقاط ورود دوگانه (dual entry points)، نقطهٔ ورود محلی به‌طور پیش‌فرض همان نشانی ورود تابع است. برای تغییر این مورد به گزینهٔ \fB\-msplit\-patch\-nops\fR مراجعه کنید.
.Sp
حداکثر مقدار \fIN\fR و \fIM\fR برابر با 65535 است. در PowerPC با ELFv2 ABI، برای تابعی با نقاط ورود دوگانه، مقادیر پشتیبانی‌شده برای \fIM\fR در صورت عدم استفاده از \fB\-msplit\-patch\-nops\fR برابر با 0، 2، 6 و 14 هستند..SS "گزینه‌های کنترل‌کنندهٔ پیش‌پردازنده (Options Controlling the Preprocessor)"
.IX Subsection "Options Controlling the Preprocessor"
این گزینه‌ها پیش‌پردازندهٔ C را کنترل می‌کنند، که پیش از کامپایل واقعی روی هر فایل مبدأ C اجرا می‌شود.
.PP
اگر از گزینهٔ \fB\-E\fR استفاده کنید، هیچ کاری به‌جز پیش‌پردازش انجام نمی‌شود. برخی از این گزینه‌ها تنها در کنار \fB\-E\fR معنا دارند، چرا که خروجی پیش‌پردازنده را برای کامپایل واقعی نامناسب می‌کنند.
.PP
افزون بر گزینه‌های فهرست‌شده در اینجا، گزینه‌های متعددی برای کنترل مسیرهای جستجوی فایل‌های include وجود دارند که در \&\fBDirectory Options\fR مستند شده‌اند. گزینه‌های کنترل خطایابی و گزارش‌های پیش‌پردازنده در \&\fBWarning Options\fR فهرست شده‌اند.
.IP "\fB\-D\fR \fIname\fR" 4
.IX Item "-D name"
.PD 0
.IP \fB\-\-define\-macro=\fR\fIname\fR 4
.IX Item "--define-macro=name"
.IP "\fB\-\-define\-macro\fR \fIname\fR" 4
.IX Item "--define-macro name"
.PD
\fIname\fR را به‌عنوان یک ماکرو با مقدار تعریف \f(CW1\fR از پیش تعریف می‌کند.
.IP "\fB\-D\fR \fIname\fR\fB=\fR\fIdefinition\fR" 4
.IX Item "-D name=definition"
.PD 0
.IP \fB\-\-define\-macro=\fR\fIname\fR\fB=\fR\fIdefinition\fR 4
.IX Item "--define-macro=name=definition"
.IP "\fB\-\-define\-macro\fR \fIname\fR\fB=\fR\fIdefinition\fR" 4
.IX Item "--define-macro name=definition"
.PD
محتوای \fIdefinition\fR نشانه‌گذاری (tokenized) شده و طوری پردازش می‌شود که گویی در مرحلهٔ سوم ترجمه درون یک دایرکتیو \fB#define\fR ظاهر شده است. به‌ویژه، تعریف با نویسه‌های خط‌جدیدِ درون‌متنی بریده می‌شود.
.Sp
اگر پیش‌پردازنده را از یک شل یا برنامه‌ای شبیه به شل اجرا می‌کنید، ممکن است لازم باشد از نحو نقل‌قول (quoting) شل برای محافظت از نویسه‌هایی مانند فاصله‌ها که در نحو شل معنای خاصی دارند، استفاده کنید.
.Sp
اگر مایلید یک ماکروی شبیه به تابع (function-like) را در خط فرمان تعریف کنید، فهرست آرگومان‌های آن را در پرانتز قبل از علامت مساوی (در صورت وجود) بنویسید. پرانتزها برای اغلب شل‌ها معنادار هستند، بنابراین باید این گزینه را نقل‌قول کنید. در \fBsh\fR و \fBcsh\fR، ساختار \&\fB\-D\*(Aq\fR\fIname\fR\fB(\fR\fIargs...\fR\fB)=\fR\fIdefinition\fR\fB\*(Aq\fR کار می‌کند.
.Sp
گزینه‌های \&\fB\-D\fR و \fB\-U\fR به ترتیبی که در خط فرمان داده شده‌اند پردازش می‌شوند. تمام گزینه‌های \fB\-imacros\fR \fIfile\fR و \&\fB\-include\fR \fIfile\fR پس از همهٔ گزینه‌های \&\fB\-D\fR و \fB\-U\fR پردازش می‌شوند.
.IP "\fB\-U\fR \fIname\fR" 4
.IX Item "-U name"
.PD 0
.IP \fB\-\-undefine\-macro=\fR\fIname\fR 4
.IX Item "--undefine-macro=name"
.IP "\fB\-\-undefine\-macro\fR \fIname\fR" 4
.IX Item "--undefine-macro name"
.PD
هرگونه تعریف قبلی \fIname\fR را، چه توکار باشد چه با گزینهٔ \fB\-D\fR ارائه شده باشد، لغو می‌کند.
.IP "\fB\-include\fR \fIfile\fR" 4
.IX Item "-include file"
.PD 0
.IP \fB\-\-include=\fR\fIfile\fR 4
.IX Item "--include=file"
.IP "\fB\-\-include\fR \fIfile\fR" 4
.IX Item "--include file"
.PD
فایل \fIfile\fR را به‌گونه‌ای پردازش می‌کند که گویی \f(CW\*(C`#include "file"\*(C'\fR در خط اول فایل مبدأ اصلی ظاهر شده است. با این حال، نخستین دایرکتوری مورد جستجو برای \fIfile\fR دایرکتوری کاری پیش‌پردازنده است \fIبه‌جای\fR دایرکتوری شامل فایل مبدأ اصلی. اگر در آنجا یافت نشد، مانند حالت عادی در بقیهٔ زنجیرهٔ جستجوی \f(CW\*(C`#include "..."\*(C'\fR جستجو می‌شود.
.Sp
اگر چندین گزینهٔ \fB\-include\fR داده شود، فایل‌ها به ترتیبی که در خط فرمان ظاهر شده‌اند گنجانده خواهند شد.
.IP "\fB\-imacros\fR \fIfile\fR" 4
.IX Item "-imacros file"
.PD 0
.IP \fB\-\-imacros=\fR\fIfile\fR 4
.IX Item "--imacros=file"
.IP "\fB\-\-imacros\fR \fIfile\fR" 4
.IX Item "--imacros file"
.PD
دقیقاً مانند \fB\-include\fR عمل می‌کند، با این تفاوت که هرگونه خروجی حاصل از پیمایش \fIfile\fR دور ریخته می‌شود. ماکروهایی که تعریف می‌کند تعریف‌شده باقی می‌مانند. این امر به شما امکان می‌دهد تمام ماکروها را از یک هدر دریافت کنید بدون اینکه اعلان‌های آن پردازش شوند.
.Sp
تمام فایل‌های مشخص‌شده با \fB\-imacros\fR قبل از تمام فایل‌های مشخص‌شده با \fB\-include\fR پردازش می‌شوند.
.IP \fB\-undef\fR 4
.IX Item "-undef"
هیچ‌یک از ماکروهای وابسته به سیستم یا مخصوص GCC را از پیش تعریف نمی‌کند. ماکروهای استانداردِ از پیش تعریف‌شده، تعریف‌شده باقی می‌مانند.
.IP \fB\-pthread\fR 4
.IX Item "-pthread"
ماکروهای اضافی مورد نیاز برای استفاده از کتابخانهٔ POSIX threads را تعریف می‌کند. شما باید از این گزینه به‌طور یکنواخت هم برای کامپایل و هم برای پیونددهی (linking) استفاده کنید. این گزینه روی مقصدهای GNU/Linux، اکثر مشتقات دیگر Unix و همچنین مقصدهای x86 Cygwin و MinGW پشتیبانی می‌شود.
.IP \fB\-M\fR 4
.IX Item "-M"
.PD 0
.IP \fB\-\-dependencies\fR 4
.IX Item "--dependencies"
.PD
به‌جای خروجی دادن نتیجهٔ پیش‌پردازش، قاعده‌ای مناسب برای \fBmake\fR خروجی می‌دهد که وابستگی‌های فایل مبدأ اصلی را شرح می‌دهد. پیش‌پردازنده یک قاعدهٔ \fBmake\fR شامل نام فایل شیء (object file) مربوط به آن فایل مبدأ، یک دونقطه، و نام تمام فایل‌های گنجانده‌شده (از جمله فایل‌هایی که از گزینه‌های خط فرمان \fB\-include\fR یا \&\fB\-imacros\fR آمده‌اند) را خروجی می‌دهد.
.Sp
مگر در صورت مشخص شدن صریح (با \fB\-MT\fR یا \fB\-MQ\fR)، نام فایل شیء شامل نام فایل مبدأ است که پسوند آن با پسوند فایل شیء جایگزین شده و تمام بخش‌های دایرکتوری ابتدای آن حذف گردیده است. اگر فایل‌های گنجانده‌شده زیاد باشند، این قاعده با استفاده از \fB\e\fR\-newline به چند خط شکسته می‌شود. این قاعده هیچ دستوری ندارد.
.Sp
این گزینه خروجی اشکال‌زدایی پیش‌پردازنده مانند \&\fB\-dM\fR را متوقف نمی‌کند. برای جلوگیری از تداخل چنین خروجی‌های اشکال‌زدایی با قواعد وابستگی، باید صراحتاً فایل خروجی وابستگی را با \&\fB\-MF\fR مشخص کنید، یا از یک متغیر محیطی مانند \&\fBDEPENDENCIES_OUTPUT\fR استفاده نمایید. خروجی اشکال‌زدایی همچنان طبق روال عادی به جریان خروجی استاندارد فرستاده می‌شود.
.Sp
ارائهٔ \fB\-M\fR به راه‌انداز (driver) مستلزم \fB\-E\fR بوده و هشدارها را با یک \fB\-w\fR ضمنی غیرفعال می‌کند.
.IP \fB\-MM\fR 4
.IX Item "-MM"
.PD 0
.IP \fB\-\-user\-dependencies\fR 4
.IX Item "--user-dependencies"
.PD
مانند \fB\-M\fR عمل می‌کند اما فایل‌های هدر موجود در دایرکتوری‌های هدر سیستم و نیز فایل‌های هدری را که به‌طور مستقیم یا غیرمستقیم از چنین هدری گنجانده شده‌اند، ذکر نمی‌کند.
.Sp
این بدان معناست که انتخاب براکت‌های زاویه‌دار یا علامت نقل‌قول دوتایی در یک دایرکتیو \&\fB#include\fR به‌خودی‌خود تعیین نمی‌کند که آیا آن هدر در خروجی وابستگی \fB\-MM\fR ظاهر شود یا خیر.
.IP "\fB\-MF\fR \fIfile\fR" 4
.IX Item "-MF file"
هنگامی که همراه با \fB\-M\fR یا \fB\-MM\fR استفاده شود، فایلی را برای نوشتن وابستگی‌ها مشخص می‌کند. اگر هیچ سوئیچ \fB\-MF\fR داده نشود، پیش‌پردازنده قواعد را به همان جایی ارسال می‌کند که خروجی پیش‌پردازش‌شده را ارسال می‌کرد.
.Sp
هنگامی که با گزینه‌های درایور \fB\-MD\fR یا \fB\-MMD\fR استفاده شود، \&\fB\-MF\fR فایل پیش‌فرض خروجی وابستگی را بازنویسی می‌کند.
.Sp
اگر \fIfile\fR برابر با \fI\-\fR باشد، وابستگی‌ها در \fIstdout\fR نوشته می‌شوند.
.IP \fB\-MG\fR 4
.IX Item "-MG"
.PD 0
.IP \fB\-\-print\-missing\-file\-dependencies\fR 4
.IX Item "--print-missing-file-dependencies"
.PD
همراه با گزینه‌ای مانند \fB\-M\fR که درخواست ایجاد وابستگی می‌کند، \fB\-MG\fR فرض می‌کند فایل‌های هدر ناموجود، فایل‌های تولیدشده (generated) هستند و بدون ایجاد خطا آن‌ها را به فهرست وابستگی‌ها اضافه می‌کند. نام فایل وابستگی مستقیماً از دایرکتیو \&\f(CW\*(C`#include\*(C'\fR بدون پیشوند کردن هیچ مسیری گرفته می‌شود. \fB\-MG\fR همچنین خروجی پیش‌پردازش‌شده را سرکوب می‌کند، زیرا نبود یک فایل هدر آن را بی‌فایده می‌سازد.
.Sp
این قابلیت در به‌روزرسانی خودکار makefileها استفاده می‌شود.
.IP \fB\-Mno\-modules\fR 4
.IX Item "-Mno-modules"
تولید وابستگی را برای رابط‌های ماژول کامپایل‌شده غیرفعال می‌کند.
.IP \fB\-MP\fR 4
.IX Item "-MP"
این گزینه به CPP دستور می‌دهد که یک هدف ساختگی (phony target) برای هر وابستگی به‌جز فایل اصلی اضافه کند، که باعث می‌شود هر یک به هیچ‌چیز وابسته نباشد. این قواعد ساختگی خطاهایی را دور می‌زنند که \fBmake\fR در صورت حذف فایل‌های هدر بدون به‌روزرسانی متناظر در \fIMakefile\fR صادر می‌کند.
.Sp
این یک خروجی نمونه است:
.Sp.Vb 1
\&        test.o: test.c test.h
\&        
\&        test.h:
.Ve
.IP "\fB\-MT\fR \fItarget\fR" 4
.IX Item "-MT target"
هدف (target) قاعده‌ای را که با تولید وابستگی صادر می‌شود تغییر می‌دهد. به‌طور
پیش‌فرض CPP نام فایل ورودی اصلی را می‌گیرد، هرگونه بخش‌های دایرکتوری و هر پسوند فایلی مانند \fB.c\fR را حذف می‌کند، و
پسوند معمول فایل‌های شیء پلتفرم را اضافه می‌کند. نتیجه، همان هدف خواهد بود.
.Sp
گزینهٔ \fB\-MT\fR هدف را دقیقاً روی همان رشته‌ای که مشخص می‌کنید
تنظیم می‌کند. اگر چندین هدف می‌خواهید، می‌توانید آن‌ها را به‌عنوان یک تک‌آرگومان
به \fB\-MT\fR بدهید، یا از چندین گزینهٔ \fB\-MT\fR استفاده کنید.
.Sp
برای مثال، \fB\-MT\ \*(Aq$(objpfx)foo.o\*(Aq\fR ممکن است چنین نتیجه‌ای بدهد:
.Sp
.Vb 1
\&        $(objpfx)foo.o: foo.c
.Ve
.IP "\fB\-MQ\fR \fItarget\fR" 4
.IX Item "-MQ target"
مشابه \fB\-MT\fR، اما نویسه‌هایی را که برای Make ویژه هستند نقل‌قول
می‌کند. \fB\-MQ\ \*(Aq$(objpfx)foo.o\*(Aq\fR چنین نتیجه‌ای می‌دهد:
.Sp
.Vb 1
\&        $$(objpfx)foo.o: foo.c
.Ve
.Sp
هدف پیش‌فرض به‌طور خودکار نقل‌قول می‌شود، گویی با
\&\fB\-MQ\fR داده شده است.
.IP \fB\-MD\fR 4
.IX Item "-MD"
.PD 0
.IP \fB\-\-write\-dependencies\fR 4
.IX Item "--write-dependencies"
.PD
\&\fB\-MD\fR معادل \fB\-M \-MF\fR \fIfile\fR است، به این استثنا که
\&\fB\-E\fR به‌طور ضمنی اعمال نمی‌شود. راه‌انداز (driver) مقدار \fIfile\fR را بر اساس
داده شدن یا نشدن گزینهٔ \fB\-o\fR تعیین می‌کند. اگر داده شده باشد، راه‌انداز از آرگومان
آن اما با پسوند \fI.d\fR استفاده می‌کند؛ در غیر این صورت نام فایل ورودی را
گرفته، هرگونه بخش‌های دایرکتوری و پسوند آن را حذف می‌کند، و
یک پسوند \fI.d\fR را اعمال می‌نماید.
.Sp
اگر \fB\-MD\fR همراه با \fB\-E\fR استفاده شود، هر
سوییچ \fB\-o\fR به این صورت درک می‌شود که فایل خروجی وابستگی را مشخص می‌کند، اما اگر بدون \fB\-E\fR استفاده شود، هر \fB\-o\fR
به‌عنوان مشخص‌کنندهٔ فایل شیء هدف تلقی می‌گردد.
.Sp
از آنجا که \fB\-E\fR به‌طور ضمنی اعمال نمی‌شود، از \fB\-MD\fR می‌توان برای تولید
یک فایل خروجی وابستگی به‌عنوان یک اثر جانبی در فرایند کامپایل استفاده کرد.
.IP \fB\-MMD\fR 4
.IX Item "-MMD"
.PD 0
.IP \fB\-\-write\-user\-dependencies\fR 4
.IX Item "--write-user-dependencies"
.PD
مشابه \fB\-MD\fR، با این تفاوت که تنها فایل‌های سرایند کاربر را ذکر می‌کند، نه
فایل‌های سرایند سیستم را.
.IP \fB\-fpreprocessed\fR 4
.IX Item "-fpreprocessed"
به پیش‌پردازنده اعلام می‌کند که فایل ورودی قبلاً پیش‌پردازش شده است.
این امر مواردی چون گسترش ماکروها، تبدیل سه‌نویسه‌ای‌ها (trigraphs)،
اتصال خطوط جدید با نویسهٔ گریز، و پردازش اکثر دستورات پیش‌پردازنده را غیرفعال می‌کند.
پیش‌پردازنده همچنان توضیح‌ها (کامنت‌ها) را تشخیص داده و حذف می‌کند، به‌طوری که می‌توانید
فایلی را که با \fB\-C\fR پیش‌پردازش شده، بدون مشکل به کامپایلر
ارسال کنید. در این حالت، پیش‌پردازندهٔ یکپارچه چیزی بیش از
یک نشانه‌گذار (tokenizer) برای فرانت‌اندها نخواهد بود.
.Sp
اگر فایل ورودی یکی از پسوندهای \fB.i\fR، \fB.ii\fR یا \fB.mi\fR را داشته باشد،
\&\fB\-fpreprocessed\fR به‌طور ضمنی اعمال می‌شود. این‌ها همان پسوندهایی هستند
که GCC برای فایل‌های پیش‌پردازش‌شدهٔ ایجاد شده توسط
\&\fB\-save\-temps\fR به کار می‌برد.
.IP \fB\-fdirectives\-only\fR 4
.IX Item "-fdirectives-only"
هنگام پیش‌پردازش، دستورات پیش‌پردازنده را مدیریت کن، اما ماکروها را گسترش نده.
.Sp
رفتار این گزینه به گزینه‌های \fB\-E\fR و \fB\-fpreprocessed\fR
بستگی دارد.
.Sp
همراه با \fB\-E\fR، پیش‌پردازش به مدیریت دستوراتی مانند
\f(CW\*(C`#define\*(C'\fR، \f(CW\*(C`#ifdef\*(C'\fR و \f(CW\*(C`#error\*(C'\fR محدود می‌شود. سایر
عملیات پیش‌پردازنده، مانند گسترش ماکرو و تبدیل سه‌نویسه‌ای‌ها
انجام نمی‌شوند. علاوه بر این، گزینهٔ \fB\-dD\fR به‌طور ضمنی
فعال می‌گردد.
.Sp
همراه با \fB\-fpreprocessed\fR، پیش‌تعریف ماکروهای خط فرمان و بیشتر
ماکروهای توکار (builtin) غیرفعال می‌شود. ماکروهایی مانند \f(CW\*(C`_\|_LINE_\|_\*(C'\fR که
وابسته به زمینه هستند، به‌طور عادی پردازش می‌شوند. این امر کامپایل
فایل‌هایی را که پیش‌تر با \f(CW\*(C`\-E \-fdirectives\-only\*(C'\fR پیش‌پردازش شده‌اند امکان‌پذیر می‌سازد.
.Sp
با حضور هر دو گزینهٔ \fB\-E\fR و \fB\-fpreprocessed\fR، قواعد مربوط به
\&\fB\-fpreprocessed\fR تقدم دارند. این امر پیش‌پردازش کامل
فایل‌هایی را که قبلاً با \f(CW\*(C`\-E \-fdirectives\-only\*(C'\fR پیش‌پردازش شده‌اند ممکن می‌کند.
.IP \fB\-fdollars\-in\-identifiers\fR 4
.IX Item "-fdollars-in-identifiers"
پذیرش \fB$\fR در شناسه‌ها.
.IP \fB\-fextended\-identifiers\fR 4
.IX Item "-fextended-identifiers"
پذیرش نام‌های نویسهٔ جهان‌شمول (universal character names) و نویسه‌های گسترش‌یافته در
شناسه‌ها. این گزینه به‌طور پیش‌فرض برای C99 (و نسخه‌های بعدی
استاندارد C) و C++ فعال است.
.IP \fB\-fno\-canonical\-system\-headers\fR 4
.IX Item "-fno-canonical-system-headers"
هنگام پیش‌پردازش، مسیرهای سرایند سیستم را از طریق متعارف‌سازی (canonicalization) کوتاه نکن.
.IP \fB\-fmax\-include\-depth=\fR\fIdepth\fR 4
.IX Item "-fmax-include-depth=depth"
حداکثر عمق تودرتویی دستورهای #include را تنظیم می‌کند. پیش‌فرض 200 است.
.IP \fB\-fsearch\-include\-path\fR[\fB=\fR\fIkind\fR] 4
.IX Item "-fsearch-include-path[=kind]"
جستجوی فایل‌های ورودی در مسیر #include، و نه فقط در دایرکتوری
جاری. این گزینه به‌ویژه برای ماژول‌های C++20 مفید است که در آن‌ها
هر دو واحدهای سرایند و واحدهای واسط ماژول باید مستقیماً
کامپایل شوند:
.Sp
.Vb 1
\&        g++ \-c \-std=c++20 \-fmodules \-fsearch\-include\-path bits/stdc++.h bits/std.cc
.Ve
.Sp
مقدار \fIkind\fR به‌طور پیش‌فرض \fBuser\fR است، که مسیر جستجوی
\f(CW#include "..."\fR را بررسی می‌کند؛ همچنین می‌توانید صراحتاً \fBsystem\fR را
برای مسیر جستجوی \f(CW\*(C`#include <...>\*(C'\fR مشخص کنید.
.IP \fB\-ftabstop=\fR\fIwidth\fR 4
.IX Item "-ftabstop=width"
فاصلهٔ بین توقف‌های تب (tab stops) را تنظیم می‌کند. این کار به پیش‌پردازنده کمک می‌کند تا
شمارهٔ ستون‌های صحیحی را در هشدارها یا خطاها گزارش دهد، حتی اگر تب‌ها در خط
ظاهر شوند. اگر مقدار کمتر از 1 یا بزرگتر از 100 باشد، از این گزینه
صرف‌نظر می‌شود. پیش‌فرض 8 است.
.IP \fB\-ftrack\-macro\-expansion\fR[\fB=\fR\fIlevel\fR] 4
.IX Item "-ftrack-macro-expansion[=level]"
مکان نشانه‌ها (tokens) را در امتداد گسترش ماکروها ردیابی می‌کند. این امکان را به
کامپایلر می‌دهد تا در صورت بروز خطای کامپایل درون یک گسترش ماکرو،
گزارش تشخیصی دربارهٔ پشتهٔ فعلی گسترش ماکرو صادر کند. استفاده از این
گزینه باعث مصرف حافظهٔ بیشتر توسط پیش‌پردازنده و کامپایلر
می‌شود. پارامتر \fIlevel\fR می‌تواند برای انتخاب سطح دقتِ ردیابی مکان نشانه‌ها
استفاده شود و در نتیجه در صورت نیاز مصرف حافظه را کاهش دهد.
مقدار \fB0\fR برای \fIlevel\fR این گزینه را غیرفعال می‌کند. مقدار \fB1\fR مکان نشانه‌ها را
در یک حالت تقلیل‌یافته به‌منظور حداقل بار اضافی حافظه ردیابی می‌کند. در این حالت
تمام نشانه‌های ناشی از گسترش آرگومانِ یک ماکروی شبه‌تابع، دارای
مکان یکسانی هستند. مقدار \fB2\fR مکان نشانه‌ها را به‌طور کامل ردیابی می‌کند.
این مقدار بیشترین مصرف حافظه را دارد. هنگامی که هیچ آرگومانی به این گزینه داده نشود،
مقدار پیش‌فرض پارامتر \fB2\fR است.
.Sp
توجه داشته باشید که \f(CW\*(C`\-ftrack\-macro\-expansion=2\*(C'\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-fmacro\-prefix\-map=\fR\fIold\fR\fB=\fR\fInew\fR 4
.IX Item "-fmacro-prefix-map=old=new"
هنگام پیش‌پردازش فایل‌های واقع در دایرکتوری \fIold\fR،
ماکروهای \f(CW\*(C`_\|_FILE_\|_\*(C'\fR و \f(CW\*(C`_\|_BASE_FILE_\|_\*(C'\fR را طوری گسترش می‌دهد که گویی
فایل‌ها در دایرکتوری \fInew\fR قرار دارند. از این قابلیت می‌توان
برای تغییر یک مسیر مطلق به یک مسیر نسبی با استفاده از \fI.\fR برای
\&\fInew\fR بهره برد که می‌تواند منجر به ساخت‌های بازتولیدپذیرتری شود که
مستقل از مکان هستند. این گزینه همچنین بر
\&\f(CW\*(C`_\|_builtin_FILE()\*(C'\fR حین کامپایل اثر می‌گذارد. همچنین ببینید:
\&\fB\-ffile\-prefix\-map\fR و \fB\-fcanon\-prefix\-map\fR.
.IP \fB\-fexec\-charset=\fR\fIcharset\fR 4
.IX Item "-fexec-charset=charset"
مجموعه‌نویسهٔ اجرایی مورد استفاده برای ثوابت رشته‌ای و نویسه‌ای را
تنظیم می‌کند. پیش‌فرض UTF\-8 است. \fIcharset\fR می‌تواند هر کدگذاری
پشتیبانی‌شده توسط روتین کتابخانه‌ای \f(CW\*(C`iconv\*(C'\fR سیستم باشد.
.IP \fB\-fwide\-exec\-charset=\fR\fIcharset\fR 4
.IX Item "-fwide-exec-charset=charset"
مجموعه‌نویسهٔ اجرایی عریض مورد استفاده برای ثوابت رشته‌ای و نویسه‌ای
عریض را تعیین می‌کند. مقدار پیش‌فرض یکی از UTF\-32BE، UTF\-32LE، UTF\-16BE،
یا UTF\-16LE است، هرکدام که با عرض \f(CW\*(C`wchar_t\*(C'\fR و ترتیب
بایتی مه‌پایان (big-endian) یا که‌پایان (little-endian) مورد استفاده برای تولید کد مطابقت داشته باشد. همانند
\fB\-fexec\-charset\fR، \fIcharset\fR می‌تواند هر کدگذاری پشتیبانی‌شده
توسط روتین کتابخانه‌ای \f(CW\*(C`iconv\*(C'\fR سیستم باشد؛ با این حال، با کدگذاری‌هایی که
دقیقاً در \f(CW\*(C`wchar_t\*(C'\fR جا نمی‌شوند دچار مشکل خواهید شد.
.IP \fB\-finput\-charset=\fR\fIcharset\fR 4
.IX Item "-finput-charset=charset"
مجموعه‌نویسهٔ ورودی را تنظیم می‌کند که برای تبدیل از مجموعه‌نویسهٔ
فایل ورودی به مجموعه‌نویسهٔ مبدأ مورد استفاده توسط GCC به کار می‌رود. مقدار
پیش‌فرض UTF\-8 است. \fIcharset\fR می‌تواند هر کدگذاری
پشتیبانی‌شده توسط روتین کتابخانه‌ای \f(CW\*(C`iconv\*(C'\fR سیستم باشد.
.Sp
اگر مجموعه‌نویسهٔ ورودی UTF\-8 باشد، در صورت فعال بودن \fB\-Winvalid\-utf8\fR،
هشدارهایی دربارهٔ توالی‌های بدقوارهٔ واحدهای کد (code unit) صادر می‌شود.
در غیر این صورت، وقتی مجموعه‌نویسهٔ ورودی با مجموعه‌نویسهٔ اجرایی مطابقت داشته باشد
هیچ گزارش تشخیصی صادر نمی‌شود. در صورت متفاوت بودن، توالی‌های
بدقوارهٔ واحدهای کد هنگام تبدیل کدگذاری (transcoding) به مجموعه‌نویسهٔ اجرایی موجب بروز خطا می‌شوند..IP \fB\-fpch\-deps\fR 4
.IX Item "-fpch-deps"
هنگام استفاده از سرآیندهای از‌پیش‌کامپایل‌شده (precompiled headers)، این پرچم باعث می‌شود که پرچم‌های خروجی وابستگی، فایل‌های موجود در وابستگی‌های سرآیند از‌پیش‌کامپایل‌شده را نیز فهرست کنند. در صورت عدم تعیین، تنها خود سرآیند از‌پیش‌کامپایل‌شده فهرست می‌شود و نه فایل‌هایی که برای ساخت آن استفاده شده‌اند، چرا که هنگام استفاده از یک سرآیند از‌پیش‌کامپایل‌شده به آن فایل‌ها رجوع نمی‌شود.
.IP \fB\-fpch\-preprocess\fR 4
.IX Item "-fpch-preprocess"
این گزینه امکان استفاده از سرآیند از‌پیش‌کامپایل‌شده را به همراه \fB\-E\fR فراهم می‌کند. این گزینه یک \f(CW\*(C`#pragma\*(C'\fR ویژه، به صورت
\&\f(CW\*(C`#pragma GCC pch_preprocess "\fR\f(CIfilename\fR\f(CW"\*(C'\fR را در خروجی درج می‌کند تا مکانی را که سرآیند از‌پیش‌کامپایل‌شده در آن یافت شد و نام فایل آن (\fIfilename\fR) را مشخص کند.
هنگامی که \fB\-fpreprocessed\fR در حال استفاده باشد، GCC این \f(CW\*(C`#pragma\*(C'\fR را تشخیص داده و PCH را بارگذاری می‌کند.
.Sp
این گزینه به صورت پیش‌فرض غیرفعال است، زیرا خروجی پیش‌پردازش‌شدهٔ حاصل واقعاً فقط به عنوان ورودی برای GCC مناسب است. این گزینه توسط
\&\fB\-save\-temps\fR فعال می‌شود.
.Sp
شما نباید این \f(CW\*(C`#pragma\*(C'\fR را در کد خود بنویسید، اما در صورتی که فایل PCH در مکان دیگری در دسترس باشد، ویرایش نام فایل بی‌خطر است. نام فایل می‌تواند مطلق باشد یا نسبت به دایرکتوری جاری GCC مشخص شود.
.IP \fB\-fworking\-directory\fR 4
.IX Item "-fworking-directory"
تولید نشانگرهای خط (linemarkers) را در خروجی پیش‌پردازنده فعال می‌کند تا کامپایلر از دایرکتوری کاری جاری در زمان پیش‌پردازش مطلع شود. هنگامی که این گزینه فعال باشد، پیش‌پردازنده پس از نشانگر خط اولیه، یک نشانگر خط دوم همراه با دایرکتوری کاری جاری و به دنبال آن دو اسلش صادر می‌کند. هنگامی که این دایرکتوری در ورودی پیش‌پردازش‌شده وجود داشته باشد، GCC از آن به عنوان دایرکتوری کاری جاری در برخی قالب‌های اطلاعات اشکال‌زدایی (debugging) استفاده می‌کند. این گزینه در صورت فعال بودن اطلاعات اشکال‌زدایی به‌طور ضمنی فعال می‌شود، اما می‌توان با شکل نقیض آن یعنی \fB\-fno\-working\-directory\fR جلوی آن را گرفت. اگر پرچم \fB\-P\fR در خط فرمان وجود داشته باشد، این گزینه هیچ تأثیری نخواهد داشت، زیرا در این صورت اساساً هیچ دستورالعمل \f(CW\*(C`#line\*(C'\fR صادر نمی‌شود.
.IP \fB\-C\fR 4
.IX Item "-C"
.PD 0
.IP \fB\-\-comments\fR 4
.IX Item "--comments"
.PD
کامنت‌ها را دور نریزید. تمام کامنت‌ها به فایل خروجی منتقل می‌شوند، به جز کامنت‌های درون دستورالعمل‌های پردازش‌شده که همراه با خود دستورالعمل حذف می‌شوند.
.Sp
هنگام استفاده از \fB\-C\fR باید برای اثرات جانبی آماده باشید؛ این گزینه باعث می‌شود پیش‌پردازنده با کامنت‌ها به عنوان توکن‌های مستقل رفتار کند. برای مثال، قرار گرفتن کامنت‌ها در ابتدای خطی که قرار است یک خط دستورالعمل باشد، باعث تبدیل آن خط به یک خط کد منبع معمولی می‌شود، زیرا نخستین توکن در آن خط دیگر یک \fB#\fR نخواهد بود.
.IP \fB\-CC\fR 4
.IX Item "-CC"
.PD 0
.IP \fB\-\-comments\-in\-macros\fR 4
.IX Item "--comments-in-macros"
.PD
کامنت‌ها را دور نریزید، از جمله در طول بسط ماکرو (macro expansion). این گزینه شبیه به \fB\-C\fR است، با این تفاوت که کامنت‌های درون ماکروها نیز در جایی که ماکرو بسط می‌یابد به فایل خروجی منتقل می‌شوند.
.Sp
علاوه بر اثرات جانبی گزینهٔ \fB\-C\fR، گزینهٔ \fB\-CC\fR باعث می‌شود تمام کامنت‌های سبک ++C در داخل ماکرو به کامنت‌های سبک C تبدیل شوند. این کار برای جلوگیری از این است که استفاده‌های بعدی از آن ماکرو به طور ناخواسته بقیه خط منبع را به کامنت تبدیل نکند.
.Sp
گزینهٔ \fB\-CC\fR معمولاً برای پشتیبانی از کامنت‌های lint استفاده می‌شود.
.IP \fB\-P\fR 4
.IX Item "-P"
.PD 0
.IP \fB\-\-no\-line\-commands\fR 4
.IX Item "--no-line-commands"
.PD
از تولید نشانگرهای خط در خروجی پیش‌پردازنده جلوگیری می‌کند. این ممکن است هنگام اجرای پیش‌پردازنده بر روی مواردی که کد C نیستند و قرار است به برنامه‌ای ارسال شوند که ممکن است با نشانگرهای خط دچار سردرگمی شود، مفید باشد.
.IP \fB\-traditional\fR 4
.IX Item "-traditional"
.PD 0
.IP \fB\-\-traditional\fR 4
.IX Item "--traditional"
.IP \fB\-traditional\-cpp\fR 4
.IX Item "-traditional-cpp"
.IP \fB\-\-traditional\-cpp\fR 4
.IX Item "--traditional-cpp"
.PD
تلاش می‌کند تا رفتار پیش‌پردازنده‌های C پیش‌از استاندارد را به جای پیش‌پردازنده‌های ISO C شبیه‌سازی کند.
برای جزئیات به دفترچه راهنمای GNU CPP مراجعه کنید.
.Sp
توجه داشته باشید که GCC در غیر این صورت تلاشی برای شبیه‌سازی یک کامپایلر C پیش‌از استاندارد نمی‌کند، و این گزینه‌ها تنها همراه با سوییچ \fB\-E\fR یا هنگام فراخوانی صریح CPP پشتیبانی می‌شوند.
.IP \fB\-trigraphs\fR 4
.IX Item "-trigraphs"
.PD 0
.IP \fB\-\-trigraphs\fR 4
.IX Item "--trigraphs"
.PD
از سه‌نگاره‌های (trigraphs) استاندارد ISO C پشتیبانی می‌کند.
این‌ها توالی‌های سه‌کاراکتری هستند که همگی با \fB??\fR شروع می‌شوند و توسط استاندارد ISO C برای نشان دادن کاراکترهای منفرد تعریف شده‌اند. برای مثال،
\&\fB??/\fR بیانگر \fB\e\fR است، بنابراین \fB\*(Aq??/n\*(Aq\fR یک ثابت کاراکتری برای خط جدید (newline) است.
.Sp
نُه سه‌نگاره و جایگزین‌های آن‌ها عبارتند از:
.Sp
.Vb 2
\&        Trigraph:       ??(  ??)  ??<  ??>  ??=  ??/  ??\*(Aq  ??!  ??\-
\&        Replacement:      [    ]    {    }    #    \e    ^    |    ~
.Ve
.Sp
به‌طور پیش‌فرض، GCC سه‌نگاره‌ها را نادیده می‌گیرد، اما در حالت‌های منطبق با استاندارد آن‌ها را تبدیل می‌کند. گزینه‌های \fB\-std\fR و
\&\fB\-ansi\fR را ببینید.
.IP \fB\-remap\fR 4
.IX Item "-remap"
کد ویژه‌ای را برای دور زدن محدودیت سیستم‌های فایلی که فقط نام‌های فایل بسیار کوتاه را مجاز می‌دانند (مانند MS\-DOS)، فعال می‌کند.
.IP \fB\-H\fR 4
.IX Item "-H"
.PD 0
.IP \fB\-\-trace\-includes\fR 4
.IX Item "--trace-includes"
.PD
علاوه بر دیگر فعالیت‌های عادی، نام هر فایل سرآیند استفاده‌شده را چاپ می‌کند. هر نام به گونه‌ای دندانه‌دار می‌شود که نشان دهد در چه عمقی از پشتهٔ
\&\fB#include\fR قرار دارد. فایل‌های سرآیند از‌پیش‌کامپایل‌شده نیز چاپ می‌شوند، حتی اگر نامعتبر شناخته شوند؛ یک فایل سرآیند از‌پیش‌کامپایل‌شده نامعتبر با \fB...x\fR و یک فایل معتبر با \fB...!\fR چاپ می‌شود.
.IP \fB\-d\fR\fIletters\fR 4
.IX Item "-dletters"
.PD 0
.IP \fB\-\-dump=\fR\fIletters\fR 4
.IX Item "--dump=letters"
.IP "\fB\-\-dump\fR \fIletters\fR" 4
.IX Item "--dump letters"
.PD
مشخص می‌کند که در حین کامپایل، روبرداری‌های اشکال‌زدایی (debugging dumps) طبق آنچه توسط
\&\fIletters\fR مشخص شده، تولید شوند. پرچم‌های مستندشده در اینجا مواردی هستند که به پیش‌پردازنده مربوط می‌شوند. سایر \fIletters\fR توسط خود کامپایلر تفسیر می‌شوند، یا برای نسخه‌های آینده GCC رزرو شده‌اند و بنابراین بدون هشدار نادیده گرفته می‌شوند. اگر \fIletters\fR مشخص کنید که رفتار آن‌ها با یکدیگر تداخل داشته باشد، نتیجه نامشخص خواهد بود.
.RS 4
.IP \fB\-dM\fR 4
.IX Item "-dM"
.PD 0
.IP \fB\-\-dump=M\fR 4
.IX Item "--dump=M"
.PD
به جای خروجی عادی، فهرستی از دستورالعمل‌های \fB#define\fR را برای تمامی ماکروهای تعریف‌شده در طول اجرای پیش‌پردازنده، از جمله ماکروهای از‌پیش‌تعریف‌شده، تولید می‌کند. این امکان را به شما می‌دهد تا متوجه شوید چه چیزهایی در نسخهٔ پیش‌پردازنده شما از پیش تعریف شده‌اند.
با فرض اینکه فایلی به نام \fIfoo.h\fR ندارید، دستور
.Sp
.Vb 1
\&        touch foo.h; cpp \-dM foo.h
.Ve
.Sp
همه ماکروهای از‌پیش‌تعریف‌شده را نشان می‌دهد.
.Sp
اگر از \fB\-dM\fR بدون گزینهٔ \fB\-E\fR استفاده کنید، \fB\-dM\fR به عنوان مترادفی برای \fB\-fdump\-rtl\-mach\fR تفسیر می‌شود.
.IP \fB\-dD\fR 4
.IX Item "-dD"
.PD 0
.IP \fB\-\-dump=D\fR 4
.IX Item "--dump=D"
.PD
مانند \fB\-dM\fR عمل می‌کند، با این تفاوت که \fIهم\fR دستورالعمل‌های \fB#define\fR و \fIهم\fR نتیجهٔ پیش‌پردازش را در خروجی قرار می‌دهد. هر دو نوع خروجی به فایل خروجی استاندارد ارسال می‌شوند.
.IP \fB\-dN\fR 4
.IX Item "-dN".PD 0
.IP \fB\-\-dump=N\fR 4
.IX Item "--dump=N"
.PD
مانند \fB\-dD\fR، اما تنها نام ماکروها را صادر می‌کند و نه بسط آن‌ها را.
.IP \fB\-dI\fR 4
.IX Item "-dI"
.PD 0
.IP \fB\-\-dump=I\fR 4
.IX Item "--dump=I"
.PD
علاوه بر نتیجه پیش‌پردازش، دستورات \fB#include\fR را نیز در خروجی قرار می‌دهد.
.IP \fB\-dU\fR 4
.IX Item "-dU"
.PD 0
.IP \fB\-\-dump=U\fR 4
.IX Item "--dump=U"
.PD
مانند \fB\-dD\fR است، به جز اینکه فقط ماکروهایی که بسط داده شده‌اند یا وضعیت تعریف بودن آن‌ها در دستورات پیش‌پردازنده بررسی شده است در خروجی چاپ می‌شوند؛ چاپ خروجی تا زمان استفاده یا بررسی ماکرو به تعویق می‌افتد؛ و همچنین دستورات \fB#undef\fR نیز برای ماکروهایی که بررسی شده‌اند اما در آن زمان تعریف نشده بودند در خروجی درج می‌شوند.
.RE
.RS 4
.RE
.IP \fB\-fdebug\-cpp\fR 4
.IX Item "-fdebug-cpp"
این گزینه فقط برای اشکال‌زدایی GCC کاربرد دارد. هنگامی که از طریق CPP یا همراه با \fB\-E\fR استفاده شود، اطلاعات اشکال‌زدایی مربوط به نقشه‌های مکان (location maps) را تخلیه می‌کند. پیش از هر نشانک (token) در خروجی، اطلاعات نقشه‌ای که مکان آن متعلق به آن است درج می‌گردد.
.Sp
هنگامی که از طریق GCC و بدون \fB\-E\fR استفاده شود، این گزینه هیچ تأثیری ندارد.
.IP \fB\-Wp,\fR\fIoption\fR 4
.IX Item "-Wp,option"
می‌توانید از \fB\-Wp,\fR\fIoption\fR برای دور زدن گرداننده کامپایلر (compiler driver) و ارسال مستقیم \fIoption\fR به پیش‌پردازنده استفاده کنید. اگر \fIoption\fR شامل ویرگول باشد، در محل ویرگول‌ها به چندین گزینه تفکیک می‌شود. با این حال، بسیاری از گزینه‌ها پیش از ارسال به پیش‌پردازنده توسط گرداننده کامپایلر اصلاح، ترجمه یا تفسیر می‌شوند، و \fB\-Wp\fR به‌اجبار این مرحله را نادیده می‌گیرد. رابط کاربری مستقیم پیش‌پردازنده مستندسازی نشده و ممکن است تغییر کند، بنابراین در صورت امکان باید از استفاده از \fB\-Wp\fR خودداری کنید و اجازه دهید خود گرداننده گزینه‌ها را مدیریت نماید.
.IP "\fB\-Xpreprocessor\fR \fIoption\fR" 4
.IX Item "-Xpreprocessor option"
گزینه \fIoption\fR را به عنوان گزینه‌ای برای پیش‌پردازنده ارسال می‌کند. می‌توانید از این مورد برای ارائه گزینه‌های پیش‌پردازنده مختص سیستم که GCC آن‌ها را نمی‌شناسد، استفاده کنید.
.Sp
اگر می‌خواهید گزینه‌ای ارسال کنید که دارای آرگومان است، باید از \fB\-Xpreprocessor\fR دوبار استفاده کنید؛ یک‌بار برای خود گزینه و یک‌بار برای آرگومان آن.
.IP \fB\-no\-integrated\-cpp\fR 4
.IX Item "-no-integrated-cpp"
.PD 0
.IP \fB\-\-no\-integrated\-cpp\fR 4
.IX Item "--no-integrated-cpp"
.PD
پیش‌پردازش را به عنوان یک مرحله مستقل پیش از کامپایل اجرا می‌کند.
به طور پیش‌فرض، GCC پیش‌پردازش را به عنوان بخشی یکپارچه از نشانه‌گذاری (tokenization) و تجزیه ورودی انجام می‌دهد.
اگر این گزینه مشخص شود، بخش فرانت‌اند زبان مربوطه (\fBcc1\fR، \fBcc1plus\fR یا \fBcc1obj\fR به ترتیب برای C، C++‎ و Objective\-C) به جای آن دوبار فراخوانی می‌شود؛ یک‌بار فقط برای پیش‌پردازش و یک‌بار برای کامپایل واقعی ورودیِ پیش‌پردازش‌شده.
این گزینه ممکن است همراه با گزینه‌های \fB\-B\fR یا \fB\-wrapper\fR برای تعیین یک پیش‌پردازنده جایگزین یا اعمال پردازش‌های اضافی روی سورس برنامه بین مرحله پیش‌پردازش عادی و کامپایل مفید باشد.
.SS "ارسال گزینه‌ها به اسمبلر (Passing Options to the Assembler)"
.IX Subsection "Passing Options to the Assembler"
می‌توانید گزینه‌ها را به اسمبلر ارسال کنید.
.IP \fB\-Wa,\fR\fIoption\fR 4
.IX Item "-Wa,option"
گزینه \fIoption\fR را به عنوان گزینه‌ای برای اسمبلر ارسال می‌کند. اگر \fIoption\fR شامل ویرگول باشد، در محل ویرگول‌ها به چندین گزینه تفکیک می‌شود.
.IP "\fB\-Xassembler\fR \fIoption\fR" 4
.IX Item "-Xassembler option"
.PD 0
.IP \fB\-\-for\-assembler=\fR\fIoption\fR 4
.IX Item "--for-assembler=option"
.IP "\fB\-\-for\-assembler\fR \fIoption\fR" 4
.IX Item "--for-assembler option"
.PD
گزینه \fIoption\fR را به عنوان گزینه‌ای برای اسمبلر ارسال می‌کند. می‌توانید از این مورد برای ارائه گزینه‌های اسمبلر مختص سیستم که GCC آن‌ها را نمی‌شناسد، استفاده کنید.
.Sp
اگر می‌خواهید گزینه‌ای ارسال کنید که دارای یک آرگومان است، باید از \fB\-Xassembler\fR دوبار استفاده کنید؛ یک‌بار برای گزینه و یک‌بار برای آرگومان آن..SS "گزینه‌های پیوند دادن (Options for Linking)"
.IX Subsection "Options for Linking"
این گزینه‌ها زمانی فعال می‌شوند که کامپایلر فایل‌های شیء را به یک
فایل خروجی اجرایی پیوند می‌دهد. در صورتی که کامپایلر مرحلهٔ پیوند را
انجام ندهد، این گزینه‌ها بی‌اثر خواهند بود.
.IP \fIobject\-file\-name\fR 4
.IX Item "object-file-name"
نام فایلی که به پسوند شناخته‌شدهٔ ویژه‌ای ختم نمی‌شود، به عنوان نام
یک فایل شیء یا کتابخانه در نظر گرفته می‌شود. (پیونددهنده بر اساس محتویات
فایل، فایل‌های شیء را از کتابخانه‌ها تشخیص می‌دهد.) اگر پیوند انجام شود،
این فایل‌های شیء به عنوان ورودی برای پیونددهنده استفاده می‌شوند.
.IP \fB\-c\fR 4
.IX Item "-c"
.PD 0
.IP \fB\-S\fR 4
.IX Item "-S"
.IP \fB\-E\fR 4
.IX Item "-E"
.PD
اگر هر یک از این گزینه‌ها استفاده شود، پیونددهنده اجرا نمی‌شود و
نام فایل‌های شیء نباید به عنوان آرگومان به کار روند.
.IP \fB\-flink\-libatomic\fR 4
.IX Item "-flink-libatomic"
پیوند دادن libatomic را در صورت پشتیبانی توسط هدف فعال می‌کند؛ این گزینه
به صورت پیش‌فرض فعال است. شکل نقیض آن \fB\-fno\-link\-libatomic\fR می‌تواند
برای غیرفعال کردن صریح پیوند دادن libatomic استفاده شود.
.IP \fB\-flinker\-output=\fR\fItype\fR 4
.IX Item "-flinker-output=type"
این گزینه تولید کد بهینه‌ساز زمان پیوند (LTO) را کنترل می‌کند. به طور
پیش‌فرض خروجی پیونددهنده به صورت خودکار توسط افزونهٔ پیونددهنده تعیین
می‌شود. برای اشکال‌زدایی کامپایلر و در شرایطی که پیوند افزایشی با یک فایل
شیء غیر LTO مورد نیاز باشد، ممکن است کنترل دستی این نوع خروجی مفید باشد.
.Sp
اگر مقدار \fItype\fR برابر با \fBexec\fR باشد، تولید کد یک باینری ایستا
تولید می‌کند. در این حالت هر دو گزینهٔ \fB\-fpic\fR و \fB\-fpie\fR
غیرفعال می‌شوند.
.Sp
اگر مقدار \fItype\fR برابر با \fBdyn\fR باشد، تولید کد یک کتابخانهٔ
اشتراکی ایجاد می‌کند. در این حالت \fB\-fpic\fR یا \fB\-fPIC\fR حفظ
می‌شوند، اما به طور خودکار فعال نمی‌گردند. این سازوکار امکان ساخت
کتابخانه‌های اشتراکی بدون کد مستقل از موقعیت (position\-independent code) را در
معماری‌هایی که این قابلیت در آن‌ها مجاز است (مانند x86) فراهم می‌کند.
.Sp
اگر مقدار \fItype\fR برابر با \fBpie\fR باشد، تولید کد یک فایل اجرایی
\fB\-fpie\fR تولید می‌کند. این گزینه بهینه‌سازی‌هایی مشابه \fBexec\fR
به همراه دارد، با این تفاوت که اگر \fB\-fpie\fR در زمان کامپایل مشخص شده
باشد، غیرفعال نمی‌شود.
.Sp
اگر مقدار \fItype\fR برابر با \fBrel\fR باشد، کامپایلر فرض می‌کند که
پیوند افزایشی در حال انجام است. بخش‌های حاوی کد میانی برای بهینه‌سازی
زمان پیوند با هم ادغام شده، پیش‌بهینه‌سازی می‌شوند و در فایل شیء حاصل
قرار می‌گیرند. علاوه بر این، اگر \&\fB\-ffat\-lto\-objects\fR مشخص شده
باشد، کد باینری برای پیوندهای غیر LTO آینده نیز تولید می‌گردد. فایل شیء
تولیدشده توسط پیوند افزایشی کوچک‌تر از یک کتابخانهٔ ایستا خواهد بود که از
همان فایل‌های شیء ساخته شده باشد. در زمان پیوند، نتیجهٔ پیوند افزایشی با فرض
اینکه بیشتر اشیاء موجود در کتابخانه استفاده می‌شوند، سریع‌تر از یک کتابخانهٔ
ایستا بارگذاری می‌شود.
.Sp
در نهایت، مقدار \fBnolto\-rel\fR کامپایلر را برای پیوند افزایشی به گونه‌ای
پیکربندی می‌کند که تولید کد اجباری می‌شود، یک باینری نهایی تولید شده و کد
میانی برای بهینه‌سازی‌های آتی زمان پیوند حذف (strip) می‌شود. هنگامی که چندین
فایل شیء با یکدیگر پیوند داده می‌شوند، کد حاصل نسبت به زمانی که بهینه‌سازی‌های
زمان پیوند غیرفعال است بهینه‌تر خواهد بود (برای مثال inlining بین‌ماژولی صورت
می‌گیرد)، اما بیشتر مزایای بهینه‌سازی کل برنامه (whole\-program optimizations)
از دست می‌رود.
.Sp
در طول پیوند افزایشی (توسط \fB\-r\fR) مقدار پیش‌فرض افزونهٔ پیونددهنده
\&\fBrel\fR است. برای پیوند افزایشی اشیاء LTO و اشیاء غیر LTO در یک فایل
شیء ترکیبی واحد، به GNU Binutils نسخهٔ 2.44 یا جدیدتر نیاز است. اگر هر یک از
فایل‌های شیء در پیوند افزایشی نتواند برای بهینه‌سازی زمان پیوند استفاده شود،
افزونهٔ پیونددهنده یک هشدار صادر کرده و از \fBnolto\-rel\fR استفاده می‌کند.
برای حفظ بهینه‌سازی کل برنامه، در عوض چنین اشیائی را به یک کتابخانهٔ ایستا پیوند دهید.
.IP \fB\-fuse\-ld=bfd\fR 4
.IX Item "-fuse-ld=bfd"
استفاده از پیونددهندهٔ \fBbfd\fR به جای پیونددهندهٔ پیش‌فرض.
.IP \fB\-fuse\-ld=gold\fR 4
.IX Item "-fuse-ld=gold"
استفاده از پیونددهندهٔ \fBgold\fR به جای پیونددهندهٔ پیش‌فرض.
.IP \fB\-fuse\-ld=lld\fR 4
.IX Item "-fuse-ld=lld"
استفاده از پیونددهندهٔ \fBlld\fR متعلق به LLVM به جای پیونددهندهٔ پیش‌فرض.
.IP \fB\-fuse\-ld=mold\fR 4
.IX Item "-fuse-ld=mold"
استفاده از پیونددهندهٔ Modern Linker (\fBmold\fR) به جای پیونددهندهٔ پیش‌فرض.
.IP \fB\-fuse\-ld=wild\fR 4
.IX Item "-fuse-ld=wild"
استفاده از پیونددهندهٔ Wild (\fBwild\fR) به جای پیونددهندهٔ پیش‌فرض.
.IP \fB\-l\fR\fIlibrary\fR 4
.IX Item "-llibrary"
.PD 0
.IP "\fB\-l\fR \fIlibrary\fR" 4
.IX Item "-l library"
.PD
هنگام پیوند دادن، کتابخانهٔ با نام \fIlibrary\fR را جستجو می‌کند. (حالت دوم
که کتابخانه به صورت یک آرگومان جداگانه آمده، تنها برای سازگاری با POSIX است
و توصیه نمی‌شود.)
.Sp
گزینهٔ \fB\-l\fR توسط GCC مستقیماً به پیونددهنده ارسال می‌شود. برای جزئیات
دقیق به مستندات پیونددهندهٔ خود مراجعه کنید. توضیحات کلی زیر در مورد پیونددهندهٔ
GNU صدق می‌کند.
.Sp
پیونددهنده فهرست استانداردی از دایرکتوری‌ها را برای یافتن کتابخانه جستجو می‌کند.
دایرکتوری‌های جستجوشده شامل چندین دایرکتوری استاندارد سیستم به اضافهٔ هر
دایرکتوری مشخص‌شده با \fB\-L\fR است.
.Sp
کتابخانه‌های ایستا، آرشیوهایی از فایل‌های شیء هستند و نام‌هایی مانند
\fIliblibrary.a\fR دارند. برخی از اهداف از کتابخانه‌های اشتراکی نیز پشتیبانی
می‌کنند که معمولاً نام‌هایی مانند \fIliblibrary.so\fR دارند. اگر هر دو نوع
کتابخانهٔ ایستا و اشتراکی یافت شوند، پیونددهنده اولویت را به پیوند با
کتابخانهٔ اشتراکی می‌دهد مگر اینکه گزینهٔ \&\fB\-static\fR استفاده شده باشد.
.Sp
محل قرارگیری این گزینه در دستور اهمیت دارد؛ پیونددهنده کتابخانه‌ها و فایل‌های
شیء را به همان ترتیبی که مشخص شده‌اند جستجو و پردازش می‌کند. بنابراین، دستور
\fBfoo.o \-lz bar.o\fR کتابخانهٔ \fBz\fR را پس از فایل \fIfoo.o\fR اما قبل از
\fIbar.o\fR جستجو می‌کند. اگر \fIbar.o\fR به توابعی در \fBz\fR ارجاع دهد، ممکن
است آن توابع بارگذاری نشوند.
.IP \fB\-lobjc\fR 4
.IX Item "-lobjc"
برای پیوند دادن یک برنامهٔ Objective\-C یا Objective\-C++ به این حالت خاص
از گزینهٔ \fB\-l\fR نیاز دارید.
.IP \fB\-nostartfiles\fR 4
.IX Item "-nostartfiles"
هنگام پیوند دادن، از فایل‌های راه‌اندازی (startup) استاندارد سیستم استفاده نکن.
کتابخانه‌های استاندارد سیستم به طور عادی استفاده می‌شوند، مگر اینکه از \fB\-nostdlib\fR،
\&\fB\-nolibc\fR، یا \fB\-nodefaultlibs\fR استفاده شود.
.IP \fB\-nodefaultlibs\fR 4
.IX Item "-nodefaultlibs"
هنگام پیوند دادن، از کتابخانه‌های استاندارد سیستم استفاده نکن. فقط کتابخانه‌هایی
که شما مشخص می‌کنید به پیونددهنده ارسال می‌شوند، و گزینه‌های مشخص‌کنندهٔ نحوهٔ
پیوند کتابخانه‌های سیستم، مانند \fB\-static\-libgcc\fR یا \fB\-shared\-libgcc\fR،
نادیده گرفته می‌شوند. فایل‌های راه‌اندازی استاندارد به طور عادی استفاده می‌شوند،
مگر اینکه از \fB\-nostartfiles\fR استفاده شود.
.Sp
کامپایلر ممکن است فراخوانی‌هایی برای \f(CW\*(C`memcmp\*(C'\fR،
\&\f(CW\*(C`memset\*(C'\fR، \f(CW\*(C`memcpy\*(C'\fR و \f(CW\*(C`memmove\*(C'\fR تولید کند.
این نمادها معمولاً توسط مدخل‌های موجود در libc برطرف (resolve) می‌شوند. در
صورت تعیین این گزینه، این نقاط ورود باید از طریق سازوکار دیگری تأمین شوند.
.IP \fB\-nolibc\fR 4
.IX Item "-nolibc"
هنگام پیوند دادن، از کتابخانهٔ C یا کتابخانه‌های سیستمی که پیوند نزدیکی با آن
دارند استفاده نکن. همچنان پیوند با فایل‌های راه‌اندازی، \fIlibgcc\fR، یا
کتابخانه‌های پشتیبانی زبانی فراهم‌شده توسط زنجیره ابزار (toolchain) مانند
\fIlibgnat\fR، \fIlibgfortran\fR یا \fIlibstdc++\fR برقرار خواهد بود، مگر اینکه
گزینه‌هایی که مانع از گنجاندن آن‌ها می‌شوند نیز استفاده شده باشند. این گزینه معمولاً
\fB\-lc\fR را از خط فرمان پیوند حذف می‌کند، و همچنین کتابخانه‌های سیستمی را که
به طور معمول با آن همراه هستند و در صورت نبود کتابخانهٔ C بی‌معنی می‌شوند، مانند
\fB\-lpthread\fR یا \&\fB\-lm\fR در برخی پیکربندی‌ها. این گزینه برای اهداف
bare\-board در نظر گرفته شده است، یعنی زمانی که عملاً هیچ کتابخانهٔ C در دسترسی نیست.
.IP \fB\-nostdlib\fR 4
.IX Item "-nostdlib"
.PD 0
.IP \fB\-\-no\-standard\-libraries\fR 4
.IX Item "--no-standard-libraries"
.PD
هنگام پیوند دادن، از فایل‌های راه‌اندازی یا کتابخانه‌های استاندارد سیستم استفاده
نکن. هیچ فایل راه‌اندازی ارسال نمی‌شود و فقط کتابخانه‌های مشخص‌شده توسط شما به
پیونددهنده تحویل داده می‌شوند؛ همچنین گزینه‌های مشخص‌کنندهٔ نحوهٔ پیوند
کتابخانه‌های سیستم، مانند \&\fB\-static\-libgcc\fR یا \fB\-shared\-libgcc\fR،
نادیده گرفته می‌شوند.
.Sp
کامپایلر ممکن است فراخوانی‌هایی برای \f(CW\*(C`memcmp\*(C'\fR، \f(CW\*(C`memset\*(C'\fR،
\&\f(CW\*(C`memcpy\*(C'\fR و \f(CW\*(C`memmove\*(C'\fR تولید کند. این نمادها معمولاً توسط
مدخل‌های موجود در libc برطرف می‌شوند. در صورت تعیین این گزینه، این نقاط ورود
باید از طریق سازوکار دیگری تأمین شوند.
.Sp
یکی از کتابخانه‌های استانداردی که توسط \fB\-nostdlib\fR و \&\fB\-nodefaultlibs\fR
کنار گذاشته می‌شود، \fIlibgcc.a\fR است؛ کتابخانه‌ای از زیرروال‌های داخلی که GCC
برای برطرف کردن کاستی‌های ماشین‌های خاص یا نیازهای ویژهٔ برخی زبان‌ها از آن
استفاده می‌کند.
.Sp
در بیشتر موارد، حتی زمانی که می‌خواهید از سایر کتابخانه‌های استاندارد اجتناب کنید،
به \fIlibgcc.a\fR نیاز خواهید داشت. به عبارت دیگر، هنگامی که \fB\-nostdlib\fR یا
\fB\-nodefaultlibs\fR را مشخص می‌کنید، معمولاً باید \fB\-lgcc\fR را نیز تعیین
کنید. این کار تضمین می‌کند که هیچ ارجاع حل‌نشده‌ای به زیرروال‌های کتابخانهٔ داخلی
GCC باقی نمی‌ماند. (یک نمونه از این زیرروال‌های داخلی \f(CW\*(C`_\|_main\*(C'\fR
است که برای اطمینان از فراخوانی سازنده‌های ++C استفاده می‌شود.).IP \fB\-nostdlib++\fR 4
.IX Item "-nostdlib++"
به‌صورت ضمنی با کتابخانه‌های استاندارد C++ پیوند برقرار نشود.
.IP "\fB\-e\fR \fIentry\fR" 4
.IX Item "-e entry"
.PD 0
.IP \fB\-\-entry=\fR\fIentry\fR 4
.IX Item "--entry=entry"
.IP "\fB\-\-entry\fR \fIentry\fR" 4
.IX Item "--entry entry"
.PD
مشخص می‌کند که نقطهٔ ورود برنامه \fIentry\fR است. این آرگومان توسط پیونددهنده
تفسیر می‌شود؛ پیونددهندهٔ GNU نام یک نماد یا یک نشانی را می‌پذیرد.
.IP \fB\-pie\fR 4
.IX Item "-pie"
.PD 0
.IP \fB\-\-pie\fR 4
.IX Item "--pie"
.PD
در مقصدهایی که پشتیبانی می‌کنند، یک فایل اجرایی مستقل از موقعیت به‌صورت پویا
پیوندخورده تولید می‌کند. برای دستیابی به نتایج قابل پیش‌بینی، هنگام مشخص کردن این
گزینهٔ پیونددهنده باید همان مجموعه گزینه‌های استفاده شده در زمان کامپایل
(\fB\-fpie\fR، \fB\-fPIE\fR، یا زیرگزینه‌های مربوط به مدل) را نیز مشخص کنید.
.IP \fB\-no\-pie\fR 4
.IX Item "-no-pie"
فایل اجرایی مستقل از موقعیت به‌صورت پویا پیوندخورده تولید نکن.
.IP \fB\-static\-pie\fR 4
.IX Item "-static-pie"
.PD 0
.IP \fB\-\-static\-pie\fR 4
.IX Item "--static-pie"
.PD
در مقصدهایی که پشتیبانی می‌کنند، یک فایل اجرایی مستقل از موقعیت ایستا تولید می‌کند.
یک فایل اجرایی مستقل از موقعیت ایستا شبیه به فایل اجرایی ایستا است، اما می‌تواند
بدون نیاز به پیونددهندهٔ پویا در هر نشانی‌ای بارگذاری شود. برای دستیابی به نتایج قابل
پیش‌بینی، هنگام مشخص کردن این گزینهٔ پیونددهنده باید همان مجموعه گزینه‌های استفاده
شده در زمان کامپایل (\fB\-fpie\fR، \fB\-fPIE\fR، یا زیرگزینه‌های مربوط به مدل) را نیز مشخص کنید.
.IP \fB\-pthread\fR 4
.IX Item "-pthread"
با کتابخانهٔ ریسه‌های POSIX پیوند برقرار می‌کند. این گزینه در مقصدهای GNU/Linux،
بیشتر مشتقات یونیکس و همچنین مقصدهای x86 Cygwin و MinGW پشتیبانی می‌شود. در برخی
مقصدها این گزینه پرچم‌هایی را نیز برای پیش‌پردازنده تنظیم می‌کند، بنابراین باید به‌طور پیوسته
هم برای کامپایل و هم برای پیونددهی استفاده شود.
.IP \fB\-r\fR 4
.IX Item "-r"
یک شیء جابه‌جاشدنی را به‌عنوان خروجی تولید می‌کند. این عمل با نام پیونددهی جزئی
نیز شناخته می‌شود.
.IP \fB\-rdynamic\fR 4
.IX Item "-rdynamic"
پرچم \fB\-export\-dynamic\fR را به پیونددهندهٔ ELF در مقصدهایی که از آن پشتیبانی می‌کنند،
ارسال می‌کند. این کار به پیونددهنده دستور می‌دهد که همهٔ نمادها را، نه فقط نمادهای
استفاده‌شده، به جدول نمادهای پویا اضافه کند. این گزینه برای برخی از موارد استفاده
از \f(CW\*(C`dlopen\*(C'\fR یا برای امکان دریافت ردیابی پشته (backtrace) از درون برنامه مورد نیاز است.
.IP \fB\-s\fR 4
.IX Item "-s"
تمام جدول نمادها و اطلاعات جابه‌جایی را از فایل اجرایی حذف می‌کند.
.IP \fB\-static\fR 4
.IX Item "-static"
.PD 0
.IP \fB\-\-static\fR 4
.IX Item "--static"
.PD
در سامانه‌هایی که از پیوند پویا پشتیبانی می‌کنند، این گزینه اثر \fB\-pie\fR را لغو کرده
و از پیوند با کتابخانه‌های مشترک جلوگیری می‌کند. در سایر سامانه‌ها، این گزینه
هیچ اثری ندارد.
.IP \fB\-shared\fR 4
.IX Item "-shared"
.PD 0
.IP \fB\-\-shared\fR 4
.IX Item "--shared"
.PD
یک شیء مشترک (shared object) تولید می‌کند که می‌تواند با سایر اشیاء پیوند خورده و یک فایل
اجرایی را تشکیل دهد. همهٔ سامانه‌ها از این گزینه پشتیبانی نمی‌کنند. برای نتایج قابل پیش‌بینی،
هنگام مشخص کردن این گزینهٔ پیونددهنده باید همان مجموعه گزینه‌های استفاده شده در زمان کامپایل
(\fB\-fpic\fR، \fB\-fPIC\fR، یا زیرگزینه‌های مدل) را نیز مشخص کنید.[1]
.IP \fB\-shared\-libgcc\fR 4
.IX Item "-shared-libgcc"
.PD 0
.IP \fB\-static\-libgcc\fR 4
.IX Item "-static-libgcc"
.PD
در سامانه‌هایی که \fIlibgcc\fR را به‌صورت یک کتابخانهٔ مشترک ارائه می‌دهند، این گزینه‌ها
به ترتیب استفاده از نسخهٔ مشترک یا ایستا را اجبار می‌کنند. اگر هنگام پیکربندی
کامپایلر هیچ نسخهٔ مشترکی از \fIlibgcc\fR ساخته نشده باشد، این گزینه‌ها هیچ اثری ندارند.
.Sp
موقعیت‌های گوناگونی وجود دارد که در آن‌ها یک برنامهٔ کاربردی باید به‌جای نسخهٔ ایستا،
از نسخهٔ مشترک \fIlibgcc\fR استفاده کند. رایج‌ترین آن‌ها زمانی است که برنامه قصد پرتاب (throw)
و گرفتن (catch) استثناها را در میان کتابخانه‌های مشترک مختلف دارد. در این حالت، هر یک
از کتابخانه‌ها و همچنین خود برنامه باید از \fIlibgcc\fR مشترک استفاده کنند.
.Sp
بنابراین، راه‌انداز G++ هر زمان که یک کتابخانهٔ مشترک یا یک فایل اجرایی اصلی بسازید،
به‌طور خودکار \fB\-shared\-libgcc\fR را اضافه می‌کند، زیرا برنامه‌های C++ معمولاً از استثناها
استفاده می‌کنند و این تصمیم درستی است.
.Sp
اگر در عوض، از راه‌انداز GCC برای ساخت کتابخانه‌های مشترک استفاده کنید، ممکن است متوجه
شوید که آن‌ها همیشه با \fIlibgcc\fR مشترک پیوند داده نمی‌شوند. اگر GCC در زمان پیکربندی خود
تشخیص دهد که شما پیونددهندهٔ غیر گنو دارید یا پیونددهندهٔ گنویی دارید که از گزینهٔ
\fB\-\-eh\-frame\-hdr\fR پشتیبانی نمی‌کند، به‌طور پیش‌فرض نسخهٔ مشترک \fIlibgcc\fR را
درون کتابخانه‌های مشترک پیوند می‌دهد. در غیر این صورت، از امکانات پیونددهنده بهره گرفته
و پیوند با نسخهٔ مشترک \fIlibgcc\fR را حذف و بهینه‌سازی می‌کند، و به‌طور پیش‌فرض با نسخهٔ
ایستای libgcc پیوند برقرار می‌کند. این امر اجازه می‌دهد تا استثناها بدون تحمیل هزینه‌های
جابه‌جایی در هنگام بارگذاری کتابخانه، در میان چنین کتابخانه‌های مشترکی انتشار یابند.
.Sp
با این حال، اگر قرار است یک کتابخانه یا فایل اجرایی اصلی استثنایی را پرتاب کند یا بگیرد،
باید آن را با استفاده از راه‌انداز G++، یا با استفاده از گزینهٔ \&\fB\-shared\-libgcc\fR پیوند دهید،
تا با \&\fIlibgcc\fR مشترک پیوند یابد.
.IP \fB\-static\-libasan\fR 4
.IX Item "-static-libasan"
هنگامی که گزینهٔ \fB\-fsanitize=address\fR برای پیوند یک برنامه استفاده می‌شود،
راه‌انداز GCC به‌طور خودکار با \fBlibasan\fR پیوند برقرار می‌کند. اگر \&\fIlibasan\fR
به‌صورت کتابخانهٔ مشترک در دسترس باشد و گزینهٔ \fB\-static\fR استفاده نشده باشد، پیوند
با نسخهٔ مشترک \&\fIlibasan\fR انجام می‌شود. گزینهٔ \fB\-static\-libasan\fR راه‌انداز GCC
را هدایت می‌کند تا \fIlibasan\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-static\-libhwasan\fR 4
.IX Item "-static-libhwasan"
هنگامی که گزینهٔ \fB\-fsanitize=hwaddress\fR برای پیوند یک برنامه استفاده می‌شود،
راه‌انداز GCC به‌طور خودکار با \fBlibhwasan\fR پیوند برقرار می‌کند. اگر \&\fIlibhwasan\fR
به‌صورت کتابخانهٔ مشترک در دسترس باشد و گزینهٔ \fB\-static\fR استفاده نشده باشد، پیوند
با نسخهٔ مشترک \&\fIlibhwasan\fR انجام می‌شود. گزینهٔ \fB\-static\-libhwasan\fR راه‌انداز GCC
را هدایت می‌کند تا \fIlibhwasan\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-static\-liblsan\fR 4
.IX Item "-static-liblsan"
هنگامی که گزینهٔ \fB\-fsanitize=leak\fR برای پیوند یک برنامه استفاده می‌شود،
راه‌انداز GCC به‌طور خودکار با \fBliblsan\fR پیوند برقرار می‌کند. اگر \&\fIliblsan\fR
به‌صورت کتابخانهٔ مشترک در دسترس باشد و گزینهٔ \fB\-static\fR استفاده نشده باشد، پیوند
با نسخهٔ مشترک \&\fIliblsan\fR انجام می‌شود. گزینهٔ \fB\-static\-liblsan\fR راه‌انداز GCC
را هدایت می‌کند تا \fIliblsan\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-static\-libtsan\fR 4
.IX Item "-static-libtsan"
هنگامی که گزینهٔ \fB\-fsanitize=thread\fR برای پیوند یک برنامه استفاده می‌شود،
راه‌انداز GCC به‌طور خودکار با \fBlibtsan\fR پیوند برقرار می‌کند. اگر \&\fIlibtsan\fR
به‌صورت کتابخانهٔ مشترک در دسترس باشد و گزینهٔ \fB\-static\fR استفاده نشده باشد، پیوند
با نسخهٔ مشترک \&\fIlibtsan\fR انجام می‌شود. گزینهٔ \fB\-static\-libtsan\fR راه‌انداز GCC
را هدایت می‌کند تا \fIlibtsan\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-static\-libubsan\fR 4
.IX Item "-static-libubsan"
هنگامی که گزینهٔ \fB\-fsanitize=undefined\fR برای پیوند یک برنامه استفاده می‌شود،
راه‌انداز GCC به‌طور خودکار با \fBlibubsan\fR پیوند برقرار می‌کند. اگر \&\fIlibubsan\fR
به‌صورت کتابخانهٔ مشترک در دسترس باشد و گزینهٔ \fB\-static\fR استفاده نشده باشد، پیوند
با نسخهٔ مشترک \&\fIlibubsan\fR انجام می‌شود. گزینهٔ \fB\-static\-libubsan\fR راه‌انداز GCC
را هدایت می‌کند تا \fIlibubsan\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-static\-libstdc++\fR 4
.IX Item "-static-libstdc++"
هنگامی که برنامهٔ \fBg++\fR برای پیوند یک برنامهٔ C++ استفاده می‌شود، معمولاً
به‌طور خودکار با \fBlibstdc++\fR پیوند برقرار می‌کند. اگر \&\fIlibstdc++\fR به‌عنوان یک
کتابخانهٔ مشترک در دسترس باشد و از گزینهٔ \&\fB\-static\fR استفاده نشود، پیوند با
نسخهٔ مشترک \fIlibstdc++\fR انجام می‌شود. این حالت معمولاً مناسب است. با این حال،
گاهی اوقات مفید است که نسخهٔ \fIlibstdc++\fR استفاده‌شده توسط برنامه را بدون نیاز
به یک پیوند کاملاً ایستا تثبیت کنید. گزینهٔ \&\fB\-static\-libstdc++\fR راه‌انداز \fBg++\fR را
هدایت می‌کند تا \fIlibstdc++\fR را به‌صورت ایستا پیوند دهد، بدون آنکه لزوماً سایر
کتابخانه‌ها به‌صورت ایستا پیوند داده شوند.
.IP \fB\-symbolic\fR 4
.IX Item "-symbolic"
.PD 0
.IP \fB\-\-symbolic\fR 4
.IX Item "--symbolic"
.PD
هنگام ساخت یک شیء مشترک، ارجاعات به نمادهای سراسری را متصل می‌کند. دربارهٔ هرگونه
ارجاع حل‌نشده هشدار می‌دهد (مگر اینکه توسط گزینهٔ ویرایشگر پیوند
\fB\-Xlinker \-z \-Xlinker defs\fR لغو شده باشد). تنها سامانه‌های معدودی از این گزینه پشتیبانی می‌کنند..IP "\fB\-T\fR \fIscript\fR" 4
.IX Item "-T script"
از \fIscript\fR به‌عنوان اسکریپت پیونددهنده (linker script) استفاده می‌کند. این گزینه در بیشتر سیستم‌هایی که از پیونددهندهٔ GNU استفاده می‌کنند پشتیبانی می‌شود. در برخی از مقصدهای هدف (targets)، مانند بردهای خام (bare\-board) فاقد سیستم‌عامل، ممکن است گزینهٔ \fB\-T\fR هنگام پیوند دادن برای جلوگیری از ارجاع به نمادهای تعریف‌نشده الزامی باشد.
.IP "\fB\-Xlinker\fR \fIoption\fR" 4
.IX Item "-Xlinker option"
گزینهٔ \fIoption\fR را به‌عنوان گزینه‌ای به پیونددهنده ارسال می‌کند. می‌توانید از این مورد برای ارسال گزینه‌های مختص سیستمی به پیونددهنده استفاده کنید که GCC آن‌ها را نمی‌شناسد.
.Sp
اگر می‌خواهید گزینه‌ای را ارسال کنید که آرگومانی جداگانه دریافت می‌کند، باید دوبار از \&\fB\-Xlinker\fR استفاده کنید؛ یک‌بار برای گزینه و یک‌بار برای آرگومان. برای مثال، جهت ارسال \fB\-assert definitions\fR، باید \&\fB\-Xlinker \-assert \-Xlinker definitions\fR را بنویسید. نوشتن \&\fB\-Xlinker "\-assert definitions"\fR کارساز نخواهد بود، زیرا کل رشته را به‌عنوان یک آرگومان واحد ارسال می‌کند، که چیزی نیست که پیونددهنده انتظار دارد.
.Sp
هنگام استفاده از پیونددهندهٔ GNU، معمولاً راحت‌تر است که آرگومان‌ها با استفاده از نحو \fIoption\fR\fB=\fR\fIvalue\fR به گزینه‌های پیونددهنده ارسال شوند تا به‌صورت آرگومان‌های جداگانه. برای مثال، می‌توانید به‌جای \&\fB\-Xlinker \-Map \-Xlinker output.map\fR عبارت \&\fB\-Xlinker \-Map=output.map\fR را مشخص کنید. پیونددهنده‌های دیگر ممکن است از این نحو برای گزینه‌های خط فرمان پشتیبانی نکنند.
.IP \fB\-Wl,\fR\fIoption\fR 4
.IX Item "-Wl,option"
.PD 0
.IP \fB\-\-for\-linker=\fR\fIoption\fR 4
.IX Item "--for-linker=option"
.IP "\fB\-\-for\-linker\fR \fIoption\fR" 4
.IX Item "--for-linker option"
.PD
گزینهٔ \fIoption\fR را به‌عنوان گزینه‌ای به پیونددهنده ارسال می‌کند. اگر \fIoption\fR شامل ویرگول باشد، بر اساس ویرگول‌ها به چندین گزینه تقسیم می‌شود. می‌توانید از این نحو برای ارسال یک آرگومان به گزینه استفاده کنید. برای مثال، \fB\-Wl,\-Map,output.map\fR گزینهٔ \fB\-Map output.map\fR را به پیونددهنده ارسال می‌کند. هنگام استفاده از پیونددهندهٔ GNU، می‌توانید با \&\fB\-Wl,\-Map=output.map\fR نیز به همین نتیجه دست یابید.
.IP "\fB\-u\fR \fIsymbol\fR" 4
.IX Item "-u symbol"
.PD 0
.IP \fB\-\-force\-link=\fR\fIsymbol\fR 4
.IX Item "--force-link=symbol"
.IP "\fB\-\-force\-link\fR \fIsymbol\fR" 4
.IX Item "--force-link symbol"
.PD
وانمود می‌کند که نماد \fIsymbol\fR تعریف‌نشده است، تا پیونددهی ماژول‌های کتابخانه‌ای را برای تعریف آن اجبار کند. می‌توانید از \fB\-u\fR چندین بار با نمادهای مختلف برای اجبار به بارگذاری ماژول‌های کتابخانه‌ای اضافی استفاده کنید.
.IP \fB\-Tbss=\fR\fIaddr\fR 4
.IX Item "-Tbss=addr"
.PD 0
.IP \fB\-Tdata=\fR\fIaddr\fR 4
.IX Item "-Tdata=addr"
.IP \fB\-Ttext=\fR\fIaddr\fR 4
.IX Item "-Ttext=addr"
.IP \fB\-N\fR 4
.IX Item "-N"
.IP \fB\-n\fR 4
.IX Item "-n"
.IP \fB\-t\fR 4
.IX Item "-t"
.IP \fB\-Z\fR 4
.IX Item "-Z"
.IP "\fB\-z\fR \fIkeyword\fR" 4
.IX Item "-z keyword"
.PD
این گزینه‌ها بدون تفسیر توسط GCC، مستقیماً به پیونددهنده فرستاده می‌شوند. برای اطلاع از معانی این گزینه‌ها به مستندات پیونددهندهٔ خود مراجعه کنید.
.SS "گزینه‌های جستجوی دایرکتوری (Options for Directory Search)"
.IX Subsection "Options for Directory Search"
این گزینه‌ها دایرکتوری‌هایی را برای جستجوی فایل‌های سرآیند (header files)، کتابخانه‌ها و بخش‌هایی از کامپایلر مشخص می‌کنند:
.IP "\fB\-I\fR \fIdir\fR" 4
.IX Item "-I dir"
.PD 0
.IP "\fB\-iquote\fR \fIdir\fR" 4
.IX Item "-iquote dir"
.IP "\fB\-isystem\fR \fIdir\fR" 4
.IX Item "-isystem dir"
.IP "\fB\-idirafter\fR \fIdir\fR" 4
.IX Item "-idirafter dir"
.IP \fB\-\-include\-directory\-after=\fR\fIdir\fR 4
.IX Item "--include-directory-after=dir"
.IP "\fB\-\-include\-directory\-after\fR \fIdir\fR" 4
.IX Item "--include-directory-after dir"
.IP \fB\-\-include\-directory=\fR\fIdir\fR 4
.IX Item "--include-directory=dir"
.IP "\fB\-\-include\-directory\fR \fIdir\fR" 4
.IX Item "--include-directory dir"
.PD
دایرکتوری \fIdir\fR را به فهرست دایرکتوری‌هایی که در طول پیش‌پردازش برای فایل‌های سرآیند جستجو می‌شوند، اضافه می‌کند. گزینهٔ \fB\-\-include\-directory\fR یک نام مستعار برای \fB\-I\fR است، در حالی که \fB\-\-include\-directory\-after\fR یک نام مستعار برای \fB\-idirafter\fR می‌باشد.
اگر \fIdir\fR با \fB=\fR یا \f(CW$SYSROOT\fR شروع شود، علامت \fB=\fR یا \f(CW$SYSROOT\fR با پیشوند sysroot جایگزین می‌شود؛ گزینه‌های \&\fB\-\-sysroot\fR و \fB\-isysroot\fR را ببینید.
.Sp
دایرکتوری‌های مشخص‌شده با \fB\-iquote\fR تنها برای شکل نقل‌قولی دستورالعمل، یعنی \f(CW\*(C`#include\ "\fR\f(CIfile\fR\f(CW"\*(C'\fR اعمال می‌شوند. دایرکتوری‌های مشخص‌شده با \fB\-I\fR، \fB\-isystem\fR یا \fB\-idirafter\fR برای جستجوی هر دو دستورالعمل
\&\f(CW\*(C`#include\ "\fR\f(CIfile\fR\f(CW"\*(C'\fR و
\&\f(CW\*(C`#include\ <\fR\f(CIfile\fR\f(CW>\*(C'\fR اعمال می‌گردند.
.Sp
می‌توانید هر تعداد یا ترکیبی از این گزینه‌ها را در خط فرمان برای جستجوی فایل‌های سرآیند در چندین دایرکتوری مشخص کنید. ترتیب جستجو به صورت زیر است:
.RS 4
.IP 1. 4
.IX Item "1."
برای شکل نقل‌قولی دستورالعمل include، ابتدا دایرکتوری فایل فعلی جستجو می‌شود.
.IP 2. 4
.IX Item "2."
برای شکل نقل‌قولی دستورالعمل include، دایرکتوری‌های مشخص‌شده با گزینه‌های \fB\-iquote\fR به ترتیبی که در خط فرمان ظاهر شده‌اند، از چپ به راست جستجو می‌شوند.
.IP 3. 4
.IX Item "3."
دایرکتوری‌های مشخص‌شده با گزینه‌های \fB\-I\fR از چپ به راست پویش می‌شوند.
.IP 4. 4
.IX Item "4."
دایرکتوری‌های مشخص‌شده با گزینه‌های \fB\-isystem\fR از چپ به راست پویش می‌شوند.
.IP 5. 4
.IX Item "5."
دایرکتوری‌های استاندارد سیستم پویش می‌شوند.
.IP 6. 4
.IX Item "6."
دایرکتوری‌های مشخص‌شده با گزینه‌های \fB\-idirafter\fR از چپ به راست پویش می‌شوند.
.RE
.RS 4
.Sp
می‌توانید از \fB\-I\fR برای بازنویسی (override) یک فایل سرآیند سیستم و جایگزینی نسخهٔ خود استفاده کنید، زیرا این دایرکتوری‌ها پیش از دایرکتوری‌های استاندارد فایل‌های سرآیند سیستم جستجو می‌شوند. با این حال، نباید از این گزینه برای افزودن دایرکتوری‌هایی استفاده کنید که شامل فایل‌های سرآیند سیستم ارائه‌شده توسط توزیع‌کننده هستند؛ برای این منظور از \fB\-isystem\fR استفاده نمایید.
.Sp
گزینه‌های \fB\-isystem\fR و \fB\-idirafter\fR همچنین دایرکتوری را به‌عنوان یک دایرکتوری سیستم علامت‌گذاری می‌کنند، تا همان رفتار ویژه‌ای که برای دایرکتوری‌های استاندارد سیستم اعمال می‌شود برای آن نیز لحاظ گردد.
.Sp
اگر یک دایرکتوری include استاندارد سیستم، یا یک دایرکتوری مشخص‌شده با \&\fB\-isystem\fR، هم‌زمان با \fB\-I\fR نیز مشخص شده باشد، گزینهٔ \fB\-I\fR نادیده گرفته می‌شود. دایرکتوری همچنان جستجو می‌شود اما به‌عنوان یک دایرکتوری سیستم در جایگاه عادی خود در زنجیرهٔ include سیستم. این عمل برای اطمینان از این است که فرایند GCC برای رفع عیب سرآیندهای معیوب سیستم و ترتیب دستورالعمل \f(CW\*(C`#include_next\*(C'\fR به‌طور ناخواسته تغییر نکند.
اگر واقعاً نیاز به تغییر ترتیب جستجوی دایرکتوری‌های سیستم دارید، از گزینه‌های \fB\-nostdinc\fR و/یا \fB\-isystem\fR استفاده کنید.
.RE
.IP \fB\-I\-\fR 4
.IX Item "-I-"
.PD 0
.IP \fB\-\-include\-barrier\fR 4
.IX Item "--include-barrier"
.PD
مسیر include را تفکیک می‌کند.
این گزینه منسوخ شده است. لطفاً به‌جای آن برای دایرکتوری‌های \fB\-I\fR پیش از \fB\-I\-\fR از \fB\-iquote\fR استفاده کرده و گزینهٔ \fB\-I\-\fR را حذف کنید.
.Sp
هر دایرکتوری مشخص‌شده با گزینه‌های \fB\-I\fR قبل از \fB\-I\-\fR، تنها برای سرآیندهای درخواست‌شده با \&\f(CW\*(C`#include\ "\fR\f(CIfile\fR\f(CW"\*(C'\fR جستجو می‌شود؛ آن‌ها برای \&\f(CW\*(C`#include\ <\fR\f(CIfile\fR\f(CW>\*(C'\fR جستجو نمی‌شوند. اگر دایرکتوری‌های بیشتری با گزینه‌های \fB\-I\fR پس از \fB\-I\-\fR مشخص شوند، آن دایرکتوری‌ها برای تمامی دستورالعمل‌های \fB#include\fR جستجو خواهند شد.
.Sp
علاوه بر این، \fB\-I\-\fR مانع استفاده از دایرکتوری فایل فعلی به‌عنوان اولین دایرکتوری جستجو برای \f(CW\*(C`#include\ "\fR\f(CIfile\fR\f(CW"\*(C'\fR می‌شود. هیچ راهی برای باطل کردن این اثر \fB\-I\-\fR وجود ندارد.
.IP "\fB\-iprefix\fR \fIprefix\fR" 4
.IX Item "-iprefix prefix".PD 0
.IP \fB\-\-include\-prefix=\fR\fIprefix\fR 4
.IX Item "--include-prefix=prefix"
.IP "\fB\-\-include\-prefix\fR \fIprefix\fR" 4
.IX Item "--include-prefix prefix"
.PD
مقدار \fIprefix\fR را به عنوان پیشوند برای گزینه‌های بعدی \fB\-iwithprefix\fR مشخص می‌کند. اگر پیشوند نمایانگر یک دایرکتوری باشد، باید \fB/\fR انتهایی را نیز لحاظ کنید.
.IP "\fB\-iwithprefix\fR \fIdir\fR" 4
.IX Item "-iwithprefix dir"
.PD 0
.IP "\fB\-iwithprefixbefore\fR \fIdir\fR" 4
.IX Item "-iwithprefixbefore dir"
.IP \fB\-\-include\-with\-prefix=\fR\fIprefix\fR 4
.IX Item "--include-with-prefix=prefix"
.IP "\fB\-\-include\-with\-prefix\fR \fIprefix\fR" 4
.IX Item "--include-with-prefix prefix"
.IP \fB\-\-include\-with\-prefix\-after=\fR\fIprefix\fR 4
.IX Item "--include-with-prefix-after=prefix"
.IP "\fB\-\-include\-with\-prefix\-after\fR \fIprefix\fR" 4
.IX Item "--include-with-prefix-after prefix"
.IP \fB\-\-include\-with\-prefix\-before=\fR\fIprefix\fR 4
.IX Item "--include-with-prefix-before=prefix"
.IP "\fB\-\-include\-with\-prefix\-before\fR \fIprefix\fR" 4
.IX Item "--include-with-prefix-before prefix"
.PD
دایرکتوری \fIdir\fR را به پیشوندی که قبلاً با \&\fB\-iprefix\fR مشخص شده اضافه می‌کند و دایرکتوری حاصل را به مسیر جستجوی include می‌افزاید. گزینهٔ \fB\-iwithprefixbefore\fR آن را در همان جایگاهی قرار می‌دهد که \fB\-I\fR قرار می‌داد؛ در حالی که \fB\-iwithprefix\fR آن را در جایگاه \fB\-idirafter\fR می‌گذارد.
.Sp
گزینه‌های \&\fB\-\-include\-with\-prefix\fR و \fB\-\-include\-with\-prefix\-after\fR هر دو نام‌های مستعار برای \fB\-iwithprefix\fR هستند، در حالی که \&\fB\-\-include\-with\-prefix\-before\fR نام مستعاری برای \&\fB\-iwithprefixbefore\fR است.
.IP "\fB\-isysroot\fR \fIdir\fR" 4
.IX Item "-isysroot dir"
این گزینه شبیه گزینهٔ \fB\-\-sysroot\fR است، اما تنها برای فایل‌های سرآیند اعمال می‌شود (به‌جز در هدف‌های Darwin، که در آن هم برای فایل‌های سرآیند و هم برای کتابخانه‌ها اعمال می‌شود). برای اطلاعات بیشتر گزینهٔ \fB\-\-sysroot\fR را ببینید.
.IP "\fB\-imultilib\fR \fIdir\fR" 4
.IX Item "-imultilib dir"
از \fIdir\fR به عنوان یک زیردایرکتوری از دایرکتوریِ حاوی سرآیندهای ++C مختص هدف استفاده می‌کند.
.IP "\fB\-imultiarch\fR \fIdir\fR" 4
.IX Item "-imultiarch dir"
از \fIdir\fR به عنوان یک زیردایرکتوری از دایرکتوریِ حاوی سرآیندهای ++C مختص معماری استفاده می‌کند.
.IP \fB\-nostdinc\fR 4
.IX Item "-nostdinc"
.PD 0
.IP \fB\-\-no\-standard\-includes\fR 4
.IX Item "--no-standard-includes"
.PD
دایرکتوری‌های استاندارد سیستم را برای فایل‌های سرآیند جستجو نمی‌کند. تنها دایرکتوری‌هایی که صراحتاً با گزینه‌های \fB\-I\fR، \&\fB\-iquote\fR، \fB\-isystem\fR و/یا \fB\-idirafter\fR مشخص شده‌اند (و در صورت مناسب بودن، دایرکتوریِ فایل جاری) جستجو می‌شوند.
.IP \fB\-nostdinc++\fR 4
.IX Item "-nostdinc++"
فایل‌های سرآیند را در دایرکتوری‌های استاندارد مختص ++C جستجو نمی‌کند، اما سایر دایرکتوری‌های استاندارد را همچنان جستجو می‌کند. (این گزینه هنگام ساخت کتابخانهٔ ++C استفاده می‌شود.)
.IP \fB\-\-embed\-dir=\fR\fIdir\fR 4
.IX Item "--embed-dir=dir"
.PD 0
.IP \fB\-\-embed\-directory=\fR\fIdir\fR 4
.IX Item "--embed-directory=dir"
.IP "\fB\-\-embed\-directory\fR \fIdir\fR" 4
.IX Item "--embed-directory dir"
.PD
دایرکتوری \fIdir\fR را به فهرست دایرکتوری‌های جستجو برای دستور پیش‌پردازندهٔ \&\f(CW\*(C`#embed\*(C'\fR یا ماکروی \f(CW\*(C`_\|_has_embed\*(C'\fR می‌افزاید. هیچ دایرکتوری پیش‌فرضی برای \f(CW\*(C`#embed\*(C'\fR وجود ندارد.
.Sp
اگر \fIdir\fR با \fB=\fR یا \f(CW$SYSROOT\fR آغاز شود، آنگاه \fB=\fR یا \f(CW$SYSROOT\fR با پیشوند sysroot جایگزین می‌شود؛ گزینه‌های \&\fB\-\-sysroot\fR و \fB\-isysroot\fR را ببینید.
.IP \fB\-iplugindir=\fR\fIdir\fR 4
.IX Item "-iplugindir=dir"
دایرکتوری مورد نظر برای جستجوی افزونه‌هایی (plugins) که به جای \&\fB\-fplugin=\fR\fIpath\fR\fB/\fR\fIname\fR\fB.so\fR با \fB\-fplugin=\fR\fIname\fR مشخص می‌شوند را تعیین می‌کند. این گزینه برای استفادهٔ مستقیم کاربر در نظر گرفته نشده است، بلکه فقط توسط گرداننده (driver) ارسال می‌شود.
.IP \fB\-L\fR\fIdir\fR 4
.IX Item "-Ldir"
.PD 0
.IP \fB\-\-library\-directory=\fR\fIdir\fR 4
.IX Item "--library-directory=dir"
.IP "\fB\-\-library\-directory\fR \fIdir\fR" 4
.IX Item "--library-directory dir"
.PD
دایرکتوری \fIdir\fR را به فهرست دایرکتوری‌هایی که برای \fB\-l\fR جستجو می‌شوند اضافه می‌کند.
.IP \fB\-B\fR\fIprefix\fR 4
.IX Item "-Bprefix"
.PD 0
.IP \fB\-\-prefix=\fR\fIprefix\fR 4
.IX Item "--prefix=prefix"
.IP "\fB\-\-prefix\fR \fIprefix\fR" 4
.IX Item "--prefix prefix"
.PD
این گزینه مشخص می‌کند فایل‌های اجرایی، کتابخانه‌ها، فایل‌های include و فایل‌های داده‌ایِ خود کامپایلر در کجا پیدا شوند.
.Sp
برنامهٔ گردانندهٔ کامپایلر یک یا چند زیربرنامه از قبیل \&\fBcpp\fR، \fBcc1\fR، \fBas\fR و \fBld\fR را اجرا می‌کند. این برنامه \&\fIprefix\fR را به عنوان پیشوند برای هر برنامه‌ای که سعی در اجرای آن دارد، هم همراه با \fImachine\fR\fB/\fR\fIversion\fR\fB/\fR و هم بدون آن برای ماشین هدف و نسخهٔ کامپایلر مربوطه، امتحان می‌کند.
.Sp
برای هر زیربرنامه‌ای که قرار است اجرا شود، گردانندهٔ کامپایلر ابتدا پیشوند \&\fB\-B\fR (در صورت وجود) را امتحان می‌کند. اگر آن نام پیدا نشود، یا اگر \fB\-B\fR مشخص نشده باشد، گرداننده دو پیشوند استاندارد \&\fI/usr/lib/gcc/\fR و \fI/usr/local/lib/gcc/\fR را امتحان می‌کند. اگر هیچ‌یک از آن‌ها به نام فایلی پیدا شده منتهی نشود، نام دست‌نخوردهٔ برنامه با استفاده از دایرکتوری‌های مشخص‌شده در متغیر محیطی \&\fBPATH\fR شما جستجو می‌شود.
.Sp
کامپایلر بررسی می‌کند که آیا مسیر ارائه‌شده توسط \fB\-B\fR به یک دایرکتوری اشاره دارد یا خیر، و در صورت لزوم یک نویسهٔ جداکنندهٔ دایرکتوری را به انتهای مسیر اضافه می‌کند.
.Sp
پیشوندهای \&\fB\-B\fR که عملاً نام دایرکتوری‌ها را مشخص می‌کنند، برای کتابخانه‌ها در پیونددهنده نیز اعمال می‌شوند، زیرا کامپایلر این گزینه‌ها را به گزینه‌های \fB\-L\fR برای پیونددهنده ترجمه می‌کند. آن‌ها همچنین برای فایل‌های include در پیش‌پردازنده نیز اعمال می‌شوند، زیرا کامپایلر این گزینه‌ها را به گزینه‌های \fB\-isystem\fR برای پیش‌پردازنده ترجمه می‌کند. در این حالت، کامپایلر عبارت \fBinclude\fR را به پیشوند پیوست می‌کند.
.Sp
فایل پشتیبانی زمان اجرای \fIlibgcc.a\fR نیز در صورت نیاز می‌تواند با استفاده از پیشوند \fB\-B\fR جستجو شود. اگر در آنجا یافت نشد، دو پیشوند استاندارد فوق امتحان می‌شوند، و تمام. اگر این فایل با این روش‌ها یافت نشود، از فرایند پیوند کنار گذاشته می‌شود.
.Sp
راه دیگر برای مشخص کردن پیشوندی بسیار شبیه به پیشوند \fB\-B\fR، استفاده از متغیر محیطی \fBGCC_EXEC_PREFIX\fR است.
.Sp
به عنوان یک راهکار موقتِ ویژه (kludge)، اگر مسیر ارائه‌شده توسط \fB\-B\fR به صورت \&\fI[dir/]stageN/\fR باشد که در آن \fIN\fR عددی در محدودهٔ 0 تا 9 است، با \fI[dir/]include\fR جایگزین می‌شود. این کار برای کمک به خودراه‌اندازی (boot\-strapping) کامپایلر است.
.IP \fB\-no\-canonical\-prefixes\fR 4
.IX Item "-no-canonical-prefixes"
.PD 0
.IP \fB\-\-no\-canonical\-prefixes\fR 4
.IX Item "--no-canonical-prefixes"
.PD
پیوندهای نمادین را بسط نمی‌دهد، ارجاعات به \fB/../\fR یا \fB/./\fR را حل‌وفصل نمی‌کند، و هنگام تولید یک پیشوند نسبی مسیر را مطلق نمی‌سازد.
.IP \fB\-\-sysroot=\fR\fIdir\fR 4
.IX Item "--sysroot=dir"
.PD 0
.IP "\fB\-\-sysroot\fR \fIdir\fR" 4
.IX Item "--sysroot dir"
.PD
از \fIdir\fR به عنوان دایرکتوری ریشهٔ منطقی برای سرآیندها و کتابخانه‌ها استفاده می‌کند. برای مثال، اگر کامپایلر در حالت عادی برای سرآیندها در \&\fI/usr/include\fR و برای کتابخانه‌ها در \fI/usr/lib\fR جستجو می‌کند، در عوض \fIdir/usr/include\fR و \fIdir/usr/lib\fR را جستجو خواهد کرد.
.Sp
اگر هم از این گزینه و هم از گزینهٔ \fB\-isysroot\fR استفاده کنید، آنگاه گزینهٔ \fB\-\-sysroot\fR برای کتابخانه‌ها اعمال می‌شود، اما گزینهٔ \&\fB\-isysroot\fR برای فایل‌های سرآیند اعمال می‌گردد.
.Sp
پیونددهندهٔ گنو (GNU linker) (با شروع از نسخهٔ 2.16) پشتیبانی لازم را برای این گزینه دارد. اگر پیونددهندهٔ شما از این گزینه پشتیبانی نکند، جنبهٔ فایل سرآیند \fB\-\-sysroot\fR همچنان کار می‌کند، اما جنبهٔ کتابخانهٔ آن کار نخواهد کرد.
.IP \fB\-\-no\-sysroot\-suffix\fR 4
.IX Item "--no-sysroot-suffix"
برای برخی از هدف‌ها، بسته به سایر گزینه‌های استفاده‌شده، پسوندی به دایرکتوری ریشهٔ مشخص‌شده با \fB\-\-sysroot\fR افزوده می‌شود، به طوری که سرآیندها ممکن است برای مثال به جای \&\fIdir/usr/include\fR در \&\fIdir/suffix/usr/include\fR پیدا شوند. این گزینه اضافه شدن چنین پسوندی را غیرفعال می‌کند..SS "گزینه‌های قراردادهای تولید کد (Options for Code Generation Conventions)"
.IX Subsection "Options for Code Generation Conventions"
این گزینه‌های مستقل از ماشین، قراردادهای رابط مورد استفاده در تولید کد را کنترل می‌کنند.
.PP
اکثر آن‌ها دارای هر دو فرم مثبت و منفی هستند؛ فرم منفی \fB\-ffoo\fR به‌صورت \fB\-fno\-foo\fR است. در جدول زیر، تنها یکی از فرم‌ها فهرست شده است\-\-\-فرمی که پیش‌فرض نیست. شما می‌توانید فرم دیگر را با حذف \fBno\-\fR یا اضافه کردن آن بیابید.
.IP \fB\-fstack\-reuse=\fR\fIreuse\-level\fR 4
.IX Item "-fstack-reuse=reuse-level"
این گزینه استفادهٔ مجدد از فضای پشته را برای متغیرهای محلی/خودکار (local/auto) تعریف‌شده توسط کاربر و متغیرهای موقت تولیدشده توسط کامپایلر کنترل می‌کند. \fIreuse_level\fR می‌تواند \fBall\fR، \&\fBnamed_vars\fR یا \fBnone\fR باشد. مقدار \fBall\fR استفادهٔ مجدد از پشته را برای تمام متغیرهای محلی و متغیرهای موقت فعال می‌کند، \fBnamed_vars\fR استفادهٔ مجدد را تنها برای متغیرهای محلی نام‌دار تعریف‌شده توسط کاربر فعال می‌سازد، و \fBnone\fR استفادهٔ مجدد از پشته را به‌طور کامل غیرفعال می‌کند. مقدار پیش‌فرض \fBall\fR است. این گزینه زمانی مورد نیاز است که برنامه طول عمر یک متغیر محلی در حوزه (scoped) یا متغیر موقت تولیدشده توسط کامپایلر را فراتر از نقطهٔ پایان تعریف‌شده توسط زبان گسترش می‌دهد. هنگامی که طول عمر یک متغیر پایان می‌یابد، و چنانچه آن متغیر در حافظه مقیم باشد، کامپایلر بهینه‌ساز این آزادی عمل را دارد که فضای پشتهٔ آن را برای دیگر متغیرهای موقت یا متغیرهای محلی دارای حوزه‌ای که بازهٔ حیاتشان (live range) با آن هم‌پوشانی ندارد، مجدداً استفاده کند. کدهای قدیمی (legacy) که طول عمر متغیرهای محلی را فراتر می‌برند به احتمال زیاد با بهینه‌سازی استفادهٔ مجدد از پشته دچار شکست می‌شوند.
.Sp
به‌عنوان مثال،
.Sp
.Vb 3
\&           int *p;
\&           {
\&             int local1;
\&        
\&             p = &local1;
\&             local1 = 10;
\&             ....
\&           }
\&           {
\&              int local2;
\&              local2 = 20;
\&              ...
\&           }
\&        
\&           if (*p == 10)  // out of scope use of local1
\&             {
\&        
\&             }
.Ve
.Sp
مثالی دیگر:
.Sp
.Vb 6
\&           struct A
\&           {
\&               A(int k) : i(k), j(k) { }
\&               int i;
\&               int j;
\&           };
\&        
\&           A *ap;
\&        
\&           void foo(const A& ar)
\&           {
\&              ap = &ar;
\&           }
\&        
\&           void bar()
\&           {
\&              foo(A(10)); // temp object\*(Aqs lifetime ends when foo returns
\&        
\&              {
\&                A a(20);
\&                ....
\&              }
\&              ap\->i+= 10;  // ap references out of scope temp whose space
\&                           // is reused with a. What is the value of ap\->i?
\&           }
.Ve
.Sp
طول عمر متغیرهای موقت ایجادشده توسط کامپایلر به‌خوبی توسط استاندارد C++ تعریف شده است. هنگامی که طول عمر یک متغیر موقت به پایان می‌رسد، و در صورتی که آن متغیر موقت در حافظه مقیم باشد، کامپایلر بهینه‌ساز این آزادی عمل را دارد که فضای پشتهٔ آن را با سایر متغیرهای موقت یا متغیرهای محلی دارای حوزه‌ای که بازهٔ حیات آن‌ها با آن هم‌پوشانی ندارد، مجدداً استفاده کند. با این حال برخی از کدهای قدیمی به رفتار کامپایلرهای قدیمی‌تر متکی هستند که در آن‌ها فضای پشتهٔ متغیرهای موقت مجدداً استفاده نمی‌شد؛ بنابراین استفادهٔ مجدد تهاجمی از پشته می‌تواند منجر به خطاهای زمان اجرا شود. از این گزینه برای کنترل بهینه‌سازی استفادهٔ مجدد از پشته برای اشیاء موقت استفاده می‌شود.
.IP \fB\-ftrapv\fR 4
.IX Item "-ftrapv"
این گزینه برای سرریز علامت‌دار در عملیات جمع، تفریق و ضرب تله (trap) ایجاد می‌کند.
گزینه‌های \fB\-ftrapv\fR و \fB\-fwrapv\fR اثر یکدیگر را لغو می‌کنند، بنابراین استفاده از \&\fB\-ftrapv\fR \fB\-fwrapv\fR در خط فرمان منجر به اعمال \&\fB\-fwrapv\fR می‌شود. توجه داشته باشید که تنها گزینه‌های فعال اثر یکدیگر را خنثی می‌کنند، بنابراین استفاده از \fB\-ftrapv\fR \fB\-fwrapv\fR \fB\-fno\-wrapv\fR در خط فرمان منجر به اعمال \fB\-ftrapv\fR خواهد شد.
.IP \fB\-fwrapv\fR 4
.IX Item "-fwrapv"
این گزینه به کامپایلر دستور می‌دهد فرض کند سرریز محاسبات حسابی علامت‌دار در جمع، تفریق و ضرب، با استفاده از نمایش مکمل دو (twos\-complement) دچار چرخش (wrap around) می‌شود. این پرچم برخی بهینه‌سازی‌ها را فعال و برخی دیگر را غیرفعال می‌سازد.
گزینه‌های \fB\-ftrapv\fR و \fB\-fwrapv\fR اثر یکدیگر را لغو می‌کنند، بنابراین استفاده از \&\fB\-ftrapv\fR \fB\-fwrapv\fR در خط فرمان منجر به اعمال \&\fB\-fwrapv\fR می‌شود. توجه داشته باشید که تنها گزینه‌های فعال اثر یکدیگر را خنثی می‌کنند، بنابراین استفاده از \fB\-ftrapv\fR \fB\-fwrapv\fR \fB\-fno\-wrapv\fR در خط فرمان موجب اعمال \fB\-ftrapv\fR خواهد شد.
.IP \fB\-fwrapv\-pointer\fR 4
.IX Item "-fwrapv-pointer"
این گزینه به کامپایلر دستور می‌دهد فرض کند سرریز محاسبات حسابی اشاره‌گرها در جمع و تفریق، با استفاده از نمایش مکمل دو دچار چرخش (wrap around) می‌شود. این پرچم برخی بهینه‌سازی‌ها را که فرض می‌کنند سرریز اشاره‌گر نامعتبر است غیرفعال می‌کند.
.IP \fB\-fstrict\-overflow\fR 4
.IX Item "-fstrict-overflow"
این گزینه شامل \fB\-fno\-wrapv\fR \fB\-fno\-wrapv\-pointer\fR است و در صورت منفی شدن بر \fB\-fwrapv\fR \fB\-fwrapv\-pointer\fR دلالت دارد.
.IP \fB\-fexceptions\fR 4
.IX Item "-fexceptions"
مدیریت استثناها (exception handling) را فعال می‌کند. کدهای اضافی مورد نیاز برای انتشار استثناها را تولید می‌کند. برای برخی از اهداف (targets)، این بدین معناست که GCC اطلاعات بازپیچی قاب (frame unwind) را برای تمام توابع تولید می‌کند که می‌تواند بار سربار قابل‌توجهی در اندازهٔ داده‌ها ایجاد کند، هرچند که بر اجرای برنامه تأثیری ندارد. اگر این گزینه را مشخص نکنید، GCC به‌طور پیش‌فرض آن را برای زبان‌هایی مانند C++ که معمولاً به مدیریت استثنا نیاز دارند فعال کرده و برای زبان‌هایی مانند C که معمولاً به آن نیاز ندارند غیرفعال می‌سازد. با این حال، ممکن است هنگام کامپایل کدهای C که نیازمند تعامل صحیح با گرداننده‌های استثنا (exception handlers) نوشته‌شده در C++ هستند، نیاز به فعال کردن این گزینه داشته باشید. همچنین ممکن است در صورت کامپایل برنامه‌های قدیمی‌تر C++ که از مدیریت استثنا استفاده نمی‌کنند، تمایل داشته باشید این گزینه را غیرفعال کنید.
.IP \fB\-fnon\-call\-exceptions\fR 4
.IX Item "-fnon-call-exceptions"
کدی تولید می‌کند که به دستورالعمل‌های تله‌انداز (trapping) اجازه می‌دهد استثنا پرتاب کنند. توجه داشته باشید که این امر نیازمند پشتیبانی زمان اجرای مختص هر پلتفرم است که در همه جا وجود ندارد. علاوه بر این، این گزینه تنها به دستورالعمل‌های \fIتله‌انداز\fR اجازهٔ پرتاب استثنا می‌دهد، یعنی ارجاعات حافظه یا دستورالعمل‌های ممیز شناور. این ویژگی اجازه نمی‌دهد استثناها از گرداننده‌های سیگنال دلخواه نظیر \f(CW\*(C`SIGALRM\*(C'\fR پرتاب شوند. این گزینه \&\fB\-fexceptions\fR را فعال می‌سازد.
.IP \fB\-fdelete\-dead\-exceptions\fR 4
.IX Item "-fdelete-dead-exceptions"
فرض می‌کند دستورالعمل‌هایی که ممکن است استثنا پرتاب کنند اما در غیر این صورت نقشی در اجرای برنامه ندارند، می‌توانند از طریق بهینه‌سازی حذف شوند. این گزینه بر فراخوانی توابع تأثیری نمی‌گذارد مگر توابعی که دارای مشخصه‌های \&\f(CW\*(C`pure\*(C'\fR یا \f(CW\*(C`const\*(C'\fR باشند.
این گزینه به‌طور پیش‌فرض برای کامپایلرهای Ada و C++، همان‌طور که مشخصات این زبان‌ها مجاز دانسته‌اند، فعال است.
مراحل بهینه‌سازی که موجب حذف استثناهای مرده می‌شوند، به‌طور مستقل در سطوح مختلف بهینه‌سازی فعال می‌گردند.
.IP \fB\-funwind\-tables\fR 4
.IX Item "-funwind-tables"
مشابه \fB\-fexceptions\fR است، با این تفاوت که تنها داده‌های ایستای مورد نیاز را تولید کرده و به‌هیچ‌وجه دیگر بر کد تولیدشده تأثیر نمی‌گذارد. معمولاً نیازی به فعال کردن این گزینه ندارید؛ در عوض، پردازشگر زبانی که به این سازوکار نیاز دارد، آن را از جانب شما فعال می‌کند.
.IP \fB\-fasynchronous\-unwind\-tables\fR 4
.IX Item "-fasynchronous-unwind-tables"
در صورت پشتیبانی ماشین هدف، جدول بازپیچی را در قالب DWARF تولید می‌کند. این جدول در هر مرز دستورالعمل دقیق است، بنابراین می‌تواند برای بازپیچی پشته ناشی از رویدادهای ناهمگام (نظیر اشکال‌زدا یا زباله‌روب) استفاده شود.
.IP \fB\-fno\-gnu\-unique\fR 4
.IX Item "-fno-gnu-unique"
در سیستم‌هایی با اسمبلر GNU و کتابخانهٔ C جدید، کامپایلر C++ از پیوند \f(CW\*(C`STB_GNU_UNIQUE\*(C'\fR استفاده می‌کند تا اطمینان یابد که تعاریف اعضای داده‌ای ایستای الگوها (template) و متغیرهای محلی ایستا در توابع برخط (inline) حتی در حضور \f(CW\*(C`RTLD_LOCAL\*(C'\fR نیز یکتا هستند؛ این امر برای جلوگیری از بروز مشکلاتی لازم است که در آن‌ها کتابخانه‌ای مورد استفاده توسط دو پلاگین مختلف \f(CW\*(C`RTLD_LOCAL\*(C'\fR، وابسته به تعریفی در یکی از آن‌ها بوده و بنابراین با دیگری در مورد پیوند نماد دچار تضاد می‌شود. اما این امر باعث می‌شود \f(CW\*(C`dlclose\*(C'\fR برای DSOهای تحت‌تأثیر نادیده گرفته شود؛ اگر برنامهٔ شما به مقداردهی اولیهٔ مجدد یک DSO از طریق \f(CW\*(C`dlclose\*(C'\fR و \f(CW\*(C`dlopen\*(C'\fR متکی است، می‌توانید از \&\fB\-fno\-gnu\-unique\fR استفاده کنید.
.IP \fB\-fpcc\-struct\-return\fR 4
.IX Item "-fpcc-struct-return"
مقادیر «کوتاه» \f(CW\*(C`struct\*(C'\fR و \f(CW\*(C`union\*(C'\fR را مانند ساختارهای بلندتر در حافظه برمی‌گرداند، نه در ثبات‌ها. این قرارداد کارایی کمتری دارد، اما این مزیت را دارد که اجازهٔ قابلیت فراخوانی متقابل میان فایل‌های کامپایل‌شده با GCC و فایل‌های کامپایل‌شده با سایر کامپایلرها، به‌ویژه Portable C Compiler (pcc) را فراهم می‌کند.
.Sp
قرارداد دقیق برای بازگرداندن ساختارها در حافظه به ماکروهای پیکربندی هدف وابسته است.
.Sp
ساختارها و اجتماعات (unions) کوتاه مواردی هستند که اندازه و هم‌ترازی (alignment) آن‌ها با یک نوع عدد صحیح مطابقت دارد.
.Sp
\&\fBهشدار:\fR کدی که با گزینهٔ \fB\-fpcc\-struct\-return\fR کامپایل شده باشد از نظر باینری با کدی که با گزینهٔ \&\fB\-freg\-struct\-return\fR کامپایل شده سازگار نیست. از آن برای تطابق با یک رابط باینری کاربردی (ABI) غیرپیش‌فرض استفاده کنید..IP \fB\-freg\-struct\-return\fR 4
.IX Item "-freg-struct-return"
در صورت امکان، مقادیر \f(CW\*(C`struct\*(C'\fR و \f(CW\*(C`union\*(C'\fR را در ثبات‌ها بازمی‌گرداند.
این روش برای ساختارهای کوچک کارآمدتر از
\&\fB\-fpcc\-struct\-return\fR است.
.Sp
اگر نه \fB\-fpcc\-struct\-return\fR و نه
\&\fB\-freg\-struct\-return\fR را مشخص نکنید، پیش‌فرض GCC هر قراردادی خواهد بود که
برای معماری مقصد استاندارد است. اگر هیچ قرارداد استانداردی وجود نداشته باشد، پیش‌فرض GCC
بر روی \fB\-fpcc\-struct\-return\fR قرار می‌گیرد، به جز در مقصدهایی که GCC
کامپایلر اصلی است. در آن موارد، می‌توانیم استاندارد را انتخاب کنیم و
گزینهٔ کارآمدترِ بازگردانی در ثبات را برگزیده‌ایم.
.Sp
\&\fBهشدار:\fR کدی که با سوییچ \fB\-freg\-struct\-return\fR
کامپایل شده باشد از نظر باینری با کدی که با سوییچ
\&\fB\-fpcc\-struct\-return\fR کامپایل شده سازگار نیست.
از آن برای انطباق با یک رابط باینری کاربردی (ABI) غیرپیش‌فرض استفاده کنید.
.IP \fB\-fshort\-enums\fR 4
.IX Item "-fshort-enums"
برای یک نوع \f(CW\*(C`enum\*(C'\fR تنها به اندازه‌ای بایت تخصیص می‌دهد که برای
محدودهٔ مقادیر ممکنِ اعلان‌شده نیاز دارد. به‌طور خاص، نوع \f(CW\*(C`enum\*(C'\fR
معادل کوچک‌ترین نوع عدد صحیحی خواهد بود که فضای کافی داشته باشد.
این گزینه برای یک نوع شمارشی با نوعِ زیرینِ ثابت هیچ تأثیری ندارد.
.Sp
\&\fBهشدار:\fR سوییچ \fB\-fshort\-enums\fR باعث می‌شود GCC کدی تولید کند
که از نظر باینری با کد تولیدشده بدون این سوییچ سازگار نیست.
از آن برای انطباق با یک رابط باینری کاربردی (ABI) غیرپیش‌فرض استفاده کنید.
.IP \fB\-fshort\-wchar\fR 4
.IX Item "-fshort-wchar"
نوع زیرین برای \f(CW\*(C`wchar_t\*(C'\fR را بازنویسی می‌کند تا به جای حالت پیش‌فرض برای مقصد،
برابر با \f(CW\*(C`short unsigned int\*(C'\fR باشد. این گزینه
برای ساخت برنامه‌هایی که قرار است تحت WINE اجرا شوند مفید است.
.Sp
\&\fBهشدار:\fR سوییچ \fB\-fshort\-wchar\fR باعث می‌شود GCC کدی تولید کند
که از نظر باینری با کد تولیدشده بدون این سوییچ سازگار نیست.
از آن برای انطباق با یک رابط باینری کاربردی (ABI) غیرپیش‌فرض استفاده کنید.
.IP \fB\-fcommon\fR 4
.IX Item "-fcommon"
در کد C، این گزینه نحوهٔ جای‌گذاری متغیرهای سراسریِ تعریف‌شده بدون مقدار اولیه‌ساز را که در استاندارد C به عنوان \fIتعریف‌های آزمایشی\fR (tentative definitions)
شناخته می‌شوند، کنترل می‌کند. تعریف‌های آزمایشی از اعلان‌های متغیر با
کلمه کلیدی \f(CW\*(C`extern\*(C'\fR، که فضایی تخصیص نمی‌دهند، متمایز هستند.
.Sp
حالت پیش‌فرض \fB\-fno\-common\fR است، که مشخص می‌کند کامپایلر متغیرهای سراسریِ
مقداردهی‌نشده را در بخش BSS فایل شیء قرار می‌دهد.
این کار مانع از ادغام تعریف‌های آزمایشی توسط پیونددهنده می‌شود؛ بنابراین اگر متغیر یکسانی به‌طور
تصادفی در بیش از یک واحد کامپایل تعریف شده باشد، با خطای multiple\-definition مواجه می‌شوید.
.Sp
گزینهٔ \fB\-fcommon\fR متغیرهای سراسری مقداردهی‌نشده را در یک بلوک مشترک قرار می‌دهد.
این به پیونددهنده امکان می‌دهد همهٔ تعریف‌های آزمایشی از یک متغیر یکسان در واحدهای مختلف کامپایل را
به همان شیء، یا به یک تعریف غیرآزمایشی ارجاع دهد و حل کند. این رفتار با C++ ناسازگار است،
و در بسیاری از مقاصد جریمه‌ای در سرعت و اندازهٔ کد هنگام ارجاع به متغیرهای سراسری به همراه دارد. کاربرد
اصلی آن، امکان پیوند دادن کدهای قدیمی بدون رخ دادن خطا است.
.IP \fB\-fno\-ident\fR 4
.IX Item "-fno-ident"
.PD 0
.IP \fB\-Qy\fR 4
.IX Item "-Qy"
.IP \fB\-Qn\fR 4
.IX Item "-Qn"
.PD
\&\fB\-fno\-ident\fR از درج دستورالعمل‌های اسمبلی \f(CW\*(C`.ident\*(C'\fR جلوگیری کرده
و باعث نادیده گرفته شدن رهنمود پیش‌پردازندهٔ \f(CW\*(C`#ident\*(C'\fR می‌شود.
\&\fB\-Qy\fR و \fB\-Qn\fR مترادف‌های منسوخ‌شده به‌ترتیب برای \fB\-fident\fR
و \fB\-fno\-ident\fR هستند.
.IP \fB\-finhibit\-size\-directive\fR 4
.IX Item "-finhibit-size-directive"
دستورالعمل اسمبلی \f(CW\*(C`.size\*(C'\fR یا هر چیز دیگری را که در صورت
تکه‌تکه شدن تابع از وسط و قرار گرفتن دو نیمه در مکان‌هایی دور از هم در حافظه مشکل ایجاد کند، خروجی نمی‌دهد. این گزینه
هنگام کامپایل \fIcrtstuff.c\fR استفاده می‌شود؛ نباید نیازی به استفاده از آن
برای چیز دیگری داشته باشید.
.IP \fB\-fverbose\-asm\fR 4
.IX Item "-fverbose-asm"
اطلاعات توضیحی بیشتری در کد اسمبلی تولیدشده قرار می‌دهد تا
خوانایی آن بیشتر شود. این گزینه عموماً فقط برای کسانی مفید است
که واقعاً نیاز به خواندن کد اسمبلی تولیدشده دارند (شاید هنگام
اشکال‌زدایی خود کامپایلر).
.Sp
گزینهٔ \&\fB\-fno\-verbose\-asm\fR که حالت پیش‌فرض است، باعث حذف
اطلاعات اضافی می‌شود و هنگام مقایسهٔ دو فایل اسمبلی کاربرد دارد.
.Sp
توضیحات اضافه‌شده شامل موارد زیر است:
.RS 4
.IP * 4
اطلاعات مربوط به نسخهٔ کامپایلر و گزینه‌های خط فرمان،
.IP * 4
خطوط کد مبدأ مرتبط با دستورالعمل‌های اسمبلی،
در قالب FILENAME:LINENUMBER:CONTENT OF LINE،
.IP * 4
نکاتی در مورد اینکه کدام عبارات سطح بالا با
عملوندهای مختلف دستورالعمل اسمبلی مطابقت دارند.
.RE
.RS 4
.Sp
برای مثال، با در نظر گرفتن این فایل مبدأ C:
.Sp
.Vb 4
\&        int test (int n)
\&        {
\&          int i;
\&          int total = 0;
\&        
\&          for (i = 0; i < n; i++)
\&            total += i * i;
\&        
\&          return total;
\&        }
.Ve
.Sp
کامپایل به اسمبلی (x86_64) از طریق \fB\-S\fR و ارسال مستقیم نتیجه
به stdout با استفاده از \fB\-o\fR \fB\-\fR
.Sp
.Vb 1
\&        gcc \-S test.c \-fverbose\-asm \-Os \-o \-
.Ve
.Sp
خروجی مشابه زیر تولید می‌کند:
.Sp
.Vb 5
\&                .file   "test.c"
\&        # GNU C11 (GCC) version 7.0.0 20160809 (experimental) (x86_64\-pc\-linux\-gnu)
\&          [...snip...]
\&        # options passed:
\&          [...snip...]
\&        
\&                .text
\&                .globl  test
\&                .type   test, @function
\&        test:
\&        .LFB0:
\&                .cfi_startproc
\&        # test.c:4:   int total = 0;
\&                xorl    %eax, %eax      # <retval>
\&        # test.c:6:   for (i = 0; i < n; i++)
\&                xorl    %edx, %edx      # i
\&        .L2:
\&        # test.c:6:   for (i = 0; i < n; i++)
\&                cmpl    %edi, %edx      # n, i
\&                jge     .L5     #,
\&        # test.c:7:     total += i * i;
\&                movl    %edx, %ecx      # i, tmp92
\&                imull   %edx, %ecx      # i, tmp92
\&        # test.c:6:   for (i = 0; i < n; i++)
\&                incl    %edx    # i
\&        # test.c:7:     total += i * i;
\&                addl    %ecx, %eax      # tmp92, <retval>
\&                jmp     .L2     #
\&        .L5:
\&        # test.c:10: }
\&                ret
\&                .cfi_endproc
\&        .LFE0:
\&                .size   test, .\-test
\&                .ident  "GCC: (GNU) 7.0.0 20160809 (experimental)"
\&                .section        .note.GNU\-stack,"",@progbits
.Ve
.Sp
این توضیحات برای انسان‌ها در نظر گرفته شده‌اند نه ماشین‌ها، و بنابراین
فرمت دقیق توضیحات ممکن است تغییر کند.
.RE
.IP \fB\-frecord\-gcc\-switches\fR 4
.IX Item "-frecord-gcc-switches"
این سوییچ باعث می‌شود خط فرمان استفاده‌شده برای فراخوانی
کامپایلر، در فایل شیء در حال ایجاد ثبت شود.
این سوییچ تنها روی برخی از مقاصد پیاده‌سازی شده است و قالب دقیق
ثبت به مقصد و قالب فایل باینری بستگی دارد، اما
معمولاً به شکل بخشی حاوی متن ASCII درمی‌آید. این
سوییچ با سوییچ \fB\-fverbose\-asm\fR مرتبط است، اما آن
سوییچ اطلاعات را فقط در فایل خروجی اسمبلی به عنوان توضیح
ثبت می‌کند، بنابراین هرگز به فایل شیء راه نمی‌یابد.
همچنین برای روش دیگری از ذخیرهٔ گزینه‌های کامپایلر در فایل شیء،
به \fB\-grecord\-gcc\-switches\fR مراجعه کنید.
.IP \fB\-fpic\fR 4
.IX Item "-fpic"
در صورت پشتیبانی ماشین مقصد، کد مستقل از موقعیت (PIC) مناسب برای استفاده در
یک کتابخانهٔ مشترک تولید می‌کند. چنین کدی به تمام آدرس‌های
ثابت از طریق یک جدول آفست سراسری (GOT) دسترسی پیدا می‌کند. بارگذار
پویا هنگام شروع برنامه ورودی‌های GOT را تحلیل و حل می‌کند (بارگذار
پویا بخشی از GCC نیست؛ بلکه بخشی از سیستم‌عامل است). اگر
اندازهٔ GOT برای فایل اجرایی پیوند داده‌شده از حداکثر اندازهٔ خاص ماشین
فراتر رود، پیامی خطا از پیونددهنده دریافت می‌کنید که نشان می‌دهد
\&\fB\-fpic\fR کار نمی‌کند؛ در این صورت، به‌جای آن با \fB\-fPIC\fR
دوباره کامپایل کنید. (این مقادیر بیشینه در SPARC برابر با 8k، در AArch64 برابر با 28k
و در m68k و RS/6000 برابر با 32k است. x86 چنین محدودیتی ندارد.)
.Sp
کد مستقل از موقعیت نیازمند پشتیبانی ویژه‌ای است، و بنابراین تنها
روی ماشین‌های خاصی کار می‌کند. برای x86، کامپایلر GCC از PIC برای System V پشتیبانی
می‌کند اما برای Sun 386i پشتیبانی نمی‌کند. کد تولیدشده برای IBM RS/6000 همواره
مستقل از موقعیت است.
.Sp
هنگامی که این پرچم تنظیم شده باشد، ماکروهای \f(CW\*(C`_\|_pic_\|_\*(C'\fR و \f(CW\*(C`_\|_PIC_\|_\*(C'\fR
روی 1 تعریف می‌شوند..IP \fB\-fPIC\fR 4
.IX Item "-fPIC"
در صورت پشتیبانی توسط ماشین مقصد، کد مستقل از موقعیت (position\-independent code)
تولید می‌کند که برای پیوند پویا مناسب بوده و از هرگونه محدودیت در اندازهٔ
جدول آفست سراسری (GOT) جلوگیری می‌کند. این گزینه روی AArch64، m68k،
PowerPC و SPARC تفاوت ایجاد می‌کند.
.Sp
کد مستقل از موقعیت نیازمند پشتیبانی ویژه‌ای است و بنابراین تنها روی
ماشین‌های خاصی کار می‌کند.
.Sp
هنگامی که این پرچم تنظیم شود، ماکروهای \f(CW\*(C`_\|_pic_\|_\*(C'\fR و \f(CW\*(C`_\|_PIC_\|_\*(C'\fR
با مقدار 2 تعریف می‌شوند.
.IP \fB\-fpie\fR 4
.IX Item "-fpie"
.PD 0
.IP \fB\-fPIE\fR 4
.IX Item "-fPIE"
.PD
این گزینه‌ها مشابه \fB\-fpic\fR و \fB\-fPIC\fR هستند، اما کد مستقل از موقعیت
تولیدشده تنها می‌تواند در فایل‌های اجرایی پیوند داده شود. معمولاً از این گزینه‌ها
برای کامپایل کدی استفاده می‌شود که قرار است با استفاده از گزینهٔ \fB\-pie\fR در GCC
پیوند یابد.
.Sp
\&\fB\-fpie\fR و \fB\-fPIE\fR هر دو ماکروهای
\&\f(CW\*(C`_\|_pie_\|_\*(C'\fR و \f(CW\*(C`_\|_PIE_\|_\*(C'\fR را تعریف می‌کنند. این ماکروها
برای \fB\-fpie\fR دارای مقدار 1 و برای \fB\-fPIE\fR دارای مقدار 2 هستند.
.IP \fB\-fno\-plt\fR 4
.IX Item "-fno-plt"
برای فراخوانی توابع خارجی در کد مستقل از موقعیت از PLT استفاده نکن.
در عوض، آدرس فراخوانی‌شونده (callee) را در محل‌های فراخوانی از GOT بارگذاری
کرده و به آن پرش کن. این کار با حذف کدهای واسط (stubs) جدول PLT و در معرض
بهینه‌سازی قرار دادن بارگذاری‌های GOT، منجر به کدی کارآمدتر می‌شود. در
معماری‌هایی مانند x86 ۳۲ بیتی که در آن‌ها کدهای واسط PLT انتظار اشاره‌گر GOT
را در ثباتی خاص دارند، این کار آزادی عمل بیشتری در تخصیص ثبات به کامپایلر می‌دهد.
پیوند تنبل (Lazy binding) نیازمند استفاده از PLT است؛ با \fB\-fno\-plt\fR تمام
نمادهای خارجی در زمان بارگذاری حل‌وفصل می‌شوند.
.Sp
به عنوان روشی جایگزین، می‌توان از صفت تابع \f(CW\*(C`noplt\*(C'\fR برای جلوگیری
از فراخوانی توابع خارجی خاص از طریق PLT استفاده کرد.
.Sp
در کد وابسته به موقعیت، برخی مقصدها نیز فراخوانی توابعی را که برای عدم استفاده
از PLT نشانه‌گذاری شده‌اند، به استفاده از GOT تغییر می‌دهند.
.IP \fB\-fno\-jump\-tables\fR 4
.IX Item "-fno-jump-tables"
برای دستورهای switch از جدول‌های پرش (jump tables) استفاده نکن، حتی در مواردی
که نسبت به سایر راهبردهای تولید کد کارآمدتر باشد. این گزینه در ترکیب با
\fB\-fpic\fR یا \fB\-fPIC\fR برای ساخت کدهایی که بخشی از یک پیونددهندهٔ پویا
هستند و نمی‌توانند به آدرس یک جدول پرش ارجاع دهند کاربرد دارد. در برخی مقصدها،
جدول‌های پرش نیازی به GOT ندارند و به این گزینه نیازی نیست.
.IP \fB\-fno\-bit\-tests\fR 4
.IX Item "-fno-bit-tests"
برای دستورهای switch از آزمون‌های بیتی (bit tests) استفاده نکن، حتی در مواردی
که نسبت به سایر راهبردهای تولید کد کارآمدتر باشد.
.IP \fB\-ffixed\-\fR\fIreg\fR 4
.IX Item "-ffixed-reg"
با ثبات نام‌برده‌شدهٔ \fIreg\fR به عنوان یک ثبات ثابت رفتار کن؛ کد تولیدشده
هرگز نباید به آن ارجاع دهد (شاید به جز به عنوان اشاره‌گر پشته، اشاره‌گر فریم
یا در نقش ثابت دیگری).
.Sp
\&\fIreg\fR باید نام یک ثبات باشد. نام‌های ثبات قابل قبول مختص ماشین هستند و در
ماکروی \f(CW\*(C`REGISTER_NAMES\*(C'\fR در فایل ماکروی توصیف ماشین تعریف شده‌اند.
.Sp
این پرچم حالت منفی ندارد، زیرا یک انتخاب سه‌گانه را مشخص می‌کند.
.IP \fB\-fcall\-used\-\fR\fIreg\fR 4
.IX Item "-fcall-used-reg"
با ثبات نام‌برده‌شدهٔ \fIreg\fR به عنوان یک ثبات تخصیص‌پذیر رفتار کن که با
فراخوانی توابع مقدارش دستخوش تغییر می‌شود (clobbered). این ثبات ممکن است برای
متغیرهای موقت یا متغیرهایی که در طول فراخوانی زنده نمی‌مانند تخصیص یابد. توابعی که
به این روش کامپایل می‌شوند، ثبات \fIreg\fR را ذخیره و بازیابی نمی‌کنند.
.Sp
استفاده از این پرچم برای اشاره‌گر فریم یا اشاره‌گر پشته یک خطا است.
استفاده از این پرچم برای سایر ثبات‌هایی که نقش‌های فراگیر ثابتی در مدل
اجرای ماشین دارند، نتایج فاجعه‌باری به همراه دارد.
.Sp
این پرچم حالت منفی ندارد، زیرا یک انتخاب سه‌گانه را مشخص می‌کند.
.IP \fB\-fcall\-saved\-\fR\fIreg\fR 4
.IX Item "-fcall-saved-reg"
با ثبات نام‌برده‌شدهٔ \fIreg\fR به عنوان یک ثبات تخصیص‌پذیر رفتار کن که توسط
توابع ذخیره می‌شود. این ثبات ممکن است حتی برای متغیرهای موقت یا متغیرهایی که
در طول فراخوانی زنده می‌مانند نیز تخصیص یابد. توابعی که به این روش کامپایل
می‌شوند، در صورت استفاده از ثبات \fIreg\fR، آن را ذخیره و بازیابی می‌کنند.
.Sp
استفاده از این پرچم برای اشاره‌گر فریم یا اشاره‌گر پشته یک خطا است.
استفاده از این پرچم برای سایر ثبات‌هایی که نقش‌های فراگیر ثابتی در مدل
اجرای ماشین دارند، نتایج فاجعه‌باری به همراه دارد.
.Sp
استفاده از این پرچم برای ثباتی که مقادیر بازگشتی تابع ممکن است در آن قرار گیرد،
نوع متفاوتی از فاجعه به بار می‌آورد.
.Sp
این پرچم حالت منفی ندارد، زیرا یک انتخاب سه‌گانه را مشخص می‌کند.
.IP \fB\-fpack\-struct[=\fR\fIn\fR\fB]\fR 4
.IX Item "-fpack-struct[=n]"
بدون تعیین یک مقدار، تمام اعضای ساختار را بدون هیچ فضای خالی در کنار هم
فشرده‌سازی کن. هنگامی که مقداری مشخص شود (که باید توان کوچکی از دو باشد)،
اعضای ساختار را مطابق با این مقدار که نمایانگر حداکثر تراز (alignment) است
بسته‌بندی کن (یعنی اشیایی با نیازمندی‌های تراز پیش‌فرض بزرگ‌تر از این مقدار،
احتمالاً به‌صورت ترازنشده در جایگاه مناسب بعدی قرار می‌گیرند).
.Sp
\&\fBهشدار:\fR گزینهٔ \fB\-fpack\-struct\fR باعث می‌شود GCC کدی تولید کند که با
کدهای تولیدشده بدون این گزینه سازگاری باینری ندارد. علاوه بر این، کارایی کد
را کاهش می‌دهد. تنها برای سازگاری با یک رابط باینری کاربردی (ABI) غیرپیش‌فرض
از آن استفاده کنید.
.IP \fB\-fleading\-underscore\fR 4
.IX Item "-fleading-underscore"
این گزینه و همتای آن، \fB\-fno\-leading\-underscore\fR، نحوهٔ نمایش نمادهای C را
در فایل شیء به‌صورت اجباری تغییر می‌دهند. یک کاربرد آن، کمک به پیوند با کدهای
قدیمی اسمبلی است.
.Sp
\&\fBهشدار:\fR گزینهٔ \fB\-fleading\-underscore\fR باعث می‌شود GCC کدی تولید کند
که با کدهای تولیدشده بدون این گزینه سازگاری باینری ندارد. برای سازگاری با یک
رابط باینری کاربردی غیرپیش‌فرض از آن استفاده کنید. همهٔ مقصدها پشتیبانی کاملی
از این گزینه ارائه نمی‌دهند.
.IP \fB\-ftls\-model=\fR\fImodel\fR 4
.IX Item "-ftls-model=model"
مدل فضای ذخیره‌سازی محلی رشته (TLS) مورد استفاده را تغییر می‌دهد.
آرگومان \fImodel\fR باید یکی از مقادیر \fBglobal\-dynamic\fR،
\&\fBlocal\-dynamic\fR، \fBinitial\-exec\fR یا \fBlocal\-exec\fR باشد.
توجه داشته باشید که این انتخاب مشمول بهینه‌سازی است: کامپایلر ممکن است برای
نمادهایی که در خارج از واحد ترجمه قابل مشاهده نیستند، یا اگر \fB\-fpic\fR در
خط فرمان مشخص نشده باشد، از مدلی کارآمدتر استفاده کند.
.Sp
پیش‌فرض بدون \fB\-fpic\fR مقدار \fBinitial\-exec\fR است؛ همراه با
\&\fB\-fpic\fR پیش‌فرض \fBglobal\-dynamic\fR است.
.IP \fB\-ftrampolines\fR 4
.IX Item "-ftrampolines"
برای مقصدهایی که معمولاً برای توابع تو در تو به ترامپولین‌ها نیاز دارند، همیشه
به جای استفاده از توصیف‌کننده‌ها، آن‌ها را تولید کن. در غیر این صورت، برای
مقصدهایی که به آن‌ها نیازی ندارند، مانند HP\-PA یا IA\-64، کاری انجام نده.
.Sp
ترامپولین قطعه کد کوچکی است که در زمان اجرا روی پشته ایجاد می‌شود، هنگامی که
آدرس یک تابع تو در تو گرفته شده است، و برای فراخوانی غیرمستقیم تابع تو در تو
استفاده می‌شود. بنابراین، برای عملکرد صحیح برنامه لازم است که پشته قابل اجرا
(executable) شود.
.Sp
گزینهٔ \&\fB\-fno\-trampolines\fR بر اساس نوع هر زبان به صورت پیش‌فرض فعال است
تا به کامپایلر اجازه دهد در صورت ایمن تشخیص دادن، از تولید آن‌ها خودداری کرده و
آن‌ها را با توصیف‌کننده‌ها جایگزین سازد. توصیف‌کننده‌ها فقط از داده تشکیل شده‌اند،
اما کد تولیدشده باید برای کار با آن‌ها آماده باشد. در زمان نگارش این مستند،
\fB\-fno\-trampolines\fR تنها برای زبان Ada به طور پیش‌فرض فعال است.
.Sp
علاوه بر این، در صورت وجود توابع تو در تو، کدهای کامپایل‌شده با \fB\-ftrampolines\fR
و کدهای کامپایل‌شده با \&\fB\-fno\-trampolines\fR سازگاری باینری ندارند. بنابراین،
این گزینه باید در کل سطح برنامه استفاده شده و با احتیاط بسیار دستکاری شود.
.Sp
برای زبان‌هایی غیر از Ada، گزینه‌های \f(CW\*(C`\-ftrampolines\*(C'\fR و
\&\f(CW\*(C`\-fno\-trampolines\*(C'\fR در حال حاضر هیچ اثری ندارند، و ترامپولین‌ها
همیشه روی سکوهایی که برای توابع تو در تو به آن‌ها نیاز دارند تولید می‌شوند.
.IP \fB\-ftrampoline\-impl=\fR[\fBstack\fR|\fBheap\fR] 4
.IX Item "-ftrampoline-impl=[stack|heap]"
به‌طور پیش‌فرض، ترامپولین‌ها روی پشته تولید می‌شوند. با این حال، برخی سکوها
(مانند Apple M1) پشتهٔ قابل اجرا را مجاز نمی‌دانند. کامپایل با
\&\fB\-ftrampoline\-impl=heap\fR فراخوانی‌هایی به
\&\f(CW\*(C`_\|_gcc_nested_func_ptr_created\*(C'\fR و
\&\f(CW\*(C`_\|_gcc_nested_func_ptr_deleted\*(C'\fR ایجاد می‌کند تا فضای ترامپولین
را روی هیپ قابل اجرا تخصیص داده و آزاد کند. این توابع در libgcc پیاده‌سازی
شده‌اند و تنها روی مقصدهای مشخصی ارائه خواهند شد:
x86_64 Darwin، و x86_64 و aarch64 در Linux. \fIتوجه داشته باشید\fR: در صورتی که
\&\f(CW\*(C`setjmp\*(C'\fR انجام دهید، توابع تو در تو را نمونه‌سازی کنید و سپس با
\&\f(CW\*(C`longjmp\*(C'\fR به وضعیتی پیش از تخصیص آن توابع تو در تو بازگردید، تضمینی
\fIوجود ندارد\fR که ترامپولین‌های هیپ به‌درستی آزاد شوند.
.IP \fB\-fvisibility=\fR[\fBdefault\fR|\fBinternal\fR|\fBhidden\fR|\fBprotected\fR] 4
.IX Item "-fvisibility=[default|internal|hidden|protected]"
نمایانی پیش‌فرض نمادهای تصویر ELF را روی گزینهٔ مشخص‌شده تنظیم می‌کند\-\-\-تمام
نمادها با این مشخصه علامت‌گذاری می‌شوند مگر اینکه درون کد لغو شوند.
استفاده از این ویژگی می‌تواند زمان پیوند و بارگذاری کتابخانه‌های شیء اشتراکی را
به‌طور چشمگیری بهبود بخشد، کد بهینه‌تری تولید کند، صادرات API تقریباً بی‌نقصی
ارائه دهد و از تداخل نمادها جلوگیری کند.
\fBاکیداً\fR توصیه می‌شود که از این گزینه در هر شیء اشتراکی که توزیع می‌کنید
استفاده نمایید.
.Sp
برخلاف نام‌گذاری، \fBdefault\fR همیشه به معنای عمومی (public) است؛ یعنی
در دسترس برای پیوند خوردن از خارج شیء اشتراکی. گزینه‌های \fBprotected\fR و
\fBinternal\fR در کاربردهای واقعی عملاً بلااستفاده هستند، بنابراین تنها گزینهٔ
رایج دیگر \fBhidden\fR است. پیش‌فرض در صورت عدم تعیین \fB\-fvisibility\fR مقدار
\&\fBdefault\fR است، یعنی تمام نمادها عمومی می‌شوند.
.Sp
توضیح مناسبی دربارهٔ مزایای اطمینان از نمایانی صحیح نمادهای ELF در مقالهٔ
"How To Write Shared Libraries" به قلم Ulrich Drepper (قابل دسترسی در
<\fBhttps://www.akkadia.org/drepper\fR>) ارائه شده است\-\-\-با این حال راهکار
برتری که به کمک این گزینه نسبت به مخفی‌سازی در حالتی که پیش‌فرضْ عمومی است
فراهم شده، این است که پیش‌فرض را hidden قرار داده و موارد لازم را عمومی علامت‌گذاری
کنید. این امر در DLLها روی Windows یک هنجار است و با \fB\-fvisibility=hidden\fR
و \f(CW\*(C`_\|_attribute_\|_ ((visibility("default")))\*(C'\fR به جای
\&\f(CW\*(C`_\|_declspec(dllexport)\*(C'\fR معناشناسی تقریباً یکسانی با ساختار نحوی
همسان به دست می‌آورید. این یک موهبت بزرگ برای کسانی است که روی پروژه‌های
چندسکویی کار می‌کنند.
.Sp
برای کسانی که پشتیبانی از نمایانی را به کدهای موجود اضافه می‌کنند، دستور
\&\f(CW\*(C`#pragma GCC visibility\*(C'\fR می‌تواند مفید باشد. نحوهٔ کار به این صورت
است که اعلان‌هایی را که می‌خواهید نمایانی آن‌ها را تنظیم کنید (به عنوان مثال) با
\&\f(CW\*(C`#pragma GCC visibility push(hidden)\*(C'\fR و
\&\f(CW\*(C`#pragma GCC visibility pop\*(C'\fR احاطه می‌کنید.
به یاد داشته باشید که نمایانی نمادها باید \fBبه عنوان بخشی از قرارداد رابط API\fR
دیده شود و بنابراین تمام کدهای جدید باید همیشه در صورتی که نمایانی پیش‌فرض نیست
آن را مشخص کنند؛ یعنی اعلان‌هایی که صرفاً برای استفاده در DSO محلی هستند \fBهمیشه\fR
باید به‌صراحت به عنوان hidden علامت‌گذاری شوند تا از سربار ارجاع غیرمستقیم PLT
جلوگیری شود\-\-\-واضح ساختن این موضوع به خوانایی و خودسندسازی کد نیز کمک می‌کند.
توجه داشته باشید که به دلیل الزامات مشخصات ISO C++، عملگرهای \f(CW\*(C`operator new\*(C'\fR
و \&\f(CW\*(C`operator delete\*(C'\fR همیشه باید دارای نمایانی پیش‌فرض (default) باشند.
.Sp
آگاه باشید که سرایندهای خارج از پروژهٔ شما، به‌ویژه سرایندهای سیستم و سرایندهای
هر کتابخانهٔ دیگری که استفاده می‌کنید، ممکن است انتظار کامپایل با نمایانی غیر از
پیش‌فرض را نداشته باشند. ممکن است نیاز باشد به‌صراحت از
\&\f(CW\*(C`#pragma GCC visibility push(default)\*(C'\fR پیش از گنجاندن هر یک از
این سرایندها استفاده کنید.
.Sp
اعلان‌های \&\f(CW\*(C`extern\*(C'\fR تحت تأثیر \fB\-fvisibility\fR قرار نمی‌گیرند،
بنابراین بخش زیادی از کدها را می‌توان با \fB\-fvisibility=hidden\fR بدون تغییر
مجدداً کامپایل کرد. با این حال، این بدان معناست که فراخوانی توابع \f(CW\*(C`extern\*(C'\fR
بدون نمایانی صریح از PLT استفاده می‌کند، بنابراین مؤثرتر است که از
\&\f(CW\*(C`_\|_attribute ((visibility))\*(C'\fR و/یا \&\f(CW\*(C`#pragma GCC visibility\*(C'\fR
برای اعلام این که کدام اعلان‌های \f(CW\*(C`extern\*(C'\fR باید مخفی در نظر گرفته
شوند به کامپایلر استفاده کنید.
.Sp
توجه داشته باشید که \fB\-fvisibility\fR بر موجودیت‌های پیوند مبهم (vague linkage)
در C++ تأثیر می‌گذارد. این بدان معناست که برای نمونه، یک کلاس استثنا که بین
DSOها پرتاب می‌شود باید صریحاً با نمایانی default نشانه‌گذاری شود تا گره‌های
\fBtype_info\fR بین DSOها یکپارچه شوند.
.Sp
مروری بر این روش‌ها، مزایای آن‌ها و نحوهٔ استفاده از آن‌ها در
<\fBhttps://gcc.gnu.org/wiki/Visibility\fR> در دسترس است..IP \fB\-fstrict\-volatile\-bitfields\fR 4
.IX Item "-fstrict-volatile-bitfields"
این گزینه زمانی باید به کار رود که دسترسی‌ها به فیلدهای بیتی \f(CWvolatile\fR (یا سایر فیلدهای ساختار، اگرچه کامپایلر معمولاً در هر صورت آن نوع‌ها را رعایت می‌کند) باید از یک دسترسی واحد با پهنای نوعِ فیلد، و در صورت امکان هم‌تراز با تراز طبیعی استفاده کنند. برای نمونه، مقصدهایی با ثبات‌های جانبی نگاشت‌شده در حافظه (memory-mapped) ممکن است به دسترسی‌هایی با پهنای دقیقاً ۱۶ بیت نیاز داشته باشند؛ با این پرچم می‌توانید همهٔ فیلدهای بیتیِ جانبی را به‌صورت \f(CW\*(C`unsigned short\*(C'\fR تعریف کنید (با فرض اینکه \f(CWshort\fR در این مقصدهای هدف ۱۶ بیتی است) تا GCC را وادار کنید به جای یک دسترسی احتمالاً بهینه‌ترِ ۳۲ بیتی، از دسترسی‌های ۱۶ بیتی استفاده کند.
.Sp
اگر این گزینه غیرفعال باشد، کامپایلر از بهینه‌ترین دستورالعمل استفاده می‌کند. در مثال قبلی، این ممکن است یک دستورالعمل بارگذاری (load) ۳۲ بیتی باشد، حتی اگر به بایت‌هایی دسترسی پیدا کند که شامل هیچ بخشی از فیلد بیتی نیستند، یا به ثبات‌های نگاشت‌شده در حافظه‌ای دسترسی یابد که ارتباطی به ثبات در حال به‌روزرسانی ندارند.
.Sp
در برخی موارد، مانند زمانی که مشخصهٔ \f(CW\*(C`packed\*(C'\fR بر روی یک فیلد ساختار اعمال شده باشد، ممکن است دسترسی به آن فیلد با یک خواندن یا نوشتنِ منفرد که برای ماشین مقصد به‌درستی تراز شده باشد، امکان‌پذیر نباشد. در این حالت، GCC به جای تولید کدی که در زمان اجرا دچار خطا شده یا نتیجه را کوتاه (truncate) کند، به تولید چندین دسترسی بازمی‌گردد.
.Sp
نکته: به دلیل محدودیت‌های مدل حافظهٔ C/C++11، دسترسی‌های نوشتن مجاز نیستند اعضایی را که فیلد بیتی نیستند دستکاری کنند. بنابراین توصیه می‌شود تمام بیت‌های نوعِ فیلد را به‌صورت اعضای فیلد بیتی تعریف کنید.
.Sp
مقدار پیش‌فرض این گزینه توسط واسط باینری برنامه (ABI) برای پردازندهٔ مقصد تعیین می‌شود.
.IP \fB\-fsync\-libcalls\fR 4
.IX Item "-fsync-libcalls"
این گزینه کنترل می‌کند که آیا هرگونه نمونهٔ درون‌خط‌نشده (out\-of\-line) از خانوادهٔ توابع \f(CW\*(C`_\|_sync\*(C'\fR می‌تواند برای پیاده‌سازی خانوادهٔ توابع \f(CW\*(C`_\|_atomic\*(C'\fR در C++11 استفاده شود یا خیر.
.Sp
مقدار پیش‌فرض این گزینه فعال است، بنابراین تنها شکل کاربردی این گزینه \fB\-fno\-sync\-libcalls\fR است. این گزینه در پیاده‌سازی کتابخانهٔ زمان اجرای \fIlibatomic\fR استفاده می‌شود.
.IP \fB\-fzero\-init\-padding\-bits=\fR\fIvalue\fR 4
.IX Item "-fzero-init-padding-bits=value"
مقداردهی اولیهٔ بیت‌های فاصله‌ساز (padding bits) با صفر را در مقداردهنده‌های اولیهٔ متغیرهای خودکار تضمین می‌کند.
برخی زبان‌ها مقداردهی اولیهٔ بیت‌های فاصله‌ساز با صفر را در موارد خاصی تضمین می‌کنند؛ برای نمونه C23 هنگام استفاده از مقداردهنده‌های اولیهٔ خالی (\f(CW\*(C`{}\*(C'\fR)، یا C++ هنگام استفاده از مقداردهی اولیه با صفر، یا C تضمین می‌کند فیلدهایی که در یک مقداردهنده اولیه مشخص نشده‌اند، بیت‌های فاصله‌ساز آن‌ها با صفر مقداردهی اولیه شوند. این گزینه امکان تغییر زمانِ تضمینِ مقداردهی با صفر بیت‌های فاصله‌ساز در مقداردهنده‌ها را فراهم می‌کند.
پیش‌فرض \f(CW\*(C`\-fzero\-init\-padding\-bits=standard\*(C'\fR است که هیچ تضمینی فراتر از استاندارد مربوطه ارائه نمی‌دهد؛ برای نمونه:
.Sp
.Vb 6
\&          struct A { char a; unsigned long long b; char c; };
\&          union B { char a; unsigned long long b; };
\&          struct A a = {}; // C23 guarantees padding bits are zero.
\&          struct A b = { 1, 2, 3 }; // No guarantees.
\&          union B c = {}; // C23 guarantees padding bits are zero.
\&          union B d = { 1 }; // No guarantees.
.Ve
.Sp
\&\f(CW\*(C`\-fzero\-init\-padding\-bits=unions\*(C'\fR علاوه‌بر آنچه استانداردها تضمین می‌کنند، مقداردهی اولیهٔ بیت‌های فاصله‌ساز را در اجتماع‌ها (unions) تضمین می‌کند، مشروط بر اینکه مقداردهندهٔ اولیهٔ یک union خالی باشد (که در این صورت تمام بیت‌های union با صفر مقداردهی اولیه می‌شوند) یا اگر عضو مقداردهی‌شده از union کوچک‌تر از اندازهٔ union باشد (که در این حالت تضمین می‌کند بیت‌های فاصله‌سازِ خارج از عضو مقداردهی‌شده با صفر مقداردهی اولیه شوند). این رفتار GCC پیش از GCC 15 بود و در مثال بالا، مقداردهی با صفر را برای \f(CW\*(C`sizeof (unsigned long long) \- 1\*(C'\fR بایت پایانی در union تضمین می‌کند.
.Sp
\&\f(CW\*(C`\-fzero\-init\-padding\-bits=all\*(C'\fR افزون بر این، مقداردهی اولیهٔ با صفر بیت‌های فاصله‌ساز را در سایر ساختارهای تجمعی (aggregates) تضمین می‌کند؛ بنابراین فاصله‌ساز بین \f(CW\*(C`b.a\*(C'\fR و \f(CW\*(C`b.b\*(C'\fR (در صورت وجود) و فاصله‌ساز انتهایی در ساختار (در صورت وجود) را شامل می‌شود.
.SS "گزینه‌های توسعه‌دهندگان GCC (GCC Developer Options)"
.IX Subsection "GCC Developer Options"
این بخش گزینه‌های خط فرمانی را شرح می‌دهد که عمدتاً مورد توجه توسعه‌دهندگان GCC هستند؛ از جمله گزینه‌هایی برای پشتیبانی از آزمایش کامپایلر و بررسی اشکالات کامپایلر و مشکلات کارایی در زمان کامپایل. این موارد شامل گزینه‌هایی است که در مراحل مختلف کامپایل، خروجی‌های اشکال‌زدایی (debug dumps) تولید می‌کنند؛ آمارهایی مانند مصرف حافظه و زمان اجرا را چاپ می‌کنند؛ و اطلاعاتی را دربارهٔ پیکربندی GCC، مانند مکان‌های جستجوی کتابخانه‌ها، نمایش می‌دهند. برای کارهای معمول کامپایل و پیوند دادن (linking) به‌ندرت نیاز به استفاده از این گزینه‌ها خواهید داشت.
.PP
بسیاری از گزینه‌های توسعه‌دهنده که باعث می‌شوند GCC خروجی را در یک فایل تخلیه (dump) کند، پسوند اختیاری \fB=\fR\fIfilename\fR می‌پذیرند. می‌توانید \fBstdout\fR یا \fB\-\fR را برای تخلیه در خروجی استاندارد، و \fBstderr\fR را برای خطای استاندارد مشخص کنید.
.PP
اگر \fB=\fR\fIfilename\fR حذف شود، یک نام پیش‌فرض برای فایل تخلیه با الحاق نام پایهٔ فایل تخلیه، شمارهٔ گذر (pass number)، حرف فاز (phase letter) و نام گذر ساخته می‌شود. نام پایهٔ فایل تخلیه، در صورتی که به‌طور صریح مشخص شده باشد و یک فایل اجرایی نباشد، نام فایل خروجی تولیدشده توسط کامپایلر است؛ در غیر این صورت، نام فایل منبع خواهد بود.
شمارهٔ گذر بر اساس ترتیبی تعیین می‌شود که گذرها در مدیر گذرهای کامپایلر ثبت می‌شوند.
این ترتیب عموماً با ترتیب اجرا یکسان است، اما گذرهایی که توسط پلاگین‌ها ثبت می‌شوند، گذرهای ویژه‌ی معماری مقصد، یا گذرهایی که به دلایل دیگر دیر ثبت شده‌اند، شماره‌ای بالاتر از گذر با نام \fBfinal\fR دریافت می‌کنند، حتی اگر زودتر اجرا شوند. حرف فاز یکی از موارد \fBi\fR (تحلیل بین‌روالی)، \fBl\fR (مختص زبان)، \fBr\fR (RTL)، یا \fBt\fR (درخت) است.
این فایل‌ها در دایرکتوری فایل خروجی ایجاد می‌شوند.
.IP \fB\-fcallgraph\-info\fR 4
.IX Item "-fcallgraph-info"
.PD 0
.IP \fB\-fcallgraph\-info=\fR\fIMARKERS\fR 4
.IX Item "-fcallgraph-info=MARKERS"
.PD
کامپایلر را وادار می‌کند اطلاعات گراف فراخوانی (callgraph) برنامه را به ازای هر فایل شیء (object file) در خروجی قرار دهد. این اطلاعات در قالب متداول VCG تولید می‌شوند. در صورت مشخص کردن یک فهرست از نشانگرهای جداشده با کاما، می‌توان آن را با اطلاعات اضافی به ازای هر گره یا هر یال آراست. هنگامی که نشانگر \f(CW\*(C`su\*(C'\fR مشخص شود، گراف فراخوانی با اطلاعات استفاده از پشته آراسته می‌شود؛ این معادل با \fB\-fstack\-usage\fR است. هنگامی که نشانگر \f(CW\*(C`da\*(C'\fR تعیین شود، گراف فراخوانی با اطلاعات مربوط به اشیاء پویا تخصیص‌یافته آراسته می‌شود.
.Sp
هنگام کامپایل با \fB\-flto\fR، هیچ اطلاعات گراف فراخوانی همراه با فایل شیء در خروجی نوشته نمی‌شود. در زمان پیوند LTO، گزینهٔ \fB\-fcallgraph\-info\fR ممکن است چندین فایل اطلاعات گراف فراخوانی در کنار فایل‌های خروجی میانی LTO تولید کند.
.IP \fB\-d\fR\fIletters\fR 4
.IX Item "-dletters"
.PD 0
.IP \fB\-\-dump=\fR\fIletters\fR 4
.IX Item "--dump=letters"
.IP "\fB\-\-dump\fR \fIletters\fR" 4
.IX Item "--dump letters"
.IP \fB\-fdump\-rtl\-\fR\fIpass\fR 4
.IX Item "-fdump-rtl-pass"
.IP \fB\-fdump\-rtl\-\fR\fIpass\fR\fB\-\fR\fIoptions\fR 4
.IX Item "-fdump-rtl-pass-options"
.IP \fB\-fdump\-rtl\-\fR\fIpass\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR 4
.IX Item "-fdump-rtl-pass-options=filename"
.PD
مشخص می‌کند که در طول کامپایل، در زمان‌های تعیین‌شده توسط \fIletters\fR (هنگام استفاده از \fB\-d\fR) یا توسط \fIpass\fR (هنگام استفاده از \fB\-fdump\-rtl\fR)، خروجی‌های تخلیهٔ اشکال‌زدایی ایجاد شوند. این مورد برای اشکال‌زدایی گذرهای مبتنی بر RTL کامپایلر استفاده می‌شود.
.Sp
برخی از سوئیچ‌های \fB\-d\fR\fIletters\fR هنگامی که \fB\-E\fR برای پیش‌پردازش به کار می‌رود، معنای متفاوتی دارند.
.Sp
شکل \fB\-\fR\fIoptions\fR کنترل بیشتری بر روی جزئیات فایل تخلیه فراهم می‌کند. به \fB\-fdump\-tree\fR مراجعه کنید.
.Sp
در اینجا نمونه‌های واقعی گزینه‌های خط فرمان که از این الگوها پیروی می‌کنند و معانی آن‌ها آورده شده است:
.RS 4
.IP \fB\-fdump\-rtl\-alignments\fR 4
.IX Item "-fdump-rtl-alignments"
تخلیه پس از محاسبهٔ ترازهای پرش (branch alignments).
.IP \fB\-fdump\-rtl\-asmcons\fR 4
.IX Item "-fdump-rtl-asmcons"
تخلیه پس از اصلاح عبارت‌های rtl که قیدهای ورودی/خروجی (in/out constraints) برآورده‌نشده دارند.
.IP \fB\-fdump\-rtl\-auto_inc_dec\fR 4
.IX Item "-fdump-rtl-auto_inc_dec"
تخلیه پس از کشف خود‌افزایش/کاهش (auto\-inc\-dec). این گذر تنها روی معماری‌هایی اجرا می‌شود که دستورالعمل‌های خود‌افزایش یا خود‌کاهش دارند.
.IP \fB\-fdump\-rtl\-barriers\fR 4
.IX Item "-fdump-rtl-barriers"
تخلیه پس از پاک‌سازی دستورالعمل‌های مانع (barrier instructions).
.IP \fB\-fdump\-rtl\-bbpart\fR 4
.IX Item "-fdump-rtl-bbpart"
تخلیه پس از افرازش (پارتیشن‌بندی) بلوک‌های پایهٔ داغ و سرد.
.IP \fB\-fdump\-rtl\-bbro\fR 4
.IX Item "-fdump-rtl-bbro"
تخلیه پس از بازآرایی بلوک‌ها (block reordering).
.IP \fB\-fdump\-rtl\-btl1\fR 4
.IX Item "-fdump-rtl-btl1"
.PD 0
.IP \fB\-fdump\-rtl\-btl2\fR 4
.IX Item "-fdump-rtl-btl2"
.PD
\&\fB\-fdump\-rtl\-btl1\fR و \fB\-fdump\-rtl\-btl2\fR تخلیهٔ خروجی پس از دو گذر بهینه‌سازی بارگذاری مقصد پرش (branch target load) را فعال می‌کنند..IP \fB\-fdump\-rtl\-bypass\fR 4
.IX Item "-fdump-rtl-bypass"
تخلیه پس از کنارگذر پرش‌ها و بهینه‌سازی‌های جریان کنترل.
.IP \fB\-fdump\-rtl\-combine\fR 4
.IX Item "-fdump-rtl-combine"
تخلیه پس از گذر ترکیب دستورالعمل‌های RTL.
.IP \fB\-fdump\-rtl\-compgotos\fR 4
.IX Item "-fdump-rtl-compgotos"
تخلیه پس از تکثیر gotoهای محاسبه‌شده.
.IP \fB\-fdump\-rtl\-ce1\fR 4
.IX Item "-fdump-rtl-ce1"
.PD 0
.IP \fB\-fdump\-rtl\-ce2\fR 4
.IX Item "-fdump-rtl-ce2"
.IP \fB\-fdump\-rtl\-ce3\fR 4
.IX Item "-fdump-rtl-ce3"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-ce1\fR، \fB\-fdump\-rtl\-ce2\fR و
\&\fB\-fdump\-rtl\-ce3\fR تخلیه پس از سه گذر
تبدیل if را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-cprop_hardreg\fR 4
.IX Item "-fdump-rtl-cprop_hardreg"
تخلیه پس از انتشار رونوشت ثبات سخت‌افزاری.
.IP \fB\-fdump\-rtl\-csa\fR 4
.IX Item "-fdump-rtl-csa"
تخلیه پس از ترکیب تنظیمات پشته.
.IP \fB\-fdump\-rtl\-cse1\fR 4
.IX Item "-fdump-rtl-cse1"
.PD 0
.IP \fB\-fdump\-rtl\-cse2\fR 4
.IX Item "-fdump-rtl-cse2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-cse1\fR و \fB\-fdump\-rtl\-cse2\fR تخلیه پس از
دو گذر حذف زیرعبارت‌های مشترک را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-dce\fR 4
.IX Item "-fdump-rtl-dce"
تخلیه پس از گذرهای مستقل حذف کدهای مرده.
.IP \fB\-fdump\-rtl\-dbr\fR 4
.IX Item "-fdump-rtl-dbr"
تخلیه پس از زمان‌بندی انشعاب‌های با تاخیر.
.IP \fB\-fdump\-rtl\-dce1\fR 4
.IX Item "-fdump-rtl-dce1"
.PD 0
.IP \fB\-fdump\-rtl\-dce2\fR 4
.IX Item "-fdump-rtl-dce2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-dce1\fR و \fB\-fdump\-rtl\-dce2\fR تخلیه پس از
دو گذر حذف ذخیره‌سازی‌های مرده را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-eh\fR 4
.IX Item "-fdump-rtl-eh"
تخلیه پس از نهایی‌سازی کد مدیریت استثنا (EH).
.IP \fB\-fdump\-rtl\-eh_ranges\fR 4
.IX Item "-fdump-rtl-eh_ranges"
تخلیه پس از تبدیل نواحی بازه مدیریت استثنا (EH).
.IP \fB\-fdump\-rtl\-expand\fR 4
.IX Item "-fdump-rtl-expand"
تخلیه پس از تولید RTL.
.IP \fB\-fdump\-rtl\-fwprop1\fR 4
.IX Item "-fdump-rtl-fwprop1"
.PD 0
.IP \fB\-fdump\-rtl\-fwprop2\fR 4
.IX Item "-fdump-rtl-fwprop2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-fwprop1\fR و \fB\-fdump\-rtl\-fwprop2\fR
تخلیه پس از دو گذر انتشار رو به جلو را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-gcse1\fR 4
.IX Item "-fdump-rtl-gcse1"
.PD 0
.IP \fB\-fdump\-rtl\-gcse2\fR 4
.IX Item "-fdump-rtl-gcse2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-gcse1\fR و \fB\-fdump\-rtl\-gcse2\fR تخلیه
پس از حذف سراسری زیرعبارت‌های مشترک را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-init\-regs\fR 4
.IX Item "-fdump-rtl-init-regs"
تخلیه پس از مقداردهی اولیه ثبات‌ها.
.IP \fB\-fdump\-rtl\-initvals\fR 4
.IX Item "-fdump-rtl-initvals"
تخلیه پس از محاسبه مجموعه‌های مقادیر اولیه.
.IP \fB\-fdump\-rtl\-into_cfglayout\fR 4
.IX Item "-fdump-rtl-into_cfglayout"
تخلیه پس از تبدیل به حالت cfglayout.
.IP \fB\-fdump\-rtl\-ira\fR 4
.IX Item "-fdump-rtl-ira"
تخلیه پس از تخصیص تکرارشونده ثبات‌ها.
.IP \fB\-fdump\-rtl\-jump\fR 4
.IX Item "-fdump-rtl-jump"
تخلیه پس از دومین بهینه‌سازی پرش.
.IP \fB\-fdump\-rtl\-loop2\fR 4
.IX Item "-fdump-rtl-loop2"
\&\fB\-fdump\-rtl\-loop2\fR تخلیه پس از گذرهای
بهینه‌سازی حلقه در RTL را فعال می‌کند.
.IP \fB\-fdump\-rtl\-mach\fR 4
.IX Item "-fdump-rtl-mach"
تخلیه پس از انجام گذر بازسازمان‌دهی وابسته به ماشین، در صورت وجود آن
گذر.
.IP \fB\-fdump\-rtl\-mode_sw\fR 4
.IX Item "-fdump-rtl-mode_sw"
تخلیه پس از حذف تعویض‌های زاید حالت.
.IP \fB\-fdump\-rtl\-rnreg\fR 4
.IX Item "-fdump-rtl-rnreg"
تخلیه پس از شماره‌گذاری مجدد ثبات‌ها.
.IP \fB\-fdump\-rtl\-outof_cfglayout\fR 4
.IX Item "-fdump-rtl-outof_cfglayout"
تخلیه پس از خروج از حالت cfglayout.
.IP \fB\-fdump\-rtl\-peephole2\fR 4
.IX Item "-fdump-rtl-peephole2"
تخلیه پس از گذر peephole.
.IP \fB\-fdump\-rtl\-postreload\fR 4
.IX Item "-fdump-rtl-postreload"
تخلیه پس از بهینه‌سازی‌های پس از بارگذاری مجدد (post\-reload).
.IP \fB\-fdump\-rtl\-pro_and_epilogue\fR 4
.IX Item "-fdump-rtl-pro_and_epilogue"
تخلیه پس از تولید مقدمه و مؤخره توابع.
.IP \fB\-fdump\-rtl\-sched1\fR 4
.IX Item "-fdump-rtl-sched1"
.PD 0
.IP \fB\-fdump\-rtl\-sched2\fR 4
.IX Item "-fdump-rtl-sched2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-sched1\fR و \fB\-fdump\-rtl\-sched2\fR تخلیه پس از
گذرهای زمان‌بندی بلوک پایه را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-ree\fR 4
.IX Item "-fdump-rtl-ree"
تخلیه پس از حذف بسط با علامت/صفر.
.IP \fB\-fdump\-rtl\-seqabstr\fR 4
.IX Item "-fdump-rtl-seqabstr"
تخلیه پس از کشف توالی‌های مشترک.
.IP \fB\-fdump\-rtl\-shorten\fR 4
.IX Item "-fdump-rtl-shorten"
تخلیه پس از کوتاه‌سازی انشعاب‌ها.
.IP \fB\-fdump\-rtl\-split1\fR 4
.IX Item "-fdump-rtl-split1"
.PD 0
.IP \fB\-fdump\-rtl\-split2\fR 4
.IX Item "-fdump-rtl-split2"
.IP \fB\-fdump\-rtl\-split3\fR 4
.IX Item "-fdump-rtl-split3"
.IP \fB\-fdump\-rtl\-split4\fR 4
.IX Item "-fdump-rtl-split4"
.IP \fB\-fdump\-rtl\-split5\fR 4
.IX Item "-fdump-rtl-split5"
.PD
این گزینه‌ها تخلیه پس از پنج دور
تقسیم دستورالعمل‌ها را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-sms\fR 4
.IX Item "-fdump-rtl-sms"
تخلیه پس از زمان‌بندی پیمانه‌ای (modulo scheduling). این گذر فقط روی برخی
معماری‌ها اجرا می‌شود.
.IP \fB\-fdump\-rtl\-stack\fR 4
.IX Item "-fdump-rtl-stack"
تخلیه پس از تبدیل ثبات‌های «flat register file» در GCC به
ثبات‌های پشته‌مانند x87. این گذر فقط روی گونه‌های x86 اجرا می‌شود.
.IP \fB\-fdump\-rtl\-subreg1\fR 4
.IX Item "-fdump-rtl-subreg1"
.PD 0
.IP \fB\-fdump\-rtl\-subreg2\fR 4
.IX Item "-fdump-rtl-subreg2"
.PD
گزینه‌های \&\fB\-fdump\-rtl\-subreg1\fR و \fB\-fdump\-rtl\-subreg2\fR تخلیه پس از
دو گذر گسترش subreg را فعال می‌کنند.
.IP \fB\-fdump\-rtl\-vartrack\fR 4
.IX Item "-fdump-rtl-vartrack"
تخلیه پس از ردگیری متغیرها.
.IP \fB\-fdump\-rtl\-vregs\fR 4
.IX Item "-fdump-rtl-vregs"
تخلیه پس از تبدیل ثبات‌های مجازی به ثبات‌های سخت‌افزاری.
.IP \fB\-fdump\-rtl\-web\fR 4
.IX Item "-fdump-rtl-web"
تخلیه پس از تقسیم بازه حیات.
.IP \fB\-fdump\-rtl\-regclass\fR 4
.IX Item "-fdump-rtl-regclass"
.PD 0
.IP \fB\-fdump\-rtl\-subregs_of_mode_init\fR 4
.IX Item "-fdump-rtl-subregs_of_mode_init"
.IP \fB\-fdump\-rtl\-subregs_of_mode_finish\fR 4
.IX Item "-fdump-rtl-subregs_of_mode_finish"
.IP \fB\-fdump\-rtl\-dfinit\fR 4
.IX Item "-fdump-rtl-dfinit"
.IP \fB\-fdump\-rtl\-dfinish\fR 4
.IX Item "-fdump-rtl-dfinish".PD
این تخلیه‌ها تعریف شده‌اند اما همواره فایل‌های خالی تولید می‌کنند.
.IP \fB\-da\fR 4
.IX Item "-da"
.PD 0
.IP \fB\-\-dump=a\fR 4
.IX Item "--dump=a"
.IP \fB\-fdump\-rtl\-all\fR 4
.IX Item "-fdump-rtl-all"
.PD
تولید تمام تخلیه‌های فهرست‌شده در بالا.
.IP \fB\-dA\fR 4
.IX Item "-dA"
.PD 0
.IP \fB\-\-dump=A\fR 4
.IX Item "--dump=A"
.PD
حاشیه‌نویسی خروجی اسمبلر با اطلاعات گوناگون اشکال‌زدایی.
.IP \fB\-dD\fR 4
.IX Item "-dD"
.PD 0
.IP \fB\-\-dump=D\fR 4
.IX Item "--dump=D"
.PD
تخلیه تمام تعاریف ماکرو در انتهای پیش‌پردازش، علاوه بر خروجی عادی.
.IP \fB\-dH\fR 4
.IX Item "-dH"
.PD 0
.IP \fB\-\-dump=H\fR 4
.IX Item "--dump=H"
.PD
تولید یک core dump هر زمان که خطایی رخ دهد.
.IP \fB\-dp\fR 4
.IX Item "-dp"
.PD 0
.IP \fB\-\-dump=p\fR 4
.IX Item "--dump=p"
.PD
حاشیه‌نویسی خروجی اسمبلر با یادداشتی که نشان می‌دهد از کدام الگو و جایگزین استفاده شده است. طول و هزینه هر دستورالعمل نیز چاپ می‌شود.
.IP \fB\-dP\fR 4
.IX Item "-dP"
.PD 0
.IP \fB\-\-dump=P\fR 4
.IX Item "--dump=P"
.PD
تخلیه RTL در خروجی اسمبلر به صورت یک توضیح (comment) پیش از هر دستورالعمل. همچنین حاشیه‌نویسی \fB\-dp\fR را فعال می‌کند.
.IP \fB\-dx\fR 4
.IX Item "-dx"
.PD 0
.IP \fB\-\-dump=x\fR 4
.IX Item "--dump=x"
.PD
تنها تولید RTL برای یک تابع به جای کامپایل کردن آن. معمولاً به همراه \fB\-fdump\-rtl\-expand\fR استفاده می‌شود.
.RE
.RS 4
.RE
.IP \fB\-fdump\-debug\fR 4
.IX Item "-fdump-debug"
تخلیه اطلاعات اشکال‌زدایی تولیدشده در طول مرحله تولید اشکال‌زدایی.
.IP \fB\-fdump\-earlydebug\fR 4
.IX Item "-fdump-earlydebug"
تخلیه اطلاعات اشکال‌زدایی تولیدشده در طول مرحله زودهنگام تولید اشکال‌زدایی.
.IP \fB\-fdump\-noaddr\fR 4
.IX Item "-fdump-noaddr"
هنگام انجام تخلیه‌های اشکال‌زدایی، از چاپ آدرس‌ها جلوگیری می‌کند. این کار استفاده از diff را روی تخلیه‌های اشکال‌زدایی برای فراخوانی‌های کامپایلر با باینری‌های مختلف کامپایلر و/یا مکان‌های شروع متفاوت text / bss / data / heap / stack / dso امکان‌پذیرتر می‌سازد.
.IP \fB\-freport\-bug\fR 4
.IX Item "-freport-bug"
در صورت وقوع خطای داخلی کامپایلر (ICE)، اطلاعات اشکال‌زدایی را جمع‌آوری کرده و در یک فایل موقت تخلیه می‌کند.
.IP \fB\-fdump\-unnumbered\fR 4
.IX Item "-fdump-unnumbered"
هنگام انجام تخلیه‌های اشکال‌زدایی، شماره دستورالعمل‌ها و خروجی آدرس را حذف می‌کند. این امر استفاده از diff را روی تخلیه‌های اشکال‌زدایی برای فراخوانی‌های کامپایلر با گزینه‌های متفاوت، به ویژه با و بدون \&\fB\-g\fR، عملی‌تر می‌کند.
.IP \fB\-fdump\-unnumbered\-links\fR 4
.IX Item "-fdump-unnumbered-links"
هنگام انجام تخلیه‌های اشکال‌زدایی (گزینه \fB\-d\fR در بالا را ببینید)، شماره دستورالعمل‌ها را برای پیوندها به دستورالعمل‌های قبلی و بعدی در یک دنباله حذف می‌کند.
.IP \fB\-fdump\-internal\-locations\fR 4
.IX Item "-fdump-internal-locations"
تخلیه اطلاعات دقیق درباره بازنمایی داخلی GCC از مکان‌های کد منبع.
.IP \fB\-fdump\-ipa\-\fR\fIswitch\fR 4
.IX Item "-fdump-ipa-switch"
.PD 0
.IP \fB\-fdump\-ipa\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR 4
.IX Item "-fdump-ipa-switch-options"
.PD
کنترل تخلیه درخت زبان در مراحل مختلف تحلیل بین‌رویه‌ای (inter\-procedural analysis) درون یک فایل. نام فایل با افزودن یک پسوند ویژه switch به نام فایل منبع ایجاد می‌شود، و فایل در همان دایرکتوری فایل خروجی تولید می‌گردد. تخلیه‌های زیر امکان‌پذیر هستند:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
تمام تخلیه‌های تحلیل بین‌رویه‌ای را فعال می‌کند.
.IP \fBcgraph\fR 4
.IX Item "cgraph"
تخلیه اطلاعات مربوط به بهینه‌سازی گراف فراخوانی (call\-graph)، حذف توابع استفاده‌نشده و تصمیمات درون‌خطی‌سازی (inlining).
.IP \fBinline\fR 4
.IX Item "inline"
تخلیه پس از درون‌خطی‌سازی توابع.
.IP \fBstrubm\fR 4
.IX Item "strubm"
تخلیه پس از انتخاب حالت‌های \f(CW\*(C`strub\*(C'\fR و ثبت انتخاب‌ها به عنوان ویژگی‌های تابع (function attributes).
.IP \fBstrub\fR 4
.IX Item "strub"
تخلیه تبدیلات \f(CW\*(C`strub\*(C'\fR: تغییرات واسط (interface)، پوشش‌دهی تابع (function wrapping) و درج فراخوانی‌های توکار (builtin) برای پاکسازی پشته (stack scrubbing) و واترمارک‌گذاری.
.RE
.RS 4
.Sp
علاوه بر این، گزینه‌های \fB\-optimized\fR، \fB\-missed\fR،
\&\fB\-note\fR و \fB\-all\fR می‌توانند مشخص شوند که معنایی مشابه با
\fB\-fopt\-info\fR دارند، و مقدار پیش‌فرض آنها \fB\-optimized\fR است.
.Sp
به عنوان مثال، \fB\-fdump\-ipa\-inline\-optimized\-missed\fR اطلاعات مربوط به
جایگاه‌های فراخوانی (callsites) را که درون‌خطی شده‌اند، به همراه جایگاه‌های فراخوانی
که درون‌خطی نشده‌اند منتشر می‌کند.
.Sp
به طور پیش‌فرض، فایل تخلیه حاوی پیام‌هایی درباره بهینه‌سازی‌های موفق
(معادل با \fB\-optimized\fR) به همراه جزئیات سطح پایین در مورد تحلیل خواهد بود.
.RE
.IP \fB\-fdump\-ipa\-clones\fR 4
.IX Item "-fdump-ipa-clones"
ایجاد یک فایل تخلیه حاوی اطلاعات مربوط به ایجاد کلون‌های گره گراف فراخوانی و حذف گره‌های گراف فراخوانی در طول بهینه‌سازی‌ها و تبدیلات بین‌رویه‌ای. کاربرد اصلی مورد نظر آن این است که ابزارهای ایجاد وصله‌های زنده (live\-patches) بتوانند مجموعه‌ای از توابع را که برای جایگزینی کامل یک تابع خاص نیاز به وصله زنده دارند مشخص کنند (نگاه کنید به \&\fB\-flive\-patching\fR). نام فایل با افزودن پسوند \f(CW\*(C`ipa\-clones\*(C'\fR به نام فایل منبع ایجاد می‌شود و فایل در همان دایرکتوری فایل خروجی تولید می‌گردد. هر مدخل در فایل در یک خط جداگانه قرار دارد که شامل فیلدهای جداشده با نقطه ویرگول است.
.Sp
در حالت ایجاد کلون از گراف فراخوانی، هر یک از فیلدها عبارتند از:
.RS 4
.IP 1. 4
.IX Item "1."
رشته \f(CW\*(C`Callgraph clone\*(C'\fR.
.IP 2. 4
.IX Item "2."
نام تابعی که کلون می‌شود، به همان شکلی که به اسمبلر ارائه شده است.
.IP 3. 4
.IX Item "3."
عددی که تابع در حال کلون‌شدن را در گراف فراخوانی به صورت یکتا مشخص می‌کند. توجه داشته باشید که این عدد تنها درون یک واحد کامپایل یا درون تحلیل کل برنامه یکتا است اما به احتمال زیاد در این دو مرحله متفاوت خواهد بود.
.IP 4. 4
.IX Item "4."
نام فایل منبعی که تابع در آن تعریف شده است.
.IP 5. 4
.IX Item "5."
خطی که تعریف تابع در آن قرار دارد.
.IP 6. 4
.IX Item "6."
ستونی که تعریف تابع در آن قرار دارد.
.IP 7. 4
.IX Item "7."
نام کلون تابع جدید، به همان شکلی که به اسمبلر ارائه شده است.
.IP 8. 4
.IX Item "8."
عددی که کلون تابع جدید را در گراف فراخوانی به صورت یکتا مشخص می‌کند. توجه داشته باشید که این عدد تنها درون یک واحد کامپایل یا درون تحلیل کل برنامه یکتا است اما به احتمال زیاد در این دو مرحله متفاوت خواهد بود..IP 9. 4
.IX Item "9."
نام فایل منبعی که مکان کد منبع کلون جدید به آن اشاره می‌کند.
.IP 10. 4
.IX Item "10."
سطری که مکان کد منبع کلون جدید به آن اشاره می‌کند.
.IP 11. 4
.IX Item "11."
ستونی که مکان کد منبع کلون جدید به آن اشاره می‌کند.
.IP 12. 4
.IX Item "12."
رشته‌ای که دلیل کلون‌سازی را مشخص می‌کند.
.RE
.RS 4
.Sp
در صورت حذف کلون از گراف فراخوانی (call graph)، فیلدهای مربوطه عبارتند از:
.IP 1. 4
.IX Item "1."
رشتهٔ \f(CW\*(C`Callgraph removal\*(C'\fR.
.IP 2. 4
.IX Item "2."
نام تابعی که در حال حذف است، به همان صورتی که به اسمبلی‌کننده ارائه می‌شود.
.IP 3. 4
.IX Item "3."
عددی که به طور یکتا تابع در حال کلون شدن را در گراف فراخوانی مشخص می‌کند.
توجه داشته باشید که این عدد تنها در یک واحد کامپایل یا در تحلیل کل برنامه
(whole\-program analysis) یکتا است، اما به احتمال زیاد در این دو مرحله متفاوت خواهد بود.
.IP 4. 4
.IX Item "4."
نام فایل منبعی که تابع در آن تعریف شده است.
.IP 5. 4
.IX Item "5."
سطری که تعریف تابع در آن قرار دارد.
.IP 6. 4
.IX Item "6."
ستونی که تعریف تابع در آن قرار دارد.
.RE
.RS 4
.RE
.IP \fB\-fdump\-lang\fR 4
.IX Item "-fdump-lang"
برون‌ریزی اطلاعات مختص زبان. نام فایل با افزودن
\&\fI.lang\fR به نام فایل منبع ساخته می‌شود.
.IP \fB\-fdump\-lang\-all\fR 4
.IX Item "-fdump-lang-all"
.PD 0
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR 4
.IX Item "-fdump-lang-switch"
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR 4
.IX Item "-fdump-lang-switch-options"
.IP \fB\-fdump\-lang\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR 4
.IX Item "-fdump-lang-switch-options=filename"
.PD
کنترل برون‌ریزی اطلاعات مختص زبان. بخش‌های \fIoptions\fR
و \fIfilename\fR همان‌گونه که در گزینهٔ
\&\fB\-fdump\-tree\fR توضیح داده شده رفتار می‌کنند. گزینهٔ \fB\-fdump\-tree\-all\fR تمام
برون‌ریزی‌های مختص زبان را فعال می‌کند؛ سایر گزینه‌ها بسته به زبان متفاوت هستند. برای
نمونه، ببینید
.IP \fB\-fdump\-passes\fR 4
.IX Item "-fdump-passes"
چاپ فهرست گذرهای بهینه‌سازی فعال یا غیرفعال‌شده توسط گزینه‌های فعلی خط فرمان روی \fIstderr\fR.
.IP \fB\-fdump\-statistics\-\fR\fIoption\fR 4
.IX Item "-fdump-statistics-option"
فعال‌سازی و کنترل برون‌ریزی آمار گذرها در فایلی جداگانه. نام
فایل با افزودن پسوندی که به
\&\fB.statistics\fR ختم می‌شود به نام فایل منبع تولید می‌گردد و فایل در
همان دایرکتوری فایل خروجی ایجاد می‌شود. اگر از قالب \fB\-\fR\fIoption\fR
استفاده شود، \fB\-stats\fR باعث جمع بستن شمارنده‌ها روی
کل واحد کامپایل می‌شود، در حالی که \fB\-details\fR تک‌تک رویدادها را به
محض تولید توسط گذرها برون‌ریزی می‌کند. حالت پیش‌فرض بدون هیچ گزینه‌ای، جمع بستن
شمارنده‌ها برای هر تابع کامپایل‌شده است.
.IP \fB\-fdump\-tree\-all\fR 4
.IX Item "-fdump-tree-all"
.PD 0
.IP \fB\-fdump\-tree\-\fR\fIswitch\fR 4
.IX Item "-fdump-tree-switch"
.IP \fB\-fdump\-tree\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR 4
.IX Item "-fdump-tree-switch-options"
.IP \fB\-fdump\-tree\-\fR\fIswitch\fR\fB\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR 4
.IX Item "-fdump-tree-switch-options=filename"
.PD
کنترل برون‌ریزی درخت زبان واسط در مراحل مختلف پردازش در یک فایل. اگر از قالب \fB\-\fR\fIoptions\fR
استفاده شود، \fIoptions\fR فهرستی از گزینه‌های جداشده با \fB\-\fR
است که جزئیات برون‌ریزی را کنترل می‌کنند. همهٔ گزینه‌ها برای
همهٔ برون‌ریزی‌ها قابل اعمال نیستند؛ مواردی که کاربردی ندارند نادیده گرفته می‌شوند.
گزینه‌های زیر در دسترس هستند
.RS 4
.IP \fBaddress\fR 4
.IX Item "address"
چاپ آدرس هر گره. معمولاً این گزینه معنای خاصی ندارد، چرا که بر اساس محیط و فایل منبع
تغییر می‌کند. کاربرد اصلی آن برای مطابقت دادن یک فایل برون‌ریزی با محیط اشکال‌زدایی است.
.IP \fBasmname\fR 4
.IX Item "asmname"
اگر \f(CW\*(C`DECL_ASSEMBLER_NAME\*(C'\fR برای یک اعلان مشخص تنظیم شده باشد، به جای
\f(CW\*(C`DECL_NAME\*(C'\fR از آن در برون‌ریزی استفاده می‌شود. کاربرد اصلی آن، سهولت در
ردیابی معکوس از نام‌های درهم‌ریخته (mangled names) در فایل اسمبلی است.
.IP \fBslim\fR 4
.IX Item "slim"
هنگام برون‌ریزی بازنمایی‌های واسط فرانت‌اند، از برون‌ریزی اعضای یک حوزه (scope) یا بدنهٔ یک
تابع صرفاً به این دلیل که به آن حوزه رسیده است جلوگیری می‌کند. تنها مواردی
برون‌ریزی می‌شوند که مستقیماً از طریق مسیر دیگری قابل دسترسی باشند.
.Sp
هنگام برون‌ریزی درخت‌های چاپ زیبا، این گزینه از برون‌ریزی بدنهٔ ساختارهای کنترلی جلوگیری می‌کند.
.Sp
هنگام برون‌ریزی RTL، خروجی RTL را به جای بازنمایی پیش‌فرض مشابه لیسپ (LISP\-like)، به صورت
مختصر (slim) چاپ می‌کند.
.IP \fBraw\fR 4
.IX Item "raw"
چاپ بازنمایی خام (raw) از درخت. به طور پیش‌فرض، درخت‌ها با چاپ زیبا به
شکلی مشابه با ساختار زبان C بازنمایی می‌شوند.
.IP \fBdetails\fR 4
.IX Item "details"
فعال‌سازی برون‌ریزی‌های دقیق‌تر (توسط همهٔ گزینه‌های برون‌ریزی اعمال نمی‌شود). همچنین
اطلاعات گذرهای بهینه‌سازی را شامل می‌شود.
.IP \fBstats\fR 4
.IX Item "stats"
فعال‌سازی برون‌ریزی آمارهای گوناگون دربارهٔ گذر (توسط همهٔ گزینه‌های برون‌ریزی اعمال
نمی‌شود).
.IP \fBblocks\fR 4
.IX Item "blocks"
فعال‌سازی نمایش مرزهای بلوک پایه (در برون‌ریزی‌های خام غیرفعال است).
.IP \fBgraph\fR 4
.IX Item "graph"
برای هر یک از دیگر فایل‌های برون‌ریزی مشخص‌شده (\fB\-fdump\-rtl\-\fR\fIpass\fR)،
بازنمایی‌ای از گراف جریان کنترل که مناسب مشاهده با GraphViz باشد را در فایل \fIfile.passid.pass.dot\fR
برون‌ریزی می‌کند. هر تابع در فایل به صورت یک زیرگراف (subgraph) با فرمت زیبا چاپ می‌شود،
تا GraphViz بتواند همهٔ آن‌ها را در یک نمودار واحد رسم کند.
.Sp
‏RTL همیشه به صورت خلاصه (slim) برون‌ریزی می‌شود.
.IP \fBvops\fR 4
.IX Item "vops"
فعال‌سازی نمایش عملوندهای مجازی برای هر عبارت.
.IP \fBlineno\fR 4
.IX Item "lineno"
فعال‌سازی نمایش شماره سطرها برای عبارت‌ها.
.IP \fBuid\fR 4
.IX Item "uid"
فعال‌سازی نمایش شناسهٔ یکتا (\f(CW\*(C`DECL_UID\*(C'\fR) برای هر متغیر.
.IP \fBverbose\fR 4
.IX Item "verbose"
فعال‌سازی نمایش برون‌ریزی درخت برای هر عبارت.
.IP \fBeh\fR 4
.IX Item "eh"
فعال‌سازی نمایش شماره ناحیهٔ EH که هر عبارت را در بر می‌گیرد.
.IP \fBscev\fR 4
.IX Item "scev"
فعال‌سازی نمایش جزئیات تحلیل تکامل اسکالر (scalar evolution).
.IP \fBoptimized\fR 4
.IX Item "optimized"
فعال‌سازی نمایش اطلاعات بهینه‌سازی (تنها در گذرهای مشخصی موجود است).
.IP \fBmissed\fR 4
.IX Item "missed"
فعال‌سازی نمایش اطلاعات بهینه‌سازی‌های از دست رفته (تنها در گذرهای مشخصی موجود است).
.IP \fBnote\fR 4
.IX Item "note"
فعال‌سازی سایر اطلاعات تفصیلی بهینه‌سازی (تنها در گذرهای مشخصی موجود است).
.IP \fBfolding\fR 4
.IX Item "folding"
فعال‌سازی برون‌ریزی اطلاعات الگوهای تطبیق و ساده‌سازی (match.pd)، در هنگام اعمال شدن آن‌ها.
.IP \fBall\fR 4
.IX Item "all"
فعال‌سازی تمام گزینه‌ها، به جز \fBraw\fR، \fBslim\fR، \fBverbose\fR
و \fBlineno\fR.
.IP \fBoptall\fR 4
.IX Item "optall"
فعال‌سازی تمام گزینه‌های بهینه‌سازی، یعنی \fBoptimized\fR،
\&\fBmissed\fR و \fBnote\fR.
.RE
.RS 4
.Sp
برای تعیین اینکه چه برون‌ریزی‌های درختی در دسترس هستند یا یافتن برون‌ریزی برای یک گذر
مورد نظر، مراحل زیر را دنبال کنید..IP 1. 4
.IX Item "1."
کامپایلر GCC را با \fB\-fdump\-passes\fR فراخوانی کنید و در خروجی \fIstderr\fR به‌دنبال کدی بگردید که متناظر با گذر (pass) مد نظر شماست.
برای نمونه، کدهای \f(CW\*(C`tree\-evrp\*(C'\fR، \f(CW\*(C`tree\-vrp1\*(C'\fR و
\&\f(CW\*(C`tree\-vrp2\*(C'\fR متناظر با سه گذرِ Value Range Propagation هستند.
عدد انتهای نام، فراخوانی‌های متمایزِ همان گذر را تفکیک می‌کند.
.IP 2. 4
.IX Item "2."
برای فعال‌سازی ایجاد فایل تخلیه (dump file)، کد گذر را به
پیشوند گزینهٔ \fB\-fdump\-\fR الحاق کرده و GCC را با آن فراخوانی کنید. برای نمونه،
جهت فعال‌سازی خروجی تخلیه از گذر Early Value Range Propagation، کامپایلر
GCC را با گزینهٔ \fB\-fdump\-tree\-evrp\fR فراخوانی نمایید. به‌صورت اختیاری، می‌توانید
نام فایل تخلیه را نیز مشخص کنید. اگر نامی تعیین نکنید، GCC
آن را طبق توضیحات زیر ایجاد می‌کند.
.IP 3. 4
.IX Item "3."
خروجی تخلیهٔ گذر را در فایلی بیابید که نام آن از سه مؤلفه تشکیل شده و
با نقطه از یکدیگر جدا شده‌اند: نام فایل مبدأیی که GCC برای کامپایل آن فراخوانی
شده است، یک پسوند عددی که بیانگر شمارهٔ گذر است و به‌دنبال آن حرف \fBt\fR برای
گذرهای درختی (و حرف \fBr\fR برای گذرهای RTL) می‌آید، و در نهایت کد گذر.
برای نمونه، تخلیهٔ گذر Early VRP ممکن است در فایلی با نام \fImyfile.c.038t.evrp\fR
در دایرکتوری کاری فعلی باشد. توجه داشته باشید که این کدهای عددی پایدار نیستند
و ممکن است از یک نگارش GCC به نگارش دیگر تغییر کنند.
.RE
.RS 4
.RE
.IP \fB\-fopt\-info\fR 4
.IX Item "-fopt-info"
.PD 0
.IP \fB\-fopt\-info\-\fR\fIoptions\fR 4
.IX Item "-fopt-info-options"
.IP \fB\-fopt\-info\-\fR\fIoptions\fR\fB=\fR\fIfilename\fR 4
.IX Item "-fopt-info-options=filename"
.PD
خروجی‌های تخلیهٔ بهینه‌سازی را از گذرهای مختلف بهینه‌سازی کنترل می‌کند. اگر از
قالب \&\fB\-\fR\fIoptions\fR استفاده شود، \fIoptions\fR فهرستی از کلمات کلیدی گزینه‌ها
است که با \&\fB\-\fR از هم جدا شده‌اند تا جزئیات تخلیه و بهینه‌سازی‌ها را
انتخاب نمایند.
.Sp
می‌توان \fIoptions\fR را به سه گروه تقسیم کرد:
.RS 4
.IP 1. 4
.IX Item "1."
گزینه‌هایی که تعیین می‌کنند چه نوع پیام‌هایی باید صادر شوند،
.IP 2. 4
.IX Item "2."
گزینه‌هایی که میزان پرگویی (verbosity) خروجی تخلیه را مشخص می‌کنند، و
.IP 3. 4
.IX Item "3."
گزینه‌هایی که مشخص می‌کنند کدام بهینه‌سازی‌ها باید لحاظ گردند.
.RE
.RS 4
.Sp
گزینه‌های هر گروه را می‌توان آزادانه با یکدیگر ترکیب کرد زیرا فاقد
هم‌پوشانی هستند. با این حال، در صورت بروز هرگونه تعارض،
گزینه‌های پسین در خط فرمان بر گزینه‌های پیشین اولویت یافته
و جایگزین آن‌ها می‌شوند.
.Sp
گزینه‌های زیر کنترل می‌کنند که چه نوع پیام‌هایی باید صادر شوند:
.IP \fBoptimized\fR 4
.IX Item "optimized"
چاپ اطلاعات هنگام اعمال موفقیت‌آمیز یک بهینه‌سازی. تعیین اینکه
کدام اطلاعات مرتبط هستند بر عهدهٔ گذر است. برای نمونه، گذرهای
بردارساز (vectorizer) موقعیت حلقه‌هایی را در کد مبدأ چاپ می‌کنند که با
موفقیت برداری‌سازی شده‌اند.
.IP \fBmissed\fR 4
.IX Item "missed"
چاپ اطلاعات دربارهٔ بهینه‌سازی‌های ازدست‌رفته. هر گذر به‌طور مجزا
مشخص می‌کند چه اطلاعاتی در خروجی گنجانده شود.
.IP \fBnote\fR 4
.IX Item "note"
چاپ اطلاعات تفصیلی دربارهٔ بهینه‌سازی‌ها، مانند برخی دگرگونی‌ها،
پیام‌های با جزئیات بیشتر دربارهٔ تصمیم‌گیری‌ها و غیره.
.IP \fBall\fR 4
.IX Item "all"
چاپ اطلاعات با جزئیات دربارهٔ بهینه‌سازی. این شامل
\&\fBoptimized\fR، \fBmissed\fR و \fBnote\fR است.
.RE
.RS 4
.Sp
گزینهٔ زیر میزان پرگویی تخلیه را کنترل می‌کند:
.IP \fBinternals\fR 4
.IX Item "internals"
به‌طور پیش‌فرض، فقط پیام‌های «سطح بالا» صادر می‌شوند. این گزینه پیام‌های
اضافی و با جزئیات بیشتر را فعال می‌کند که احتمالاً تنها برای توسعه‌دهندگان
GCC حائز اهمیت خواهند بود.
.RE
.RS 4
.Sp
یک یا چند کلمهٔ کلیدی زیر را می‌توان برای توصیف گروهی از بهینه‌سازی‌ها
به کار برد:
.IP \fBipa\fR 4
.IX Item "ipa"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌های بین‌روالی (interprocedural).
.IP \fBloop\fR 4
.IX Item "loop"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌های حلقه.
.IP \fBinline\fR 4
.IX Item "inline"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌های درون‌خطی‌سازی (inlining).
.IP \fBomp\fR 4
.IX Item "omp"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌های OMP (تخلیه بار محاسباتی و چندپردازشی).
.IP \fBvec\fR 4
.IX Item "vec"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌های برداری‌سازی (vectorization).
.IP \fBoptall\fR 4
.IX Item "optall"
فعال‌سازی تخلیه از تمام بهینه‌سازی‌ها. این یک ابرمجموعه از
گروه‌های بهینه‌سازی ذکرشده در بالاست.
.RE
.RS 4
.Sp
اگر \fIoptions\fR
حذف شود، مقدار پیش‌فرض آن \fBoptimized\-optall\fR خواهد بود، به این معنی که پیام‌های
مربوط به بهینه‌سازی‌های موفقیت‌آمیز از تمام گذرها تخلیه شده و از پیام‌هایی که
به‌عنوان «داخلی» (internals) تلقی می‌شوند صرف‌نظر می‌گردد.
.Sp
اگر \fIfilename\fR ارائه شود، خروجی‌های تخلیه از تمام بهینه‌سازی‌های
قابل‌اعمال در \fIfilename\fR الحاق و تجمیع می‌شوند.
در غیر این صورت، خروجی تخلیه در \fIstderr\fR فرستاده می‌شود. هرچند چندین
گزینهٔ \&\fB\-fopt\-info\fR پذیرفته می‌شود، تنها یکی از آن‌ها می‌تواند حاوی
یک \fIfilename\fR باشد. اگر نام‌های فایل دیگری مشخص شوند، به جز نخستین
گزینه، سایر موارد نادیده گرفته می‌شوند.
.Sp
توجه داشته باشید که در صورت وجود چندین واحد ترجمه، فایل خروجی
\&\fIfilename\fR بازنویسی می‌شود. اگر یک خروجی ترکیبی از چند واحد
ترجمه مد نظر باشد، باید در عوض از \fIstderr\fR استفاده شود.
.Sp
در مثال زیر، اطلاعات بهینه‌سازی در
\&\fIstderr\fR خروجی داده می‌شود:
.Sp
.Vb 1
\&        gcc \-O3 \-fopt\-info
.Ve
.Sp
این مثال:
.Sp
.Vb 1
\&        gcc \-O3 \-fopt\-info\-missed=missed.all
.Ve
.Sp
گزارش بهینه‌سازی‌های ازدست‌رفته از تمام گذرها را در
\&\fImissed.all\fR خروجی می‌دهد، و این مورد:
.Sp
.Vb 1
\&        gcc \-O2 \-ftree\-vectorize \-fopt\-info\-vec\-missed
.Ve
.Sp
اطلاعات مربوط به فرصت‌های بهینه‌سازیِ ازدست‌رفته از گذرهای برداری‌سازی
را در \fIstderr\fR چاپ می‌کند.
توجه داشته باشید که \fB\-fopt\-info\-vec\-missed\fR معادل
\&\fB\-fopt\-info\-missed\-vec\fR است. ترتیب نام گروه‌های بهینه‌سازی
و انواع پیام‌های فهرست‌شده پس از \fB\-fopt\-info\fR اهمیتی ندارد.
.Sp
به‌عنوان مثالی دیگر،
.Sp
.Vb 1
\&        gcc \-O3 \-fopt\-info\-inline\-optimized\-missed=inline.txt
.Ve
.Sp
اطلاعات مربوط به بهینه‌سازی‌های ازدست‌رفته و نیز مکان‌های بهینه‌شده
از تمامی گذرهای درون‌خطی‌سازی را در
\&\fIinline.txt\fR خروجی می‌دهد.
.Sp
در نهایت، دستور زیر را در نظر بگیرید:
.Sp
.Vb 1
\&        gcc \-fopt\-info\-vec\-missed=vec.miss \-fopt\-info\-loop\-optimized=loop.opt
.Ve
.Sp
در اینجا دو نام فایل خروجی \fIvec.miss\fR و \fIloop.opt\fR دچار
تداخل می‌شوند، چرا که تعیین تنها یک فایل خروجی مجاز است. در این حالت، فقط
گزینهٔ اول اعمال شده و گزینه‌های پس از آن نادیده
گرفته می‌شوند؛ بنابراین تنها \fIvec.miss\fR تولید می‌شود که شامل
تخلیه‌های ارائه‌شده از بردارساز پیرامون فرصت‌های ازدست‌رفته است.
.RE.IP \fB\-fsave\-optimization\-record\fR 4
.IX Item "-fsave-optimization-record"
یک فایل SRCFILE.opt\-record.json.gz با ذکر جزئیات بهینه‌سازی‌های انجام‌شده، برای آن دسته از بهینه‌سازی‌هایی که از \fB\-fopt\-info\fR پشتیبانی می‌کنند، می‌نویسد.
.Sp
این گزینه آزمایشی است و قالب داده‌های درون فایل فشردهٔ JSON ممکن است تغییر کند.
.Sp
این گزینه تقریباً معادل یک نسخهٔ ماشین‌خوان از \&\fB\-fopt\-info\-all\fR است، به‌صورت مجموعه‌ای از پیام‌ها به همراه فایل منبع، شماره خط و شماره ستون، با داده‌های اضافی زیر برای هر پیام:
.RS 4
.IP * 4
تعداد دفعات اجرای کدی که در حال بهینه‌سازی است، به همراه فراداده‌ای درباره اینکه آیا این مقدار از داده‌های واقعی پروفایل‌سازی به‌دست آمده یا صرفاً یک برآورد است، که به مصرف‌کنندگان اجازه می‌دهد پیام‌ها را بر اساس میزان داغی (hotness) کد اولویت‌بندی کنند،
.IP * 4
نام تابعِ کدی که در حال بهینه‌سازی است، در صورت امکان،
.IP * 4
«زنجیرهٔ درون‌خطی‌سازی» (inlining chain) برای کدی که در حال بهینه‌سازی است، به طوری که وقتی یک تابع در چندین مکان مختلف درون‌خطی می‌شود (که ممکن است خودشان نیز درون‌خطی شده باشند)، خواننده بتواند نسخه‌ها را از یکدیگر تشخیص دهد،
.IP * 4
اشیایی که آن بخش‌هایی از پیام را که به عبارت‌ها، دستورها یا گره‌های جدول نماد ارجاع دارند، این‌که جزء کدام‌یک از این دسته‌ها هستند، و در صورت موجود بودن، مکان آن‌ها در کد منبع را مشخص می‌کنند،
.IP * 4
گذر GCC که پیام را صادر کرده است، و
.IP * 4
مکانی در کد خود GCC که پیام از آنجا صادر شده است
.RE
.RS 4
.Sp
علاوه بر این، برخی از پیام‌ها به‌طور منطقی درون پیام‌های دیگر تو در تو هستند، که بازتاب‌دهندهٔ جزئیات پیاده‌سازی گذرهای بهینه‌سازی است.
.RE
.IP \fB\-fsched\-verbose=\fR\fIn\fR 4
.IX Item "-fsched-verbose=n"
در مقصدهایی که از زمان‌بندی دستورالعمل استفاده می‌کنند، این گزینه مقدار خروجی اشکال‌زدایی‌ای را که زمان‌بند در فایل‌های dump می‌نویسد کنترل می‌کند.
.Sp
به ازای \fIn\fR بزرگ‌تر از صفر، \fB\-fsched\-verbose\fR همان اطلاعات \fB\-fdump\-rtl\-sched1\fR و \fB\-fdump\-rtl\-sched2\fR را خروجی می‌دهد. برای \fIn\fR بزرگ‌تر از یک، احتمالات بلوک پایه (basic block)، اطلاعات دقیق فهرست آماده و اطلاعات واحد/دستورالعمل (unit/insn) را نیز خروجی می‌دهد. برای \fIn\fR بزرگ‌تر از دو، شامل RTL در نقطهٔ لغو (abort)، جریان کنترل و اطلاعات نواحی می‌شود. و برای \fIn\fR بیش از چهار، \fB\-fsched\-verbose\fR اطلاعات وابستگی را نیز شامل می‌شود.
.IP \fB\-fenable\-\fR\fIkind\fR\fB\-\fR\fIpass\fR 4
.IX Item "-fenable-kind-pass"
.PD 0
.IP \fB\-fdisable\-\fR\fIkind\fR\fB\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR 4
.IX Item "-fdisable-kind-pass=range-list"
.PD
این مجموعه‌ای از گزینه‌هاست که برای فعال یا غیرفعال کردن صریح گذرهای بهینه‌سازی استفاده می‌شوند. این گزینه‌ها برای اشکال‌زدایی GCC در نظر گرفته شده‌اند. کاربران کامپایلر در عوض باید از گزینه‌های معمول برای فعال یا غیرفعال کردن گذرها استفاده کنند.
.RS 4
.IP \fB\-fdisable\-ipa\-\fR\fIpass\fR 4
.IX Item "-fdisable-ipa-pass"
گذر IPA با نام \fIpass\fR را غیرفعال می‌کند. \fIpass\fR نام گذر است. اگر همان گذر به‌طور ایستا چندین بار در کامپایلر فراخوانی شود، یک شمارهٔ ترتیبی با شروع از ۱ باید به انتهای نام گذر افزوده شود.
.IP \fB\-fdisable\-rtl\-\fR\fIpass\fR 4
.IX Item "-fdisable-rtl-pass"
.PD 0
.IP \fB\-fdisable\-rtl\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR 4
.IX Item "-fdisable-rtl-pass=range-list"
.PD
گذر RTL با نام \fIpass\fR را غیرفعال می‌کند. \fIpass\fR نام گذر است. اگر همان گذر به‌طور ایستا چندین بار در کامپایلر فراخوانی شود، یک شمارهٔ ترتیبی با شروع از ۱ باید به انتهای نام گذر افزوده شود. \fIrange\-list\fR فهرستی جداشده با کاما از محدوده‌های توابع یا نام‌های اسمبلی است. هر محدوده یک جفت‌عدد جداشده با دونقطه است. محدوده در هر دو انتها شامل شونده است. اگر محدوده بدیهی باشد، جفت‌عدد می‌تواند به یک عدد منفرد ساده شود. اگر شناسهٔ \fIuid\fR گرهٔ گراف فراخوانی تابع درون یکی از محدوده‌های مشخص‌شده قرار گیرد، آن \fIpass\fR برای آن تابع غیرفعال می‌شود. مقدار \fIuid\fR در سرآیند تابع در یک فایل dump نمایش داده می‌شود، و نام‌های گذرها را می‌توان با استفاده از گزینهٔ \fB\-fdump\-passes\fR خروجی گرفت (dump کرد).
.IP \fB\-fdisable\-tree\-\fR\fIpass\fR 4
.IX Item "-fdisable-tree-pass"
.PD 0
.IP \fB\-fdisable\-tree\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR 4
.IX Item "-fdisable-tree-pass=range-list"
.PD
گذر tree با نام \fIpass\fR را غیرفعال می‌کند. برای شرح آرگومان‌های گزینه به \fB\-fdisable\-rtl\fR مراجعه کنید.
.IP \fB\-fenable\-ipa\-\fR\fIpass\fR 4
.IX Item "-fenable-ipa-pass"
گذر IPA با نام \fIpass\fR را فعال می‌کند. \fIpass\fR نام گذر است. اگر همان گذر به‌طور ایستا چندین بار در کامپایلر فراخوانی شود، یک شمارهٔ ترتیبی با شروع از ۱ باید به انتهای نام گذر افزوده شود.
.IP \fB\-fenable\-rtl\-\fR\fIpass\fR 4
.IX Item "-fenable-rtl-pass"
.PD 0
.IP \fB\-fenable\-rtl\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR 4
.IX Item "-fenable-rtl-pass=range-list"
.PD
گذر RTL با نام \fIpass\fR را فعال می‌کند. برای شرح آرگومان‌های گزینه و مثال‌ها به \fB\-fdisable\-rtl\fR مراجعه کنید.
.IP \fB\-fenable\-tree\-\fR\fIpass\fR 4
.IX Item "-fenable-tree-pass"
.PD 0
.IP \fB\-fenable\-tree\-\fR\fIpass\fR\fB=\fR\fIrange\-list\fR 4
.IX Item "-fenable-tree-pass=range-list"
.PD
گذر tree با نام \fIpass\fR را فعال می‌کند. برای شرح آرگومان‌های گزینه به \fB\-fdisable\-rtl\fR مراجعه کنید.
.RE
.RS 4
.Sp
در اینجا چند مثال آورده شده است که نحوهٔ استفاده از این گزینه‌ها را نشان می‌دهند.
.Sp
.Vb 10
\&        # disable ccp1 for all functions
\&           \-fdisable\-tree\-ccp1
\&        # disable complete unroll for function whose cgraph node uid is 1
\&           \-fenable\-tree\-cunroll=1
\&        # disable gcse2 for functions at the following ranges [1,1],
\&        # [300,400], and [400,1000]
\&        # disable gcse2 for functions foo and foo2
\&           \-fdisable\-rtl\-gcse2=foo,foo2
\&        # disable early inlining
\&           \-fdisable\-tree\-einline
\&        # disable ipa inlining
\&           \-fdisable\-ipa\-inline
\&        # enable tree full unroll
\&           \-fenable\-tree\-unroll
.Ve
.RE
.IP \fB\-fchecking\fR 4
.IX Item "-fchecking"
.PD 0
.IP \fB\-fchecking=\fR\fIn\fR 4
.IX Item "-fchecking=n"
.PD
بررسی‌های سازگاری داخلی را فعال می‌کند. پیش‌فرض به پیکربندی کامپایلر بستگی دارد. \fB\-fchecking=2\fR بررسی‌های سازگاری داخلی بیشتری را فعال می‌کند که ممکن است بر تولید کد تأثیر بگذارند.
.IP \fB\-frandom\-seed=\fR\fIstring\fR 4
.IX Item "-frandom-seed=string"
این گزینه بذری (seed) را فراهم می‌کند که GCC به‌جای اعداد تصادفی در تولید نام‌های نماد خاصی استفاده می‌کند که باید در هر فایل کامپایل‌شده متفاوت باشند. همچنین برای قرار دادن مُهرهای یکتا در فایل‌های دادهٔ پوشش (coverage) و فایل‌های شیءِ تولیدکنندهٔ آن‌ها استفاده می‌شود. می‌توانید از گزینهٔ \fB\-frandom\-seed\fR برای تولید فایل‌های شیءِ بازتولیدپذیر و دقیقاً یکسان استفاده کنید.
.Sp
مقدار \fIstring\fR می‌تواند یک عدد (ده‌دهی، هشت‌هشتی یا شانزده‌شانزدهی) یا یک رشتهٔ دلخواه باشد (که در این حالت با محاسبهٔ CRC32 به یک عدد تبدیل می‌شود).
.Sp
مقدار \fIstring\fR باید برای هر فایلی که کامپایل می‌کنید متفاوت باشد.
.IP \fB\-save\-temps\fR 4
.IX Item "-save-temps"
.PD 0
.IP \fB\-\-save\-temps\fR 4
.IX Item "--save-temps"
.PD
فایل‌های میانی معمولاً «موقت» را به‌طور دائمی ذخیره می‌کند؛ آن‌ها را طبق آنچه ذیل \&\fB\-dumpbase\fR و \fB\-dumpdir\fR شرح داده شده، به‌عنوان فایل‌های خروجی کمکی نام‌گذاری می‌کند.
.Sp
هنگامی که در ترکیب با گزینهٔ خط فرمان \fB\-x\fR استفاده شود، \&\fB\-save\-temps\fR آن‌قدر هوشمند است که از بازنویسی روی یک فایل منبع ورودی با پسوند مشابه با یک فایل میانی جلوگیری کند. فایل میانی متناظر را می‌توان با تغییر نام فایل منبع قبل از استفاده از \fB\-save\-temps\fR به دست آورد.
.IP \fB\-save\-temps=cwd\fR 4
.IX Item "-save-temps=cwd"
معادل با \fB\-save\-temps \-dumpdir ./\fR است.
.IP \fB\-save\-temps=obj\fR 4
.IX Item "-save-temps=obj"
معادل با \fB\-save\-temps \-dumpdir \fR\f(BIoutdir/\fR است، که در آن \&\fIoutdir/\fR دایرکتوری فایل خروجی مشخص‌شده پس از گزینهٔ \&\fB\-o\fR، از جمله هرگونه جداکنندهٔ دایرکتوری است. اگر گزینهٔ \&\fB\-o\fR استفاده نشود، سوییچ \fB\-save\-temps=obj\fR مانند \fB\-save\-temps=cwd\fR رفتار می‌کند..IP \fB\-specs=\fR\fIfile\fR 4
.IX Item "-specs=file"
.PD 0
.IP \fB\-\-specs=\fR\fIfile\fR 4
.IX Item "--specs=file"
.IP "\fB\-\-specs\fR \fIfile\fR" 4
.IX Item "--specs file"
.PD
پردازش \fIfile\fR پس از آنکه کامپایلر فایل استاندارد \fIspecs\fR را خواند، به منظور بازنویسی پیش‌فرض‌هایی که برنامهٔ راه‌انداز \fBgcc\fR هنگام تعیین سوییچ‌های ارسالی به \fBcc1\fR،
\&\fBcc1plus\fR، \fBas\fR، \fBld\fR و غیره به کار می‌برد. بیش از یک
\&\fB\-specs=\fR\fIfile\fR می‌تواند در خط فرمان مشخص شود، و آن‌ها به ترتیب، از چپ به راست پردازش می‌شوند.
.IP \fB\-time\fR[\fB=\fR\fIfile\fR] 4
.IX Item "-time[=file]"
گزارش زمان CPU صرف‌شده توسط هر زیرپردازش در توالی کامپایل. برای فایل‌های منبع C، این شامل خود کامپایلر و اسمبلر است (بعلاوهٔ پیونددهنده اگر پیوندزنی انجام شود).
.Sp
بدون مشخص کردن فایل خروجی، خروجی به این صورت خواهد بود:
.Sp
.Vb 2
\&        # cc1 0.12 0.01
\&        # as 0.00 0.01
.Ve
.Sp
نخستین عدد در هر خط، «زمان کاربر» است، یعنی زمانی که صرف اجرای خود برنامه شده است. عدد دوم «زمان سیستم» است، زمانی که صرف اجرای روال‌های سیستم‌عامل از طرف برنامه شده است. هر دو عدد بر حسب ثانیه هستند.
.Sp
با مشخص کردن یک فایل خروجی، خروجی به انتهای فایل نام‌برده الحاق می‌شود، و به این صورت خواهد بود:
.Sp
.Vb 2
\&        0.12 0.01 cc1 <options>
\&        0.00 0.01 as <options>
.Ve
.Sp
«زمان کاربر» و «زمان سیستم» به پیش از نام برنامه منتقل می‌شوند، و گزینه‌های ارسال‌شده به برنامه نمایش داده می‌شوند، تا بعداً بتوان فهمید چه فایلی، و با چه گزینه‌هایی در حال کامپایل بوده است.
.IP \fB\-fdump\-final\-insns\fR[\fB=\fR\fIfile\fR] 4
.IX Item "-fdump-final-insns[=file]"
تخلیهٔ (dump) بازنمایی درونی نهایی (RTL) در \fIfile\fR. اگر آرگومان اختیاری حذف شود (یا اگر \fIfile\fR برابر با \f(CW\*(C`.\*(C'\fR باشد)، نام فایل dump با الحاق \f(CW\*(C`.gkd\*(C'\fR به نام پایهٔ dump تعیین می‌شود؛ \fB\-dumpbase\fR را ببینید.
.IP \fB\-fcompare\-debug\fR[\fB=\fR\fIopts\fR] 4
.IX Item "-fcompare-debug[=opts]"
اگر هیچ خطایی در طول کامپایل رخ ندهد، کامپایلر را برای بار دوم اجرا می‌کند، و \fIopts\fR و \fB\-fcompare\-debug\-second\fR را به آرگومان‌های ارسالی به کامپایل دوم می‌افزاید. بازنمایی درونی نهایی در هر دو کامپایل dump می‌شود، و در صورت وجود تفاوت، یک خطا چاپ می‌کند.
.Sp
اگر علامت مساوی حذف شود، مقدار پیش‌فرض \fB\-gtoggle\fR استفاده می‌شود.
.Sp
متغیر محیطی \fBGCC_COMPARE_DEBUG\fR، در صورت تعریف شدن، غیرخالی بودن و غیرصفر بودن، به‌طور ضمنی \fB\-fcompare\-debug\fR را فعال می‌کند. اگر \fBGCC_COMPARE_DEBUG\fR با یک رشته که با خط تیره آغاز می‌شود تعریف شده باشد، برای \fIopts\fR استفاده می‌شود؛ در غیر این صورت، مقدار پیش‌فرض \fB\-gtoggle\fR به کار می‌رود.
.Sp
\&\fB\-fcompare\-debug=\fR، با علامت مساوی اما بدون \fIopts\fR، معادل \fB\-fno\-compare\-debug\fR است، که dump کردن بازنمایی نهایی و کامپایل دوم را غیرفعال کرده و حتی از اثرگذاری \fBGCC_COMPARE_DEBUG\fR نیز جلوگیری می‌کند.
.Sp
برای بررسی پوشش کامل در طول آزمایش \fB\-fcompare\-debug\fR، متغیر \fBGCC_COMPARE_DEBUG\fR را مثلاً روی \fB\-fcompare\-debug\-not\-overridden\fR تنظیم کنید، که GCC آن را به عنوان یک گزینهٔ نامعتبر در هر کامپایل واقعی (به جز پیش‌پردازش، اسمبلی یا پیوندزنی) رد می‌کند. برای دریافت فقط یک هشدار، تنظیم \fBGCC_COMPARE_DEBUG\fR روی \fB\-w%n\-fcompare\-debug not overridden\fR کافی خواهد بود.
.IP \fB\-fcompare\-debug\-second\fR 4
.IX Item "-fcompare-debug-second"
این گزینه به‌طور ضمنی به همراه گزینه‌هایی برای بی‌صدا کردن هشدارها و حذف گزینه‌های دیگری که باعث می‌شوند کامپایلر به عنوان اثر جانبی در فایل‌ها یا در خروجی استاندارد داده تولید کند، برای کامپایل دوم درخواستی توسط \fB\-fcompare\-debug\fR به کامپایلر ارسال می‌شود. فایل‌های dump و فایل‌های موقت حفظ‌شده طوری تغییر نام می‌یابند که در کامپایل دوم دارای پسوند اضافی \f(CW\*(C`.gk\*(C'\fR باشند، تا از رونویسی موارد ایجادشده توسط کامپایل اول جلوگیری شود.
.Sp
هنگامی که این گزینه به درایور کامپایلر ارسال شود، باعث صرف‌نظر کردن از کامپایل \fIاول\fR می‌شود، که این ویژگی آن را تنها برای اشکال‌زدایی خود کامپایلر کاربردی می‌سازد.
.IP \fB\-gtoggle\fR 4
.IX Item "-gtoggle"
تولید اطلاعات اشکال‌زدایی را خاموش می‌کند، اگر کنار گذاشتن این گزینه آن را تولید می‌کرد؛ یا در غیر این صورت آن را در سطح ۲ فعال می‌کند. جایگاه این آرگومان در خط فرمان اهمیتی ندارد؛ پس از پردازش تمام گزینه‌های دیگر اعمال می‌شود و فارغ از اینکه چند بار مشخص شده باشد، تنها یک بار اعمال خواهد شد. این گزینه عمدتاً برای استفاده به همراه \fB\-fcompare\-debug\fR در نظر گرفته شده است.
.IP \fB\-fvar\-tracking\-assignments\-toggle\fR 4
.IX Item "-fvar-tracking-assignments-toggle"
تغییر وضعیت (toggle) گزینهٔ \fB\-fvar\-tracking\-assignments\fR، به همان شیوه‌ای که \fB\-gtoggle\fR وضعیت \fB\-g\fR را تغییر می‌دهد.
.IP \fB\-Q\fR 4
.IX Item "-Q"
هنگامی که پیش از \fB\-\-help=\fR در خط فرمان به کار رود، \fB\-Q\fR به عنوان تغییردهندهٔ خروجی راهنما عمل می‌کند.
.Sp
در غیر این صورت، این گزینه باعث می‌شود کامپایلر نام هر تابع را هنگام کامپایل شدن چاپ کند، و آمارهایی دربارهٔ هر گذر (pass) پس از پایان آن نمایش دهد.
.IP \fB\-ftime\-report\fR 4
.IX Item "-ftime-report"
باعث می‌شود کامپایلر پس از اتمام، آمارهایی را دربارهٔ زمان مصرف‌شده توسط هر گذر در stderr چاپ کند.
.Sp
اگر خروجی SARIF برای پیام‌های تشخیصی از طریق \fB\-fdiagnostics\-format=sarif\-file\fR یا \fB\-fdiagnostics\-format=sarif\-stderr\fR درخواست شده باشد، اطلاعات \fB\-ftime\-report\fR در عوض در قالب JSON و به عنوان بخشی از خروجی SARIF صادر می‌شود. ساختار دقیق این داده‌های JSON ممکن است تغییر کند، و به دلیل ثبت شدن در مکانی کمی متفاوت درون کامپایلر، مقادیر ممکن است دقیقاً با موارد صادرشده به stderr مطابقت نداشته باشند.
.IP \fB\-ftime\-report\-details\fR 4
.IX Item "-ftime-report-details"
زمان مصرف‌شده توسط بخش‌های زیرساختی را برای هر گذر به صورت جداگانه ثبت می‌کند.
.IP \fB\-fira\-verbose=\fR\fIn\fR 4
.IX Item "-fira-verbose=n"
کنترل میزان جزئیات فایل dump برای تخصیص‌دهندهٔ یکپارچهٔ ثبات (IRA). مقدار پیش‌فرض 5 است. اگر مقدار \fIn\fR بزرگتر یا مساوی با 10 باشد، خروجی dump با همان قالبِ \fIn\fR منهای 10 به stderr فرستاده می‌شود.
.IP \fB\-flto\-report\fR 4
.IX Item "-flto-report"
گزارشی با جزئیات درونی دربارهٔ نحوهٔ کارکرد بهینه‌ساز زمان پیوند (LTO) چاپ می‌کند. محتویات این گزارش از نسخه‌ای به نسخهٔ دیگر متفاوت است. هدف آن مفید بودن برای توسعه‌دهندگان GCC هنگام پردازش فایل‌های شیء در حالت LTO (از طریق \fB\-flto\fR) است.
.Sp
به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-flto\-report\-wpa\fR 4
.IX Item "-flto-report-wpa"
مانند \fB\-flto\-report\fR، اما گزارش را تنها برای فاز WPA از بهینه‌سازی زمان پیوند چاپ می‌کند.
.IP \fB\-fmem\-report\fR 4
.IX Item "-fmem-report"
باعث می‌شود کامپایلر پس از پایان، آمارهایی دربارهٔ تخصیص حافظهٔ دائمی چاپ کند.
.IP \fB\-fmem\-report\-wpa\fR 4
.IX Item "-fmem-report-wpa"
باعث می‌شود کامپایلر آمارهایی دربارهٔ تخصیص حافظهٔ دائمی را تنها برای فاز WPA چاپ کند.
.IP \fB\-fpre\-ipa\-mem\-report\fR 4
.IX Item "-fpre-ipa-mem-report"
.PD 0
.IP \fB\-fpost\-ipa\-mem\-report\fR 4
.IX Item "-fpost-ipa-mem-report"
.PD
باعث می‌شود کامپایلر آمارهایی دربارهٔ تخصیص حافظهٔ دائمی را قبل یا بعد از بهینه‌سازی بین‌روالی (IPA) چاپ کند.
.IP \fB\-fmultiflags\fR 4
.IX Item "-fmultiflags"
این گزینه امکان استفاده از \f(CW\*(C`TFLAGS\*(C'\fR آگاه از چندکتابخانه‌ای (multilib) را برای ساخت کتابخانه‌های مقصد با گزینه‌هایی متفاوت از آنچه کامپایلر به‌طور پیش‌فرض برای استفاده پیکربندی شده است، از طریق مشخصات (specs) تنظیم‌شده توسط بخش‌های درونی کامپایلر، توسط هدف، یا توسط سازندگان در زمان پیکربندی فراهم می‌کند.
.Sp
همانند \f(CW\*(C`TFLAGS\*(C'\fR، این گزینه اجازه می‌دهد کتابخانه‌های مقصد برای محیط‌های پایهٔ سازگار و قابل‌حمل ساخته شوند، در حالی که پیش‌فرض‌های کامپایلر روی محیط‌های پیشرفته‌تر تنظیم شده باشند. این ویژگی سودمند است زیرا اگر پیش‌فرض‌ها برای محیط مقصد بهینه نباشند، کاربران می‌توانند پیش‌فرض‌های پیکربندی‌شدهٔ کامپایلر را برای ساخت برنامه‌های خود به‌سادگی تغییر دهند، در حالی که بازسازی کتابخانه‌های زمان اجرا معمولاً به این آسانی یا مطلوب نیست.
.Sp
برخلاف \f(CW\*(C`TFLAGS\*(C'\fR، استفاده از specs امکان انتخاب پرچم‌های متفاوت برای multilibهای گوناگون را فراهم می‌سازد. روش انجام آن، ساخت با دستور \fBmake TFLAGS=\-fmultiflags\fR پس از پیکربندی با \fB\-\-with\-specs=%{fmultiflags:...}\fR است.
.Sp
این گزینه پس از پایان پردازش self specهای درایور، توسط درایور کنار گذاشته می‌شود.
.Sp
همچنین برای بررسی اینکه آیا \f(CW\*(C`TFLAGS\*(C'\fR برای ساخت همهٔ کتابخانه‌های مقصد به کار می‌رود یا خیر، پیکربندی یک کامپایلر غیر خودراه‌انداز (non\-bootstrap) با \fB\-\-with\-specs=\*(Aq%{!fmultiflags:%emissing TFLAGS}\*(Aq\fR و سپس ساخت کامپایلر و کتابخانه‌های مقصد مفید است..IP \fB\-fprofile\-report\fR 4
.IX Item "-fprofile-report"
باعث می‌شود کامپایلر آماری را دربارهٔ سازگاری نمایهٔ (تخمین‌زده‌شده) و تأثیر هر یک از گذرها (passes) چاپ کند.
.IP \fB\-fstack\-usage\fR 4
.IX Item "-fstack-usage"
باعث می‌شود کامپایلر اطلاعات میزان استفاده از پشته را برای برنامه، به‌تفکیک هر تابع، در خروجی ارائه دهد. نام فایل برای ثبت این داده‌ها (dump) با افزودن
\&\fI.su\fR به \fIauxname\fR ساخته می‌شود. اگر نام فایل خروجی به‌طور صریح مشخص شده باشد و یک فایل اجرایی نباشد، \fIauxname\fR از نام فایل خروجی،
و در غیر این صورت از نام پایهٔ (basename) فایل منبع تولید می‌شود. هر مدخل از سه فیلد تشکیل شده است:
.RS 4
.IP * 4
نام تابع.
.IP * 4
تعداد بایت‌ها.
.IP * 4
یک یا چند توصیف‌کننده: \f(CW\*(C`static\*(C'\fR، \f(CW\*(C`dynamic\*(C'\fR، \f(CW\*(C`bounded\*(C'\fR.
.RE
.RS 4
.Sp
توصیف‌کنندهٔ \f(CW\*(C`static\*(C'\fR به این معنی است که تابع پشته را به‌صورت ایستا دستکاری می‌کند: تعداد بایت ثابتی در هنگام ورود به تابع برای فریم تخصیص داده شده و هنگام خروج از تابع آزاد می‌شود؛ به‌جز این هیچ تنظیم پشته‌ای در تابع انجام نمی‌گیرد. فیلد دوم همین تعداد بایت ثابت است.
.Sp
توصیف‌کنندهٔ \f(CW\*(C`dynamic\*(C'\fR به این معنی است که تابع پشته را به‌صورت پویا دستکاری می‌کند: علاوه بر تخصیص ایستای شرح‌داده‌شده در بالا، تنظیمات پشته در بدنهٔ تابع انجام می‌شود، برای مثال جهت push/pop کردن آرگومان‌ها هنگام فراخوانی توابع. اگر توصیف‌کنندهٔ \f(CW\*(C`bounded\*(C'\fR نیز حضور داشته باشد، مقدار این تنظیمات در زمان کامپایل کران‌دار (محدود) است و فیلد دوم کران بالای کل مقدار پشتهٔ استفاده‌شده توسط تابع خواهد بود. اگر وجود نداشته باشد، مقدار این تنظیمات در زمان کامپایل کران‌دار نیست و فیلد دوم تنها نشان‌دهندهٔ بخش محدودشده است.
.RE
.IP \fB\-fstats\fR 4
.IX Item "-fstats"
در پایان فرایند کامپایل، آماری را دربارهٔ پردازش فرانت‌اند (front-end) منتشر می‌کند.
این گزینه فقط توسط فرانت‌اند C++ پشتیبانی می‌شود، و
اطلاعات ارائه‌شده عموماً تنها برای تیم توسعهٔ G++ مفید است.
.IP \fB\-fdbg\-cnt\-list\fR 4
.IX Item "-fdbg-cnt-list"
نام و کران بالای شمارنده را برای همهٔ شمارنده‌های اشکال‌زدایی چاپ می‌کند.
.IP \fB\-fdbg\-cnt=\fR\fIcounter\-value\-list\fR 4
.IX Item "-fdbg-cnt=counter-value-list"
کران پایین و بالای شمارندهٔ اشکال‌زدایی داخلی را تعیین می‌کند. \fIcounter\-value\-list\fR
فهرستی جداشده با کاما از تاپل‌های \fIname\fR:\fIlower_bound1\fR\-\fIupper_bound1\fR
[:\fIlower_bound2\fR\-\fIupper_bound2\fR...] است که نام شمارنده و فهرستی از بازه‌های بسته را تنظیم می‌کند.
مقدار \fIlower_bound\fR اختیاری است و اگر تعیین نشود با صفر مقداردهی اولیه می‌شود.
برای مثال، با \fB\-fdbg\-cnt=dce:2\-4:10\-11,tail_call:10\fR،
عبارت \&\f(CWdbg_cnt(dce)\fR تنها برای دفعات فراخوانی دوم، سوم، چهارم، دهم و
یازدهم مقدار true را بازمی‌گرداند.
برای \f(CWdbg_cnt(tail_call)\fR مقدار true برای ۱۰ فراخوانی اول برگردانده می‌شود.
.IP \fB\-print\-autofdo\-gcov\-version\fR 4
.IX Item "-print-autofdo-gcov-version"
.PD 0
.IP \fB\-\-print\-autofdo\-gcov\-version\fR 4
.IX Item "--print-autofdo-gcov-version"
.PD
نسخهٔ فعلی GCOV مورد استفاده توسط زیرساخت AutoFDO را چاپ می‌کند.
.IP \fB\-print\-file\-name=\fR\fIlibrary\fR 4
.IX Item "-print-file-name=library"
.PD 0
.IP \fB\-\-print\-file\-name=\fR\fIlibrary\fR 4
.IX Item "--print-file-name=library"
.IP "\fB\-\-print\-file\-name\fR \fIlibrary\fR" 4
.IX Item "--print-file-name library"
.PD
نام مطلق و کامل فایل کتابخانهٔ \fIlibrary\fR را که هنگام پیوند (link) استفاده خواهد شد
چاپ می‌کند\-\-\-و هیچ کار دیگری انجام نمی‌دهد. با این گزینه، GCC هیچ چیز را کامپایل یا پیوند نمی‌کند؛
فقط نام فایل را چاپ می‌کند.
.IP \fB\-print\-multi\-directory\fR 4
.IX Item "-print-multi-directory"
.PD 0
.IP \fB\-\-print\-multi\-directory\fR 4
.IX Item "--print-multi-directory"
.PD
نام دایرکتوری متناظر با multilib انتخاب‌شده توسط هر یک از سوییچ‌های دیگر خط فرمان را چاپ می‌کند.
فرض بر این است که این دایرکتوری در \fBGCC_EXEC_PREFIX\fR وجود دارد.
.IP \fB\-print\-multi\-lib\fR 4
.IX Item "-print-multi-lib"
.PD 0
.IP \fB\-\-print\-multi\-lib\fR 4
.IX Item "--print-multi-lib"
.PD
نگاشت نام دایرکتوری‌های multilib به سوییچ‌های کامپایلر را که آن‌ها را فعال می‌کنند، چاپ می‌کند.
نام دایرکتوری با یک \&\fB;\fR از سوییچ‌ها جدا می‌شود، و هر سوییچ به جای
\&\fB\-\fR با یک \&\fB@\fR شروع می‌شود، بدون هیچ فاصله‌ای میان سوییچ‌های چندگانه. هدف از این کار
تسهیل پردازش در شل است.
.IP \fB\-print\-multi\-os\-directory\fR 4
.IX Item "-print-multi-os-directory"
.PD 0
.IP \fB\-\-print\-multi\-os\-directory\fR 4
.IX Item "--print-multi-os-directory"
.PD
مسیر کتابخانه‌های سیستم‌عامل برای multilib انتخاب‌شده را، نسبت به یک زیردایرکتوری \fIlib\fR چاپ می‌کند.
اگر کتابخانه‌های سیستم‌عامل در زیردایرکتوری \fIlib\fR موجود باشند و از هیچ multilibای استفاده نشود، این
معمولاً فقط \fI.\fR است؛ اگر کتابخانه‌های سیستم‌عامل در دایرکتوری‌های هم‌سطحِ \fIlibsuffix\fR موجود باشند،
برای مثال \fI../lib64\fR، \fI../lib\fR یا \&\fI../lib32\fR را چاپ می‌کند، یا اگر کتابخانه‌های سیستم‌عامل در زیردایرکتوری‌های
\fIlib/subdir\fR قرار داشته باشند، عناوینی مانند \fIamd64\fR، \fIsparcv9\fR یا \fIev6\fR را چاپ می‌کند.
.IP \fB\-print\-multiarch\fR 4
.IX Item "-print-multiarch"
.PD 0
.IP \fB\-\-print\-multiarch\fR 4
.IX Item "--print-multiarch"
.PD
مسیر کتابخانه‌های سیستم‌عامل را برای معماری چندگانهٔ (multiarch) انتخاب‌شده،
نسبت به یک زیردایرکتوری \fIlib\fR چاپ می‌کند.
.IP \fB\-print\-prog\-name=\fR\fIprogram\fR 4
.IX Item "-print-prog-name=program"
.PD 0
.IP \fB\-\-print\-prog\-name=\fR\fIprogram\fR 4
.IX Item "--print-prog-name=program"
.IP "\fB\-\-print\-prog\-name\fR \fIprogram\fR" 4
.IX Item "--print-prog-name program"
.PD
مشابه \fB\-print\-file\-name\fR، اما برای برنامه‌ای مانند \fBcpp\fR جستجو می‌کند.
.IP \fB\-print\-libgcc\-file\-name\fR 4
.IX Item "-print-libgcc-file-name"
.PD 0
.IP \fB\-\-print\-libgcc\-file\-name\fR 4
.IX Item "--print-libgcc-file-name"
.PD
همانند \fB\-print\-file\-name=libgcc.a\fR.
.Sp
این گزینه زمانی مفید است که از \fB\-nostdlib\fR یا \fB\-nodefaultlibs\fR استفاده می‌کنید
اما مایلید با \fIlibgcc.a\fR پیوند برقرار کنید. می‌توانید این‌گونه عمل کنید:
.Sp
.Vb 1
\&        gcc \-nostdlib <files>... \`gcc \-print\-libgcc\-file\-name\`
.Ve
.IP \fB\-print\-search\-dirs\fR 4
.IX Item "-print-search-dirs"
.PD 0
.IP \fB\-\-print\-search\-dirs\fR 4
.IX Item "--print-search-dirs"
.PD
نام دایرکتوری نصب پیکربندی‌شده و فهرستی از دایرکتوری‌های برنامه و کتابخانه‌ای را که
\fBgcc\fR جستجو می‌کند چاپ می‌کند\-\-\-و هیچ کار دیگری انجام نمی‌دهد.
.Sp
این گزینه زمانی مفید است که \fBgcc\fR پیام خطای
\&\fBinstallation problem, cannot exec cpp0: No such file or directory\fR را چاپ می‌کند.
برای برطرف کردن این مشکل یا باید \fIcpp0\fR و سایر اجزای کامپایلر را در جایی که \fBgcc\fR
انتظار دارد قرار دهید، یا متغیر محیطی \fBGCC_EXEC_PREFIX\fR را روی دایرکتوری محل نصب آن‌ها تنظیم کنید.
علامت \fB/\fR انتهایی را فراموش نکنید.
.IP \fB\-print\-sysroot\fR 4
.IX Item "-print-sysroot"
.PD 0
.IP \fB\-\-print\-sysroot\fR 4
.IX Item "--print-sysroot"
.PD
دایرکتوری sysroot مقصد را که در طول کامپایل استفاده می‌شود،
چاپ می‌کند. این همان sysroot مقصدی است که در زمان configure یا با استفاده از
گزینهٔ \fB\-\-sysroot\fR مشخص شده است؛ احتمالاً همراه با یک پسوند اضافی که به گزینه‌های کامپایل
بستگی دارد. اگر هیچ sysroot مقصدی مشخص نشده باشد، این گزینه چیزی چاپ نمی‌کند.
.IP \fB\-print\-sysroot\-headers\-suffix\fR 4
.IX Item "-print-sysroot-headers-suffix"
.PD 0
.IP \fB\-\-print\-sysroot\-headers\-suffix\fR 4
.IX Item "--print-sysroot-headers-suffix"
.PD
پسوند اضافه‌شده به sysroot مقصد را هنگام جستجوی سرآیندها چاپ می‌کند،
یا در صورتی که کامپایلر با چنین پسوندی پیکربندی نشده باشد خطا می‌دهد\-\-\-و
هیچ کار دیگری انجام نمی‌دهد.
.IP \fB\-dumpmachine\fR 4
.IX Item "-dumpmachine"
ماشین مقصد کامپایلر را (برای مثال،
\&\fBi686\-pc\-linux\-gnu\fR) چاپ می‌کند\-\-\-و هیچ کار دیگری انجام نمی‌دهد.
.IP \fB\-dumpversion\fR 4
.IX Item "-dumpversion"
نسخهٔ کامپایلر را (برای مثال \f(CW3.0\fR، \f(CW6.3.0\fR یا \f(CW7\fR) چاپ می‌کند\-\-\-و هیچ
کار دیگری انجام نمی‌دهد. این نسخهٔ کامپایلر است که در مسیرهای فایل‌سیستم و
specs استفاده می‌شود. بسته به نحوهٔ پیکربندی کامپایلر، این مقدار می‌تواند تنها
یک عدد (نسخهٔ اصلی یا major)، دو عدد جداشده با نقطه (نسخهٔ اصلی و فرعی یا major و minor)
یا سه عدد جداشده با نقطه (نسخهٔ اصلی، فرعی و سطح وصله یا patchlevel) باشد..IP \fB\-dumpfullversion\fR 4
.IX Item "-dumpfullversion"
نسخه کامل کامپایلر را چاپ می‌کند\-\-\-و کار دیگری انجام نمی‌دهد. خروجی همیشه سه عدد است که با نقطه از هم جدا شده‌اند: نسخه اصلی (major)، فرعی (minor) و وصله (patchlevel).
.IP \fB\-dumpspecs\fR 4
.IX Item "-dumpspecs"
مشخصات (specs) توکار کامپایلر را چاپ می‌کند\-\-\-و کار دیگری انجام نمی‌دهد. (این گزینه هنگام ساخت خود GCC استفاده می‌شود.)
.IP "\fB\-\-param\fR \fIname\fR\fB=\fR\fIvalue\fR" 4
.IX Item "--param name=value"
.PD 0
.IP \fB\-\-param=\fR\fIname\fR\fB=\fR\fIvalue\fR 4
.IX Item "--param=name=value"
.PD
به‌طور قراردادی، GCC به جای استفاده از مقادیر ثابت سخت‌کدشده، از پارامترهایی استفاده می‌کند که می‌توان آن‌ها را در خط فرمان مشخص کرد تا محدودیت‌های دلخواه یا قواعد تجربی (heuristics) کامپایلر را نشان دهند. بسیاری از پارامترها به بهینه‌سازی مربوط می‌شوند؛ برای مثال، GCC توابعی را که بیش از تعداد مشخصی دستورالعمل داشته باشند درون‌خطی (inline) نمی‌کند. تحلیل‌گر ایستا (static analyzer) نیز به همین ترتیب از پارامترها برای محدود کردن پیچیدگی استفاده می‌کند، بهینه‌سازی زمان پیوند (link-time optimization) از پارامترها برای کنترل بخش‌بندی استفاده می‌کند و غیره. پارامترهای دیگر جنبه‌هایی از GCC را کنترل می‌کنند که کاملاً داخلی هستند، مانند تخصیص حافظه و راهبرد بازیافت حافظه (garbage collection). موارد دیگر رفتارهای خاص معماری هدف را کنترل می‌کنند.
.Sp
گزینه \fB\-\-param\fR یک رابط یکپارچه برای مشخص کردن مقادیر این پارامترهای کامپایلر فراهم می‌کند. با این حال، نام پارامترهای خاص و معنای مقادیر آن‌ها به سازوکارهای درونی کامپایلر وابسته است و ممکن است بدون اطلاع قبلی در نسخه‌های آینده تغییر کند. شما نباید برای کامپایل صحیح برنامه خود به تنظیمات این پارامترها وابسته باشید. این پارامترها برای راحتی توسعه‌دهندگان در اشکال‌زدایی مشکلات کامپایل یا در برخی موارد، برای ارائه راه‌حل‌های موقت (workarounds) در برابر باگ‌های کامپایلر از طریق خط فرمان در دسترس قرار گرفته‌اند.
.SS "گزینه‌های وابسته به معماری هدف (Target-Specific Options)"
.IX Subsection "Target-Specific Options"
هر ماشین هدفی که توسط GCC پشتیبانی می‌شود می‌تواند گزینه‌های خاص خود را داشته باشد\-\-\-برای مثال، تا به شما امکان دهد برای یک نوع پردازنده یا ABI خاص کامپایل کنید، یا بهینه‌سازی‌های مختص آن ماشین را کنترل نمایید. به‌طور مشابه، GCC همچنین دارای گزینه‌هایی است که مخصوص سیستم‌عامل‌ها یا محیط‌های زمان اجرای خاص در سیستم هدف هستند.
.PP
به‌طور قراردادی، نام گزینه‌های مختص ماشین با \&\fB\-m\fR آغاز می‌شود. برخی پیکربندی‌های کامپایلر نیز از گزینه‌های وابسته به هدف اضافی پشتیبانی می‌کنند که معمولاً برای سازگاری با سایر کامپایلرها روی همان پلتفرم است.
.PP
\fIگزینه‌های AArch64\fR
.IX Subsection "AArch64 Options"
.PP
این گزینه‌ها برای پیاده‌سازی‌های AArch64 تعریف شده‌اند:
.IP \fB\-mabi=\fR\fIname\fR 4
.IX Item "-mabi=name"
برای مدل داده مشخص‌شده کد تولید می‌کند. مقادیر مجاز عبارتند از \fBilp32\fR برای مدل داده شبه SysV که در آن int، long int و اشاره‌گرها ۳۲ بیتی هستند، و \fBlp64\fR برای مدل داده شبه SysV که در آن int ۳۲ بیتی است اما long int و اشاره‌گرها ۶۴ بیتی هستند.
.Sp
مقدار پیش‌فرض به پیکربندی معماری هدف خاص بستگی دارد. توجه داشته باشید که ABIهای LP64 و ILP32 از نظر پیوند سازگار نیستند؛ شما باید تمام برنامه خود را با همان ABI کامپایل کنید و با مجموعه‌ای از کتابخانه‌های سازگار پیوند دهید.
.Sp
مدل \fBilp32\fR منسوخ شده است.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
کد با ترتیب بایت بزرگ‌انتهای (big-endian) تولید می‌کند. این پیش‌فرض است زمانی که GCC برای یک هدف \&\fBaarch64_be\-*\-*\fR پیکربندی شده باشد.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
کد با ترتیب بایت کوچک‌انتهای (little-endian) تولید می‌کند. این پیش‌فرض است زمانی که GCC برای یک هدف \&\fBaarch64\-*\-*\fR پیکربندی شده باشد، اما نه برای یک هدف \&\fBaarch64_be\-*\-*\fR.
.IP \fB\-menable\-sysreg\-checking\fR 4
.IX Item "-menable-sysreg-checking"
در صورتی که تلاشی برای دسترسی به یک ثبات سیستم (system register) که روی معماری هدف موجود نیست صورت گیرد، پیام خطا تولید می‌کند.
.IP \fB\-mgeneral\-regs\-only\fR 4
.IX Item "-mgeneral-regs-only"
کدی تولید می‌کند که فقط از ثبات‌های همه‌منظوره استفاده می‌کند. این کار کامپایلر را از استفاده از ثبات‌های ممیز شناور (floating-point) و Advanced SIMD باز می‌دارد، اما هیچ محدودیتی بر اسمبلر اعمال نمی‌کند.
.IP \fB\-mcmodel=tiny\fR 4
.IX Item "-mcmodel=tiny"
کد را برای مدل کد ناچیز (tiny) تولید می‌کند. برنامه و نمادهای ایستا تعریف‌شده آن باید در فاصله 1MB از یکدیگر قرار گیرند. برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند.
.IP \fB\-mcmodel=small\fR 4
.IX Item "-mcmodel=small"
کد را برای مدل کد کوچک (small) تولید می‌کند. برنامه و نمادهای ایستا تعریف‌شده آن باید در فاصله 4GB از یکدیگر قرار گیرند. برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند. این مدل کد پیش‌فرض است.
.IP \fB\-mcmodel=large\fR 4
.IX Item "-mcmodel=large"
کد را برای مدل کد بزرگ (large) تولید می‌کند. این حالت هیچ فرضی درباره آدرس‌ها و اندازه بخش‌ها (sections) در نظر نمی‌گیرد. برنامه‌ها فقط می‌توانند به‌صورت ایستا پیوند داده شوند. گزینه \&\fB\-mcmodel=large\fR با \fB\-mabi=ilp32\fR، \&\fB\-fpic\fR و \fB\-fPIC\fR ناسازگار است.
.IP \fB\-mtp=\fR\fIname\fR 4
.IX Item "-mtp=name"
ثبات سیستمی را که به عنوان اشاره‌گر نخ (thread pointer) استفاده می‌شود مشخص می‌کند. مقادیر معتبر عبارتند از \fBtpidr_el0\fR، \fBtpidrro_el0\fR، \fBtpidr_el1\fR، \fBtpidr_el2\fR و \&\fBtpidr_el3\fR. برای سازگاری با گذشته، نام‌های مستعار \fBel0\fR، \&\fBel1\fR، \fBel2\fR و \fBel3\fR نیز پذیرفته می‌شوند.
تنظیم پیش‌فرض \fBtpidr_el0\fR است. توصیه می‌شود تمام کدهایی که قرار است با یکدیگر تعامل داشته باشند با مقدار یکسانی از این گزینه کامپایل شوند تا از دسترسی به یک اشاره‌گر نخ متفاوت از سطح استثنای (exception level) نادرست جلوگیری شود.
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD 0
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD
از تولید دسترسی‌های حافظه‌ای که ممکن است بر اساس مشخصات معماری روی مرز طبیعی شیء تراز نشده باشند، اجتناب می‌کند یا به آن‌ها اجازه می‌دهد.
.IP \fB\-momit\-leaf\-frame\-pointer\fR 4
.IX Item "-momit-leaf-frame-pointer"
.PD 0
.IP \fB\-mno\-omit\-leaf\-frame\-pointer\fR 4
.IX Item "-mno-omit-leaf-frame-pointer"
.PD
اشاره‌گر چارچوب (frame pointer) را در توابع برگ (leaf functions) حذف یا حفظ می‌کند. رفتار اول، پیش‌فرض است.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR 4
.IX Item "-mstack-protector-guard-reg=reg"
.IP \fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR 4
.IX Item "-mstack-protector-guard-offset=offset"
.PD
کد محافظت از پشته را با استفاده از قناری (canary) در \fIguard\fR تولید می‌کند. مکان‌های پشتیبانی‌شده عبارتند از \fBglobal\fR برای یک قناری سراسری یا \fBsysreg\fR برای یک قناری در یک ثبات سیستم مناسب.
.Sp
با انتخاب حالت دوم، گزینه‌های
\&\fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR و
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR علاوه بر این مشخص می‌کنند
که از کدام ثبات سیستم به عنوان ثبات پایه برای خواندن قناری، و از چه آفستی نسبت به آن ثبات پایه استفاده شود. هیچ ثبات یا آفست پیش‌فرضی وجود ندارد چرا که این قابلیت تماماً برای استفاده در هسته لینوکس است.
.IP \fB\-mtls\-dialect=desc\fR 4
.IX Item "-mtls-dialect=desc"
از توصیف‌گرهای TLS به عنوان سازوکار حافظه محلی نخ (thread-local storage) برای دسترسی‌های پویای متغیرهای TLS استفاده می‌کند. این پیش‌فرض است.
.IP \fB\-mtls\-dialect=traditional\fR 4
.IX Item "-mtls-dialect=traditional"
از TLS سنتی به عنوان سازوکار حافظه محلی نخ برای دسترسی‌های پویای متغیرهای TLS استفاده می‌کند.
.IP \fB\-mtls\-size=\fR\fIsize\fR 4
.IX Item "-mtls-size=size"
اندازه بیتی آفست‌های بی‌درنگ (immediate) در TLS را مشخص می‌کند. مقادیر معتبر عبارتند از 12، 24، 32 و 48. این گزینه نیازمند binutils نسخه 2.26 یا جدیدتر است.
.IP \fB\-mfix\-cortex\-a53\-835769\fR 4
.IX Item "-mfix-cortex-a53-835769"
.PD 0
.IP \fB\-mno\-fix\-cortex\-a53\-835769\fR 4
.IX Item "-mno-fix-cortex-a53-835769"
.PD
راه‌حل موقت برای نقص فنی (erratum) شماره 835769 در ARM Cortex\-A53 را فعال یا غیرفعال می‌کند. این شامل قرار دادن یک دستورالعمل NOP بین دستورالعمل‌های حافظه و دستورالعمل‌های ضرب-تجمع (multiply-accumulate) اعداد صحیح ۶۴ بیتی است. اگر در خط فرمان معماری یا پردازنده‌ای مشخص شود که به این راه‌حل نیازی ندارد، این پرچم نادیده گرفته خواهد شد.
.IP \fB\-mfix\-cortex\-a53\-843419\fR 4
.IX Item "-mfix-cortex-a53-843419"
.PD 0
.IP \fB\-mno\-fix\-cortex\-a53\-843419\fR 4
.IX Item "-mno-fix-cortex-a53-843419"
.PD
راه‌حل موقت برای نقص فنی شماره 843419 در ARM Cortex\-A53 را فعال یا غیرفعال می‌کند. راه‌حل این نقص فنی در زمان پیوند انجام می‌شود و این گزینه فقط پرچم مربوطه را به پیونددهنده (linker) ارسال می‌کند. اگر در خط فرمان معماری یا پردازنده‌ای مشخص شود که به این راه‌حل نیازی ندارد، این پرچم نادیده گرفته خواهد شد.
.IP \fB\-mlow\-precision\-recip\-sqrt\fR 4
.IX Item "-mlow-precision-recip-sqrt"
.PD 0
.IP \fB\-mno\-low\-precision\-recip\-sqrt\fR 4
.IX Item "-mno-low-precision-recip-sqrt"
.PD
تقریب جذر معکوس (reciprocal square root) را فعال یا غیرفعال می‌کند. این گزینه تنها در صورتی تأثیر دارد که \fB\-ffast\-math\fR یا \&\fB\-funsafe\-math\-optimizations\fR نیز استفاده شده باشد. فعال کردن این گزینه دقت نتایج جذر معکوس را برای دقت یگانه (single precision) به حدود ۱۶ بیت و برای دقت دوگانه (double precision) به ۳۲ بیت کاهش می‌دهد..IP \fB\-mlow\-precision\-sqrt\fR 4
.IX Item "-mlow-precision-sqrt"
.PD 0
.IP \fB\-mno\-low\-precision\-sqrt\fR 4
.IX Item "-mno-low-precision-sqrt"
.PD
تقریب جذر (ریشه دوم) را فعال یا غیرفعال می‌کند.
این گزینه تنها زمانی اثرگذار است که \fB\-ffast\-math\fR یا
\&\fB\-funsafe\-math\-optimizations\fR نیز استفاده شده باشد. فعال کردن این گزینه،
دقت نتایج جذر را برای دقت یگانه (single precision) به حدود ۱۶ بیت و
برای دقت دوگانه (double precision) به ۳۲ بیت کاهش می‌دهد.
در صورت فعال بودن، به‌طور ضمنی \fB\-mlow\-precision\-recip\-sqrt\fR را نیز در بر دارد.
.IP \fB\-mlow\-precision\-div\fR 4
.IX Item "-mlow-precision-div"
.PD 0
.IP \fB\-mno\-low\-precision\-div\fR 4
.IX Item "-mno-low-precision-div"
.PD
تقریب تقسیم را فعال یا غیرفعال می‌کند.
این گزینه تنها زمانی اثرگذار است که \fB\-ffast\-math\fR یا
\&\fB\-funsafe\-math\-optimizations\fR نیز استفاده شده باشد. فعال کردن این گزینه،
دقت نتایج تقسیم را برای دقت یگانه به حدود ۱۶ بیت و
برای دقت دوگانه به ۳۲ بیت کاهش می‌دهد.
.IP \fB\-mtrack\-speculation\fR 4
.IX Item "-mtrack-speculation"
.PD 0
.IP \fB\-mno\-track\-speculation\fR 4
.IX Item "-mno-track-speculation"
.PD
تولید کد اضافی برای ردیابی اجرای حدسی (speculative execution) از طریق شاخه‌های
شرطی را فعال یا غیرفعال می‌کند. سپس وضعیت ردیابی‌شده می‌تواند توسط کامپایلر هنگام
بسط دادن فراخوانی‌های \&\f(CW\*(C`_\|_builtin_speculation_safe_value\*(C'\fR به منظور
تولید توالی کد کارآمدتر استفاده شود.
.IP \fB\-moutline\-atomics\fR 4
.IX Item "-moutline-atomics"
.PD 0
.IP \fB\-mno\-outline\-atomics\fR 4
.IX Item "-mno-outline-atomics"
.PD
فراخوانی توابع کمکی درون‌خطی‌نشده (out\-of\-line helpers) را برای پیاده‌سازی عملیات اتمیک فعال یا غیرفعال می‌کند.
این توابع کمکی در زمان اجرا مشخص می‌کنند که آیا می‌توان از دستورالعمل‌های LSE
متعلق به ARMv8.1\-A استفاده کرد یا خیر؛ در غیر این صورت، از دستورالعمل‌های load/store\-exclusive
موجود در ISA پایهٔ ARMv8.0 استفاده خواهند کرد.
.Sp
این گزینه تنها هنگام کامپایل برای مجموعه دستورالعمل پایهٔ ARMv8.0 قابل اعمال است.
در صورت استفاده از نسخه‌های جدیدتر، مانند \fB\-march=armv8.1\-a\fR
یا \fB\-march=armv8\-a+lse\fR، دستورالعمل‌های ARMv8.1\-Atomics مستقیماً
استفاده خواهند شد. همین موضوع هنگام استفاده از \fB\-mcpu=\fR در صورتی که پردازندهٔ
انتخاب‌شده از ویژگی \fBlse\fR پشتیبانی کند نیز صدق می‌کند.
این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mmax\-vectorization\fR 4
.IX Item "-mmax-vectorization"
.PD 0
.IP \fB\-mno\-max\-vectorization\fR 4
.IX Item "-mno-max-vectorization"
.PD
نادیده‌گرفتن (override) مدل هزینهٔ بردارساز را فعال یا غیرفعال می‌کند تا بردارسازی
همیشه سودمند به نظر برسد. این گزینه می‌تواند با \&\fB\-mautovec\-preference\fR
ترکیب شود و امکان کنترل دقیق بر روی اینکه کدام ISA برای بردارسازی خودکار
استفاده شود را فراهم کند. بر خلاف \fB\-fno\-vect\-cost\-model\fR یا
\&\fB\-fvect\-cost\-model=unlimited\fR، این گزینه مقایسهٔ هزینه بین حالت‌های
برداری مختلف را خاموش نمی‌کند.
.IP \fB\-mautovec\-preference=\fR\fIname\fR 4
.IX Item "-mautovec-preference=name"
یک راهبرد انتخاب ISA را برای بردارسازی خودکار تحمیل می‌کند. مقادیر
مجاز \fIname\fR عبارتند از:
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
استفاده از روش‌های اکتشافی (heuristics) پیش‌فرض.
.IP \fBasimd\-only\fR 4
.IX Item "asimd-only"
تنها استفاده از Advanced SIMD برای بردارسازی خودکار.
.IP \fBsve\-only\fR 4
.IX Item "sve-only"
تنها استفاده از SVE برای بردارسازی خودکار.
.IP \fBprefer\-asimd\fR 4
.IX Item "prefer-asimd"
استفاده از هر دو Advanced SIMD و SVE. اولویت دادن به Advanced SIMD هنگامی که
هزینه‌ها برابر برآورد شوند.
.IP \fBprefer\-sve\fR 4
.IX Item "prefer-sve"
استفاده از هر دو Advanced SIMD و SVE. اولویت دادن به SVE هنگامی که هزینه‌ها برابر برآورد شوند.
.RE
.RS 4
.Sp
برای بهترین کارایی اکیداً توصیه می‌شود به‌جای آن از \fB\-mcpu\fR یا
\&\fB\-mtune\fR استفاده شود. این پارامتر فقط باید برای بررسی و ارزیابی کد
استفاده شود.
.RE
.IP \fB\-march=\fR\fIname\fR 4
.IX Item "-march=name"
نام معماری هدف و در صورت تمایل، یک یا چند تغییردهندهٔ ویژگی (feature modifier)
را مشخص می‌کند. این گزینه دارای ساختار
\&\fB\-march=\fR\fIarch\fR{\fB+\fR[\fBno\fR]\fIfeature\fR}* است.
.Sp
جدول زیر مقادیر مجاز برای \fIarch\fR و ویژگی‌هایی را که به‌طور پیش‌فرض
فعال می‌کنند خلاصه کرده است:
.RS 4
.IP "\fIمقدار arch\fR : \fIمعماری\fR : \fIبه‌طور پیش‌فرض شامل\fR" 4
.IX Item "arch value : Architecture : Includes by default"
.PD 0
.IP "\fBarmv8\-a\fR : Armv8\-A : \fB+fp\fR, \fB+simd\fR" 4
.IX Item "armv8-a : Armv8-A : +fp, +simd"
.IP "\fBarmv8.1\-a\fR : Armv8.1\-A : \fBarmv8\-a\fR, \fB+crc\fR, \fB+lse\fR, \fB+rdma\fR" 4
.IX Item "armv8.1-a : Armv8.1-A : armv8-a, +crc, +lse, +rdma"
.IP "\fBarmv8.2\-a\fR : Armv8.2\-A : \fBarmv8.1\-a\fR" 4
.IX Item "armv8.2-a : Armv8.2-A : armv8.1-a"
.IP "\fBarmv8.3\-a\fR : Armv8.3\-A : \fBarmv8.2\-a\fR, \fB+pauth\fR, \fB+fcma\fR, \fB+jscvt\fR" 4
.IX Item "armv8.3-a : Armv8.3-A : armv8.2-a, +pauth, +fcma, +jscvt"
.IP "\fBarmv8.4\-a\fR : Armv8.4\-A : \fBarmv8.3\-a\fR, \fB+flagm\fR, \fB+fp16fml\fR, \fB+dotprod\fR, \fB+rcpc2\fR" 4
.IX Item "armv8.4-a : Armv8.4-A : armv8.3-a, +flagm, +fp16fml, +dotprod, +rcpc2"
.IP "\fBarmv8.5\-a\fR : Armv8.5\-A : \fBarmv8.4\-a\fR, \fB+sb\fR, \fB+ssbs\fR, \fB+predres\fR, \fB+frintts\fR, \fB+flagm2\fR" 4
.IX Item "armv8.5-a : Armv8.5-A : armv8.4-a, +sb, +ssbs, +predres, +frintts, +flagm2"
.IP "\fBarmv8.6\-a\fR : Armv8.6\-A : \fBarmv8.5\-a\fR, \fB+bf16\fR, \fB+i8mm\fR" 4
.IX Item "armv8.6-a : Armv8.6-A : armv8.5-a, +bf16, +i8mm"
.IP "\fBarmv8.7\-a\fR : Armv8.7\-A : \fBarmv8.6\-a\fR, \fB+wfxt\fR, \fB+xs\fR" 4
.IX Item "armv8.7-a : Armv8.7-A : armv8.6-a, +wfxt, +xs"
.IP "\fBarmv8.8\-a\fR : Armv8.8\-a : \fBarmv8.7\-a\fR, \fB+mops\fR" 4
.IX Item "armv8.8-a : Armv8.8-a : armv8.7-a, +mops"
.IP "\fBarmv8.9\-a\fR : Armv8.9\-a : \fBarmv8.8\-a\fR" 4
.IX Item "armv8.9-a : Armv8.9-a : armv8.8-a"
.IP "\fBarmv9\-a\fR : Armv9\-A : \fBarmv8.5\-a\fR, \fB+sve\fR, \fB+sve2\fR" 4
.IX Item "armv9-a : Armv9-A : armv8.5-a, +sve, +sve2"
.IP "\fBarmv9.1\-a\fR : Armv9.1\-A : \fBarmv9\-a\fR, \fB+bf16\fR, \fB+i8mm\fR" 4
.IX Item "armv9.1-a : Armv9.1-A : armv9-a, +bf16, +i8mm"
.IP "\fBarmv9.2\-a\fR : Armv9.2\-A : \fBarmv9.1\-a\fR, \fB+wfxt\fR, \fB+xs\fR" 4
.IX Item "armv9.2-a : Armv9.2-A : armv9.1-a, +wfxt, +xs"
.IP "\fBarmv9.3\-a\fR : Armv9.3\-A : \fBarmv9.2\-a\fR, \fB+mops\fR" 4
.IX Item "armv9.3-a : Armv9.3-A : armv9.2-a, +mops"
.IP "\fBarmv9.4\-a\fR : Armv9.4\-A : \fBarmv9.3\-a\fR, \fB+sve2p1\fR" 4
.IX Item "armv9.4-a : Armv9.4-A : armv9.3-a, +sve2p1"
.IP "\fBarmv9.5\-a\fR : Armv9.5\-A : \fBarmv9.4\-a\fR, \fBcpa\fR, \fB+faminmax\fR, \fB+lut\fR" 4
.IX Item "armv9.5-a : Armv9.5-A : armv9.4-a, cpa, +faminmax, +lut"
.IP "\fBarmv8\-r\fR : Armv8\-R : \fBarmv8\-r\fR" 4
.IX Item "armv8-r : Armv8-R : armv8-r"
.PD
.RE
.RS 4
.Sp
مقدار \fBnative\fR در سیستم‌های محلی AArch64 GNU/Linux در دسترس است و
باعث می‌شود کامپایلر معماری سیستم میزبان را انتخاب کند. این گزینه در صورتی که
کامپایلر قادر به شناسایی معماری سیستم میزبان نباشد، هیچ اثری نخواهد داشت. هنگامی
که \fB\-march=native\fR داده شود و گزینهٔ دیگری از \fB\-mcpu\fR یا \fB\-mtune\fR
مشخص نشده باشد، GCC پردازندهٔ میزبان را هم به عنوان پردازندهٔ هدف جهت تنظیم کارایی
و هم جهت انتخاب ویژگی‌های معماری برمی‌گزیند. بدین معنی که با \fB\-march=native\fR
همانند \fB\-mcpu=native\fR رفتار می‌شود.
.Sp
مقادیر مجاز برای \fIfeature\fR در زیربخش مربوط به
\fBaarch64\-feature\-modifiers,,\fR\fB\-march\fR \fBand\fR \fB\-mcpu\fR
\&\fBFeature Modifiers\fR فهرست شده‌اند. در صورت تعیین تغییردهنده‌های
متناقض ویژگی، راست‌ترین ویژگی اعمال می‌شود.
.Sp
کامپایلر GCC از \fIname\fR برای تعیین نوع دستورالعمل‌هایی که می‌تواند در
زمان تولید کد اسمبلی صادر کند، استفاده می‌نماید. اگر \fB\-march\fR بدون
تعیین هر یک از گزینه‌های \fB\-mtune\fR یا \fB\-mcpu\fR مشخص شده باشد،
کد به‌گونه‌ای بهینه‌سازی می‌شود که در طیفی از پردازنده‌های هدفی که معماری مورد نظر
را پیاده‌سازی می‌کنند عملکرد خوبی داشته باشد.
.RE
.IP \fB\-mtune=\fR\fIname\fR 4
.IX Item "-mtune=name"
نام پردازندهٔ هدف را مشخص می‌کند که GCC باید کارایی کد را برای آن تنظیم (tune) کند.
مقادیر مجاز برای این گزینه عبارتند از:
\&\fBgeneric\fR, \fBcortex\-a35\fR, \fBcortex\-a53\fR, \fBcortex\-a55\fR,
\&\fBcortex\-a57\fR, \fBcortex\-a72\fR, \fBcortex\-a73\fR, \fBcortex\-a75\fR,
\&\fBcortex\-a76\fR, \fBcortex\-a76ae\fR, \fBcortex\-a77\fR,
\&\fBcortex\-a65\fR, \fBcortex\-a65ae\fR, \fBcortex\-a34\fR,
\&\fBcortex\-a78\fR, \fBcortex\-a78ae\fR, \fBcortex\-a78c\fR,
\&\fBares\fR, \fBexynos\-m1\fR, \fBemag\fR, \fBfalkor\fR,
\&\fBoryon\-1\fR,
\&\fBneoverse\-512tvb\fR, \fBneoverse\-e1\fR, \fBneoverse\-n1\fR,
\&\fBneoverse\-n2\fR, \fBneoverse\-v1\fR, \fBneoverse\-v2\fR, \fBgrace\fR,
\&\fBneoverse\-v3\fR, \fBneoverse\-v3ae\fR, \fBarmagicpu\fR, \fBneoverse\-n3\fR,
\&\fBolympus\fR, \fBrigel\fR, \fBcortex\-a725\fR, \fBcortex\-x925\fR,
\&\fBqdf24xx\fR, \fBsaphira\fR, \fBphecda\fR, \fBxgene1\fR, \fBvulcan\fR,
\&\fBocteontx\fR, \fBocteontx81\fR,  \fBocteontx83\fR,
\&\fBocteontx2\fR, \fBocteontx2t98\fR, \fBocteontx2t96\fR
\&\fBocteontx2t93\fR, \fBocteontx2f95\fR, \fBocteontx2f95n\fR,
\&\fBocteontx2f95mm\fR,
\&\fBa64fx\fR, \fBfujitsu\-monaka\fR,
\&\fBthunderx\fR, \fBthunderxt88\fR,
\&\fBthunderxt88p1\fR, \fBthunderxt81\fR, \fBtsv110\fR, \fBhip12\fR,
\&\fBthunderxt83\fR, \fBthunderx2t99\fR, \fBthunderx3t110\fR, \fBzeus\fR,
\&\fBcortex\-a57.cortex\-a53\fR, \fBcortex\-a72.cortex\-a53\fR,
\&\fBcortex\-a73.cortex\-a35\fR, \fBcortex\-a73.cortex\-a53\fR,
\&\fBcortex\-a75.cortex\-a55\fR, \fBcortex\-a76.cortex\-a55\fR,
\&\fBcortex\-r82\fR, \fBcortex\-r82ae\fR, \fBcortex\-x1\fR, \fBcortex\-x1c\fR,
\&\fBcortex\-x2\fR, \fBcortex\-x3\fR, \fBcortex\-x4\fR, \fBcortex\-a510\fR,
\&\fBcortex\-a520\fR, \fBcortex\-a520ae\fR, \fBcortex\-a710\fR, \fBcortex\-a715\fR,
\&\fBcortex\-a720\fR, \fBcortex\-a720ae\fR, \fBampere1\fR, \fBampere1a\fR,
\&\fBampere1b\fR, \fBampere1c\fR, \fBcobalt\-100\fR, \fBapple\-m1\fR,
\&\fBapple\-m2\fR, \fBapple\-m3\fR, \fBapple\-m4\fR, \fBapple\-m5\fR, \fBc1\-nano\fR,
\&\fBc1\-pro\fR, \fBc1\-premium\fR \fBc1\-ultra\fR و \fBnative\fR.
.Sp
مقادیر \fBcortex\-a57.cortex\-a53\fR، \fBcortex\-a72.cortex\-a53\fR،
\&\fBcortex\-a73.cortex\-a35\fR، \fBcortex\-a73.cortex\-a53\fR،
\&\fBcortex\-a75.cortex\-a55\fR، \fBcortex\-a76.cortex\-a55\fR،
\&\fBapple\-m1\fR، \fBapple\-m2\fR، \fBapple\-m3\fR و \fBgb10\fR مشخص می‌کنند
که GCC باید برای یک سامانهٔ big.LITTLE بهینه‌سازی کند.
.Sp
مقدار \fBneoverse\-512tvb\fR مشخص می‌کند که GCC باید برای هسته‌های Neoverse تنظیم
شود که (الف) SVE را پیاده‌سازی کرده‌اند و (ب) پهنای باند برداری کل آن‌ها ۵۱۲ بیت در
هر چرخه است. به بیان دیگر، این گزینه به GCC می‌گوید که کد را برای هسته‌های Neoverse
تنظیم کند که می‌توانند در هر چرخه ۴ دستورالعمل محاسباتی ۱۲۸ بیتی Advanced SIMD را
اجرا کنند و تعداد معادل آن دستورالعمل محاسباتی SVE در هر چرخه انجام دهند (۲ دستورالعمل
برای SVE با اندازه ۲۵۶ بیت، و ۴ دستورالعمل برای SVE با اندازه ۱۲۸ بیت). این تنظیم
کلی‌تر از تنظیم برای یک هستهٔ خاص مانند Neoverse V1 است، اما از تنظیم پیش‌فرضی که در
زیر شرح داده شده، خاص‌تر است.
.Sp
علاوه بر این، در سیستم‌های محلی AArch64 GNU/Linux مقدار
\&\fBnative\fR کارایی را متناسب با سیستم میزبان تنظیم می‌کند. این گزینه در
صورتی که کامپایلر نتواند پردازندهٔ سیستم میزبان را شناسایی کند، هیچ اثری نخواهد داشت.
.Sp
در صورتی که هیچ‌یک از \fB\-mtune=\fR، \fB\-mcpu=\fR یا \fB\-march=\fR
مشخص نشده باشند، کد به‌گونه‌ای تنظیم می‌شود که در طیفی از پردازنده‌های هدف عملکرد
خوبی داشته باشد.
.Sp
این گزینه نمی‌تواند با تغییردهنده‌های ویژگی همراه شود..IP \fB\-mcpu=\fR\fIname\fR 4
.IX Item "-mcpu=name"
نام پردازندهٔ مقصد را مشخص می‌کند، که به‌طور اختیاری می‌تواند با یک یا چند اصلاح‌کنندهٔ ویژگی پسوند یابد. این گزینه دارای قالب
\&\fB\-mcpu=\fR\fIcpu\fR{\fB+\fR[\fBno\fR]\fIfeature\fR}* است، که در آن مقادیر مجاز برای \fIcpu\fR همان مقادیر دردسترس برای \fB\-mtune\fR هستند. مقادیر مجاز برای \fIfeature\fR در زیربخش مربوط به
\&\fBaarch64\-feature\-modifiers,,\fR\fB\-march\fR \fBand\fR \fB\-mcpu\fR
\&\fBFeature Modifiers\fR مستند شده‌اند. در صورت تعیین اصلاح‌کننده‌های ویژگی متناقض، راست‌ترین ویژگی اعمال می‌شود.
.Sp
کامپایلر GCC از \fIname\fR برای تعیین نوع دستورالعمل‌هایی که می‌تواند هنگام تولید کد اسمبلی صادر کند (همانند \fB\-march\fR) و برای تعیین پردازندهٔ مقصدی که کارایی برای آن تنظیم و بهینه می‌شود (همانند \fB\-mtune\fR) استفاده می‌کند. در صورتی که این گزینه همراه با \fB\-march\fR یا \fB\-mtune\fR استفاده شود، آن گزینه‌ها بر بخش مربوطه از این گزینه ارجحیت خواهند داشت.
.Sp
گزینهٔ \&\fB\-mcpu=neoverse\-512tvb\fR از این نظر خاص است که به یک هستهٔ خاص اشاره نمی‌کند، بلکه به تمام هسته‌های Neoverse اشاره دارد که (الف) SVE را پیاده‌سازی کرده باشند و (ب) مجموع پهنای باند برداری ۵۱۲ بیت در هر چرخه داشته باشند. مگر اینکه توسط \fB\-march\fR لغو شود،
\&\fB\-mcpu=neoverse\-512tvb\fR کدی تولید می‌کند که می‌تواند روی یک هستهٔ Neoverse V1 اجرا شود، چرا که Neoverse V1 نخستین هستهٔ Neoverse با این ویژگی‌ها است. مگر اینکه توسط \fB\-mtune\fR لغو شود،
\&\fB\-mcpu=neoverse\-512tvb\fR کد را همانند
\&\fB\-mtune=neoverse\-512tvb\fR تنظیم و بهینه می‌کند.
.IP \fB\-moverride=\fR\fIstring\fR 4
.IX Item "-moverride=string"
تصمیمات بهینه‌سازیِ اتخاذشده توسط بک‌اند را در پاسخ به سوییچ
\&\fB\-mtune=\fR لغو و بازنویسی می‌کند. تضمینی وجود ندارد که نحو، معناشناسی و مقادیر پذیرفته‌شده برای \fIstring\fR در این گزینه در بین نسخه‌های مختلف یکسان و سازگار بماند.
.Sp
این گزینه صرفاً برای استفاده در هنگام توسعهٔ GCC در نظر گرفته شده است.
.IP \fB\-mpc\-relative\-literal\-loads\fR 4
.IX Item "-mpc-relative-literal-loads"
.PD 0
.IP \fB\-mno\-pc\-relative\-literal\-loads\fR 4
.IX Item "-mno-pc-relative-literal-loads"
.PD
بارگذاری‌های مقادیر لیترال وابسته به PC (یا PC\-relative literal loads) را فعال یا غیرفعال می‌کند. با این گزینه، استخرهای لیترال با استفاده از یک دستورالعمل منفرد دردسترس قرار می‌گیرند و پس از هر تابع صادر می‌شوند. این امر حداکثر اندازهٔ توابع را به 1MB محدود می‌کند. این گزینه به‌طور پیش‌فرض برای
\&\fB\-mcmodel=tiny\fR فعال است.
.IP \fB\-msign\-return\-address=\fR\fIscope\fR 4
.IX Item "-msign-return-address=scope"
حوزهٔ تابعی را که امضای نشانی بازگشت روی آن اعمال خواهد شد انتخاب می‌کند. مقادیر مجاز عبارتند از \fBnone\fR که امضای نشانی بازگشت را غیرفعال می‌کند،
\&\fBnon\-leaf\fR که امضای اشاره‌گر را برای توابعی که تابع برگ (leaf) نیستند فعال می‌سازد، و \fBall\fR که امضای اشاره‌گر را برای تمام توابع فعال می‌کند. مقدار پیش‌فرض \fBnone\fR است. این گزینه به نفع
\&\fB\-mbranch\-protection\fR منسوخ شده است.
.IP \fB\-mbranch\-protection=\fR\fIfeatures\fR 4
.IX Item "-mbranch-protection=features"
ویژگی‌های محافظت از انشعاب مورد استفاده را انتخاب می‌کند.
\&\fIfeatures\fR می‌تواند یکی از حالت‌های زیر را داشته باشد:
.Sp
\&\fBnone\fR مقدار پیش‌فرض است و تمام انواع محافظت از انشعاب را غیرفعال می‌کند.
.Sp
\&\fBstandard\fR تمام انواع ویژگی‌های محافظت از انشعاب را فعال می‌کند. اگر یک ویژگی دارای گزینه‌های تنظیم بیشتری باشد، \fBstandard\fR آن را روی سطح استاندارد خود قرار می‌دهد.
.Sp
\&\fBpac\-ret\fR امضای نشانی بازگشت را در سطح استاندارد فعال می‌کند: امضای توابعی که نشانی بازگشت را در حافظه ذخیره می‌کنند (توابع غیربرگ عملاً همیشه این کار را انجام می‌دهند) با استفاده از A\-key.
.Sp
\&\fBpac\-ret+leaf\fR امضای \fBpac\-ret\fR را گسترش می‌دهد تا توابع برگ را نیز شامل شود.
.Sp
از \&\fBpac\-ret+b\-key\fR یا \fBpac\-ret+leaf+b\-key\fR می‌توان برای امضای توابع با B\-key به جای A\-key استفاده کرد.
.Sp
\&\fBbti\fR سازوکار شناسایی مقصد انشعاب (branch target identification) را فعال می‌کند.
.Sp
\&\fBgcs\fR تولید کد سازگار با پشتهٔ کنترل محافظت‌شده (guarded control stack) را فعال می‌کند.
.IP \fB\-mharden\-sls=\fR\fIopts\fR 4
.IX Item "-mharden-sls=opts"
مقاوم‌سازی کامپایلر در برابر گمانه‌زنی خط مستقیم (SLS) را فعال می‌کند.
\&\fIopts\fR فهرستی از گزینه‌های زیر است که با کاما از یکدیگر جدا شده‌اند:
.RS 4
.IP \fBretbr\fR 4
.IX Item "retbr"
.PD 0
.IP \fBblr\fR 4
.IX Item "blr"
.PD
.RE
.RS 4
.Sp
علاوه بر این، \fB\-mharden\-sls=all\fR تمام مقاوم‌سازی‌های SLS را فعال می‌کند در حالی که
\&\fB\-mharden\-sls=none\fR تمام مقاوم‌سازی‌های SLS را غیرفعال می‌سازد.
.RE
.IP \fB\-mearly\-ra=\fR\fIscope\fR 4
.IX Item "-mearly-ra=scope"
تعیین می‌کند چه زمانی یک گذر زودهنگام تخصیص ثبات فعال شود. این گذر پیش از زمان‌بندی دستورالعمل‌ها اجرا می‌شود و تلاش می‌کند یک تخصیص بدون ریزش (spill\-free) برای کدهای ممیز شناور و برداری پیدا کند. همچنین تلاش می‌کند از دستورالعمل‌های چندثباتی گام‌دار، مانند LD1 و ST1 گام‌دار در SME2 استفاده کند.
.Sp
مقادیر ممکن برای \fIscope\fR عبارتند از: \fIall\fR که این گذر را روی تمام توابع اجرا می‌کند؛ \fIstrided\fR که گذر را روی توابعی اجرا می‌کند که به دستورالعمل‌های چندثباتی گام‌دار دسترسی دارند؛ و \fInone\fR که گذر را غیرفعال می‌سازد.
.Sp
گزینهٔ \&\fB\-mearly\-ra=all\fR برای \fB\-O2\fR و بالاتر، و برای
\&\fB\-Os\fR پیش‌فرض است. در غیر این صورت \fB\-mearly\-ra=none\fR پیش‌فرض است.
.IP \fB\-mearly\-ldp\-fusion\fR 4
.IX Item "-mearly-ldp-fusion"
.PD 0
.IP \fB\-mno\-early\-ldp\-fusion\fR 4
.IX Item "-mno-early-ldp-fusion"
.PD
نسخه‌ای از گذر ادغام جفت بارگذاری/ذخیره‌سازی (load/store pair fusion) در AArch64 را که قبل از تخصیص ثبات اجرا می‌شود فعال می‌کند. به‌طور پیش‌فرض در \fB\-O\fR و بالاتر فعال است.
.IP \fB\-mlate\-ldp\-fusion\fR 4
.IX Item "-mlate-ldp-fusion"
.PD 0
.IP \fB\-mno\-late\-ldp\-fusion\fR 4
.IX Item "-mno-late-ldp-fusion"
.PD
نسخه‌ای از گذر ادغام جفت بارگذاری/ذخیره‌سازی در AArch64 را که بعد از تخصیص ثبات اجرا می‌شود فعال می‌کند. به‌طور پیش‌فرض در \fB\-O\fR و بالاتر فعال است.
.IP \fB\-mnarrow\-gp\-writes\fR 4
.IX Item "-mnarrow-gp-writes"
تبدیل نوشتن‌های ثبات عمومی ۶۴ بیتی به عملیات‌های معادل ۳۲ بیتی را هنگامی که مشخص است ۳۲ بیت بالایی صفر هستند فعال می‌کند. این گذر را می‌توان با \-mnarrow\-gp\-writes کنترل کرد و در \-O2 و بالاتر فعال است، اما به‌طور پیش‌فرض فعال نیست، مگر برای \fB\-mcpu=olympus\fR.
.IP \fB\-msve\-vector\-bits=\fR\fIbits\fR 4
.IX Item "-msve-vector-bits=bits"
تعداد بیت‌ها در یک ثبات برداری SVE را مشخص می‌کند. این گزینه تنها زمانی اثرگذار است که SVE فعال باشد.
.Sp
کامپایلر GCC از دو حالت تولید کد SVE پشتیبانی می‌کند: خروجی «مستقل از طول بردار» (vector\-length agnostic) که با هر اندازه‌ای از ثبات برداری کار می‌کند و خروجی «وابسته به طول بردار» (vector\-length specific) که به GCC امکان می‌دهد زمانی که برای بهینه‌سازی مفید باشد، دربارهٔ طول بردار فرضیاتی در نظر بگیرد. مقادیر ممکن برای \fBbits\fR عبارتند از: \fBscalable\fR، \fB128\fR،
\&\fB256\fR، \fB512\fR، \fB1024\fR و \fB2048\fR.
تعیین \fBscalable\fR خروجی مستقل از طول بردار را برمی‌گزیند. در حال حاضر \fB\-msve\-vector\-bits=128\fR نیز برای مقاصد big\-endian خروجی مستقل از طول بردار تولید می‌کند. سایر مقادیر، کد وابسته به طول بردار تولید می‌کنند. رفتار این مقادیر ممکن است در نسخه‌های آینده تغییر کند و برای تولید کدی که بین طول‌های مختلف بردار سخت‌افزاری SVE سازگار و قابل‌حمل باشد، نباید به مقداری جز \fBscalable\fR اتکا کرد.
.Sp
مقدار پیش‌فرض \fB\-msve\-vector\-bits=scalable\fR است که کد مستقل از طول بردار تولید می‌کند.
.PP
اصلاح‌کننده‌های ویژگی \fB\-march\fR و \fB\-mcpu\fR
.IX Subsection "-march and -mcpu Feature Modifiers"
.PP
اصلاح‌کننده‌های ویژگی مورد استفاده با \fB\-march\fR و \fB\-mcpu\fR می‌توانند هر یک از موارد زیر و معکوس آن‌ها یعنی \fBno\fR\fIfeature\fR باشند:
.IP \fBcrc\fR 4
.IX Item "crc"
افزونهٔ CRC را فعال می‌کند. این ویژگی به‌طور پیش‌فرض برای
\&\fB\-march=armv8.1\-a\fR فعال است.
.IP \fBcrypto\fR 4
.IX Item "crypto"
افزونهٔ Crypto را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌سازد.
.IP \fBfp\fR 4
.IX Item "fp"
دستورالعمل‌های ممیز شناور را فعال می‌کند. این ویژگی به‌طور پیش‌فرض برای تمام مقادیر ممکن گزینه‌های \fB\-march\fR و \fB\-mcpu\fR فعال است.
.IP \fBsimd\fR 4
.IX Item "simd"
دستورالعمل‌های Advanced SIMD را فعال می‌کند. این گزینه همچنین دستورالعمل‌های ممیز شناور را فعال می‌سازد. این ویژگی به‌طور پیش‌فرض برای تمام مقادیر ممکن گزینه‌های
\&\fB\-march\fR و \fB\-mcpu\fR فعال است.
.IP \fBsve\fR 4
.IX Item "sve"
دستورالعمل‌های Scalable Vector Extension را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌سازد.
.IP \fBlse\fR 4
.IX Item "lse"
دستورالعمل‌های Large System Extension را فعال می‌کند. این ویژگی به‌طور پیش‌فرض برای
\&\fB\-march=armv8.1\-a\fR فعال است..IP \fBrdma\fR 4
.IX Item "rdma"
دستورالعمل‌های Round Double Multiply Accumulate را فعال می‌کند. این گزینه به‌طور پیش‌فرض
برای \fB\-march=armv8.1\-a\fR فعال است.
.IP \fBfp16\fR 4
.IX Item "fp16"
افزونهٔ FP16 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های ممیز شناور را فعال می‌سازد.
.IP \fBfp16fml\fR 4
.IX Item "fp16fml"
افزونهٔ FP16 fmla را فعال می‌کند. این گزینه همچنین افزونه‌های FP16 و
دستورالعمل‌های ممیز شناور را فعال می‌سازد. این گزینه به‌طور پیش‌فرض برای \fB\-march=armv8.4\-a\fR فعال است. استفاده از این گزینه در معماری‌های پیش از Armv8.2\-A پشتیبانی نمی‌شود.
.IP \fBrcpc\fR 4
.IX Item "rcpc"
افزونهٔ RCpc را فعال می‌کند. این گزینه امکان استفاده از دستورالعمل‌های LDAPR را برای
معناشناسی اتمیک بارگیری\-دستیابی (load\-acquire atomic semantics) فراهم ساخته و آن را به اسمبلر منتقل می‌کند تا
دستورهای asm درون‌خطی بتوانند از دستورالعمل‌های افزونهٔ RCpc استفاده کنند.
.IP \fBdotprod\fR 4
.IX Item "dotprod"
افزونهٔ Dot Product را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD را فعال می‌سازد.
.IP \fBaes\fR 4
.IX Item "aes"
افزونهٔ رمزنگاری aes و pmull در Armv8\-a را فعال می‌کند. این گزینه همچنین دستورالعمل‌های
Advanced SIMD را فعال می‌سازد.
.IP \fBsha2\fR 4
.IX Item "sha2"
افزونهٔ رمزنگاری sha2 در Armv8\-a را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD را فعال می‌سازد.
.IP \fBsha3\fR 4
.IX Item "sha3"
افزونهٔ رمزنگاری sha512 و sha3 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD
را فعال می‌سازد. استفاده از این گزینه در معماری‌های پیش از Armv8.2\-A پشتیبانی نمی‌شود.
.IP \fBsm4\fR 4
.IX Item "sm4"
افزونهٔ رمزنگاری sm3 و sm4 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های Advanced SIMD را فعال می‌سازد.
استفاده از این گزینه در معماری‌های پیش از Armv8.2\-A پشتیبانی نمی‌شود.
.IP \fBprofile\fR 4
.IX Item "profile"
افزونهٔ Statistical Profiling را فعال می‌کند. این گزینه صرفاً برای فعال‌سازی
افزونه در سطح اسمبلر است و بر تولید کد تأثیری نمی‌گذارد.
.IP \fBrng\fR 4
.IX Item "rng"
دستورالعمل‌های تولید عدد تصادفی (Random Number) در Armv8.5\-a را فعال می‌کند. این گزینه صرفاً
برای فعال‌سازی افزونه در سطح اسمبلر است و بر تولید کد تأثیری
نمی‌گذارد.
.IP \fBmemtag\fR 4
.IX Item "memtag"
افزونه‌های برچسب‌گذاری حافظه (Memory Tagging Extensions) در Armv8.5\-a را فعال می‌کند.
استفاده از این گزینه در معماری‌های پیش از Armv8.5\-A پشتیبانی نمی‌شود.
.IP \fBsb\fR 4
.IX Item "sb"
دستورالعمل Speculation Barrier در Armv8\-a را فعال می‌کند. این گزینه صرفاً برای
فعال‌سازی افزونه در سطح اسمبلر است و بر تولید کد تأثیری
نمی‌گذارد. این گزینه به‌طور پیش‌فرض برای \fB\-march=armv8.5\-a\fR فعال است.
.IP \fBssbs\fR 4
.IX Item "ssbs"
دستورالعمل Speculative Store Bypass Safe در Armv8\-a را فعال می‌کند. این گزینه
صرفاً برای فعال‌سازی افزونه در سطح اسمبلر است و بر تولید کد تأثیری
نمی‌گذارد. این گزینه به‌طور پیش‌فرض برای \fB\-march=armv8.5\-a\fR فعال است.
.IP \fBpredres\fR 4
.IX Item "predres"
دستورالعمل‌های Execution and Data Prediction Restriction در Armv8\-a را فعال می‌کند.
این گزینه صرفاً برای فعال‌سازی افزونه در سطح اسمبلر است و بر
تولید کد تأثیری نمی‌گذارد. این گزینه به‌طور پیش‌فرض برای
\&\fB\-march=armv8.5\-a\fR فعال است.
.IP \fBsve2\fR 4
.IX Item "sve2"
افزونهٔ Scalable Vector Extension 2 در Armv8\-a را فعال می‌کند. این گزینه همچنین دستورالعمل‌های
SVE را فعال می‌سازد.
.IP \fBsve2\-bitperm\fR 4
.IX Item "sve2-bitperm"
دستورالعمل‌های SVE2 bitperm را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SVE2 را فعال می‌سازد.
.IP \fBsve2\-sm4\fR 4
.IX Item "sve2-sm4"
دستورالعمل‌های SVE2 sm4 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SVE2 را فعال می‌سازد.
.IP \fBsve2\-aes\fR 4
.IX Item "sve2-aes"
دستورالعمل‌های SVE2 aes را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SVE2 را فعال می‌سازد.
.IP \fBsve2\-sha3\fR 4
.IX Item "sve2-sha3"
دستورالعمل‌های SVE2 sha3 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SVE2 را فعال می‌سازد.
.IP \fBsve2p1\fR 4
.IX Item "sve2p1"
دستورالعمل‌های SVE2.1 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SVE2 را فعال می‌سازد.
.IP \fBtme\fR 4
.IX Item "tme"
افزونهٔ حافظهٔ تراکنشی (Transactional Memory Extension) را فعال می‌کند.
.IP \fBi8mm\fR 4
.IX Item "i8mm"
دستورالعمل‌های ضرب ماتریس عدد صحیح ۸ بیتی را فعال می‌کند. این گزینه همچنین
دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌سازد. این گزینه به‌طور
پیش‌فرض برای \fB\-march=armv8.6\-a\fR فعال است. استفاده از این گزینه در معماری‌های
پیش از Armv8.2\-A پشتیبانی نمی‌شود.
.IP \fBf32mm\fR 4
.IX Item "f32mm"
دستورالعمل‌های ضرب ماتریس ممیز شناور ۳۲ بیتی را فعال می‌کند. این گزینه همچنین
دستورالعمل‌های SVE را فعال می‌سازد. استفاده از این گزینه در معماری‌های پیش از Armv8.2\-A
پشتیبانی نمی‌شود.
.IP \fBf64mm\fR 4
.IX Item "f64mm"
دستورالعمل‌های ضرب ماتریس ممیز شناور ۶۴ بیتی را فعال می‌کند. این گزینه همچنین
دستورالعمل‌های SVE را فعال می‌سازد. استفاده از این گزینه در معماری‌های پیش از Armv8.2\-A
پشتیبانی نمی‌شود.
.IP \fBbf16\fR 4
.IX Item "bf16"
دستورالعمل‌های ممیز شناور با دقت نیمه brain (brain half\-precision) را فعال می‌کند. این گزینه همچنین
دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌سازد. این گزینه به‌طور
پیش‌فرض برای \fB\-march=armv8.6\-a\fR فعال است. استفاده از این گزینه در معماری‌های
پیش از Armv8.2\-A پشتیبانی نمی‌شود.
.IP \fBls64\fR 4
.IX Item "ls64"
دستورالعمل‌های بارگیری و ذخیرهٔ اتمیک ۶۴ بایتی را برای شتاب‌دهنده‌ها فعال می‌کند.
.IP \fBmops\fR 4
.IX Item "mops"
دستورالعمل‌های تسریع عملیات حافظه مانند \f(CW\*(C`memcpy\*(C'\fR،
\&\f(CW\*(C`memmove\*(C'\fR و \f(CW\*(C`memset\*(C'\fR را فعال می‌کند. این گزینه به‌طور پیش‌فرض برای
\&\fB\-march=armv8.8\-a\fR فعال است.
.IP \fBflagm\fR 4
.IX Item "flagm"
افزونهٔ دستورالعمل‌های دستکاری پرچم (Flag Manipulation instructions Extension) را فعال می‌کند.
.IP \fBflagm2\fR 4
.IX Item "flagm2"
دستورالعمل‌های تبدیل پرچم FlagM2 را فعال می‌کند.
.IP \fBpauth\fR 4
.IX Item "pauth"
افزونهٔ اصالت‌سنجی اشاره‌گر (Pointer Authentication Extension) را فعال می‌کند.
.IP \fBcssc\fR 4
.IX Item "cssc"
دستورالعمل‌های فشرده‌سازی توالی کوتاه مشترک (Common Short Sequence Compression) را فعال می‌کند.
.IP \fBcmpbr\fR 4
.IX Item "cmpbr"
دستورالعمل‌های کوتاه‌تر مقایسه و انشعاب، یعنی \f(CW\*(C`cbb\*(C'\fR، \f(CW\*(C`cbh\*(C'\fR و
\&\f(CW\*(C`cb\*(C'\fR را فعال می‌کند.
.IP \fBsme\fR 4
.IX Item "sme"
افزونهٔ ماتریس مقیاس‌پذیر (Scalable Matrix Extension) را فعال می‌کند.
.IP \fBsme\-i16i64\fR 4
.IX Item "sme-i16i64"
افزونهٔ FEAT_SME_I16I64 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های
SME را فعال می‌سازد.
.IP \fBsme\-f64f64\fR 4
.IX Item "sme-f64f64"
افزونهٔ FEAT_SME_F64F64 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های
SME را فعال می‌سازد.
.IP \fBsme2\fR 4
.IX Item "sme2"
افزونهٔ Scalable Matrix Extension 2 را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME را فعال می‌سازد.
.IP \fBsme\-f8f16\fR 4
.IX Item "sme-f8f16"
افزونهٔ FEAT_SME_F8F16 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME2 و FP8
را فعال می‌سازد.
.IP \fBsme\-f8f32\fR 4
.IX Item "sme-f8f32"
افزونهٔ FEAT_SME_F8F32 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME2 و FP8
را فعال می‌سازد.
.IP \fBsme\-b16b16\fR 4
.IX Item "sme-b16b16"
افزونهٔ FEAT_SME_B16B16 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME2
و SVE_B16B16 را فعال می‌سازد.
.IP \fBsme\-f16f16\fR 4
.IX Item "sme-f16f16"
افزونهٔ FEAT_SME_F16F16 را برای SME فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME2
را فعال می‌سازد.
.IP \fBsme2p1\fR 4
.IX Item "sme2p1"
نسخهٔ ۲.۱ از افزونهٔ Scalable Matrix Extension را فعال می‌کند. این گزینه همچنین دستورالعمل‌های SME2
را فعال می‌سازد.
.IP \fBfcma\fR 4
.IX Item "fcma"
افزونه‌های SIMD برای اعداد مختلط را فعال می‌کند.
.IP \fBjscvt\fR 4
.IX Item "jscvt"
دستورالعمل تبدیل جاوااسکریپت \f(CW\*(C`fjcvtzs\*(C'\fR را فعال می‌کند.
.IP \fBfrintts\fR 4
.IX Item "frintts"
دستورالعمل‌های گرد کردن ممیز شناور به مقدار عدد صحیح را فعال می‌کند.
.IP \fBwfxt\fR 4
.IX Item "wfxt"
دستورالعمل‌های \f(CW\*(C`wfet\*(C'\fR و \f(CW\*(C`wfit\*(C'\fR را فعال می‌کند.
.IP \fBxs\fR 4
.IX Item "xs"
افزونهٔ صفت حافظهٔ XS را فعال می‌کند..IP \fBlse128\fR 4
.IX Item "lse128"
فعال‌سازی افزونه دستورالعمل‌های اتمیک ۱۲۸ بیتی LSE128. این گزینه همچنین دستورالعمل‌های LSE را فعال می‌کند.
.IP \fBd128\fR 4
.IX Item "d128"
فعال‌سازی پشتیبانی از دستورالعمل‌های خواندن/نوشتن ثبات‌های سیستمی ۱۲۸ بیتی. این گزینه افزونه LSE128 را نیز فعال می‌کند.
.IP \fBgcs\fR 4
.IX Item "gcs"
فعال‌سازی پشتیبانی از افزونه Guarded Control Stack در Armv9.4\-a.
.IP \fBthe\fR 4
.IX Item "the"
فعال‌سازی پشتیبانی از افزونه مقاوم‌سازی ترجمه (translation hardening) در Armv8.9\-a/9.4\-a.
.IP \fBrcpc2\fR 4
.IX Item "rcpc2"
فعال‌سازی افزونه RCpc2.
.IP \fBrcpc3\fR 4
.IX Item "rcpc3"
فعال‌سازی افزونه RCpc3 (سازگاری آزادسازی یا Release Consistency).
.IP \fBfp8\fR 4
.IX Item "fp8"
فعال‌سازی افزونه fp8 (نقطه شناور ۸ بیتی).
.IP \fBfp8fma\fR 4
.IX Item "fp8fma"
فعال‌سازی افزونه ضرب و جمع انباشته (multiply accumulate) نقطه شناور ۸ بیتی (fp8).
.IP \fBssve\-fp8fma\fR 4
.IX Item "ssve-fp8fma"
فعال‌سازی افزونه ضرب و جمع انباشته نقطه شناور ۸ بیتی (fp8) در حالت جاری (streaming mode).
.IP \fBfp8dot4\fR 4
.IX Item "fp8dot4"
فعال‌سازی افزونه ضرب داخلی ۴ جهته نقطه شناور ۸ بیتی (fp8) به دقت یگانه (single\-precision).
.IP \fBssve\-fp8dot4\fR 4
.IX Item "ssve-fp8dot4"
فعال‌سازی افزونه ضرب داخلی ۴ جهته نقطه شناور ۸ بیتی (fp8) به دقت یگانه در حالت جاری (streaming mode).
.IP \fBfp8dot2\fR 4
.IX Item "fp8dot2"
فعال‌سازی افزونه ضرب داخلی ۲ جهته نقطه شناور ۸ بیتی (fp8) به نیم‌دقت (half\-precision).
.IP \fBssve\-fp8dot2\fR 4
.IX Item "ssve-fp8dot2"
فعال‌سازی افزونه ضرب داخلی ۲ جهته نقطه شناور ۸ بیتی (fp8) به نیم‌دقت در حالت جاری (streaming mode).
.IP \fBfaminmax\fR 4
.IX Item "faminmax"
فعال‌سازی افزونه بیشینه/کمینه مطلق ممیز شناور (Floating Point Absolute Maximum/Minimum).
.IP \fBlut\fR 4
.IX Item "lut"
فعال‌سازی افزونه جدول جستجو (Lookup Table).
.IP \fBsme\-lutv2\fR 4
.IX Item "sme-lutv2"
فعال‌سازی افزونه نسخه ۲ جدول جستجوی SME (یا LUTv2).
.IP \fBcpa\fR 4
.IX Item "cpa"
فعال‌سازی دستورالعمل‌های محاسبات اشاره‌گر بررسی‌شده (Checked Pointer Arithmetic).
.IP \fBsve\-b16b16\fR 4
.IX Item "sve-b16b16"
فعال‌سازی افزونه ممیز شناور مغزی (\f(CW\*(C`bf16\*(C'\fR) بدون گسترش پهنا (non\-widening) در SVE. این گزینه تنها زمانی تأثیر دارد که \f(CW\*(C`sve2\*(C'\fR یا \f(CW\*(C`sme2\*(C'\fR نیز فعال باشند.
.IP \fBsve\-bfscale\fR 4
.IX Item "sve-bfscale"
فعال‌سازی افزونه SVE_BFSCALE.
.IP \fBpoe2\fR 4
.IX Item "poe2"
فعال‌سازی افزونه همپوشانی‌های مجوز ۲ (Permission Overlays Extension 2).
.IP \fBtev\fR 4
.IX Item "tev"
فعال‌سازی افزونه بردار شبه‌استثناء TIndex (TIndex Exception\-like Vector).
.IP \fBtlbid\fR 4
.IX Item "tlbid"
فعال‌سازی افزونه دامنه‌های TLBI (TLBI Domains).
.IP \fBgcie\fR 4
.IX Item "gcie"
فعال‌سازی افزونه رابط پردازنده برای کنترل‌کننده وقفه عمومی نسخه ۵ (GICv5).
.IP \fBlscp\fR 4
.IX Item "lscp"
فعال‌سازی افزونه جفت بارگذاری دستیابی و ذخیره آزادسازی (load acquire and store release pair).
.IP \fBmops\-go\fR 4
.IX Item "mops-go"
فعال‌سازی گونه‌های فقط برچسب (tag only) از دستورالعمل‌های MOPS. این گزینه همچنین دستورالعمل‌های شتاب‌دهی به عملیات‌های حافظه و افزونه‌های برچسب‌گذاری حافظه Armv8.5\-a را فعال می‌کند.
.IP \fBsve2p3\fR 4
.IX Item "sve2p3"
فعال‌سازی SVE2.3. این گزینه همچنین دستورالعمل‌های SVE2.2 را فعال می‌کند.
.IP \fBsme2p3\fR 4
.IX Item "sme2p3"
فعال‌سازی SME2.3. این گزینه همچنین دستورالعمل‌های SME2.2 را فعال می‌کند.
.IP \fBf16f32dot\fR 4
.IX Item "f16f32dot"
فعال‌سازی دستورالعمل‌های f16f32dot در Armv9.7\-a. این گزینه همچنین Advanced SIMD، دستورالعمل‌های ممیز شناور و دستورالعمل‌های FP16 در Armv8.2\-a را فعال می‌کند.
.IP \fBsve\-b16mm\fR 4
.IX Item "sve-b16mm"
فعال‌سازی افزونه SVE B16MM. این گزینه همچنین دستورالعمل‌های SVE، Advanced SIMD و ممیز شناور را فعال می‌کند.
.IP \fBmtetc\fR 4
.IX Item "mtetc"
فعال‌سازی عملیات‌های بلوک برچسب حافظه پنهان داده (Data cache tag block). این گزینه همچنین افزونه‌های برچسب‌گذاری حافظه Armv8.5\-a را فعال می‌کند.
.IP \fBf16f32mm\fR 4
.IX Item "f16f32mm"
فعال‌سازی دستورالعمل‌های f16f32mm در Armv9.7\-a. این گزینه همچنین Advanced SIMD، دستورالعمل‌های ممیز شناور و دستورالعمل‌های FP16 در Armv8.2\-a را فعال می‌کند.
.IP \fBf16mm\fR 4
.IX Item "f16mm"
فعال‌سازی دستورالعمل‌های f16mm. این گزینه همچنین Advanced SIMD، دستورالعمل‌های ممیز شناور و دستورالعمل‌های FP16 در Armv8.2\-a را فعال می‌کند.
.PP
ویژگی \fBcrypto\fR مستلزم فعال بودن \fBaes\fR، \fBsha2\fR و \fBsimd\fR است که خود \fBfp\fR را نیز در بر دارد.
برعکس، \fBnofp\fR مستلزم \fBnosimd\fR است که به نوبه خود شامل
\&\fBnocrypto\fR، \fBnoaes\fR و \fBnosha2\fR می‌شود.
.PP
\fIگزینه‌های Adapteva Epiphany\fR
.IX Subsection "Adapteva Epiphany Options"
.PP
این گزینه‌های \fB\-m\fR برای پردازنده Adapteva Epiphany تعریف شده‌اند:
.IP \fB\-mhalf\-reg\-file\fR 4
.IX Item "-mhalf-reg-file"
.PD 0
.IP \fB\-mno\-half\-reg\-file\fR 4
.IX Item "-mno-half-reg-file"
.PD
هیچ ثباتی را در محدوده \f(CW\*(C`r32\*(C'\fR...\f(CW\*(C`r63\*(C'\fR تخصیص ندهد.
این کار اجازه می‌دهد کد روی گونه‌های سخت‌افزاری که فاقد این ثبات‌ها هستند اجرا شود.
.IP \fB\-mprefer\-short\-insn\-regs\fR 4
.IX Item "-mprefer-short-insn-regs"
.PD 0
.IP \fB\-mno\-prefer\-short\-insn\-regs\fR 4
.IX Item "-mno-prefer-short-insn-regs"
.PD
تخصیص ترجیحی ثبات‌هایی که امکان تولید دستورالعمل‌های کوتاه را فراهم می‌کنند.
این کار می‌تواند منجر به افزایش تعداد دستورالعمل‌ها شود، بنابراین ممکن است اندازه کلی کد را کاهش یا افزایش دهد.
.IP \fB\-mbranch\-cost=\fR\fInum\fR 4
.IX Item "-mbranch-cost=num"
تنظیم هزینه انشعاب‌ها به حدوداً \fInum\fR دستورالعمل «ساده».
این هزینه صرفاً یک تخمین اکتشافی است و تضمین نمی‌شود که در انتشارها و نسخه‌های مختلف نتایج یکسانی ایجاد کند.
.IP \fB\-mcmove\fR 4
.IX Item "-mcmove"
.PD 0
.IP \fB\-mno\-cmove\fR 4
.IX Item "-mno-cmove"
.PD
فعال‌سازی تولید دستورالعمل‌های انتقال شرطی (conditional moves).
.IP \fB\-mnops=\fR\fInum\fR 4
.IX Item "-mnops=num"
درج \fInum\fR دستور NOP پیش از هر دستورالعمل تولیدشده دیگر.
.IP \fB\-mno\-soft\-cmpsf\fR 4
.IX Item "-mno-soft-cmpsf"
.PD 0
.IP \fB\-msoft\-cmpsf\fR 4
.IX Item "-msoft-cmpsf"
.PD
برای مقایسه‌های ممیز شناور با دقت یگانه، یک دستورالعمل \f(CW\*(C`fsub\*(C'\fR درج کرده و پرچم‌ها را بررسی می‌کند. این روش سریع‌تر از مقایسه نرم‌افزاری است، اما ممکن است در حضور مقادیر NaN، یا زمانی که دو عدد کوچکِ متفاوت به گونه‌ای مقایسه می‌شوند که تفاضل آن‌ها صفر محاسبه می‌شود، نتایج نادرستی ایجاد کند. حالت پیش‌فرض \fB\-msoft\-cmpsf\fR است که از مقایسه‌های نرم‌افزاری کندتر ولی سازگار با IEEE استفاده می‌کند.
.IP \fB\-mstack\-offset=\fR\fInum\fR 4
.IX Item "-mstack-offset=num"
تنظیم فاصله (افست) بین بالای پشته و اشاره‌گر پشته.
برای مثال، مقدار ۸ به این معنی است که هشت بایت در محدوده \f(CW\*(C`sp+0...sp+7\*(C'\fR می‌تواند توسط توابع برگ (leaf functions) بدون تخصیص پشته استفاده شود.
مقادیری غیر از \fB8\fR یا \fB16\fR آزمایش‌نشده هستند و بعید است به‌درستی کار کنند.
همچنین توجه داشته باشید که این گزینه ABI را تغییر می‌دهد؛ کامپایل کردن برنامه‌ای با افست پشته متفاوت از کتابخانه‌هایی که برنامه با آن‌ها کامپایل شده است، معمولاً کار نخواهد کرد.
این گزینه در صورتی مفید است که بخواهید ارزیابی کنید آیا یک افست پشته متفاوت کد بهتری تولید می‌کند یا خیر، اما برای استفاده واقعی از یک افست پشته دیگر جهت ساخت برنامه‌های کاربردی، توصیه می‌شود زنجیره ابزار (toolchain) با گزینه مناسب \fB\-\-with\-stack\-offset=\fR\fInum\fR پیکربندی شود.
.IP \fB\-mno\-round\-nearest\fR 4
.IX Item "-mno-round-nearest".PD 0
.IP \fB\-mround\-nearest\fR 4
.IX Item "-mround-nearest"
.PD
\&\fB\-mno\-round\-nearest\fR
باعث می‌شود که زمان‌بند فرض کند حالت گرد کردن روی بُرش (truncating) تنظیم شده است. پیش‌فرض \fB\-mround\-nearest\fR است.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
اگر به‌طور دیگری توسط یک صفت (attribute) مشخص نشده باشد، فرض می‌کند همهٔ فراخوانی‌ها ممکن است فراتر از محدودهٔ آفست دستورالعمل‌های \f(CW\*(C`b\*(C'\fR / \f(CW\*(C`bl\*(C'\fR باشند، و بنابراین نشانی تابع را پیش از اجرای فراخوانی (که در غیر این صورت مستقیم بود) درون یک ثبات بارگذاری می‌کند. این حالت پیش‌فرض است.
.IP \fB\-mshort\-calls\fR 4
.IX Item "-mshort-calls"
اگر به‌طور دیگری توسط یک صفت مشخص نشده باشد، فرض می‌کند همهٔ فراخوانی‌های مستقیم در محدودهٔ دستورالعمل‌های \f(CW\*(C`b\*(C'\fR / \f(CW\*(C`bl\*(C'\fR قرار دارند، بنابراین از این دستورالعمل‌ها برای فراخوانی‌های مستقیم استفاده می‌کند.
.Sp
پیش‌فرض \fB\-mlong\-calls\fR است. توجه داشته باشید که \fB\-mlong\-calls\fR معادل \fB\-mno\-short\-calls\fR است، و به همین ترتیب \&\fB\-mno\-long\-calls\fR معادل \fB\-mshort\-calls\fR است.
.IP \fB\-msmall16\fR 4
.IX Item "-msmall16"
.PD 0
.IP \fB\-mno\-small16\fR 4
.IX Item "-mno-small16"
.PD
فرض می‌کند نشانی‌ها می‌توانند به عنوان مقادیر بدون علامت ۱۶ بیتی بارگذاری شوند. این مورد برای نشانی‌های توابعی که معناشناسی \fB\-mlong\-calls\fR برای آن‌ها اعمال شده، صدق نمی‌کند.
.IP \fB\-mfp\-mode=\fR\fImode\fR 4
.IX Item "-mfp-mode=mode"
حالت غالب واحد ممیز شناور (FPU) را تنظیم می‌کند.
این گزینه حالت ممیز شناوری را تعیین می‌کند که در زمان فراخوانی و بازگشت تابع ارائه شده و مورد انتظار است.
تطبیق دادن این حالت با حالتی که بیشتر در شروع تابع به آن نیاز دارید، می‌تواند با جلوگیری از تغییر حالت‌های غیرضروری، برنامه‌های شما را کوچک‌تر و سریع‌تر کند.
.Sp
مقدار \fImode\fR می‌تواند روی یکی از مقادیر زیر تنظیم شود:
.RS 4
.IP \fBcaller\fR 4
.IX Item "caller"
هر حالتی در هنگام ورود به تابع معتبر است، و با بازگشت تابع و زمان فراخوانی توابع دیگر، حفظ یا بازیابی می‌شود. این حالت برای کامپایل کتابخانه‌ها یا سایر واحدهای کامپایلی مفید است که ممکن است بخواهید آن‌ها را در برنامه‌های مختلف با حالت‌های غالب متفاوت FPU ادغام کنید؛ در این وضعیت، سهولت استفاده از یک فایل شیء (object file) منفرد، بر بار اضافهٔ حجم و سرعت ناشی از هرگونه تغییر حالت اضافی که ممکن است در مقایسه با انتخاب حالت غالب دقیق‌تر FPU لازم باشد، ارجحیت دارد.
.IP \fBtruncate\fR 4
.IX Item "truncate"
این حالتی است که برای محاسبات ممیز شناور با حالت گرد کردن بُرِشی (یعنی گرد کردن به سمت صفر) استفاده می‌شود. این شامل تبدیل از ممیز شناور به عدد صحیح نیز هست.
.IP \fBround\-nearest\fR 4
.IX Item "round-nearest"
این حالتی است که برای محاسبات ممیز شناور با حالت گرد کردن به نزدیک‌ترین یا زوج (round-to-nearest-or-even) استفاده می‌شود.
.IP \fBint\fR 4
.IX Item "int"
این حالتی است که برای انجام محاسبات اعداد صحیح در FPU استفاده می‌شود، مانند ضرب عدد صحیح یا ضرب و جمع انباشتهٔ اعداد صحیح.
.RE
.RS 4
.Sp
پیش‌فرض \fB\-mfp\-mode=caller\fR است.
.RE
.IP \fB\-mmay\-round\-for\-trunc\fR 4
.IX Item "-mmay-round-for-trunc"
.PD 0
.IP \fB\-mno\-may\-round\-for\-trunc\fR 4
.IX Item "-mno-may-round-for-trunc"
.PD
این گزینه اجازه می‌دهد بُرش ممیز شناور به عدد صحیح با گرد کردن جایگزین شود تا در تعویض حالت صرفه‌جویی شود. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mfp\-iarith\fR 4
.IX Item "-mfp-iarith"
.PD 0
.IP \fB\-mno\-fp\-iarith\fR 4
.IX Item "-mno-fp-iarith"
.PD
این گزینه استفاده از واحد ممیز شناور را برای جمع و تفریق اعداد صحیح فعال می‌کند. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-msplit\-lohi\fR 4
.IX Item "-msplit-lohi"
.PD 0
.IP \fB\-mno\-split\-lohi\fR 4
.IX Item "-mno-split-lohi"
.IP \fB\-mpost\-inc\fR 4
.IX Item "-mpost-inc"
.IP \fB\-mno\-post\-inc\fR 4
.IX Item "-mno-post-inc"
.IP \fB\-mpost\-modify\fR 4
.IX Item "-mpost-modify"
.IP \fB\-mno\-post\-modify\fR 4
.IX Item "-mno-post-modify"
.PD
بهینه‌سازی‌های جزئی تولید کد که به ترتیب تقسیم بارگذاری‌های ۳۲ بیتی، تولید نشانی‌های پس‌افزایشی (post\-increment)، و تولید نشانی‌های پس‌اصلاحی (post\-modify) را کنترل می‌کنند. حالت‌های پیش‌فرض عبارتند از \fBmsplit\-lohi\fR، \&\fB\-mpost\-inc\fR و \fB\-mpost\-modify\fR.
.IP \fB\-mno\-vect\-double\fR 4
.IX Item "-mno-vect-double"
حالت SIMD ترجیحی را به SImode تغییر می‌دهد. پیش‌فرض \&\fB\-mvect\-double\fR است که از DImode به عنوان حالت ترجیحی SIMD استفاده می‌کند.
.IP \fB\-max\-vect\-align=\fR\fInum\fR 4
.IX Item "-max-vect-align=num"
حداکثر تراز (alignment) برای انواع حالت برداری SIMD. مقدار \&\fInum\fR می‌تواند ۴ یا ۸ باشد. پیش‌فرض ۸ است. توجه داشته باشید که این یک تغییر در ABI است، هرچند بسیاری از رابط‌های توابع کتابخانه‌ای در صورتی که از حالت‌های برداری SIMD در مواردی که بر اندازه یا تراز انواع مربوطه تأثیر می‌گذارد استفاده نکنند، دست‌نخورده باقی می‌مانند.
.IP \fB\-msplit\-vecmove\-early\fR 4
.IX Item "-msplit-vecmove-early"
.PD 0
.IP \fB\-mno\-split\-vecmove\-early\fR 4
.IX Item "-mno-split-vecmove-early"
.PD
انتقال‌های برداری را پیش از reload به انتقال‌های تک‌کلمه‌ای تقسیم می‌کند. از نظر تئوری این کار می‌تواند تخصیص ثبات بهتری ارائه دهد، اما تاکنون عموماً خلاف این صادق بوده است.
.IP \fB\-m1reg\-\fR\fIreg\fR 4
.IX Item "-m1reg-reg"
ثباتی را برای نگه‌داشتن مقدار ثابت \-1 مشخص می‌کند، که بارگذاری مقادیر ثابت منفی کوچک و برخی ماسک‌های بیتی را سریع‌تر می‌سازد. مقادیر مجاز برای \fIreg\fR عبارتند از \fBr43\fR و \fBr63\fR، که استفاده از آن ثبات را به عنوان ثبات ثابت تعیین می‌کنند، و \fBnone\fR، که نشان می‌دهد هیچ ثباتی برای این منظور استفاده نمی‌شود. پیش‌فرض \fB\-m1reg\-none\fR است.
.PP
\fIگزینه‌های AMD GCN\fR
.IX Subsection "AMD GCN Options"
.PP
این گزینه‌ها به‌طور خاص برای پورت AMD GCN تعریف شده‌اند.
.IP \fB\-march=\fR\fIgpu\fR 4
.IX Item "-march=gpu"
.PD 0
.IP \fB\-mtune=\fR\fIgpu\fR 4
.IX Item "-mtune=gpu"
.PD
نوع معماری یا تنظیم بهینه‌سازی (tuning) را برای \fIgpu\fR تعیین می‌کند. مقادیر پشتیبانی‌شده برای \fIgpu\fR عبارتند از:
.RS 4
.IP \fBgfx900\fR 4
.IX Item "gfx900"
کامپایل برای دستگاه‌های GCN5 Vega 10 (gfx900).
.IP \fBgfx902\fR 4
.IX Item "gfx902"
کامپایل برای دستگاه‌های GCN5 Vega gfx902. (آزمایشی)
.IP \fBgfx904\fR 4
.IX Item "gfx904"
کامپایل برای دستگاه‌های GCN5 Vega gfx904. (آزمایشی)
.IP \fBgfx906\fR 4
.IX Item "gfx906"
کامپایل برای دستگاه‌های GCN5 Vega 20 (gfx906).
.IP \fBgfx908\fR 4
.IX Item "gfx908"
کامپایل برای دستگاه‌های سری CDNA1 Instinct MI100 (gfx908).
.IP \fBgfx909\fR 4
.IX Item "gfx909"
کامپایل برای دستگاه‌های GCN5 Vega gfx909. (آزمایشی)
.IP \fBgfx90a\fR 4
.IX Item "gfx90a"
کامپایل برای دستگاه‌های سری CDNA2 Instinct MI200 (gfx90a).
.IP \fBgfx90c\fR 4
.IX Item "gfx90c"
کامپایل برای دستگاه‌های GCN5 Vega 7 (gfx90c).
.IP \fBgfx942\fR 4
.IX Item "gfx942"
کامپایل برای دستگاه‌های سری CDNA3 Instinct MI300 (gfx942). (آزمایشی)
.IP \fBgfx950\fR 4
.IX Item "gfx950"
کامپایل برای دستگاه‌های CDNA3 gfx950. (آزمایشی)
.IP \fBgfx9\-generic\fR 4
.IX Item "gfx9-generic"
کامپایل کد عمومی برای دستگاه‌های Vega، قابل اجرا بر روی زیرمجموعهٔ زیر از دستگاه‌های GFX9: gfx900، gfx902، gfx904، gfx906، gfx909 و gfx90c.
.IP \fBgfx9\-4\-generic\fR 4
.IX Item "gfx9-4-generic"
کامپایل کد عمومی برای دستگاه‌های CDNA3، قابل اجرا بر روی زیرمجموعهٔ زیر از دستگاه‌های GFX9: gfx942 و gfx950. (آزمایشی).IP \fBgfx1030\fR 4
.IX Item "gfx1030"
کامپایل برای دستگاه‌های RDNA2 gfx1030 (سری GFX10).
.IP \fBgfx1031\fR 4
.IX Item "gfx1031"
کامپایل برای دستگاه‌های RDNA2 gfx1031 (سری GFX10). (آزمایشی)
.IP \fBgfx1032\fR 4
.IX Item "gfx1032"
کامپایل برای دستگاه‌های RDNA2 gfx1032 (سری GFX10). (آزمایشی)
.IP \fBgfx1033\fR 4
.IX Item "gfx1033"
کامپایل برای دستگاه‌های RDNA2 gfx1033 (سری GFX10). (آزمایشی)
.IP \fBgfx1034\fR 4
.IX Item "gfx1034"
کامپایل برای دستگاه‌های RDNA2 gfx1034 (سری GFX10). (آزمایشی)
.IP \fBgfx1035\fR 4
.IX Item "gfx1035"
کامپایل برای دستگاه‌های RDNA2 gfx1035 (سری GFX10). (آزمایشی)
.IP \fBgfx1036\fR 4
.IX Item "gfx1036"
کامپایل برای دستگاه‌های RDNA2 gfx1036 (سری GFX10).
.IP \fBgfx10\-3\-generic\fR 4
.IX Item "gfx10-3-generic"
کامپایل کد عمومی برای دستگاه‌های GFX10\-3، قابل اجرا روی gfx1030،
gfx1031، gfx1032، gfx1033، gfx1034، gfx1035، و gfx1036.
.IP \fBgfx1100\fR 4
.IX Item "gfx1100"
کامپایل برای دستگاه‌های RDNA3 gfx1100 (سری GFX11).
.IP \fBgfx1101\fR 4
.IX Item "gfx1101"
کامپایل برای دستگاه‌های RDNA3 gfx1101 (سری GFX11). (آزمایشی)
.IP \fBgfx1102\fR 4
.IX Item "gfx1102"
کامپایل برای دستگاه‌های RDNA3 gfx1102 (سری GFX11). (آزمایشی)
.IP \fBgfx1103\fR 4
.IX Item "gfx1103"
کامپایل برای دستگاه‌های RDNA3 gfx1103 (سری GFX11).
.IP \fBgfx1150\fR 4
.IX Item "gfx1150"
کامپایل برای دستگاه‌های RDNA3 gfx1150 (سری GFX11). (آزمایشی)
.IP \fBgfx1151\fR 4
.IX Item "gfx1151"
کامپایل برای دستگاه‌های RDNA3 gfx1151 (سری GFX11). (آزمایشی)
.IP \fBgfx1152\fR 4
.IX Item "gfx1152"
کامپایل برای دستگاه‌های RDNA3 gfx1152 (سری GFX11). (آزمایشی)
.IP \fBgfx1153\fR 4
.IX Item "gfx1153"
کامپایل برای دستگاه‌های RDNA3 gfx1153 (سری GFX11). (آزمایشی)
.IP \fBgfx11\-generic\fR 4
.IX Item "gfx11-generic"
کامپایل کد عمومی برای دستگاه‌های GFX11، قابل اجرا روی gfx1100، gfx1101،
gfx1102، gfx1103، gfx1150، gfx1151، gfx1152، و gfx1153.
.RE
.RS 4
.RE
.IP \fB\-mgang\-private\-size=\fR\fIbytes\fR 4
.IX Item "-mgang-private-size=bytes"
تنظیم مقدار حافظهٔ اشتراک داده محلی (LDS) جهت رزرو برای
متغیرهای gang\-private. مقدار پیش‌فرض 512 است.
.IP \fB\-msram\-ecc=on\fR 4
.IX Item "-msram-ecc=on"
.PD 0
.IP \fB\-msram\-ecc=off\fR 4
.IX Item "-msram-ecc=off"
.IP \fB\-msram\-ecc=any\fR 4
.IX Item "-msram-ecc=any"
.PD
کامپایل باینری‌های مناسب برای دستگاه‌هایی که قابلیت SRAM\-ECC در آن‌ها فعال،
غیرفعال یا در هر یک از این دو حالت باشد. این قابلیت در برخی دستگاه‌ها
می‌تواند به‌ازای هر فرایند فعال شود. کد کامپایل‌شده باید با حالت دستگاه
مطابقت داشته باشد. مقدار پیش‌فرض برای دستگاه‌هایی که از آن پشتیبانی می‌کنند
\&\fBany\fR است.
.IP \fB\-mxnack=on\fR 4
.IX Item "-mxnack=on"
.PD 0
.IP \fB\-mxnack=off\fR 4
.IX Item "-mxnack=off"
.IP \fB\-mxnack=any\fR 4
.IX Item "-mxnack=any"
.PD
کامپایل باینری‌های مناسب برای دستگاه‌هایی که قابلیت XNACK در آن‌ها فعال،
غیرفعال یا در هر یک از این دو حالت است. برخی از دستگاه‌ها همیشه به XNACK
نیاز دارند و برخی به کاربر اجازهٔ پیکربندی XNACK را می‌دهند. کد کامپایل‌شده
باید با حالت دستگاه مطابقت داشته باشد. مقدار پیش‌فرض در دستگاه‌هایی که از
حافظهٔ اشتراکی یکپارچه (Unified Shared Memory) پشتیبانی می‌کنند \fB\-mxnack=any\fR
است، و در غیر این صورت \fB\-mxnack=no\fR.
.IP \fB\-Wopenacc\-dims\fR 4
.IX Item "-Wopenacc-dims"
.PD 0
.IP \fB\-Wno\-openacc\-dims\fR 4
.IX Item "-Wno-openacc-dims"
.PD
کنترل هشدارهای مربوط به ابعاد نامعتبر OpenACC.
.PP
\fIگزینه‌های ARC\fR
.IX Subsection "ARC Options"
.PP
گزینه‌های زیر گونهٔ معماری‌ای را که کد برای آن کامپایل می‌شود،
کنترل می‌کنند:
.IP \fB\-mbarrel\-shifter\fR 4
.IX Item "-mbarrel-shifter"
تولید دستورالعمل‌های پشتیبانی‌شده توسط barrel shifter. این حالت پیش‌فرض است،
مگر اینکه \fB\-mcpu=ARC601\fR یا \fB\-mcpu=ARCEM\fR فعال باشد.
.IP \fB\-mjli\-always\fR 4
.IX Item "-mjli-always"
اجبار به فراخوانی یک تابع با استفاده از دستور jli_s. این گزینه
تنها برای معماری ARCv2 معتبر است.
.IP \fB\-mcpu=\fR\fIcpu\fR 4
.IX Item "-mcpu=cpu"
تنظیم نوع معماری، نحوهٔ استفاده از ثبات‌ها، و پارامترهای زمان‌بندی دستورالعمل‌ها
برای \fIcpu\fR. همچنین گزینه‌های نام مستعار میان‌بری برای سازگاری با گذشته
و سهولت در دسترس هستند. مقادیر پشتیبانی‌شده برای \fIcpu\fR عبارت‌اند از:
.RS 4
.IP \fBarc600\fR 4
.IX Item "arc600"
کامپایل برای ARC600. نام‌های مستعار: \fB\-mA6\fR، \fB\-mARC600\fR.
.IP \fBarc601\fR 4
.IX Item "arc601"
کامپایل برای ARC601. نام مستعار: \fB\-mARC601\fR.
.IP \fBarc700\fR 4
.IX Item "arc700"
کامپایل برای ARC700. نام‌های مستعار: \fB\-mA7\fR، \fB\-mARC700\fR.
در صورت پیکربندی با \fB\-\-with\-cpu=arc700\fR، این حالت پیش‌فرض است.
.IP \fBarcem\fR 4
.IX Item "arcem"
کامپایل برای ARC EM.
.IP \fBarchs\fR 4
.IX Item "archs"
کامپایل برای ARC HS.
.IP \fBem\fR 4
.IX Item "em"
کامپایل برای پردازندهٔ ARC EM بدون افزونه‌های سخت‌افزاری.
.IP \fBem4\fR 4
.IX Item "em4"
کامپایل برای پردازندهٔ ARC EM4.
.IP \fBem4_dmips\fR 4
.IX Item "em4_dmips"
کامپایل برای پردازندهٔ ARC EM4 DMIPS.
.IP \fBem4_fpus\fR 4
.IX Item "em4_fpus"
کامپایل برای پردازندهٔ ARC EM4 DMIPS به‌همراه افزونهٔ ممیز شناور با
دقت یگانه (single\-precision).
.IP \fBem4_fpuda\fR 4
.IX Item "em4_fpuda"
کامپایل برای پردازندهٔ ARC EM4 DMIPS با ممیز شناور دقت یگانه و
دستورالعمل‌های کمکی دقت مضاعف (double assist).
.IP \fBhs\fR 4
.IX Item "hs"
کامپایل برای پردازندهٔ ARC HS بدون هیچ‌گونه افزونه سخت‌افزاری به جز
دستورالعمل‌های اتمیک (atomic).
.IP \fBhs34\fR 4
.IX Item "hs34"
کامپایل برای پردازندهٔ ARC HS34.
.IP \fBhs38\fR 4
.IX Item "hs38"
کامپایل برای پردازندهٔ ARC HS38.
.IP \fBhs38_linux\fR 4
.IX Item "hs38_linux"
کامپایل برای پردازندهٔ ARC HS38 با فعال بودن تمامی افزونه‌های سخت‌افزاری.
.IP \fBhs4x\fR 4
.IX Item "hs4x"
کامپایل برای پردازندهٔ ARC HS4x.
.IP \fBhs4xd\fR 4
.IX Item "hs4xd"
کامپایل برای پردازندهٔ ARC HS4xD.
.IP \fBhs4x_rel31\fR 4
.IX Item "hs4x_rel31"
کامپایل برای پردازندهٔ ARC HS4x نگارش 3.10a.
.IP \fBarc600_norm\fR 4
.IX Item "arc600_norm"
کامپایل برای پردازندهٔ ARC 600 با فعال بودن دستورالعمل‌های \f(CW\*(C`norm\*(C'\fR.
.IP \fBarc600_mul32x16\fR 4
.IX Item "arc600_mul32x16"
کامپایل برای پردازندهٔ ARC 600 با فعال بودن دستورالعمل‌های \f(CW\*(C`norm\*(C'\fR و ضرب ۳۲ در ۱۶ بیتی.
.IP \fBarc600_mul64\fR 4
.IX Item "arc600_mul64"
کامپایل برای پردازندهٔ ARC 600 با فعال بودن دستورالعمل‌های \f(CW\*(C`norm\*(C'\fR و خانوادهٔ \f(CW\*(C`mul64\*(C'\fR.
.IP \fBarc601_norm\fR 4
.IX Item "arc601_norm"
کامپایل برای پردازندهٔ ARC 601 با فعال بودن دستورالعمل‌های \f(CW\*(C`norm\*(C'\fR..IP \fBarc601_mul32x16\fR 4
.IX Item "arc601_mul32x16"
کامپایل برای پردازندهٔ ARC 601 با فعال بودن دستورهای ضرب 32x16\-bit و \f(CW\*(C`norm\*(C'\fR.
.IP \fBarc601_mul64\fR 4
.IX Item "arc601_mul64"
کامپایل برای پردازندهٔ ARC 601 با فعال بودن دستورهای خانوادهٔ \f(CW\*(C`mul64\*(C'\fR و \f(CW\*(C`norm\*(C'\fR.
.IP \fBnps400\fR 4
.IX Item "nps400"
کامپایل برای ARC 700 روی تراشهٔ NPS400.
.IP \fBem_mini\fR 4
.IX Item "em_mini"
کامپایل برای پیکربندی کمینه‌گرای ARC EM دارای مجموعه ثبات‌های کاهش‌یافته.
.RE
.RS 4
.RE
.IP \fB\-mdpfp\fR 4
.IX Item "-mdpfp"
.PD 0
.IP \fB\-mdpfp\-compact\fR 4
.IX Item "-mdpfp-compact"
.PD
تولید دستورهای FPX با دقت مضاعف (double\-precision)، بهینه‌شده برای پیاده‌سازی فشرده (compact).
.IP \fB\-mdpfp\-fast\fR 4
.IX Item "-mdpfp-fast"
تولید دستورهای FPX با دقت مضاعف، بهینه‌شده برای پیاده‌سازی سریع (fast).
.IP \fB\-mno\-dpfp\-lrsr\fR 4
.IX Item "-mno-dpfp-lrsr"
.PD 0
.IP \fB\-mdpfp\-lrsr\fR 4
.IX Item "-mdpfp-lrsr"
.PD
کنترل این‌که آیا دستورهای \f(CW\*(C`lr\*(C'\fR و \f(CW\*(C`sr\*(C'\fR از ثبات‌های کمکی (aux registers) افزونهٔ FPX استفاده کنند یا خیر. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mea\fR 4
.IX Item "-mea"
تولید دستورهای محاسباتی گسترش‌یافته (extended arithmetic). در حال حاضر تنها
\&\f(CW\*(C`divaw\*(C'\fR، \f(CW\*(C`adds\*(C'\fR، \f(CW\*(C`subs\*(C'\fR و \f(CW\*(C`sat16\*(C'\fR
پشتیبانی می‌شوند. فقط برای \fB\-mcpu=ARC700\fR معتبر است.
.IP \fB\-mmul32x16\fR 4
.IX Item "-mmul32x16"
تولید دستورهای ضرب و ضرب\-انباشت (multiply\-accumulate) 32x16\-bit.
.IP \fB\-mmul64\fR 4
.IX Item "-mmul64"
تولید دستورهای \f(CW\*(C`mul64\*(C'\fR و \f(CW\*(C`mulu64\*(C'\fR.
فقط برای \fB\-mcpu=ARC600\fR معتبر است.
.IP \fB\-mnorm\fR 4
.IX Item "-mnorm"
تولید دستورهای \f(CW\*(C`norm\*(C'\fR. در صورتی که \fB\-mcpu=ARC700\fR اعمال شده باشد، این حالت پیش‌فرض است.
.IP \fB\-mspfp\fR 4
.IX Item "-mspfp"
.PD 0
.IP \fB\-mspfp\-compact\fR 4
.IX Item "-mspfp-compact"
.PD
تولید دستورهای FPX با دقت یگانه (single\-precision)، بهینه‌شده برای پیاده‌سازی فشرده (compact).
.IP \fB\-mspfp\-fast\fR 4
.IX Item "-mspfp-fast"
تولید دستورهای FPX با دقت یگانه، بهینه‌شده برای پیاده‌سازی سریع (fast).
.IP \fB\-msimd\fR 4
.IX Item "-msimd"
فعال‌سازی تولید دستورهای ARC SIMD از طریق توابع توکار (builtins) ویژهٔ مقصد. فقط برای \fB\-mcpu=ARC700\fR معتبر است.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
این گزینه نادیده گرفته می‌شود؛ صرفاً برای اهداف سازگاری ارائه شده است.
کد ممیز شناور نرم‌افزاری به‌طور پیش‌فرض تولید می‌شود و این مقدار پیش‌فرض می‌تواند
توسط گزینه‌های FPX جایگزین شود؛ \fB\-mspfp\fR، \fB\-mspfp\-compact\fR، یا
\&\fB\-mspfp\-fast\fR برای دقت یگانه، و \fB\-mdpfp\fR،
\&\fB\-mdpfp\-compact\fR، یا \fB\-mdpfp\-fast\fR برای دقت مضاعف.
.IP \fB\-mswap\fR 4
.IX Item "-mswap"
تولید دستورهای \f(CW\*(C`swap\*(C'\fR.
.IP \fB\-matomic\fR 4
.IX Item "-matomic"
این گزینه استفاده از افزونهٔ شرطی بارگذاری/ذخیره‌سازی قفل‌شده (locked load/store conditional) را برای پیاده‌سازی توابع توکار حافظهٔ اتمیک فعال می‌کند. برای هسته‌های ARC 6xx یا ARC EM در دسترس نیست.
.IP \fB\-mdiv\-rem\fR 4
.IX Item "-mdiv-rem"
فعال‌سازی دستورهای \f(CW\*(C`div\*(C'\fR و \f(CW\*(C`rem\*(C'\fR برای هسته‌های ARCv2.
.IP \fB\-mcode\-density\fR 4
.IX Item "-mcode-density"
.PD 0
.IP \fB\-mno\-code\-density\fR 4
.IX Item "-mno-code-density"
.PD
فعال‌سازی دستورهای چگالی کد (code density) برای ARC EM.
این گزینه به‌طور پیش‌فرض برای ARC HS فعال است.
.IP \fB\-mll64\fR 4
.IX Item "-mll64"
فعال‌سازی عملیات بارگذاری/ذخیره‌سازی دوگانه (double load/store) برای هسته‌های ARC HS.
.IP \fB\-mtp\-regno=\fR\fIregno\fR 4
.IX Item "-mtp-regno=regno"
تعیین شمارهٔ ثبات اشاره‌گر رشته (thread pointer).
.IP \fB\-mbitops\fR 4
.IX Item "-mbitops"
فعال‌سازی استفاده از عملیات بیتی NPS400.
.IP \fB\-mcmem\fR 4
.IX Item "-mcmem"
فعال‌سازی استفاده از افزونهٔ xld/xst در NPS400.
.IP \fB\-mmpy\-option=\fR\fImulto\fR 4
.IX Item "-mmpy-option=multo"
کامپایل کد ARCv2 با یک گزینهٔ طراحی ضرب‌کننده (multiplier). می‌توانید
این گزینه را با استفاده از یک رشته یا یک مقدار عددی برای \fImulto\fR مشخص کنید.
\&\fBwlh1\fR مقدار پیش‌فرض است. مقادیر شناخته‌شده عبارتند از:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
.PD 0
.IP \fBnone\fR 4
.IX Item "none"
.PD
هیچ ضرب‌کننده‌ای در دسترس نیست.
.IP \fB1\fR 4
.IX Item "1"
.PD 0
.IP \fBw\fR 4
.IX Item "w"
.PD
ضرب‌کنندهٔ 16x16، کاملاً خط‌لوله‌ای (fully pipelined).
دستورهای زیر فعال می‌شوند: \f(CW\*(C`mpyw\*(C'\fR و \f(CW\*(C`mpyuw\*(C'\fR.
.IP \fB2\fR 4
.IX Item "2"
.PD 0
.IP \fBwlh1\fR 4
.IX Item "wlh1"
.PD
ضرب‌کنندهٔ 32x32، کاملاً
خط‌لوله‌ای (۱ مرحله). دستورهای زیر نیز علاوه بر آن
فعال می‌شوند: \f(CW\*(C`mpy\*(C'\fR، \f(CW\*(C`mpyu\*(C'\fR، \f(CW\*(C`mpym\*(C'\fR، \f(CW\*(C`mpymu\*(C'\fR و \f(CW\*(C`mpy_s\*(C'\fR.
.IP \fB3\fR 4
.IX Item "3"
.PD 0
.IP \fBwlh2\fR 4
.IX Item "wlh2"
.PD
ضرب‌کنندهٔ 32x32، کاملاً خط‌لوله‌ای
(۲ مرحله). دستورهای زیر نیز علاوه بر آن فعال می‌شوند: \f(CW\*(C`mpy\*(C'\fR،
\&\f(CW\*(C`mpyu\*(C'\fR، \f(CW\*(C`mpym\*(C'\fR، \f(CW\*(C`mpymu\*(C'\fR و \f(CW\*(C`mpy_s\*(C'\fR.
.IP \fB4\fR 4
.IX Item "4"
.PD 0
.IP \fBwlh3\fR 4
.IX Item "wlh3"
.PD
دو ضرب‌کنندهٔ 16x16، انسدادی (blocking)،
ترتیبی (sequential). دستورهای زیر نیز علاوه بر آن فعال می‌شوند: \f(CW\*(C`mpy\*(C'\fR،
\&\f(CW\*(C`mpyu\*(C'\fR، \f(CW\*(C`mpym\*(C'\fR، \f(CW\*(C`mpymu\*(C'\fR و \f(CW\*(C`mpy_s\*(C'\fR.
.IP \fB5\fR 4
.IX Item "5"
.PD 0
.IP \fBwlh4\fR 4
.IX Item "wlh4"
.PD
یک ضرب‌کنندهٔ 16x16، انسدادی،
ترتیبی. دستورهای زیر نیز علاوه بر آن فعال می‌شوند: \f(CW\*(C`mpy\*(C'\fR،
\&\f(CW\*(C`mpyu\*(C'\fR، \f(CW\*(C`mpym\*(C'\fR، \f(CW\*(C`mpymu\*(C'\fR و \f(CW\*(C`mpy_s\*(C'\fR.
.IP \fB6\fR 4
.IX Item "6"
.PD 0
.IP \fBwlh5\fR 4
.IX Item "wlh5"
.PD
یک ضرب‌کنندهٔ 32x4، انسدادی،
ترتیبی. دستورهای زیر نیز علاوه بر آن فعال می‌شوند: \f(CW\*(C`mpy\*(C'\fR،
\&\f(CW\*(C`mpyu\*(C'\fR، \f(CW\*(C`mpym\*(C'\fR، \f(CW\*(C`mpymu\*(C'\fR و \f(CW\*(C`mpy_s\*(C'\fR.
.IP \fB7\fR 4
.IX Item "7"
.PD 0
.IP \fBplus_dmpy\fR 4
.IX Item "plus_dmpy"
.PD
پشتیبانی از SIMD در ARC HS..IP \fB8\fR 4
.IX Item "8"
.PD 0
.IP \fBplus_macd\fR 4
.IX Item "plus_macd"
.PD
پشتیبانی از SIMD پردازنده‌های ARC HS.
.IP \fB9\fR 4
.IX Item "9"
.PD 0
.IP \fBplus_qmacw\fR 4
.IX Item "plus_qmacw"
.PD
پشتیبانی از SIMD پردازنده‌های ARC HS.
.RE
.RS 4
.Sp
این گزینه تنها برای هسته‌های ARCv2 در دسترس است.
.RE
.IP \fB\-mfpu=\fR\fIfpu\fR 4
.IX Item "-mfpu=fpu"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور خاص را برای هسته‌های ARCv2
فعال می‌کند. مقادیر پشتیبانی‌شده برای \fIfpu\fR عبارتند از:
.RS 4
.IP \fBfpus\fR 4
.IX Item "fpus"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه را فعال می‌کند.
.IP \fBfpud\fR 4
.IX Item "fpud"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف را فعال می‌کند.
افزونهٔ ممیز شناور با دقت یگانه نیز فعال می‌شود. برای ARC EM در دسترس نیست.
.IP \fBfpuda\fR 4
.IX Item "fpuda"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف را با استفاده از
دستورالعمل‌های کمکی دقت مضاعف فعال می‌کند. افزونهٔ ممیز شناور با دقت یگانه
نیز فعال می‌شود. این گزینه تنها برای ARC EM در دسترس است.
.IP \fBfpuda_div\fR 4
.IX Item "fpuda_div"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف را با استفاده از
دستورالعمل‌های کمکی دقت مضاعف فعال می‌کند. افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه،
ریشهٔ دوم و تقسیم نیز فعال می‌شوند. این گزینه تنها برای ARC EM در دسترس است.
.IP \fBfpuda_fma\fR 4
.IX Item "fpuda_fma"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف را با استفاده از
دستورالعمل‌های کمکی دقت مضاعف فعال می‌کند. افزونه‌های سخت‌افزاری ممیز شناور
با دقت یگانه و ضرب و جمع ادغام‌شده نیز فعال می‌شوند. این گزینه تنها برای ARC EM
در دسترس است.
.IP \fBfpuda_all\fR 4
.IX Item "fpuda_all"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف را با استفاده از
دستورالعمل‌های کمکی دقت مضاعف فعال می‌کند. تمامی افزونه‌های سخت‌افزاری ممیز شناور
با دقت یگانه نیز فعال می‌شوند. این گزینه تنها برای ARC EM در دسترس است.
.IP \fBfpus_div\fR 4
.IX Item "fpus_div"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه، ریشهٔ دوم و تقسیم را فعال می‌کند.
.IP \fBfpud_div\fR 4
.IX Item "fpud_div"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف، ریشهٔ دوم و تقسیم را
فعال می‌کند. این گزینه شامل گزینهٔ \fBfpus_div\fR نیز می‌شود. برای ARC EM در دسترس نیست.
.IP \fBfpus_fma\fR 4
.IX Item "fpus_fma"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه و ضرب و جمع ادغام‌شده را فعال می‌کند.
.IP \fBfpud_fma\fR 4
.IX Item "fpud_fma"
پشتیبانی از افزونه‌های سخت‌افزاری ممیز شناور با دقت مضاعف و ضرب و جمع ادغام‌شده را
فعال می‌کند. این گزینه شامل گزینهٔ \fBfpus_fma\fR نیز می‌شود. برای ARC EM در دسترس نیست.
.IP \fBfpus_all\fR 4
.IX Item "fpus_all"
پشتیبانی از تمامی افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه را فعال می‌کند.
.IP \fBfpud_all\fR 4
.IX Item "fpud_all"
پشتیبانی از تمامی افزونه‌های سخت‌افزاری ممیز شناور با دقت یگانه و مضاعف را
فعال می‌کند. برای ARC EM در دسترس نیست.
.RE
.RS 4
.RE
.IP "\fB\-mirq\-ctrl\-saved=\fR\fIregister\-range\fR\fB,\fR \fIblink\fR\fB,\fR \fIlp_count\fR" 4
.IX Item "-mirq-ctrl-saved=register-range, blink, lp_count"
ثبات‌های همه‌منظوره‌ای را مشخص می‌کند که پردازنده هنگام ورود و خروج وقفه به‌طور خودکار
ذخیره/بازیابی می‌کند. \fIregister\-range\fR به‌صورت دو ثبات که با یک خط تیره جدا شده‌اند
مشخص می‌شود. محدودهٔ ثبات‌ها همواره با \f(CW\*(C`r0\*(C'\fR آغاز می‌شود و حد بالایی آن
ثبات \f(CW\*(C`fp\*(C'\fR است. \&\fIblink\fR و \fIlp_count\fR اختیاری هستند. این گزینه
تنها برای هسته‌های ARC EM و ARC HS معتبر است.
.IP \fB\-mrgf\-banked\-regs=\fR\fInumber\fR 4
.IX Item "-mrgf-banked-regs=number"
تعداد ثبات‌هایی را مشخص می‌کند که در هنگام ورود به وقفهٔ سریع در بانک دوم ثبات‌ها
تکرار می‌شوند. وقفه‌های سریع، وقفه‌هایی با بالاترین سطح اولویت P0 هستند.
این وقفه‌ها برای جلوگیری از تراکنش‌های حافظه در طول توالی‌های ورود و خروج وقفه،
تنها ثبات‌های PC و STATUS32 را ذخیره می‌کنند. هنگامی که از وقفه‌های سریع در یک پردازندهٔ
خانوادهٔ ARC V2 استفاده می‌کنید از این گزینه بهره ببرید. مقادیر مجاز عبارتند از 4، 8، 16 و 32.
.IP \fB\-mlpc\-width=\fR\fIwidth\fR 4
.IX Item "-mlpc-width=width"
عرض ثبات \f(CW\*(C`lp_count\*(C'\fR را مشخص می‌کند. مقادیر معتبر برای
\&\fIwidth\fR عبارتند از 8، 16، 20، 24، 28 و 32 بیت. عرض پیش‌فرض بر روی
32 بیت ثابت است. اگر عرض کمتر از 32 باشد، کامپایلر تلاشی برای تبدیل حلقه‌ها
در برنامهٔ شما جهت استفاده از سازوکار حلقه با تأخیر صفر (zero\-delay loop)
نمی‌کند، مگر اینکه مشخص باشد ثبات \f(CW\*(C`lp_count\*(C'\fR می‌تواند مقدار
شمارندهٔ حلقهٔ مورد نیاز را در خود نگه دارد. بسته به عرض مشخص‌شده، کامپایلر و کتابخانهٔ
زمان اجرا ممکن است برای نیازهای گوناگون همچنان به استفاده از سازوکار حلقه ادامه دهند.
این گزینه ماکروی \&\f(CW\*(C`_\|_ARC_LPC_WIDTH_\|_\*(C'\fR را با مقدار \fIwidth\fR تعریف می‌کند.
.IP \fB\-mrf16\fR 4
.IX Item "-mrf16"
این گزینه به کامپایلر دستور می‌دهد تا کد را برای یک فایل ثبات ۱۶ مدخلی تولید کند.
این گزینه ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_ARC_RF16_\|_\*(C'\fR را تعریف می‌کند.
.IP \fB\-mbranch\-index\fR 4
.IX Item "-mbranch-index"
استفاده از دستورالعمل‌های \f(CW\*(C`bi\*(C'\fR یا \f(CW\*(C`bih\*(C'\fR را برای پیاده‌سازی
جدول‌های پرش فعال می‌کند.
.PP
گزینه‌های زیر به اسمبلر ارسال می‌شوند و همچنین نمادهای ماکروی پیش‌پردازنده را تعریف می‌کنند.
.IP \fB\-mlock\fR 4
.IX Item "-mlock"
به اسمبلر ارسال می‌شود تا افزونهٔ شرطی بارگذاری/ذخیرهٔ قفل‌شده را فعال کند.
همچنین نماد پیش‌پردازندهٔ \&\f(CW\*(C`_\|_Xlock\*(C'\fR را تنظیم می‌کند.
.IP \fB\-mswape\fR 4
.IX Item "-mswape"
به اسمبلر ارسال می‌شود تا دستورالعمل افزونهٔ تغییر ترتیب بایت‌ها را فعال کند.
همچنین نماد پیش‌پردازندهٔ \&\f(CW\*(C`_\|_Xswape\*(C'\fR را تنظیم می‌کند.
.IP \fB\-mxy\fR 4
.IX Item "-mxy"
به اسمبلر ارسال می‌شود تا افزونهٔ حافظهٔ XY را فعال کند. همچنین
نماد پیش‌پردازندهٔ \f(CW\*(C`_\|_Xxy\*(C'\fR را تنظیم می‌کند.
.PP
گزینه‌های زیر نحوهٔ حاشیه‌نویسی کد اسمبلی را کنترل می‌کنند:
.IP \fB\-misize\fR 4
.IX Item "-misize"
دستورالعمل‌های اسمبلی را با آدرس‌های تخمینی حاشیه‌نویسی می‌کند.
.PP
گزینه‌های زیر به پیونددهنده ارسال می‌شوند:
.IP \fB\-marclinux\fR 4
.IX Item "-marclinux"
.PD 0
.IP \fB\-mno\-arclinux\fR 4
.IX Item "-mno-arclinux"
.PD
به پیونددهنده ارسال می‌شود تا استفاده از شبیه‌سازی \f(CW\*(C`arclinux\*(C'\fR را مشخص کند.
این گزینه به‌طور پیش‌فرض در زنجیره‌های ابزار ساخته‌شده برای اهداف
\&\f(CW\*(C`arc\-linux\-uclibc\*(C'\fR و \f(CW\*(C`arceb\-linux\-uclibc\*(C'\fR
در صورتی که پروفایل‌سازی درخواست نشده باشد، فعال است.
.IP \fB\-marclinux_prof\fR 4
.IX Item "-marclinux_prof"
.PD 0
.IP \fB\-mno\-arclinux_prof\fR 4
.IX Item "-mno-arclinux_prof"
.PD
به پیونددهنده ارسال می‌شود تا استفاده از شبیه‌سازی
\&\f(CW\*(C`arclinux_prof\*(C'\fR را مشخص کند. این گزینه به‌طور پیش‌فرض در
زنجیره‌های ابزار ساخته‌شده برای اهداف \f(CW\*(C`arc\-linux\-uclibc\*(C'\fR و
\&\f(CW\*(C`arceb\-linux\-uclibc\*(C'\fR هنگامی که پروفایل‌سازی درخواست شده باشد، فعال است.
.PP
گزینه‌های زیر معناشناسی کد تولیدشده را کنترل می‌کنند:
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
فراخوانی‌ها را به‌صورت فراخوانی‌های غیرمستقیم از طریق ثبات تولید می‌کند، بدین ترتیب دسترسی
به کل محدودهٔ آدرس ۳۲ بیتی را فراهم می‌سازد.
.IP \fB\-mmedium\-calls\fR 4
.IX Item "-mmedium-calls"
.PD 0
.IP \fB\-mno\-medium\-calls\fR 4
.IX Item "-mno-medium-calls"
.PD
برای فراخوانی‌ها از محدودهٔ آدرس‌دهی کمتر از ۲۵ بیت استفاده نمی‌کند، که آفست
در دسترس برای دستور شاخه‌روی و پیوند غیرمشروط است. اجرای شرطی
فراخوانی‌های توابع سرکوب می‌شود تا امکان استفاده از محدودهٔ ۲۵ بیتی را به جای محدودهٔ
۲۱ بیتی شاخه‌روی و پیوند شرطی فراهم کند. این حالت پیش‌فرض برای زنجیره‌های ابزار
ساخته‌شده برای اهداف \f(CW\*(C`arc\-linux\-uclibc\*(C'\fR و \f(CW\*(C`arceb\-linux\-uclibc\*(C'\fR است..IP "\fB\-G\fR \fInum\fR" 4
.IX Item "-G num"
قراردادن تعاریف داده‌های قابل مشاهده از خارج در یک بخش داده‌های کوچک (small data section) در صورتی که اندازهٔ آن داده بزرگ‌تر از \fInum\fR بایت نباشد. مقدار پیش‌فرض \&\fInum\fR برای هر پیکربندی ARC برابر با ۴ است، یا در صورت وجود عملیات بارگذاری/ذخیرهٔ (load/store) دوگانه، ۸ می‌باشد.
.IP \fB\-mno\-sdata\fR 4
.IX Item "-mno-sdata"
عدم تولید ارجاع‌های sdata. این حالت پیش‌فرض برای زنجیره‌های ابزار ساخته‌شده برای اهداف \f(CW\*(C`arc\-linux\-uclibc\*(C'\fR و \f(CW\*(C`arceb\-linux\-uclibc\*(C'\fR است.
.IP \fB\-mvolatile\-cache\fR 4
.IX Item "-mvolatile-cache"
.PD 0
.IP \fB\-mno\-volatile\-cache\fR 4
.IX Item "-mno-volatile-cache"
.PD
کنترل نحوهٔ دسترسی به ارجاع‌های فرار (volatile).
حالت پیش‌فرض \fB\-mvolatile\-cache\fR است که از دسترسی‌های حافظهٔ معمولِ دارای حافظهٔ پنهان (cached) برای ارجاع‌های فرار استفاده می‌کند.
از \fB\-mno\-volatile\-cache\fR برای
فعال‌سازی دور زدن حافظهٔ پنهان (cache bypass) برای ارجاع‌های فرار استفاده کنید.
.PP
گزینه‌های زیر تولید کد را تنظیم دقیق می‌کنند:
.IP \fB\-mauto\-modify\-reg\fR 4
.IX Item "-mauto-modify-reg"
فعال‌سازی استفاده از pre/post modify همراه با جابه‌جایی ثبات.
.IP \fB\-mno\-brcc\fR 4
.IX Item "-mno-brcc"
.PD 0
.IP \fB\-mbrcc\fR 4
.IX Item "-mbrcc"
.PD
این گزینه یک گذر وابسته به هدف را در \fIarc_reorg\fR برای
تولید دستورالعمل‌های مقایسه و انشعاب (\f(CW\*(C`br\fR\f(CIcc\fR\f(CW\*(C'\fR) کنترل می‌کند، که
به طور پیش‌فرض فعال است.
این گزینه هیچ تأثیری بر
تولید این دستورالعمل‌ها که توسط گذر combiner هدایت می‌شوند ندارد.
.IP \fB\-mcase\-vector\-pcrel\fR 4
.IX Item "-mcase-vector-pcrel"
استفاده از جدول‌های switch case وابسته به شمارندهٔ برنامه (PC\-relative) جهت فعال‌سازی کوتاه‌سازی جدول case.
این حالت پیش‌فرض برای \fB\-Os\fR است.
.IP \fB\-mno\-cond\-exec\fR 4
.IX Item "-mno-cond-exec"
غیرفعال کردن گذر ویژهٔ ARCompact برای تولید دستورالعمل‌های
اجرای شرطی.
.Sp
به دلیل زمان‌بندی delay slot و برهم‌کنش‌های میان تعداد عملوندها،
اندازه مقادیر مستقیم (literal sizes)، طول دستورالعمل‌ها، و پشتیبانی از اجرای شرطی،
گذر مستقل از هدف برای تولید اجرای شرطی اغلب ناکافی است،
بنابراین پورت ARC یک گذر ویژه را حفظ کرده است که پس از تخصیص ثبات،
کوتاه‌سازی انشعاب (branch shortening)، و زمان‌بندی delay slot، سعی می‌کند فرصت‌های بیشتری برای
تولید اجرای شرطی پیدا کند. این گذر
عموماً، اما نه همیشه، عملکرد و اندازهٔ کد را به بهای
زمان کامپایل بیشتر بهبود می‌بخشد، و به همین دلیل گزینه‌ای برای خاموش کردن آن وجود دارد.
اگر به دلیل شرطی‌شدن دستورالعمل‌های call با مشکل فراتر رفتن آن‌ها
از محدودهٔ مجاز آفست مواجه شدید، باید استفاده از
\&\fB\-mmedium\-calls\fR را مد نظر قرار دهید.
.IP \fB\-mearly\-cbranchsi\fR 4
.IX Item "-mearly-cbranchsi"
فعال‌سازی استفاده از الگوی \f(CW\*(C`cbranchsi\*(C'\fR پیش از reload.
.IP \fB\-mindexed\-loads\fR 4
.IX Item "-mindexed-loads"
فعال‌سازی استفاده از بارگذاری‌های نمایه‌دار (indexed loads). این مورد می‌تواند مشکل‌ساز باشد زیرا برخی
از بهینه‌سازها در این صورت فرض می‌کنند که ذخیره‌سازی‌های نمایه‌دار (indexed stores) نیز وجود دارند، در حالی که
چنین نیست.
.IP \fB\-mlra\-priority\-none\fR 4
.IX Item "-mlra-priority-none"
عدم تعیین هرگونه اولویت برای ثبات‌های هدف.
.IP \fB\-mlra\-priority\-compact\fR 4
.IX Item "-mlra-priority-compact"
تعیین اولویت ثبات هدف برای r0..r3 / r12..r15.
.IP \fB\-mlra\-priority\-noncompact\fR 4
.IX Item "-mlra-priority-noncompact"
کاهش اولویت ثبات هدف برای r0..r3 / r12..r15.
.IP \fB\-mmillicode\fR 4
.IX Item "-mmillicode"
هنگام بهینه‌سازی برای اندازه (با استفاده از \fB\-Os\fR)، پرولوگ‌ها و اپیلوگ‌هایی
که باید تعداد زیادی ثبات را ذخیره یا بازیابی کنند اغلب با
استفاده از فراخوانی یک تابع ویژه در libgcc کوتاه می‌شوند؛ این فراخوانی به عنوان
یک فراخوانی \fImillicode\fR شناخته می‌شود. از آنجا که این فراخوانی‌ها می‌توانند مسائلی در
کارایی ایجاد کنند و/یا هنگام پیوند دادن به شیوهٔ غیر استاندارد موجب مشکلات پیوندزنی شوند،
این گزینه برای روشن یا خاموش کردن تولید فراخوانی millicode
فراهم شده است.
.IP \fB\-mcode\-density\-frame\fR 4
.IX Item "-mcode-density-frame"
این گزینه کامپایلر را قادر می‌سازد تا دستورالعمل‌های \f(CW\*(C`enter\*(C'\fR و \f(CW\*(C`leave\*(C'\fR را
صادر کند. این دستورالعمل‌ها فقط برای پردازنده‌های دارای
ویژگی code\-density معتبر هستند.
.IP \fB\-msize\-level=\fR\fIlevel\fR 4
.IX Item "-msize-level=level"
تنظیم دقیق بهینه‌سازی اندازه با توجه به طول دستورالعمل‌ها و ترازسازی (alignment).
مقادیر شناخته‌شده برای \fIlevel\fR عبارتند از:
.RS 4
.IP \fB0\fR 4
.IX Item "0"
بدون بهینه‌سازی اندازه. این سطح منسوخ شده و مانند \fB1\fR با آن رفتار می‌شود.
.IP \fB1\fR 4
.IX Item "1"
دستورالعمل‌های کوتاه به صورت فرصت‌طلبانه استفاده می‌شوند.
.IP \fB2\fR 4
.IX Item "2"
علاوه بر این، ترازسازی حلقه‌ها و کد پس از سدها (barriers) حذف می‌شود.
.IP \fB3\fR 4
.IX Item "3"
علاوه بر این، ترازسازی اختیاری داده‌ها حذف شده و گزینهٔ \fBOs\fR فعال می‌شود.
.RE
.RS 4
.Sp
هنگامی که \fB\-Os\fR فعال باشد، مقدار پیش‌فرض روی \fB3\fR قرار می‌گیرد. در غیر این صورت،
رفتار در هنگام تعیین نشدن آن معادل سطح \fB1\fR است.
.RE
.IP \fB\-mtune=\fR\fIcpu\fR 4
.IX Item "-mtune=cpu"
تنظیم پارامترهای زمان‌بندی دستورالعمل برای \fIcpu\fR، که هر مقدار ضمنی
تعیین‌شده توسط \fB\-mcpu=\fR را بازنویسی می‌کند.
.Sp
مقادیر پشتیبانی‌شده برای \fIcpu\fR عبارتند از:
.RS 4
.IP \fBARC600\fR 4
.IX Item "ARC600"
تنظیم برای پردازندهٔ ARC600.
.IP \fBARC601\fR 4
.IX Item "ARC601"
تنظیم برای پردازندهٔ ARC601.
.IP \fBARC700\fR 4
.IX Item "ARC700"
تنظیم برای پردازندهٔ ARC700 با بلوک ضرب‌کننده استاندارد.
.IP \fBARC700\-xmac\fR 4
.IX Item "ARC700-xmac"
تنظیم برای پردازندهٔ ARC700 با بلوک XMAC.
.IP \fBARC725D\fR 4
.IX Item "ARC725D"
تنظیم برای پردازندهٔ ARC725D.
.IP \fBARC750D\fR 4
.IX Item "ARC750D"
تنظیم برای پردازندهٔ ARC750D.
.IP \fBcore3\fR 4
.IX Item "core3"
تنظیم برای پردازندهٔ نوع core3 از معماری ARCv2. این گزینه استفاده از
دستورالعمل \&\f(CW\*(C`dbnz\*(C'\fR را فعال می‌کند.
.IP \fBrelease31a\fR 4
.IX Item "release31a"
تنظیم برای ARC4x انتشار 3.10a.
.RE
.RS 4
.RE
.IP \fB\-mmultcost=\fR\fInum\fR 4
.IX Item "-mmultcost=num"
هزینه‌ای که برای یک دستورالعمل ضرب در نظر گرفته می‌شود، به‌طوری که \fB4\fR معادل یک
دستورالعمل معمولی است.
.PP
\fIگزینه‌های ARM (ARM Options)\fR
.IX Subsection "ARM Options"
.PP
این گزینه‌های \fB\-m\fR برای پورت ARM تعریف شده‌اند:
.IP \fB\-mabi=\fR\fIname\fR 4
.IX Item "-mabi=name"
تولید کد برای ABI مشخص‌شده. مقادیر مجاز عبارتند از: \fBapcs\-gnu\fR،
\&\fBatpcs\fR، \fBaapcs\fR و \fBaapcs\-linux\fR.
.IP \fB\-mapcs\-frame\fR 4
.IX Item "-mapcs-frame"
تولید یک فریم پشته (stack frame) سازگار با استاندارد فراخوانی رویهٔ ARM
(ARM Procedure Call Standard) برای همهٔ توابع، حتی اگر این کار برای
اجرای صحیح کد اکیداً ضروری نباشد. تعیین \fB\-fomit\-frame\-pointer\fR
همراه با این گزینه باعث می‌شود فریم‌های پشته برای
توابع برگی (leaf functions) تولید نشوند. حالت پیش‌فرض \fB\-mno\-apcs\-frame\fR است.
این گزینه منسوخ شده است.
.IP \fB\-mapcs\fR 4
.IX Item "-mapcs"
این گزینه مترادفی برای \fB\-mapcs\-frame\fR است و منسوخ شده می‌باشد.
.IP \fB\-mthumb\-interwork\fR 4
.IX Item "-mthumb-interwork"
تولید کدی که از فراخوانی متقابل میان مجموعه‌دستورالعمل‌های ARM و Thumb
پشتیبانی کند. بدون این گزینه، در معماری‌های پیش از نسخهٔ ۵ (pre\-v5)، این
دو مجموعه‌دستورالعمل نمی‌توانند به صورت قابل اطمینان در یک برنامه استفاده شوند. حالت
پیش‌فرض \fB\-mno\-thumb\-interwork\fR است، زیرا در صورت تعیین \fB\-mthumb\-interwork\fR
کد اندکی بزرگ‌تر تولید می‌شود. در پیکربندی‌های AAPCS این گزینه بی‌معنی است.
.IP \fB\-msched\-prolog\fR 4
.IX Item "-msched-prolog".PD 0
.IP \fB\-mno\-sched\-prolog\fR 4
.IX Item "-mno-sched-prolog"
.PD
مجاز شمردن یا جلوگیری از تغییر ترتیب دستورالعمل‌ها در مقدمهٔ تابع (function prologue)، یا
ادغام آن دستورالعمل‌ها با دستورالعمل‌های موجود در بدنهٔ تابع.
با \fB\-mno\-sched\-prolog\fR،
این بدان معناست که همه توابع با یک مجموعه دستورالعمل قابل‌تشخیص شروع می‌شوند
(یا در واقع با انتخابی از میان یک مجموعه کوچک از مقدمه‌های گوناگون توابع)، و می‌توان
از این اطلاعات برای تعیین محل شروع توابع در یک قطعه کد اجرایی استفاده کرد.
پیش‌فرض \fB\-msched\-prolog\fR است.
.IP \fB\-mfloat\-abi=\fR\fIname\fR 4
.IX Item "-mfloat-abi=name"
مشخص می‌کند از کدام ABI ممیز شناور (floating\-point) استفاده شود. مقادیر مجاز
عبارت‌اند از: \fBsoft\fR، \fBsoftfp\fR و \fBhard\fR.
.Sp
تعیین \fBsoft\fR باعث می‌شود GCC خروجی حاوی فراخوانی‌های کتابخانه‌ای برای عملیات ممیز شناور تولید کند.
\&\fBsoftfp\fR اجازه تولید کدی را می‌دهد که از دستورالعمل‌های سخت‌افزاری ممیز شناور استفاده می‌کند، اما همچنان از قراردادهای فراخوانی soft\-float بهره می‌برد.
\&\fBhard\fR اجازه تولید دستورالعمل‌های ممیز شناور را داده و از قراردادهای فراخوانی ویژهٔ FPU استفاده می‌کند.
.Sp
پیش‌فرض به پیکربندی مقصد مشخص بستگی دارد. توجه داشته باشید که
ABIهای hard\-float و soft\-float از نظر پیوند سازگار نیستند؛ شما باید
کل برنامه خود را با همان ABI کامپایل کرده و با مجموعه‌ای سازگار از کتابخانه‌ها پیوند دهید.
.IP \fB\-mgeneral\-regs\-only\fR 4
.IX Item "-mgeneral-regs-only"
تولید کدی که تنها از ثبات‌های همه‌منظوره استفاده می‌کند. این کار مانع از استفاده کامپایلر
از ثبات‌های ممیز شناور و Advanced SIMD می‌شود اما هیچ محدودیتی بر اسمبلر
اعمال نخواهد کرد.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
تولید کد برای پردازنده‌ای که در حالت little\-endian اجرا می‌شود. این
پیش‌فرض برای تمامی پیکربندی‌های استاندارد است.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
تولید کد برای پردازنده‌ای که در حالت big\-endian اجرا می‌شود؛ پیش‌فرض
کامپایل کردن کد برای پردازنده little\-endian است.
.IP \fB\-mbe8\fR 4
.IX Item "-mbe8"
.PD 0
.IP \fB\-mbe32\fR 4
.IX Item "-mbe32"
.PD
هنگام پیوند دادن یک ایمیج big\-endian بین قالب‌های BE8 و BE32 انتخاب می‌کند.
این گزینه روی ایمیج‌های little\-endian تأثیری ندارد و نادیده گرفته می‌شود.
پیش‌فرض به معماری مقصد انتخاب‌شده بستگی دارد. برای معماری ARMv6
و جدیدتر پیش‌فرض BE8 است، و برای معماری‌های قدیمی‌تر
پیش‌فرض BE32 است. قالب BE32 توسط ARM منسوخ شده است.
.IP \fB\-march=\fR\fIname\fR[\fB+extension...\fR] 4
.IX Item "-march=name[+extension...]"
نام معماری مقصد ARM را مشخص می‌کند. GCC از این
نام برای تعیین اینکه چه نوع دستورالعمل‌هایی را می‌تواند هنگام تولید
کد اسمبلی منتشر کند، استفاده می‌کند. این گزینه می‌تواند در کنار یا به جای
گزینه \fB\-mcpu=\fR استفاده شود.
.Sp
نام‌های مجاز عبارت‌اند از:
\&\fBarmv4t\fR،
\&\fBarmv5t\fR، \fBarmv5te\fR،
\&\fBarmv6\fR، \fBarmv6j\fR، \fBarmv6k\fR، \fBarmv6kz\fR، \fBarmv6t2\fR،
\&\fBarmv6z\fR، \fBarmv6zk\fR،
\&\fBarmv7\fR، \fBarmv7\-a\fR، \fBarmv7ve\fR،
\&\fBarmv8\-a\fR، \fBarmv8.1\-a\fR، \fBarmv8.2\-a\fR، \fBarmv8.3\-a\fR،
\&\fBarmv8.4\-a\fR،
\&\fBarmv8.5\-a\fR،
\&\fBarmv8.6\-a\fR،
\&\fBarmv9\-a\fR،
\&\fBarmv7\-r\fR،
\&\fBarmv8\-r\fR،
\&\fBarmv6\-m\fR، \fBarmv6s\-m\fR،
\&\fBarmv7\-m\fR، \fBarmv7e\-m\fR،
\&\fBarmv8\-m.base\fR، \fBarmv8\-m.main\fR،
\&\fBarmv8.1\-m.main\fR،
\&\fBiwmmxt\fR و \fBiwmmxt2\fR.
.Sp
علاوه بر این، معماری‌های زیر که فاقد پشتیبانی از حالت اجرای Thumb هستند
شناسایی می‌شوند اما پشتیبانی از آن‌ها منسوخ شده است: \fBarmv4\fR.
.Sp
بسیاری از معماری‌ها از افزونه‌ها پشتیبانی می‌کنند. این‌ها را می‌توان با
افزودن \fB+\fR\fIextension\fR به نام معماری اضافه کرد. گزینه‌های افزونه
به ترتیب پردازش می‌شوند و قابلیت‌ها انباشته می‌شوند. یک افزونه همچنین هرگونه
افزونه پایه لازم را که به آن وابسته است فعال می‌کند. برای مثال، افزونه \fB+crypto\fR
همواره افزونه \fB+simd\fR را فعال خواهد کرد. استثنای ساختار افزایشی برای
افزونه‌هایی است که پیشوند \&\fB+no...\fR دارند: این افزونه‌ها گزینه مشخص‌شده و
هر افزونه دیگری را که ممکن است به حضور آن افزونه وابسته باشد غیرفعال می‌کنند.
.Sp
برای مثال، \fB\-march=armv7\-a+simd+nofp+vfpv4\fR معادل نوشتن
\fB\-march=armv7\-a+vfpv4\fR است، چرا که گزینه \fB+simd\fR کاملاً توسط
گزینه \fB+nofp\fR که به دنبال آن می‌آید غیرفعال می‌شود.
.Sp
بیشتر نام‌های افزونه‌ها به صورت عمومی نام‌گذاری شده‌اند، اما اثری دارند که
به معماری اعمال‌شده بر آن وابسته است. برای مثال، گزینه \fB+simd\fR را می‌توان
هم بر معماری \fBarmv7\-a\fR و هم \&\fBarmv8\-a\fR اعمال کرد، اما افزونه‌های
اصلی ARMv7\-A Advanced SIMD (Neon) را برای \fBarmv7\-a\fR و نوع ARMv8\-A
را برای \fBarmv8\-a\fR فعال می‌کند.
.Sp
جدول زیر افزونه‌های پشتیبانی‌شده را برای هر معماری فهرست می‌کند.
معماری‌هایی که ذکر نشده‌اند از هیچ افزونه‌ای پشتیبانی نمی‌کنند.
.RS 4
.IP \fBarmv5te\fR 4
.IX Item "armv5te"
.PD 0
.IP \fBarmv6\fR 4
.IX Item "armv6"
.IP \fBarmv6j\fR 4
.IX Item "armv6j"
.IP \fBarmv6k\fR 4
.IX Item "armv6k"
.IP \fBarmv6kz\fR 4
.IX Item "armv6kz"
.IP \fBarmv6t2\fR 4
.IX Item "armv6t2"
.IP \fBarmv6z\fR 4
.IX Item "armv6z"
.IP \fBarmv6zk\fR 4
.IX Item "armv6zk"
.RS 4
.IP \fB+fp\fR 4
.IX Item "+fp"
.PD
دستورالعمل‌های ممیز شناور VFPv2. افزونه \fB+vfpv2\fR می‌تواند
به عنوان یک نام مستعار برای این افزونه استفاده شود.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور.
.RE
.RS 4
.RE
.IP \fBarmv7\fR 4
.IX Item "armv7"
زیرمجموعه مشترک معماری‌های ARMv7\-A، ARMv7\-R و ARMv7\-M.
.RS 4
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور VFPv3، با ۱۶ ثبات دقت مضاعف (double\-precision).
افزونه \fB+vfpv3\-d16\fR می‌تواند به عنوان یک نام مستعار برای این افزونه استفاده شود.
توجه داشته باشید که ممیز شناور توسط معماری پایه ARMv7\-M پشتیبانی نمی‌شود، اما با هر دو معماری ARMv7\-A و
ARMv7\-R سازگار است.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور.
.RE
.RS 4
.RE
.IP \fBarmv7\-a\fR 4
.IX Item "armv7-a"
.RS 4
.PD 0
.IP \fB+mp\fR 4
.IX Item "+mp"
.PD
افزونه چندپردازشی (multiprocessing).
.IP \fB+sec\fR 4
.IX Item "+sec"
افزونه امنیتی (security).
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور VFPv3، با ۱۶ ثبات دقت مضاعف. افزونه \fB+vfpv3\-d16\fR می‌تواند به عنوان یک نام مستعار
برای این افزونه استفاده شود.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های Advanced SIMD (Neon) v1 و دستورالعمل‌های ممیز شناور VFPv3.
افزونه‌های \fB+neon\fR و \fB+neon\-vfpv3\fR می‌توانند به عنوان نام‌های مستعار برای این افزونه استفاده شوند.
.IP \fB+vfpv3\fR 4
.IX Item "+vfpv3"
دستورالعمل‌های ممیز شناور VFPv3، با ۳۲ ثبات دقت مضاعف.
.IP \fB+vfpv3\-d16\-fp16\fR 4
.IX Item "+vfpv3-d16-fp16"
دستورالعمل‌های ممیز شناور VFPv3، با ۱۶ ثبات دقت مضاعف و عملیات تبدیل ممیز شناور با دقت نیمه (half\-precision)..IP \fB+vfpv3\-fp16\fR 4
.IX Item "+vfpv3-fp16"
دستورالعمل‌های ممیز شناور VFPv3، با ۳۲ ثبات دقت مضاعف و عملیات تبدیل ممیز شناور نیمه‌دقت.
.IP \fB+vfpv4\-d16\fR 4
.IX Item "+vfpv4-d16"
دستورالعمل‌های ممیز شناور VFPv4، با ۱۶ ثبات دقت مضاعف.
.IP \fB+vfpv4\fR 4
.IX Item "+vfpv4"
دستورالعمل‌های ممیز شناور VFPv4، با ۳۲ ثبات دقت مضاعف.
.IP \fB+neon\-fp16\fR 4
.IX Item "+neon-fp16"
دستورالعمل‌های Advanced SIMD (Neon) v1 و ممیز شناور VFPv3، به همراه عملیات تبدیل ممیز شناور نیمه‌دقت.
.IP \fB+neon\-vfpv4\fR 4
.IX Item "+neon-vfpv4"
دستورالعمل‌های Advanced SIMD (Neon) v2 و ممیز شناور VFPv4.
.IP \fB+nosimd\fR 4
.IX Item "+nosimd"
غیرفعال کردن دستورالعمل‌های Advanced SIMD (ممیز شناور را غیرفعال نمی‌کند).
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور و Advanced SIMD.
.RE
.RS 4
.RE
.IP \fBarmv7ve\fR 4
.IX Item "armv7ve"
نسخهٔ گسترش‌یافتهٔ معماری ARMv7\-A با پشتیبانی از مجازی‌سازی.
.RS 4
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور VFPv4، با ۱۶ ثبات دقت مضاعف.
افزونهٔ \fB+vfpv4\-d16\fR می‌تواند به عنوان نام مستعار برای این افزونه به کار رود.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های Advanced SIMD (Neon) v2 و ممیز شناور VFPv4. افزونهٔ
\fB+neon\-vfpv4\fR می‌تواند به عنوان نام مستعار برای این افزونه به کار رود.
.IP \fB+vfpv3\-d16\fR 4
.IX Item "+vfpv3-d16"
دستورالعمل‌های ممیز شناور VFPv3، با ۱۶ ثبات دقت مضاعف.
.IP \fB+vfpv3\fR 4
.IX Item "+vfpv3"
دستورالعمل‌های ممیز شناور VFPv3، با ۳۲ ثبات دقت مضاعف.
.IP \fB+vfpv3\-d16\-fp16\fR 4
.IX Item "+vfpv3-d16-fp16"
دستورالعمل‌های ممیز شناور VFPv3، با ۱۶ ثبات دقت مضاعف
و عملیات تبدیل ممیز شناور نیمه‌دقت.
.IP \fB+vfpv3\-fp16\fR 4
.IX Item "+vfpv3-fp16"
دستورالعمل‌های ممیز شناور VFPv3، با ۳۲ ثبات دقت مضاعف
و عملیات تبدیل ممیز شناور نیمه‌دقت.
.IP \fB+vfpv4\-d16\fR 4
.IX Item "+vfpv4-d16"
دستورالعمل‌های ممیز شناور VFPv4، با ۱۶ ثبات دقت مضاعف.
.IP \fB+vfpv4\fR 4
.IX Item "+vfpv4"
دستورالعمل‌های ممیز شناور VFPv4، با ۳۲ ثبات دقت مضاعف.
.IP \fB+neon\fR 4
.IX Item "+neon"
دستورالعمل‌های Advanced SIMD (Neon) v1 و ممیز شناور VFPv3.
افزونهٔ \fB+neon\-vfpv3\fR می‌تواند به عنوان نام مستعار برای این افزونه به کار رود.
.IP \fB+neon\-fp16\fR 4
.IX Item "+neon-fp16"
دستورالعمل‌های Advanced SIMD (Neon) v1 و ممیز شناور VFPv3، به همراه
عملیات تبدیل ممیز شناور نیمه‌دقت.
.IP \fB+nosimd\fR 4
.IX Item "+nosimd"
غیرفعال کردن دستورالعمل‌های Advanced SIMD (ممیز شناور را غیرفعال نمی‌کند).
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور و Advanced SIMD.
.RE
.RS 4
.RE
.IP \fBarmv8\-a\fR 4
.IX Item "armv8-a"
.RS 4
.PD 0
.IP \fB+crc\fR 4
.IX Item "+crc"
.PD
دستورالعمل‌های بررسی افزونگی چرخه‌ای (CRC).
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ARMv8\-A Advanced SIMD و ممیز شناور.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن دستورالعمل‌های رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+sb\fR 4
.IX Item "+sb"
دستورالعمل سد گمانه‌زنی (Speculation Barrier).
.IP \fB+predres\fR 4
.IX Item "+predres"
دستورالعمل‌های محدودسازی پیش‌بینی اجرا و داده (Execution and Data Prediction Restriction).
.RE
.RS 4
.RE
.IP \fBarmv8.1\-a\fR 4
.IX Item "armv8.1-a"
.RS 4
.PD 0
.IP \fB+simd\fR 4
.IX Item "+simd"
.PD
دستورالعمل‌های ARMv8.1\-A Advanced SIMD و ممیز شناور.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری. این گزینه همچنین دستورالعمل‌های Advanced SIMD و
ممیز شناور را فعال می‌کند.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن دستورالعمل‌های رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+sb\fR 4
.IX Item "+sb"
دستورالعمل سد گمانه‌زنی (Speculation Barrier).
.IP \fB+predres\fR 4
.IX Item "+predres"
دستورالعمل‌های محدودسازی پیش‌بینی اجرا و داده (Execution and Data Prediction Restriction).
.RE
.RS 4
.RE
.IP \fBarmv8.2\-a\fR 4
.IX Item "armv8.2-a"
.PD 0
.IP \fBarmv8.3\-a\fR 4
.IX Item "armv8.3-a"
.RS 4
.IP \fB+fp16\fR 4
.IX Item "+fp16"
.PD
دستورالعمل‌های پردازش دادهٔ ممیز شناور نیمه‌دقت.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.IP \fB+fp16fml\fR 4
.IX Item "+fp16fml"
افزونهٔ fmla ممیز شناور نیمه‌دقت. این گزینه همچنین
افزونهٔ ممیز شناور نیمه‌دقت و دستورالعمل‌های Advanced SIMD و
ممیز شناور را فعال می‌کند.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ARMv8.1\-A Advanced SIMD و ممیز شناور.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری. این گزینه همچنین دستورالعمل‌های Advanced SIMD و
ممیز شناور را فعال می‌کند.
.IP \fB+dotprod\fR 4
.IX Item "+dotprod"
فعال‌سازی افزونهٔ ضرب نقطه‌ای (Dot Product). این گزینه همچنین دستورالعمل‌های Advanced SIMD را فعال می‌کند.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن افزونهٔ رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+sb\fR 4
.IX Item "+sb"
دستورالعمل سد گمانه‌زنی (Speculation Barrier).
.IP \fB+predres\fR 4
.IX Item "+predres"
دستورالعمل‌های محدودسازی پیش‌بینی اجرا و داده (Execution and Data Prediction Restriction).
.IP \fB+i8mm\fR 4
.IX Item "+i8mm"
دستورالعمل‌های ضرب ماتریسی اعداد صحیح ۸ بیتی (8\-bit Integer Matrix Multiply).
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند..IP \fB+bf16\fR 4
.IX Item "+bf16"
دستورالعمل‌های ممیز شناور با دقت نیمه Brain.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.RE
.RS 4
.RE
.IP \fBarmv8.4\-a\fR 4
.IX Item "armv8.4-a"
.RS 4
.PD 0
.IP \fB+fp16\fR 4
.IX Item "+fp16"
.PD
دستورالعمل‌های پردازش دادهٔ ممیز شناور با دقت نیمه.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور و نیز
افزونهٔ Dot Product و افزونهٔ fmla ممیز شناور با دقت نیمه را فعال
می‌کند.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ممیز شناور و Advanced SIMD مربوط به ARMv8.3\-A و همچنین
افزونهٔ Dot Product.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری. این گزینه همچنین دستورالعمل‌های Advanced SIMD و
ممیز شناور و نیز افزونهٔ Dot Product را فعال می‌کند.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن افزونهٔ رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+sb\fR 4
.IX Item "+sb"
دستورالعمل سد گمانه‌زنی (Speculation Barrier).
.IP \fB+predres\fR 4
.IX Item "+predres"
دستورالعمل‌های محدودسازی پیش‌بینی اجرا و داده (Execution and Data Prediction Restriction).
.IP \fB+i8mm\fR 4
.IX Item "+i8mm"
دستورالعمل‌های ضرب ماتریسی اعداد صحیح ۸ بیتی.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.IP \fB+bf16\fR 4
.IX Item "+bf16"
دستورالعمل‌های ممیز شناور با دقت نیمه Brain.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.RE
.RS 4
.RE
.IP \fBarmv8.5\-a\fR 4
.IX Item "armv8.5-a"
.RS 4
.PD 0
.IP \fB+fp16\fR 4
.IX Item "+fp16"
.PD
دستورالعمل‌های پردازش دادهٔ ممیز شناور با دقت نیمه.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور و نیز
افزونهٔ Dot Product و افزونهٔ fmla ممیز شناور با دقت نیمه را فعال
می‌کند.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ممیز شناور و Advanced SIMD مربوط به ARMv8.3\-A و همچنین
افزونهٔ Dot Product.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری. این گزینه همچنین دستورالعمل‌های Advanced SIMD و
ممیز شناور و نیز افزونهٔ Dot Product را فعال می‌کند.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن افزونهٔ رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+i8mm\fR 4
.IX Item "+i8mm"
دستورالعمل‌های ضرب ماتریسی اعداد صحیح ۸ بیتی.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.IP \fB+bf16\fR 4
.IX Item "+bf16"
دستورالعمل‌های ممیز شناور با دقت نیمه Brain.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.RE
.RS 4
.RE
.IP \fBarmv8.6\-a\fR 4
.IX Item "armv8.6-a"
.RS 4
.PD 0
.IP \fB+fp16\fR 4
.IX Item "+fp16"
.PD
دستورالعمل‌های پردازش دادهٔ ممیز شناور با دقت نیمه.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور و نیز
افزونهٔ Dot Product و افزونهٔ fmla ممیز شناور با دقت نیمه را فعال
می‌کند.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ممیز شناور و Advanced SIMD مربوط به ARMv8.3\-A و همچنین
افزونهٔ Dot Product.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری. این گزینه همچنین دستورالعمل‌های Advanced SIMD و
ممیز شناور و نیز افزونهٔ Dot Product را فعال می‌کند.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن افزونهٔ رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.IP \fB+i8mm\fR 4
.IX Item "+i8mm"
دستورالعمل‌های ضرب ماتریسی اعداد صحیح ۸ بیتی.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.IP \fB+bf16\fR 4
.IX Item "+bf16"
دستورالعمل‌های ممیز شناور با دقت نیمه Brain.
این گزینه همچنین دستورالعمل‌های Advanced SIMD و ممیز شناور را فعال می‌کند.
.RE
.RS 4
.RE
.IP \fBarmv7\-r\fR 4
.IX Item "armv7-r"
.RS 4
.PD 0
.IP \fB+fp.sp\fR 4
.IX Item "+fp.sp"
.PD
دستورالعمل‌های ممیز شناور VFPv3 با دقت تکی. افزونهٔ
\&\fB+vfpv3xd\fR می‌تواند به عنوان نام مستعاری برای این افزونه استفاده شود.
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور VFPv3 با ۱۶ ثبات با دقت مضاعف.
افزونهٔ +vfpv3\-d16 می‌تواند به عنوان نام مستعاری برای این افزونه استفاده شود.
.IP \fB+vfpv3xd\-d16\-fp16\fR 4
.IX Item "+vfpv3xd-d16-fp16"
دستورالعمل‌های ممیز شناور VFPv3 با دقت تکی با ۱۶ ثبات دقت مضاعف
و عملیات تبدیل ممیز شناور با دقت نیمه.
.IP \fB+vfpv3\-d16\-fp16\fR 4
.IX Item "+vfpv3-d16-fp16"
دستورالعمل‌های ممیز شناور VFPv3 با ۱۶ ثبات با دقت مضاعف
و عملیات تبدیل ممیز شناور با دقت نیمه.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن افزونهٔ ممیز شناور.
.IP \fB+idiv\fR 4
.IX Item "+idiv"
دستورالعمل‌های تقسیم عدد صحیح در حالت ARM.
.IP \fB+noidiv\fR 4
.IX Item "+noidiv"
غیرفعال کردن افزونهٔ تقسیم عدد صحیح در حالت ARM.
.RE
.RS 4
.RE
.IP \fBarmv7e\-m\fR 4
.IX Item "armv7e-m"
.RS 4
.PD 0
.IP \fB+fp\fR 4
.IX Item "+fp"
.PD
دستورالعمل‌های ممیز شناور VFPv4 با دقت تکی.
.IP \fB+fpv5\fR 4
.IX Item "+fpv5"
دستورالعمل‌های ممیز شناور FPv5 با دقت تکی.
.IP \fB+fp.dp\fR 4
.IX Item "+fp.dp"
دستورالعمل‌های ممیز شناور FPv5 با دقت تکی و مضاعف.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن افزونه‌های ممیز شناور.
.RE
.RS 4
.RE
.IP \fBarmv8.1\-m.main\fR 4
.IX Item "armv8.1-m.main"
.RS 4
.PD 0
.IP \fB+dsp\fR 4
.IX Item "+dsp".PD
دستورالعمل‌های DSP.
.IP \fB+mve\fR 4
.IX Item "+mve"
دستورالعمل‌های اعداد صحیح M\-Profile Vector Extension (MVE).
.IP \fB+mve.fp\fR 4
.IX Item "+mve.fp"
دستورالعمل‌های اعداد صحیح و ممیز شناور با دقت یگانه در
M\-Profile Vector Extension (MVE).
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور با دقت یگانه.
.IP \fB+fp.dp\fR 4
.IX Item "+fp.dp"
دستورالعمل‌های ممیز شناور با دقت یگانه و دوگانه.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن افزونهٔ ممیز شناور.
.IP "\fB+cdecp0, +cdecp1, ... , +cdecp7\fR" 4
.IX Item "+cdecp0, +cdecp1, ... , +cdecp7"
فعال کردن Custom Datapath Extension (CDE) روی کمک‌پردازنده‌های انتخاب‌شده
بر پایهٔ شماره‌های ارائه‌شده در گزینه‌ها در بازهٔ 0 تا 7.
.IP \fB+pacbti\fR 4
.IX Item "+pacbti"
فعال کردن افزونهٔ احراز هویت اشاره‌گر و شناسایی مقصد انشعاب (Pointer Authentication and Branch Target Identification Extension).
.RE
.RS 4
.RE
.IP \fBarmv8\-m.main\fR 4
.IX Item "armv8-m.main"
.RS 4
.PD 0
.IP \fB+dsp\fR 4
.IX Item "+dsp"
.PD
دستورالعمل‌های DSP.
.IP \fB+nodsp\fR 4
.IX Item "+nodsp"
غیرفعال کردن افزونهٔ DSP.
.IP \fB+fp\fR 4
.IX Item "+fp"
دستورالعمل‌های ممیز شناور با دقت یگانه.
.IP \fB+fp.dp\fR 4
.IX Item "+fp.dp"
دستورالعمل‌های ممیز شناور با دقت یگانه و دوگانه.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن افزونهٔ ممیز شناور.
.IP "\fB+cdecp0, +cdecp1, ... , +cdecp7\fR" 4
.IX Item "+cdecp0, +cdecp1, ... , +cdecp7"
فعال کردن Custom Datapath Extension (CDE) روی کمک‌پردازنده‌های انتخاب‌شده
بر پایهٔ شماره‌های ارائه‌شده در گزینه‌ها در بازهٔ 0 تا 7.
.RE
.RS 4
.RE
.IP \fBarmv8\-r\fR 4
.IX Item "armv8-r"
.RS 4
.PD 0
.IP \fB+crc\fR 4
.IX Item "+crc"
.PD
دستورالعمل‌های Cyclic Redundancy Check (CRC).
.IP \fB+fp.sp\fR 4
.IX Item "+fp.sp"
دستورالعمل‌های ممیز شناور FPv5 با دقت یگانه.
.IP \fB+simd\fR 4
.IX Item "+simd"
دستورالعمل‌های ممیز شناور و Advanced SIMD مربوط به ARMv8\-A.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری.
.IP \fB+nocrypto\fR 4
.IX Item "+nocrypto"
غیرفعال کردن دستورالعمل‌های رمزنگاری.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
غیرفعال کردن دستورالعمل‌های ممیز شناور، Advanced SIMD و رمزنگاری.
.RE
.RS 4
.RE
.RE
.RS 4
.Sp
گزینهٔ \&\fB\-march=native\fR باعث می‌شود کامپایلر معماری
رایانهٔ ساخت را به‌طور خودکار تشخیص دهد. در حال حاضر، این قابلیت تنها در
GNU/Linux پشتیبانی می‌شود و همهٔ معماری‌ها شناسایی نمی‌شوند. اگر تشخیص
خودکار ناموفق باشد، این گزینه هیچ تأثیری نخواهد داشت.
.Sp
گزینهٔ \&\fB\-march=unset\fR باعث می‌شود کامپایلر هرگونه گزینهٔ
\&\fB\-march=...\fR را که پیش‌تر در خط فرمان آمده نادیده بگیرد
و به‌گونه‌ای عمل کند که گویی این گزینه هرگز داده نشده است. این ویژگی برای جلوگیری
از هشدارهای مربوط به تداخل گزینه‌های CPU و معماری زمانی که این دو
مشخصات معماری متفاوتی را تولید می‌کنند، سودمند است.
.RE
.IP \fB\-mtune=\fR\fIname\fR 4
.IX Item "-mtune=name"
این گزینه نام پردازندهٔ ARM مقصد را مشخص می‌کند که
GCC باید کارایی کد را برای آن بهینه‌سازی کند.
برای برخی پیاده‌سازی‌های ARM می‌توان با استفاده از این گزینه به کارایی
بهتری دست یافت.
نام‌های مجاز عبارتند از: \fBarm7tdmi\fR، \fBarm7tdmi\-s\fR، \fBarm710t\fR،
\&\fBarm720t\fR، \fBarm740t\fR، \fBstrongarm\fR، \fBstrongarm110\fR،
\&\fBstrongarm1100\fR، \fBstrongarm1110\fR، \fBarm8\fR، \fBarm810\fR،
\&\fBarm9\fR، \fBarm9e\fR، \fBarm920\fR، \fBarm920t\fR، \fBarm922t\fR،
\&\fBarm946e\-s\fR، \fBarm966e\-s\fR، \fBarm968e\-s\fR، \fBarm926ej\-s\fR،
\&\fBarm940t\fR، \fBarm9tdmi\fR، \fBarm10tdmi\fR، \fBarm1020t\fR،
\&\fBarm1026ej\-s\fR، \fBarm10e\fR، \fBarm1020e\fR، \fBarm1022e\fR،
\&\fBarm1136j\-s\fR، \fBarm1136jf\-s\fR، \fBmpcore\fR، \fBmpcorenovfp\fR،
\&\fBarm1156t2\-s\fR، \fBarm1156t2f\-s\fR، \fBarm1176jz\-s\fR، \fBarm1176jzf\-s\fR،
\&\fBgeneric\-armv7\-a\fR، \fBcortex\-a5\fR، \fBcortex\-a7\fR، \fBcortex\-a8\fR،
\&\fBcortex\-a9\fR، \fBcortex\-a12\fR، \fBcortex\-a15\fR، \fBcortex\-a17\fR،
\&\fBcortex\-a32\fR، \fBcortex\-a35\fR، \fBcortex\-a53\fR، \fBcortex\-a55\fR،
\&\fBcortex\-a57\fR، \fBcortex\-a72\fR، \fBcortex\-a73\fR، \fBcortex\-a75\fR،
\&\fBcortex\-a76\fR، \fBcortex\-a76ae\fR، \fBcortex\-a77\fR،
\&\fBcortex\-a78\fR، \fBcortex\-a78ae\fR، \fBcortex\-a78c\fR، \fBcortex\-a710\fR،
\&\fBares\fR، \fBcortex\-r4\fR، \fBcortex\-r4f\fR، \fBcortex\-r5\fR،
\&\fBcortex\-r7\fR، \fBcortex\-r8\fR، \fBcortex\-r52\fR، \fBcortex\-r52plus\fR،
\&\fBcortex\-m0\fR، \fBcortex\-m0plus\fR، \fBcortex\-m1\fR، \fBcortex\-m3\fR،
\&\fBcortex\-m4\fR، \fBcortex\-m7\fR، \fBcortex\-m23\fR، \fBcortex\-m33\fR،
\&\fBcortex\-m35p\fR، \fBcortex\-m52\fR، \fBcortex\-m55\fR، \fBcortex\-m85\fR، \fBcortex\-x1\fR،
\&\fBcortex\-x1c\fR، \fBcortex\-m1.small\-multiply\fR، \fBcortex\-m0.small\-multiply\fR،
\&\fBcortex\-m0plus.small\-multiply\fR، \fBexynos\-m1\fR، \fBmarvell\-pj4\fR،
\&\fBneoverse\-n1\fR، \fBneoverse\-n2\fR، \fBneoverse\-v1\fR، \fBxscale\fR،
\&\fBiwmmxt\fR، \fBiwmmxt2\fR، \fBep9312\fR، \fBfa526\fR، \fBfa626\fR،
\&\fBfa606te\fR، \fBfa626te\fR، \fBfmp626\fR، \fBfa726te\fR، \fBstar\-mc1\fR،
\&\fBxgene1\fR.
.Sp
افزون بر این، این گزینه می‌تواند مشخص کند که GCC باید کارایی
کد را برای یک سامانهٔ big.LITTLE بهینه‌سازی کند. نام‌های مجاز عبارتند از:
\&\fBcortex\-a15.cortex\-a7\fR، \fBcortex\-a17.cortex\-a7\fR،
\&\fBcortex\-a57.cortex\-a53\fR، \fBcortex\-a72.cortex\-a53\fR،
\&\fBcortex\-a72.cortex\-a35\fR، \fBcortex\-a73.cortex\-a53\fR،
\&\fBcortex\-a75.cortex\-a55\fR، \fBcortex\-a76.cortex\-a55\fR.
.Sp
گزینهٔ \&\fB\-mtune=generic\-\fR\fIarch\fR مشخص می‌کند که GCC باید کارایی
را برای ترکیبی از پردازنده‌های درون معماری \fIarch\fR بهینه‌سازی کند.
هدف، تولید کدی است که روی محبوب‌ترین پردازنده‌های کنونی به‌خوبی اجرا شود،
و ایجاد تعادلی میان بهینه‌سازی‌هایی که به سود برخی پردازنده‌ها در این بازه هستند
و پرهیز از تله‌های افت کارایی در سایر پردازنده‌ها است. تأثیرات
این گزینه ممکن است در نسخه‌های آیندهٔ GCC با آمدن و رفتن مدل‌های CPU تغییر یابد.
.Sp
گزینهٔ \&\fB\-mtune\fR همان گزینه‌های افزونهٔ مجاز در \fB\-mcpu\fR را می‌پذیرد،
اما این گزینه‌های افزونه تأثیری بر بهینه‌سازی کارایی کد تولیدشده ندارند.
.Sp
گزینهٔ \&\fB\-mtune=native\fR باعث می‌شود کامپایلر CPU
رایانهٔ ساخت را به‌طور خودکار تشخیص دهد. در حال حاضر، این قابلیت تنها در
GNU/Linux پشتیبانی می‌شود و همهٔ معماری‌ها شناسایی نمی‌شوند. اگر تشخیص خودکار
ناموفق باشد، این گزینه هیچ تأثیری نخواهد داشت.
.IP \fB\-mcpu=\fR\fIname\fR[\fB+extension...\fR] 4
.IX Item "-mcpu=name[+extension...]"
این گزینه نام پردازندهٔ ARM مقصد را مشخص می‌کند. GCC از این نام
برای تعیین نام معماری ARM مقصد (گویی با \fB\-march\fR مشخص
شده باشد) و نوع پردازندهٔ ARM جهت بهینه‌سازی کارایی (گویی با
\&\fB\-mtune\fR مشخص شده باشد) استفاده می‌کند. در مواردی که این گزینه
در کنار \fB\-march\fR یا \fB\-mtune\fR استفاده شود،
آن گزینه‌ها بر بخش مربوطه از این گزینه اولویت خواهند داشت.
.Sp
بسیاری از پردازنده‌های پشتیبانی‌شده افزونه‌های معماری اختیاری را
پیاده‌سازی می‌کنند. در مواردی که چنین باشد، افزونه‌های معماری
معمولاً به‌طور پیش‌فرض فعال هستند. چنانچه پیاده‌سازی‌هایی فاقد آن افزونه
وجود داشته باشند، می‌توان از نحو افزونه برای غیرفعال کردن
افزونه‌هایی که حذف شده‌اند استفاده کرد. برای دستورالعمل‌های ممیز شناور و
Advanced SIMD (Neon)، تنظیمات گزینه‌های
\&\fB\-mfloat\-abi\fR و \fB\-mfpu\fR نیز باید در نظر گرفته شوند:
دستورالعمل‌های ممیز شناور و Advanced SIMD تنها در صورتی استفاده خواهند شد که
\&\fB\-mfloat\-abi\fR روی \fBsoft\fR تنظیم نشده باشد؛ و هر تنظیمی از
\&\fB\-mfpu\fR به‌جز \fBauto\fR، دستورالعمل‌های افزونهٔ ممیز شناور و
SIMD در دسترس را بازنویسی خواهد کرد.
.Sp
برای نمونه، \fBcortex\-a9\fR را می‌توان در سه پیکربندی اصلی یافت:
فقط عدد صحیح، تنها با یک واحد ممیز شناور، یا با ممیز شناور و
Advanced SIMD. حالت پیش‌فرض فعال کردن همهٔ دستورالعمل‌ها است، اما می‌توان
از افزونه‌های \fB+nosimd\fR و \fB+nofp\fR به ترتیب برای غیرفعال کردن
تنها SIMD یا هر دو گروه دستورالعمل‌های SIMD و ممیز شناور استفاده کرد.
.Sp
نام‌های مجاز برای این گزینه مشابه با نام‌های مجاز برای
\&\fB\-mtune\fR است.
.Sp
گزینه‌های افزونهٔ زیر میان پردازنده‌های فهرست‌شده مشترک هستند:
.RS 4.IP \fB+nodsp\fR 4
.IX Item "+nodsp"
دستورالعمل‌های DSP را روی \fBcortex\-m33\fR، \fBcortex\-m35p\fR،
\&\fBcortex\-m52\fR، \fBcortex\-m55\fR و \fBcortex\-m85\fR غیرفعال می‌کند.
همچنین دستورالعمل‌های عدد صحیح و ممیز شناور با دقت یگانهٔ M\-Profile Vector Extension (MVE) را روی
\&\fBcortex\-m52\fR، \fBcortex\-m55\fR و \fBcortex\-m85\fR غیرفعال می‌کند.
.IP \fB+nopacbti\fR 4
.IX Item "+nopacbti"
افزونهٔ Pointer Authentication and Branch Target Identification را
روی \fBcortex\-m52\fR و \fBcortex\-m85\fR غیرفعال می‌کند.
.IP \fB+nomve\fR 4
.IX Item "+nomve"
دستورالعمل‌های عدد صحیح و ممیز شناور با دقت یگانهٔ M\-Profile Vector Extension (MVE) را روی \fBcortex\-m52\fR، \fBcortex\-m55\fR و
\&\fBcortex\-m85\fR غیرفعال می‌کند.
.IP \fB+nomve.fp\fR 4
.IX Item "+nomve.fp"
دستورالعمل‌های ممیز شناور با دقت یگانهٔ M\-Profile Vector Extension (MVE) را روی \fBcortex\-m52\fR، \fBcortex\-m55\fR و \fBcortex\-m85\fR غیرفعال می‌کند.
.IP "\fB+cdecp0, +cdecp1, ... , +cdecp7\fR" 4
.IX Item "+cdecp0, +cdecp1, ... , +cdecp7"
افزونهٔ Custom Datapath Extension (CDE) را روی هم‌پردازنده‌های انتخاب‌شده بر اساس اعداد ارائه‌شده در گزینه‌ها در بازهٔ ۰ تا ۷ روی \fBcortex\-m52\fR،
\&\fBcortex\-m55\fR، \fBcortex\-m85\fR و \fBstar\-mc1\fR فعال می‌کند.
.IP \fB+nofp\fR 4
.IX Item "+nofp"
دستورالعمل‌های ممیز شناور را روی \fBarm9e\fR،
\&\fBarm946e\-s\fR، \fBarm966e\-s\fR، \fBarm968e\-s\fR، \fBarm10e\fR،
\&\fBarm1020e\fR، \fBarm1022e\fR، \fBarm926ej\-s\fR،
\&\fBarm1026ej\-s\fR، \fBcortex\-r5\fR، \fBcortex\-r7\fR، \fBcortex\-r8\fR،
\&\fBcortex\-m4\fR، \fBcortex\-m7\fR، \fBcortex\-m33\fR، \fBcortex\-m35p\fR،
\&\fBcortex\-m52\fR، \fBcortex\-m55\fR و \fBcortex\-m85\fR غیرفعال می‌کند.
دستورالعمل‌های ممیز شناور و SIMD را روی
\&\fBgeneric\-armv7\-a\fR، \fBcortex\-a5\fR، \fBcortex\-a7\fR،
\&\fBcortex\-a8\fR، \fBcortex\-a9\fR، \fBcortex\-a12\fR،
\&\fBcortex\-a15\fR، \fBcortex\-a17\fR، \fBcortex\-a15.cortex\-a7\fR،
\&\fBcortex\-a17.cortex\-a7\fR، \fBcortex\-a32\fR، \fBcortex\-a35\fR،
\&\fBcortex\-a53\fR و \fBcortex\-a55\fR غیرفعال می‌کند.
.IP \fB+nofp.dp\fR 4
.IX Item "+nofp.dp"
بخش دقت مضاعف (double\-precision) دستورالعمل‌های ممیز شناور را روی \fBcortex\-r5\fR، \fBcortex\-r7\fR، \fBcortex\-r8\fR، \fBcortex\-r52\fR،
\&\fBcortex\-r52plus\fR و \fBcortex\-m7\fR غیرفعال می‌کند.
.IP \fB+nosimd\fR 4
.IX Item "+nosimd"
دستورالعمل‌های SIMD (اما نه ممیز شناور) را روی
\&\fBgeneric\-armv7\-a\fR، \fBcortex\-a5\fR، \fBcortex\-a7\fR
و \fBcortex\-a9\fR غیرفعال می‌کند.
.IP \fB+crypto\fR 4
.IX Item "+crypto"
دستورالعمل‌های رمزنگاری را روی \fBcortex\-a32\fR،
\&\fBcortex\-a35\fR، \fBcortex\-a53\fR، \fBcortex\-a55\fR، \fBcortex\-a57\fR،
\&\fBcortex\-a72\fR، \fBcortex\-a73\fR، \fBcortex\-a75\fR، \fBexynos\-m1\fR،
\&\fBxgene1\fR، \fBcortex\-a57.cortex\-a53\fR، \fBcortex\-a72.cortex\-a53\fR،
\&\fBcortex\-a73.cortex\-a35\fR، \fBcortex\-a73.cortex\-a53\fR و
\&\fBcortex\-a75.cortex\-a55\fR فعال می‌کند.
.RE
.RS 4
.Sp
علاوه بر این، شبه‌هدف \fBgeneric\-armv7\-a\fR به‌طور پیش‌فرض از VFPv3 با ۱۶ ثبات دقت مضاعف استفاده می‌کند. این هدف از گزینه‌های افزونهٔ زیر پشتیبانی می‌کند: \fBmp\fR، \fBsec\fR، \fBvfpv3\-d16\fR،
\&\fBvfpv3\fR، \fBvfpv3\-d16\-fp16\fR، \fBvfpv3\-fp16\fR،
\&\fBvfpv4\-d16\fR، \fBvfpv4\fR، \fBneon\fR، \fBneon\-vfpv3\fR،
\&\fBneon\-fp16\fR، \fBneon\-vfpv4\fR. معانی آن‌ها مشابه افزونه‌های مربوط به \fB\-march=armv7\-a\fR است.
.Sp
استفاده از \&\fB\-mcpu=generic\-\fR\fIarch\fR نیز مجاز است و معادل با \fB\-march=\fR\fIarch\fR \fB\-mtune=generic\-\fR\fIarch\fR می‌باشد. برای اطلاعات بیشتر \fB\-mtune\fR را ببینید.
.Sp
گزینهٔ \&\fB\-mcpu=native\fR باعث می‌شود کامپایلر پردازندهٔ رایانهٔ ساخت را به‌طور خودکار شناسایی کند. در حال حاضر، این قابلیت تنها روی GNU/Linux پشتیبانی می‌شود و همهٔ معماری‌ها شناسایی نمی‌شوند. اگر تشخیص خودکار ناموفق باشد، این گزینه هیچ اثری نخواهد داشت.
.Sp
گزینهٔ \&\fB\-mcpu=unset\fR باعث می‌شود کامپایلر هرگونه گزینهٔ \&\fB\-mcpu=...\fR را که پیش‌تر در خط فرمان آمده نادیده بگیرد و به‌گونه‌ای عمل کند که گویی این گزینه هرگز ارسال نشده است. این برای جلوگیری از هشدارهای مربوط به تداخل گزینه‌های CPU و معماری، زمانی که این دو مشخصات متفاوتی برای معماری ایجاد می‌کنند، مفید است.
.RE
.IP \fB\-mfpu=\fR\fIname\fR 4
.IX Item "-mfpu=name"
این گزینه مشخص می‌کند چه سخت‌افزار ممیز شناوری (یا شبیه‌سازی سخت‌افزاری) روی هدف در دسترس است. نام‌های مجاز عبارتند از: \fBauto\fR، \fBvfpv2\fR،
\&\fBvfpv3\fR،
\&\fBvfpv3\-fp16\fR، \fBvfpv3\-d16\fR، \fBvfpv3\-d16\-fp16\fR، \fBvfpv3xd\fR،
\&\fBvfpv3xd\-fp16\fR، \fBneon\-vfpv3\fR، \fBneon\-fp16\fR، \fBvfpv4\fR،
\&\fBvfpv4\-d16\fR، \fBfpv4\-sp\-d16\fR، \fBneon\-vfpv4\fR،
\&\fBfpv5\-d16\fR، \fBfpv5\-sp\-d16\fR،
\&\fBfp\-armv8\fR، \fBneon\-fp\-armv8\fR و \fBcrypto\-neon\-fp\-armv8\fR.
توجه داشته باشید که \fBneon\fR یک نام مستعار برای \fBneon\-vfpv3\fR و \fBvfp\fR
نام مستعاری برای \fBvfpv2\fR است.
.Sp
تنظیم \fBauto\fR حالت پیش‌فرض و خاص است. این تنظیم باعث می‌شود کامپایلر دستورالعمل‌های ممیز شناور و Advanced SIMD را بر اساس تنظیمات \fB\-mcpu\fR و \fB\-march\fR انتخاب کند.
.Sp
اگر سخت‌افزار ممیز شناور انتخاب‌شده شامل افزونهٔ NEON باشد (مانند \fB\-mfpu=neon\fR)، توجه داشته باشید که عملیات ممیز شناور توسط گذر بردارسازی خودکار GCC\*(Aqs تولید نخواهد شد مگر اینکه \&\fB\-funsafe\-math\-optimizations\fR نیز مشخص شده باشد. دلیل این امر این است که سخت‌افزار NEON استاندارد IEEE 754 را برای محاسبات ممیز شناور به‌طور کامل پیاده‌سازی نمی‌کند (به‌ویژه مقادیر غیرعادی (denormal) به‌عنوان صفر در نظر گرفته می‌شوند)، بنابراین استفاده از دستورالعمل‌های NEON ممکن است منجر به کاهش دقت شود.
.Sp
شما همچنین می‌توانید نام fpu را در سطح تابع با استفاده از پراگماها یا مشخصه‌های تابع \f(CWtarget("fpu=")\fR تعیین کنید.
.IP \fB\-mfp16\-format=\fR\fIname\fR 4
.IX Item "-mfp16-format=name"
قالب نوع دادهٔ ممیز شناور با نیم‌دقت \f(CW\*(C`_\|_fp16\*(C'\fR را مشخص می‌کند.
نام‌های مجاز عبارتند از \fBnone\fR، \fBieee\fR و \fBalternative\fR؛
حالت پیش‌فرض \fBnone\fR است که در این حالت نوع دادهٔ \f(CW\*(C`_\|_fp16\*(C'\fR تعریف نمی‌شود.
.IP \fB\-mstructure\-size\-boundary=\fR\fIn\fR 4
.IX Item "-mstructure-size-boundary=n"
اندازهٔ تمام ساختارها (structures) و اجتماع‌ها (unions) به مضربی از تعداد بیت‌های تعیین‌شده توسط این گزینه رو به بالا گرد می‌شود. مقادیر مجاز ۸، ۳۲ و ۶۴ هستند. مقدار پیش‌فرض برای زنجیره‌ابزارهای مختلف متفاوت است. برای زنجیره‌ابزارهایی که COFF را هدف قرار می‌دهند، مقدار پیش‌فرض ۸ است. مقدار ۶۴ تنها در صورتی مجاز است که ABI زیربنایی از آن پشتیبانی کند.
.Sp
تعیین عدد بزرگ‌تر می‌تواند کدی سریع‌تر و بهینه‌تر تولید کند، اما ممکن است اندازهٔ برنامه را نیز افزایش دهد. مقادیر مختلف به‌طور بالقوه با یکدیگر ناسازگار هستند. کدی که با یک مقدار کامپایل شده باشد، در صورت تبادل اطلاعات از طریق ساختارها یا اجتماع‌ها، لزوماً نمی‌تواند با کد یا کتابخانه‌هایی که با مقدار دیگری کامپایل شده‌اند کار کند.
.Sp
این گزینه منسوخ شده است.
.IP \fB\-mabort\-on\-noreturn\fR 4
.IX Item "-mabort-on-noreturn"
یک فراخوانی به تابع \f(CW\*(C`abort\*(C'\fR در انتهای یک تابع \&\f(CW\*(C`noreturn\*(C'\fR ایجاد می‌کند. اگر تابع تلاش کند بازگردد، این فراخوانی اجرا می‌شود.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
.PD 0
.IP \fB\-mno\-long\-calls\fR 4
.IX Item "-mno-long-calls"
.PD
به کامپایلر اعلام می‌کند که فراخوانی توابع را ابتدا با بارگذاری آدرس تابع در یک ثبات و سپس انجام فراخوانی زیرروال روی این ثبات انجام دهد. در صورتی که تابع هدف خارج از محدودهٔ آدرس‌دهی ۶۴ مگابایتی نسخهٔ مبتنی بر آفست دستور فراخوانی زیرروال قرار داشته باشد، به این گزینه نیاز است.
.Sp
حتی اگر این گزینه فعال باشد، همهٔ فراخوانی‌های توابع به فراخوانی‌های طولانی (long calls) تبدیل نمی‌شوند. قاعدهٔ کلی این است که توابع ایستا (static)، توابعی که دارای مشخصهٔ \f(CW\*(C`short_call\*(C'\fR هستند، توابعی که در دامنهٔ دستور \f(CW\*(C`#pragma no_long_calls\*(C'\fR قرار دارند، و توابعی که تعاریف آن‌ها از قبل در همان واحد کامپایل جاری کامپایل شده است، به فراخوانی‌های طولانی تبدیل نمی‌شوند. استثنائات این قاعده این است که تعاریف توابع ضعیف (weak)، توابع با مشخصهٔ \f(CW\*(C`long_call\*(C'\fR یا مشخصهٔ \f(CW\*(C`section\*(C'\fR، و توابعی که در دامنهٔ دستور \f(CW\*(C`#pragma long_calls\*(C'\fR قرار دارند، همواره به فراخوانی‌های طولانی تبدیل می‌شوند.
.Sp
این قابلیت به‌طور پیش‌فرض فعال نیست. تعیین گزینهٔ \&\fB\-mno\-long\-calls\fR رفتار پیش‌فرض را بازیابی می‌کند، همان‌طور که قرار دادن فراخوانی توابع در دامنهٔ دستور \f(CW\*(C`#pragma long_calls_off\*(C'\fR این کار را انجام می‌دهد. توجه داشته باشید که این گزینه‌ها هیچ تاثیری بر نحوهٔ تولید کد توسط کامپایلر برای مدیریت فراخوانی توابع از طریق اشاره‌گرهای تابع ندارند.
.IP \fB\-msingle\-pic\-base\fR 4
.IX Item "-msingle-pic-base"
با ثبات مورد استفاده برای آدرس‌دهی PIC به‌صورت فقط‌خواندنی رفتار می‌کند، به‌جای اینکه آن را در مقدمهٔ (prologue) هر تابع بارگذاری کند. سیستم زمان اجرا مسئول مقداردهی اولیهٔ این ثبات با مقداری مناسب پیش از شروع اجرا است.
.IP \fB\-mpic\-register=\fR\fIreg\fR 4
.IX Item "-mpic-register=reg"
ثبات مورد استفاده برای آدرس‌دهی PIC را مشخص می‌کند.
برای حالت پایهٔ استاندارد PIC، مقدار پیش‌فرض هر ثبات مناسبی است که توسط کامپایلر تعیین شود. برای حالت پایهٔ تکی PIC، اگر هدف مبتنی بر EABI باشد یا بررسی پشته فعال باشد، پیش‌فرض \&\fBR9\fR است؛ در غیر این صورت مقدار پیش‌فرض \fBR10\fR خواهد بود.
.IP \fB\-mpic\-data\-is\-text\-relative\fR 4
.IX Item "-mpic-data-is-text-relative"
فرض می‌کند که فاصلهٔ جابه‌جایی میان بخش‌های متن (text) و داده (data) در زمان پیوند ایستا ثابت است. این به کامپایلر اجازه می‌دهد تا با استفاده از عملیات آدرس‌دهی وابسته به PC به داده‌هایی که مشخص است در بخش داده قرار دارند دسترسی پیدا کند. برای اهداف غیر VxWorks RTP، این گزینه به‌طور پیش‌فرض فعال است. هنگام غیرفعال شدن روی چنین اهدافی، گزینهٔ \fB\-msingle\-pic\-base\fR را به‌طور پیش‌فرض فعال می‌کند..IP \fB\-mpoke\-function\-name\fR 4
.IX Item "-mpoke-function-name"
نام هر تابع را مستقیماً پیش از پیش‌درآمد تابع (prologue)، در بخش text می‌نویسد. کد تولیدشده مشابه زیر است:
.Sp
.Vb 9
\&             t0
\&                 .ascii "arm_poke_function_name", 0
\&                 .align
\&             t1
\&                 .word 0xff000000 + (t1 \- t0)
\&             arm_poke_function_name
\&                 mov     ip, sp
\&                 stmfd   sp!, {fp, ip, lr, pc}
\&                 sub     fp, ip, #4
.Ve
.Sp
هنگام انجام ردگیری پشته (stack backtrace)، کد می‌تواند مقدار \f(CW\*(C`pc\*(C'\fR ذخیره‌شده در \f(CW\*(C`fp + 0\*(C'\fR را بررسی کند. اگر تابع ردگیری سپس به مکان \f(CW\*(C`pc \- 12\*(C'\fR نگاه کند و ۸ بیت بالایی تنظیم شده باشند، آن‌گاه مشخص می‌شود که نام تابعی بلافاصله پیش از این مکان جاسازی شده و طول آن برابر \f(CW\*(C`((pc[\-3]) & 0xff000000)\*(C'\fR است.
.IP \fB\-mthumb\fR 4
.IX Item "-mthumb"
.PD 0
.IP \fB\-marm\fR 4
.IX Item "-marm"
.PD
بین تولید کدی که در وضعیت‌های ARM و Thumb اجرا می‌شود، انتخاب می‌کند. پیش‌فرض در بیشتر پیکربندی‌ها تولید کدی است که در وضعیت ARM اجرا شود، اما این پیش‌فرض می‌تواند با پیکربندی GCC از طریق گزینه پیکربندی \fB\-\-with\-mode=\fR\fIstate\fR تغییر کند.
.Sp
همچنین می‌توانید وضعیت ARM و Thumb را برای هر تابع با استفاده از صفت‌ها یا عملگرهای عمل‌یاخته (pragmas) تابعی \f(CWtarget("thumb")\fR و \f(CWtarget("arm")\fR بازنویسی (override) کنید.
.IP \fB\-mtpcs\-frame\fR 4
.IX Item "-mtpcs-frame"
یک فریم پشته (stack frame) سازگار با استاندارد فراخوانی روال Thumb (یا TPCS) برای تمامی توابع غیربرگی (non-leaf) تولید می‌کند. (تابع برگی تابعی است که هیچ تابع دیگری را فراخوانی نمی‌کند.) مقدار پیش‌فرض \fB\-mno\-tpcs\-frame\fR است.
.IP \fB\-mtpcs\-leaf\-frame\fR 4
.IX Item "-mtpcs-leaf-frame"
یک فریم پشته سازگار با استاندارد فراخوانی روال Thumb برای تمامی توابع برگی تولید می‌کند. (تابع برگی تابعی است که هیچ تابع دیگری را فراخوانی نمی‌کند.) مقدار پیش‌فرض \fB\-mno\-apcs\-leaf\-frame\fR است.
.IP \fB\-mcallee\-super\-interworking\fR 4
.IX Item "-mcallee-super-interworking"
به تمامی توابعِ دارای دسترسی خارجی در فایل در حال کامپایل، سرآیندی از مجموعه دستورالعمل‌های ARM اختصاص می‌دهد که پیش از اجرای بقیه تابع، به حالت Thumb تغییر وضعیت می‌دهد. این ویژگی امکان فراخوانی این توابع را از کدهای فاقد تعامل‌پذیری (non-interworking) فراهم می‌کند. این گزینه در پیکربندی‌های AAPCS معتبر نیست، چرا که تعامل‌پذیری به طور پیش‌فرض فعال است.
.IP \fB\-mcaller\-super\-interworking\fR 4
.IX Item "-mcaller-super-interworking"
به فراخوانی‌ها از طریق اشاره‌گرهای تابع (شامل توابع مجازی) اجازه می‌دهد بدون توجه به اینکه کد مقصد برای تعامل‌پذیری کامپایل شده است یا خیر، به درستی اجرا شوند. در صورت فعال بودن این گزینه، سربار اندکی در هزینه اجرای اشاره‌گر تابع وجود خواهد داشت. این گزینه در پیکربندی‌های AAPCS معتبر نیست، زیرا تعامل‌پذیری به طور پیش‌فرض فعال است.
.IP \fB\-mtp=\fR\fIname\fR 4
.IX Item "-mtp=name"
مدل دسترسی برای اشاره‌گر فضای ذخیره‌سازی محلی رشته (TLS) را مشخص می‌کند. مدل \fBsoft\fR فراخوانی‌هایی به \f(CW\*(C`_\|_aeabi_read_tp\*(C'\fR تولید می‌کند. سایر مدل‌های پذیرفته‌شده عبارتند از \fBtpidrurw\fR، \fBtpidruro\fR و \fBtpidrprw\fR که اشاره‌گر رشته را مستقیماً از ثبات سیستمی متناظر واکشی می‌کنند (از معماری arm6k به بعد پشتیبانی می‌شود). این ثبات‌های سیستمی از طریق واسط پردازنده کمکی CP15 قابل دسترسی هستند و آرگومان \fBcp15\fR نیز به عنوان یک نام مستعار برای \fBtpidruro\fR پذیرفته می‌شود. آرگومان \fBauto\fR از بهترین روش موجود برای پردازنده انتخاب‌شده استفاده می‌کند. تنظیم پیش‌فرض \fBauto\fR است.
.IP \fB\-mtls\-dialect=\fR\fIdialect\fR 4
.IX Item "-mtls-dialect=dialect"
گویش مورد استفاده برای دسترسی به فضای ذخیره‌سازی محلی رشته را مشخص می‌کند. دو گویش پشتیبانی می‌شوند: \fBgnu\fR و \fBgnu2\fR. گویش \fBgnu\fR طرح‌واره اصلی GNU را برای پشتیبانی از مدل‌های پویای محلی و سراسری TLS انتخاب می‌کند. گویش \fBgnu2\fR طرح توصیف‌گر GNU را برمی‌گزیند که کارایی بهتری را برای کتابخانه‌های اشتراکی فراهم می‌سازد. طرح توصیف‌گر GNU با طرح اصلی سازگار است، اما نیازمند پشتیبانی جدید اسمبلر، پیونددهنده و کتابخانه است. مدل‌های TLS اجرایی اولیه (initial exec) و محلی (local exec) تحت تأثیر این گزینه قرار نمی‌گیرند و همواره از طرح اصلی استفاده می‌کنند.
.IP \fB\-mword\-relocations\fR 4
.IX Item "-mword-relocations"
تنها بازنشانی‌های مطلق (absolute relocations) را روی مقادیری به اندازه کلمه (یعنی R_ARM_ABS32) تولید می‌کند. این گزینه به طور پیش‌فرض روی مقصدهایی (مانند uClinux و SymbianOS) که بارگذار زمان اجرا این محدودیت را تحمیل می‌کند، و همچنین هنگامی که \fB\-fpic\fR یا \fB\-fPIC\fR مشخص شده باشد، فعال است. این گزینه با \fB\-mslow\-flash\-data\fR تداخل دارد.
.IP \fB\-mfix\-cortex\-m3\-ldrd\fR 4
.IX Item "-mfix-cortex-m3-ldrd"
برخی از هسته‌های Cortex\-M3 می‌توانند هنگام استفاده از دستورالعمل‌های \f(CW\*(C`ldrd\*(C'\fR با ثبات‌های مقصد و پایه متداخل، موجب خرابی داده‌ها شوند. این گزینه از تولید این دستورالعمل‌ها جلوگیری می‌کند. این گزینه به طور پیش‌فرض هنگام مشخص شدن \fB\-mcpu=cortex\-m3\fR فعال است.
.IP \fB\-mfix\-cortex\-a57\-aes\-1742098\fR 4
.IX Item "-mfix-cortex-a57-aes-1742098"
.PD 0
.IP \fB\-mno\-fix\-cortex\-a57\-aes\-1742098\fR 4
.IX Item "-mno-fix-cortex-a57-aes-1742098"
.IP \fB\-mfix\-cortex\-a72\-aes\-1655431\fR 4
.IX Item "-mfix-cortex-a72-aes-1655431"
.IP \fB\-mno\-fix\-cortex\-a72\-aes\-1655431\fR 4
.IX Item "-mno-fix-cortex-a72-aes-1655431"
.PD
کاهش اثر (یا غیرفعال‌سازی آن) برای یک خطای سخت‌افزاری (erratum) در Cortex\-A57 و Cortex\-A72 را که بر دستورالعمل‌های رمزنگاری AES تأثیر می‌گذارد، فعال می‌کند. این گزینه به طور پیش‌فرض در صورت مشخص شدن \fB\-mcpu=cortex\-a57\fR یا \fB\-mcpu=cortex\-a72\fR فعال است.
.IP \fB\-munaligned\-access\fR 4
.IX Item "-munaligned-access"
.PD 0
.IP \fB\-mno\-unaligned\-access\fR 4
.IX Item "-mno-unaligned-access"
.PD
خواندن و نوشتن مقادیر ۱۶ و ۳۲ بیتی را از آدرس‌هایی که تراز ۱۶ یا ۳۲ بیتی ندارند فعال (یا غیرفعال) می‌کند. به طور پیش‌فرض، دسترسی ناتراز برای تمامی معماری‌های پیش از ARMv6، تمامی ARMv6\-M و معماری‌های پایه ARMv8\-M Baseline غیرفعال است و برای تمامی معماری‌های دیگر فعال می‌باشد. اگر دسترسی ناتراز فعال نباشد، دسترسی به کلمات در ساختارهای داده فشرده‌شده (packed) به صورت بایت به بایت انجام می‌گیرد.
.Sp
صفت ARM با نام \f(CW\*(C`Tag_CPU_unaligned_access\*(C'\fR در فایل شیء تولیدشده، بسته به تنظیم این گزینه، روی true یا false قرار می‌گیرد. اگر دسترسی ناتراز فعال باشد، نماد پیش‌پردازنده \f(CW\*(C`_\|_ARM_FEATURE_UNALIGNED\*(C'\fR نیز تعریف می‌شود.
.IP \fB\-mslow\-flash\-data\fR 4
.IX Item "-mslow-flash-data"
فرض می‌کند که بارگذاری داده‌ها از حافظه flash کندتر از واکشی دستورالعمل است. بنابراین بارگذاری مقادیر تحت‌اللفظی (literal load) برای دست‌یابی به کارایی بهتر به حداقل می‌رسد. این گزینه تنها هنگام کامپایل برای ARMv7 M\-profile پشتیبانی می‌شود و به طور پیش‌فرض خاموش است. این گزینه با \fB\-mword\-relocations\fR تداخل دارد.
.IP \fB\-masm\-syntax\-unified\fR 4
.IX Item "-masm-syntax-unified"
فرض می‌کند که اسمبلر درون‌خطی از نحو یکپارچه asm استفاده می‌کند. پیش‌فرض در حال حاضر خاموش است که به معنای نحو تفکیک‌شده (divided syntax) می‌باشد. این گزینه هیچ تأثیری بر Thumb2 ندارد؛ با این حال ممکن است در نسخه‌های بعدی GCC تغییر کند. نحو تفکیک‌شده باید منسوخ تلقی شود.
.IP \fB\-mrestrict\-it\fR 4
.IX Item "-mrestrict-it"
تولید بلوک‌های IT را محدود می‌کند تا با قواعد ARMv8\-A مطابقت داشته باشد. بلوک‌های IT تنها می‌توانند شامل یک دستورالعمل تک ۱۶ بیتی از یک مجموعه برگزیده از دستورالعمل‌ها باشند. این گزینه به طور پیش‌فرض برای حالت ARMv8\-A Thumb روشن است.
.IP \fB\-mpure\-code\fR 4
.IX Item "-mpure-code"
اجازه قرارگیری داده‌های ثابت در بخش‌های کد را نمی‌دهد. علاوه بر این، هنگام کامپایل برای قالب شیء ELF، به تمامی بخش‌های text ویژگی بخش ویژه پردازنده ELF یعنی \f(CW\*(C`SHF_ARM_PURECODE\*(C'\fR را اختصاص می‌دهد. این گزینه تنها هنگام تولید کد غیر-pic برای مقصدهای M\-profile در دسترس است.
.IP \fB\-mcmse\fR 4
.IX Item "-mcmse"
کد امن را مطابق با «ARMv8\-M Security Extensions: Requirements on Development Tools Engineering Specification» تولید می‌کند که در نشانی <\fBhttps://developer.arm.com/documentation/ecm0359818/latest\fR> قابل دسترسی است.
.IP \fB\-mfix\-cmse\-cve\-2021\-35465\fR 4
.IX Item "-mfix-cmse-cve-2021-35465"
اثر یک مشکل امنیتی بالقوه را در دستورالعمل \f(CW\*(C`VLLDM\*(C'\fR در برخی از دستگاه‌های M\-profile هنگام استفاده از CMSE کاهش می‌دهد (CVE\-2021\-365465). این گزینه به طور پیش‌فرض زمانی فعال است که گزینه \fB\-mcpu=\fR به همراه \f(CW\*(C`cortex\-m33\*(C'\fR، \f(CW\*(C`cortex\-m35p\*(C'\fR، \f(CW\*(C`cortex\-m52\*(C'\fR، \f(CW\*(C`cortex\-m55\*(C'\fR، \f(CW\*(C`cortex\-m85\*(C'\fR یا \f(CW\*(C`star\-mc1\*(C'\fR استفاده شود. گزینه \fB\-mno\-fix\-cmse\-cve\-2021\-35465\fR می‌تواند برای غیرفعال کردن این کاهش اثر استفاده شود.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR 4
.IX Item "-mstack-protector-guard-offset=offset"
.PD
کد محافظت از پشته را با استفاده از قناری در \fIguard\fR تولید می‌کند. مکان‌های پشتیبانی‌شده عبارتند از \fBglobal\fR برای یک قناری سراسری یا \fBtls\fR برای یک قناری در دسترس از طریق ثبات TLS. گزینه \fB\-mstack\-protector\-guard\-offset=\fR برای استفاده با \fB\-fstack\-protector\-guard=tls\fR در نظر گرفته شده است و برای استفاده در کدهای فضای کاربری (user-land) نیست.
.IP \fB\-mfdpic\fR 4
.IX Item "-mfdpic"
.PD 0
.IP \fB\-mno\-fdpic\fR 4
.IX Item "-mno-fdpic"
.PD
واسط دوتایی برنامه (ABI) مربوط به FDPIC را انتخاب می‌کند، که از توصیف‌کننده‌های تابع ۶۴ بیتی برای نمایش اشاره‌گرها به توابع استفاده می‌کند. هنگامی که کامپایلر برای مقصدهای \f(CW\*(C`arm\-*\-uclinuxfdpiceabi\*(C'\fR پیکربندی شده باشد، این گزینه به طور پیش‌فرض فعال است و در صورتی که هیچ‌یک از گزینه‌های مرتبط با PIC/PIE ارائه نشده باشد، به طور ضمنی \fB\-fPIE\fR را فعال می‌کند. در سایر مقصدها، تنها قابلیت‌های تولید کد مختص FDPIC را فعال می‌سازد و کاربر در صورت نیاز باید گزینه‌های مربوط به PIC/PIE را صراحتاً ارائه دهد.
.Sp
توجه داشته باشید که پیوند ایستا پشتیبانی نمی‌شود، زیرا هنگام بازنشانی خودکار برنامه (self-relocation) همچنان پیونددهنده پویا را درگیر می‌کند. اگر چنین رفتاری قابل قبول باشد، از گزینه‌های \-static و \-Wl,\-dynamic\-linker استفاده کنید.
.Sp
گزینه معکوس \fB\-mno\-fdpic\fR برای ساخت هسته لینوکس با استفاده از همان زنجیره ابزار (\f(CW\*(C`arm\-*\-uclinuxfdpiceabi\*(C'\fR) که برای ساخت برنامه‌های فضای کاربری استفاده می‌شود، مفید (و الزامی) است..IP \fB\-mbranch\-protection=\fR\fIfeatures\fR 4
.IX Item "-mbranch-protection=features"
فعال‌سازی ویژگی‌های محافظت از انشعاب (تنها armv8.1\-m.main).
.Sp
\&\fIfeatures\fR می‌تواند یکی از شکل‌های زیر را داشته باشد:
.Sp
\&\fBnone\fR کد را بدون محافظت از انشعاب یا امضای آدرس بازگشت تولید می‌کند.
.Sp
\&\fBstandard\fR کد را با تمام ویژگی‌های محافظت از انشعاب فعال‌شده در سطح استانداردشان تولید می‌کند.
.Sp
\&\fBpac\-ret\fR کد را در حالی تولید می‌کند که امضای آدرس بازگشت در سطح استاندارد تنظیم شده است؛ یعنی تمام توابعی که آدرس بازگشت را در حافظه ذخیره می‌کنند امضا می‌شوند.
.Sp
\&\fBpac\-ret+leaf\fR امضای \fBpac\-ret\fR را گسترش می‌دهد تا توابع برگی (leaf) را نیز حتی اگر آدرس بازگشت را در حافظه ذخیره نکنند، شامل شود.
.Sp
\&\fBbti\fR دستورالعمل‌های فرودگاهی (landing\-pad) را به مقصدهای مجاز دستورالعمل‌های انشعاب غیرمستقیم اضافه می‌کند.
.Sp
اگر پشتیبانی از افزونهٔ معماری \fB+pacbti\fR فعال نشده باشد (مثلاً از طریق \fB\-march=\fR)، تمام عملیات‌های محافظت از انشعاب و امضای آدرس بازگشت مقید به استفاده از دستورالعمل‌هایی هستند که تنها در فضای architectural\-NOP تعریف شده‌اند. کد تولیدشده همچنان با نسخه‌های پیشین معماری سازگار با گذشته (backwards\-compatible) باقی می‌ماند، اما امنیت اضافی می‌تواند در زمان اجرا روی پردازنده‌هایی که از افزونهٔ \fBPACBTI\fR پشتیبانی می‌کنند فعال شود.
.Sp
اجرای اجباری مقصد انشعاب با استفاده از BTI تنها در صورتی می‌تواند در زمان اجرا فعال شود که تمام کدهای برنامه دست‌کم با \&\fB\-mbranch\-protection=bti\fR کامپایل شده باشند.
.Sp
هر تنظیمی غیر از \fBnone\fR تنها در armv8\-m.main یا جدیدتر پشتیبانی می‌شود.
.Sp
حالت پیش‌فرض، تولید کد بدون محافظت از انشعاب یا امضای آدرس بازگشت است.
.IP \fB\-mvectorize\-with\-neon\-quad\fR 4
.IX Item "-mvectorize-with-neon-quad"
.PD 0
.IP \fB\-mvectorize\-with\-neon\-double\fR 4
.IX Item "-mvectorize-with-neon-double"
.PD
کنترل اینکه آیا برداری‌سازی (vectorization) از ثبات‌های quad\-word یا double\-word در NEON استفاده کند یا خیر. حالت پیش‌فرض \fB\-mvectorize\-with\-neon\-quad\fR است.
.PP
\fIگزینه‌های AVR\fR
.IX Subsection "AVR Options"
.PP
این گزینه‌ها برای پیاده‌سازی‌های AVR تعریف شده‌اند:
.IP \fB\-mmcu=\fR\fImcu\fR 4
.IX Item "-mmcu=mcu"
معماری مجموعه دستورالعمل (ISA) یا نوع قطعهٔ AVR را مشخص می‌کند.
پیش‌فرض برای این گزینه \f(CW\*(C`avr2\*(C'\fR است.
.Sp
دستگاه‌ها و ISAهای AVR زیر پشتیبانی می‌شوند.
\&\fIنکته:\fR پشتیبانی کامل از یک دستگاه متشکل از کد راه‌اندازی \f(CW\*(C`crt\fR\f(CImcu\fR\f(CW.o\*(C'\fR، یک هدر دستگاه \f(CW\*(C`avr/io*.h\*(C'\fR، یک کتابخانهٔ دستگاه \f(CW\*(C`lib\fR\f(CImcu\fR\f(CW.a\*(C'\fR و یک فایل device\-specs (\f(CW\*(C`https://gcc.gnu.org/wiki/avr\-gcc#spec\-files\*(C'\fR) با نام \&\f(CW\*(C`specs\-\fR\f(CImcu\fR\f(CW\*(C'\fR است. کامپایلر تنها مورد آخر را بر اساس \f(CW\*(C`\fR\f(CImcu\fR\f(CW\*(C'\fRهای پشتیبانی‌شدهٔ زیر ارائه می‌دهد. مابقی موارد توسط AVR\-LibC (\f(CW\*(C`https://github.com/avrdudes/avr\-libc\*(C'\fR) یا به‌وسیلهٔ فایل‌های \&\f(CW\*(C`atpack\*(C'\fR (\f(CW\*(C`https://gcc.gnu.org/wiki/avr\-gcc#atpack\*(C'\fR) از سوی سازندهٔ سخت‌افزار پشتیبانی می‌شوند.
.RS 4
.ie n .IP """avr2""" 4
.el .IP \f(CWavr2\fR 4
.IX Item "avr2"
دستگاه‌های «Classic» با حداکثر 8 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`attiny22\*(C'\fR, \f(CW\*(C`attiny26\*(C'\fR, \f(CW\*(C`at90s2313\*(C'\fR, \f(CW\*(C`at90s2323\*(C'\fR, \f(CW\*(C`at90s2333\*(C'\fR, \f(CW\*(C`at90s2343\*(C'\fR, \f(CW\*(C`at90s4414\*(C'\fR, \f(CW\*(C`at90s4433\*(C'\fR, \f(CW\*(C`at90s4434\*(C'\fR, \f(CW\*(C`at90c8534\*(C'\fR, \f(CW\*(C`at90s8515\*(C'\fR, \f(CW\*(C`at90s8535\*(C'\fR.
.ie n .IP """avr25""" 4
.el .IP \f(CWavr25\fR 4
.IX Item "avr25"
دستگاه‌های «Classic» با حداکثر 8 KiB حافظهٔ برنامه و دارای دستورالعمل \f(CW\*(C`MOVW\*(C'\fR.
\&\fImcu\fR = \f(CW\*(C`attiny13\*(C'\fR, \f(CW\*(C`attiny13a\*(C'\fR, \f(CW\*(C`attiny24\*(C'\fR, \f(CW\*(C`attiny24a\*(C'\fR, \f(CW\*(C`attiny25\*(C'\fR, \f(CW\*(C`attiny261\*(C'\fR, \f(CW\*(C`attiny261a\*(C'\fR, \f(CW\*(C`attiny2313\*(C'\fR, \f(CW\*(C`attiny2313a\*(C'\fR, \f(CW\*(C`attiny43u\*(C'\fR, \f(CW\*(C`attiny44\*(C'\fR, \f(CW\*(C`attiny44a\*(C'\fR, \f(CW\*(C`attiny45\*(C'\fR, \f(CW\*(C`attiny48\*(C'\fR, \f(CW\*(C`attiny441\*(C'\fR, \f(CW\*(C`attiny461\*(C'\fR, \f(CW\*(C`attiny461a\*(C'\fR, \f(CW\*(C`attiny4313\*(C'\fR, \f(CW\*(C`attiny84\*(C'\fR, \f(CW\*(C`attiny84a\*(C'\fR, \f(CW\*(C`attiny85\*(C'\fR, \f(CW\*(C`attiny87\*(C'\fR, \f(CW\*(C`attiny88\*(C'\fR, \f(CW\*(C`attiny828\*(C'\fR, \f(CW\*(C`attiny841\*(C'\fR, \f(CW\*(C`attiny861\*(C'\fR, \f(CW\*(C`attiny861a\*(C'\fR, \f(CW\*(C`ata5272\*(C'\fR, \f(CW\*(C`ata6616c\*(C'\fR, \f(CW\*(C`at86rf401\*(C'\fR.
.ie n .IP """avr3""" 4
.el .IP \f(CWavr3\fR 4
.IX Item "avr3"
دستگاه‌های «Classic» با 16 KiB تا 64 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`at76c711\*(C'\fR, \f(CW\*(C`at43usb355\*(C'\fR.
.ie n .IP """avr31""" 4
.el .IP \f(CWavr31\fR 4
.IX Item "avr31"
دستگاه‌های «Classic» با 128 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atmega103\*(C'\fR, \f(CW\*(C`at43usb320\*(C'\fR.
.ie n .IP """avr35""" 4
.el .IP \f(CWavr35\fR 4
.IX Item "avr35"
دستگاه‌های «Classic» با 16 KiB تا 64 KiB حافظهٔ برنامه و دارای دستورالعمل \f(CW\*(C`MOVW\*(C'\fR.
\&\fImcu\fR = \f(CW\*(C`attiny167\*(C'\fR, \f(CW\*(C`attiny1634\*(C'\fR, \f(CW\*(C`atmega8u2\*(C'\fR, \f(CW\*(C`atmega16u2\*(C'\fR, \f(CW\*(C`atmega32u2\*(C'\fR, \f(CW\*(C`ata5505\*(C'\fR, \f(CW\*(C`ata6617c\*(C'\fR, \f(CW\*(C`ata664251\*(C'\fR, \f(CW\*(C`at90usb82\*(C'\fR, \f(CW\*(C`at90usb162\*(C'\fR.
.ie n .IP """avr4""" 4
.el .IP \f(CWavr4\fR 4
.IX Item "avr4"
دستگاه‌های «Enhanced» با حداکثر 8 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atmega48\*(C'\fR, \f(CW\*(C`atmega48a\*(C'\fR, \f(CW\*(C`atmega48p\*(C'\fR, \f(CW\*(C`atmega48pa\*(C'\fR, \f(CW\*(C`atmega48pb\*(C'\fR, \f(CW\*(C`atmega8\*(C'\fR, \f(CW\*(C`atmega8a\*(C'\fR, \f(CW\*(C`atmega8hva\*(C'\fR, \f(CW\*(C`atmega88\*(C'\fR, \f(CW\*(C`atmega88a\*(C'\fR, \f(CW\*(C`atmega88p\*(C'\fR, \f(CW\*(C`atmega88pa\*(C'\fR, \f(CW\*(C`atmega88pb\*(C'\fR, \f(CW\*(C`atmega8515\*(C'\fR, \f(CW\*(C`atmega8535\*(C'\fR, \f(CW\*(C`ata5795\*(C'\fR, \f(CW\*(C`ata6285\*(C'\fR, \f(CW\*(C`ata6286\*(C'\fR, \f(CW\*(C`ata6289\*(C'\fR, \f(CW\*(C`ata6612c\*(C'\fR, \f(CW\*(C`at90pwm1\*(C'\fR, \f(CW\*(C`at90pwm2\*(C'\fR, \f(CW\*(C`at90pwm2b\*(C'\fR, \f(CW\*(C`at90pwm3\*(C'\fR, \f(CW\*(C`at90pwm3b\*(C'\fR, \f(CW\*(C`at90pwm81\*(C'\fR.
.ie n .IP """avr5""" 4
.el .IP \f(CWavr5\fR 4
.IX Item "avr5"
دستگاه‌های «Enhanced» با 16 KiB تا 64 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atmega16\*(C'\fR, \f(CW\*(C`atmega16a\*(C'\fR, \f(CW\*(C`atmega16hva\*(C'\fR, \f(CW\*(C`atmega16hva2\*(C'\fR, \f(CW\*(C`atmega16hvb\*(C'\fR, \f(CW\*(C`atmega16hvbrevb\*(C'\fR, \f(CW\*(C`atmega16m1\*(C'\fR, \f(CW\*(C`atmega16u4\*(C'\fR, \f(CW\*(C`atmega161\*(C'\fR, \f(CW\*(C`atmega162\*(C'\fR, \f(CW\*(C`atmega163\*(C'\fR, \f(CW\*(C`atmega164a\*(C'\fR, \f(CW\*(C`atmega164p\*(C'\fR, \f(CW\*(C`atmega164pa\*(C'\fR, \f(CW\*(C`atmega165\*(C'\fR, \f(CW\*(C`atmega165a\*(C'\fR, \f(CW\*(C`atmega165p\*(C'\fR, \f(CW\*(C`atmega165pa\*(C'\fR, \f(CW\*(C`atmega168\*(C'\fR, \f(CW\*(C`atmega168a\*(C'\fR, \f(CW\*(C`atmega168p\*(C'\fR, \f(CW\*(C`atmega168pa\*(C'\fR, \f(CW\*(C`atmega168pb\*(C'\fR, \f(CW\*(C`atmega169\*(C'\fR, \f(CW\*(C`atmega169a\*(C'\fR, \f(CW\*(C`atmega169p\*(C'\fR, \f(CW\*(C`atmega169pa\*(C'\fR, \f(CW\*(C`atmega32\*(C'\fR, \f(CW\*(C`atmega32a\*(C'\fR, \f(CW\*(C`atmega32c1\*(C'\fR, \f(CW\*(C`atmega32hvb\*(C'\fR, \f(CW\*(C`atmega32hvbrevb\*(C'\fR, \f(CW\*(C`atmega32m1\*(C'\fR, \f(CW\*(C`atmega32u4\*(C'\fR, \f(CW\*(C`atmega32u6\*(C'\fR, \f(CW\*(C`atmega323\*(C'\fR, \f(CW\*(C`atmega324a\*(C'\fR, \f(CW\*(C`atmega324p\*(C'\fR, \f(CW\*(C`atmega324pa\*(C'\fR, \f(CW\*(C`atmega324pb\*(C'\fR, \f(CW\*(C`atmega325\*(C'\fR, \f(CW\*(C`atmega325a\*(C'\fR, \f(CW\*(C`atmega325p\*(C'\fR, \f(CW\*(C`atmega325pa\*(C'\fR, \f(CW\*(C`atmega328\*(C'\fR, \f(CW\*(C`atmega328p\*(C'\fR, \f(CW\*(C`atmega328pb\*(C'\fR, \f(CW\*(C`atmega329\*(C'\fR, \f(CW\*(C`atmega329a\*(C'\fR, \f(CW\*(C`atmega329p\*(C'\fR, \f(CW\*(C`atmega329pa\*(C'\fR, \f(CW\*(C`atmega3250\*(C'\fR, \f(CW\*(C`atmega3250a\*(C'\fR, \f(CW\*(C`atmega3250p\*(C'\fR, \f(CW\*(C`atmega3250pa\*(C'\fR, \f(CW\*(C`atmega3290\*(C'\fR, \f(CW\*(C`atmega3290a\*(C'\fR, \f(CW\*(C`atmega3290p\*(C'\fR, \f(CW\*(C`atmega3290pa\*(C'\fR, \f(CW\*(C`atmega406\*(C'\fR, \f(CW\*(C`atmega64\*(C'\fR, \f(CW\*(C`atmega64a\*(C'\fR, \f(CW\*(C`atmega64c1\*(C'\fR, \f(CW\*(C`atmega64hve\*(C'\fR, \f(CW\*(C`atmega64hve2\*(C'\fR, \f(CW\*(C`atmega64m1\*(C'\fR, \f(CW\*(C`atmega64rfr2\*(C'\fR, \f(CW\*(C`atmega640\*(C'\fR, \f(CW\*(C`atmega644\*(C'\fR, \f(CW\*(C`atmega644a\*(C'\fR, \f(CW\*(C`atmega644p\*(C'\fR, \f(CW\*(C`atmega644pa\*(C'\fR, \f(CW\*(C`atmega644rfr2\*(C'\fR, \f(CW\*(C`atmega645\*(C'\fR, \f(CW\*(C`atmega645a\*(C'\fR, \f(CW\*(C`atmega645p\*(C'\fR, \f(CW\*(C`atmega649\*(C'\fR, \f(CW\*(C`atmega649a\*(C'\fR, \f(CW\*(C`atmega649p\*(C'\fR, \f(CW\*(C`atmega6450\*(C'\fR, \f(CW\*(C`atmega6450a\*(C'\fR, \f(CW\*(C`atmega6450p\*(C'\fR, \f(CW\*(C`atmega6490\*(C'\fR, \f(CW\*(C`atmega6490a\*(C'\fR, \f(CW\*(C`atmega6490p\*(C'\fR, \f(CW\*(C`ata5790\*(C'\fR, \f(CW\*(C`ata5790n\*(C'\fR, \f(CW\*(C`ata5791\*(C'\fR, \f(CW\*(C`ata6613c\*(C'\fR, \f(CW\*(C`ata6614q\*(C'\fR, \f(CW\*(C`ata5782\*(C'\fR, \f(CW\*(C`ata5831\*(C'\fR, \f(CW\*(C`ata8210\*(C'\fR, \f(CW\*(C`ata8510\*(C'\fR, \f(CW\*(C`ata5787\*(C'\fR, \f(CW\*(C`ata5835\*(C'\fR, \f(CW\*(C`ata5700m322\*(C'\fR, \f(CW\*(C`ata5702m322\*(C'\fR, \f(CW\*(C`at90pwm161\*(C'\fR, \f(CW\*(C`at90pwm216\*(C'\fR, \f(CW\*(C`at90pwm316\*(C'\fR, \f(CW\*(C`at90can32\*(C'\fR, \f(CW\*(C`at90can64\*(C'\fR, \f(CW\*(C`at90scr100\*(C'\fR, \f(CW\*(C`at90usb646\*(C'\fR, \f(CW\*(C`at90usb647\*(C'\fR, \f(CW\*(C`at94k\*(C'\fR, \f(CW\*(C`m3000\*(C'\fR.
.ie n .IP """avr51""" 4
.el .IP \f(CWavr51\fR 4
.IX Item "avr51"
دستگاه‌های «Enhanced» با 128 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atmega128\*(C'\fR, \f(CW\*(C`atmega128a\*(C'\fR, \f(CW\*(C`atmega128rfa1\*(C'\fR, \f(CW\*(C`atmega128rfr2\*(C'\fR, \f(CW\*(C`atmega1280\*(C'\fR, \f(CW\*(C`atmega1281\*(C'\fR, \f(CW\*(C`atmega1284\*(C'\fR, \f(CW\*(C`atmega1284p\*(C'\fR, \f(CW\*(C`atmega1284rfr2\*(C'\fR, \f(CW\*(C`at90can128\*(C'\fR, \f(CW\*(C`at90usb1286\*(C'\fR, \f(CW\*(C`at90usb1287\*(C'\fR.
.ie n .IP """avr6""" 4
.el .IP \f(CWavr6\fR 4
.IX Item "avr6"
دستگاه‌های «Enhanced» با شمارندهٔ برنامه (PC) سه بایتی، یعنی با بیش از 128 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atmega256rfr2\*(C'\fR, \f(CW\*(C`atmega2560\*(C'\fR, \f(CW\*(C`atmega2561\*(C'\fR, \f(CW\*(C`atmega2564rfr2\*(C'\fR.
.ie n .IP """avrxmega2""" 4
.el .IP \f(CWavrxmega2\fR 4
.IX Item "avrxmega2"
دستگاه‌های «XMEGA» با بیش از 8 KiB و حداکثر 64 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atxmega8e5\*(C'\fR, \f(CW\*(C`atxmega16a4\*(C'\fR, \f(CW\*(C`atxmega16a4u\*(C'\fR, \f(CW\*(C`atxmega16c4\*(C'\fR, \f(CW\*(C`atxmega16d4\*(C'\fR, \f(CW\*(C`atxmega16e5\*(C'\fR, \f(CW\*(C`atxmega32a4\*(C'\fR, \f(CW\*(C`atxmega32a4u\*(C'\fR, \f(CW\*(C`atxmega32c3\*(C'\fR, \f(CW\*(C`atxmega32c4\*(C'\fR, \f(CW\*(C`atxmega32d3\*(C'\fR, \f(CW\*(C`atxmega32d4\*(C'\fR, \f(CW\*(C`atxmega32e5\*(C'\fR, \f(CW\*(C`avr64da28\*(C'\fR, \f(CW\*(C`avr64da28s\*(C'\fR, \f(CW\*(C`avr64da32\*(C'\fR, \f(CW\*(C`avr64da32s\*(C'\fR, \f(CW\*(C`avr64da48\*(C'\fR, \f(CW\*(C`avr64da48s\*(C'\fR, \f(CW\*(C`avr64da64\*(C'\fR, \f(CW\*(C`avr64da64s\*(C'\fR, \f(CW\*(C`avr64db28\*(C'\fR, \f(CW\*(C`avr64db32\*(C'\fR, \f(CW\*(C`avr64db48\*(C'\fR, \f(CW\*(C`avr64db64\*(C'\fR, \f(CW\*(C`avr64dd14\*(C'\fR, \f(CW\*(C`avr64dd20\*(C'\fR, \f(CW\*(C`avr64dd28\*(C'\fR, \f(CW\*(C`avr64dd32\*(C'\fR, \f(CW\*(C`avr64du28\*(C'\fR, \f(CW\*(C`avr64du32\*(C'\fR, \f(CW\*(C`avr64ea28\*(C'\fR, \f(CW\*(C`avr64ea32\*(C'\fR, \f(CW\*(C`avr64ea48\*(C'\fR, \f(CW\*(C`avr64sd28\*(C'\fR, \f(CW\*(C`avr64sd32\*(C'\fR, \f(CW\*(C`avr64sd48\*(C'\fR.
.ie n .IP """avrxmega3""" 4
.el .IP \f(CWavrxmega3\fR 4
.IX Item "avrxmega3"
دستگاه‌های «XMEGA» با حداکثر 64 KiB حافظهٔ برنامه و RAM به صورت ترکیبی، و با حافظهٔ برنامه‌ای که در فضای نشانی RAM قابل مشاهده است.
\&\fImcu\fR = \f(CW\*(C`attiny202\*(C'\fR, \f(CW\*(C`attiny204\*(C'\fR, \f(CW\*(C`attiny212\*(C'\fR, \f(CW\*(C`attiny214\*(C'\fR, \f(CW\*(C`attiny402\*(C'\fR, \f(CW\*(C`attiny404\*(C'\fR, \f(CW\*(C`attiny406\*(C'\fR, \f(CW\*(C`attiny412\*(C'\fR, \f(CW\*(C`attiny414\*(C'\fR, \f(CW\*(C`attiny416\*(C'\fR, \f(CW\*(C`attiny416auto\*(C'\fR, \f(CW\*(C`attiny417\*(C'\fR, \f(CW\*(C`attiny424\*(C'\fR, \f(CW\*(C`attiny426\*(C'\fR, \f(CW\*(C`attiny427\*(C'\fR, \f(CW\*(C`attiny804\*(C'\fR, \f(CW\*(C`attiny806\*(C'\fR, \f(CW\*(C`attiny807\*(C'\fR, \f(CW\*(C`attiny814\*(C'\fR, \f(CW\*(C`attiny816\*(C'\fR, \f(CW\*(C`attiny817\*(C'\fR, \f(CW\*(C`attiny824\*(C'\fR, \f(CW\*(C`attiny826\*(C'\fR, \f(CW\*(C`attiny827\*(C'\fR, \f(CW\*(C`attiny1604\*(C'\fR, \f(CW\*(C`attiny1606\*(C'\fR, \f(CW\*(C`attiny1607\*(C'\fR, \f(CW\*(C`attiny1614\*(C'\fR, \f(CW\*(C`attiny1616\*(C'\fR, \f(CW\*(C`attiny1617\*(C'\fR, \f(CW\*(C`attiny1624\*(C'\fR, \f(CW\*(C`attiny1626\*(C'\fR, \f(CW\*(C`attiny1627\*(C'\fR, \f(CW\*(C`attiny3214\*(C'\fR, \f(CW\*(C`attiny3216\*(C'\fR, \f(CW\*(C`attiny3217\*(C'\fR, \f(CW\*(C`attiny3224\*(C'\fR, \f(CW\*(C`attiny3226\*(C'\fR, \f(CW\*(C`attiny3227\*(C'\fR, \f(CW\*(C`atmega808\*(C'\fR, \f(CW\*(C`atmega809\*(C'\fR, \f(CW\*(C`atmega1608\*(C'\fR, \f(CW\*(C`atmega1609\*(C'\fR, \f(CW\*(C`atmega3208\*(C'\fR, \f(CW\*(C`atmega3209\*(C'\fR, \f(CW\*(C`atmega4808\*(C'\fR, \f(CW\*(C`atmega4809\*(C'\fR, \f(CW\*(C`avr16dd14\*(C'\fR, \f(CW\*(C`avr16dd20\*(C'\fR, \f(CW\*(C`avr16dd28\*(C'\fR, \f(CW\*(C`avr16dd32\*(C'\fR, \f(CW\*(C`avr16du14\*(C'\fR, \f(CW\*(C`avr16du20\*(C'\fR, \f(CW\*(C`avr16du28\*(C'\fR, \f(CW\*(C`avr16du32\*(C'\fR, \f(CW\*(C`avr16ea28\*(C'\fR, \f(CW\*(C`avr16ea32\*(C'\fR, \f(CW\*(C`avr16ea48\*(C'\fR, \f(CW\*(C`avr16eb14\*(C'\fR, \f(CW\*(C`avr16eb20\*(C'\fR, \f(CW\*(C`avr16eb28\*(C'\fR, \f(CW\*(C`avr16eb32\*(C'\fR, \f(CW\*(C`avr16la14\*(C'\fR, \f(CW\*(C`avr16la20\*(C'\fR, \f(CW\*(C`avr16la28\*(C'\fR, \f(CW\*(C`avr16la32\*(C'\fR, \f(CW\*(C`avr32da28\*(C'\fR, \f(CW\*(C`avr32da28s\*(C'\fR, \f(CW\*(C`avr32da32\*(C'\fR, \f(CW\*(C`avr32da32s\*(C'\fR, \f(CW\*(C`avr32da48\*(C'\fR, \f(CW\*(C`avr32da48s\*(C'\fR, \f(CW\*(C`avr32db28\*(C'\fR, \f(CW\*(C`avr32db32\*(C'\fR, \f(CW\*(C`avr32db48\*(C'\fR, \f(CW\*(C`avr32dd14\*(C'\fR, \f(CW\*(C`avr32dd20\*(C'\fR, \f(CW\*(C`avr32dd28\*(C'\fR, \f(CW\*(C`avr32dd32\*(C'\fR, \f(CW\*(C`avr32du14\*(C'\fR, \f(CW\*(C`avr32du20\*(C'\fR, \f(CW\*(C`avr32du28\*(C'\fR, \f(CW\*(C`avr32du32\*(C'\fR, \f(CW\*(C`avr32ea28\*(C'\fR, \f(CW\*(C`avr32ea32\*(C'\fR, \f(CW\*(C`avr32ea48\*(C'\fR, \f(CW\*(C`avr32eb14\*(C'\fR, \f(CW\*(C`avr32eb20\*(C'\fR, \f(CW\*(C`avr32eb28\*(C'\fR, \f(CW\*(C`avr32eb32\*(C'\fR, \f(CW\*(C`avr32la14\*(C'\fR, \f(CW\*(C`avr32la20\*(C'\fR, \f(CW\*(C`avr32la28\*(C'\fR, \f(CW\*(C`avr32la32\*(C'\fR, \f(CW\*(C`avr32sd20\*(C'\fR, \f(CW\*(C`avr32sd28\*(C'\fR, \f(CW\*(C`avr32sd32\*(C'\fR.
.ie n .IP """avrxmega4""" 4
.el .IP \f(CWavrxmega4\fR 4
.IX Item "avrxmega4"
دستگاه‌های «XMEGA» با بیش از 64 KiB و حداکثر 128 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atxmega64a3\*(C'\fR, \f(CW\*(C`atxmega64a3u\*(C'\fR, \f(CW\*(C`atxmega64a4u\*(C'\fR, \f(CW\*(C`atxmega64b1\*(C'\fR, \f(CW\*(C`atxmega64b3\*(C'\fR, \f(CW\*(C`atxmega64c3\*(C'\fR, \f(CW\*(C`atxmega64d3\*(C'\fR, \f(CW\*(C`atxmega64d4\*(C'\fR, \f(CW\*(C`avr128da28\*(C'\fR, \f(CW\*(C`avr128da28s\*(C'\fR, \f(CW\*(C`avr128da32\*(C'\fR, \f(CW\*(C`avr128da32s\*(C'\fR, \f(CW\*(C`avr128da48\*(C'\fR, \f(CW\*(C`avr128da48s\*(C'\fR, \f(CW\*(C`avr128da64\*(C'\fR, \f(CW\*(C`avr128da64s\*(C'\fR, \f(CW\*(C`avr128db28\*(C'\fR, \f(CW\*(C`avr128db32\*(C'\fR, \f(CW\*(C`avr128db48\*(C'\fR, \f(CW\*(C`avr128db64\*(C'\fR.
.ie n .IP """avrxmega5""" 4
.el .IP \f(CWavrxmega5\fR 4
.IX Item "avrxmega5"
دستگاه‌های «XMEGA» با بیش از 64 KiB و حداکثر 128 KiB حافظهٔ برنامه و بیش از 64 KiB حافظهٔ RAM.
\&\fImcu\fR = \f(CW\*(C`atxmega64a1\*(C'\fR, \f(CW\*(C`atxmega64a1u\*(C'\fR.
.ie n .IP """avrxmega6""" 4
.el .IP \f(CWavrxmega6\fR 4
.IX Item "avrxmega6"
دستگاه‌های «XMEGA» با بیش از 128 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`atxmega128a3\*(C'\fR, \f(CW\*(C`atxmega128a3u\*(C'\fR, \f(CW\*(C`atxmega128b1\*(C'\fR, \f(CW\*(C`atxmega128b3\*(C'\fR, \f(CW\*(C`atxmega128c3\*(C'\fR, \f(CW\*(C`atxmega128d3\*(C'\fR, \f(CW\*(C`atxmega128d4\*(C'\fR, \f(CW\*(C`atxmega192a3\*(C'\fR, \f(CW\*(C`atxmega192a3u\*(C'\fR, \f(CW\*(C`atxmega192c3\*(C'\fR, \f(CW\*(C`atxmega192d3\*(C'\fR, \f(CW\*(C`atxmega256a3\*(C'\fR, \f(CW\*(C`atxmega256a3b\*(C'\fR, \f(CW\*(C`atxmega256a3bu\*(C'\fR, \f(CW\*(C`atxmega256a3u\*(C'\fR, \f(CW\*(C`atxmega256c3\*(C'\fR, \f(CW\*(C`atxmega256d3\*(C'\fR, \f(CW\*(C`atxmega384c3\*(C'\fR, \f(CW\*(C`atxmega384d3\*(C'\fR.
.ie n .IP """avrxmega7""" 4
.el .IP \f(CWavrxmega7\fR 4
.IX Item "avrxmega7"
دستگاه‌های «XMEGA» با بیش از 128 KiB حافظهٔ برنامه و بیش از 64 KiB حافظهٔ RAM.
\&\fImcu\fR = \f(CW\*(C`atxmega128a1\*(C'\fR, \f(CW\*(C`atxmega128a1u\*(C'\fR, \f(CW\*(C`atxmega128a4u\*(C'\fR.
.ie n .IP """avrtiny""" 4
.el .IP \f(CWavrtiny\fR 4
.IX Item "avrtiny"
دستگاه‌های با هستهٔ Tiny از نوع «Reduced Tiny» تنها با ۱۶ ثبات همه‌منظوره و 512 B تا 4 KiB حافظهٔ برنامه.
\&\fImcu\fR = \f(CW\*(C`attiny4\*(C'\fR, \f(CW\*(C`attiny5\*(C'\fR, \f(CW\*(C`attiny9\*(C'\fR, \f(CW\*(C`attiny10\*(C'\fR, \f(CW\*(C`attiny102\*(C'\fR, \f(CW\*(C`attiny104\*(C'\fR, \f(CW\*(C`attiny20\*(C'\fR, \f(CW\*(C`attiny40\*(C'\fR.
.ie n .IP """avr1""" 4
.el .IP \f(CWavr1\fR 4
.IX Item "avr1"
این ISA توسط هستهٔ کمینهٔ AVR پیاده‌سازی شده و تنها برای اسمبلر پشتیبانی می‌شود.
\&\fImcu\fR = \f(CW\*(C`attiny11\*(C'\fR, \f(CW\*(C`attiny12\*(C'\fR, \f(CW\*(C`attiny15\*(C'\fR, \f(CW\*(C`attiny28\*(C'\fR, \f(CW\*(C`at90s1200\*(C'\fR.
.RE
.RS 4
.RE
.IP \fB\-mabsdata\fR 4
.IX Item "-mabsdata"
فرض می‌کند که تمام داده‌ها در حافظهٔ ایستا می‌توانند توسط دستورالعمل‌های LDS / STS دسترسی‌پذیر باشند. این گزینه تنها بر روی دستگاه‌های تقلیل‌یافتهٔ Tiny مانند ATtiny40 اثر دارد. همچنین ویژگی متغیر \f(CW\*(C`absdata\*(C'\fR در \&\fBAVR Attributes,variable attribute\fR را ببینید.
.IP \fB\-mcvt\fR 4
.IX Item "-mcvt"
استفاده از یک \fIجدول بردار فشرده\fR (CVT). برخی دستگاه‌ها از یک CVT با تنها چهار ورودی پشتیبانی می‌کنند: 0=Reset، 1=NMI، 2=Prio1 IRQ، 3=Prio0 IRQs. این گزینه به‌جای \f(CW\*(C`crt\fR\f(CImcu\fR\f(CW.o\*(C'\fR معمول، کد راه‌اندازی را از \f(CW\*(C`crt\fR\f(CImcu\fR\f(CW\-cvt.o\*(C'\fR پیوند (link) می‌دهد. علاوه بر ارائهٔ یک جدول بردار فشرده، کد راه‌اندازی بیت \&\f(CW\*(C`CPUINT_CTRLA.CPUINT_CVT\*(C'\fR را تنظیم خواهد کرد که CVT را روی دستگاه فعال می‌کند.
.Sp
هنگامی که نمی‌خواهید کد راه‌اندازی بیت \f(CW\*(C`CPUINT_CTRLA.CPUINT_CVT\*(C'\fR را تنظیم کند، می‌توانید نماد \f(CW\*(C`_\|_init_cvt\*(C'\fR را مقداردهی کنید تا کد مربوطه دیگر از \f(CW\*(C`lib\fR\f(CImcu\fR\f(CW.a\*(C'\fR وارد نشود. به‌عنوان مثال، می‌توانید با \f(CW\*(C`\-Wl,\-\-defsym,_\|_init_cvt=0\*(C'\fR پیوند دهید.
.Sp
کد راه‌اندازی CVT از نسخهٔ AVR\-LibC\ v2.3 (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/1010\*(C'\fR) به بعد در دسترس است.
.IP \fB\-mdouble=\fR\fIbits\fR 4
.IX Item "-mdouble=bits".PD 0
.IP \fB\-mlong\-double=\fR\fIbits\fR 4
.IX Item "-mlong-double=bits"
.PD
اندازه (به بیت) نوع‌های \f(CW\*(C`double\*(C'\fR یا \f(CW\*(C`long double\*(C'\fR را به ترتیب
تعیین می‌کند. مقادیر ممکن برای \fIbits\fR برابر با 32 و 64 هستند.
مجاز بودن یا نبودن یک مقدار مشخص برای \fIbits\fR به گزینه‌های پیکربندی
\&\f(CW\*(C`\-\-with\-double=\*(C'\fR و \f(CW\*(C`\-\-with\-long\-double=\*(C'\fR
در configure بستگی دارد (\f(CW\*(C`https://gcc.gnu.org/install/configure.html#avr\*(C'\fR)،
و همین موضوع برای مقادیر پیش‌فرض گزینه‌ها نیز صدق می‌کند.
.IP \fB\-mgas\-isr\-prologues\fR 4
.IX Item "-mgas-isr-prologues"
روال‌های سرویس وقفه (ISRها) ممکن است از شبه‌دستور \f(CW\*(C`_\|_gcc_isr\*(C'\fR که
توسط GNU Binutils پشتیبانی می‌شود استفاده کنند.
اگر این گزینه فعال باشد، این ویژگی همچنان می‌تواند برای تک‌تک
ISRها از طریق صفت تابع \fBAVR Attributes,,\fR\f(CB\*(C`no_gccisr\*(C'\fR
غیرفعال شود. این ویژگی در صورتی که بهینه‌سازی فعال باشد به‌طور پیش‌فرض فعال است
(اما نه با \fB\-Og\fR، \f(CW@pxref\fR{Optimize Options})،
و به شرطی که GNU Binutils از PR21683 پشتیبانی کند (\f(CW\*(C`https://sourceware.org/PR21683\*(C'\fR).
.IP \fB\-mint8\fR 4
.IX Item "-mint8"
نوع \f(CW\*(C`int\*(C'\fR را یک عدد صحیح ۸ بیتی فرض می‌کند. این مورد بر اندازه تمام انواع داده تأثیر می‌گذارد: یک
\&\f(CW\*(C`char\*(C'\fR برابر با ۱ بایت، یک \f(CW\*(C`int\*(C'\fR برابر با ۱ بایت، یک \f(CW\*(C`long\*(C'\fR برابر با ۲ بایت،
و \f(CW\*(C`long long\*(C'\fR برابر با ۴ بایت خواهد بود. لطفاً توجه داشته باشید که این گزینه
با استانداردهای C مطابقت ندارد، اما اندازه کد تولیدشده
را کاهش می‌دهد.
.IP \fB\-mmain\-is\-OS_task\fR 4
.IX Item "-mmain-is-OS_task"
ثبات‌ها را در \f(CW\*(C`main\*(C'\fR ذخیره نمی‌کند. اثر آن مشابه الصاق
صفت \fBAVR Attributes,,\fR\f(CB\*(C`OS_task\*(C'\fR
به \f(CW\*(C`main\*(C'\fR است. این ویژگی در صورتی که بهینه‌سازی روشن باشد به‌طور پیش‌فرض فعال است.
.IP \fB\-mno\-call\-main\fR 4
.IX Item "-mno-call-main"
تابع \f(CW\*(C`main\*(C'\fR را از طریق دستورهای زیر اجرا نمی‌کند:
.Sp
.Vb 2
\&        XCALL  main
\&        XJMP   exit
.Ve
.Sp
در عوض، \f(CW\*(C`main\*(C'\fR را در بخش
\&\f(CW\*(C`.init9\*(C'\fR (\f(CW\*(C`https://avrdudes.github.io/avr\-libc/avr\-libc\-user\-manual/mem_sections.html#sec_dot_init\*(C'\fR)
قرار می‌دهد تا نیازی به فراخوانی نباشد.
با تنظیم این گزینه، کاربر تضمین می‌کند که \f(CW\*(C`main\*(C'\fR هرگز بازنمی‌گردد.
.Sp
این گزینه می‌تواند برای دستگاه‌هایی با منابع بسیار محدود، جهت
صرفه‌جویی در چند بایت کد و فضای پشته استفاده شود. این قابلیت از
نسخه AVR\-LibC\ v2.3 طبق انتظار کار خواهد کرد (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/1012\*(C'\fR).
در نسخه‌های قدیمی‌تر، هیچ بهبودی در کارایی حاصل نخواهد شد.
.IP \fB\-mno\-interrupts\fR 4
.IX Item "-mno-interrupts"
کد تولیدشده با وقفه‌های سخت‌افزاری سازگار نیست.
اندازه کد کوچک‌تر می‌شود.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
تلاش می‌کند تا در صورت امکان، دستورهای \f(CW\*(C`CALL\*(C'\fR یا \f(CW\*(C`JMP\*(C'\fR را با دستورهای کوتاه‌تر
\&\f(CW\*(C`RCALL\*(C'\fR یا \f(CW\*(C`RJMP\*(C'\fR جایگزین کند.
تنظیم \fB\-mrelax\fR صرفاً گزینه \fB\-\-mlink\-relax\fR را به خط فرمان
اسمبلر و گزینه \fB\-\-relax\fR را به خط فرمان پیونددهنده (linker)
اضافه می‌کند.
.Sp
تعدیل پرش‌ها (Jump relaxing) توسط پیونددهنده انجام می‌شود، زیرا آفست‌های پرش پیش
از جای‌گذاری کد مشخص نیستند. بنابراین، کد اسمبلی تولیدشده توسط کامپایلر
یکسان است، اما ممکن است دستورالعمل‌های موجود در فایل اجرایی
با دستورالعمل‌های موجود در کد اسمبلی متفاوت باشند.
.Sp
در صورت نیاز به استاب‌های پیونددهنده (linker stubs)، باید relaxing فعال باشد؛
بخش مربوط به \f(CW\*(C`EIND\*(C'\fR و استاب‌های پیونددهنده را در زیر ببینید.
.IP \fB\-mpmem\-wrap\-around\fR 4
.IX Item "-mpmem-wrap-around"
چرخش شمارنده برنامه (program counter wrap\-around) را در بهینه‌سازی پیونددهنده فعال می‌کند.
.IP \fB\-mrodata\-in\-ram\fR 4
.IX Item "-mrodata-in-ram"
.PD 0
.IP \fB\-mno\-rodata\-in\-ram\fR 4
.IX Item "-mno-rodata-in-ram"
.PD
بخش‌های \f(CW\*(C`.rodata\*(C'\fR را برای داده‌های فقط‌خواندنی به ترتیب در RAM یا
در حافظه برنامه قرار می‌دهد.
برای بیشتر دستگاه‌ها انتخابی وجود ندارد و این گزینه بیشتر شبیه به
یک اعلان قطعی (assertion) عمل می‌کند.
.Sp
از نسخه 14 و برای دستگاه‌های AVR64* و AVR128*، بخش \f(CW\*(C`.rodata\*(C'\fR
به‌طور پیش‌فرض در حافظه فلش قرار می‌گیرد، به شرط آنکه پشتیبانی مورد نیاز در GNU Binutils
(PR31124 (\f(CW\*(C`https://sourceware.org/PR31124\*(C'\fR)) در دسترس باشد.
در آن حالت، می‌توان از \fB\-mrodata\-in\-ram\fR برای بازگشت به چیدمان قدیمی
با قرار دادن \f(CW\*(C`.rodata\*(C'\fR در RAM استفاده کرد.
.IP \fB\-mtiny\-stack\fR 4
.IX Item "-mtiny-stack"
تنها ۸ بیت پایینی اشاره‌گر پشته را تغییر می‌دهد.
.IP \fB\-mfract\-convert\-truncate\fR 4
.IX Item "-mfract-convert-truncate"
اجازه می‌دهد تا برای نوع‌های ممیزثابت کسری، به جای گرد کردن به سمت صفر از برش (truncation) استفاده شود.
.IP \fB\-nodevicelib\fR 4
.IX Item "-nodevicelib"
با کتابخانه اختصاصی دستگاه در AVR\-LibC یعنی \f(CW\*(C`lib\fR\f(CImcu\fR\f(CW.a\*(C'\fR پیوند برقرار نمی‌کند.
.Sp
توجه داشته باشید که از نسخه AVR\-LibC v2.3، این کتابخانه شامل کدهایی است
که برای عملکرد صحیح برنامه ضروری هستند. به‌ویژه،
شامل بخش‌هایی از کد راه‌اندازی (startup code) مانند موارد زیر است:
\&\f(CW\*(C`_\|_init_sp\*(C'\fR (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/1011\*(C'\fR)
برای مقداردهی اولیه اشاره‌گر پشته با نماد \f(CW\*(C`_\|_stack\*(C'\fR،
\&\f(CW\*(C`_\|_init_cvt\*(C'\fR (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/1010\*(C'\fR)
برای آماده‌سازی سخت‌افزار جهت استفاده از جدول بردار فشرده با \fB\-mcvt\fR،
\&\f(CW\*(C`_\|_call_main\*(C'\fR (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/1012\*(C'\fR)
برای فراخوانی \f(CW\*(C`main\*(C'\fR و \f(CW\*(C`exit\*(C'\fR، و
\&\f(CW\*(C`_\|_do_flmap_init\*(C'\fR (\f(CW\*(C`https://github.com/avrdudes/avr\-libc/issues/931\*(C'\fR)
برای تنظیم FLMAP بر اساس نماد \f(CW\*(C`_\|_flmap\*(C'\fR.
.IP \fB\-nodevicespecs\fR 4
.IX Item "-nodevicespecs"
مقدار \fB\-specs=device\-specs/specs\-\fR\fImcu\fR را به خط فرمان
راه‌انداز کامپایلر اضافه نمی‌کند. کاربر مسئولیت تأمین گزینه‌های مناسب خط فرمان
برای زیرپردازش‌هایی مانند کامپایلر اصلی، اسمبلر و پیونددهنده را بر عهده می‌گیرد.
این بدان معناست که کاربر باید فایل مشخصات اختصاصی دستگاه خود را از طریق
\&\fB\-specs=\fR\fIpath\-to\-specs\-file\fR ارائه دهد. در این صورت دیگر
نیازی به گزینه \fB\-mmcu=\fR\fImcu\fR نخواهد بود.
.Sp
این گزینه همچنین می‌تواند به‌عنوان جایگزینی برای روش قدیمی‌تر تعیین فایل‌های سفارشی device-specs
به کار رود؛ روشی که در آن نیاز بود \fB\-B\fR \fIsome\-path\fR به دایرکتوری‌ای اشاره کند
که حاوی پوشه‌ای به نام \f(CW\*(C`device\-specs\*(C'\fR بود که آن هم شامل فایل مشخصاتی به نام
\&\f(CW\*(C`specs\-\fR\f(CImcu\fR\f(CW\*(C'\fR می‌شد، جایی که \fImcu\fR توسط \fB\-mmcu=\fR\fImcu\fR تعیین شده بود.
.IP \fB\-Waddr\-space\-convert\fR 4
.IX Item "-Waddr-space-convert"
در مواردی که فضای آدرس حاصل در فضای آدرس مبدأ گنجانده نشده باشد،
درباره تبدیل‌های بین فضاهای آدرس هشدار می‌دهد.
.IP \fB\-Wmisspelled\-isr\fR 4
.IX Item "-Wmisspelled-isr"
در صورتی که نام ISR اشتباه نوشته شده باشد (یعنی بدون پیشوند _\|_vector باشد) هشدار می‌دهد.
به‌طور پیش‌فرض فعال است.
.PP
گزینه‌های بهینه‌سازی AVR (AVR Optimization Options)
.IX Subsection "AVR Optimization Options"
.PP
گزینه‌های زیر، گزینه‌های بهینه‌سازی خالص هستند.
گزینه‌های \fB\-mgas\-isr\-prologues\fR، \fB\-mmain\-is\-OS_task\fR،
\&\fB\-mno\-call\-main\fR و \fB\-mrelax\fR که در بالا آمدند، تنها
\&\fIتقریباً\fR گزینه بهینه‌سازی محسوب می‌شوند، زیرا موارد نادری وجود دارد
که در آن‌ها تفاوت در کد تولیدشده اهمیت پیدا می‌کند.
.IP \fB\-maccumulate\-args\fR 4
.IX Item "-maccumulate-args"
آرگومان‌های خروجی تابع را انباشته کرده و فضای پشته مورد نیاز برای آرگومان‌های
خروجی تابع را یک‌بار در مقدمه/پایان‌بخش (prologue/epilogue) تابع تخصیص داده/آزاد می‌کند.
بدون این گزینه، آرگومان‌های خروجی پیش از فراخوانی تابع روی پشته قرار گرفته (push)
و پس از آن برداشته می‌شوند (pop).
همچنین گزینه بهینه‌سازی \fB\-fdefer\-pop\fR را ببینید:
\&\fBOptimize Options,,optimization option\fR.
.Sp
برداشتن آرگومان‌ها از پشته پس از فراخوانی تابع در AVR می‌تواند پرهزینه باشد،
بنابراین انباشته کردن فضای پشته ممکن است منجر به فایل‌های اجرایی کوچک‌تر شود،
زیرا نیازی به حذف آرگومان‌ها از پشته پس از چنین فراخوانی‌هایی نخواهد بود.
.Sp
این گزینه می‌تواند حجم کد را برای توابعی که چندین بار توابعی با
آرگومان‌های روی پشته را فراخوانی می‌کنند (مانند توابع شبیه به printf)، کاهش دهد.
.IP \fB\-mbranch\-cost=\fR\fIcost\fR 4
.IX Item "-mbranch-cost=cost"
هزینه انشعاب را برای دستورالعمل‌های انشعاب شرطی روی
\&\fIcost\fR تنظیم می‌کند. مقادیر معقول برای \fIcost\fR اعداد صحیح، کوچک و
غیرمنفی هستند. هزینه پیش‌فرض انشعاب 0 است.
.IP \fB\-mcall\-prologues\fR 4
.IX Item "-mcall-prologues"
مقدمه‌ها و پایان‌بخش‌های توابع به‌صورت فراخوانی زیرروال‌های مناسب بسط داده می‌شوند.
اندازه کد کوچک‌تر می‌شود.
.IP \fB\-mfuse\-add\fR 4
.IX Item "-mfuse-add"
.PD 0
.IP \fB\-mno\-fuse\-add\fR 4
.IX Item "-mno-fuse-add"
.IP \fB\-mfuse\-add=\fR\fIlevel\fR 4
.IX Item "-mfuse-add=level"
.PD
دسترسی‌های غیرمستقیم به حافظه را در دستگاه‌های کوچک‌شده Tiny بهینه‌سازی می‌کند.
حالت پیش‌فرض برای بهینه‌سازی‌های \fB\-Og\fR و \fB\-O1\fR از مقدار \f(CW\*(C`\fR\f(CIlevel\fR\f(CW=1\*(C'\fR
و برای بهینه‌سازی‌های بالاتر از مقدار \f(CW\*(C`\fR\f(CIlevel\fR\f(CW=2\*(C'\fR استفاده می‌کند.
مقادیر معتبر برای \fIlevel\fR عبارتند از \f(CW0\fR، \f(CW1\fR و \f(CW2\fR.
.IP \fB\-mfuse\-move\fR 4
.IX Item "-mfuse-move"
.PD 0
.IP \fB\-mno\-fuse\-move\fR 4
.IX Item "-mno-fuse-move".IP \fB\-mfuse\-move=\fR\fIlevel\fR 4
.IX Item "-mfuse-move=level"
.PD
اجرای یک مرحله بهینه‌سازی پس از بارگذاری مجدد (post reload) که تلاش می‌کند دستورالعمل‌های انتقال (move) را ادغام کرده و دستورالعمل‌های چندبایتی را به عملیات‌های ۸ بیتی تقسیم کند.
حالت پیش‌فرض برای بهینه‌سازی \fB\-O1\fR مقدار \f(CW\*(C`\fR\f(CIlevel\fR\f(CW=3\*(C'\fR، و برای سطوح بهینه‌سازی بالاتر مقدار \f(CW\*(C`\fR\f(CIlevel\fR\f(CW=23\*(C'\fR را استفاده می‌کند.
مقادیر معتبر برای \fIlevel\fR در بازه \f(CW0\fR ... \f(CW23\fR قرار دارند که یک مقدار مبنای مختلط (mixed radix) 3:2:2:2 است. هر رقم جنبه‌ای از بهینه‌سازی را کنترل می‌کند.
.IP \fB\-mfuse\-move2\fR 4
.IX Item "-mfuse-move2"
اجرای یک مرحله بهینه‌سازی پس از ترکیب (post combine) که تلاش می‌کند دستورالعمل‌های انتقال (move) را ادغام کند.
.IP \fB\-mstrict\-X\fR 4
.IX Item "-mstrict-X"
استفاده از ثبات آدرس‌دهی \f(CW\*(C`X\*(C'\fR به روشی که توسط سخت‌افزار پیشنهاد شده است. بدین معنی که از \f(CW\*(C`X\*(C'\fR تنها در آدرس‌دهی غیرمستقیم، پس‌افزایشی (post\-increment) یا پیش‌کاهشی (pre\-decrement) استفاده می‌شود.
.Sp
بدون این گزینه، ثبات \f(CW\*(C`X\*(C'\fR ممکن است به همان شیوهٔ \f(CW\*(C`Y\*(C'\fR یا \f(CW\*(C`Z\*(C'\fR استفاده شود که در این حالت با دستورالعمل‌های اضافی شبیه‌سازی خواهد شد.
به‌عنوان مثال، بارگذاری یک مقدار با آدرس‌دهی \f(CW\*(C`X+const\*(C'\fR با مقدار نامنفی و کوچک \f(CW\*(C`const < 64\*(C'\fR در ثبات \fIRn\fR به‌صورت زیر انجام می‌شود:
.Sp
.Vb 3
\&        adiw r26, const   ; X += const
\&        ld   <Rn>, X        ; <Rn> = *X
\&        sbiw r26, const   ; X \-= const
.Ve
.IP \fB\-msplit\-bit\-shift\fR 4
.IX Item "-msplit-bit-shift"
تقسیم شیفت‌های چندبایتی با آفست ثابت به یک شیفت با آفست بایتی و یک شیفت باقیمانده با آفست غیربایتی.
این بهینه‌سازی به‌طور پیش‌فرض برای \fB\-O2\fR و بالاتر، شامل \fB\-Os\fR اما به‌جز \fB\-Oz\fR، فعال است.
تقسیم شیفت‌ها با آفست ثابتی که مضربی از ۸ باشد توسط \fB\-mfuse\-move\fR کنترل می‌شود.
.IP \fB\-msplit\-ldst\fR 4
.IX Item "-msplit-ldst"
تقسیم بارگذاری‌ها و ذخیره‌سازی‌های چندبایتی به چندین بارگذاری و ذخیره‌سازی تک‌بایتی.
این بهینه‌سازی به‌طور پیش‌فرض برای \fB\-O2\fR و بالاتر فعال است.
.IP \fB\-muse\-nonzero\-bits\fR 4
.IX Item "-muse-nonzero-bits"
فعال‌سازی بهینه‌سازی‌هایی که تنها زمانی امکان‌پذیرند که برخی بیت‌ها در یک ثبات همواره صفر باشند.
این بهینه‌سازی به‌طور پیش‌فرض برای \fB\-O2\fR و بالاتر فعال است.
.PP
\f(CW\*(C`EIND\*(C'\fR و دستگاه‌هایی با بیش از ۱۲۸ کیبی‌بایت فلش
.IX Subsection "EIND and Devices with More Than 128 Ki Bytes of Flash"
.PP
اشاره‌گرها در این پیاده‌سازی ۱۶ بیتی هستند.
آدرس یک تابع یا برچسب به‌صورت آدرس کلمه‌ای (word address) نمایش داده می‌شود تا پرش‌ها و فراخوانی‌های غیرمستقیم بتوانند به هر آدرس کدی در محدوده ۶۴ کیبی‌کلمه هدف‌گیری کنند.
.PP
به‌منظور تسهیل پرش‌های غیرمستقیم در دستگاه‌هایی با بیش از ۱۲۸ کیبی‌بایت فضای حافظه برنامه، یک ثبات با کاربرد خاص به نام \f(CW\*(C`EIND\*(C'\fR وجود دارد که هنگام استفاده از دستورالعمل‌های \f(CW\*(C`EICALL\*(C'\fR یا \f(CW\*(C`EIJMP\*(C'\fR به‌عنوان پرارزش‌ترین بخش آدرس هدف عمل می‌کند.
.PP
پرش‌ها و فراخوانی‌های غیرمستقیم در این دستگاه‌ها توسط کامپایلر به‌صورت زیر مدیریت می‌شوند و مشمول برخی محدودیت‌ها هستند:
.IP * 4
کامپایلر هرگز \f(CW\*(C`EIND\*(C'\fR را مقداردهی نمی‌کند.
.IP * 4
کامپایلر از \f(CW\*(C`EIND\*(C'\fR به‌طور ضمنی در دستورالعمل‌های \f(CW\*(C`EICALL\*(C'\fR/\f(CW\*(C`EIJMP\*(C'\fR استفاده می‌کند، یا ممکن است \f(CW\*(C`EIND\*(C'\fR را مستقیماً بخواند تا یک فراخوانی/پرش غیرمستقیم را با استفاده از دستورالعمل \f(CW\*(C`RET\*(C'\fR شبیه‌سازی کند.
.IP * 4
کامپایلر فرض می‌کند که \f(CW\*(C`EIND\*(C'\fR هرگز در حین اجرای کد راه‌اندازی یا در طول برنامه تغییر نمی‌کند. به‌ویژه، \f(CW\*(C`EIND\*(C'\fR در مقدمه/پایان (prologue/epilogue) توابع یا روتین‌های سرویس وقفه ذخیره یا بازیابی نمی‌شود.
.IP * 4
برای فراخوانی‌های غیرمستقیم به توابع و gotoهای محاسبه‌شده (computed goto)، پیونددهنده قطعه‌کدهای واسط (\fIstub\fR) تولید می‌کند. استاب‌ها سکوهای پرش هستند که گاهی ترامپولین (\fItrampoline\fR) نیز نامیده می‌شوند. بنابراین، فراخوانی/پرش غیرمستقیم به چنین استابی می‌پرد. استاب حاوی یک پرش مستقیم به آدرس مد نظر است.
.IP * 4
بهینه‌سازی relaxation پیونددهنده باید فعال باشد تا پیونددهنده بتواند در تمام شرایط استاب‌ها را به‌درستی ایجاد کند. گزینه کامپایلر \fB\-mrelax\fR و گزینه پیونددهنده \fB\-\-relax\fR را ببینید. موارد خاصی وجود دارد که پیونددهنده قرار است استاب تولید کند اما در صورت فعال نبودن relaxation، بدون ارائه پیام خطای مفید متوقف می‌شود.
.IP * 4
اسکریپت پیش‌فرض پیونددهنده برای کدهایی با \f(CW\*(C`EIND = 0\*(C'\fR تنظیم شده است. اگر قرار باشد کد در شرایطی با \f(CW\*(C`EIND != 0\*(C'\fR کار کند، باید از یک اسکریپت پیونددهنده سفارشی استفاده شود تا بخش‌هایی که نام آن‌ها با \f(CW\*(C`.trampolines\*(C'\fR آغاز می‌شود در قطعه‌ای قرار گیرند که \f(CW\*(C`EIND\*(C'\fR به آن اشاره می‌کند.
.IP * 4
کد راه‌اندازی libgcc هرگز \f(CW\*(C`EIND\*(C'\fR را تنظیم نمی‌کند. توجه داشته باشید که کد راه‌اندازی ترکیبی از کدهای libgcc و AVR\-LibC است. برای بررسی تأثیر AVR\-LibC بر روی \f(CW\*(C`EIND\*(C'\fR، راهنمای کاربری AVR\-LibC را ببینید (\f(CW\*(C`https://avrdudes.github.io/avr\-libc/avr\-libc\-user\-manual\*(C'\fR).
.IP * 4
برای کدهای راه‌اندازی اختصاصی کاربر مجاز است که \f(CW\*(C`EIND\*(C'\fR را زودتر مقداردهی کنند، به‌عنوان مثال با استفاده از کد مقداردهی اولیه که در بخش \f(CW\*(C`.init3\*(C'\fR قرار دارد. این کد پیش از کدهای عمومی راه‌اندازی که RAM را مقداردهی اولیه کرده و سازنده‌ها را فراخوانی می‌کنند اجرا می‌شود، اما بعد از بخشی از کد راه‌اندازی AVR\-LibC اجرا خواهد شد که \f(CW\*(C`EIND\*(C'\fR را روی قطعه‌ای تنظیم می‌کند که جدول بردار در آن واقع شده است.
.Sp
.Vb 1
\&        #include <avr/io.h>
\&        
\&        static void
\&        _\|_attribute_\|_((section(".init3"),naked,used,no_instrument_function))
\&        init3_set_eind (void)
\&        {
\&          _\|_asm volatile ("ldi r24,pm_hh8(_\|_trampolines_start)\en\et"
\&                          "out %i0,r24" :: "n" (&EIND) : "r24","memory");
\&        }
.Ve
.Sp
نماد \f(CW\*(C`_\|_trampolines_start\*(C'\fR در اسکریپت پیونددهنده تعریف شده است.
.IP * 4
استاب‌ها در صورتی به‌طور خودکار توسط پیونددهنده تولید می‌شوند که دو شرط زیر برقرار باشند:
.RS 4
.ie n .IP "\-<آدرس یک برچسب با استفاده از اصلاح‌گر ""gs"" گرفته شده باشد>" 4
.el .IP "\-<آدرس یک برچسب با استفاده از اصلاح‌گر \f(CWgs\fR گرفته شده باشد>" 4
.IX Item "-<The address of a label is taken by means of the gs modifier>"
(کوتاه‌شدهٔ \fIgenerate stubs\fR) مانند:
.Sp
.Vb 2
\&        LDI r24, lo8(gs(<func>))
\&        LDI r25, hi8(gs(<func>))
.Ve
.IP "\-<مکان نهایی آن برچسب در یک قطعه کد باشد>" 4
.IX Item "-<The final location of that label is in a code segment>"
\&\fIخارج\fR از قطعه‌ای که استاب‌ها در آن قرار دارند.
.RE
.RS 4
.RE
.IP * 4
کامپایلر چنین اصلاح‌گرهای \f(CW\*(C`gs\*(C'\fR را برای برچسب‌های کد در موقعیت‌های زیر صادر می‌کند:
.RS 4
.IP "\-<گرفتن آدرس یک تابع یا برچسب کد.>" 4
.IX Item "-<Taking address of a function or code label.>"
.PD 0
.IP "\-<دستورات gotoی محاسبه‌شده (Computed goto).>" 4
.IX Item "-<Computed goto.>"
.IP "\-<اگر از تابع prologue\-save استفاده شده باشد؛ به گزینه خط فرمان \fB\-mcall\-prologues\fR>" 4
.IX Item "-<If prologue-save function is used, see -mcall-prologues>"
.PD
مراجعه کنید.
.IP "\-<جدول‌های توزیع switch/case. اگر چنین جدول‌های توزیعی را نمی‌خواهید،>" 4
.IX Item "-<Switch/case dispatch tables. If you do not want such dispatch>"
می‌توانید گزینه خط فرمان \fB\-fno\-jump\-tables\fR را مشخص کنید.
.IP "\-<سازنده‌ها/ویرانگرهای C و C++‎ که در زمان راه‌اندازی/خاموشی فراخوانی می‌شوند.>" 4
.IX Item "-<C and C++ constructors/destructors called during startup/shutdown.>"
.PD 0
.ie n .IP "\-<اگر ابزارها با یک اصلاح‌گر ()gs که در بالا توضیح داده شد برخورد کنند.>" 4
.el .IP "\-<اگر ابزارها با یک اصلاح‌گر \f(CWgs()\fR که در بالا توضیح داده شد برخورد کنند.>" 4
.IX Item "-<If the tools hit a gs() modifier explained above.>"
.PD
.RE
.RS 4
.RE
.IP * 4
پرش به آدرس‌های غیرنمادین به‌صورت زیر پشتیبانی \fIنمی‌شود\fR:
.Sp
.Vb 5
\&        int main (void)
\&        {
\&            /* Call function at word address 0x2 */
\&            return ((int(*)(void)) 0x2)();
\&        }
.Ve
.Sp
در عوض، باید یک استاب تنظیم شود، یعنی تابع باید از طریق یک نماد (\f(CW\*(C`func_4\*(C'\fR در این مثال) فراخوانی گردد:
.Sp
.Vb 3
\&        int main (void)
\&        {
\&            extern int func_4 (void);
\&        
\&            /* Call function at byte address 0x4 */
\&            return func_4();
\&        }
.Ve
.Sp
و برنامه با \fB\-Wl,\-\-defsym,func_4=0x4\fR پیوند داده شود.
همچنین می‌توان \f(CW\*(C`func_4\*(C'\fR را در اسکریپت پیونددهنده تعریف کرد..PP
مدیریت ثبات‌های با کاربرد خاص \f(CW\*(C`RAMPD\*(C'\fR، \f(CW\*(C`RAMPX\*(C'\fR، \f(CW\*(C`RAMPY\*(C'\fR و \f(CW\*(C`RAMPZ\*(C'\fR
.IX Subsection "Handling of the RAMPD, RAMPX, RAMPY and RAMPZ Special Function Registers"
.PP
برخی از دستگاه‌های AVR از حافظه‌هایی بزرگ‌تر از محدودهٔ 64 KiB که با اشاره‌گرهای ۱۶ بیتی قابل دسترسی هستند، پشتیبانی می‌کنند. برای دسترسی به مکان‌های حافظه در خارج از این محدودهٔ 64 KiB، محتوای یک ثبات \f(CW\*(C`RAMP\*(C'\fR به‌عنوان بخش بالایی آدرس استفاده می‌شود:
ثبات‌های آدرس \f(CW\*(C`X\*(C'\fR، \f(CW\*(C`Y\*(C'\fR، \f(CW\*(C`Z\*(C'\fR به ترتیب با ثبات‌های با کاربرد خاص \f(CW\*(C`RAMPX\*(C'\fR، \f(CW\*(C`RAMPY\*(C'\fR، \f(CW\*(C`RAMPZ\*(C'\fR الحاق می‌شوند تا یک آدرس عریض به دست آید. به طور مشابه، \&\f(CW\*(C`RAMPD\*(C'\fR همراه با آدرس‌دهی مستقیم استفاده می‌شود.
.IP * 4
کد راه‌اندازی، ثبات‌های با کاربرد خاص \f(CW\*(C`RAMP\*(C'\fR را با صفر مقداردهی اولیه می‌کند.
.IP * 4
اگر از یک \fBAVR Named Address Spaces,فضای آدرس نام‌گذاری‌شده\fR غیر از generic یا \f(CW\*(C`_\|_flash\*(C'\fR استفاده شود، آن‌گاه \f(CW\*(C`RAMPZ\*(C'\fR در صورت نیاز پیش از عملیات تنظیم می‌شود.
.IP * 4
اگر دستگاه از RAM بزرگ‌تر از 64 KiB پشتیبانی کند و کامپایلر برای انجام عملیاتی نیاز به تغییر \f(CW\*(C`RAMPZ\*(C'\fR داشته باشد، \f(CW\*(C`RAMPZ\*(C'\fR پس از پایان عملیات به صفر بازنشانی می‌شود.
.IP * 4
اگر دستگاه دارای یک ثبات \f(CW\*(C`RAMP\*(C'\fR مشخص باشد، پرولوگ/اپیلوگ روتین وقفه (ISR) آن SFR را ذخیره/بازیابی کرده و آن را با صفر مقداردهی اولیه می‌کند تا در صورتی که کد ISR (به طور ضمنی) از آن استفاده کند، آماده باشد.
.IP * 4
حافظهٔ RAM بزرگ‌تر از 64 KiB توسط GCC برای اهداف AVR پشتیبانی نمی‌شود. اگر از اسمبلی درون‌خطی (inline assembler) برای خواندن از مکان‌هایی خارج از محدودهٔ آدرس‌دهی ۱۶ بیتی استفاده کرده و یکی از ثبات‌های \f(CW\*(C`RAMP\*(C'\fR را تغییر می‌دهید، باید پس از دسترسی دوباره آن را به صفر بازنشانی کنید.
.PP
ماکروهای توکار AVR
.IX Subsection "AVR Built-in Macros"
.PP
کامپایلر GCC چندین ماکروی توکار را تعریف می‌کند تا کد کاربر بتواند وجود یا عدم وجود قابلیت‌ها را بیازماید. تقریباً تمام ماکروهای توکار زیر از قابلیت‌های دستگاه استنتاج شده و بنابراین با گزینهٔ خط فرمانی \fB\-mmcu=\fR فعال می‌شوند.
.PP
برای ماکروهای توکار اختصاصی AVR بیشتر، به \&\fBAVR Named Address Spaces\fR و \fBAVR Built\-in Functions\fR مراجعه کنید.
.ie n .IP """_\|_AVR_ARCH_\|_""" 4
.el .IP \f(CW_\|_AVR_ARCH_\|_\fR 4
.IX Item "__AVR_ARCH__"
ماکروی توکاری که به یک عدد ده‌دهی مشخص‌کنندهٔ معماری بسط می‌یابد و به گزینهٔ \fB\-mmcu=\fR\fImcu\fR بستگی دارد. مقادیر ممکن عبارتند از:
.Sp
\&\f(CW2\fR, \f(CW25\fR, \f(CW3\fR, \f(CW31\fR, \f(CW35\fR,
\&\f(CW4\fR, \f(CW5\fR, \f(CW51\fR, \f(CW6\fR
.Sp
برای \fImcu\fR=\f(CW\*(C`avr2\*(C'\fR, \f(CW\*(C`avr25\*(C'\fR, \f(CW\*(C`avr3\*(C'\fR, \f(CW\*(C`avr31\*(C'\fR,
\&\f(CW\*(C`avr35\*(C'\fR, \f(CW\*(C`avr4\*(C'\fR, \f(CW\*(C`avr5\*(C'\fR, \f(CW\*(C`avr51\*(C'\fR, \f(CW\*(C`avr6\*(C'\fR,
.Sp
به ترتیب و
.Sp
\&\f(CW100\fR,
\&\f(CW102\fR, \f(CW103\fR, \f(CW104\fR,
\&\f(CW105\fR, \f(CW106\fR, \f(CW107\fR
.Sp
به ترتیب برای \fImcu\fR=\f(CW\*(C`avrtiny\*(C'\fR,
\&\f(CW\*(C`avrxmega2\*(C'\fR, \f(CW\*(C`avrxmega3\*(C'\fR, \f(CW\*(C`avrxmega4\*(C'\fR,
\&\f(CW\*(C`avrxmega5\*(C'\fR, \f(CW\*(C`avrxmega6\*(C'\fR, \f(CW\*(C`avrxmega7\*(C'\fR.
اگر \fImcu\fR یک دستگاه را تعیین کند، این ماکروی توکار متناسب با آن مقداردهی می‌شود. برای نمونه، با \fB\-mmcu=atmega8\fR این ماکرو برابر با \f(CW4\fR تعریف می‌شود.
.ie n .IP """_\|_AVR_\fIDevice\fR_\|_""" 4
.el .IP \f(CW_\|_AVR_\fR\f(CIDevice\fR\f(CW_\|_\fR 4
.IX Item "__AVR_Device__"
تنظیم \fB\-mmcu=\fR\fIdevice\fR این ماکروی توکار را تعریف می‌کند که نمایانگر نام دستگاه است. برای نمونه، \fB\-mmcu=atmega8\fR ماکروی توکار \f(CW\*(C`_\|_AVR_ATmega8_\|_\*(C'\fR و \fB\-mmcu=attiny261a\fR ماکروی \&\f(CW\*(C`_\|_AVR_ATtiny261A_\|_\*(C'\fR را تعریف می‌کند، و غیره.
.Sp
نام‌های ماکروهای توکار از الگوی \f(CW\*(C`_\|_AVR_\fR\f(CIDevice\fR\f(CW_\|_\*(C'\fR پیروی می‌کنند که در آن \fIDevice\fR همان نام دستگاه طبق راهنمای کاربر AVR است. تفاوت بین \&\fIDevice\fR در ماکروی توکار و \fIdevice\fR در \&\fB\-mmcu=\fR\fIdevice\fR در این است که دومی همیشه با حروف کوچک نوشته می‌شود.
.Sp
اگر \fIdevice\fR یک دستگاه نبوده بلکه تنها یک معماری هسته مانند \&\fBavr51\fR باشد، این ماکرو تعریف نمی‌شود.
.ie n .IP """_\|_AVR_DEVICE_NAME_\|_""" 4
.el .IP \f(CW_\|_AVR_DEVICE_NAME_\|_\fR 4
.IX Item "__AVR_DEVICE_NAME__"
تنظیم \fB\-mmcu=\fR\fIdevice\fR این ماکروی توکار را برابر با نام دستگاه تعیین می‌کند. برای نمونه، با \fB\-mmcu=atmega8\fR این ماکرو برابر با \f(CW\*(C`atmega8\*(C'\fR تعریف می‌شود.
.Sp
اگر \fIdevice\fR یک دستگاه نبوده بلکه تنها یک معماری هسته مانند \&\fBavr51\fR باشد، این ماکرو تعریف نمی‌شود.
.ie n .IP """_\|_AVR_CVT_\|_""" 4
.el .IP \f(CW_\|_AVR_CVT_\|_\fR 4
.IX Item "__AVR_CVT__"
کد با گزینهٔ \f(CW\*(C`\-mcvt\*(C'\fR برای استفاده از یک \&\fIcompact vector table\fR (جدول بردار فشرده) کامپایل می‌شود.
.ie n .IP """_\|_AVR_XMEGA_\|_""" 4
.el .IP \f(CW_\|_AVR_XMEGA_\|_\fR 4
.IX Item "__AVR_XMEGA__"
دستگاه / معماری متعلق به خانوادهٔ دستگاه‌های XMEGA است.
.ie n .IP """_\|_AVR_HAVE_ADIW_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_ADIW_\|_\fR 4
.IX Item "__AVR_HAVE_ADIW__"
دستگاه دارای دستورالعمل‌های \f(CW\*(C`ADIW\*(C'\fR و \f(CW\*(C`SBIW\*(C'\fR است.
.ie n .IP """_\|_AVR_HAVE_ELPM_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_ELPM_\|_\fR 4
.IX Item "__AVR_HAVE_ELPM__"
دستگاه دارای دستورالعمل \f(CW\*(C`ELPM\*(C'\fR است.
.ie n .IP """_\|_AVR_HAVE_ELPMX_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_ELPMX_\|_\fR 4
.IX Item "__AVR_HAVE_ELPMX__"
دستگاه دارای دستورالعمل‌های \f(CW\*(C`ELPM R\fR\f(CIn\fR\f(CW,Z\*(C'\fR و \f(CW\*(C`ELPM
R\fR\f(CIn\fR\f(CW,Z+\*(C'\fR است.
.ie n .IP """_\|_AVR_HAVE_LPMX_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_LPMX_\|_\fR 4
.IX Item "__AVR_HAVE_LPMX__"
دستگاه دارای دستورالعمل‌های \f(CW\*(C`LPM R\fR\f(CIn\fR\f(CW,Z\*(C'\fR و
\&\f(CW\*(C`LPM R\fR\f(CIn\fR\f(CW,Z+\*(C'\fR است.
.ie n .IP """_\|_AVR_HAVE_MOVW_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_MOVW_\|_\fR 4
.IX Item "__AVR_HAVE_MOVW__"
دستگاه دارای دستورالعمل \f(CW\*(C`MOVW\*(C'\fR برای انجام جابه‌جایی‌های ۱۶ بیتی ثبات به ثبات است.
.ie n .IP """_\|_AVR_HAVE_MUL_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_MUL_\|_\fR 4
.IX Item "__AVR_HAVE_MUL__"
دستگاه دارای یک ضرب‌کنندهٔ سخت‌افزاری است.
.ie n .IP """_\|_AVR_HAVE_JMP_CALL_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_JMP_CALL_\|_\fR 4
.IX Item "__AVR_HAVE_JMP_CALL__"
دستگاه دارای دستورالعمل‌های \f(CW\*(C`JMP\*(C'\fR و \f(CW\*(C`CALL\*(C'\fR است. این مورد برای دستگاه‌هایی با بیش از 8 KiB حافظهٔ برنامه صدق می‌کند.
.ie n .IP """_\|_AVR_HAVE_EIJMP_EICALL_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_EIJMP_EICALL_\|_\fR 4
.IX Item "__AVR_HAVE_EIJMP_EICALL__"
.PD 0
.ie n .IP """_\|_AVR_3_BYTE_PC_\|_""" 4
.el .IP \f(CW_\|_AVR_3_BYTE_PC_\|_\fR 4
.IX Item "__AVR_3_BYTE_PC__"
.PD
دستگاه دارای دستورالعمل‌های \f(CW\*(C`EIJMP\*(C'\fR و \f(CW\*(C`EICALL\*(C'\fR است. این مورد برای دستگاه‌هایی با بیش از 128 KiB حافظهٔ برنامه صادق است. این امر همچنین بدین معناست که شمارندهٔ برنامه (PC) دارای پهنای ۳ بایت است.
.ie n .IP """_\|_AVR_2_BYTE_PC_\|_""" 4
.el .IP \f(CW_\|_AVR_2_BYTE_PC_\|_\fR 4
.IX Item "__AVR_2_BYTE_PC__"
شمارندهٔ برنامه (PC) دارای پهنای ۲ بایت است. این مورد برای دستگاه‌هایی با حداکثر 128 KiB حافظهٔ برنامه صدق می‌کند.
.ie n .IP """_\|_AVR_HAVE_8BIT_SP_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_8BIT_SP_\|_\fR 4
.IX Item "__AVR_HAVE_8BIT_SP__"
.PD 0
.ie n .IP """_\|_AVR_HAVE_16BIT_SP_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_16BIT_SP_\|_\fR 4
.IX Item "__AVR_HAVE_16BIT_SP__"
.PD
ثبات اشاره‌گر پشته (SP) توسط کامپایلر به ترتیب به‌عنوان یک ثبات ۸ بیتی یا ۱۶ بیتی در نظر گرفته می‌شود.
تعریف این ماکروها تحت تأثیر گزینهٔ \fB\-mtiny\-stack\fR قرار دارد.
.ie n .IP """_\|_AVR_HAVE_SPH_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_SPH_\|_\fR 4
.IX Item "__AVR_HAVE_SPH__"
.PD 0
.ie n .IP """_\|_AVR_SP8_\|_""" 4
.el .IP \f(CW_\|_AVR_SP8_\|_\fR 4
.IX Item "__AVR_SP8__"
.PD
دستگاه به ترتیب دارای ثبات با کاربرد خاص SPH (بخش بالایی اشاره‌گر پشته) است یا یک اشاره‌گر پشتهٔ ۸ بیتی دارد.
تعریف این ماکروها تحت تأثیر \fB\-mmcu=\fR و در موارد \fB\-mmcu=avr2\fR و \fB\-mmcu=avr25\fR همچنین تحت تأثیر \fB\-msp8\fR قرار دارد.
.ie n .IP """_\|_AVR_HAVE_RAMPD_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_RAMPD_\|_\fR 4
.IX Item "__AVR_HAVE_RAMPD__"
.PD 0
.ie n .IP """_\|_AVR_HAVE_RAMPX_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_RAMPX_\|_\fR 4
.IX Item "__AVR_HAVE_RAMPX__"
.ie n .IP """_\|_AVR_HAVE_RAMPY_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_RAMPY_\|_\fR 4
.IX Item "__AVR_HAVE_RAMPY__"
.ie n .IP """_\|_AVR_HAVE_RAMPZ_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_RAMPZ_\|_\fR 4
.IX Item "__AVR_HAVE_RAMPZ__".PD
دستگاه به ترتیب دارای ثبات‌های عملکرد ویژه \f(CW\*(C`RAMPD\*(C'\fR، \f(CW\*(C`RAMPX\*(C'\fR، \f(CW\*(C`RAMPY\*(C'\fR
و \&\f(CW\*(C`RAMPZ\*(C'\fR است.
.ie n .IP """_\|_NO_INTERRUPTS_\|_""" 4
.el .IP \f(CW_\|_NO_INTERRUPTS_\|_\fR 4
.IX Item "__NO_INTERRUPTS__"
این ماکرو نشان‌دهنده گزینه خط فرمان \fB\-mno\-interrupts\fR است.
.ie n .IP """_\|_AVR_ERRATA_SKIP_\|_""" 4
.el .IP \f(CW_\|_AVR_ERRATA_SKIP_\|_\fR 4
.IX Item "__AVR_ERRATA_SKIP__"
.PD 0
.ie n .IP """_\|_AVR_ERRATA_SKIP_JMP_CALL_\|_""" 4
.el .IP \f(CW_\|_AVR_ERRATA_SKIP_JMP_CALL_\|_\fR 4
.IX Item "__AVR_ERRATA_SKIP_JMP_CALL__"
.PD
برخی دستگاه‌های AVR (مانند AT90S8515 و ATmega103) نباید به دلیل یک نقص سخت‌افزاری (erratum)
از روی دستورالعمل‌های ۳۲ بیتی پرش کنند. دستورالعمل‌های پرش عبارتند
از \&\f(CW\*(C`SBRS\*(C'\fR، \f(CW\*(C`SBRC\*(C'\fR، \f(CW\*(C`SBIS\*(C'\fR، \f(CW\*(C`SBIC\*(C'\fR و \f(CW\*(C`CPSE\*(C'\fR.
ماکروی دوم تنها زمانی تعریف می‌شود که \f(CW\*(C`_\|_AVR_HAVE_JMP_CALL_\|_\*(C'\fR نیز
تنظیم شده باشد.
.ie n .IP """_\|_AVR_ISA_RMW_\|_""" 4
.el .IP \f(CW_\|_AVR_ISA_RMW_\|_\fR 4
.IX Item "__AVR_ISA_RMW__"
دستگاه دارای دستورالعمل‌های خواندن\-تغییر\-نوشتن (XCH، LAC، LAS و LAT) است.
.ie n .IP """_\|_AVR_SFR_OFFSET_\|_=\fIoffset\fR""" 4
.el .IP \f(CW_\|_AVR_SFR_OFFSET_\|_=\fR\f(CIoffset\fR\f(CW\fR 4
.IX Item "__AVR_SFR_OFFSET__=offset"
دستورالعمل‌هایی که می‌توانند مستقیماً ثبات‌های عملکرد ویژه ورودی/خروجی را
مانند \f(CW\*(C`IN\*(C'\fR، \f(CW\*(C`OUT\*(C'\fR، \f(CW\*(C`SBI\*(C'\fR و غیره آدرس‌دهی کنند، ممکن است از آدرسی متفاوت
نسبت به حالتی که با دستورالعمل دسترسی به RAM مانند \f(CW\*(C`LD\*(C'\fR یا \f(CW\*(C`STS\*(C'\fR آدرس‌دهی
می‌شوند، استفاده نمایند. این آفست به معماری دستگاه بستگی دارد و باید
از آدرس RAM کسر شود تا آدرس I/O مربوطه به دست آید.
.ie n .IP """_\|_AVR_SHORT_CALLS_\|_""" 4
.el .IP \f(CW_\|_AVR_SHORT_CALLS_\|_\fR 4
.IX Item "__AVR_SHORT_CALLS__"
گزینه خط فرمان \fB\-mshort\-calls\fR تنظیم شده است.
.ie n .IP """_\|_AVR_PM_BASE_ADDRESS_\|_=\fIaddr\fR""" 4
.el .IP \f(CW_\|_AVR_PM_BASE_ADDRESS_\|_=\fR\f(CIaddr\fR\f(CW\fR 4
.IX Item "__AVR_PM_BASE_ADDRESS__=addr"
برخی دستگاه‌ها از خواندن از حافظه فلش با استفاده از دستورالعمل‌های \f(CW\*(C`LD*\*(C'\fR
پشتیبانی می‌کنند. حافظه فلش در فضای آدرس داده در یک آفست \f(CW\*(C`_\|_AVR_PM_BASE_ADDRESS_\|_\*(C'\fR
دیده می‌شود. اگر این ماکرو تعریف نشده باشد، این ویژگی در دسترس نخواهد بود. در صورت تعریف شدن،
فضای آدرس خطی است و نیازی به قرار دادن \&\f(CW\*(C`.rodata\*(C'\fR در RAM نیست. این موضوع
توسط فایل توصیف پیونددهنده پیش‌فرض مدیریت می‌شود و در حال حاضر برای
\&\f(CW\*(C`avrtiny\*(C'\fR و \f(CW\*(C`avrxmega3\*(C'\fR در دسترس است. حتی راحت‌تر از آن،
نیازی به استفاده از فضاهای آدرس مانند \f(CW\*(C`_\|_flash\*(C'\fR یا ویژگی‌هایی چون
مشخصه \f(CW\*(C`progmem\*(C'\fR و \f(CW\*(C`pgm_read_*\*(C'\fR نخواهد بود.
.ie n .IP """_\|_AVR_HAVE_FLMAP_\|_""" 4
.el .IP \f(CW_\|_AVR_HAVE_FLMAP_\|_\fR 4
.IX Item "__AVR_HAVE_FLMAP__"
این ماکرو در صورت برقرار بودن شرایط زیر تعریف می‌شود:
.RS 4
.ie n .IP "*<دستگاه دارای فیلد بیتی ""NVMCTRL_CTRLB.FLMAP"" است.>" 4
.el .IP "*<دستگاه دارای فیلد بیتی \f(CWNVMCTRL_CTRLB.FLMAP\fR است.>" 4
.IX Item "*<The device has the NVMCTRL_CTRLB.FLMAP bitfield.>"
این مورد برای دستگاه‌های AVR64* و AVR128* اعمال می‌شود.
.IP "*<در زمان اسمبل مشخص نیست از کدام شبیه‌سازی استفاده خواهد شد.>" 4
.IX Item "*<It's not known at assembler-time which emulation will be used.>"
.RE
.RS 4
.Sp
این بدان معناست که کامپایلر با GNU Binutils که PR31124 (\f(CW\*(C`https://sourceware.org/PR31124\*(C'\fR)
را پیاده‌سازی می‌کند، پیکربندی شده است.
.RE
.ie n .IP """_\|_AVR_RODATA_IN_RAM_\|_""" 4
.el .IP \f(CW_\|_AVR_RODATA_IN_RAM_\|_\fR 4
.IX Item "__AVR_RODATA_IN_RAM__"
این ماکرو هنگامی که کد برای یک معماری پایه کامپایل می‌شود، تعریف‌نشده است.
.Sp
هنگامی که کد برای یک دستگاه کامپایل می‌شود، اگر بخش‌های \f(CW\*(C`.rodata\*(C'\fR برای داده‌های
فقط‌خواندنی در RAM قرار گیرند، این ماکرو برابر ۱ تعریف می‌شود؛ و در غیر این صورت، برابر ۰ تعریف می‌شود.
.ie n .IP """_\|_WITH_AVRLIBC_\|_""" 4
.el .IP \f(CW_\|_WITH_AVRLIBC_\|_\fR 4
.IX Item "__WITH_AVRLIBC__"
کامپایلر برای استفاده به همراه AVR\-LibC پیکربندی شده است.
گزینه پیکربندی \fB\-\-with\-avrlibc\fR را ببینید.
.ie n .IP """_\|_HAVE_SIGNAL_N_\|_""" 4
.el .IP \f(CW_\|_HAVE_SIGNAL_N_\|_\fR 4
.IX Item "__HAVE_SIGNAL_N__"
کامپایلر از \f(CWsignal(\fR\f(CInum\fR\f(CW)\fR و
\&\f(CWinterrupt(\fR\f(CInum\fR\f(CW)\fR
در \&\fBAVR Attributes,,function attributes\fR با آرگومان \fInum\fR
که شماره زیرروال خدمت وقفه را مشخص می‌کند، پشتیبانی می‌نماید.
.ie n .IP """_\|_HAVE_DOUBLE_MULTILIB_\|_""" 4
.el .IP \f(CW_\|_HAVE_DOUBLE_MULTILIB_\|_\fR 4
.IX Item "__HAVE_DOUBLE_MULTILIB__"
در صورتی تعریف می‌شود که \fB\-mdouble=\fR به عنوان یک گزینه multilib عمل کند.
.ie n .IP """_\|_HAVE_DOUBLE32_\|_""" 4
.el .IP \f(CW_\|_HAVE_DOUBLE32_\|_\fR 4
.IX Item "__HAVE_DOUBLE32__"
.PD 0
.ie n .IP """_\|_HAVE_DOUBLE64_\|_""" 4
.el .IP \f(CW_\|_HAVE_DOUBLE64_\|_\fR 4
.IX Item "__HAVE_DOUBLE64__"
.PD
در صورتی تعریف می‌شود که کامپایلر به ترتیب از double ۳۲ بیتی یا ۶۴ بیتی پشتیبانی کند.
ساختار واقعی توسط گزینه \fB\-mdouble=\fR مشخص می‌شود.
.ie n .IP """_\|_DEFAULT_DOUBLE_\|_""" 4
.el .IP \f(CW_\|_DEFAULT_DOUBLE_\|_\fR 4
.IX Item "__DEFAULT_DOUBLE__"
اندازه \f(CW\*(C`double\*(C'\fR بر حسب بیت، در صورتی که \fB\-mdouble=\fR تنظیم نشده باشد.
برای بررسی ساختار \f(CW\*(C`double\*(C'\fR در یک برنامه، از ماکروی داخلی
\f(CW\*(C`_\|_SIZEOF_DOUBLE_\|_\*(C'\fR استفاده کنید.
.ie n .IP """_\|_HAVE_LONG_DOUBLE32_\|_""" 4
.el .IP \f(CW_\|_HAVE_LONG_DOUBLE32_\|_\fR 4
.IX Item "__HAVE_LONG_DOUBLE32__"
.PD 0
.ie n .IP """_\|_HAVE_LONG_DOUBLE64_\|_""" 4
.el .IP \f(CW_\|_HAVE_LONG_DOUBLE64_\|_\fR 4
.IX Item "__HAVE_LONG_DOUBLE64__"
.ie n .IP """_\|_HAVE_LONG_DOUBLE_MULTILIB_\|_""" 4
.el .IP \f(CW_\|_HAVE_LONG_DOUBLE_MULTILIB_\|_\fR 4
.IX Item "__HAVE_LONG_DOUBLE_MULTILIB__"
.ie n .IP """_\|_DEFAULT_LONG_DOUBLE_\|_""" 4
.el .IP \f(CW_\|_DEFAULT_LONG_DOUBLE_\|_\fR 4
.IX Item "__DEFAULT_LONG_DOUBLE__"
.PD
مشابه موارد بالا، اما برای \f(CW\*(C`long double\*(C'\fR به جای \f(CW\*(C`double\*(C'\fR.
.ie n .IP """_\|_WITH_DOUBLE_COMPARISON_\|_""" 4
.el .IP \f(CW_\|_WITH_DOUBLE_COMPARISON_\|_\fR 4
.IX Item "__WITH_DOUBLE_COMPARISON__"
نشان‌دهنده گزینه پیکربندی \f(CW\*(C`\-\-with\-double\-comparison={tristate|bool|libf7}\*(C'\fR
(\f(CW\*(C`https://gcc.gnu.org/install/configure.html#avr\*(C'\fR)
است و برابر با \f(CW2\fR یا \f(CW3\fR تعریف می‌شود.
.ie n .IP """_\|_WITH_LIBF7_LIBGCC_\|_""" 4
.el .IP \f(CW_\|_WITH_LIBF7_LIBGCC_\|_\fR 4
.IX Item "__WITH_LIBF7_LIBGCC__"
.PD 0
.ie n .IP """_\|_WITH_LIBF7_MATH_\|_""" 4
.el .IP \f(CW_\|_WITH_LIBF7_MATH_\|_\fR 4
.IX Item "__WITH_LIBF7_MATH__"
.ie n .IP """_\|_WITH_LIBF7_MATH_SYMBOLS_\|_""" 4
.el .IP \f(CW_\|_WITH_LIBF7_MATH_SYMBOLS_\|_\fR 4
.IX Item "__WITH_LIBF7_MATH_SYMBOLS__"
.PD
نشان‌دهنده گزینه پیکربندی \f(CW\*(C`\-\-with\-libf7={libgcc|math|math\-symbols}\*(C'\fR
(\f(CW\*(C`https://gcc.gnu.org/install/configure.html#avr\*(C'\fR) است.
.PP
گزینه‌های داخلی AVR (AVR Internal Options)
.IX Subsection "AVR Internal Options"
.PP
گزینه‌های زیر به صورت داخلی توسط کامپایلر و برای ارتباط بین فایل‌های مشخصات دستگاه
(device specs) و خود کامپایلر استفاده می‌شوند. نیازی به تنظیم دستی این گزینه‌ها نیست؛
به‌ویژه آنکه این موارد گزینه بهینه‌سازی نیستند. استفاده نادرست از این گزینه‌ها ممکن است
به تولید کدهای غیربهینه یا نادرست منجر شود. این موارد صرفاً جهت کامل بودن مستندات
و برای درک بهتر فایل‌های مشخصات دستگاه
(\f(CW\*(C`https://gcc.gnu.org/wiki/avr\-gcc#spec\-files\*(C'\fR)
مستند شده‌اند.
.IP \fB\-mn\-flash=\fR\fInum\fR 4
.IX Item "-mn-flash=num"
فرض می‌کند که حافظه فلش اندازه‌ای معادل \fInum\fR برابر ۶۴ کیبی‌بایت دارد.
این گزینه تعیین می‌کند کدام فضاهای آدرس \f(CW\*(C`_\|_flash\fR\f(CIN\fR\f(CW\*(C'\fR در دسترس هستند.
.IP \fB\-mflmap\fR 4
.IX Item "-mflmap"
دستگاه دارای فیلد بیتی \f(CW\*(C`FLMAP\*(C'\fR واقع در ثبات عملکرد ویژه
\f(CW\*(C`NVMCTRL_CTRLB\*(C'\fR است.
.IP \fB\-mrmw\fR 4
.IX Item "-mrmw"
فرض می‌کند که دستگاه از دستورالعمل‌های خواندن\-تغییر\-نوشتن
\f(CW\*(C`XCH\*(C'\fR، \f(CW\*(C`LAC\*(C'\fR، \f(CW\*(C`LAS\*(C'\fR و \f(CW\*(C`LAT\*(C'\fR پشتیبانی می‌کند.
.IP \fB\-mshort\-calls\fR 4
.IX Item "-mshort-calls"
فرض می‌کند که \f(CW\*(C`RJMP\*(C'\fR و \f(CW\*(C`RCALL\*(C'\fR می‌توانند کل حافظه برنامه را
هدف قرار دهند. این گزینه برای تولید و انتخاب multilib برای دستگاه‌های
معماری \f(CW\*(C`avrxmega3\*(C'\fR استفاده می‌شود.
.IP \fB\-mskip\-bug\fR 4
.IX Item "-mskip-bug"
تولید کد بدون پرش (\f(CW\*(C`CPSE\*(C'\fR، \f(CW\*(C`SBRS\*(C'\fR،
\&\f(CW\*(C`SBRC\*(C'\fR، \f(CW\*(C`SBIS\*(C'\fR، \f(CW\*(C`SBIC\*(C'\fR) از روی دستورالعمل‌های ۳۲ بیتی.
.IP \fB\-msp8\fR 4
.IX Item "-msp8"
با ثبات اشاره‌گر پشته به عنوان یک ثبات ۸ بیتی رفتار می‌کند؛
یعنی فرض می‌کند بایت بالایی اشاره‌گر پشته صفر است.
این گزینه توسط کامپایلر برای انتخاب و ساخت multilibها برای
معماری‌های \f(CW\*(C`avr2\*(C'\fR و \f(CW\*(C`avr25\*(C'\fR استفاده می‌شود.
این معماری‌ها دستگاه‌های دارای \f(CW\*(C`SPH\*(C'\fR و فاقد آن را ترکیب می‌کنند..PP
\fIگزینه‌های Blackfin\fR
.IX Subsection "گزینه‌های Blackfin"
.IP \fB\-mcpu=\fR\fIcpu\fR[\fB\-\fR\fIsirevision\fR] 4
.IX Item "-mcpu=cpu[-sirevision]"
نام پردازندهٔ Blackfin مقصد را مشخص می‌کند. در حال حاضر، \fIcpu\fR
می‌تواند یکی از موارد \fBbf512\fR، \fBbf514\fR، \fBbf516\fR، \fBbf518\fR،
\&\fBbf522\fR، \fBbf523\fR، \fBbf524\fR، \fBbf525\fR، \fBbf526\fR،
\&\fBbf527\fR، \fBbf531\fR، \fBbf532\fR، \fBbf533\fR،
\&\fBbf534\fR، \fBbf536\fR، \fBbf537\fR، \fBbf538\fR، \fBbf539\fR،
\&\fBbf542\fR، \fBbf544\fR، \fBbf547\fR، \fBbf548\fR، \fBbf549\fR،
\&\fBbf542m\fR، \fBbf544m\fR، \fBbf547m\fR، \fBbf548m\fR، \fBbf549m\fR،
\&\fBbf561\fR، \fBbf592\fR باشد.
.Sp
بخش اختیاری \fIsirevision\fR نسخهٔ بازبینی سیلیکون (silicon revision) پردازندهٔ
Blackfin مقصد را مشخص می‌کند. تمامی راهکارهای دورزدن اشکال سخت‌افزاری (workaround)
موجود برای بازبینی سیلیکونِ هدف فعال می‌شوند. اگر \fIsirevision\fR برابر با \fBnone\fR باشد،
هیچ راهکاری فعال نمی‌شود. اگر \fIsirevision\fR برابر با \fBany\fR باشد، تمامی راهکارها برای
پردازندهٔ هدف فعال خواهند شد. ماکروی \f(CW\*(C`_\|_SILICON_REVISION_\|_\*(C'\fR به صورت دو رقم
هگزادسیمال که نشان‌دهندهٔ شماره‌های اصلی و فرعی در بازبینی سیلیکون هستند تعریف می‌شود.
اگر \fIsirevision\fR برابر با \fBnone\fR باشد، \f(CW\*(C`_\|_SILICON_REVISION_\|_\*(C'\fR تعریف
نمی‌شود. اگر \fIsirevision\fR برابر با \fBany\fR باشد،
\&\f(CW\*(C`_\|_SILICON_REVISION_\|_\*(C'\fR به صورت \f(CW0xffff\fR تعریف می‌گردد.
اگر این \fIsirevision\fR اختیاری استفاده نشود، GCC جدیدترین نسخهٔ بازبینی سیلیکون
شناخته‌شده برای پردازندهٔ Blackfin هدف را در نظر می‌گیرد.
.Sp
کامپایلر GCC یک ماکروی پیش‌پردازنده برای \fIcpu\fR مشخص‌شده تعریف می‌کند.
برای زنجیرهٔ ابزار \fBbfin\-elf\fR، در صورتی که گزینهٔ \fB\-msim\fR داده نشود، این گزینه
موجب پیوند خوردن BSP سخت‌افزاری ارائه‌شده توسط libgloss می‌شود.
.Sp
بدون این گزینه، به‌طور پیش‌فرض \fBbf532\fR به عنوان پردازنده استفاده می‌شود.
.Sp
توجه داشته باشید که پشتیبانی از \fBbf561\fR کامل نیست. برای \fBbf561\fR،
تنها ماکروی پیش‌پردازنده تعریف می‌شود.
.IP \fB\-msim\fR 4
.IX Item "-msim"
مشخص می‌کند که برنامه روی شبیه‌ساز اجرا خواهد شد. این کار باعث پیوند خوردن
BSP شبیه‌ساز ارائه‌شده توسط libgloss می‌شود. این گزینه فقط برای زنجیرهٔ
ابزار \fBbfin\-elf\fR اثرگذار است. برخی گزینه‌های دیگر مانند \fB\-mid\-shared\-library\fR
و \&\fB\-mfdpic\fR، به صورت ضمنی گزینهٔ \fB\-msim\fR را فعال می‌کنند.
.IP \fB\-momit\-leaf\-frame\-pointer\fR 4
.IX Item "-momit-leaf-frame-pointer"
اشاره‌گر چارچوب (frame pointer) را در توابع برگ (leaf functions) در ثبات نگه نمی‌دارد.
این کار از دستورالعمل‌های ذخیره، راه‌اندازی و بازیابی اشاره‌گرهای چارچوب جلوگیری کرده
و یک ثبات اضافی را در توابع برگ در دسترس قرار می‌دهد.
.IP \fB\-mspecld\-anomaly\fR 4
.IX Item "-mspecld-anomaly"
.PD 0
.IP \fB\-mno\-specld\-anomaly\fR 4
.IX Item "-mno-specld-anomaly"
.PD
در صورت فعال بودن، کامپایلر اطمینان حاصل می‌کند که کد تولیدشده شامل بارگذاری‌های
حدسی (speculative loads) پس از دستورالعمل‌های پرش نباشد. اگر از این گزینه استفاده شود،
\&\f(CW\*(C`_\|_WORKAROUND_SPECULATIVE_LOADS\*(C'\fR تعریف می‌شود.
.IP \fB\-mcsync\-anomaly\fR 4
.IX Item "-mcsync-anomaly"
.PD 0
.IP \fB\-mno\-csync\-anomaly\fR 4
.IX Item "-mno-csync-anomaly"
.PD
در صورت فعال بودن، کامپایلر اطمینان حاصل می‌کند که کد تولیدشده شامل دستورالعمل‌های
CSYNC یا SSYNC با فاصلهٔ بسیار کم پس از انشعاب‌های شرطی نباشد.
اگر از این گزینه استفاده شود، \f(CW\*(C`_\|_WORKAROUND_SPECULATIVE_SYNCS\*(C'\fR تعریف می‌شود.
.IP \fB\-mlow64k\fR 4
.IX Item "-mlow64k"
.PD 0
.IP \fB\-mno\-low64k\fR 4
.IX Item "-mno-low64k"
.PD
در صورت فعال بودن، کامپایلر مجاز است از این آگاهی که کل برنامه در 64k پایینی
حافظه جای می‌گیرد، بهره ببرد. رفتار پیش‌فرض این است که فرض شود برنامه
اندازه‌ای نامحدود دارد (\fB\-mno\-low64k\fR).
.IP \fB\-mstack\-check\-l1\fR 4
.IX Item "-mstack-check-l1"
بررسی پشته را با استفاده از اطلاعات قرار داده‌شده در حافظهٔ یادداشت موقت (scratchpad)
L1 توسط هستهٔ uClinux انجام می‌دهد.
.IP \fB\-mid\-shared\-library\fR 4
.IX Item "-mid-shared-library"
.PD 0
.IP \fB\-mno\-id\-shared\-library\fR 4
.IX Item "-mno-id-shared-library"
.PD
کدی تولید می‌کند که از کتابخانه‌های اشتراکی از طریق روش شناسهٔ کتابخانه (library ID)
پشتیبانی می‌کند. این کار امکان «اجرا در جا» (execute in place) و کتابخانه‌های اشتراکی
را در محیطی بدون مدیریت حافظهٔ مجازی فراهم می‌سازد. این گزینه به صورت ضمنی
\fB\-fPIC\fR را فعال می‌کند. در هدف \fBbfin\-elf\fR، این گزینه به صورت ضمنی
\fB\-msim\fR را نیز در بر دارد. حالت پیش‌فرض \fB\-mno\-id\-shared\-library\fR است
تا کدی تولید کند که فرض نمی‌کند کتابخانه‌های اشتراکی مبتنی بر شناسه به کار می‌روند.
.IP \fB\-mleaf\-id\-shared\-library\fR 4
.IX Item "-mleaf-id-shared-library"
.PD 0
.IP \fB\-mno\-leaf\-id\-shared\-library\fR 4
.IX Item "-mno-leaf-id-shared-library"
.PD
کدی تولید می‌کند که از کتابخانه‌های اشتراکی از طریق روش شناسهٔ کتابخانه پشتیبانی می‌کند،
اما فرض را بر این می‌گذارد که این کتابخانه یا فایل اجرایی با هیچ کتابخانهٔ اشتراکیِ
مبتنی بر شناسهٔ دیگری پیوند نخواهد خورد. این امر به کامپایلر اجازه می‌دهد تا از کدهای
سریع‌تری برای پرش‌ها و فراخوانی‌ها استفاده کند.
.Sp
پیش‌فرض \fB\-mno\-leaf\-id\-shared\-library\fR است، که در آن فرضی مبنی بر عدم پیوند
کد در حال کامپایل با کتابخانه‌های اشتراکیِ مبتنی بر شناسه در نظر گرفته نمی‌شود.
در این حالت برای دستورالعمل‌های پرش و فراخوانی کدهای کندتری تولید می‌شود.
.IP \fB\-mshared\-library\-id=n\fR 4
.IX Item "-mshared-library-id=n"
شمارهٔ شناسایی کتابخانهٔ اشتراکیِ مبتنی بر شناسه را که در حال کامپایل است مشخص می‌کند.
تعیین مقدار 0 کد فشرده‌تری تولید می‌کند؛ تعیین مقادیر دیگر تخصیص آن شماره را به کتابخانهٔ
فعلی تحمیل می‌کند اما نسبت به حذف این گزینه، از نظر حافظه یا زمان بهینه‌تر نخواهد بود.
.IP \fB\-msep\-data\fR 4
.IX Item "-msep-data"
.PD 0
.IP \fB\-mno\-sep\-data\fR 4
.IX Item "-mno-sep-data"
.PD
کدی تولید می‌کند که امکان قرارگیری قطعهٔ داده (data segment) را در ناحیه‌ای متفاوت از حافظه
نسبت به قطعهٔ کد (text segment) فراهم می‌آورد. این امر با حذف بازنشانی‌ها (relocations) نسبت
به بخش متن، امکان «اجرا در جا» را در یک محیط بدون مدیریت حافظهٔ مجازی فراهم می‌سازد.
پیش‌فرض \fB\-mno\-sep\-data\fR است که به GCC دستور می‌دهد کدی تولید کند که فرض
می‌کند قطعهٔ داده بلافاصله پس از قطعهٔ کد قرار دارد.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
.PD 0
.IP \fB\-mno\-long\-calls\fR 4
.IX Item "-mno-long-calls"
.PD
به کامپایلر اعلام می‌کند که فراخوانی توابع را ابتدا با بارگذاری نشانی تابع در یک ثبات
و سپس انجام یک فراخوانی زیرروال (subroutine call) روی این ثبات انجام دهد. این سوییچ
زمانی لازم است که تابع هدف خارج از دامنهٔ آدرس‌دهی ۲۴ بیتیِ دستورالعمل فراخوانی
زیرروال مبتنی بر آفست قرار داشته باشد.
.Sp
این قابلیت به‌طور پیش‌فرض فعال نیست. تعیین \&\fB\-mno\-long\-calls\fR رفتار پیش‌فرض را
بازمی‌گرداند. توجه داشته باشید که این سوییچ‌ها هیچ تأثیری بر نحوهٔ تولید کد برای رسیدگی به
فراخوانی توابع از طریق اشاره‌گرهای تابع ندارند.
.IP \fB\-mfast\-fp\fR 4
.IX Item "-mfast-fp"
پیوند با کتابخانهٔ ممیز شناور سریع. این کتابخانه به منظور بهبود کارایی، برخی از قوانین
استاندارد ممیز شناور IEEE را برای بررسی ورودی‌ها در برابر «عدد نیست» (NAN) نادیده می‌گیرد.
.IP \fB\-minline\-plt\fR 4
.IX Item "-minline-plt"
درون‌خط‌سازی (inlining) مدخل‌های PLT را در فراخوانی توابعی که معلوم نیست به صورت محلی
مقید (bind) می‌شوند، فعال می‌کند. این گزینه بدون \fB\-mfdpic\fR هیچ تأثیری ندارد.
.IP \fB\-mmulticore\fR 4
.IX Item "-mmulticore"
یک برنامهٔ مستقل برای پردازنده‌های چندهسته‌ای Blackfin می‌سازد.
این گزینه باعث استفاده از فایل‌های راه‌انداز و اسکریپت‌های پیوند مناسب با پشتیبانی از چندهسته‌ای
شده و ماکروی \f(CW\*(C`_\|_BFIN_MULTICORE\*(C'\fR را تعریف می‌کند.
این گزینه فقط همراه با \fB\-mcpu=bf561\fR[\fB\-\fR\fIsirevision\fR] قابل استفاده است.
.Sp
این گزینه می‌تواند همراه با \fB\-mcorea\fR یا \fB\-mcoreb\fR استفاده شود که مدل برنامه‌نویسی
«یک برنامه برای هر هسته» را انتخاب می‌کند. بدون \&\fB\-mcorea\fR یا \fB\-mcoreb\fR،
مدل برنامه‌نویسی «تک‌برنامه/دو هسته‌ای» استفاده می‌شود. در این مدل، تابع اصلی
هستهٔ Core B باید با نام \f(CW\*(C`coreb_main\*(C'\fR نام‌گذاری شود.
.Sp
اگر این گزینه استفاده نشود، مدل برنامه‌نویسی برنامهٔ تک‌هسته‌ای استفاده خواهد شد.
.IP \fB\-mcorea\fR 4
.IX Item "-mcorea"
هنگام استفاده از مدل برنامه‌نویسی «یک برنامه برای هر هسته»، یک برنامهٔ مستقل برای
هستهٔ Core A از BF561 می‌سازد. برای پشتیبانی از Core A، فایل‌های راه‌انداز و
اسکریپت‌های پیوند مناسب به کار گرفته می‌شوند و ماکروی \&\f(CW\*(C`_\|_BFIN_COREA\*(C'\fR
تعریف می‌گردد. این گزینه تنها در ترکیب با \fB\-mmulticore\fR قابل استفاده است.
.IP \fB\-mcoreb\fR 4
.IX Item "-mcoreb"
هنگام استفاده از مدل برنامه‌نویسی «یک برنامه برای هر هسته»، یک برنامهٔ مستقل برای
هستهٔ Core B از BF561 می‌سازد. برای پشتیبانی از Core B، فایل‌های راه‌انداز و
اسکریپت‌های پیوند مناسب به کار گرفته می‌شوند و ماکروی \&\f(CW\*(C`_\|_BFIN_COREB\*(C'\fR
تعریف می‌گردد. در زمان استفاده از این گزینه، باید به جای \f(CW\*(C`main\*(C'\fR از
\f(CW\*(C`coreb_main\*(C'\fR استفاده شود. این گزینه تنها در ترکیب با \fB\-mmulticore\fR
قابل استفاده است.
.IP \fB\-msdram\fR 4
.IX Item "-msdram"
یک برنامهٔ مستقل برای حافظهٔ SDRAM می‌سازد. فایل‌های راه‌انداز و اسکریپت‌های پیوند مناسب
برای قرار دادن برنامه در SDRAM استفاده می‌شوند، و ماکروی \&\f(CW\*(C`_\|_BFIN_SDRAM\*(C'\fR
تعریف می‌گردد. بارگذار (loader) باید پیش از بارگذاری برنامه، حافظهٔ SDRAM را مقداردهی اولیه کند..IP \fB\-micplb\fR 4
.IX Item "-micplb"
فرض می‌کند که ICPLBها در زمان اجرا فعال هستند. این گزینه بر برخی از راه‌حل‌های موقت ناهنجاری‌ها (anomaly workarounds) تأثیر می‌گذارد. برای اهداف لینوکس، پیش‌فرض این است که فرض شود ICPLBها فعال هستند؛ برای برنامه‌های مستقل (standalone)، پیش‌فرض غیرفعال بودن است.
.PP
\fIگزینه‌های C6X\fR
.IX Subsection "C6X Options"
.IP \fB\-march=\fR\fIname\fR 4
.IX Item "-march=name"
این گزینه نام معماری هدف را تعیین می‌کند. GCC از این نام برای مشخص کردن نوع دستورالعمل‌هایی که می‌تواند هنگام تولید کد اسمبلی ایجاد کند، استفاده می‌کند. نام‌های مجاز عبارتند از: \fBc62x\fR،
\&\fBc64x\fR، \fBc64x+\fR، \fBc67x\fR، \fBc67x+\fR، \fBc674x\fR.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
تولید کد برای یک هدف big\-endian.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
تولید کد برای یک هدف little\-endian. این حالت پیش‌فرض است.
.IP \fB\-msim\fR 4
.IX Item "-msim"
انتخاب فایل‌های راه‌اندازی (startup) و اسکریپت پیونددهنده مناسب برای شبیه‌ساز.
.IP \fB\-msdata=default\fR 4
.IX Item "-msdata=default"
داده‌های سراسری و ایستا کوچک را در بخش \f(CW\*(C`.neardata\*(C'\fR قرار می‌دهد که توسط ثبات \f(CW\*(C`B14\*(C'\fR اشاره می‌شود. داده‌های سراسری و ایستا مقداردهی‌نشده کوچک را در بخش \f(CW\*(C`.bss\*(C'\fR که مجاور بخش \f(CW\*(C`.neardata\*(C'\fR است قرار می‌دهد. داده‌های فقط‌خواندنی کوچک را در بخش
\&\f(CW\*(C`.rodata\*(C'\fR قرار می‌دهد. بخش‌های متناظر مورد استفاده برای تکه‌داده‌های بزرگ عبارتند از \f(CW\*(C`.fardata\*(C'\fR، \f(CW\*(C`.far\*(C'\fR و \f(CW\*(C`.const\*(C'\fR.
.IP \fB\-msdata=all\fR 4
.IX Item "-msdata=all"
تمام داده‌ها، و نه فقط اشیای کوچک، را در بخش‌های رزرو شده برای داده‌های کوچک قرار می‌دهد و برای دسترسی به آن‌ها از آدرس‌دهی نسبی نسبت به ثبات \f(CW\*(C`B14\*(C'\fR استفاده می‌کند.
.IP \fB\-msdata=none\fR 4
.IX Item "-msdata=none"
از بخش‌های رزرو شده برای داده‌های کوچک هیچ استفاده‌ای نمی‌کند و برای دسترسی به تمام داده‌ها از نشانی‌های مطلق استفاده می‌کند. تمام داده‌های سراسری و ایستای مقداردهی‌شده را در بخش \f(CW\*(C`.fardata\*(C'\fR، و تمام داده‌های مقداردهی‌نشده را در بخش
\&\f(CW\*(C`.far\*(C'\fR قرار می‌دهد. تمام داده‌های ثابت را در بخش \f(CW\*(C`.const\*(C'\fR قرار می‌دهد.
.IP \fB\-mdsbt\fR 4
.IX Item "-mdsbt"
کامپایل برای ABI کتابخانه اشتراکی DSBT. این گزینه برای کامپایل با \fB\-fpic\fR یا \fB\-fPIC\fR لازم است، و متضمن \fB\-fpic\fR می‌باشد.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
از تولید فراخوانی‌های وابسته به PC خودداری می‌کند؛ در عوض از ارجاع غیرمستقیم استفاده می‌کند.
.PP
\fIگزینه‌های CRIS\fR
.IX Subsection "CRIS Options"
.PP
این گزینه‌ها به‌طور خاص برای پورت‌های CRIS تعریف شده‌اند.
.IP \fB\-march=\fR\fIarchitecture\-type\fR 4
.IX Item "-march=architecture-type"
.PD 0
.IP \fB\-mcpu=\fR\fIarchitecture\-type\fR 4
.IX Item "-mcpu=architecture-type"
.PD
تولید کد برای معماری مشخص‌شده. گزینه‌های انتخابی برای
\&\fIarchitecture\-type\fR به ترتیب برای ETRAX\ 4، ETRAX\ 100 و ETRAX\ 100\ LX عبارتند از \fBv3\fR، \fBv8\fR و \fBv10\fR.
پیش‌فرض \fBv0\fR است.
.IP \fB\-mtune=\fR\fIarchitecture\-type\fR 4
.IX Item "-mtune=architecture-type"
بهینه‌سازی هر آنچه مربوط به کد تولیدی است برای \fIarchitecture\-type\fR، به‌جز ABI و مجموعه دستورالعمل‌های در دسترس. گزینه‌های انتخابی برای \fIarchitecture\-type\fR همانند گزینه‌های
\&\fB\-march=\fR\fIarchitecture\-type\fR هستند.
.IP \fB\-mmax\-stackframe=\fR\fIn\fR 4
.IX Item "-mmax-stackframe=n"
هشدار دادن هنگامی که فریم پشته یک تابع از \fIn\fR بایت فراتر می‌رود.
.IP \fB\-metrax4\fR 4
.IX Item "-metrax4"
.PD 0
.IP \fB\-metrax100\fR 4
.IX Item "-metrax100"
.PD
گزینه‌های \fB\-metrax4\fR و \fB\-metrax100\fR به ترتیب مترادف‌های
\&\fB\-march=v3\fR و \fB\-march=v8\fR هستند.
.IP \fB\-mmul\-bug\-workaround\fR 4
.IX Item "-mmul-bug-workaround"
.PD 0
.IP \fB\-mno\-mul\-bug\-workaround\fR 4
.IX Item "-mno-mul-bug-workaround"
.PD
اعمال راهکار رفع اشکال برای باگ موجود در دستورالعمل‌های \f(CW\*(C`muls\*(C'\fR و \f(CW\*(C`mulu\*(C'\fR در مدل‌های پردازنده‌ای که تحت تأثیر آن هستند. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mpdebug\fR 4
.IX Item "-mpdebug"
فعال‌سازی اطلاعات مفصل اشکال‌زدایی مخصوص CRIS در کد اسمبلی. این گزینه همچنین باعث خاموش شدن نشانگر کد قالب‌بندی‌شده‌ی \fB#NO_APP\fR برای اسمبلر در ابتدای فایل اسمبلی می‌شود.
.IP \fB\-mcc\-init\fR 4
.IX Item "-mcc-init"
از نتایج کدهای شرطی حاصل از دستورالعمل قبلی استفاده نمی‌کند؛ همیشه پیش از استفاده از کدهای شرطی، دستورالعمل‌های مقایسه و آزمون را صادر می‌کند.
.IP \fB\-mno\-side\-effects\fR 4
.IX Item "-mno-side-effects"
دستورالعمل‌های دارای اثرات جانبی را در حالت‌های آدرس‌دهی غیر از پس‌افزایش صادر نمی‌کند.
.IP \fB\-mstack\-align\fR 4
.IX Item "-mstack-align"
.PD 0
.IP \fB\-mno\-stack\-align\fR 4
.IX Item "-mno-stack-align"
.IP \fB\-mdata\-align\fR 4
.IX Item "-mdata-align"
.IP \fB\-mno\-data\-align\fR 4
.IX Item "-mno-data-align"
.IP \fB\-mconst\-align\fR 4
.IX Item "-mconst-align"
.IP \fB\-mno\-const\-align\fR 4
.IX Item "-mno-const-align"
.PD
این گزینه‌ها (گزینه‌های حاوی \fBno\-\fR) ترتیب هم‌ترازی (حذف ترتیب هم‌ترازی) فریم پشته، داده‌های منفرد و ثوابت را بر اساس بیشینه اندازه دسترسی به یک قلم داده برای مدل پردازنده انتخاب‌شده مهیا می‌کنند. پیش‌فرض، هم‌ترازی ۳۲ بیتی است. جزئیات ABI مانند چیدمان ساختار تحت تأثیر این گزینه‌ها قرار نمی‌گیرند.
.IP \fB\-m32\-bit\fR 4
.IX Item "-m32-bit"
.PD 0
.IP \fB\-m16\-bit\fR 4
.IX Item "-m16-bit"
.IP \fB\-m8\-bit\fR 4
.IX Item "-m8-bit"
.PD
همانند گزینه‌های هم‌ترازی پشته، داده و ثوابت در بالا، این گزینه‌ها ترتیب هم‌تراز شدن فریم پشته، داده‌های قابل نوشتن و ثوابت را به صورت ۳۲ بیتی، ۱۶ بیتی یا ۸ بیتی فراهم می‌کنند. حالت پیش‌فرض، هم‌ترازی ۳۲ بیتی است.
.IP \fB\-mno\-prologue\-epilogue\fR 4
.IX Item "-mno-prologue-epilogue"
.PD 0
.IP \fB\-mprologue\-epilogue\fR 4
.IX Item "-mprologue-epilogue"
.PD
با \fB\-mno\-prologue\-epilogue\fR، مقدمه و مؤخره عادی تابع که فریم پشته را برپا می‌کنند حذف می‌شوند و هیچ دستورالعمل بازگشت یا دنباله بازگشتی در کد تولید نمی‌شود. از این گزینه تنها به همراه بررسی چشمی کد کامپایل‌شده استفاده کنید: هیچ هشدار یا خطایی در صورتی که ثبات‌های ذخیره‌شونده توسط فراخوانده‌شده نیاز به ذخیره‌سازی داشته باشند یا برای متغیرهای محلی نیاز به تخصیص حافظه باشد، صادر نمی‌شود.
.IP \fB\-mbest\-lib\-options\fR 4
.IX Item "-mbest-lib-options"
.PD 0
.IP \fB\-moverride\-best\-lib\-options\fR 4
.IX Item "-moverride-best-lib-options"
.PD
گزینه \&\fB\-mbest\-lib\-options\fR گزینه‌هایی را انتخاب می‌کند که بیشترین قابلیت‌ها را که توسط سایر گزینه‌ها مجاز شمرده شده‌اند، فعال می‌کنند. این گزینه فرم دارای \fBno\-\fR ندارد، اما
\&\fB\-moverride\-best\-lib\-options\fR صرف نظر از ترتیب قرارگیری این دو گزینه در خط فرمان، آن را غیرفعال می‌کند.
.IP \fB\-mtrap\-using\-break8\fR 4
.IX Item "-mtrap-using-break8"
صدور تله‌ها به صورت \fBbreak 8\fR. این رفتار پیش‌فرض برای CRIS v3 به بالا است. در صورت غیرفعال بودن، به جای آن از فراخوانی‌های \f(CW\*(C`abort\*(C'\fR استفاده می‌شود.
.IP \fB\-mtrap\-unaligned\-atomic\fR 4
.IX Item "-mtrap-unaligned-atomic"
صدور بررسی‌هایی که هنگام اعمال توابع توکار اتمیک بر روی حافظه ناتراز، باعث اجرای دستورالعمل‌های \fBbreak 8\fR می‌شوند.
.IP \fB\-munaligned\-atomic\-may\-use\-library\fR 4
.IX Item "-munaligned-atomic-may-use-library"
مدیریت توابع توکار اتمیکی که ممکن است با فراخوانی توابع کتابخانه‌ای روی داده‌های ناتراز اعمال شوند. این گزینه اولویتی بالاتر از \fB\-mtrap\-unaligned\-atomic\fR دارد.
.IP \fB\-sim\fR 4
.IX Item "-sim"
این گزینه ترتیبی می‌دهد تا پیوند با توابع ورودی\-خروجیِ یک کتابخانه شبیه‌ساز برقرار شود. کد، داده‌های مقداردهی‌شده و داده‌های مقداردهی‌شده با صفر به‌طور متوالی تخصیص می‌یابند.
.IP \fB\-sim2\fR 4
.IX Item "-sim2"
مشابه \fB\-sim\fR، اما گزینه‌های پیونددهنده را برای قرار دادن داده‌های مقداردهی‌شده در 0x40000000 و داده‌های مقداردهی‌شده با صفر در 0x80000000 ارسال می‌کند.
.PP
\fIگزینه‌های C\-SKY\fR
.IX Subsection "C-SKY Options".PP
کامپایلر GCC هنگام کامپایل برای پردازنده‌های C\-SKY V2 از این گزینه‌ها پشتیبانی می‌کند.
.IP \fB\-march=\fR\fIarch\fR 4
.IX Item "-march=arch"
معماری هدف C\-SKY را مشخص می‌کند. مقادیر معتبر برای \fIarch\fR عبارتند از:
\&\fBck801\fR، \fBck802\fR، \fBck803\fR، \fBck807\fR و \fBck810\fR.
مقدار پیش‌فرض \fBck810\fR است.
.IP \fB\-mcpu=\fR\fIcpu\fR 4
.IX Item "-mcpu=cpu"
پردازندهٔ هدف C\-SKY را مشخص می‌کند. مقادیر معتبر برای \fIcpu\fR عبارتند از:
\&\fBck801\fR، \fBck801t\fR،
\&\fBck802\fR، \fBck802t\fR، \fBck802j\fR،
\&\fBck803\fR، \fBck803h\fR، \fBck803t\fR، \fBck803ht\fR،
\&\fBck803f\fR، \fBck803fh\fR، \fBck803e\fR، \fBck803eh\fR،
\&\fBck803et\fR، \fBck803eht\fR، \fBck803ef\fR، \fBck803efh\fR،
\&\fBck803ft\fR، \fBck803eft\fR، \fBck803efht\fR، \fBck803r1\fR،
\&\fBck803hr1\fR، \fBck803tr1\fR، \fBck803htr1\fR، \fBck803fr1\fR،
\&\fBck803fhr1\fR، \fBck803er1\fR، \fBck803ehr1\fR، \fBck803etr1\fR،
\&\fBck803ehtr1\fR، \fBck803efr1\fR، \fBck803efhr1\fR، \fBck803ftr1\fR،
\&\fBck803eftr1\fR، \fBck803efhtr1\fR،
\&\fBck803s\fR، \fBck803st\fR، \fBck803se\fR، \fBck803sf\fR،
\&\fBck803sef\fR، \fBck803seft\fR،
\&\fBck807e\fR، \fBck807ef\fR، \fBck807\fR، \fBck807f\fR،
\&\fBck810e\fR، \fBck810et\fR، \fBck810ef\fR، \fBck810eft\fR،
\&\fBck810\fR، \fBck810v\fR، \fBck810f\fR، \fBck810t\fR، \fBck810fv\fR،
\&\fBck810tv\fR، \fBck810ft\fR و \fBck810ftv\fR.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
.PD 0
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
.PD
تولید کد با ترتیب بایت بزرگ‌پایان (big\-endian) یا کوچک‌پایان (little\-endian) را انتخاب می‌کند. مقدار پیش‌فرض little\-endian است.
.IP \fB\-mfloat\-abi=\fR\fIname\fR 4
.IX Item "-mfloat-abi=name"
مشخص می‌کند که از کدام ABI ممیز شناور استفاده شود. مقادیر مجاز
عبارتند از: \fBsoft\fR، \fBsoftfp\fR و \fBhard\fR.
.Sp
تعیین \fBsoft\fR باعث می‌شود GCC خروجی‌ای حاوی فراخوانی توابع کتابخانه‌ای
برای عملیات ممیز شناور تولید کند.
\&\fBsoftfp\fR امکان تولید کد با استفاده از دستورالعمل‌های سخت‌افزاری
ممیز شناور را فراهم می‌کند، اما همچنان از قراردادهای فراخوانی soft\-float بهره می‌برد.
\&\fBhard\fR امکان تولید دستورالعمل‌های ممیز شناور را فراهم ساخته
و از قراردادهای فراخوانی اختصاصی FPU استفاده می‌کند.
.Sp
مقدار پیش‌فرض به پیکربندی هدف خاص وابسته است. توجه داشته باشید که
ABIهای hard\-float و soft\-float از نظر پیوند (link) سازگار نیستند؛ شما باید
تمام برنامهٔ خود را با همان ABI کامپایل کرده و با مجموعه‌ای از کتابخانه‌های سازگار پیوند دهید.
.IP \fB\-mdouble\-float\fR 4
.IX Item "-mdouble-float"
.PD 0
.IP \fB\-mno\-double\-float\fR 4
.IX Item "-mno-double-float"
.PD
هنگامی که \fB\-mhard\-float\fR فعال است، تولید دستورالعمل‌های ممیز شناور با
دقت مضاعف (double\-precision) را فعال می‌کند. این حالت به جز هنگام
کامپایل برای CK803، مقدار پیش‌فرض است.
.IP \fB\-mfdivdu\fR 4
.IX Item "-mfdivdu"
.PD 0
.IP \fB\-mno\-fdivdu\fR 4
.IX Item "-mno-fdivdu"
.PD
هنگامی که \fB\-mhard\-float\fR فعال است، تولید دستورالعمل‌های
\&\f(CW\*(C`frecipd\*(C'\fR، \f(CW\*(C`fsqrtd\*(C'\fR و \f(CW\*(C`fdivd\*(C'\fR را فعال می‌کند.
این حالت به جز هنگام کامپایل برای CK803، مقدار پیش‌فرض است.
.IP \fB\-mfpu=\fR\fIfpu\fR 4
.IX Item "-mfpu=fpu"
پردازندهٔ ممیز شناور را انتخاب می‌کند. این گزینه تنها همراه با
\&\fB\-mhard\-float\fR قابل استفاده است.
مقادیر مجاز برای \fIfpu\fR عبارتند از:
\&\fBfpv2_sf\fR (معادل با \fB\-mno\-double\-float \-mno\-fdivdu\fR)،
\&\fBfpv2\fR (\fB\-mdouble\-float \-mno\-divdu\fR) و
\&\fBfpv2_divd\fR (\fB\-mdouble\-float \-mdivdu\fR).
.IP \fB\-melrw\fR 4
.IX Item "-melrw"
.PD 0
.IP \fB\-mno\-elrw\fR 4
.IX Item "-mno-elrw"
.PD
دستورالعمل گسترش‌یافتهٔ \f(CW\*(C`lrw\*(C'\fR را فعال می‌کند. این گزینه به‌طور پیش‌فرض
برای CK801 فعال و در غیر این صورت غیرفعال است.
.IP \fB\-mistack\fR 4
.IX Item "-mistack"
.PD 0
.IP \fB\-mno\-istack\fR 4
.IX Item "-mno-istack"
.PD
دستورالعمل‌های پشتهٔ وقفه را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.Sp
گزینهٔ \fB\-mistack\fR برای مدیریت ویژگی‌های تابعی
\&\f(CW\*(C`interrupt\*(C'\fR و \f(CW\*(C`isr\*(C'\fR الزامی است.
.IP \fB\-mmp\fR 4
.IX Item "-mmp"
.PD 0
.IP \fB\-mno\-mp\fR 4
.IX Item "-mno-mp"
.PD
دستورالعمل‌های چندپردازنده‌ای را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.IP \fB\-mcp\fR 4
.IX Item "-mcp"
.PD 0
.IP \fB\-mno\-cp\fR 4
.IX Item "-mno-cp"
.PD
دستورالعمل‌های کمک‌پردازنده را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.IP \fB\-mcache\fR 4
.IX Item "-mcache"
.PD 0
.IP \fB\-mno\-cache\fR 4
.IX Item "-mno-cache"
.PD
دستورالعمل‌های کمک‌پردازنده را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.IP \fB\-msecurity\fR 4
.IX Item "-msecurity"
.PD 0
.IP \fB\-mno\-security\fR 4
.IX Item "-mno-security"
.PD
دستورالعمل‌های امنیتی C\-SKY را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.IP \fB\-mtrust\fR 4
.IX Item "-mtrust"
.PD 0
.IP \fB\-mno\-trust\fR 4
.IX Item "-mno-trust"
.PD
دستورالعمل‌های تراست (trust) در C\-SKY را فعال می‌کند؛ پیش‌فرض غیرفعال است.
.IP \fB\-mdsp\fR 4
.IX Item "-mdsp"
.PD 0
.IP \fB\-mno\-dsp\fR 4
.IX Item "-mno-dsp"
.IP \fB\-medsp\fR 4
.IX Item "-medsp"
.IP \fB\-mno\-edsp\fR 4
.IX Item "-mno-edsp"
.IP \fB\-mvdsp\fR 4
.IX Item "-mvdsp"
.IP \fB\-mno\-vdsp\fR 4
.IX Item "-mno-vdsp"
.PD
به ترتیب دستورالعمل‌های DSP، Enhanced DSP یا Vector DSP در C\-SKY را فعال می‌کند.
تمام این گزینه‌ها به‌طور پیش‌فرض غیرفعال هستند.
.IP \fB\-mdiv\fR 4
.IX Item "-mdiv"
.PD 0
.IP \fB\-mno\-div\fR 4
.IX Item "-mno-div"
.PD
دستورالعمل‌های تقسیم را تولید می‌کند. پیش‌فرض غیرفعال است.
.IP \fB\-msmart\fR 4
.IX Item "-msmart"
.PD 0
.IP \fB\-mno\-smart\fR 4
.IX Item "-mno-smart"
.PD
کد را برای حالت هوشمند (Smart Mode) تولید می‌کند که تنها از ثبات‌های شمارهٔ 0\-7 استفاده
می‌کند تا امکان استفاده از دستورالعمل‌های ۱۶ بیتی فراهم شود. این گزینه برای CK801 که
این رفتار در آن الزامی است نادیده گرفته می‌شود، و برای CK802 به‌طور پیش‌فرض فعال است.
برای سایر اهداف، پیش‌فرض غیرفعال است.
.IP \fB\-mhigh\-registers\fR 4
.IX Item "-mhigh-registers"
.PD 0
.IP \fB\-mno\-high\-registers\fR 4
.IX Item "-mno-high-registers"
.PD
کد را با استفاده از ثبات‌های بالایی شمارهٔ 16\-31 تولید می‌کند. این گزینه
روی CK801، CK802 یا CK803 پشتیبانی نمی‌شود، و برای سایر پردازنده‌ها
به‌طور پیش‌فرض فعال است.
.IP \fB\-manchor\fR 4
.IX Item "-manchor"
.PD 0
.IP \fB\-mno\-anchor\fR 4
.IX Item "-mno-anchor"
.PD
کد را با استفاده از آدرس‌های نماد لنگر سراسری (global anchor symbol) تولید می‌کند.
.IP \fB\-mpushpop\fR 4
.IX Item "-mpushpop"
.PD 0.IP \fB\-mno\-pushpop\fR 4
.IX Item "-mno-pushpop"
.PD
تولید کد با استفاده از دستورالعمل‌های \f(CW\*(C`push\*(C'\fR و \f(CW\*(C`pop\*(C'\fR. این گزینه
به‌طور پیش‌فرض فعال است.
.IP \fB\-mmultiple\-stld\fR 4
.IX Item "-mmultiple-stld"
.PD 0
.IP \fB\-mno\-multiple\-stld\fR 4
.IX Item "-mno-multiple-stld"
.PD
تولید کد با استفاده از دستورالعمل‌های \f(CW\*(C`stm\*(C'\fR و \f(CW\*(C`ldm\*(C'\fR. این گزینه
در CK801 پشتیبانی نمی‌شود، اما در سایر پردازنده‌ها به‌طور پیش‌فرض فعال است.
.IP \fB\-mconstpool\fR 4
.IX Item "-mconstpool"
.PD 0
.IP \fB\-mno\-constpool\fR 4
.IX Item "-mno-constpool"
.PD
ایجاد استخرهای ثابت (constant pools) در کامپایلر به جای واگذاری آن به
اسمبلر. این گزینه حالت پیش‌فرض بوده و برای تولید کد صحیح روی CK801 و CK802 الزامی
است، و روی سایر پردازنده‌ها اختیاری می‌باشد.
.IP \fB\-mstack\-size\fR 4
.IX Item "-mstack-size"
.PD 0
.IP \fB\-mno\-stack\-size\fR 4
.IX Item "-mno-stack-size"
.PD
درج دستورات راهنمای \f(CW\*(C`.stack_size\*(C'\fR برای هر تابع در خروجی
اسمبلی. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mccrt\fR 4
.IX Item "-mccrt"
.PD 0
.IP \fB\-mno\-ccrt\fR 4
.IX Item "-mno-ccrt"
.PD
تولید کد برای زمان اجرای کامپایلر C\-SKY به جای libgcc. این
گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mbranch\-cost=\fR\fIn\fR 4
.IX Item "-mbranch-cost=n"
تنظیم هزینهٔ انشعاب به حدود \f(CW\*(C`n\*(C'\fR دستورالعمل. مقدار پیش‌فرض ۱ است.
.IP \fB\-msched\-prolog\fR 4
.IX Item "-msched-prolog"
.PD 0
.IP \fB\-mno\-sched\-prolog\fR 4
.IX Item "-mno-sched-prolog"
.PD
اجازه دادن به زمان‌بندی توالی‌های prologue و epilogue توابع. استفاده از
این گزینه می‌تواند منجر به تولید کدی شود که با الزامات پیش‌درآمد C\-SKY V2 ABI
سازگار نبوده و امکان اشکال‌زدایی یا ردگیری به عقب (backtrace) آن وجود نداشته باشد.
این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-msim\fR 4
.IX Item "-msim"
.PD 0
.IP \fB\-mno\-sim\fR 4
.IX Item "-mno-sim"
.PD
پیوند با کتابخانهٔ libsemi.a که با شبیه‌ساز سازگار است. فقط برای
کامپایلر ELF کاربرد دارد.
.PP
\fIگزینه‌های Cygwin و MinGW\fR
.IX Subsection "Cygwin and MinGW Options"
.PP
این گزینه‌های اضافی برای مقصدهای Microsoft Windows در دسترس هستند:
.IP \fB\-mconsole\fR 4
.IX Item "-mconsole"
این گزینه
مشخص می‌کند که یک برنامهٔ کنسولی باید تولید شود؛ با
دستور دادن به پیونددهنده برای تنظیم نوع زیرسیستم در سرآیند PE
به مقدار مورد نیاز برنامه‌های کنسولی.
این گزینه برای مقصدهای Cygwin و MinGW در دسترس بوده و
به‌طور پیش‌فرض روی آن مقصدها فعال است.
.IP \fB\-mcrtdll=\fR\fIlibrary\fR 4
.IX Item "-mcrtdll=library"
پیش‌پردازش، کامپایل یا پیوند با کتابخانهٔ C RunTime DLL مشخص‌شده توسط \fIlibrary\fR.
این گزینه ماکروهای پیش‌تعریف‌شدهٔ \f(CW\*(C`_\|_CRTDLL_\|_\*(C'\fR، \f(CW\*(C`_\|_MSVCRT_\|_\*(C'\fR،
\&\f(CW\*(C`_UCRT\*(C'\fR و \f(CW\*(C`_\|_MSVCRT_VERSION_\|_\*(C'\fR را برای \fIlibrary\fR مربوط به CRT مشخص‌شده تنظیم می‌کند،
فایل آغازین را برای کتابخانهٔ CRT انتخاب کرده و با آن کتابخانهٔ CRT پیوند می‌دهد.
نام‌های شناخته‌شدهٔ کتابخانهٔ CRT برای پیش‌پردازنده عبارتند از:
\&\f(CW\*(C`crtdll*\*(C'\fR، \f(CW\*(C`msvcrt10*\*(C'\fR، \f(CW\*(C`msvcrt20*\*(C'\fR، \f(CW\*(C`msvcrt40*\*(C'\fR،
\&\f(CW\*(C`msvcr40*\*(C'\fR، \f(CW\*(C`msvcrtd*\*(C'\fR، \f(CW\*(C`msvcrt\-os*\*(C'\fR،
\&\f(CW\*(C`msvcr70*\*(C'\fR، \f(CW\*(C`msvcr71*\*(C'\fR، \f(CW\*(C`msvcr80*\*(C'\fR، \f(CW\*(C`msvcr90*\*(C'\fR،
\&\f(CW\*(C`msvcr100*\*(C'\fR، \f(CW\*(C`msvcr110*\*(C'\fR، \f(CW\*(C`msvcr120*\*(C'\fR و \f(CW\*(C`ucrt*\*(C'\fR.
اگر این گزینه مشخص نشود، کتابخانهٔ واردات پیش‌فرض MinGW با نام
\&\f(CW\*(C`msvcrt\*(C'\fR برای پیوند استفاده می‌شود و هیچ تنظیم دیگری برای
پیش‌پردازنده انجام نخواهد شد. کتابخانهٔ واردات MinGW با نام \f(CW\*(C`msvcrt\*(C'\fR صرفاً یک
پیوند نمادین به (یا کپی از) یک کتابخانهٔ واردات دیگر MinGW CRT است که در
طول کامپایل MinGW انتخاب شده است. کتابخانهٔ واردات MinGW با نام \f(CW\*(C`msvcrt\-os\*(C'\fR
برای کتابخانهٔ سیستمی CRT DLL ویندوز یعنی \f(CW\*(C`msvcrt.dll\*(C'\fR است و
در بیشتر موارد، کتابخانهٔ واردات پیش‌فرض MinGW می‌باشد.
به‌طور کلی، تغییر دادن CRT DLL نیازمند کامپایل مجدد
کل MinGW CRT است. این گزینه صرفاً برای مقاصد آزمایشی و
تست است.
این گزینه برای مقصدهای MinGW در دسترس است.
.IP \fB\-mdll\fR 4
.IX Item "-mdll"
این گزینه برای مقصدهای Cygwin و MinGW در دسترس است. این گزینه
مشخص می‌کند که یک DLL\-\-\-یک کتابخانهٔ پیوند پویا\-\-\-باید تولید
شود، و امکان انتخاب شیء آغازین زمان اجرا و
نقطهٔ ورود مورد نیاز را فراهم می‌سازد.
.IP \fB\-mnop\-fun\-dllimport\fR 4
.IX Item "-mnop-fun-dllimport"
این گزینه برای مقصدهای Cygwin و MinGW در دسترس است. این
گزینه مشخص می‌کند که صفت \f(CW\*(C`dllimport\*(C'\fR باید نادیده گرفته شود.
.IP \fB\-mthreads\fR 4
.IX Item "-mthreads"
پشتیبانی از مدیریت استثنای امن در برابر نخ‌ها (thread\-safe exception handling) روی MinGW. برنامه‌هایی که به
مدیریت استثنای thread\-safe متکی هستند باید تمام کد را با گزینهٔ
\&\fB\-mthreads\fR کامپایل و پیوند دهند. هنگام کامپایل، \fB\-mthreads\fR مقدار
\&\fB\-D_MT\fR را تعریف می‌کند؛ هنگام پیوند دادن، کتابخانهٔ کمکی ویژهٔ نخ‌ها با نام
\&\fB\-lmingwthrd\fR را پیوند می‌دهد که داده‌های مدیریت استثنای مربوط به هر نخ را پاک‌سازی می‌کند.
.IP \fB\-municode\fR 4
.IX Item "-municode"
این گزینه برای مقصدهای MinGW\-w64 در دسترس است. این گزینه
موجب تعریف پیش‌فرض ماکروی پیش‌پردازندهٔ \f(CW\*(C`UNICODE\*(C'\fR شده، و
کد راه‌انداز زمان اجرای سازگار با یونیکد را انتخاب می‌کند.
.IP \fB\-mwin32\fR 4
.IX Item "-mwin32"
این گزینه برای مقصدهای Cygwin و MinGW در دسترس است. این
گزینه مشخص می‌کند که ماکروهای از پیش تعریف‌شدهٔ معمول Microsoft Windows
در پیش‌پردازنده تنظیم شوند، اما بر انتخاب
کتابخانهٔ زمان اجرا/کد راه‌انداز تأثیری نمی‌گذارد.
.IP \fB\-mwindows\fR 4
.IX Item "-mwindows"
این گزینه برای مقصدهای Cygwin و MinGW در دسترس است. این
گزینه مشخص می‌کند که یک برنامه با رابط گرافیکی کاربر (GUI) باید با
دستور به پیونددهنده برای تنظیم مناسب نوع زیرسیستم در سرآیند PE
تولید شود.
.IP \fB\-fno\-set\-stack\-executable\fR 4
.IX Item "-fno-set-stack-executable"
این گزینه برای مقصدهای MinGW در دسترس است. این گزینه مشخص می‌کند که
پرچم قابل اجرا بودن پشته که توسط توابع تو در تو استفاده می‌شود، تنظیم
نشود. این امر برای باینری‌هایی که در حالت هسته (kernel mode) مربوط به
Microsoft Windows اجرا می‌شوند ضروری است، زیرا در آنجا API مربوط به User32 که برای تنظیم دسترسی‌های
اجرایی به کار می‌رود، در دسترس نیست.
.IP \fB\-fwritable\-relocated\-rdata\fR 4
.IX Item "-fwritable-relocated-rdata"
این گزینه برای مقصدهای MinGW و Cygwin در دسترس است. این گزینه مشخص
می‌کند که داده‌های بازآرایی‌شده در بخش فقط خواندنی، در بخش \f(CW\*(C`.data\*(C'\fR
قرار گیرند. این قابلیت برای زمان‌های اجرای قدیمی‌تری که از
تغییر دادن بخش‌های \f(CW\*(C`.rdata\*(C'\fR برای شبه‌بازآرایی (pseudo\-relocation) پشتیبانی نمی‌کنند، ضروری است.
.IP \fB\-mpe\-aligned\-commons\fR 4
.IX Item "-mpe-aligned-commons"
این گزینه برای مقصدهای Cygwin و MinGW در دسترس است. این گزینه
مشخص می‌کند که هنگام تولید کد، از پسوند گنو برای قالب فایل PE که
امکان ترازسازی صحیح متغیرهای COMMON را فراهم می‌سازد، استفاده
شود. این گزینه به‌طور پیش‌فرض فعال است اگر
GCC تشخیص دهد که اسمبلر مقصد یافت‌شده در حین پیکربندی
از این قابلیت پشتیبانی می‌کند.
.IP \fB\-muse\-libstdc\-wrappers\fR 4
.IX Item "-muse-libstdc-wrappers"
استفاده از پوشش‌های DLL مربوط به Cygwin برای پشتیبانی از عملگرهای \f(CW\*(C`new\*(C'\fR و \f(CW\*(C`delete\*(C'\fR در ++C.
.PP
همچنین برای گزینه‌های استاندارد، بخش \fBگزینه‌های x86\fR را ببینید.
.PP
\fIگزینه‌های Darwin\fR
.IX Subsection "Darwin Options"
.PP
این گزینه‌ها برای همهٔ معماری‌هایی که سیستم‌عامل Darwin را اجرا می‌کنند تعریف
شده‌اند.
.PP
کامپایلر FSF GCC روی Darwin فایل‌های شیء چندمعماری («fat») ایجاد نمی‌کند؛ بلکه
یک فایل شیء برای همان تک معماری‌ای ایجاد می‌کند که GCC برای
هدف گرفتن آن ساخته شده است. کامپایلر GCC متعلق به شرکت Apple در Darwin در صورت استفاده از
چندین گزینهٔ \&\fB\-arch\fR فایل‌های «fat» ایجاد می‌کند؛ این کار را با اجرای چندبارهٔ کامپایلر یا
پیونددهنده و سپس ترکیب نتایج با ابزار
\&\fIlipo\fR انجام می‌دهد.
.PP
زیرنوع (subtype) فایل ایجادشده (مانند \fBppc7400\fR، \fBppc970\fR یا
\&\fBi686\fR) توسط پرچم‌هایی تعیین می‌شود که معماری مجموعه دستورالعمل‌ها (ISA) را که
GCC هدف قرار می‌دهد مشخص می‌کنند، مانند \fB\-mcpu\fR یا \fB\-march\fR. از گزینهٔ
\&\fB\-force_cpusubtype_ALL\fR می‌توان برای لغو این رفتار استفاده کرد.
.PP
ابزارهای Darwin هنگام مواجهه با عدم تطابق در ISA رفتارهای
متفاوتی دارند. اسمبلر، \fIas\fR، تنها به دستورالعمل‌هایی اجازهٔ
استفاده می‌دهد که برای زیرنوع فایلِ در حال تولید معتبر باشند،
بنابراین نمی‌توانید دستورالعمل‌های ۶۴ بیتی را در یک فایل شیء \fBppc750\fR قرار دهید.
پیونددهنده برای کتابخانه‌های اشتراکی، \fI/usr/bin/libtool\fR، اگر
خواسته شود کتابخانه‌ای اشتراکی با زیرنوعی با محدودیت کمتر نسبت به فایل‌های ورودی‌اش ایجاد کند شکست می‌خورد
و خطا چاپ می‌کند (به عنوان مثال، تلاش برای قرار دادن
یک فایل شیء \fBppc970\fR در یک کتابخانهٔ \fBppc7400\fR). پیونددهنده
برای فایل‌های اجرایی، \fBld\fR، بدون تولید پیام خطا، محدودکننده‌ترین
زیرنوع در میان تمامی فایل‌های ورودی‌اش را به فایل اجرایی اختصاص می‌دهد..IP \fB\-F\fR\fIdir\fR 4
.IX Item "-Fdir"
دایرکتوری فریم‌ورک \fIdir\fR را به ابتدای فهرست دایرکتوری‌های مورد جستجو برای فایل‌های سرآیند اضافه می‌کند. این دایرکتوری‌ها با موارد مشخص‌شده توسط گزینه‌های \fB\-I\fR در هم آمیخته شده و به ترتیب از چپ به راست بررسی می‌شوند.
.Sp
دایرکتوری فریم‌ورک دایرکتوری‌ای است که شامل فریم‌ورک‌ها باشد. یک فریم‌ورک، دایرکتوری‌ای با پسوند \fI.framework\fR است که مستقیماً شامل یک دایرکتوری \fIHeaders\fR و/یا \&\fIPrivateHeaders\fR باشد. نام یک فریم‌ورک، نام این دایرکتوری بدون پسوند \fI.framework\fR است. سرآیندهای مرتبط با فریم‌ورک در یکی از این دو دایرکتوری یافت می‌شوند، که در این بین ابتدا \&\fIHeaders\fR جستجو می‌شود. یک زیرفریم‌ورک (subframework)، دایرکتوری فریم‌ورکی است که در دایرکتوری \fIFrameworks\fR یک فریم‌ورک دیگر قرار دارد. شمول (include) سرآیندهای زیرفریم‌ورک تنها می‌تواند در سرآیند فریم‌ورکی که شامل آن زیرفریم‌ورک است یا در سرآیند یک زیرفریم‌ورک هم‌سطح ظاهر شود. دو زیرفریم‌ورک در صورتی هم‌سطح هستند که در یک فریم‌ورک مشترک قرار داشته باشند. یک زیرفریم‌ورک نباید همنام یک فریم‌ورک باشد؛ در صورت نقض این مورد، یک هشدار صادر می‌شود. در حال حاضر یک زیرفریم‌ورک نمی‌تواند دارای زیرفریم‌ورک‌های دیگری باشد؛ در آینده ممکن است این سازوکار برای پشتیبانی از این حالت گسترش یابد. فریم‌ورک‌های استاندارد را می‌توان در \fI/System/Library/Frameworks\fR و \&\fI/Library/Frameworks\fR یافت. یک نمونه include به صورت \&\f(CW\*(C`#include <Framework/header.h>\*(C'\fR است، که در آن \fIFramework\fR بیانگر نام فریم‌ورک بوده و \fIheader.h\fR در دایرکتوری \&\fIPrivateHeaders\fR یا \fIHeaders\fR یافت می‌شود.
.IP \fB\-iframework\fR\fIdir\fR 4
.IX Item "-iframeworkdir"
مشابه \fB\-F\fR است با این تفاوت که دایرکتوری به عنوان یک دایرکتوری سیستمی در نظر گرفته می‌شود. تفاوت اصلی میان \fB\-iframework\fR و \&\fB\-F\fR در این است که با \fB\-iframework\fR کامپایلر در مورد ساختارهای موجود در فایل‌های سرآیندی که از طریق \&\fIdir\fR پیدا می‌شوند هشداری صادر نمی‌کند. این گزینه تنها برای خانواده زبان‌های C معتبر است.
.IP "\fB\-arch\fR \fIname\fR" 4
.IX Item "-arch name"
تولید خروجی برای معماری \fIname\fR. همان‌طور که در بالا توضیح داده شد، GCC خروجی را برای معماری‌ای که برای آن پیکربندی شده است تولید می‌کند و از گزینه‌های معمول خود برای انتخاب گونه‌های زیرمعماری بهره می‌برد. گزینه \fB\-arch\fR برای سازگاری پذیرفته می‌شود، اما اگر \&\fIname\fR با تشخیص خود GCC از معماری مقصد ناهمخوان باشد، یک خطا گزارش می‌شود.
.IP "\fB\-dependency\-file\fR \fIfilename\fR" 4
.IX Item "-dependency-file filename"
نام مستعاری برای گزینه پیش‌پردازنده \fB\-MF\fR \fIfilename\fR.
.IP \fB\-fapple\-kext\fR 4
.IX Item "-fapple-kext"
تولید کد برای افزونه‌های هسته (kext) قابل بارگذاری Darwin.
.IP \fB\-gused\fR 4
.IX Item "-gused"
تولید اطلاعات اشکال‌زدایی برای نمادهایی که استفاده شده‌اند. برای قالب اشکال‌زدایی stabs، این گزینه \fB\-feliminate\-unused\-debug\-symbols\fR را فعال می‌کند. این گزینه به‌طور پیش‌فرض روشن (ON) است.
.IP \fB\-gfull\fR 4
.IX Item "-gfull"
تولید اطلاعات اشکال‌زدایی برای تمام نمادها و نوع‌ها.
.IP \fB\-matt\-stubs\fR 4
.IX Item "-matt-stubs"
.PD 0
.IP \fB\-mno\-att\-stubs\fR 4
.IX Item "-mno-att-stubs"
.PD
فعال‌سازی استاب‌های PIC به سبک AT&T. در صورت پشتیبانی توسط معماری مقصد (در حال حاضر تنها x86)، این حالت پیش‌فرض است.
.IP \fB\-mconstant\-cfstrings\fR 4
.IX Item "-mconstant-cfstrings"
.PD 0
.IP \fB\-fconstant\-cfstrings\fR 4
.IX Item "-fconstant-cfstrings"
.PD
هنگامی که زمان اجرای NeXT استفاده می‌شود (حالت پیش‌فرض در این سیستم‌ها)، هرگونه تنظیمات \fB\-fconstant\-string\-class\fR نادیده گرفته شده و باعث می‌شود ثابت‌های لفظی \f(CW\*(C`@"..."\*(C'\fR به عنوان رشته‌های ثابت CoreFoundation چیده شوند.
.Sp
گزینه \&\fB\-fconstant\-cfstrings\fR یک نام مستعار برای \fB\-mconstant\-cfstrings\fR است.
.IP \fB\-mdynamic\-no\-pic\fR 4
.IX Item "-mdynamic-no-pic"
تولید کد مناسب برای فایل‌های اجرایی (نه کتابخانه‌های اشتراکی). این گزینه با \fB\-fpic\fR، \fB\-fPIC\fR، \fB\-fpie\fR یا \fB\-fPIE\fR ناسازگار است.
.IP \fB\-mfix\-and\-continue\fR 4
.IX Item "-mfix-and-continue"
.PD 0
.IP \fB\-ffix\-and\-continue\fR 4
.IX Item "-ffix-and-continue"
.IP \fB\-findirect\-data\fR 4
.IX Item "-findirect-data"
.PD
تولید کد مناسب برای چرخه توسعه سریع، مانند فراهم ساختن امکان بارگذاری پویای فایل‌های \fI.o\fR توسط GDB در برنامه‌های در حال اجرا. گزینه‌های \fB\-findirect\-data\fR و \fB\-ffix\-and\-continue\fR برای سازگاری با نسخه‌های قبلی ارائه شده‌اند.
.IP \fB\-mkernel\fR 4
.IX Item "-mkernel"
فعال‌سازی حالت توسعه هسته (kernel). گزینه \fB\-mkernel\fR در صورت امکان گزینه‌های \&\fB\-static\fR، \fB\-fno\-common\fR، \fB\-fno\-use\-cxa\-atexit\fR، \&\fB\-fno\-exceptions\fR، \fB\-fno\-non\-call\-exceptions\fR، \&\fB\-fapple\-kext\fR، \fB\-fno\-weak\fR و \fB\-fno\-rtti\fR را تنظیم می‌کند. این حالت همچنین برای مقصدهای PowerPC، گزینه‌های \fB\-mno\-altivec\fR، \&\fB\-msoft\-float\fR، \fB\-fno\-builtin\fR و \&\fB\-mlong\-branch\fR را تنظیم می‌نماید.
.IP \fB\-mmacosx\-version\-min=\fR\fIversion\fR 4
.IX Item "-mmacosx-version-min=version"
.PD 0
.IP \fB\-asm_macosx_version_min=\fR\fIversion\fR 4
.IX Item "-asm_macosx_version_min=version"
.PD
گزینه \fB\-mmacosx\-version\-min\fR مشخص می‌کند قدیمی‌ترین نسخه MacOS X که این فایل اجرایی روی آن اجرا خواهد شد، \&\fIversion\fR است. مقادیر معمول پشتیبانی‌شده برای \fIversion\fR شامل \f(CW12\fR، \&\f(CW10.12\fR و \f(CW10.5.8\fR هستند.
.Sp
اگر کامپایلر طوری ساخته شده باشد که به‌طور پیش‌فرض از سرآیندهای سیستم استفاده کند، مقدار پیش‌فرض این گزینه همان نسخه سیستمی است که کامپایلر روی آن اجرا می‌شود؛ در غیر این صورت، مقدار پیش‌فرض انتخاب گزینه‌هایی است که با بیشترین تعداد سیستم‌ها و پایگاه‌های کد سازگار باشند.
.Sp
گزینه \&\fB\-asm_macosx_version_min=\fR\fIversion\fR مشابه است، اما راه‌انداز GCC اطلاعات \fIversion\fR آن را تنها به اسمبلر ارسال می‌کند.
.IP \fB\-mone\-byte\-bool\fR 4
.IX Item "-mone-byte-bool"
نادیده گرفتن مقادیر پیش‌فرض برای \f(CW\*(C`bool\*(C'\fR به طوری که \f(CW\*(C`sizeof(bool)==1\*(C'\fR برقرار باشد. به‌طور پیش‌فرض هنگام کامپایل برای Darwin/PowerPC مقدار \f(CWsizeof(bool)\fR برابر \f(CW4\fR و هنگام کامپایل برای Darwin/x86 برابر \f(CW1\fR است، بنابراین این گزینه روی x86 تأثیری ندارد.
.Sp
\&\fBهشدار:\fR سوئیچ \fB\-mone\-byte\-bool\fR باعث می‌شود GCC کدی تولید کند که با کد تولیدشده بدون این سوئیچ سازگاری باینری ندارد. استفاده از این سوئیچ ممکن است نیازمند کامپایل مجدد تمام پودمان‌های دیگر برنامه، از جمله کتابخانه‌های سیستمی باشد. از این سوئیچ برای مطابقت با یک مدل داده غیرپیش‌فرض استفاده کنید.
.IP \fB\-msymbol\-stubs\fR 4
.IX Item "-msymbol-stubs"
.PD 0
.IP \fB\-mno\-symbol\-stubs\fR 4
.IX Item "-mno-symbol-stubs"
.PD
اجبار به تولید استاب‌های غیرمستقیم نماد خارجی برای ارجاعات PIC. به‌طور پیش‌فرض، اگر نسخه پیونددهنده مقصد (\fB\-mtarget\-linker\fR) به اندازه کافی قدیمی باشد که به آن‌ها نیاز داشته باشد، این گزینه به‌طور خودکار فعال می‌شود.
.IP \fB\-mtarget\-linker=\fR\fIversion\fR 4
.IX Item "-mtarget-linker=version"
.PD 0
.IP "\fB\-mtarget\-linker\fR \fIversion\fR" 4
.IX Item "-mtarget-linker version"
.PD
مشخص کردن نسخه هدف \fBld64\fR، که هر نسخه مشخص‌شده در پیکربندی GCC را لغو می‌کند. نسخه‌های جدیدتر پیونددهنده در برخی موارد، مثلاً برای کد PIC، از تولید کد بهبودیافته پشتیبانی می‌کنند.
.IP \fB\-ObjC\fR 4
.IX Item "-ObjC"
معادل \fB\-x objective\-c\fR؛ مشخص می‌کند که ورودی، کد منبع Objective\-C است.
.IP \fB\-ObjC++\fR 4
.IX Item "-ObjC++"
معادل \fB\-x objective\-c++\fR؛ مشخص می‌کند که ورودی، کد منبع Objective\-C++ است.
.IP \fB\-Wnonportable\-cfstrings\fR 4
.IX Item "-Wnonportable-cfstrings"
.PD 0
.IP \fB\-Wno\-nonportable\-cfstrings\fR 4
.IX Item "-Wno-nonportable-cfstrings"
.PD
هشدار در صورتی که اشیاء رشته‌ای ثابت CoreFoundation حاوی نویسه‌های غیرقابل‌حمل باشند. این هشدار به‌طور پیش‌فرض فعال است.
.IP \fB\-all_load\fR 4
.IX Item "-all_load"
بارگذاری تمام اعضای کتابخانه‌های آرشیو ایستا.
برای اطلاعات بیشتر به \fBld\fR\|(1) مراجعه کنید.
.IP \fB\-arch_errors_fatal\fR 4
.IX Item "-arch_errors_fatal"
باعث می‌شود خطاهای مربوط به فایل‌هایی با معماری نادرست، مهلک (fatal) تلقی شوند.
.IP \fB\-bind_at_load\fR 4
.IX Item "-bind_at_load"
باعث می‌شود فایل خروجی به‌گونه‌ای نشانه‌گذاری شود که پیونددهنده پویا هنگام بارگذاری یا راه‌اندازی فایل، تمام ارجاعات تعریف‌نشده را مقیدسازی (bind) کند.
.IP \fB\-bundle\fR 4
.IX Item "-bundle"
تولید یک فایل در قالب بسته (bundle) Mach\-o.
برای اطلاعات بیشتر به \fBld\fR\|(1) مراجعه کنید..IP "\fB\-bundle_loader\fR \fIexecutable\fR" 4
.IX Item "-bundle_loader executable"
این گزینه \fIexecutable\fR (فایل اجرایی) را مشخص می‌کند که فایل خروجی ساخت پیوندخورده را بارگذاری خواهد کرد. برای اطلاعات بیشتر صفحه راهنمای \fBld\fR\|(1) را ببینید.
.IP \fB\-dynamiclib\fR 4
.IX Item "-dynamiclib"
هنگام ارسال این گزینه، GCC در زمان پیوند به جای یک فایل اجرایی، با استفاده از دستور \fIlibtool\fR مربوط به Darwin، یک کتابخانه پویا تولید می‌کند.
.IP \fB\-force_cpusubtype_ALL\fR 4
.IX Item "-force_cpusubtype_ALL"
این گزینه باعث می‌شود که فایل خروجی GCC به‌جای زیرنوع کنترل‌شده توسط گزینه \fB\-mcpu\fR یا \fB\-march\fR، زیرنوع \fBALL\fR را داشته باشد.
.IP \fB\-nodefaultrpaths\fR 4
.IX Item "-nodefaultrpaths"
مسیرهای اجرای پیش‌فرض (run paths) برای دایرکتوری‌های کتابخانه کامپایلر را به فایل‌های اجرایی، پودمان‌ها یا کتابخانه‌های پویا اضافه نمی‌کند. در macOS 10.5 و جدیدتر، runpath تعبیه‌شده به‌طور پیش‌فرض اضافه می‌شود مگر اینکه کاربر \&\fB\-nodefaultrpaths\fR را به خط پیوند اضافه کند. مسیرهای اجرا برای ساخت در macOS نسخه 10.11 یا بالاتر لازم هستند (و بنابراین اجبار می‌شوند).
.IP \fB\-nodefaultexport\fR 4
.IX Item "-nodefaultexport"
صادره‌های نماد پیش‌فرض را به پودمان‌ها یا کتابخانه‌های پویا اضافه نمی‌کند.
.IP "\fB\-allowable_client\fR  \fIclient_name\fR" 4
.IX Item "-allowable_client client_name"
.PD 0
.IP \fB\-client_name\fR 4
.IX Item "-client_name"
.IP \fB\-compatibility_version\fR 4
.IX Item "-compatibility_version"
.IP \fB\-current_version\fR 4
.IX Item "-current_version"
.IP \fB\-dead_strip\fR 4
.IX Item "-dead_strip"
.IP \fB\-dylib_file\fR 4
.IX Item "-dylib_file"
.IP \fB\-dylinker\fR 4
.IX Item "-dylinker"
.IP \fB\-dylinker_install_name\fR 4
.IX Item "-dylinker_install_name"
.IP \fB\-dynamic\fR 4
.IX Item "-dynamic"
.IP \fB\-exported_symbols_list\fR 4
.IX Item "-exported_symbols_list"
.IP \fB\-filelist\fR 4
.IX Item "-filelist"
.IP \fB\-flat_namespace\fR 4
.IX Item "-flat_namespace"
.IP \fB\-force_flat_namespace\fR 4
.IX Item "-force_flat_namespace"
.IP \fB\-framework\fR 4
.IX Item "-framework"
.IP \fB\-headerpad_max_install_names\fR 4
.IX Item "-headerpad_max_install_names"
.IP \fB\-image_base\fR 4
.IX Item "-image_base"
.IP "\fB\-init\fR \fIsymbol\-name\fR" 4
.IX Item "-init symbol-name"
.IP \fB\-install_name\fR 4
.IX Item "-install_name"
.IP \fB\-keep_private_externs\fR 4
.IX Item "-keep_private_externs"
.IP \fB\-pagezero_size\fR 4
.IX Item "-pagezero_size"
.IP \fB\-preload\fR 4
.IX Item "-preload"
.IP \fB\-read_only_relocs\fR 4
.IX Item "-read_only_relocs"
.IP \fB\-sectalign\fR 4
.IX Item "-sectalign"
.IP \fB\-sectcreate\fR 4
.IX Item "-sectcreate"
.IP \fB\-seg_addr_table\fR 4
.IX Item "-seg_addr_table"
.IP \fB\-seg1addr\fR 4
.IX Item "-seg1addr"
.IP \fB\-segaddr\fR 4
.IX Item "-segaddr"
.IP \fB\-segprot\fR 4
.IX Item "-segprot"
.IP \fB\-segs_read_only_addr\fR 4
.IX Item "-segs_read_only_addr"
.IP \fB\-segs_read_write_addr\fR 4
.IX Item "-segs_read_write_addr"
.IP \fB\-sub_library\fR 4
.IX Item "-sub_library"
.IP \fB\-sub_umbrella\fR 4
.IX Item "-sub_umbrella"
.IP \fB\-twolevel_namespace\fR 4
.IX Item "-twolevel_namespace"
.IP \fB\-twolevel_namespace_hints\fR 4
.IX Item "-twolevel_namespace_hints"
.IP \fB\-umbrella\fR 4
.IX Item "-umbrella"
.IP \fB\-undefined\fR 4
.IX Item "-undefined"
.IP \fB\-unexported_symbols_list\fR 4
.IX Item "-unexported_symbols_list"
.IP \fB\-weak_framework\fR 4
.IX Item "-weak_framework"
.IP \fB\-weak_reference_mismatches\fR 4
.IX Item "-weak_reference_mismatches"
.IP \fB\-whatsloaded\fR 4
.IX Item "-whatsloaded"
.IP \fB\-whyload\fR 4
.IX Item "-whyload"
.PD
این گزینه‌ها به پیونددهنده Darwin منتقل می‌شوند. صفحه راهنمای پیونددهنده Darwin آن‌ها را با جزئیات شرح می‌دهد.
.PP
\fIگزینه‌های DEC Alpha\fR
.IX Subsection "DEC Alpha Options"
.PP
این گزینه‌های \fB\-m\fR برای پیاده‌سازی‌های DEC Alpha تعریف شده‌اند:
.IP \fB\-mno\-soft\-float\fR 4
.IX Item "-mno-soft-float"
.PD 0
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD
از دستورالعمل‌های سخت‌افزاری ممیز شناور برای محاسبات ممیز شناور استفاده می‌کند (یا نمی‌کند). وقتی \fB\-msoft\-float\fR مشخص شده باشد، توابع موجود در \fIlibgcc.a\fR برای انجام عملیات ممیز شناور به کار می‌روند. این روتین‌ها دستورالعمل‌های ممیز شناور را صادر می‌کنند، مگر اینکه با روتین‌هایی که عملیات ممیز شناور را شبیه‌سازی می‌کنند جایگزین شده باشند، یا به‌گونه‌ای کامپایل شده باشند که چنین روتین‌های شبیه‌سازی را فراخوانی کنند. اگر برای یک Alpha بدون عملیات ممیز شناور کامپایل می‌کنید، باید مطمئن شوید که کتابخانه به‌گونه‌ای ساخته شده باشد که آن‌ها را فراخوانی نکند.
.Sp
توجه داشته باشید که پیاده‌سازی‌های Alpha بدون عملیات ممیز شناور ملزم به داشتن ثبات‌های ممیز شناور هستند.
.IP \fB\-mfp\-regs\fR 4
.IX Item "-mfp-regs"
.PD 0
.IP \fB\-mno\-fp\-regs\fR 4
.IX Item "-mno-fp-regs"
.PD
کدی تولید می‌کند که از مجموعه ثبات‌های ممیز شناور استفاده می‌کند (یا نمی‌کند).
گزینه \&\fB\-mno\-fp\-regs\fR مستلزم \fB\-msoft\-float\fR است. اگر از مجموعه ثبات‌های ممیز شناور استفاده نشود، عملوندهای ممیز شناور مانند اعداد صحیح در ثبات‌های عدد صحیح منتقل می‌شوند و نتایج ممیز شناور به‌جای \f(CW$f0\fR در \f(CW$0\fR ارسال می‌شوند. این یک توالی فراخوانی غیراستاندارد است، بنابراین هر تابعی با آرگومان یا مقدار بازگشتی ممیز شناور که توسط کد کامپایل‌شده با \fB\-mno\-fp\-regs\fR فراخوانی می‌شود نیز باید با این گزینه کامپایل گردد.
.Sp
کاربرد معمول این گزینه، ساخت کرنلی است که از هیچ ثبات ممیز شناوری استفاده نمی‌کند و بنابراین نیازی به ذخیره و بازیابی آن‌ها ندارد.
.IP \fB\-mieee\fR 4
.IX Item "-mieee"
معماری Alpha سخت‌افزار ممیز شناور را بهینه‌شده برای حداکثر کارایی پیاده‌سازی می‌کند. این معماری تا حد زیادی با استاندارد ممیز شناور IEEE سازگار است. با این حال، برای انطباق کامل، به کمک نرم‌افزاری نیاز است. این گزینه کدی کاملاً منطبق بر IEEE تولید می‌کند، \fIبه‌جز\fR اینکه \fIinexact\-flag\fR نگهداری نمی‌شود (به زیر مراجعه کنید). اگر این گزینه فعال باشد، ماکروی پیش‌پردازنده \f(CW\*(C`_IEEE_FP\*(C'\fR در زمان کامپایل تعریف می‌شود. کد حاصل کارایی کمتری دارد، اما می‌تواند به‌درستی از اعداد غیرنرمال (denormalized) و مقادیر استثنایی IEEE مانند Not-a-Number (NaN) و مثبت/منفی بی‌نهایت پشتیبانی کند. سایر کامپایلرهای Alpha این گزینه را \fB\-ieee_with_no_inexact\fR می‌نامند.
.IP \fB\-mieee\-with\-inexact\fR 4
.IX Item "-mieee-with-inexact"
این گزینه مانند \fB\-mieee\fR است، به‌جز اینکه کد تولیدشده \fIinexact\-flag\fR استاندارد IEEE را نیز نگهداری می‌کند. فعال کردن این گزینه باعث می‌شود کد تولیدشده محاسبات ریاضی کاملاً منطبق بر IEEE را پیاده‌سازی کند. علاوه بر \&\f(CW\*(C`_IEEE_FP\*(C'\fR، ماکروی پیش‌پردازنده \f(CW\*(C`_IEEE_FP_EXACT\*(C'\fR نیز تعریف می‌شود. در برخی پیاده‌سازی‌های Alpha، کد حاصل ممکن است به‌طور قابل‌توجهی کندتر از کد تولیدشده در حالت پیش‌فرض اجرا شود. از آنجا که کدهای بسیار اندکی به \fIinexact\-flag\fR وابسته‌اند، معمولاً نباید این گزینه را تعیین کنید. سایر کامپایلرهای Alpha این گزینه را \fB\-ieee_with_inexact\fR می‌نامند.
.IP \fB\-mfp\-trap\-mode=\fR\fItrap\-mode\fR 4
.IX Item "-mfp-trap-mode=trap-mode"
این گزینه کنترل می‌کند که چه تله‌های (trap) مربوط به ممیز شناور فعال شوند. سایر کامپایلرهای Alpha این گزینه را \fB\-fptm\fR \fItrap\-mode\fR می‌نامند. حالت تله را می‌توان روی یکی از چهار مقدار زیر تنظیم کرد:
.RS 4
.IP \fBn\fR 4
.IX Item "n"
این حالت پیش‌فرض (عادی) است. تنها تله‌هایی فعال می‌شوند که در نرم‌افزار نمی‌توان آن‌ها را غیرفعال کرد (به‌عنوان مثال، تله تقسیم بر صفر)..IP \fBu\fR 4
.IX Item "u"
علاوه بر تله‌های فعال‌شده توسط \fBn\fR، تله‌های زیرریز (underflow) نیز فعال می‌شوند.
.IP \fBsu\fR 4
.IX Item "su"
مانند \fBu\fR، اما دستورالعمل‌ها به گونه‌ای علامت‌گذاری می‌شوند که برای تکمیل نرم‌افزاری امن باشند (برای جزئیات به راهنمای معماری Alpha مراجعه کنید).
.IP \fBsui\fR 4
.IX Item "sui"
مانند \fBsu\fR، اما تله‌های نادقیق (inexact) نیز فعال می‌شوند.
.RE
.RS 4
.RE
.IP \fB\-mfp\-rounding\-mode=\fR\fIrounding\-mode\fR 4
.IX Item "-mfp-rounding-mode=rounding-mode"
حالت گرد کردن IEEE را انتخاب می‌کند. دیگر کامپایلرهای Alpha این گزینه را
\&\fB\-fprm\fR \fIrounding\-mode\fR می‌نامند. مقدار \fIrounding\-mode\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBn\fR 4
.IX Item "n"
حالت گرد کردن عادی IEEE. اعداد ممیز شناور به سمت نزدیک‌ترین عدد ماشین یا در صورت تساوی فاصله، به سمت عدد ماشین زوج گرد می‌شوند.
.IP \fBm\fR 4
.IX Item "m"
گرد کردن به سمت منفی بی‌نهایت.
.IP \fBc\fR 4
.IX Item "c"
حالت گرد کردن بریده‌شده (chopped). اعداد ممیز شناور به سمت صفر گرد می‌شوند.
.IP \fBd\fR 4
.IX Item "d"
حالت گرد کردن پویا (dynamic). فیلدی در ثبات کنترل ممیز شناور
(\fIfpcr\fR، به راهنمای مرجع معماری Alpha مراجعه کنید) حالت گرد کردن اعمال‌شده را کنترل می‌کند. کتابخانهٔ C این ثبات را برای گرد کردن به سمت مثبت بی‌نهایت مقداردهی اولیه می‌کند. بنابراین، مگر اینکه برنامهٔ شما
\&\fIfpcr\fR را تغییر دهد، \fBd\fR معادل گرد کردن به سمت مثبت بی‌نهایت خواهد بود.
.RE
.RS 4
.RE
.IP \fB\-mtrap\-precision=\fR\fItrap\-precision\fR 4
.IX Item "-mtrap-precision=trap-precision"
در معماری Alpha، تله‌های ممیز شناور نادقیق (imprecise) هستند. این بدان معناست که بدون کمک نرم‌افزاری، بازیابی پس از یک تلهٔ ممیز شناور غیرممکن است و اجرای برنامه معمولاً باید پایان یابد. GCC می‌تواند کدی تولید کند که به گرداننده‌های تلهٔ سیستم‌عامل در تعیین محل دقیقی که باعث ایجاد تلهٔ ممیز شناور شده است کمک کند. بسته به نیازمندی‌های برنامه، می‌توان سطوح مختلفی از دقت را انتخاب کرد:
.RS 4
.IP \fBp\fR 4
.IX Item "p"
دقت در سطح برنامه (Program precision). این گزینه پیش‌فرض است و به این معنی است که گردانندهٔ تله فقط می‌تواند تشخیص دهد کدام برنامه باعث ایجاد استثنای ممیز شناور شده است.
.IP \fBf\fR 4
.IX Item "f"
دقت در سطح تابع (Function precision). گردانندهٔ تله می‌تواند تابعی را که باعث ایجاد استثنای ممیز شناور شده است مشخص کند.
.IP \fBi\fR 4
.IX Item "i"
دقت در سطح دستورالعمل (Instruction precision). گردانندهٔ تله می‌تواند دستورالعمل دقیقی را که باعث ایجاد استثنای ممیز شناور شده است مشخص کند.
.RE
.RS 4
.Sp
سایر کامپایلرهای Alpha گزینه‌های معادل دیگری با نام‌های
\&\fB\-scope_safe\fR و \fB\-resumption_safe\fR ارائه می‌دهند.
.RE
.IP \fB\-mieee\-conformant\fR 4
.IX Item "-mieee-conformant"
این گزینه کد تولیدشده را به عنوان سازگار با IEEE علامت‌گذاری می‌کند. شما نباید از این گزینه استفاده کنید مگر اینکه گزینهٔ \fB\-mtrap\-precision=i\fR و همچنین یکی از گزینه‌های
\&\fB\-mfp\-trap\-mode=su\fR یا \fB\-mfp\-trap\-mode=sui\fR را مشخص کرده باشید. تنها اثر آن، درج خط \fB.eflag 48\fR در دیباچهٔ تابع (prologue) در فایل اسمبلی تولیدشده است.
.IP \fB\-mbuild\-constants\fR 4
.IX Item "-mbuild-constants"
به طور معمول، GCC یک ثابت عدد صحیح ۳۲ یا ۶۴ بیتی را بررسی می‌کند تا ببیند آیا می‌تواند آن را از ثابت‌های کوچک‌تر در دو یا سه دستورالعمل بسازد یا خیر. اگر نتواند، ثابت را به عنوان یک لیترال در خروجی قرار می‌دهد و کدی برای بارگیری آن از بخش داده (data segment) در زمان اجرا تولید می‌کند.
.Sp
از این گزینه استفاده کنید تا GCC ملزم شود \fIهمهٔ\fR ثابت‌های عدد صحیح را با استفاده از کد بسازد، حتی اگر به دستورالعمل‌های بیشتری نیاز داشته باشد (حداکثر شش دستورالعمل).
.Sp
شما معمولاً از این گزینه برای ساخت بارگذار پویای کتابخانهٔ مشترک استفاده می‌کنید. از آنجا که بارگذار خود یک کتابخانهٔ مشترک است، باید پیش از آنکه بتواند متغیرها و ثابت‌ها را در بخش دادهٔ خود پیدا کند، خود را در حافظه بازنشانی (relocate) کند.
.IP \fB\-mbwx\fR 4
.IX Item "-mbwx"
.PD 0
.IP \fB\-mno\-bwx\fR 4
.IX Item "-mno-bwx"
.IP \fB\-mcix\fR 4
.IX Item "-mcix"
.IP \fB\-mno\-cix\fR 4
.IX Item "-mno-cix"
.IP \fB\-mfix\fR 4
.IX Item "-mfix"
.IP \fB\-mno\-fix\fR 4
.IX Item "-mno-fix"
.IP \fB\-mmax\fR 4
.IX Item "-mmax"
.IP \fB\-mno\-max\fR 4
.IX Item "-mno-max"
.PD
مشخص می‌کند که آیا GCC باید برای استفاده از مجموعه‌دستورالعمل‌های اختیاری BWX، CIX، FIX و MAX کد تولید کند یا خیر. حالت پیش‌فرض، استفاده از مجموعه‌دستورالعمل‌های پشتیبانی‌شده توسط نوع پردازنده‌ای است که از طریق گزینهٔ \fB\-mcpu=\fR مشخص شده است؛ یا در صورت مشخص نشدن، نوع پردازنده‌ای که GCC روی آن ساخته شده است.
.IP \fB\-msafe\-bwa\fR 4
.IX Item "-msafe-bwa"
.PD 0
.IP \fB\-mno\-safe\-bwa\fR 4
.IX Item "-mno-safe-bwa"
.PD
مشخص می‌کند که در صورت عدم وجود مجموعه‌دستورالعمل اختیاری BWX، آیا GCC باید برای دسترسی‌های حافظه در سطح بایت و کلمهٔ هم‌تراز (aligned word)، کدی امن در برابر چندنخی (multi-thread safe) و سیگنال‌های ناهمگام (async-signal safe) تولید کند یا خیر.
.IP \fB\-msafe\-partial\fR 4
.IX Item "-msafe-partial"
.PD 0
.IP \fB\-mno\-safe\-partial\fR 4
.IX Item "-mno-safe-partial"
.PD
مشخص می‌کند که آیا GCC باید برای دسترسی‌های جزئی به حافظه کدی امن در برابر چندنخی و سیگنال‌های ناهمگام تولید کند یا خیر؛ این دسترسی‌ها شامل دسترسی‌های تکه‌تکه به داده‌های ناهم‌تراز و همچنین دسترسی‌های بلوکی به بخش‌های ابتدایی و انتهایی انواع داده‌های تجمیعی (aggregate types) یا سایر اشیاء موجود در حافظه است که به ترتیب بر روی یک مرز دادهٔ ۶۴ بیتیِ هم‌تراز شروع یا پایان نمی‌یابند.
.IP \fB\-mfloat\-vax\fR 4
.IX Item "-mfloat-vax"
.PD 0
.IP \fB\-mfloat\-ieee\fR 4
.IX Item "-mfloat-ieee"
.PD
تولید کدی که به جای دقت‌های تکی (single) و دوگانهٔ (double) استاندارد IEEE، از محاسبات ممیز شناور F و G در VAX استفاده می‌کند (یا استفاده نمی‌کند).
.IP \fB\-mexplicit\-relocs\fR 4
.IX Item "-mexplicit-relocs"
.PD 0
.IP \fB\-mno\-explicit\-relocs\fR 4
.IX Item "-mno-explicit-relocs"
.PD
اسمبلرهای قدیمی‌تر Alpha راهی برای تولید بازنشانی نمادها (symbol relocations) به جز از طریق ماکروهای اسمبلر نداشتند. استفاده از این ماکروها اجازهٔ زمان‌بندی بهینهٔ دستورالعمل‌ها را نمی‌دهد. بستهٔ GNU Binutils از نسخهٔ 2.12 از نحو جدیدی پشتیبانی می‌کند که به کامپایلر اجازه می‌دهد به طور صریح مشخص کند کدام بازنشانی‌ها باید بر روی کدام دستورالعمل‌ها اعمال شوند. این گزینه بیشتر برای اشکال‌زدایی مفید است، زیرا GCC در هنگام ساخته شدن، قابلیت‌های اسمبلر را تشخیص داده و مقدار پیش‌فرض را بر همان اساس تنظیم می‌کند.
.IP \fB\-msmall\-data\fR 4
.IX Item "-msmall-data"
.PD 0
.IP \fB\-mlarge\-data\fR 4
.IX Item "-mlarge-data"
.PD
هنگامی که \fB\-mexplicit\-relocs\fR فعال باشد، داده‌های ایستا (static data) از طریق بازنشانی‌های نسبی به \fIgp\fR دسترسی پیدا می‌کنند. هنگامی که \fB\-msmall\-data\fR استفاده شود، اشیایی به طول ۸ بایت یا کوچک‌تر در یک «ناحیهٔ داده‌های کوچک» (\fIsmall data area\fR، یعنی بخش‌های \f(CW\*(C`.sdata\*(C'\fR و \f(CW\*(C`.sbss\*(C'\fR) قرار می‌گیرند و از طریق بازنشانی‌های ۱۶ بیتی نسبت به ثبات \f(CW$gp\fR در دسترس قرار می‌گیرند. این امر اندازهٔ ناحیهٔ داده‌های کوچک را به ۶۴ کیلوبایت محدود می‌کند، اما به متغیرها اجازه می‌دهد که مستقیماً از طریق یک تک‌دستورالعمل قابل دسترسی باشند.
.Sp
حالت پیش‌فرض \fB\-mlarge\-data\fR است. با این گزینه، ناحیهٔ داده به کمی کمتر از ۲ گیگابایت محدود می‌شود. برنامه‌هایی که به بیش از ۲ گیگابایت داده نیاز دارند، باید به جای بخش دادهٔ برنامه، از \f(CW\*(C`malloc\*(C'\fR یا \f(CW\*(C`mmap\*(C'\fR برای تخصیص داده‌ها در هیپ (heap) استفاده کنند.
.Sp
هنگام تولید کد برای کتابخانه‌های مشترک، \fB\-fpic\fR متضمن
\&\fB\-msmall\-data\fR و \fB\-fPIC\fR متضمن \fB\-mlarge\-data\fR است.
.IP \fB\-msmall\-text\fR 4
.IX Item "-msmall-text"
.PD 0
.IP \fB\-mlarge\-text\fR 4
.IX Item "-mlarge-text"
.PD
هنگامی که \fB\-msmall\-text\fR استفاده می‌شود، کامپایلر فرض می‌کند که کد کل برنامه (یا کتابخانهٔ مشترک) در ۴ مگابایت جای می‌گیرد و در نتیجه با یک دستور انشعاب (branch) قابل دستیابی است. هنگامی که \fB\-msmall\-data\fR استفاده می‌شود، کامپایلر می‌تواند فرض کند که همهٔ نمادهای محلی مقدار \f(CW$gp\fR یکسانی دارند و بدین ترتیب تعداد دستورالعمل‌های مورد نیاز برای فراخوانی یک تابع را از ۴ به ۱ کاهش دهد.
.Sp
حالت پیش‌فرض \fB\-mlarge\-text\fR است..IP \fB\-mcpu=\fR\fIcpu_type\fR 4
.IX Item "-mcpu=cpu_type"
مجموعه دستورالعمل‌ها و پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \fIcpu_type\fR تعیین می‌کند. می‌توانید نام به سبک \fBEV\fR یا شماره تراشه متناظر را مشخص کنید. GCC از پارامترهای زمان‌بندی برای خانواده پردازنده‌های EV4، EV5 و EV6 پشتیبانی می‌کند و مقادیر پیش‌فرض را برای مجموعه دستورالعمل‌ها از روی پردازنده‌ای که مشخص می‌کنید برمی‌گزیند. اگر نوع پردازنده را مشخص نکنید، GCC به‌طور پیش‌فرض پردازنده‌ای را در نظر می‌گیرد که کامپایلر روی آن ساخته شده است.
.Sp
مقادیر پشتیبانی‌شده برای \fIcpu_type\fR عبارتند از:
.RS 4
.IP \fBev4\fR 4
.IX Item "ev4"
.PD 0
.IP \fBev45\fR 4
.IX Item "ev45"
.IP \fB21064\fR 4
.IX Item "21064"
.PD
همانند یک EV4 زمان‌بندی می‌شود و هیچ افزونه مجموعه دستورالعملی ندارد.
.IP \fBev5\fR 4
.IX Item "ev5"
.PD 0
.IP \fB21164\fR 4
.IX Item "21164"
.PD
همانند یک EV5 زمان‌بندی می‌شود و هیچ افزونه مجموعه دستورالعملی ندارد.
.IP \fBev56\fR 4
.IX Item "ev56"
.PD 0
.IP \fB21164a\fR 4
.IX Item "21164a"
.PD
همانند یک EV5 زمان‌بندی می‌شود و از افزونه BWX پشتیبانی می‌کند.
.IP \fBpca56\fR 4
.IX Item "pca56"
.PD 0
.IP \fB21164pc\fR 4
.IX Item "21164pc"
.IP \fB21164PC\fR 4
.IX Item "21164PC"
.PD
همانند یک EV5 زمان‌بندی می‌شود و از افزونه‌های BWX و MAX پشتیبانی می‌کند.
.IP \fBev6\fR 4
.IX Item "ev6"
.PD 0
.IP \fB21264\fR 4
.IX Item "21264"
.PD
همانند یک EV6 زمان‌بندی می‌شود و از افزونه‌های BWX، FIX و MAX پشتیبانی می‌کند.
.IP \fBev67\fR 4
.IX Item "ev67"
.PD 0
.IP \fB21264a\fR 4
.IX Item "21264a"
.PD
همانند یک EV6 زمان‌بندی می‌شود و از افزونه‌های BWX، CIX، FIX و MAX پشتیبانی می‌کند.
.RE
.RS 4
.Sp
زنجیره ابزارهای بومی (Native toolchains) همچنین از مقدار \fBnative\fR پشتیبانی می‌کنند که بهترین گزینه معماری را برای پردازنده میزبان انتخاب می‌کند. اگر GCC پردازنده را شناسایی نکند، \&\fB\-mcpu=native\fR هیچ اثری نخواهد داشت.
.RE
.IP \fB\-mtune=\fR\fIcpu_type\fR 4
.IX Item "-mtune=cpu_type"
فقط پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \&\fIcpu_type\fR تعیین می‌کند. مجموعه دستورالعمل‌ها تغییر نمی‌کند.
.Sp
زنجیره ابزارهای بومی همچنین از مقدار \fBnative\fR پشتیبانی می‌کنند که بهترین گزینه معماری را برای پردازنده میزبان انتخاب می‌کند. اگر GCC پردازنده را شناسایی نکند، \&\fB\-mtune=native\fR هیچ اثری نخواهد داشت.
.IP \fB\-mmemory\-latency=\fR\fItime\fR 4
.IX Item "-mmemory-latency=time"
میزان تأخیری (latency) را تعیین می‌کند که زمان‌بند باید برای ارجاعات معمول به حافظه، از دیدگاه برنامه، در نظر بگیرد. این عدد به شدت به الگوهای دسترسی به حافظه توسط برنامه و اندازه حافظه نهان (کَش) خارجی روی ماشین وابسته است.
.Sp
گزینه‌های معتبر برای \fItime\fR عبارتند از:
.RS 4
.IP \fInumber\fR 4
.IX Item "number"
یک عدد ده‌دهی نشان‌دهنده چرخه‌های ساعت.
.IP \fBL1\fR 4
.IX Item "L1"
.PD 0
.IP \fBL2\fR 4
.IX Item "L2"
.IP \fBL3\fR 4
.IX Item "L3"
.IP \fBmain\fR 4
.IX Item "main"
.PD
کامپایلر شامل تخمین‌هایی از تعداد چرخه‌های ساعت برای سخت‌افزار «معمول» EV4 و EV5 برای حافظه‌های نهان سطح ۱، ۲ و ۳ (که Dcache، Scache و Bcache نیز نامیده می‌شوند) و همچنین حافظه اصلی است. توجه داشته باشید که L3 فقط برای EV5 معتبر است.
.RE
.RS 4
.RE
.IP \fB\-mtls\-kernel\fR 4
.IX Item "-mtls-kernel"
به‌جای \f(CW\*(C`rduniq\*(C'\fR دستور \f(CW\*(C`rdval\*(C'\fR را برای اشاره‌گر ریسه (thread pointer) صادر می‌کند.
.IP \fB\-mtls\-size=\fR\fIbitsize\fR 4
.IX Item "-mtls-size=bitsize"
اندازه بر حسب بیت آفست‌های بی‌واسطه (immediate) در TLS را مشخص می‌کند. مقادیر معتبر برای \fIbitsize\fR عبارتند از 16، 32 و 64؛ مقدار پیش‌فرض 32 است.
.IP \fB\-mlong\-double\-128\fR 4
.IX Item "-mlong-double-128"
.PD 0
.IP \fB\-mlong\-double\-64\fR 4
.IX Item "-mlong-double-64"
.PD
اندازه نوع داده \f(CW\*(C`long double\*(C'\fR را مشخص می‌کند. توجه داشته باشید که \&\fB\-mlong\-double\-128\fR با ممیز شناور VAX ناسازگار است.
.PP
\fIگزینه‌های eBPF\fR
.IX Subsection "eBPF Options"
.IP \fB\-mframe\-limit=\fR\fIbytes\fR 4
.IX Item "-mframe-limit=bytes"
حد قطعی اندازه فریم را بر حسب بایت مشخص می‌کند. در حال حاضر، مقداری که می‌توان مشخص کرد باید کمتر یا مساوی \&\fB32767\fR باشد. پیش‌فرض، هر محدودیتی است که توسط نسخه هسته لینوکس هدف اعمال شده باشد.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
کد را برای یک هدف بزرگ‌پایان (big\-endian) تولید می‌کند.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
کد را برای یک هدف کوچک‌پایان (little\-endian) تولید می‌کند. این گزینه پیش‌فرض است.
.IP \fB\-mjmpext\fR 4
.IX Item "-mjmpext"
.PD 0
.IP \fB\-mno\-jmpext\fR 4
.IX Item "-mno-jmpext"
.PD
تولید دستورالعمل‌های پرش شرطی اضافه را فعال یا غیرفعال می‌کند. برای CPU v2 و بالاتر فعال است.
.IP \fB\-mjmp32\fR 4
.IX Item "-mjmp32"
.PD 0
.IP \fB\-mno\-jmp32\fR 4
.IX Item "-mno-jmp32"
.PD
تولید دستورالعمل‌های پرش ۳۲ بیتی را فعال یا غیرفعال می‌کند. برای CPU v3 و بالاتر فعال است.
.IP \fB\-malu32\fR 4
.IX Item "-malu32"
.PD 0
.IP \fB\-mno\-alu32\fR 4
.IX Item "-mno-alu32"
.PD
تولید دستورالعمل‌های ۳۲ بیتی ALU را فعال یا غیرفعال می‌کند. برای CPU v3 و بالاتر فعال است.
.IP \fB\-mv3\-atomics\fR 4
.IX Item "-mv3-atomics"
.PD 0
.IP \fB\-mno\-v3\-atomics\fR 4
.IX Item "-mno-v3-atomics"
.PD
دستورالعمل‌های مربوط به عملیات اتمی عمومی معرفی‌شده در CPU v3 را فعال یا غیرفعال می‌کند. برای CPU v3 و بالاتر فعال است.
.IP \fB\-mbswap\fR 4
.IX Item "-mbswap"
.PD 0
.IP \fB\-mno\-bswap\fR 4
.IX Item "-mno-bswap"
.PD
دستورالعمل‌های جابه‌جایی بایت (byte swap) را فعال یا غیرفعال می‌کند. برای CPU v4 و بالاتر فعال است.
.IP \fB\-msdiv\fR 4
.IX Item "-msdiv"
.PD 0
.IP \fB\-mno\-sdiv\fR 4
.IX Item "-mno-sdiv"
.PD
دستورالعمل‌های تقسیم علامت‌دار و باقیمانده (modulus) را فعال یا غیرفعال می‌کند. برای CPU v4 و بالاتر فعال است..IP \fB\-msmov\fR 4
.IX Item "-msmov"
.PD 0
.IP \fB\-mno\-smov\fR 4
.IX Item "-mno-smov"
.PD
دستورالعمل‌های انتقال (move) با گسترش علامت (sign\-extending) و بارگذاری حافظه را فعال یا غیرفعال می‌کند.
برای پردازنده‌های v4 و بالاتر فعال است.
.IP \fB\-mcpu=\fR\fIversion\fR 4
.IX Item "-mcpu=version"
مشخص می‌کند که کدام نسخه از معماری مجموعه دستورالعمل‌های (ISA) eBPF هدف قرار گیرد. نسخه‌های جدیدتر ممکن است توسط همه کرنل‌ها پشتیبانی نشوند. مقدار پیش‌فرض \fBv4\fR است.
.Sp
مقادیر پشتیبانی‌شده برای \fIversion\fR عبارتند از:
.RS 4
.IP \fBv1\fR 4
.IX Item "v1"
نخستین ISA پایدار eBPF بدون ویژگی‌ها یا افزونه‌های ویژه.
.IP \fBv2\fR 4
.IX Item "v2"
پشتیبانی از افزونه‌های پرش (jump)، مانند آنچه در \fB\-mjmpext\fR آمده است.
.IP \fBv3\fR 4
.IX Item "v3"
همه قابلیت‌های v2، به‌علاوه:
.RS 4
.IP "\-<عملیات‌های پرش ۳۲\-بیتی، مانند \fB\-mjmp32\fR>" 4
.IX Item "-<32-bit jump operations, as in -mjmp32>"
.PD 0
.IP "\-<عملیات‌های ALU ۳۲\-بیتی، مانند \fB\-malu32\fR>" 4
.IX Item "-<32-bit ALU operations, as in -malu32>"
.IP "\-<عملیات‌های اتمیک عمومی، مانند \fB\-mv3\-atomics\fR>" 4
.IX Item "-<general atomic operations, as in -mv3-atomics>"
.PD
.RE
.RS 4
.RE
.IP \fBv4\fR 4
.IX Item "v4"
همه قابلیت‌های v3، به‌علاوه:
.RS 4
.IP "\-<دستورالعمل‌های جابه‌جایی بایت (Byte swap)، مانند \fB\-mbswap\fR>" 4
.IX Item "-<Byte swap instructions, as in -mbswap>"
.PD 0
.IP "\-<دستورالعمل‌های تقسیم و باقی‌مانده علامت‌دار، مانند \fB\-msdiv\fR>" 4
.IX Item "-<Signed division and modulus instructions, as in -msdiv>"
.IP "\-<دستورالعمل‌های انتقال با گسترش علامت و بارگذاری حافظه، مانند \fB\-msmov\fR>" 4
.IX Item "-<Sign-extending move and memory load instructions, as in -msmov>"
.PD
.RE
.RS 4
.RE
.RE
.RS 4
.RE
.IP \fB\-mco\-re\fR 4
.IX Item "-mco-re"
.PD 0
.IP \fB\-mno\-co\-re\fR 4
.IX Item "-mno-co-re"
.PD
پشتیبانی از BPF Compile Once \- Run Everywhere (CO\-RE) را فعال یا غیرفعال می‌کند.
پشتیبانی از BPF CO\-RE هنگام تولید اطلاعات اشکال‌زدایی BTF برای هدف BPF (\fB\-gbtf\fR) به‌طور پیش‌فرض فعال است.
.IP \fB\-mxbpf\fR 4
.IX Item "-mxbpf"
تولید کد برای یک نسخه گسترش‌یافته از BPF، که برخی از محدودیت‌های اعمال‌شده توسط معماری BPF را کاهش می‌دهد:
.RS 4
.IP "\-<ذخیره و بازیابی ثبات‌های callee\-saved به‌ترتیب در زمان ورود به تابع و>" 4
.IX Item "-<Save and restore callee-saved registers at function entry and>"
خروج از آن.
.RE
.RS 4
.RE
.IP \fB\-masm=\fR\fIdialect\fR 4
.IX Item "-masm=dialect"
دستورالعمل‌های اسمبلی را با استفاده از \fIdialect\fR انتخاب‌شده برای eBPF خروجی می‌دهد. مقدار پیش‌فرض \fBpseudoc\fR است.
.Sp
مقادیر پشتیبانی‌شده برای \fIdialect\fR عبارتند از:
.RS 4
.IP \fBnormal\fR 4
.IX Item "normal"
لهجه اسمبلی استاندارد را خروجی می‌دهد.
.IP \fBpseudoc\fR 4
.IX Item "pseudoc"
لهجه اسمبلی شبه‌سی (pseudo\-c) را خروجی می‌دهد.
.RE
.RS 4
.RE
.IP \fB\-minline\-memops\-threshold=\fR\fIbytes\fR 4
.IX Item "-minline-memops-threshold=bytes"
آستانه اندازه‌ای را بر حسب بایت مشخص می‌کند که در مقادیر کمتر یا مساوی آن، توابع memmove، memcpy و memset همواره باید به‌صورت درون‌خطی (inline) بسط داده شوند. عملیات‌هایی که با اندازه‌های بزرگ‌تر از این آستانه سروکار دارند، باید به‌جای بسط درون‌خطی با استفاده از فراخوانی کتابخانه پیاده‌سازی شوند؛ اما از آنجا که BPF فراخوانی‌های کتابخانه‌ای (libcalls) را مجاز نمی‌داند، فراتر رفتن از این آستانه منجر به خطای زمان کامپایل می‌شود. مقدار پیش‌فرض \fB1024\fR بایت است.
.IP \fB\-Wco\-re\fR 4
.IX Item "-Wco-re"
هشدارهایی را برای سناریوهایی فعال می‌کند که در آن‌ها \-mco\-re فعال است، اما امکان تولید کد سازگار با CO\-RE وجود ندارد.
.PP
\fIگزینه‌های FR30\fR
.IX Subsection "FR30 Options"
.PP
این گزینه‌ها به‌طور ویژه برای پورت FR30 تعریف شده‌اند.
.IP \fB\-msmall\-model\fR 4
.IX Item "-msmall-model"
استفاده از مدل فضای آدرس کوچک (small address space model). این گزینه می‌تواند کد کوچک‌تری تولید کند، اما فرض می‌کند که تمامی مقادیر نمادین و آدرس‌ها در یک محدوده ۲۰\-بیتی جای می‌گیرند.
.IP \fB\-mno\-lsim\fR 4
.IX Item "-mno-lsim"
فرض می‌کند که پشتیبانی زمان اجرا فراهم شده است و بنابراین نیازی به گنجاندن کتابخانه شبیه‌ساز (\fIlibsim.a\fR) در خط فرمان پیونددهنده نیست.
.PP
\fIگزینه‌های FRV\fR
.IX Subsection "FRV Options"
.IP \fB\-mgpr\-32\fR 4
.IX Item "-mgpr-32"
تنها از ۳۲ ثبات همه‌منظوره نخست استفاده می‌کند.
.IP \fB\-mgpr\-64\fR 4
.IX Item "-mgpr-64"
از تمامی ۶۴ ثبات همه‌منظوره استفاده می‌کند.
.IP \fB\-mfpr\-32\fR 4
.IX Item "-mfpr-32"
تنها از ۳۲ ثبات ممیز شناور نخست استفاده می‌کند.
.IP \fB\-mfpr\-64\fR 4
.IX Item "-mfpr-64"
از تمامی ۶۴ ثبات ممیز شناور استفاده می‌کند.
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
برای عملیات‌های ممیز شناور از دستورالعمل‌های سخت‌افزاری استفاده می‌کند.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
برای عملیات‌های ممیز شناور از توابع کتابخانه‌ای استفاده می‌کند.
.IP \fB\-malloc\-cc\fR 4
.IX Item "-malloc-cc"
تخصیص پویای ثبات‌های کد شرط (condition code).
.IP \fB\-mfixed\-cc\fR 4
.IX Item "-mfixed-cc"
برای تخصیص پویای ثبات‌های کد شرط تلاش نمی‌کند، تنها از \f(CW\*(C`icc0\*(C'\fR و \f(CW\*(C`fcc0\*(C'\fR استفاده می‌کند.
.IP \fB\-mdword\fR 4
.IX Item "-mdword"
.PD 0
.IP \fB\-mno\-dword\fR 4
.IX Item "-mno-dword"
.PD
کنترل می‌کند که آیا ABI از دستورالعمل‌های کلمه مضاعف (double\-word) استفاده کند یا خیر.
.IP \fB\-mdouble\fR 4
.IX Item "-mdouble"
.PD 0
.IP \fB\-mno\-double\fR 4
.IX Item "-mno-double"
.PD
استفاده از دستورالعمل‌های ممیز شناور دقت مضاعف (double) را فعال یا غیرفعال می‌کند.
.IP \fB\-mmedia\fR 4
.IX Item "-mmedia"
.PD 0
.IP \fB\-mno\-media\fR 4
.IX Item "-mno-media"
.PD
استفاده از دستورالعمل‌های چندرسانه‌ای (media) را فعال یا غیرفعال می‌کند.
.IP \fB\-mmuladd\fR 4
.IX Item "-mmuladd"
.PD 0
.IP \fB\-mno\-muladd\fR 4
.IX Item "-mno-muladd"
.PD
استفاده از دستورالعمل‌های ضرب و جمع/تفریق را فعال یا غیرفعال می‌کند.
.IP \fB\-mfdpic\fR 4
.IX Item "-mfdpic"
انتخاب ABI مربوط به FDPIC، که از توصیف‌گرهای تابع برای نمایش اشاره‌گرها به توابع استفاده می‌کند. بدون هیچ‌یک از گزینه‌های مرتبط با PIC/PIE، مستلزم \fB\-fPIE\fR است. همراه با \fB\-fpic\fR یا \fB\-fpie\fR، فرض می‌کند که ورودی‌های GOT و داده‌های کوچک در یک محدوده ۱۲\-بیتی از آدرس پایه GOT قرار دارند؛ با \fB\-fPIC\fR یا \fB\-fPIE\fR، آفست‌های GOT به‌صورت ۳۲ بیتی محاسبه می‌شوند.
با هدف \fBbfin\-elf\fR، این گزینه مستلزم \fB\-msim\fR است..IP \fB\-minline\-plt\fR 4
.IX Item "-minline-plt"
درون‌ریزی (inlining) مدخل‌های PLT را در فراخوانی توابعی که مقید شدن محلی (bind locally) آن‌ها محرز نیست، فعال می‌کند. این گزینه بدون \fB\-mfdpic\fR بی‌استفاده است. این قابلیت در صورت بهینه‌سازی برای سرعت و کامپایل برای کتابخانه‌های اشتراکی (یعنی \fB\-fPIC\fR یا \fB\-fpic\fR)، یا هنگامی که گزینه بهینه‌سازی مانند \fB\-O3\fR یا بالاتر در خط فرمان مشخص شده باشد، به‌طور پیش‌فرض فعال است.
.IP \fB\-mTLS\fR 4
.IX Item "-mTLS"
هنگام تولید کد محلیِ ریسه (thread-local)، قطعه (segment) بزرگ TLS را فرض می‌گیرد.
.IP \fB\-mtls\fR 4
.IX Item "-mtls"
هنگام تولید کد محلیِ ریسه، قطعه بزرگ TLS را فرض نمی‌گیرد.
.IP \fB\-mgprel\-ro\fR 4
.IX Item "-mgprel-ro"
استفاده از بازنشانی‌های (relocations) \f(CW\*(C`GPREL\*(C'\fR را در FDPIC ABI برای داده‌هایی که مشخص است در بخش‌های فقط‌خواندنی (read-only) قرار دارند فعال می‌کند. به‌طور پیش‌فرض فعال است، به‌جز برای \fB\-fpic\fR یا \fB\-fpie\fR: هرچند ممکن است به کوچک‌تر شدن جدول آفست سراسری (GOT) کمک کند، اما ۱ دستورالعمل را با ۴ دستورالعمل معاوضه می‌کند. با \fB\-fPIC\fR یا \fB\-fPIE\fR، ۳ دستورالعمل را با ۴ دستورالعمل معاوضه می‌کند که یکی از آن‌ها می‌تواند بین چندین نماد به اشتراک گذاشته شود و از نیاز به یک مدخل GOT برای نماد ارجاع‌شده جلوگیری می‌کند، بنابراین احتمال سودمندی آن بیشتر است. در غیر این صورت، می‌توان از \fB\-mno\-gprel\-ro\fR برای غیرفعال کردن آن استفاده کرد.
.IP \fB\-multilib\-library\-pic\fR 4
.IX Item "-multilib-library-pic"
پیوند با کتابخانه‌های pic (کتابخانه‌ای، نه FD). این گزینه به‌طور ضمنی توسط \fB\-mlibrary\-pic\fR و همچنین \fB\-fPIC\fR و \fB\-fpic\fR بدون \fB\-mfdpic\fR فعال می‌شود. هرگز نباید نیاز به استفاده صریح از آن داشته باشید.
.IP \fB\-mlinked\-fp\fR 4
.IX Item "-mlinked-fp"
از الزام EABI مبنی بر ایجاد همیشگی اشاره‌گر فریم (frame pointer) در زمان تخصیص یک فریم پشته (stack frame) پیروی می‌کند. این گزینه به‌طور پیش‌فرض فعال است و می‌توان با \fB\-mno\-linked\-fp\fR آن را غیرفعال کرد.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
استفاده از آدرس‌دهی غیرمستقیم برای فراخوانی توابع خارج از واحد ترجمه (compilation unit) فعلی. این امکان را فراهم می‌سازد که توابع در هر نقطه‌ای از فضای آدرس‌دهی ۳۲ بیتی قرار گیرند.
.IP \fB\-malign\-labels\fR 4
.IX Item "-malign-labels"
تلاش می‌کند تا برچسب‌ها را با درج NOP در بسته (packet) قبلی، روی مرز ۸ بایتی تراز کند. این گزینه فقط زمانی تأثیر دارد که بسته‌بندی VLIW فعال باشد. این گزینه بسته جدیدی ایجاد نمی‌کند؛ بلکه صرفاً NOPها را به بسته‌های موجود اضافه می‌کند.
.IP \fB\-mlibrary\-pic\fR 4
.IX Item "-mlibrary-pic"
تولید کد EABI مستقل از موقعیت (position-independent).
.IP \fB\-macc\-4\fR 4
.IX Item "-macc-4"
فقط از چهار ثبات انباشتگر چندرسانه‌ای (media accumulator) اول استفاده می‌کند.
.IP \fB\-macc\-8\fR 4
.IX Item "-macc-8"
از هر هشت ثبات انباشتگر چندرسانه‌ای استفاده می‌کند.
.IP \fB\-mpack\fR 4
.IX Item "-mpack"
.PD 0
.IP \fB\-mno\-pack\fR 4
.IX Item "-mno-pack"
.PD
فعال یا غیرفعال کردن بسته‌بندی دستورالعمل‌های VLIW.
.IP \fB\-mno\-eflags\fR 4
.IX Item "-mno-eflags"
سوئیچ‌های ABI را در e_flags علامت‌گذاری نمی‌کند.
.IP \fB\-mcond\-move\fR 4
.IX Item "-mcond-move"
.PD 0
.IP \fB\-mno\-cond\-move\fR 4
.IX Item "-mno-cond-move"
.PD
فعال یا غیرفعال کردن استفاده از دستورالعمل‌های انتقال شرطی (conditional-move)؛ این گزینه به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-mscc\fR 4
.IX Item "-mscc"
.PD 0
.IP \fB\-mno\-scc\fR 4
.IX Item "-mno-scc"
.PD
فعال یا غیرفعال کردن استفاده از دستورالعمل‌های مقداردهی شرطی (conditional set)؛ به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-mcond\-exec\fR 4
.IX Item "-mcond-exec"
.PD 0
.IP \fB\-mno\-cond\-exec\fR 4
.IX Item "-mno-cond-exec"
.PD
فعال یا غیرفعال کردن استفاده از اجرای شرطی (conditional execution)؛ به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-mvliw\-branch\fR 4
.IX Item "-mvliw-branch"
.PD 0
.IP \fB\-mno\-vliw\-branch\fR 4
.IX Item "-mno-vliw-branch"
.PD
فعال یا غیرفعال کردن یک گام بهینه‌سازی برای بسته‌بندی انشعاب‌ها (branches) در دستورالعمل‌های VLIW؛ به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-mmulti\-cond\-exec\fR 4
.IX Item "-mmulti-cond-exec"
.PD 0
.IP \fB\-mno\-multi\-cond\-exec\fR 4
.IX Item "-mno-multi-cond-exec"
.PD
فعال یا غیرفعال کردن بهینه‌سازی \f(CW\*(C`&&\*(C'\fR و \f(CW\*(C`||\*(C'\fR در اجرای شرطی؛ به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-mnested\-cond\-exec\fR 4
.IX Item "-mnested-cond-exec"
.PD 0
.IP \fB\-mno\-nested\-cond\-exec\fR 4
.IX Item "-mno-nested-cond-exec"
.PD
فعال یا غیرفعال کردن بهینه‌سازی‌های اجرای شرطی تودرتو؛ به‌طور پیش‌فرض فعال است.
.Sp
این سوئیچ عمدتاً برای اشکال‌زدایی کامپایلر است و احتمالاً در نسخه‌های آینده حذف خواهد شد.
.IP \fB\-moptimize\-membar\fR 4
.IX Item "-moptimize-membar"
.PD 0
.IP \fB\-mno\-optimize\-membar\fR 4
.IX Item "-mno-optimize-membar"
.PD
این سوئیچ دستورالعمل‌های زائد \f(CW\*(C`membar\*(C'\fR را از کد تولیدشده توسط کامپایلر حذف می‌کند. به‌طور پیش‌فرض فعال است.
.IP \fB\-mtomcat\-stats\fR 4
.IX Item "-mtomcat-stats"
باعث می‌شود gas آمار tomcat را چاپ کند.
.IP \fB\-mcpu=\fR\fIcpu\fR 4
.IX Item "-mcpu=cpu"
نوع پردازنده‌ای که کد برای آن تولید می‌شود را مشخص می‌کند. مقادیر ممکن عبارتند از:
\&\fBfrv\fR، \fBfr550\fR، \fBtomcat\fR، \fBfr500\fR، \fBfr450\fR،
\&\fBfr405\fR، \fBfr400\fR، \fBfr300\fR و \fBsimple\fR.
.PP
\fIگزینه‌های FT32 (FT32 Options)\fR
.IX Subsection "FT32 Options"
.PP
این گزینه‌ها به‌طور خاص برای معماری FT32 تعریف شده‌اند.
.IP \fB\-msim\fR 4
.IX Item "-msim"
مشخص می‌کند که برنامه روی شبیه‌ساز (simulator) اجرا خواهد شد. این کار باعث پیوند خوردن کتابخانه و کد راه‌اندازی (startup) زمان اجرای متفاوتی می‌شود.
هنگام تولید برنامه‌هایی که روی سخت‌افزار واقعی اجرا می‌شوند، نباید از این گزینه استفاده کنید؛ باید کتابخانه زمان اجرای خود را برای هرگونه توابع ورودی/خروجی مورد نیاز فراهم کنید.
.IP \fB\-mnodiv\fR 4
.IX Item "-mnodiv"
از دستورالعمل‌های div و mod استفاده نمی‌کند.
.IP \fB\-mft32b\fR 4
.IX Item "-mft32b"
استفاده از دستورالعمل‌های توسعه‌یافته پردازنده FT32B را فعال می‌کند.
.IP \fB\-mcompress\fR 4
.IX Item "-mcompress"
تمام کد را با استفاده از طرح فشرده‌سازی کد FT32B فشرده می‌کند.
.IP \fB\-mnopm\fR 4
.IX Item "-mnopm"
کدی تولید نمی‌کند که حافظه برنامه (program memory) را بخواند.
.PP
\fIگزینه‌های GNU/Linux (GNU/Linux Options)\fR
.IX Subsection "GNU/Linux Options"
.PP
این گزینه‌های \fB\-m\fR برای مقاصد GNU/Linux تعریف شده‌اند:
.IP \fB\-mglibc\fR 4
.IX Item "-mglibc"
استفاده از کتابخانه GNU C (glibc). این گزینه به‌طور پیش‌فرض فعال است، مگر در مقاصد
\&\fB*\-*\-linux\-*uclibc*\fR، \fB*\-*\-linux\-*musl*\fR و
\&\fB*\-*\-linux\-*android*\fR..IP \fB\-muclibc\fR 4
.IX Item "-muclibc"
استفاده از کتابخانهٔ سی uClibc. این رفتار پیش‌فرض در هدف‌های
\&\fB*\-*\-linux\-*uclibc*\fR است.
.IP \fB\-mmusl\fR 4
.IX Item "-mmusl"
استفاده از کتابخانهٔ سی musl. این رفتار پیش‌فرض در هدف‌های
\&\fB*\-*\-linux\-*musl*\fR است.
.IP \fB\-mbionic\fR 4
.IX Item "-mbionic"
استفاده از کتابخانهٔ سی Bionic. این رفتار پیش‌فرض در هدف‌های
\&\fB*\-*\-linux\-*android*\fR است.
.IP \fB\-mandroid\fR 4
.IX Item "-mandroid"
.PD 0
.IP \fB\-mno\-android\fR 4
.IX Item "-mno-android"
.PD
کامپایل کد سازگار با پلتفرم Android. این رفتار پیش‌فرض روی هدف‌های
\&\fB*\-*\-linux\-*android*\fR است.
.Sp
هنگام کامپایل، این گزینه به‌طور پیش‌فرض \fB\-mbionic\fR، \fB\-fPIC\fR،
\&\fB\-fno\-exceptions\fR و \fB\-fno\-rtti\fR را فعال می‌کند. هنگام پیوند،
این گزینه باعث می‌شود راه‌انداز GCC گزینه‌های مختص Android را به پیونددهنده پاس دهد.
در نهایت، این گزینه موجب تعریف شدن ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_ANDROID_\|_\*(C'\fR
می‌شود.
.Sp
این گزینه را می‌توان به‌طور کامل با \fB\-mno\-android\fR غیرفعال کرد.
.IP \fB\-tno\-android\-cc\fR 4
.IX Item "-tno-android-cc"
غیرفعال کردن اثرات کامپایلیِ \fB\-mandroid\fR، یعنی عدم فعال‌سازی
\&\fB\-mbionic\fR، \fB\-fPIC\fR، \fB\-fno\-exceptions\fR و
\&\fB\-fno\-rtti\fR به‌طور پیش‌فرض.
.IP \fB\-tno\-android\-ld\fR 4
.IX Item "-tno-android-ld"
غیرفعال کردن اثرات پیوندِ \fB\-mandroid\fR، یعنی ارسال گزینه‌های پیوند استاندارد
Linux به پیونددهنده.
.PP
\fIگزینه‌های H8/300\fR
.IX Subsection "H8/300 Options"
.PP
این گزینه‌های \fB\-m\fR برای پیاده‌سازی‌های H8/300 تعریف شده‌اند:
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
کوتاه‌تر کردن برخی از ارجاعات آدرس در زمان پیوند در صورت امکان؛ از گزینهٔ
پیونددهندهٔ \fB\-relax\fR استفاده می‌کند.
.IP \fB\-mh\fR 4
.IX Item "-mh"
تولید کد برای H8/300H.
.IP \fB\-ms\fR 4
.IX Item "-ms"
تولید کد برای H8S.
.IP \fB\-mn\fR 4
.IX Item "-mn"
تولید کد برای H8S و H8/300H در حالت عادی (normal mode). این سوییچ
باید همراه با \fB\-mh\fR یا \fB\-ms\fR استفاده شود.
.IP \fB\-msx\fR 4
.IX Item "-msx"
تولید کد H8SX.
.IP \fB\-ms2600\fR 4
.IX Item "-ms2600"
تولید کد برای H8S/2600. این سوییچ باید همراه با \fB\-ms\fR استفاده شود.
.IP \fB\-mquickcall\fR 4
.IX Item "-mquickcall"
استفاده از ثبات‌ها برای ارسال آرگومان.
.IP \fB\-mslowbyte\fR 4
.IX Item "-mslowbyte"
کند در نظر گرفتن دسترسی به حافظه در اندازهٔ بایت.
.IP \fB\-mexr\fR 4
.IX Item "-mexr"
.PD 0
.IP \fB\-mno\-exr\fR 4
.IX Item "-mno-exr"
.PD
ذخیرهٔ ثبات‌های گسترش‌یافته روی پشته قبل از اجرای توابعی
با مشخصهٔ \f(CW\*(C`monitor\*(C'\fR.
پیش‌فرض \fB\-mexr\fR است. این گزینه فقط برای هدف‌های H8S معتبر است.
.IP \fB\-mint32\fR 4
.IX Item "-mint32"
تنظیم اندازهٔ داده‌های \f(CW\*(C`int\*(C'\fR به‌طور پیش‌فرض روی ۳۲ بیت.
.IP \fB\-malign\-300\fR 4
.IX Item "-malign-300"
در H8/300H و H8S، از همان قواعد ترازسازی مشابه H8/300 استفاده می‌کند.
پیش‌فرض برای H8/300H و H8S تراز کردن داده‌های long و float روی
مرزهای ۴ بایتی است.
\&\fB\-malign\-300\fR باعث تراز شدن آن‌ها روی مرزهای ۲ بایتی می‌شود.
این گزینه روی H8/300 هیچ اثری ندارد.
.PP
\fIگزینه‌های HPPA\fR
.IX Subsection "HPPA Options"
.PP
این گزینه‌های \fB\-m\fR برای خانوادهٔ رایانه‌های HPPA تعریف شده‌اند:
.IP \fB\-march=\fR\fIarchitecture\-type\fR 4
.IX Item "-march=architecture-type"
تولید کد برای معماری مشخص‌شده. گزینه‌های موجود برای
\&\fIarchitecture\-type\fR عبارتند از \fB1.0\fR برای پردازنده‌های PA 1.0،
\&\fB1.1\fR برای PA 1.1، و \fB2.0\fR برای پردازنده‌های PA 2.0. برای تعیین گزینهٔ
معماری مناسب برای دستگاه خود، به فایل
\&\fI/usr/lib/sched.models\fR در یک سیستم HP\-UX مراجعه کنید. کدهای کامپایل‌شده برای
معماری‌های با شمارهٔ پایین‌تر روی معماری‌های با شمارهٔ بالاتر اجرا می‌شوند، اما
عکس آن صادق نیست.
.IP \fB\-mpa\-risc\-1\-0\fR 4
.IX Item "-mpa-risc-1-0"
.PD 0
.IP \fB\-mpa\-risc\-1\-1\fR 4
.IX Item "-mpa-risc-1-1"
.IP \fB\-mpa\-risc\-2\-0\fR 4
.IX Item "-mpa-risc-2-0"
.PD
به‌ترتیب مترادف‌هایی برای \fB\-march=1.0\fR، \fB\-march=1.1\fR و \fB\-march=2.0\fR هستند.
.IP \fB\-matomic\-libcalls\fR 4
.IX Item "-matomic-libcalls"
.PD 0
.IP \fB\-mno\-atomic\-libcalls\fR 4
.IX Item "-mno-atomic-libcalls"
.PD
تولید libcallها برای بارگذاری‌ها و ذخیره‌سازی‌های اتمیک در صورت غیرفعال بودن sync libcallها.
این گزینه به‌طور پیش‌فرض فعال است. این گزینه تنها بر تولید
libcallهای اتمیک توسط backend مربوط به HPPA تأثیر می‌گذارد.
.Sp
هر دوی پیاده‌سازی‌های فراخوانی کتابخانه‌ای sync و \fIlibatomic\fR از قفل‌گذاری استفاده می‌کنند.
در نتیجه، عمل‌های ذخیره در پردازنده نسبت به سایر عملیات اتمیک، اتمیک
نیستند. عمل‌های بارگذاری پردازنده تا اندازهٔ DImode نسبت به سایر عملیات اتمیک
اتمیک هستند، به شرطی که به‌صورت یک دسترسی واحد پیاده‌سازی شده باشند.
.Sp
معماری PA\-RISC به جز دستورالعمل \f(CW\*(C`ldcw\*(C'\fR از هیچ عملیات اتمیکی در سخت‌افزار
پشتیبانی نمی‌کند. بنابراین، تمام پشتیبانی اتمیک با استفاده از libcallهای sync و atomic
پیاده‌سازی شده است. پشتیبانی از sync libcall در \fIlibgcc.a\fR و پشتیبانی از
atomic libcall در \&\fIlibatomic\fR قرار دارد.
.Sp
این گزینه فراخوانی‌های \f(CW\*(C`_\|_atomic_exchange\*(C'\fR را برای ذخیره‌های اتمیک تولید می‌کند.
همچنین مدیریت ویژه‌ای را برای دسترسی‌های اتمیک DImode روی هدف‌های ۳۲ بیتی
فراهم می‌آورد.
.IP \fB\-mcaller\-copies\fR 4
.IX Item "-mcaller-copies"
فراخواننده (caller) آرگومان‌های تابعی را که با ارجاع پنهان ارسال شده‌اند کپی می‌کند. این
گزینه باید با احتیاط استفاده شود چرا که با زمان‌اجرای پیش‌فرض
۳۲ بیتی سازگار نیست. با این حال، فقط ساختارهای داده‌ای بزرگ‌تر از هشت بایت
با ارجاع پنهان ارسال می‌شوند و این گزینه سازگاری بهتری با OpenMP فراهم می‌کند.
.IP \fB\-mcoherent\-ldcw\fR 4
.IX Item "-mcoherent-ldcw"
استفاده از راهنمایی کنترل حافظه موقتِ همگام (coherent cache\-control hint) برای ldcw/ldcd.
.IP \fB\-mdisable\-fpregs\fR 4
.IX Item "-mdisable-fpregs"
غیرفعال کردن ثبات‌های ممیز شناور. معادل \fB\-msoft\-float\fR است.
.IP \fB\-mdisable\-indexing\fR 4
.IX Item "-mdisable-indexing"
جلوگیری از استفادهٔ کامپایلر از حالت‌های آدرس‌دهی اندیسی. این کار از برخی
مشکلات مبهم هنگام کامپایل کد تولیدشده توسط MIG در MACH جلوگیری می‌کند.
.IP \fB\-mfast\-indirect\-calls\fR 4
.IX Item "-mfast-indirect-calls"
تولید کدی با این فرض که فراخوانی‌ها هرگز از مرزهای فضایی عبور نمی‌کنند. این
به GCC اجازه می‌دهد کدی با فراخوانی‌های غیرمستقیم سریع‌تر تولید کند.
.Sp
این گزینه در حضور کتابخانه‌های مشترک یا توابع تودرتو کار نمی‌کند.
.IP \fB\-mfixed\-range=\fR\fIregister\-range\fR 4
.IX Item "-mfixed-range=register-range"
تولید کدی که با محدودهٔ ثبات داده‌شده به عنوان ثبات‌های ثابت برخورد می‌کند.
یک ثبات ثابت ثباتی است که تخصیص‌دهندهٔ ثبات نمی‌تواند از آن استفاده کند. این گزینه
هنگام کامپایل کد هسته مفید است. محدودهٔ ثبات به‌صورت دو ثبات
که با یک خط تیره از هم جدا شده‌اند مشخص می‌شود. می‌توان چندین محدودهٔ ثبات را
به‌صورت جداشده با کاما تعیین کرد.
.IP \fB\-mgas\fR 4
.IX Item "-mgas"
فعال‌سازی استفاده از دستورالعمل‌های اسمبلری که فقط GAS متوجه آن‌ها می‌شود.
.IP \fB\-mgnu\-ld\fR 4
.IX Item "-mgnu-ld"
استفاده از گزینه‌های مخصوص به GNU \fBld\fR.
این کار هنگام ساخت یک کتابخانهٔ مشترک، \fB\-shared\fR را به \fBld\fR
ارسال می‌کند. این رفتار پیش‌فرض است زمانی که GCC به‌طور صریح یا
ضمنی با پیونددهندهٔ GNU پیکربندی شده باشد. این گزینه بر این‌که
کدام \fBld\fR فراخوانی شود اثری ندارد؛ بلکه تنها پارامترهای ارسالی
به آن \fBld\fR را تغییر می‌دهد.
پیونددهنده‌ای که فراخوانی می‌شود با گزینهٔ پیکربندی
\&\fB\-\-with\-ld\fR، مسیر جستجوی برنامه در GCC و در نهایت با \fBPATH\fR کاربر
تعیین می‌شود. پیونددهندهٔ مورداستفاده توسط GCC را می‌توان با دستور
\&\fBwhich \`gcc \-print\-prog\-name=ld\`\fR چاپ کرد. این گزینه تنها روی
GCC مربوط به HP\-UX شصت و چهار بیتی، یعنی پیکربندی‌شده با \fBhppa*64*\-*\-hpux*\fR، در دسترس است..IP \fB\-mhp\-ld\fR 4
.IX Item "-mhp-ld"
استفاده از گزینه‌های مخصوص به \fBld\fR شرکت HP.
این گزینه در هنگام ساخت یک کتابخانهٔ مشترک، مقدار \fB\-b\fR را به \fBld\fR ارسال می‌کند و در تمامی پیوندها، \fB+Accept TypeMismatch\fR را به \fBld\fR می‌فرستد. این رفتار پیش‌فرض است هنگامی که GCC به‌صورت صریح یا ضمنی با پیونددهندهٔ HP پیکربندی شده باشد. این گزینه بر این‌که کدام \fBld\fR فراخوانی شود تأثیری ندارد؛ فقط پارامترهایی را که به آن \fBld\fR ارسال می‌شوند تغییر می‌دهد.
پیونددهندهٔ \fBld\fR فراخوانی‌شده توسط گزینهٔ پیکربندی \fB\-\-with\-ld\fR، مسیر جستجوی برنامه‌های GCC، و در نهایت توسط \fBPATH\fR کاربر تعیین می‌شود. پیونددهندهٔ استفاده‌شده توسط GCC را می‌توان با دستور \fBwhich \&\`gcc \-print\-prog\-name=ld\`\fR مشاهده کرد. این گزینه تنها در GCC ۶۴-بیتی HP\-UX، یعنی پیکربندی‌شده با \fBhppa*64*\-*\-hpux*\fR، در دسترس است.
.IP \fB\-mlinker\-opt\fR 4
.IX Item "-mlinker-opt"
گذر بهینه‌سازی را در پیونددهندهٔ HP\-UX فعال می‌کند. توجه داشته باشید که این کار دیباگ نمادین را غیرممکن می‌سازد.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
تولید کدی که از توالی‌های فراخوانی طولانی استفاده می‌کند. این کار تضمین می‌کند که یک فراخوانی همواره بتواند به stubهای تولیدشده توسط پیونددهنده دسترسی یابد. رفتار پیش‌فرض این است که فراخوانی‌های طولانی تنها زمانی تولید شوند که فاصله از محل فراخوانی تا ابتدای تابع یا واحد ترجمه (بسته به مورد)، از حد از پیش تعیین‌شده‌ای که بر پایهٔ نوع انشعاب مورداستفاده مشخص شده، فراتر رود. محدودیت‌ها برای فراخوانی‌های عادی به‌ترتیب ۷,۶۰۰,۰۰۰ و ۲۴۰,۰۰۰ بایت برای معماری‌های PA 2.0 و PA 1.X است. فراخوانی‌های هم‌سطح (Sibling calls) همیشه به ۲۴۰,۰۰۰ بایت محدود هستند.
.Sp
فاصله‌ها هنگام استفاده از گزینهٔ \fB\-ffunction\-sections\fR، یا هنگام استفاده از گزینه‌های \fB\-mgas\fR و \fB\-mno\-portable\-runtime\fR در کنار هم تحت HP\-UX با پیونددهندهٔ SOM، از ابتدای توابع اندازه‌گیری می‌شوند.
.Sp
معمولاً استفاده از این گزینه مطلوب نیست زیرا کارایی را کاهش می‌دهد. با این حال، ممکن است در برنامه‌های بزرگ، به‌ویژه زمانی که از پیوند جزئی (partial linking) برای ساخت برنامه استفاده می‌شود، مفید باشد.
.Sp
انواع فراخوانی‌های طولانی مورداستفاده به توانمندی‌های اسمبلر و پیونددهنده و نوع کدی که تولید می‌شود بستگی دارد. تأثیر آن بر سیستم‌هایی که از فراخوانی‌های طولانی مطلق، و فراخوانی‌های طولانی تفاضل نماد PIC یا فراخوانی‌های نسبی نسبت به PC پشتیبانی می‌کنند باید نسبتاً اندک باشد. با این حال، در سیستم‌های ۳۲-بیتی ELF در کد PIC از فراخوانی غیرمستقیم استفاده می‌شود که بسیار طولانی است.
.IP \fB\-mlong\-load\-store\fR 4
.IX Item "-mlong-load-store"
توالی‌های بارگذاری و ذخیره‌سازی سه‌دستوری را آن‌گونه که گاهی توسط پیونددهندهٔ HP\-UX 10 الزام می‌شود تولید می‌کند. این گزینه معادل گزینهٔ \fB+k\fR در کامپایلرهای HP است.
.IP \fB\-mno\-space\-regs\fR 4
.IX Item "-mno-space-regs"
کدی تولید می‌کند که فرض می‌کند مقصد فاقد ثبات‌های فضا (space registers) است. این به GCC اجازه می‌دهد فراخوانی‌های غیرمستقیم سریع‌تری تولید کرده و از حالت‌های آدرس‌دهی اندیس‌دار مقیاس‌بندی‌نشده استفاده کند.
.Sp
چنین کدی برای سیستم‌های PA سطح ۰ و هسته‌ها مناسب است.
.IP \fB\-mordered\fR 4
.IX Item "-mordered"
فرض می‌کند که ارجاعات به حافظه مرتب هستند و نیازی به حائل‌ها (barriers) نیست.
.IP \fB\-mportable\-runtime\fR 4
.IX Item "-mportable-runtime"
استفاده از قراردادهای فراخوانی قابل‌حمل پیشنهادشده توسط HP برای سیستم‌های ELF.
.IP \fB\-mschedule=\fR\fIcpu\-type\fR 4
.IX Item "-mschedule=cpu-type"
کد را با توجه به محدودیت‌های نوع ماشین \fIcpu\-type\fR زمان‌بندی می‌کند. گزینه‌های انتخابی برای \fIcpu\-type\fR عبارتند از \fB700\fR، \fB7100\fR، \fB7100LC\fR، \fB7200\fR، \fB7300\fR و \fB8000\fR. برای تعیین گزینهٔ زمان‌بندی مناسب برای دستگاه خود، در یک سیستم HP\-UX به \fI/usr/lib/sched.models\fR مراجعه کنید. زمان‌بندی پیش‌فرض \fB8000\fR است.
.IP \fB\-msio\fR 4
.IX Item "-msio"
.PD 0
.IP \fB\-mwsio\fR 4
.IX Item "-mwsio"
.PD
گزینهٔ \fB\-msio\fR تعریف پیشین \f(CW\*(C`_SIO\*(C'\fR را برای IO کارساز تولید می‌کند. پیش‌فرض
\&\fB\-mwsio\fR است. این گزینه تعاریف پیشین \f(CW\*(C`_\|_hp9000s700\*(C'\fR،
\&\f(CW\*(C`_\|_hp9000s700_\|_\*(C'\fR و \f(CW\*(C`_WSIO\*(C'\fR را برای IO ایستگاه کاری تولید می‌کند. این
گزینه‌ها تحت HP\-UX و HI\-UX در دسترس هستند.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
خروجی حاوی فراخوانی‌های کتابخانه‌ای برای محاسبات ممیز شناور تولید می‌کند.
\&\fBهشدار:\fR کتابخانه‌های ضروری برای تمامی مقصدهای HPPA در دسترس نیستند. معمولاً از امکانات کامپایلر C مرسوم دستگاه استفاده می‌شود، اما این کار در کامپایل متقاطع به‌صورت مستقیم امکان‌پذیر نیست. شما باید خودتان تمهیدات لازم را برای فراهم کردن توابع کتابخانه‌ای مناسب برای کامپایل متقاطع مهیا کنید.
.Sp
گزینهٔ \fB\-msoft\-float\fR قرارداد فراخوانی را در فایل خروجی تغییر می‌دهد؛ بنابراین تنها زمانی مفید است که \fIتمام\fR برنامه را با این گزینه کامپایل کنید. به‌ویژه، برای این‌که این قابلیت کار کند باید \fIlibgcc.a\fR، کتابخانه‌ای که همراه با GCC ارائه می‌شود، را با \fB\-msoft\-float\fR کامپایل کنید.
.IP \fB\-msoft\-mult\fR 4
.IX Item "-msoft-mult"
استفاده از ضرب عدد صحیح نرم‌افزاری.
.Sp
این گزینه استفاده از دستورالعمل \f(CW\*(C`xmpyu\*(C'\fR را غیرفعال می‌کند.
.IP \fB\-munix=\fR\fIunix\-std\fR 4
.IX Item "-munix=unix-std"
تعاریف پیشین کامپایلر را تولید کرده و یک startfile برای استاندارد UNIX مشخص‌شده برمی‌گزیند. گزینه‌های قابل انتخاب برای \fIunix\-std\fR شامل \fB93\fR، \fB95\fR
و \fB98\fR است. مقدار \fB93\fR در تمام نسخه‌های HP\-UX پشتیبانی می‌شود. مقدار \fB95\fR
در HP\-UX 10.10 و بعد از آن در دسترس است. مقدار \fB98\fR در HP\-UX
11.11 و بعد از آن موجود است. مقادیر پیش‌فرض عبارتند از \fB93\fR برای HP\-UX 10.00،
\&\fB95\fR برای HP\-UX 10.10 تا 11.00، و \fB98\fR برای HP\-UX 11.11
و پس از آن.
.Sp
گزینهٔ \fB\-munix=93\fR تعاریف پیشین مشابه با GCC 3.3 و 3.4 را ارائه می‌دهد.
\&\fB\-munix=95\fR تعاریف پیشین اضافی برای \f(CW\*(C`XOPEN_UNIX\*(C'\fR
و \f(CW\*(C`_XOPEN_SOURCE_EXTENDED\*(C'\fR، و فایل آغازین \fIunix95.o\fR را فراهم می‌کند.
\&\fB\-munix=98\fR تعاریف پیشین اضافی برای \f(CW\*(C`_XOPEN_UNIX\*(C'\fR،
\&\f(CW\*(C`_XOPEN_SOURCE_EXTENDED\*(C'\fR، \f(CW\*(C`_INCLUDE_\|_STDC_A1_SOURCE\*(C'\fR و
\&\f(CW\*(C`_INCLUDE_XOPEN_SOURCE_500\*(C'\fR، و فایل آغازین \fIunix98.o\fR را مهیا می‌سازد.
.Sp
\fIمهم\fR است بدانید که این گزینه رابط‌های روتین‌های مختلف کتابخانه‌ای را تغییر می‌دهد. همچنین بر رفتار عملیاتی کتابخانهٔ C اثر می‌گذارد. بنابراین در استفاده از این گزینه نیاز به احتیاط \fIفوق‌العاده\fR است.
.Sp
کد کتابخانه‌ای که قصد دارد با بیش از یک استاندارد UNIX کار کند باید متغیر \f(CW\*(C`_\|_xpg4_extended_mask\*(C'\fR را بر حسب مورد آزمایش، تنظیم و بازیابی کند. بیشتر نرم‌افزارهای GNU این قابلیت را ارائه نمی‌دهند.
.IP \fB\-nolibdld\fR 4
.IX Item "-nolibdld"
جلوگیری از تولید گزینه‌های پیوند برای جستجوی \fIlibdld.sl\fR هنگامی که گزینهٔ
\&\fB\-static\fR در HP\-UX 10 و بالاتر مشخص شده است.
.IP \fB\-static\fR 4
.IX Item "-static"
پیاده‌سازی \f(CW\*(C`setlocale\*(C'\fR در کتابخانهٔ C متعلق به HP\-UX به \fIlibdld.sl\fR وابسته است. نسخهٔ بایگانی‌شده‌ای از \fIlibdld.sl\fR وجود ندارد. بنابراین زمانی که گزینهٔ \fB\-static\fR تعیین می‌شود، به گزینه‌های پیوند ویژه‌ای برای رفع این وابستگی نیاز است.
.Sp
در HP\-UX 10 و بالاتر، درایور GCC در زمان مشخص شدن گزینهٔ \fB\-static\fR، گزینه‌های ضروری برای پیوند با \fIlibdld.sl\fR را می‌افزاید. این موضوع باعث می‌شود باینری حاصل به‌صورت پویا باشد. در پورت ۶۴-بیتی، پیونددهنده‌ها در هر حال به‌طور پیش‌فرض باینری‌های پویا تولید می‌کنند. گزینهٔ \fB\-nolibdld\fR می‌تواند برای ممانعت از افزودن این گزینه‌های پیوند توسط درایور GCC به کار رود.
.IP \fB\-threads\fR 4
.IX Item "-threads"
پشتیبانی از چندریسمانی با کتابخانهٔ \fIdce thread\fR را تحت HP\-UX اضافه می‌کند. این گزینه پرچم‌هایی را هم برای پیش‌پردازنده و هم برای پیونددهنده تنظیم می‌کند.
.PP
\fIگزینه‌های IA\-64 (IA\-64 Options)\fR
.IX Subsection "IA-64 Options"
.PP
این‌ها گزینه‌های \fB\-m\fR هستند که برای معماری Intel IA\-64 تعریف شده‌اند.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
تولید کد برای مقصد بزرگ‌پایان (big\-endian). این مقدار پیش‌فرض برای HP\-UX است.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
تولید کد برای مقصد کوچک‌پایان (little\-endian). این مقدار پیش‌فرض برای AIX5 و GNU/Linux است.
.IP \fB\-mgnu\-as\fR 4
.IX Item "-mgnu-as"
.PD 0
.IP \fB\-mno\-gnu\-as\fR 4
.IX Item "-mno-gnu-as"
.PD
تولید (یا عدم تولید) کد برای اسمبلر GNU. این رفتار پیش‌فرض است.
.IP \fB\-mgnu\-ld\fR 4
.IX Item "-mgnu-ld"
.PD 0
.IP \fB\-mno\-gnu\-ld\fR 4
.IX Item "-mno-gnu-ld"
.PD
تولید (یا عدم تولید) کد برای پیونددهندهٔ GNU. این رفتار پیش‌فرض است.
.IP \fB\-mno\-pic\fR 4
.IX Item "-mno-pic"
تولید کدی که از ثبات اشاره‌گر عمومی استفاده نمی‌کند. نتیجه، کد مستقل از موقعیت نخواهد بود و ABI متعلق به IA\-64 را نقض می‌کند.
.IP \fB\-mvolatile\-asm\-stop\fR 4
.IX Item "-mvolatile-asm-stop"
.PD 0
.IP \fB\-mno\-volatile\-asm\-stop\fR 4
.IX Item "-mno-volatile-asm-stop".PD
تولید کردن (یا نکردن) بیت توقف (stop bit) بلافاصله پیش و پس از عبارت‌های volatile asm.
.IP \fB\-mregister\-names\fR 4
.IX Item "-mregister-names"
.PD 0
.IP \fB\-mno\-register\-names\fR 4
.IX Item "-mno-register-names"
.PD
تولید کردن (یا نکردن) نام‌های ثبات \fBin\fR، \fBloc\fR و \fBout\fR برای ثبات‌های پشته‌ای (stacked registers). این کار ممکن است خوانایی خروجی اسمبلر را افزایش دهد.
.IP \fB\-mno\-sdata\fR 4
.IX Item "-mno-sdata"
.PD 0
.IP \fB\-msdata\fR 4
.IX Item "-msdata"
.PD
غیرفعال‌سازی (یا فعال‌سازی) بهینه‌سازی‌هایی که از بخش داده‌های کوچک (small data section) استفاده می‌کنند. این گزینه ممکن است برای دور زدن اشکالات بهینه‌ساز مفید باشد.
.IP \fB\-mconstant\-gp\fR 4
.IX Item "-mconstant-gp"
تولید کدی که از یک مقدار ثابت و یکتای اشاره‌گر سراسری (global pointer) استفاده می‌کند. این گزینه هنگام کامپایل کد کرنل کاربرد دارد.
.IP \fB\-mauto\-pic\fR 4
.IX Item "-mauto-pic"
تولید کدی که خودبازمکان‌یاب (self\-relocatable) باشد. این گزینه مستلزم \fB\-mconstant\-gp\fR است. این ویژگی هنگام کامپایل کد میان‌افزار (firmware) مفید است.
.IP \fB\-minline\-float\-divide\-min\-latency\fR 4
.IX Item "-minline-float-divide-min-latency"
تولید کد برای تقسیم‌های درون‌خطی (inline) مقادیر ممیز شناور با استفاده از الگوریتم کمینهٔ تاخیر (minimum latency).
.IP \fB\-minline\-float\-divide\-max\-throughput\fR 4
.IX Item "-minline-float-divide-max-throughput"
تولید کد برای تقسیم‌های درون‌خطی مقادیر ممیز شناور با استفاده از الگوریتم بیشینهٔ توان عملیاتی (maximum throughput).
.IP \fB\-mno\-inline\-float\-divide\fR 4
.IX Item "-mno-inline-float-divide"
تولید نکردن کد درون‌خطی برای تقسیم‌های مقادیر ممیز شناور.
.IP \fB\-minline\-int\-divide\-min\-latency\fR 4
.IX Item "-minline-int-divide-min-latency"
تولید کد برای تقسیم‌های درون‌خطی مقادیر صحیح با استفاده از الگوریتم کمینهٔ تاخیر.
.IP \fB\-minline\-int\-divide\-max\-throughput\fR 4
.IX Item "-minline-int-divide-max-throughput"
تولید کد برای تقسیم‌های درون‌خطی مقادیر صحیح با استفاده از الگوریتم بیشینهٔ توان عملیاتی.
.IP \fB\-mno\-inline\-int\-divide\fR 4
.IX Item "-mno-inline-int-divide"
تولید نکردن کد درون‌خطی برای تقسیم‌های مقادیر صحیح.
.IP \fB\-minline\-sqrt\-min\-latency\fR 4
.IX Item "-minline-sqrt-min-latency"
تولید کد برای جذر درون‌خطی با استفاده از الگوریتم کمینهٔ تاخیر.
.IP \fB\-minline\-sqrt\-max\-throughput\fR 4
.IX Item "-minline-sqrt-max-throughput"
تولید کد برای جذر درون‌خطی با استفاده از الگوریتم بیشینهٔ توان عملیاتی.
.IP \fB\-mno\-inline\-sqrt\fR 4
.IX Item "-mno-inline-sqrt"
تولید نکردن کد درون‌خطی برای \f(CW\*(C`sqrt\*(C'\fR.
.IP \fB\-mno\-dwarf2\-asm\fR 4
.IX Item "-mno-dwarf2-asm"
.PD 0
.IP \fB\-mdwarf2\-asm\fR 4
.IX Item "-mdwarf2-asm"
.PD
تولید نکردن (یا کردن) کد اسمبلر برای اطلاعات اشکال‌زدایی شماره خط DWARF. این گزینه ممکن است هنگام استفاده نکردن از اسمبلر گنو (GNU assembler) مفید باشد.
.IP \fB\-mearly\-stop\-bits\fR 4
.IX Item "-mearly-stop-bits"
.PD 0
.IP \fB\-mno\-early\-stop\-bits\fR 4
.IX Item "-mno-early-stop-bits"
.PD
اجازه دادن به قرارگیری بیت‌های توقف زودتر از موقعیت بلافاصله پیش از دستوری که باعث فعال شدن بیت توقف شده است. این کار می‌تواند زمان‌بندی دستورها را بهبود بخشد، اما همواره این‌گونه نیست.
.IP \fB\-mfixed\-range=\fR\fIregister\-range\fR 4
.IX Item "-mfixed-range=register-range"
تولید کدی که بازهٔ ثبات مشخص‌شده را به عنوان ثبات‌های ثابت در نظر می‌گیرد. ثبات ثابت ثباتی است که تخصیص‌دهندهٔ ثبات (register allocator) نمی‌تواند از آن استفاده کند. این گزینه هنگام کامپایل کد کرنل کاربرد دارد. بازهٔ ثبات‌ها به صورت دو ثبات جداشده با یک خط تیره مشخص می‌شود. چندین بازهٔ ثبات را می‌توان با ویرگول انگلیسی از یکدیگر جدا کرد.
.IP \fB\-mtls\-size=\fR\fItls\-size\fR 4
.IX Item "-mtls-size=tls-size"
مشخص کردن اندازهٔ بیتی آفست‌های بی‌واسطهٔ TLS. مقادیر معتبر عبارتند از 14، 22 و 64.
.IP \fB\-mtune=\fR\fIcpu\-type\fR 4
.IX Item "-mtune=cpu-type"
میزان‌سازی زمان‌بندی دستورها برای یک پردازندهٔ خاص. مقادیر معتبر عبارتند از
\&\fBitanium\fR، \fBitanium1\fR، \fBmerced\fR، \fBitanium2\fR
و \fBmckinley\fR.
.IP \fB\-milp32\fR 4
.IX Item "-milp32"
.PD 0
.IP \fB\-mlp64\fR 4
.IX Item "-mlp64"
.PD
تولید کد برای یک محیط ۳۲بیتی یا ۶۴بیتی.
محیط ۳۲بیتی اندازه‌های int، long و pointer را ۳۲ بیت تنظیم می‌کند.
محیط ۶۴بیتی int را به ۳۲ بیت و long و pointer را به ۶۴ بیت تنظیم می‌نماید. این پرچم‌ها مختص HP\-UX هستند.
.IP \fB\-mno\-sched\-br\-data\-spec\fR 4
.IX Item "-mno-sched-br-data-spec"
.PD 0
.IP \fB\-msched\-br\-data\-spec\fR 4
.IX Item "-msched-br-data-spec"
.PD
(غیر)فعال‌سازی زمان‌بندی حدسی داده‌ها پیش از reload.
این امر موجب تولید دستورهای \f(CW\*(C`ld.a\*(C'\fR و دستورهای بررسی متناظر (\f(CW\*(C`ld.c\*(C'\fR / \f(CW\*(C`chk.a\*(C'\fR) می‌شود.
تنظیم پیش‌فرض غیرفعال است.
.IP \fB\-msched\-ar\-data\-spec\fR 4
.IX Item "-msched-ar-data-spec"
.PD 0
.IP \fB\-mno\-sched\-ar\-data\-spec\fR 4
.IX Item "-mno-sched-ar-data-spec"
.PD
(فعال/غیرفعال)سازی زمان‌بندی حدسی داده‌ها پس از reload.
این امر موجب تولید دستورهای \f(CW\*(C`ld.a\*(C'\fR و دستورهای بررسی متناظر (\f(CW\*(C`ld.c\*(C'\fR / \f(CW\*(C`chk.a\*(C'\fR) می‌شود.
تنظیم پیش‌فرض فعال است.
.IP \fB\-mno\-sched\-control\-spec\fR 4
.IX Item "-mno-sched-control-spec"
.PD 0
.IP \fB\-msched\-control\-spec\fR 4
.IX Item "-msched-control-spec"
.PD
(غیر)فعال‌سازی زمان‌بندی حدسی کنترلی. این ویژگی تنها در زمان زمان‌بندی ناحیه‌ای (یعنی قبل از reload) در دسترس است.
این امر موجب تولید دستورهای \f(CW\*(C`ld.s\*(C'\fR و دستورهای بررسی متناظر \f(CW\*(C`chk.s\*(C'\fR می‌شود.
تنظیم پیش‌فرض غیرفعال است.
.IP \fB\-msched\-br\-in\-data\-spec\fR 4
.IX Item "-msched-br-in-data-spec"
.PD 0
.IP \fB\-mno\-sched\-br\-in\-data\-spec\fR 4
.IX Item "-mno-sched-br-in-data-spec"
.PD
(فعال/غیرفعال)سازی زمان‌بندی حدسی دستورهایی که قبل از reload به بارگذاری‌های حدسی داده‌ها وابسته هستند.
این گزینه تنها با فعال بودن \fB\-msched\-br\-data\-spec\fR مؤثر است.
تنظیم پیش‌فرض فعال است.
.IP \fB\-msched\-ar\-in\-data\-spec\fR 4
.IX Item "-msched-ar-in-data-spec"
.PD 0
.IP \fB\-mno\-sched\-ar\-in\-data\-spec\fR 4
.IX Item "-mno-sched-ar-in-data-spec"
.PD
(فعال/غیرفعال)سازی زمان‌بندی حدسی دستورهایی که پس از reload به بارگذاری‌های حدسی داده‌ها وابسته هستند.
این گزینه تنها با فعال بودن \fB\-msched\-ar\-data\-spec\fR مؤثر است.
تنظیم پیش‌فرض فعال است.
.IP \fB\-msched\-in\-control\-spec\fR 4
.IX Item "-msched-in-control-spec"
.PD 0
.IP \fB\-mno\-sched\-in\-control\-spec\fR 4
.IX Item "-mno-sched-in-control-spec"
.PD
(فعال/غیرفعال)سازی زمان‌بندی حدسی دستورهایی که به بارگذاری‌های حدسی کنترلی وابسته هستند.
این گزینه تنها با فعال بودن \fB\-msched\-control\-spec\fR مؤثر است.
تنظیم پیش‌فرض فعال است.
.IP \fB\-mno\-sched\-count\-spec\-in\-critical\-path\fR 4
.IX Item "-mno-sched-count-spec-in-critical-path"
.PD 0
.IP \fB\-msched\-count\-spec\-in\-critical\-path\fR 4
.IX Item "-msched-count-spec-in-critical-path"
.PD
در صورت فعال بودن، وابستگی‌های حدسی در طول محاسبهٔ اولویت‌های دستورها در نظر گرفته می‌شوند. این امر کاربرد حدس‌زنی را کمی محافظه‌کارانه‌تر می‌کند.
تنظیم پیش‌فرض غیرفعال است.
.IP \fB\-msched\-spec\-ldc\fR 4
.IX Item "-msched-spec-ldc"
.PD 0
.IP \fB\-mno\-sched\-spec\-ldc\fR 4
.IX Item "-mno-sched-spec-ldc"
.PD
استفاده از بررسی سادهٔ حدس داده‌ها. این گزینه به‌طور پیش‌فرض فعال است..IP \fB\-msched\-control\-spec\-ldc\fR 4
.IX Item "-msched-control-spec-ldc"
.PD 0
.IP \fB\-mno\-sched\-control\-spec\-ldc\fR 4
.IX Item "-mno-sched-control-spec-ldc"
.PD
استفاده از یک بررسی ساده برای حدس کنترلی (control speculation). این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-msched\-stop\-bits\-after\-every\-cycle\fR 4
.IX Item "-msched-stop-bits-after-every-cycle"
.PD 0
.IP \fB\-mno\-sched\-stop\-bits\-after\-every\-cycle\fR 4
.IX Item "-mno-sched-stop-bits-after-every-cycle"
.PD
قرار دادن یک بیت توقف پس از هر چرخه در زمان زمان‌بندی. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-msched\-fp\-mem\-deps\-zero\-cost\fR 4
.IX Item "-msched-fp-mem-deps-zero-cost"
.PD 0
.IP \fB\-mno\-sched\-fp\-mem\-deps\-zero\-cost\fR 4
.IX Item "-mno-sched-fp-mem-deps-zero-cost"
.PD
فرض بر اینکه ذخیره‌ها و بارگذاری‌های ممیز شناور در صورت قرارگیری در یک گروه دستورالعمل یکسان، احتمالاً تداخلی ایجاد نمی‌کنند. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-msel\-sched\-dont\-check\-control\-spec\fR 4
.IX Item "-msel-sched-dont-check-control-spec"
.PD 0
.IP \fB\-mno\-sel\-sched\-dont\-check\-control\-spec\fR 4
.IX Item "-mno-sel-sched-dont-check-control-spec"
.PD
تولید بررسی‌ها برای حدس کنترلی در زمان‌بندی انتخابی (selective scheduling). این پرچم به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-msched\-max\-memory\-insns=\fR\fImax\-insns\fR 4
.IX Item "-msched-max-memory-insns=max-insns"
محدود کردن تعداد دستورالعمل‌های حافظه در هر گروه دستورالعمل، با اولویت پایین‌تر دادن به دستورالعمل‌های حافظه بعدی که سعی در زمان‌بندی در همان گروه دستورالعمل دارند. این گزینه اغلب برای جلوگیری از تداخل‌های بنک حافظه پنهان (cache bank conflicts) مفید است. مقدار پیش‌فرض 1 است.
.IP \fB\-msched\-max\-memory\-insns\-hard\-limit\fR 4
.IX Item "-msched-max-memory-insns-hard-limit"
.PD 0
.IP \fB\-mno\-sched\-max\-memory\-insns\-hard\-limit\fR 4
.IX Item "-mno-sched-max-memory-insns-hard-limit"
.PD
محدودیت مشخص‌شده توسط \fBmsched\-max\-memory\-insns\fR را به یک حد سخت (hard limit) تبدیل می‌کند که وجود تعداد بیشتری در یک گروه دستورالعمل را مجاز نمی‌داند. در غیر این صورت، این محدودیت «نرم» (soft) است، به این معنی که با رسیدن به حد نصاب، عملیات‌های غیر حافظه‌ای ترجیح داده می‌شوند، اما عملیات‌های حافظه همچنان ممکن است زمان‌بندی شوند.
.PP
\fIگزینه‌های LM32\fR
.IX Subsection "LM32 Options"
.PP
این گزینه‌های \fB\-m\fR برای معماری LatticeMico32 تعریف شده‌اند:
.IP \fB\-mbarrel\-shift\-enabled\fR 4
.IX Item "-mbarrel-shift-enabled"
فعال‌سازی دستورالعمل‌های barrel\-shift.
.IP \fB\-mdivide\-enabled\fR 4
.IX Item "-mdivide-enabled"
فعال‌سازی دستورالعمل‌های تقسیم و باقیمانده (modulus).
.IP \fB\-mmultiply\-enabled\fR 4
.IX Item "-mmultiply-enabled"
فعال‌سازی دستورالعمل‌های ضرب.
.IP \fB\-msign\-extend\-enabled\fR 4
.IX Item "-msign-extend-enabled"
فعال‌سازی دستورالعمل‌های گسترش علامت (sign extend).
.IP \fB\-muser\-enabled\fR 4
.IX Item "-muser-enabled"
فعال‌سازی دستورالعمل‌های تعریف‌شده توسط کاربر.
.PP
\fIگزینه‌های LoongArch\fR
.IX Subsection "LoongArch Options"
.PP
این گزینه‌های خط فرمان برای مقصدهای LoongArch تعریف شده‌اند:
.IP \fB\-march=\fR\fIarch\-type\fR 4
.IX Item "-march=arch-type"
تولید دستورالعمل‌ها برای نوع ماشین \fIarch\-type\fR.
\&\fB\-march=\fR\fIarch\-type\fR به GCC اجازه می‌دهد کدی تولید کند که ممکن است روی پردازنده‌هایی غیر از پردازنده مشخص‌شده اصلاً اجرا نشود.
.Sp
انتخاب‌ها برای \fIarch\-type\fR عبارتند از:
.RS 4
.IP \fBnative\fR 4
.IX Item "native"
نوع پردازنده محلی تشخیص‌داده‌شده توسط کامپایلر بومی.
.IP \fBloongarch64\fR 4
.IX Item "loongarch64"
پردازنده عمومی ۶۴ بیتی LoongArch.
.IP \fBla464\fR 4
.IX Item "la464"
پردازنده مبتنی بر LoongArch LA464 همراه با LSX و LASX.
.IP \fBla664\fR 4
.IX Item "la664"
پردازنده مبتنی بر LoongArch LA664 همراه با LSX، LASX و تمام دستورالعمل‌های LoongArch v1.1.
.IP \fBla64v1.0\fR 4
.IX Item "la64v1.0"
LoongArch64 ISA نسخه 1.0.
.IP \fBla64v1.1\fR 4
.IX Item "la64v1.1"
LoongArch64 ISA نسخه 1.1.
.IP \fBla32v1.0\fR 4
.IX Item "la32v1.0"
LoongArch32 ISA نسخه 1.0.
.IP \fBla32rv1.0\fR 4
.IX Item "la32rv1.0"
LoongArch32 Reduced ISA نسخه 1.0.
.RE
.RS 4
.Sp
اطلاعات بیشتر درباره نسخه‌های LoongArch ISA را می‌توان در <\fBhttps://github.com/loongson/la\-toolchain\-conventions\fR> یافت.
.RE
.IP \fB\-mtune=\fR\fItune\-type\fR 4
.IX Item "-mtune=tune-type"
بهینه‌سازی کد تولیدشده برای پردازنده مقصد مشخص‌شده.
.Sp
انتخاب‌ها برای \fItune\-type\fR عبارتند از:
.RS 4
.IP \fBnative\fR 4
.IX Item "native"
نوع پردازنده محلی تشخیص‌داده‌شده توسط کامپایلر بومی.
.IP \fBgeneric\fR 4
.IX Item "generic"
پردازنده عمومی LoongArch.
.IP \fBloongarch64\fR 4
.IX Item "loongarch64"
پردازنده عمومی ۶۴ بیتی LoongArch.
.IP \fBla464\fR 4
.IX Item "la464"
هسته LoongArch LA464.
.IP \fBla664\fR 4
.IX Item "la664"
هسته LoongArch LA664.
.IP \fBloongarch32\fR 4
.IX Item "loongarch32"
پردازنده عمومی ۳۲ بیتی LoongArch.
.RE
.RS 4
.RE
.IP \fB\-mabi=\fR\fIbase\-abi\-type\fR 4
.IX Item "-mabi=base-abi-type"
تولید کد برای قرارداد فراخوانی (calling convention) مشخص‌شده.
\&\fIbase\-abi\-type\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBlp64d\fR 4
.IX Item "lp64d"
استفاده از ثبات‌های همه‌منظوره ۶۴ بیتی و ثبات‌های ممیز شناور ۳۲/۶۴ بیتی برای انتقال پارامتر. مدل داده LP64 است که در آن \fBint\fR برابر ۳۲ بیت و \fBlong int\fR و اشاره‌گرها ۶۴ بیتی هستند.
.IP \fBlp64f\fR 4
.IX Item "lp64f"
استفاده از ثبات‌های همه‌منظوره ۶۴ بیتی و ثبات‌های ممیز شناور ۳۲ بیتی برای انتقال پارامتر. مدل داده LP64 است که در آن \fBint\fR برابر ۳۲ بیت و \fBlong int\fR و اشاره‌گرها ۶۴ بیتی هستند.
.IP \fBlp64s\fR 4
.IX Item "lp64s"
استفاده از ثبات‌های همه‌منظوره ۶۴ بیتی و عدم استفاده از ثبات‌های ممیز شناور برای انتقال پارامتر. مدل داده LP64 است که در آن \fBint\fR برابر ۳۲ بیت و \fBlong int\fR و اشاره‌گرها ۶۴ بیتی هستند.
.RE
.RS 4
.RE
.IP \fB\-mfpu=\fR\fIfpu\-type\fR 4
.IX Item "-mfpu=fpu-type"
تولید کد برای نوع FPU مشخص‌شده، که می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fB64\fR 4
.IX Item "64"
مجاز شمردن استفاده از دستورالعمل‌های سخت‌افزاری ممیز شناور برای عملیات‌های ۳۲ بیتی و ۶۴ بیتی.
.IP \fB32\fR 4
.IX Item "32"
مجاز شمردن استفاده از دستورالعمل‌های سخت‌افزاری ممیز شناور برای عملیات‌های ۳۲ بیتی.
.IP \fBnone\fR 4
.IX Item "none"
.PD 0
.IP \fB0\fR 4
.IX Item "0".PD
از به‌کارگیری دستورالعمل‌های ممیز شناور سخت‌افزاری جلوگیری می‌کند.
.RE
.RS 4
.RE
.IP \fB\-msimd=\fR\fIsimd\-type\fR 4
.IX Item "-msimd=simd-type"
تولید دستورالعمل‌های LoongArch SIMD را برای برداری‌سازی (vectorization) و از طریق توابع توکار (builtin) فعال می‌کند. مقدار می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBlasx\fR 4
.IX Item "lasx"
تولید دستورالعمل‌ها از افزونهٔ ۲۵۶بیتی LoongArch Advanced SIMD Extension (LASX) و افزونهٔ ۱۲۸بیتی LoongArch SIMD Extension (LSX) را فعال می‌کند.
.IP \fBlsx\fR 4
.IX Item "lsx"
تولید دستورالعمل‌ها از افزونهٔ ۱۲۸بیتی LoongArch SIMD Extension (LSX) را فعال می‌کند.
.IP \fBnone\fR 4
.IX Item "none"
هیچ دستورالعمل LoongArch SIMD تولید نخواهد شد.
.RE
.RS 4
.RE
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
گزینهٔ \fB\-mfpu=none\fR را اجبار کرده و از به‌کارگیری ثبات‌های ممیز شناور برای انتقال پارامترها جلوگیری می‌کند. این گزینه ممکن است ABI هدف را تغییر دهد.
.IP \fB\-msingle\-float\fR 4
.IX Item "-msingle-float"
گزینهٔ \fB\-mfpu=32\fR را اجبار کرده و استفاده از ثبات‌های ممیز شناور ۳۲بیتی را برای انتقال پارامترها مجاز می‌کند. این گزینه ممکن است ABI هدف را تغییر دهد.
.IP \fB\-mdouble\-float\fR 4
.IX Item "-mdouble-float"
گزینهٔ \fB\-mfpu=64\fR را اجبار کرده و استفاده از ثبات‌های ممیز شناور ۳۲/۶۴بیتی را برای انتقال پارامترها مجاز می‌کند. این گزینه ممکن است ABI هدف را تغییر دهد.
.IP \fB\-mlasx\fR 4
.IX Item "-mlasx"
.PD 0
.IP \fB\-mno\-lasx\fR 4
.IX Item "-mno-lasx"
.IP \fB\-mlsx\fR 4
.IX Item "-mlsx"
.IP \fB\-mno\-lsx\fR 4
.IX Item "-mno-lsx"
.PD
دامنهٔ افزونه‌های SIMD قابل‌استفاده توسط کامپایلر برای تولید کد (none / LSX / LASX) را به‌صورت تدریجی تنظیم می‌کند. فعال‌سازی LASX با
\&\fB\-mlasx\fR به‌طور خودکار LSX را فعال کرده،
و غیرفعال‌سازی LSX با \fB\-mno\-lsx\fR
به‌طور خودکار LASX را غیرفعال می‌کند. این گزینه‌های اختصاصی درایور، روی وضعیت نهایی پیکربندی
\&\fB\-msimd\fR اعمال شده و به ترتیبی که در خط فرمان درایور GCC ظاهر می‌شوند تغییرات تدریجی ایجاد می‌کنند تا در نهایت گزینهٔ استانداردشده و نهایی
\&\fB\-msimd\fR را که به خود کامپایلر ارسال می‌شود حاصل نمایند.
.IP \fB\-mbranch\-cost=\fR\fIn\fR 4
.IX Item "-mbranch-cost=n"
هزینهٔ انشعاب‌ها را تقریباً برابر با \fIn\fR دستورالعمل تعیین می‌کند.
.IP \fB\-maddr\-reg\-reg\-cost=\fR\fIn\fR 4
.IX Item "-maddr-reg-reg-cost=n"
هزینهٔ ADDRESS_REG_REG را برابر با مقدار محاسبه‌شده توسط \fIn\fR قرار می‌دهد.
.IP \fB\-mcheck\-zero\-division\fR 4
.IX Item "-mcheck-zero-division"
.PD 0
.IP \fB\-mno\-check\-zero\-divison\fR 4
.IX Item "-mno-check-zero-divison"
.PD
در تقسیم عدد صحیح بر صفر تله (trap) ایجاد می‌کند (نمی‌کند). حالت پیش‌فرض،
\&\fB\-mcheck\-zero\-division\fR برای سطوح بهینه‌سازی \fB\-O0\fR یا \fB\-Og\fR، و
\&\fB\-mno\-check\-zero\-division\fR برای سایر سطوح بهینه‌سازی است.
.IP \fB\-mbreak\-code=\fR\fIcode\fR 4
.IX Item "-mbreak-code=code"
یک دستورالعمل \f(CW\*(C`break\*(C'\fR \fIcode\fR برای تله‌های غیرقابل‌بازیابی حاصل از \f(CW\*(C`_\|_builtin_trap\*(C'\fR یا موارد درج‌شده توسط کامپایلر (برای نمونه یک مسیر نادرست تفکیک‌شده با
\&\fB\-fisolate\-erroneous\-paths\-dereference\fR) صادر می‌کند، یا در صورتی که \fIcode\fR منفی یا بزرگ‌تر از ۳۲۷۶۷ باشد یک دستورالعمل
\&\f(CW\*(C`amswap.w $r0, $r1, $r0\*(C'\fR صادر می‌کند که سبب می‌شود سخت‌افزار یک استثنای Instruction Not\-defined Exception ایجاد نماید. مقدار پیش‌فرض \-1 است، به این معنی که از دستورالعمل
\&\f(CW\*(C`amswap.w\*(C'\fR استفاده شود.
.IP \fB\-mcond\-move\-int\fR 4
.IX Item "-mcond-move-int"
.PD 0
.IP \fB\-mno\-cond\-move\-int\fR 4
.IX Item "-mno-cond-move-int"
.PD
انتقال‌های شرطی برای داده‌های صحیح در ثبات‌های همه‌منظوره فعال (غیرفعال) می‌شوند. پیش‌فرض \fB\-mcond\-move\-int\fR است.
.IP \fB\-mcond\-move\-float\fR 4
.IX Item "-mcond-move-float"
.PD 0
.IP \fB\-mno\-cond\-move\-float\fR 4
.IX Item "-mno-cond-move-float"
.PD
انتقال‌های شرطی برای ثبات‌های ممیز شناور فعال (غیرفعال) می‌شوند. پیش‌فرض \fB\-mcond\-move\-float\fR است.
.IP \fB\-mmemcpy\fR 4
.IX Item "-mmemcpy"
.PD 0
.IP \fB\-mno\-memcpy\fR 4
.IX Item "-mno-memcpy"
.PD
استفاده از \f(CW\*(C`memcpy\*(C'\fR را برای جابه‌جایی‌های بلوکی غیرساده اجبار (یا عدم اجبار) می‌کند. پیش‌فرض \fB\-mno\-memcpy\fR است که به GCC امکان می‌دهد بیشتر رونوشت‌های با اندازهٔ ثابت را درون‌خطی (inline) کند. تعیین سطح بهینه‌سازی روی \fB\-Os\fR نیز استفاده از \f(CW\*(C`memcpy\*(C'\fR را اجبار می‌کند، اما در صورت تعیین صریح، \fB\-mno\-memcpy\fR می‌تواند این رفتار را صرف‌نظر از ترتیب این گزینه‌ها در خط فرمان لغو نماید.
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD 0
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD
از ایجاد دسترسی‌های حافظه‌ای که ممکن است بر روی مرز طبیعی شیء، آن‌گونه که در مشخصات معماری تعریف شده، تراز نشده باشند اجتناب می‌کند (یا آن‌ها را مجاز می‌سازد). مقدار پیش‌فرض
\&\fB\-mno\-strict\-align\fR است.
.IP "\fB\-G\fR \fInum\fR" 4
.IX Item "-G num"
داده‌های سراسری و ایستا با اندازهٔ کوچک‌تر از \fInum\fR بایت را در یک بخش داده‌های کوچک (small data section) قرار می‌دهد. مقدار پیش‌فرض 0 است.
.IP \fB\-mmax\-inline\-memcpy\-size=\fR\fIn\fR 4
.IX Item "-mmax-inline-memcpy-size=n"
تمام جابه‌جایی‌های بلوکی (مانند فراخوانی‌های \f(CW\*(C`memcpy\*(C'\fR یا رونوشت‌های ساختار) کمتر یا مساوی با \fIn\fR بایت را درون‌خطی (inline) می‌کند. مقدار پیش‌فرض \fIn\fR برابر با 1024 است.
.IP \fB\-mcmodel=\fR\fIcode\-model\fR 4
.IX Item "-mcmodel=code-model"
مدل کد (code model) را روی یکی از موارد زیر تنظیم می‌کند:
.RS 4
.IP "\fBtiny\-static (هنوز پیاده‌سازی نشده است)\fR" 4
.IX Item "tiny-static (Not implemented yet)"
.PD 0
.IP "\fBtiny (هنوز پیاده‌سازی نشده است)\fR" 4
.IX Item "tiny (Not implemented yet)"
.IP \fBnormal\fR 4
.IX Item "normal"
.PD
بخش کد (text segment) باید درون فضای آدرس‌دهی 128MB باشد. بخش داده (data segment) باید درون فضای آدرس‌دهی 2GB باشد.
.IP \fBmedium\fR 4
.IX Item "medium"
بخش کد و بخش داده هر دو باید درون فضای آدرس‌دهی 2GB قرار داشته باشند. این مدل کد پیش‌فرض است مگر آنکه GCC با
\&\fB\-\-with\-cmodel=\fR به‌گونه‌ای پیکربندی شده باشد که مدل کد پیش‌فرض متفاوتی را مشخص کند.
.IP "\fBlarge (هنوز پیاده‌سازی نشده است)\fR" 4
.IX Item "large (Not implemented yet)"
.PD 0
.IP \fBextreme\fR 4
.IX Item "extreme"
.PD
این حالت اندازهٔ بخش کد و بخش داده را محدود نمی‌کند. گزینهٔ \fB\-mcmodel=extreme\fR با \fB\-fplt\fR و/یا \fB\-mexplicit\-relocs=none\fR ناسازگار است.
.RE
.RS 4
.RE
.IP \fB\-mexplicit\-relocs=\fR\fIstyle\fR 4
.IX Item "-mexplicit-relocs=style"
.PD 0
.IP \fB\-mexplicit\-relocs\fR 4
.IX Item "-mexplicit-relocs"
.IP \fB\-mno\-explicit\-relocs\fR 4
.IX Item "-mno-explicit-relocs"
.PD
تعیین می‌کند که چه زمانی در هنگام کار با آدرس‌های نمادین، از عملگرهای بازمکانی (relocation operators) اسمبلر استفاده شود. روش جایگزین، استفاده از ماکروهای اسمبلر است که ممکن است زمان‌بندی دستورالعمل‌ها را محدود کند اما امکان بهینه‌سازی پیونددهنده (linker relaxation) را فراهم می‌سازد.
با \fB\-mexplicit\-relocs=none\fR، همواره از ماکروهای اسمبلر استفاده می‌شود؛
با \fB\-mexplicit\-relocs=always\fR، همواره از عملگرهای بازمکانی اسمبلر استفاده می‌شود؛ و با \fB\-mexplicit\-relocs=auto\fR کامپایلر در جاهایی که linker relaxation برای بهبود کیفیت کد غیرممکن است از عملگرهای بازمکانی، و در سایر جاها از ماکروها استفاده می‌کند.
.Sp
مقدار پیش‌فرض این گزینه بر اساس قابلیت‌های اسمبلر شناسایی‌شده در زمان ساخت GCC و همچنین تنظیم \fB\-mrelax\fR تعیین می‌شود:
\&\fB\-mexplicit\-relocs=none\fR اگر اسمبلر اصلاً از عملگرهای بازمکانی پشتیبانی نکند،
\&\fB\-mexplicit\-relocs=always\fR اگر اسمبلر از عملگرهای بازمکانی پشتیبانی کند اما \fB\-mrelax\fR فعال نباشد،
\&\fB\-mexplicit\-relocs=auto\fR اگر اسمبلر از عملگرهای بازمکانی پشتیبانی کند و \fB\-mrelax\fR نیز فعال باشد.
.Sp
برای سازگاری رو به عقب، \fB\-mexplicit\-relocs\fR معادل با
\&\fB\-mexplicit\-relocs=always\fR بوده، در حالی که \fB\-mno\-explicit\-relocs\fR معادل با \fB\-mexplicit\-relocs=none\fR است..IP \fB\-mdirect\-extern\-access\fR 4
.IX Item "-mdirect-extern-access"
.PD 0
.IP \fB\-mno\-direct\-extern\-access\fR 4
.IX Item "-mno-direct-extern-access"
.PD
استفاده از GOT را برای دسترسی به نمادهای خارجی کنترل می‌کند. حالت پیش‌فرض
\&\fB\-mno\-direct\-extern\-access\fR است: برای نمادهای خارجی با نمایانی پیش‌فرض از GOT استفاده می‌شود، اما برای سایر نمادهای خارجی استفاده نمی‌شود.
.Sp
با \fB\-mdirect\-extern\-access\fR، از GOT استفاده نمی‌شود و تمام نمادهای خارجی به‌صورت وابسته به PC (یا PC\-relative) آدرس‌دهی می‌شوند. این گزینه \fBتنها\fR برای محیط‌هایی مناسب است که هیچ پیوند پویایی در آن‌ها انجام نمی‌شود؛ مانند سفت‌افزارها، هسته‌های سیستم‌عامل، یا فایل‌های اجرایی پیوندیافته با \fB\-static\fR یا \fB\-static\-pie\fR.
گزینهٔ \&\fB\-mdirect\-extern\-access\fR با \fB\-fPIC\fR یا
\&\fB\-fpic\fR سازگار نیست.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
.PD 0
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
.PD
بهره‌گیری (یا عدم بهره‌گیری) از آسان‌سازی‌های پیونددهنده (linker relaxations). اگر
\&\fB\-mpass\-mrelax\-to\-as\fR فعال باشد، این گزینه به اسمبلر نیز ارسال می‌شود. حالت پیش‌فرض در زمان ساخت GCC با تشخیص پشتیبانی اسمبلر مربوطه تعیین می‌شود:
در صورتی که اسمبلر هم از گزینهٔ \fB\-mrelax\fR و هم از بهینه‌سازی relaxation انشعاب شرطی پشتیبانی کند، مقدار پیش‌فرض \&\fB\-mrelax\fR خواهد بود (این پشتیبانی الزامی است، در غیر این صورت دستورالعمل‌های
\&\f(CW\*(C`.align\*(C'\fR و دستورهای انشعاب شرطی در کد اسمبلی خروجی از GCC ممکن است به دلیل سرریز بازنشانی (relocation overflow) توسط اسمبلر رد شوند)، در غیر این صورت پیش‌فرض \fB\-mno\-relax\fR است.
.IP \fB\-mpass\-mrelax\-to\-as\fR 4
.IX Item "-mpass-mrelax-to-as"
.PD 0
.IP \fB\-mno\-pass\-mrelax\-to\-as\fR 4
.IX Item "-mno-pass-mrelax-to-as"
.PD
ارسال (یا عدم ارسال) گزینهٔ \fB\-mrelax\fR یا \fB\-mno\-relax\fR
به اسمبلر. پیش‌فرض در هنگام ساخت GCC با بررسی پشتیبانی اسمبلر مربوطه تعیین می‌شود:
در صورتی که اسمبلر از گزینهٔ \&\fB\-mrelax\fR پشتیبانی کند، پیش‌فرض
\&\fB\-mpass\-mrelax\-to\-as\fR خواهد بود، در غیر این صورت \fB\-mno\-pass\-mrelax\-to\-as\fR است.
این گزینه بیشتر برای اشکال‌زدایی یا تعامل با اسمبلرهایی متفاوت از اسمبلر زمان ساخت کاربرد دارد.
.IP \fB\-mrecip\fR 4
.IX Item "-mrecip"
این گزینه استفاده از دستورهای تخمین معکوس و تخمین معکوس ریشهٔ دوم همراه با گام‌های تکمیلی نیوتن\-رافسون را جهت افزایش دقت، به جای انجام تقسیم یا جذر و تقسیم برای آرگومان‌های ممیز شناور فعال می‌کند.
این دستورها تنها در صورتی تولید می‌شوند که \fB\-funsafe\-math\-optimizations\fR
همراه با \fB\-ffinite\-math\-only\fR و
\&\fB\-fno\-trapping\-math\fR فعال شده باشد.
این گزینه به‌طور پیش‌فرض غیرفعال است. پیش از استفاده از این گزینه، باید مطمئن شوید پردازندهٔ مقصد از دستورهای \f(CW\*(C`frecipe\*(C'\fR و \f(CW\*(C`frsqrte\*(C'\fR پشتیبانی می‌کند.
توجه داشته باشید که اگرچه توان عملیاتی این توالی بالاتر از توان عملیاتی دستور غیرمعکوس است، اما دقت توالی می‌تواند تا ۲ ulp کاهش یابد (به عنوان مثال معکوس 1.0 برابر با 0.99999994 می‌شود).
.IP \fB\-mrecip=\fR\fIopt\fR 4
.IX Item "-mrecip=opt"
این گزینه مشخص می‌کند کدام‌یک از دستورهای تخمین معکوس مجاز به استفاده هستند. \fIopt\fR فهرستی از گزینه‌ها است که با کاما از یکدیگر جدا می‌شوند، و می‌توان یک علامت \fB!\fR را در ابتدای هر گزینه برای معکوس کردن عملکرد آن قرار داد:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
فعال‌سازی تمامی دستورهای تخمین.
.IP \fBdefault\fR 4
.IX Item "default"
فعال‌سازی دستورهای پیش‌فرض، معادل با \fB\-mrecip\fR.
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی تمامی دستورهای تخمین، معادل با \fB\-mno\-recip\fR.
.IP \fBdiv\fR 4
.IX Item "div"
فعال‌سازی تقریب برای تقسیم اسکالر.
.IP \fBvec\-div\fR 4
.IX Item "vec-div"
فعال‌سازی تقریب برای تقسیم برداری.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
فعال‌سازی تقریب برای ریشهٔ دوم اسکالر.
.IP \fBvec\-sqrt\fR 4
.IX Item "vec-sqrt"
فعال‌سازی تقریب برای ریشهٔ دوم برداری.
.IP \fBrsqrt\fR 4
.IX Item "rsqrt"
فعال‌سازی تقریب برای معکوس ریشهٔ دوم اسکالر.
.IP \fBvec\-rsqrt\fR 4
.IX Item "vec-rsqrt"
فعال‌سازی تقریب برای معکوس ریشهٔ دوم برداری.
.RE
.RS 4
.Sp
بنابراین، به عنوان مثال، \fB\-mrecip=all,!sqrt\fR تمامی تقریب‌های معکوس را به جز ریشهٔ دوم اسکالر فعال می‌کند.
.RE
.IP \fB\-mfrecipe\fR 4
.IX Item "-mfrecipe"
.PD 0
.IP \fB\-mno\-frecipe\fR 4
.IX Item "-mno-frecipe"
.PD
استفاده (یا عدم استفاده) از دستورهای \f(CW\*(C`frecipe.{s/d}\*(C'\fR و \f(CW\*(C`frsqrte.{s/d}\*(C'\fR.
هنگام کامپایل با \fB\-march=la664\fR،
این گزینه به‌طور پیش‌فرض فعال است. در غیر این صورت، مقدار پیش‌فرض \fB\-mno\-frecipe\fR خواهد بود.
.IP \fB\-mdiv32\fR 4
.IX Item "-mdiv32"
.PD 0
.IP \fB\-mno\-div32\fR 4
.IX Item "-mno-div32"
.PD
استفاده (یا عدم استفاده) از دستورهای \f(CW\*(C`div.w[u]\*(C'\fR و \f(CW\*(C`mod.w[u]\*(C'\fR با ورودی‌هایی که بسط علامت نیافته‌اند (sign\-extended نشده‌اند). هنگام کامپایل با \fB\-march=la664\fR، این گزینه به‌طور پیش‌فرض فعال است. در غیر این صورت پیش‌فرض \fB\-mno\-div32\fR است.
.IP \fB\-mlam\-bh\fR 4
.IX Item "-mlam-bh"
.PD 0
.IP \fB\-mno\-lam\-bh\fR 4
.IX Item "-mno-lam-bh"
.PD
استفاده (یا عدم استفاده) از دستورهای \f(CW\*(C`am{swap/add}[_db].{b/h}\*(C'\fR.
هنگام کامپایل
با \fB\-march=la664\fR، به‌طور پیش‌فرض فعال است. در غیر این صورت
پیش‌فرض \fB\-mno\-lam\-bh\fR است.
.IP \fB\-mlamcas\fR 4
.IX Item "-mlamcas"
.PD 0
.IP \fB\-mno\-lamcas\fR 4
.IX Item "-mno-lamcas"
.PD
استفاده (یا عدم استفاده) از دستورهای \f(CW\*(C`amcas[_db].{b/h/w/d}\*(C'\fR.
هنگام کامپایل با
\&\fB\-march=la664\fR، این گزینه به‌طور پیش‌فرض فعال است. در غیر این صورت پیش‌فرض
\&\fB\-mno\-lamcas\fR است.
.IP \fB\-mld\-seq\-sa\fR 4
.IX Item "-mld-seq-sa"
.PD 0
.IP \fB\-mno\-ld\-seq\-sa\fR 4
.IX Item "-mno-ld-seq-sa"
.PD
تعیین اینکه آیا به یک سد بارگذاری\-بارگذاری هم‌آدرس (\f(CW\*(C`dbar 0x700\*(C'\fR) نیاز است یا خیر. هنگام
کامپایل با \fB\-march=la664\fR، این گزینه به‌طور پیش‌فرض فعال است.
در غیر این صورت، پیش‌فرض
\&\fB\-mno\-ld\-seq\-sa\fR است و به سد بارگذاری\-بارگذاری نیاز خواهد بود.
.IP \fB\-mscq\fR 4
.IX Item "-mscq"
.PD 0
.IP \fB\-mno\-scq\fR 4
.IX Item "-mno-scq"
.PD
استفاده (یا عدم استفاده) از دستور ذخیرهٔ مشروط ۱۶ بایتی \f(CW\*(C`sc.q\*(C'\fR.
اگر نوع ماشین مشخص‌شده با
\&\fB\-march=\fR از این دستور پشتیبانی کند، مقدار پیش‌فرض \fB\-mscq\fR است؛ در غیر این صورت \fB\-mno\-scq\fR خواهد بود.
.IP \fB\-mtls\-dialect=\fR\fIopt\fR 4
.IX Item "-mtls-dialect=opt"
این گزینه مشخص می‌کند کدام گویش TLS برای مدل‌های پویای عمومی (general dynamic) و پویای محلی (local dynamic) می‌تواند استفاده شود. آرگومان \fIopt\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBtrad\fR 4
.IX Item "trad"
استفاده از TLS سنتی. این مقدار پیش‌فرض است.
.IP \fBdesc\fR 4
.IX Item "desc"
استفاده از توصیف‌گرهای TLS.
.RE
.RS 4
.RE
.IP \fB\-mannotate\-tablejump\fR 4
.IX Item "-mannotate-tablejump"
.PD 0
.IP \fB\-mno\-annotate\-tablejump\fR 4
.IX Item "-mno-annotate-tablejump"
.PD
ایجاد یک بخش حاشیه‌نویسی با نام \f(CW\*(C`.discard.tablejump_annotate\*(C'\fR برای مرتبط کردن دستور \f(CW\*(C`jirl\*(C'\fR و جدول پرش، زمانی که از یک جدول پرش برای بهینه‌سازی عبارت \f(CW\*(C`switch\*(C'\fR استفاده می‌شود. برخی ابزارهای خارجی، برای نمونه \fIobjtool\fR در سامانهٔ ساخت هستهٔ لینوکس، برای تحلیل جریان کنترل به این حاشیه‌نویسی نیاز دارند. پیش‌فرض
\&\fB\-mno\-annotate\-tablejump\fR است..PP
\fIگزینه‌های LynxOS\fR
.IX Subsection "LynxOS Options"
.PP
این گزینه‌ها برای اهداف LynxOS در دسترس هستند.
.IP \fB\-mshared\fR 4
.IX Item "-mshared"
استفاده از کتابخانه‌های اشتراکی. حالت پیش‌فرض پیوند دادن با کتابخانه‌های ایستا است.
.IP \fB\-mthreads\fR 4
.IX Item "-mthreads"
پشتیبانی از چندنخی (multi\-threading).
.IP \fB\-mlegacy\-threads\fR 4
.IX Item "-mlegacy-threads"
پشتیبانی از چندنخی سنتی (legacy).
این گزینه با \fB\-mthreads\fR ناسازگار است.
.PP
\fIگزینه‌های M32C\fR
.IX Subsection "M32C Options"
.IP \fB\-mcpu=\fR\fIname\fR 4
.IX Item "-mcpu=name"
پردازنده‌ای (CPU) که کد برای آن تولید می‌شود را انتخاب می‌کند. \fIname\fR می‌تواند یکی از مقادیر
\&\fBr8c\fR برای سری R8C/Tiny، \fBm16c\fR برای سری M16C (تا /60)، \fBm32cm\fR برای سری M16C/80، یا \fBm32c\fR
برای سری M32C/80 باشد.
.IP \fB\-msim\fR 4
.IX Item "-msim"
مشخص می‌کند که برنامه روی شبیه‌ساز اجرا خواهد شد. این کار باعث پیوند خوردن با یک
کتابخانهٔ زمان اجرای جایگزین می‌شود که برای مثال از ورودی/خروجی فایل پشتیبانی می‌کند. هنگام تولید
برنامه‌هایی که قرار است روی سخت‌افزار واقعی اجرا شوند، نباید از این گزینه استفاده کنید؛ باید برای هر
تابع ورودی/خروجی که نیاز است، کتابخانهٔ زمان اجرای خود را فراهم کنید.
.IP \fB\-memregs=\fR\fInumber\fR 4
.IX Item "-memregs=number"
تعداد شبه‌ثبات‌های مبتنی بر حافظه را که GCC در زمان تولید کد استفاده می‌کند، مشخص می‌نماید.
این شبه‌ثبات‌ها مانند ثبات‌های واقعی استفاده می‌شوند، بنابراین بین توانایی GCC در جا دادن
کد در ثبات‌های موجود و افت کارایی ناشی از استفاده از حافظه به جای ثبات‌ها، یک مصالحه وجود دارد.
توجه داشته باشید که تمام ماژول‌های یک برنامه باید با مقدار یکسانی برای این گزینه کامپایل شوند.
به همین دلیل، نباید از این گزینه به همراه کتابخانه‌های زمان اجرای پیش‌فرض GCC استفاده کنید.
.PP
\fIگزینه‌های M32R/D\fR
.IX Subsection "M32R/D Options"
.PP
این گزینه‌های \fB\-m\fR برای معماری‌های Renesas M32R/D تعریف شده‌اند:
.IP \fB\-m32r2\fR 4
.IX Item "-m32r2"
تولید کد برای M32R/2.
.IP \fB\-m32rx\fR 4
.IX Item "-m32rx"
تولید کد برای M32R/X.
.IP \fB\-m32r\fR 4
.IX Item "-m32r"
تولید کد برای M32R. این مقدار پیش‌فرض است.
.IP \fB\-mmodel=small\fR 4
.IX Item "-mmodel=small"
فرض می‌کند همهٔ شیءها در ۱۶ مگابایت ابتدایی حافظه قرار دارند (به طوری که آدرس آن‌ها
بتواند با دستورالعمل \f(CW\*(C`ld24\*(C'\fR بارگذاری شود)، و فرض می‌کند همهٔ زیرروال‌ها
با دستورالعمل \f(CW\*(C`bl\*(C'\fR در دسترس هستند.
این مقدار پیش‌فرض است.
.Sp
آدرس‌پذیری یک شیء خاص را می‌توان با استفاده از ویژگی
\&\f(CW\*(C`model\*(C'\fR تعیین کرد.
.IP \fB\-mmodel=medium\fR 4
.IX Item "-mmodel=medium"
فرض می‌کند شیءها ممکن است در هر کجای فضای آدرس ۳۲ بیتی باشند (کامپایلر
دستورالعمل‌های \f(CW\*(C`seth/add3\*(C'\fR را برای بارگذاری آدرس‌های آن‌ها تولید می‌کند)، و
فرض می‌کند همهٔ زیرروال‌ها با دستورالعمل \f(CW\*(C`bl\*(C'\fR در دسترس هستند.
.IP \fB\-mmodel=large\fR 4
.IX Item "-mmodel=large"
فرض می‌کند شیءها ممکن است در هر کجای فضای آدرس ۳۲ بیتی باشند (کامپایلر
دستورالعمل‌های \f(CW\*(C`seth/add3\*(C'\fR را برای بارگذاری آدرس‌های آن‌ها تولید می‌کند)، و
فرض می‌کند زیرروال‌ها ممکن است با دستورالعمل \f(CW\*(C`bl\*(C'\fR در دسترس نباشند
(کامپایلر توالی دستورالعمل بسیار کندترِ \f(CW\*(C`seth/add3/jl\*(C'\fR
را تولید می‌کند).
.IP \fB\-msdata=none\fR 4
.IX Item "-msdata=none"
استفاده از ناحیهٔ داده‌های کوچک (small data area) را غیرفعال می‌کند. متغیرها در
یکی از بخش‌های \f(CW\*(C`.data\*(C'\fR، \f(CW\*(C`.bss\*(C'\fR، یا \f(CW\*(C`.rodata\*(C'\fR قرار می‌گیرند (مگر این‌که
ویژگی \f(CW\*(C`section\*(C'\fR مشخص شده باشد).
این مقدار پیش‌فرض است.
.Sp
ناحیهٔ داده‌های کوچک شامل بخش‌های \f(CW\*(C`.sdata\*(C'\fR و \f(CW\*(C`.sbss\*(C'\fR است.
اشیاء را می‌توان با استفاده از ویژگی \f(CW\*(C`section\*(C'\fR و با به‌کارگیری
یکی از این بخش‌ها، به صورت صریح در ناحیهٔ داده‌های کوچک قرار داد.
.IP \fB\-msdata=sdata\fR 4
.IX Item "-msdata=sdata"
داده‌های سراسری و ایستای کوچک را در ناحیهٔ داده‌های کوچک قرار می‌دهد، اما
کد خاصی برای ارجاع به آن‌ها تولید نمی‌کند.
.IP \fB\-msdata=use\fR 4
.IX Item "-msdata=use"
داده‌های سراسری و ایستای کوچک را در ناحیهٔ داده‌های کوچک قرار می‌دهد و
دستورالعمل‌های خاصی برای ارجاع به آن‌ها تولید می‌کند.
.IP "\fB\-G\fR \fInum\fR" 4
.IX Item "-G num"
اشیاء سراسری و ایستای کوچک‌تر یا مساوی با \fInum\fR بایت را به جای بخش‌های عادی data
یا BSS، در بخش‌های داده‌های کوچک یا BSS قرار می‌دهد. مقدار پیش‌فرض \fInum\fR برابر 8 است.
گزینهٔ \fB\-msdata\fR برای این‌که این گزینه اثری داشته باشد باید روی یکی از مقادیر
\fBsdata\fR یا \fBuse\fR تنظیم شده باشد.
.Sp
همهٔ ماژول‌ها باید با مقدار \fB\-G\fR \fInum\fR یکسانی کامپایل شوند.
کامپایل کردن با مقادیر متفاوت \fInum\fR ممکن است کار کند یا نکند؛ اگر کار
نکند، پیونددهنده یک پیام خطا می‌دهد\-\-\-کد نادرست تولید نخواهد شد.
.IP \fB\-mdebug\fR 4
.IX Item "-mdebug"
باعث می‌شود کد مخصوص M32R در کامپایلر، برخی آماره‌ها را نمایش دهد
که ممکن است در اشکال‌زدایی برنامه‌ها مفید باشد.
.IP \fB\-malign\-loops\fR 4
.IX Item "-malign-loops"
.PD 0
.IP \fB\-mno\-align\-loops\fR 4
.IX Item "-mno-align-loops"
.PD
تراز کردن همهٔ حلقه‌ها روی یک مرز ۳۲ بایتی. این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-missue\-rate=\fR\fInumber\fR 4
.IX Item "-missue-rate=number"
صدور \fInumber\fR دستورالعمل در هر چرخه. \fInumber\fR تنها می‌تواند 1
یا 2 باشد.
.IP \fB\-mbranch\-cost=\fR\fInumber\fR 4
.IX Item "-mbranch-cost=number"
مقدار \fInumber\fR تنها می‌تواند 1 یا 2 باشد. اگر 1 باشد، انشعاب‌ها بر کد شرطی
ترجیح داده می‌شوند؛ اگر 2 باشد، عکس این حالت اعمال می‌شود.
.IP \fB\-mflush\-trap=\fR\fInumber\fR 4
.IX Item "-mflush-trap=number"
شمارهٔ trap مورد استفاده برای تخلیهٔ حافظهٔ نهان (cache flush) را مشخص می‌کند. مقدار پیش‌فرض
12 است. شماره‌های معتبر بین 0 و 15 (شامل هر دو) هستند.
.IP \fB\-mno\-flush\-trap\fR 4
.IX Item "-mno-flush-trap"
مشخص می‌کند که حافظهٔ نهان نمی‌تواند با استفاده از یک trap تخلیه شود.
.IP \fB\-mflush\-func=\fR\fIname\fR 4
.IX Item "-mflush-func=name"
نام تابع سیستم‌عاملی را که برای تخلیهٔ حافظهٔ نهان باید فراخوانی شود مشخص می‌کند.
مقدار پیش‌فرض \fB_flush_cache\fR است، اما فراخوانی تابع تنها در صورتی
استفاده می‌شود که trap در دسترس نباشد.
.IP \fB\-mno\-flush\-func\fR 4
.IX Item "-mno-flush-func"
نشان می‌دهد که هیچ تابع سیستم‌عاملی برای تخلیهٔ حافظهٔ نهان وجود ندارد.
.PP
\fIگزینه‌های M680x0\fR
.IX Subsection "M680x0 Options"
.PP
این‌ها گزینه‌های \fB\-m\fR تعریف‌شده برای پردازنده‌های M680x0 و ColdFire هستند.
تنظیمات پیش‌فرض به این بستگی دارد که در هنگام پیکربندی کامپایلر کدام معماری
انتخاب شده باشد؛ مقادیر پیش‌فرض برای متداول‌ترین انتخاب‌ها در زیر آمده است.
.IP \fB\-march=\fR\fIarch\fR 4
.IX Item "-march=arch"
تولید کد برای یک معماری مجموعه دستورالعمل خاص از M680x0 یا ColdFire.
مقادیر مجاز برای \fIarch\fR در معماری‌های M680x0 عبارتند از: \fB68000\fR، \fB68010\fR، \fB68020\fR،
\&\fB68030\fR، \fB68040\fR، \fB68060\fR و \fBcpu32\fR. معماری‌های ColdFire بر اساس
طبقه‌بندی ISA شرکت Freescale انتخاب می‌شوند و مقادیر مجاز عبارتند از: \fBisaa\fR، \fBisaaplus\fR،
\&\fBisab\fR و \fBisac\fR.
.Sp
کامپایلر GCC هر زمان که کدی برای یک هدف ColdFire تولید می‌کند، ماکروی \f(CW\*(C`_\|_mcf\fR\f(CIarch\fR\f(CW_\|_\*(C'\fR را
تعریف می‌نماید. \fIarch\fR در این ماکرو یکی از آرگومان‌های \fB\-march\fR است
که در بالا ذکر شد.
.Sp
هنگامی که \fB\-march\fR و \fB\-mtune\fR با یکدیگر استفاده شوند، کدی را انتخاب
می‌کنند که روی خانواده‌ای از پردازنده‌های مشابه اجرا می‌شود اما برای یک
ریزمعماری (microarchitecture) خاص بهینه‌سازی شده است.
.IP \fB\-mcpu=\fR\fIcpu\fR 4
.IX Item "-mcpu=cpu"
تولید کد برای یک پردازندهٔ خاص M680x0 یا ColdFire.
مقادیر \fIcpu\fR برای M680x0 عبارتند از: \fB68000\fR، \fB68010\fR، \fB68020\fR،
\&\fB68030\fR، \fB68040\fR، \fB68060\fR، \fB68302\fR، \fB68332\fR
و \fBcpu32\fR. پردازنده‌های \fIcpu\fR برای ColdFire در جدول زیر آورده
شده‌اند، که همچنین پردازنده‌ها را به خانواده‌ها دسته‌بندی می‌کند:
.RS 4
.IP "\fIخانواده\fR : \fIآرگومان‌های\fR \fB\-mcpu\fR" 4
.IX Item "Family : -mcpu arguments"
.PD 0
.IP "\fB51\fR : \fB51\fR \fB51ac\fR \fB51ag\fR \fB51cn\fR \fB51em\fR \fB51je\fR \fB51jf\fR \fB51jg\fR \fB51jm\fR \fB51mm\fR \fB51qe\fR \fB51qm\fR" 4
.IX Item "51 : 51 51ac 51ag 51cn 51em 51je 51jf 51jg 51jm 51mm 51qe 51qm"
.IP "\fB5206\fR : \fB5202\fR \fB5204\fR \fB5206\fR" 4
.IX Item "5206 : 5202 5204 5206"
.IP "\fB5206e\fR : \fB5206e\fR" 4
.IX Item "5206e : 5206e".IP "\fB5208\fR : \fB5207\fR \fB5208\fR" 4
.IX Item "5208 : 5207 5208"
.IP "\fB5211a\fR : \fB5210a\fR \fB5211a\fR" 4
.IX Item "5211a : 5210a 5211a"
.IP "\fB5213\fR : \fB5211\fR \fB5212\fR \fB5213\fR" 4
.IX Item "5213 : 5211 5212 5213"
.IP "\fB5216\fR : \fB5214\fR \fB5216\fR" 4
.IX Item "5216 : 5214 5216"
.IP "\fB52235\fR : \fB52230\fR \fB52231\fR \fB52232\fR \fB52233\fR \fB52234\fR \fB52235\fR" 4
.IX Item "52235 : 52230 52231 52232 52233 52234 52235"
.IP "\fB5225\fR : \fB5224\fR \fB5225\fR" 4
.IX Item "5225 : 5224 5225"
.IP "\fB52259\fR : \fB52252\fR \fB52254\fR \fB52255\fR \fB52256\fR \fB52258\fR \fB52259\fR" 4
.IX Item "52259 : 52252 52254 52255 52256 52258 52259"
.IP "\fB5235\fR : \fB5232\fR \fB5233\fR \fB5234\fR \fB5235\fR \fB523x\fR" 4
.IX Item "5235 : 5232 5233 5234 5235 523x"
.IP "\fB5249\fR : \fB5249\fR" 4
.IX Item "5249 : 5249"
.IP "\fB5250\fR : \fB5250\fR" 4
.IX Item "5250 : 5250"
.IP "\fB5271\fR : \fB5270\fR \fB5271\fR" 4
.IX Item "5271 : 5270 5271"
.IP "\fB5272\fR : \fB5272\fR" 4
.IX Item "5272 : 5272"
.IP "\fB5275\fR : \fB5274\fR \fB5275\fR" 4
.IX Item "5275 : 5274 5275"
.IP "\fB5282\fR : \fB5280\fR \fB5281\fR \fB5282\fR \fB528x\fR" 4
.IX Item "5282 : 5280 5281 5282 528x"
.IP "\fB53017\fR : \fB53011\fR \fB53012\fR \fB53013\fR \fB53014\fR \fB53015\fR \fB53016\fR \fB53017\fR" 4
.IX Item "53017 : 53011 53012 53013 53014 53015 53016 53017"
.IP "\fB5307\fR : \fB5307\fR" 4
.IX Item "5307 : 5307"
.IP "\fB5329\fR : \fB5327\fR \fB5328\fR \fB5329\fR \fB532x\fR" 4
.IX Item "5329 : 5327 5328 5329 532x"
.IP "\fB5373\fR : \fB5372\fR \fB5373\fR \fB537x\fR" 4
.IX Item "5373 : 5372 5373 537x"
.IP "\fB5407\fR : \fB5407\fR" 4
.IX Item "5407 : 5407"
.IP "\fB5475\fR : \fB5470\fR \fB5471\fR \fB5472\fR \fB5473\fR \fB5474\fR \fB5475\fR \fB547x\fR \fB5480\fR \fB5481\fR \fB5482\fR \fB5483\fR \fB5484\fR \fB5485\fR" 4
.IX Item "5475 : 5470 5471 5472 5473 5474 5475 547x 5480 5481 5482 5483 5484 5485"
.PD
.RE
.RS 4
.Sp
در صورتی که \fIarch\fR با \fIcpu\fR سازگار باشد، \&\fB\-mcpu=\fR\fIcpu\fR بر \&\fB\-march=\fR\fIarch\fR اولویت دارد. سایر ترکیب‌های \&\fB\-mcpu\fR و \&\fB\-march\fR پذیرفته نمی‌شوند.
.Sp
هنگامی که مقصد ColdFire با نام \&\fIcpu\fR انتخاب شود، GCC ماکروی \f(CW\*(C`_\|_mcf_cpu_\fR\f(CIcpu\fR\f(CW\*(C'\fR را تعریف می‌کند. همچنین \f(CW\*(C`_\|_mcf_family_\fR\f(CIfamily\fR\f(CW\*(C'\fR را نیز تعریف می‌کند، که در آن مقدار \fIfamily\fR در جدول بالا مشخص شده است.
.RE
.IP \fB\-mtune=\fR\fItune\fR 4
.IX Item "-mtune=tune"
کد را برای یک ریزمعماری خاص در چارچوب محدودیت‌های تعیین‌شده توسط \fB\-march\fR و \fB\-mcpu\fR تنظیم (بهینه‌سازی) می‌کند.
ریزمعماری‌های M680x0 عبارتند از: \fB68000\fR، \fB68010\fR،
\&\fB68020\fR، \fB68030\fR، \fB68040\fR، \fB68060\fR
و \fBcpu32\fR. ریزمعماری‌های ColdFire
عبارتند از: \fBcfv1\fR، \fBcfv2\fR، \fBcfv3\fR، \fBcfv4\fR و \fBcfv4e\fR.
.Sp
همچنین می‌توانید از \fB\-mtune=68020\-40\fR برای کدهایی استفاده کنید که باید به طور نسبتاً مطلوبی روی مقصدهای 68020، 68030 و 68040 اجرا شوند. گزینهٔ \&\fB\-mtune=68020\-60\fR مشابه است اما مقصدهای 68060 را نیز شامل می‌شود. این دو گزینه به ترتیب همان تصمیم‌های بهینه‌سازی \&\fB\-m68020\-40\fR و \fB\-m68020\-60\fR را برمی‌گزینند.
.Sp
هنگام بهینه‌سازی برای معماری 680x0 با نام \fIarch\fR، کامپایلر GCC ماکروهای \f(CW\*(C`_\|_mc\fR\f(CIarch\fR\f(CW\*(C'\fR و \f(CW\*(C`_\|_mc\fR\f(CIarch\fR\f(CW_\|_\*(C'\fR را تعریف می‌کند. همچنین \&\f(CW\*(C`mc\fR\f(CIarch\fR\f(CW\*(C'\fR را نیز تعریف می‌کند، مگر اینکه گزینهٔ \fB\-ansi\fR یا یک گزینهٔ غیر گنو \fB\-std\fR استفاده شده باشد. اگر GCC برای محدوده‌ای از معماری‌ها تنظیم شود، مانند آنچه با \fB\-mtune=68020\-40\fR یا \fB\-mtune=68020\-60\fR انتخاب می‌شود، ماکروها را برای تمام معماری‌های موجود در آن بازه تعریف می‌کند.
.Sp
کامپایلر GCC همچنین ماکروی \f(CW\*(C`_\|_m\fR\f(CIuarch\fR\f(CW_\|_\*(C'\fR را هنگام بهینه‌سازی برای ریزمعماری ColdFire با نام \fIuarch\fR تعریف می‌کند، که در آن \fIuarch\fR یکی از آرگومان‌های ارائه‌شده در بالا است.
.IP \fB\-m68000\fR 4
.IX Item "-m68000"
.PD 0
.IP \fB\-mc68000\fR 4
.IX Item "-mc68000"
.PD
تولید خروجی برای 68000. این حالت پیش‌فرض است زمانی که کامپایلر برای سیستم‌های مبتنی بر 68000 پیکربندی شده باشد. این گزینه معادل \fB\-march=68000\fR است.
.Sp
از این گزینه برای میکروکنترلرهای دارای هستهٔ 68000 یا EC000 شامل 68008، 68302، 68306، 68307، 68322، 68328 و 68356 استفاده کنید.
.IP \fB\-m68010\fR 4
.IX Item "-m68010"
تولید خروجی برای 68010. این حالت پیش‌فرض است زمانی که کامپایلر برای سیستم‌های مبتنی بر 68010 پیکربندی شده باشد. این گزینه معادل \fB\-march=68010\fR است.
.IP \fB\-m68020\fR 4
.IX Item "-m68020"
.PD 0
.IP \fB\-mc68020\fR 4
.IX Item "-mc68020"
.PD
تولید خروجی برای 68020. این حالت پیش‌فرض است زمانی که کامپایلر برای سیستم‌های مبتنی بر 68020 پیکربندی شده باشد. این گزینه معادل \fB\-march=68020\fR است.
.IP \fB\-m68030\fR 4
.IX Item "-m68030"
تولید خروجی برای 68030. این حالت پیش‌فرض است هنگامی که کامپایلر برای سیستم‌های مبتنی بر 68030 پیکربندی شده باشد. این گزینه معادل \&\fB\-march=68030\fR است.
.IP \fB\-m68040\fR 4
.IX Item "-m68040"
تولید خروجی برای 68040. این حالت پیش‌فرض است هنگامی که کامپایلر برای سیستم‌های مبتنی بر 68040 پیکربندی شده باشد. این گزینه معادل \&\fB\-march=68040\fR است.
.Sp
این گزینه از به‌کارگیری دستورالعمل‌های 68881/68882 که باید توسط نرم‌افزار روی 68040 شبیه‌سازی شوند جلوگیری می‌کند. اگر 68040 شما کدی برای شبیه‌سازی آن دستورالعمل‌ها ندارد از این گزینه استفاده کنید.
.IP \fB\-m68060\fR 4
.IX Item "-m68060"
تولید خروجی برای 68060. این حالت پیش‌فرض است هنگامی که کامپایلر برای سیستم‌های مبتنی بر 68060 پیکربندی شده باشد. این گزینه معادل \&\fB\-march=68060\fR است.
.Sp
این گزینه از به‌کارگیری دستورالعمل‌های 68020 و 68881/68882 که باید توسط نرم‌افزار روی 68060 شبیه‌سازی شوند جلوگیری می‌کند. اگر 68060 شما کدی برای شبیه‌سازی آن دستورالعمل‌ها ندارد از این گزینه استفاده کنید.
.IP \fB\-m68302\fR 4
.IX Item "-m68302"
تولید کد برای 68302.
.IP \fB\-m68332\fR 4
.IX Item "-m68332"
تولید کد برای 68332.
.IP \fB\-m68851\fR 4
.IX Item "-m68851"
پردازندهٔ 68851 یک MMU خارجی برای پردازندهٔ 68020 بود. کامپایلر GCC این گزینه را می‌پذیرد، اما از آن استفاده نمی‌کند.
.IP \fB\-mcpu32\fR 4
.IX Item "-mcpu32"
تولید خروجی برای CPU32. این حالت پیش‌فرض است زمانی که کامپایلر برای سیستم‌های مبتنی بر CPU32 پیکربندی شده باشد. این گزینه معادل \fB\-march=cpu32\fR است.
.Sp
از این گزینه برای میکروکنترلرهای دارای هستهٔ CPU32 یا CPU32+ شامل 68330، 68331، 68332، 68333، 68334، 68336، 68340، 68341، 68349 و 68360 استفاده کنید.
.IP \fB\-mfidoa\fR 4
.IX Item "-mfidoa"
تولید کد برای Fido A.
.IP \fB\-m5200\fR 4
.IX Item "-m5200"
تولید خروجی برای پردازندهٔ ColdFire 520X. این حالت پیش‌فرض است زمانی که کامپایلر برای سیستم‌های مبتنی بر 520X پیکربندی شده باشد. این گزینه معادل \fB\-mcpu=5206\fR است، و اکنون به نفع آن گزینه منسوخ شده است.
.Sp
از این گزینه برای میکروکنترلرهای با هستهٔ 5200، شامل MCF5202، MCF5203، MCF5204 و MCF5206 استفاده کنید.
.IP \fB\-m5206e\fR 4
.IX Item "-m5206e"
تولید خروجی برای پردازندهٔ ColdFire 5206e. این گزینه اکنون به نفع گزینهٔ معادل \fB\-mcpu=5206e\fR منسوخ شده است.
.IP \fB\-m528x\fR 4
.IX Item "-m528x"
تولید خروجی برای یکی از اعضای خانوادهٔ ColdFire 528X. این گزینه اکنون به نفع گزینهٔ معادل \&\fB\-mcpu=528x\fR منسوخ شده است.
.IP \fB\-m5307\fR 4
.IX Item "-m5307"
تولید خروجی برای پردازندهٔ ColdFire 5307. این گزینه اکنون به نفع گزینهٔ معادل \fB\-mcpu=5307\fR منسوخ شده است.
.IP \fB\-m5407\fR 4
.IX Item "-m5407"
تولید خروجی برای پردازندهٔ ColdFire 5407. این گزینه اکنون به نفع گزینهٔ معادل \fB\-mcpu=5407\fR منسوخ شده است.
.IP \fB\-mcfv4e\fR 4
.IX Item "-mcfv4e"
تولید خروجی برای پردازنده‌ای از خانوادهٔ ColdFire V4e (مانند 547x/548x). این شامل استفاده از دستورالعمل‌های سخت‌افزاری ممیز شناور می‌شود. این گزینه معادل \fB\-mcpu=547x\fR است، و اکنون به نفع آن گزینه منسوخ شده است..IP \fB\-m68020\-40\fR 4
.IX Item "-m68020-40"
تولید خروجی برای 68040، بدون استفاده از هیچ‌یک از دستورالعمل‌های جدید.
این کار منجر به تولید کدی می‌شود که می‌تواند با کارایی نسبتاً مناسبی روی
68020/68881 یا 68030 یا 68040 اجرا شود. کد تولیدشده از دستورالعمل‌های
68881 که روی 68040 شبیه‌سازی می‌شوند استفاده می‌کند.
.Sp
این گزینه معادل \fB\-march=68020\fR \fB\-mtune=68020\-40\fR است.
.IP \fB\-m68020\-60\fR 4
.IX Item "-m68020-60"
تولید خروجی برای 68060، بدون استفاده از هیچ‌یک از دستورالعمل‌های جدید.
این کار منجر به تولید کدی می‌شود که می‌تواند با کارایی نسبتاً مناسبی روی
68020/68881 یا 68030 یا 68040 اجرا شود. کد تولیدشده از دستورالعمل‌های
68881 که روی 68060 شبیه‌سازی می‌شوند استفاده می‌کند.
.Sp
این گزینه معادل \fB\-march=68020\fR \fB\-mtune=68020\-60\fR است.
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD 0
.IP \fB\-m68881\fR 4
.IX Item "-m68881"
.PD
تولید دستورالعمل‌های ممیز شناور (floating\-point). این مقدار پیش‌فرض برای 68020
و بالاتر و همچنین دستگاه‌های ColdFire دارای FPU است. این گزینه ماکروی
\f(CW\*(C`_\|_HAVE_68881_\|_\*(C'\fR را روی اهداف M680x0 و \f(CW\*(C`_\|_mcffpu_\|_\*(C'\fR
را روی اهداف ColdFire تعریف می‌کند.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
دستورالعمل‌های ممیز شناور را تولید نکن؛ به‌جای آن از فراخوانی‌های کتابخانه‌ای استفاده کن.
این مقدار پیش‌فرض برای اهداف 68000، 68010 و 68832 است. همچنین مقدار
پیش‌فرض برای دستگاه‌های ColdFire فاقد FPU می‌باشد.
.IP \fB\-mdiv\fR 4
.IX Item "-mdiv"
.PD 0
.IP \fB\-mno\-div\fR 4
.IX Item "-mno-div"
.PD
دستورالعمل‌های سخت‌افزاری تقسیم و باقیماندهٔ ColdFire را تولید بکن (یا نکن).
اگر \fB\-march\fR بدون \fB\-mcpu\fR استفاده شود، مقدار پیش‌فرض برای معماری‌های
ColdFire برابر «on» (فعال) و برای معماری‌های M680x0 برابر «off» (غیرفعال) است.
در غیر این صورت، مقدار پیش‌فرض از پردازندهٔ مقصد گرفته می‌شود (خواه پردازندهٔ
پیش‌فرض، یا پردازنده‌ای که با \fB\-mcpu\fR مشخص شده است). برای مثال، مقدار
پیش‌فرض برای \fB\-mcpu=5206\fR برابر «off» و برای \&\fB\-mcpu=5206e\fR برابر «on» است.
.Sp
هنگامی که این گزینه فعال باشد، GCC ماکروی \f(CW\*(C`_\|_mcfhwdiv_\|_\*(C'\fR را تعریف می‌کند.
.IP \fB\-mshort\fR 4
.IX Item "-mshort"
.PD 0
.IP \fB\-mno\-short\fR 4
.IX Item "-mno-short"
.IP \fB\-mnoshort\fR 4
.IX Item "-mnoshort"
.PD
نوع \f(CW\*(C`int\*(C'\fR را همانند \f(CW\*(C`short int\*(C'\fR به‌اندازهٔ ۱۶ بیت در نظر بگیر.
علاوه بر این، پارامترهای ارسال‌شده روی پشته نیز حتی در اهدافی که API آن‌ها
ارتقا به ۳۲ بیت را الزامی می‌کند، روی مرز ۱۶ بیتی هم‌تراز می‌شوند.
این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mbitfield\fR 4
.IX Item "-mbitfield"
.PD 0
.IP \fB\-mno\-bitfield\fR 4
.IX Item "-mno-bitfield"
.IP \fB\-mnobitfield\fR 4
.IX Item "-mnobitfield"
.PD
استفاده از دستورالعمل‌های میدان بیتی (bit\-field) را کنترل کن.
گزینه‌های \fB\-m68000\fR، \fB\-mcpu32\fR
و \fB\-m5200\fR مستلزم \fB\-mnobitfield\fR هستند؛
گزینهٔ \fB\-m68020\fR مستلزم \fB\-mbitfield\fR است.
.IP \fB\-mrtd\fR 4
.IX Item "-mrtd"
.PD 0
.IP \fB\-mno\-rtd\fR 4
.IX Item "-mno-rtd"
.IP \fB\-mnortd\fR 4
.IX Item "-mnortd"
.PD
استفاده از یک قرارداد فراخوانی تابع (function\-calling convention) متفاوت را کنترل می‌کند
که در آن توابعی با تعداد ثابتی از آرگومان‌ها با دستورالعمل \f(CW\*(C`rtd\*(C'\fR
بازمی‌گردند؛ دستوری که هنگام بازگشت، آرگومان‌های آن‌ها را از پشته برمی‌دارد (pop می‌کند).
این امر باعث صرفه‌جویی در یک دستورالعمل در تابع فراخواننده می‌شود زیرا نیازی به برداشتن
آرگومان‌ها از پشته در آنجا نیست.
.Sp
این قرارداد فراخوانی با قراردادی که معمولاً در Unix استفاده می‌شود ناسازگار است،
بنابراین اگر نیاز به فراخوانی کتابخانه‌های کامپایل‌شده با کامپایلر Unix دارید،
نمی‌توانید از آن استفاده کنید.
.Sp
همچنین، باید اعلان‌های پیش‌الگو (prototype) را برای تمام توابعی که تعداد متغیری
از آرگومان‌ها دریافت می‌کنند (از جمله \f(CW\*(C`printf\*(C'\fR) فراهم کنید؛
در غیر این صورت برای فراخوانی آن توابع کدی نادرست تولید می‌شود.
.Sp
علاوه بر این، اگر تابعی را با تعداد بیش از حد آرگومان فراخوانی کنید، کد به‌شدت
نادرستی حاصل می‌شود. (به‌طور معمول، آرگومان‌های اضافی بدون هیچ آسیبی
نادیده گرفته می‌شوند.)
.Sp
دستورالعمل \f(CW\*(C`rtd\*(C'\fR توسط پردازنده‌های 68010، 68020، 68030،
68040، 68060 و CPU32 پشتیبانی می‌شود، اما توسط 68000 یا 5200 پشتیبانی نمی‌شود.
.Sp
مقدار پیش‌فرض \fB\-mno\-rtd\fR است.
.IP \fB\-malign\-int\fR 4
.IX Item "-malign-int"
.PD 0
.IP \fB\-mno\-align\-int\fR 4
.IX Item "-mno-align-int"
.PD
کنترل می‌کند که آیا GCC متغیرهای \f(CW\*(C`int\*(C'\fR، \f(CW\*(C`long\*(C'\fR، \f(CW\*(C`long long\*(C'\fR،
\&\f(CW\*(C`float\*(C'\fR، \f(CW\*(C`double\*(C'\fR و \f(CW\*(C`long double\*(C'\fR را روی مرز ۳۲ بیتی
هم‌تراز کند (\fB\-malign\-int\fR) یا مرز ۱۶ بیتی (\fB\-mno\-align\-int\fR).
هم‌تراز کردن متغیرها روی مرزهای ۳۲ بیتی کدی تولید می‌کند که روی پردازنده‌های
دارای گذرگاه‌های ۳۲ بیتی تا حدی سریع‌تر اجرا می‌شود، البته به بهای مصرف حافظهٔ بیشتر.
.Sp
\&\fBهشدار:\fR اگر از گزینهٔ \fB\-malign\-int\fR استفاده کنید، GCC
ساختارهای حاوی انواع فوق را متفاوت از اغلب مشخصات منتشرشدهٔ رابط دودویی
برنامه کاربردی (ABI) برای m68k هم‌تراز می‌کند.
.Sp
استفاده مستقیم از حالت آدرس‌دهی وابسته به pc (pc\-relative) پردازندهٔ 68000، به‌جای
استفاده از جدول آفست سراسری (GOT). در حال حاضر، این گزینه مستلزم \fB\-fpic\fR است
که حداکثر یک آفست ۱۶ بیتی را برای آدرس‌دهی وابسته به pc مجاز می‌داند. در حال حاضر
\&\fB\-fPIC\fR به همراه \fB\-mpcrel\fR پشتیبانی نمی‌شود، هرچند که این قابلیت می‌تواند برای
پردازنده‌های 68020 و بالاتر پشتیبانی شود.
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD 0
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD
فرض نکن (فرض کن) که ارجاعات حافظهٔ غیرهم‌تراز توسط سیستم
مدیریت می‌شوند.
.IP \fB\-msep\-data\fR 4
.IX Item "-msep-data"
.PD 0
.IP \fB\-mno\-sep\-data\fR 4
.IX Item "-mno-sep-data"
.PD
با \fB\-msep\-data\fR،
کدی تولید می‌کند که اجازه می‌دهد بخش داده (data segment) در ناحیه‌ای متفاوت از
حافظه نسبت به بخش متن (text segment) قرار گیرد. این کار امکان اجرا درجا
(execute\-in\-place) را در محیط‌های فاقد مدیریت حافظهٔ مجازی فراهم می‌سازد. این گزینه
مستلزم \&\fB\-fPIC\fR است.
.Sp
این گزینه به‌طور پیش‌فرض غیرفعال است؛ GCC
کدی تولید می‌کند که فرض می‌کند بخش داده بلافاصله پس از بخش متن قرار دارد.
.IP \fB\-mid\-shared\-library\fR 4
.IX Item "-mid-shared-library"
.PD 0
.IP \fB\-mno\-id\-shared\-library\fR 4
.IX Item "-mno-id-shared-library"
.PD
در صورت فعال بودن، کدی تولید می‌کند که از کتابخانه‌های مشترک از طریق روش
شناسهٔ کتابخانه (library ID) پشتیبانی می‌کند.
این کار امکان اجرا درجا و کتابخانه‌های مشترک را در محیط‌های بدون
مدیریت حافظهٔ مجازی فراهم می‌آورد. این گزینه مستلزم \fB\-fPIC\fR است.
.Sp
این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mshared\-library\-id=\fR\fIn\fR 4
.IX Item "-mshared-library-id=n"
شمارهٔ شناسایی کتابخانهٔ مشترک مبتنی بر شناسه را که در حال کامپایل است
مشخص می‌کند. تعیین مقدار 0 کدی فشرده‌تر تولید می‌کند؛ تعیین مقادیر دیگر
تخصیص آن شماره به کتابخانهٔ فعلی را اجباری می‌کند، اما از نظر فضا یا زمان
کارآمدتر از حذف این گزینه نیست.
.IP \fB\-mxgot\fR 4
.IX Item "-mxgot"
.PD 0
.IP \fB\-mno\-xgot\fR 4
.IX Item "-mno-xgot"
.PD
هنگام تولید کد مستقل از موقعیت (position\-independent code) برای ColdFire، کدی
تولید می‌کند که حتی اگر GOT بیش از ۸۱۹۲ مدخل داشته باشد کار کند. این کد بزرگ‌تر
و کندتر از کدی است که بدون این گزینه تولید می‌شود. در پردازنده‌های M680x0، این
گزینه لازم نیست؛ \fB\-fPIC\fR کافی است.
.Sp
به‌طور معمول GCC برای بارگذاری مقادیر از GOT از یک دستورالعمل واحد استفاده می‌کند.
اگرچه این روش نسبتاً کارآمد است، اما تنها زمانی کار می‌کند که اندازهٔ GOT
کمتر از حدود 64k باشد. هر اندازهٔ بزرگ‌تری باعث می‌شود پیونددهنده خطایی مانند
زیر گزارش کند:
.Sp
.Vb 1
\&        relocation truncated to fit: R_68K_GOT16O foobar
.Ve
.Sp
اگر چنین اتفاقی افتاد، باید کد خود را با \fB\-mxgot\fR دوباره کامپایل کنید.
در این صورت باید با GOTهای بسیار بزرگ کار کند. با این حال، کد تولیدشده با
\&\fB\-mxgot\fR کارایی کمتری دارد، زیرا برای واکشی مقدار یک نماد سراسری ۴ دستورالعمل
زمان می‌برد.
.Sp
توجه داشته باشید که برخی پیونددهنده‌ها، از جمله نسخه‌های جدیدتر پیونددهندهٔ GNU،
می‌توانند چندین GOT ایجاد کرده و مدخل‌های GOT را مرتب کنند. اگر از چنین پیونددهنده‌ای
استفاده می‌کنید، تنها در صورتی نیاز به استفاده از \fB\-mxgot\fR خواهید داشت که یک فایل
شیء (object file) منفرد را کامپایل کنید که به بیش از ۸۱۹۲ مدخل GOT دسترسی داشته باشد.
موارد بسیار کمی این‌گونه هستند.
.Sp
این گزینه‌ها هیچ اثری ندارند مگر اینکه GCC در حال تولید
کد مستقل از موقعیت باشد..IP \fB\-mxtls\fR 4
.IX Item "-mxtls"
پشتیبانی از قطعه TLS بزرگ‌تر از 64K. ملاحظات مربوط به استفاده از این گزینه مشابه موارد \fB\-mxgot\fR در بالا است؛ آدرس‌دهی پیش‌فرض با آفست ۱۶\-بیتی برای TLS کارآمدتر است، اما ممکن است برای برخی برنامه‌ها ناکافی باشد.
.IP \fB\-mlong\-jump\-table\-offsets\fR 4
.IX Item "-mlong-jump-table-offsets"
استفاده از آفست‌های ۳۲\-بیتی در جدول‌های \f(CW\*(C`switch\*(C'\fR. پیش‌فرض استفاده از آفست‌های ۱۶\-بیتی است.
.PP
\fIگزینه‌های MCore\fR
.IX Subsection "MCore Options"
.PP
این‌ها گزینه‌های \fB\-m\fR تعریف‌شده برای پردازنده‌های Motorola M*Core هستند.
.IP \fB\-mhardlit\fR 4
.IX Item "-mhardlit"
.PD 0
.IP \fB\-mno\-hardlit\fR 4
.IX Item "-mno-hardlit"
.PD
جای‌گذاری مستقیم مقادیر ثابت درون جریان کد در صورتی که در دو دستورالعمل یا کمتر امکان‌پذیر باشد.
.IP \fB\-mdiv\fR 4
.IX Item "-mdiv"
.PD 0
.IP \fB\-mno\-div\fR 4
.IX Item "-mno-div"
.PD
استفاده از دستورالعمل تقسیم. (به‌طور پیش‌فرض فعال است).
.IP \fB\-mrelax\-immediates\fR 4
.IX Item "-mrelax-immediates"
.PD 0
.IP \fB\-mno\-relax\-immediates\fR 4
.IX Item "-mno-relax-immediates"
.PD
اجازه دادن به مقادیر بی‌واسطه با اندازه دلخواه در عملیات بیتی.
.IP \fB\-mwide\-bitfields\fR 4
.IX Item "-mwide-bitfields"
.PD 0
.IP \fB\-mno\-wide\-bitfields\fR 4
.IX Item "-mno-wide-bitfields"
.PD
در نظر گرفتن همیشگی فیلدهای بیتی به اندازه \f(CW\*(C`int\*(C'\fR.
.IP \fB\-m4byte\-functions\fR 4
.IX Item "-m4byte-functions"
.PD 0
.IP \fB\-mno\-4byte\-functions\fR 4
.IX Item "-mno-4byte-functions"
.PD
اجبار تمام توابع به تراز شدن روی مرز ۴\-بایتی.
.IP \fB\-mcallgraph\-data\fR 4
.IX Item "-mcallgraph-data"
.PD 0
.IP \fB\-mno\-callgraph\-data\fR 4
.IX Item "-mno-callgraph-data"
.PD
تولید اطلاعات گراف فراخوانی (callgraph).
.IP \fB\-mslow\-bytes\fR 4
.IX Item "-mslow-bytes"
.PD 0
.IP \fB\-mno\-slow\-bytes\fR 4
.IX Item "-mno-slow-bytes"
.PD
ترجیح دسترسی کلمه‌ای هنگام خواندن مقادیر بایتی.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
.PD 0
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
.PD
تولید کد به ترتیب برای مقاصد little-endian یا big-endian. پیش‌فرض big-endian است. کد little-endian فقط با \fB\-m340\fR پشتیبانی می‌شود.
.IP \fB\-m210\fR 4
.IX Item "-m210"
تولید کد برای پردازنده 210.
.IP \fB\-m340\fR 4
.IX Item "-m340"
تولید کد برای پردازنده 340.
.IP \fB\-mno\-lsim\fR 4
.IX Item "-mno-lsim"
فرض بر این که پشتیبانی زمان اجرا از پیش فراهم شده است و در نتیجه کتابخانه شبیه‌ساز (\fIlibsim.a)\fR از خط فرمان پیونددهنده حذف می‌شود.
.IP \fB\-mstack\-increment=\fR\fIsize\fR 4
.IX Item "-mstack-increment=size"
تنظیم بیشینه مقدار برای یک عملیات منفرد افزایش پشته. مقادیر بزرگ می‌توانند سرعت برنامه‌هایی را که شامل توابعی با نیاز به فضای پشته زیاد هستند افزایش دهند، اما اگر پشته بیش از حد گسترش یابد، می‌توانند باعث بروز خطای بخش‌بندی (segmentation fault) نیز بشوند. مقدار پیش‌فرض 0x1000 است.
.PP
\fIگزینه‌های MicroBlaze\fR
.IX Subsection "MicroBlaze Options"
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
استفاده از شبیه‌سازی نرم‌افزاری برای ممیز شناور (پیش‌فرض).
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
استفاده از دستورالعمل‌های سخت‌افزاری ممیز شناور.
.IP \fB\-mmemcpy\fR 4
.IX Item "-mmemcpy"
عدم بهینه‌سازی انتقال‌های بلوکی؛ استفاده از \f(CW\*(C`memcpy\*(C'\fR.
.IP \fB\-mcpu=\fR\fIcpu\-type\fR 4
.IX Item "-mcpu=cpu-type"
استفاده از ویژگی‌ها و زمان‌بندی کد برای CPU مشخص‌شده.
مقادیر پشتیبانی‌شده در قالب \fBv\fR\fIX\fR\fB.\fR\fIYY\fR\fB.\fR\fIZ\fR هستند،
که در آن \fIX\fR نسخه اصلی، \fIYY\fR نسخه فرعی، و
\&\fIZ\fR کد سازگاری است. مقادیر نمونه عبارتند از \fBv3.00.a\fR،
\&\fBv4.00.b\fR، \fBv5.00.a\fR، \fBv5.00.b\fR، \fBv6.00.a\fR.
.IP \fB\-mxl\-soft\-mul\fR 4
.IX Item "-mxl-soft-mul"
.PD 0
.IP \fB\-mno\-xl\-soft\-mul\fR 4
.IX Item "-mno-xl-soft-mul"
.PD
استفاده از شبیه‌سازی نرم‌افزاری ضرب. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mxl\-soft\-div\fR 4
.IX Item "-mxl-soft-div"
.PD 0
.IP \fB\-mno\-xl\-soft\-div\fR 4
.IX Item "-mno-xl-soft-div"
.PD
استفاده از شبیه‌سازی نرم‌افزاری برای تقسیم. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mxl\-barrel\-shift\fR 4
.IX Item "-mxl-barrel-shift"
استفاده از شیفت‌دهنده بشکه‌ای سخت‌افزاری.
.IP \fB\-mxl\-pattern\-compare\fR 4
.IX Item "-mxl-pattern-compare"
استفاده از دستورالعمل‌های مقایسه الگو.
.IP \fB\-msmall\-divides\fR 4
.IX Item "-msmall-divides"
استفاده از بهینه‌سازی جدول جستجو برای تقسیم اعداد صحیح علامت‌دار کوچک.
.IP \fB\-mxl\-gp\-opt\fR 4
.IX Item "-mxl-gp-opt"
استفاده از بخش‌های \f(CW\*(C`.sdata\*(C'\fR/\f(CW\*(C`.sbss\*(C'\fR با آدرس‌دهی نسبی به GP.
.IP \fB\-mxl\-multiply\-high\fR 4
.IX Item "-mxl-multiply-high"
استفاده از دستورالعمل‌های ضرب بالا برای بخش بالایی حاصل‌ضرب 32x32.
.IP \fB\-mxl\-float\-convert\fR 4
.IX Item "-mxl-float-convert"
استفاده از دستورالعمل‌های سخت‌افزاری تبدیل ممیز شناور.
.IP \fB\-mxl\-float\-sqrt\fR 4
.IX Item "-mxl-float-sqrt"
استفاده از دستورالعمل سخت‌افزاری جذر ممیز شناور.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
تولید کد برای مقصد big-endian.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
تولید کد برای مقصد little-endian.
.IP \fB\-mxl\-reorder\fR 4
.IX Item "-mxl-reorder"
استفاده از دستورالعمل‌های بازآرایی (دستورهای swap و بارگذاری/ذخیره‌سازی با بایت‌های معکوس).
.IP \fB\-mxl\-mode\-\fR\fIapp\-model\fR 4
.IX Item "-mxl-mode-app-model"
انتخاب مدل برنامه \fIapp\-model\fR. مدل‌های معتبر عبارتند از:
.RS 4
.IP \fBexecutable\fR 4
.IX Item "executable"
برنامه اجرایی عادی (پیش‌فرض)، از کد راه‌اندازی \fIcrt0.o\fR استفاده می‌کند.
.IP \fBxmdstub\fR 4
.IX Item "xmdstub"
جهت استفاده همراه با عامل دیباگ نفوذی مبتنی بر Xilinx Microprocessor Debugger (XMD) به نام xmdstub. این مدل از فایل راه‌اندازی
\&\fIcrt1.o\fR استفاده می‌کند و نشانی آغازین برنامه را روی 0x800 تنظیم می‌نماید.
.IP \fBbootstrap\fR 4
.IX Item "bootstrap"
برای برنامه‌هایی که با استفاده از یک بارگذار بوت بارگذاری می‌شوند.
این مدل از فایل راه‌اندازی \fIcrt2.o\fR استفاده می‌کند که فاقد گرداننده بردار بازنشانی پردازنده است. این حالت برای انتقال کنترل در هنگام بازنشانی پردازنده به بارگذار بوت به جای برنامه مناسب است.
.IP \fBnovectors\fR 4
.IX Item "novectors"
برای برنامه‌هایی که به هیچ‌یک از بردارهای MicroBlaze نیازی ندارند. این گزینه ممکن است برای برنامه‌هایی که درون یک برنامه پایشگر اجرا می‌شوند مفید باشد. این مدل از \fIcrt3.o\fR به عنوان فایل راه‌اندازی استفاده می‌کند.
.RE
.RS 4
.RE.IP \fB\-mxl\-prefetch\fR 4
.IX Item "-mxl-prefetch"
فعال‌سازی درج دستورالعمل‌های پیش‌واکشی (\f(CW\*(C`wic\*(C'\fR) در محل‌های فراخوانی (call sites).
.IP \fB\-mpic\-data\-is\-text\-relative\fR 4
.IX Item "-mpic-data-is-text-relative"
فرض می‌کند که جابه‌جایی میان بخش‌های text و data در زمان پیوند ایستا (static link time) ثابت است. این قابلیت اجازه می‌دهد که داده‌ها به‌جای GOT، از طریق آفست نسبت به ابتدای آدرس text ارجاع داده شوند، زیرا آدرس‌دهی وابسته به PC پشتیبانی نمی‌شود.
.PP
\fIگزینه‌های MIPS (MIPS Options)\fR
.IX Subsection "MIPS Options"
.IP \fB\-EB\fR 4
.IX Item "-EB"
.PD 0
.IP \fB\-meb\fR 4
.IX Item "-meb"
.PD
تولید کد بزرگ‌پایان (big\-endian).
.IP \fB\-EL\fR 4
.IX Item "-EL"
.PD 0
.IP \fB\-mel\fR 4
.IX Item "-mel"
.PD
تولید کد کوچک‌پایان (little\-endian). این گزینه پیش‌فرض برای پیکربندی‌های \fBmips*el\-*\-*\fR است.
.IP \fB\-march=\fR\fIarch\fR 4
.IX Item "-march=arch"
تولید کد قابل اجرا روی \fIarch\fR، که می‌تواند نام یک ISA عمومی MIPS یا نام یک پردازندهٔ خاص باشد.
نام‌های ISA عبارتند از:
\&\fBmips1\fR، \&\fBmips2\fR، \&\fBmips3\fR، \&\fBmips4\fR،
\&\fBmips32\fR، \&\fBmips32r2\fR، \&\fBmips32r3\fR، \&\fBmips32r5\fR،
\&\fBmips32r6\fR، \&\fBmips64\fR، \&\fBmips64r2\fR، \&\fBmips64r3\fR،
\&\fBmips64r5\fR و \fBmips64r6\fR.
نام‌های پردازنده عبارتند از:
\&\fB4kc\fR، \fB4km\fR، \fB4kp\fR، \fB4ksc\fR،
\&\fB4kec\fR، \fB4kem\fR، \fB4kep\fR، \fB4ksd\fR،
\&\fB5kc\fR، \fB5kf\fR،
\&\fB20kc\fR،
\&\fB24kc\fR، \fB24kf2_1\fR، \fB24kf1_1\fR،
\&\fB24kec\fR، \fB24kef2_1\fR، \fB24kef1_1\fR،
\&\fB34kc\fR، \fB34kf2_1\fR، \fB34kf1_1\fR، \fB34kn\fR،
\&\fB74kc\fR، \fB74kf2_1\fR، \fB74kf1_1\fR، \fB74kf3_2\fR،
\&\fB1004kc\fR، \fB1004kf2_1\fR، \fB1004kf1_1\fR،
\&\fBi6400\fR، \fBi6500\fR،
\&\fBinteraptiv\fR،
\&\fBloongson2e\fR، \fBloongson2f\fR، \fBloongson3a\fR، \fBgs464\fR،
\&\fBgs464e\fR، \fBgs264e\fR،
\&\fBm4k\fR،
\&\fBm14k\fR، \fBm14kc\fR، \fBm14ke\fR، \fBm14kec\fR،
\&\fBm5100\fR، \fBm5101\fR،
\&\fBocteon\fR، \fBocteon+\fR، \fBocteon2\fR، \fBocteon3\fR،
\&\fBorion\fR،
\&\fBp5600\fR، \fBp6600\fR،
\&\fBr2000\fR، \fBr3000\fR، \fBr3900\fR، \fBr4000\fR، \fBr4400\fR،
\&\fBr4600\fR، \fBr4650\fR، \fBr4700\fR، \fBr5900\fR،
\&\fBr6000\fR، \fBr8000\fR،
\&\fBrm7000\fR، \fBrm9000\fR،
\&\fBr10000\fR، \fBr12000\fR، \fBr14000\fR، \fBr16000\fR،
\&\fBsb1\fR،
\&\fBsr71000\fR،
\&\fBvr4100\fR، \fBvr4111\fR، \fBvr4120\fR، \fBvr4130\fR، \fBvr4300\fR،
\&\fBvr5000\fR، \fBvr5400\fR، \fBvr5500\fR،
\&\fBxlr\fR و \fBxlp\fR.
\&\fBallegrex\fR،
مقدار ویژهٔ \fBfrom\-abi\fR سازگارترین معماری را برای ABI انتخاب‌شده برمی‌گزیند (یعنی
\&\fBmips1\fR برای ABIهای ۳۲ بیتی و \fBmips3\fR برای ABIهای ۶۴ بیتی).
.Sp
زنجیره ابزار بومی Linux/GNU نیز از مقدار \fBnative\fR پشتیبانی می‌کند،
که بهترین گزینهٔ معماری را برای پردازندهٔ میزبان انتخاب می‌نماید.
اگر GCC پردازنده را شناسایی نکند، \fB\-march=native\fR هیچ تأثیری نخواهد داشت.
.Sp
در نام‌های پردازنده‌ها، پسوند پایانی \fB000\fR می‌تواند به صورت \fBk\fR خلاصه شود
(برای مثال، \fB\-march=r2k\fR). پیشوندها اختیاری هستند و
\&\fBvr\fR ممکن است به‌صورت \fBr\fR نوشته شود.
.Sp
نام‌هایی با قالب \fIn\fR\fBf2_1\fR به پردازنده‌هایی اشاره دارند که کلاک FPU آن‌ها با نصف نرخ کلاک هسته کار می‌کند، نام‌هایی با قالب
\&\fIn\fR\fBf1_1\fR به پردازنده‌هایی با FPUهایی اشاره دارند که سرعت کلاک یکسانی
با هسته دارند، و نام‌هایی با قالب \fIn\fR\fBf3_2\fR به
پردازنده‌هایی اشاره دارند که نسبت کلاک FPU آن‌ها ۳:۲ نسبت به هسته است.
به دلایل سازگاری، \fIn\fR\fBf\fR به عنوان مترادفی برای
\fIn\fR\fBf2_1\fR پذیرفته شده است، در حالی که \fIn\fR\fBx\fR و \fIb\fR\fBfx\fR به عنوان
مترادف‌هایی برای \fIn\fR\fBf1_1\fR پذیرفته می‌شوند.
.Sp
کامپایلر GCC بر پایهٔ مقدار این گزینه، دو ماکرو تعریف می‌کند. ماکروی نخست
\f(CW\*(C`_MIPS_ARCH\*(C'\fR است که نام معماری هدف را به‌صورت یک
رشته مشخص می‌کند. ماکروی دوم ساختار \f(CW\*(C`_MIPS_ARCH_\fR\f(CIfoo\fR\f(CW\*(C'\fR دارد
که در آن \fIfoo\fR مقدار بزرگ‌نویسی‌شدهٔ \f(CW\*(C`_MIPS_ARCH\*(C'\fR است.
برای مثال، \fB\-march=r2000\fR مقدار \f(CW\*(C`_MIPS_ARCH\*(C'\fR را برابر
با \f(CW"r2000"\fR قرار داده و ماکروی \f(CW\*(C`_MIPS_ARCH_R2000\*(C'\fR را تعریف می‌کند.
.Sp
توجه داشته باشید که ماکروی \f(CW\*(C`_MIPS_ARCH\*(C'\fR از نام‌های پردازنده که در بالا
ذکر شد استفاده می‌کند. به بیانی دیگر، پیشوند کامل را حفظ کرده و
\fB000\fR را به \fBk\fR خلاصه نمی‌کند. در مورد \fBfrom\-abi\fR،
این ماکرو نام معماری تعیین‌شده (یا \f(CW"mips1"\fR یا
\&\f(CW"mips3"\fR) را برمی‌گرداند. در صورت مشخص نشدن هیچ گزینهٔ
\&\fB\-march\fR، این ماکرو نام معماری پیش‌فرض را تعیین می‌کند.
.IP \fB\-mtune=\fR\fIarch\fR 4
.IX Item "-mtune=arch"
بهینه‌سازی برای \fIarch\fR. این گزینه از جمله، شیوهٔ زمان‌بندی دستورالعمل‌ها
و هزینهٔ تخمینی عملیات محاسباتی را کنترل می‌کند. فهرست مقادیر
\fIarch\fR همانند مقادیر \&\fB\-march\fR است.
.Sp
هنگامی که از این گزینه استفاده نشود، GCC برای پردازنده‌ای که با
\fB\-march\fR مشخص شده است بهینه‌سازی می‌کند. با استفادهٔ هم‌زمان از \fB\-march\fR و
\&\fB\-mtune\fR، می‌توان کدی تولید کرد که روی یک خانواده از پردازنده‌ها اجرا شود،
اما بهینه‌سازی کد برای یکی از اعضای خاص آن خانواده انجام پذیرد.
.Sp
گزینهٔ \&\fB\-mtune\fR ماکروهای \f(CW\*(C`_MIPS_TUNE\*(C'\fR و
\&\f(CW\*(C`_MIPS_TUNE_\fR\f(CIfoo\fR\f(CW\*(C'\fR را تعریف می‌کند، که مشابه ماکروهای
\&\fB\-march\fR شرح‌داده‌شده در بالا عمل می‌کنند.
.IP \fB\-mips1\fR 4
.IX Item "-mips1"
معادل با \fB\-march=mips1\fR.
.IP \fB\-mips2\fR 4
.IX Item "-mips2"
معادل با \fB\-march=mips2\fR.
.IP \fB\-mips3\fR 4
.IX Item "-mips3"
معادل با \fB\-march=mips3\fR.
.IP \fB\-mips4\fR 4
.IX Item "-mips4"
معادل با \fB\-march=mips4\fR.
.IP \fB\-mips32\fR 4
.IX Item "-mips32"
معادل با \fB\-march=mips32\fR.
.IP \fB\-mips32r3\fR 4
.IX Item "-mips32r3"
معادل با \fB\-march=mips32r3\fR.
.IP \fB\-mips32r5\fR 4
.IX Item "-mips32r5"
معادل با \fB\-march=mips32r5\fR.
.IP \fB\-mips32r6\fR 4
.IX Item "-mips32r6"
معادل با \fB\-march=mips32r6\fR.
.IP \fB\-mips64\fR 4
.IX Item "-mips64"
معادل با \fB\-march=mips64\fR.
.IP \fB\-mips64r2\fR 4
.IX Item "-mips64r2"
معادل با \fB\-march=mips64r2\fR.
.IP \fB\-mips64r3\fR 4
.IX Item "-mips64r3"
معادل با \fB\-march=mips64r3\fR.
.IP \fB\-mips64r5\fR 4
.IX Item "-mips64r5"
معادل با \fB\-march=mips64r5\fR.
.IP \fB\-mips64r6\fR 4
.IX Item "-mips64r6"
معادل با \fB\-march=mips64r6\fR.
.IP \fB\-mips16\fR 4
.IX Item "-mips16"
.PD 0
.IP \fB\-mno\-mips16\fR 4
.IX Item "-mno-mips16"
.PD
تولید (عدم تولید) کد MIPS16. اگر هدف GCC یک معماری MIPS32 یا MIPS64 باشد، از MIPS16e ASE بهره می‌برد.
.Sp
تولید کد MIPS16 همچنین می‌تواند بر پایهٔ هر تابع از طریق مشخصه‌های
\f(CW\*(C`mips16\*(C'\fR و \f(CW\*(C`nomips16\*(C'\fR کنترل شود.
.IP \fB\-mmips16e2\fR 4
.IX Item "-mmips16e2"
.PD 0
.IP \fB\-mno\-mips16e2\fR 4
.IX Item "-mno-mips16e2"
.PD
استفاده از (عدم استفاده از) MIPS16e2 ASE. این گزینه رفتار گزینهٔ
\fB\-mips16\fR را تغییر می‌دهد به گونه‌ای که MIPS16e2 ASE را هدف قرار دهد.
.IP \fB\-mflip\-mips16\fR 4
.IX Item "-mflip-mips16"
.PD 0
.IP \fB\-mflip\-mips16\fR 4
.IX Item "-mflip-mips16".PD
تولید کد MIPS16 روی توابع به‌صورت متناوب (یک‌درمیان). این گزینه برای آزمون رگرسیونِ
تولید کد ترکیبی MIPS16/غیر\-MIPS16 ارائه شده است و برای استفادهٔ معمول در کامپایل
کد کاربر در نظر گرفته نشده است.
.IP \fB\-minterlink\-compressed\fR 4
.IX Item "-minterlink-compressed"
.PD 0
.IP \fB\-mno\-interlink\-compressed\fR 4
.IX Item "-mno-interlink-compressed"
.PD
الزام (عدم الزام) به این که کدی که از ISA استاندارد MIPS (فشرده‌نشده) استفاده می‌کند،
از نظر پیوند با کد MIPS16 و microMIPS سازگار باشد و برعکس.
.Sp
برای نمونه، کدی که از کدگذاری استاندارد ISA استفاده می‌کند نمی‌تواند مستقیماً به کد
MIPS16 یا microMIPS پرش کند؛ بلکه باید از یک فراخوانی یا یک پرش غیرمستقیم استفاده
نماید. بنابراین \&\fB\-minterlink\-compressed\fR پرش‌های مستقیم را غیرفعال می‌کند
مگر آن‌که GCC بداند مقصد پرش فشرده نیست.
.IP \fB\-minterlink\-mips16\fR 4
.IX Item "-minterlink-mips16"
.PD 0
.IP \fB\-mno\-interlink\-mips16\fR 4
.IX Item "-mno-interlink-mips16"
.PD
نام‌های مستعار \fB\-minterlink\-compressed\fR و
\&\fB\-mno\-interlink\-compressed\fR. این گزینه‌ها پیش از microMIPS ASE
به وجود آمده‌اند و برای سازگاری با نسخه‌های پیشین نگه‌داشته شده‌اند.
.IP \fB\-mabi=32\fR 4
.IX Item "-mabi=32"
.PD 0
.IP \fB\-mabi=o64\fR 4
.IX Item "-mabi=o64"
.IP \fB\-mabi=n32\fR 4
.IX Item "-mabi=n32"
.IP \fB\-mabi=64\fR 4
.IX Item "-mabi=64"
.IP \fB\-mabi=eabi\fR 4
.IX Item "-mabi=eabi"
.PD
تولید کد برای ABI مشخص‌شده.
.Sp
توجه داشته باشید که EABI دارای یک نوع ۳۲ بیتی و یک نوع ۶۴ بیتی است.
به‌طور معمول هنگامی که یک معماری ۶۴ بیتی را انتخاب می‌کنید GCC کد
۶۴ بیتی تولید می‌کند، اما می‌توانید از \fB\-mgp32\fR برای دریافت کد
۳۲ بیتی به جای آن استفاده کنید.
.Sp
برای اطلاعات بیشتر دربارهٔ O64 ABI، به
<\fBhttps://gcc.gnu.org/projects/mipso64\-abi.html\fR> مراجعه کنید.
.Sp
کامپایلر GCC از نوعی از o32 ABI پشتیبانی می‌کند که در آن ثبات‌های ممیز
شناور به جای ۳۲ بیت، دارای پهنای ۶۴ بیت هستند. می‌توانید این ترکیب را با
\&\fB\-mabi=32\fR \fB\-mfp64\fR انتخاب کنید. این ABI به دستورالعمل‌های
\f(CW\*(C`mthc1\*(C'\fR و \f(CW\*(C`mfhc1\*(C'\fR متکی است و بنابراین تنها در
پردازنده‌های MIPS32R2، MIPS32R3 و MIPS32R5 پشتیبانی می‌شود.
.Sp
تخصیص ثبات‌ها برای آرگومان‌ها و مقادیر بازگشتی یکسان باقی می‌ماند، اما هر
مقدار اسکالر به جای یک جفت ثبات ۳۲ بیتی، در یک ثبات ۶۴ بیتی تکی ارسال
می‌شود. برای مثال، مقادیر ممیز شناور اسکالر فقط در \fR\f(CB$f0\fR\fB\fR
بازگردانده می‌شوند، نه در یک جفت \&\fB\fR\f(CB$f0\fR\fB\fR/\fB\fR\f(CB$f1\fR\fB\fR.
مجموعهٔ ثبات‌های ذخیره‌شده هنگام فراخوانی (call\-saved) نیز از این حیث
بدون تغییر باقی می‌ماند که ثبات‌های با دقت مضاعفِ شماره‌زوج ذخیره می‌شوند.
.Sp
دو نوع دیگر از o32 ABI برای امکان‌پذیر ساختن انتقال از ثبات‌های ۳۲ بیتی به
۶۴ بیتی پشتیبانی می‌شوند. این دو، FPXX (\fB\-mfpxx\fR) و FP64A
(\fB\-mfp64\fR \fB\-mno\-odd\-spreg\fR) هستند. افزونهٔ FPXX الزام می‌کند که تمام
کدها باید هنگام اجرا با استفاده از ثبات‌های ۳۲ بیتی یا ۶۴ بیتی به‌درستی کار کنند.
این کد می‌تواند با FP32 یا FP64 پیوند متقابل بخورد، اما نه با هر دو.
افزونهٔ FP64A مشابه افزونهٔ FP64 است اما استفاده از ثبات‌های دقت یگانه با
شماره‌های فرد را منع می‌کند. این گزینه می‌تواند در کنار حالت \f(CW\*(C`FRE\*(C'\fR
پردازنده‌های کمکی شناور (FPU) در پردازنده‌های MIPS32R5 استفاده شود و به هر دو کد
FP32 و FP64A امکان می‌دهد بدون تغییر حالت‌های FPU، در یک فرایند پیوند خورده
و اجرا شوند.
.IP \fB\-mabicalls\fR 4
.IX Item "-mabicalls"
.PD 0
.IP \fB\-mno\-abicalls\fR 4
.IX Item "-mno-abicalls"
.PD
تولید (عدم تولید) کدی که برای شیءهای پویای سبک SVR4 مناسب است.
گزینهٔ \fB\-mabicalls\fR برای سیستم‌های مبتنی بر SVR4 پیش‌فرض است.
.IP \fB\-mshared\fR 4
.IX Item "-mshared"
.PD 0
.IP \fB\-mno\-shared\fR 4
.IX Item "-mno-shared"
.PD
تولید (عدم تولید) کدی که کاملاً مستقل از موقعیت است و بنابراین می‌تواند
به کتابخانه‌های مشترک پیوند داده شود. این گزینه فقط بر \fB\-mabicalls\fR
تأثیر می‌گذارد.
.Sp
تمامی کدهای \fB\-mabicalls\fR از قدیم بدون در نظر گرفتن گزینه‌هایی مانند
\fB\-fPIC\fR و \fB\-fpic\fR، مستقل از موقعیت بوده‌اند. با این حال،
زنجیره‌ابزار GNU به‌عنوان یک افزونه به فایل‌های اجرایی اجازه می‌دهد تا برای
نمادهایی با پیوند محلی از دسترسی‌های مطلق استفاده کنند. همچنین می‌تواند از
توالی‌های کوتاه‌تر راه‌اندازی اولیهٔ GP استفاده کند و فراخوانی‌های مستقیم برای
توابعِ تعریف‌شدهٔ محلی بسازد. این حالت با \fB\-mno\-shared\fR انتخاب می‌شود.
.Sp
گزینهٔ \&\fB\-mno\-shared\fR به binutils نسخهٔ 2.16 یا بالاتر وابسته است و
شیءهایی تولید می‌کند که فقط توسط پیونددهندهٔ GNU می‌توانند پیوند داده شوند. با
این حال، این گزینه بر ABI فایل اجرایی نهایی تأثیری ندارد؛ بلکه تنها بر ABI شیءهای
با قابلیت بازنشانی (relocatable) اثر می‌گذارد. استفاده از \fB\-mno\-shared\fR
عموماً فایل‌های اجرایی را هم کوچک‌تر و هم سریع‌تر می‌کند.
.Sp
گزینهٔ \&\fB\-mshared\fR پیش‌فرض است.
.IP \fB\-mplt\fR 4
.IX Item "-mplt"
.PD 0
.IP \fB\-mno\-plt\fR 4
.IX Item "-mno-plt"
.PD
فرض کردن (فرض نکردن) این‌که پیونددهنده‌های ایستا و پویا از PLTها و بازنشانی‌های
کپی (copy relocations) پشتیبانی می‌کنند. این گزینه فقط بر
\&\fB\-mno\-shared \-mabicalls\fR اثر می‌گذارد. برای n64 ABI، این گزینه
بدون \fB\-msym32\fR اثری ندارد.
.Sp
می‌توانید با پیکربندی GCC با \fB\-\-with\-mips\-plt\fR، گزینهٔ \fB\-mplt\fR را
پیش‌فرض کنید. در غیر این صورت، پیش‌فرض \&\fB\-mno\-plt\fR است.
.IP \fB\-mxgot\fR 4
.IX Item "-mxgot"
.PD 0
.IP \fB\-mno\-xgot\fR 4
.IX Item "-mno-xgot"
.PD
برداشتن (برنداشتن) محدودیت‌های معمول روی اندازهٔ جدول افست سراسری (GOT).
.Sp
به‌طور معمول GCC برای بارگذاری مقادیر از GOT از یک دستورالعمل واحد استفاده می‌کند.
اگرچه این کار نسبتاً کارآمد است، تنها در صورتی کار می‌کند که GOT کوچک‌تر از حدود
64k باشد. هر مقداری بزرگ‌تر باعث می‌شود پیونددهنده خطایی مانند زیر را گزارش دهد:
.Sp
.Vb 1
\&        relocation truncated to fit: R_MIPS_GOT16 foobar
.Ve
.Sp
در صورت بروز چنین خطایی، باید کد خود را با \fB\-mxgot\fR دوباره کامپایل کنید.
این روش با GOTهای بسیار بزرگ کار می‌کند، اگرچه کد کارایی کمتری خواهد داشت، چرا که
واکشی مقدار یک نماد سراسری نیازمند سه دستورالعمل خواهد بود.
.Sp
توجه داشته باشید که برخی پیونددهنده‌ها می‌توانند چندین GOT ایجاد کنند. اگر از چنین
پیونددهنده‌ای استفاده می‌کنید، تنها زمانی به \fB\-mxgot\fR نیاز خواهید داشت که یک
فایل شیء واحد به بیش از مدخل‌های معادل 64k از GOT دسترسی پیدا کند. فایل‌های شیء
بسیار اندکی چنین رفتاری دارند.
.Sp
این گزینه‌ها هیچ اثری ندارند مگر این‌که GCC در حال تولید کد مستقل از موقعیت باشد.
.IP \fB\-mgp32\fR 4
.IX Item "-mgp32"
فرض می‌کند که ثبات‌های عمومی ۳۲ بیتی هستند.
.IP \fB\-mgp64\fR 4
.IX Item "-mgp64"
فرض می‌کند که ثبات‌های عمومی ۶۴ بیتی هستند.
.IP \fB\-mfp32\fR 4
.IX Item "-mfp32"
فرض می‌کند که ثبات‌های ممیز شناور ۳۲ بیتی هستند.
.IP \fB\-mfp64\fR 4
.IX Item "-mfp64"
فرض می‌کند که ثبات‌های ممیز شناور ۶۴ بیتی هستند.
.IP \fB\-mfpxx\fR 4
.IX Item "-mfpxx"
هیچ فرضی دربارهٔ پهنای ثبات‌های ممیز شناور در نظر نمی‌گیرد.
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
استفاده از دستورالعمل‌های پردازندهٔ کمکی ممیز شناور.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
عدم استفاده از دستورالعمل‌های پردازندهٔ کمکی ممیز شناور. در عوض، محاسبات
ممیز شناور را با استفاده از فراخوانی توابع کتابخانه‌ای انجام می‌دهد.
.IP \fB\-mno\-float\fR 4
.IX Item "-mno-float"
معادل \fB\-msoft\-float\fR است، اما علاوه بر آن تصریح می‌کند که برنامهٔ در حال
کامپایل هیچ عملیات ممیز شناوری انجام نمی‌دهد. این گزینه در حال حاضر تنها توسط برخی
پیکربندی‌های MIPS بر روی سخت‌افزار خام (bare\-metal) پشتیبانی می‌شود؛ جایی که
ممکن است مجموعهٔ خاصی از کتابخانه‌ها را انتخاب کند که فاقد هرگونه پشتیبانی از ممیز
شناور هستند (از جمله، برای مثال، قالب‌های ممیز شناور در \f(CW\*(C`printf\*(C'\fR).
اگر کدی که با \fB\-mno\-float\fR کامپایل شده است تصادفاً شامل عملیات ممیز شناور باشد،
احتمالاً با خطا در زمان پیوند یا زمان اجرا مواجه خواهد شد..IP \fB\-msingle\-float\fR 4
.IX Item "-msingle-float"
فرض کردن این‌که کمک‌پردازندهٔ ممیز شناور تنها از عملیات با دقت‌تکی پشتیبانی می‌کند.
.IP \fB\-mdouble\-float\fR 4
.IX Item "-mdouble-float"
فرض کردن این‌که کمک‌پردازندهٔ ممیز شناور از عملیات با دقت‌مضاعف پشتیبانی می‌کند. این مقدار پیش‌فرض است.
.IP \fB\-modd\-spreg\fR 4
.IX Item "-modd-spreg"
.PD 0
.IP \fB\-mno\-odd\-spreg\fR 4
.IX Item "-mno-odd-spreg"
.PD
فعال‌سازی استفاده از ثبات‌های ممیز شناور دقت‌تکی با شمارهٔ فرد برای o32 ABI. این گزینه پیش‌فرض برای پردازنده‌هایی است که پشتیبانی آن‌ها از این ثبات‌ها مشخص است. هنگام استفاده از o32 FPXX ABI، گزینهٔ \fB\-mno\-odd\-spreg\fR به‌طور پیش‌فرض تنظیم می‌شود.
.IP \fB\-mabs=2008\fR 4
.IX Item "-mabs=2008"
.PD 0
.IP \fB\-mabs=legacy\fR 4
.IX Item "-mabs=legacy"
.PD
این گزینه‌ها رفتار با داده‌های ممیز شناور ویژهٔ عددناپذیر (NaN) استاندارد IEEE 754 را توسط دستورالعمل‌های ماشین \f(CW\*(C`abs.\fR\f(CIfmt\fR\f(CW\*(C'\fR و
\&\f(CW\*(C`neg.\fR\f(CIfmt\fR\f(CW\*(C'\fR کنترل می‌کنند.
.Sp
به‌طور پیش‌فرض یا زمانی که \fB\-mabs=legacy\fR استفاده می‌شود، رفتار سنتی (legacy) انتخاب می‌گردد. در این حالت این دستورالعمل‌ها محاسباتی تلقی شده و در جایی که عملکرد صحیح مورد نیاز است و عملوند ورودی ممکن است NaN باشد، از آن‌ها اجتناب می‌شود. در عوض، دنبالهٔ طولانی‌تری از دستورالعمل‌ها که بیت علامت دادهٔ ممیز شناور را به‌صورت دستی دستکاری می‌کنند استفاده می‌شود، مگر این‌که گزینهٔ \fB\-ffinite\-math\-only\fR نیز مشخص شده باشد.
.Sp
گزینهٔ \fB\-mabs=2008\fR رفتار IEEE 754\-2008 را انتخاب می‌کند. در این حالت این دستورالعمل‌ها غیرمحاسباتی تلقی می‌شوند و بنابراین در تمام موارد، به‌ویژه در حالتی که عملوند ورودی یک NaN باشد، عملکرد درستی دارند. بنابراین این دستورالعمل‌ها همواره برای عملیات مربوطه استفاده می‌شوند.
.IP \fB\-mnan=2008\fR 4
.IX Item "-mnan=2008"
.PD 0
.IP \fB\-mnan=legacy\fR 4
.IX Item "-mnan=legacy"
.PD
این گزینه‌ها کدگذاری داده‌های ممیز شناور ویژهٔ عددناپذیر (NaN) استاندارد IEEE 754 را کنترل می‌کنند.
.Sp
گزینهٔ \fB\-mnan=legacy\fR کدگذاری سنتی (legacy) را انتخاب می‌کند. در این حالت NaNهای آرام (qNaNs) با 0 بودن بیت نخست فیلد کسر پایانی (trailing significand) نشان داده می‌شوند، در حالی که NaNهای هشداردهنده (sNaNs) با 1 بودن بیت نخست فیلد کسر پایانی نشان داده می‌شوند.
.Sp
گزینهٔ \fB\-mnan=2008\fR کدگذاری IEEE 754\-2008 را انتخاب می‌کند. در این حالت qNaNها با 1 بودن بیت نخست فیلد کسر پایانی مشخص می‌شوند، در حالی که sNaNها با 0 بودن بیت نخست فیلد کسر پایانی مشخص می‌گردند.
.Sp
پیش‌فرض \fB\-mnan=legacy\fR است، مگر این‌که GCC با گزینهٔ \&\fB\-\-with\-nan=2008\fR پیکربندی شده باشد.
.IP \fB\-mllsc\fR 4
.IX Item "-mllsc"
.PD 0
.IP \fB\-mno\-llsc\fR 4
.IX Item "-mno-llsc"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های \fBll\fR، \fBsc\fR و \fBsync\fR برای پیاده‌سازی توابع توکار حافظهٔ اتمی. هنگامی که هیچ‌کدام از این گزینه‌ها مشخص نشده باشد، اگر معماری مقصد از آن‌ها پشتیبانی کند، GCC از این دستورالعمل‌ها استفاده می‌کند.
.Sp
\&\fB\-mllsc\fR زمانی سودمند است که محیط زمان اجرا بتواند این دستورالعمل‌ها را شبیه‌سازی کند و \fB\-mno\-llsc\fR هنگام کامپایل برای معماری‌های مجموعه دستورالعمل (ISA) غیراستاندارد کاربرد دارد. می‌توانید به‌ترتیب با پیکربندی GCC با \fB\-\-with\-llsc\fR و \fB\-\-without\-llsc\fR هر یک را به حالت پیش‌فرض درآورید. گزینهٔ \fB\-\-with\-llsc\fR برای برخی پیکربندی‌ها پیش‌فرض است؛ برای جزئیات به مستندات نصب مراجعه کنید.
.IP \fB\-mdsp\fR 4
.IX Item "-mdsp"
.PD 0
.IP \fB\-mno\-dsp\fR 4
.IX Item "-mno-dsp"
.PD
استفاده کردن (یا نکردن) از ویرایش ۱ افزونهٔ MIPS DSP ASE.
این گزینه ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_mips_dsp\*(C'\fR را تعریف می‌کند. همچنین
\&\f(CW\*(C`_\|_mips_dsp_rev\*(C'\fR را برابر با 1 تعیین می‌کند.
.IP \fB\-mdspr2\fR 4
.IX Item "-mdspr2"
.PD 0
.IP \fB\-mno\-dspr2\fR 4
.IX Item "-mno-dspr2"
.PD
استفاده کردن (یا نکردن) از ویرایش ۲ افزونهٔ MIPS DSP ASE.
این گزینه ماکروهای پیش‌پردازندهٔ \f(CW\*(C`_\|_mips_dsp\*(C'\fR و \f(CW\*(C`_\|_mips_dspr2\*(C'\fR را تعریف می‌کند.
همچنین \f(CW\*(C`_\|_mips_dsp_rev\*(C'\fR را برابر با 2 قرار می‌دهد.
.IP \fB\-msmartmips\fR 4
.IX Item "-msmartmips"
.PD 0
.IP \fB\-mno\-smartmips\fR 4
.IX Item "-mno-smartmips"
.PD
استفاده کردن (یا نکردن) از افزونهٔ MIPS SmartMIPS ASE.
.IP \fB\-mpaired\-single\fR 4
.IX Item "-mpaired-single"
.PD 0
.IP \fB\-mno\-paired\-single\fR 4
.IX Item "-mno-paired-single"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های ممیز شناور جفت‌شده‌تکی (paired\-single).
این گزینه نیازمند فعال بودن پشتیبانی سخت‌افزاری ممیز شناور است.
.IP \fB\-mdmx\fR 4
.IX Item "-mdmx"
.PD 0
.IP \fB\-mno\-mdmx\fR 4
.IX Item "-mno-mdmx"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های افزونهٔ رسانهٔ دیجیتال MIPS (Digital Media Extension).
این گزینه تنها هنگام تولید کد ۶۴ بیتی قابل استفاده است و نیازمند فعال بودن پشتیبانی سخت‌افزاری ممیز شناور است.
.IP \fB\-mips3d\fR 4
.IX Item "-mips3d"
.PD 0
.IP \fB\-mno\-mips3d\fR 4
.IX Item "-mno-mips3d"
.PD
استفاده کردن (یا نکردن) از افزونهٔ MIPS\-3D ASE.
گزینهٔ \fB\-mips3d\fR مستلزم فعال بودن \fB\-mpaired\-single\fR است.
.IP \fB\-mmicromips\fR 4
.IX Item "-mmicromips"
.PD 0
.IP \fB\-mno\-micromips\fR 4
.IX Item "-mno-micromips"
.PD
تولید کردن (یا نکردن) کد microMIPS.
.Sp
تولید کد microMIPS می‌تواند بر پایهٔ هر تابع نیز از طریق مشخصه‌های
\f(CW\*(C`micromips\*(C'\fR و \f(CW\*(C`nomicromips\*(C'\fR کنترل شود.
.IP \fB\-mmt\fR 4
.IX Item "-mmt"
.PD 0
.IP \fB\-mno\-mt\fR 4
.IX Item "-mno-mt"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های چندریسمانی (Multithreading) MT.
.IP \fB\-mmcu\fR 4
.IX Item "-mmcu"
.PD 0
.IP \fB\-mno\-mcu\fR 4
.IX Item "-mno-mcu"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های افزونهٔ MIPS MCU ASE.
.IP \fB\-meva\fR 4
.IX Item "-meva"
.PD 0
.IP \fB\-mno\-eva\fR 4
.IX Item "-mno-eva"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های آدرس‌دهی مجازی بهبودیافتهٔ MIPS (EVA).
.IP \fB\-mvirt\fR 4
.IX Item "-mvirt"
.PD 0
.IP \fB\-mno\-virt\fR 4
.IX Item "-mno-virt"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های مجازی‌سازی (VZ) MIPS.
.IP \fB\-mxpa\fR 4
.IX Item "-mxpa"
.PD 0
.IP \fB\-mno\-xpa\fR 4
.IX Item "-mno-xpa"
.PD
استفاده کردن (یا نکردن) از دستورالعمل‌های آدرس فیزیکی گسترش‌یافتهٔ MIPS (XPA).
.IP \fB\-mcrc\fR 4
.IX Item "-mcrc"
.PD 0.IP \fB\-mno\-crc\fR 4
.IX Item "-mno-crc"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های وارسی افزونگی چرخشی (CRC) در MIPS.
.IP \fB\-mginv\fR 4
.IX Item "-mginv"
.PD 0
.IP \fB\-mno\-ginv\fR 4
.IX Item "-mno-ginv"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های باطل‌سازی سراسری (GINV) در MIPS.
.IP \fB\-mmsa\fR 4
.IX Item "-mmsa"
.PD 0
.IP \fB\-mno\-msa\fR 4
.IX Item "-mno-msa"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های افزونهٔ MIPS MSA.
.IP \fB\-mloongson\-mmi\fR 4
.IX Item "-mloongson-mmi"
.PD 0
.IP \fB\-mno\-loongson\-mmi\fR 4
.IX Item "-mno-loongson-mmi"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های افزونه‌های چندرسانه‌ای MIPS Loongson (MMI).
.IP \fB\-mloongson\-ext\fR 4
.IX Item "-mloongson-ext"
.PD 0
.IP \fB\-mno\-loongson\-ext\fR 4
.IX Item "-mno-loongson-ext"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های افزونه‌های MIPS Loongson (EXT).
.IP \fB\-mloongson\-ext2\fR 4
.IX Item "-mloongson-ext2"
.PD 0
.IP \fB\-mno\-loongson\-ext2\fR 4
.IX Item "-mno-loongson-ext2"
.PD
استفاده (عدم استفاده) از دستورالعمل‌های افزونه‌های نگارش ۲ MIPS Loongson (EXT2).
.IP \fB\-mlong64\fR 4
.IX Item "-mlong64"
اجبار نوع‌های \f(CW\*(C`long\*(C'\fR به داشتن پهنای ۶۴ بیتی. برای توضیحات در مورد حالت پیش‌فرض و چگونگی تعیین اندازهٔ اشاره‌گر (pointer)، \fB\-mlong32\fR را ببینید.
.IP \fB\-mlong32\fR 4
.IX Item "-mlong32"
اجبار نوع‌های \f(CW\*(C`long\*(C'\fR، \f(CW\*(C`int\*(C'\fR و اشاره‌گر به داشتن پهنای ۳۲ بیتی.
.Sp
اندازهٔ پیش‌فرض \f(CW\*(C`int\*(C'\fRها، \f(CW\*(C`long\*(C'\fRها و اشاره‌گرها به ABI بستگی دارد. تمام ABIهای پشتیبانی‌شده از \f(CW\*(C`int\*(C'\fRهای ۳۲ بیتی استفاده می‌کنند. ABI نوع n64 و همچنین EABI ۶۴ بیتی از \f(CW\*(C`long\*(C'\fRهای ۶۴ بیتی استفاده می‌کنند؛ سایر موارد از \f(CW\*(C`long\*(C'\fRهای ۳۲ بیتی استفاده می‌کنند. اندازهٔ اشاره‌گرها برابر با اندازهٔ \f(CW\*(C`long\*(C'\fRها یا هم‌اندازه با ثبات‌های اعداد صحیح (هرکدام که کوچک‌تر باشد) است.
.IP \fB\-msym32\fR 4
.IX Item "-msym32"
.PD 0
.IP \fB\-mno\-sym32\fR 4
.IX Item "-mno-sym32"
.PD
فرض کردن (فرض نکردن) اینکه تمام نمادها بدون توجه به ABI انتخاب‌شده مقادیر ۳۲ بیتی دارند. این گزینه در ترکیب با \&\fB\-mabi=64\fR و \fB\-mno\-abicalls\fR مفید است؛ زیرا به GCC اجازه می‌دهد ارجاعات کوتاه‌تر و سریع‌تری به آدرس‌های نمادین ایجاد کند.
.IP "\fB\-G\fR \fInum\fR" 4
.IX Item "-G num"
قرار دادن تعاریف داده‌های با دید خارجی (externally-visible) در یک بخش دادهٔ کوچک (small data section) در صورتی که اندازهٔ آن داده بزرگ‌تر از \fInum\fR بایت نباشد. در این صورت GCC می‌تواند دسترسی‌های کارآمدتری به داده‌ها تولید کند؛ برای جزئیات \fB\-mgpopt\fR را ببینید.
.Sp
مقدار پیش‌فرض گزینهٔ \fB\-G\fR به پیکربندی بستگی دارد.
.IP \fB\-mlocal\-sdata\fR 4
.IX Item "-mlocal-sdata"
.PD 0
.IP \fB\-mno\-local\-sdata\fR 4
.IX Item "-mno-local-sdata"
.PD
تعمیم دادن (تعمیم ندادن) رفتار \fB\-G\fR به داده‌های محلی نیز، مانند متغیرهای static در زبان C. گزینهٔ \fB\-mlocal\-sdata\fR در تمام پیکربندی‌ها حالت پیش‌فرض است.
.Sp
اگر پیونددهنده (linker) هشدار دهد که برنامه بیش از حد از داده‌های کوچک استفاده می‌کند، می‌توانید بازسازی بخش‌هایی از برنامه را که از نظر کارایی حساسیت کمتری دارند با \&\fB\-mno\-local\-sdata\fR امتحان کنید. همچنین ممکن است بخواهید کتابخانه‌های بزرگ را با \fB\-mno\-local\-sdata\fR بسازید تا کتابخانه‌ها فضای بیشتری برای برنامهٔ اصلی باقی بگذارند.
.IP \fB\-mextern\-sdata\fR 4
.IX Item "-mextern-sdata"
.PD 0
.IP \fB\-mno\-extern\-sdata\fR 4
.IX Item "-mno-extern-sdata"
.PD
فرض کردن (فرض نکردن) اینکه داده‌های تعریف‌شده در خارج، در صورتی که اندازهٔ آن‌ها در محدودهٔ \fB\-G\fR باشد، در یک بخش دادهٔ کوچک قرار دارند. گزینهٔ \&\fB\-mextern\-sdata\fR در تمام پیکربندی‌ها حالت پیش‌فرض است.
.Sp
اگر پودمانی مانند \fIMod\fR را با گزینه‌های \fB\-mextern\-sdata\fR \fB\-G\fR \&\fInum\fR \fB\-mgpopt\fR کامپایل کنید، و \fIMod\fR به متغیری به نام \fIVar\fR ارجاع دهد که بزرگ‌تر از \fInum\fR بایت نباشد، باید مطمئن شوید که \fIVar\fR در یک بخش دادهٔ کوچک قرار گرفته است. اگر \fIVar\fR توسط پودمان دیگری تعریف شده است، باید یا آن پودمان را با مقدار \fB\-G\fR به‌اندازهٔ کافی بزرگ کامپایل کنید یا صفت \f(CW\*(C`section\*(C'\fR را به تعریف \fIVar\fR پیوست کنید. اگر \fIVar\fR اشتراکی (common) باشد، باید برنامه را با تنظیم \fB\-G\fR به‌اندازهٔ کافی بزرگ پیوند دهید.
.Sp
ساده‌ترین راه برای برآورده کردن این محدودیت‌ها، کامپایل و پیوند دادن تمام پودمان‌ها با یک گزینهٔ \fB\-G\fR یکسان است. با این حال، ممکن است بخواهید کتابخانه‌ای بسازید که از چندین حد مختلف برای داده‌های کوچک پشتیبانی کند. می‌توانید این کار را با کامپایل کتابخانه با بالاترین مقدار پشتیبانی‌شدهٔ \fB\-G\fR و علاوه‌بر‌آن، استفاده از \&\fB\-mno\-extern\-sdata\fR برای جلوگیری از ایجاد فرضیات در کتابخانه دربارهٔ داده‌های تعریف‌شده در خارج، انجام دهید.
.IP \fB\-mgpopt\fR 4
.IX Item "-mgpopt"
.PD 0
.IP \fB\-mno\-gpopt\fR 4
.IX Item "-mno-gpopt"
.PD
استفاده (عدم استفاده) از دسترسی‌های نسبی به GP برای نمادهایی که مشخص است در بخش دادهٔ کوچک قرار دارند؛ گزینه‌های \fB\-G\fR، \fB\-mlocal\-sdata\fR و \&\fB\-mextern\-sdata\fR را ببینید. گزینهٔ \fB\-mgpopt\fR در تمام پیکربندی‌ها حالت پیش‌فرض است.
.Sp
گزینهٔ \&\fB\-mno\-gpopt\fR برای مواردی مفید است که ثبات \f(CW$gp\fR ممکن است مقدار \f(CW\*(C`_gp\*(C'\fR را در خود نگه ندارد. به‌عنوان مثال، اگر کد بخشی از یک کتابخانه باشد که ممکن است در یک ناظر راه‌اندازی (boot monitor) استفاده شود، برنامه‌هایی که روال‌های boot monitor را فراخوانی می‌کنند مقدار نامشخصی را در \f(CW$gp\fR عبور می‌دهند. (در چنین شرایطی، خود boot monitor معمولاً با \fB\-G0\fR کامپایل می‌شود.)
.Sp
گزینهٔ \&\fB\-mno\-gpopt\fR مستلزم \&\fB\-mno\-local\-sdata\fR و \&\fB\-mno\-extern\-sdata\fR است.
.IP \fB\-membedded\-data\fR 4
.IX Item "-membedded-data"
.PD 0
.IP \fB\-mno\-embedded\-data\fR 4
.IX Item "-mno-embedded-data"
.PD
تخصیص متغیرها در وهلهٔ اول به بخش داده‌های فقط‌خواندنی در صورت امکان، سپس در بخش داده‌های کوچک در صورت امکان، و در غیر این صورت در بخش داده (data). این کار کدی کمی کُندتر از حالت پیش‌فرض ایجاد می‌کند، اما مقدار RAM مورد نیاز در هنگام اجرا را کاهش می‌دهد و بنابراین ممکن است برای برخی سیستم‌های توکار (embedded) ارجح باشد.
.IP \fB\-muninit\-const\-in\-rodata\fR 4
.IX Item "-muninit-const-in-rodata"
.PD 0
.IP \fB\-mno\-uninit\-const\-in\-rodata\fR 4
.IX Item "-mno-uninit-const-in-rodata"
.PD
قرار دادن متغیرهای \f(CW\*(C`const\*(C'\fR مقداردهی‌نشده در بخش داده‌های فقط‌خواندنی. این گزینه تنها در ترکیب با \fB\-membedded\-data\fR معنادار است.
.IP \fB\-mcode\-readable=\fR\fIsetting\fR 4
.IX Item "-mcode-readable=setting"
مشخص می‌کند که آیا GCC مجاز است کدی تولید کند که از بخش‌های قابل اجرا (executable sections) بخواند یا خیر. سه مقدار ممکن وجود دارد:
.RS 4
.IP \fB\-mcode\-readable=yes\fR 4
.IX Item "-mcode-readable=yes"
دستورالعمل‌ها آزادانه می‌توانند به بخش‌های قابل اجرا دسترسی داشته باشند. این مقدار پیش‌فرض است.
.IP \fB\-mcode\-readable=pcrel\fR 4
.IX Item "-mcode-readable=pcrel"
دستورالعمل‌های بارگذاری نسبی به PC در MIPS16 می‌توانند به بخش‌های قابل اجرا دسترسی داشته باشند، اما سایر دستورالعمل‌ها نباید این کار را انجام دهند. این گزینه در پردازنده‌های 4KSc و 4KSd هنگامی که بیت Read Inhibit در TLBهای کد تنظیم شده است مفید است. همچنین در پردازنده‌هایی که می‌توان آن‌ها را با رابط دوگانهٔ SRAM دستورالعمل/داده پیکربندی کرد و مانند M4K بارگذاری‌های نسبی به PC را به‌طور خودکار به RAM دستورالعمل تغییر مسیر می‌دهند، مفید واقع می‌شود.
.IP \fB\-mcode\-readable=no\fR 4
.IX Item "-mcode-readable=no"
دستورالعمل‌ها نباید به بخش‌های قابل اجرا دسترسی داشته باشند. این گزینه می‌تواند روی مقصدهایی مفید باشد که برای داشتن رابط دوگانهٔ SRAM دستورالعمل/داده پیکربندی شده‌اند اما (برخلاف M4K) بارگذاری‌های نسبی به PC را به‌طور خودکار به RAM دستورالعمل هدایت نمی‌کنند.
.RE
.RS 4
.Sp
در مقصدهای SDE، گزینهٔ \fB\-mcode\-data\-in\-code\fR به‌عنوان نام مستعار سنتی برای \fB\-mcode\-readable=no\fR، و گزینهٔ \fB\-mcode\-xonly\fR برای \fB\-mcode\-readable=pcrel\fR در دسترس است.
.RE
.IP \fB\-msplit\-addresses\fR 4
.IX Item "-msplit-addresses".PD 0
.IP \fB\-mno\-split\-addresses\fR 4
.IX Item "-mno-split-addresses"
.PD
فعال‌سازی (غیرفعال‌سازی) استفاده از عملگرهای بازآرایی (relocation) اسمبلر \f(CW%hi()\fR و \f(CW%lo()\fR. این گزینه با \&\fB\-mexplicit\-relocs\fR جایگزین شده است، اما برای سازگاری با نسخه‌های پیشین حفظ می‌شود.
.IP \fB\-mexplicit\-relocs=none\fR 4
.IX Item "-mexplicit-relocs=none"
.PD 0
.IP \fB\-mexplicit\-relocs=base\fR 4
.IX Item "-mexplicit-relocs=base"
.IP \fB\-mexplicit\-relocs=pcrel\fR 4
.IX Item "-mexplicit-relocs=pcrel"
.IP \fB\-mexplicit\-relocs\fR 4
.IX Item "-mexplicit-relocs"
.IP \fB\-mno\-explicit\-relocs\fR 4
.IX Item "-mno-explicit-relocs"
.PD
این گزینه‌ها استفاده از بازآرایی‌های صریح (مانند \f(CW%gp_rel\fR) را کنترل می‌کنند.
مقدار پیش‌فرض به نسخهٔ GAS در زمان ساخت خود GCC بستگی دارد.
.Sp
پشتیبانی از بازآرایی‌های صریح \f(CW\*(C`base\*(C'\fR در سال ۲۰۰۱ به GAS اضافه شد.
پشتیبانی از بازآرایی‌های صریح \f(CW\*(C`pcrel\*(C'\fR در سال ۲۰۱۴ به GAS افزوده شد
که از \f(CW%pcrel_hi\fR و \f(CW%pcrel_lo\fR پشتیبانی می‌کند.
.IP \fB\-mcheck\-zero\-division\fR 4
.IX Item "-mcheck-zero-division"
.PD 0
.IP \fB\-mno\-check\-zero\-division\fR 4
.IX Item "-mno-check-zero-division"
.PD
ایجاد تله (عدم ایجاد تله) هنگام تقسیم عدد صحیح بر صفر.
.Sp
پیش‌فرض \fB\-mcheck\-zero\-division\fR است.
.IP \fB\-mdivide\-traps\fR 4
.IX Item "-mdivide-traps"
.PD 0
.IP \fB\-mdivide\-breaks\fR 4
.IX Item "-mdivide-breaks"
.PD
سیستم‌های MIPS تقسیم بر صفر را با تولید یک تلهٔ شرطی (conditional trap) یا یک دستورالعمل break بررسی می‌کنند. استفاده از تله‌ها منجر به کد کوچک‌تر می‌شود، اما فقط روی MIPS II و نسخه‌های پس از آن پشتیبانی می‌شود. همچنین، برخی از نسخه‌های هستهٔ لینوکس دارای باگی هستند که مانع از تولید سیگنال مناسب (\f(CW\*(C`SIGFPE\*(C'\fR) توسط تله می‌شود. از \fB\-mdivide\-traps\fR برای مجاز ساختن تله‌های شرطی روی معماری‌هایی که از آن‌ها پشتیبانی می‌کنند و از \&\fB\-mdivide\-breaks\fR برای اجبار به استفاده از دستورات break استفاده کنید.
.Sp
پیش‌فرض معمولاً \fB\-mdivide\-traps\fR است، اما این مقدار را می‌توان در زمان پیکربندی (configure time) با استفاده از \fB\-\-with\-divide=breaks\fR لغو کرد.
بررسی‌های تقسیم بر صفر را می‌توان با استفاده از \&\fB\-mno\-check\-zero\-division\fR به‌طور کامل غیرفعال کرد.
.IP \fB\-mload\-store\-pairs\fR 4
.IX Item "-mload-store-pairs"
.PD 0
.IP \fB\-mno\-load\-store\-pairs\fR 4
.IX Item "-mno-load-store-pairs"
.PD
فعال‌سازی (غیرفعال‌سازی) بهینه‌سازی جفت‌کردن دستورالعمل‌های بارگذاری (load) یا ذخیره‌سازی (store) متوالی برای فعال کردن پیوند بارگذاری/ذخیره (load/store bonding). این گزینه به‌طور پیش‌فرض فعال است، اما تنها زمانی اعمال می‌شود که معماری انتخاب‌شده از پیونددهی پشتیبانی کند.
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD 0
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.IP \fB\-munaligned\-access\fR 4
.IX Item "-munaligned-access"
.IP \fB\-mno\-unaligned\-access\fR 4
.IX Item "-mno-unaligned-access"
.PD
غیرفعال‌سازی (فعال‌سازی) دسترسی مستقیم غیرهم‌تراز برای MIPS Release 6.
معماری MIPSr6 نیازمند پشتیبانی از دسترسی غیرهم‌تراز در دستورات load/store است، چه از طریق سخت‌افزار و چه از طریق تله‌گذاری و شبیه‌سازی (trapping and emulation). در حالت دوم، ممکن است هستهٔ سیستم‌عامل به \fB\-mstrict\-align\fR نیاز داشته باشد. گزینه‌های \fB\-munaligned\-access\fR و \fB\-mno\-unaligned\-access\fR منسوخ شده‌اند و تنها برای سازگاری با نسخه‌های پیشین ارائه می‌شوند.
.IP \fB\-mmemcpy\fR 4
.IX Item "-mmemcpy"
.PD 0
.IP \fB\-mno\-memcpy\fR 4
.IX Item "-mno-memcpy"
.PD
اجبار (عدم اجبار) به استفاده از \f(CW\*(C`memcpy\*(C'\fR برای انتقال‌های بلوکی غیربدیهی (non-trivial). پیش‌فرض \fB\-mno\-memcpy\fR است که به GCC اجازه می‌دهد بیشتر رونوشت‌های با اندازهٔ ثابت را به‌صورت درون‌خطی (inline) درآورد.
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
.PD 0
.IP \fB\-mno\-long\-calls\fR 4
.IX Item "-mno-long-calls"
.PD
غیرفعال‌سازی (عدم غیرفعال‌سازی) استفاده از دستورالعمل \f(CW\*(C`jal\*(C'\fR. فراخوانی توابع با استفاده از \f(CW\*(C`jal\*(C'\fR کارآمدتر است، اما مستلزم آن است که فراخواننده (caller) و فراخوانده‌شده (callee) در یک قطعهٔ (segment) ۲۵۶ مگابایتی یکسان قرار داشته باشند.
.Sp
این گزینه هیچ تأثیری بر کدهای abicalls ندارد. پیش‌فرض \&\fB\-mno\-long\-calls\fR است.
.IP \fB\-mmad\fR 4
.IX Item "-mmad"
.PD 0
.IP \fB\-mno\-mad\fR 4
.IX Item "-mno-mad"
.PD
فعال‌سازی (غیرفعال‌سازی) استفاده از دستورالعمل‌های \f(CW\*(C`mad\*(C'\fR، \f(CW\*(C`madu\*(C'\fR و \f(CW\*(C`mul\*(C'\fR، طبق آن‌چه که توسط ISA پردازندهٔ R4650 ارائه شده است.
.IP \fB\-mimadd\fR 4
.IX Item "-mimadd"
.PD 0
.IP \fB\-mno\-imadd\fR 4
.IX Item "-mno-imadd"
.PD
فعال‌سازی (غیرفعال‌سازی) استفاده از دستورالعمل‌های عدد صحیح \f(CW\*(C`madd\*(C'\fR و \f(CW\*(C`msub\*(C'\fR. پیش‌فرض در معماری‌هایی که از \f(CW\*(C`madd\*(C'\fR و \f(CW\*(C`msub\*(C'\fR پشتیبانی می‌کنند \fB\-mimadd\fR است، به‌جز در معماری 74k که مشخص شده است کد کندتری تولید می‌کند.
.IP \fB\-mfused\-madd\fR 4
.IX Item "-mfused-madd"
.PD 0
.IP \fB\-mno\-fused\-madd\fR 4
.IX Item "-mno-fused-madd"
.PD
فعال‌سازی (غیرفعال‌سازی) استفاده از دستورالعمل‌های ضرب\-انباشت (multiply\-accumulate) ممیز شناور در صورت در دسترس بودن آن‌ها. پیش‌فرض \&\fB\-mfused\-madd\fR است.
.Sp
در پردازندهٔ R8000 هنگام استفاده از دستورالعمل‌های ضرب\-انباشت، حاصل‌ضرب میانی با دقت بی‌نهایت محاسبه می‌شود و مشمول بیت FCSR Flush to Zero نمی‌گردد. این مسئله ممکن است در برخی شرایط نامطلوب باشد. در سایر پردازنده‌ها، نتیجه از نظر عددی با محاسبهٔ معادل با استفاده از دستورالعمل‌های جداگانهٔ ضرب، جمع، تفریق و منفی‌سازی یکسان است.
.IP \fB\-nocpp\fR 4
.IX Item "-nocpp"
به اسمبلر MIPS اعلام می‌کند که هنگام اسمبل کردن فایل‌های اسمبلر کاربر (با پسوند \fB.s\fR)، پیش‌پردازندهٔ خود را بر روی آن‌ها اجرا نکند.
.IP \fB\-mfix\-24k\fR 4
.IX Item "-mfix-24k"
.PD 0
.IP \fB\-mno\-fix\-24k\fR 4
.IX Item "-mno-fix-24k"
.PD
دور زدن نقص فنی (errata) پردازندهٔ 24K E48 (از دست رفتن داده‌ها در ذخیره‌سازی‌ها حین بازپرکنی/refill). این راه‌حل‌ها به جای GCC توسط اسمبلر پیاده‌سازی می‌شوند.
.IP \fB\-mfix\-r4000\fR 4
.IX Item "-mfix-r4000"
.PD 0
.IP \fB\-mno\-fix\-r4000\fR 4
.IX Item "-mno-fix-r4000"
.PD
دور زدن برخی از نقص‌های فنی (errata) پردازندهٔ R4000:
.RS 4
.IP \- 4
یک شیفت دوکلمه‌ای (double-word) یا متغیر ممکن است در صورت اجرا بلافاصله پس از آغاز یک تقسیم عدد صحیح، نتیجهٔ نادرستی تولید کند.
.IP \- 4
یک شیفت دوکلمه‌ای یا متغیر ممکن است در صورت اجرا هنگام در جریان بودن یک ضرب عدد صحیح، نتیجهٔ نادرستی تولید کند.
.IP \- 4
یک تقسیم عدد صحیح ممکن است در صورت آغاز در شکاف تأخیر (delay slot) یک انشعاب انجام‌شده (taken branch) یا یک پرش، نتیجهٔ نادرستی بدهد.
.RE
.RS 4
.RE
.IP \fB\-mfix\-r4400\fR 4
.IX Item "-mfix-r4400"
.PD 0
.IP \fB\-mno\-fix\-r4400\fR 4
.IX Item "-mno-fix-r4400"
.PD
دور زدن برخی از نقص‌های فنی (errata) پردازندهٔ R4400:
.RS 4
.IP \- 4
یک شیفت دوکلمه‌ای یا متغیر ممکن است در صورت اجرا بلافاصله پس از آغاز یک تقسیم عدد صحیح، نتیجهٔ نادرستی تولید کند.
.RE
.RS 4
.RE
.IP \fB\-mfix\-r10000\fR 4
.IX Item "-mfix-r10000".PD 0
.IP \fB\-mno\-fix\-r10000\fR 4
.IX Item "-mno-fix-r10000"
.PD
برطرف کردن برخی اشکالات سخت‌افزاری (errata) در R10000:
.RS 4
.IP \- 4
دنباله‌های \&\f(CW\*(C`ll\*(C'\fR/\f(CW\*(C`sc\*(C'\fR ممکن است در نسخه‌های پیش از 3.0 رفتار اتمیک (atomic) نداشته باشند. آن‌ها ممکن است در نسخه 2.6 و قدیمی‌تر دچار بن‌بست (deadlock) شوند.
.RE
.RS 4
.Sp
این گزینه تنها در صورتی قابل استفاده است که معماری مقصد از دستورالعمل‌های branch\-likely پشتیبانی کند. در صورت استفاده از \&\fB\-march=r10000\fR، گزینه \fB\-mfix\-r10000\fR پیش‌فرض است؛ در غیر این صورت \fB\-mno\-fix\-r10000\fR پیش‌فرض خواهد بود.
.RE
.IP \fB\-mfix\-r5900\fR 4
.IX Item "-mfix-r5900"
.PD 0
.IP \fB\-mno\-fix\-r5900\fR 4
.IX Item "-mno-fix-r5900"
.PD
از تلاش برای زمان‌بندی دستور قبلی در شکاف تأخیر (delay slot) دستور پرشی که در انتهای یک حلقه کوتاه شامل شش دستور یا کمتر قرار دارد خودداری کرده و به‌جای آن همیشه یک دستور \f(CW\*(C`nop\*(C'\fR را در آنجا قرار می‌دهد. اشکال حلقه کوتاه تحت شرایط خاصی به‌دلیل یک باگ سخت‌افزاری در تراشه R5900 باعث می‌شود حلقه‌ها تنها یک یا دو بار اجرا شوند. این راهکار ترمیمی به‌جای GCC توسط اسِمبلر پیاده‌سازی شده است.
.IP \fB\-mfix\-rm7000\fR 4
.IX Item "-mfix-rm7000"
.PD 0
.IP \fB\-mno\-fix\-rm7000\fR 4
.IX Item "-mno-fix-rm7000"
.PD
اشکالات سخت‌افزاری \f(CW\*(C`dmult\*(C'\fR/\f(CW\*(C`dmultu\*(C'\fR در RM7000 را برطرف می‌کند. این راهکارهای ترمیمی به‌جای GCC توسط اسِمبلر پیاده‌سازی شده‌اند.
.IP \fB\-mfix\-vr4120\fR 4
.IX Item "-mfix-vr4120"
.PD 0
.IP \fB\-mno\-fix\-vr4120\fR 4
.IX Item "-mno-fix-vr4120"
.PD
برطرف کردن برخی اشکالات سخت‌افزاری خاص در VR4120:
.RS 4
.IP \- 4
دستور \&\f(CW\*(C`dmultu\*(C'\fR همیشه نتیجه درستی تولید نمی‌کند.
.IP \- 4
دستورهای \&\f(CW\*(C`div\*(C'\fR و \f(CW\*(C`ddiv\*(C'\fR در صورتی که یکی از عملوندها منفی باشد همیشه نتیجه درستی تولید نمی‌کنند.
.RE
.RS 4
.Sp
راهکارهای ترمیمی برای اشکالات تقسیم به توابع ویژه‌ای در \&\fIlibgcc.a\fR وابسته هستند. در حال حاضر، این توابع فقط توسط پیکربندی‌های \f(CW\*(C`mips64vr*\-elf\*(C'\fR ارائه می‌شوند.
.Sp
سایر اشکالات VR4120 نیازمند درج یک NOP بین جفت‌دستورالعمل‌های خاصی هستند. این اشکالات توسط اسِمبلر مدیریت می‌شوند، نه توسط خود GCC.
.RE
.IP \fB\-mfix\-vr4130\fR 4
.IX Item "-mfix-vr4130"
.PD 0
.IP \fB\-mno\-fix\-vr4130\fR 4
.IX Item "-mno-fix-vr4130"
.PD
اشکالات سخت‌افزاری دستورهای \f(CW\*(C`mflo\*(C'\fR/\f(CW\*(C`mfhi\*(C'\fR در VR4130 را برطرف می‌کند. این راهکارها به‌جای GCC توسط اسِمبلر پیاده‌سازی شده‌اند، اگرچه GCC در صورتی که دستورالعمل‌های \f(CW\*(C`macc\*(C'\fR، \f(CW\*(C`macchi\*(C'\fR، \f(CW\*(C`dmacc\*(C'\fR و \f(CW\*(C`dmacchi\*(C'\fR در VR4130 در دسترس باشند، از استفاده از \f(CW\*(C`mflo\*(C'\fR و \f(CW\*(C`mfhi\*(C'\fR خودداری می‌کند.
.IP \fB\-mfix\-sb1\fR 4
.IX Item "-mfix-sb1"
.PD 0
.IP \fB\-mno\-fix\-sb1\fR 4
.IX Item "-mno-fix-sb1"
.PD
برطرف کردن برخی اشکالات سخت‌افزاری خاص در هسته پردازنده SB\-1.
(این پرچم در حال حاضر اشکالات ممیز شناور «F1» و «F2» را در ویرایش دوم پردازنده SB\-1 برطرف می‌کند.)
.IP \fB\-mfix4300\fR 4
.IX Item "-mfix4300"
.PD 0
.IP \fB\-mno\-fix4300\fR 4
.IX Item "-mno-fix4300"
.PD
اشکالی را در سیلیکون‌های اولیه VR4300 برطرف می‌کند که باعث می‌شد عملیات ضرب با عملوندهای خاص، ضرب‌های بلافاصله پس از خود را خراب کند.
.IP \fB\-mr10k\-cache\-barrier=\fR\fIsetting\fR 4
.IX Item "-mr10k-cache-barrier=setting"
مشخص می‌کند که آیا GCC باید برای جلوگیری از اثرات جانبی اجرای حدسی (speculation) در پردازنده‌های R10K، مانع‌های کَش (cache barriers) درج کند یا خیر.
.Sp
مشابه بسیاری از پردازنده‌ها، R10K تلاش می‌کند نتیجه یک پرش شرطی را پیش‌بینی کرده و دستورالعمل‌های شاخه «انتخاب‌شده» را به‌طور حدسی اجرا کند. در صورتی که نتیجه پیش‌بینی نادرست باشد، پردازنده بعداً اجرای این دستورالعمل‌ها را لغو می‌کند. با این حال، در R10K حتی دستورالعمل‌های لغو شده نیز می‌توانند اثرات جانبی داشته باشند.
.Sp
این مشکل فقط بر روی ذخیره‌سازی‌های هسته (kernel stores) و بسته به سیستم، بر روی بارگذاری‌های هسته (kernel loads) تأثیر می‌گذارد. به‌عنوان مثال، یک ذخیره‌سازی که به‌صورت حدسی اجرا شده است ممکن است حافظه مقصد را در کَش بارگذاری کرده و خط کَش را به‌عنوان کثیف (dirty) نشانه‌گذاری کند، حتی اگر خود عملیات ذخیره‌سازی بعداً لغو شود. اگر یک عملیات DMA پیش از تخلیه (flush) خط «کثیف» روی همان ناحیه از حافظه بنویسد، داده‌های کَش‌شده روی داده‌های ارائه‌شده توسط DMA بازنویسی می‌شوند. برای توضیحات کامل، از جمله سایر مشکلات احتمالی، به دفترچه راهنمای پردازنده R10K مراجعه کنید.
.Sp
یک راهکار این است که پیش از هر دسترسی به حافظه که ممکن است به‌صورت حدسی اجرا شود و حتی در صورت لغو شدن دارای اثر جانبی باشد، دستورالعمل‌های مانع کَش درج شوند. گزینه \fB\-mr10k\-cache\-barrier=\fR\fIsetting\fR نحوه پیاده‌سازی این راهکار در GCC را کنترل می‌کند. این گزینه فرض می‌کند که دسترسی‌های لغوشده به هر بایتی در نواحی زیر، اثر جانبی نخواهند داشت:
.RS 4
.IP 1. 4
.IX Item "1."
حافظه اشغال‌شده توسط فریم پشته (stack frame) تابع جاری؛
.IP 2. 4
.IX Item "2."
حافظه اشغال‌شده توسط یک آرگومان ورودی پشته؛
.IP 3. 4
.IX Item "3."
حافظه اشغال‌شده توسط شیئی که آدرس آن در زمان پیوند ثابت (link\-time\-constant) است.
.RE
.RS 4
.Sp
اطمینان از امن بودن دسترسی‌های حدسی به این نواحی بر عهده هسته (kernel) است.
.Sp
اگر برنامه ورودی شامل یک اعلان تابع مانند زیر باشد:
.Sp
.Vb 1
\&        void foo (void);
.Ve
.Sp
آن‌گاه پیاده‌سازی \f(CW\*(C`foo\*(C'\fR باید اجازه دهد که \f(CW\*(C`j foo\*(C'\fR و \&\f(CW\*(C`jal foo\*(C'\fR به‌صورت حدسی اجرا شوند. GCC این محدودیت را برای توابعی که خود کامپایل می‌کند رعایت می‌نماید. انتظار می‌رود توابع غیر GCC (مانند کدهای اسمبلی دست‌نویس) نیز همین رویه را دنبال کنند.
.Sp
این گزینه دارای سه حالت است:
.IP \fB\-mr10k\-cache\-barrier=load\-store\fR 4
.IX Item "-mr10k-cache-barrier=load-store"
یک مانع کَش پیش از هر بارگذاری یا ذخیره‌سازی که ممکن است به‌صورت حدسی اجرا شده و حتی در صورت لغو شدن اثر جانبی داشته باشد، درج می‌کند.
.IP \fB\-mr10k\-cache\-barrier=store\fR 4
.IX Item "-mr10k-cache-barrier=store"
یک مانع کَش پیش از هر ذخیره‌سازی که ممکن است به‌صورت حدسی اجرا شده و حتی در صورت لغو شدن اثر جانبی داشته باشد، درج می‌کند.
.IP \fB\-mr10k\-cache\-barrier=none\fR 4
.IX Item "-mr10k-cache-barrier=none"
درج مانع‌های کَش را غیرفعال می‌کند. این حالت پیش‌فرض است.
.RE
.RS 4
.RE
.IP \fB\-mflush\-func=\fR\fIfunc\fR 4
.IX Item "-mflush-func=func"
.PD 0
.IP \fB\-mno\-flush\-func\fR 4
.IX Item "-mno-flush-func"
.PD
تابعی را برای فراخوانی جهت تخلیه کَش‌های I و D تعیین می‌کند، یا مشخص می‌کند هیچ تابعی فراخوانی نشود. در صورت فراخوانی، تابع باید همان آرگومان‌های تابع متداول \f(CW\*(C`_flush_func\*(C'\fR را بپذیرد، یعنی آدرس محدوده حافظه‌ای که کَش آن تخلیه می‌شود، اندازه محدوده حافظه و عدد 3 (برای تخلیه هر دو کَش). مقدار پیش‌فرض به مقصدی که GCC برای آن پیکربندی شده است بستگی دارد، اما معمولاً \&\f(CW\*(C`_flush_func\*(C'\fR یا \f(CW\*(C`_\|_cpu_flush\*(C'\fR است.
.IP \fB\-mbranch\-cost=\fR\fInum\fR 4
.IX Item "-mbranch-cost=num"
هزینه پرش‌ها (branches) را تقریباً برابر با \fInum\fR دستورالعمل «ساده» تنظیم می‌کند. این هزینه صرفاً یک تقریب اکتشافی (heuristic) است و تضمینی نیست که نتایج یکسانی در نگارش‌های مختلف ایجاد کند. مقدار هزینه صفر، مقدار پیش‌فرض را انتخاب می‌کند که بر اساس تنظیمات \fB\-mtune\fR تعیین می‌شود.
.IP \fB\-mbranch\-likely\fR 4
.IX Item "-mbranch-likely"
.PD 0
.IP \fB\-mno\-branch\-likely\fR 4
.IX Item "-mno-branch-likely".PD
فعال یا غیرفعال کردن استفاده از دستورالعمل‌های Branch Likely، صرف‌نظر از
پیش‌فرض معماری انتخاب‌شده. به‌طور پیش‌فرض، در صورتی که توسط معماری انتخاب‌شده
پشتیبانی شوند، ممکن است دستورالعمل‌های Branch Likely تولید شوند. یک استثنا
برای معماری‌های MIPS32 و MIPS64 و پردازنده‌هایی است که این معماری‌ها را
پیاده‌سازی می‌کنند؛ برای آن‌ها، دستورالعمل‌های Branch Likely به‌طور پیش‌فرض
تولید نمی‌شوند زیرا معماری‌های MIPS32 و MIPS64 صراحتاً استفاده از آن‌ها را
منسوخ کرده‌اند.
.IP \fB\-mcompact\-branches=never\fR 4
.IX Item "-mcompact-branches=never"
.PD 0
.IP \fB\-mcompact\-branches=optimal\fR 4
.IX Item "-mcompact-branches=optimal"
.IP \fB\-mcompact\-branches=always\fR 4
.IX Item "-mcompact-branches=always"
.PD
این گزینه‌ها شکل پرش‌های تولید‌شده را کنترل می‌کنند. پیش‌فرض
\fB\-mcompact\-branches=optimal\fR است.
.Sp
گزینهٔ \fB\-mcompact\-branches=never\fR تضمین می‌کند که دستورالعمل‌های
پرش فشرده (compact branch) هرگز تولید نشوند.
.Sp
گزینهٔ \fB\-mcompact\-branches=always\fR تضمین می‌کند که در صورت وجود، برای
MIPS Release 6 به بعد یک دستورالعمل پرش فشرده تولید شود.
اگر دستور پرش فشرده در دسترس نباشد (یا پیش از R6 باشد)،
به‌جای آن از نوع delay slot پرش استفاده می‌شود.
.Sp
اگر برای اهداف MIPS16/microMIPS استفاده شود، در حال حاضر نادیده گرفته می‌شود.
رفتار برای MIPS16/microMIPS ممکن است در آینده تغییر کند،
چرا که آن‌ها دارای برخی دستورالعمل‌های پرش فشرده هستند.
.Sp
گزینهٔ \fB\-mcompact\-branches=optimal\fR باعث می‌شود در صورتی که پرش با
delay slot در ISA فعلی در دسترس باشد و شکاف تاخیر با موفقیت پر شود، از آن
استفاده گردد. اگر شکاف تاخیر پر نشود، در صورت موجود بودن، یک پرش فشرده
انتخاب می‌شود.
.IP \fB\-mfp\-exceptions\fR 4
.IX Item "-mfp-exceptions"
.PD 0
.IP \fB\-mno\-fp\-exceptions\fR 4
.IX Item "-mno-fp-exceptions"
.PD
مشخص می‌کند که آیا استثناهای ممیز شناور (FP) فعال باشند یا خیر. این مورد بر
نحوهٔ زمان‌بندی دستورالعمل‌های FP برای برخی پردازنده‌ها تأثیر می‌گذارد.
پیش‌فرض این است که استثناهای FP فعال هستند.
.Sp
برای نمونه، در SB\-1، اگر استثناهای FP غیرفعال باشند و در حال تولید کد ۶۴ بیتی
باشیم، می‌توانیم از هر دو لوله‌خط (pipe) ممیز شناور استفاده کنیم. در غیر این صورت،
تنها می‌توانیم از یک لوله‌خط FP استفاده کنیم.
.IP \fB\-mvr4130\-align\fR 4
.IX Item "-mvr4130-align"
.PD 0
.IP \fB\-mno\-vr4130\-align\fR 4
.IX Item "-mno-vr4130-align"
.PD
لوله‌خط پردازندهٔ VR4130 از نوع سوپراسکالر دوطرفه (two\-way superscalar) است،
اما تنها در صورتی می‌تواند دو دستورالعمل را با هم صادر کند که دستورالعمل نخست
تراز ۸ بایتی داشته باشد. هنگامی که این گزینه فعال است، GCC جفت‌دستورالعمل‌هایی
را که فکر می‌کند باید به‌طور موازی اجرا شوند، تراز می‌کند.
.Sp
این گزینه تنها هنگام بهینه‌سازی برای VR4130 تأثیرگذار است.
معمولاً کد را سریع‌تر می‌کند، اما به بهای بزرگ‌تر شدن اندازهٔ آن تمام می‌شود.
این گزینه به‌طور پیش‌فرض در سطح بهینه‌سازی \fB\-O3\fR فعال است.
.IP \fB\-msynci\fR 4
.IX Item "-msynci"
.PD 0
.IP \fB\-mno\-synci\fR 4
.IX Item "-mno-synci"
.PD
فعال (غیرفعال) کردن تولید دستورالعمل‌های \f(CW\*(C`synci\*(C'\fR در
معماری‌هایی که از آن پشتیبانی می‌کنند. دستورالعمل‌های \f(CW\*(C`synci\*(C'\fR (در صورت
فعال بودن) هنگامی که \f(CW\*(C`_\|_builtin_\|_\|_clear_cache\*(C'\fR کامپایل شود
تولید می‌شوند.
.Sp
این گزینه به‌طور پیش‌فرض روی \fB\-mno\-synci\fR تنظیم شده است، اما می‌توان
با پیکربندی GCC با \fB\-\-with\-synci\fR این مقدار پیش‌فرض را لغو کرد.
.Sp
هنگام کامپایل کد برای سیستم‌های تک‌پردازنده‌ای، استفاده از \f(CW\*(C`synci\*(C'\fR
به‌طور کلی ایمن است. با این حال، در بسیاری از سیستم‌های چند‌هسته‌ای (SMP)،
کَش‌های دستورالعمل را روی تمام هسته‌ها نامعتبر نمی‌سازد و ممکن است منجر به
رفتار تعریف‌نشده شود.
.IP \fB\-mrelax\-pic\-calls\fR 4
.IX Item "-mrelax-pic-calls"
.PD 0
.IP \fB\-mno\-relax\-pic\-calls\fR 4
.IX Item "-mno-relax-pic-calls"
.PD
تلاش برای تبدیل فراخوانی‌های PIC که معمولاً از طریق ثبات
\&\f(CW$25\fR ارسال می‌شوند به فراخوانی‌های مستقیم. این مورد تنها در صورتی ممکن است
که پیونددهنده بتواند مقصد را در زمان پیوند حل کند و مقصد در محدودهٔ یک
فراخوانی مستقیم باشد.
.Sp
در صورتی که GCC برای استفاده از یک اسمبلر و یک پیونددهنده پیکربندی شده باشد که از
دستورالعمل اسمبلی \f(CW\*(C`.reloc\*(C'\fR پشتیبانی کنند و \fB\-mexplicit\-relocs\fR
برقرار باشد، \&\fB\-mrelax\-pic\-calls\fR حالت پیش‌فرض است. با
\&\fB\-mno\-explicit\-relocs\fR، این بهینه‌سازی می‌تواند به‌تنهایی توسط اسمبلر
و پیونددهنده بدون کمک کامپایلر انجام شود.
.IP \fB\-mmcount\-ra\-address\fR 4
.IX Item "-mmcount-ra-address"
.PD 0
.IP \fB\-mno\-mcount\-ra\-address\fR 4
.IX Item "-mno-mcount-ra-address"
.PD
تولید (یا عدم تولید) کدی که به \f(CW\*(C`_mcount\*(C'\fR اجازه می‌دهد آدرس بازگشت
تابع فراخواننده را تغییر دهد. در صورت فعال بودن، این گزینه رابط معمول
\f(CW\*(C`_mcount\*(C'\fR را با یک پارامتر جدید \fIra\-address\fR گسترش می‌دهد که نوع
\f(CW\*(C`intptr_t *\*(C'\fR دارد و در ثبات \&\f(CW$12\fR فرستاده می‌شود. سپس
\f(CW\*(C`_mcount\*(C'\fR می‌تواند با انجام هر دوی موارد زیر، آدرس بازگشت را ویرایش کند:
.RS 4
.IP * 4
بازگرداندن آدرس جدید در ثبات \f(CW$31\fR.
.IP * 4
ذخیرهٔ آدرس جدید در \f(CW\*(C`*\fR\f(CIra\-address\fR\f(CW\*(C'\fR،
اگر \fIra\-address\fR تهی نباشد.
.RE
.RS 4
.Sp
پیش‌فرض \fB\-mno\-mcount\-ra\-address\fR است.
.RE
.IP \fB\-mframe\-header\-opt\fR 4
.IX Item "-mframe-header-opt"
.PD 0
.IP \fB\-mno\-frame\-header\-opt\fR 4
.IX Item "-mno-frame-header-opt"
.PD
فعال (غیرفعال) کردن بهینه‌سازی سرآیند فریم در o32 ABI. هنگام استفاده از
o32 ABI، فراخوانی توابع ۱۶ بایت را روی پشته تخصیص می‌دهد تا تابع فراخوانده‌شده
آرگومان‌های ثبات را روی آن بنویسد. در صورت فعال بودن، این بهینه‌سازی اگر تشخیص
دهد که سرآیند فریم بدون استفاده است، از تخصیص آن صرف‌نظر می‌کند.
.Sp
این بهینه‌سازی به‌طور پیش‌فرض در تمام سطوح بهینه‌سازی خاموش است.
.IP \fB\-mlxc1\-sxc1\fR 4
.IX Item "-mlxc1-sxc1"
.PD 0
.IP \fB\-mno\-lxc1\-sxc1\fR 4
.IX Item "-mno-lxc1-sxc1"
.PD
در صورت امکان، فعال (غیرفعال) کردن تولید دستورالعمل‌های \f(CW\*(C`lwxc1\*(C'\fR،
\&\f(CW\*(C`swxc1\*(C'\fR، \f(CW\*(C`ldxc1\*(C'\fR و \f(CW\*(C`sdxc1\*(C'\fR. به‌طور پیش‌فرض فعال است.
.IP \fB\-mmadd4\fR 4
.IX Item "-mmadd4"
.PD 0
.IP \fB\-mno\-madd4\fR 4
.IX Item "-mno-madd4"
.PD
در صورت امکان، فعال (غیرفعال) کردن تولید دستورالعمل‌های ۴ عملوندی \f(CW\*(C`madd.s\*(C'\fR،
\&\f(CW\*(C`madd.d\*(C'\fR و دستورالعمل‌های مرتبط. به‌طور پیش‌فرض فعال است.
.PP
\fIگزینه‌های MMIX\fR
.IX Subsection "MMIX Options"
.PP
این گزینه‌ها برای MMIX تعریف شده‌اند:
.IP \fB\-mlibfuncs\fR 4
.IX Item "-mlibfuncs"
.PD 0
.IP \fB\-mno\-libfuncs\fR 4
.IX Item "-mno-libfuncs"
.PD
مشخص می‌کند که توابع درونی کتابخانه (intrinsic) کامپایل می‌شوند و بدون توجه به اندازه،
تمام مقادیر را در ثبات‌ها ارسال می‌کنند.
.IP \fB\-mepsilon\fR 4
.IX Item "-mepsilon"
.PD 0
.IP \fB\-mno\-epsilon\fR 4
.IX Item "-mno-epsilon"
.PD
تولید دستورالعمل‌های مقایسهٔ ممیز شناور که با ارجاع به ثبات اپسیلون
\f(CW\*(C`rE\*(C'\fR مقایسه می‌کنند.
.IP \fB\-mabi=mmixware\fR 4
.IX Item "-mabi=mmixware"
.PD 0
.IP \fB\-mabi=gnu\fR 4
.IX Item "-mabi=gnu"
.PD
تولید کدی که پارامترهای تابع و مقادیر بازگشتی را به‌گونه‌ای ارسال می‌کند که (در تابع
فراخوانده‌شده) به‌عنوان ثبات‌های \f(CW$0\fR به بالا دیده شوند، بر خلاف GNU ABI که از
ثبات‌های سراسری \f(CW$231\fR به بالا استفاده می‌کند.
.IP \fB\-mzero\-extend\fR 4
.IX Item "-mzero-extend".PD 0
.IP \fB\-mno\-zero\-extend\fR 4
.IX Item "-mno-zero-extend"
.PD
هنگام خواندن داده‌ها از حافظه در اندازه‌های کوتاه‌تر از ۶۴ بیت، به‌طور پیش‌فرض از دستورالعمل‌های بارگذاری با بسط صفر استفاده می‌کند (استفاده نمی‌کند)، به جای دستورالعمل‌های با بسط علامت.
.IP \fB\-mknuthdiv\fR 4
.IX Item "-mknuthdiv"
.PD 0
.IP \fB\-mno\-knuthdiv\fR 4
.IX Item "-mno-knuthdiv"
.PD
باعث می‌شود که علامت باقیمانده حاصل از تقسیم، هم‌علامت با مقسوم‌علیه باشد. در حالت پیش‌فرض، یعنی \fB\-mno\-knuthdiv\fR، علامت باقیمانده از علامت مقسوم پیروی می‌کند. هر دو روش از نظر محاسباتی معتبر هستند، که روش دوم تقریباً به طور اختصاصی استفاده می‌شود.
.IP \fB\-mtoplevel\-symbols\fR 4
.IX Item "-mtoplevel-symbols"
.PD 0
.IP \fB\-mno\-toplevel\-symbols\fR 4
.IX Item "-mno-toplevel-symbols"
.PD
یک \fB:\fR به ابتدای همه نمادهای سراسری اضافه می‌کند (اضافه نمی‌کند)، تا کد اسمبلی بتواند با دستورالعمل اسمبلی \f(CW\*(C`PREFIX\*(C'\fR استفاده شود.
.IP \fB\-melf\fR 4
.IX Item "-melf"
یک فایل اجرایی در قالب ELF تولید می‌کند، به جای قالب پیش‌فرض \&\fBmmo\fR که توسط شبیه‌ساز \fBmmix\fR استفاده می‌شود.
.IP \fB\-mbranch\-predict\fR 4
.IX Item "-mbranch-predict"
.PD 0
.IP \fB\-mno\-branch\-predict\fR 4
.IX Item "-mno-branch-predict"
.PD
هنگامی که پیش‌بینی ایستان انشعاب یک انشعاب محتمل را نشان می‌دهد، از دستورالعمل‌های انشعاب محتمل استفاده می‌کند (استفاده نمی‌کند).
.IP \fB\-mbase\-addresses\fR 4
.IX Item "-mbase-addresses"
.PD 0
.IP \fB\-mno\-base\-addresses\fR 4
.IX Item "-mno-base-addresses"
.PD
کدی تولید می‌کند (تولید نمی‌کند) که از \fIآدرس‌های پایه\fR استفاده کند. استفاده از یک آدرس پایه به‌طور خودکار درخواستی را (که توسط اسمبلر و پیونددهنده مدیریت می‌شود) برای تنظیم یک مقدار ثابت در یک ثبات سراسری ایجاد می‌کند. این ثبات برای یک یا چند درخواست آدرس پایه در محدوده ۰ تا ۲۵۵ از مقدار نگه‌داری‌شده در ثبات استفاده می‌شود. این امر عموماً به کدی کوتاه و سریع منجر می‌شود، اما تعداد داده‌های متفاوتی که می‌توانند آدرس‌دهی شوند محدود است. این بدان معناست که برنامه‌ای که از داده‌های ایستای زیادی استفاده می‌کند ممکن است به \fB\-mno\-base\-addresses\fR نیاز داشته باشد.
.IP \fB\-msingle\-exit\fR 4
.IX Item "-msingle-exit"
.PD 0
.IP \fB\-mno\-single\-exit\fR 4
.IX Item "-mno-single-exit"
.PD
کد تولیدشده را وادار می‌کند (وادار نمی‌کند) تا در هر تابع تنها یک نقطه خروج داشته باشد.
.IP \fB\-mset\-data\-start=\fR\fIaddress\fR 4
.IX Item "-mset-data-start=address"
هنگام پیوند دادن، شروع بخش داده را روی \fIaddress\fR تنظیم می‌کند.
.IP \fB\-mset\-program\-start=\fR\fIaddress\fR 4
.IX Item "-mset-program-start=address"
.PD 0
.IP \fB\-mno\-set\-program\-start\fR 4
.IX Item "-mno-set-program-start"
.PD
هنگام پیوند دادن، آدرس شروع برنامه را روی \fIaddress\fR تنظیم می‌کند. مقدار پیش‌فرض آن 0x100 است مگر اینکه از \fI\-mno\-set\-program\-start\fR برای لغو کامل این گزینه استفاده شود.
.PP
\fIگزینه‌های MN10300\fR
.IX Subsection "MN10300 Options"
.PP
این گزینه‌های \fB\-m\fR برای معماری‌های Matsushita MN10300 تعریف شده‌اند:
.IP \fB\-mmult\-bug\fR 4
.IX Item "-mmult-bug"
.PD 0
.IP \fB\-mno\-mult\-bug\fR 4
.IX Item "-mno-mult-bug"
.PD
در صورت فعال بودن، کدی تولید می‌کند تا از اشکالات موجود در دستورالعمل‌های ضرب برای پردازنده‌های MN10300 اجتناب شود. این حالت پیش‌فرض است.
.IP \fB\-mam33\fR 4
.IX Item "-mam33"
.PD 0
.IP \fB\-mno\-am33\fR 4
.IX Item "-mno-am33"
.PD
کد را با استفاده از ویژگی‌های اختصاصی پردازنده AM33 تولید می‌کند. حالت پیش‌فرض \fB\-mno\-am33\fR است.
.IP \fB\-mam33\-2\fR 4
.IX Item "-mam33-2"
.PD 0
.IP \fB\-mno\-am33\-2\fR 4
.IX Item "-mno-am33-2"
.PD
کد را با استفاده از ویژگی‌های اختصاصی پردازنده AM33/2.0 تولید می‌کند. حالت پیش‌فرض \fB\-mno\-am33\-2\fR است.
.IP \fB\-mam34\fR 4
.IX Item "-mam34"
.PD 0
.IP \fB\-mno\-am34\fR 4
.IX Item "-mno-am34"
.PD
کد را با استفاده از ویژگی‌های اختصاصی پردازنده AM34 تولید می‌کند. حالت پیش‌فرض \fB\-mno\-am34\fR است.
.IP \fB\-mtune=\fR\fIcpu\-type\fR 4
.IX Item "-mtune=cpu-type"
هنگام زمان‌بندی دستورالعمل‌ها، از ویژگی‌های زمان‌بندی نوع CPU مشخص‌شده استفاده می‌کند. این کار نوع پردازنده هدف را تغییر نمی‌دهد. نوع CPU باید یکی از موارد \fBmn10300\fR، \fBam33\fR، \&\fBam33\-2\fR یا \fBam34\fR باشد.
.IP \fB\-mreturn\-pointer\-on\-d0\fR 4
.IX Item "-mreturn-pointer-on-d0"
.PD 0
.IP \fB\-mno\-return\-pointer\-on\-d0\fR 4
.IX Item "-mno-return-pointer-on-d0"
.PD
هنگام تولید تابعی که یک اشاره‌گر برمی‌گرداند، اشاره‌گر را در هر دوی \f(CW\*(C`a0\*(C'\fR و \f(CW\*(C`d0\*(C'\fR بازمی‌گرداند. در غیر این صورت، اشاره‌گر تنها در \f(CW\*(C`a0\*(C'\fR بازگردانده می‌شود، و تلاش برای فراخوانی چنین توابعی بدون پیش‌نمونه منجر به خطا می‌شود. توجه داشته باشید که این گزینه به‌طور پیش‌فرض فعال است؛ برای غیرفعال کردن آن از \&\fB\-mno\-return\-pointer\-on\-d0\fR استفاده کنید.
.IP \fB\-mno\-crt0\fR 4
.IX Item "-mno-crt0"
فایل شیء مقداردهی اولیه زمان اجرای C را پیوند نمی‌دهد.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
به پیونددهنده نشان می‌دهد که باید یک مرحله بهینه‌سازی واهلش (relaxation) را برای کوتاه‌تر کردن انشعاب‌ها، فراخوانی‌ها و آدرس‌های حافظه مطلق انجام دهد. این گزینه فقط زمانی تأثیر دارد که در خط فرمان برای مرحله نهایی پیوند استفاده شود.
.Sp
این گزینه اشکال‌زدایی نمادین را غیرممکن می‌کند.
.IP \fB\-mliw\fR 4
.IX Item "-mliw"
.PD 0
.IP \fB\-mno\-liw\fR 4
.IX Item "-mno-liw"
.PD
به کامپایلر اجازه می‌دهد در صورتی که هدف \fBAM33\fR یا جدیدتر باشد، دستورالعمل‌های \fIکلمه دستورالعمل طولانی\fR را تولید کند. این گزینه به‌طور پیش‌فرض فعال است.
\&\fB\-mliw\fR ماکروی پیش‌پردازنده \f(CW\*(C`_\|_LIW_\|_\*(C'\fR را تعریف می‌کند؛
\&\fB\-mno\-liw\fR ماکروی پیش‌پردازنده \f(CW\*(C`_\|_NO_LIW_\|_\*(C'\fR را تعریف می‌کند.
.IP \fB\-msetlb\fR 4
.IX Item "-msetlb"
.PD 0
.IP \fB\-mno\-setlb\fR 4
.IX Item "-mno-setlb"
.PD
به کامپایلر اجازه می‌دهد در صورتی که هدف \fBAM33\fR یا جدیدتر باشد، دستورالعمل‌های \fISETLB\fR و \fILcc\fR را تولید کند. این گزینه به‌طور پیش‌فرض فعال است.
\&\fB\-msetlb\fR ماکروی پیش‌پردازنده \f(CW\*(C`_\|_SETLB_\|_\*(C'\fR را تعریف می‌کند؛
\&\fB\-mno\-setlb\fR ماکروی پیش‌پردازنده \f(CW\*(C`_\|_NO_SETLB_\|_\*(C'\fR را تعریف می‌کند.
.PP
\fIگزینه‌های Moxie\fR
.IX Subsection "Moxie Options"
.IP \fB\-meb\fR 4
.IX Item "-meb"
کد بزرگ‌پایان (big-endian) تولید می‌کند. این حالت پیش‌فرض برای پیکربندی‌های \fBmoxie\-*\-*\fR است.
.IP \fB\-mel\fR 4
.IX Item "-mel"
کد کوچک‌پایان (little-endian) تولید می‌کند.
.IP \fB\-mmul.x\fR 4
.IX Item "-mmul.x"
.PD 0
.IP \fB\-mno\-mul.x\fR 4
.IX Item "-mno-mul.x"
.PD
دستورالعمل‌های mul.x و umul.x را تولید می‌کند. این گزینه به‌طور پیش‌فرض برای پیکربندی‌های \&\fBmoxiebox\-*\-*\fR فعال است.
.IP \fB\-mno\-crt0\fR 4
.IX Item "-mno-crt0"
فایل شیء مقداردهی اولیه زمان اجرای C را پیوند نمی‌دهد.
.PP
\fIگزینه‌های MSP430\fR
.IX Subsection "MSP430 Options".PP
این گزینه‌ها برای MSP430 تعریف شده‌اند:
.IP \fB\-masm\-hex\fR 4
.IX Item "-masm-hex"
خروجی اسمبلی را وادار می‌کند تا همیشه از ثابت‌های شانزده‌شانزدهی (hex) استفاده کند. به طور معمول چنین
ثابت‌هایی اعداد ده‌دهی علامت‌دار هستند، اما این گزینه برای اهداف
مجموعه آزمایش (testsuite) و/یا زیبایی ظاهری در دسترس است.
.IP \fB\-mmcu=\fR\fIname\fR 4
.IX Item "-mmcu=name"
میکروکنترلر (MCU) هدف را انتخاب می‌کند. این گزینه برای ایجاد یک نماد پیش‌پردازنده C
بر اساس نام MCU استفاده می‌شود، به این صورت که به حروف بزرگ تبدیل شده و
پیشوند و پسوند \fB_\|_\fR به آن افزوده می‌گردد. این نماد به نوبه خود توسط
فایل سرایند \&\fImsp430.h\fR برای انتخاب یک فایل سرایند مکمل ویژه MCU به کار می‌رود.
.Sp
این گزینه همچنین معماری مجموعه دستورالعمل (ISA) مورد استفاده را تعیین می‌کند. اگر نام MCU به گونه‌ای باشد که
تنها از 430 ISA پشتیبانی کند، همان انتخاب می‌شود، در غیر این صورت
430X ISA انتخاب خواهد شد. نام عمومی MCU به شکل \fBmsp430\fR نیز می‌تواند
برای انتخاب 430 ISA استفاده شود. به طور مشابه، نام عمومی \fBmsp430x\fR برای MCU
معماری 430X ISA را انتخاب می‌کند.
.Sp
علاوه بر این، یک اسکریپت پیونددهنده ویژه MCU به خط فرمان پیونددهنده
اضافه می‌شود. نام اسکریپت، نام MCU به همراه پسوند
\&\fI.ld\fR است. بنابراین، مشخص کردن \fB\-mmcu=xxx\fR در خط فرمان \fBgcc\fR،
نماد پیش‌پردازنده C یعنی \f(CW\*(C`_\|_XXX_\|_\*(C'\fR را تعریف کرده و
باعث می‌شود پیونددهنده به دنبال اسکریپتی به نام \fIxxx.ld\fR بگردد.
.Sp
معماری ISA و ضرب سخت‌افزاری پشتیبانی‌شده برای MCUهای گوناگون، به صورت کدگذاری‌شده ثابت
درون GCC قرار دارد. با این حال، می‌توان از یک فایل خارجی \fIdevices.csv\fR
برای گسترش پشتیبانی از دستگاه‌ها فراتر از موارد کدگذاری‌شده استفاده کرد.
.Sp
کامپایلر GCC با استفاده از روش‌های زیر و بر اساس اولویت مشخص‌شده به دنبال فایل \fIdevices.csv\fR
می‌گردد، به طوری که روش نخست بر روش دوم و روش دوم بر روش سوم اولویت دارد.
.RS 4
.IP "مسیر include مشخص‌شده با \fB\-I\fR و \fB\-L\fR" 4
.IX Item "Include path specified with -I and -L"
فایل \&\fIdevices.csv\fR در هر یک از دایرکتوری‌های مشخص‌شده توسط مسیرهای include
و مسیرهای جستجوی کتابخانه پیونددهنده جستجو می‌شود.
.IP "مسیر مشخص‌شده توسط متغیر محیطی \fBMSP430_GCC_INCLUDE_DIR\fR" 4
.IX Item "Path specified by the environment variable MSP430_GCC_INCLUDE_DIR"
مقدار متغیر محیطی سراسری
\&\fBMSP430_GCC_INCLUDE_DIR\fR
را برابر با مسیر کامل دایرکتوری حاوی \fIdevices.csv\fR تعریف کنید
تا GCC این دایرکتوری را برای یافتن \fIdevices.csv\fR جستجو کند.
اگر \fIdevices.csv\fR یافت شود، این دایرکتوری همچنین به عنوان مسیر include
و مسیر کتابخانه پیونددهنده ثبت می‌شود. بنابراین فایل‌های سرایند
و اسکریپت‌های پیونددهنده موجود در این دایرکتوری را می‌توان بدون تعیین
دستی \fB\-I\fR و \fB\-L\fR در خط فرمان استفاده کرد.
.IP "دایرکتوری \fImsp430\-elf{,bare}/include/devices\fR" 4
.IX Item "The msp430-elf{,bare}/include/devices directory"
در نهایت، GCC مسیر \fImsp430\-elf{,bare}/include/devices\fR را از دایرکتوری
ریشه زنجیره ابزار بررسی می‌کند. این دایرکتوری در نصب پیش‌فرض
وجود ندارد، اما اگر آن را ایجاد کرده و \fIdevices.csv\fR را در آن رونوشت
کرده باشید، داده‌های MCU خوانده می‌شوند. همانند موارد بالا، این دایرکتوری نیز
به عنوان مسیر include و مسیر کتابخانه پیونددهنده ثبت می‌شود.
.RE
.RS 4
.Sp
اگر هیچ‌یک از روش‌های جستجوی بالا فایل \fIdevices.csv\fR را پیدا نکنند، از
داده‌های کدگذاری‌شده ثابت MCU استفاده خواهد شد.
.RE
.IP \fB\-mwarn\-mcu\fR 4
.IX Item "-mwarn-mcu"
.PD 0
.IP \fB\-mno\-warn\-mcu\fR 4
.IX Item "-mno-warn-mcu"
.PD
این گزینه هشدارهای مربوط به تداخل میان نام MCU مشخص‌شده توسط گزینه \fB\-mmcu\fR
و ISA تعیین‌شده توسط گزینه \&\fB\-mcpu\fR و/یا پشتیبانی از ضرب سخت‌افزاری
تعیین‌شده توسط گزینه \&\fB\-mhwmult\fR را فعال یا غیرفعال می‌کند. این گزینه
همچنین هشدارهای مربوط به نام‌های ناشناخته MCU را تغییر وضعیت می‌دهد. این گزینه
به‌طور پیش‌فرض فعال است.
.IP \fB\-msim\fR 4
.IX Item "-msim"
پیوند با کتابخانه‌های زمان اجرای شبیه‌ساز و اسکریپت پیونددهنده آن. این گزینه
بر هر اسکریپتی که ممکن است توسط گزینه \fB\-mmcu=\fR انتخاب شود اولویت دارد و
جایگزین آن می‌شود.
.IP \fB\-mlarge\fR 4
.IX Item "-mlarge"
استفاده از مدل آدرس‌دهی بزرگ (اشاره‌گرهای ۲۰ بیتی، \f(CW\*(C`size_t\*(C'\fR ۲۰ بیتی).
.IP \fB\-msmall\fR 4
.IX Item "-msmall"
استفاده از مدل آدرس‌دهی کوچک (اشاره‌گرهای ۱۶ بیتی، \f(CW\*(C`size_t\*(C'\fR ۱۶ بیتی).
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
این گزینه به اسمبلر و پیونددهنده ارسال می‌شود و به پیونددهنده اجازه می‌دهد
بهینه‌سازی‌های خاصی را انجام دهد که تا پیش از زمان پیوند نهایی
قابل انجام نیستند.
.IP \fBmhwmult=\fR\fItype\fR 4
.IX Item "mhwmult=type"
نوع ضرب سخت‌افزاری پشتیبانی‌شده توسط هدف را توصیف می‌کند.
مقادیر پذیرفته‌شده برای \fItype\fR عبارتند از: \fBnone\fR برای عدم وجود ضرب سخت‌افزاری،
\&\fB16bit\fR
برای ضرب اصلی صرفاً ۱۶ بیتی که در MCUهای اولیه پشتیبانی می‌شد،
\&\fB32bit\fR برای ضرب ۱۶/۳۲ بیتی پشتیبانی‌شده در MCUهای جدیدتر، و
\&\fBf5series\fR برای ضرب ۱۶/۳۲ بیتی پشتیبانی‌شده در MCUهای سری F5.
مقدار \fBauto\fR نیز می‌تواند ارائه شود. این مقدار به GCC می‌گوید تا
پشتیبانی از ضرب سخت‌افزاری را بر اساس نام MCU ارائه‌شده توسط
گزینه \&\fB\-mmcu\fR استنتاج کند. اگر هیچ گزینه \fB\-mmcu\fR مشخص نشده باشد یا
نام MCU ناشناخته باشد، فرض می‌شود ضرب سخت‌افزاری پشتیبانی نمی‌شود.
\f(CW\*(C`auto\*(C'\fR مقدار پیش‌فرض است.
.Sp
ضرب‌های سخت‌افزاری معمولاً با فراخوانی یک روتین کتابخانه‌ای انجام می‌شوند.
این کار باعث صرفه‌جویی در فضای کد تولیدشده می‌شود. با این حال هنگام کامپایل با
\&\fB\-O3\fR یا بالاتر، ضرب‌کننده سخت‌افزاری به صورت درون‌خطی (inline) فراخوانی
می‌شود. این کار کدی بزرگ‌تر اما سریع‌تر تولید می‌کند.
.Sp
روتین‌های ضرب سخت‌افزاری وقفه‌ها را در حین اجرا غیرفعال کرده و
پس از اتمام کار، وضعیت پیشین وقفه را بازمی‌گردانند. این موضوع
استفاده از آن‌ها را در داخل گرداننده‌های وقفه و همچنین در کدهای معمولی ایمن می‌سازد.
.IP \fB\-minrt\fR 4
.IX Item "-minrt"
استفاده از یک محیط زمان اجرای حداقلی بدون پشتیبانی از مقداردهنده‌های اولیه‌ی
ایستا یا سازنده‌ها را فعال می‌کند. این قابلیت برای دستگاه‌های با حافظه محدود
در نظر گرفته شده است. کامپایلر نمادهای خاصی را در برخی شیءها قرار می‌دهد
که به پیونددهنده و زمان اجرا اعلام می‌کنند کدام بخش‌های کد مورد نیاز است.
.IP \fB\-mtiny\-printf\fR 4
.IX Item "-mtiny-printf"
توابع کتابخانه‌ای \f(CW\*(C`printf\*(C'\fR و \f(CW\*(C`puts\*(C'\fR با اندازه کد کاهش‌یافته را فعال می‌کند.
پیاده‌سازی‌های \fBtiny\fR این توابع بازورودپذیر (reentrant) نیستند، بنابراین
باید در برنامه‌های چندنخی با احتیاط استفاده شوند.
.Sp
پشتیبانی از جریان‌ها (streams) حذف شده است و رشته‌های چاپی
همیشه از طریق فراخوانی سیستمی \f(CW\*(C`write\*(C'\fR به stdout ارسال می‌شوند. رشته
پیش از ارسال به write بافر نمی‌شود.
.Sp
این گزینه به Newlib Nano IO نیاز دارد، بنابراین GCC باید با
\&\fB\-\-enable\-newlib\-nano\-formatted\-io\fR پیکربندی شده باشد.
.IP \fB\-mmax\-inline\-shift=\fR\fIn\fR 4
.IX Item "-mmax-inline-shift=n"
این گزینه یک عدد صحیح \fIn\fR بین ۰ تا ۶۴ (شامل هر دو) می‌گیرد و
حداکثر تعداد دستورهای شیفت درون‌خطی (inline) را تعیین می‌کند که باید برای
انجام عملیات شیفت با مقداری ثابت صادر شوند. هنگامی که نیاز به عبور از این
مقدار باشد، به جای آن از یک تابع کمکی mspabi استفاده می‌شود. مقدار پیش‌فرض ۴ است.
.Sp
این موضوع فقط بر مواردی اثر می‌گذارد که شیفت به چندین موقعیت نتواند
با یک دستور واحد انجام شود (مانند تمام شیفت‌های >1 در 430 ISA).
.Sp
شیفت‌های یک مقدار ۳۲ بیتی دست‌کم دو برابر پرهزینه‌تر هستند، بنابراین مقدار ارائه‌شده برای
این گزینه بر ۲ تقسیم شده و مقدار حاصل به جای آن استفاده می‌شود.
.IP \fB\-mcode\-region=\fR\fIwhere\fR 4
.IX Item "-mcode-region=where"
.PD 0
.IP \fB\-mdata\-region=\fR\fIwhere\fR 4
.IX Item "-mdata-region=where"
.PD
این گزینه‌ها به کامپایلر اعلام می‌کنند که توابع و داده‌هایی را که هیچ‌یک از
صفت‌های \f(CW\*(C`lower\*(C'\fR، \f(CW\*(C`upper\*(C'\fR، \f(CW\*(C`either\*(C'\fR یا
\&\f(CW\*(C`section\*(C'\fR را ندارند در کجا قرار دهد. مقادیر ممکن برای \fIwhere\fR عبارتند از \fBlower\fR،
\&\fBupper\fR، \fBeither\fR یا \fBany\fR. سه مقدار نخست مانند
صفت متناظر عمل می‌کنند. چهارمین مقدار ممکن،
\&\fBany\fR، پیش‌فرض است. این مقدار، جای‌گذاری را به طور کامل به
اسکریپت پیونددهنده و نحوه تخصیص بخش‌های استاندارد
(\f(CW\*(C`.text\*(C'\fR، \f(CW\*(C`.data\*(C'\fR و غیره) به نواحی حافظه واگذار می‌کند.
.IP \fB\-muse\-lower\-region\-prefix\fR 4
.IX Item "-muse-lower-region-prefix"
هنگام کامپایل با \&\fB\-mcode\-region=lower\fR یا \fB\-mdata\-region=lower\fR، پیشوند
\fB.lower\fR را به نام بخش‌ها اضافه می‌کند. به طور
پیش‌فرض غیرفعال است.
.IP \fB\-msilicon\-errata=\fR\fIname\fR[\fB,\fR\fIname\fR\fB...\fR] 4
.IX Item "-msilicon-errata=name[,name...]"
این گزینه درخواستی را به اسمبلر ارسال می‌کند تا اصلاحات مربوط به
خطاهای سخت‌افزاری سیلیسیمی (silicon errata) نام‌برده‌شده را فعال کند. برای جزئیات به مستندات اسمبلر مراجعه کنید.
.IP \fB\-msilicon\-errata\-warn=\fR\fIname\fR[\fB,\fR\fIname\fR\fB...\fR] 4
.IX Item "-msilicon-errata-warn=name[,name...]"
این گزینه درخواستی را به اسمبلر ارسال می‌کند تا در مواردی که ممکن است
نیاز به اعمال خطای سخت‌افزاری سیلیسیمی نام‌برده‌شده باشد، پیام‌های هشدار را
فعال کند. برای جزئیات به مستندات اسمبلر مراجعه کنید.
.IP \fB\-mwarn\-devices\-csv\fR 4
.IX Item "-mwarn-devices-csv"
.PD 0
.IP \fB\-mno\-warn\-devices\-csv\fR 4
.IX Item "-mno-warn-devices-csv"
.PD
اگر \fIdevices.csv\fR پیدا نشود یا در تجزیه آن مشکلی وجود داشته باشد
هشدار می‌دهد (پیش‌فرض: فعال).
.PP
\fIگزینه‌های NDS32\fR
.IX Subsection "NDS32 Options".PP
این گزینه‌ها برای پیاده‌سازی‌های NDS32 تعریف شده‌اند:
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
.PD 0
.IP \fB\-EB\fR 4
.IX Item "-EB"
.PD
تولید کد در حالت big\-endian.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
.PD 0
.IP \fB\-EL\fR 4
.IX Item "-EL"
.PD
تولید کد در حالت little\-endian.
.IP \fB\-mabi=2\fR 4
.IX Item "-mabi=2"
.PD 0
.IP \fB\-mfloat\-abi=soft\fR 4
.IX Item "-mfloat-abi=soft"
.PD
استفاده از ABI نرم‌افزاری ممیز شناور (soft floating\-point).
.IP \fB\-mabi=2fp+\fR 4
.IX Item "-mabi=2fp+"
.PD 0
.IP \fB\-mfloat\-abi=hard\fR 4
.IX Item "-mfloat-abi=hard"
.PD
استفاده از ABI سخت‌افزاری ممیز شناور (hard floating\-point).
.IP \fB\-mreduced\-regs\fR 4
.IX Item "-mreduced-regs"
استفاده از مجموعه ثبات‌های کاهش‌یافته (reduced\-set) برای تخصیص ثبات.
.IP \fB\-mfull\-regs\fR 4
.IX Item "-mfull-regs"
استفاده از مجموعه ثبات‌های کامل (full\-set) برای تخصیص ثبات.
.IP \fB\-malways\-align\fR 4
.IX Item "-malways-align"
هم‌ترازسازی همیشگی نقطه ورود تابع، مقصدهای پرش و نشانی بازگشت.
.IP \fB\-malign\-functions\fR 4
.IX Item "-malign-functions"
هم‌ترازسازی نقطه ورود تابع با مرز ۴ بایت.
.IP \fB\-mfp\-as\-gp\fR 4
.IX Item "-mfp-as-gp"
.PD 0
.IP \fB\-mno\-fp\-as\-gp\fR 4
.IX Item "-mno-fp-as-gp"
.PD
فعال/غیرفعال کردن بهینه‌سازی fp\-as\-gp.
.IP \fB\-mcmov\fR 4
.IX Item "-mcmov"
.PD 0
.IP \fB\-mno\-cmov\fR 4
.IX Item "-mno-cmov"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های جابه‌جایی شرطی (conditional move).
.IP \fB\-mhw\-abs\fR 4
.IX Item "-mhw-abs"
.PD 0
.IP \fB\-mno\-hw\-abs\fR 4
.IX Item "-mno-hw-abs"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های سخت‌افزاری قدر مطلق (abs).
.IP \fB\-mext\-perf\fR 4
.IX Item "-mext-perf"
.PD 0
.IP \fB\-mno\-ext\-perf\fR 4
.IX Item "-mno-ext-perf"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های افزونه کارایی (performance extension).
.IP \fB\-mext\-perf2\fR 4
.IX Item "-mext-perf2"
.PD 0
.IP \fB\-mno\-ext\-perf2\fR 4
.IX Item "-mno-ext-perf2"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های افزونه کارایی ۲ (performance extension 2).
.IP \fB\-mext\-string\fR 4
.IX Item "-mext-string"
.PD 0
.IP \fB\-mno\-ext\-string\fR 4
.IX Item "-mno-ext-string"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های افزونه رشته (string extension).
.IP \fB\-mext\-dsp\fR 4
.IX Item "-mext-dsp"
.PD 0
.IP \fB\-mno\-ext\-dsp\fR 4
.IX Item "-mno-ext-dsp"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های افزونه DSP.
.IP \fB\-mext\-fpu\-fma\fR 4
.IX Item "-mext-fpu-fma"
.PD 0
.IP \fB\-mno\-ext\-fpu\-fma\fR 4
.IX Item "-mno-ext-fpu-fma"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های ضرب و جمع ممیز شناور (multiply\-accumulation).
.IP \fB\-mext\-fpu\-sp\fR 4
.IX Item "-mext-fpu-sp"
.PD 0
.IP \fB\-mno\-ext\-fpu\-sp\fR 4
.IX Item "-mno-ext-fpu-sp"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های ممیز شناور با دقت یگانه (single\-precision).
.IP \fB\-mext\-fpu\-dp\fR 4
.IX Item "-mext-fpu-dp"
.PD 0
.IP \fB\-mno\-ext\-fpu\-dp\fR 4
.IX Item "-mno-ext-fpu-dp"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های ممیز شناور با دقت مضاعف (double\-precision).
.IP \fB\-mv3push\fR 4
.IX Item "-mv3push"
.PD 0
.IP \fB\-mno\-v3push\fR 4
.IX Item "-mno-v3push"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های v3 push25/pop25.
.IP \fB\-m16\-bit\fR 4
.IX Item "-m16-bit"
.PD 0
.IP \fB\-mno\-16\-bit\fR 4
.IX Item "-mno-16-bit"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های ۱۶ بیتی.
.IP \fB\-mvh\fR 4
.IX Item "-mvh"
.PD 0
.IP \fB\-mno\-vh\fR 4
.IX Item "-mno-vh"
.PD
فعال/غیرفعال کردن پشتیبانی از Virtual Hosting.
.IP \fB\-misr\-vector\-size=\fR\fInum\fR 4
.IX Item "-misr-vector-size=num"
تعیین اندازه هر بردار وقفه، که باید ۴ یا ۱۶ باشد.
.IP \fB\-misr\-secure=\fR\fInum\fR 4
.IX Item "-misr-secure=num"
تعیین سطح امنیت c\-isr برای کل فایل.
.IP \fB\-mcache\-block\-size=\fR\fInum\fR 4
.IX Item "-mcache-block-size=num"
تعیین اندازه هر بلوک حافظه نهان (cache block)،
که باید توانی از ۲ بین ۴ و ۵۱۲ باشد.
.IP \fB\-march=\fR\fIarch\fR 4
.IX Item "-march=arch"
معماری مقصد را مشخص می‌کند. \fIarch\fR می‌تواند یکی از مقادیر
\&\fBv2\fR، \fBv3\fR، \fBv3j\fR، \fBv3m\fR، \fBv3f\fR یا \fBv3s\fR باشد.
.IP \fB\-mcpu=\fR\fIcpu\fR 4
.IX Item "-mcpu=cpu"
پردازنده (CPU) مقصد برای کامپایل را مشخص می‌کند. \fIcpu\fR می‌تواند یکی از مقادیر
\&\fBn6\fR، \fBn650\fR، \fBn7\fR، \fBn705\fR، \fBn8\fR، \fBn801\fR،
\&\fBsn8\fR، \fBsn801\fR، \fBs8\fR، \fBs801\fR، \fBe8\fR، \fBe801\fR،
\&\fBn820\fR، \fBs830\fR، \fBe830\fR، \fBn9\fR، \fBn903\fR، \fBn903a\fR،
\&\fBn968\fR، \fBn968a\fR، \fBn10\fR، \fBn1033\fR، \fBn1033a\fR،
\&\fBn1033\-fpu\fR، \fBn1033\-spu\fR، \fBn1068\fR، \fBn1068a\fR،
\&\fBn1068\-fpu\fR، \fBn1068a\-fpu\fR، \fBd10\fR، \fBd1088\fR،
\&\fBd1088\-fpu\fR، \fBd1088\-spu\fR، \fBn15\fR، \fBd15\fR، \fBn15s\fR،
\&\fBd15s\fR، \fBn15f\fR، \fBd15f\fR، \fBn12\fR، \fBn1213\fR،
\&\fBn1233\fR، \fBn1233\-fpu\fR، \fBn1233\-spu\fR، \fBn13\fR، \fBn1337\fR،
\&\fBn1337\-fpu\fR، \fBn1337\-spu\fR یا \fBsimple\fR باشد.
.IP \fB\-mconfig\-fpu=\fR\fInum\fR 4
.IX Item "-mconfig-fpu=num"
مقدار پیکربندی FPU را از 0 تا 7 مشخص می‌کند؛ مقادیر 0\-\-3 همان‌طور که در مشخصات FPU آمده است می‌باشند،
و مقادیر 4\-\-7 متناظر با 0\-\-3 هستند.
.IP \fB\-mconfig\-mul=\fR\fItype\fR 4
.IX Item "-mconfig-mul=type"
پیکربندی دستورالعمل ضرب را تعیین می‌کند. \fItype\fR می‌تواند یکی از مقادیر
\&\fBfast\fR، \fBfast1\fR (معادل با \fBfast\fR)، \fBfast2\fR یا
\&\fBslow\fR باشد. مقدار پیش‌فرض \fBfast1\fR است.
.IP \fB\-mconfig\-register\-ports=\fR\fIkind\fR 4
.IX Item "-mconfig-register-ports=kind"
تعداد درگاه‌های خواندن/نوشتن را برای هسته‌های n9/n10 تعیین می‌کند. این مقدار باید
\&\fB3r2w\fR یا \fB2r1w\fR باشد.
.IP \fB\-mcmodel=\fR\fIcode\-model\fR 4
.IX Item "-mcmodel=code-model"
مدل کد را روی یکی از موارد زیر تنظیم می‌کند:
.RS 4
.IP \fBsmall\fR 4
.IX Item "small"
تمام بخش‌های داده و داده‌های فقط‌خواندنی (read\-only data) باید در فضای آدرس‌دهی 512KB قرار داشته باشند.
بخش کد (text segment) باید در فضای آدرس‌دهی 16MB قرار داشته باشد..IP \fBmedium\fR 4
.IX Item "medium"
قطعهٔ داده باید درون محدودهٔ 512KB باشد، در حالی که قطعهٔ دادهٔ فقط‌خواندنی می‌تواند درون فضای آدرس‌دهی 4GB قرار گیرد. قطعهٔ کد (text segment) همچنان باید درون فضای آدرس‌دهی 16MB باشد.
.IP \fBlarge\fR 4
.IX Item "large"
تمام قطعه‌های کد و داده می‌توانند درون فضای آدرس‌دهی 4GB باشند.
.RE
.RS 4
.Sp
پیش‌فرض در مقصدهای GNU/Linux برابر با \fBlarge\fR و در سایر مقصدهای ELF برابر با \fBmedium\fR است.
.RE
.IP \fB\-mctor\-dtor\fR 4
.IX Item "-mctor-dtor"
.PD 0
.IP \fB\-mno\-ctor\-dtor\fR 4
.IX Item "-mno-ctor-dtor"
.PD
فعال/غیرفعال کردن ویژگی سازنده/ویرانگر (constructor/destructor).
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
.PD 0
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
.PD
فعال/غیرفعال کردن گزینهٔ پیونددهنده برای تعدیل (relax) دستورالعمل‌ها.
.IP \fB\-mrelax\-hint\fR 4
.IX Item "-mrelax-hint"
.PD 0
.IP \fB\-mno\-relax\-hint\fR 4
.IX Item "-mno-relax-hint"
.PD
فعال/غیرفعال کردن درج راهنماها (hints) برای پیونددهنده جهت انجام تعدیل.
.IP \fB\-msched\-prolog\-epilog\fR 4
.IX Item "-msched-prolog-epilog"
.PD 0
.IP \fB\-mno\-sched\-prolog\-epilog\fR 4
.IX Item "-mno-sched-prolog-epilog"
.PD
فعال/غیرفعال کردن زمان‌بندی توالی آغازین (prologue) و پایانی (epilogue) تابع.
.IP \fB\-mret\-in\-naked\-func\fR 4
.IX Item "-mret-in-naked-func"
.PD 0
.IP \fB\-mno\-ret\-in\-naked\-func\fR 4
.IX Item "-mno-ret-in-naked-func"
.PD
فعال/غیرفعال کردن تولید دستورالعمل‌های بازگشت در توابع عریان (naked functions). این گزینه به طور پیش‌فرض فعال است.
.IP \fB\-malways\-save\-lp\fR 4
.IX Item "-malways-save-lp"
.PD 0
.IP \fB\-mno\-always\-save\-lp\fR 4
.IX Item "-mno-always-save-lp"
.PD
فعال/غیرفعال کردن ذخیرهٔ همیشگی \f(CW$lp\fR در پشته (stack).
.IP \fB\-munaligned\-access\fR 4
.IX Item "-munaligned-access"
.PD 0
.IP \fB\-mno\-unaligned\-access\fR 4
.IX Item "-mno-unaligned-access"
.PD
فعال/غیرفعال کردن دسترسی‌های ناتراز کلمه (word) و نیم‌کلمه (halfword) به داده‌های بسته‌بندی‌شده (packed).
.IP \fB\-minline\-asm\-r15\fR 4
.IX Item "-minline-asm-r15"
.PD 0
.IP \fB\-mno\-inline\-asm\-r15\fR 4
.IX Item "-mno-inline-asm-r15"
.PD
مجاز/غیرمجاز کردن استفاده از r15 برای اسمبلی درون‌خطی (inline asm).
.PP
\fIگزینه‌های Nvidia PTX\fR
.IX Subsection "Nvidia PTX Options"
.PP
این گزینه‌ها برای Nvidia PTX تعریف شده‌اند:
.IP \fB\-m64\fR 4
.IX Item "-m64"
نادیده گرفته می‌شود، اما برای سازگاری با گذشته حفظ شده است. تنها ABI ۶۴\-بیتی پشتیبانی می‌شود.
.IP \fB\-march=\fR\fIarchitecture\-string\fR 4
.IX Item "-march=architecture-string"
تولید کد برای معماری مقصد PTX ISA مشخص‌شده.
رشته‌های معماری معتبر عبارتند از:
\&\fBsm_30\fR، \fBsm_35\fR، \fBsm_37\fR،
\&\fBsm_50\fR، \fBsm_52\fR، \fBsm_53\fR،
\&\fBsm_61\fR،
\&\fBsm_70\fR، \fBsm_75\fR،
\&\fBsm_80\fR و \fBsm_89\fR.
مقدار پیش‌فرض به نحوهٔ پیکربندی کامپایلر بستگی دارد؛ به
\&\fB\-\-with\-arch\fR مراجعه کنید.
.Sp
این گزینه مقدار ماکروی پیش‌پردازندهٔ
\&\f(CW\*(C`_\|_PTX_SM_\|_\*(C'\fR را تنظیم می‌کند؛ برای نمونه، برای \fBsm_35\fR، دارای مقدار
\&\fB350\fR است.
.IP \fB\-misa=\fR\fIarchitecture\-string\fR 4
.IX Item "-misa=architecture-string"
نام مستعار \fB\-march=\fR.
.IP \fB\-march\-map=\fR\fIarchitecture\-string\fR 4
.IX Item "-march-map=architecture-string"
نزدیک‌ترین مقدار دردسترس برای \fB\-march=\fR را انتخاب می‌کند که توانمندتر از مقدار درخواستی نباشد. برای نمونه، برای \fB\-march\-map=sm_50\fR گزینهٔ
\&\fB\-march=sm_37\fR و برای \fB\-march\-map=sm_53\fR گزینهٔ
\&\fB\-march=sm_53\fR را انتخاب می‌کند.
.IP \fB\-mptx=\fR\fIversion\-string\fR 4
.IX Item "-mptx=version-string"
تولید کد برای نگارش مشخص‌شده از PTX ISA.
رشته‌های نگارش معتبر عبارتند از:
\&\fB3.1\fR،
\&\fB4.0\fR، \fB4.1\fR، \fB4.2\fR،
\&\fB5.0\fR،
\&\fB6.0\fR، \fB6.3\fR،
\&\fB7.0\fR، \fB7.3\fR و \fB7.8\fR.
نگارش پیش‌فرض PTX ISA همان نسخه‌ای است که پشتیبانی از معماری مقصد انتخاب‌شده را افزوده است (به \fB\-march=\fR مراجعه کنید)، اما حداقل
\&\fB6.3\fR، یا برای \fB\-march=sm_52\fR و بالاتر، \fB7.3\fR است.
.Sp
این گزینه مقدارهای ماکروهای پیش‌پردازندهٔ
\&\f(CW\*(C`_\|_PTX_ISA_VERSION_MAJOR_\|_\*(C'\fR و \f(CW\*(C`_\|_PTX_ISA_VERSION_MINOR_\|_\*(C'\fR را تنظیم می‌کند؛
برای نمونه، برای \fB3.1\fR این ماکروها به ترتیب دارای مقادیر \fB3\fR و
\&\fB1\fR هستند.
.IP \fB\-mmainkernel\fR 4
.IX Item "-mmainkernel"
پیوند دادن کد برای یک کرنل _\|_main. این گزینه برای اجرای مستقل (stand-alone) به جای اجرای تخلیه بار پردازشی (offloading) به کار می‌رود.
.IP \fB\-moptimize\fR 4
.IX Item "-moptimize"
.PD 0
.IP \fB\-mno\-optimize\fR 4
.IX Item "-mno-optimize"
.PD
فعال/غیرفعال کردن بهینه‌سازی‌های اجرای بخش‌بندی‌شده (partitioned execution). این گزینه به طور پیش‌فرض زمانی که هر سطحی از بهینه‌سازی انتخاب شده باشد، فعال است.
.IP \fB\-msoft\-stack\fR 4
.IX Item "-msoft-stack"
.PD 0
.IP \fB\-mno\-soft\-stack\fR 4
.IX Item "-mno-soft-stack"
.PD
برای \fB\-mno\-soft\-stack\fR (پیش‌فرض، مگر این‌که \fB\-mgomp\fR مشخص شده باشد)، از پشته‌های «بومی» (native) در PTX استفاده می‌شود؛ بدین معنی که کدی تولید می‌شود که از حافظهٔ \f(CW\*(C`.local\*(C'\fR یا دستور \f(CW\*(C`alloca\*(C'\fR در PTX به طور مستقیم برای ذخیره‌سازی پشته بهره می‌برد.
مگر در حالتی که \fB\-mptx=7.3\fR یا بالاتر و \fB\-march=sm_52\fR یا بالاتر فعال باشند، آرایه‌های با طول متغیر و تخصیص پویای حافظه روی پشته با \f(CW\*(C`alloca\*(C'\fR پشتیبانی نمی‌شوند.
.Sp
برای \fB\-msoft\-stack\fR (که توسط \fB\-mgomp\fR به طور ضمنی فعال می‌شود)، کدی تولید می‌شود که از حافظهٔ \f(CW\*(C`.local\*(C'\fR یا \f(CW\*(C`alloca\*(C'\fR در PTX مستقیماً برای ذخیره‌سازی پشته استفاده نمی‌کند. در عوض، یک اشاره‌گر پشته به ازای هر warp به طور صریح نگهداری می‌شود. این کار امکان تخصیص پشته با طول متغیر (با آرایه‌های با طول متغیر یا \f(CW\*(C`alloca\*(C'\fR) را فراهم می‌کند، و زمانی که حافظهٔ سراسری (global memory) برای ذخیره‌سازی زیربنایی به کار رود، دسترسی به متغیرهای خودکار (automatic variables) از سایر رشته‌ها (threads) یا با دستورالعمل‌های اتمیک را ممکن می‌سازد. این روش تولید کد برای offloading در OpenMP استفاده می‌شود، اما این گزینه به تنهایی به منظور آزمودن کامپایلر دردسترس قرار گرفته است؛ برای تولید کد مناسب جهت پیوند در برنامه‌هایی که از offloading در OpenMP استفاده می‌کنند، از گزینهٔ \fB\-mgomp\fR استفاده کنید.
.IP \fB\-msoft\-stack\-reserve\-local=\fR\fIsize\fR 4
.IX Item "-msoft-stack-reserve-local=size"
اندازهٔ حافظهٔ \f(CW\*(C`.local\*(C'\fR استفاده‌شده برای پشته را هنگامی که مقدار دقیق آن مشخص نیست تعیین می‌کند. مقدار پیش‌فرض آن 128 است.
.IP \fB\-muniform\-simt\fR 4
.IX Item "-muniform-simt"
.PD 0
.IP \fB\-mno\-uniform\-simt\fR 4
.IX Item "-mno-uniform-simt"
.PD
فعال/غیرفعال کردن نوعی از تولید کد که امکان اجرای تمام رشته‌ها (threads) را در هر warp فراهم می‌کند، در حالی که وضعیت حافظه و اثرات جانبی (side effects) را طوری حفظ می‌کند که گویی تنها یک رشته در هر warp بیرون از ناحیه‌های SIMD مربوط به OpenMP فعال است. تمام عملیات اتمیک و فراخوانی‌های زمان اجرا (\f(CW\*(C`malloc\*(C'\fR، \f(CW\*(C`free\*(C'\fR، \f(CW\*(C`vprintf\*(C'\fR) به صورت شرطی اجرا می‌شوند (تنها در صورتی که نمایهٔ لاین کنونی برابر با نمایهٔ لاین اصلی باشد)، و ثباتی که مقداردهی می‌شود از طریق یک دستورالعمل shuffle از لاین اصلی رونوشت می‌گردد. در خارج از ناحیه‌های SIMD، لاین 0 به عنوان اصلی (master) عمل می‌کند؛ در درون، هر رشته خود را به عنوان اصلی در نظر می‌گیرد. آرایهٔ حافظهٔ اشتراکی \f(CW\*(C`int _\|_nvptx_uni[]\*(C'\fR ماسک‌های بیتی تمام‌صفر یا تمام‌یک را برای هر warp ذخیره می‌کند که نشان‌دهندهٔ حالت جاری است (۰ در خارج از ناحیه‌های SIMD). هر رشته می‌تواند ماسک بیتی در موقعیت \f(CW\*(C`tid.y\*(C'\fR را با نمایهٔ لاین جاری AND بیتی کند تا نمایهٔ لاین اصلی را محاسبه نماید..IP \fB\-mgomp\fR 4
.IX Item "-mgomp"
.PD 0
.IP \fB\-mno\-gomp\fR 4
.IX Item "-mno-gomp"
.PD
فعال/غیرفعال‌سازی تولید کد برای استفاده در OpenMP offloading.
گزینهٔ \&\fB\-mgomp\fR گزینه‌های \fB\-msoft\-stack\fR و
\&\fB\-muniform\-simt\fR را فعال کرده و گونهٔ multilib متناظر را انتخاب می‌کند.
.PP
\fIگزینه‌های OpenRISC\fR
.IX Subsection "OpenRISC Options"
.PP
این گزینه‌ها برای OpenRISC تعریف شده‌اند:
.IP \fB\-mboard=\fR\fIname\fR 4
.IX Item "-mboard=name"
پیکربندی زمان اجرای مخصوص یک برد. این مقدار برای پیوند با کتابخانهٔ برد newlib
به پیونددهنده ارسال می‌شود. مقدار پیش‌فرض \f(CW\*(C`or1ksim\*(C'\fR است.
.IP \fB\-msoft\-div\fR 4
.IX Item "-msoft-div"
.PD 0
.IP \fB\-mhard\-div\fR 4
.IX Item "-mhard-div"
.PD
انتخاب دستورالعمل‌های نرم‌افزاری یا سخت‌افزاری تقسیم (\f(CW\*(C`l.div\*(C'\fR، \f(CW\*(C`l.divu\*(C'\fR).
حالت پیش‌فرض تقسیم سخت‌افزاری است.
.IP \fB\-msoft\-mul\fR 4
.IX Item "-msoft-mul"
.PD 0
.IP \fB\-mhard\-mul\fR 4
.IX Item "-mhard-mul"
.PD
انتخاب دستورالعمل‌های نرم‌افزاری یا سخت‌افزاری ضرب (\f(CW\*(C`l.mul\*(C'\fR، \f(CW\*(C`l.muli\*(C'\fR).
حالت پیش‌فرض ضرب سخت‌افزاری است.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
انتخاب نرم‌افزار یا سخت‌افزار برای محاسبات ممیز شناور.
پیش‌فرض حالت نرم‌افزاری است.
.IP \fB\-mdouble\-float\fR 4
.IX Item "-mdouble-float"
هنگامی که \fB\-mhard\-float\fR انتخاب شده باشد، تولید دستورالعمل‌های ممیز شناور
با دقت مضاعف (double\-precision) را فعال می‌کند. به‌طور پیش‌فرض، از توابع \fIlibgcc\fR
برای انجام عملیات ممیز شناور با دقت مضاعف استفاده می‌شود.
.IP \fB\-munordered\-float\fR 4
.IX Item "-munordered-float"
هنگامی که \fB\-mhard\-float\fR انتخاب شده باشد، تولید دستورالعمل‌های مقایسهٔ
نامرتب ممیز شناور و تنظیم پرچم (\f(CW\*(C`lf.sfun*\*(C'\fR) را فعال می‌کند. به‌طور پیش‌فرض
از توابع \fIlibgcc\fR برای انجام عملیات مقایسهٔ نامرتب ممیز شناور و تنظیم پرچم استفاده می‌شود.
.IP \fB\-mcmov\fR 4
.IX Item "-mcmov"
فعال کردن تولید دستورالعمل‌های انتقال شرطی (\f(CW\*(C`l.cmov\*(C'\fR). به‌طور
پیش‌فرض، معادل‌های آن با استفاده از set و branch تولید می‌شوند.
.IP \fB\-mror\fR 4
.IX Item "-mror"
فعال کردن تولید دستورالعمل‌های چرخش به راست (\f(CW\*(C`l.ror\*(C'\fR). به‌طور پیش‌فرض
از توابع \fIlibgcc\fR برای انجام عملیات چرخش به راست استفاده می‌شود.
.IP \fB\-mrori\fR 4
.IX Item "-mrori"
فعال کردن تولید دستورالعمل‌های چرخش به راست با مقدار بی‌واسطه (\f(CW\*(C`l.rori\*(C'\fR).
به‌طور پیش‌فرض، از توابع \fIlibgcc\fR برای انجام عملیات چرخش به راست با مقدار بی‌واسطه
استفاده می‌شود.
.IP \fB\-msext\fR 4
.IX Item "-msext"
فعال کردن تولید دستورالعمل‌های گسترش علامت (\f(CW\*(C`l.ext*\*(C'\fR). به‌طور پیش‌فرض
از بارگذاری‌های حافظه برای انجام گسترش علامت استفاده می‌شود.
.IP \fB\-msfimm\fR 4
.IX Item "-msfimm"
فعال کردن تولید دستورالعمل‌های مقایسه و تنظیم پرچم با مقدار بی‌واسطه (\f(CW\*(C`l.sf*i\*(C'\fR).
به‌طور پیش‌فرض، دستورالعمل‌های اضافی برای ذخیرهٔ مقدار بی‌واسطه در یک ثبات تولید می‌شود.
.IP \fB\-mshftimm\fR 4
.IX Item "-mshftimm"
فعال کردن تولید دستورالعمل‌های شیفت با مقدار بی‌واسطه (\f(CW\*(C`l.srai\*(C'\fR، \f(CW\*(C`l.srli\*(C'\fR و
\&\f(CW\*(C`l.slli\*(C'\fR). به‌طور پیش‌فرض، دستورالعمل‌های اضافی برای ذخیرهٔ مقدار بی‌واسطه
در یک ثبات تولید می‌شود.
.IP \fB\-mcmodel=small\fR 4
.IX Item "-mcmodel=small"
تولید کد OpenRISC برای مدل small: جدول GOT به 64k و پرش‌های فراخوانی
تابع به آفست‌های 64M محدود می‌شوند. این مدل پیش‌فرض است.
.IP \fB\-mcmodel=large\fR 4
.IX Item "-mcmodel=large"
تولید کد OpenRISC برای مدل large: جدول GOT می‌تواند تا اندازهٔ 4G رشد کند
و پرش‌های فراخوانی تابع می‌توانند کل فضای آدرس‌دهی 4G را هدف قرار دهند.
.PP
\fIگزینه‌های PDP\-11\fR
.IX Subsection "PDP-11 Options"
.PP
این گزینه‌ها برای PDP\-11 تعریف شده‌اند:
.IP \fB\-mfpu\fR 4
.IX Item "-mfpu"
استفاده از ممیز شناور سخت‌افزاری FPP. این حالت پیش‌فرض است. (ممیز شناور
FIS در PDP\-11/40 پشتیبانی نمی‌شود.) مستلزم \fB\-m45\fR است.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
عدم استفاده از ممیز شناور سخت‌افزاری.
.IP \fB\-mac0\fR 4
.IX Item "-mac0"
.PD 0
.IP \fB\-mno\-ac0\fR 4
.IX Item "-mno-ac0"
.PD
با \fB\-mac0\fR، نتایج ممیز شناور در ac0 (که در نحو اسمبلر Unix به صورت fr0 است)
بازگردانده می‌شوند. حالت پیش‌فرض، \fB\-mno\-ac0\fR، بازگرداندن نتایج ممیز شناور در حافظه است.
.IP \fB\-m40\fR 4
.IX Item "-m40"
تولید کد برای یک PDP\-11/40.
مستلزم \fB\-msoft\-float\fR و \fB\-mno\-split\fR است.
.IP \fB\-m45\fR 4
.IX Item "-m45"
تولید کد برای یک PDP\-11/45. این حالت پیش‌فرض است.
.IP \fB\-m10\fR 4
.IX Item "-m10"
تولید کد برای یک PDP\-11/10.
مستلزم \fB\-msoft\-float\fR و \fB\-mno\-split\fR است.
.IP \fB\-mint16\fR 4
.IX Item "-mint16"
.PD 0
.IP \fB\-mno\-int32\fR 4
.IX Item "-mno-int32"
.PD
استفاده از \f(CW\*(C`int\*(C'\fR ۱۶\-بیتی. این حالت پیش‌فرض است.
.IP \fB\-mint32\fR 4
.IX Item "-mint32"
.PD 0
.IP \fB\-mno\-int16\fR 4
.IX Item "-mno-int16"
.PD
استفاده از \f(CW\*(C`int\*(C'\fR ۳۲\-بیتی.
.IP \fB\-msplit\fR 4
.IX Item "-msplit"
مقصد دارای فضای دستورالعمل و دادهٔ مجزا (split) است. مستلزم \fB\-m45\fR است.
.IP \fB\-munix\-asm\fR 4
.IX Item "-munix-asm"
استفاده از نحو اسمبلر Unix.
.IP \fB\-mdec\-asm\fR 4
.IX Item "-mdec-asm"
استفاده از نحو اسمبلر DEC.
.IP \fB\-mgnu\-asm\fR 4
.IX Item "-mgnu-asm"
استفاده از نحو اسمبلر GNU. این حالت پیش‌فرض است.
.IP \fB\-mlra\fR 4
.IX Item "-mlra"
استفاده از تخصیص‌دهندهٔ جدید ثبات LRA. به‌طور پیش‌فرض، از تخصیص‌دهندهٔ
قدیمی \(lqreload\(rq استفاده می‌شود.
.PP
\fIگزینه‌های Picolibc\fR
.IX Subsection "Picolibc Options"
.PP
این گزینه‌ها همگردانی و پیوند را در زمان استفاده از Picolibc کنترل می‌کنند:
.IP \fB\-\-oslib=\fR\fIlibrary\fR 4
.IX Item "--oslib=library"
جستجوی کتابخانه‌ای به نام \fIlibrary\fR پس از کتابخانهٔ C، که امکان می‌دهد
نمادهای تعریف‌نشده توسط کتابخانهٔ C توسط این کتابخانه تعریف شوند. کتابخانهٔ
C، libgcc و این کتابخانه بین پرچم‌های \&\fB\-\-start\-group\fR و \fB\-\-end\-group\fR
قرار می‌گیرند تا هر یک بتوانند به نمادهای دیگری ارجاع دهند. برای بسیاری از مقاصد،
Picolibc گونه‌ای از \&\fBsemihost\fR ارائه می‌دهد (مشخص‌شده با \fB\-\-oslib=semihost\fR)
که کارکردهای پایه‌ای سیستم‌عامل را برای پشتیبانی از کنسول و ورودی/خروجی فایل هنگام اجرا
در یک شبیه‌ساز یا استفاده از یک اشکال‌زدای مدار-داخلی به اندازهٔ کافی فراهم می‌آورد.
.IP \fB\-\-crt0=\fR[\fBnone\fR|\fBminimal\fR|\fBhosted\fR|\fBsemihost\fR] 4
.IX Item "--crt0=[none|minimal|hosted|semihost]"
جایگزین کردن نام پیش‌فرض \fIcrt0.o\fR با \&\fIcrt0\-variant.o\fR.
گونهٔ \fBnone\fR هیچ کد راه‌اندازی‌ای ارائه نمی‌دهد و به شما اجازه می‌دهد
کد خود را فراهم کنید. \fBminimal\fR راه‌اندازی اولیهٔ حافظه را انجام می‌دهد اما
هیچ سازنده‌ای را فراخوانی نمی‌کند. هنگامی که هیچ گزینهٔ \fB\-crt0\fR مشخص نشده باشد،
کد مقداردهی اولیهٔ پیش‌فرض فراخوانی‌هایی را به همهٔ سازنده‌ها اضافه می‌کند.
\fBhosted\fR یک فراخوانی به \f(CW\*(C`exit\*(C'\fR را در زمان بازگشت از \&\f(CW\*(C`main\*(C'\fR اضافه می‌کند.
\fBsemihost\fR به یک پارامتر خط فرمانی ارائه‌شده از طریق رابط semihosting
دسترسی پیدا کرده و آن را بر اساس فاصله‌ها به آرگومان‌ها تقسیم می‌کند، و آرایهٔ حاصل از
رشته‌ها را در \f(CW\*(C`argc\*(C'\fR و \f(CW\*(C`argv\*(C'\fR به \&\f(CW\*(C`main\*(C'\fR ارسال می‌کند. در برخی از مقاصد،
از جمله AArch64، ARC، ARM، LoongArch، M680x0، RISC\-V، SH و x86،
گزینهٔ \&\fBsemihost\fR همچنین استثناهای سخت‌افزاری را به دام انداخته و اطلاعات را در
کنسول چاپ می‌کند. توجه داشته باشید که \fB\-\-crt0=semihost\fR به APIهای ارائه‌شده توسط
\fB\-\-oslib=semihost\fR وابسته است..IP \fB\-\-printf=\fR[\fBd\fR|\fBf\fR|\fBl\fR|\fBi\fR|\fBm\fR] 4
.IX Item "--printf=[d|f|l|i|m]"
گونهٔ \f(CW\*(C`printf\*(C'\fR را انتخاب می‌کند.
کتابخانهٔ Picolibc پنج گونهٔ مختلف از \f(CW\*(C`printf\*(C'\fR را ارائه می‌دهد که همگام با کاهش اندازهٔ کد، سطوح کارایی کمتری را ارائه می‌کنند. مقدار \fBd\fR سطح پیش‌فرض است که انطباق کامل با C17 و POSIX.1\-2024 را فراهم می‌کند. مقدار \fBf\fR همان مجموعه ویژگی‌ها را ارائه می‌دهد، اما به جای مقادیر \f(CW\*(C`double\*(C'\fR از مقادیر \f(CW\*(C`float\*(C'\fR که با استفاده از ماکروی \f(CW\*(C`printf_float\*(C'\fR ارسال می‌شوند پشتیبانی می‌کند. مقدار \fBl\fR تمام پشتیبانی از ممیز شناور و پارامترهای مکانی POSIX را حذف می‌کند. مقدار \fBi\fR اعداد صحیح را به مقادیری که بزرگتر از \f(CW\*(C`long\*(C'\fR نیستند محدود می‌سازد. مقدار \fBm\fR پشتیبانی از بیشتر گزینه‌های قالب‌بندی از جمله پهنا و دقت را حذف می‌کند. قالب‌ها و آرگومان‌ها همچنان به درستی تجزیه می‌شوند، اما خروجی به آن پارامترها پایبند نخواهد بود.
.IP \fB\-\-scanf=\fR[\fBd\fR|\fBf\fR|\fBl\fR|\fBi\fR|\fBm\fR] 4
.IX Item "--scanf=[d|f|l|i|m]"
گونهٔ \f(CW\*(C`scanf\*(C'\fR را انتخاب می‌کند.
کتابخانهٔ Picolibc پنج گونهٔ مختلف از \f(CW\*(C`scanf\*(C'\fR را ارائه می‌دهد که همگام با کاهش اندازهٔ کد، سطوح کارایی کمتری را ارائه می‌کنند. مقدار \fBd\fR سطح پیش‌فرض است که انطباق کامل با C17 و POSIX.1\-2024 را فراهم می‌کند. مقدار \fBf\fR پشتیبانی از مقادیر \&\f(CW\*(C`double\*(C'\fR را حذف می‌کند. مقدار \fBl\fR تمام پشتیبانی از ممیز شناور را حذف می‌کند. مقدار \fBi\fR اعداد صحیح را به مقادیری که بزرگتر از \&\f(CW\*(C`long\*(C'\fR نیستند محدود می‌سازد. مقدار \fBm\fR پشتیبانی از مشخص‌کننده‌های تبدیل \fB%[\fR را حذف می‌کند.
.PP
\fIگزینه‌های PowerPC\fR
.IX Subsection "PowerPC Options"
.PP
این موارد در زیر فهرست شده‌اند
.PP
\fIگزینه‌های PRU\fR
.IX Subsection "PRU Options"
.PP
این گزینه‌های خط فرمان برای هدف PRU تعریف شده‌اند:
.IP \fB\-minrt\fR 4
.IX Item "-minrt"
پیوند دادن با حداقل محیط زمان اجرا (runtime). این گزینه می‌تواند اندازهٔ باینری نهایی ELF را به طور چشمگیری کاهش دهد، اما برخی از ویژگی‌های استاندارد زمان اجرای C حذف می‌شوند.
.Sp
این گزینه پشتیبانی از مقداردهنده‌های اولیه و سازنده‌های ایستا (static initializers and constructors) را غیرفعال می‌کند. توجه داشته باشید که کامپایلر همچنان ممکن است کدی با مقداردهنده‌ها و سازنده‌های ایستا تولید کند. این بر عهدهٔ برنامه‌نویس است که اطمینان حاصل کند برنامهٔ مبدأ از این ویژگی‌ها استفاده نمی‌کند.
.Sp
کد راه‌اندازی حداقلی آرگومان‌های \f(CW\*(C`argc\*(C'\fR و \f(CW\*(C`argv\*(C'\fR را به تابع \f(CW\*(C`main\*(C'\fR ارسال نمی‌کند، بنابراین تابع \f(CW\*(C`main\*(C'\fR باید به صورت \f(CW\*(C`int main (void)\*(C'\fR اعلان شود. این حالت در حال حاضر در اکثر پروژه‌های سفت‌افزار (firmware) یک قاعدهٔ معمول است.
.IP \fB\-mmcu=\fR\fImcu\fR 4
.IX Item "-mmcu=mcu"
گونهٔ سخت‌افزار PRU مورد استفاده را مشخص می‌کند. یک فایل spec با نام متناظر بارگذاری می‌شود که اندازه‌های ناحیهٔ حافظه را به پیونددهنده ارسال کرده و ماکروهای C ویژهٔ سخت‌افزار را تعریف می‌کند.
.Sp
کتابخانهٔ Newlib تنها مشخصهٔ \f(CW\*(C`sim\*(C'\fR را ارائه می‌دهد که برای اجرای آزمون‌های رگرسیون با استفاده از شبیه‌ساز در نظر گرفته شده است. مشخصات (specs) سخت‌افزار واقعی را می‌توان با نصب بستهٔ GnuPruMcu (\f(CW\*(C`https://github.com/dinuxbg/gnuprumcu\*(C'\fR) به دست آورد.
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
باعث می‌شود GCC گزینهٔ خط فرمان \fB\-\-no\-relax\fR را به جای گزینهٔ \fB\-\-relax\fR به پیونددهنده ارسال کند.
.IP \fB\-mloop\fR 4
.IX Item "-mloop"
.PD 0
.IP \fB\-mno\-loop\fR 4
.IX Item "-mno-loop"
.PD
اجازه دادن (یا اجازه ندادن) به GCC برای استفاده از دستورالعمل LOOP.
.IP \fB\-mmul\fR 4
.IX Item "-mmul"
.PD 0
.IP \fB\-mno\-mul\fR 4
.IX Item "-mno-mul"
.PD
اجازه دادن (یا اجازه ندادن) به GCC برای استفاده از واحد ضرب‌کنندهٔ PRU.
.IP \fB\-mfillzero\fR 4
.IX Item "-mfillzero"
.PD 0
.IP \fB\-mno\-fillzero\fR 4
.IX Item "-mno-fillzero"
.PD
اجازه دادن (یا اجازه ندادن) به GCC برای استفاده از دستورالعمل‌های FILL و ZERO.
.IP \fB\-mabi=\fR\fIvariant\fR 4
.IX Item "-mabi=variant"
گونهٔ ABI را برای تولید کد مشخص می‌کند. گزینهٔ \fB\-mabi=ti\fR گونهٔ دست‌نخوردهٔ TI ABI را انتخاب می‌کند، در حالی که \fB\-mabi=gnu\fR گونه‌ای از GNU را انتخاب می‌کند که به شکل طبیعی‌تری با مفروضات خاص GCC سازگار است. تفاوت‌ها به شرح زیر هستند:
.RS 4
.IP "\fBاندازهٔ اشاره‌گر تابع (Function Pointer Size)\fR" 4
.IX Item "Function Pointer Size"
مقررات TI ABI مشخص می‌کند که اشاره‌گرهای تابع (کد) ۱۶ بیتی هستند، در حالی که GNU تنها از اشاره‌گرهای داده و کد ۳۲ بیتی پشتیبانی می‌کند.
.IP "\fBاشاره‌گر اختیاری مقدار بازگشتی (Optional Return Value Pointer)\fR" 4
.IX Item "Optional Return Value Pointer"
مقادیر بازگشتی تابع که بزرگتر از ۶۴ بیت هستند با استفاده از یک اشاره‌گر پنهان به عنوان نخستین آرگومان تابع ارسال می‌شوند. با این حال، TI ABI مقرر می‌دارد که اگر فراخواننده از مقدار بازگشتی استفاده نکند، این اشاره‌گر می‌تواند NULL باشد. در مقابل، GNU همواره یک اشاره‌گر معتبر برای مقدار بازگشتی ارسال کرده و انتظار آن را دارد.
.IP "\fBاندازهٔ ساختار حاوی فیلدهای بیتی (Size Of Struct Containing Bit\-fields)\fR" 4
.IX Item "Size Of Struct Containing Bit-fields"
TI ABI مقرر می‌دارد که اگر struct حاوی فیلد بیتی باشد، اندازهٔ آن با نوع فیلد بیتی تعیین شود. از سوی دیگر، GNU کمترین تعداد بایت‌هایی را که بتواند فیلد بیتی را در خود جای دهد، تخصیص می‌دهد.
.Sp
برای مثال، TI ABI برای این struct مقدار ۴ بایت رزرو می‌کند، در حالی که GNU یک بایت واحد را رزرو می‌نماید:
.Sp
.Vb 1
\&        struct S { int i:1; };
.Ve
.IP "\fBاندازهٔ دسترسی برای فیلدهای بیتی فرار (Access Size For Volatile Bit\-fields)\fR" 4
.IX Item "Access Size For Volatile Bit-fields"
TI ABI الزامی می‌کند که به فیلدهای بیتی فرار (volatile) با استفاده از نوع آن‌ها دسترسی پیدا شود. در مقابل، GNU ABI از کوچک‌ترین نوع عدد صحیحی که فیلد بیتی در آن جای گیرد استفاده می‌کند.
.Sp
برای مثال، TI ABI برای فیلد بیتی زیر نیازمند یک بارگذاری منفرد ۴ بایتی است. اما GNU یک بارگذاری ۱ بایتی تولید می‌کند:
.Sp
.Vb 1
\&        struct S { volatile int i:1; };
.Ve
.RE
.RS 4
.Sp
پیاده‌سازی کنونی \fB\-mabi=ti\fR در صورت شناسایی هر یک از ساختارهای کدی بالا، صرفاً یک خطای کامپایل صادر می‌کند. در نتیجه، کتابخانهٔ استاندارد C قابل ساخت نیست و هنگام پیوند دادن با \&\fB\-mabi=ti\fR حذف می‌شود.
.Sp
ویژگی Relaxation یک قابلیت GNU است و به دلایل ایمنی هنگام استفاده از \&\fB\-mabi=ti\fR غیرفعال می‌شود. زنجیره ابزار TI بازنشانی‌ها را برای دستورالعمل‌های QBBx منتشر نمی‌کند، بنابراین پیونددهندهٔ GNU نمی‌تواند هنگام کوتاه‌سازی شبه‌دستورالعمل‌های مجاور LDI32، آن‌ها را تنظیم کند.
.RE
.PP
\fIگزینه‌های RISC\-V\fR
.IX Subsection "RISC-V Options"
.PP
این گزینه‌های خط فرمان برای هدف‌های RISC\-V تعریف شده‌اند:
.IP \fB\-mbranch\-cost=\fR\fIn\fR 4
.IX Item "-mbranch-cost=n"
هزینهٔ انشعاب‌ها (branches) را تقریباً به اندازهٔ \fIn\fR دستورالعمل تنظیم می‌کند.
.IP \fB\-mabi=\fR\fIABI\-string\fR 4
.IX Item "-mabi=ABI-string"
قرارداد فراخوانی اعداد صحیح و ممیز شناور را مشخص می‌کند. رشتهٔ \fIABI\-string\fR شامل دو بخش است: اندازهٔ انواع عدد صحیح و ثبات‌های مورد استفاده برای انواع ممیز شناور. برای مثال \fB\-march=rv64ifd \-mabi=lp64d\fR بدین معناست که \&\fBlong\fR و اشاره‌گرها ۶۴ بیتی هستند (که به طور ضمنی \fBint\fR را ۳۲ بیتی تعریف می‌کند)، و مقادیر ممیز شناور با پهنای حداکثر ۶۴ بیت در ثبات‌های F منتقل می‌شوند. این را مقایسه کنید با \fB\-march=rv64ifd \-mabi=lp64f\fR که همچنان به کامپایلر امکان می‌دهد کدی با استفاده از افزونه‌های F و D تولید کند، اما تنها اجازه می‌دهد مقادیر ممیز شناور با طول حداکثر ۳۲ بیت در ثبات‌ها منتقل شوند؛ یا \&\fB\-march=rv64ifd \-mabi=lp64\fR که در آن هیچ آرگومان ممیز شناوری در ثبات‌ها منتقل نمی‌شود.
.Sp
مقدار پیش‌فرض برای این آرگومان وابسته به سیستم است؛ اگر قرارداد فراخوانی خاصی مد نظر دارید باید آن را به صراحت مشخص کنید. قراردادهای فراخوانی معتبر عبارتند از: \fBilp32\fR، \fBilp32f\fR، \fBilp32d\fR، \fBlp64\fR، \&\fBlp64f\fR و \fBlp64d\fR. پیاده‌سازی برخی از قراردادهای فراخوانی بر روی برخی از ISAها غیرممکن است: به عنوان مثال، \fB\-march=rv32if \-mabi=ilp32d\fR نامعتبر است چرا که این ABI الزامی می‌داند که مقادیر ۶۴ بیتی در ثبات‌های F منتقل شوند، اما ثبات‌های F تنها ۳۲ بیت پهنا دارند. همچنین ABI نوع \fBilp32e\fR وجود دارد که تنها با معماری \fBrv32e\fR قابل استفاده است و ABI نوع \fBlp64e\fR که تنها با \fBrv64e\fR قابل استفاده می‌باشد. این ABIها در حال حاضر به خوبی مشخص نشده‌اند و ممکن است دستخوش تغییر شوند.
.IP \fB\-mfdiv\fR 4
.IX Item "-mfdiv"
.PD 0
.IP \fB\-mno\-fdiv\fR 4
.IX Item "-mno-fdiv"
.PD
استفاده کردن یا نکردن از دستورالعمل‌های سخت‌افزاری تقسیم و جذر (ریشه دوم) ممیز شناور. این گزینه نیازمند افزونه‌های F یا D برای ثبات‌های ممیز شناور است. در صورتی که معماری مشخص‌شده دارای این دستورالعمل‌ها باشد، حالت پیش‌فرض استفاده از آن‌ها است.
.IP \fB\-mfence\-tso\fR 4
.IX Item "-mfence-tso"
.PD 0
.IP \fB\-mno\-fence\-tso\fR 4
.IX Item "-mno-fence-tso".PD
استفاده کردن یا نکردن از دستورالعمل \fBfence.tso\fR، که روی برخی پردازنده‌ها (از جمله پردازنده‌های ساخت T\-Head) پیاده‌سازی نشده است. اگر دستورالعمل \fBfence.tso\fR در دسترس نباشد، در عوض از یک fence قوی‌تر استفاده می‌شود.
.IP \fB\-mdiv\fR 4
.IX Item "-mdiv"
.PD 0
.IP \fB\-mno\-div\fR 4
.IX Item "-mno-div"
.PD
استفاده کردن یا نکردن از دستورالعمل‌های سخت‌افزاری برای تقسیم اعداد صحیح. این کار به افزونهٔ M نیاز دارد. حالت پیش‌فرض در صورتی که معماری مشخص‌شده دارای این دستورالعمل‌ها باشد، استفاده از آن‌هاست.
.IP \fB\-misa\-spec=\fR\fIISA\-spec\-string\fR 4
.IX Item "-misa-spec=ISA-spec-string"
تعیین نسخه‌ای از مشخصات ISA بدون امتیاز (سابقاً سطح کاربر یا User\-Level) برای RISC\-V که کد تولیدشده باید با آن سازگار باشد. مقادیر ممکن برای \fIISA\-spec\-string\fR عبارتند از:
.RS 4
.ie n .IP 2.2 4
.el .IP \f(CW2.2\fR 4
.IX Item "2.2"
تولید کد منطبق با نسخهٔ 2.2.
.ie n .IP 20190608 4
.el .IP \f(CW20190608\fR 4
.IX Item "20190608"
تولید کد منطبق با نسخهٔ 20190608.
.ie n .IP 20191213 4
.el .IP \f(CW20191213\fR 4
.IX Item "20191213"
تولید کد منطبق با نسخهٔ 20191213.
.RE
.RS 4
.Sp
پیش‌فرض \fB\-misa\-spec=20191213\fR است مگر اینکه GCC با گزینهٔ \fB\-\-with\-isa\-spec=\fR برای تعیین یک نسخهٔ پیش‌فرض متفاوت پیکربندی شده باشد.
.RE
.IP \fB\-march=\fR[\fIISA\fR|\fIProfile\fR|\fIProfile_ISA\fR|\fIprocessor\-string\fR] 4
.IX Item "-march=[ISA|Profile|Profile_ISA|processor-string]"
تولید کد برای ISA یا پروفایل مشخص‌شدهٔ RISC\-V یا ترکیبی از آن‌ها
(مانند \fBrv64im\fR، \fBrvi20u64\fR یا \fBrvi20u64_zbb\fR). نام‌های
ISAها و پروفایل‌ها باید با حروف کوچک باشند.
نمونه‌ها شامل \fBrv64i\fR، \fBrv32g\fR،
\&\fBrv32e\fR، \fBrv32imaf\fR، \fBrva22u64\fR و \fBrva23u64\fR هستند.
برای ترکیب یک پروفایل نام‌گذاری‌شده با افزونه‌های اختیاری RISC\-V ISA،
ابتدا پروفایل را ذکر کنید و سپس نام افزونه(ها) را با استفاده از یک
زیرخط (underscore) به‌عنوان جداکننده به آن الحاق کنید (مانند
\&\fBrvi20u64_zca_zcb\fR و \fBrva23u64_zacas\fR). علاوه بر این، مقدار ویژهٔ
\&\fBhelp\fR (\fB\-march=help\fR) برای فهرست کردن تمام افزونه‌های پشتیبانی‌شده
پذیرفته می‌شود.
.Sp
گزینهٔ \&\fB\-march=unset\fR باعث می‌شود کامپایلر تمام گزینه‌های
\&\fB\-march=...\fR را که پیش‌تر در خط فرمان آمده‌اند نادیده بگیرد،
و به‌گونه‌ای عمل کند که گویی این گزینه هرگز داده نشده است. این مورد برای
اطمینان از اینکه معماری از گزینهٔ \&\fB\-mcpu\fR گرفته شود مفید است، و در
صورتی که هنگام استفاده از \fB\-march=unset\fR هیچ گزینهٔ \fB\-mcpu\fR مشخص نشده باشد،
خطایی رخ خواهد داد.
.Sp
قواعد نحوی رشتهٔ ISA به شرح زیر تعریف می‌شود:
.RS 4
.IP * 4
رشته باید با \fBrv32\fR یا \fBrv64\fR آغاز شود، و پس از آن
\&\fBi\fR، \fBe\fR یا \fBg\fR بیاید، که به آن ISA پایه گفته می‌شود.
.IP * 4
بخش بعدی رشته، فهرستی از نام‌های افزونه است. نام‌های افزونه
می‌توانند به چندحرفی (مانند \fBzba\fR) و تک‌حرفی (مانند \fBv\fR)
دسته‌بندی شوند. افزونه‌های تک‌حرفی می‌توانند به‌صورت پیاپی بیایند،
اما افزونه‌های چندحرفی باید با زیرخط از یکدیگر جدا شوند.
.IP * 4
زیرخط می‌تواند در هر کجای پس از ISA پایه قرار بگیرد. این کار تأثیر خاصی
ندارد اما برای بهبود خوانایی استفاده می‌شود و می‌تواند به‌عنوان جداکننده عمل کند.
.IP * 4
نام‌های افزونه ممکن است شامل یک شماره نسخهٔ اختیاری باشند، که از نحو
\fB<major>p<minor>\fR یا \fB<major>\fR پیروی می‌کند (برای نمونه \fBm2p1\fR یا
\&\fBm2\fR).
.RE
.RS 4
.Sp
افزونه‌های پشتیبانی‌شده در زیر فهرست شده‌اند:
.IP "\fIنام افزونه\fR : \fIنسخهٔ پشتیبانی‌شده\fR : \fIتوضیحات\fR" 4
.IX Item "Extension Name : Supported Version : Description"
.PD 0
.IP \fBg\fR 4
.IX Item "g"
.PD
\&\f(CW@tab\fR \-
\&\f(CW@tab\fR افزونهٔ پایهٔ محاسبات همه‌منظوره؛ \fBg\fR به
\&\fBi\fR، \fBm\fR، \fBa\fR، \fBf\fR، \fBd\fR، \fBzicsr\fR و
\&\fBzifencei\fR بسط می‌یابد.
.IP \fBe\fR 4
.IX Item "e"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ پایهٔ عدد صحیح کاهش‌یافته
.IP \fBi\fR 4
.IX Item "i"
\&\f(CW@tab\fR 2.0 2.1
\&\f(CW@tab\fR افزونهٔ پایهٔ عدد صحیح
.IP \fBm\fR 4
.IX Item "m"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ ضرب و تقسیم عدد صحیح
.IP \fBa\fR 4
.IX Item "a"
\&\f(CW@tab\fR 2.0 2.1
\&\f(CW@tab\fR افزونهٔ اتمیک (Atomic)
.IP \fBf\fR 4
.IX Item "f"
\&\f(CW@tab\fR 2.0 2.2
\&\f(CW@tab\fR افزونهٔ ممیز شناور با دقت یگانه (Single\-precision)
.IP \fBd\fR 4
.IX Item "d"
\&\f(CW@tab\fR 2.0 2.2
\&\f(CW@tab\fR افزونهٔ ممیز شناور با دقت دوگانه (Double\-precision)
.IP \fBc\fR 4
.IX Item "c"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ فشرده (Compressed)
.IP \fBb\fR 4
.IX Item "b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ استاندارد برای توابع دستکاری بیت
.IP \fBv\fR 4
.IX Item "v"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ برداری (Vector)
.IP \fBh\fR 4
.IX Item "h"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ هایپروایزر (Hypervisor)
.IP \fBzic64b\fR 4
.IX Item "zic64b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR اندازهٔ بلوک حافظهٔ نهان (Cache) برابر با ۶۴ بایت است
.IP \fBzicbom\fR 4
.IX Item "zicbom"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ مدیریت بلوک حافظهٔ نهان
.IP \fBzicbop\fR 4
.IX Item "zicbop"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ پیش‌واکشی (Prefetch) بلوک حافظهٔ نهان
.IP \fBzicboz\fR 4
.IX Item "zicboz"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ صفر کردن بلوک حافظهٔ نهان
.IP \fBziccamoa\fR 4
.IX Item "ziccamoa"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR حافظهٔ اصلی از تمام عملیات اتمیک در A پشتیبانی می‌کند
.IP \fBziccif\fR 4
.IX Item "ziccif"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR حافظهٔ اصلی از واکشی دستورالعمل با الزام اتمیک بودن پشتیبانی می‌کند
.IP \fBzicclsm\fR 4
.IX Item "zicclsm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR حافظهٔ اصلی از بارگذاری‌ها/ذخیره‌سازی‌های ناهم‌تراز پشتیبانی می‌کند
.IP \fBziccrse\fR 4
.IX Item "ziccrse"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR حافظهٔ اصلی از پیشروی متوالی در دنباله‌های LR/SC پشتیبانی می‌کند
.IP \fBzicfilp\fR 4
.IX Item "zicfilp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ پد فرود (Landing pad) یکپارچگی جریان کنترل
.IP \fBzicfiss\fR 4
.IX Item "zicfiss"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ پشتهٔ سایه (Shadow stack) یکپارچگی جریان کنترل
.IP \fBzicntr\fR 4
.IX Item "zicntr"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ استاندارد برای شمارنده‌ها و زمان‌سنج‌های پایه
.IP \fBzicond\fR 4
.IX Item "zicond"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات شرطی عدد صحیح
.IP \fBzicsr\fR 4
.IX Item "zicsr"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ دسترسی به ثبات کنترل و وضعیت (CSR).IP \fBzifencei\fR 4
.IX Item "zifencei"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ حصار واکشی دستورالعمل
.IP \fBzihintntl\fR 4
.IX Item "zihintntl"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ رهنمودهای مکان‌مندی غیرزمانی
.IP \fBzihintpause\fR 4
.IX Item "zihintpause"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ رهنمود مکث
.IP \fBzihpm\fR 4
.IX Item "zihpm"
\&\f(CW@tab\fR 2.0
\&\f(CW@tab\fR افزونهٔ استاندارد برای شمارنده‌های عملکرد سخت‌افزاری
.IP \fBzimop\fR 4
.IX Item "zimop"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات‌های ممکن (May\-be\-operations)
.IP \fBzilsd\fR 4
.IX Item "zilsd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل‌های جفت بارگذاری/ذخیره
.IP \fBzmmul\fR 4
.IX Item "zmmul"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ضرب اعداد صحیح
.IP \fBza128rs\fR 4
.IX Item "za128rs"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR اندازهٔ ۱۲۸ بایتی مجموعهٔ رزرو
.IP \fBza64rs\fR 4
.IX Item "za64rs"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR اندازهٔ ۶۴ بایتی مجموعهٔ رزرو
.IP \fBzaamo\fR 4
.IX Item "zaamo"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات‌های حافظهٔ اتمی
.IP \fBzabha\fR 4
.IX Item "zabha"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات‌های حافظهٔ اتمی بایت و نیم‌کلمه
.IP \fBzacas\fR 4
.IX Item "zacas"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل‌های مقایسه و جابه‌جایی اتمی (CAS)
.IP \fBzalrsc\fR 4
.IX Item "zalrsc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR زیرمجموعهٔ بارگذاری\-رزرو/ذخیرهٔ\-مشروط از افزونهٔ A
.IP \fBzawrs\fR 4
.IX Item "zawrs"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ انتظار روی مجموعهٔ رزرو
.IP \fBzama16b\fR 4
.IX Item "zama16b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR بارگذاری‌ها، ذخیره‌ها و AMOهای ناترازی که کاملاً درون یک مرز ۱۶ بایتی با تراز طبیعی قرار دارند، اتمی هستند
.IP \fBzfa\fR 4
.IX Item "zfa"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ممیز شناور تکمیلی
.IP \fBzfbfmin\fR 4
.IX Item "zfbfmin"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ حداقل پشتیبانی از BF16
.IP \fBzfh\fR 4
.IX Item "zfh"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ممیز شناور با دقت نیمه
.IP \fBzfhmin\fR 4
.IX Item "zfhmin"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ حداقل ممیز شناور با دقت نیمه
.IP \fBzfinx\fR 4
.IX Item "zfinx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ممیز شناور با دقت یگانه در ثبات‌های عدد صحیح
.IP \fBzdinx\fR 4
.IX Item "zdinx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ممیز شناور با دقت دوگانه در ثبات‌های عدد صحیح
.IP \fBzca\fR 4
.IX Item "zca"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل‌های فشردهٔ عدد صحیح
.IP \fBzcb\fR 4
.IX Item "zcb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل‌های فشردهٔ ساده
.IP \fBzcd\fR 4
.IX Item "zcd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ بارگذاری‌ها و ذخیره‌های ممیز شناور فشرده با دقت دوگانه
.IP \fBzce\fR 4
.IX Item "zce"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های دستورالعمل فشرده برای پردازنده‌های تعبیه‌شده
.IP \fBzcf\fR 4
.IX Item "zcf"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ بارگذاری‌ها و ذخیره‌های ممیز شناور فشرده با دقت یگانه
.IP \fBzcmop\fR 4
.IX Item "zcmop"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات‌های ممکن فشرده
.IP \fBzcmp\fR 4
.IX Item "zcmp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ فشردهٔ Push/Pop
.IP \fBzcmt\fR 4
.IX Item "zcmt"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل پرش جدولی
.IP \fBzclsd\fR 4
.IX Item "zclsd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستورالعمل‌های جفت بارگذاری/ذخیرهٔ فشرده
.IP \fBzba\fR 4
.IX Item "zba"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ محاسبهٔ آدرس
.IP \fBzbb\fR 4
.IX Item "zbb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستکاری بیتی پایه‌ای
.IP \fBzbc\fR 4
.IX Item "zbc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ضرب بدون رقم نقلی
.IP \fBzbkb\fR 4
.IX Item "zbkb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ دستکاری بیتی رمزنگاری
.IP \fBzbkc\fR 4
.IX Item "zbkc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ ضرب بدون رقم نقلی رمزنگاری
.IP \fBzbkx\fR 4
.IX Item "zbkx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ جایگشت ماتریس کلیدی (Crossbar) رمزنگاری
.IP \fBzbs\fR 4
.IX Item "zbs"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ عملیات تک‌بیتی
.IP \fBzk\fR 4
.IX Item "zk"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ استاندارد رمزنگاری اسکالر
.IP \fBzkn\fR 4
.IX Item "zkn"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ مجموعه الگوریتم‌های NIST
.IP \fBzknd\fR 4
.IX Item "zknd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ رمزگشایی AES
.IP \fBzkne\fR 4
.IX Item "zkne"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ رمزنگاری AES
.IP \fBzknh\fR 4
.IX Item "zknh"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ تابع درهم‌سازی
.IP \fBzkr\fR 4
.IX Item "zkr"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ منبع آنتروپی
.IP \fBzks\fR 4
.IX Item "zks"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ مجموعه الگوریتم‌های ShangMi
.IP \fBzksed\fR 4
.IX Item "zksed"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونهٔ رمز قالبی SM4.IP \fBzksh\fR 4
.IX Item "zksh"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه تابع درهم‌ساز SM3
.IP \fBzkt\fR 4
.IX Item "zkt"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه تاخیر اجرای مستقل از داده
.IP \fBztso\fR 4
.IX Item "ztso"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ترتیب‌بندی کامل ذخیره‌سازی
.IP \fBzvbb\fR 4
.IX Item "zvbb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری دستکاری بیتی پایه‌ای
.IP \fBzvbc\fR 4
.IX Item "zvbc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری ضرب بدون رقم نقلی
.IP \fBzve32f\fR 4
.IX Item "zve32f"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های برداری برای پردازنده‌های تعبیه‌شده
.IP \fBzve32x\fR 4
.IX Item "zve32x"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های برداری برای پردازنده‌های تعبیه‌شده
.IP \fBzve64d\fR 4
.IX Item "zve64d"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های برداری برای پردازنده‌های تعبیه‌شده
.IP \fBzve64f\fR 4
.IX Item "zve64f"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های برداری برای پردازنده‌های تعبیه‌شده
.IP \fBzve64x\fR 4
.IX Item "zve64x"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های برداری برای پردازنده‌های تعبیه‌شده
.IP \fBzvfbfmin\fR 4
.IX Item "zvfbfmin"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری تبدیل‌های BF16
.IP \fBzvfbfwma\fR 4
.IX Item "zvfbfwma"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری ضرب/جمع عریض‌کننده BF16
.IP \fBzvfh\fR 4
.IX Item "zvfh"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری ممیز شناور نیم‌دقت
.IP \fBzvfhmin\fR 4
.IX Item "zvfhmin"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری کمینه ممیز شناور نیم‌دقت
.IP \fBzvkb\fR 4
.IX Item "zvkb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری دستکاری بیتی رمزنگاری
.IP \fBzvkg\fR 4
.IX Item "zvkg"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری GCM/GMAC
.IP \fBzvkn\fR 4
.IX Item "zvkn"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های NIST، \fBzvkn\fR بسط می‌یابد به
.IP \fBzvknc\fR 4
.IX Item "zvknc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های NIST به همراه ضرب بدون رقم نقلی، \fBzvknc\fR
.IP \fBzvkned\fR 4
.IX Item "zvkned"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری رمز قالبی AES
.IP \fBzvkng\fR 4
.IX Item "zvkng"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های NIST به همراه GCM، \fBzvkng\fR بسط می‌یابد
.IP \fBzvknha\fR 4
.IX Item "zvknha"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری درهم‌ساز امن SHA\-2
.IP \fBzvknhb\fR 4
.IX Item "zvknhb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری درهم‌ساز امن SHA\-2
.IP \fBzvks\fR 4
.IX Item "zvks"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های ShangMi، \fBzvks\fR بسط می‌یابد
.IP \fBzvksc\fR 4
.IX Item "zvksc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های ShangMi به همراه ضرب بدون رقم نقلی،
.IP \fBzvksed\fR 4
.IX Item "zvksed"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری رمز قالبی SM4
.IP \fBzvksg\fR 4
.IX Item "zvksg"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری مجموعه الگوریتم‌های ShangMi به همراه GCM
.IP \fBzvksh\fR 4
.IX Item "zvksh"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری درهم‌ساز امن SM3
.IP \fBzvkt\fR 4
.IX Item "zvkt"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری تاخیر اجرای مستقل از داده
.IP \fBzvl1024b\fR 4
.IX Item "zvl1024b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl128b\fR 4
.IX Item "zvl128b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl16384b\fR 4
.IX Item "zvl16384b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه استاندارد کمینه طول بردار
.IP \fBzvl2048b\fR 4
.IX Item "zvl2048b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl256b\fR 4
.IX Item "zvl256b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl32768b\fR 4
.IX Item "zvl32768b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه استاندارد کمینه طول بردار
.IP \fBzvl32b\fR 4
.IX Item "zvl32b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl4096b\fR 4
.IX Item "zvl4096b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl512b\fR 4
.IX Item "zvl512b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl64b\fR 4
.IX Item "zvl64b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های استاندارد کمینه طول بردار
.IP \fBzvl65536b\fR 4
.IX Item "zvl65536b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه استاندارد کمینه طول بردار
.IP \fBzvl8192b\fR 4
.IX Item "zvl8192b"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه استاندارد کمینه طول بردار
.IP \fBzhinx\fR 4
.IX Item "zhinx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ممیز شناور نیم‌دقت در ثبات‌های عدد صحیح
.IP \fBzhinxmin\fR 4
.IX Item "zhinxmin"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه کمینه ممیز شناور نیم‌دقت در ثبات‌های عدد صحیح
.IP \fBsdtrig\fR 4
.IX Item "sdtrig"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه محرک‌های اشکال‌زدایی
.IP \fBsha\fR 4
.IX Item "sha"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه تقویت‌شده هایپروایزر
.IP \fBshcounterenw\fR 4
.IX Item "shcounterenw"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR پشتیبانی از فعال‌سازهای قابل نوشتن برای هر شمارنده پشتیبانی‌شده.IP \fBshgatpa\fR 4
.IX Item "shgatpa"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR پشتیبانی از حالت SvNNx4 برای تمام حالت‌های پشتیبانی‌شده توسط satp
.IP \fBshlcofideleg\fR 4
.IX Item "shlcofideleg"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR تفویض وقفه‌های LCOFI به VS\-mode
.IP \fBshtvala\fR 4
.IX Item "shtvala"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات htval تمامی مقادیر مورد نیاز را فراهم می‌کند
.IP \fBshvstvala\fR 4
.IX Item "shvstvala"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات vstval تمامی مقادیر مورد نیاز را فراهم می‌کند
.IP \fBshvstvecd\fR 4
.IX Item "shvstvecd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات vstvec از حالت مستقیم پشتیبانی می‌کند
.IP \fBshvsatpa\fR 4
.IX Item "shvsatpa"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات vsatp از تمام حالت‌های پشتیبانی‌شده توسط satp پشتیبانی می‌کند
.IP \fBsmaia\fR 4
.IX Item "smaia"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه معماری پیشرفته وقفه
.IP \fBsmcntrpmf\fR 4
.IX Item "smcntrpmf"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR فیلتر کردن حالت سطح دسترسی cycle و instret
.IP \fBsmcsrind\fR 4
.IX Item "smcsrind"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR دسترسی غیرمستقیم به CSR در سطح Machine
.IP \fBsmepmp\fR 4
.IX Item "smepmp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR بهبودهای PMP برای دسترسی به حافظه و جلوگیری از اجرا در حالت Machine
.IP \fBsmmpm\fR 4
.IX Item "smmpm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ماسک‌گذاری اشاره‌گر در حالت سرپرست
.IP \fBsmnpm\fR 4
.IX Item "smnpm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ماسک‌گذاری اشاره‌گر در حالت سرپرست
.IP \fBsmrnmi\fR 4
.IX Item "smrnmi"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR وقفه‌های غیرقابل‌ماسک با قابلیت ازسرگیری
.IP \fBsmstateen\fR 4
.IX Item "smstateen"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه فعال‌سازی وضعیت
.IP \fBsmdbltrp\fR 4
.IX Item "smdbltrp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های به دام انداختن دوگانه (double trap)
.IP \fBssaia\fR 4
.IX Item "ssaia"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه معماری پیشرفته وقفه برای حالت سرپرست
.IP \fBssccptr\fR 4
.IX Item "ssccptr"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR پشتیبانی حافظه اصلی از خواندن جدول صفحه
.IP \fBsscofpmf\fR 4
.IX Item "sscofpmf"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه سرریز شمارنده و فیلترگذاری
.IP \fBsscounterenw\fR 4
.IX Item "sscounterenw"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR پشتیبانی از فعال‌سازهای قابل نوشتن برای هر شمارنده پشتیبانی‌شده
.IP \fBsscsrind\fR 4
.IX Item "sscsrind"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR دسترسی غیرمستقیم به CSR در حالت سرپرست
.IP \fBssnpm\fR 4
.IX Item "ssnpm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ماسک‌گذاری اشاره‌گر در حالت سرپرست
.IP \fBsspm\fR 4
.IX Item "sspm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ماسک‌گذاری اشاره‌گر در حالت سرپرست
.IP \fBssstateen\fR 4
.IX Item "ssstateen"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه فعال‌سازی وضعیت در حالت سرپرست
.IP \fBsstc\fR 4
.IX Item "sstc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه وقفه‌های زمان‌سنج در حالت سرپرست
.IP \fBsstvala\fR 4
.IX Item "sstvala"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات stval تمامی مقادیر مورد نیاز را فراهم می‌کند
.IP \fBsstvecd\fR 4
.IX Item "sstvecd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ثبات stvec از حالت مستقیم پشتیبانی می‌کند
.IP \fBssstrict\fR 4
.IX Item "ssstrict"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR کدگذاری‌های رزروشدهٔ پیاده‌سازی‌نشده استثنای دستور غیرمجاز صادر می‌کنند و هیچ افزونه ناسازگاری وجود ندارد
.IP \fBssdbltrp\fR 4
.IX Item "ssdbltrp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه‌های به دام انداختن دوگانه (double trap)
.IP \fBssu64xl\fR 4
.IX Item "ssu64xl"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR پشتیبانی از UXLEN=64 الزامی است
.IP \fBsupm\fR 4
.IX Item "supm"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ماسک‌گذاری اشاره‌گر در حالت کاربر
.IP \fBsvinval\fR 4
.IX Item "svinval"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه باطل‌سازی دقیق کَش ترجمه نشانی
.IP \fBsvnapot\fR 4
.IX Item "svnapot"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه پیوستگی ترجمه NAPOT
.IP \fBsvpbmt\fR 4
.IX Item "svpbmt"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه انواع حافظه مبتنی بر صفحه
.IP \fBsvvptc\fR 4
.IX Item "svvptc"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه بی‌نیازکننده از دستورهای مدیریت حافظه پس از علامت‌گذاری PTEها به عنوان معتبر
.IP \fBsvadu\fR 4
.IX Item "svadu"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه به‌روزرسانی سخت‌افزاری بیت‌های A/D
.IP \fBsvade\fR 4
.IX Item "svade"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR ایجاد استثنا هنگامی که به‌روزرسانی سخت‌افزاری بیت‌های A/D غیرفعال است
.IP \fBsvbare\fR 4
.IX Item "svbare"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR حالت bare در satp پشتیبانی می‌شود
.IP \fBxcvalu\fR 4
.IX Item "xcvalu"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه متفرقه ALU برای Core\-V
.IP \fBxcvbi\fR 4
.IX Item "xcvbi"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه انشعاب بی‌واسطه برای Core\-V
.IP \fBxcvelw\fR 4
.IX Item "xcvelw"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه بارگذاری کلمه رویداد در Core\-V
.IP \fBxcvmac\fR 4
.IX Item "xcvmac"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ضرب\-انباشت برای Core\-V
.IP \fBxcvsimd\fR 4
.IX Item "xcvsimd"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه SIMD برای Core\-V
.IP \fBxsfcease\fR 4
.IX Item "xsfcease"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه دستور CEASE برای SiFive
.IP \fBxsfvcp\fR 4
.IX Item "xsfvcp"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه کمک‌پردازنده برداری VCIX برای SiFive
.IP \fBxsfvfnrclipxfqf\fR 4
.IX Item "xsfvfnrclipxfqf"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR دستورهای برش محدوده‌ای FP32 به int8 در SiFive.IP \fBxsfvqmaccdod\fR 4
.IX Item "xsfvqmaccdod"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ضرب ماتریسی int8 شرکت SiFive
.IP \fBxsfvqmaccqoq\fR 4
.IX Item "xsfvqmaccqoq"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ضرب ماتریسی int8 شرکت SiFive
.IP \fBxtheadba\fR 4
.IX Item "xtheadba"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه محاسبه آدرس T\-head
.IP \fBxtheadbb\fR 4
.IX Item "xtheadbb"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه دستکاری بیتی پایه T\-head
.IP \fBxtheadbs\fR 4
.IX Item "xtheadbs"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه دستورالعمل‌های تک‌بیتی T\-head
.IP \fBxtheadcmo\fR 4
.IX Item "xtheadcmo"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه عملیات مدیریت حافظه نهان T\-head
.IP \fBxtheadcondmov\fR 4
.IX Item "xtheadcondmov"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه انتقال شرطی T\-head
.IP \fBxtheadfmemidx\fR 4
.IX Item "xtheadfmemidx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه عملیات حافظه نمایه‌شده برای ثبات‌های ممیز شناور T\-head
.IP \fBxtheadfmv\fR 4
.IX Item "xtheadfmv"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه انتقال داده‌های بیت‌های بالای ممیز شناور با دقت مضاعف T\-head
.IP \fBxtheadint\fR 4
.IX Item "xtheadint"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه شتاب‌دهی وقفه T\-head
.IP \fBxtheadmac\fR 4
.IX Item "xtheadmac"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ضرب\-انباشت (MAC) شرکت T\-head
.IP \fBxtheadmemidx\fR 4
.IX Item "xtheadmemidx"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه عملیات حافظه نمایه‌شده T\-head
.IP \fBxtheadmempair\fR 4
.IX Item "xtheadmempair"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه عملیات حافظه با دو GPR شرکت T\-head
.IP \fBxtheadsync\fR 4
.IX Item "xtheadsync"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه همگام‌سازی چند‌هسته‌ای T\-head
.IP \fBxtheadvector\fR 4
.IX Item "xtheadvector"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه برداری T\-head
.IP \fBxventanacondops\fR 4
.IX Item "xventanacondops"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه عملیات شرطی عدد صحیح Ventana
.IP \fBxmipscmov\fR 4
.IX Item "xmipscmov"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه انتقال شرطی Mips
.IP \fBxmipscbop\fR 4
.IX Item "xmipscbop"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه پیش‌واکشی (prefetch) شرکت Mips
.IP \fBxandesperf\fR 4
.IX Item "xandesperf"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه کارایی Andes
.IP \fBxandesbfhcvt\fR 4
.IX Item "xandesbfhcvt"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه تبدیل bfloat16 شرکت Andes
.IP \fBxandesvbfhcvt\fR 4
.IX Item "xandesvbfhcvt"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه برداری تبدیل bfloat16 شرکت Andes
.IP \fBxandesvsintload\fR 4
.IX Item "xandesvsintload"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه بارگذاری برداری INT4 شرکت Andes
.IP \fBxandesvpackfph\fR 4
.IX Item "xandesvpackfph"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه برداری بسته‌بندی‌شده FP16 شرکت Andes
.IP \fBxandesvdot\fR 4
.IX Item "xandesvdot"
\&\f(CW@tab\fR 5.0
\&\f(CW@tab\fR افزونه ضرب داخلی برداری Andes
.IP \fBxsmtvdot\fR 4
.IX Item "xsmtvdot"
\&\f(CW@tab\fR 1.0
\&\f(CW@tab\fR افزونه ضرب داخلی برداری SpacemiT
.RE
.RS 4
.Sp
هنگامی که \fB\-march=\fR مشخص نشده باشد، GCC از تنظیمات
\&\fB\-mcpu\fR استفاده می‌کند.
.Sp
اگر هیچ‌یک از گزینه‌های \fB\-march\fR و \fB\-mcpu=\fR مشخص نشده باشند، مقدار پیش‌فرض این
آرگومان وابسته به سیستم است؛ اگر خواهان یک افزونه معماری خاص هستید،
باید آن را به‌طور صریح مشخص کنید.
.Sp
هنگامی که مشخصات RISC\-V افزونه‌ای را وابسته به افزونه‌های دیگر تعریف می‌کند،
در صورتی که آن افزونه‌های وابسته به‌طور صریح اضافه نشده باشند، GCC آن‌ها را
به‌طور ضمنی به مجموعه افزونه‌های فعال اضافه می‌کند.
.Sp
\&\fBنام هسته (Core Name)\fR
.RE
.IP \fB\-mcpu=\fR\fIprocessor\-string\fR 4
.IX Item "-mcpu=processor-string"
از معماری پردازنده ارائه‌شده استفاده کرده و خروجی را برای آن، که با نام پردازنده
خاصی تعیین می‌شود، بهینه‌سازی می‌کند. مقادیر مجاز برای این گزینه عبارتند از:
.Sp
\&\fBsifive\-e20\fR,
.Sp
\&\fBsifive\-e21\fR,
.Sp
\&\fBsifive\-e24\fR,
.Sp
\&\fBsifive\-e31\fR,
.Sp
\&\fBsifive\-e34\fR,
.Sp
\&\fBsifive\-e76\fR,
.Sp
\&\fBsifive\-s21\fR,
.Sp
\&\fBsifive\-s51\fR,
.Sp
\&\fBsifive\-s54\fR,
.Sp
\&\fBsifive\-s76\fR,
.Sp
\&\fBsifive\-u54\fR,
.Sp
\&\fBsifive\-u74\fR,
.Sp
\&\fBsifive\-x280\fR,
.Sp
\&\fBsifive\-p450\fR,
.Sp
\&\fBsifive\-p670\fR,
.Sp
\&\fBthead\-c906\fR,
.Sp
\&\fBxt\-c908\fR,
.Sp
\&\fBxt\-c908v\fR,
.Sp
\&\fBxt\-c910\fR,
.Sp
\&\fBxt\-c910v2\fR,
.Sp
\&\fBxt\-c920\fR,
.Sp
\&\fBxt\-c920v2\fR,
.Sp
\&\fBtt\-ascalon\-x\fR,
.Sp
\&\fBtt\-ascalon\-d8\fR,
.Sp
\&\fBxiangshan\-nanhu\fR,
.Sp
\&\fBxiangshan\-kunminghu\fR,
.Sp
\&\fBmips\-p8700\fR,
.Sp
\&\fBandes\-n22\fR,
.Sp
\&\fBandes\-n25\fR,
.Sp
\&\fBandes\-a25\fR,
.Sp
\&\fBandes\-nx25\fR,
.Sp
\&\fBandes\-ax25\fR,
.Sp
\&\fBandes\-a27\fR,
.Sp
\&\fBandes\-ax27\fR,
.Sp
\&\fBandes\-n225\fR,
.Sp
\&\fBandes\-d23\fR,
.Sp
\&\fBandes\-n45\fR,
.Sp
\&\fBandes\-nx45\fR,
.Sp
\&\fBandes\-a45\fR,
.Sp
\&\fBandes\-ax45\fR,
.Sp
\&\fBspacemit\-x60\fR.
.Sp
توجه داشته باشید که \fB\-mcpu\fR اولویتی بر \fB\-march\fR یا \fB\-mtune\fR ندارد و آن‌ها را لغو نمی‌کند.
.Sp
\&\fBنام تنظیم (Tune Name)\fR.IP \fB\-mtune=\fR\fIprocessor\-string\fR 4
.IX Item "-mtune=processor-string"
خروجی را برای پردازندهٔ داده‌شده بهینه‌سازی می‌کند، که توسط ریزمعماری یا
نام یک پردازنده (CPU) مشخص تعیین می‌شود. مقادیر مجاز برای این گزینه عبارتند از:
.Sp
\&\fBgeneric\fR,
.Sp
\&\fBrocket\fR,
.Sp
\&\fBsifive\-3\-series\fR,
.Sp
\&\fBsifive\-5\-series\fR,
.Sp
\&\fBsifive\-7\-series\fR,
.Sp
\&\fBsifive\-p400\-series\fR,
.Sp
\&\fBsifive\-p600\-series\fR,
.Sp
\&\fBtt\-ascalon\-x\fR,
.Sp
\&\fBtt\-ascalon\-d8\fR,
.Sp
\&\fBthead\-c906\fR,
.Sp
\&\fBxt\-c908\fR,
.Sp
\&\fBxt\-c908v\fR,
.Sp
\&\fBxt\-c910\fR,
.Sp
\&\fBxt\-c910v2\fR,
.Sp
\&\fBxt\-c920\fR,
.Sp
\&\fBxt\-c920v2\fR,
.Sp
\&\fBxiangshan\-nanhu\fR,
.Sp
\&\fBxiangshan\-kunminghu\fR,
.Sp
\&\fBspacemit\-x60\fR,
.Sp
\&\fBgeneric\-ooo\fR,
.Sp
\&\fBsize\fR,
.Sp
\&\fBmips\-p8700\fR,
.Sp
\&\fBandes\-25\-series\fR,
.Sp
\&\fBandes\-23\-series\fR,
.Sp
\&\fBandes\-45\-series\fR,
.Sp
و تمام گزینه‌های معتبر برای \fB\-mcpu=\fR.
.Sp
هنگامی که \fB\-mtune=\fR مشخص نشده باشد، GCC از تنظیمات مربوط به
\&\fB\-mcpu\fR استفاده می‌کند. اگر هیچ‌کدام مشخص نشده باشند، پیش‌فرض \fBgeneric\fR است.
.Sp
گزینهٔ \fBsize\fR برای استفاده توسط کاربران نهایی در نظر گرفته نشده است. این گزینه
زمانی که \fB\-Os\fR مشخص شده باشد استفاده می‌شود. این مقدار اطلاعات هزینهٔ دستورالعمل‌های
ارائه‌شده توسط \fB\-mtune=\fR را لغو (override) می‌کند، اما اطلاعات خط‌لوله (pipeline) را لغو نمی‌کند.
این امر به کاهش اندازهٔ کد در عین ارائهٔ عملکرد مناسب کمک می‌کند.
.IP \fB\-mpreferred\-stack\-boundary=\fR\fInum\fR 4
.IX Item "-mpreferred-stack-boundary=num"
تلاش می‌کند تراز مرز پشته (stack) را روی مرز ۲ به توان \fInum\fR
بایت نگه دارد. اگر \fB\-mpreferred\-stack\-boundary\fR مشخص نشده باشد،
مقدار پیش‌فرض ۴ (۱۶ بایت یا ۱۲۸ بیت) است.
.Sp
\&\fBهشدار:\fR در صورت استفاده از این گزینه، باید تمام پودمان‌ها (modules)، از جمله
هرگونه کتابخانه‌ای را با همین مقدار بسازید. این امر شامل کتابخانه‌های سیستم
و پودمان‌های راه‌اندازی (startup) نیز می‌شود.
.IP \fB\-msmall\-data\-limit=\fR\fIn\fR 4
.IX Item "-msmall-data-limit=n"
داده‌های سراسری و ایستای کوچک‌تر از \fIn\fR بایت را در یک بخش (section) ویژه قرار می‌دهد
(در برخی مقصدها).
.IP \fB\-msave\-restore\fR 4
.IX Item "-msave-restore"
.PD 0
.IP \fB\-mno\-save\-restore\fR 4
.IX Item "-mno-save-restore"
.PD
استفاده یا عدم استفاده از کد پیش‌درآمد (prologue) و پس‌درآمد (epilogue) کوچک‌تر اما کندتر که
از فراخوانی توابع کتابخانه‌ای استفاده می‌کند. پیش‌فرض، استفاده از پیش‌درآمدها و
پس‌درآمدهای سریع درون‌خطی (inline) است.
.IP \fB\-mmovcc\fR 4
.IX Item "-mmovcc"
.PD 0
.IP \fB\-mno\-movcc\fR 4
.IX Item "-mno-movcc"
.PD
تولید یا عدم تولید توالی‌های کد انتقال شرطی بدون انشعاب (branchless conditional-move)، حتی برای
مقصدهایی که دستورالعمل‌های خاصی برای عملیات شرطی ندارند.
در صورت فعال بودن، در جاهایی که سودمند باشد توالی‌هایی از عملیات‌های ALU با
استفاده از دستورالعمل‌های معماری پایهٔ عدد صحیح (base integer ISA) تولید می‌شود.
.IP \fB\-minline\-atomics\fR 4
.IX Item "-minline-atomics"
.PD 0
.IP \fB\-mno\-inline\-atomics\fR 4
.IX Item "-mno-inline-atomics"
.PD
استفاده یا عدم استفاده از کد شبیه‌سازی اتمی زیرکلمه‌ای (subword atomic) کوچک‌تر اما کندتر که
از فراخوانی توابع libatomic استفاده می‌کند. پیش‌فرض، استفاده از عملیات اتمی زیرکلمه‌ای سریع
و درون‌خطی است که نیازی به libatomic ندارند.
.IP \fB\-minline\-strlen\fR 4
.IX Item "-minline-strlen"
.PD 0
.IP \fB\-mno\-inline\-strlen\fR 4
.IX Item "-mno-inline-strlen"
.PD
تلاش کردن یا نکردن برای درون‌خطی‌سازی فراخوانی‌های \f(CW\*(C`strlen\*(C'\fR در صورت امکان.
درون‌خطی‌سازی تنها زمانی قابل انجام است که رشته به‌درستی تراز شده باشد
و دستورالعمل‌های پردازش شتاب‌یافته در دسترس باشند.
پیش‌فرض، درون‌خطی کردن فراخوانی‌های \f(CW\*(C`strlen\*(C'\fR است.
.IP \fB\-minline\-strcmp\fR 4
.IX Item "-minline-strcmp"
.PD 0
.IP \fB\-mno\-inline\-strcmp\fR 4
.IX Item "-mno-inline-strcmp"
.PD
تلاش کردن یا نکردن برای درون‌خطی‌سازی فراخوانی‌های \f(CW\*(C`strcmp\*(C'\fR در صورت امکان.
درون‌خطی‌سازی تنها زمانی قابل انجام است که رشته‌ها به‌درستی تراز شده باشند
و دستورالعمل‌های پردازش شتاب‌یافته در دسترس باشند.
پیش‌فرض، درون‌خطی کردن فراخوانی‌های \f(CW\*(C`strcmp\*(C'\fR است.
.IP \fB\-minline\-strncmp\fR 4
.IX Item "-minline-strncmp"
.PD 0
.IP \fB\-mno\-inline\-strncmp\fR 4
.IX Item "-mno-inline-strncmp"
.PD
تلاش کردن یا نکردن برای درون‌خطی‌سازی فراخوانی‌های \f(CW\*(C`strncmp\*(C'\fR در صورت امکان.
درون‌خطی‌سازی تنها زمانی قابل انجام است که رشته‌ها به‌درستی تراز شده باشند
و دستورالعمل‌های پردازش شتاب‌یافته در دسترس باشند.
پیش‌فرض، درون‌خطی کردن فراخوانی‌های \f(CW\*(C`strncmp\*(C'\fR است.
.IP \fB\-mstringop\-strategy=\fR\fIstrategy\fR 4
.IX Item "-mstringop-strategy=strategy"
تعیین یک راهبرد مشخص برای درون‌خطی‌سازی عملیات‌های رشته و حافظه.
\&\fIstrategy\fR می‌تواند یکی از مقادیر \fBauto\fR، \fBlibcall\fR، \fBscalar\fR
یا \fBvector\fR باشد.
.IP \fB\-mshorten\-memrefs\fR 4
.IX Item "-mshorten-memrefs"
.PD 0
.IP \fB\-mno\-shorten\-memrefs\fR 4
.IX Item "-mno-shorten-memrefs"
.PD
تلاش کردن یا نکردن برای استفادهٔ بیشتر از دستورالعمل‌های فشردهٔ بارگذاری/ذخیره (load/store) با
جایگزین کردن بارگذاری/ذخیرهٔ \*(Aqثبات پایه + آفست بزرگ\*(Aq با یک بارگذاری/ذخیرهٔ جدید
از \*(Aqپایه جدید + آفست کوچک\*(Aq. اگر پایهٔ جدید در یک ثبات فشرده
ذخیره شود، بارگذاری/ذخیرهٔ جدید می‌تواند فشرده گردد. در حال حاضر تنها
بارگذاری/ذخیرهٔ اعداد صحیح ۳۲\-بیتی را هدف قرار می‌دهد.
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD 0
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD
عدم تولید یا تولید دسترسی‌های غیرتراز به حافظه. پیش‌فرض بر این اساس تنظیم می‌شود
که آیا پردازنده‌ای که برای آن بهینه‌سازی می‌کنیم از دسترسی سریع غیرتراز پشتیبانی
می‌کند یا خیر.
.IP \fB\-mscalar\-strict\-align\fR 4
.IX Item "-mscalar-strict-align"
.PD 0
.IP \fB\-mno\-scalar\-strict\-align\fR 4
.IX Item "-mno-scalar-strict-align"
.PD
عدم تولید یا تولید دسترسی‌های غیرتراز به حافظه. مقدار پیش‌فرض بسته به اینکه
پردازنده‌ای که برای آن بهینه‌سازی می‌کنیم از دسترسی سریع غیرتراز پشتیبانی می‌کند یا خیر،
تنظیم می‌شود. این گزینه یک نام مستعار برای \fB\-mstrict\-align\fR است.
.IP \fB\-mvector\-strict\-align\fR 4
.IX Item "-mvector-strict-align"
.PD 0
.IP \fB\-mno\-vector\-strict\-align\fR 4
.IX Item "-mno-vector-strict-align"
.PD
عدم تولید یا تولید دسترسی‌های برداری غیرتراز به حافظه. پیش‌فرض روی غیرفعال (off)
تنظیم شده است مگر اینکه پردازنده‌ای که برای آن بهینه‌سازی می‌کنیم صراحتاً
از دسترسی حافظهٔ برداری با عناصر غیرتراز (element\-misaligned) پشتیبانی کند.
.IP \fB\-mmax\-vectorization\fR 4
.IX Item "-mmax-vectorization".PD 0
.IP \fB\-mno\-max\-vectorization\fR 4
.IX Item "-mno-max-vectorization"
.PD
فعال یا غیرفعال کردن بازنویسیِ (override) مدل هزینه بردارساز به‌گونه‌ای که بردارسازی همیشه سودمند به نظر برسد. بر خلاف \fB\-fno\-vect\-cost\-model\fR یا
\&\fB\-fvect\-cost\-model=unlimited\fR این گزینه مقایسه هزینه بین حالت‌های برداری مختلف را خاموش نمی‌کند.
.IP \fB\-mcmodel=medlow\fR 4
.IX Item "-mcmodel=medlow"
تولید کد برای مدل کد medium\-low. برنامه و نمادهای ایستا تعریف‌شده آن باید درون یک محدوده آدرس ۲ گیبی‌بایتی (2 GiB) واحد قرار گیرند و باید بین آدرس‌های مطلق \-2 GiB و +2 GiB باشند. برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند. این مدل کد پیش‌فرض است مگر اینکه GCC با \fB\-\-with\-cmodel=\fR که یک مدل کد پیش‌فرض متفاوت را تعیین می‌کند، پیکربندی شده باشد.
.IP \fB\-mcmodel=medany\fR 4
.IX Item "-mcmodel=medany"
تولید کد برای مدل کد medium\-any. برنامه و نمادهای ایستا تعریف‌شده آن باید درون هر محدوده آدرس ۲ گیبی‌بایتی (2 GiB) واحد قرار گیرند. برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند.
.Sp
کد تولیدشده توسط مدل کد medium\-any مستقل از موقعیت (position\-independent) است، اما تضمین نمی‌شود هنگام پیوند در برنامه‌های اجرایی یا کتابخانه‌های مستقل از موقعیت به‌درستی کار کند.
.IP \fB\-mcmodel=large\fR 4
.IX Item "-mcmodel=large"
تولید کد برای یک مدل کد بزرگ (large)، که هیچ محدودیتی روی اندازه یا جای‌گذاری نمادها ندارد.
.IP \fB\-mexplicit\-relocs\fR 4
.IX Item "-mexplicit-relocs"
.PD 0
.IP \fB\-mno\-explicit\-relocs\fR 4
.IX Item "-mno-explicit-relocs"
.PD
استفاده یا عدم استفاده از عملگرهای بازنشانی (relocation) اسمبلر هنگام کار با آدرس‌های نمادین. راه‌حل جایگزین، استفاده از ماکروهای اسمبلر است که ممکن است بهینه‌سازی را محدود کند.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
.PD 0
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
.PD
بهره‌گیری از تعدیل‌های پیونددهنده (linker relaxations) برای کاهش تعداد دستورالعمل‌های مورد نیاز جهت تحقق آدرس‌های نماد. حالت پیش‌فرض، بهره‌گیری از تعدیل‌های پیونددهنده است.
.IP \fB\-mriscv\-attribute\fR 4
.IX Item "-mriscv-attribute"
.PD 0
.IP \fB\-mno\-riscv\-attribute\fR 4
.IX Item "-mno-riscv-attribute"
.PD
تولید کردن (یا تولید نکردن) صفت RISC\-V برای ثبت اطلاعات اضافی درون اشیاء ELF. این ویژگی دست‌کم به binutils نسخه 2.32 نیاز دارد.
.IP \fB\-mcsr\-check\fR 4
.IX Item "-mcsr-check"
.PD 0
.IP \fB\-mno\-csr\-check\fR 4
.IX Item "-mno-csr-check"
.PD
بررسی CSR را فعال یا غیرفعال می‌کند.
.IP \fB\-momit\-leaf\-frame\-pointer\fR 4
.IX Item "-momit-leaf-frame-pointer"
اشاره‌گر چارچوب (frame pointer) را در یک ثبات برای توابع برگ (leaf functions) نگه نمی‌دارد. این کار از دستورالعمل‌های ذخیره، برپاسازی و بازیابی اشاره‌گرهای چارچوب جلوگیری کرده و یک ثبات اضافی را در توابع برگ در دسترس قرار می‌دهد.
.IP \fB\-malign\-data=\fR\fItype\fR 4
.IX Item "-malign-data=type"
کنترل نحوه هم‌ترازی متغیرها و ثابت‌های از نوع آرایه، ساختار (structure) یا اجتماع (union) توسط GCC. مقادیر پشتیبانی‌شده برای \fItype\fR عبارتند از \fBxlen\fR که از پهنای ثبات x به‌عنوان مقدار هم‌ترازی استفاده می‌کند، و \fBnatural\fR که از هم‌ترازی طبیعی بهره می‌برد. حالت پیش‌فرض \&\fBxlen\fR است.
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
تولید کد بزرگ‌پایان (big\-endian). این گزینه در حالتی که GCC برای یک هدف \&\fBriscv64be\-*\-*\fR یا \fBriscv32be\-*\-*\fR پیکربندی شده باشد، پیش‌فرض است.
پشتیبانی از big\-endian در RISC\-V آزمایشی است. رابط ABI هنوز پایدار نیست و ممکن است در نسخه‌های آینده دستخوش تغییرات ناسازگار شود.
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
تولید کد کوچک‌پایان (little\-endian). این گزینه در حالتی که GCC برای یک هدف \&\fBriscv64\-*\-*\fR یا \fBriscv32\-*\-*\fR (و نه برای یک هدف \fBriscv64be\-*\-*\fR یا
\&\fBriscv32be\-*\-*\fR) پیکربندی شده باشد، پیش‌فرض است.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR 4
.IX Item "-mstack-protector-guard-reg=reg"
.IP \fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR 4
.IX Item "-mstack-protector-guard-offset=offset"
.PD
تولید کد محافظت از پشته با استفاده از قناری (canary) در \fIguard\fR. مکان‌های پشتیبانی‌شده عبارتند از \fBglobal\fR برای یک قناری سراسری یا \fBtls\fR برای قناری به ازای هر رشته (per\-thread) در بلوک TLS.
.Sp
با انتخاب دوم، گزینه‌های
\&\fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR و
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR علاوه‌براین مشخص می‌کنند
که کدام ثبات به‌عنوان ثبات پایه برای خواندن قناری، و از چه آفستی نسبت به آن ثبات پایه استفاده شود. هیچ ثبات یا آفست پیش‌فرضی وجود ندارد چرا که این قابلیت منحصراً برای استفاده در هسته لینوکس در نظر گرفته شده است.
.IP \fB\-mtls\-dialect=desc\fR 4
.IX Item "-mtls-dialect=desc"
استفاده از توصیف‌کننده‌های TLS به‌عنوان سازوکار فضای ذخیره‌سازی محلی رشته (thread\-local storage) برای دسترسی‌های پویای متغیرهای TLS.
.IP \fB\-mtls\-dialect=trad\fR 4
.IX Item "-mtls-dialect=trad"
استفاده از TLS سنتی به‌عنوان سازوکار فضای ذخیره‌سازی محلی رشته برای دسترسی‌های پویای متغیرهای TLS. این گزینه پیش‌فرض است.
.IP \fB\-mrvv\-vector\-bits=\fR\fIvalue\fR 4
.IX Item "-mrvv-vector-bits=value"
مشخص می‌کند که تعداد بیت‌ها برای یک ثبات برداری RVV، که از گزینه \fB\-march=\fR گرفته شده است، چگونه تفسیر شود.
پارامتر \fIvalue\fR به‌صورت یک کلیدواژه رشته‌ای مشخص می‌شود و می‌تواند یکی از
\&\fBscalable\fR یا \fBzvl\fR باشد. پیش‌فرض \fBscalable\fR است که به
GCC می‌گوید عدد را به‌عنوان حداقل تفسیر کند، در حالی که \fBzvl\fR به GCC می‌گوید دقیقاً
از همان تعداد بیت‌های مشخص‌شده استفاده نماید.
.IP \fB\-mrvv\-max\-lmul=\fR\fIvalue\fR 4
.IX Item "-mrvv-max-lmul=value"
این گزینه امکان کنترل صریح بر حداکثر ضریب طول (LMUL) مورد استفاده هنگام تولید کد برای افزونه‌های برداری RISC\-V (RVV) را فراهم می‌کند.
پارامتر \fIvalue\fR به‌صورت یک کلیدواژه رشته‌ای مشخص می‌شود و می‌تواند
یکی از \fBm1\fR، \fBm2\fR، \fBm4\fR، \fBm8\fR یا \fBdynamic\fR باشد. مقدار
پیش‌فرض برای سازگاری با سخت‌افزارهای موجود که از سایر گزینه‌ها پشتیبانی نمی‌کنند، \fBm1\fR است.
.IP \fB\-madjust\-lmul\-cost\fR 4
.IX Item "-madjust-lmul-cost"
.PD 0
.IP \fB\-mno\-adjust\-lmul\-cost\fR 4
.IX Item "-mno-adjust-lmul-cost"
.PD
این گزینه مدل هزینه مورد استفاده برای زمان‌بندی دستورالعمل‌های برداری را به‌گونه‌ای تنظیم می‌کند که زمان تأخیر (latency) دستورالعمل‌ها را در ضریب طول RVV، یعنی LMUL، ضرب کند.
این گزینه به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mautovec\-segment\fR 4
.IX Item "-mautovec-segment"
.PD 0
.IP \fB\-mno\-autovec\-segment\fR 4
.IX Item "-mno-autovec-segment"
.PD
فعال یا غیرفعال کردن تولید دستورالعمل‌های بارگذاری/ذخیره قطعه برداری (vector segment load/store).
این گزینه به‌طور پیش‌فرض فعال است.
.PP
\fIگزینه‌های RL78\fR
.IX Subsection "RL78 Options"
.IP \fB\-msim\fR 4
.IX Item "-msim"
پیوند دادن کتابخانه‌های هدف اضافی جهت پشتیبانی از اجرا در یک شبیه‌ساز.
.IP \fB\-mmul=none\fR 4
.IX Item "-mmul=none"
.PD 0
.IP \fB\-mmul=g10\fR 4
.IX Item "-mmul=g10"
.IP \fB\-mmul=g13\fR 4
.IX Item "-mmul=g13"
.IP \fB\-mmul=g14\fR 4
.IX Item "-mmul=g14"
.IP \fB\-mmul=rl78\fR 4
.IX Item "-mmul=rl78"
.PD
نوع پشتیبانی سخت‌افزاری از ضرب و تقسیم را برای استفاده مشخص می‌کند. ساده‌ترین حالت \f(CW\*(C`none\*(C'\fR است که از نرم‌افزار برای هر دو عمل ضرب و تقسیم استفاده می‌کند. این حالت پیش‌فرض است. مقدار \f(CW\*(C`g13\*(C'\fR
برای قطعه جانبی ضرب/تقسیم سخت‌افزاری موجود روی اهداف RL78/G13 (هسته S2) است. مقدار \f(CW\*(C`g14\*(C'\fR استفاده از
دستورالعمل‌های ضرب و تقسیم پشتیبانی‌شده توسط قطعات RL78/G14 (هسته S3) را انتخاب می‌کند. مقدار \f(CW\*(C`rl78\*(C'\fR نام مستعاری برای \f(CW\*(C`g14\*(C'\fR و
مقدار \f(CW\*(C`mg10\*(C'\fR نام مستعاری برای \f(CW\*(C`none\*(C'\fR است.
.Sp
علاوه‌براین، بر پایه تنظیم این گزینه، یک ماکروی پیش‌پردازنده C تعریف می‌شود. مقادیر ممکن عبارتند از: \f(CW\*(C`_\|_RL78_MUL_NONE_\|_\*(C'\fR،
\&\f(CW\*(C`_\|_RL78_MUL_G13_\|_\*(C'\fR یا \f(CW\*(C`_\|_RL78_MUL_G14_\|_\*(C'\fR.
.IP \fB\-mcpu=g10\fR 4
.IX Item "-mcpu=g10"
.PD 0
.IP \fB\-mcpu=g13\fR 4
.IX Item "-mcpu=g13".IP \fB\-mcpu=g14\fR 4
.IX Item "-mcpu=g14"
.IP \fB\-mcpu=rl78\fR 4
.IX Item "-mcpu=rl78"
.PD
هسته RL78 مورد نظر را مشخص می‌کند. پیش‌فرض هسته G14 است که با نام هسته S3 یا صرفاً RL78 نیز شناخته می‌شود. هسته G13 یا S2 فاقد دستورالعمل‌های ضرب یا تقسیم است و در عوض برای این عملیات‌ها از یک جانبی سخت‌افزاری استفاده می‌کند. هسته G10 یا S1 بانک‌های ثبات ندارد، بنابراین از یک قرارداد فراخوانی متفاوت استفاده می‌کند.
.Sp
اگر این گزینه تنظیم شود، نوع پشتیبانی ضرب سخت‌افزاری مورد استفاده را نیز انتخاب می‌کند، مگر اینکه با یک گزینه صریح \&\fB\-mmul=none\fR در خط فرمان لغو شود. بنابراین، مشخص کردن \&\fB\-mcpu=g13\fR استفاده از جانبی سخت‌افزاری ضرب G13 را فعال می‌کند و مشخص کردن \fB\-mcpu=g10\fR استفاده از ضرب‌های سخت‌افزاری را به‌طور کامل غیرفعال می‌سازد.
.Sp
توجه داشته باشید اگرچه هسته RL78/G14 هدف پیش‌فرض است، مشخص کردن \&\fB\-mcpu=g14\fR یا \fB\-mcpu=rl78\fR در خط فرمان، رفتار زنجیره ابزار را تغییر می‌دهد چرا که پشتیبانی ضرب سخت‌افزاری G14 را نیز فعال می‌کند. اگر این گزینه‌ها در خط فرمان مشخص نشوند، حتی در صورتی که کد هسته RL78 را هدف قرار داده باشد، روال‌های ضرب نرم‌افزاری استفاده خواهند شد. این امر برای سازگاری رو به عقب با زنجیره ابزارهای قدیمی‌تری است که فاقد پشتیبانی از ضرب و تقسیم سخت‌افزاری بودند.
.Sp
علاوه بر این، یک ماکروی پیش‌پردازنده C بر اساس تنظیمات این گزینه تعریف می‌شود. مقادیر ممکن عبارتند از: \f(CW\*(C`_\|_RL78_G10_\|_\*(C'\fR، \&\f(CW\*(C`_\|_RL78_G13_\|_\*(C'\fR یا \f(CW\*(C`_\|_RL78_G14_\|_\*(C'\fR.
.IP \fB\-mg10\fR 4
.IX Item "-mg10"
.PD 0
.IP \fB\-mg13\fR 4
.IX Item "-mg13"
.IP \fB\-mg14\fR 4
.IX Item "-mg14"
.IP \fB\-mrl78\fR 4
.IX Item "-mrl78"
.PD
این‌ها نام‌های مستعار برای گزینه متناظر \fB\-mcpu=\fR هستند. این موارد برای سازگاری رو به عقب ارائه شده‌اند.
.IP \fB\-mallregs\fR 4
.IX Item "-mallregs"
به کامپایلر اجازه می‌دهد از تمام ثبات‌های در دسترس استفاده کند. به‌طور پیش‌فرض ثبات‌های \f(CW\*(C`r24..r31\*(C'\fR برای استفاده در گرداننده‌های وقفه رزرو شده‌اند. با فعال بودن این گزینه، این ثبات‌ها می‌توانند در توابع عادی نیز استفاده شوند.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
.PD 0
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
.PD
فعال/غیرفعال کردن بازآرایی (relaxation) اسمبلر و پیونددهنده. این گزینه به‌طور پیش‌فرض در \fB\-Os\fR فعال است.
.IP \fB\-mes0\fR 4
.IX Item "-mes0"
فرض می‌کند مقدار \f(CW\*(C`ES\*(C'\fR در سراسر اجرای برنامه صفر است، و از آن برای آدرس‌دهی داده‌های فقط‌خواندنی استفاده می‌کند.
.IP \fB\-msave\-mduc\-in\-interrupts\fR 4
.IX Item "-msave-mduc-in-interrupts"
.PD 0
.IP \fB\-mno\-save\-mduc\-in\-interrupts\fR 4
.IX Item "-mno-save-mduc-in-interrupts"
.PD
مشخص می‌کند که توابع گرداننده وقفه باید ثبات‌های MDUC را حفظ کنند. این تنها در صورتی لازم است که کد عادی ممکن باشد از ثبات‌های MDUC استفاده کند، برای مثال به این دلیل که عملیات ضرب و تقسیم انجام می‌دهد. پیش‌فرض، نادیده گرفتن ثبات‌های MDUC است زیرا این امر گرداننده‌های وقفه را سریع‌تر می‌کند. برای اینکه این ویژگی کار کند، باید گزینه هدف \fB\-mg13\fR ارسال شود، چرا که این قابلیت تنها روی هدف G13 (هسته S2) موجود است. ثبات‌های MDUC تنها در صورتی ذخیره می‌شوند که گرداننده وقفه عملیات ضرب یا تقسیم انجام دهد یا تابع دیگری را فراخوانی کند.
.PP
\fIگزینه‌های IBM RS/6000 و PowerPC\fR
.IX Subsection "IBM RS/6000 and PowerPC Options"
.PP
این گزینه‌های \fB\-m\fR برای IBM RS/6000 و PowerPC تعریف شده‌اند:
.IP \fB\-mcpu=\fR\fIcpu_type\fR 4
.IX Item "-mcpu=cpu_type"
نوع معماری، نحوه استفاده از ثبات‌ها و پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \fIcpu_type\fR تنظیم می‌کند. مقادیر پشتیبانی‌شده برای \fIcpu_type\fR عبارتند از: \fB401\fR، \fB403\fR، \&\fB405\fR، \fB405fp\fR، \fB440\fR، \fB440fp\fR، \fB464\fR، \fB464fp\fR، \&\fB476\fR، \fB476fp\fR، \fB505\fR، \fB601\fR، \fB602\fR، \fB603\fR، \&\fB603e\fR، \fB604\fR، \fB604e\fR، \fB620\fR، \fB630\fR، \fB740\fR، \&\fB7400\fR، \fB7450\fR، \fB750\fR، \fB801\fR، \fB821\fR، \fB823\fR، \&\fB860\fR، \fB970\fR، \fB8540\fR، \fBa2\fR، \fBe300c2\fR، \&\fBe300c3\fR، \fBe500mc\fR، \fBe500mc64\fR، \fBe5500\fR، \&\fBe6500\fR، \fBec603e\fR، \fBG3\fR، \fBG4\fR، \fBG5\fR، \&\fBtitan\fR، \fBpower3\fR، \fBpower4\fR، \fBpower5\fR، \fBpower5+\fR، \&\fBpower6\fR، \fBpower6x\fR، \fBpower7\fR، \fBpower8\fR، \&\fBpower9\fR، \fBpower10\fR، \fBpower11\fR، \fBfuture\fR، \fBpowerpc\fR، \&\fBpowerpc64\fR، \fBpowerpc64le\fR، \fBrs64\fR و \fBnative\fR.
.Sp
گزینه‌های \&\fB\-mcpu=powerpc\fR، \fB\-mcpu=powerpc64\fR و \&\fB\-mcpu=powerpc64le\fR نوع ماشین‌های معماری PowerPC ۳۲\-بیتی خالص (با هر دو نوع ترتیب بایت)، PowerPC ۶۴\-بیتی big endian و PowerPC ۶۴\-بیتی little endian را مشخص می‌کنند، که در آن‌ها یک مدل پردازنده عمومی و مناسب برای اهداف زمان‌بندی فرض می‌شود.
.Sp
مشخص کردن \fBnative\fR به عنوان نوع پردازنده، گزینه معماری متناظر با پردازنده میزبان سیستمی را که کامپایل را انجام می‌دهد شناسایی و انتخاب می‌کند. اگر GCC پردازنده را شناسایی نکند، \&\fB\-mcpu=native\fR هیچ تأثیری ندارد.
.Sp
گزینه‌های دیگر یک پردازنده خاص را مشخص می‌کنند. کدی که تحت این گزینه‌ها تولید می‌شود بهترین اجرا را روی آن پردازنده دارد، و ممکن است روی پردازنده‌های دیگر اصلاً اجرا نشود.
.Sp
گزینه‌های \fB\-mcpu\fR گزینه‌های زیر را به‌طور خودکار فعال یا غیرفعال می‌کنند:
.Sp
\&\fB\-maltivec  \-mfprnd  \-mhard\-float  \-mmfcrf  \-mmultiple
\&\-mpopcntb  \-mpopcntd  \-mpowerpc64
\&\-mpowerpc\-gpopt  \-mpowerpc\-gfxopt
\&\-mmulhw  \-mdlmzb  \-mmfpgpr  \-mvsx
\&\-mcrypto  \-mhtm  \-mpower8\-fusion
\&\-mquad\-memory  \-mquad\-memory\-atomic  \-mfloat128
\&\-mfloat128\-hardware  \-mprefixed  \-mpcrel  \-mmma
\&\-mdense\-math \-mrop\-protect\fR
.Sp
گزینه‌های خاص تنظیم‌شده برای هر CPU بین نسخه‌های مختلف کامپایلر تفاوت دارد، که به تنظیماتی بستگی دارد که به نظر می‌رسد کدی بهینه برای آن پردازنده تولید می‌کند؛ این لزوماً بازتاب‌دهنده قابلیت‌های واقعی سخت‌افزار نیست. اگر مایلید گزینه‌ای مجزا را روی مقداری مشخص تنظیم کنید، می‌توانید آن را پس از گزینه \fB\-mcpu\fR مشخص کنید، مانند \&\fB\-mcpu=970 \-mno\-altivec\fR.
.Sp
در AIX، در حال حاضر گزینه‌های \fB\-maltivec\fR و \fB\-mpowerpc64\fR توسط گزینه \fB\-mcpu\fR فعال یا غیرفعال نمی‌شوند چرا که AIX پشتیبانی کاملی از این گزینه‌ها ندارد. با این حال اگر مطمئن هستید که در محیط شما کار خواهند کرد، همچنان می‌توانید آن‌ها را به‌صورت جداگانه فعال یا غیرفعال کنید.
.Sp
در موارد دیگر، توصیه می‌کنیم به جای گزینه‌هایی که تولید دستورالعمل‌های خاص را کنترل می‌کنند، از گزینه \fB\-mcpu=\fR\fIcpu_type\fR استفاده کنید.
.IP \fB\-mtune=\fR\fIcpu_type\fR 4
.IX Item "-mtune=cpu_type"
پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \&\fIcpu_type\fR تنظیم می‌کند، اما برخلاف \fB\-mcpu=\fR\fIcpu_type\fR نوع معماری یا استفاده از ثبات‌ها را تغییر نمی‌دهد. همان مقادیر \fIcpu_type\fR که برای \fB\-mcpu\fR به کار می‌روند، برای \fB\-mtune\fR نیز استفاده می‌شوند. اگر هر دو مشخص شوند، کد تولیدشده از معماری و ثبات‌های تعیین‌شده توسط \fB\-mcpu\fR استفاده می‌کند، اما پارامترهای زمان‌بندی تعیین‌شده توسط \fB\-mtune\fR را به کار می‌گیرد.
.IP \fB\-mpowerpc64\fR 4
.IX Item "-mpowerpc64"
.PD 0
.IP \fB\-mno\-powerpc64\fR 4
.IX Item "-mno-powerpc64"
.PD
گزینه \fB\-mpowerpc64\fR به GCC اجازه می‌دهد دستورالعمل‌های ۶۴\-بیتی اضافی را که در معماری کامل PowerPC64 وجود دارند تولید کرده و با ثبات‌های GPR به عنوان مقادیر ۶۴\-بیتی doubleword رفتار کند. پیش‌فرض GCC گزینه \&\fB\-mno\-powerpc64\fR است.
.IP \fB\-mcmodel=small\fR 4
.IX Item "-mcmodel=small"
تولید کد PowerPC64 برای مدل کوچک (small): جدول TOC به 64k محدود است.
.IP \fB\-mcmodel=medium\fR 4
.IX Item "-mcmodel=medium"
تولید کد PowerPC64 برای مدل متوسط (medium): جدول TOC و سایر داده‌های ایستا می‌توانند تا مجموعاً اندازه 4G باشند. این حالت پیش‌فرض برای لینوکس ۶۴\-بیتی است.
.IP \fB\-mcmodel=large\fR 4
.IX Item "-mcmodel=large"
تولید کد PowerPC64 برای مدل بزرگ (large): جدول TOC می‌تواند تا اندازه 4G باشد. سایر داده‌ها و کد تنها توسط فضای آدرس ۶۴\-بیتی محدود می‌شوند.
.IP \fB\-mprofile\-kernel\fR 4
.IX Item "-mprofile-kernel"
این گزینه در اهداف PowerPC64 GNU/Linux موجود است. در صورت استفاده با \&\fB\-pg\fR، باعث می‌شود فراخوانی‌های \f(CW\*(C`mcount\*(C'\fR به جای بعد از مقدمه تابع، قبل از آن درج شوند.
.IP \fB\-maltivec\fR 4
.IX Item "-maltivec".PD 0
.IP \fB\-mno\-altivec\fR 4
.IX Item "-mno-altivec"
.PD
کدی تولید می‌کند که از دستورالعمل‌های AltiVec استفاده می‌کند (استفاده نمی‌کند)، و همچنین استفاده از توابع توکار (built\-in) را فعال می‌کند که دسترسی مستقیم‌تر به مجموعه دستورالعمل‌های AltiVec را امکان‌پذیر می‌سازند. ممکن است برای تطبیق ABI فعلی با بهبودهای ABI مربوط به AltiVec، به تنظیم \&\fB\-mabi=altivec\fR نیز نیاز داشته باشید.
.Sp
هنگامی که \fB\-maltivec\fR استفاده می‌شود، ترتیب عناصر برای توابع درونی AltiVec مانند \f(CW\*(C`vec_splat\*(C'\fR، \f(CW\*(C`vec_extract\*(C'\fR و \f(CW\*(C`vec_insert\*(C'\fR با ترتیب عناصر آرایه متناسب با ترتیب بایت‌ها (endianness) در مقصد مطابقت دارد. بدین معنا که هنگام هدف‌گیری بسترهای big\-endian، عنصر صفر نشان‌دهنده چپ‌ترین عنصر در یک ثبات برداری است و هنگام هدف‌گیری بسترهای little\-endian، نشان‌دهنده راست‌ترین عنصر در یک ثبات برداری خواهد بود.
.IP \fB\-mpowerpc\-gpopt\fR 4
.IX Item "-mpowerpc-gpopt"
.PD 0
.IP \fB\-mno\-powerpc\-gpopt\fR 4
.IX Item "-mno-powerpc-gpopt"
.PD
مشخص کردن \fB\-mpowerpc\-gpopt\fR به
GCC اجازه می‌دهد از دستورالعمل‌های اختیاری معماری PowerPC در
گروه کاربرد عمومی (General Purpose)، شامل جذر ممیز شناور، استفاده کند. مشخص کردن
.IP \fB\-mpowerpc\-gfxopt\fR 4
.IX Item "-mpowerpc-gfxopt"
.PD 0
.IP \fB\-mno\-powerpc\-gfxopt\fR 4
.IX Item "-mno-powerpc-gfxopt"
.PD
\&\fB\-mpowerpc\-gfxopt\fR به GCC اجازه می‌دهد
از دستورالعمل‌های اختیاری معماری PowerPC در گروه گرافیک (Graphics)،
شامل انتخاب ممیز شناور (floating\-point select)، استفاده کند.
.IP \fB\-mmfcrf\fR 4
.IX Item "-mmfcrf"
.PD 0
.IP \fB\-mno\-mfcrf\fR 4
.IX Item "-mno-mfcrf"
.PD
گزینهٔ \fB\-mmfcrf\fR به GCC اجازه می‌دهد دستورالعمل انتقال از
فیلد ثبات شرطی (move from condition register field) را که روی پردازندهٔ POWER4
و دیگر پردازنده‌های پشتیبانی‌کننده از معماری PowerPC V2.01
پیاده‌سازی شده است، تولید کند.
.IP \fB\-mpopcntb\fR 4
.IX Item "-mpopcntb"
.PD 0
.IP \fB\-mno\-popcntb\fR 4
.IX Item "-mno-popcntb"
.PD
گزینهٔ \fB\-mpopcntb\fR به GCC اجازه می‌دهد دستورالعمل‌های popcount و
تخمین معکوس ممیز شناور با دقت مضاعف را که روی
پردازندهٔ POWER5 و دیگر پردازنده‌های پشتیبانی‌کننده از معماری PowerPC V2.02
پیاده‌سازی شده است، تولید کند.
.IP \fB\-mpopcntd\fR 4
.IX Item "-mpopcntd"
.PD 0
.IP \fB\-mno\-popcntd\fR 4
.IX Item "-mno-popcntd"
.PD
گزینهٔ \fB\-mpopcntd\fR به GCC اجازه می‌دهد دستورالعمل popcount
پیاده‌سازی‌شده روی پردازندهٔ POWER7 و دیگر پردازنده‌های
پشتیبانی‌کننده از معماری PowerPC V2.06 را تولید کند.
.IP \fB\-mfprnd\fR 4
.IX Item "-mfprnd"
.PD 0
.IP \fB\-mno\-fprnd\fR 4
.IX Item "-mno-fprnd"
.PD
گزینهٔ \fB\-mfprnd\fR به GCC اجازه می‌دهد دستورالعمل‌های گرد کردن ممیز شناور
به عدد صحیح را که روی پردازندهٔ +POWER5 و دیگر
پردازنده‌های پشتیبانی‌کننده از معماری PowerPC V2.03 پیاده‌سازی شده است، تولید کند.
.IP \fB\-mcmpb\fR 4
.IX Item "-mcmpb"
.PD 0
.IP \fB\-mno\-cmpb\fR 4
.IX Item "-mno-cmpb"
.PD
گزینهٔ \fB\-mcmpb\fR به GCC اجازه می‌دهد دستورالعمل مقایسهٔ بایت‌ها را که
روی پردازندهٔ POWER6 و دیگر پردازنده‌های پشتیبانی‌کننده
از معماری PowerPC V2.05 پیاده‌سازی شده است، تولید کند.
.IP \fB\-mhard\-dfp\fR 4
.IX Item "-mhard-dfp"
.PD 0
.IP \fB\-mno\-hard\-dfp\fR 4
.IX Item "-mno-hard-dfp"
.PD
گزینهٔ \fB\-mhard\-dfp\fR به GCC اجازه می‌دهد دستورالعمل‌های ممیز
شناور ده‌دهی (decimal floating\-point) را که روی برخی پردازنده‌های POWER پیاده‌سازی شده است، تولید کند.
.IP \fB\-mvrsave\fR 4
.IX Item "-mvrsave"
.PD 0
.IP \fB\-mno\-vrsave\fR 4
.IX Item "-mno-vrsave"
.PD
هنگام تولید کد AltiVec، دستورالعمل‌های VRSAVE را تولید می‌کند.
.IP \fB\-msecure\-plt\fR 4
.IX Item "-msecure-plt"
کدی تولید می‌کند که به \fBld\fR و \fBld.so\fR امکان می‌دهد
فایل‌های اجرایی و کتابخانه‌های اشتراکی را با
بخش‌های غیرقابل‌اجرای \f(CW\*(C`.plt\*(C'\fR و \f(CW\*(C`.got\*(C'\fR بسازند.
این یک گزینهٔ PowerPC برای SYSV ABI ۳۲ بیتی است.
.IP \fB\-mbss\-plt\fR 4
.IX Item "-mbss-plt"
کدی تولید می‌کند که از بخش BSS \f(CW\*(C`.plt\*(C'\fR که توسط \fBld.so\fR
پر می‌شود استفاده کرده و نیازمند بخش‌های \f(CW\*(C`.plt\*(C'\fR و \f(CW\*(C`.got\*(C'\fR
است که هم قابل نوشتن و هم قابل اجرا باشند.
این یک گزینهٔ PowerPC برای SYSV ABI ۳۲ بیتی است.
.IP \fB\-msplit\-patch\-nops\fR 4
.IX Item "-msplit-patch-nops"
هنگام افزودن NOPها برای یک ناحیهٔ قابل وصله‌زنی از طریق گزینهٔ
\&\fB\-fpatchable\-function\-entry\fR، دستورات NOP «قبل» را پیش
از نقطهٔ ورود سراسری و NOPهای «بعد» را پس از نقطهٔ ورود محلی درج می‌کند.
این امر موجب می‌شود در زمان تولید نقطهٔ ورود سراسری، توالی NOPها
غیرمتوالی باشد. بدون این گزینه، NOPها مستقیماً پیش و
پس از نقطهٔ ورود محلی درج می‌شوند که آن‌ها را متوالی می‌سازد، اما فاصلهٔ نقطهٔ ورود سراسری
و محلی را بیشتر می‌کند. اگر تنها یک نقطهٔ ورود تولید شود،
این گزینه هیچ اثری نخواهد داشت.
.IP \fB\-misel\fR 4
.IX Item "-misel"
.PD 0
.IP \fB\-mno\-isel\fR 4
.IX Item "-mno-isel"
.PD
این سوئیچ تولید دستورالعمل‌های ISEL را فعال یا غیرفعال می‌کند.
.IP \fB\-mvsx\fR 4
.IX Item "-mvsx"
.PD 0
.IP \fB\-mno\-vsx\fR 4
.IX Item "-mno-vsx"
.PD
کدی تولید می‌کند که از دستورالعمل‌های برداری/نرده‌ای (VSX)
استفاده می‌کند (استفاده نمی‌کند)، و همچنین استفاده از توابع توکار را که دسترسی
مستقیم‌تر به مجموعه دستورالعمل‌های VSX را فراهم می‌سازند، فعال می‌کند.
.IP \fB\-mcrypto\fR 4
.IX Item "-mcrypto"
.PD 0
.IP \fB\-mno\-crypto\fR 4
.IX Item "-mno-crypto"
.PD
استفاده از توابع توکار (غیرفعال‌سازی) را که امکان دسترسی
مستقیم به دستورالعمل‌های رمزنگاری اضافه‌شده در نسخهٔ
2.07 از PowerPC ISA را می‌دهند، فعال می‌کند.
.IP \fB\-mhtm\fR 4
.IX Item "-mhtm"
.PD 0
.IP \fB\-mno\-htm\fR 4
.IX Item "-mno-htm"
.PD
استفاده از توابع توکار (غیرفعال‌سازی) را که امکان دسترسی
مستقیم به دستورالعمل‌های حافظه تراکنشی سخت‌افزاری (HTM) اضافه‌شده
در نسخهٔ 2.07 از PowerPC ISA را می‌دهند، فعال می‌کند.
.IP \fB\-mpower8\-fusion\fR 4
.IX Item "-mpower8-fusion"
.PD 0
.IP \fB\-mno\-power8\-fusion\fR 4
.IX Item "-mno-power8-fusion"
.PD
کدی تولید می‌کند که برخی از عملیات اعداد صحیح را در کنار یکدیگر
نگه می‌دارد (نگه نمی‌دارد) تا دستورالعمل‌ها بتوانند در پردازنده‌های power8
و پس از آن با یکدیگر ادغام (fuse) شوند.
.IP \fB\-mquad\-memory\fR 4
.IX Item "-mquad-memory"
.PD 0
.IP \fB\-mno\-quad\-memory\fR 4
.IX Item "-mno-quad-memory"
.PD
کدی تولید می‌کند که از دستورالعمل‌های غیراتمیک حافظه برای کلمهٔ چهارتایی (quad word)
استفاده می‌کند (استفاده نمی‌کند). گزینهٔ \fB\-mquad\-memory\fR نیازمند استفاده
از حالت ۶۴ بیتی است.
.IP \fB\-mquad\-memory\-atomic\fR 4
.IX Item "-mquad-memory-atomic"
.PD 0
.IP \fB\-mno\-quad\-memory\-atomic\fR 4
.IX Item "-mno-quad-memory-atomic"
.PD
کدی تولید می‌کند که از دستورالعمل‌های اتمیک حافظه برای کلمهٔ چهارتایی (quad word)
استفاده می‌کند (استفاده نمی‌کند). گزینهٔ \fB\-mquad\-memory\-atomic\fR نیازمند استفاده
از حالت ۶۴ بیتی است..IP \fB\-mfloat128\fR 4
.IX Item "-mfloat128"
.PD 0
.IP \fB\-mno\-float128\fR 4
.IX Item "-mno-float128"
.PD
فعال/غیرفعال کردن کلمه کلیدی \fI_\|_float128\fR برای ممیز شناور ۱۲۸ بیتی IEEE و استفاده از شبیه‌سازی نرم‌افزاری یا دستورالعمل‌های سخت‌افزاری برای ممیز شناور ۱۲۸ بیتی IEEE.
.Sp
مجموعه دستورالعمل VSX (\fB\-mvsx\fR) برای استفاده از پشتیبانی ممیز شناور ۱۲۸ بیتی IEEE باید فعال باشد. ممیز شناور ۱۲۸ بیتی IEEE فقط روی Linux پشتیبانی می‌شود.
.Sp
مقدار پیش‌فرض برای \fB\-mfloat128\fR در سیستم‌های PowerPC Linux با مجموعه دستورالعمل VSX فعال و در سایر سیستم‌ها غیرفعال است.
.Sp
اگر از مجموعه دستورالعمل ISA 3.0 (\fB\-mcpu=power9\fR) روی یک سیستم ۶۴ بیتی استفاده کنید، پشتیبانی ممیز شناور ۱۲۸ بیتی IEEE همچنین تولید دستورالعمل‌های سخت‌افزاری ممیز شناور ۱۲۸ بیتی IEEE مربوط به ISA 3.0 را فعال می‌کند. در غیر این صورت، اگر تولید دستورالعمل‌های ISA 3.0 را مشخص نکنید یا یک سیستم ۳۲ بیتی big\-endian را هدف قرار دهید، ممیز شناور ۱۲۸ بیتی IEEE با شبیه‌سازی نرم‌افزاری مدیریت می‌شود.
.IP \fB\-mfloat128\-hardware\fR 4
.IX Item "-mfloat128-hardware"
.PD 0
.IP \fB\-mno\-float128\-hardware\fR 4
.IX Item "-mno-float128-hardware"
.PD
فعال/غیرفعال کردن استفاده از دستورالعمل‌های سخت‌افزاری ISA 3.0 برای پشتیبانی از نوع داده‌ی \&\fI_\|_float128\fR.
.Sp
مقدار پیش‌فرض برای \fB\-mfloat128\-hardware\fR در سیستم‌های PowerPC Linux که از مجموعه دستورالعمل ISA 3.0 استفاده می‌کنند فعال و در سایر سیستم‌ها غیرفعال است.
.IP \fB\-m32\fR 4
.IX Item "-m32"
.PD 0
.IP \fB\-m64\fR 4
.IX Item "-m64"
.PD
تولید کد برای محیط‌های ۳۲ بیتی یا ۶۴ بیتی مقصدهای Darwin و SVR4 (شامل GNU/Linux). محیط ۳۲ بیتی مقادیر int، long و اشاره‌گر (pointer) را ۳۲ بیت تنظیم می‌کند و کدی تولید می‌کند که روی هر گونه‌ای از PowerPC اجرا می‌شود. محیط ۶۴ بیتی مقدار int را ۳۲ بیت و long و اشاره‌گر را ۶۴ بیت تنظیم کرده و مشابه \&\fB\-mpowerpc64\fR برای PowerPC64 کد تولید می‌کند.
.IP \fB\-mfull\-toc\fR 4
.IX Item "-mfull-toc"
.PD 0
.IP \fB\-mno\-fp\-in\-toc\fR 4
.IX Item "-mno-fp-in-toc"
.IP \fB\-mno\-sum\-in\-toc\fR 4
.IX Item "-mno-sum-in-toc"
.IP \fB\-mminimal\-toc\fR 4
.IX Item "-mminimal-toc"
.PD
تغییر نحوه‌ی ایجاد جدول محتویات یا TOC (Table Of Contents)، که برای هر فایل اجرایی ایجاد می‌شود. گزینه \fB\-mfull\-toc\fR به‌طور پیش‌فرض انتخاب شده است. در این حالت، GCC دست‌کم یک مدخل TOC برای هر ارجاع یکتای متغیرهای غیرخودکار در برنامه تخصیص می‌دهد. GCC همچنین مقادیر ثابت ممیز شناور را در TOC قرار می‌دهد. با این حال، تنها ۱۶٬۳۸۴ مدخل در TOC موجود است.
.Sp
اگر پیام خطایی از پیونددهنده دریافت کردید مبنی بر این‌که فضای در دسترس TOC سرریز شده است، می‌توانید با گزینه‌های \fB\-mno\-fp\-in\-toc\fR و \fB\-mno\-sum\-in\-toc\fR میزان فضای مصرفی TOC را کاهش دهید. گزینه \&\fB\-mno\-fp\-in\-toc\fR مانع از قرار دادن مقادیر ثابت ممیز شناور در TOC توسط GCC می‌شود و \fB\-mno\-sum\-in\-toc\fR باعث می‌شود GCC به‌جای قرار دادن حاصل‌جمع یک آدرس و یک مقدار ثابت در TOC، کدی تولید کند که این مجموع را در زمان اجرا محاسبه کند. می‌توانید یک یا هر دوی این گزینه‌ها را مشخص کنید. هر یک از آن‌ها به بهای صرفه‌جویی در فضای TOC، موجب تولید کدی اندکی کندتر و حجیم‌تر توسط GCC می‌شود.
.Sp
اگر حتی با مشخص کردن هر دوی این گزینه‌ها فضای TOC کم آمد، به‌جای آن‌ها \fB\-mminimal\-toc\fR را مشخص کنید. این گزینه موجب می‌شود GCC تنها یک مدخل TOC برای هر فایل ایجاد کند. با تعیین این گزینه، GCC کدی کندتر و حجیم‌تر تولید می‌کند که مصرف فضای TOC در آن فوق‌العاده اندک است. ممکن است ترجیح دهید از این گزینه تنها روی فایل‌هایی استفاده کنید که کدهای با بسامد اجرای کمتر دارند.
.IP \fB\-maix64\fR 4
.IX Item "-maix64"
.PD 0
.IP \fB\-maix32\fR 4
.IX Item "-maix32"
.PD
فعال‌سازی ABI و قرارداد فراخوانی ۶۴ بیتی AIX: اشاره‌گرهای ۶۴ بیتی، نوع ۶۴ بیتی \&\f(CW\*(C`long\*(C'\fR و زیرساخت مورد نیاز برای پشتیبانی از آن‌ها. مشخص کردن \fB\-maix64\fR متضمن \fB\-mpowerpc64\fR است، در حالی که \fB\-maix32\fR رابط ۶۴ بیتی ABI را غیرفعال کرده و متضمن \fB\-mno\-powerpc64\fR است. پیش‌فرض GCC گزینه \fB\-maix32\fR است.
.IP \fB\-mxl\-compat\fR 4
.IX Item "-mxl-compat"
.PD 0
.IP \fB\-mno\-xl\-compat\fR 4
.IX Item "-mno-xl-compat"
.PD
تولید کدی که هنگام استفاده از ABI سازگار با AIX، تطابق بیشتری با معناشناسی کامپایلر IBM XL داشته باشد. آرگومان‌های ممیز شناور توابعی که دارای اعلان الگوی اولیه (prototype) هستند را علاوه بر ثبات‌های FPR مخصوص آرگومان، روی پشته و فراتر از ناحیه ذخیره ثبات (RSA) ارسال می‌کند. هنگام مقایسه مقادیر و تبدیل به double، فرض نمی‌کند که باارزش‌ترین double در مقدار ۱۲۸ بیتی long double به‌درستی گرد شده است. همچنین از نام‌های نماد XL برای روال‌های پشتیبانی long double استفاده می‌کند.
.Sp
قرارداد فراخوانی AIX گسترش داده شده بود اما در ابتدا مستند نشده بود تا حالت نامتعارفی از K&R C را مدیریت کند؛ حالتی که در آن تابعی که آدرس آرگومان‌های خود را می‌گیرد، با آرگومان‌های کمتری نسبت به تعریفش فراخوانی می‌شود. کامپایلرهای IBM XL زمانی که یک زیرروال بدون بهینه‌سازی کامپایل شود، به آرگومان‌های ممیز شناوری که در RSA جا نمی‌شوند از طریق پشته دسترسی پیدا می‌کنند. از آنجا که ذخیره‌سازی همیشگی آرگومان‌های ممیز شناور روی پشته ناکارآمد است و به‌ندرت نیاز می‌شود، این گزینه به‌طور پیش‌فرض فعال نیست و تنها هنگام فراخوانی زیرروال‌هایی که توسط کامپایلرهای IBM XL بدون بهینه‌سازی کامپایل شده‌اند لازم خواهد بود.
.IP \fB\-mpe\fR 4
.IX Item "-mpe"
پشتیبانی از \fIIBM RS/6000 SP\fR \fIParallel Environment\fR (PE). پیوند دادن برنامه‌ای که برای استفاده از تبادل پیام نوشته شده است با کد راه‌اندازی ویژه جهت فعال‌سازی اجرای برنامه. سیستم باید PE را در مسیر استاندارد (\fI/usr/lpp/ppe.poe/\fR) نصب داشته باشد، یا فایل \fIspecs\fR باید با گزینه \fB\-specs=\fR جایگزین شود تا مسیر پوشه مناسب تعیین گردد. محیط Parallel Environment از رشته‌ها (threads) پشتیبانی نمی‌کند، بنابراین گزینه \fB\-mpe\fR و گزینه \fB\-pthread\fR ناسازگار هستند.
.IP \fB\-malign\-natural\fR 4
.IX Item "-malign-natural"
.PD 0
.IP \fB\-malign\-power\fR 4
.IX Item "-malign-power"
.PD
در AIX، نگارش ۳۲ بیتی Darwin و نگارش ۶۴ بیتی PowerPC GNU/Linux، گزینه \&\fB\-malign\-natural\fR هم‌ترازی تعریف‌شده در ABI برای انواع داده بزرگ‌تر، مانند doubleهای ممیز شناور را بر مبنای مرز اندازه طبیعی آن‌ها نادیده می‌گیرد (override). گزینه \fB\-malign\-power\fR به GCC دستور می‌دهد که از قوانین هم‌ترازی مشخص‌شده در ABI پیروی کند. پیش‌فرض GCC هم‌ترازی استاندارد تعریف‌شده در ABI است.
.Sp
در سیستم‌های ۶۴ بیتی Darwin، هم‌ترازی طبیعی حالت پیش‌فرض است و \fB\-malign\-power\fR پشتیبانی نمی‌شود.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
تولید کدی که از مجموعه ثبات‌های ممیز شناور استفاده نمی‌کند (می‌کند). در صورت استفاده از گزینه \&\fB\-msoft\-float\fR و ارسال آن به GCC هنگام پیوند، شبیه‌سازی نرم‌افزاری ممیز شناور ارائه می‌شود.
.IP \fB\-mmultiple\fR 4
.IX Item "-mmultiple"
.PD 0
.IP \fB\-mno\-multiple\fR 4
.IX Item "-mno-multiple"
.PD
تولید کدی که از دستورالعمل‌های بارگذاری چندکلمه‌ای (load multiple word) و ذخیره چندکلمه‌ای (store multiple word) استفاده می‌کند (نمی‌کند). این دستورالعمل‌ها به‌طور پیش‌فرض در سیستم‌های POWER تولید می‌شوند و در سیستم‌های PowerPC تولید نمی‌گردند. از \fB\-mmultiple\fR روی سیستم‌های PowerPC با ترتیب little\-endian استفاده نکنید، زیرا این دستورالعمل‌ها در شرایطی که پردازنده در حالت little\-endian است کار نمی‌کنند. موارد استثنا PPC740 و PPC750 هستند که این دستورالعمل‌ها را در حالت little\-endian مجاز می‌دانند.
.IP \fB\-mupdate\fR 4
.IX Item "-mupdate"
.PD 0
.IP \fB\-mno\-update\fR 4
.IX Item "-mno-update"
.PD
تولید کدی که از دستورالعمل‌های بارگذاری یا ذخیره‌ای استفاده می‌کند (نمی‌کند) که ثبات پایه را به آدرس مکان حافظه محاسبه‌شده به‌روز می‌کنند. این دستورالعمل‌ها به‌طور پیش‌فرض تولید می‌شوند. اگر از \&\fB\-mno\-update\fR استفاده کنید، بازه زمانی کوتاهی میان زمان به‌روزرسانی اشاره‌گر پشته و ذخیره آدرس چارچوب قبلی وجود خواهد داشت؛ به این معنا که کدی که در جریان وقفه‌ها یا سیگنال‌ها چارچوب پشته را می‌پیماید، ممکن است با داده‌های مخدوش مواجه شود.
.IP \fB\-mavoid\-indexed\-addresses\fR 4
.IX Item "-mavoid-indexed-addresses"
.PD 0
.IP \fB\-mno\-avoid\-indexed\-addresses\fR 4
.IX Item "-mno-avoid-indexed-addresses"
.PD
تولید کدی که تلاش می‌کند از استفاده از دستورالعمل‌های بارگذاری یا ذخیره نمایه‌شده اجتناب کند (اجتناب نکند). این دستورالعمل‌ها می‌توانند در پردازنده‌های Power6 در شرایط خاصی باعث کاهش کارایی شوند، مانند زمانی که در آرایه‌های بزرگی گام برداشته می‌شود که از یک مرز 16M عبور می‌کنند. این گزینه هنگام هدف‌گیری Power6 به‌طور پیش‌فرض فعال است و در غیر این صورت غیرفعال خواهد بود..IP \fB\-mfused\-madd\fR 4
.IX Item "-mfused-madd"
.PD 0
.IP \fB\-mno\-fused\-madd\fR 4
.IX Item "-mno-fused-madd"
.PD
تولید کدی که از دستورالعمل‌های ضرب و جمع ممیز شناور (فلوتینگ پوینت) استفاده کند (استفاده نکند). در صورت استفاده از ممیز شناور سخت‌افزاری، این دستورالعمل‌ها به صورت پیش‌فرض تولید می‌شوند. گزینهٔ وابسته به ماشین \fB\-mfused\-madd\fR اکنون به گزینهٔ مستقل از ماشین \fB\-ffp\-contract=fast\fR نگاشت شده، و \fB\-mno\-fused\-madd\fR به \fB\-ffp\-contract=off\fR نگاشت می‌شود.
.IP \fB\-mmulhw\fR 4
.IX Item "-mmulhw"
.PD 0
.IP \fB\-mno\-mulhw\fR 4
.IX Item "-mno-mulhw"
.PD
تولید کدی که از دستورالعمل‌های ضرب نیم‌کلمه (half-word) و ضرب\-جمع روی پردازنده‌های IBM 405، 440، 464 و 476 استفاده کند (استفاده نکند). این دستورالعمل‌ها هنگام هدف قرار دادن آن پردازنده‌ها به صورت پیش‌فرض تولید می‌شوند.
.IP \fB\-mdlmzb\fR 4
.IX Item "-mdlmzb"
.PD 0
.IP \fB\-mno\-dlmzb\fR 4
.IX Item "-mno-dlmzb"
.PD
تولید کدی که از دستورالعمل جستجوی رشتهٔ \fBdlmzb\fR در پردازنده‌های IBM 405، 440، 464 و 476 استفاده کند (استفاده نکند). این دستورالعمل هنگام هدف قرار دادن آن پردازنده‌ها به صورت پیش‌فرض تولید می‌شود.
.IP \fB\-mno\-bit\-align\fR 4
.IX Item "-mno-bit-align"
.PD 0
.IP \fB\-mbit\-align\fR 4
.IX Item "-mbit-align"
.PD
روی System V.4 و سیستم‌های توکار PowerPC، ساختارها و اجتماع‌هایی که شامل فیلدهای بیتی هستند را برای تراز شدن با نوع پایهٔ فیلد بیتی، مجبور نمی‌کند (می‌کند).
.Sp
برای مثال، به طور پیش‌فرض ساختاری که چیزی جز ۸ فیلد بیتی \f(CW\*(C`unsigned\*(C'\fR با طول ۱ ندارد، در یک مرز ۴ بایتی تراز می‌شود و اندازه‌ای برابر با ۴ بایت دارد. با استفاده از \fB\-mno\-bit\-align\fR، ساختار در یک مرز ۱ بایتی تراز شده و اندازهٔ آن ۱ بایت خواهد بود.
.IP \fB\-mbit\-word\fR 4
.IX Item "-mbit-word"
.PD 0
.IP \fB\-mno\-bit\-word\fR 4
.IX Item "-mno-bit-word"
.PD
اجازه دادن به فیلدهای بیتی برای عبور از مرزهای کلمه (word).
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD 0
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD
روی System V.4 و سیستم‌های توکار PowerPC، فرض نمی‌کند (می‌کند) که ارجاعات حافظهٔ ترازنشده توسط سیستم مدیریت می‌شوند.
.IP \fB\-mrelocatable\fR 4
.IX Item "-mrelocatable"
.PD 0
.IP \fB\-mno\-relocatable\fR 4
.IX Item "-mno-relocatable"
.PD
تولید کدی که به یک فایل اجرایی ایستا اجازه می‌دهد (اجازه نمی‌دهد) در زمان اجرا به آدرس دیگری بازنشانی (relocate) شود. بارگذار یک سیستم توکار سادهٔ PowerPC باید تمام محتویات بخش \f(CW\*(C`.got2\*(C'\fR و مکان‌های ۴ بایتی فهرست‌شده در بخش \f(CW\*(C`.fixup\*(C'\fR (جدولی از آدرس‌های ۳۲ بیتی تولید شده توسط این گزینه) را بازنشانی کند. برای اینکه این سازوکار کار کند، تمام اشیای پیوند داده‌شده با یکدیگر باید با \fB\-mrelocatable\fR یا \fB\-mrelocatable\-lib\fR کامپایل شوند. کد کامپایل‌شده با \fB\-mrelocatable\fR پشته را در مرز ۸ بایتی تراز می‌کند.
.IP \fB\-mrelocatable\-lib\fR 4
.IX Item "-mrelocatable-lib"
.PD 0
.IP \fB\-mno\-relocatable\-lib\fR 4
.IX Item "-mno-relocatable-lib"
.PD
مانند \fB\-mrelocatable\fR، گزینهٔ \fB\-mrelocatable\-lib\fR نیز یک بخش \f(CW\*(C`.fixup\*(C'\fR تولید می‌کند تا به فایل‌های اجرایی ایستا امکان بازنشانی در زمان اجرا داده شود، اما \fB\-mrelocatable\-lib\fR از تراز پشتهٔ کوچک‌ترِ \fB\-mrelocatable\fR استفاده نمی‌کند. اشیای کامپایل‌شده با \fB\-mrelocatable\-lib\fR را می‌توان با اشیایی که با هر ترکیبی از گزینه‌های \fB\-mrelocatable\fR کامپایل شده‌اند پیوند داد.
.IP \fB\-mlittle\fR 4
.IX Item "-mlittle"
.PD 0
.IP \fB\-mlittle\-endian\fR 4
.IX Item "-mlittle-endian"
.PD
روی System V.4 و سیستم‌های توکار PowerPC، کد را برای پردازنده در حالت بایت‌کوچک (little-endian) کامپایل می‌کند. گزینهٔ \fB\-mlittle\-endian\fR همانند \fB\-mlittle\fR است.
.IP \fB\-mbig\fR 4
.IX Item "-mbig"
.PD 0
.IP \fB\-mbig\-endian\fR 4
.IX Item "-mbig-endian"
.PD
روی System V.4 و سیستم‌های توکار PowerPC، کد را برای پردازنده در حالت بایت‌بزرگ (big-endian) کامپایل می‌کند. گزینهٔ \fB\-mbig\-endian\fR همانند \fB\-mbig\fR است.
.IP \fB\-mdynamic\-no\-pic\fR 4
.IX Item "-mdynamic-no-pic"
در سیستم‌های Darwin / macOS، کد را طوری کامپایل می‌کند که خودِ آن قابل بازنشانی نباشد، اما مراجع خارجی آن قابل بازنشانی باشند. کد حاصل برای برنامه‌های کاربردی مناسب است، اما نه برای کتابخانه‌های مشترک.
.IP \fB\-msingle\-pic\-base\fR 4
.IX Item "-msingle-pic-base"
با ثباتی که برای آدرس‌دهی PIC استفاده می‌شود به عنوان فقط‌خواندنی رفتار می‌کند، به جای اینکه در مقدمهٔ هر تابع بارگذاری شود. سیستم زمان اجرا مسئول مقداردهی اولیهٔ این ثبات با یک مقدار مناسب پیش از شروع اجرا است.
.IP \fB\-mprioritize\-restricted\-insns=\fR\fIpriority\fR 4
.IX Item "-mprioritize-restricted-insns=priority"
این گزینه اولویتی را که به دستورالعمل‌های محدود به شیار اعزام در طول گذر دوم زمان‌بندی اختصاص می‌یابد، کنترل می‌کند. آرگومان \fIpriority\fR یکی از مقادیر \fB0\fR، \fB1\fR یا \fB2\fR را می‌گیرد تا به ترتیب اولویت هیچ، بالاترین، یا دومین اولویت بالا را به دستورالعمل‌های محدود به شیار اعزام اختصاص دهد.
.IP \fB\-msched\-costly\-dep=\fR\fIdependence_type\fR 4
.IX Item "-msched-costly-dep=dependence_type"
این گزینه کنترل می‌کند که کدام وابستگی‌ها در طول زمان‌بندی دستورالعمل توسط هدف پرهزینه در نظر گرفته شوند. آرگومان \fIdependence_type\fR یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBno\fR 4
.IX Item "no"
هیچ وابستگی‌ای پرهزینه نیست.
.IP \fBall\fR 4
.IX Item "all"
تمام وابستگی‌ها پرهزینه هستند.
.IP \fBtrue_store_to_load\fR 4
.IX Item "true_store_to_load"
وابستگی واقعی از ذخیره‌سازی به بارگذاری (store to load) پرهزینه است.
.IP \fBstore_to_load\fR 4
.IX Item "store_to_load"
هرگونه وابستگی از ذخیره‌سازی به بارگذاری پرهزینه است.
.IP \fInumber\fR 4
.IX Item "number"
هر وابستگی‌ای که تأخیر آن بزرگ‌تر یا مساوی با \fInumber\fR باشد پرهزینه است.
.RE
.RS 4
.RE
.IP \fB\-minsert\-sched\-nops=\fR\fIscheme\fR 4
.IX Item "-minsert-sched-nops=scheme"
این گزینه تعیین می‌کند که در گذر دوم زمان‌بندی از کدام طرح درج NOP استفاده شود. آرگومان \fIscheme\fR یکی از مقادیر زیر را می‌پذیرد:
.RS 4
.IP \fBno\fR 4
.IX Item "no"
دستورهای NOP درج نشوند.
.IP \fBpad\fR 4
.IX Item "pad"
پر کردن هر گروه اعزام که شکاف‌های صدور خالی دارد با NOP، بر اساس گروه‌بندی زمان‌بند.
.IP \fBregroup_exact\fR 4
.IX Item "regroup_exact"
درج NOPها برای وادار کردن دستورهای وابستهٔ پرهزینه به رفتن در گروه‌های جداگانه. درج دقیقاً به همان تعداد NOP که بر اساس گروه‌بندی تخمینی پردازنده، برای راندن یک دستور به یک گروه جدید لازم است.
.IP \fInumber\fR 4
.IX Item "number"
درج NOPها برای وادار کردن دستورهای وابستهٔ پرهزینه به رفتن در گروه‌های جداگانه. درج \fInumber\fR دستور NOP برای انتقال یک دستور به گروه جدید.
.RE
.RS 4
.RE
.IP \fB\-mcall\-sysv\fR 4
.IX Item "-mcall-sysv"
روی System V.4 و سیستم‌های توکار PowerPC، کد را با استفاده از قراردادهای فراخوانی که به پیش‌نویس مارس ۱۹۹۵ از مکمل رابط باینری کاربردی System V برای پردازندهٔ PowerPC پایبند هستند، کامپایل می‌کند. این حالت پیش‌فرض است، مگر اینکه GCC را با استفاده از \fBpowerpc\-*\-eabiaix\fR پیکربندی کرده باشید..IP \fB\-mcall\-sysv\-eabi\fR 4
.IX Item "-mcall-sysv-eabi"
.PD 0
.IP \fB\-mcall\-eabi\fR 4
.IX Item "-mcall-eabi"
.PD
مشخص کردن هر دو گزینهٔ \fB\-mcall\-sysv\fR و \fB\-meabi\fR.
.IP \fB\-mcall\-sysv\-noeabi\fR 4
.IX Item "-mcall-sysv-noeabi"
مشخص کردن هر دو گزینهٔ \fB\-mcall\-sysv\fR و \fB\-mno\-eabi\fR.
.IP \fB\-mcall\-aixdesc\fR 4
.IX Item "-mcall-aixdesc"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، کد را برای سیستم‌عامل AIX کامپایل می‌کند.
.IP \fB\-mcall\-linux\fR 4
.IX Item "-mcall-linux"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، کد را برای سیستم گنو مبتنی بر لینوکس کامپایل می‌کند.
.IP \fB\-mcall\-freebsd\fR 4
.IX Item "-mcall-freebsd"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، کد را برای سیستم‌عامل FreeBSD کامپایل می‌کند.
.IP \fB\-mcall\-netbsd\fR 4
.IX Item "-mcall-netbsd"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، کد را برای سیستم‌عامل NetBSD کامپایل می‌کند.
.IP \fB\-mcall\-openbsd\fR 4
.IX Item "-mcall-openbsd"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، کد را برای سیستم‌عامل OpenBSD کامپایل می‌کند.
.IP \fB\-mtraceback=\fR\fItraceback_type\fR 4
.IX Item "-mtraceback=traceback_type"
انتخاب نوع جدول traceback. مقادیر معتبر برای \fItraceback_type\fR عبارت‌اند از \fBfull\fR، \fBpart\fR و \fBno\fR.
.IP \fB\-maix\-struct\-return\fR 4
.IX Item "-maix-struct-return"
بازگرداندن تمام ساختارها در حافظه (همان‌طور که در ABI مربوط به AIX مشخص شده است).
.IP \fB\-msvr4\-struct\-return\fR 4
.IX Item "-msvr4-struct-return"
بازگرداندن ساختارهای کوچک‌تر از ۸ بایت در ثبات‌ها (همان‌طور که در ABI مربوط به SVR4 مشخص شده است).
.IP \fB\-mabi=\fR\fIabi\-type\fR 4
.IX Item "-mabi=abi-type"
گسترش ABI فعلی با یک افزونهٔ خاص، یا حذف چنین افزونه‌ای.
مقادیر معتبر عبارت‌اند از: \fBaltivec\fR، \fBno\-altivec\fR،
\&\fBibmlongdouble\fR، \fBieeelongdouble\fR،
\&\fBelfv1\fR، \fBelfv2\fR،
و برای AIX: \fBvec\-extabi\fR، \fBvec\-default\fR.
.IP \fB\-mabi=ibmlongdouble\fR 4
.IX Item "-mabi=ibmlongdouble"
تغییر ABI فعلی برای استفاده از long double با دقت گسترش‌یافتهٔ IBM.
اگر پیش‌فرض سیستم شما استفاده از long double با دقت گسترش‌یافتهٔ IEEE باشد، احتمالاً این گزینه کار نخواهد کرد. اگر نوع long double را از دقت گسترش‌یافتهٔ IEEE تغییر دهید، کامپایلر هشداری صادر می‌کند مگر اینکه از گزینهٔ \fB\-Wno\-psabi\fR استفاده کنید.
نیازمند فعال بودن \fB\-mlong\-double\-128\fR است.
.IP \fB\-mabi=ieeelongdouble\fR 4
.IX Item "-mabi=ieeelongdouble"
تغییر ABI فعلی برای استفاده از long double با دقت گسترش‌یافتهٔ IEEE.
اگر پیش‌فرض سیستم شما استفاده از long double با دقت گسترش‌یافتهٔ IBM باشد، احتمالاً این گزینه کار نخواهد کرد. اگر نوع long double را از دقت گسترش‌یافتهٔ IBM تغییر دهید، کامپایلر هشداری صادر می‌کند مگر اینکه از گزینهٔ \fB\-Wno\-psabi\fR استفاده کنید.
نیازمند فعال بودن \fB\-mlong\-double\-128\fR است.
.IP \fB\-mabi=elfv1\fR 4
.IX Item "-mabi=elfv1"
تغییر ABI فعلی برای استفاده از ELFv1 ABI.
این ABI پیش‌فرض برای لینوکس ۶۴ بیتی PowerPC با ترتیب بایت بزرگ‌تر (big\-endian) است.
بازنویسی ABI پیش‌فرض نیازمند پشتیبانی سیستمی ویژه‌ای است و احتمالاً به شکل‌های غیرمنتظره و شدیدی شکست خواهد خورد.
.IP \fB\-mabi=elfv2\fR 4
.IX Item "-mabi=elfv2"
تغییر ABI فعلی برای استفاده از ELFv2 ABI.
این ABI پیش‌فرض برای لینوکس ۶۴ بیتی PowerPC با ترتیب بایت کوچک‌تر (little\-endian) است.
بازنویسی ABI پیش‌فرض نیازمند پشتیبانی سیستمی ویژه‌ای است و احتمالاً به شکل‌های غیرمنتظره و شدیدی شکست خواهد خورد.
.IP \fB\-mgnu\-attribute\fR 4
.IX Item "-mgnu-attribute"
.PD 0
.IP \fB\-mno\-gnu\-attribute\fR 4
.IX Item "-mno-gnu-attribute"
.PD
تولید دستورالعمل‌های اسمبلی .gnu_attribute برای تنظیم جفت‌های برچسب/مقدار در بخش \&.gnu.attributes که دگرگونی‌های ABI را در پارامترهای توابع یا مقادیر بازگشتی مشخص می‌کنند.
.IP \fB\-mprototype\fR 4
.IX Item "-mprototype"
.PD 0
.IP \fB\-mno\-prototype\fR 4
.IX Item "-mno-prototype"
.PD
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC فرض می‌کند که تمام فراخوانی‌ها به توابع با آرگومان‌های متغیر به درستی پیش‌نمونه‌سازی (prototyped) شده‌اند. در غیر این صورت، کامپایلر باید پیش از هر فراخوانی فاقد پیش‌نمونه، یک دستورالعمل برای تنظیم یا پاک کردن بیت ۶ ثبات کد وضعیت (\f(CW\*(C`CR\*(C'\fR) درج کند تا مشخص شود که آیا در صورت دریافت آرگومان‌های متغیر، مقادیر ممیز شناور در ثبات‌های ممیز شناور ارسال می‌شوند یا خیر. با گزینهٔ \&\fB\-mprototype\fR، تنها فراخوانی‌های دارای پیش‌نمونه به توابع با آرگومان متغیر این بیت را تنظیم یا پاک می‌کنند.
.IP \fB\-msim\fR 4
.IX Item "-msim"
در سامانه‌های توکار PowerPC، فرض می‌کند که نام ماژول راه‌اندازی \&\fIsim\-crt0.o\fR است و کتابخانه‌های استاندارد C شامل \&\fIlibsim.a\fR و \&\fIlibc.a\fR هستند. این حالت پیش‌فرض برای پیکربندی‌های \fBpowerpc\-*\-eabisim\fR است.
.IP \fB\-mmvme\fR 4
.IX Item "-mmvme"
در سامانه‌های توکار PowerPC، فرض می‌کند که نام ماژول راه‌اندازی \&\fIcrt0.o\fR است و کتابخانه‌های استاندارد C شامل \fIlibmvme.a\fR و \&\fIlibc.a\fR هستند.
.IP \fB\-mads\fR 4
.IX Item "-mads"
در سامانه‌های توکار PowerPC، فرض می‌کند که نام ماژول راه‌اندازی \&\fIcrt0.o\fR است و کتابخانه‌های استاندارد C شامل \fIlibads.a\fR و \&\fIlibc.a\fR هستند.
.IP \fB\-myellowknife\fR 4
.IX Item "-myellowknife"
در سامانه‌های توکار PowerPC، فرض می‌کند که نام ماژول راه‌اندازی \&\fIcrt0.o\fR است و کتابخانه‌های استاندارد C شامل \fIlibyk.a\fR و \&\fIlibc.a\fR هستند.
.IP \fB\-mvxworks\fR 4
.IX Item "-mvxworks"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، مشخص می‌کند که شما برای یک سیستم VxWorks کامپایل می‌کنید.
.IP \fB\-memb\fR 4
.IX Item "-memb"
در سامانه‌های توکار PowerPC، بیت \f(CW\*(C`PPC_EMB\*(C'\fR را در هدر پرچم‌های ELF تنظیم می‌کند تا نشان دهد که بازآرایی‌های گسترش‌یافتهٔ \fBeabi\fR استفاده شده‌اند.
.IP \fB\-meabi\fR 4
.IX Item "-meabi"
.PD 0
.IP \fB\-mno\-eabi\fR 4
.IX Item "-mno-eabi"
.PD
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، از مشخصات رابط دودویی برنامه‌های توکار (EABI) که مجموعه‌ای از اصلاحات روی ویژگی‌های System V.4 است، پیروی می‌کند (یا نمی‌کند). انتخاب \fB\-meabi\fR به این معنی است که پشته روی یک مرز ۸ بایتی هم‌تراز می‌شود، تابع \&\f(CW\*(C`_\|_eabi\*(C'\fR از \f(CW\*(C`main\*(C'\fR فراخوانی می‌شود تا محیط EABI را برپا کند، و گزینهٔ \fB\-msdata\fR می‌تواند از هر دو ثبات \f(CW\*(C`r2\*(C'\fR و \&\f(CW\*(C`r13\*(C'\fR برای اشاره به دو ناحیهٔ داده‌های کوچک مجزا استفاده کند. انتخاب \&\fB\-mno\-eabi\fR بدین معنی است که پشته روی یک مرز ۱۶ بایتی هم‌تراز می‌شود، هیچ تابع مقداردهی اولیهٔ EABI از \f(CW\*(C`main\*(C'\fR فراخوانی نمی‌شود، و گزینهٔ \&\fB\-msdata\fR تنها از \f(CW\*(C`r13\*(C'\fR برای اشاره به یک ناحیهٔ داده‌های کوچک منفرد استفاده می‌کند. اگر GCC را با استفاده از یکی از گزینه‌های \fBpowerpc*\-*\-eabi*\fR پیکربندی کرده باشید، گزینهٔ \fB\-meabi\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-msdata=eabi\fR 4
.IX Item "-msdata=eabi"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، داده‌های سراسری و ایستای کوچک و مقداردهی‌شدهٔ \&\f(CW\*(C`const\*(C'\fR را در بخش \f(CW\*(C`.sdata2\*(C'\fR قرار می‌دهد که توسط ثبات \f(CW\*(C`r2\*(C'\fR به آن اشاره می‌شود. داده‌های سراسری و ایستای کوچک و مقداردهی‌شدهٔ غیر\-\f(CW\*(C`const\*(C'\fR را در بخش \f(CW\*(C`.sdata\*(C'\fR قرار می‌دهد که توسط ثبات \f(CW\*(C`r13\*(C'\fR به آن اشاره می‌شود. داده‌های سراسری و ایستای کوچک و مقداردهی‌نشده را در بخش \f(CW\*(C`.sbss\*(C'\fR قرار می‌دهد که هم‌جوار بخش \f(CW\*(C`.sdata\*(C'\fR است. گزینهٔ \fB\-msdata=eabi\fR با گزینهٔ \fB\-mrelocatable\fR ناسازگار است. گزینهٔ \&\fB\-msdata=eabi\fR همچنین گزینهٔ \fB\-memb\fR را نیز تنظیم می‌کند.
.IP \fB\-msdata=sysv\fR 4
.IX Item "-msdata=sysv"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، داده‌های سراسری و ایستای کوچک را در بخش \f(CW\*(C`.sdata\*(C'\fR قرار می‌دهد که توسط ثبات \&\f(CW\*(C`r13\*(C'\fR به آن اشاره می‌شود. داده‌های سراسری و ایستای کوچک و مقداردهی‌نشده را در بخش \&\f(CW\*(C`.sbss\*(C'\fR قرار می‌دهد که هم‌جوار با بخش \f(CW\*(C`.sdata\*(C'\fR است. گزینهٔ \fB\-msdata=sysv\fR با گزینهٔ \&\fB\-mrelocatable\fR ناسازگار است.
.IP \fB\-msdata=default\fR 4
.IX Item "-msdata=default"
.PD 0
.IP \fB\-msdata\fR 4
.IX Item "-msdata"
.PD
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، اگر \fB\-meabi\fR استفاده شود، کد را همانند \fB\-msdata=eabi\fR کامپایل می‌کند؛ در غیر این صورت کد را همانند \fB\-msdata=sysv\fR کامپایل می‌کند.
.IP \fB\-msdata=data\fR 4
.IX Item "-msdata=data"
در سیستم‌های System V.4 و سامانه‌های توکار PowerPC، داده‌های سراسری کوچک را در بخش \f(CW\*(C`.sdata\*(C'\fR قرار می‌دهد. داده‌های سراسری کوچک و مقداردهی‌نشده را در بخش \f(CW\*(C`.sbss\*(C'\fR قرار می‌دهد. با این حال، از ثبات \f(CW\*(C`r13\*(C'\fR برای آدرس‌دهی داده‌های کوچک استفاده نمی‌کند. این رفتار پیش‌فرض است مگر اینکه از گزینه‌های دیگر \fB\-msdata\fR استفاده شده باشد..IP \fB\-msdata=none\fR 4
.IX Item "-msdata=none"
.PD 0
.IP \fB\-mno\-sdata\fR 4
.IX Item "-mno-sdata"
.PD
در سامانه‌های تعبیه‌شدهٔ PowerPC، تمام داده‌های سراسری و ایستای مقداردهی اولیه‌شده را در بخش \f(CW\*(C`.data\*(C'\fR و تمام داده‌های مقداردهی‌نشده را در بخش \f(CW\*(C`.bss\*(C'\fR قرار می‌دهد.
.IP \fB\-mreadonly\-in\-sdata\fR 4
.IX Item "-mreadonly-in-sdata"
اشیاء فقط‌خواندنی را نیز در بخش \f(CW\*(C`.sdata\*(C'\fR قرار می‌دهد. این رفتار پیش‌فرض است.
.IP \fB\-mblock\-move\-inline\-limit=\fR\fInum\fR 4
.IX Item "-mblock-move-inline-limit=num"
تمام انتقال‌های بلوکی (مانند فراخوانی‌های \f(CW\*(C`memcpy\*(C'\fR یا رونوشت‌های ساختار) با اندازهٔ کمتر یا مساوی با \fInum\fR بایت را درون‌خطی (inline) می‌کند. حداقل مقدار برای \fInum\fR در مقصدهای ۳۲ بیتی برابر با ۳۲ بایت و در مقصدهای ۶۴ بیتی برابر با ۶۴ بایت است. مقدار پیش‌فرض بسته به مقصد متغیر است.
.IP \fB\-mblock\-compare\-inline\-limit=\fR\fInum\fR 4
.IX Item "-mblock-compare-inline-limit=num"
برای تمام مقایسه‌های بلوکی (مانند فراخوانی‌های \f(CW\*(C`memcmp\*(C'\fR یا مقایسه‌های ساختار) که کمتر یا مساوی با \fInum\fR بایت هستند، کد درون‌خطی غیرحلقه‌ای تولید می‌کند. اگر \fInum\fR برابر با 0 باشد، تمام بسط‌های درون‌خطی (حلقه‌ای و غیرحلقه‌ای) مقایسهٔ بلوک غیرفعال می‌شوند. مقدار پیش‌فرض بسته به مقصد تعیین می‌شود.
.IP \fB\-mblock\-compare\-inline\-loop\-limit=\fR\fInum\fR 4
.IX Item "-mblock-compare-inline-loop-limit=num"
یک بسط درون‌خطی با استفاده از کد حلقه‌ای برای تمام مقایسه‌های بلوکی تولید می‌کند که طول آن‌ها کمتر یا مساوی با \fInum\fR بایت بوده، اما از حد مجاز بسط درون‌خطی غیرحلقه‌ای بیشتر است. اگر طول بلوک ثابت نباشد، حداکثر \fInum\fR بایت قبل از این‌که \f(CW\*(C`memcmp\*(C'\fR برای مقایسهٔ باقی‌ماندهٔ بلوک فراخوانی شود، مقایسه می‌گردد. مقدار پیش‌فرض بسته به مقصد تعیین می‌شود.
.IP \fB\-mstring\-compare\-inline\-limit=\fR\fInum\fR 4
.IX Item "-mstring-compare-inline-limit=num"
حداکثر \fInum\fR بایت از رشته را با کد درون‌خطی مقایسه می‌کند. اگر تفاوت یا پایان رشته تا انتهای مقایسهٔ درون‌خطی مشخص نشود، فراخوانی \f(CW\*(C`strcmp\*(C'\fR یا \f(CW\*(C`strncmp\*(C'\fR باقی مقایسه را انجام می‌دهد. مقدار پیش‌فرض ۶۴ بایت است.
.IP "\fB\-G\fR \fInum\fR" 4
.IX Item "-G num"
در سامانه‌های تعبیه‌شدهٔ PowerPC، متغیرهای سراسری و ایستایی را که اندازهٔ آن‌ها کمتر یا مساوی با \fInum\fR بایت است، به‌جای بخش‌های عادی data یا BSS، در بخش‌های داده‌های کوچک (small data) یا BSS قرار می‌دهد. به‌طور پیش‌فرض، مقدار \fInum\fR برابر با 8 است. سوئیچ \fB\-G\fR \fInum\fR به پیونددهنده (linker) نیز فرستاده می‌شود. تمام پیمانه‌ها باید با مقدار یکسان \fB\-G\fR \fInum\fR همگردانی شوند.
.IP \fB\-mregnames\fR 4
.IX Item "-mregnames"
.PD 0
.IP \fB\-mno\-regnames\fR 4
.IX Item "-mno-regnames"
.PD
در System V.4 و سامانه‌های تعبیه‌شدهٔ PowerPC، نام ثبات‌ها را در خروجی زبان اسمبلی با استفاده از اشکال نمادین درج می‌کند (یا درج نمی‌کند).
.IP \fB\-mlongcall\fR 4
.IX Item "-mlongcall"
.PD 0
.IP \fB\-mno\-longcall\fR 4
.IX Item "-mno-longcall"
.PD
به‌طور پیش‌فرض فرض می‌کند که تمام فراخوانی‌ها دوردست هستند، به‌طوری که یک توالی فراخوانی طولانی‌تر و پرهزینه‌تر مورد نیاز است. این امر برای فراخوانی‌هایی که دورتر از ۳۲ مگابایت (۳۳٬۵۵۴٬۴۳۲ بایت) از مکان فعلی هستند الزامی است. اگر کامپایلر بداند که فراخوانی نمی‌تواند تا این اندازه دور باشد، یک فراخوانی کوتاه (short call) تولید می‌شود. این تنظیم را می‌توان توسط صفت تابع \f(CW\*(C`shortcall\*(C'\fR یا دستور \f(CW#pragma longcall(0)\fR لغو کرد.
.Sp
برخی پیونددهنده‌ها قادرند فراخوانی‌های خارج از محدوده را شناسایی کرده و کدهای رابط (glue code) را بی‌درنگ ایجاد کنند. در این سامانه‌ها، فراخوانی‌های طولانی غیرضروری بوده و کد کندتری تولید می‌کنند. در زمان نگارش این متن، پیونددهندهٔ AIX و همچنین پیونددهندهٔ GNU برای PowerPC/64 قادر به انجام این کار هستند. برنامه‌ریزی شده است که این ویژگی به پیونددهندهٔ GNU برای سامانه‌های ۳۲ بیتی PowerPC نیز افزوده شود.
.Sp
در سامانه‌های PowerPC64 ELFv2 و سامانه‌های ۳۲ بیتی PowerPC با پیونددهنده‌های جدیدتر GNU، کامپایلر GCC می‌تواند با استفاده از یک توالی فراخوانی PLT درون‌خطی، فراخوانی‌های دوردست را تولید کند (ببینید: \fB\-mpltseq\fR). سامانهٔ PowerPC با گزینهٔ \fB\-mbss\-plt\fR و سامانه‌های PowerPC64 ELFv1 (بزرگ‌پایان) از فراخوانی‌های درون‌خطی PLT پشتیبانی نمی‌کنند.
.Sp
در سامانه‌های Darwin/PPC، دستور \f(CW\*(C`#pragma longcall\*(C'\fR عبارت \f(CW\*(C`jbsr callee, L42\*(C'\fR را به همراه یک \fIbranch island\fR (کد واسط) تولید می‌کند. دو نشانی مقصد نمایانگر تابع فراخوانده‌شده (callee) و جزیرهٔ انشعاب (branch island) هستند. پیونددهندهٔ Darwin/PPC نشانی اول را ترجیح می‌دهد و اگر دستور \f(CW\*(C`bl\*(C'\fR در PPC مستقیماً به تابع فراخوانده‌شده برسد، یک \f(CW\*(C`bl callee\*(C'\fR تولید می‌کند؛ در غیر این صورت، پیونددهنده عبارت \f(CW\*(C`bl L42\*(C'\fR را برای فراخوانی جزیرهٔ انشعاب ایجاد می‌نماید. جزیرهٔ انشعاب به بدنهٔ تابع فراخواننده ضمیمه می‌شود؛ این بخش، نشانی کامل ۳۲ بیتی تابع فراخوانده‌شده را محاسبه کرده و به آن پرش می‌کند.
.Sp
در سامانه‌های Mach\-O (Darwin)، این گزینه کامپایلر را هدایت می‌کند تا کد واسط را برای هر فراخوانی مستقیم ایجاد کند و پیونددهندهٔ Darwin تصمیم می‌گیرد که از آن استفاده کند یا آن را کنار بگذارد.
.Sp
در آینده، ممکن است GCC تمام تعاریف longcall را هنگامی که مشخص باشد پیونددهنده کدهای واسط تولید می‌کند، نادیده بگیرد.
.IP \fB\-mpltseq\fR 4
.IX Item "-mpltseq"
.PD 0
.IP \fB\-mno\-pltseq\fR 4
.IX Item "-mno-pltseq"
.PD
ویژگی \-fno\-plt و فراخوانی‌های طولانی را با استفاده از یک توالی فراخوانی PLT درون‌خطی پیاده‌سازی می‌کند (یا نمی‌کند) که از پیوند تنبل (lazy linking) و فراخوانی‌های طولانی به توابع در کتابخانه‌های مشترک بارگذاری‌شده با dlopen پشتیبانی می‌نماید. فراخوانی‌های درون‌خطی PLT فقط در PowerPC64 ELFv2 و سامانه‌های ۳۲ بیتی PowerPC با پیونددهنده‌های جدیدتر GNU پشتیبانی می‌شوند؛ در صورت شناسایی این پشتیبانی در هنگام پیکربندی GCC و در مورد سامانه‌های ۳۲ بیتی PowerPC در صورتی که GCC با \fB\-\-enable\-secureplt\fR پیکربندی شده باشد، به‌طور پیش‌فرض فعال هستند. کدهای تولیدشده با \fB\-mpltseq\fR و اشیاء بازنشانی‌پذیر (relocatable) ۳۲ بیتی PowerPC با \fB\-mbss\-plt\fR نباید با یکدیگر پیوند داده شوند.
.IP \fB\-mtls\-markers\fR 4
.IX Item "-mtls-markers"
.PD 0
.IP \fB\-mno\-tls\-markers\fR 4
.IX Item "-mno-tls-markers"
.PD
فراخوانی‌های \f(CW\*(C`_\|_tls_get_addr\*(C'\fR را با یک بازنشانی (relocation) که آرگومان تابع را تعیین می‌کند، علامت‌گذاری می‌کند (یا نمی‌کند). این بازنشانی به پیونددهنده امکان می‌دهد فراخوانی تابع را برای بهینه‌سازی TLS با دستورالعمل‌های راه‌اندازی آرگومان پیوند دهد، که این امر به نوبهٔ خود به GCC اجازه می‌دهد زمان‌بندی بهتری برای این توالی انجام دهد.
.IP \fB\-mrecip\fR 4
.IX Item "-mrecip"
.PD 0
.IP \fB\-mno\-recip\fR 4
.IX Item "-mno-recip"
.PD
این گزینه استفاده از دستورالعمل‌های برآورد معکوس و برآورد ریشهٔ دوم معکوس را به همراه گام‌های اضافی نیوتن\-رافسون (Newton\-Raphson) برای افزایش دقت به‌جای تقسیم یا جذر و تقسیم برای آرگومان‌های ممیز شناور فعال می‌کند. هنگام استفاده از \fB\-mrecip\fR باید گزینهٔ \fB\-ffast\-math\fR (یا حداقل گزینه‌های \fB\-funsafe\-math\-optimizations\fR،\ \fB\-ffinite\-math\-only\fR، \fB\-freciprocal\-math\fR و \fB\-fno\-trapping\-math\fR) را به کار ببرید. توجه داشته باشید در حالی که توان پردازشی توالی عموماً بالاتر از دستورالعمل‌های غیرمعکوس است، دقت توالی برای ریشه‌های دوم معکوس می‌تواند تا 2 ulp کاهش یابد (برای نمونه، معکوس 1.0 برابر با 0.99999994 می‌شود).
.IP \fB\-mrecip=\fR\fIopt\fR 4
.IX Item "-mrecip=opt"
این گزینه مشخص می‌کند کدام دستورالعمل‌های برآورد معکوس می‌توانند استفاده شوند. \fIopt\fR فهرستی از گزینه‌ها است که با ویرگول لاتین از یکدیگر جدا شده‌اند و می‌توان یک نماد \f(CW\*(C`!\*(C'\fR را برای معکوس کردن عملکرد گزینه به ابتدای آن افزود:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
تمام دستورالعمل‌های برآورد را فعال می‌کند.
.IP \fBdefault\fR 4
.IX Item "default"
دستورالعمل‌های پیش‌فرض را فعال می‌کند که معادل با \fB\-mrecip\fR است.
.IP \fBnone\fR 4
.IX Item "none"
تمام دستورالعمل‌های برآورد را غیرفعال می‌کند که معادل با \fB\-mno\-recip\fR است.
.IP \fBdiv\fR 4
.IX Item "div"
دستورالعمل‌های تقریب معکوس را برای هر دو دقت تکی (single) و مضاعف (double) فعال می‌کند.
.IP \fBdivf\fR 4
.IX Item "divf"
دستورالعمل‌های تقریب معکوس با دقت تکی را فعال می‌کند.
.IP \fBdivd\fR 4
.IX Item "divd"
دستورالعمل‌های تقریب معکوس با دقت مضاعف را فعال می‌کند.
.IP \fBrsqrt\fR 4
.IX Item "rsqrt"
دستورالعمل‌های تقریب ریشهٔ دوم معکوس را برای هر دو دقت تکی و مضاعف فعال می‌کند.
.IP \fBrsqrtf\fR 4
.IX Item "rsqrtf"
دستورالعمل‌های تقریب ریشهٔ دوم معکوس با دقت تکی را فعال می‌کند.
.IP \fBrsqrtd\fR 4
.IX Item "rsqrtd"
دستورالعمل‌های تقریب ریشهٔ دوم معکوس با دقت مضاعف را فعال می‌کند.
.RE
.RS 4
.Sp
بنابراین برای نمونه، گزینهٔ \fB\-mrecip=all,!rsqrtd\fR تمام دستورالعمل‌های برآورد معکوس را به جز دستورالعمل‌های \f(CW\*(C`FRSQRTE\*(C'\fR،\ \f(CW\*(C`XSRSQRTEDP\*(C'\fR و \f(CW\*(C`XVRSQRTEDP\*(C'\fR که محاسبات ریشهٔ دوم معکوس با دقت مضاعف را مدیریت می‌کنند، فعال می‌سازد.
.RE.IP \fB\-mrecip\-precision\fR 4
.IX Item "-mrecip-precision"
.PD 0
.IP \fB\-mno\-recip\-precision\fR 4
.IX Item "-mno-recip-precision"
.PD
فرض می‌کند (فرض نمی‌کند) که دستورالعمل‌های برآورد معکوس (reciprocal estimate)، تخمین‌هایی با دقت بالاتر از آنچه توسط PowerPC ABI الزامی شده ارائه می‌دهند. انتخاب \fB\-mcpu=power6\fR، \fB\-mcpu=power7\fR یا \&\fB\-mcpu=power8\fR به طور خودکار \fB\-mrecip\-precision\fR را فعال می‌کند. دستورالعمل‌های تخمین ریشه دوم با دقت مضاعف (double\-precision) به طور پیش‌فرض روی ماشین‌های با دقت پایین تولید نمی‌شوند، چرا که تخمینی ارائه نمی‌دهند که پس از سه مرحله همگرا شود.
.IP \fB\-mveclibabi=\fR\fItype\fR 4
.IX Item "-mveclibabi=type"
نوع ABI مورد استفاده برای برداری‌سازی توابع درونی (intrinsics) با استفاده از یک کتابخانه خارجی را تعیین می‌کند. تنها نوعی که در حال حاضر پشتیبانی می‌شود \fBmass\fR است، که استفاده از کتابخانه‌های Mathematical Acceleration Subsystem (MASS) شرکت IBM را برای برداری‌سازی توابع درونی با استفاده از کتابخانه‌های خارجی مشخص می‌کند.
در حال حاضر GCC هنگام تولید کد برای power7 فراخوانی‌هایی به \f(CW\*(C`acosd2\*(C'\fR، \f(CW\*(C`acosf4\*(C'\fR،
\&\f(CW\*(C`acoshd2\*(C'\fR، \f(CW\*(C`acoshf4\*(C'\fR، \f(CW\*(C`asind2\*(C'\fR، \f(CW\*(C`asinf4\*(C'\fR،
\&\f(CW\*(C`asinhd2\*(C'\fR، \f(CW\*(C`asinhf4\*(C'\fR، \f(CW\*(C`atan2d2\*(C'\fR، \f(CW\*(C`atan2f4\*(C'\fR،
\&\f(CW\*(C`atand2\*(C'\fR، \f(CW\*(C`atanf4\*(C'\fR، \f(CW\*(C`atanhd2\*(C'\fR، \f(CW\*(C`atanhf4\*(C'\fR،
\&\f(CW\*(C`cbrtd2\*(C'\fR، \f(CW\*(C`cbrtf4\*(C'\fR، \f(CW\*(C`cosd2\*(C'\fR، \f(CW\*(C`cosf4\*(C'\fR،
\&\f(CW\*(C`coshd2\*(C'\fR، \f(CW\*(C`coshf4\*(C'\fR، \f(CW\*(C`erfcd2\*(C'\fR، \f(CW\*(C`erfcf4\*(C'\fR،
\&\f(CW\*(C`erfd2\*(C'\fR، \f(CW\*(C`erff4\*(C'\fR، \f(CW\*(C`exp2d2\*(C'\fR، \f(CW\*(C`exp2f4\*(C'\fR،
\&\f(CW\*(C`expd2\*(C'\fR، \f(CW\*(C`expf4\*(C'\fR، \f(CW\*(C`expm1d2\*(C'\fR، \f(CW\*(C`expm1f4\*(C'\fR،
\&\f(CW\*(C`hypotd2\*(C'\fR، \f(CW\*(C`hypotf4\*(C'\fR، \f(CW\*(C`lgammad2\*(C'\fR، \f(CW\*(C`lgammaf4\*(C'\fR،
\&\f(CW\*(C`log10d2\*(C'\fR، \f(CW\*(C`log10f4\*(C'\fR، \f(CW\*(C`log1pd2\*(C'\fR، \f(CW\*(C`log1pf4\*(C'\fR،
\&\f(CW\*(C`log2d2\*(C'\fR، \f(CW\*(C`log2f4\*(C'\fR، \f(CW\*(C`logd2\*(C'\fR، \f(CW\*(C`logf4\*(C'\fR،
\&\f(CW\*(C`powd2\*(C'\fR، \f(CW\*(C`powf4\*(C'\fR، \f(CW\*(C`sind2\*(C'\fR، \f(CW\*(C`sinf4\*(C'\fR، \f(CW\*(C`sinhd2\*(C'\fR،
\&\f(CW\*(C`sinhf4\*(C'\fR، \f(CW\*(C`sqrtd2\*(C'\fR، \f(CW\*(C`sqrtf4\*(C'\fR، \f(CW\*(C`tand2\*(C'\fR،
\&\f(CW\*(C`tanf4\*(C'\fR، \f(CW\*(C`tanhd2\*(C'\fR و \f(CW\*(C`tanhf4\*(C'\fR صادر می‌کند. هر دو گزینه \fB\-ftree\-vectorize\fR و
\&\fB\-funsafe\-math\-optimizations\fR نیز باید فعال باشند. کتابخانه‌های MASS باید در زمان پیوند مشخص شوند.
.IP \fB\-mfriz\fR 4
.IX Item "-mfriz"
.PD 0
.IP \fB\-mno\-friz\fR 4
.IX Item "-mno-friz"
.PD
دستورالعمل \f(CW\*(C`friz\*(C'\fR را تولید می‌کند (تولید نمی‌کند) هنگامی که از گزینه
\&\fB\-funsafe\-math\-optimizations\fR برای بهینه‌سازی گرد کردن مقادیر ممیز شناور به عدد صحیح ۶۴ بیتی و بازگشت به ممیز شناور استفاده می‌شود. دستورالعمل \f(CW\*(C`friz\*(C'\fR در صورتی که عدد ممیز شناور برای قرار گرفتن در عدد صحیح بیش از حد بزرگ باشد، همان مقدار را بازنمی‌گرداند.
.IP \fB\-mpointers\-to\-nested\-functions\fR 4
.IX Item "-mpointers-to-nested-functions"
.PD 0
.IP \fB\-mno\-pointers\-to\-nested\-functions\fR 4
.IX Item "-mno-pointers-to-nested-functions"
.PD
کدی برای بارگذاری ثبات زنجیره ایستا (\f(CW\*(C`r11\*(C'\fR) هنگام فراخوانی از طریق یک اشاره‌گر در سیستم‌های AIX و لینوکس ۶۴ بیتی تولید می‌کند (تولید نمی‌کند)؛ در این سیستم‌ها، اشاره‌گر تابع به یک توصیف‌گر ۳ کلمه‌ای اشاره دارد که آدرس تابع، مقدار TOC جهت بارگذاری در ثبات \f(CW\*(C`r2\*(C'\fR، و مقدار زنجیره ایستا جهت بارگذاری در ثبات \f(CW\*(C`r11\*(C'\fR را در بر دارد. گزینه
\&\fB\-mpointers\-to\-nested\-functions\fR به طور پیش‌فرض فعال است. اگر از \fB\-mno\-pointers\-to\-nested\-functions\fR استفاده کنید، نمی‌توانید از طریق اشاره‌گرها، توابع تو در تو یا توابعی را که در زبان‌های دیگر کامپایل شده و از زنجیره ایستا استفاده می‌کنند فراخوانی کنید.
.IP \fB\-msave\-toc\-indirect\fR 4
.IX Item "-msave-toc-indirect"
.PD 0
.IP \fB\-mno\-save\-toc\-indirect\fR 4
.IX Item "-mno-save-toc-indirect"
.PD
کدی برای ذخیره مقدار TOC در محل رزروشده پشته در مقدمه تابع (prologue) تولید می‌کند (تولید نمی‌کند)، در صورتی که تابع در سیستم‌های AIX و لینوکس ۶۴ بیتی از طریق یک اشاره‌گر فراخوانی کند. اگر مقدار TOC در مقدمه ذخیره نشود، دقیقاً پیش از فراخوانی از طریق اشاره‌گر ذخیره می‌شود. گزینه \fB\-mno\-save\-toc\-indirect\fR حالت پیش‌فرض است.
.IP \fB\-mcompat\-align\-parm\fR 4
.IX Item "-mcompat-align-parm"
.PD 0
.IP \fB\-mno\-compat\-align\-parm\fR 4
.IX Item "-mno-compat-align-parm"
.PD
کدی برای ارسال پارامترهای ساختار با حداکثر تراز ۶۴ بیت، جهت سازگاری با نسخه‌های قدیمی‌تر GCC تولید می‌کند (تولید نمی‌کند).
.Sp
نسخه‌های قدیمی‌تر GCC (قبل از 4.9.0) به اشتباه پارامتر ساختار را روی مرز ۱۲۸ بیتی تراز نمی‌کردند، زمانی که آن ساختار حاوی عضوی بود که به تراز ۱۲۸ بیتی نیاز داشت. این موضوع در نسخه‌های جدیدتر GCC اصلاح شده است. این گزینه می‌تواند برای تولید کدی استفاده شود که با توابع کامپایل‌شده توسط نسخه‌های قدیمی‌تر GCC سازگار باشد.
.Sp
گزینه \fB\-mno\-compat\-align\-parm\fR حالت پیش‌فرض است.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR 4
.IX Item "-mstack-protector-guard-reg=reg"
.IP \fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR 4
.IX Item "-mstack-protector-guard-offset=offset"
.PD
کد محافظت از پشته را با استفاده از قناری (canary) در \fIguard\fR تولید می‌کند. مکان‌های پشتیبانی‌شده عبارتند از \fBglobal\fR برای قناری سراسری یا \fBtls\fR برای قناری مجزا برای هر رشته در بلوک TLS (پیش‌فرض در نسخه GNU libc 2.4 یا بالاتر).
.Sp
با انتخاب حالت دوم، گزینه‌های
\&\fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR و
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR علاوه بر این مشخص می‌کنند
که کدام ثبات به عنوان ثبات پایه برای خواندن قناری، و از چه آفستی نسبت به آن ثبات پایه استفاده شود. مقدار پیش‌فرض برای آن‌ها بر اساس آنچه در ABI مربوطه مشخص شده تعیین می‌گردد.
.IP \fB\-mpcrel\fR 4
.IX Item "-mpcrel"
.PD 0
.IP \fB\-mno\-pcrel\fR 4
.IX Item "-mno-pcrel"
.PD
آدرس‌دهی وابسته به شمارنده برنامه (pc\-relative) را تولید می‌کند (تولید نمی‌کند). گزینه \fB\-mpcrel\fR نیازمند فعال بودن مدل کد متوسط (\fB\-mcmodel=medium\fR) و گزینه‌های آدرس‌دهی پیشوندی (\fB\-mprefixed\fR) است.
.IP \fB\-mprefixed\fR 4
.IX Item "-mprefixed"
.PD 0
.IP \fB\-mno\-prefixed\fR 4
.IX Item "-mno-prefixed"
.PD
حالت‌های آدرس‌دهی را با استفاده از دستورالعمل‌های بارگذاری و ذخیره‌سازی پیشوندی (prefixed) تولید می‌کند (تولید نمی‌کند). گزینه \fB\-mprefixed\fR مستلزم فعال بودن گزینه \fB\-mcpu=power10\fR (یا جدیدتر) است.
.IP \fB\-mmma\fR 4
.IX Item "-mmma"
.PD 0
.IP \fB\-mno\-mma\fR 4
.IX Item "-mno-mma"
.PD
دستورالعمل‌های MMA را تولید می‌کند (تولید نمی‌کند). گزینه \fB\-mma\fR مستلزم فعال بودن گزینه \fB\-mcpu=power10\fR (یا جدیدتر) است.
.IP \fB\-mdense\-math\fR 4
.IX Item "-mdense-math"
.PD 0
.IP \fB\-mno\-dense\-math\fR 4
.IX Item "-mno-dense-math"
.PD
دستورالعمل‌های Dense Math Facility (DMF) را تولید می‌کند (تولید نمی‌کند). گزینه \fB\-mdense\-math\fR مستلزم فعال بودن گزینه
\&\fB\-mcpu=future\fR (یا جدیدتر) است.
.IP \fB\-mrop\-protect\fR 4
.IX Item "-mrop-protect"
.PD 0
.IP \fB\-mno\-rop\-protect\fR 4
.IX Item "-mno-rop-protect"
.PD
دستورالعمل‌های محافظت از ROP را هنگامی که پردازنده هدف از آن‌ها پشتیبانی می‌کند تولید می‌کند (تولید نمی‌کند). در حال حاضر این گزینه بهینه‌سازی جمع‌بندی (\fB\-fshrink\-wrap\fR) را غیرفعال می‌کند.
.IP \fB\-mprivileged\fR 4
.IX Item "-mprivileged"
.PD 0
.IP \fB\-mno\-privileged\fR 4
.IX Item "-mno-privileged"
.PD
کدی که در حالت ممتاز (privileged state) اجرا می‌شود را تولید می‌کند (تولید نمی‌کند).
.IP \fB\-mblock\-ops\-unaligned\-vsx\fR 4
.IX Item "-mblock-ops-unaligned-vsx"
.PD 0
.IP \fB\-mno\-block\-ops\-unaligned\-vsx\fR 4
.IX Item "-mno-block-ops-unaligned-vsx"
.PD
عملیات بارگذاری و ذخیره‌سازی ترازنشده vsx را برای بسط درون‌خطی توابع \f(CW\*(C`memcpy\*(C'\fR و \f(CW\*(C`memmove\*(C'\fR تولید می‌کند (تولید نمی‌کند).
.IP \fB\-msplat\-word\-constant\fR 4
.IX Item "-msplat-word-constant"
.PD 0
.IP \fB\-mno\-splat\-word\-constant\fR 4
.IX Item "-mno-splat-word-constant"
.PD
کدی را تولید می‌کند (تولید نمی‌کند) که از دستورالعمل \f(CW\*(C`XXSPLTIW\*(C'\fR استفاده می‌کند. این گزینه به طور پیش‌فرض فعال است.
.IP \fB\-msplat\-float\-constant\fR 4
.IX Item "-msplat-float-constant"
.PD 0.IP \fB\-mno\-splat\-float\-constant\fR 4
.IX Item "-mno-splat-float-constant"
.PD
تولید (عدم تولید) کدی که از دستورالعمل \f(CW\*(C`XXSPLTIDP\*(C'\fR استفاده می‌کند.
این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mieee128\-constant\fR 4
.IX Item "-mieee128-constant"
.PD 0
.IP \fB\-mno\-ieee128\-constant\fR 4
.IX Item "-mno-ieee128-constant"
.PD
تولید (عدم تولید) کدی که از دستورالعمل \f(CW\*(C`LXVKQ\*(C'\fR استفاده می‌کند.
این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mwarn\-altivec\-long\fR 4
.IX Item "-mwarn-altivec-long"
.PD 0
.IP \fB\-mno\-warn\-altivec\-long\fR 4
.IX Item "-mno-warn-altivec-long"
.PD
فعال‌سازی یا غیرفعال‌سازی هشدارها دربارهٔ استفاده از نوع منسوخ‌شدهٔ \fBvector long ...\fR
در Altivec. این گزینه به‌طور پیش‌فرض فعال است.
.PP
\fIگزینه‌های RX\fR
.IX Subsection "RX Options"
.PP
این گزینه‌های خط فرمان برای اهداف RX تعریف شده‌اند:
.IP \fB\-m64bit\-doubles\fR 4
.IX Item "-m64bit-doubles"
.PD 0
.IP \fB\-m32bit\-doubles\fR 4
.IX Item "-m32bit-doubles"
.PD
اندازهٔ نوع دادهٔ \f(CW\*(C`double\*(C'\fR را ۶۴ بیت (\fB\-m64bit\-doubles\fR)
یا ۳۲ بیت (\fB\-m32bit\-doubles\fR) تعیین می‌کند. مقدار پیش‌فرض
\&\fB\-m32bit\-doubles\fR است. \fIنکته:\fR سخت‌افزار ممیز شناور RX تنها
روی مقادیر ۳۲ بیتی کار می‌کند، به همین دلیل مقدار پیش‌فرض
\&\fB\-m32bit\-doubles\fR است.
.IP \fB\-fpu\fR 4
.IX Item "-fpu"
.PD 0
.IP \fB\-nofpu\fR 4
.IX Item "-nofpu"
.PD
استفاده از سخت‌افزار ممیز شناور RX را فعال (\fB\-fpu\fR) یا
غیرفعال (\fB\-nofpu\fR) می‌کند. پیش‌فرض برای سری RX600 فعال
و برای سری RX200 غیرفعال است.
.Sp
با این حال، دستورالعمل‌های ممیز شناور تنها برای مقادیر ممیز شناور ۳۲ بیتی
تولید می‌شوند، بنابراین در صورت استفاده از گزینهٔ \&\fB\-m64bit\-doubles\fR،
سخت‌افزار FPU برای مقادیر double استفاده نمی‌شود.
.Sp
\&\fIنکته:\fR در صورت فعال بودن گزینهٔ \fB\-fpu\fR، گزینهٔ
\&\fB\-funsafe\-math\-optimizations\fR نیز به‌طور خودکار فعال می‌شود.
دلیل این امر این است که دستورالعمل‌های RX FPU ذاتاً ناامن هستند.
.IP \fB\-mcpu=\fR\fIname\fR 4
.IX Item "-mcpu=name"
نوع پردازندهٔ RX مورد نظر را انتخاب می‌کند. در حال حاضر سه نوع
پشتیبانی می‌شوند: سخت‌افزارهای عمومی سری \fBRX600\fR و \fBRX200\fR، و
پردازندهٔ خاص \fBRX610\fR. مقدار پیش‌فرض \fBRX600\fR است.
.Sp
تنها تفاوت میان \fBRX600\fR و \fBRX610\fR این است که
\&\fBRX610\fR از دستورالعمل \f(CW\*(C`MVTIPL\*(C'\fR پشتیبانی نمی‌کند.
.Sp
سری \fBRX200\fR فاقد واحد ممیز شناور سخت‌افزاری است و بنابراین
هنگام انتخاب این نوع، \fB\-nofpu\fR به‌طور پیش‌فرض فعال می‌شود.
.IP \fB\-mbig\-endian\-data\fR 4
.IX Item "-mbig-endian-data"
.PD 0
.IP \fB\-mlittle\-endian\-data\fR 4
.IX Item "-mlittle-endian-data"
.PD
داده‌ها (نه کدها) را در قالب big\-endian ذخیره می‌کند. پیش‌فرض
\&\fB\-mlittle\-endian\-data\fR است، یعنی ذخیرهٔ داده‌ها در قالب little\-endian.
.IP \fB\-msmall\-data\-limit=\fR\fIN\fR 4
.IX Item "-msmall-data-limit=N"
حداکثر اندازه (به بایت) متغیرهای سراسری و ایستا را که می‌توانند در ناحیهٔ داده‌های
کوچک (small data area) قرار گیرند، مشخص می‌کند. استفاده از ناحیهٔ داده‌های کوچک
می‌تواند به کدی کوچک‌تر و سریع‌تر منجر شود، اما اندازهٔ این ناحیه محدود است و
اطمینان از سرریز نشدن آن بر عهدهٔ برنامه‌نویس است. همچنین در صورت استفاده از ناحیهٔ
داده‌های کوچک، یکی از ثبات‌های RX (معمولاً \f(CW\*(C`r13\*(C'\fR) برای اشاره به این
ناحیه رزرو می‌شود، بنابراین دیگر توسط کامپایلر قابل استفاده نخواهد بود. در صورتی که
متغیرها به جای نگهداری در این ثبات به داخل پشته رانده شوند، این امر ممکن است به کدی
کُندتر و/یا بزرگ‌تر منجر شود.
.Sp
توجه داشته باشید که متغیرهای مشترک (متغیرهایی که مقداردهی اولیه نشده‌اند) و
ثوابت در ناحیهٔ داده‌های کوچک قرار نمی‌گیرند، چرا که به بخش‌های دیگری در فایل
اجرایی خروجی اختصاص می‌یابند.
.Sp
مقدار پیش‌فرض صفر است که این ویژگی را غیرفعال می‌کند. توجه داشته باشید که این ویژگی
در سطوح بالاتر بهینه‌سازی (\fB\-O2\fR و غیره) به دلیل اثرات مضر بالقوهٔ رزرو یک ثبات،
به‌طور پیش‌فرض فعال نمی‌شود. بر عهدهٔ برنامه‌نویس است که بررسی کند و ببیند آیا این
ویژگی برای برنامه‌اش سودمند است یا خیر. برای آگاهی از چگونگی انتخاب ثبات اصلیِ
نگه‌دارندهٔ اشاره‌گر ناحیهٔ داده‌های کوچک، توضیحات مربوط به گزینهٔ \fB\-mpid\fR را ببینید.
.IP \fB\-msim\fR 4
.IX Item "-msim"
.PD 0
.IP \fB\-mno\-sim\fR 4
.IX Item "-mno-sim"
.PD
از زمان‌اجرای شبیه‌ساز استفاده می‌کند. پیش‌فرض استفاده از زمان‌اجرای
مختص به برد libgloss است.
.IP \fB\-mas100\-syntax\fR 4
.IX Item "-mas100-syntax"
.PD 0
.IP \fB\-mno\-as100\-syntax\fR 4
.IX Item "-mno-as100-syntax"
.PD
هنگام تولید خروجی اسمبلر، از ساختار نحوی سازگار با اسمبلر AS100 متعلق به Renesas
استفاده می‌کند. این ساختار نحوی توسط اسمبلر GAS نیز قابل پردازش است، اما محدودیت‌هایی
دارد و به همین دلیل به‌طور پیش‌فرض تولید نمی‌شود.
.IP \fB\-mmax\-constant\-size=\fR\fIN\fR 4
.IX Item "-mmax-constant-size=N"
حداکثر اندازه (به بایت) مقداری ثابتی را که می‌تواند به عنوان یک عملوند در دستورالعمل
RX به کار رود مشخص می‌کند. اگرچه مجموعه دستورالعمل‌های RX اجازه می‌دهد مقادیر ثابت با
طول حداکثر ۴ بایت در دستورالعمل‌ها استفاده شوند، اما مقدار طولانی‌تر به منزلهٔ
دستورالعمل طولانی‌تر است. بدین ترتیب در برخی شرایط محدود کردن اندازهٔ مقادیر ثابتی که
در دستورالعمل‌ها استفاده می‌شوند می‌تواند سودمند باشد. مقادیر ثابتی که بیش از حد بزرگ
باشند، در یک استخر مقادیر ثابت قرار می‌گیرند و از طریق ارجاع غیرمستقیم ثبات به آن‌ها
ارجاع داده می‌شود.
.Sp
مقدار \fIN\fR می‌تواند بین 0 تا 4 باشد. مقدار 0 (پیش‌فرض) یا 4 به این معنی است که
مقادیر ثابت با هر اندازه‌ای مجاز هستند.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
کاهش پیونددهنده (linker relaxation) را فعال می‌کند. کاهش پیونددهنده فرآیندی است که طی
آن پیونددهنده تلاش می‌کند با یافتن نگارش‌های کوتاه‌تر از دستورالعمل‌های مختلف، حجم
برنامه را کاهش دهد. به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mint\-register=\fR\fIN\fR 4
.IX Item "-mint-register=N"
تعداد ثبات‌های رزروشده برای توابع گردانندهٔ وقفهٔ سریع را مشخص می‌کند. مقدار \fIN\fR
می‌تواند بین 0 تا 4 باشد. مقدار 1 به این معنی است که ثبات \f(CW\*(C`r13\*(C'\fR
منحصراً برای گرداننده‌های وقفهٔ سریع رزرو می‌شود. مقدار 2 ثبات‌های \f(CW\*(C`r13\*(C'\fR
و \&\f(CW\*(C`r12\*(C'\fR را رزرو می‌کند. مقدار 3 ثبات‌های \f(CW\*(C`r13\*(C'\fR،
\&\f(CW\*(C`r12\*(C'\fR و \&\f(CW\*(C`r11\*(C'\fR را رزرو می‌کند، و مقدار 4 ثبات‌های
\f(CW\*(C`r13\*(C'\fR تا \f(CW\*(C`r10\*(C'\fR را رزرو می‌کند. مقدار 0، که پیش‌فرض است،
هیچ ثباتی را رزرو نمی‌کند.
.IP \fB\-msave\-acc\-in\-interrupts\fR 4
.IX Item "-msave-acc-in-interrupts"
مشخص می‌کند که توابع گردانندهٔ وقفه باید ثبات انباشتگر (accumulator) را حفظ کنند.
این کار تنها زمانی لازم است که کد عادی احتمالاً از ثبات انباشتگر استفاده کند؛ برای
مثال، به این دلیل که ضرب‌های ۶۴ بیتی انجام می‌دهد. پیش‌فرض، نادیده گرفتن انباشتگر
است زیرا این امر سرعت گرداننده‌های وقفه را بیشتر می‌کند.
.IP \fB\-mpid\fR 4
.IX Item "-mpid"
.PD 0
.IP \fB\-mno\-pid\fR 4
.IX Item "-mno-pid"
.PD
تولید داده‌های مستقل از موقعیت (position\-independent data) را فعال می‌کند. در زمان
فعال بودن، هرگونه دسترسی به داده‌های ثابت از طریق یک آفست از آدرس پایه‌ای که در یک
ثبات نگهداری می‌شود انجام می‌گیرد. این امر امکان تعیین موقعیت داده‌های ثابت را در
زمان اجرا بدون نیاز به بازآرایی فایل اجرایی فراهم می‌سازد که مزیتی برای برنامه‌های
توکار با محدودیت‌های شدید حافظه است. داده‌های قابل تغییر تحت تأثیر این گزینه قرار
نمی‌گیرند.
.Sp
توجه داشته باشید که استفاده از این ویژگی، یک ثبات (معمولاً \f(CW\*(C`r13\*(C'\fR) را
برای آدرس پایهٔ داده‌های ثابت رزرو می‌کند. این موضوع می‌تواند به ویژه در توابع پیچیده
منجر به تولید کدی کُندتر و/یا بزرگ‌تر شود.
.Sp
ثبات واقعیِ انتخاب‌شده برای نگهداری آدرس پایهٔ داده‌های ثابت به فعال بودن گزینه‌های خط
فرمان \fB\-msmall\-data\-limit\fR و/یا \&\fB\-mint\-register\fR بستگی دارد. با شروع
از ثبات \f(CW\*(C`r13\*(C'\fR و حرکت به سمت پایین، ثبات‌ها ابتدا برای برآورده کردن
نیازمندی‌های \fB\-mint\-register\fR، سپس \fB\-mpid\fR و در نهایت
\fB\-msmall\-data\-limit\fR تخصیص داده می‌شوند. بدین ترتیب در صورتی که هر دو گزینهٔ
\&\fB\-mint\-register=4\fR و \fB\-mpid\fR در خط فرمان مشخص شده باشند، امکان دارد که
ثبات ناحیهٔ داده‌های کوچک \f(CW\*(C`r8\*(C'\fR باشد.
.Sp
به‌طور پیش‌فرض این ویژگی فعال نیست. حالت پیش‌فرض را می‌توان از طریق گزینهٔ خط فرمان
\fB\-mno\-pid\fR بازگرداند.
.IP \fB\-mno\-warn\-multiple\-fast\-interrupts\fR 4
.IX Item "-mno-warn-multiple-fast-interrupts".PD 0
.IP \fB\-mwarn\-multiple\-fast\-interrupts\fR 4
.IX Item "-mwarn-multiple-fast-interrupts"
.PD
از صدور پیام هشدار توسط GCC در صورتی که بیش از یک گرداننده وقفه سریع را حین کامپایل یک فایل بیابد، جلوگیری می‌کند. پیش‌فرض، صدور یک هشدار به ازای هر گرداننده وقفه سریع اضافیِ پیدا شده است، زیرا RX تنها از یک وقفه از این نوع پشتیبانی می‌کند.
.IP \fB\-mallow\-string\-insns\fR 4
.IX Item "-mallow-string-insns"
.PD 0
.IP \fB\-mno\-allow\-string\-insns\fR 4
.IX Item "-mno-allow-string-insns"
.PD
استفاده از دستورالعمل‌های دستکاری رشته \&\f(CW\*(C`SMOVF\*(C'\fR، \f(CW\*(C`SCMPU\*(C'\fR، \f(CW\*(C`SMOVB\*(C'\fR، \f(CW\*(C`SMOVU\*(C'\fR، \f(CW\*(C`SUNTIL\*(C'\fR،
\&\f(CW\*(C`SWHILE\*(C'\fR و همچنین دستورالعمل \f(CW\*(C`RMPA\*(C'\fR را فعال یا غیرفعال می‌کند. این
دستورالعمل‌ها ممکن است داده‌ها را پیش‌واکشی (prefetch) کنند که در صورت دسترسی به
یک ثبات I/O، انجام آن امن نیست. (برای اطلاعات بیشتر به بخش 12.2.7 از RX62N Group User\*(Aqs Manual
مراجعه کنید).
.Sp
پیش‌فرض مجاز بودن این دستورالعمل‌ها است، اما برای GCC ممکن نیست که با اطمینان تمامی
شرایطی را که ممکن است از یک دستورالعمل رشته برای دسترسی به یک ثبات I/O استفاده شود
تشخیص دهد، بنابراین استفاده از آن‌ها نمی‌تواند به‌طور خودکار غیرفعال شود. در عوض،
به برنامه‌نویس واگذار شده است که در صورت دسترسی برنامه‌اش به فضای I/O،
از گزینه \fB\-mno\-allow\-string\-insns\fR استفاده کند.
.Sp
هنگامی که این دستورالعمل‌ها فعال باشند، GCC نماد پیش‌پردازنده C یعنی
\&\f(CW\*(C`_\|_RX_ALLOW_STRING_INSNS_\|_\*(C'\fR را تعریف می‌کند، و در غیر این صورت نماد
\&\f(CW\*(C`_\|_RX_DISALLOW_STRING_INSNS_\|_\*(C'\fR را تعریف می‌کند.
.IP \fB\-mjsr\fR 4
.IX Item "-mjsr"
.PD 0
.IP \fB\-mno\-jsr\fR 4
.IX Item "-mno-jsr"
.PD
تنها (یا نه فقط) از دستورالعمل‌های \f(CW\*(C`JSR\*(C'\fR برای دسترسی به توابع استفاده شود.
این گزینه می‌تواند زمانی که اندازه کد از محدوده دستورالعمل‌های \f(CW\*(C`BSR\*(C'\fR
فراتر می‌رود به کار رود. توجه داشته باشید که \fB\-mno\-jsr\fR به معنای عدم استفاده از
\&\f(CW\*(C`JSR\*(C'\fR نیست، بلکه بدین معناست که از هر نوع شاخه‌بندی (branch) می‌توان استفاده کرد.
.IP \fB\-mlra\fR 4
.IX Item "-mlra"
استفاده از تخصیص‌دهنده ثبات جدید LRA. به‌طور پیش‌فرض، از تخصیص‌دهنده
قدیمی «reload» استفاده می‌شود.
.PP
\&\fIنکته:\fR گزینه خط فرمان عمومی GCC به نام \fB\-ffixed\-\fR\fIreg\fR
هنگام استفاده با ویژگی تابع \&\f(CW\*(C`interrupt\*(C'\fR، برای درگاه (port) معماری RX
اهمیت ویژه‌ای دارد. این ویژگی نشان‌دهنده تابعی است که برای پردازش
وقفه‌های سریع در نظر گرفته شده است. GCC تضمین می‌کند که تنها از ثبات‌های
\&\f(CW\*(C`r10\*(C'\fR، \f(CW\*(C`r11\*(C'\fR، \f(CW\*(C`r12\*(C'\fR و/یا \f(CW\*(C`r13\*(C'\fR استفاده کند، و آن هم فقط مشروط بر
این که استفاده عادی از ثبات‌های متناظر از طریق گزینه‌های خط فرمان
\&\fB\-ffixed\-\fR\fIreg\fR یا \fB\-mint\-register\fR محدود شده باشد.
.PP
\fIگزینه‌های S/390 و zSeries\fR
.IX Subsection "S/390 and zSeries Options"
.PP
این‌ها گزینه‌های \fB\-m\fR هستند که برای معماری S/390 و zSeries تعریف شده‌اند.
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD 0
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD
استفاده از (عدم استفاده از) دستورالعمل‌ها و ثبات‌های ممیز شناور سخت‌افزاری
برای عملیات ممیز شناور. زمانی که \fB\-msoft\-float\fR تعیین شود،
از توابع موجود در \fIlibgcc.a\fR برای انجام عملیات ممیز شناور
استفاده می‌شود. زمانی که \fB\-mhard\-float\fR تعیین شود، کامپایلر
دستورالعمل‌های ممیز شناور IEEE را تولید می‌کند. این حالت پیش‌فرض است.
.IP \fB\-mhard\-dfp\fR 4
.IX Item "-mhard-dfp"
.PD 0
.IP \fB\-mno\-hard\-dfp\fR 4
.IX Item "-mno-hard-dfp"
.PD
استفاده از (عدم استفاده از) دستورالعمل‌های سخت‌افزاری ممیز شناور ده‌دهی برای
عملیات ممیز شناور ده‌دهی. هنگامی که \fB\-mno\-hard\-dfp\fR
مشخص شود، توابع موجود در \fIlibgcc.a\fR برای اجرای عملیات
ممیز شناور ده‌دهی استفاده می‌شوند. زمانی که \fB\-mhard\-dfp\fR
مشخص گردد، کامپایلر دستورالعمل‌های سخت‌افزاری ممیز شناور ده‌دهی را
تولید می‌کند. این حالت برای \fB\-march=z9\-ec\fR یا بالاتر پیش‌فرض است.
.IP \fB\-mlong\-double\-64\fR 4
.IX Item "-mlong-double-64"
.PD 0
.IP \fB\-mlong\-double\-128\fR 4
.IX Item "-mlong-double-128"
.PD
این گزینه‌ها اندازه نوع \f(CW\*(C`long double\*(C'\fR را کنترل می‌کنند. اندازه
۶۴ بیتی باعث می‌شود نوع \f(CW\*(C`long double\*(C'\fR معادل نوع \f(CW\*(C`double\*(C'\fR
گردد. این حالت پیش‌فرض است.
.IP \fB\-mbackchain\fR 4
.IX Item "-mbackchain"
.PD 0
.IP \fB\-mno\-backchain\fR 4
.IX Item "-mno-backchain"
.PD
ذخیره (عدم ذخیره) نشانی فریم فراخواننده به عنوان اشاره‌گر زنجیره پشتیبان (backchain pointer)
در فریم پشته فراخوانده‌شده.
ممکن است یک backchain برای امکان خطایابی با استفاده از ابزارهایی که اطلاعات فریم فراخوانی
DWARF را تشخیص نمی‌دهند، مورد نیاز باشد.
هنگامی که \fB\-mno\-packed\-stack\fR فعال باشد، اشاره‌گر backchain در
پایین فریم پشته ذخیره می‌شود؛ هنگامی که \fB\-mpacked\-stack\fR فعال باشد،
backchain در بالاترین کلمه (word) از ناحیه ذخیره ثبات ۹۶/۱۶۰ بایتی قرار می‌گیرد.
.Sp
به‌طور کلی، کدهای کامپایل‌شده با \fB\-mbackchain\fR از نظر فراخوانی با
کدهای کامپایل‌شده با \fB\-mno\-backchain\fR سازگار (call\-compatible) هستند؛ اما استفاده از backchain
برای اهداف خطایابی معمولاً مستلزم آن است که کل باینری با
\&\fB\-mbackchain\fR ساخته شود. توجه داشته باشید که ترکیب \fB\-mbackchain\fR،
\&\fB\-mpacked\-stack\fR و \fB\-mhard\-float\fR پشتیبانی نمی‌شود. به منظور
ساخت هسته لینوکس از \fB\-msoft\-float\fR استفاده کنید.
.Sp
پیش‌فرض بر این است که backchain نگه‌داری نشود.
.IP \fB\-mpacked\-stack\fR 4
.IX Item "-mpacked-stack"
.PD 0
.IP \fB\-mno\-packed\-stack\fR 4
.IX Item "-mno-packed-stack"
.PD
استفاده از (عدم استفاده از) چیدمان فشرده پشته (packed stack layout). هنگامی که \fB\-mno\-packed\-stack\fR
مشخص شود، کامپایلر از تمامی فیلدهای ناحیه ذخیره ثبات ۹۶/۱۶۰ بایتی تنها برای اهداف پیش‌فرض
آن‌ها استفاده می‌کند؛ فیلدهای بلااستفاده همچنان فضای پشته را اشغال خواهند کرد.
هنگامی که \fB\-mpacked\-stack\fR مشخص شود، شیارهای ذخیره ثبات به‌صورت متراکم در
بالای ناحیه ذخیره ثبات بسته‌بندی می‌شوند؛ فضای استفاده‌نشده برای مقاصد دیگر استفاده مجدد می‌شود،
که امکان استفاده کارآمدتر از فضای موجود در پشته را فراهم می‌سازد.
با این حال، زمانی که \fB\-mbackchain\fR نیز فعال باشد، بالاترین کلمه از
ناحیه ذخیره همواره برای نگهداری backchain استفاده می‌شود، و ثبات نشانی بازگشت
همواره دو کلمه پایین‌تر از backchain ذخیره می‌گردد.
.Sp
تا زمانی که از backchain فریم پشته استفاده نشود، کدهای تولیدشده با
\&\fB\-mpacked\-stack\fR از نظر فراخوانی با کدهای تولیدشده با
\&\fB\-mno\-packed\-stack\fR سازگار هستند. توجه داشته باشید که برخی نگارش‌های غیر FSF از GCC 2.95 برای
S/390 یا zSeries کدهایی تولید می‌کردند که از backchain فریم پشته در زمان اجرا
استفاده می‌کرد، نه صرفاً برای اهداف خطایابی. چنین کدهایی از نظر فراخوانی با
کدهای کامپایل‌شده با \fB\-mpacked\-stack\fR سازگار نیستند. همچنین توجه داشته باشید که
ترکیب \fB\-mbackchain\fR،
\&\fB\-mpacked\-stack\fR و \fB\-mhard\-float\fR پشتیبانی نمی‌شود. به منظور
ساخت هسته لینوکس از \fB\-msoft\-float\fR استفاده کنید.
.Sp
پیش‌فرض بر این است که از چیدمان فشرده پشته استفاده نشود.
.IP \fB\-msmall\-exec\fR 4
.IX Item "-msmall-exec"
.PD 0
.IP \fB\-mno\-small\-exec\fR 4
.IX Item "-mno-small-exec"
.PD
تولید (یا عدم تولید) کد با استفاده از دستورالعمل \f(CW\*(C`bras\*(C'\fR
جهت انجام فراخوانی زیرروال‌ها.
این قابلیت تنها در صورتی با اطمینان کار می‌کند که اندازه کل فایل اجرایی از
64k تجاوز نکند. پیش‌فرض، استفاده از دستورالعمل \f(CW\*(C`basr\*(C'\fR به جای آن است
که فاقد این محدودیت می‌باشد.
.IP \fB\-m64\fR 4
.IX Item "-m64"
.PD 0
.IP \fB\-m31\fR 4
.IX Item "-m31"
.PD
هنگامی که \fB\-m31\fR مشخص شود، کدی منطبق با ABI سیستم GNU/Linux برای S/390
تولید می‌کند. زمانی که \fB\-m64\fR مشخص شود، کدی منطبق با ABI سیستم
GNU/Linux برای zSeries تولید می‌کند. این موضوع به‌ویژه به GCC امکان
تولید دستورالعمل‌های ۶۴ بیتی را می‌دهد. برای مقصدهای \fBs390\fR،
پیش‌فرض \fB\-m31\fR است، در حالی که برای مقصدهای \fBs390x\fR
پیش‌فرض \fB\-m64\fR می‌باشد. توجه داشته باشید که \fB\-m31\fR منسوخ شده است و
پشتیبانی از آن حذف خواهد شد.
.IP \fB\-mzarch\fR 4
.IX Item "-mzarch"
.PD 0
.IP \fB\-mesa\fR 4
.IX Item "-mesa"
.PD
هنگامی که \fB\-mzarch\fR مشخص شود، با استفاده از دستورالعمل‌های
موجود در z/Architecture کد تولید می‌کند.
هنگامی که \fB\-mesa\fR مشخص شود، با استفاده از دستورالعمل‌های
موجود در ESA/390 کد تولید می‌کند. توجه داشته باشید که استفاده از \fB\-mesa\fR
همراه با \fB\-m64\fR امکان‌پذیر نیست.
هنگام تولید کدی منطبق با ABI سیستم GNU/Linux برای S/390،
پیش‌فرض \fB\-mesa\fR است. هنگام تولید کدی منطبق
با ABI سیستم GNU/Linux برای zSeries، پیش‌فرض \fB\-mzarch\fR است..IP \fB\-mhtm\fR 4
.IX Item "-mhtm"
.PD 0
.IP \fB\-mno\-htm\fR 4
.IX Item "-mno-htm"
.PD
گزینهٔ \fB\-mhtm\fR مجموعه‌ای از توابع توکار (built-ins) را فعال می‌کند که از دستورالعمل‌های موجود در تسهیلات اجرای تراکنشی (transactional execution facility) معرفی‌شده در نسل رایانهٔ IBM zEnterprise EC12 بهره می‌برند؛ بخش \&\fBS/390 System z Built\-in Functions\fR.
\&\fB\-mhtm\fR هنگام استفاده از \fB\-march=zEC12\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-mvx\fR 4
.IX Item "-mvx"
.PD 0
.IP \fB\-mno\-vx\fR 4
.IX Item "-mno-vx"
.PD
هنگامی که \fB\-mvx\fR مشخص شود، کدی با استفاده از دستورالعمل‌های موجود در تسهیلات گسترش برداری (vector extension facility) معرفی‌شده در نسل رایانهٔ IBM z13 تولید می‌شود.
این گزینه ABI را برای برخی مقادیر از نوع برداری، با توجه به هم‌ترازی (alignment) و قراردادهای فراخوانی (calling conventions) تغییر می‌دهد. در صورتی که مقادیر از نوع برداری در زمینه‌ای مرتبط با ABI استفاده شوند، یک دستور \fB.gnu_attribute\fR از GAS اضافه می‌شود تا باینری حاصل را با ABI استفاده‌شده علامت‌گذاری کند.
\&\fB\-mvx\fR هنگام استفاده از \fB\-march=z13\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-mzvector\fR 4
.IX Item "-mzvector"
.PD 0
.IP \fB\-mno\-zvector\fR 4
.IX Item "-mno-zvector"
.PD
گزینهٔ \fB\-mzvector\fR افزونه‌های زبان برداری و توابع توکاری که از دستورالعمل‌های ارائه‌شده توسط تسهیلات گسترش برداری معرفی‌شده در نسل رایانهٔ IBM z13 استفاده می‌کنند را فعال می‌سازد.
این گزینه پشتیبانی از کلمهٔ کلیدی \fBvector\fR را برای تعریف متغیرها و آرگومان‌های نوع برداری اضافه می‌کند. \fBvector\fR تنها زمانی در دسترس است که افزونه‌های GNU فعال باشند. در صورت درخواست انطباق دقیق با استاندارد، برای مثال با \fB\-std=c99\fR، این کلمه بسط داده نمی‌شود.
علاوه بر توابع توکار سطح پایین GCC، گزینهٔ \fB\-mzvector\fR مجموعه‌ای از توابع توکار را فعال می‌کند که برای سازگاری با پیاده‌سازی‌های سبک AltiVec مانند Power و Cell اضافه شده‌اند. برای استفاده از این توابع توکار، باید فایل سرآیند \fIvecintrin.h\fR را بگنجانید.
\&\fB\-mzvector\fR به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mmvcle\fR 4
.IX Item "-mmvcle"
.PD 0
.IP \fB\-mno\-mvcle\fR 4
.IX Item "-mno-mvcle"
.PD
تولید کردن (یا نکردن) کدی که از دستورالعمل \f(CW\*(C`mvcle\*(C'\fR برای انجام جابه‌جایی‌های بلوکی استفاده می‌کند. زمانی که \fB\-mno\-mvcle\fR مشخص شود، به جای آن از یک حلقهٔ \f(CW\*(C`mvc\*(C'\fR استفاده می‌شود. این حالت پیش‌فرض است، مگر اینکه بهینه‌سازی برای اندازه (size) انجام شود.
.IP \fB\-mdebug\fR 4
.IX Item "-mdebug"
.PD 0
.IP \fB\-mno\-debug\fR 4
.IX Item "-mno-debug"
.PD
چاپ کردن (یا نکردن) اطلاعات اشکال‌زدایی اضافی هنگام کامپایل.
حالت پیش‌فرض چاپ نکردن اطلاعات اشکال‌زدایی است.
.IP \fB\-march=\fR\fIcpu\-type\fR 4
.IX Item "-march=cpu-type"
تولید کدی که بر روی \fIcpu\-type\fR اجرا می‌شود، که نام سیستمی نشان‌دهندهٔ نوع پردازنده‌ای مشخص است. مقادیر ممکن برای \&\fIcpu\-type\fR عبارتند از \fBz900\fR/\fBarch5\fR، \fBz990\fR/\fBarch6\fR،
\&\fBz9\-109\fR، \fBz9\-ec\fR/\fBarch7\fR، \fBz10\fR/\fBarch8\fR،
\&\fBz196\fR/\fBarch9\fR، \fBzEC12\fR، \fBz13\fR/\fBarch11\fR،
\&\fBz14\fR/\fBarch12\fR، \fBz15\fR/\fBarch13\fR،
\&\fBz16\fR/\fBarch14\fR، \fBz17\fR/\fBarch15\fR و \fBnative\fR.
.Sp
پیش‌فرض \fB\-march=z900\fR است.
.Sp
مشخص کردن \fBnative\fR به عنوان نوع پردازنده می‌تواند برای انتخاب بهترین گزینهٔ معماری متناسب با پردازندهٔ میزبان به کار رود.
اگر GCC پردازنده را شناسایی نکند، \fB\-march=native\fR هیچ تأثیری نخواهد داشت.
.IP \fB\-mtune=\fR\fIcpu\-type\fR 4
.IX Item "-mtune=cpu-type"
میزان‌سازی دقیق تمام موارد ممکن دربارهٔ کد تولیدشده متناسب با \fIcpu\-type\fR، به جز ABI و مجموعهٔ دستورالعمل‌های در دسترس.
فهرست مقادیر \fIcpu\-type\fR همانند فهرست \fB\-march\fR است.
پیش‌فرض، مقداری است که برای \fB\-march\fR استفاده شده است.
.IP \fB\-mtpf\-trace\fR 4
.IX Item "-mtpf-trace"
.PD 0
.IP \fB\-mno\-tpf\-trace\fR 4
.IX Item "-mno-tpf-trace"
.PD
تولید کدی که انشعاب‌های ویژهٔ سیستم‌عامل TPF را به روال‌های ردگیری (trace routines) در سیستم‌عامل اضافه می‌کند (یا اضافه نمی‌کند). این گزینه حتی هنگام کامپایل برای سیستم‌عامل TPF نیز به‌طور پیش‌فرض غیرفعال است.
.IP \fB\-mtpf\-trace\-skip\fR 4
.IX Item "-mtpf-trace-skip"
.PD 0
.IP \fB\-mno\-tpf\-trace\-skip\fR 4
.IX Item "-mno-tpf-trace-skip"
.PD
تولید کدی که مقاصد انشعاب پیش‌فرضِ فعال‌شده توسط \fB\-mtpf\-trace\fR را تغییر می‌دهد (یا نمی‌دهد) تا به روال‌های ردگیری تخصصی اشاره کنند که امکان نادیده گرفتن انتخابی ورودی‌های ردگیری تابع را برای سیستم‌عامل TPF فراهم می‌آورند. این گزینه به‌طور پیش‌فرض خاموش است، حتی در زمان کامپایل برای سیستم‌عامل TPF و مشخص کردن \fB\-mtpf\-trace\fR.
.IP \fB\-mmain\fR 4
.IX Item "-mmain"
برای مقصد سیستم‌عامل TPF، هنگام پیوند دادن از این گزینه برای افزودن کد راه‌اندازی (startup code) و سایر گزینه‌های پیونددهنده جهت تولید شیء اصلی استفاده کنید.
.IP \fB\-mfused\-madd\fR 4
.IX Item "-mfused-madd"
.PD 0
.IP \fB\-mno\-fused\-madd\fR 4
.IX Item "-mno-fused-madd"
.PD
تولید کدی که از دستورالعمل‌های ضرب و جمع توأم ممیز شناور (fused multiply-accumulate) استفاده می‌کند (یا نمی‌کند). در صورت استفاده از ممیز شناور سخت‌افزاری، این دستورالعمل‌ها به‌طور پیش‌فرض تولید می‌شوند.
.IP \fB\-mwarn\-framesize=\fR\fIframesize\fR 4
.IX Item "-mwarn-framesize=framesize"
صدور یک هشدار در صورتی که تابع جاری از اندازه فریم داده‌شده فراتر رود.
از آنجا که این بررسی در زمان کامپایل انجام می‌شود، لزوماً به این معنی نیست که هنگام اجرای برنامه یک مشکل واقعی رخ خواهد داد. هدف از آن شناسایی توابعی است که به احتمال زیاد باعث سرریز پشته (stack overflow) می‌شوند. این گزینه برای محیط‌هایی با اندازهٔ پشتهٔ محدود، مانند هستهٔ لینوکس، مفید است.
.Sp
مقدار صفر این هشدار را غیرفعال می‌کند؛ که همان مقدار پیش‌فرض است.
.IP \fB\-mwarn\-dynamicstack\fR 4
.IX Item "-mwarn-dynamicstack"
.PD 0
.IP \fB\-mno\-warn\-dynamicstack\fR 4
.IX Item "-mno-warn-dynamicstack"
.PD
صدور یک هشدار اگر تابع، \f(CW\*(C`alloca\*(C'\fR را فراخوانی کند یا از آرایه‌های با اندازهٔ پویا استفاده کند. این کار در شرایطی با اندازهٔ پشتهٔ محدود عموماً ایدهٔ نامناسبی است.
.IP \fB\-mstack\-guard=\fR\fIstack\-guard\fR 4
.IX Item "-mstack-guard=stack-guard"
.PD 0
.IP \fB\-mstack\-size=\fR\fIstack\-size\fR 4
.IX Item "-mstack-size=stack-size"
.IP \fB\-mno\-stack\-guard\fR 4
.IX Item "-mno-stack-guard"
.IP \fB\-mno\-stack\-size\fR 4
.IX Item "-mno-stack-size"
.PD
اگر این گزینه‌ها فعال باشند، بخش پسین S/390 دستورالعمل‌های اضافی را در مقدمهٔ تابع (function prologue) صادر می‌کند که اگر اندازه پشته به میزان \fIstack\-guard\fR بایت فراتر از \fIstack\-size\fR برود، یک تله (trap) را فعال می‌کنند (به یاد داشته باشید که پشته در S/390 رو به پایین رشد می‌کند).
اگر گزینهٔ \fIstack\-guard\fR ذکر نشود، کوچک‌ترین توان ۲ که بزرگ‌تر از اندازهٔ فریم تابع کامپایل‌شده باشد انتخاب می‌شود.
.Sp
این گزینه‌ها برای کمک به اشکال‌زدایی مشکلات سرریز پشته در نظر گرفته شده‌اند. کد اضافی تولیدشده سربار ناچیزی ایجاد می‌کند و از این رو می‌تواند در سیستم‌های شبه‌عملیاتی بدون افت عملکرد چشمگیر استفاده شود.
.Sp
مقادیر داده‌شده باید دقیقاً توانی از ۲ باشند و \fIstack\-size\fR باید بدون تجاوز از 64k، بزرگ‌تر از \fIstack\-guard\fR باشد.
برای کارایی بهینه، کد اضافی این فرض را در نظر می‌گیرد که پشته در آدرسی هم‌تراز با مقدار مشخص‌شده توسط \fIstack\-size\fR آغاز می‌شود.
.Sp
گزینهٔ \fB\-mstack\-guard=\fR فقط می‌تواند در ترکیب با \&\fB\-mstack\-size=\fR به کار رود. شما می‌توانید این گزینه‌ها را در خط فرمان به ترتیب با \fB\-mno\-stack\-guard\fR و \fB\-mno\-stack\-size\fR بازنویسی و لغو کنید.
.IP \fB\-mhotpatch=\fR\fIpre\-halfwords\fR\fB,\fR\fIpost\-halfwords\fR 4
.IX Item "-mhotpatch=pre-halfwords,post-halfwords"
اگر گزینهٔ وصله‌زنی زنده (hotpatch) فعال باشد، یک مقدمهٔ تابع مخصوص وصله‌زنی زنده برای تمامی توابع موجود در واحد کامپایل تولید می‌شود.
پیش از برچسب تابع، تعداد مشخص‌شده‌ای از دستورالعمل‌های دو بایتی NOP قرار می‌گیرد (\fIpre\-halfwords\fR، حداکثر ۱۰۰۰۰۰۰). پس از برچسب، ۲ * \fIpost\-halfwords\fR بایت با استفاده از بزرگ‌ترین دستورالعمل‌های شبیه NOP که معماری اجازه می‌دهد افزوده می‌شود (حداکثر ۱۰۰۰۰۰۰).
.Sp
اگر هر دو آرگومان صفر باشند، وصله‌زنی زنده غیرفعال است.
.Sp
این گزینه را می‌توان برای توابع منفرد با استفاده از صفت \&\f(CW\*(C`hotpatch\*(C'\fR لغو و جایگزین کرد.
.IP \fB\-mpic\-data\-is\-text\-relative\fR 4
.IX Item "-mpic-data-is-text-relative".PD 0
.IP \fB\-mno\-pic\-data\-is\-text\-relative\fR 4
.IX Item "-mno-pic-data-is-text-relative"
.PD
هنگام کامپایل برای S/390 با \fB\-fpic\fR یا \fB\-fPIC\fR، به‌طور معمول GCC کدی با استفاده از آدرس‌دهی نسبی بین کد و داده تولید می‌کند. با این حال، برای وصله‌زدن زنده (hotpatching) ممکن است نیاز باشد بخش‌های جدید \f(CW\*(C`.text\*(C'\fR اضافه شوند در حالی که از بخش‌های موجود \f(CW\*(C`.data\*(C'\fR و \f(CW\*(C`.bss\*(C'\fR استفاده می‌شود. در این حالت، برای اجبار به آدرس‌دهی از طریق GOT از \fB\-mno\-pic\-data\-is\-text\-relative\fR استفاده کنید.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-record\fR 4
.IX Item "-mstack-protector-guard-record"
.PD
کد محافظت از پشته را با استفاده از قناری (canary) در \fIguard\fR تولید می‌کند. مکان‌های پشتیبانی‌شده عبارتند از \fBglobal\fR برای یک قناری سراسری یا \fBtls\fR برای یک قناری به ازای هر رشته در بلوک TLS (پیش‌فرض).
.Sp
گزینه \fB\-mstack\-protector\-guard\-record\fR منجر به تولید بخش \f(CW\*(C`_\|_stack_protector_loc\*(C'\fR شامل اشاره‌گرهایی به تمام دستورالعمل‌هایی می‌شود که آدرس محافظ سراسری را بارگذاری می‌کنند. بنابراین، این گزینه فقط در ترکیب با \fB\-mstack\-protector\-guard=global\fR مؤثر است. کاربرد مورد نظر آن برای هسته Linux است.
.IP \fB\-mindirect\-branch=\fR\fIchoice\fR 4
.IX Item "-mindirect-branch=choice"
.PD 0
.IP \fB\-mindirect\-branch\-jump=\fR\fIchoice\fR 4
.IX Item "-mindirect-branch-jump=choice"
.IP \fB\-mindirect\-branch\-call=\fR\fIchoice\fR 4
.IX Item "-mindirect-branch-call=choice"
.IP \fB\-mfunction\-return=\fR\fIchoice\fR 4
.IX Item "-mfunction-return=choice"
.IP \fB\-mfunction\-return\-mem=\fR\fIchoice\fR 4
.IX Item "-mfunction-return-mem=choice"
.IP \fB\-mfunction\-return\-reg=\fR\fIchoice\fR 4
.IX Item "-mfunction-return-reg=choice"
.PD
این گروه از گزینه‌ها با فعال‌سازی جایگزینی پرش‌های غیرمستقیم و بازگشت‌های توابع با پرش‌های مستقیم به یک thunk، آسیب‌پذیری‌های امنیتی مرتبط با اجرای حدسی (speculative execution) و پیش‌بینی پرش غیرمستقیم را رفع می‌کند.
.Sp
مشخص کردن \fIchoice\fR به عنوان \fBkeep\fR باعث تولید کد پیش‌فرض می‌شود. مقدار \fBthunk\fR تولید thunkهای خارج از خط (out\-of\-line) را فعال کرده و پرش غیرمستقیم قبلی را با یک پرش مستقیم به thunk جایگزین می‌کند. مقدار \fBthunk\-extern\fR جایگزینی پرش را مانند \fBthunk\fR انجام می‌دهد اما thunkها را تولید نمی‌کند. مقدار \fBthunk\-inline\fR فقط با \&\fB\-mindirect\-branch\-jump\fR در دسترس است؛ برای پشتیبانی از بازگشایی صحیح پشته و مدیریت استثناها، بهتر است در برنامه‌های فضای کاربر به‌جای \fBthunk\fR از آن استفاده شود.
.Sp
گزینه \&\fB\-mindirect\-branch\fR مقادیر \fB\-mindirect\-branch\-jump\fR و \fB\-mindirect\-branch\-call\fR را تنظیم می‌کند.
گزینه \&\fB\-mfunction\-return\fR مقادیر \fB\-mfunction\-return\-reg\fR و \fB\-mfunction\-return\-mem\fR را تنظیم می‌کند.
.Sp
تمامی این گزینه‌ها را می‌توان بر پایه هر تابع نیز با استفاده از ویژگی‌های تابع (function attributes) تنظیم کرد.
.IP \fB\-mindirect\-branch\-table\fR 4
.IX Item "-mindirect-branch-table"
.PD 0
.IP \fB\-mno\-indirect\-branch\-table\fR 4
.IX Item "-mno-indirect-branch-table"
.PD
این گزینه در ترکیب با گزینه‌های \&\fB\-mindirect\-branch\fR و \fB\-mfunction\-return\fR مفید است. هنگامی که فعال باشد، باعث تولید جدول‌هایی می‌شود که به مکان‌های پرشی که توسط آن گزینه‌ها وصله شده‌اند، اشاره می‌کنند. این جدول‌ها در بخش‌هایی به نام‌های \f(CW\*(C`.s390_indirect_jump\*(C'\fR، \&\f(CW\*(C`.s390_indirect_call\*(C'\fR، \f(CW\*(C`.s390_return_reg\*(C'\fR و \&\f(CW\*(C`.s390_return_mem\*(C'\fR منتشر می‌شوند. هر بخش شامل آرایه‌ای از عناصر ۳۲ بیتی است؛ هر مدخل آفستِ از آن مدخل تا مکان وصله‌شده را در خود نگه می‌دارد.
.IP \fB\-mfentry\fR 4
.IX Item "-mfentry"
.PD 0
.IP \fB\-mno\-fentry\fR 4
.IX Item "-mno-fentry"
.PD
هنگامی که در ترکیب با گزینه \fB\-pg\fR استفاده شود، کد پروفایلینگ را با استفاده از قلاب \f(CW\*(C`_\|_fentry_\|_\*(C'\fR که توسط GLIBC 2.29 یا بالاتر ارائه شده، تولید می‌کند. این ویژگی فقط برای کد ۶۴ بیتی در دسترس است. اگر این گزینه فعال نباشد، پروفایلینگ در عوض از قلاب کم‌بازده‌تر \f(CW\*(C`_mcount\*(C'\fR استفاده می‌کند.
.IP \fB\-mrecord\-mcount\fR 4
.IX Item "-mrecord-mcount"
.PD 0
.IP \fB\-mno\-record\-mcount\fR 4
.IX Item "-mno-record-mcount"
.PD
هنگامی که فعال باشد، یک بخش \f(CW\*(C`_\|_mcount_loc\*(C'\fR شامل مکان‌های تمام فراخوانی‌های پروفایلینگ تولیدشده برای \f(CW\*(C`_mcount\*(C'\fR یا \f(CW\*(C`_\|_fentry_\|_\*(C'\fR ایجاد می‌کند.
.IP \fBmnop\-mcount\fR 4
.IX Item "mnop-mcount"
.PD 0
.IP \fBmno\-nop\-mcount\fR 4
.IX Item "mno-nop-mcount"
.PD
به‌جای تولید فراخوانی‌ها به \f(CW\*(C`_mcount\*(C'\fR یا \f(CW\*(C`_\|_fentry_\|_\*(C'\fR با \fB\-pg\fR، دنباله‌ای از دستورالعمل‌های بی‌اثر (no\-op) با همان طول را در مکان‌هایی که فراخوانی‌ها باید درج می‌شدند، وارد می‌کند. این گزینه می‌تواند در ترکیب با گزینه \fB\-mrecord\-mcount\fR برای وصله کردن دنباله‌های فراخوانی در فایل شیء (object file) بدون کامپایل مجدد آن استفاده شود.
.IP \fB\-mpreserve\-args\fR 4
.IX Item "-mpreserve-args"
.PD 0
.IP \fB\-mno\-preserve\-args\fR 4
.IX Item "-mno-preserve-args"
.PD
هنگامی که فعال باشد، تمام ثبات‌های آرگومان را در پشته ذخیره کرده و اطلاعات CFI متناظر را تولید می‌کند. این گزینه برای برنامه‌هایی که مایلند بازگشایی پشته مختص به خود را پیاده‌سازی کنند و به آرگومان‌های تابع نیاز دارند مفید است.
.IP \fB\-munaligned\-symbols\fR 4
.IX Item "-munaligned-symbols"
.PD 0
.IP \fB\-mno\-unaligned\-symbols\fR 4
.IX Item "-mno-unaligned-symbols"
.PD
فرض می‌کند که نمادهای خارجی با هم‌ترازی طبیعی ۱ بالقوه ناتراز (unaligned) هستند. به‌طور پیش‌فرض، تمام نمادهای بدون تراز صریح، همان‌گونه که توسط IBM Z ABI تعیین شده است، بر روی مرز ۲ بایتی تراز فرض می‌شوند.
.PP
\fIگزینه‌های SH\fR
.IX Subsection "SH Options"
.PP
این گزینه‌های \fB\-m\fR برای پیاده‌سازی‌های SH تعریف شده‌اند:
.IP \fB\-m1\fR 4
.IX Item "-m1"
تولید کد برای SH1.
.IP \fB\-m2\fR 4
.IX Item "-m2"
تولید کد برای SH2.
.IP \fB\-m2e\fR 4
.IX Item "-m2e"
تولید کد برای SH2e.
.IP \fB\-m2a\-nofpu\fR 4
.IX Item "-m2a-nofpu"
تولید کد برای SH2a بدون FPU، یا برای یک SH2a\-FPU به نحوی که از واحد ممیز شناور استفاده نشود.
.IP \fB\-m2a\-single\-only\fR 4
.IX Item "-m2a-single-only"
تولید کد برای SH2a\-FPU به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف (double\-precision) استفاده نشود.
.IP \fB\-m2a\-single\fR 4
.IX Item "-m2a-single"
تولید کد برای SH2a\-FPU با فرض این‌که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت منفرد (single\-precision) است.
.IP \fB\-m2a\fR 4
.IX Item "-m2a"
تولید کد برای SH2a\-FPU با فرض این‌که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت مضاعف است.
.IP \fB\-m3\fR 4
.IX Item "-m3"
تولید کد برای SH3.
.IP \fB\-m3e\fR 4
.IX Item "-m3e"
تولید کد برای SH3e.
.IP \fB\-m4\-nofpu\fR 4
.IX Item "-m4-nofpu"
تولید کد برای SH4 بدون واحد ممیز شناور.
.IP \fB\-m4\-single\-only\fR 4
.IX Item "-m4-single-only"
تولید کد برای SH4 با واحد ممیز شناوری که فقط از محاسبات با دقت منفرد پشتیبانی می‌کند.
.IP \fB\-m4\-single\fR 4
.IX Item "-m4-single"
تولید کد برای SH4 با فرض این‌که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت منفرد است.
.IP \fB\-m4\fR 4
.IX Item "-m4"
تولید کد برای SH4.
.IP \fB\-m4\-100\fR 4
.IX Item "-m4-100"
تولید کد برای SH4\-100.
.IP \fB\-m4\-100\-nofpu\fR 4
.IX Item "-m4-100-nofpu"
تولید کد برای SH4\-100 به نحوی که از واحد ممیز شناور استفاده نشود.
.IP \fB\-m4\-100\-single\fR 4
.IX Item "-m4-100-single"
تولید کد برای SH4\-100 با فرض این‌که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت منفرد است..IP \fB\-m4\-100\-single\-only\fR 4
.IX Item "-m4-100-single-only"
تولید کد برای SH4\-100 به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف استفاده نشود.
.IP \fB\-m4\-200\fR 4
.IX Item "-m4-200"
تولید کد برای SH4\-200.
.IP \fB\-m4\-200\-nofpu\fR 4
.IX Item "-m4-200-nofpu"
تولید کد برای SH4\-200 به گونه‌ای که از واحد ممیز شناور استفاده نشود.
.IP \fB\-m4\-200\-single\fR 4
.IX Item "-m4-200-single"
تولید کد برای SH4\-200 با این فرض که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت یگانه قرار دارد.
.IP \fB\-m4\-200\-single\-only\fR 4
.IX Item "-m4-200-single-only"
تولید کد برای SH4\-200 به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف استفاده نشود.
.IP \fB\-m4\-300\fR 4
.IX Item "-m4-300"
تولید کد برای SH4\-300.
.IP \fB\-m4\-300\-nofpu\fR 4
.IX Item "-m4-300-nofpu"
تولید کد برای SH4\-300 به گونه‌ای که از واحد ممیز شناور استفاده نشود.
.IP \fB\-m4\-300\-single\fR 4
.IX Item "-m4-300-single"
تولید کد برای SH4\-300 به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف استفاده نشود.
.IP \fB\-m4\-300\-single\-only\fR 4
.IX Item "-m4-300-single-only"
تولید کد برای SH4\-300 به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف استفاده نشود.
.IP \fB\-m4\-340\fR 4
.IX Item "-m4-340"
تولید کد برای SH4\-340 (بدون MMU، بدون FPU).
.IP \fB\-m4\-400\fR 4
.IX Item "-m4-400"
تولید کد برای SH4\-400 (بدون MMU، بدون FPU).
.IP \fB\-m4\-500\fR 4
.IX Item "-m4-500"
تولید کد برای SH4\-500 (بدون FPU). گزینهٔ \fB\-isa=sh4\-nofpu\fR را به اسمبلر ارسال می‌کند.
.IP \fB\-m4a\-nofpu\fR 4
.IX Item "-m4a-nofpu"
تولید کد برای SH4al\-dsp، یا برای یک SH4a به گونه‌ای که از واحد ممیز شناور استفاده نشود.
.IP \fB\-m4a\-single\-only\fR 4
.IX Item "-m4a-single-only"
تولید کد برای SH4a به گونه‌ای که از هیچ عملیات ممیز شناور با دقت مضاعف استفاده نشود.
.IP \fB\-m4a\-single\fR 4
.IX Item "-m4a-single"
تولید کد برای SH4a با این فرض که واحد ممیز شناور به‌طور پیش‌فرض در حالت دقت یگانه قرار دارد.
.IP \fB\-m4a\fR 4
.IX Item "-m4a"
تولید کد برای SH4a.
.IP \fB\-m4al\fR 4
.IX Item "-m4al"
مشابه \fB\-m4a\-nofpu\fR، به جز اینکه به‌طور ضمنی \fB\-dsp\fR را به اسمبلر ارسال می‌کند. کامپایلر GCC در حال حاضر هیچ دستورالعمل DSP تولید نمی‌کند.
.IP \fB\-mb\fR 4
.IX Item "-mb"
کامپایل کد برای پردازنده در حالت big\-endian.
.IP \fB\-ml\fR 4
.IX Item "-ml"
کامپایل کد برای پردازنده در حالت little\-endian.
.IP \fB\-mdalign\fR 4
.IX Item "-mdalign"
هم‌تراز کردن داده‌های دقت مضاعف (doubles) در مرزهای ۶۴ بیتی. توجه داشته باشید که این کار قراردادهای فراخوانی را تغییر می‌دهد و در نتیجه برخی از توابع کتابخانه استاندارد C کار نخواهند کرد، مگر اینکه ابتدا آن را با \fB\-mdalign\fR بازکامپایل کنید.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
کوتاه‌تر کردن برخی از ارجاعات آدرس در زمان پیوند در صورت امکان؛ از گزینهٔ پیونددهندهٔ \fB\-relax\fR استفاده می‌کند.
.IP \fB\-mbigtable\fR 4
.IX Item "-mbigtable"
استفاده از آفست‌های ۳۲ بیتی در جدول‌های \f(CW\*(C`switch\*(C'\fR. پیش‌فرض استفاده از آفست‌های ۱۶ بیتی است.
.IP \fB\-mbitops\fR 4
.IX Item "-mbitops"
فعال‌سازی استفاده از دستورالعمل‌های دستکاری بیت روی SH2A.
.IP \fB\-mfmovd\fR 4
.IX Item "-mfmovd"
فعال‌سازی استفاده از دستورالعمل \f(CW\*(C`fmovd\*(C'\fR. محدودیت‌های تراز را در \fB\-mdalign\fR بررسی کنید.
.IP \fB\-mrenesas\fR 4
.IX Item "-mrenesas"
.PD 0
.IP \fB\-mno\-renesas\fR 4
.IX Item "-mno-renesas"
.PD
مطابقت با قراردادهای فراخوانی تعریف‌شده توسط Renesas. پیش‌فرض برای تمامی مقصدهای زنجیره ابزار SH گزینهٔ \fB\-mno\-renesas\fR است که از قراردادهای فراخوانی تعریف‌شده برای GCC قبل از در دسترس قرار گرفتن قراردادهای Renesas استفاده می‌کند.
.IP \fB\-mnomacsave\fR 4
.IX Item "-mnomacsave"
علامت‌گذاری ثبات \f(CW\*(C`MAC\*(C'\fR به عنوان call\-clobbered، حتی اگر گزینهٔ \fB\-mrenesas\fR داده شده باشد.
.IP \fB\-mieee\fR 4
.IX Item "-mieee"
.PD 0
.IP \fB\-mno\-ieee\fR 4
.IX Item "-mno-ieee"
.PD
کنترل تطابق مقایسه‌های ممیز شناور با استاندارد IEEE، که بر نحوه مدیریت مواردی که نتیجه یک مقایسه نامرتب (unordered) است تأثیر می‌گذارد. به‌طور پیش‌فرض \fB\-mieee\fR به‌صورت ضمنی فعال است. اگر \fB\-ffinite\-math\-only\fR فعال باشد، \fB\-mno\-ieee\fR به‌طور ضمنی تنظیم می‌شود که منجر به مقایسه‌های ممیز شناور سریع‌تر «بزرگ‌تر یا مساوی» و «کوچک‌تر یا مساوی» می‌گردد. تنظیمات ضمنی را می‌توان با تعیین \fB\-mieee\fR یا \fB\-mno\-ieee\fR لغو کرد.
.IP \fB\-minline\-ic_invalidate\fR 4
.IX Item "-minline-ic_invalidate"
.PD 0
.IP \fB\-mno\-inline\-ic_invalidate\fR 4
.IX Item "-mno-inline-ic_invalidate"
.PD
درون‌خطی (Inline) کردن کد برای باطل‌سازی ورودی‌های حافظهٔ نهان دستورالعمل (instruction cache) پس از راه‌اندازی ترامپولین‌های توابع تودرتو.
این گزینه در صورتی که \fB\-musermode\fR فعال باشد و گزینهٔ تولید کدِ انتخاب‌شده (مانند \fB\-m4\fR) اجازه استفاده از دستورالعمل \f(CW\*(C`icbi\*(C'\fR را ندهد، هیچ تأثیری ندارد.
اگر گزینهٔ تولید کدِ انتخاب‌شده اجازه استفاده از دستورالعمل \f(CW\*(C`icbi\*(C'\fR را ندهد و \fB\-musermode\fR فعال نباشد، کد درون‌خطی‌شده آرایهٔ آدرس حافظهٔ نهان دستورالعمل را مستقیماً با یک نوشتن انجمنی (associative write) دستکاری می‌کند. این امر نه تنها در زمان اجرا به حالت ممتاز (privileged mode) نیاز دارد، بلکه در صورتی که خط حافظهٔ نهان از طریق TLB نگاشت شده و سپس نگاشت آن لغو شده باشد، با شکست مواجه می‌شود.
.IP \fB\-misize\fR 4
.IX Item "-misize"
درج اندازه و محل دستورالعمل در کد اسمبلی.
.IP \fB\-matomic\-model=\fR\fImodel\fR 4
.IX Item "-matomic-model=model"
مدل عملیات اتمی و پارامترهای اضافی را به صورت یک فهرست جداشده با کاما تنظیم می‌کند. برای جزئیات درباره توابع توکار اتمی، بخش \fB_\|_atomic Builtins\fR را ببینید. مدل‌ها و پارامترهای زیر پشتیبانی می‌شوند:
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال کردن توالی‌های اتمی تولیدشده توسط کامپایلر و ارسال فراخوانی‌های کتابخانه‌ای برای عملیات اتمی. این حالت پیش‌فرض است اگر مقصد \f(CW\*(C`sh*\-*\-linux*\*(C'\fR نباشد.
.IP \fBsoft\-gusa\fR 4
.IX Item "soft-gusa"
تولید توالی‌های اتمی نرم‌افزاری gUSA سازگار با GNU/Linux برای توابع توکار اتمی. توالی‌های اتمی تولیدشده به پشتیبانی اضافی از سوی کد مدیریت وقفه/استثنای سیستم نیاز دارند و فقط برای سیستم‌های تک‌هسته‌ای SH3* و SH4* مناسب هستند. این گزینه زمانی که مقصد \f(CW\*(C`sh*\-*\-linux*\*(C'\fR و پردازنده SH3* یا SH4* باشد، به‌طور پیش‌فرض فعال است. هنگامی که مقصد SH4A باشد، این گزینه همچنین تا حدی از دستورالعمل‌های سخت‌افزاری اتمی \f(CW\*(C`movli.l\*(C'\fR و \f(CW\*(C`movco.l\*(C'\fR برای تولید کد بهینه‌تر استفاده می‌کند، مگر اینکه \fBstrict\fR مشخص شده باشد.
.IP \fBsoft\-tcb\fR 4
.IX Item "soft-tcb"
تولید توالی‌های نرم‌افزاری اتمی که از متغیری در بلوک کنترل ریسه (thread control block) استفاده می‌کنند. این مورد نوعی تغییریافته از توالی‌های gUSA است که می‌تواند روی مقصدهای SH1* و SH2* نیز استفاده شود. توالی‌های اتمی تولیدشده به پشتیبانی اضافی از طرف کد مدیریت وقفه/استثنای سیستم نیاز دارند و فقط برای سیستم‌های تک‌هسته‌ای مناسب هستند. هنگام استفاده از این مدل، پارامتر \fBgbr\-offset=\fR نیز باید مشخص شود.
.IP \fBsoft\-imask\fR 4
.IX Item "soft-imask"
تولید توالی‌های اتمی نرم‌افزاری که وقفه‌ها را موقتاً با تنظیم \f(CW\*(C`SR.IMASK = 1111\*(C'\fR غیرفعال می‌کنند. این مدل فقط زمانی کار می‌کند که برنامه در حالت ممتاز (privileged mode) اجرا شود و تنها برای سیستم‌های تک‌هسته‌ای مناسب است. پشتیبانی اضافی از طرف کد مدیریت وقفه/استثنای سیستم برای این حالت لازم نیست. این مدل به‌طور پیش‌فرض زمانی که مقصد \f(CW\*(C`sh*\-*\-linux*\*(C'\fR و SH1* یا SH2* باشد فعال می‌شود.
.IP \fBhard\-llcs\fR 4
.IX Item "hard-llcs"
تولید توالی‌های اتمی سخت‌افزاری تنها با استفاده از دستورالعمل‌های \f(CW\*(C`movli.l\*(C'\fR و \f(CW\*(C`movco.l\*(C'\fR. این قابلیت تنها روی SH4A در دسترس است و برای سیستم‌های چند‌هسته‌ای مناسب می‌باشد.
از آنجا که دستورالعمل‌های سخت‌افزاری فقط از متغیرهای اتمی ۳۲ بیتی پشتیبانی می‌کنند، دسترسی به متغیرهای ۸ یا ۱۶ بیتی با دسترسی‌های ۳۲ بیتی شبیه‌سازی می‌شود.
کد کامپایل‌شده با این گزینه، در صورت اجرا روی سیستم SH4A، با سیستم‌های مدیریت وقفه/استثنای سایر مدل‌های اتمی نرم‌افزاری نیز سازگار است. برای این مدل پشتیبانی اضافی از طرف کد مدیریت وقفه/استثنای سیستم لازم نیست..IP \fBgbr\-offset=\fR 4
.IX Item "gbr-offset="
این پارامتر، آفست (برحسب بایت) متغیر در ساختار بلوک کنترل ریسه (thread control block) را مشخص می‌کند که باید توسط توالی‌های اتمیکِ تولیدشده در هنگام انتخاب مدل \fBsoft\-tcb\fR استفاده شود. برای سایر مدل‌ها، این پارامتر نادیده گرفته می‌شود. مقدار مشخص‌شده باید مضرب صحیحی از چهار و در بازهٔ 0\-1020 باشد.
.IP \fBstrict\fR 4
.IX Item "strict"
این پارامتر از استفادهٔ ترکیبی چندین مدل اتمیک، حتی در صورت سازگار بودن آن‌ها، جلوگیری می‌کند و کامپایلر را وادار می‌سازد تا توالی‌های اتمیک را تنها بر اساس مدل مشخص‌شده تولید کند.
.RE
.RS 4
.RE
.IP \fB\-mtas\fR 4
.IX Item "-mtas"
کد دستوریِ \f(CW\*(C`tas.b\*(C'\fR را برای \f(CW\*(C`_\|_atomic_test_and_set\*(C'\fR تولید می‌کند.
توجه داشته باشید که بسته به پیکربندی سخت‌افزاری و نرم‌افزاری خاص، این کار می‌تواند به دلیل تخلیهٔ خط حافظهٔ نهانِ عملوند ناشی از دستورالعمل \f(CW\*(C`tas.b\*(C'\fR، کارایی کلی را کاهش دهد. در پردازنده‌های چند‌هسته‌ای SH4A، دستورالعمل \f(CW\*(C`tas.b\*(C'\fR باید با احتیاط استفاده شود چرا که در برخی پیکربندی‌های حافظهٔ نهان می‌تواند منجر به آسیب‌دیدگی داده‌ها شود.
.IP \fB\-mprefergot\fR 4
.IX Item "-mprefergot"
هنگام تولید کد مستقل از موقعیت، فراخوانی‌های تابع را به جای جدول پیوند رویه (Procedure Linkage Table) با استفاده از جدول آفست سراسری (Global Offset Table) صادر می‌کند.
.IP \fB\-musermode\fR 4
.IX Item "-musermode"
.PD 0
.IP \fB\-mno\-usermode\fR 4
.IX Item "-mno-usermode"
.PD
به کامپایلر اجازه نمی‌دهد (اجازه می‌دهد) کدی برای حالت ممتاز تولید کند. مشخص کردن
\&\fB\-musermode\fR همچنین در صورتی که کد درون‌خطی‌شده در حالت کاربری کار نکند، \fB\-mno\-inline\-ic_invalidate\fR را نیز در بر دارد. \fB\-musermode\fR هنگامی که مقصد \f(CW\*(C`sh*\-*\-linux*\*(C'\fR باشد، حالت پیش‌فرض است. اگر مقصد SH1* یا SH2* باشد،
\&\fB\-musermode\fR هیچ تأثیری ندارد، زیرا حالت کاربری وجود ندارد.
.IP \fB\-multcost=\fR\fInumber\fR 4
.IX Item "-multcost=number"
هزینهٔ در نظر گرفته‌شده برای یک دستورالعمل ضرب را تعیین می‌کند.
.IP \fB\-mdiv=\fR\fIstrategy\fR 4
.IX Item "-mdiv=strategy"
راهبرد تقسیم مورد استفاده برای عملیات تقسیم عدد صحیح را تعیین می‌کند.
\&\fIstrategy\fR می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP \fBcall\-div1\fR 4
.IX Item "call-div1"
تابعی از کتابخانه را فراخوانی می‌کند که برای انجام عملیات از دستورالعمل تقسیم تک‌مرحله‌ای
\&\f(CW\*(C`div1\*(C'\fR استفاده می‌کند. تقسیم بر صفر نتیجه‌ای نامشخص تولید می‌کند و به تله (trap) منجر نمی‌شود. این حالت به‌جز برای SH4،
SH2A و SHcompact پیش‌فرض است.
.IP \fBcall\-fp\fR 4
.IX Item "call-fp"
تابعی از کتابخانه را فراخوانی می‌کند که عملیات را با ممیز شناور دقت‌مضاعف انجام می‌دهد. تقسیم بر صفر باعث ایجاد استثنای ممیز شناور می‌شود. این حالت برای SHcompact دارای FPU پیش‌فرض است. مشخص کردن این مورد برای مقاصدی که فاقد FPU دقت‌مضاعف هستند، به \f(CW\*(C`call\-div1\*(C'\fR برمی‌گردد.
.IP \fBcall\-table\fR 4
.IX Item "call-table"
تابعی از کتابخانه را فراخوانی می‌کند که برای مقسوم‌علیه‌های کوچک از یک جدول جست‌وجو (lookup table) و برای مقسوم‌علیه‌های بزرگ‌تر از دستورالعمل \f(CW\*(C`div1\*(C'\fR همراه با تفکیک حالات استفاده می‌کند.
تقسیم بر صفر نتیجه‌ای نامشخص تولید می‌کند و به تله منجر نمی‌شود.
این حالت پیش‌فرضِ
SH4 است. مشخص کردن این مورد برای مقاصدی که فاقد دستورالعمل‌های تغییر مکان پویا هستند، به \f(CW\*(C`call\-div1\*(C'\fR برمی‌گردد.
.RE
.RS 4
.Sp
هنگامی که راهبرد تقسیم مشخص نشده باشد، راهبرد پیش‌فرض بر اساس مقصد فعلی انتخاب می‌شود. برای SH2A راهبرد پیش‌فرض، استفاده از دستورالعمل‌های \f(CW\*(C`divs\*(C'\fR و \f(CW\*(C`divu\*(C'\fR به جای فراخوانی توابع کتابخانه‌ای است.
.RE
.IP \fB\-maccumulate\-outgoing\-args\fR 4
.IX Item "-maccumulate-outgoing-args"
.PD 0
.IP \fB\-mno\-accumulate\-outgoing\-args\fR 4
.IX Item "-mno-accumulate-outgoing-args"
.PD
فضا را یک‌بار در مقدمهٔ تابع برای آرگومان‌های خروجی رزرو می‌کند، به جای آنکه این کار در اطراف هر فراخوانی انجام شود. این کار به‌طور کلی برای کارایی و اندازه مفید است و همچنین برای بازپیچی (unwinding) جهت جلوگیری از تغییر فریم پشته در اطراف کد شرطی لازم است. \fB\-maccumulate\-outgoing\-args\fR
به‌طور پیش‌فرض فعال است.
.IP \fB\-mdivsi3_libfunc=\fR\fIname\fR 4
.IX Item "-mdivsi3_libfunc=name"
نام تابع کتابخانه‌ای مورد استفاده برای تقسیم علامت‌دار ۳۲ بیتی را روی
\&\fIname\fR تنظیم می‌کند.
این گزینه فقط بر نام استفاده‌شده در راهبردهای تقسیم \fBcall\fR تأثیر می‌گذارد، و کامپایلر همچنان انتظار همان مجموعه‌های ثبات‌های ورودی/خروجی/تخریب‌شده را دارد که گویی این گزینه وجود نداشته است.
.IP \fB\-mfixed\-range=\fR\fIregister\-range\fR 4
.IX Item "-mfixed-range=register-range"
کدی تولید می‌کند که با بازهٔ ثبات‌های ارائه‌شده به عنوان ثبات‌های ثابت برخورد می‌کند. ثبات ثابت ثباتی است که تخصیص‌دهندهٔ ثبات نمی‌تواند از آن استفاده کند. این گزینه هنگام کامپایل کد هسته مفید است. بازهٔ ثبات با دو ثبات که با یک خط تیره از هم جدا شده‌اند مشخص می‌شود. می‌توان چندین بازهٔ ثبات را جداشده با کاما مشخص کرد.
.IP \fB\-mbranch\-cost=\fR\fInum\fR 4
.IX Item "-mbranch-cost=num"
مقدار \fInum\fR را به عنوان هزینهٔ یک دستورالعمل انشعاب در نظر می‌گیرد. مقادیر بالاتر باعث می‌شوند کامپایلر در صورت امکان تلاش کند کدهای بدون انشعاب بیشتری تولید کند. اگر مشخص نشود، این مقدار بسته به نوع پردازنده‌ای که برای آن کامپایل می‌شود انتخاب می‌گردد.
.IP \fB\-mzdcbranch\fR 4
.IX Item "-mzdcbranch"
.PD 0
.IP \fB\-mno\-zdcbranch\fR 4
.IX Item "-mno-zdcbranch"
.PD
فرض می‌کند (فرض نمی‌کند) که دستورالعمل‌های انشعاب شرطی با جابه‌جایی صفر
\&\f(CW\*(C`bt\*(C'\fR و \f(CW\*(C`bf\*(C'\fR سریع هستند. اگر \fB\-mzdcbranch\fR مشخص شود، کامپایلر توالی‌های کد انشعاب با جابه‌جایی صفر را ترجیح می‌دهد. این گزینه هنگام تولید کد برای SH4 و SH4A به‌طور پیش‌فرض فعال است.
می‌توان آن را به‌طور صریح با مشخص کردن \fB\-mno\-zdcbranch\fR غیرفعال کرد.
.IP \fB\-mcbranch\-force\-delay\-slot\fR 4
.IX Item "-mcbranch-force-delay-slot"
استفاده از شکاف‌های تأخیر را برای انشعاب‌های شرطی اجباری می‌کند، که در صورت نیافتن دستورالعمل مناسب، شکاف تأخیر را با یک \f(CW\*(C`nop\*(C'\fR پر می‌کند.
به‌طور پیش‌فرض
این گزینه غیرفعال است. این گزینه می‌تواند برای دور زدن اشکالات سخت‌افزاریِ موجود در SH7055 اصلی فعال شود.
.IP \fB\-mfsca\fR 4
.IX Item "-mfsca"
.PD 0
.IP \fB\-mno\-fsca\fR 4
.IX Item "-mno-fsca"
.PD
به کامپایلر اجازه می‌دهد یا نمی‌دهد که دستورالعمل \f(CW\*(C`fsca\*(C'\fR را برای تقریب‌های سینوس و کسینوس صادر کند. گزینهٔ \fB\-mfsca\fR باید در ترکیب با \fB\-funsafe\-math\-optimizations\fR استفاده شود.
این گزینه هنگام تولید کد برای SH4A به‌طور پیش‌فرض فعال است.
استفاده از \fB\-mno\-fsca\fR تقریب‌های سینوس و کسینوس را غیرفعال می‌کند، حتی اگر \fB\-funsafe\-math\-optimizations\fR فعال باشد.
.IP \fB\-mfsrra\fR 4
.IX Item "-mfsrra"
.PD 0
.IP \fB\-mno\-fsrra\fR 4
.IX Item "-mno-fsrra"
.PD
به کامپایلر اجازه می‌دهد یا نمی‌دهد که دستورالعمل \f(CW\*(C`fsrra\*(C'\fR را برای تقریب‌های معکوس ریشهٔ دوم صادر کند. گزینهٔ \fB\-mfsrra\fR
باید در ترکیب با \fB\-funsafe\-math\-optimizations\fR و
\&\fB\-ffinite\-math\-only\fR استفاده شود.
این گزینه هنگام تولید کد برای SH4A به‌طور پیش‌فرض فعال است.
استفاده از \fB\-mno\-fsrra\fR تقریب‌های معکوس ریشهٔ دوم را غیرفعال می‌کند،
حتی اگر \fB\-funsafe\-math\-optimizations\fR و \fB\-ffinite\-math\-only\fR
فعال باشند.
.IP \fB\-mpretend\-cmove\fR 4
.IX Item "-mpretend-cmove"
.PD 0
.IP \fB\-mno\-pretend\-cmove\fR 4
.IX Item "-mno-pretend-cmove"
.PD
انشعاب‌های شرطی با جابه‌جایی صفر را برای الگوهای دستورالعمل انتقال شرطی ترجیح می‌دهد یا ترجیح نمی‌دهد.
این کار می‌تواند منجر به کدهای سریع‌تر در پردازندهٔ SH4 شود.
.IP \fB\-mfdpic\fR 4
.IX Item "-mfdpic"
.PD 0
.IP \fB\-mno\-fdpic\fR 4
.IX Item "-mno-fdpic"
.PD
کد را با استفاده از ABI مربوط به FDPIC تولید می‌کند.
.IP \fB\-mlra\fR 4
.IX Item "-mlra"
.PD 0
.IP \fB\-mno\-lra\fR 4
.IX Item "-mno-lra"
.PD
از تخصیص‌دهندهٔ جدید ثبات LRA استفاده می‌کند. به‌طور پیش‌فرض، تخصیص‌دهندهٔ قدیمی «reload» استفاده می‌شود.
.PP
\fIگزینه‌های Solaris 2\fR
.IX Subsection "Solaris 2 Options"
.PP
این گزینه‌ها در Solaris 2 پشتیبانی می‌شوند:
.IP \fB\-mclear\-hwcap\fR 4
.IX Item "-mclear-hwcap".PD 0
.IP \fB\-mno\-clear\-hwcap\fR 4
.IX Item "-mno-clear-hwcap"
.PD
گزینهٔ \fB\-mclear\-hwcap\fR به کامپایلر می‌گوید قابلیت‌های سخت‌افزاری (hardware capabilities) تولیدشده توسط اسمبلر Solaris را حذف کند. این کار تنها زمانی ضروری است که فایل‌های شیء از افزونه‌های ISA استفاده می‌کنند که توسط ماشین فعلی پشتیبانی نمی‌شود، اما در زمان اجرا بررسی می‌کنند که آیا باید از آن‌ها استفاده شود یا خیر.
.IP \fB\-mimpure\-text\fR 4
.IX Item "-mimpure-text"
.PD 0
.IP \fB\-mno\-impure\-text\fR 4
.IX Item "-mno-impure-text"
.PD
گزینهٔ \fB\-mimpure\-text\fR که علاوه بر \fB\-shared\fR استفاده می‌شود، به کامپایلر می‌گوید هنگام پیوند یک شیء اشتراکی (shared object)، گزینهٔ \fB\-z text\fR را به پیونددهنده ارسال نکند. با استفاده از این گزینه، می‌توانید کد وابسته به موقعیت (position\-dependent) را به یک شیء اشتراکی پیوند دهید.
.Sp
گزینهٔ \fB\-mimpure\-text\fR پیام خطای پیونددهنده مبنی بر «relocations remain against allocatable but non\-writable sections» را فرونشانی می‌کند. با این حال، بازنشانی‌های ضروری باعث برانگیختن رونوشت در زمان نوشتن (copy\-on\-write) می‌شوند و شیء اشتراکی عملاً بین فرایندها به اشتراک گذاشته نمی‌شود. به جای استفاده از \fB\-mimpure\-text\fR، باید تمام کدهای منبع را با \fB\-fpic\fR یا \fB\-fPIC\fR کامپایل کنید.
.IP \fB\-gsctf\fR 4
.IX Item "-gsctf"
قالب CTF مربوط به Solaris را تولید می‌کند. باید هم برای کامپایل و هم برای پیوند استفاده شود. برای اطلاعات بیشتر \fBctf\|(7)\fR را ببینید. این گزینه تنها از Solaris 11.4 SRU 84 به بعد که پشتیبانی لازم به زنجیره‌ابزار افزوده شد، پشتیبانی می‌شود.
.PP
\fIگزینه‌های SPARC\fR
.IX Subsection "SPARC Options"
.PP
این گزینه‌های \fB\-m\fR در SPARC پشتیبانی می‌شوند:
.IP \fB\-mno\-app\-regs\fR 4
.IX Item "-mno-app-regs"
.PD 0
.IP \fB\-mapp\-regs\fR 4
.IX Item "-mapp-regs"
.PD
گزینهٔ \fB\-mapp\-regs\fR را مشخص کنید تا خروجی با استفاده از ثبات‌های سراسری ۲ تا ۴ تولید شود؛ ثبات‌هایی که SPARC SVR4 ABI برای برنامه‌های کاربردی رزرو کرده است. مانند ثبات سراسری ۱، با هر یک از ثبات‌های سراسری ۲ تا ۴ نیز به عنوان یک ثبات قابل تخصیص که با فراخوانی توابع بازنویسی (clobber) می‌شود رفتار خواهد شد. این حالت پیش‌فرض است.
.Sp
برای سازگاری کامل با SVR4 ABI به قیمت مقداری افت کارایی، \fB\-mno\-app\-regs\fR را مشخص کنید. باید کتابخانه‌ها و نرم‌افزارهای سیستمی را با این گزینه کامپایل کنید.
.IP \fB\-mflat\fR 4
.IX Item "-mflat"
.PD 0
.IP \fB\-mno\-flat\fR 4
.IX Item "-mno-flat"
.PD
با \fB\-mflat\fR، کامپایلر دستورالعمل‌های save/restore را تولید نمی‌کند و از یک مدل پنجرهٔ ثبات «مسطح» (flat) یا تک‌پنجره‌ای استفاده می‌کند. این مدل با مدل پنجرهٔ ثبات معمولی سازگار است. ثبات‌های محلی و ثبات‌های ورودی (۰ تا ۵) همچنان به عنوان ثبات‌های ذخیره‌شده توسط فراخوانده‌شده (call\-saved) در نظر گرفته می‌شوند و در صورت نیاز روی پشته ذخیره می‌شوند.
.Sp
با \fB\-mno\-flat\fR (پیش‌فرض)، کامپایلر دستورالعمل‌های save/restore را تولید می‌کند (به جز برای توابع برگ یا leaf functions). این حالت کاری عادی است.
.IP \fB\-mfpu\fR 4
.IX Item "-mfpu"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
خروجی شامل دستورالعمل‌های ممیز شناور (floating\-point) تولید می‌کند. این حالت پیش‌فرض است.
.IP \fB\-mno\-fpu\fR 4
.IX Item "-mno-fpu"
.PD 0
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD
خروجی شامل فراخوانی‌های کتابخانه‌ای برای ممیز شناور تولید می‌کند.
\&\fBهشدار:\fR کتابخانه‌های لازم برای تمام اهداف SPARC در دسترس نیستند. معمولاً از امکانات کامپایلر C معمول ماشین استفاده می‌شود، اما این کار در کامپایل متقابل (cross\-compilation) مستقیماً امکان‌پذیر نیست. برای کامپایل متقابل باید خودتان ترتیبی برای ارائهٔ توابع کتابخانه‌ای مناسب اتخاذ کنید. اهداف توکار \fBsparc\-*\-aout\fR و \&\fBsparclite\-*\-*\fR پشتیبانی ممیز شناور نرم‌افزاری را ارائه می‌دهند.
.Sp
گزینهٔ \&\fB\-msoft\-float\fR شیوهٔ فراخوانی (calling convention) را در فایل خروجی تغییر می‌دهد؛ بنابراین تنها زمانی مفید است که \fIتمام\fR برنامه را با این گزینه کامپایل کنید. به‌ویژه، باید \fIlibgcc.a\fR (کتابخانه‌ای که همراه GCC ارائه می‌شود) را با \fB\-msoft\-float\fR کامپایل کنید تا به درستی کار کند.
.IP \fB\-mhard\-quad\-float\fR 4
.IX Item "-mhard-quad-float"
خروجی شامل دستورالعمل‌های ممیز شناور با کلمهٔ چهارگانه (long double) تولید می‌کند.
.IP \fB\-msoft\-quad\-float\fR 4
.IX Item "-msoft-quad-float"
خروجی شامل فراخوانی‌های کتابخانه‌ای برای دستورالعمل‌های ممیز شناور با کلمهٔ چهارگانه (long double) تولید می‌کند. توابع فراخوانی‌شده همان‌هایی هستند که در SPARC ABI مشخص شده‌اند. این حالت پیش‌فرض است.
.Sp
تا زمان نگارش این مستند، هیچ پیاده‌سازی از SPARC وجود ندارد که از دستورالعمل‌های سخت‌افزاری ممیز شناور کلمهٔ چهارگانه پشتیبانی کند. همهٔ آن‌ها برای این دستورالعمل‌ها یک گردانندهٔ تله (trap handler) فراخوانی می‌کنند، و سپس گردانندهٔ تله اثر آن دستورالعمل را شبیه‌سازی می‌کند. به دلیل سربار گردانندهٔ تله، این روش بسیار کندتر از فراخوانی توابع کتابخانهٔ ABI است. بنابراین گزینهٔ \&\fB\-msoft\-quad\-float\fR پیش‌فرض است.
.IP \fB\-mno\-unaligned\-doubles\fR 4
.IX Item "-mno-unaligned-doubles"
.PD 0
.IP \fB\-munaligned\-doubles\fR 4
.IX Item "-munaligned-doubles"
.PD
فرض می‌کند که doubleها ترازبندی ۸ بایتی دارند. این حالت پیش‌فرض است.
.Sp
با \fB\-munaligned\-doubles\fR، کامپایلر GCC تنها در صورتی فرض می‌کند که doubleها ترازبندی ۸ بایتی دارند که در نوع دیگری گنجانده شده باشند، یا آدرس مطلق داشته باشند. در غیر این صورت، فرض می‌کند که آن‌ها ترازبندی ۴ بایتی دارند. مشخص کردن این گزینه از برخی مشکلات نادر سازگاری با کدهای تولیدشده توسط دیگر کامپایلرها جلوگیری می‌کند. این حالت پیش‌فرض نیست زیرا منجر به افت کارایی، به‌ویژه برای کدهای ممیز شناور می‌شود.
.IP \fB\-muser\-mode\fR 4
.IX Item "-muser-mode"
.PD 0
.IP \fB\-mno\-user\-mode\fR 4
.IX Item "-mno-user-mode"
.PD
کدی که فقط می‌تواند در حالت ناظر (supervisor mode) اجرا شود تولید نمی‌کند. این موضوع تنها مربوط به دستورالعمل \f(CW\*(C`casa\*(C'\fR است که برای پردازندهٔ LEON3 صادر می‌شود. این حالت پیش‌فرض است.
.IP \fB\-mfaster\-structs\fR 4
.IX Item "-mfaster-structs"
.PD 0
.IP \fB\-mno\-faster\-structs\fR 4
.IX Item "-mno-faster-structs"
.PD
با \fB\-mfaster\-structs\fR، کامپایلر فرض می‌کند ساختارها (structures) باید ترازبندی ۸ بایتی داشته باشند. این کار استفاده از جفت‌دستورالعمل‌های \f(CW\*(C`ldd\*(C'\fR و \f(CW\*(C`std\*(C'\fR را برای رونوشت‌ها در انتساب ساختار، به جای دو برابر جفت‌های \f(CW\*(C`ld\*(C'\fR و \f(CW\*(C`st\*(C'\fR ممکن می‌سازد. با این حال، استفاده از این ترازبندی تغییریافته مستقیماً SPARC ABI را نقض می‌کند. بنابراین، این گزینه فقط برای استفاده روی اهدافی در نظر گرفته شده است که توسعه‌دهنده اذعان دارد کد حاصل مستقیماً با قوانین ABI مطابقت ندارد.
.IP \fB\-mstd\-struct\-return\fR 4
.IX Item "-mstd-struct-return"
.PD 0
.IP \fB\-mno\-std\-struct\-return\fR 4
.IX Item "-mno-std-struct-return"
.PD
با \fB\-mstd\-struct\-return\fR، کامپایلر طبق 32\-bit ABI کدهای بررسی‌کننده در توابعی که ساختارها یا اجتماع‌ها (unions) را برمی‌گردانند تولید می‌کند تا عدم تطابق اندازه میان دو طرف فراخوانی تابع را تشخیص دهد.
.Sp
پیش‌فرض \fB\-mno\-std\-struct\-return\fR است. این گزینه در حالت ۶۴ بیتی هیچ اثری ندارد.
.IP \fB\-mcpu=\fR\fIcpu_type\fR 4
.IX Item "-mcpu=cpu_type"
مجموعه دستورالعمل، مجموعه ثبات‌ها، و پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \fIcpu_type\fR تنظیم می‌کند. مقادیر پشتیبانی‌شده برای \fIcpu_type\fR عبارتند از:
\&\fBv7\fR، \fBcypress\fR، \fBv8\fR، \fBsupersparc\fR، \fBhypersparc\fR،
\&\fBleon\fR، \fBleon3\fR، \fBleon3v7\fR، \fBleon5\fR، \fBsparclite\fR،
\&\fBf930\fR، \fBf934\fR، \fBsparclite86x\fR، \fBsparclet\fR، \fBtsc701\fR،
\&\fBv9\fR، \fBultrasparc\fR، \fBultrasparc3\fR، \fBniagara\fR،
\&\fBniagara2\fR، \fBniagara3\fR، \fBniagara4\fR، \fBniagara7\fR و
\&\fBm8\fR.
.Sp
زنجیره‌ابزارهای بومی Solaris و GNU/Linux همچنین از مقدار \fBnative\fR پشتیبانی می‌کنند که بهترین گزینهٔ معماری را برای پردازندهٔ میزبان انتخاب می‌کند. اگر GCC پردازنده را شناسایی نکند، \fB\-mcpu=native\fR هیچ تأثیری ندارد.
.Sp
پارامترهای زمان‌بندی دستورالعمل پیش‌فرض برای مقادیری استفاده می‌شوند که یک معماری و نه یک پیاده‌سازی را انتخاب می‌کنند. این مقادیر عبارتند از \fBv7\fR، \fBv8\fR،
\&\fBsparclite\fR، \fBsparclet\fR و \fBv9\fR.
.Sp
در اینجا فهرستی از هر معماری پشتیبانی‌شده و پیاده‌سازی‌های پشتیبانی‌شدهٔ آن‌ها آمده است.
.RS 4
.IP v7 4
.IX Item "v7"
cypress, leon3v7.IP v8 4
.IX Item "v8"
supersparc, hypersparc, leon, leon3, leon5
.IP sparclite 4
.IX Item "sparclite"
f930, f934, sparclite86x
.IP sparclet 4
.IX Item "sparclet"
tsc701
.IP v9 4
.IX Item "v9"
ultrasparc, ultrasparc3, niagara, niagara2, niagara3, niagara4,
niagara7, m8
.RE
.RS 4
.Sp
به‌طور پیش‌فرض (مگر اینکه طور دیگری پیکربندی شده باشد)، GCC کدی برای گونهٔ V7 از معماری SPARC تولید می‌کند. با \fB\-mcpu=cypress\fR، کامپایلر علاوه بر آن، کد را برای تراشهٔ Cypress CY7C602 که در سری SPARCStation/SPARCServer 3xx استفاده شده است بهینه‌سازی می‌کند. این مقدار همچنین برای مدل‌های قدیمی‌تر SPARCStation 1، 2، IPX و غیره مناسب است.
.Sp
با \fB\-mcpu=v8\fR، کامپایلر GCC کدی برای گونهٔ V8 معماری SPARC تولید می‌کند. تنها تفاوت آن با کد V7 این است که کامپایلر دستورالعمل‌های ضرب عدد صحیح و تقسیم عدد صحیح را صادر می‌کند که در SPARC\-V8 وجود دارند اما در SPARC\-V7 موجود نیستند. با \fB\-mcpu=supersparc\fR، کامپایلر علاوه بر این، کد را برای تراشهٔ SuperSPARC، که در سری SPARCStation 10، 1000 و 2000 به کار رفته است، بهینه‌سازی می‌کند.
.Sp
با \fB\-mcpu=sparclite\fR، کامپایلر GCC کدی برای گونهٔ SPARClite معماری SPARC تولید می‌کند. این گزینه دستورالعمل‌های ضرب عدد صحیح، گام تقسیم عدد صحیح و پویش (\f(CW\*(C`ffs\*(C'\fR) را که در SPARClite وجود داشته اما در SPARC\-V7 وجود ندارند اضافه می‌کند. با \fB\-mcpu=f930\fR، کامپایلر علاوه بر این، کد را برای تراشهٔ Fujitsu MB86930 که گونهٔ اولیهٔ SPARClite و بدون FPU است بهینه‌سازی می‌کند. با \&\fB\-mcpu=f934\fR، کامپایلر علاوه بر این، کد را برای تراشهٔ جدیدتر Fujitsu MB86934 همراه با FPU بهینه‌سازی می‌کند.
.Sp
با \fB\-mcpu=sparclet\fR، کامپایلر GCC کدی برای گونهٔ SPARClet معماری SPARC تولید می‌کند. این گزینه دستورالعمل‌های ضرب عدد صحیح، ضرب/انباشت، گام تقسیم عدد صحیح و پویش (\f(CW\*(C`ffs\*(C'\fR) را که در SPARClet وجود دارند اما در SPARC\-V7 نیستند اضافه می‌کند. با \fB\-mcpu=tsc701\fR، کامپایلر علاوه بر این، کد را برای تراشهٔ TEMIC SPARClet بهینه‌سازی می‌کند.
.Sp
با \fB\-mcpu=v9\fR، کامپایلر GCC کدی برای گونهٔ V9 معماری SPARC تولید می‌کند. این گزینه دستورالعمل‌های انتقال ۶۴ بیتی عدد صحیح و ممیز شناور، ۳ ثبات کد وضعیت ممیز شناور اضافی و دستورالعمل‌های انتقال شرطی را اضافه می‌کند. با \fB\-mcpu=ultrasparc\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC I/II/IIi بهینه‌سازی می‌کند. با \&\fB\-mcpu=ultrasparc3\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC III/III+/IIIi/IIIi+/IV/IV+ بهینه‌سازی می‌کند. با \&\fB\-mcpu=niagara\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC T1 بهینه‌سازی می‌کند. با \fB\-mcpu=niagara2\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC T2 بهینه‌سازی می‌کند. با \&\fB\-mcpu=niagara3\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC T3 بهینه‌سازی می‌کند. با \fB\-mcpu=niagara4\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Sun UltraSPARC T4 بهینه‌سازی می‌کند. با \&\fB\-mcpu=niagara7\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Oracle SPARC M7 بهینه‌سازی می‌کند. با \fB\-mcpu=m8\fR، کامپایلر علاوه بر این، کد را برای تراشه‌های Oracle M8 بهینه‌سازی می‌کند.
.RE
.IP \fB\-mtune=\fR\fIcpu_type\fR 4
.IX Item "-mtune=cpu_type"
پارامترهای زمان‌بندی دستورالعمل‌ها را برای نوع ماشین \fIcpu_type\fR تعیین می‌کند، اما بر خلاف گزینهٔ \fB\-mcpu=\fR\fIcpu_type\fR، مجموعه دستورالعمل‌ها یا مجموعه ثبات‌ها را تغییر نمی‌دهد.
.Sp
همان مقادیر مجاز برای \fB\-mcpu=\fR\fIcpu_type\fR را می‌توان برای \&\fB\-mtune=\fR\fIcpu_type\fR نیز به کار برد، اما تنها مقادیر سودمند آن‌هایی هستند که یک پیاده‌سازی خاص از پردازنده را انتخاب می‌کنند. این مقادیر عبارتند از:
\&\fBcypress\fR، \fBsupersparc\fR، \fBhypersparc\fR، \fBleon\fR،
\&\fBleon3\fR، \fBleon3v7\fR، \fBleon5\fR، \fBf930\fR، \fBf934\fR،
\&\fBsparclite86x\fR، \fBtsc701\fR، \fBultrasparc\fR،
\&\fBultrasparc3\fR، \fBniagara\fR، \fBniagara2\fR، \fBniagara3\fR،
\&\fBniagara4\fR، \fBniagara7\fR و \fBm8\fR. در زنجیره‌ابزارهای بومی Solaris و GNU/Linux، از مقدار \fBnative\fR نیز می‌توان استفاده کرد.
.IP \fB\-mv8plus\fR 4
.IX Item "-mv8plus"
.PD 0
.IP \fB\-mno\-v8plus\fR 4
.IX Item "-mno-v8plus"
.PD
با \fB\-mv8plus\fR، کامپایلر GCC کدی منطبق بر ABI مربوط به SPARC\-V8+ تولید می‌کند. تفاوت آن با ABI مربوط به V8 در این است که ثبات‌های سراسری و خروجی ۶۴ بیتی در نظر گرفته می‌شوند. این گزینه به‌طور پیش‌فرض در Solaris در حالت ۳۲ بیتی برای تمام پردازنده‌های SPARC\-V9 فعال است.
.IP \fB\-mvis\fR 4
.IX Item "-mvis"
.PD 0
.IP \fB\-mno\-vis\fR 4
.IX Item "-mno-vis"
.PD
با \fB\-mvis\fR، کامپایلر GCC کدی تولید می‌کند که از افزونه‌های مجموعه دستورالعمل تصویری (VIS) پردازندهٔ UltraSPARC بهره می‌برد. مقدار پیش‌فرض \fB\-mno\-vis\fR است.
.IP \fB\-mvis2\fR 4
.IX Item "-mvis2"
.PD 0
.IP \fB\-mno\-vis2\fR 4
.IX Item "-mno-vis2"
.PD
با \fB\-mvis2\fR، کامپایلر GCC کدی تولید می‌کند که از نسخهٔ 2.0 افزونه‌های مجموعه دستورالعمل تصویری UltraSPARC بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند UltraSPARC\-III و جدیدتر، پیش‌فرض \fB\-mvis2\fR است. تعیین \fB\-mvis2\fR همچنین گزینهٔ \fB\-mvis\fR را فعال می‌کند.
.IP \fB\-mvis3\fR 4
.IX Item "-mvis3"
.PD 0
.IP \fB\-mno\-vis3\fR 4
.IX Item "-mno-vis3"
.PD
با \fB\-mvis3\fR، کامپایلر GCC کدی تولید می‌کند که از نسخهٔ 3.0 افزونه‌های مجموعه دستورالعمل تصویری UltraSPARC بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند niagara\-3 و جدیدتر، پیش‌فرض \fB\-mvis3\fR است. تعیین \fB\-mvis3\fR همچنین گزینه‌های \fB\-mvis2\fR و \fB\-mvis\fR را فعال می‌کند.
.IP \fB\-mvis3b\fR 4
.IX Item "-mvis3b"
.PD 0
.IP \fB\-mno\-vis3b\fR 4
.IX Item "-mno-vis3b"
.PD
با \fB\-mvis3b\fR، کامپایلر GCC کدی تولید می‌کند که از نسخهٔ 3.0 افزونه‌های مجموعه دستورالعمل تصویری UltraSPARC، به همراه دستورالعمل‌های اضافی VIS معرفی‌شده در معماری Oracle SPARC 2011 بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند niagara\-7 و جدیدتر، پیش‌فرض \fB\-mvis3b\fR است. تعیین \fB\-mvis3b\fR همچنین گزینه‌های \fB\-mvis3\fR، \fB\-mvis2\fR و \fB\-mvis\fR را فعال می‌کند.
.IP \fB\-mvis4\fR 4
.IX Item "-mvis4"
.PD 0
.IP \fB\-mno\-vis4\fR 4
.IX Item "-mno-vis4"
.PD
با \fB\-mvis4\fR، کامپایلر GCC کدی تولید می‌کند که از نسخهٔ 4.0 افزونه‌های مجموعه دستورالعمل تصویری UltraSPARC بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند niagara\-7 و جدیدتر، پیش‌فرض \fB\-mvis4\fR است. تعیین \fB\-mvis4\fR همچنین گزینه‌های \fB\-mvis3b\fR، \fB\-mvis3\fR، \fB\-mvis2\fR و \&\fB\-mvis\fR را فعال می‌کند.
.IP \fB\-mvis4b\fR 4
.IX Item "-mvis4b"
.PD 0
.IP \fB\-mno\-vis4b\fR 4
.IX Item "-mno-vis4b"
.PD
با \fB\-mvis4b\fR، کامپایلر GCC کدی تولید می‌کند که از نسخهٔ 4.0 افزونه‌های مجموعه دستورالعمل تصویری UltraSPARC، به همراه دستورالعمل‌های اضافی VIS معرفی‌شده در معماری Oracle SPARC 2017 بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند m8 و جدیدتر، پیش‌فرض \fB\-mvis4b\fR است. تعیین \&\fB\-mvis4b\fR همچنین گزینه‌های \fB\-mvis4\fR، \fB\-mvis3b\fR، \&\fB\-mvis3\fR، \fB\-mvis2\fR و \fB\-mvis\fR را فعال می‌کند.
.IP \fB\-mcbcond\fR 4
.IX Item "-mcbcond"
.PD 0
.IP \fB\-mno\-cbcond\fR 4
.IX Item "-mno-cbcond"
.PD
با \fB\-mcbcond\fR، کامپایلر GCC کدی تولید می‌کند که از دستورالعمل‌های مقایسه و پرش شرطی (Compare\-and\-Branch\-on\-Condition) در UltraSPARC بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند Niagara\-4 و جدیدتر، پیش‌فرض \fB\-mcbcond\fR است.
.IP \fB\-mfmaf\fR 4
.IX Item "-mfmaf"
.PD 0
.IP \fB\-mno\-fmaf\fR 4
.IX Item "-mno-fmaf"
.PD
با \fB\-mfmaf\fR، کامپایلر GCC کدی تولید می‌کند که از دستورالعمل‌های ممیز شناور ضرب-جمع توأم (Fused Multiply\-Add) در UltraSPARC بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از این دستورالعمل‌ها پشتیبانی می‌کند، مانند Niagara\-3 و جدیدتر، پیش‌فرض \fB\-mfmaf\fR است.
.IP \fB\-mfsmuld\fR 4
.IX Item "-mfsmuld"
.PD 0
.IP \fB\-mno\-fsmuld\fR 4
.IX Item "-mno-fsmuld"
.PD
با \fB\-mfsmuld\fR، کامپایلر GCC کدی تولید می‌کند که از دستورالعمل ضرب ممیز شناور تکی به دوگانه (FsMULd) بهره می‌برد. هنگام هدف قرار دادن پردازنده‌ای که از نسخه‌های معماری V8 یا V9 با FPU به جز \fB\-mcpu=leon\fR پشتیبانی می‌کند، پیش‌فرض \&\fB\-mfsmuld\fR است..IP \fB\-mpopc\fR 4
.IX Item "-mpopc"
.PD 0
.IP \fB\-mno\-popc\fR 4
.IX Item "-mno-popc"
.PD
با \fB\-mpopc\fR، کامپایلر GCC کدی تولید می‌کند که از دستورالعمل Population Count در UltraSPARC بهره می‌برد. در صورت هدف‌قرار دادن پردازنده‌ای که از چنین دستورالعملی پشتیبانی می‌کند (مانند Niagara\-2 و بعد از آن)، پیش‌فرض \fB\-mpopc\fR است.
.IP \fB\-msubxc\fR 4
.IX Item "-msubxc"
.PD 0
.IP \fB\-mno\-subxc\fR 4
.IX Item "-mno-subxc"
.PD
با \fB\-msubxc\fR، کامپایلر GCC کدی تولید می‌کند که از دستورالعمل Subtract\-Extended\-with\-Carry در UltraSPARC بهره می‌برد. در صورت هدف‌قرار دادن پردازنده‌ای که از چنین دستورالعملی پشتیبانی می‌کند (مانند Niagara\-7 و بعد از آن)، پیش‌فرض \fB\-msubxc\fR است.
.IP \fB\-mfix\-at697f\fR 4
.IX Item "-mfix-at697f"
راهکار ثبت‌شده برای تک‌ایراد سخت‌افزاری (erratum) پردازنده Atmel AT697F (که متناظر با ایراد شماره ۱۳ پردازنده AT697E است) را فعال می‌کند.
.IP \fB\-mfix\-ut699\fR 4
.IX Item "-mfix-ut699"
راهکارهای ثبت‌شده برای ایرادهای ممیز شناور (floating\-point) و ایرادهای ابطال حافظهٔ نهان داده (data cache nullify) در پردازنده UT699 را فعال می‌کند.
.IP \fB\-mfix\-ut700\fR 4
.IX Item "-mfix-ut700"
راهکار ثبت‌شده برای ایرادهای ذخیره‌سازی متوالی (back\-to\-back store) پردازنده UT699E/UT700 را فعال می‌کند.
.IP \fB\-mfix\-gr712rc\fR 4
.IX Item "-mfix-gr712rc"
راهکار ثبت‌شده برای ایرادهای ذخیره‌سازی متوالی (back\-to\-back store) پردازنده GR712RC را فعال می‌کند.
.PP
این گزینه‌های \fB\-m\fR، علاوه بر موارد بالا، بر روی پردازنده‌های SPARC\-V9 در محیط‌های ۶۴ بیتی پشتیبانی می‌شوند:
.IP \fB\-m32\fR 4
.IX Item "-m32"
.PD 0
.IP \fB\-m64\fR 4
.IX Item "-m64"
.PD
کد را برای یک محیط ۳۲ بیتی یا ۶۴ بیتی تولید می‌کند.
محیط ۳۲ بیتی، int، long و اشاره‌گر (pointer) را روی ۳۲ بیت تنظیم می‌کند.
محیط ۶۴ بیتی، int را روی ۳۲ بیت و long و اشاره‌گر را روی ۶۴ بیت تنظیم می‌کند.
.IP \fB\-mptr32\fR 4
.IX Item "-mptr32"
.PD 0
.IP \fB\-mptr64\fR 4
.IX Item "-mptr64"
.PD
به‌ترتیب از اشاره‌گرهای ۳۲ یا ۶۴ بیتی استفاده می‌کند. برخلاف گزینه‌های \fB\-m32\fR و \&\fB\-m64\fR، این گزینه تنها بر اندازهٔ اشاره‌گر تأثیر می‌گذارد و تأثیری بر ABI ندارد.
.IP \fB\-mcmodel=\fR\fIwhich\fR 4
.IX Item "-mcmodel=which"
مدل کد را روی یکی از موارد زیر تنظیم می‌کند:
.RS 4
.IP \fBmedlow\fR 4
.IX Item "medlow"
مدل کد Medium/Low: آدرس‌های ۶۴ بیتی، برنامه‌ها باید در ۳۲ بیت پایینی حافظه پیوند (link) داده شوند. برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند.
.IP \fBmedmid\fR 4
.IX Item "medmid"
مدل کد Medium/Middle: آدرس‌های ۶۴ بیتی، برنامه‌ها باید در ۴۴ بیت پایینی حافظه پیوند داده شوند، قطعه‌های text و data باید اندازه‌ای کمتر از 2GB داشته باشند و قطعه data باید در فاصلهٔ حداکثر 2GB از قطعه text قرار گیرد.
.IP \fBmedany\fR 4
.IX Item "medany"
مدل کد Medium/Anywhere: آدرس‌های ۶۴ بیتی، برنامه‌ها ممکن است در هر کجای حافظه پیوند داده شوند، قطعه‌های text و data باید اندازه‌ای کمتر از 2GB داشته باشند و قطعه data باید در فاصلهٔ حداکثر 2GB از قطعه text واقع شود.
.IP \fBembmedany\fR 4
.IX Item "embmedany"
مدل کد Medium/Anywhere برای سامانه‌های تعبیه‌شده (embedded):
آدرس‌های ۶۴ بیتی، قطعه‌های text و data باید اندازه‌ای کمتر از 2GB داشته باشند، و هر دو می‌توانند از هر کجای حافظه شروع شوند (تعیین‌شده در زمان پیوند). ثبات عمومی \f(CW%g4\fR به ابتدای قطعه data اشاره می‌کند. برنامه‌ها به‌صورت ایستا پیوند می‌خورند و PIC پشتیبانی نمی‌شود.
.RE
.RS 4
.RE
.IP \fB\-mmemory\-model=\fR\fImem\-model\fR 4
.IX Item "-mmemory-model=mem-model"
مدل حافظهٔ اجرایی روی پردازنده را به یکی از موارد زیر تنظیم می‌کند:
.RS 4
.IP \fBdefault\fR 4
.IX Item "default"
مدل حافظهٔ پیش‌فرض برای پردازنده و سیستم‌عامل.
.IP \fBrmo\fR 4
.IX Item "rmo"
Relaxed Memory Order
.IP \fBpso\fR 4
.IX Item "pso"
Partial Store Order
.IP \fBtso\fR 4
.IX Item "tso"
Total Store Order
.IP \fBsc\fR 4
.IX Item "sc"
Sequential Consistency
.RE
.RS 4
.Sp
این مدل‌های حافظه به‌طور رسمی در پیوست D راهنمای معماری SPARC\-V9، همان‌طور که در فیلد \f(CW\*(C`PSTATE.MM\*(C'\fR پردازنده مقداردهی می‌شوند، تعریف شده‌اند.
.RE
.IP \fB\-mstack\-bias\fR 4
.IX Item "-mstack-bias"
.PD 0
.IP \fB\-mno\-stack\-bias\fR 4
.IX Item "-mno-stack-bias"
.PD
با \fB\-mstack\-bias\fR، کامپایلر GCC فرض می‌کند که اشاره‌گر پشته (stack pointer)، و در صورت وجود اشاره‌گر فریم (frame pointer)، دارای آفست \-2047 هستند که هنگام ارجاع به فریم پشته باید مجدداً اضافه شود. این حالت، رفتار پیش‌فرض در حالت ۶۴ بیتی است. در غیر این صورت، فرض می‌شود چنین آفستی وجود ندارد.
.PP
\fIگزینه‌های System V\fR
.IX Subsection "Options for System V"
.PP
این گزینه‌های اضافی در System V Release 4 برای سازگاری با سایر کامپایلرها در آن سیستم‌ها در دسترس هستند:
.IP \fB\-G\fR 4
.IX Item "-G"
یک شیء اشتراکی (shared object) ایجاد می‌کند.
توصیه می‌شود به‌جای آن از \fB\-symbolic\fR یا \fB\-shared\fR استفاده شود.
.IP \fB\-YP,\fR\fIdirs\fR 4
.IX Item "-YP,dirs"
برای کتابخانه‌های مشخص‌شده با \fB\-l\fR فقط دایرکتوری‌های \fIdirs\fR (و نه هیچ جای دیگر) را جستجو می‌کند.
.IP \fB\-Ym,\fR\fIdir\fR 4
.IX Item "-Ym,dir"
برای یافتن پیش‌پردازندهٔ M4 در دایرکتوری \fIdir\fR جستجو می‌کند.
اسمبلر از این گزینه استفاده می‌کند.
.PP
\fIگزینه‌های V850\fR
.IX Subsection "V850 Options"
.PP
این گزینه‌های \fB\-m\fR برای پیاده‌سازی‌های V850 تعریف شده‌اند:
.IP \fB\-mlong\-calls\fR 4
.IX Item "-mlong-calls"
.PD 0
.IP \fB\-mno\-long\-calls\fR 4
.IX Item "-mno-long-calls"
.PD
با تمام فراخوانی‌ها به‌صورت دوردست (نزدیک) رفتار می‌کند. اگر فراخوانی‌ها دوردست در نظر گرفته شوند، کامپایلر همواره آدرس تابع را در یک ثبات بارگذاری می‌کند و به‌صورت غیرمستقیم از طریق اشاره‌گر فراخوانی را انجام می‌دهد.
.IP \fB\-mno\-ep\fR 4
.IX Item "-mno-ep"
.PD 0
.IP \fB\-mep\fR 4
.IX Item "-mep"
.PD
بلوک‌های پایه‌ای را که ۴ بار یا بیشتر از یک اشاره‌گر شاخص برای کپی کردن اشاره‌گر در ثبات \f(CW\*(C`ep\*(C'\fR استفاده می‌کنند، بهینه‌سازی نمی‌کند (بهینه‌سازی می‌کند) و از دستورالعمل‌های کوتاه‌تر \f(CW\*(C`sld\*(C'\fR و \f(CW\*(C`sst\*(C'\fR بهره می‌برد. در صورت بهینه‌سازی، گزینهٔ \fB\-mep\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-mno\-prolog\-function\fR 4
.IX Item "-mno-prolog-function"
.PD 0
.IP \fB\-mprolog\-function\fR 4
.IX Item "-mprolog-function"
.PD
از توابع خارجی برای ذخیره و بازیابی ثبات‌ها در آغاز و پایان (prologue و epilogue) تابع استفاده نمی‌کند (استفاده می‌کند). توابع خارجی کندتر هستند، اما اگر بیش از یک تابع تعداد یکسانی ثبات را ذخیره کنند، فضای کد کمتری مصرف می‌کنند. در صورت بهینه‌سازی، گزینهٔ \fB\-mprolog\-function\fR به‌طور پیش‌فرض فعال است.
.IP \fB\-mspace\fR 4
.IX Item "-mspace"
تلاش می‌کند اندازهٔ کد تا جای ممکن کوچک شود. در حال حاضر، این گزینه فقط گزینه‌های \fB\-mep\fR و \fB\-mprolog\-function\fR را فعال می‌کند..IP \fB\-mtda=\fR\fIn\fR 4
.IX Item "-mtda=n"
متغیرهای ایستا یا سراسری را که اندازه آن‌ها \fIn\fR بایت یا کمتر است، در
ناحیه داده بسیار کوچک (tiny data area) که ثبات \f(CW\*(C`ep\*(C'\fR به آن اشاره می‌کند قرار می‌دهد. ناحیه داده
بسیار کوچک می‌تواند در مجموع تا 256 بایت (128 بایت برای ارجاعات بایتی) را در خود جای دهد.
.IP \fB\-msda=\fR\fIn\fR 4
.IX Item "-msda=n"
متغیرهای ایستا یا سراسری را که اندازه آن‌ها \fIn\fR بایت یا کمتر است، در
ناحیه داده کوچک (small data area) که ثبات \f(CW\*(C`gp\*(C'\fR به آن اشاره می‌کند قرار می‌دهد. ناحیه داده کوچک
می‌تواند تا 64 کیلوبایت را در خود جای دهد.
.IP \fB\-mzda=\fR\fIn\fR 4
.IX Item "-mzda=n"
متغیرهای ایستا یا سراسری را که اندازه آن‌ها \fIn\fR بایت یا کمتر است، در
32 کیلوبایت نخست حافظه قرار می‌دهد.
.IP \fB\-mv850\fR 4
.IX Item "-mv850"
مشخص می‌کند که پردازنده مقصد V850 است.
.IP \fB\-mv850e3v5\fR 4
.IX Item "-mv850e3v5"
مشخص می‌کند که پردازنده مقصد V850E3V5 است. در صورت استفاده از این گزینه،
ثابت پیش‌پردازنده \f(CW\*(C`_\|_v850e3v5_\|_\*(C'\fR تعریف می‌شود.
.IP \fB\-mv850e2v4\fR 4
.IX Item "-mv850e2v4"
مشخص می‌کند که پردازنده مقصد V850E3V5 است. این گزینه یک نام مستعار برای
گزینه \fB\-mv850e3v5\fR است.
.IP \fB\-mv850e2v3\fR 4
.IX Item "-mv850e2v3"
مشخص می‌کند که پردازنده مقصد V850E2V3 است. در صورت استفاده از این گزینه،
ثابت پیش‌پردازنده \f(CW\*(C`_\|_v850e2v3_\|_\*(C'\fR تعریف می‌شود.
.IP \fB\-mv850e2\fR 4
.IX Item "-mv850e2"
مشخص می‌کند که پردازنده مقصد V850E2 است. در صورت استفاده از این گزینه،
ثابت پیش‌پردازنده \f(CW\*(C`_\|_v850e2_\|_\*(C'\fR تعریف می‌شود.
.IP \fB\-mv850e1\fR 4
.IX Item "-mv850e1"
مشخص می‌کند که پردازنده مقصد V850E1 است. در صورت استفاده از این گزینه،
ثابت‌های پیش‌پردازنده \f(CW\*(C`_\|_v850e1_\|_\*(C'\fR و \f(CW\*(C`_\|_v850e_\|_\*(C'\fR تعریف می‌شوند.
.IP \fB\-mv850es\fR 4
.IX Item "-mv850es"
مشخص می‌کند که پردازنده مقصد V850ES است. این گزینه یک نام مستعار برای
گزینه \fB\-mv850e1\fR است.
.IP \fB\-mv850e\fR 4
.IX Item "-mv850e"
مشخص می‌کند که پردازنده مقصد V850E است. در صورت استفاده از این گزینه،
ثابت پیش‌پردازنده \f(CW\*(C`_\|_v850e_\|_\*(C'\fR تعریف می‌شود.
.Sp
اگر هیچ‌یک از گزینه‌های \fB\-mv850\fR، \fB\-mv850e\fR، \fB\-mv850e1\fR،
\fB\-mv850e2\fR، \fB\-mv850e2v3\fR یا \fB\-mv850e3v5\fR تعریف نشده باشند،
یک پردازنده مقصد پیش‌فرض انتخاب شده و ثابت پیش‌پردازنده مربوطه
\fB_\|_v850*_\|_\fR تعریف می‌گردد.
.Sp
ثابت‌های پیش‌پردازنده \f(CW\*(C`_\|_v850\*(C'\fR و \f(CW\*(C`_\|_v851_\|_\*(C'\fR صرف‌نظر از این‌که
کدام گونه پردازنده مقصد باشد، همواره تعریف می‌شوند.
.IP \fB\-mdisable\-callt\fR 4
.IX Item "-mdisable-callt"
.PD 0
.IP \fB\-mno\-disable\-callt\fR 4
.IX Item "-mno-disable-callt"
.PD
این گزینه از تولید دستورالعمل \f(CW\*(C`CALLT\*(C'\fR برای انواع v850e،
v850e1، v850e2، v850e2v3 و v850e3v5 از معماری v850 جلوگیری می‌کند.
.Sp
این گزینه هنگام استفاده از RH850 ABI به‌طور پیش‌فرض فعال است
(به \fB\-mrh850\-abi\fR مراجعه کنید) و هنگام استفاده از GCC ABI به‌طور پیش‌فرض غیرفعال است.
اگر دستورالعمل‌های \f(CW\*(C`CALLT\*(C'\fR تولید شوند، نماد پیش‌پردازنده C
به نام \f(CW\*(C`_\|_V850_CALLT_\|_\*(C'\fR تعریف خواهد شد.
.IP \fB\-mrelax\fR 4
.IX Item "-mrelax"
.PD 0
.IP \fB\-mno\-relax\fR 4
.IX Item "-mno-relax"
.PD
گزینه خط فرمان \fB\-mrelax\fR را به اسمبلر منتقل می‌کند
(یا منتقل نمی‌کند).
.IP \fB\-mlong\-jumps\fR 4
.IX Item "-mlong-jumps"
.PD 0
.IP \fB\-mno\-long\-jumps\fR 4
.IX Item "-mno-long-jumps"
.PD
تولید دستورالعمل‌های پرش نسبی به PC را غیرفعال (یا دوباره فعال) می‌کند.
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
تولید دستورالعمل‌های ممیز شناور سخت‌افزاری را غیرفعال (یا دوباره فعال) می‌کند.
این گزینه تنها زمانی اهمیت دارد که معماری مقصد \fBV850E2V3\fR یا
بالاتر باشد. اگر دستورالعمل‌های ممیز شناور سخت‌افزاری در حال تولید باشند،
نماد پیش‌پردازنده C به نام \&\f(CW\*(C`_\|_FPU_OK_\|_\*(C'\fR تعریف می‌شود، در غیر این صورت
نماد \&\f(CW\*(C`_\|_NO_FPU_\|_\*(C'\fR تعریف خواهد شد.
.IP \fB\-mloop\fR 4
.IX Item "-mloop"
استفاده از دستورالعمل LOOP در e3v5 را فعال می‌کند. هنگام انتخاب
معماری e3v5، استفاده از این دستورالعمل به‌طور پیش‌فرض فعال نیست،
زیرا استفاده از آن هنوز جنبه آزمایشی دارد.
.IP \fB\-mrh850\-abi\fR 4
.IX Item "-mrh850-abi"
.PD 0
.IP \fB\-mghs\fR 4
.IX Item "-mghs"
.PD
پشتیبانی از نسخه RH850 از V850 ABI را فعال می‌کند. این حالت
پیش‌فرض است. با این نسخه از ABI، قوانین زیر اعمال می‌شوند:
.RS 4
.IP * 4
ساختارها و اجتماع‌ها با اندازه عدد صحیح به‌جای ثبات، از طریق یک اشاره‌گر حافظه
بازگردانده می‌شوند.
.IP * 4
ساختارها و اجتماع‌های بزرگ (بزرگ‌تر از 8 بایت) از طریق مقدار (by value)
ارسال می‌شوند.
.IP * 4
توابع روی مرزهای 16 بیتی تراز می‌شوند.
.IP * 4
گزینه خط فرمان \fB\-m8byte\-align\fR پشتیبانی می‌شود.
.IP * 4
گزینه خط فرمان \fB\-mdisable\-callt\fR به‌طور پیش‌فرض فعال است.
گزینه خط فرمان \fB\-mno\-disable\-callt\fR پشتیبانی نمی‌شود.
.RE
.RS 4
.Sp
هنگامی که این نسخه از ABI فعال باشد، نماد پیش‌پردازنده C به نام
\&\f(CW\*(C`_\|_V850_RH850_ABI_\|_\*(C'\fR تعریف می‌شود.
.RE
.IP \fB\-mgcc\-abi\fR 4
.IX Item "-mgcc-abi"
پشتیبانی از نسخه قدیمی GCC از V850 ABI را فعال می‌کند. با این
نسخه از ABI، قوانین زیر اعمال می‌شوند:
.RS 4
.IP * 4
ساختارها و اجتماع‌ها با اندازه عدد صحیح در ثبات \f(CW\*(C`r10\*(C'\fR بازگردانده می‌شوند.
.IP * 4
ساختارها و اجتماع‌های بزرگ (بزرگ‌تر از 8 بایت) با ارجاع (by reference)
ارسال می‌شوند.
.IP * 4
توابع روی مرزهای 32 بیتی تراز می‌شوند، مگر این‌که بهینه‌سازی
برای اندازه انجام گیرد.
.IP * 4
گزینه خط فرمان \fB\-m8byte\-align\fR پشتیبانی نمی‌شود.
.IP * 4
گزینه خط فرمان \fB\-mdisable\-callt\fR پشتیبانی می‌شود، اما به‌طور پیش‌فرض
فعال نیست.
.RE
.RS 4
.Sp
هنگامی که این نسخه از ABI فعال باشد، نماد پیش‌پردازنده C به نام
\&\f(CW\*(C`_\|_V850_GCC_ABI_\|_\*(C'\fR تعریف می‌شود.
.RE
.IP \fB\-m8byte\-align\fR 4
.IX Item "-m8byte-align"
.PD 0
.IP \fB\-mno\-8byte\-align\fR 4
.IX Item "-mno-8byte-align"
.PD
پشتیبانی از تراز شدن نوع‌های \f(CW\*(C`double\*(C'\fR و \f(CW\*(C`long long\*(C'\fR روی
مرزهای 8 بایتی را فعال می‌کند. حالت پیش‌فرض این است که تراز تمام
اشیاء حداکثر به 4 بایت محدود شود. هنگامی که \&\fB\-m8byte\-align\fR در
حال اثر باشد، نماد پیش‌پردازنده C به نام \&\f(CW\*(C`_\|_V850_8BYTE_ALIGN_\|_\*(C'\fR
تعریف می‌شود.
.IP \fB\-mbig\-switch\fR 4
.IX Item "-mbig-switch"
.PD 0
.IP \fB\-mno\-big\-switch\fR 4
.IX Item "-mno-big-switch"
.PD
کدی مناسب برای جدول‌های switch بزرگ تولید می‌کند. تنها زمانی از این گزینه
استفاده کنید که اسمبلر یا پیونددهنده در مورد انشعاب‌های خارج از محدوده درون
یک جدول switch خطا گزارش کند.
.IP \fB\-mapp\-regs\fR 4
.IX Item "-mapp-regs"
.PD 0
.IP \fB\-mno\-app\-regs\fR 4
.IX Item "-mno-app-regs"
.PD
گزینه \&\fB\-mapp\-regs\fR باعث می‌شود از r2 و r5 در کدهای تولیدشده توسط
کامپایلر استفاده شود. این تنظیم پیش‌فرض است. گزینه \fB\-mno\-app\-regs\fR
باعث می‌شود با r2 و r5 به عنوان ثبات‌های ثابت برخورد شود..IP \fB\-msmall\-sld\fR 4
.IX Item "-msmall-sld"
.PD 0
.IP \fB\-mno\-small\-sld\fR 4
.IX Item "-mno-small-sld"
.PD
فعال یا غیرفعال کردن استفاده از دستورالعمل‌های بارگذاری کوتاه (short load).
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
عدم اعمال هم‌ترازی دقیق داده‌ها.
.IP \fB\-mjump\-tables\-in\-data\-section\fR 4
.IX Item "-mjump-tables-in-data-section"
.PD 0
.IP \fB\-mno\-jump\-tables\-in\-data\-section\fR 4
.IX Item "-mno-jump-tables-in-data-section"
.PD
فعال یا غیرفعال کردن قرارگیری جدول‌های پرش برای عبارت‌های switch در بخش \f(CW\*(C`.data\*(C'\fR به جای بخش \f(CW\*(C`.code\*(C'\fR. مقدار پیش‌فرض \fB\-mno\-jump\-tables\-in\-data\-section\fR است.
.PP
\fIگزینه‌های VAX\fR
.IX Subsection "VAX Options"
.PP
این گزینه‌های \fB\-m\fR برای VAX تعریف شده‌اند:
.IP \fB\-munix\fR 4
.IX Item "-munix"
از تولید دستورالعمل‌های پرش خاصی (\f(CW\*(C`aobleq\*(C'\fR و غیره) که اسمبلر Unix برای VAX نمی‌تواند آن‌ها را در بازه‌های طولانی مدیریت کند، خودداری کن.
.IP \fB\-mgnu\fR 4
.IX Item "-mgnu"
با این فرض که از اسمبلر GNU استفاده می‌شود، آن دستورالعمل‌های پرش را تولید کن.
.IP \fB\-md\fR 4
.IX Item "-md"
.PD 0
.IP \fB\-md\-float\fR 4
.IX Item "-md-float"
.PD
استفاده از قالب دادهٔ D_floating به جای G_floating برای اعداد ممیز شناور با دقت مضاعف (double\-precision).
.IP \fB\-mg\fR 4
.IX Item "-mg"
.PD 0
.IP \fB\-mg\-float\fR 4
.IX Item "-mg-float"
.PD
استفاده از قالب دادهٔ G_floating به جای D_floating برای اعداد ممیز شناور با دقت مضاعف (double\-precision).
.IP \fB\-mlra\fR 4
.IX Item "-mlra"
.PD 0
.IP \fB\-mno\-lra\fR 4
.IX Item "-mno-lra"
.PD
فعال‌سازی تخصیص ثبات محلی (LRA). این ویژگی برای VAX هنوز آزمایشی است، بنابراین کامپایلر به طور پیش‌فرض از بارگذاری مجدد (reload) استاندارد استفاده می‌کند.
.IP \fB\-mvaxc\-alignment\fR 4
.IX Item "-mvaxc-alignment"
استفاده از قراردادهای VAXC برای هم‌ترازی اعضای ساختار (structure).
.IP \fB\-mqmath\fR 4
.IX Item "-mqmath"
.PD 0
.IP \fB\-mno\-qmath\fR 4
.IX Item "-mno-qmath"
.PD
فعال یا غیرفعال کردن الگوهای دستورالعمل جدید برای جمع و تفریق اعداد صحیح ۶۴ بیتی.
.PP
\fIگزینه‌های Visium\fR
.IX Subsection "Visium Options"
.IP \fB\-mdebug\fR 4
.IX Item "-mdebug"
هنگام پیوند زدن برنامه‌هایی که ورودی/خروجی فایل انجام می‌دهند و قرار است روی هدف MCM اجرا شوند، از این گزینه استفاده کنید. این گزینه باعث می‌شود کتابخانه‌های \&\fIlibc.a\fR و \fIlibdebug.a\fR پیوند داده شوند. شما باید برنامه را روی مقصد تحت کنترل واسط اشکال‌زدایی از راه دور (stub) نرم‌افزار GDB اجرا کنید.
.IP \fB\-msim\fR 4
.IX Item "-msim"
هنگام پیوند زدن برنامه‌هایی که ورودی/خروجی فایل انجام می‌دهند و قرار است روی شبیه‌ساز اجرا شوند، از این گزینه استفاده کنید. این گزینه موجب پیوند خوردن کتابخانه‌های \&\fIlibc.a\fR و \fIlibsim.a\fR می‌شود.
.IP \fB\-mfpu\fR 4
.IX Item "-mfpu"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
تولید کدی شامل دستورالعمل‌های ممیز شناور. این حالت پیش‌فرض است.
.IP \fB\-mno\-fpu\fR 4
.IX Item "-mno-fpu"
.PD 0
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD
تولید کدی حاوی فراخوانی‌های کتابخانه‌ای برای ممیز شناور.
.Sp
گزینهٔ \&\fB\-msoft\-float\fR قرارداد فراخوانی (calling convention) را در فایل خروجی تغییر می‌دهد؛ بنابراین تنها زمانی مفید است که \fIتمام\fR برنامه را با این گزینه کامپایل کنید. به‌ویژه، برای اینکه این مورد کار کند، باید \fIlibgcc.a\fR (کتابخانه‌ای که همراه GCC ارائه می‌شود) را با \fB\-msoft\-float\fR کامپایل کنید.
.IP \fB\-mcpu=\fR\fIcpu_type\fR 4
.IX Item "-mcpu=cpu_type"
تنظیم مجموعه دستورالعمل، مجموعه ثبات‌ها و پارامترهای زمان‌بندی دستورالعمل برای نوع ماشین \fIcpu_type\fR. مقادیر پشتیبانی‌شده برای \fIcpu_type\fR شامل \&\fBmcm\fR، \fBgr5\fR و \fBgr6\fR هستند.
.Sp
مقدار \&\fBmcm\fR مترادفی برای \fBgr5\fR است که جهت سازگاری با نسخه‌های قبلی قرار داده شده است.
.Sp
به‌طور پیش‌فرض (مگر اینکه به گونه‌ای دیگر پیکربندی شده باشد)، GCC کدی برای گونهٔ GR5 از معماری Visium تولید می‌کند.
.Sp
با گزینهٔ \fB\-mcpu=gr6\fR، کامپایلر GCC برای گونهٔ GR6 از معماری Visium کد تولید می‌کند. تنها تفاوت با کد GR5 این است که کامپایلر دستورالعمل‌های انتقال بلوکی (block move) را تولید خواهد کرد.
.IP \fB\-mtune=\fR\fIcpu_type\fR 4
.IX Item "-mtune=cpu_type"
پارامترهای زمان‌بندی دستورالعمل را برای نوع ماشین \fIcpu_type\fR تنظیم می‌کند، اما بر خلاف گزینهٔ \&\fB\-mcpu=\fR\fIcpu_type\fR، مجموعه دستورالعمل‌ها یا مجموعه ثبات‌ها را تغییر نمی‌دهد.
.IP \fB\-msv\-mode\fR 4
.IX Item "-msv-mode"
تولید کد برای حالت ناظر (supervisor mode)، که در آن هیچ محدودیتی در دسترسی به ثبات‌های عمومی وجود ندارد. این حالت پیش‌فرض است.
.IP \fB\-muser\-mode\fR 4
.IX Item "-muser-mode"
تولید کد برای حالت کاربر (user mode)، که در آن دسترسی به برخی از ثبات‌های عمومی ممنوع است: روی GR5، دسترسی به ثبات‌های r24 تا r31 در این حالت امکان‌پذیر نیست؛ روی GR6، تنها ثبات‌های r29 تا r31 تحت تأثیر قرار می‌گیرند.
.PP
\fIگزینه‌های VMS\fR
.IX Subsection "VMS Options"
.PP
این گزینه‌های \fB\-m\fR برای پیاده‌سازی‌های VMS تعریف شده‌اند:
.IP \fB\-mvms\-return\-codes\fR 4
.IX Item "-mvms-return-codes"
بازگرداندن کدهای وضعیت VMS از تابع \f(CW\*(C`main\*(C'\fR. پیش‌فرض بازگرداندن کدهای وضعیت به سبک POSIX (مانند کدهای خطا) است.
.IP \fB\-mdebug\-main=\fR\fIprefix\fR 4
.IX Item "-mdebug-main=prefix"
نشانه‌گذاری اولین روالی که نام آن با \fIprefix\fR شروع می‌شود به عنوان روال اصلی برای اشکال‌زدا.
.IP \fB\-mmalloc64\fR 4
.IX Item "-mmalloc64"
استفادهٔ پیش‌فرض از روال‌های تخصیص حافظهٔ ۶۴ بیتی.
.IP \fB\-mpointer\-size=\fR\fIsize\fR 4
.IX Item "-mpointer-size=size"
تنظیم اندازهٔ پیش‌فرض اشاره‌گرها. گزینه‌های ممکن برای \fIsize\fR عبارت‌اند از: \&\fB32\fR یا \fBshort\fR برای اشاره‌گرهای ۳۲ بیتی، \fB64\fR یا \fBlong\fR برای اشاره‌گرهای ۶۴ بیتی، و \fBno\fR برای پشتیبانیِ صرف از اشاره‌گرهای ۳۲ بیتی. گزینهٔ آخر \f(CW\*(C`pragma pointer_size\*(C'\fR را غیرفعال می‌کند.
.PP
\fIگزینه‌های VxWorks\fR
.IX Subsection "VxWorks Options"
.PP
گزینه‌های این بخش برای تمامی اهداف VxWorks تعریف شده‌اند. گزینه‌های مختص سخت‌افزار هدف در کنار سایر گزینه‌ها برای آن هدف فهرست شده‌اند.
.IP \fB\-mrtp\fR 4
.IX Item "-mrtp"
کامپایلر GCC می‌تواند هم برای هسته‌های VxWorks و هم برای فرایندهای بلادرنگ (RTPs) کد تولید کند. این گزینه حالت تولید کد را از حالت اول به حالت دوم تغییر می‌دهد. همچنین ماکروی پیش‌پردازندهٔ \f(CW\*(C`_\|_RTP_\|_\*(C'\fR را تعریف می‌کند.
.IP \fB\-msmp\fR 4
.IX Item "-msmp"
انتخاب زمان‌های اجرای SMP برای پیوند زدن. در معماری‌هایی غیر از PowerPC و همچنین در VxWorks نسخه ۷ یا بالاتر در دسترس نیست، چرا که در آن نسخه‌ها انتخاب بخشی از پیکربندی ساخت VxWorks است و مسیرهای کتابخانه برای هر دو حالت یکسان هستند.
.IP \fB\-mvthreads\fR 4
.IX Item "-mvthreads"
پیوند زدن با محیط زمان اجرای VxWorks AE vThread.
.IP \fB\-non\-static\fR 4
.IX Item "-non-static"
پیوند زدن فایل اجرایی RTP با کتابخانه‌های مشترک (shared) به جای کتابخانه‌های ایستا (static). گزینه‌های \fB\-static\fR و \fB\-shared\fR نیز می‌توانند برای RTPها استفاده شوند؛ \fB\-static\fR حالت پیش‌فرض است..IP \fB\-Bstatic\fR 4
.IX Item "-Bstatic"
.PD 0
.IP \fB\-Bdynamic\fR 4
.IX Item "-Bdynamic"
.PD
این گزینه‌ها به پیونددهنده ارسال می‌شوند. آنها برای سازگاری با Diab تعریف شده‌اند.
.IP \fB\-Xbind\-lazy\fR 4
.IX Item "-Xbind-lazy"
پیوندزدن تنبل (lazy binding) فراخوانی‌های توابع را فعال می‌کند. این گزینه معادل
\&\fB\-Wl,\-z,now\fR بوده و برای سازگاری با Diab تعریف شده است.
.IP \fB\-Xbind\-now\fR 4
.IX Item "-Xbind-now"
پیوندزدن تنبل فراخوانی‌های توابع را غیرفعال می‌کند. این گزینه پیش‌فرض است و
برای سازگاری با Diab تعریف شده است.
.PP
\fIگزینه‌های x86\fR
.IX Subsection "x86 Options"
.PP
این بخش گزینه‌های \fB\-m\fR موجود برای خانواده رایانه‌های x86 را مستند می‌کند.
.PP
گروه گزینه‌های زیر امکان کامپایل با هدف قرار دادن یک پردازنده خاص را فراهم می‌سازند.
.IP \fB\-march=\fR\fIcpu\-type\fR 4
.IX Item "-march=cpu-type"
تولید دستورالعمل‌ها برای نوع ماشین \fIcpu\-type\fR. بر خلاف
\&\fB\-mtune=\fR\fIcpu\-type\fR که صرفاً کد تولیدشده را برای \fIcpu\-type\fR مشخص‌شده
تنظیم می‌کند، \fB\-march=\fR\fIcpu\-type\fR به GCC اجازه می‌دهد کدی تولید کند که ممکن است
اصلاً روی پردازنده‌هایی غیر از پردازنده مشخص‌شده اجرا نشود. مشخص کردن \fB\-march=\fR\fIcpu\-type\fR
متضمن \&\fB\-mtune=\fR\fIcpu\-type\fR نیز هست، مگر در مواردی که خلاف آن ذکر شده باشد.
.Sp
انتخاب‌ها برای \fIcpu\-type\fR عبارت‌اند از:
.RS 4
.IP \fBnative\fR 4
.IX Item "native"
این گزینه با تشخیص نوع پردازنده ماشینی که کامپایل روی آن انجام می‌شود، پردازنده هدف
برای تولید کد در زمان کامپایل را انتخاب می‌کند. استفاده از \fB\-march=native\fR
تمام زیرمجموعه‌های دستورالعمل پشتیبانی‌شده توسط ماشین محلی را فعال می‌کند (بنابراین ممکن است
نتیجه روی ماشین‌های دیگر اجرا نشود). استفاده از \fB\-mtune=native\fR کدی بهینه‌شده
برای ماشین محلی تحت محدودیت‌های مجموعه دستورالعمل انتخاب‌شده تولید می‌کند.
.IP \fBx86\-64\fR 4
.IX Item "x86-64"
یک پردازنده عمومی با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2 و FXSR.
.IP \fBx86\-64\-v2\fR 4
.IX Item "x86-64-v2"
.PD 0
.IP \fBx86\-64\-v3\fR 4
.IX Item "x86-64-v3"
.IP \fBx86\-64\-v4\fR 4
.IX Item "x86-64-v4"
.PD
این انتخاب‌ها برای \fIcpu\-type\fR، سطح ریزمعماری متناظر را از psABI مربوط به x86\-64
انتخاب می‌کنند. در ABIهایی غیر از psABI برای x86\-64، آنها همان ویژگی‌های CPU را انتخاب می‌کنند
که اسناد psABI برای x86\-64 برای آن سطح ریزمعماری خاص مشخص کرده است.
.Sp
از آنجا که این مقادیر \fIcpu\-type\fR تنظیم \&\fB\-mtune\fR متناظری ندارند،
استفاده از \fB\-march\fR با این مقادیر، تنظیم عمومی را فعال می‌کند. تنظیم اختصاصی را می‌توان
با استفاده از گزینه \&\fB\-mtune=\fR\fIother\-cpu\-type\fR و با مقدار مناسب
\&\fIother\-cpu\-type\fR فعال کرد.
.IP \fBi386\fR 4
.IX Item "i386"
پردازنده اصلی Intel i386.
.IP \fBi486\fR 4
.IX Item "i486"
پردازنده Intel i486. (هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBi586\fR 4
.IX Item "i586"
.PD 0
.IP \fBpentium\fR 4
.IX Item "pentium"
.PD
پردازنده Intel Pentium بدون پشتیبانی از MMX.
.IP \fBlakemont\fR 4
.IX Item "lakemont"
میکروکنترلر Intel Lakemont، بر پایه پردازنده Intel Pentium.
.IP \fBpentium\-mmx\fR 4
.IX Item "pentium-mmx"
پردازنده Intel Pentium MMX، بر پایه هسته Pentium با پشتیبانی از مجموعه دستورالعمل MMX.
.IP \fBpentiumpro\fR 4
.IX Item "pentiumpro"
پردازنده Intel Pentium Pro بدون پشتیبانی از MMX.
.IP \fBi686\fR 4
.IX Item "i686"
هنگامی که با \fB\-march\fR استفاده شود، مجموعه دستورالعمل Pentium Pro
استفاده می‌شود، بنابراین کد روی تمام تراشه‌های خانواده i686 اجرا می‌شود.
هنگامی که با \fB\-mtune\fR استفاده شود، معنای یکسانی با \fBgeneric\fR دارد.
.IP \fBpentium2\fR 4
.IX Item "pentium2"
پردازنده Intel Pentium II، بر پایه هسته Pentium Pro با پشتیبانی از مجموعه‌های دستورالعمل MMX و FXSR.
.IP \fBpentium3\fR 4
.IX Item "pentium3"
.PD 0
.IP \fBpentium3m\fR 4
.IX Item "pentium3m"
.PD
پردازنده Intel Pentium III، بر پایه هسته Pentium Pro با پشتیبانی از مجموعه‌های دستورالعمل MMX، FXSR و SSE.
.IP \fBpentium\-m\fR 4
.IX Item "pentium-m"
پردازنده Intel Pentium M؛ نسخه کم‌مصرف پردازنده Intel Pentium III
با پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2 و FXSR. استفاده‌شده در لپ‌تاپ‌های
Centrino.
.IP \fBpentium4\fR 4
.IX Item "pentium4"
.PD 0
.IP \fBpentium4m\fR 4
.IX Item "pentium4m"
.PD
پردازنده Intel Pentium 4 با پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2 و FXSR.
.IP \fBprescott\fR 4
.IX Item "prescott"
نسخه بهبودیافته پردازنده Intel Pentium 4 با پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3 و FXSR.
.IP \fBnocona\fR 4
.IX Item "nocona"
نسخه بهبودیافته پردازنده Intel Pentium 4 با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE،
SSE2، SSE3، CX16 و FXSR.
.IP \fBcore2\fR 4
.IX Item "core2"
پردازنده Intel Core 2 با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3، CX16،
SAHF و FXSR.
.IP \fBnehalem\fR 4
.IX Item "nehalem"
.PD 0
.IP \fBcorei7\fR 4
.IX Item "corei7"
.PD
پردازنده Intel Nehalem با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF و FXSR.
.IP \fBwestmere\fR 4
.IX Item "westmere"
پردازنده Intel Westmere با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR و PCLMUL.
.IP \fBsandybridge\fR 4
.IX Item "sandybridge"
.PD 0
.IP \fBcorei7\-avx\fR 4
.IX Item "corei7-avx"
.PD
پردازنده Intel Sandy Bridge با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE و PCLMUL.
.IP \fBivybridge\fR 4
.IX Item "ivybridge"
.PD 0
.IP \fBcore\-avx\-i\fR 4
.IX Item "core-avx-i"
.PD
پردازنده Intel Ivy Bridge با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND
و F16C.
.IP \fBhaswell\fR 4
.IX Item "haswell"
.PD 0
.IP \fBcore\-avx2\fR 4
.IX Item "core-avx2"
.PD
پردازنده Intel Haswell با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE و HLE.
.IP \fBbroadwell\fR 4
.IX Item "broadwell"
پردازنده Intel Broadwell با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX و PREFETCHW.
.IP \fBskylake\fR 4
.IX Item "skylake"
پردازنده Intel Skylake با افزونه‌های 64\-bit و پشتیبانی از مجموعه‌های دستورالعمل MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW، AES،
CLFLUSHOPT، XSAVEC، XSAVES و SGX..IP \fBskylake\-avx512\fR 4
.IX Item "skylake-avx512"
پردازنده سرور Intel Skylake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2،
SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، CLWB، AVX512VL، AVX512BW،
AVX512DQ و AVX512CD.
.IP \fBcascadelake\fR 4
.IX Item "cascadelake"
پردازنده Intel Cascade Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW، AES،
CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، CLWB، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD و AVX512VNNI.
.IP \fBcannonlake\fR 4
.IX Item "cannonlake"
پردازنده سرور Intel Cannon Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2،
SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL،
FSGSBASE، RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX،
PREFETCHW، AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW،
AVX512DQ، AVX512CD، PKU، AVX512VBMI، AVX512IFMA و SHA.
.IP \fBcooperlake\fR 4
.IX Item "cooperlake"
پردازنده Intel Cooper Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW، AES،
CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، CLWB، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، AVX512VNNI و AVX512BF16.
.IP \fBicelake\-client\fR 4
.IX Item "icelake-client"
پردازنده کلاینت Intel Ice Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID و AVX512VPOPCNTDQ.
.IP \fBicelake\-server\fR 4
.IX Item "icelake-server"
پردازنده سرور Intel Ice Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، PCONFIG، WBNOINVD و CLWB.
.IP \fBtigerlake\fR 4
.IX Item "tigerlake"
پردازنده Intel Tiger Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW، AES،
CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ، AVX512CD،
PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، MOVDIRI، MOVDIR64B، CLWB،
AVX512VP2INTERSECT و KEYLOCKER.
.IP \fBrocketlake\fR 4
.IX Item "rocketlake"
پردازنده Intel Rocket Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3، SSSE3،
SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE، RDRND،
F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW، AES،
CLFLUSHOPT، XSAVEC، XSAVES، AVX512F، AVX512VL، AVX512BW، AVX512DQ، AVX512CD،
PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID و AVX512VPOPCNTDQ.
.IP \fBalderlake\fR 4
.IX Item "alderlake"
.PD 0
.IP \fBraptorlake\fR 4
.IX Item "raptorlake"
.IP \fBmeteorlake\fR 4
.IX Item "meteorlake"
.IP \fBgracemont\fR 4
.IX Item "gracemont"
.PD
پردازنده Intel Alder Lake/Raptor Lake/Meteor Lake/Gracemont با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های
MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16،
AES، PREFETCHW،
PCLMUL، RDRND، XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX،
GFNI\-SSE، CLWB، MOVDIRI، MOVDIR64B، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C،
FMA، LZCNT، PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، KL، WIDEKL و
AVX\-VNNI.
.IP \fBarrowlake\fR 4
.IX Item "arrowlake"
پردازنده Intel Arrow Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16،
AES، PREFETCHW، PCLMUL، RDRND، XSAVE، XSAVEC،
XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB، MOVDIRI،
MOVDIR64B، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT، PCONFIG، PKU،
VAES، VPCLMULQDQ، SERIALIZE، HRESET، KL، WIDEKL، AVX\-VNNI، UINTR، AVXIFMA،
AVXVNNIINT8، AVXNECONVERT و CMPCCXADD.
.IP \fBarrowlake\-s\fR 4
.IX Item "arrowlake-s"
.PD 0
.IP \fBlunarlake\fR 4
.IX Item "lunarlake"
.PD
پردازنده Intel Arrow Lake S/Lunar Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MOVBE، MMX، SSE،
SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، AES، PREFETCHW، PCLMUL، RDRND،
XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB،
MOVDIRI، MOVDIR64B، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT،
PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، KL، WIDEKL، AVX\-VNNI، UINTR،
AVXIFMA، AVXVNNIINT8، AVXNECONVERT، CMPCCXADD، AVXVNNIINT16، SHA512، SM3 و
SM4.
.IP \fBpantherlake\fR 4
.IX Item "pantherlake"
.PD 0
.IP \fBwildcatlake\fR 4
.IX Item "wildcatlake"
.PD
پردازنده Intel Panther Lake/Wildcat Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MOVBE، MMX، SSE،
SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، AES، PREFETCHW، PCLMUL، RDRND،
XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE،
CLWB، MOVDIRI، MOVDIR64B، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA،
LZCNT، PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، AVX\-VNNI، UINTR،
AVXIFMA، AVXVNNIINT8، AVXNECONVERT، CMPCCXADD، AVXVNNIINT16، SHA512، SM3 و
SM4.
.IP \fBnovalake\fR 4
.IX Item "novalake"
پردازنده Intel Nova Lake با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16،
AES، PREFETCHW، PCLMUL، RDRND، XSAVE، XSAVEC،
XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB، MOVDIRI،
MOVDIR64B، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT، PCONFIG، PKU،
VAES، VPCLMULQDQ، SERIALIZE، HRESET، AVX\-VNNI، UINTR، AVXIFMA، AVXVNNIINT8،
AVXNECONVERT، CMPCCXADD، AVXVNNIINT16، SHA512، SM3، SM4، PREFETCHI، APX_F،
AVX10.1، AVX10.2 و MOVRS.
.IP \fBsapphirerapids\fR 4
.IX Item "sapphirerapids"
.PD 0
.IP \fBemeraldrapids\fR 4
.IX Item "emeraldrapids"
.PD
پردازنده Intel Sapphire Rapids/Emerald Rapids با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE،
SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL،
FSGSBASE، RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX،
PREFETCHW، AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW،
AVX512DQ، AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES،
AVX512VBMI2، VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، PCONFIG،
WBNOINVD، CLWB، MOVDIRI، MOVDIR64B، ENQCMD، CLDEMOTE، PTWRITE، WAITPKG،
SERIALIZE، TSXLDTRK، UINTR، AMX\-BF16، AMX\-TILE، AMX\-INT8، AVX\-VNNI، AVX512\-FP16
و AVX512BF16.
.IP \fBgraniterapids\fR 4
.IX Item "graniterapids"
پردازنده Intel Granite Rapids با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، PCONFIG، WBNOINVD، CLWB،
MOVDIRI، MOVDIR64B، ENQCMD، CLDEMOTE، PTWRITE، WAITPKG، SERIALIZE، TSXLDTRK،
UINTR، AMX\-BF16، AMX\-TILE، AMX\-INT8، AVX\-VNNI، AVX512\-FP16، AVX512BF16، AMX\-FP16
و PREFETCHI.
.IP \fBgraniterapids\-d\fR 4
.IX Item "graniterapids-d"
پردازنده Intel Granite Rapids D با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، PCONFIG، WBNOINVD، CLWB،
MOVDIRI، MOVDIR64B، ENQCMD، CLDEMOTE، PTWRITE، WAITPKG، SERIALIZE، TSXLDTRK،
UINTR، AMX\-BF16، AMX\-TILE، AMX\-INT8، AVX\-VNNI، AVX512FP16، AVX512BF16، AMX\-FP16،
PREFETCHI و AMX\-COMPLEX.
.IP \fBdiamondrapids\fR 4
.IX Item "diamondrapids"
پردازنده Intel Diamond Rapids با افزونه‌های 64\-bit و پشتیبانی از مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3،
SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، AVX، XSAVE، PCLMUL، FSGSBASE،
RDRND، F16C، AVX2، BMI، BMI2، LZCNT، FMA، MOVBE، HLE، RDSEED، ADCX، PREFETCHW،
AES، CLFLUSHOPT، XSAVEC، XSAVES، SGX، AVX512F، AVX512VL، AVX512BW، AVX512DQ،
AVX512CD، PKU، AVX512VBMI، AVX512IFMA، SHA، AVX512VNNI، GFNI، VAES، AVX512VBMI2،
VPCLMULQDQ، AVX512BITALG، RDPID، AVX512VPOPCNTDQ، PCONFIG، WBNOINVD، CLWB،
MOVDIRI، MOVDIR64B، ENQCMD، CLDEMOTE، PTWRITE، WAITPKG، SERIALIZE، TSXLDTRK،
UINTR، AMX\-BF16، AMX\-TILE، AMX\-INT8، AVX\-VNNI، AVX512FP16، AVX512BF16، AMX\-FP16،
PREFETCHI، AMX\-COMPLEX، AVX10.1\-512، AVX\-IFMA، AVX\-NE\-CONVERT، AVX\-VNNI\-INT16،
AVX\-VNNI\-INT8، CMPccXADD، SHA512، SM3، SM4، AVX10.2\-512، APX_F، AMX\-AVX512،
AMX\-FP8، MOVRS و AMX\-MOVRS.
.IP \fBbonnell\fR 4
.IX Item "bonnell"
.PD 0
.IP \fBatom\fR 4
.IX Item "atom".PD
پردازندهٔ Intel Bonnell با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3 و CX16.
.IP \fBsilvermont\fR 4
.IX Item "silvermont"
.PD 0
.IP \fBslm\fR 4
.IX Item "slm"
.PD
پردازندهٔ Intel Silvermont با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، PCLMUL، PREFETCHW و RDRND.
.IP \fBgoldmont\fR 4
.IX Item "goldmont"
پردازندهٔ Intel Goldmont با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، PCLMUL، PREFETCHW، RDRND، AES، SHA، RDSEED، XSAVE، XSAVEC، XSAVES، XSAVEOPT، CLFLUSHOPT و FSGSBASE.
.IP \fBgoldmont\-plus\fR 4
.IX Item "goldmont-plus"
پردازندهٔ Intel Goldmont Plus با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، PCLMUL، PREFETCHW، RDRND، AES، SHA، RDSEED، XSAVE، XSAVEC، XSAVES، XSAVEOPT، CLFLUSHOPT، FSGSBASE، PTWRITE، RDPID و SGX.
.IP \fBtremont\fR 4
.IX Item "tremont"
پردازندهٔ Intel Tremont با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، SAHF، FXSR، PCLMUL، PREFETCHW، RDRND، AES، SHA، RDSEED، XSAVE، XSAVEC، XSAVES، XSAVEOPT، CLFLUSHOPT، FSGSBASE، PTWRITE، RDPID، SGX، CLWB، GFNI\-SSE، MOVDIRI، MOVDIR64B، CLDEMOTE و WAITPKG.
.IP \fBsierraforest\fR 4
.IX Item "sierraforest"
پردازندهٔ Intel Sierra Forest با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، AES، PREFETCHW، PCLMUL، RDRND، XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB، MOVDIRI، MOVDIR64B، CLDEMOTE، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT، PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، KL، WIDEKL، AVX\-VNNI، AVXIFMA، AVXVNNIINT8، AVXNECONVERT، CMPCCXADD، ENQCMD و UINTR.
.IP \fBgrandridge\fR 4
.IX Item "grandridge"
پردازندهٔ Intel Grand Ridge با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، AES، PREFETCHW، PCLMUL، RDRND، XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB، MOVDIRI، MOVDIR64B، CLDEMOTE، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT، PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، KL، WIDEKL، AVX\-VNNI، AVXIFMA، AVXVNNIINT8، AVXNECONVERT، CMPCCXADD، ENQCMD و UINTR.
.IP \fBclearwaterforest\fR 4
.IX Item "clearwaterforest"
پردازندهٔ Intel Clearwater Forest با پشتیبانی از افزونه‌های 64\-bit و مجموعه دستورالعمل‌های MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، POPCNT، CX16، AES، PREFETCHW، PCLMUL، RDRND، XSAVE، XSAVEC، XSAVES، XSAVEOPT، FSGSBASE، PTWRITE، RDPID، SGX، GFNI\-SSE، CLWB، MOVDIRI، MOVDIR64B، CLDEMOTE، WAITPKG، ADCX، AVX، AVX2، BMI، BMI2، F16C، FMA، LZCNT، PCONFIG، PKU، VAES، VPCLMULQDQ، SERIALIZE، HRESET، AVX\-VNNI، ENQCMD، UINTR، AVXIFMA، AVXVNNIINT8، AVXNECONVERT، CMPCCXADD، AVXVNNIINT16، SHA512، SM3، SM4، USER_MSR و PREFETCHI.
.IP \fBk6\fR 4
.IX Item "k6"
پردازندهٔ AMD K6 با پشتیبانی از مجموعه دستورالعمل‌های MMX.
.IP \fBk6\-2\fR 4
.IX Item "k6-2"
.PD 0
.IP \fBk6\-3\fR 4
.IX Item "k6-3"
.PD
نسخه‌های بهبودیافتهٔ پردازندهٔ AMD K6 با پشتیبانی از مجموعه دستورالعمل‌های MMX و !3DNow.
.IP \fBathlon\fR 4
.IX Item "athlon"
.PD 0
.IP \fBathlon\-tbird\fR 4
.IX Item "athlon-tbird"
.PD
پردازندهٔ AMD Athlon با پشتیبانی از MMX، !3dNOW، !3DNow بهبودیافته و دستورالعمل‌های پیش‌واکشی (prefetch) در SSE.
.IP \fBathlon\-4\fR 4
.IX Item "athlon-4"
.PD 0
.IP \fBathlon\-xp\fR 4
.IX Item "athlon-xp"
.IP \fBathlon\-mp\fR 4
.IX Item "athlon-mp"
.PD
پردازندهٔ بهبودیافتهٔ AMD Athlon با پشتیبانی از مجموعه دستورالعمل‌های MMX، !3DNow، !3DNow بهبودیافته و پشتیبانی کامل از مجموعه دستورالعمل‌های SSE.
.IP \fBk8\fR 4
.IX Item "k8"
.PD 0
.IP \fBopteron\fR 4
.IX Item "opteron"
.IP \fBathlon64\fR 4
.IX Item "athlon64"
.IP \fBathlon\-fx\fR 4
.IX Item "athlon-fx"
.PD
پردازنده‌های مبتنی بر هستهٔ AMD K8 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، شامل پردازنده‌های AMD Opteron، Athlon 64 و Athlon 64 FX.
(این مورد شامل ابرمجموعه‌ای از MMX، SSE، SSE2، !3DNow، !3DNow بهبودیافته و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBk8\-sse3\fR 4
.IX Item "k8-sse3"
.PD 0
.IP \fBopteron\-sse3\fR 4
.IX Item "opteron-sse3"
.IP \fBathlon64\-sse3\fR 4
.IX Item "athlon64-sse3"
.PD
نسخه‌های بهبودیافتهٔ هسته‌های AMD K8 با پشتیبانی از مجموعه دستورالعمل‌های SSE3.
.IP \fBamdfam10\fR 4
.IX Item "amdfam10"
.PD 0
.IP \fBbarcelona\fR 4
.IX Item "barcelona"
.PD
پردازنده‌های مبتنی بر هسته‌های AMD Family 10h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از CX16، MMX، SSE، SSE2، SSE3، SSE4A، !3DNow، !3DNow بهبودیافته، ABM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBbdver1\fR 4
.IX Item "bdver1"
پردازنده‌های مبتنی بر هسته‌های AMD Family 15h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از FMA4، AVX، XOP، LWP، AES، PCLMUL، CX16، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBbdver2\fR 4
.IX Item "bdver2"
پردازنده‌های مبتنی بر هستهٔ AMD Family 15h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، TBM، F16C، FMA، FMA4، AVX، XOP، LWP، AES، PCLMUL، CX16، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBbdver3\fR 4
.IX Item "bdver3"
پردازنده‌های مبتنی بر هستهٔ AMD Family 15h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، TBM، F16C، FMA، FMA4، FSGSBASE، AVX، XOP، LWP، AES، PCLMUL، CX16، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBbdver4\fR 4
.IX Item "bdver4"
پردازنده‌های مبتنی بر هستهٔ AMD Family 15h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، TBM، F16C، FMA، FMA4، FSGSBASE، AVX، AVX2، XOP، LWP، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBznver1\fR 4
.IX Item "znver1"
پردازنده‌های مبتنی بر هستهٔ AMD Family 17h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED، MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBznver2\fR 4
.IX Item "znver2"
پردازنده‌های مبتنی بر هستهٔ AMD Family 17h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، CLWB، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED، MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT، RDPID، WBNOINVD و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBznver3\fR 4
.IX Item "znver3"
پردازنده‌های مبتنی بر هستهٔ AMD Family 19h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، CLWB، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED، MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT، RDPID، WBNOINVD، PKU، VPCLMULQDQ، VAES و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBznver4\fR 4
.IX Item "znver4"
پردازنده‌های مبتنی بر هستهٔ AMD Family 19h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، CLWB، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED، MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT، RDPID، WBNOINVD، PKU، VPCLMULQDQ، VAES، AVX512F، AVX512DQ، AVX512IFMA، AVX512CD، AVX512BW، AVX512VL، AVX512BF16، AVX512VBMI، AVX512VBMI2، AVX512VNNI، AVX512BITALG، AVX512VPOPCNTDQ، GFNI و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBznver5\fR 4
.IX Item "znver5"
پردازنده‌های مبتنی بر هستهٔ AMD Family 1ah با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این مورد شامل ابرمجموعه‌ای از BMI، BMI2، CLWB، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED، MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A، SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT، RDPID، WBNOINVD، PKU، VPCLMULQDQ، VAES، AVX512F، AVX512DQ، AVX512IFMA، AVX512CD، AVX512BW، AVX512VL، AVX512BF16، AVX512VBMI، AVX512VBMI2، AVX512VNNI، AVX512BITALG، AVX512VPOPCNTDQ، GFNI، AVXVNNI، MOVDIRI، MOVDIR64B، AVX512VP2INTERSECT، PREFETCHI و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.).IP \fBznver6\fR 4
.IX Item "znver6"
پردازنده‌های مبتنی بر هسته AMD Family 1ah با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این
گزینه دربرگیرنده ابرمجموعه‌ای از BMI، BMI2، CLWB، F16C، FMA، FSGSBASE، AVX، AVX2، ADCX، RDSEED،
MWAITX، SHA، CLZERO، AES، PCLMUL، CX16، MOVBE، MMX، SSE، SSE2، SSE3، SSE4A،
SSSE3، SSE4.1، SSE4.2، ABM، XSAVEC، XSAVES، CLFLUSHOPT، POPCNT، RDPID،
WBNOINVD، PKU، VPCLMULQDQ، VAES، AVX512F، AVX512DQ، AVX512IFMA، AVX512CD،
AVX512BW، AVX512VL، AVX512BF16، AVX512VBMI، AVX512VBMI2، AVX512VNNI،
AVX512BITALG، AVX512VPOPCNTDQ، GFNI، AVXVNNI، MOVDIRI، MOVDIR64B،
AVX512VP2INTERSECT، PREFETCHI، AVXVNNIINT8، AVXIFMA، AVX512FP16، AVXNECONVERT،
AVX512BMM و افزونه‌های مجموعه دستورالعمل‌های 64\-bit است.)
.IP \fBbtver1\fR 4
.IX Item "btver1"
پردازنده‌های مبتنی بر هسته‌های AMD Family 14h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. (این
گزینه دربرگیرنده ابرمجموعه‌ای از MMX، SSE، SSE2، SSE3، SSSE3، SSE4A، CX16، ABM و افزونه‌های مجموعه
دستورالعمل‌های 64\-bit است.)
.IP \fBbtver2\fR 4
.IX Item "btver2"
پردازنده‌های مبتنی بر هسته‌های AMD Family 16h با پشتیبانی از مجموعه دستورالعمل‌های x86\-64. این
مورد شامل MOVBE، F16C، BMI، AVX، PCLMUL، AES، SSE4.2، SSE4.1، CX16، ABM،
SSE4A، SSSE3، SSE3، SSE2، SSE، MMX و افزونه‌های مجموعه دستورالعمل‌های 64\-bit می‌شود.
.IP \fBwinchip\-c6\fR 4
.IX Item "winchip-c6"
پردازنده IDT WinChip C6، که همانند i486 به همراه پشتیبانی اضافی از مجموعه دستورالعمل‌های
MMX با آن رفتار می‌شود.
.IP \fBwinchip2\fR 4
.IX Item "winchip2"
پردازنده IDT WinChip 2، که همانند i486 به همراه پشتیبانی اضافی از مجموعه دستورالعمل‌های
MMX و !3DNow با آن رفتار می‌شود.
.IP \fBc3\fR 4
.IX Item "c3"
پردازنده VIA C3 با پشتیبانی از مجموعه دستورالعمل‌های MMX و !3DNow.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBc3\-2\fR 4
.IX Item "c3-2"
پردازنده VIA C3\-2 (Nehemiah/C5XL) با پشتیبانی از مجموعه دستورالعمل‌های MMX و SSE.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBc7\fR 4
.IX Item "c7"
پردازنده VIA C7 (Esther) با پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2 و SSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBsamuel\-2\fR 4
.IX Item "samuel-2"
پردازنده VIA Eden Samuel 2 با پشتیبانی از مجموعه دستورالعمل‌های MMX و !3DNow.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnehemiah\fR 4
.IX Item "nehemiah"
پردازنده VIA Eden Nehemiah با پشتیبانی از مجموعه دستورالعمل‌های MMX و SSE.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBesther\fR 4
.IX Item "esther"
پردازنده VIA Eden Esther با پشتیبانی از مجموعه دستورالعمل‌های MMX، SSE، SSE2 و SSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBeden\-x2\fR 4
.IX Item "eden-x2"
پردازنده VIA Eden X2 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2 و SSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBeden\-x4\fR 4
.IX Item "eden-x4"
پردازنده VIA Eden X4 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2،
AVX و AVX2.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\fR 4
.IX Item "nano"
پردازنده عمومی VIA Nano با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3 و SSSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\-1000\fR 4
.IX Item "nano-1000"
پردازنده VIA Nano 1xxx با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3 و SSSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\-2000\fR 4
.IX Item "nano-2000"
پردازنده VIA Nano 2xxx با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3 و SSSE3.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\-3000\fR 4
.IX Item "nano-3000"
پردازنده VIA Nano 3xxx با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSSE3 و SSE4.1.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\-x2\fR 4
.IX Item "nano-x2"
پردازنده دو هسته‌ای VIA Nano با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSSE3 و SSE4.1.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBnano\-x4\fR 4
.IX Item "nano-x4"
پردازنده چهار هسته‌ای VIA Nano با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSSE3 و SSE4.1.
(هیچ زمان‌بندی‌ای برای این تراشه پیاده‌سازی نشده است.)
.IP \fBlujiazui\fR 4
.IX Item "lujiazui"
پردازنده ZHAOXIN lujiazui با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1،
SSE4.2، POPCNT، AES، PCLMUL، RDRND، XSAVE، XSAVEOPT، FSGSBASE، CX16،
ABM، BMI، BMI2، FXSR، RDSEED. اگرچه پردازنده‌ها از AVX و F16C پشتیبانی می‌کنند، اما به دلایل کارایی توسط \f(CW\*(C`\-march=lujiazui\*(C'\fR
فعال نشده‌اند.
.IP \fByongfeng\fR 4
.IX Item "yongfeng"
پردازنده ZHAOXIN yongfeng با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1،
SSE4.2، AVX، POPCNT، AES، PCLMUL، RDRND، XSAVE، XSAVEOPT، FSGSBASE، CX16،
ABM، BMI، BMI2، F16C، FXSR، RDSEED، AVX2، FMA، SHA، LZCNT.
.IP \fBshijidadao\fR 4
.IX Item "shijidadao"
پردازنده ZHAOXIN shijidadao با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MOVBE، MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1،
SSE4.2، AVX، POPCNT، AES، PCLMUL، RDRND، XSAVE، XSAVEOPT، FSGSBASE، CX16،
ABM، BMI، BMI2، F16C، FXSR، RDSEED، AVX2، FMA، SHA، LZCNT.
.IP \fBgeode\fR 4
.IX Item "geode"
پردازنده تعبیه‌شده AMD Geode با پشتیبانی از مجموعه دستورالعمل‌های MMX و !3DNow.
.IP \fBc86\-4g\-m4\fR 4
.IX Item "c86-4g-m4"
پردازنده HYGON c86\-4g\-m4 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSE4A، CX16، ABM، SSSE3،
SSE4.1، SSE4.2، AES، PCLMUL، AVX، AVX2، BMI، BMI2، F16C، FMA، PRFCHW، FXSR، SHA،
XSAVE، XSAVEOPT، XSAVEC، FSGSBASE، RDRND، MOVBE، MWAITX، ADX، RDSEED، CLZERO،
CLFLUSHOPT، XSAVES، LZCNT، POPCNT.
.IP \fBc86\-4g\-m6\fR 4
.IX Item "c86-4g-m6"
پردازنده HYGON c86\-4g\-m6 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSE4A، CX16، ABM، SSSE3،
SSE4.1، SSE4.2، AES، PCLMUL، AVX، AVX2، BMI، BMI2، F16C، FMA، PRFCHW، FXSR، SHA،
XSAVE، XSAVEOPT، XSAVEC، FSGSBASE، RDRND، MOVBE، MWAITX، ADX، RDSEED، CLZERO،
CLFLUSHOPT، XSAVES، LZCNT، POPCNT.
.IP \fBc86\-4g\-m7\fR 4
.IX Item "c86-4g-m7"
پردازنده HYGON c86\-4g\-m7 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSE4A، CX16، ABM، SSSE3،
SSE4.1، SSE4.2، AES، PCLMUL، AVX، AVX2، BMI، BMI2، F16C، FMA، PRFCHW، FXSR، SHA،
XSAVE، XSAVEOPT، XSAVEC، FSGSBASE، RDRND، MOVBE، MWAITX، ADX، RDSEED، CLZERO،
CLFLUSHOPT، XSAVES، LZCNT، POPCNT، AVX512F، AVX512DQ، AVX512IFMA، AVX512CD،
AVX512BW، AVX512VL، AVX512BF16، AVX512VBMI، AVX512VBMI2، GFNI، AVX512VNNI، VAES،
AVX512BITALG، AVX512VPOPCNTDQ، AVX512VP2INTERSECT، AVXVNNI، VPCLMULQDQ،
WBNOINVD.
.IP \fBc86\-4g\-m8\fR 4
.IX Item "c86-4g-m8"
پردازنده HYGON c86\-4g\-m8 با پشتیبانی از مجموعه دستورالعمل‌های x86\-64، MMX، SSE، SSE2، SSE3، SSE4A، CX16، ABM، SSSE3،
SSE4.1، SSE4.2، AES، PCLMUL، AVX، AVX2، BMI، BMI2، F16C، FMA، PRFCHW، FXSR، SHA،
XSAVE، XSAVEOPT، XSAVEC، FSGSBASE، RDRND، MOVBE، MWAITX، ADX، RDSEED، CLZERO،
CLFLUSHOPT، XSAVES، LZCNT، POPCNT، AVX512F، AVX512DQ، AVX512IFMA، AVX512CD،
AVX512BW، AVX512VL، AVX512BF16، AVX512VBMI، AVX512VBMI2، GFNI، AVX512VNNI، VAES،
AVX512BITALG، AVX512VPOPCNTDQ، AVX512VP2INTERSECT، AVXVNNI، VPCLMULQDQ،
WBNOINVD.
.RE
.RS 4
.RE
.IP \fB\-mtune=\fR\fIcpu\-type\fR 4
.IX Item "-mtune=cpu-type"
همه موارد قابل‌اعمال در کد تولیدشده، به‌جز ABI و مجموعه دستورالعمل‌های در دسترس،
برای \fIcpu\-type\fR تنظیم (tune) می‌شوند.
در حالی که انتخاب یک \fIcpu\-type\fR خاص، زمان‌بندی دستورها را به طور مناسب
برای آن تراشه ویژه تنظیم می‌کند، کامپایلر هیچ کدی تولید نمی‌کند که نتواند
روی نوع ماشین پیش‌فرض اجرا شود، مگر اینکه از گزینه
\&\fB\-march=\fR\fIcpu\-type\fR استفاده کنید.
به عنوان مثال، اگر GCC برای i686\-pc\-linux\-gnu پیکربندی شده باشد،
آنگاه \fB\-mtune=pentium4\fR کدی تولید می‌کند که برای Pentium 4 بهینه‌سازی و تنظیم شده است
اما همچنان روی ماشین‌های i686 اجرا می‌شود.
.Sp
گزینه‌های انتخابی برای \fIcpu\-type\fR همانند گزینه‌های \fB\-march\fR هستند.
علاوه بر این، \fB\-mtune\fR از ۲ گزینه اضافی برای \fIcpu\-type\fR پشتیبانی می‌کند:
.RS 4
.IP \fBgeneric\fR 4
.IX Item "generic"
تولید کد بهینه‌سازی‌شده برای رایج‌ترین پردازنده‌های IA32/AMD64/EM64T.
اگر پردازنده‌ای را که کد شما روی آن اجرا خواهد شد می‌شناسید، باید به‌جای
\&\fB\-mtune=generic\fR از گزینه متناظر \fB\-mtune\fR یا \fB\-march\fR استفاده کنید. اما اگر دقیقاً
نمی‌دانید کاربران برنامه شما چه پردازنده‌ای خواهند داشت، باید از این گزینه استفاده کنید.
.Sp
با عرضه پردازنده‌های جدید در بازار، رفتار این گزینه تغییر خواهد کرد.
بنابراین، اگر به نسخه جدیدتری از GCC ارتقا دهید، تولید کدِ کنترل‌شده
توسط این گزینه تغییر خواهد کرد تا منعکس‌کننده پردازنده‌هایی باشد
که در زمان انتشار آن نسخه از GCC رایج‌تر بوده‌اند.
.Sp
هیچ گزینه \fB\-march=generic\fR وجود ندارد زیرا \fB\-march\fR
نشان‌دهنده مجموعه دستورالعمل‌هایی است که کامپایلر می‌تواند استفاده کند، و هیچ
مجموعه دستورالعمل عمومی‌ای وجود ندارد که برای همه پردازنده‌ها قابل‌اعمال باشد. در مقابل،
\&\fB\-mtune\fR نشان‌دهنده پردازنده‌ای (یا در این مورد، مجموعه‌ای از پردازنده‌ها) است
که کد برای آن بهینه‌سازی می‌شود..IP \fBintel\fR 4
.IX Item "intel"
تولید کد بهینه‌شده برای جدیدترین پردازنده‌های Intel، که برای این نسخه از GCC شامل Haswell و Silvermont می‌شوند. اگر پردازنده‌ای را که کد شما روی آن اجرا خواهد شد می‌شناسید، باید به‌جای \fB\-mtune=intel\fR از گزینهٔ متناظر \fB\-mtune\fR یا \fB\-march\fR استفاده کنید. با این حال، اگر می‌خواهید برنامه‌تان روی هر دو پردازندهٔ Diamond Rapids و Clearwater Forest عملکرد بهتری داشته باشد، باید از این گزینه استفاده کنید.
.Sp
با عرضهٔ پردازنده‌های جدیدتر Intel در بازار، رفتار این گزینه تغییر خواهد کرد. بنابراین، اگر به نسخهٔ جدیدتری از GCC ارتقا دهید، تولید کد کنترل‌شده توسط این گزینه تغییر خواهد کرد تا منعکس‌کنندهٔ جدیدترین پردازنده‌های Intel در زمان انتشار آن نسخه از GCC باشد.
.Sp
گزینهٔ \fB\-march=intel\fR وجود ندارد، زیرا \fB\-march\fR مجموعه دستورالعمل‌هایی را که کامپایلر می‌تواند استفاده کند مشخص می‌سازد، و هیچ مجموعه دستورالعمل مشترکی که برای همهٔ پردازنده‌ها قابل‌اعمال باشد وجود ندارد. در مقابل، \&\fB\-mtune\fR پردازنده (یا در این حالت، مجموعه‌ای از پردازنده‌ها) را که کد برای آن بهینه‌سازی می‌شود، مشخص می‌کند.
.RE
.RS 4
.RE
.PP
گزینه‌های زیر امکان کنترل دقیق‌تر بر پسوندهای مجموعه دستورالعمل‌های هدف GCC را فراهم می‌کنند. هر یک دارای یک گزینهٔ متناظر \fB\-mno\-\fR برای غیرفعال کردن استفاده از این دستورالعمل‌ها است.
.PP
این پسوندها همچنین به‌صورت توابع توکار (built\-in) در دسترس هستند: برای جزئیات توابع فعال و غیرفعال‌شده توسط این سوئیچ‌ها، به \&\fBx86 Built\-in Functions\fR مراجعه کنید.
.PP
این گزینه‌ها GCC را قادر می‌سازند تا از این دستورالعمل‌های گسترش‌یافته در کد تولیدشده استفاده کند. برنامه‌هایی که تشخیص پردازنده را در زمان اجرا انجام می‌دهند، باید فایل‌های جداگانه‌ای را برای هر معماری پشتیبانی‌شده، با استفاده از پرچم‌های مناسب کامپایل کنند. به‌ویژه، فایلی که شامل کد تشخیص پردازنده است باید بدون این گزینه‌ها کامپایل شود.
.PP
برای کنترل اینکه آیا دستورالعمل‌های 387 یا SSE/AVX به‌طور خودکار برای محاسبات ممیز شناور تولید شوند یا خیر، به گزینهٔ \fB\-mfpmath=\fR در زیر مراجعه کنید.
.IP \fB\-mmmx\fR 4
.IX Item "-mmmx"
پشتیبانی از توابع توکار MMX.
.IP \fB\-msse\fR 4
.IX Item "-msse"
پشتیبانی از توابع توکار و تولید کد MMX و SSE.
.IP \fB\-msse2\fR 4
.IX Item "-msse2"
پشتیبانی از توابع توکار و تولید کد MMX، SSE و SSE2.
.IP \fB\-msse3\fR 4
.IX Item "-msse3"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2 و SSE3.
.IP \fB\-mssse3\fR 4
.IX Item "-mssse3"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3 و SSSE3.
.IP \fB\-msse4.1\fR 4
.IX Item "-msse4.1"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3 و SSE4.1.
.IP \fB\-msse4.2\fR 4
.IX Item "-msse4.2"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1 و SSE4.2.
.IP \fB\-msse4\fR 4
.IX Item "-msse4"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1 و SSE4.2.
.Sp
توجه داشته باشید که \fB\-msse4\fR پشتیبانی از هر دو مجموعهٔ SSE4.1 و SSE4.2 را فعال می‌کند، در حالی که \fB\-mno\-sse4\fR این ویژگی‌ها را غیرفعال می‌سازد؛ هیچ‌یک از حالت‌های این گزینه تأثیری بر پشتیبانی از SSE4A که به‌طور جداگانه توسط \&\fB\-msse4a\fR کنترل می‌شود، ندارد.
.IP \fB\-msse4a\fR 4
.IX Item "-msse4a"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3 و SSE4A.
.IP \fB\-mavx\fR 4
.IX Item "-mavx"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2 و AVX.
.IP \fB\-mavx2\fR 4
.IX Item "-mavx2"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX و AVX2.
.IP \fB\-mavx512f\fR 4
.IX Item "-mavx512f"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVX512F.
.IP \fB\-mavx512cd\fR 4
.IX Item "-mavx512cd"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512CD.
.IP \fB\-mavx512vl\fR 4
.IX Item "-mavx512vl"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512VL.
.IP \fB\-mavx512bw\fR 4
.IX Item "-mavx512bw"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512BW.
.IP \fB\-mavx512dq\fR 4
.IX Item "-mavx512dq"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512DQ.
.IP \fB\-mavx512ifma\fR 4
.IX Item "-mavx512ifma"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512IFMA.
.IP \fB\-mavx512vbmi\fR 4
.IX Item "-mavx512vbmi"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512VBMI.
.IP \fB\-mavx512vpopcntdq\fR 4
.IX Item "-mavx512vpopcntdq"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512VPOPCNTDQ.
.IP \fB\-mavx512vp2intersect\fR 4
.IX Item "-mavx512vp2intersect"
پشتیبانی از توابع توکار و تولید کد AVX512VP2INTERSECT.
.IP \fB\-mavx512vnni\fR 4
.IX Item "-mavx512vnni"
پشتیبانی از توابع توکار و تولید کد AVX512VNNI.
.IP \fB\-mavx512vbmi2\fR 4
.IX Item "-mavx512vbmi2"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512VBMI2.
.IP \fB\-mavx512bf16\fR 4
.IX Item "-mavx512bf16"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512BF16.
.IP \fB\-mavx512fp16\fR 4
.IX Item "-mavx512fp16"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512\-FP16.
.IP \fB\-mavx512bitalg\fR 4
.IX Item "-mavx512bitalg"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX512F و AVX512BITALG.
.IP \fB\-mavx512bmm\fR 4
.IX Item "-mavx512bmm"
پشتیبانی از توابع توکار و تولید کد AVX512BMM.
.IP \fB\-mavxvnni\fR 4
.IX Item "-mavxvnni"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVXVNNI.
.IP \fB\-mavxifma\fR 4
.IX Item "-mavxifma"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVXIFMA.
.IP \fB\-mavxvnniint8\fR 4
.IX Item "-mavxvnniint8"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVXVNNIINT8.
.IP \fB\-mavxneconvert\fR 4
.IX Item "-mavxneconvert"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVXNECONVERT.
.IP \fB\-mavxvnniint16\fR 4
.IX Item "-mavxvnniint16"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVXVNNIINT16.
.IP \fB\-mavx10.1\fR 4
.IX Item "-mavx10.1"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و AVX10.1.
.IP \fB\-mavx10.2\fR 4
.IX Item "-mavx10.2"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2، AVX10.1 و AVX10.2.
.IP \fB\-msha\fR 4
.IX Item "-msha"
پشتیبانی از توابع توکار و تولید کد SHA1 و SHA256.
.IP \fB\-maes\fR 4
.IX Item "-maes"
پشتیبانی از توابع توکار و تولید کد AES.
.IP \fB\-mpclmul\fR 4
.IX Item "-mpclmul"
پشتیبانی از توابع توکار و تولید کد PCLMUL.
.IP \fB\-mclflushopt\fR 4
.IX Item "-mclflushopt"
پشتیبانی از دستورالعمل‌های CLFLUSHOPT..IP \fB\-mclwb\fR 4
.IX Item "-mclwb"
پشتیبانی از دستور CLWB.
.IP \fB\-mfsgsbase\fR 4
.IX Item "-mfsgsbase"
پشتیبانی از توابع توکار و تولید کد FSGSBASE.
.IP \fB\-mptwrite\fR 4
.IX Item "-mptwrite"
پشتیبانی از توابع توکار و تولید کد PTWRITE.
.IP \fB\-mrdrnd\fR 4
.IX Item "-mrdrnd"
پشتیبانی از توابع توکار و تولید کد RDRND.
.IP \fB\-mf16c\fR 4
.IX Item "-mf16c"
پشتیبانی از توابع توکار و تولید کد F16C.
.IP \fB\-mfma\fR 4
.IX Item "-mfma"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX و FMA.
.IP \fB\-mfma4\fR 4
.IX Item "-mfma4"
پشتیبانی از توابع توکار و تولید کد FMA4.
.IP \fB\-mpconfig\fR 4
.IX Item "-mpconfig"
پشتیبانی از توابع توکار و تولید کد PCONFIG.
.IP \fB\-mwbnoinvd\fR 4
.IX Item "-mwbnoinvd"
پشتیبانی از توابع توکار و تولید کد WBNOINVD.
.IP \fB\-mprfchw\fR 4
.IX Item "-mprfchw"
پشتیبانی از دستور PREFETCHW.
.IP \fB\-mrdpid\fR 4
.IX Item "-mrdpid"
پشتیبانی از توابع توکار و تولید کد RDPID.
.IP \fB\-mrdseed\fR 4
.IX Item "-mrdseed"
پشتیبانی از دستور RDSEED.
.IP \fB\-msgx\fR 4
.IX Item "-msgx"
پشتیبانی از توابع توکار و تولید کد SGX.
.IP \fB\-mxop\fR 4
.IX Item "-mxop"
پشتیبانی از توابع توکار و تولید کد XOP.
.IP \fB\-mlwp\fR 4
.IX Item "-mlwp"
پشتیبانی از توابع توکار و تولید کد LWP.
.IP \fB\-m3dnow\fR 4
.IX Item "-m3dnow"
پشتیبانی از توابع توکار 3DNow!.
.IP \fB\-m3dnowa\fR 4
.IX Item "-m3dnowa"
پشتیبانی از توابع توکار Athlon 3Dnow!.
.IP \fB\-mpopcnt\fR 4
.IX Item "-mpopcnt"
پشتیبانی از تولید کد دستور popcnt.
.IP \fB\-mabm\fR 4
.IX Item "-mabm"
پشتیبانی از تولید کد دستورهای دستکاری پیشرفته بیت (ABM).
.IP \fB\-madx\fR 4
.IX Item "-madx"
پشتیبانی از دستورهای add\-carry با حفظ پرچم.
.IP \fB\-mbmi\fR 4
.IX Item "-mbmi"
پشتیبانی از توابع توکار و تولید کد BMI.
.IP \fB\-mbmi2\fR 4
.IX Item "-mbmi2"
پشتیبانی از توابع توکار و تولید کد BMI2.
.IP \fB\-mlzcnt\fR 4
.IX Item "-mlzcnt"
پشتیبانی از تابع توکار و تولید کد LZCNT.
.IP \fB\-mfxsr\fR 4
.IX Item "-mfxsr"
پشتیبانی از دستورهای FXSAVE و FXRSTOR.
.IP \fB\-mxsave\fR 4
.IX Item "-mxsave"
پشتیبانی از دستورهای XSAVE و XRSTOR.
.IP \fB\-mxsaveopt\fR 4
.IX Item "-mxsaveopt"
پشتیبانی از دستور XSAVEOPT.
.IP \fB\-mxsavec\fR 4
.IX Item "-mxsavec"
پشتیبانی از دستورهای XSAVEC.
.IP \fB\-mxsaves\fR 4
.IX Item "-mxsaves"
پشتیبانی از دستورهای XSAVES و XRSTORS.
.IP \fB\-mrtm\fR 4
.IX Item "-mrtm"
پشتیبانی از توابع توکار و تولید کد RTM.
.IP \fB\-mhle\fR 4
.IX Item "-mhle"
پشتیبانی از پیشوندهای Hardware Lock Elision.
.IP \fB\-mtbm\fR 4
.IX Item "-mtbm"
پشتیبانی از توابع توکار و تولید کد TBM.
.IP \fB\-mmwaitx\fR 4
.IX Item "-mmwaitx"
پشتیبانی از توابع توکار و تولید کد MWAITX و MONITORX.
.IP \fB\-mclzero\fR 4
.IX Item "-mclzero"
پشتیبانی از توابع توکار و تولید کد CLZERO.
.IP \fB\-mpku\fR 4
.IX Item "-mpku"
پشتیبانی از توابع توکار و تولید کد PKU.
.IP \fB\-mgfni\fR 4
.IX Item "-mgfni"
پشتیبانی از توابع توکار و تولید کد GFNI.
.IP \fB\-mvaes\fR 4
.IX Item "-mvaes"
پشتیبانی از توابع توکار و تولید کد VAES.
.IP \fB\-mwaitpkg\fR 4
.IX Item "-mwaitpkg"
پشتیبانی از توابع توکار و تولید کد WAITPKG.
.IP \fB\-mvpclmulqdq\fR 4
.IX Item "-mvpclmulqdq"
پشتیبانی از توابع توکار و تولید کد VPCLMULQDQ.
.IP \fB\-mmovdiri\fR 4
.IX Item "-mmovdiri"
پشتیبانی از توابع توکار و تولید کد MOVDIRI.
.IP \fB\-mmovdir64b\fR 4
.IX Item "-mmovdir64b"
پشتیبانی از توابع توکار و تولید کد MOVDIR64B.
.IP \fB\-menqcmd\fR 4
.IX Item "-menqcmd"
پشتیبانی از توابع توکار و تولید کد ENQCMD.
.IP \fB\-muintr\fR 4
.IX Item "-muintr"
پشتیبانی از توابع توکار و تولید کد UINTR.
.IP \fB\-mtsxldtrk\fR 4
.IX Item "-mtsxldtrk"
پشتیبانی از توابع توکار و تولید کد TSXLDTRK.
.IP \fB\-mcldemote\fR 4
.IX Item "-mcldemote"
پشتیبانی از توابع توکار و تولید کد CLDEMOTE.
.IP \fB\-mserialize\fR 4
.IX Item "-mserialize"
پشتیبانی از توابع توکار و تولید کد SERIALIZE.
.IP \fB\-mamx\-tile\fR 4
.IX Item "-mamx-tile"
پشتیبانی از توابع توکار و تولید کد AMX\-TILE.
.IP \fB\-mamx\-int8\fR 4
.IX Item "-mamx-int8"
پشتیبانی از توابع توکار و تولید کد AMX\-INT8.
.IP \fB\-mamx\-bf16\fR 4
.IX Item "-mamx-bf16"
پشتیبانی از توابع توکار و تولید کد AMX\-BF16.
.IP \fB\-mhreset\fR 4
.IX Item "-mhreset"
پشتیبانی از توابع توکار و تولید کد HRESET.
.IP \fB\-mkl\fR 4
.IX Item "-mkl"
پشتیبانی از توابع توکار و تولید کد KL.
.IP \fB\-mwidekl\fR 4
.IX Item "-mwidekl"
پشتیبانی از توابع توکار و تولید کد WIDEKL.
.IP \fB\-mcmpccxadd\fR 4
.IX Item "-mcmpccxadd"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2 و CMPCCXADD.
.IP \fB\-mamx\-fp16\fR 4
.IX Item "-mamx-fp16"
پشتیبانی از توابع توکار و تولید کد AMX\-FP16.
.IP \fB\-mprefetchi\fR 4
.IX Item "-mprefetchi"
پشتیبانی از توابع توکار و تولید کد PREFETCHI.
.IP \fB\-mraoint\fR 4
.IX Item "-mraoint"
پشتیبانی از توابع توکار و تولید کد RAOINT.
.IP \fB\-mamx\-complex\fR 4
.IX Item "-mamx-complex"
پشتیبانی از توابع توکار و تولید کد AMX\-COMPLEX.
.IP \fB\-msm3\fR 4
.IX Item "-msm3"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX و SM3.
.IP \fB\-msm4\fR 4
.IX Item "-msm4"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX و SM4.
.IP \fB\-msha512\fR 4
.IX Item "-msha512"
پشتیبانی از توابع توکار و تولید کد MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX و SHA512..IP \fB\-mapxf\fR 4
.IX Item "-mapxf"
پشتیبانی از تولید کد برای قابلیت‌های APX، شامل EGPR، PUSH2POP2،
NDD، PPX، NF، CCMP و ZU.
.IP \fB\-musermsr\fR 4
.IX Item "-musermsr"
پشتیبانی از توابع توکار و تولید کد برای USER_MSR.
.IP \fB\-mamx\-avx512\fR 4
.IX Item "-mamx-avx512"
پشتیبانی از توابع توکار و تولید کد برای MMX، SSE، SSE2، SSE3، SSSE3، SSE4.1، SSE4.2، AVX، AVX2،
AVX10.1، AVX10.2 و AMX\-AVX512.
.IP \fB\-mamx\-tf32\fR 4
.IX Item "-mamx-tf32"
پشتیبانی از توابع توکار و تولید کد برای AMX\-TF32.
.IP \fB\-mamx\-fp8\fR 4
.IX Item "-mamx-fp8"
پشتیبانی از توابع توکار و تولید کد برای AMX\-FP8.
.IP \fB\-mmovrs\fR 4
.IX Item "-mmovrs"
پشتیبانی از توابع توکار و تولید کد برای MOVRS.
.IP \fB\-mamx\-movrs\fR 4
.IX Item "-mamx-movrs"
پشتیبانی از توابع توکار و تولید کد برای AMX\-MOVRS.
.PP
این گزینه‌های اضافی برای خانوادهٔ پردازنده‌های x86 در دسترس هستند.
.IP \fB\-mfpmath=\fR\fIunit\fR 4
.IX Item "-mfpmath=unit"
تولید محاسبات ممیز شناور برای واحد انتخاب‌شدهٔ \fIunit\fR. گزینه‌های موجود
برای \fIunit\fR عبارتند از:
.RS 4
.IP \fB387\fR 4
.IX Item "387"
استفاده از پردازندهٔ کمکی ممیز شناور استاندارد 387 که در اکثر
تراشه‌ها موجود است و در غیر این صورت شبیه‌سازی می‌شود.
کد کامپایل‌شده با این گزینه تقریباً در همه‌جا اجرا می‌شود.
نتایج موقت به جای دقتی که نوع داده مشخص کرده است، با دقت ۸۰ بیتی محاسبه
می‌شوند که در مقایسه با اکثر تراشه‌های دیگر به نتایجی با تفاوت جزئی می‌انجامد.
برای توضیحات دقیق‌تر، \fB\-ffloat\-store\fR را ببینید.
.Sp
این انتخاب پیش‌فرض برای مقصدهای x86\-32 غیر از Darwin است.
.IP \fBsse\fR 4
.IX Item "sse"
استفاده از دستورالعمل‌های ممیز شناور اسکالرِ موجود در مجموعه دستورالعمل‌های SSE.
این مجموعه دستورالعمل توسط Pentium III و تراشه‌های جدیدتر،
و در خط تولید AMD توسط تراشه‌های Athlon\-4، Athlon XP و Athlon MP پشتیبانی می‌شود.
نسخهٔ اولیهٔ مجموعه دستورالعمل‌های SSE
فقط از محاسبات با دقت یگانه (single\-precision) پشتیبانی می‌کند، بنابراین محاسبات با دقت دوگانه و
دقت گسترش‌یافته همچنان با استفاده از 387 انجام می‌شوند.
نسخهٔ بعدی، که فقط در تراشه‌های Pentium 4 و AMD x86\-64 وجود دارد،
از محاسبات با دقت دوگانه نیز پشتیبانی می‌کند.
.Sp
برای کامپایلر x86\-32، باید از سوییچ‌های \fB\-march=\fR\fIcpu\-type\fR،
\&\fB\-msse\fR
یا \fB\-msse2\fR برای فعال‌سازی پسوندهای SSE و اثربخش کردن این گزینه
استفاده کنید. برای کامپایلر x86\-64، این پسوندها به صورت پیش‌فرض فعال هستند.
.Sp
کد حاصل در اکثر موارد باید به‌طور قابل توجهی سریع‌تر باشد و از
مشکلات ناپایداری عددی کدهای 387 جلوگیری کند، اما ممکن است برخی از کدهای
موجود را که انتظار دارند متغیرهای موقت ۸۰ بیتی باشند دچار خطا کند.
.Sp
این انتخاب پیش‌فرض برای کامپایلر x86\-64، مقصدهای Darwin x86\-32،
و انتخاب پیش‌فرض برای مقصدهای x86\-32 دارای مجموعه دستورالعمل‌های SSE2
در هنگام فعال بودن \fB\-ffast\-math\fR است.
.Sp
هنگام استفاده از \fB\-mavx\fR (یا گزینهٔ دیگری که پسوندهای AVX را فعال می‌کند)،
GCC دستورالعمل‌های SSE را فرومی‌نشاند؛ در عوض،
دستورالعمل‌های جدید AVX یا معادل‌های AVX را در صورت نیاز برای تمامی دستورالعمل‌های
SSE تولید می‌کند.
.IP \fBsse,387\fR 4
.IX Item "sse,387"
.PD 0
.IP \fBsse+387\fR 4
.IX Item "sse+387"
.IP \fBboth\fR 4
.IX Item "both"
.PD
تلاش برای استفاده از هر دو مجموعه دستورالعمل به‌طور هم‌زمان. این کار عملاً تعداد
ثبات‌های در دسترس را دو برابر می‌کند، و در تراشه‌هایی با واحدهای اجرایی جداگانه برای
387 و SSE، منابع اجرایی را نیز مضاعف می‌سازد. از این گزینه با احتیاط استفاده کنید، زیرا
هنوز آزمایشی است؛ چرا که تخصیص‌دهندهٔ ثبات GCC واحدهای عملکردی مجزا را به خوبی
مدل‌سازی نمی‌کند که منجر به کارایی ناپایدار می‌شود.
.RE
.RS 4
.RE
.IP \fB\-mieee\-fp\fR 4
.IX Item "-mieee-fp"
.PD 0
.IP \fB\-mno\-ieee\-fp\fR 4
.IX Item "-mno-ieee-fp"
.PD
کنترل می‌کند که آیا کامپایلر از مقایسه‌های ممیز شناور IEEE استفاده کند
یا خیر. این مقایسه‌ها حالتی را که نتیجهٔ یک مقایسه نامرتب (unordered)
است، به‌درستی مدیریت می‌کنند.
.IP \fB\-m80387\fR 4
.IX Item "-m80387"
.PD 0
.IP \fB\-mhard\-float\fR 4
.IX Item "-mhard-float"
.PD
تولید خروجی حاوی دستورالعمل‌های 80387 برای ممیز شناور.
.IP \fB\-mno\-80387\fR 4
.IX Item "-mno-80387"
.PD 0
.IP \fB\-msoft\-float\fR 4
.IX Item "-msoft-float"
.PD
تولید خروجی حاوی فراخوانی‌های کتابخانه‌ای برای ممیز شناور.
.Sp
\&\fBهشدار:\fR کتابخانه‌های ضروری بخشی از GCC نیستند.
به‌طور معمول از امکانات کامپایلر معمول C ماشین استفاده می‌شود، اما
این کار در کامپایل متقابل (cross\-compilation) به‌طور مستقیم امکان‌پذیر نیست. باید
تمهیدات لازم را برای فراهم کردن توابع کتابخانه‌ای مناسب برای
کامپایل متقابل در نظر بگیرید.
.Sp
در ماشین‌هایی که یک تابع نتایج ممیز شناور را در پشتهٔ ثبات‌های 80387
برمی‌گرداند، ممکن است حتی در صورت استفاده از \&\fB\-msoft\-float\fR
برخی کدهای دستوری (opcode) ممیز شناور صادر شوند.
.IP \fB\-mno\-fp\-ret\-in\-387\fR 4
.IX Item "-mno-fp-ret-in-387"
عدم استفاده از ثبات‌های FPU برای مقادیر بازگشتی توابع.
.Sp
قرارداد فراخوانی معمول به این صورت است که توابع مقادیر نوع‌های
\&\f(CW\*(C`float\*(C'\fR و \f(CW\*(C`double\*(C'\fR را در یک ثبات FPU بازمی‌گردانند، حتی اگر
FPU فیزیکی وجود نداشته باشد. ایده این است که سیستم‌عامل باید
یک FPU را شبیه‌سازی کند.
.Sp
گزینهٔ \fB\-mno\-fp\-ret\-in\-387\fR باعث می‌شود چنین مقادیری در عوض در
ثبات‌های معمولی CPU بازگردانده شوند.
.IP \fB\-mno\-fancy\-math\-387\fR 4
.IX Item "-mno-fancy-math-387"
برخی شبیه‌سازهای 387 از دستورالعمل‌های \f(CW\*(C`sin\*(C'\fR، \f(CW\*(C`cos\*(C'\fR و
\&\f(CW\*(C`sqrt\*(C'\fR برای 387 پشتیبانی نمی‌کنند. این گزینه را برای جلوگیری از
تولید این دستورالعمل‌ها مشخص کنید.
این گزینه در صورتی که \fB\-march\fR
مشخص کند CPU مقصد همیشه دارای یک FPU است و بنابراین دستور
نیازی به شبیه‌سازی ندارد، نادیده گرفته می‌شود. این
دستورالعمل‌ها تولید نمی‌شوند مگر اینکه از سوییچ
\&\fB\-funsafe\-math\-optimizations\fR نیز استفاده کنید.
.IP \fB\-malign\-double\fR 4
.IX Item "-malign-double"
.PD 0
.IP \fB\-mno\-align\-double\fR 4
.IX Item "-mno-align-double"
.PD
کنترل می‌کند که آیا GCC متغیرهای \f(CW\*(C`double\*(C'\fR، \f(CW\*(C`long double\*(C'\fR و
\&\f(CW\*(C`long long\*(C'\fR را در یک مرز دو کلمه‌ای تراز کند یا یک مرز
تک کلمه‌ای. تراز کردن متغیرهای \f(CW\*(C`double\*(C'\fR در یک مرز دو کلمه‌ای
کدی تولید می‌کند که روی Pentium با هزینهٔ مصرف حافظهٔ بیشتر،
تا حدی سریع‌تر اجرا می‌شود.
.Sp
در x86\-64، گزینهٔ \fB\-malign\-double\fR به صورت پیش‌فرض فعال است.
.Sp
\&\fBهشدار:\fR در صورت استفاده از سوییچ \fB\-malign\-double\fR،
ساختارهای حاوی انواع فوق متفاوت با مشخصات منتشرشدهٔ رابط باینری کاربردی (ABI)
برای x86\-32 تراز می‌شوند و با ساختارها در کدهای کامپایل‌شده بدون این سوییچ
سازگاری باینری نخواهند داشت.
.IP \fB\-m96bit\-long\-double\fR 4
.IX Item "-m96bit-long-double"
.PD 0
.IP \fB\-m128bit\-long\-double\fR 4
.IX Item "-m128bit-long-double"
.PD
این سوییچ‌ها اندازهٔ نوع دادهٔ \f(CW\*(C`long double\*(C'\fR را کنترل می‌کنند. رابط باینری
کاربردی (ABI) در x86\-32 اندازه را ۹۶ بیت مشخص می‌کند،
بنابراین \fB\-m96bit\-long\-double\fR در حالت ۳۲ بیتی پیش‌فرض است.
.Sp
معماری‌های مدرن (Pentium و جدیدتر) ترجیح می‌دهند \f(CW\*(C`long double\*(C'\fR
روی یک مرز ۸ یا ۱۶ بایتی تراز شود. در آرایه‌ها یا ساختارهای
منطبق با ABI، این امر امکان‌پذیر نیست. بنابراین، مشخص کردن
\&\fB\-m128bit\-long\-double\fR، نوع دادهٔ \f(CW\*(C`long double\*(C'\fR را
با پَد کردن (padding) با ۳۲ بیت صفر اضافه، روی یک مرز ۱۶ بایتی
تراز می‌کند.
.Sp
در کامپایلر x86\-64، گزینهٔ \fB\-m128bit\-long\-double\fR انتخاب پیش‌فرض است زیرا
ABI آن مشخص می‌کند که \f(CW\*(C`long double\*(C'\fR روی مرز ۱۶ بایتی تراز شود.
.Sp
توجه داشته باشید که هیچ‌یک از این گزینه‌ها دقتی فراتر از استاندارد ۸۰ بیتی x87
برای \f(CW\*(C`long double\*(C'\fR فراهم نمی‌کنند.
.Sp
\&\fBهشدار:\fR اگر مقدار پیش‌فرض را برای ABI مقصد خود بازنویسی کنید، این کار
اندازهٔ ساختارها و آرایه‌های حاوی متغیرهای \f(CW\*(C`long double\*(C'\fR را تغییر می‌دهد،
و همچنین قرارداد فراخوانی تابع را برای توابعی که آرگومان
\&\f(CW\*(C`long double\*(C'\fR می‌گیرند دگرگون می‌سازد. از این رو، این موارد با کدهایی که
بدون این سوییچ کامپایل شده‌اند سازگاری باینری نخواهند داشت..IP \fB\-mlong\-double\-64\fR 4
.IX Item "-mlong-double-64"
.PD 0
.IP \fB\-mlong\-double\-80\fR 4
.IX Item "-mlong-double-80"
.IP \fB\-mlong\-double\-128\fR 4
.IX Item "-mlong-double-128"
.PD
این سوییچ‌ها اندازهٔ نوع \f(CW\*(C`long double\*(C'\fR را کنترل می‌کنند. اندازهٔ ۶۴ بیتی، نوع \f(CW\*(C`long double\*(C'\fR را معادل با نوع \f(CW\*(C`double\*(C'\fR قرار می‌دهد. این حالت پیش‌فرض برای کتابخانه ۳۲ بیتی Bionic C است. اندازهٔ ۱۲۸ بیتی، نوع \f(CW\*(C`long double\*(C'\fR را معادل با نوع \&\f(CW\*(C`_\|_float128\*(C'\fR قرار می‌دهد. این حالت پیش‌فرض برای کتابخانه ۶۴ بیتی Bionic C است.
.Sp
\&\fBهشدار:\fR اگر مقدار پیش‌فرض را برای ABI مقصد خود تغییر دهید، این کار اندازهٔ ساختارها و آرایه‌های حاوی متغیرهای \f(CW\*(C`long double\*(C'\fR را تغییر می‌دهد و همچنین قرارداد فراخوانی تابع (calling convention) را برای توابعی که آرگومان \f(CW\*(C`long double\*(C'\fR می‌گیرند دگرگون می‌سازد. از این رو، آن‌ها با کدهایی که بدون این سوییچ کامپایل شده‌اند سازگاری باینری (binary-compatible) نخواهند داشت.
.IP \fB\-malign\-data=\fR\fItype\fR 4
.IX Item "-malign-data=type"
نحوهٔ هم‌ترازی متغیرها توسط GCC را کنترل می‌کند. مقادیر پشتیبانی‌شده برای \fItype\fR عبارتند از:
\&\fBcompat\fR از مقدار هم‌ترازیِ افزایش‌یافته سازگار با GCC 4.8 و پیش از آن استفاده می‌کند، \fBabi\fR از مقدار هم‌ترازی مشخص‌شده توسط psABI بهره می‌برد، و \fBcacheline\fR از مقدار هم‌ترازیِ افزایش‌یافته برای مطابقت با اندازه خط حافظهٔ نهان (cache line size) استفاده می‌کند. مقدار پیش‌فرض \fBcompat\fR است.
.IP \fB\-mlarge\-data\-threshold=\fR\fIthreshold\fR 4
.IX Item "-mlarge-data-threshold=threshold"
هنگامی که \fB\-mcmodel=medium\fR یا \fB\-mcmodel=large\fR مشخص شده باشد، شیءهای داده بزرگ‌تر از \fIthreshold\fR در بخش‌های دادهٔ بزرگ (large data sections) قرار می‌گیرند. مقدار پیش‌فرض 65535 است.
.IP \fB\-mrtd\fR 4
.IX Item "-mrtd"
از یک قرارداد فراخوانی تابع متفاوت استفاده می‌کند که در آن، توابعی با تعداد ثابتی از آرگومان‌ها با دستور \f(CW\*(C`ret \fR\f(CInum\fR\f(CW\*(C'\fR بازمی‌گردند؛ دستوری که آرگومان‌های آن‌ها را در هنگام بازگشت از پشته خارج (pop) می‌کند. این کار به دلیل عدم نیاز به خارج کردن آرگومان‌ها در سمت فراخواننده، باعث صرفه‌جویی در یک دستور در فراخواننده (caller) می‌شود.
.Sp
می‌توانید با استفاده از مشخصهٔ تابع (function attribute) \f(CW\*(C`stdcall\*(C'\fR تعیین کنید که یک تابع مشخص با این توالی فراخوانی صدا زده شود. همچنین می‌توانید گزینهٔ \fB\-mrtd\fR را با استفاده از مشخصهٔ تابع \&\f(CW\*(C`cdecl\*(C'\fR لغو و بازنویسی کنید.
.Sp
\&\fBهشدار:\fR این قرارداد فراخوانی با قراردادی که به‌طور معمول در Unix استفاده می‌شود ناسازگار است؛ بنابراین در صورت نیاز به فراخوانی کتابخانه‌هایی که با کامپایلر Unix کامپایل شده‌اند، نمی‌توانید از آن استفاده کنید.
.Sp
همچنین، باید الگوی اولیهٔ تابع (function prototype) را برای همهٔ توابعی که تعداد متغیری آرگومان می‌پذیرند (شامل \f(CW\*(C`printf\*(C'\fR) فراهم کنید؛ در غیر این صورت کدهای نادرستی برای فراخوانی این توابع تولید می‌شود.
.Sp
علاوه بر این، اگر تابعی را با بیش از حد مجاز آرگومان فراخوانی کنید، کد به‌شدت اشتباهی حاصل خواهد شد. (به‌طور معمول، آرگومان‌های اضافی بدون مشکل نادیده گرفته می‌شوند.)
.IP \fB\-mregparm=\fR\fInum\fR 4
.IX Item "-mregparm=num"
تعداد ثبات‌هایی را که برای ارسال آرگومان‌های عدد صحیح استفاده می‌شوند کنترل می‌کند. به‌طور پیش‌فرض، هیچ ثباتی برای ارسال آرگومان‌ها استفاده نمی‌شود و حداکثر می‌توان از ۳ ثبات استفاده کرد. می‌توانید این رفتار را برای یک تابع خاص با استفاده از مشخصهٔ تابع \f(CW\*(C`regparm\*(C'\fR کنترل کنید.
.Sp
\&\fBهشدار:\fR اگر از این سوییچ استفاده کنید و مقدار \&\fInum\fR غیرصفر باشد، باید تمام پودمان‌ها، از جمله تمامی کتابخانه‌ها را با همان مقدار بسازید. این امر شامل کتابخانه‌های سیستم و پودمان‌های راه‌اندازی (startup modules) نیز می‌شود.
.IP \fB\-msseregparm\fR 4
.IX Item "-msseregparm"
از قراردادهای ارسال با ثبات SSE برای آرگومان‌ها و مقادیر بازگشتی نوع float و double استفاده می‌کند. می‌توانید این رفتار را برای یک تابع خاص با استفاده از مشخصهٔ تابع \f(CW\*(C`sseregparm\*(C'\fR کنترل کنید.
.Sp
\&\fBهشدار:\fR در صورت استفاده از این سوییچ، باید تمام پودمان‌ها، از جمله تمامی کتابخانه‌ها را با همان مقدار بسازید. این امر شامل کتابخانه‌های سیستم و پودمان‌های راه‌اندازی نیز می‌شود.
.IP \fB\-mvect8\-ret\-in\-mem\fR 4
.IX Item "-mvect8-ret-in-mem"
بردارهای ۸ بایتی را به جای ثبات‌های MMX در حافظه بازمی‌گرداند. این حالت پیش‌فرض در VxWorks است تا با ABI کامپایلرهای Sun Studio تا نسخهٔ ۱۲ مطابقت داشته باشد. \fIفقط\fR در صورتی از این گزینه استفاده کنید که نیاز به حفظ سازگاری با کدهای موجودِ تولیدشده توسط آن نسخه‌های قبلی کامپایلر یا نسخه‌های قدیمی‌تر GCC داشته باشید.
.IP \fB\-mpc32\fR 4
.IX Item "-mpc32"
.PD 0
.IP \fB\-mpc64\fR 4
.IX Item "-mpc64"
.IP \fB\-mpc80\fR 4
.IX Item "-mpc80"
.PD
دقت ممیز شناور 80387 را روی ۳۲، ۶۴ یا ۸۰ بیت تنظیم می‌کند. هنگامی که \fB\-mpc32\fR مشخص شده باشد، معنادار (significand) نتایج محاسبات ممیز شناور به ۲۴ بیت گرد می‌شود (دقت تکی یا single precision)؛ گزینهٔ \fB\-mpc64\fR معنادار نتایج محاسبات ممیز شناور را به ۵۳ بیت گرد می‌کند (دقت دوگانه یا double precision) و \fB\-mpc80\fR معنادار نتایج محاسبات ممیز شناور را به ۶۴ بیت گرد می‌کند (دقت دوگانهٔ گسترش‌یافته یا extended double precision) که حالت پیش‌فرض است. هنگامی که از این گزینه استفاده شود، محاسبات ممیز شناور با دقت‌های بالاتر بدون تنظیم صریح واژهٔ کنترل FPU (FPU control word) در دسترس برنامه‌نویس نخواهد بود.
.Sp
تنظیم گرد کردن محاسبات ممیز شناور به مقداری کمتر از ۸۰ بیت پیش‌فرض می‌تواند سرعت برخی برنامه‌ها را ۲٪ یا بیشتر افزایش دهد. توجه داشته باشید که برخی از کتابخانه‌های ریاضیاتی فرض می‌کنند که محاسبات ممیز شناور با دقت گسترش‌یافته (۸۰ بیتی) به‌طور پیش‌فرض فعال است؛ بنابراین روتین‌های چنین کتابخانه‌هایی ممکن است در صورت استفاده از این گزینه برای تنظیم دقت روی مقداری کمتر از دقت گسترش‌یافته، به‌طور قابل توجهی دچار افت دقت شوند که معمولاً به دلیل پدیده‌ای موسوم به «حذف فاجعه‌بار» (catastrophic cancellation) رخ می‌دهد.
.IP \fB\-mdaz\-ftz\fR 4
.IX Item "-mdaz-ftz"
.PD 0
.IP \fB\-mno\-daz\-ftz\fR 4
.IX Item "-mno-daz-ftz"
.PD
پرچم‌های flush\-to\-zero (FTZ) و denormals\-are\-zero (DAZ) در ثبات MXCSR برای کنترل محاسبات ممیز شناور به کار می‌روند. گزینه‌های \&\fB\-Ofast\fR، \fB\-ffast\-math\fR یا \&\fB\-funsafe\-math\-optimizations\fR معمولاً کدهای راه‌اندازی‌ای (startup code) را پیوند می‌دهند که این پرچم‌ها را تنظیم می‌کند، مگر در هنگام ساخت یک کتابخانهٔ مشترک (\fB\-shared\fR). می‌توانید از گزینه‌های \fB\-mdaz\-ftz\fR و \&\fB\-mno\-daz\-ftz\fR برای فعال یا غیرفعال کردن صریح تنظیم این پرچم‌ها، صرف نظر از سایر گزینه‌های ارائه‌شده به GCC استفاده کنید.
.IP \fB\-mstackrealign\fR 4
.IX Item "-mstackrealign"
هم‌ترازی مجدد پشته در بدو ورود. در x86، گزینهٔ \fB\-mstackrealign\fR یک مقدمه (prologue) و مؤخره (epilogue) جایگزین تولید می‌کند که در صورت نیاز، پشتهٔ زمان اجرا را مجدداً هم‌تراز می‌سازد. این کار از ادغام کدهای قدیمی که هم‌ترازی پشتهٔ ۴ بایتی را حفظ می‌کنند با کدهای نوین که هم‌ترازی پشتهٔ ۱۶ بایتی را برای سازگاری با SSE حفظ می‌کنند، پشتیبانی می‌کند. همچنین مشخصهٔ \f(CW\*(C`force_align_arg_pointer\*(C'\fR را ببینید که برای توابع منفرد قابل اعمال است.
.IP \fB\-mstack\-arg\-probe\fR 4
.IX Item "-mstack-arg-probe"
کد کاوش پشته (stack probing code) را در مقدمهٔ تابع تولید می‌کند.
.IP \fB\-mpreferred\-stack\-boundary=\fR\fInum\fR 4
.IX Item "-mpreferred-stack-boundary=num"
تلاش می‌کند مرز پشته را هم‌تراز با مضارب ۲ به توان \fInum\fR بایت نگه دارد. اگر \fB\-mpreferred\-stack\-boundary\fR مشخص نشده باشد، مقدار پیش‌فرض ۴ (۱۶ بایت یا ۱۲۸ بیت) است.
.Sp
\&\fBهشدار:\fR هنگام تولید کد برای معماری x86\-64 در حالی که افزونه‌های SSE غیرفعال هستند، می‌توان از \fB\-mpreferred\-stack\-boundary=3\fR برای هم‌تراز نگه داشتن مرز پشته با مضارب ۸ بایت استفاده کرد. از آنجا که ABI در معماری x86\-64 نیازمند هم‌ترازی ۱۶ بایتی پشته است، این کار موجب ناسازگاری با ABI می‌شود و برای استفاده در محیط‌های کنترل‌شده‌ای در نظر گرفته شده که فضای پشته در آن‌ها محدودیتی اساسی است. این گزینه زمانی که توابع کامپایل‌شده با هم‌ترازی ۱۶ بایتی پشته (مانند توابع یک کتابخانهٔ استاندارد) با پشتهٔ غیرهم‌تراز فراخوانی شوند، به تولید کدهای اشتباه منجر می‌شود. در این حالت، دستورالعمل‌های SSE ممکن است باعث بروز تله‌های دسترسی غیرهم‌تراز به حافظه (misaligned memory access traps) شوند. علاوه بر این، آرگومان‌های متغیر برای شیءهای با هم‌ترازی ۱۶ بایتی (از جمله x87 long double و _\|_int128) به‌طور نادرست مدیریت می‌شوند که به نتایج اشتباه می‌انجامد. شما باید تمام پودمان‌ها، از جمله همهٔ کتابخانه‌ها را با \&\fB\-mpreferred\-stack\-boundary=3\fR بسازید. این امر کتابخانه‌های سیستم و پودمان‌های راه‌اندازی را نیز شامل می‌شود.
.IP \fB\-mincoming\-stack\-boundary=\fR\fInum\fR 4
.IX Item "-mincoming-stack-boundary=num"
فرض می‌کند پشتهٔ ورودی با مضارب ۲ به توان \fInum\fR بایت هم‌تراز شده است. اگر \fB\-mincoming\-stack\-boundary\fR مشخص نشود، از مقدار تعیین‌شده توسط \fB\-mpreferred\-stack\-boundary\fR استفاده می‌شود.
.Sp
در پردازنده‌های Pentium و Pentium Pro، مقادیر \f(CW\*(C`double\*(C'\fR و \f(CW\*(C`long double\*(C'\fR باید با مرز ۸ بایتی هم‌تراز شوند (نگاه کنید به \fB\-malign\-double\fR)، در غیر این صورت دچار افت شدید کارایی در زمان اجرا خواهند شد. در Pentium III، ممکن است نوع دادهٔ Streaming SIMD Extension (SSE) موسوم به \f(CW\*(C`_\|_m128\*(C'\fR در صورت عدم هم‌ترازی ۱۶ بایتی به‌درستی کار نکند.
.Sp
برای اطمینان از هم‌ترازی صحیح این مقادیر روی پشته، مرز پشته باید به اندازه‌ای که هر مقدار ذخیره‌شده روی آن نیاز دارد هم‌تراز باشد. علاوه بر این، هر تابع باید به‌گونه‌ای تولید شود که پشته را هم‌تراز نگه دارد. از این رو فراخوانی تابعی که با مرز ترجیحی پشتهٔ بالاتری کامپایل شده از تابعی با مرز ترجیحی پشتهٔ پایین‌تر، به احتمال زیاد پشته را از حالت هم‌تراز خارج می‌سازد. توصیه می‌شود کتابخانه‌هایی که از توابع بازفراخوانی (callback) استفاده می‌کنند، همواره از تنظیمات پیش‌فرض بهره ببرند.
.Sp
این هم‌ترازیِ افزوده، فضای پشتهٔ بیشتری مصرف کرده و عموماً حجم کد را افزایش می‌دهد. کدهایی که به مصرف فضای پشته حساس هستند، مانند سامانه‌های تعبیه‌شده (embedded systems) و هسته‌های سیستم‌عامل، ممکن است مایل باشند هم‌ترازی ترجیحی را به \fB\-mpreferred\-stack\-boundary=2\fR کاهش دهند.
.IP \fB\-mdump\-tune\-features\fR 4
.IX Item "-mdump-tune-features"
این گزینه به GCC دستور می‌دهد تا نام ویژگی‌های تنظیم کارایی x86 و تنظیمات پیش‌فرض آن‌ها را تخلیه (dump) کند. این نام‌ها می‌توانند در \&\fB\-mtune\-ctrl=\fR\fIfeature\-list\fR به کار روند..IP \fB\-mtune\-ctrl=\fR\fIfeature\-list\fR 4
.IX Item "-mtune-ctrl=feature-list"
این گزینه برای کنترل دقیق و ریزدانه‌ای ویژگی‌های تولید کد x86 استفاده می‌شود.
\&\fIfeature\-list\fR فهرستی جداشده با کاما از نام‌های \fIfeature\fR است. همچنین
\&\fB\-mdump\-tune\-features\fR را ببینید. هنگام مشخص شدن، \fIfeature\fR فعال می‌شود اگر
پیش از آن \fB^\fR نیامده باشد؛ در غیر این صورت، غیرفعال می‌گردد.
\&\fB\-mtune\-ctrl=\fR\fIfeature\-list\fR برای استفاده توسط توسعه‌دهندگان GCC در نظر
گرفته شده است. استفاده از آن ممکن است به مسیرهای کدی منجر شود که با آزمایش‌ها پوشش
داده نشده‌اند و به‌طور بالقوه می‌تواند موجب خطاهای ICE کامپایلر یا خطاهای زمان اجرا شود.
.IP \fB\-mno\-default\fR 4
.IX Item "-mno-default"
این گزینه به GCC دستور می‌دهد که تمام ویژگی‌های قابل‌تنظیم را خاموش کند. همچنین
\&\fB\-mtune\-ctrl=\fR\fIfeature\-list\fR و \fB\-mdump\-tune\-features\fR را ببینید.
.IP \fB\-mcld\fR 4
.IX Item "-mcld"
این گزینه به GCC دستور می‌دهد تا یک دستورالعمل \f(CW\*(C`cld\*(C'\fR را در پیش‌درآمد (prologue)
توابعی که از دستورالعمل‌های رشته‌ای استفاده می‌کنند، صادر کند. دستورالعمل‌های رشته‌ای
برای انتخاب بین حالت افزایش خودکار یا کاهش خودکار به پرچم DF وابسته هستند. در حالی
که ABI مشخص می‌کند که پرچم DF باید در هنگام ورود به تابع پاک شود، برخی از سیستم‌عامل‌ها
با پاک نکردن پرچم DF در توزیع‌کننده‌های استثنای (exception dispatchers) خود، این مشخصات را نقض
می‌کنند. گردانندهٔ استثنا ممکن است با پرچم DFِ تنظیم‌شده فراخوانی شود که هنگام استفاده
از دستورالعمل‌های رشته‌ای به حالت جهت‌یابی اشتباه منجر می‌شود.
این گزینه می‌تواند با پیکربندی GCC از طریق گزینهٔ پیکربندی \fB\-\-enable\-cld\fR،
به‌طور پیش‌فرض روی اهداف ۳۲ بیتی x86 فعال شود. تولید دستورالعمل‌های \f(CW\*(C`cld\*(C'\fR
در این حالت می‌تواند با گزینهٔ کامپایلر \fB\-mno\-cld\fR متوقف شود.
.IP \fB\-mvzeroupper\fR 4
.IX Item "-mvzeroupper"
این گزینه به GCC دستور می‌دهد تا قبل از انتقال جریان کنترل به خارج از تابع، یک
دستورالعمل \f(CW\*(C`vzeroupper\*(C'\fR صادر کند تا جریمهٔ انتقال از AVX به SSE را به
حداقل رسانده و همچنین ذاتی‌های (intrinsics) غیرضروری \f(CW\*(C`zeroupper\*(C'\fR را حذف کند.
.IP \fB\-mstv\fR 4
.IX Item "-mstv"
.PD 0
.IP \fB\-mno\-stv\fR 4
.IX Item "-mno-stv"
.PD
فعال/غیرفعال‌سازی گذرگاه تبدیل اسکالر به برداری (Scalar to Vectorization pass) که محاسبات
عدد صحیح ۶۴ بیتی را به محاسبات برداری تبدیل می‌کند. این بهینه‌سازی به
\&\fB\-O2\fR و بالاتر محدود شده است.
.IP \fB\-mprefer\-avx128\fR 4
.IX Item "-mprefer-avx128"
این گزینه به GCC دستور می‌دهد تا در برداری‌ساز خودکار (auto\-vectorizer) به جای
دستورالعمل‌های ۲۵۶ بیتی AVX، از دستورالعمل‌های ۱۲۸ بیتی AVX استفاده کند.
.IP \fB\-mprefer\-vector\-width=\fR\fIopt\fR 4
.IX Item "-mprefer-vector-width=opt"
این گزینه به GCC دستور می‌دهد تا در دستورالعمل‌ها به جای عرض پیش‌فرض در سکوی انتخابی،
از پهنای بردار \fIopt\fR بیتی استفاده کند.
.IP \fB\-mpartial\-vector\-fp\-math\fR 4
.IX Item "-mpartial-vector-fp-math"
.PD 0
.IP \fB\-mno\-partial\-vector\-fp\-math\fR 4
.IX Item "-mno-partial-vector-fp-math"
.PD
این گزینه به GCC امکان می‌دهد تا عملیات ممیز شناوری تولید کند که ممکن است بر
مجموعه پرچم‌های وضعیت ممیز شناور روی بردارهای جزئی اثر بگذارد؛ جایی که عناصر
بردار در بخش پایینی ثبات ۱۲۸ بیتی SSE قرار دارند. مگر اینکه
\&\fB\-fno\-trapping\-math\fR مشخص شده باشد، کامپایلر با پاک‌سازی تمام عملوندهای ورودی
به‌گونه‌ای که در بخش بالاییِ استفاده‌نشده ثبات برداری صفر داشته باشند، رفتار صحیح را تضمین
می‌کند. توجه داشته باشید که با استفاده از توابع درونی یا اسمبلی برخط (inline assembly)
با آرگومان‌های بردار جزئی، مقادیر NaN، غیرعادی (denormal) یا نامعتبر می‌توانند به بخش
بالایی بردار نشت کرده و در صورت فعال بودن \fB\-fno\-trapping\-math\fR، مشکلات احتمالی
در کارایی ایجاد کنند. این مشکلات را می‌توان با پاک‌سازی دستی بخش بالایی ثبات آرگومان
بردار جزئی یا با استفاده از \fB\-mdaz\-ftz\fR برای تنظیم پرچم DAZ (مخفف denormals\-are\-zero)
در ثبات MXCSR کاهش داد.
.Sp
این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-mmove\-max=\fR\fIbits\fR 4
.IX Item "-mmove-max=bits"
این گزینه به GCC دستور می‌دهد تا حداکثر تعداد بیت‌هایی را که می‌توان به‌طور کارآمد از
حافظه به حافظه منتقل کرد روی \fIbits\fR تنظیم کند. مقادیر معتبر
\&\fIbits\fR شامل 128، 256 و 512 است.
.IP \fB\-mstore\-max=\fR\fIbits\fR 4
.IX Item "-mstore-max=bits"
این گزینه به GCC دستور می‌دهد تا حداکثر تعداد بیت‌هایی را که می‌توان به‌طور کارآمد در
حافظه ذخیره کرد روی \fIbits\fR تنظیم کند. مقادیر معتبر \fIbits\fR شامل
128، 256 و 512 است.
.RS 4
.IP \fBnone\fR 4
.IX Item "none"
هیچ محدودیت اضافی فراتر از آنچه توسط سکوی انتخابی تعریف شده به GCC اعمال نمی‌شود.
.IP \fB128\fR 4
.IX Item "128"
ترجیح پهنای بردار ۱۲۸ بیتی برای دستورالعمل‌ها.
.IP \fB256\fR 4
.IX Item "256"
ترجیح پهنای بردار ۲۵۶ بیتی برای دستورالعمل‌ها.
.IP \fB512\fR 4
.IX Item "512"
ترجیح پهنای بردار ۵۱۲ بیتی برای دستورالعمل‌ها.
.RE
.RS 4
.RE
.IP \fB\-mnoreturn\-no\-callee\-saved\-registers\fR 4
.IX Item "-mnoreturn-no-callee-saved-registers"
این گزینه توابع دارای ویژگی \f(CW\*(C`noreturn\*(C'\fR یا مشخص‌کنندهٔ
\&\f(CW\*(C`_Noreturn\*(C'\fR را از طریق ذخیره نکردن ثبات‌های callee\-saved استفاده‌شده در تابع
در پیش‌درآمد تابع (به جز ثبات \f(CW\*(C`BP\*(C'\fR) بهینه‌سازی می‌کند. این گزینه می‌تواند
در اشکال‌زدایی فراخوانندهٔ تابع \f(CW\*(C`noreturn\*(C'\fR یا هر تابعی بالاتر در پشتهٔ فراخوانی
تداخل ایجاد کند، بنابراین به‌طور پیش‌فرض فعال نیست.
.IP \fB\-mcx16\fR 4
.IX Item "-mcx16"
این گزینه به GCC امکان می‌دهد تا دستورالعمل‌های \f(CW\*(C`CMPXCHG16B\*(C'\fR را در کد ۶۴ بیتی
برای پیاده‌سازی عملیات مقایسه-و-تبادل (compare\-and\-exchange) روی اشیای ۱۲۸ بیتی
تراز‌شده در ۱۶ بایت تولید کند. این برای به‌روزرسانی‌های اتمیک ساختارهای داده‌ای که
اندازهٔ آن‌ها از یک کلمهٔ ماشین بیشتر است مفید است. کامپایلر از این دستورالعمل برای
پیاده‌سازی \fB_\|_sync Builtins\fR استفاده می‌کند. با این حال، برای \fB_\|_atomic Builtins\fR
که روی اعداد صحیح ۱۲۸ بیتی عمل می‌کنند، همیشه از یک فراخوانی کتابخانه‌ای استفاده می‌شود.
.IP \fB\-msahf\fR 4
.IX Item "-msahf"
این گزینه تولید دستورالعمل‌های \f(CW\*(C`SAHF\*(C'\fR را در کد ۶۴ بیتی فعال می‌کند.
پردازنده‌های اولیهٔ Intel Pentium 4 با پشتیبانی از Intel 64، پیش از معرفی
گام Pentium 4 G1 در دسامبر ۲۰۰۵، فاقد دستورالعمل‌های \f(CW\*(C`LAHF\*(C'\fR و
\&\f(CW\*(C`SAHF\*(C'\fR بودند که توسط AMD64 پشتیبانی می‌شوند.
این‌ها به‌ترتیب دستورالعمل‌های بارگذاری و ذخیره‌سازی برای برخی پرچم‌های وضعیت هستند.
در حالت ۶۴ بیتی، دستورالعمل \f(CW\*(C`SAHF\*(C'\fR برای بهینه‌سازی توابع درونی \f(CW\*(C`fmod\*(C'\fR،
\&\f(CW\*(C`drem\*(C'\fR و \f(CW\*(C`remainder\*(C'\fR استفاده می‌شود؛
برای جزئیات بیشتر \fBOther Builtins\fR را ببینید.
.IP \fB\-mmovbe\fR 4
.IX Item "-mmovbe"
این گزینه استفاده از دستورالعمل \f(CW\*(C`movbe\*(C'\fR را برای بهینه‌سازی تعویض بایت (byte swapping)
موجودیت‌های چهار و هشت بایتی فعال می‌کند.
.IP \fB\-mshstk\fR 4
.IX Item "-mshstk"
گزینهٔ \fB\-mshstk\fR توابع درونی پشتهٔ سایه (shadow stack) را از فناوری اعمال جریان کنترل
(CET) در x86 فعال می‌کند.
.IP \fB\-mcrc32\fR 4
.IX Item "-mcrc32"
این گزینه به توابع درونی \f(CW\*(C`_\|_builtin_ia32_crc32qi\*(C'\fR،
\&\f(CW\*(C`_\|_builtin_ia32_crc32hi\*(C'\fR، \f(CW\*(C`_\|_builtin_ia32_crc32si\*(C'\fR و
\&\f(CW\*(C`_\|_builtin_ia32_crc32di\*(C'\fR امکان می‌دهد تا دستورالعمل ماشین \f(CW\*(C`crc32\*(C'\fR را تولید کنند.
.IP \fB\-mmwait\fR 4
.IX Item "-mmwait"
این گزینه به توابع درونی \f(CW\*(C`_\|_builtin_ia32_monitor\*(C'\fR و
\&\f(CW\*(C`_\|_builtin_ia32_mwait\*(C'\fR امکان می‌دهد تا دستورالعمل‌های ماشین \f(CW\*(C`monitor\*(C'\fR و
\&\f(CW\*(C`mwait\*(C'\fR را تولید کنند.
.IP \fB\-mrecip\fR 4
.IX Item "-mrecip"
این گزینه استفاده از دستورالعمل‌های \f(CW\*(C`RCPSS\*(C'\fR و \f(CW\*(C`RSQRTSS\*(C'\fR
(و انواع برداری‌شدهٔ آن‌ها \f(CW\*(C`RCPPS\*(C'\fR و \f(CW\*(C`RSQRTPS\*(C'\fR)
همراه با یک گام اضافی نیوتن-رافسون (Newton\-Raphson) را برای افزایش دقت،
به جای \f(CW\*(C`DIVSS\*(C'\fR و \f(CW\*(C`SQRTSS\*(C'\fR (و انواع برداری‌شدهٔ آن‌ها)
برای آرگومان‌های ممیز شناور با دقت یگانه فعال می‌کند. این دستورالعمل‌ها
تنها زمانی تولید می‌شوند که \fB\-funsafe\-math\-optimizations\fR همراه با
\&\fB\-ffinite\-math\-only\fR و \fB\-fno\-trapping\-math\fR فعال باشد.
توجه داشته باشید اگرچه توان عملیاتی این توالی بالاتر از توان عملیاتی
دستورالعمل غیرمعکوس است، اما دقت توالی می‌تواند تا ۲ ulp کاهش یابد
(یعنی معکوس ۱٫۰ برابر است با ۰٫۹۹۹۹۹۹۹۴).
.Sp
توجه داشته باشید که GCC عبارت \f(CW\*(C`1.0f/sqrtf(\fR\f(CIx\fR\f(CW)\*(C'\fR را
با استفاده از \f(CW\*(C`RSQRTSS\*(C'\fR (یا \f(CW\*(C`RSQRTPS\*(C'\fR) حتی تنها با
\&\fB\-ffast\-math\fR (یا ترکیب گزینه‌های فوق) پیاده‌سازی می‌کند و نیازی
به \fB\-mrecip\fR ندارد.
.Sp
همچنین توجه داشته باشید که GCC توالی فوق را همراه با گام اضافی نیوتن-رافسون
برای تقسیم ممیز شناورِ یگانهٔ برداری‌شده و \f(CWsqrtf(\fR\f(CIx\fR\f(CW)\fR برداری‌شده
حتی تنها با \fB\-ffast\-math\fR (یا ترکیب گزینه‌های فوق) صادر می‌کند و نیازی
به \fB\-mrecip\fR ندارد.
.IP \fB\-mrecip=\fR\fIopt\fR 4
.IX Item "-mrecip=opt"
این گزینه مشخص می‌کند که از کدام دستورالعمل‌های برآورد معکوس (reciprocal estimate)
می‌توان استفاده کرد. \fIopt\fR فهرستی جداشده با کاما از گزینه‌هاست که می‌تواند
برای معکوس کردن گزینه، با یک \fB!\fR آغاز شود:
.RS 4
.IP \fBall\fR 4
.IX Item "all"
فعال‌سازی تمام دستورالعمل‌های برآورد.
.IP \fBdefault\fR 4
.IX Item "default"
فعال‌سازی دستورالعمل‌های پیش‌فرض، معادل \fB\-mrecip\fR.
.IP \fBnone\fR 4
.IX Item "none"
غیرفعال‌سازی تمام دستورالعمل‌های برآورد، معادل \fB\-mno\-recip\fR.
.IP \fBdiv\fR 4
.IX Item "div"
فعال‌سازی تقریب برای تقسیم اسکالر..IP \fBvec\-div\fR 4
.IX Item "vec-div"
فعال‌سازی تقریب برای تقسیم برداری‌شده.
.IP \fBsqrt\fR 4
.IX Item "sqrt"
فعال‌سازی تقریب برای ریشه دوم اسکالر.
.IP \fBvec\-sqrt\fR 4
.IX Item "vec-sqrt"
فعال‌سازی تقریب برای ریشه دوم برداری‌شده.
.RE
.RS 4
.Sp
بنابراین، برای مثال، \fB\-mrecip=all,!sqrt\fR تمام
تقریب‌های معکوس را، به جز ریشه دوم، فعال می‌کند.
.RE
.IP \fB\-mveclibabi=\fR\fItype\fR 4
.IX Item "-mveclibabi=type"
نوع ABI مورد استفاده برای برداری‌سازی توابع درونی (intrinsics) با استفاده از یک کتابخانه
خارجی را مشخص می‌کند. مقادیر پشتیبانی‌شده برای \fItype\fR عبارتند از \fBsvml\fR برای کتابخانه ریاضی
بردار کوتاه Intel، ‏\fBaocl\fR برای کتابخانه ریاضی (LibM) متعلق به AMD
Optimizing CPU Libraries (AOCL) و \fBacml\fR برای کتابخانه ریاضی پایه منسوخ‌شده AMD
(که AOCL\-LibM جانشین آن است).
برای استفاده از این گزینه، باید هر دو گزینه \fB\-ftree\-vectorize\fR و
\&\fB\-funsafe\-math\-optimizations\fR فعال باشند، و یک کتابخانه سازگار با ABI مربوط به SVML
یا ACML در زمان پیوند مشخص شود.
.Sp
در حال حاضر GCC فراخوانی‌هایی را به \f(CW\*(C`vmldExp2\*(C'\fR، \f(CW\*(C`vmldLn2\*(C'\fR،
\&\f(CW\*(C`vmldLog102\*(C'\fR، \f(CW\*(C`vmldPow2\*(C'\fR، \f(CW\*(C`vmldTanh2\*(C'\fR، \f(CW\*(C`vmldTan2\*(C'\fR،
\&\f(CW\*(C`vmldAtan2\*(C'\fR، \f(CW\*(C`vmldAtanh2\*(C'\fR، \f(CW\*(C`vmldCbrt2\*(C'\fR، \f(CW\*(C`vmldSinh2\*(C'\fR،
\&\f(CW\*(C`vmldSin2\*(C'\fR، \f(CW\*(C`vmldAsinh2\*(C'\fR، \f(CW\*(C`vmldAsin2\*(C'\fR، \f(CW\*(C`vmldCosh2\*(C'\fR،
\&\f(CW\*(C`vmldCos2\*(C'\fR، \f(CW\*(C`vmldAcosh2\*(C'\fR، \f(CW\*(C`vmldAcos2\*(C'\fR، \f(CW\*(C`vmlsExp4\*(C'\fR،
\&\f(CW\*(C`vmlsLn4\*(C'\fR، \f(CW\*(C`vmlsLog104\*(C'\fR، \f(CW\*(C`vmlsPow4\*(C'\fR، \f(CW\*(C`vmlsTanh4\*(C'\fR،
\&\f(CW\*(C`vmlsTan4\*(C'\fR، \f(CW\*(C`vmlsAtan4\*(C'\fR، \f(CW\*(C`vmlsAtanh4\*(C'\fR، \f(CW\*(C`vmlsCbrt4\*(C'\fR،
\&\f(CW\*(C`vmlsSinh4\*(C'\fR، \f(CW\*(C`vmlsSin4\*(C'\fR، \f(CW\*(C`vmlsAsinh4\*(C'\fR، \f(CW\*(C`vmlsAsin4\*(C'\fR،
\&\f(CW\*(C`vmlsCosh4\*(C'\fR، \f(CW\*(C`vmlsCos4\*(C'\fR، \f(CW\*(C`vmlsAcosh4\*(C'\fR و \f(CW\*(C`vmlsAcos4\*(C'\fR برای
نوع تابع متناظر در هنگام استفاده از \fB\-mveclibabi=svml\fR،
و \f(CW\*(C`amd_vrs4_acosf\*(C'\fR، \f(CW\*(C`amd_vrs16_acosf\*(C'\fR، \f(CW\*(C`amd_vrd8_asin\*(C'\fR،
\&\f(CW\*(C`amd_vrs4_asinf\*(C'\fR، \f(CW\*(C`amd_vrs8_asinf\*(C'\fR، \f(CW\*(C`amd_vrs16_asinf\*(C'\fR،
\&\f(CW\*(C`amd_vrd2_atan\*(C'\fR، \f(CW\*(C`amd_vrd8_atan\*(C'\fR، \f(CW\*(C`amd_vrs4_atanf\*(C'\fR،
\&\f(CW\*(C`amd_vrs8_atanf\*(C'\fR، \f(CW\*(C`amd_vrs16_atanf\*(C'\fR، \f(CW\*(C`amd_vrd2_cos\*(C'\fR،
\&\f(CW\*(C`amd_vrd4_cos\*(C'\fR، \f(CW\*(C`amd_vrd8_cos\*(C'\fR، \f(CW\*(C`amd_vrs4_cosf\*(C'\fR،
\&\f(CW\*(C`amd_vrs8_cosf\*(C'\fR، \f(CW\*(C`amd_vrs16_cosf\*(C'\fR، \f(CW\*(C`amd_vrs4_coshf\*(C'\fR،
\&\f(CW\*(C`amd_vrs8_coshf\*(C'\fR، \f(CW\*(C`amd_vrd2_erf\*(C'\fR، \f(CW\*(C`amd_vrd4_erf\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_erf\*(C'\fR، \f(CW\*(C`amd_vrs4_erff\*(C'\fR، \f(CW\*(C`amd_vrs8_erff\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_erff\*(C'\fR، \f(CW\*(C`amd_vrd2_exp\*(C'\fR، \f(CW\*(C`amd_vrd4_exp\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_exp\*(C'\fR، \f(CW\*(C`amd_vrs4_expf\*(C'\fR، \f(CW\*(C`amd_vrs8_expf\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_expf\*(C'\fR، \f(CW\*(C`amd_vrd2_exp10\*(C'\fR، \f(CW\*(C`amd_vrs4_exp10f\*(C'\fR،
\&\f(CW\*(C`amd_vrd2_exp2\*(C'\fR، \f(CW\*(C`amd_vrd4_exp2\*(C'\fR، \f(CW\*(C`amd_vrd8_exp2\*(C'\fR،
\&\f(CW\*(C`amd_vrs4_exp2f\*(C'\fR، \f(CW\*(C`amd_vrs8_exp2f\*(C'\fR، \f(CW\*(C`amd_vrs16_exp2f\*(C'\fR،
\&\f(CW\*(C`amd_vrs4_expm1f\*(C'\fR، \f(CW\*(C`amd_vrd2_log\*(C'\fR، \f(CW\*(C`amd_vrd4_log\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_log\*(C'\fR، \f(CW\*(C`amd_vrs4_logf\*(C'\fR، \f(CW\*(C`amd_vrs8_logf\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_logf\*(C'\fR، \f(CW\*(C`amd_vrd2_log10\*(C'\fR، \f(CW\*(C`amd_vrs4_log10f\*(C'\fR،
\&\f(CW\*(C`amd_vrs8_log10f\*(C'\fR، \f(CW\*(C`amd_vrs16_log10f\*(C'\fR، \f(CW\*(C`amd_vrd2_log1p\*(C'\fR،
\&\f(CW\*(C`amd_vrs4_log1pf\*(C'\fR، \f(CW\*(C`amd_vrd2_log2\*(C'\fR، \f(CW\*(C`amd_vrd4_log2\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_log2\*(C'\fR، \f(CW\*(C`amd_vrs4_log2f\*(C'\fR، \f(CW\*(C`amd_vrs8_log2f\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_log2f\*(C'\fR، \f(CW\*(C`amd_vrd2_pow\*(C'\fR، \f(CW\*(C`amd_vrd4_pow\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_pow\*(C'\fR، \f(CW\*(C`amd_vrs4_powf\*(C'\fR، \f(CW\*(C`amd_vrs8_powf\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_powf\*(C'\fR، \f(CW\*(C`amd_vrd2_sin\*(C'\fR، \f(CW\*(C`amd_vrd4_sin\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_sin\*(C'\fR، \f(CW\*(C`amd_vrs4_sinf\*(C'\fR، \f(CW\*(C`amd_vrs8_sinf\*(C'\fR،
\&\f(CW\*(C`amd_vrs16_sinf\*(C'\fR، \f(CW\*(C`amd_vrd2_tan\*(C'\fR، \f(CW\*(C`amd_vrd4_tan\*(C'\fR،
\&\f(CW\*(C`amd_vrd8_tan\*(C'\fR، \f(CW\*(C`amd_vrs16_tanf\*(C'\fR، \f(CW\*(C`amd_vrs4_tanhf\*(C'\fR،
\&\f(CW\*(C`amd_vrs8_tanhf\*(C'\fR، \f(CW\*(C`amd_vrs16_tanhf\*(C'\fR برای نوع تابع متناظر
در هنگام استفاده از \fB\-mveclibabi=aocl\fR، و \f(CW\*(C`_\|_vrd2_sin\*(C'\fR،
\&\f(CW\*(C`_\|_vrd2_cos\*(C'\fR، \f(CW\*(C`_\|_vrd2_exp\*(C'\fR، \f(CW\*(C`_\|_vrd2_log\*(C'\fR، \f(CW\*(C`_\|_vrd2_log2\*(C'\fR،
\&\f(CW\*(C`_\|_vrd2_log10\*(C'\fR، \f(CW\*(C`_\|_vrs4_sinf\*(C'\fR، \f(CW\*(C`_\|_vrs4_cosf\*(C'\fR،
\&\f(CW\*(C`_\|_vrs4_expf\*(C'\fR، \f(CW\*(C`_\|_vrs4_logf\*(C'\fR، \f(CW\*(C`_\|_vrs4_log2f\*(C'\fR،
\&\f(CW\*(C`_\|_vrs4_log10f\*(C'\fR و \f(CW\*(C`_\|_vrs4_powf\*(C'\fR را برای نوع تابع متناظر
در هنگام استفاده از \fB\-mveclibabi=acml\fR ارسال می‌کند.
.IP \fB\-mabi=\fR\fIname\fR 4
.IX Item "-mabi=name"
تولید کد برای قرارداد فراخوانی (calling convention) مشخص‌شده. مقادیر مجاز عبارتند از
\fBsysv\fR برای ABI مورد استفاده در GNU/Linux و سایر سیستم‌ها، و
\&\fBms\fR برای Microsoft ABI. پیش‌فرض در صورت هدف قرار دادن Microsoft Windows، استفاده از
Microsoft ABI و در تمام سیستم‌های دیگر SysV ABI است.
شما می‌توانید این رفتار را برای توابع خاص با استفاده از ویژگی‌های تابع
\f(CW\*(C`ms_abi\*(C'\fR و \f(CW\*(C`sysv_abi\*(C'\fR کنترل کنید.
.IP \fB\-masm=\fR\fIdialect\fR 4
.IX Item "-masm=dialect"
خروجی دادن دستورالعمل‌های اسمبلی با استفاده از \fIdialect\fR (لهجه) انتخابی. همچنین بر این‌که
کدام لهجه برای \f(CW\*(C`asm\*(C'\fR پایه و
\f(CW\*(C`asm\*(C'\fR گسترش‌یافته استفاده شود اثر می‌گذارد. گزینه‌های پشتیبانی‌شده (به ترتیب
لهجه) \fBatt\fR یا \fBintel\fR هستند. پیش‌فرض \fBatt\fR است. Darwin از
\fBintel\fR پشتیبانی نمی‌کند.
.IP \fB\-mforce\-indirect\-call\fR 4
.IX Item "-mforce-indirect-call"
اجبار تمام فراخوانی‌های توابع به غیرمستقیم بودن (indirect). این گزینه هنگام استفاده
از Intel Processor Trace که اطلاعات زمان‌بندی دقیق‌تری را برای فراخوانی‌های تابع
تولید می‌کند، مفید است.
.IP \fB\-mmanual\-endbr\fR 4
.IX Item "-mmanual-endbr"
درج دستورالعمل ENDBR در مدخل تابع تنها از طریق ویژگی تابع
\f(CW\*(C`cf_check\*(C'\fR. این گزینه زمانی مفید است که همراه با گزینه
\&\fB\-fcf\-protection=branch\fR برای کنترل درج ENDBR در
مدخل تابع استفاده شود.
.IP \fB\-mcet\-switch\fR 4
.IX Item "-mcet-switch"
به‌طور پیش‌فرض، سنجش‌گری CET در دستورات switch که از
یک جدول پرش (jump table) استفاده می‌کنند خاموش است و ردیابی شاخه غیرمستقیم غیرفعال است. از آنجا
که جدول‌های پرش در حافظه فقط‌خواندنی ذخیره می‌شوند، این امر منجر به از دست رفتن مستقیم
مقاوم‌سازی نمی‌شود. اما اگر اندیس جدول پرش توسط مهاجم کنترل شود،
پرش غیرمستقیم ممکن است توسط CET محدود نگردد. این گزینه سنجش‌گری
CET را روشن می‌کند تا ردیابی شاخه غیرمستقیم را برای دستورات switch
با جدول‌های پرش فعال سازد، که باعث می‌شود مقاصد پرش از طریق هر پرش غیرمستقیمی
قابل دسترسی باشند.
.IP \fB\-mcall\-ms2sysv\-xlogues\fR 4
.IX Item "-mcall-ms2sysv-xlogues"
به دلیل تفاوت‌های موجود در ABIهای ۶۴\-بیتی، هر تابع Microsoft ABI که تابعی از
System V ABI را فراخوانی می‌کند، باید ثبات‌های RSI، RDI و XMM6\-15 را به عنوان مخدوش‌شده (clobbered) در نظر بگیرد. به‌طور
پیش‌فرض، کد ذخیره و بازیابی این ثبات‌ها به صورت درون‌خطی (inline) تولید می‌شود که
منجر به مقدمه‌ها (prologues) و موخره‌های (epilogues) نسبتاً طولانی می‌گردد. استفاده از
\&\fB\-mcall\-ms2sysv\-xlogues\fR مقدمه‌ها و موخره‌هایی تولید می‌کند که
برای انجام این ذخیره‌ها و بازیابی‌ها از stubها در بخش ایستان libgcc استفاده می‌کنند،
و بدین ترتیب اندازه تابع را با هزینه چند دستورالعمل اضافه کاهش می‌دهد.
.IP \fB\-mtls\-dialect=\fR\fItype\fR 4
.IX Item "-mtls-dialect=type"
تولید کد برای دسترسی به حافظه محلی نخ (thread\-local storage) با استفاده از قراردادهای \fBgnu\fR یا
\&\fBgnu2\fR. گزینه \fBgnu\fR پیش‌فرض محتاطانه است؛
\&\fBgnu2\fR کارآمدتر است، اما ممکن است نیازمندی‌های زمان کامپایل و زمان اجرایی را بیفزاید
که در همه سیستم‌ها قابل برآورده شدن نباشند.
.IP \fB\-mpush\-args\fR 4
.IX Item "-mpush-args"
.PD 0
.IP \fB\-mno\-push\-args\fR 4
.IX Item "-mno-push-args"
.PD
استفاده از عملیات PUSH برای ذخیره پارامترهای خروجی. این روش کوتاه‌تر است
و معمولاً سرعتی برابر با روش استفاده از عملیات SUB/MOV دارد و به‌طور پیش‌فرض
فعال است. در برخی موارد، غیرفعال کردن آن ممکن است به دلیل
زمان‌بندی بهبودیافته و کاهش وابستگی‌ها، کارایی را بهبود بخشد.
.IP \fB\-maccumulate\-outgoing\-args\fR 4
.IX Item "-maccumulate-outgoing-args"
در صورت فعال بودن، حداکثر مقدار فضای مورد نیاز برای آرگومان‌های خروجی در
مقدمه تابع (prologue) محاسبه می‌شود. این کار در اکثر پردازنده‌های مدرن به دلیل
کاهش وابستگی‌ها، زمان‌بندی بهبودیافته و کاهش استفاده از پشته در شرایطی
که مرز ترجیحی پشته برابر با ۲ نباشد سریع‌تر است. نکته منفی آن افزایش
قابل توجه در اندازه کد است. این سوئیچ متضمن \fB\-mno\-push\-args\fR است.
.IP \fB\-mms\-bitfields\fR 4
.IX Item "-mms-bitfields"
.PD 0
.IP \fB\-mno\-ms\-bitfields\fR 4
.IX Item "-mno-ms-bitfields"
.PD
فعال/غیرفعال کردن چینش میدان بیتی (bit\-field layout) سازگار با کامپایلر بومی
Microsoft Windows.
.Sp
اگر \f(CW\*(C`packed\*(C'\fR روی یک ساختار (structure) به کار رود، یا اگر از میدان‌های بیتی استفاده شود،
ممکن است Microsoft ABI ساختار را به گونه‌ای متفاوت
از شیوه معمول GCC سازمان‌دهی کند. به‌ویژه هنگام انتقال داده‌های فشرده‌شده (packed)
میان توابع کامپایل‌شده با GCC و کامپایلر بومی مایکروسافت
(خواه از طریق فراخوانی تابع یا به عنوان داده در یک فایل)، ممکن است دسترسی
به هر دو قالب ضروری باشد.
.Sp
این گزینه به‌طور پیش‌فرض برای اهداف Microsoft Windows
فعال است. این رفتار همچنین می‌تواند با استفاده از ویژگی‌های متغیر
یا نوع به‌طور محلی کنترل شود. برای اطلاعات بیشتر، \fBx86 Attributes\fR را ببینید.
.Sp
الگوریتم چینش ساختار مایکروسافت به استثنای
بسته‌بندی میدان‌های بیتی، نسبتاً ساده است.
فاصله‌گذاری (padding) و ترازسازی (alignment) اعضای ساختارها و اینکه آیا یک میدان بیتی
می‌تواند از مرز یک واحد ذخیره‌سازی عبور کند یا خیر، با این قوانین تعیین می‌شود:
.RS 4
.IP "1. اعضای ساختار به صورت متوالی و به ترتیبی که" 4
.IX Item "1. Structure members are stored sequentially in the order in which they are"
اعلان شده‌اند ذخیره می‌شوند: اولین عضو دارای کمترین نشانی حافظه و آخرین عضو
دارای بیشترین نشانی است.
.IP "2. هر شیء داده نیازمندی ترازسازی دارد. نیازمندی ترازسازی" 4
.IX Item "2. Every data object has an alignment requirement. The alignment requirement"
برای تمام داده‌ها به جز ساختارها، unionها و آرایه‌ها، یا اندازه
شیء است یا اندازه بسته‌بندی فعلی (که با ویژگی
\&\f(CW\*(C`aligned\*(C'\fR یا عملگر کاربردی \f(CW\*(C`pack\*(C'\fR مشخص می‌شود)،
هر کدام که کمتر باشد. برای ساختارها، unionها و آرایه‌ها،
نیازمندی ترازسازی، بزرگ‌ترین نیازمندی ترازسازی اعضای آن است.
به هر شیء یک انحراف (offset) اختصاص داده می‌شود به‌طوری که:
.Sp
.Vb 1
\&        offset % alignment_requirement == 0
.Ve
.IP "3. میدان‌های بیتی مجاور در یک واحد تخصیص ۱، ۲ یا ۴ بایتی بسته‌بندی" 4
.IX Item "3. Adjacent bit-fields are packed into the same 1-, 2-, or 4-byte allocation"
می‌شوند اگر انواع صحیح دارای اندازه یکسانی باشند و میدان بیتی بعدی بدون عبور
از مرز تحمیل‌شده توسط نیازمندی‌های ترازسازی مشترک میدان‌های بیتی،
در واحد تخصیص فعلی جای گیرد.
.RE
.RS 4
.Sp
کامپایلر MSVC میدان‌های بیتی با طول صفر را به روش‌های زیر تفسیر می‌کند:.IP "۱. اگر یک میدان بیتی با طول صفر بین دو میدان بیتی درج شود که" 4
.IX Item "1. If a zero-length bit-field is inserted between two bit-fields that"
به‌طور معمول ادغام می‌شوند، آن میدان‌های بیتی ادغام نخواهند شد.
.Sp
برای مثال:
.Sp
.Vb 6
\&        struct
\&         {
\&           unsigned long bf_1 : 12;
\&           unsigned long : 0;
\&           unsigned long bf_2 : 12;
\&         } t1;
.Ve
.Sp
اندازهٔ \f(CW\*(C`t1\*(C'\fR با وجود میدان بیتی با طول صفر برابر با ۸ بایت است. اگر این
میدان بیتی با طول صفر حذف شود، اندازهٔ \f(CW\*(C`t1\*(C'\fR برابر با ۴ بایت خواهد بود.
.ie n .IP "۲. اگر یک میدان بیتی با طول صفر پس از یک میدان بیتی، ""foo""، درج شود و" 4
.el .IP "۲. اگر یک میدان بیتی با طول صفر پس از یک میدان بیتی، \f(CWfoo\fR، درج شود و" 4
.IX Item "2. If a zero-length bit-field is inserted after a bit-field, foo, and the"
ترازبندی میدان بیتی با طول صفر بزرگ‌تر از عضوی باشد که پس از آن می‌آید،
\&\f(CW\*(C`bar\*(C'\fR، آن‌گاه \f(CW\*(C`bar\*(C'\fR مطابق با نوع میدان بیتی با طول صفر تراز می‌شود.
.Sp
برای مثال:
.Sp
.Vb 6
\&        struct
\&         {
\&           char foo : 4;
\&           short : 0;
\&           char bar;
\&         } t2;
\&        
\&        struct
\&         {
\&           char foo : 4;
\&           short : 0;
\&           double bar;
\&         } t3;
.Ve
.Sp
برای \f(CW\*(C`t2\*(C'\fR، عضو \f(CW\*(C`bar\*(C'\fR به جای افست ۱، در افست ۲ قرار می‌گیرد.
بر همین اساس، اندازهٔ \f(CW\*(C`t2\*(C'\fR برابر با ۴ است. برای \f(CW\*(C`t3\*(C'\fR، میدان بیتی با طول صفر
بر ترازبندی \f(CW\*(C`bar\*(C'\fR یا در نتیجه بر اندازهٔ ساختار تأثیری نمی‌گذارد.
.Sp
با در نظر گرفتن این موضوع، توجه به موارد زیر حائز اهمیت است:
.RS 4
.IP "۱. اگر یک میدان بیتی با طول صفر پس از یک میدان بیتی معمولی بیاید، نوعِ" 4
.IX Item "1. If a zero-length bit-field follows a normal bit-field, the type of the"
میدان بیتی با طول صفر ممکن است بر ترازبندی کل ساختار تأثیر بگذارد. برای
مثال، اندازهٔ \f(CW\*(C`t2\*(C'\fR برابر با ۴ بایت است، زیرا میدان بیتی با طول صفر پس از
یک میدان بیتی معمولی آمده و از نوع short است.
.IP "۲. حتی اگر پس از یک میدان بیتی با طول صفر یک میدان بیتی معمولی نیاید،" 4
.IX Item "2. Even if a zero-length bit-field is not followed by a normal bit-field,"
همچنان ممکن است بر ترازبندی ساختار تأثیر بگذارد:
.Sp
.Vb 5
\&        struct
\&         {
\&           char foo : 6;
\&           long : 0;
\&         } t4;
.Ve
.Sp
در اینجا، \f(CW\*(C`t4\*(C'\fR مقدار ۴ بایت فضا اشغال می‌کند.
.RE
.RS 4
.RE
.IP "۳. میدان‌های بیتی با طول صفر پس از اعضای غیر میدان بیتی نادیده گرفته می‌شوند:" 4
.IX Item "3. Zero-length bit-fields following non-bit-field members are ignored:"
.Vb 6
\&        struct
\&         {
\&           char foo;
\&           long : 0;
\&           char bar;
\&         } t5;
.Ve
.Sp
در اینجا، \f(CW\*(C`t5\*(C'\fR مقدار ۲ بایت فضا اشغال می‌کند.
.RE
.RS 4
.RE
.IP \fB\-mno\-align\-stringops\fR 4
.IX Item "-mno-align-stringops"
مقصد عملیات درون‌خطی‌شدهٔ رشته‌ای را تراز نمی‌کند. این سوییچ اندازهٔ کد را
کاهش داده و در صورتی که مقصد از پیش تراز شده باشد ولی GCC از آن مطلع نباشد،
کارایی را بهبود می‌بخشد.
.IP \fB\-minline\-all\-stringops\fR 4
.IX Item "-minline-all-stringops"
به‌طور پیش‌فرض، GCC تنها زمانی عملیات رشته‌ای را درون‌خطی می‌کند که مشخص
باشد مقصد حداقل روی یک مرز ۴ بایتی تراز شده است.
این گزینه امکان درون‌خطی‌سازی بیشتری را فراهم کرده و اندازهٔ کد را افزایش
می‌دهد، اما ممکن است کارایی کدهایی را که برای طول‌های کوتاه به \f(CW\*(C`memcpy\*(C'\fR
و \f(CW\*(C`memset\*(C'\fR سریع وابسته هستند، بهبود بخشد.
این گزینه بسط درون‌خطی \f(CW\*(C`strlen\*(C'\fR را برای تمامی ترازبندی‌های اشاره‌گر
فعال می‌سازد.
.IP \fB\-minline\-stringops\-dynamically\fR 4
.IX Item "-minline-stringops-dynamically"
برای عملیات رشته‌ای با اندازهٔ نامشخص، از بررسی‌های زمان اجرا به همراه کد
درون‌خطی برای بلوک‌های کوچک و فراخوانی کتابخانه برای بلوک‌های بزرگ استفاده می‌کند.
.IP \fB\-mstringop\-strategy=\fR\fIalg\fR 4
.IX Item "-mstringop-strategy=alg"
روش تصمیم‌گیری مکاشفه‌ای داخلی را برای الگوریتم خاص مورد استفاده جهت
درون‌خطی‌سازی عملیات رشته‌ای لغو و بازنویسی می‌کند. مقادیر مجاز برای \fIalg\fR عبارتند از:
.RS 4
.IP \fBrep_byte\fR 4
.IX Item "rep_byte"
.PD 0
.IP \fBrep_4byte\fR 4
.IX Item "rep_4byte"
.IP \fBrep_8byte\fR 4
.IX Item "rep_8byte"
.PD
بسط با استفاده از پیشوند \f(CW\*(C`rep\*(C'\fR در i386 برای اندازهٔ مشخص‌شده.
.IP \fBbyte_loop\fR 4
.IX Item "byte_loop"
.PD 0
.IP \fBloop\fR 4
.IX Item "loop"
.IP \fBunrolled_loop\fR 4
.IX Item "unrolled_loop"
.PD
بسط به یک حلقهٔ درون‌خطی.
.IP \fBlibcall\fR 4
.IX Item "libcall"
همیشه از فراخوانی کتابخانه‌ای استفاده شود.
.RE
.RS 4
.RE
.IP \fB\-mmemcpy\-strategy=\fR\fIstrategy\fR 4
.IX Item "-mmemcpy-strategy=strategy"
روش تصمیم‌گیری مکاشفه‌ای داخلی را جهت تعیین اینکه آیا
\&\f(CW\*(C`_\|_builtin_memcpy\*(C'\fR باید درون‌خطی شود یا خیر، و اینکه هنگام
مشخص بودن اندازهٔ مورد انتظار عملیات رونوشت از چه الگوریتم درون‌خطی استفاده
شود، بازنویسی می‌کند.
\&\fIstrategy\fR فهرستی از سه‌گانه‌های \fIalg\fR:\fImax_size\fR:\fIdest_align\fR
است که با کاما از هم جدا شده‌اند. \fIalg\fR در \fB\-mstringop\-strategy\fR
مشخص می‌شود؛ \fImax_size\fR بیشینهٔ اندازه به بایت را مشخص می‌کند که الگوریتم
درون‌خطی \fIalg\fR با آن مجاز است.
برای آخرین سه‌گانه، مقدار \fImax_size\fR باید \f(CW\-1\fR باشد.
مقدار \fImax_size\fR سه‌گانه‌ها در فهرست باید با ترتیبی صعودی مشخص گردد. کمینهٔ
اندازهٔ بایتی برای \fIalg\fR برای نخستین سه‌گانه \f(CW0\fR و برای سه‌گانه‌های
بعدی برابر با \f(CW\*(C`\fR\f(CImax_size\fR\f(CW + 1\*(C'\fR از محدودهٔ پیشین است.
.IP \fB\-mmemset\-strategy=\fR\fIstrategy\fR 4
.IX Item "-mmemset-strategy=strategy"
این گزینه مشابه \fB\-mmemcpy\-strategy=\fR است با این تفاوت که
بسط \f(CW\*(C`_\|_builtin_memset\*(C'\fR را کنترل می‌کند.
.IP \fB\-momit\-leaf\-frame\-pointer\fR 4
.IX Item "-momit-leaf-frame-pointer"
اشاره‌گر چارچوب را در یک ثبات برای توابع برگ نگه نمی‌دارد. این کار از
دستورالعمل‌های ذخیره، راه‌اندازی و بازیابی اشاره‌گرهای چارچوب جلوگیری کرده و
یک ثبات اضافی را در توابع برگ در دسترس قرار می‌دهد. گزینهٔ
\&\fB\-momit\-leaf\-frame\-pointer\fR اشاره‌گر چارچوب را برای توابع برگ
حذف می‌کند، که ممکن است اشکال‌زدایی را دشوارتر سازد.
.IP \fB\-mtls\-direct\-seg\-refs\fR 4
.IX Item "-mtls-direct-seg-refs"
.PD 0
.IP \fB\-mno\-tls\-direct\-seg\-refs\fR 4
.IX Item "-mno-tls-direct-seg-refs"
.PD
کنترل می‌کند که آیا متغیرهای TLS ممکن است با آفست‌هایی از ثبات قطعهٔ
TLS (\f(CW%gs\fR برای ۳۲ بیتی، \f(CW%fs\fR برای ۶۴ بیتی) مورد دسترسی قرار گیرند
یا اینکه اشاره‌گر پایهٔ رشته باید اضافه شود. معتبر بودن یا نبودن این رفتار
به سیستم‌عامل و اینکه آیا قطعه را به گونه‌ای نگاشت می‌کند که کل ناحیهٔ TLS
را پوشش دهد یا خیر، بستگی دارد.
.Sp
برای سیستم‌هایی که از کتابخانهٔ C گنو استفاده می‌کنند، حالت پیش‌فرض روشن است.
.IP \fB\-msse2avx\fR 4
.IX Item "-msse2avx"
.PD 0
.IP \fB\-mno\-sse2avx\fR 4
.IX Item "-mno-sse2avx"
.PD
مشخص می‌کند که اسمبلر باید دستورالعمل‌های SSE را با پیشوند VEX کدگذاری کند.
گزینهٔ \fB\-mavx\fR این ویژگی را به‌طور پیش‌فرض فعال می‌کند.
.IP \fB\-mfentry\fR 4
.IX Item "-mfentry"
.PD 0
.IP \fB\-mno\-fentry\fR 4
.IX Item "-mno-fentry".PD
اگر پروفایل‌سازی فعال باشد (\fB\-pg\fR)، فراخوانی
شمارندهٔ پروفایل‌سازی را پیش از پرولوگ قرار می‌دهد.
نکته: در معماری‌های x86، مشخصهٔ \f(CW\*(C`ms_hook_prologue\*(C'\fR
در حال حاضر برای \fB\-mfentry\fR و \fB\-pg\fR امکان‌پذیر نیست.
.IP \fB\-mrecord\-mcount\fR 4
.IX Item "-mrecord-mcount"
.PD 0
.IP \fB\-mno\-record\-mcount\fR 4
.IX Item "-mno-record-mcount"
.PD
اگر پروفایل‌سازی فعال باشد (\fB\-pg\fR)، بخشی ایجاد می‌کند که شامل
اشاره‌گرهایی به هر فراخوانی پروفایل‌سازی است؛ این ویژگی برای وصله کردن خودکار
فراخوانی‌ها مفید است. می‌توانید از گزینهٔ \fBmfentry\-section=\fR برای تعیین
نام این بخش استفاده کنید؛ مقدار پیش‌فرض آن \fB_\|_mcount_loc\fR است.
.IP \fB\-mnop\-mcount\fR 4
.IX Item "-mnop-mcount"
.PD 0
.IP \fB\-mno\-nop\-mcount\fR 4
.IX Item "-mno-nop-mcount"
.PD
اگر پروفایل‌سازی فعال باشد (\fB\-pg\fR)، فراخوانی‌های توابع
پروفایل‌سازی را به صورت NOP تولید می‌کند. این ویژگی زمانی مفید است که
آن‌ها بعداً باید به‌طور پویا وصله شوند. این گزینه احتمالاً تنها
همراه با \fB\-mrecord\-mcount\fR سودمند است.
.IP \fB\-minstrument\-return=\fR\fItype\fR 4
.IX Item "-minstrument-return=type"
همراه با \fB\-pg \-mfentry\fR، خروج‌های تابع را بر اساس
\&\fItype\fR ابزارگذاری می‌کند، که می‌تواند یکی از مقادیر \fBnone\fR برای عدم ابزارگذاری،
\&\fBcall\fR برای ایجاد فراخوانی به \f(CW\*(C`_\|_return_\|_\*(C'\fR، یا \fBnop5\fR برای
تولید یک دنبالهٔ nop پنج بایتی باشد. این گزینه فقط بازگشت‌های واقعی را که
به یک \f(CW\*(C`ret\*(C'\fR ختم می‌شوند ابزارگذاری می‌کند، نه فراخوانی‌های هم‌سطح از طریق پرش.
.IP \fB\-mrecord\-return\fR 4
.IX Item "-mrecord-return"
.PD 0
.IP \fB\-mno\-record\-return\fR 4
.IX Item "-mno-record-return"
.PD
یک بخش \f(CW\*(C`_\|_return_loc\*(C'\fR ایجاد می‌کند که به تمام کدهای
ابزارگذاری بازگشت اشاره دارد.
.IP \fB\-mfentry\-name=\fR\fIname\fR 4
.IX Item "-mfentry-name=name"
نام نماد \f(CW\*(C`_\|_fentry_\|_\*(C'\fR فراخوانی‌شده در ورودی تابع را برای
توابع \&\fB\-pg \-mfentry\fR تعیین می‌کند.
.IP \fB\-mfentry\-section=\fR\fIname\fR 4
.IX Item "-mfentry-section=name"
نام بخش مربوط به ثبت فراخوانی‌های \fB\-mrecord\-mcount\fR را تعیین می‌کند. مقدار
پیش‌فرض \fB_\|_mcount_loc\fR است.
.IP \fB\-mskip\-rax\-setup\fR 4
.IX Item "-mskip-rax-setup"
.PD 0
.IP \fB\-mno\-skip\-rax\-setup\fR 4
.IX Item "-mno-skip-rax-setup"
.PD
هنگام تولید کد برای معماری x86\-64 با غیرفعال بودن افزونه‌های SSE،
می‌توان از \fB\-mskip\-rax\-setup\fR برای صرف‌نظر از تنظیم ثبات RAX در حالتی که
هیچ آرگومان متغیری در ثبات‌های برداری ارسال نشده است، استفاده کرد.
.IP \fB\-m8bit\-idiv\fR 4
.IX Item "-m8bit-idiv"
.PD 0
.IP \fB\-mno\-8bit\-idiv\fR 4
.IX Item "-mno-8bit-idiv"
.PD
در برخی پردازنده‌ها، مانند Intel Atom، تقسیم اعداد صحیح بدون علامت ۸ بیتی
بسیار سریع‌تر از تقسیم اعداد صحیح ۳۲ بیتی/۶۴ بیتی است. این گزینه یک
بررسی در زمان اجرا ایجاد می‌کند. اگر هم مقسوم و هم مقسوم‌علیه در محدودهٔ ۰
تا ۲۵۵ باشند، به جای تقسیم اعداد صحیح ۳۲ بیتی/۶۴ بیتی، از تقسیم
اعداد صحیح بدون علامت ۸ بیتی استفاده می‌شود.
.IP \fB\-mavx256\-split\-unaligned\-load\fR 4
.IX Item "-mavx256-split-unaligned-load"
.PD 0
.IP \fB\-mavx256\-split\-unaligned\-store\fR 4
.IX Item "-mavx256-split-unaligned-store"
.PD
بارگذاری و ذخیره‌سازی غیرتراز ۳۲ بایتی AVX را تقسیم می‌کند.
.IP \fB\-mstack\-protector\-guard=\fR\fIguard\fR 4
.IX Item "-mstack-protector-guard=guard"
.PD 0
.IP \fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR 4
.IX Item "-mstack-protector-guard-reg=reg"
.IP \fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR 4
.IX Item "-mstack-protector-guard-offset=offset"
.IP \fB\-mstack\-protector\-guard\-symbol=\fR\fIsymbol\fR 4
.IX Item "-mstack-protector-guard-symbol=symbol"
.PD
کد محافظ پشته را با استفاده از قناری (canary) در \fIguard\fR ایجاد می‌کند. مکان‌های
پشتیبانی‌شده عبارتند از \fBglobal\fR برای قناری سراسری یا \fBtls\fR برای قناری
به‌ازای هر ریسه در بلوک TLS (پیش‌فرض). این گزینه فقط زمانی اعمال می‌شود که
\&\fB\-fstack\-protector\fR یا \fB\-fstack\-protector\-all\fR مشخص شده باشد.
.Sp
با انتخاب گزینهٔ اخیر، گزینه‌های
\&\fB\-mstack\-protector\-guard\-reg=\fR\fIreg\fR و
\&\fB\-mstack\-protector\-guard\-offset=\fR\fIoffset\fR علاوه بر این مشخص می‌کنند
که از کدام ثبات سگمنت (\f(CW%fs\fR یا \f(CW%gs\fR) به عنوان ثبات پایه
جهت خواندن قناری، و از چه آفستی نسبت به آن ثبات پایه استفاده شود.
مقدار پیش‌فرض این موارد همان است که در ABI مربوطه مشخص شده است.
.Sp
گزینهٔ \&\fB\-mstack\-protector\-guard\-symbol=\fR\fIsymbol\fR آفست را
با یک ارجاع نمادین به قناری موجود در بلوک TLS بازنویسی می‌کند.
.IP \fB\-mgeneral\-regs\-only\fR 4
.IX Item "-mgeneral-regs-only"
کدی تولید می‌کند که فقط از ثبات‌های همه‌منظوره استفاده می‌کند. این گزینه
از به‌کارگیری ثبات‌های ممیز شناور، برداری، ماسک و کران توسط کامپایلر
جلوگیری می‌کند.
.IP \fB\-mrelax\-cmpxchg\-loop\fR 4
.IX Item "-mrelax-cmpxchg-loop"
هنگام ایجاد یک حلقهٔ compare\-and\-swap برای توابع توکار \fB_\|_sync Builtins\fR
و \fB_\|_atomic Builtins\fR فاقد دستورالعمل بومی، با اجرای یک بارگذاری
اتمیک پیش از دستورالعمل \&\f(CW\*(C`CMPXCHG\*(C'\fR، و استفاده از دستورالعمل \f(CW\*(C`PAUSE\*(C'\fR
جهت صرفه‌جویی در مصرف انرژی پردازنده هنگام شروع مجدد حلقه، برای شرایط با رقابت بالا بهینه‌سازی می‌کند.
.IP \fB\-mindirect\-branch=\fR\fIchoice\fR 4
.IX Item "-mindirect-branch=choice"
فراخوانی و پرش غیرمستقیم را با \fIchoice\fR تبدیل می‌کند. پیش‌فرض
\&\fBkeep\fR است که فراخوانی و پرش غیرمستقیم را بدون تغییر نگه می‌دارد.
\&\fBthunk\fR فراخوانی و پرش غیرمستقیم را به thunk فراخوانی و بازگشت تبدیل می‌کند.
\&\fBthunk\-inline\fR فراخوانی و پرش غیرمستقیم را به thunk درون‌خطی فراخوانی
و بازگشت تبدیل می‌کند. \fBthunk\-extern\fR فراخوانی و پرش غیرمستقیم را به
thunk خارجی فراخوانی و بازگشت ارائه‌شده در یک فایل شیء جداگانه تبدیل می‌کند.
می‌توانید این رفتار را برای یک تابع خاص با استفاده از صفت
تابع \f(CW\*(C`indirect_branch\*(C'\fR کنترل کنید.
.Sp
توجه داشته باشید که \fB\-mcmodel=large\fR با
\&\fB\-mindirect\-branch=thunk\fR و
\&\fB\-mindirect\-branch=thunk\-extern\fR ناسازگار است، چرا که ممکن است تابع thunk
در مدل کد بزرگ در دسترس نباشد.
.Sp
توجه داشته باشید که \fB\-mindirect\-branch=thunk\-extern\fR با
\&\fB\-fcf\-protection=branch\fR سازگار است زیرا می‌توان thunk خارجی را
به‌گونه‌ای ساخت که بررسی جریان کنترل را فعال کند.
.IP \fB\-mfunction\-return=\fR\fIchoice\fR 4
.IX Item "-mfunction-return=choice"
بازگشت تابع را با \fIchoice\fR تبدیل می‌کند. پیش‌فرض \fBkeep\fR است
که بازگشت تابع را دست‌نخورده نگه می‌دارد. \fBthunk\fR بازگشت تابع را به
thunk فراخوانی و بازگشت تبدیل می‌کند. \fBthunk\-inline\fR بازگشت تابع را به
thunk درون‌خطی فراخوانی و بازگشت تبدیل می‌کند. \fBthunk\-extern\fR بازگشت
تابع را به thunk خارجی فراخوانی و بازگشت ارائه‌شده در یک فایل شیء جداگانه
تبدیل می‌کند. می‌توانید این رفتار را برای یک تابع خاص با
استفاده از صفت تابع \f(CW\*(C`function_return\*(C'\fR کنترل کنید.
.Sp
توجه داشته باشید که \fB\-mindirect\-return=thunk\-extern\fR با
\&\fB\-fcf\-protection=branch\fR سازگار است، زیرا می‌توان thunk خارجی را
برای فعال‌سازی بررسی جریان کنترل تنظیم کرد.
.Sp
توجه داشته باشید که \fB\-mcmodel=large\fR با
\&\fB\-mfunction\-return=thunk\fR و
\&\fB\-mfunction\-return=thunk\-extern\fR ناسازگار است زیرا ممکن است تابع thunk
در مدل کد بزرگ در دسترس نباشد.
.IP \fB\-mindirect\-branch\-register\fR 4
.IX Item "-mindirect-branch-register"
فراخوانی و پرش غیرمستقیم از طریق ثبات را اجباری می‌کند.
.IP \fB\-mharden\-sls=\fR\fIchoice\fR 4
.IX Item "-mharden-sls=choice"
کدی برای کاهش اثرات حدس و گمان خط مستقیم (SLS) با
\&\fIchoice\fR تولید می‌کند. پیش‌فرض \fBnone\fR است که تمام مقاوم‌سازی‌های
SLS را غیرفعال می‌کند. \fBreturn\fR مقاوم‌سازی SLS را برای بازگشت‌های تابع فعال می‌کند.
\&\fBindirect\-jmp\fR مقاوم‌سازی SLS را برای پرش‌های غیرمستقیم فعال می‌کند.
\&\fBall\fR تمامی مقاوم‌سازی‌های SLS را فعال می‌کند.
.IP \fB\-mindirect\-branch\-cs\-prefix\fR 4
.IX Item "-mindirect-branch-cs-prefix"
پیشوند CS را به دستورات call و jmp به مقصد thunk غیرمستقیم با هدف شاخه در
ثبات‌های r8\-r15 اضافه می‌کند تا طول دستورالعمل call و jmp برابر با ۶ بایت شود.
این کار اجازه می‌دهد که آن‌ها در زمان اجرا بتوانند به طور بالقوه با \fBlfence; call *%r8\-r15\fR
یا \fBlfence; jmp *%r8\-r15\fR جایگزین شوند.
.IP \fB\-mapx\-inline\-asm\-use\-gpr32\fR 4
.IX Item "-mapx-inline-asm-use-gpr32"
به‌طور پیش‌فرض، استفاده از EGPR در قیدهای اسمبلی درون‌خطی غیرفعال است زیرا GCC نمی‌تواند
مطلع شود که آیا دستورالعمل‌های اسمبلی از GP32 پشتیبانی می‌کنند یا خیر.
اگر اسمبلی درون‌خطی شما می‌تواند EGPR را مدیریت کند، از \fB\-mapx\-inline\-asm\-use\-gpr32\fR استفاده کنید.
.IP \fB\-mgather\fR 4
.IX Item "-mgather"
.PD 0
.IP \fB\-mscatter\fR 4
.IX Item "-mscatter"
.PD
به‌ترتیب بردارسازی را برای دستورالعمل‌های gather و scatter فعال می‌کند.
.PP
این گزینه‌های \fB\-m\fR علاوه‌بر موارد بالا،
در پردازنده‌های x86\-64 در محیط‌های ۶۴ بیتی پشتیبانی می‌شوند.
.IP \fB\-m32\fR 4
.IX Item "-m32".PD 0
.IP \fB\-m64\fR 4
.IX Item "-m64"
.IP \fB\-mx32\fR 4
.IX Item "-mx32"
.IP \fB\-m16\fR 4
.IX Item "-m16"
.PD
تولید کد برای یک محیط ۱۶ بیتی، ۳۲ بیتی یا ۶۴ بیتی.
گزینهٔ \fB\-m32\fR انواع دادهٔ \f(CW\*(C`int\*(C'\fR، \f(CW\*(C`long\*(C'\fR و اشاره‌گرها را ۳۲ بیتی تعیین کرده و
کدی تولید می‌کند که در حالت ۳۲ بیتی اجرا می‌شود.
.Sp
گزینهٔ \fB\-m64\fR نوع \f(CW\*(C`int\*(C'\fR را ۳۲ بیتی و انواع \f(CW\*(C`long\*(C'\fR و اشاره‌گر را
۶۴ بیتی تعیین می‌کند و برای معماری x86\-64 کد تولید می‌نماید.
فقط در Darwin، گزینهٔ \fB\-m64\fR همچنین گزینه‌های \fB\-fno\-pic\fR
و \fB\-mdynamic\-no\-pic\fR را غیرفعال می‌کند.
.Sp
گزینهٔ \fB\-mx32\fR انواع دادهٔ \f(CW\*(C`int\*(C'\fR، \f(CW\*(C`long\*(C'\fR و اشاره‌گر را
روی ۳۲ بیت تنظیم می‌کند و
برای معماری x86\-64 کد تولید می‌نماید.
.Sp
گزینهٔ \fB\-m16\fR مشابه \fB\-m32\fR است، با این تفاوت که
در ابتدای خروجی اسمبلی دستورالعمل اسمبلی \f(CW\*(C`.code16gcc\*(C'\fR را درج می‌کند
تا فایل باینری بتواند در حالت ۱۶ بیتی اجرا شود.
.IP \fB\-miamcu\fR 4
.IX Item "-miamcu"
گزینهٔ \fB\-miamcu\fR کدی سازگار با Intel MCU psABI تولید می‌کند.
این گزینه نیازمند فعال بودن گزینهٔ \fB\-m32\fR است.
.IP \fB\-mno\-red\-zone\fR 4
.IX Item "-mno-red-zone"
از به‌اصطلاح «red zone» برای کدهای x86\-64 استفاده نمی‌کند. red zone توسط ABI مربوط به x86\-64
الزامی شده است؛ ناحیه‌ای ۱۲۸ بایتی فراتر از موقعیت اشاره‌گر پشته (stack pointer) است
که توسط روتین‌های مدیریت سیگنال یا وقفه تغییر نمی‌کند و بنابراین
می‌تواند بدون تنظیم اشاره‌گر پشته برای داده‌های موقت استفاده شود.
پرچم \fB\-mno\-red\-zone\fR این red zone را غیرفعال می‌کند.
.IP \fB\-mcmodel=small\fR 4
.IX Item "-mcmodel=small"
تولید کد برای مدل کد کوچک (small code model): برنامه و نمادهای آن باید
در ۲ گیگابایت پایینی فضای آدرس پیوند (link) داده شوند. اشاره‌گرها ۶۴ بیتی هستند.
برنامه‌ها می‌توانند به‌صورت ایستا یا پویا پیوند داده شوند. این مدل، مدل کد پیش‌فرض است.
.IP \fB\-mcmodel=kernel\fR 4
.IX Item "-mcmodel=kernel"
تولید کد برای مدل کد هسته (kernel code model). هسته در ۲ گیگابایت منفی
از فضای آدرس اجرا می‌شود.
این مدل باید برای کدهای هستهٔ Linux استفاده شود.
.IP \fB\-mcmodel=medium\fR 4
.IX Item "-mcmodel=medium"
تولید کد برای مدل متوسط (medium model): برنامه در ۲ گیگابایت پایینی فضای آدرس پیوند
داده می‌شود. نمادهای کوچک نیز در آنجا قرار می‌گیرند. نمادهایی با اندازه‌های بزرگ‌تر
از \fB\-mlarge\-data\-threshold\fR در بخش‌های دادهٔ بزرگ (large data) یا BSS قرار داده
می‌شوند و می‌توانند بالاتر از ۲ گیگابایت قرار گیرند. برنامه‌ها می‌توانند
به‌صورت ایستا یا پویا پیوند داده شوند.
.IP \fB\-mcmodel=large\fR 4
.IX Item "-mcmodel=large"
تولید کد برای مدل بزرگ (large model). این مدل هیچ فرضی
در مورد آدرس‌ها و اندازهٔ بخش‌ها در نظر نمی‌گیرد.
.IP \fB\-maddress\-mode=long\fR 4
.IX Item "-maddress-mode=long"
تولید کد برای حالت آدرس بلند (long address mode). این مورد تنها برای محیط‌های ۶۴ بیتی
و x32 پشتیبانی می‌شود. این حالت، حالت آدرس پیش‌فرض برای محیط‌های ۶۴ بیتی است.
.IP \fB\-maddress\-mode=short\fR 4
.IX Item "-maddress-mode=short"
تولید کد برای حالت آدرس کوتاه (short address mode). این مورد تنها برای محیط‌های ۳۲ بیتی
و x32 پشتیبانی می‌شود. این حالت، حالت آدرس پیش‌فرض برای محیط‌های ۳۲ بیتی
و x32 است.
.IP \fB\-mneeded\fR 4
.IX Item "-mneeded"
.PD 0
.IP \fB\-mno\-needed\fR 4
.IX Item "-mno-needed"
.PD
تولید ویژگی گنو GNU_PROPERTY_X86_ISA_1_NEEDED برای مقصد Linux جهت
مشخص کردن سطح ISA ریزمعماری مورد نیاز برای اجرای فایل باینری.
.IP \fB\-mno\-direct\-extern\-access\fR 4
.IX Item "-mno-direct-extern-access"
بدون \fB\-fpic\fR یا \fB\-fPIC\fR، همواره از اشاره‌گر GOT برای
دسترسی به نمادهای خارجی استفاده می‌کند. با \fB\-fpic\fR یا \fB\-fPIC\fR،
دسترسی به نمادهای محافظت‌شده همانند نمادهای محلی تلقی می‌شود. پیش‌فرض
\&\fB\-mdirect\-extern\-access\fR است.
.Sp
\&\fBهشدار:\fR کتابخانه‌های مشترک کامپایل‌شده با
\&\fB\-mno\-direct\-extern\-access\fR و فایل اجرایی کامپایل‌شده با
\&\fB\-mdirect\-extern\-access\fR در صورتی که نمادهای محافظت‌شده در کتابخانه‌های مشترک و فایل اجرایی استفاده شده باشند، ممکن است سازگاری باینری نداشته باشند.
.IP \fB\-munroll\-only\-small\-loops\fR 4
.IX Item "-munroll-only-small-loops"
.PD 0
.IP \fB\-mno\-unroll\-only\-small\-loops\fR 4
.IX Item "-mno-unroll-only-small-loops"
.PD
باز کردن محافظه‌کارانهٔ حلقه‌های کوچک (loop unrolling) را کنترل می‌کند. این گزینه به‌طور پیش‌فرض با
\&\fB\-O2\fR فعال است و حلقه‌های دارای کمتر از ۴ دستورالعمل را ۱ بار باز می‌کند.
این کار بهره‌وری بهتری از خط لولهٔ رمزگشایی دستورالعمل‌ها در پردازنده‌های امروزی فراهم می‌کند.
می‌توانید این قابلیت را با \fB\-mno\-unroll\-only\-small\-loops\fR غیرفعال کنید،
و همچنین در صورتی که گزینه‌های کلی‌تر \fB\-funroll\-loops\fR
یا \fB\-funroll\-all\-loops\fR فعال باشند یا صراحتاً غیرفعال شده باشند نیز غیرفعال می‌شود.
.IP \fB\-mdispatch\-scheduler\fR 4
.IX Item "-mdispatch-scheduler"
فعال‌سازی زمان‌بندی دستورالعمل‌ها. این مورد تنها در پردازنده‌های \fBbdver1\fR،
\&\fBbdver2\fR، \fBbdver3\fR، \fBbdver4\fR و \fBznver1\fR پشتیبانی می‌شود و
علاوه بر آن نیازمند \fB\-fschedule\-insns \-fsched\-pressure\fR است.
.IP \fB\-mlam=\fR\fIchoice\fR 4
.IX Item "-mlam=choice"
قابلیت LAM (ماسک‌گذاری آدرس خطی یا linear\-address masking) امکان استفاده از بیت‌های خاصی در اشاره‌گر
را برای فراداده فراهم می‌سازد. مقدار پیش‌فرض \fBnone\fR است. با \fBu48\fR، بیت‌های اشاره‌گر در
موقعیت‌های 62:48 می‌توانند برای فراداده استفاده شوند؛ با \fBu57\fR، بیت‌های اشاره‌گر در
موقعیت‌های 62:57 می‌توانند برای فراداده استفاده شوند.
.PP
\fIگزینه‌های x86 Windows\fR
.IX Subsection "x86 Windows Options"
.PP
\fIگزینه‌های Xstormy16\fR
.IX Subsection "Xstormy16 Options"
.PP
این گزینه‌ها برای Xstormy16 تعریف شده‌اند:
.IP \fB\-msim\fR 4
.IX Item "-msim"
انتخاب فایل‌های راه‌اندازی (startup) و اسکریپت پیونددهندهٔ مناسب برای شبیه‌ساز.
.PP
\fIگزینه‌های Xtensa\fR
.IX Subsection "Xtensa Options"
.PP
این گزینه‌ها برای مقصدهای Xtensa پشتیبانی می‌شوند:
.IP \fB\-mconst16\fR 4
.IX Item "-mconst16"
.PD 0
.IP \fB\-mno\-const16\fR 4
.IX Item "-mno-const16"
.PD
فعال یا غیرفعال کردن استفاده از دستورالعمل‌های \f(CW\*(C`CONST16\*(C'\fR برای بارگذاری
مقادیر ثابت. در صورت فعال بودن، دستورالعمل‌های \f(CW\*(C`CONST16\*(C'\fR همواره
به‌جای دستورالعمل‌های استاندارد \f(CW\*(C`L32R\*(C'\fR استفاده می‌شوند. استفاده از
\&\f(CW\*(C`CONST16\*(C'\fR تنها زمانی به‌طور پیش‌فرض فعال است که دستورالعمل \f(CW\*(C`L32R\*(C'\fR
در دسترس نباشد.
.IP \fB\-mserialize\-volatile\fR 4
.IX Item "-mserialize-volatile"
.PD 0
.IP \fB\-mno\-serialize\-volatile\fR 4
.IX Item "-mno-serialize-volatile"
.PD
هنگامی که این گزینه فعال باشد، GCC دستورالعمل‌های \f(CW\*(C`MEMW\*(C'\fR را پیش از
ارجاعات حافظهٔ \&\f(CW\*(C`volatile\*(C'\fR درج می‌کند تا سازگاری ترتیبی (sequential consistency) تضمین شود.
پیش‌فرض \fB\-mserialize\-volatile\fR است. از
\&\fB\-mno\-serialize\-volatile\fR برای حذف دستورالعمل‌های \f(CW\*(C`MEMW\*(C'\fR استفاده کنید.
.IP \fB\-mforce\-no\-pic\fR 4
.IX Item "-mforce-no-pic"
.PD 0
.IP \fB\-mno\-force\-no\-pic\fR 4
.IX Item "-mno-force-no-pic"
.PD
برای مقاصدی مانند GNU/Linux، که در آن‌ها تمام کدهای حالت کاربر (user\-mode) در Xtensa باید
کد مستقل از موقعیت (PIC) باشند، این گزینه PIC را برای کامپایل کد هسته غیرفعال می‌کند.
.IP \fB\-mtext\-section\-literals\fR 4
.IX Item "-mtext-section-literals"
.PD 0
.IP \fB\-mno\-text\-section\-literals\fR 4
.IX Item "-mno-text-section-literals"
.PD
این گزینه‌ها مدیریت استخرهای مقادیر صریح (literal pools) را کنترل می‌کنند. حالت پیش‌فرض
\&\fB\-mno\-text\-section\-literals\fR است که مقادیر صریح را در یک بخش مجزا
در فایل خروجی قرار می‌دهد. این امر اجازه می‌دهد استخر مقادیر صریح
در یک RAM/ROM داده قرار گیرد و همچنین به پیونددهنده امکان می‌دهد استخرهای
مقادیر صریح را از فایل‌های شیء مجزا ترکیب کند تا مقادیر تکراری حذف شده و
اندازهٔ کد بهینه شود. با \fB\-mtext\-section\-literals\fR، مقادیر صریح
درون بخش متن پراکنده می‌شوند تا در نزدیک‌ترین فاصلهٔ ممکن
به ارجاعات خود قرار گیرند. این ممکن است برای فایل‌های اسمبلی بزرگ
ضروری باشد. مقادیر صریح برای هر تابع دقیقاً پیش از همان تابع قرار می‌گیرند.
.IP \fB\-mauto\-litpools\fR 4
.IX Item "-mauto-litpools"
.PD 0
.IP \fB\-mno\-auto\-litpools\fR 4
.IX Item "-mno-auto-litpools"
.PD
این گزینه‌ها نحوهٔ مدیریت استخرهای مقادیر صریح را کنترل می‌کنند. حالت پیش‌فرض
\&\fB\-mno\-auto\-litpools\fR است که مقادیر صریح را در یک بخش مجزا
در فایل خروجی قرار می‌دهد مگر اینکه از \fB\-mtext\-section\-literals\fR
استفاده شده باشد. با \fB\-mauto\-litpools\fR مقادیر صریح توسط اسمبلر در
بخش متن پراکنده می‌شوند. کامپایلر دستورالعمل‌های صریح
\&\f(CW\*(C`.literal\*(C'\fR را تولید نکرده و مقادیر صریح را با دستورالعمل‌های
\&\f(CW\*(C`MOVI\*(C'\fR به‌جای \f(CW\*(C`L32R\*(C'\fR درون ثبات‌ها بارگذاری می‌کند تا به اسمبلر اجازه دهد
عملیات ریلکسیشن (relaxation) را انجام داده و مقادیر صریح را بر حسب نیاز جای‌گذاری کند. این گزینه به
اسمبلر اجازه می‌دهد چندین استخر مقادیر صریح به ازای هر تابع ایجاد کرده و توابع بسیار بزرگ را
اسمبل نماید؛ امری که ممکن است با \&\fB\-mtext\-section\-literals\fR مقدور نباشد..IP \fB\-mtarget\-align\fR 4
.IX Item "-mtarget-align"
.PD 0
.IP \fB\-mno\-target\-align\fR 4
.IX Item "-mno-target-align"
.PD
هنگامی که این گزینه فعال باشد، GCC به اسمبلر دستور می‌دهد تا دستورالعمل‌ها را به طور خودکار تراز کند تا جریمه‌های انشعاب به بهای اندکی کاهش چگالی کد، کاهش یابند. اسمبلر تلاش می‌کند تا دستورالعمل‌های چگالی (density instructions) را عریض‌تر کند تا اهداف انشعاب و دستورالعمل‌های پس از دستورالعمل‌های فراخوانی تراز شوند. اگر دستورالعمل‌های چگالی امن قبلی به اندازه کافی برای تراز کردن یک هدف وجود نداشته باشد، هیچ عریض‌سازی انجام نمی‌شود. مقدار پیش‌فرض \fB\-mtarget\-align\fR است. این گزینه‌ها بر رفتار با دستورالعمل‌های خودترازشده مانند \f(CW\*(C`LOOP\*(C'\fR تأثیری ندارند؛ اسمبلر همیشه آن‌ها را چه با عریض کردن دستورالعمل‌های چگالی و چه با درج دستورالعمل‌های NOP تراز می‌کند.
.IP \fB\-mlongcalls\fR 4
.IX Item "-mlongcalls"
.PD 0
.IP \fB\-mno\-longcalls\fR 4
.IX Item "-mno-longcalls"
.PD
هنگامی که این گزینه فعال باشد، GCC به اسمبلر دستور می‌دهد تا فراخوانی‌های مستقیم را به فراخوانی‌های غیرمستقیم ترجمه کند، مگر اینکه بتواند تشخیص دهد که هدف یک فراخوانی مستقیم در محدوده مجازِ دستورالعمل فراخوانی قرار دارد. این ترجمه معمولاً برای فراخوانی توابع در سایر فایل‌های منبع رخ می‌دهد. به‌طور مشخص، اسمبلر یک دستورالعمل مستقیم \f(CW\*(C`CALL\*(C'\fR را به یک دستورالعمل \f(CW\*(C`L32R\*(C'\fR و به دنبال آن یک دستورالعمل \f(CW\*(C`CALLX\*(C'\fR ترجمه می‌کند. مقدار پیش‌فرض \fB\-mno\-longcalls\fR است. این گزینه باید در برنامه‌هایی استفاده شود که هدف فراخوانی در آن‌ها ممکن است خارج از محدوده باشد. این گزینه در اسمبلر پیاده‌سازی شده است نه کامپایلر، بنابراین کد اسمبلی تولیدشده توسط GCC همچنان دستورالعمل‌های فراخوانی مستقیم را نشان می‌دهد\-\-\-برای مشاهده دستورالعمل‌های واقعی به کد شیء دی‌اسمبل‌شده نگاه کنید. توجه داشته باشید که اسمبلر برای هر فراخوانی بین‌فایلی از یک فراخوانی غیرمستقیم استفاده می‌کند، نه فقط مواردی که واقعاً خارج از محدوده هستند.
.IP \fB\-mabi=\fR\fIname\fR 4
.IX Item "-mabi=name"
تولید کد برای ABI مشخص‌شده. مقادیر مجاز عبارتند از: \fBcall0\fR و
\&\fBwindowed\fR. مقدار پیش‌فرض ABI توسط پیکربندی هسته Xtensa تعیین می‌شود.
.IP \fB\-mabi=call0\fR 4
.IX Item "-mabi=call0"
هنگامی که این گزینه فعال باشد، پارامترهای تابع در ثبات‌های
\&\f(CW\*(C`a2\*(C'\fR تا \f(CW\*(C`a7\*(C'\fR منتقل می‌شوند، ثبات‌های \f(CW\*(C`a12\*(C'\fR تا \f(CW\*(C`a15\*(C'\fR از نوع
caller\-saved (ذخیره‌شده توسط فراخوان) هستند و از ثبات \f(CW\*(C`a15\*(C'\fR ممکن است به عنوان اشاره‌گر فریم (frame pointer) استفاده شود.
هنگامی که این نسخه از ABI فعال باشد، نماد پیش‌پردازنده C یعنی
\&\f(CW\*(C`_\|_XTENSA_CALL0_ABI_\|_\*(C'\fR تعریف می‌شود.
.IP \fB\-mabi=windowed\fR 4
.IX Item "-mabi=windowed"
هنگامی که این گزینه فعال باشد، پارامترهای تابع در ثبات‌های
\&\f(CW\*(C`a10\*(C'\fR تا \f(CW\*(C`a15\*(C'\fR منتقل می‌شوند و تابع فراخوانده‌شده در هنگام ورود، پنجره ثبات‌ها را
به اندازه ۸ ثبات می‌چرخاند تا آرگومان‌های آن در ثبات‌های
\&\f(CW\*(C`a2\*(C'\fR تا \f(CW\*(C`a7\*(C'\fR قرار گیرند. از ثبات \f(CW\*(C`a7\*(C'\fR ممکن است به عنوان اشاره‌گر فریم
استفاده شود. پنجره ثبات‌ها هنگام بازگشت، ۸ ثبات به عقب بازگردانده می‌شود.
هنگامی که این نسخه از ABI فعال باشد، نماد پیش‌پردازنده C یعنی
\&\f(CW\*(C`_\|_XTENSA_WINDOWED_ABI_\|_\*(C'\fR تعریف می‌شود.
.IP \fB\-mextra\-l32r\-costs=\fR\fIn\fR 4
.IX Item "-mextra-l32r-costs=n"
مشخص کردن هزینه اضافی دسترسی RAM/ROM دستورالعمل برای دستورالعمل‌های \f(CW\*(C`L32R\*(C'\fR،
بر حسب چرخه‌های ساعت (clock cycles). این مورد هنگام بهینه‌سازی برای سرعت، بر این موضوع
تأثیر می‌گذارد که آیا یک مقدار ثابت از استخر لیترال با استفاده از \f(CW\*(C`L32R\*(C'\fR بارگیری شود یا
اینکه مقدار ثابت از یک مقدار کوچک با چند دستورالعمل حسابی ترکیب و ساخته شود. مقدار پیش‌فرض 0 است.
.IP \fB\-mstrict\-align\fR 4
.IX Item "-mstrict-align"
.PD 0
.IP \fB\-mno\-strict\-align\fR 4
.IX Item "-mno-strict-align"
.PD
اجتناب یا اجازه دادن به تولید دسترسی‌های حافظه‌ای که ممکن است بر روی مرز طبیعی شیء
همان‌طور که در مشخصات معماری شرح داده شده است، تراز نشده باشند.
مقدار پیش‌فرض برای هسته‌هایی که از هر دو بارگیری و ذخیره‌سازی ناتراز در سخت‌افزار
پشتیبانی می‌کنند \fB\-mno\-strict\-align\fR و برای سایر هسته‌ها \fB\-mstrict\-align\fR است.
.PP
\fIگزینه‌های zSeries\fR
.IX Subsection "zSeries Options"
.PP
این موارد در ادامه فهرست شده‌اند
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
این بخش چندین متغیر محیطی را شرح می‌دهد که بر نحوه عملکرد GCC
تأثیر می‌گذارند. برخی از آن‌ها با تعیین دایرکتوری‌ها یا پیشوندهایی که هنگام
جستجو برای انواع فایل‌ها به کار می‌روند، عمل می‌کنند. برخی دیگر برای مشخص کردن سایر
جنبه‌های محیط کامپایل استفاده می‌شوند.
.PP
توجه داشته باشید که همچنین می‌توانید مکان‌های جستجو را با استفاده از گزینه‌هایی مانند
\&\fB\-B\fR، \fB\-I\fR و \fB\-L\fR مشخص کنید. این گزینه‌ها
بر مکان‌های تعیین‌شده توسط متغیرهای محیطی اولویت دارند، و آن‌ها نیز به نوبه خود
بر مکان‌های تعیین‌شده توسط پیکربندی GCC اولویت دارند.
.IP \fBLANG\fR 4
.IX Item "LANG"
.PD 0
.IP \fBLC_CTYPE\fR 4
.IX Item "LC_CTYPE"
.IP \fBLC_MESSAGES\fR 4
.IX Item "LC_MESSAGES"
.IP \fBLC_ALL\fR 4
.IX Item "LC_ALL"
.PD
این متغیرهای محیطی نحوه استفاده GCC از اطلاعات بومی‌سازی را کنترل می‌کنند؛ اطلاعاتی که به GCC
اجازه می‌دهد با قراردادهای ملی مختلف برای خروجی‌های تشخیصی و اطلاعاتی کار کند.
GCC دسته‌های محلی (locale categories)
\&\fBLC_CTYPE\fR و \fBLC_MESSAGES\fR را در صورتی که برای این کار پیکربندی شده باشد،
بررسی می‌کند. این دسته‌های محلی را می‌توان روی هر مقداری که توسط سیستم شما پشتیبانی می‌شود
تنظیم کرد. یک مقدار معمول برای زبان انگلیسی بریتانیا با کدگذاری UTF\-8، مقدار \fBen_GB.UTF\-8\fR است.
.Sp
اگر متغیر محیطی \fBLC_ALL\fR تنظیم شده باشد، مقدار \fBLC_CTYPE\fR و \fBLC_MESSAGES\fR
را نادیده می‌گیرد و جایگزین آن‌ها می‌شود؛ در غیر این صورت، \fBLC_CTYPE\fR و \fBLC_MESSAGES\fR
به طور پیش‌فرض از مقدار متغیر محیطی \fBLANG\fR استفاده می‌کنند. اگر هیچ‌یک از این
متغیرها تنظیم نشده باشند، GCC به رفتار سنتی C انگلیسی بازمی‌گردد.
.Sp
این متغیرهای محیطی بر کدگذاری فایل‌های ورودی و رشته‌ها در فایل‌های خروجیِ تولیدشده توسط GCC
تأثیری ندارند؛ این موارد به ترتیب توسط گزینه‌های
\&\fB\-finput\-charset\fR و \fB\-fexec\-charset\fR کنترل می‌شوند.
.IP \fBTMPDIR\fR 4
.IX Item "TMPDIR"
اگر \fBTMPDIR\fR تنظیم شده باشد، دایرکتوری مورد استفاده برای فایل‌های موقت را
مشخص می‌کند. GCC از فایل‌های موقت برای نگهداری خروجی یک مرحله از کامپایل که قرار است
به عنوان ورودی مرحله بعد استفاده شود، بهره می‌برد: برای مثال، خروجی پیش‌پردازنده که
ورودی خودِ کامپایلر است.
.IP \fBGCC_DIAGNOSTICS_LOG\fR 4
.IX Item "GCC_DIAGNOSTICS_LOG"
اگر \fBGCC_DIAGNOSTICS_LOG\fR تنظیم شده باشد، اطلاعات بیشتری در مورد زیرسیستم
عیب‌یابی منتشر خواهد شد. اگر مقدار آن خالی تنظیم شده باشد، اطلاعات در stderr نوشته خواهد شد؛
در غیر این صورت، GCC تلاش می‌کند آن فایل را باز کرده و اطلاعات را در آن بنویسد.
.Sp
محتوا و قالب دقیق اطلاعات ممکن است تغییر کند؛ این اطلاعات به جای کاربران نهایی،
برای استفاده توسعه‌دهندگان GCC در نظر گرفته شده است.
.IP \fBGCC_COMPARE_DEBUG\fR 4
.IX Item "GCC_COMPARE_DEBUG"
تنظیم \fBGCC_COMPARE_DEBUG\fR تقریباً معادل ارسال
\&\fB\-fcompare\-debug\fR به راه‌انداز کامپایلر است. برای جزئیات بیشتر به
مستندات این گزینه مراجعه کنید.
.IP \fBGCC_EXEC_PREFIX\fR 4
.IX Item "GCC_EXEC_PREFIX"
اگر \fBGCC_EXEC_PREFIX\fR تنظیم شده باشد، پیشوندی را برای استفاده در نام زیربرنامه‌های
اجراشده توسط کامپایلر مشخص می‌کند. هنگام الحاق این پیشوند به نام یک زیربرنامه هیچ
اسلشی اضافه نمی‌شود، اما در صورت تمایل می‌توانید پیشوندی را تعیین کنید که با یک اسلش ختم شود.
.Sp
اگر \fBGCC_EXEC_PREFIX\fR تنظیم نشده باشد، GCC تلاش می‌کند تا بر اساس نام مسیری
که با آن فراخوانی شده است، پیشوند مناسبی را برای استفاده تعیین کند.
.Sp
اگر GCC نتواند زیربرنامه را با استفاده از پیشوند مشخص‌شده بیابد،
مکان‌های معمول را برای یافتن زیربرنامه جستجو می‌کند.
.Sp
مقدار پیش‌فرض \fBGCC_EXEC_PREFIX\fR برابر است با
\&\fIprefix/lib/gcc/\fR که در آن \fIprefix\fR پیشوندِ کامپایلر نصب‌شده است.
در بسیاری از موارد، \fIprefix\fR همان مقدار \f(CW\*(C`prefix\*(C'\fR در زمان اجرای
اسکریپت \fIconfigure\fR است.
.Sp
سایر پیشوندهای مشخص‌شده با \fB\-B\fR بر این پیشوند اولویت دارند.
.Sp
این پیشوند همچنین برای یافتن فایل‌هایی مانند \fIcrt0.o\fR که برای پیوند دادن
(linking) استفاده می‌شوند، به کار می‌رود.
.Sp
علاوه بر این، از این پیشوند به شیوه‌ای غیرمعمول در یافتن دایرکتوری‌های جستجوی
فایل‌های سرآیند استفاده می‌شود. به ازای هر یک از دایرکتوری‌های استانداردی که نام آن‌ها
به طور معمول با \fB/usr/local/lib/gcc\fR آغاز می‌شود (به طور دقیق‌تر، با مقدار \fBGCC_INCLUDE_DIR\fR)،
GCC تلاش می‌کند تا آن بخش آغازین را با پیشوند مشخص‌شده جایگزین کند تا نام دایرکتوری جایگزینی
تولید شود. بنابراین، با \fB\-Bfoo/\fR، کامپایلر GCC دایرکتوری \&\fIfoo/bar\fR را درست قبل
از جستجوی دایرکتوری استاندارد \&\fI/usr/local/lib/bar\fR جستجو می‌کند.
اگر یک دایرکتوری استاندارد با \fIprefix\fR پیکربندی‌شده آغاز شود، هنگام جستجوی
فایل‌های سرآیند، مقدار \fIprefix\fR با \&\fBGCC_EXEC_PREFIX\fR جایگزین می‌شود.
.IP \fBCOMPILER_PATH\fR 4
.IX Item "COMPILER_PATH"
مقدار \fBCOMPILER_PATH\fR فهرستی از دایرکتوری‌ها است که با دو‌نقطه (:) از هم جدا شده‌اند،
بسیار شبیه به \fBPATH\fR. در صورتی که GCC نتواند زیربرنامه‌ها را با استفاده از
\&\fBGCC_EXEC_PREFIX\fR پیدا کند، دایرکتوری‌های مشخص‌شده را برای جستجوی زیربرنامه‌ها بررسی می‌کند.
.IP \fBLIBRARY_PATH\fR 4
.IX Item "LIBRARY_PATH"
مقدار \fBLIBRARY_PATH\fR فهرستی از دایرکتوری‌ها است که با دو‌نقطه از هم جدا شده‌اند،
بسیار شبیه به \fBPATH\fR. هنگامی که کامپایلر به صورت محلی (native) پیکربندی شده باشد،
اگر نتواند فایل‌های ویژه پیونددهنده را با استفاده از \fBGCC_EXEC_PREFIX\fR پیدا کند،
دایرکتوری‌های مشخص‌شده را جستجو می‌کند. همچنین عملیات پیوند دادن با استفاده از GCC،
هنگام جستجوی کتابخانه‌های معمولی برای گزینه \fB\-l\fR از این دایرکتوری‌ها استفاده می‌کند
(اما دایرکتوری‌های مشخص‌شده با \&\fB\-L\fR اولویت دارند)..IP \fBGCC_EXTRA_DIAGNOSTIC_OUTPUT\fR 4
.IX Item "GCC_EXTRA_DIAGNOSTIC_OUTPUT"
اگر \fBGCC_EXTRA_DIAGNOSTIC_OUTPUT\fR روی یکی از مقدارهای زیر تنظیم شده باشد، هنگام صدور راهنمایی‌های تصحیح (fix\-it hints)، متن اضافی در stderr چاپ خواهد شد. گزینه‌های \fB\-fdiagnostics\-parseable\-fixits\fR و
\&\fB\-fno\-diagnostics\-parseable\-fixits\fR نسبت به این متغیر محیطی اولویت دارند.
.RS 4
.IP \fBfixits\-v1\fR 4
.IX Item "fixits-v1"
صدور راهنمایی‌های تصحیح قابل تجزیه، معادل با
\&\fB\-fdiagnostics\-parseable\-fixits\fR. به‌ویژه، ستون‌ها به صورت تعداد بایت‌ها بیان می‌شوند که از بایت ۱ برای ستون اولیه آغاز می‌شود.
.IP \fBfixits\-v2\fR 4
.IX Item "fixits-v2"
همانند \f(CW\*(C`fixits\-v1\*(C'\fR، اما ستون‌ها همان‌طور که با \fB\-fdiagnostics\-column\-unit=display\fR مشخص می‌شود، به صورت ستون‌های نمایشی بیان می‌گردند.
.RE
.RS 4
.RE
.IP \fBEXPERIMENTAL_SARIF_SOCKET\fR 4
.IX Item "EXPERIMENTAL_SARIF_SOCKET"
اگر \fBEXPERIMENTAL_SARIF_SOCKET\fR در محیط تنظیم شده باشد، کامپایلر تلاش خواهد کرد به یک سوکت جریانی دامنهٔ یونیکس (UNIX domain stream socket) با آن نام متصل شود و به ازای هر پیام تشخیصی که رخ می‌دهد، یک اعلان JSON\-RPC 2.0 از نوع \f(CW\*(C`OnSarifResult\*(C'\fR به آن ارسال کند، که در آن مقدار اعلان یک شیء \f(CW\*(C`result\*(C'\fR در قالب SARIF است.
.Sp
اگر \fBEXPERIMENTAL_SARIF_SOCKET\fR تنظیم شده باشد و کامپایلر نتواند به آن متصل شود، بی‌درنگ با خطا مواجه خواهد شد.
.Sp
این ویژگی آزمایشی است و ممکن است بدون اطلاع قبلی تغییر کند یا حذف شود.
.PP
برخی متغیرهای محیطی دیگر نیز بر رفتار پیش‌پردازنده تأثیر می‌گذارند.
.IP \fBCPATH\fR 4
.IX Item "CPATH"
.PD 0
.IP \fBC_INCLUDE_PATH\fR 4
.IX Item "C_INCLUDE_PATH"
.IP \fBCPLUS_INCLUDE_PATH\fR 4
.IX Item "CPLUS_INCLUDE_PATH"
.IP \fBOBJC_INCLUDE_PATH\fR 4
.IX Item "OBJC_INCLUDE_PATH"
.PD
مقدار هر متغیر فهرستی از دایرکتوری‌ها است که با یک نویسهٔ ویژه از یکدیگر جدا شده‌اند (بسیار شبیه به \fBPATH\fR) و کامپایلر در آن‌ها به دنبال فایل‌های سرایند می‌گردد. نویسهٔ ویژه، یعنی \f(CW\*(C`PATH_SEPARATOR\*(C'\fR، وابسته به معماری هدف بوده و در زمان ساخت GCC تعیین می‌شود. برای سیستم‌های مبتنی بر Microsoft Windows این نویسه نقطه\-ویرگول و برای تقریباً تمامی سیستم‌های هدف دیگر دونقطه است.
.Sp
متغیر محیطی \&\fBCPATH\fR فهرستی از دایرکتوری‌ها را مشخص می‌کند که گویی با گزینهٔ \fB\-I\fR تعیین شده‌اند، با این تفاوت که پس از هر مسیر داده‌شده با گزینه‌های \fB\-I\fR در خط فرمان جستجو می‌شوند. این متغیر محیطی صرف‌نظر از اینکه چه زبانی در حال پیش‌پردازش است، به کار می‌رود.
.Sp
بقیهٔ متغیرهای محیطی تنها هنگام پیش‌پردازش زبان مشخص‌شده اعمال می‌شوند. هر یک فهرستی از دایرکتوری‌ها را برای جستجو مشخص می‌کنند که گویی با \fB\-isystem\fR تعیین شده‌اند، اما پس از هر مسیری که با گزینه‌های \fB\-isystem\fR در خط فرمان مشخص شده باشد جستجو خواهند شد.
.Sp
در تمام این متغیرها، یک عضو خالی به کامپایلر دستور می‌دهد تا دایرکتوری کاری فعلی خود را جستجو کند. اعضای خالی می‌توانند در ابتدا یا انتهای یک مسیر ظاهر شوند. برای نمونه، اگر مقدار \&\fBCPATH\fR برابر با \f(CW\*(C`:/special/include\*(C'\fR باشد، اثری مشابه با \fB\-I.\ \-I/special/include\fR خواهد داشت.
.IP \fBDEPENDENCIES_OUTPUT\fR 4
.IX Item "DEPENDENCIES_OUTPUT"
اگر این متغیر تنظیم شده باشد، مقدار آن نحوهٔ صدور وابستگی‌ها را برای Make بر اساس فایل‌های سرایند غیرسیستمیِ پردازش‌شده توسط کامپایلر مشخص می‌کند. فایل‌های سرایند سیستمی در خروجی وابستگی‌ها نادیده گرفته می‌شوند.
.Sp
مقدار \fBDEPENDENCIES_OUTPUT\fR می‌تواند صرفاً یک نام فایل باشد، که در این حالت قواعد Make در آن فایل نوشته شده و نام هدف از روی نام فایل منبع حدس زده می‌شود. همچنین مقدار می‌تواند به قالب \&\fIfile\fR\fB \fR\fItarget\fR باشد که در این صورت قواعد با استفاده از \fItarget\fR به عنوان نام هدف، در فایل \fIfile\fR نوشته می‌شوند.
.Sp
به عبارت دیگر، این متغیر محیطی معادل با ترکیب گزینه‌های \fB\-MM\fR و \fB\-MF\fR، به همراه گزینهٔ اختیاری \fB\-MT\fR است.
.IP \fBSUNPRO_DEPENDENCIES\fR 4
.IX Item "SUNPRO_DEPENDENCIES"
این متغیر مشابه \fBDEPENDENCIES_OUTPUT\fR است (به بالا مراجعه کنید)، با این تفاوت که فایل‌های سرایند سیستمی نادیده گرفته نمی‌شوند، بنابراین به جای \fB\-MM\fR بر \&\fB\-M\fR دلالت دارد. با این حال، وابستگی به فایل ورودی اصلی نادیده گرفته می‌شود.
.IP \fBSOURCE_DATE_EPOCH\fR 4
.IX Item "SOURCE_DATE_EPOCH"
اگر این متغیر تنظیم شده باشد، مقدار آن یک برچسب زمانی یونیکس (UNIX timestamp) را مشخص می‌کند تا به جای تاریخ و زمان فعلی در ماکروهای \f(CW\*(C`_\|_DATE_\|_\*(C'\fR و \f(CW\*(C`_\|_TIME_\|_\*(C'\fR استفاده شود، به گونه‌ای که برچسب‌های زمانی جاسازی‌شده بازتولیدپذیر شوند.
.Sp
مقدار \fBSOURCE_DATE_EPOCH\fR باید یک برچسب زمانی یونیکس باشد که به صورت تعداد ثانیه‌ها (بدون احتساب ثانیه‌های کبیسه) از تاریخ 01 Jan 1970 00:00:00 در قالب ASCII نشان داده می‌شود؛ دقیقاً یکسان با خروجی دستور \&\f(CW\*(C`date +%s\*(C'\fR در گنو/لینوکس و سایر سیستم‌هایی که از پسوند \f(CW%s\fR در دستور \f(CW\*(C`date\*(C'\fR پشتیبانی می‌کنند.
.Sp
این مقدار باید یک برچسب زمانی مشخص مانند زمان آخرین تغییر کد منبع یا بسته باشد و باید توسط فرآیند ساخت تنظیم شود..SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
برای دریافت دستورالعمل‌های مربوط به گزارش باگ‌ها، ببینید:
<\fBhttps://gcc.gnu.org/bugs\fR>.
.SH "پانویس‌ها (FOOTNOTES)"
.IX Header "FOOTNOTES"
.IP 1. 4
در برخی سیستم‌ها، \fBgcc \-shared\fR برای کارکرد سازنده‌ها نیازمند ساخت کد تکمیلی stub است. در سیستم‌های چندکتابخانه‌ای (multi\-libbed)، \fBgcc \-shared\fR باید کتابخانه‌های پشتیبان صحیح را برای پیوند انتخاب کند. عدم تعیین گزینه‌های صحیح ممکن است منجر به ایرادهای نامحسوس شود. تعیین آن‌ها در مواردی که ضروری نیستند بی‌ضرر است. گزینه \fB\-shared\fR مانع از افزودن کد راه‌اندازی (startup code) برای تغییر محیط ممیز شناور می‌شود؛ کاری که در برخی از مقصدها با \fB\-ffast\-math\fR، \&\fB\-Ofast\fR یا \fB\-funsafe\-math\-optimizations\fR انجام می‌گیرد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBgpl\fR\|(7)، \fBgfdl\fR\|(7)، \fBfsf\-funding\fR\|(7)،
\&\fBcpp\fR\|(1)، \fBgcov\fR\|(1)، \fBas\fR\|(1)، \fBld\fR\|(1)، \fBgdb\fR\|(1)
و مدخل‌های Info برای \fIgcc\fR، \fIcpp\fR، \fIas\fR،
\&\fIld\fR، \fIbinutils\fR و \fIgdb\fR.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
برای مشاهده مشارکت‌کنندگان در GCC، به مدخل Info برای \fBgcc\fR یا
<\fBhttps://gcc.gnu.org/onlinedocs/gcc/Contributors.html\fR>
مراجعه کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
کپی‌رایت (c) 1988\-2026 متعلق به بنیاد نرم‌افزار آزاد (.Free Software Foundation, Inc) است.
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزارهای آزاد داده می‌شود؛ بدون بخش‌های ناپیوسته، با بخش‌های تغییرناپذیر «GNU General Public License» و «Funding Free Software»، به همراه متن‌های روی جلد (a) (پایین را ببینید) و با متن‌های پشت جلد (b) (پایین را ببینید). یک رونوشت از این مجوز در صفحه راهنمای \fBgfdl\fR\|(7) گنجانده شده است.
.PP
(a) متن روی جلد FSF عبارت است از:
.PP
.Vb 1
\&     A GNU Manual
.Ve
.PP
(b) متن پشت جلد FSF عبارت است از:
.PP
.Vb 3
\&     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.
.Ve