1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595 |
- <?xml version="1.0" ?>
- <TOOLSET>
- <OPTIONXML version='7' config='target=c60' />
- <TOOL>
- <TAG>COMPILER</TAG>
- <TOOLNAME>C/C++ COMPILER</TOOLNAME>
- <DEFINITIONS>
- <OPTION tag='ABI'>
- <TYPE>simple</TYPE>
- <NAME>--abi</NAME>
- <HIDE_OPTION>true</HIDE_OPTION>
- <DEPRECATE_OPTION>
- <SEVERITY>3</SEVERITY>
- <DIAGNOSTIC>As of version 8.0.0 of the C6000 Code Generation Tools the only ABI supported is the ELF EABI. The specification of an --abi option is unnecessary.</DIAGNOSTIC>
- </DEPRECATE_OPTION>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>coffabi,eabi,elfabi</DESCRIPTION>
- <ONEOF>coffabi</ONEOF>
- <ONEOF>eabi</ONEOF>
- <ONEOF>elfabi</ONEOF>
- <DEFAULT>eabi</DEFAULT>
- </ARG>
- <DEPRECATE_ARGUMENT tag='coffabi'>
- <SEVERITY>6</SEVERITY>
- <DIAGNOSTIC>As of version 8.0.0 of the C6000 Code Generation Tools COFF ABI support is discontinued. If COFF ABI support is needed for your application, please use the latest version 7.4.x of the C6000 Code Generation Tools.</DIAGNOSTIC>
- </DEPRECATE_ARGUMENT>
- <DEPRECATE_ARGUMENT tag='elfabi'>
- <MAPSTO>
- <TAG>ABI</TAG>
- <TEXT>--abi=eabi</TEXT>
- </MAPSTO>
- </DEPRECATE_ARGUMENT>
- <TIP>Application binary interface (coffabi not supported)</TIP>
- <HELP>Specify application binary interface (option deprecated). COFFABI is no longer supported; to use it use Code Generation Tools 7.4.x. Default is eabi.</HELP>
- </OPTION>
-
- <OPTION tag='ABS_DIRECTORY'>
- <TYPE>cmdline</TYPE>
- <NAME>--abs_directory</NAME>
- <ALIAS>-fb</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Absolute listing directory (default is .obj dir)</TIP>
- <HELP>Absolute listing directory (default is .obj dir)</HELP>
- </OPTION>
-
- <OPTION tag='ABSOLUTE_LISTING'>
- <TYPE>cmdline</TYPE>
- <NAME>--absolute_listing</NAME>
- <ALIAS>-aa</ALIAS>
- <TIP>Generate absolute listing file</TIP>
- <HELP>Generate absolute listing file</HELP>
- </OPTION>
-
- <OPTION tag='ADVICE__PERFORMANCE'>
- <TYPE>simple</TYPE>
- <NAME>--advice:performance</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>all,none</DESCRIPTION>
- <ONEOF>all</ONEOF>
- <ONEOF>none</ONEOF>
- <DEFAULT>all</DEFAULT>
- </ARG>
- <TIP>Provide advice on optimization techniques</TIP>
- <HELP>Provide advice on optimization techniques to ensure use of right options and improve software pipelining.</HELP>
- </OPTION>
-
- <OPTION tag='ADVICE__PERFORMANCE_DIR'>
- <TYPE>simple</TYPE>
- <NAME>--advice:performance_dir</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>opt</DESCRIPTION>
- </ARG>
- <TIP>Place advice file in specified directory</TIP>
- <HELP>Place advice file in specified directory</HELP>
- </OPTION>
-
- <OPTION tag='ADVICE__PERFORMANCE_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--advice:performance_file</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>opt</DESCRIPTION>
- </ARG>
- <TIP>Place advice in specified file</TIP>
- <HELP>Place advice in specified file</HELP>
- </OPTION>
-
- <OPTION tag='ALIASED_VARIABLES'>
- <TYPE>simple</TYPE>
- <NAME>--aliased_variables</NAME>
- <ALIAS>-ma</ALIAS>
- <TIP>Assume called funcs create hidden aliases (rare)</TIP>
- <HELP>Assume called funcs create hidden aliases (rare)</HELP>
- </OPTION>
-
- <OPTION tag='ANALYZE'>
- <TYPE>simple</TYPE>
- <NAME>--analyze</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>codecov,callgraph</DESCRIPTION>
- <ONEOF>codecov</ONEOF>
- <ONEOF>callgraph</ONEOF>
- </ARG>
- <TIP>Generate analysis info from profile data</TIP>
- <HELP>Generate analysis information about code coverage or call graph information in the form of CSV files. This information can then be read and interpreted by other tools. For example, the cache layout tool, clt6x, can be used to interpret the call graph information and produce a preferred function order that can be incorporated into the application link. The compiler can only generate one kind of analysis information for a given invocation of the compiler.</HELP>
- <CONFLICT>GEN_PROFILE_INFO</CONFLICT>
- </OPTION>
-
- <OPTION tag='ANALYZE_ONLY'>
- <TYPE>simple</TYPE>
- <NAME>--analyze_only</NAME>
- <TIP>Only generate analysis</TIP>
- <HELP>Generate analysis only; do not continue compilation. This option is used in combination with the --analyze option to instruct the compiler to halt the compilation after it has completed the generation of analysis information requested in the --analyze option.</HELP>
- <CONFLICT>GEN_PROFILE_INFO</CONFLICT>
- </OPTION>
-
- <OPTION tag='AP_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--ap_extension</NAME>
- <ALIAS>-el</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for linear asm files (default is .sa)</TIP>
- <HELP>Extension for linear asm files (default is .sa)</HELP>
- </OPTION>
-
- <OPTION tag='AP_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--ap_file</NAME>
- <ALIAS>-fl</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>File is a linear asm file (default for .sa)</TIP>
- <HELP>File is a linear asm file (default for .sa)</HELP>
- </OPTION>
-
- <OPTION tag='ASM_DEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--asm_define</NAME>
- <ALIAS>-ad</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>NAME[=value]</DESCRIPTION>
- </ARG>
- <TIP>Pre-define assembly symbol NAME</TIP>
- <HELP>Pre-define the assembly symbol NAME, optionally setting its contents to 'value'.</HELP>
- </OPTION>
-
- <OPTION tag='ASM_DEPENDENCY'>
- <TYPE>simple</TYPE>
- <NAME>--asm_dependency</NAME>
- <ALIAS>-apd</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Generate assembly dependency information</TIP>
- <HELP>Generate assembly dependency information. Optionally, name the assembly dependency file.</HELP>
- </OPTION>
-
- <OPTION tag='ASM_DIRECTORY'>
- <TYPE>simple</TYPE>
- <NAME>--asm_directory</NAME>
- <ALIAS>-fs</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Assembly file directory (default is .)</TIP>
- <HELP>Assembly file directory (default is .)</HELP>
- </OPTION>
-
- <OPTION tag='ASM_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--asm_extension</NAME>
- <ALIAS>-ea</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for assembly files (default is .asm)</TIP>
- <HELP>Extension for assembly files (default is .asm)</HELP>
- </OPTION>
-
- <OPTION tag='ASM_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--asm_file</NAME>
- <ALIAS>-fa</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>File is an assembly file (default for .asm)</TIP>
- <HELP>File is an assembly file (default for .asm)</HELP>
- </OPTION>
-
- <OPTION tag='ASM_INCLUDES'>
- <TYPE>simple</TYPE>
- <NAME>--asm_includes</NAME>
- <ALIAS>-api</ALIAS>
- <TIP>Generate first-level assembly include file list</TIP>
- <HELP>Generate first-level assembly include file list</HELP>
- </OPTION>
-
- <OPTION tag='ASM_LISTING'>
- <TYPE>simple</TYPE>
- <NAME>--asm_listing</NAME>
- <ALIAS>-al</ALIAS>
- <TIP>Generate listing file</TIP>
- <HELP>Generate listing file</HELP>
- </OPTION>
-
- <OPTION tag='ASM_UNDEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--asm_undefine</NAME>
- <ALIAS>-au</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>NAME</DESCRIPTION>
- </ARG>
- <TIP>Undefine assembly symbol NAME</TIP>
- <HELP>Undefine assembly symbol NAME</HELP>
- </OPTION>
-
- <OPTION tag='AUTO_INLINE'>
- <TYPE>simple</TYPE>
- <NAME>--auto_inline</NAME>
- <ALIAS>-oi</ALIAS>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>Specify threshold for automatic inlining</TIP>
- <HELP>Specify threshold for automatic inlining</HELP>
- </OPTION>
-
- <OPTION tag='BIG_ENDIAN'>
- <TYPE>simple</TYPE>
- <NAME>--big_endian</NAME>
- <ALIAS>-me</ALIAS>
- <TIP>Generate big endian code</TIP>
- <HELP>Generate big endian code</HELP>
- <CHAIN>
- <TAG>ENDIAN</TAG>
- <TEXT>--endian=big</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='BUFFER_DIAGNOSTICS'>
- <TYPE>simple</TYPE>
- <NAME>--buffer_diagnostics</NAME>
- <ALIAS>-pdb</ALIAS>
- <TIP>Line buffer diagnostic output</TIP>
- <HELP>Line buffer diagnostic output to reduce message mixing when compiling in parallel.</HELP>
- </OPTION>
-
- <OPTION tag='CPLUSPLUS03'>
- <TYPE>simple</TYPE>
- <NAME>--c++03</NAME>
- <TIP>Compile program in C++03 mode.</TIP>
- <HELP>Compile program in C++03 mode.</HELP>
- <RESETS>EMBEDDED_CPP</RESETS>
- </OPTION>
-
- <OPTION tag='C89'>
- <TYPE>simple</TYPE>
- <NAME>--c89</NAME>
- <TIP>Compile program in ANSI C89 mode.</TIP>
- <HELP>Compile program in ANSI C89 mode.</HELP>
- <RESETS>C99</RESETS>
- <RESETS>KR_COMPATIBLE</RESETS>
- </OPTION>
-
- <OPTION tag='C99'>
- <TYPE>simple</TYPE>
- <NAME>--c99</NAME>
- <TIP>Compile program in C99 mode.</TIP>
- <HELP>Compile program in C99 mode.</HELP>
- <RESETS>KR_COMPATIBLE</RESETS>
- <RESETS>C89</RESETS>
- </OPTION>
-
- <OPTION tag='C_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--c_extension</NAME>
- <ALIAS>-ec</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for C files (default is .c)</TIP>
- <HELP>Extension for C files (default is .c)</HELP>
- </OPTION>
-
- <OPTION tag='C_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--c_file</NAME>
- <ALIAS>-fc</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>File is a C file (default for .c/no ext)</TIP>
- <HELP>File is a C file (default for .c/no ext)</HELP>
- </OPTION>
-
- <OPTION tag='C_SRC_INTERLIST'>
- <TYPE>simple</TYPE>
- <NAME>--c_src_interlist</NAME>
- <ALIAS>-ss</ALIAS>
- <TIP>Generate C source interlisted assembly file</TIP>
- <HELP>Generate C source interlisted assembly file</HELP>
- <OVERRIDES>SRC_INTERLIST</OVERRIDES>
- </OPTION>
-
- <OPTION tag='CALL_ASSUMPTIONS'>
- <TYPE>simple</TYPE>
- <NAME>--call_assumptions</NAME>
- <ALIAS>-op</ALIAS>
- <ARG>
- <TYPE>RANGE</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>0-3</DESCRIPTION>
- <RANGE low='0' high='3'/>
- </ARG>
- <TIP>Specify call assumptions when optimizing</TIP>
- <HELP>Specify assumptions to make about function calls when optimizing.
- Level 0 (-op0) indicates that the module has functions that are called from other modules.
- Level 1 (-op1) indicates that the module does not have functions that are called by other modules but has global variables that are modified in other modules.
- Level 2 (-op2) indicates that the module does not have functions that are called or globals that are modified by other modules.
- Level 3 (-op3) indicates that the module has functions that are called by other modules but does not have globals that are modified by other modules.</HELP>
- </OPTION>
-
- <OPTION tag='CHECK_MISRA'>
- <TYPE>simple</TYPE>
- <NAME>--check_misra</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>RULE</DESCRIPTION>
- <DEFAULT>all</DEFAULT>
- </ARG>
- <TIP>Enable checking of MISRA-C:2004 rules</TIP>
- <HELP>Enable verification of the MISRA-C:2004 rules, 'Guidelines for the use of the C language in critical systems.' For information on MISRA-C, see http://www.misra.org.uk. MISRA and MISRA-C are trademarks of MIRA Ltd.</HELP>
- <METADATA type='rulelist'>
-
- <body>
-
- <group id="required" name="Required"/>
- <group id="advisory" name="Advisory"/>
-
- <category id="1" name="Environment">
- <rule id="1.1" groups="required" name="All code shall conform to ISO 9899:1990 &quot;Programming languages - C&quot;, amended and corrected by ISO/IEC 9899/COR1:1995, ISO/IEC 9899/AMD1:1995, and ISO/IEC 9899/COR2:1996."/>
- </category>
-
- <category id="2" name="Language extensions">
- <rule id="2.1" groups="required" name="Assembly language shall be encapsulated and isolated."/>
- <rule id="2.2" groups="required" name="Source code shall only use /* ... */ style comments."/>
- <rule id="2.3" groups="required" name="The character sequence /* shall not be used within a comment."/>
- </category>
-
- <category id="3" name="Documentation">
- </category>
-
- <category id="4" name="Character sets">
- <rule id="4.1" groups="required" name="Only those excape sequences that are defined in the ISO C standard shall be used."/>
- <rule id="4.2" groups="required" name="Trigraphs shall not be used."/>
- </category>
-
- <category id="5" name="Identifiers">
- <rule id="5.2" groups="required" name="Identifiers in an inner scope shall not use the same name as an identifier in an outer scope, and therefore hide that identifier."/>
- <rule id="5.3" groups="required" name="A typedef name shall be a unique identifier."/>
- <rule id="5.4" groups="required" name="A tag name shall be a unique identifier."/>
- <rule id="5.6" groups="advisory" name="No identifier in one name space should have the same spelling as an identifier in another name space, with the exception of structure and union member names."/>
- <rule id="5.7" groups="advisory" name="No identifier name should be reused"/>
- </category>
-
- <category id="6" name="Types">
- <rule id="6.1" groups="required" name="The plain char type shall be used only for storage and use of character values."/>
- <rule id="6.2" groups="required" name="signed and unsigned char type shall be used only of the storage and use of numeric values."/>
- <rule id="6.3" groups="advisory" name="typedefs that indicate size and signedness should be used in place of the basic numerical types."/>
- <rule id="6.4" groups="required" name="Bit fields shall only be defined to be of type unsigned inti or signed int."/>
- <rule id="6.5" groups="required" name="Bit fields of the type signed int shall be at least 2 bits long."/>
- </category>
-
- <category id="7" name="Constants">
- <rule id="7.1" groups="required" name="Octal extensions (other than zero) and octal escape sequences shall not be used."/>
- </category>
-
- <category id="8" name="Declarations and definitions">
- <rule id="8.1" groups="required" name="Functions shall have prototype declarsions and the prototype shall be visible at both the function definition and call."/>
- <rule id="8.2" groups="required" name="Whenever an object or function is declared or defined, its type shall be explicitly stated."/>
- <rule id="8.5" groups="required" name="There shall be no definitions of objects or functons in a header file."/>
- <rule id="8.6" groups="required" name="Functions shall be declared at file scope."/>
- <rule id="8.7" groups="required" name="Objects shall be defined at block scope if they are only accessed from within a single function."/>
- <rule id="8.8" groups="required" name="An external object or function shall be declared in one and only one file."/>
- <rule id="8.11" groups="required" name="The static storage class specifier shall be used in definitions and declarations of objects and functions that have internal linkage."/>
- <rule id="8.12" groups="required" name="When an array is declared with external linkage, its size shall be stated explicitly or defined implicitly by initialization."/>
- </category>
-
- <category id="9" name="Initialization">
- <rule id="9.1" groups="required" name="All automatic variables shall have been assigned a value before being used."/>
- <rule id="9.2" groups="required" name="Braces shall be used to indicate and match the structure in the non-zero initialization of arrays and structures."/>
- <rule id="9.3" groups="required" name="In an enumerator list, the &quot;=&quot; construct shall not be used to explicitly initialize members other than the first, unless all items are explicitly initialized."/>
- </category>
-
- <category id="10" name="Arithmetic type conversions">
- <rule id="10.1" groups="required" name="The value of an expression of integer type shall not be implicitly converted to a different underlying type if: a) it is not a conversion to a wider integer type of the same signedness, or b) the expression is complex, or c) the expression is not constant and is a function argument, or d) the expression is not constant and is a return expression."/>
- <rule id="10.2" groups="required" name="The value of an expression of floating type shall not be implicitly converted to a different type if: a) it is not a conversion to a wider floating type, or b) the expression is complex, or c) the expression is a function argument, or d) the expression is a return expression."/>
- <rule id="10.3" groups="required" name="The value of a complex expression of integer type may only be cast to a type that is narrower and of the same signedness as the underlying type of the expression."/>
- <rule id="10.4" groups="required" name="The value of a complex expression of floating type may only be cast to a narrower floating type."/>
- <rule id="10.5" groups="required" name="If the bitwise operations ~ and &lt;&lt; are applied to an operand of underlying type unsigned char or unsigned short, the result shall immediately cast to the underlying type of the operand."/>
- <rule id="10.6" groups="required" name="A &quot;U&quot; suffix shall be applied to all constans of unsigned type."/>
- </category>
-
- <category id="11" name="Pointer type conversions">
- <rule id="11.1" groups="required" name="Conversions shall not be performed between a pointer to a function and any type other than an integral type."/>
- <rule id="11.2" groups="required" name="Conversions shall not be perfornmed between a pointer to object and any type other than an integral type, another pointer to object type or a pointer to void."/>
- <rule id="11.3" groups="advisory" name="A cast should not be performed between a pointer type and an integral type."/>
- <rule id="11.4" groups="advisory" name="A cast should not be performed between a pointer to object type and a different pointer to object type."/>
- <rule id="11.5" groups="required" name="A cast shall not be performed that removes any const or volatile qualifications from the type addressed by a pointer."/>
- </category>
-
- <category id="12" name="Expressions">
- <rule id="12.1" groups="advisory" name="Limited dependence should be placed on C's operator precedence rules in expressions."/>
- <rule id="12.2" groups="required" name="The value of an expression shall be the same under any order of evaluation that the standard permits."/>
- <rule id="12.3" groups="required" name="The sizeof operator shall not be used on expression that contain side effects."/>
- <rule id="12.4" groups="required" name="The right-hand operand of a logical &amp;&amp; or || operator shall not contain side effects."/>
- <rule id="12.5" groups="required" name="The operations of a logical &amp;&amp; or || shall be primary-expressions."/>
- <rule id="12.6" groups="advisory" name="The operands of logical operators (&amp;&amp;, || and !) should be effectively Boolean. Expressions that are effectively Boolean should not be used as operands to operators other than (&amp;&amp;, || and !)."/>
- <rule id="12.7" groups="required" name="Bitwise operators shall not be applied to operands whose underlying type is signed."/>
- <rule id="12.8" groups="required" name="The right-hand operand of a shift operator shall lie between zero and one less than the width in bits of the underlying type of the left-hand operand."/>
- <rule id="12.9" groups="required" name="The unary minus operator shall not be applied to an expression whose underlying type is unsigned."/>
- <rule id="12.10" groups="required" name="The comma operator shall not be used"/>
- <rule id="12.13" groups="advisory" name="The increment (++ and decrement (--) operators should not be mixed with other operators in an expression."/>
- </category>
-
- <category id="13" name="Control statement expressions">
- <rule id="13.1" groups="required" name="Assignment operators shall not be used in expressiopns that yield a Boolean value."/>
- <rule id="13.2" groups="advisory" name="Tests of a value against zero should be made explicit, unless the operand is effectively Boolean."/>
- <rule id="13.3" groups="required" name="Floating-point expressions shall not be tested for equality nor inequality."/>
- <rule id="13.4" groups="required" name="The controlling expression of a for statement shall not contain any objects of floating type."/>
- <rule id="13.5" groups="required" name="The three expressions of a for statement shall be concerned only with loop control."/>
- <rule id="13.6" groups="required" name="Numeric variables being used within a for loop for iteration counting shall not be modified in the body of the loop."/>
- </category>
-
- <category id="14" name="Control Flow">
- <rule id="14.1" groups="required" name="There shall be no unreachable code."/>
- <rule id="14.2" groups="required" name="All non-null statements shall either: a) have at least one side effect however executed, or b) cause cohntrol flow to change."/>
- <rule id="14.3" groups="required" name="Before preprocessing, a null statement shall only occur on a line by itself; it may be followed by a comment provided that the first character following the null statement is a white-space character."/>
- <rule id="14.4" groups="required" name="The goto statement shall not be used."/>
- <rule id="14.5" groups="required" name="The continue statement shall not be used."/>
- <rule id="14.6" groups="required" name="For any iteration statement there shall be at most one break statement used for loop termination."/>
- <rule id="14.7" groups="required" name="A function shall have a single point of exit at the end of the function."/>
- <rule id="14.8" groups="required" name="The statement forming the body of a switch, while, do ... while or for statement shall be a compound statement."/>
- <rule id="14.9" groups="required" name="An if (expression) construct shall be followed by a compound statement. The else keyword shall be followed by either a compound statement, or another if statement."/>
- <rule id="14.10" groups="required" name="All if ... else if constructs shall be terminated with an else clause."/>
- </category>
-
- <category id="15" name="Switch statements">
- <rule id="15.1" groups="required" name="A switch label shall only be used when the most closely-enclosing compound statement is the body of a switch statement."/>
- <rule id="15.2" groups="required" name="An unconditional break statement shall terminate every non-empty switch clause."/>
- <rule id="15.3" groups="required" name="The final clause of a switch statement sahll be the default clause."/>
- <rule id="15.4" groups="required" name="A switch statement shall not represent a value that is effectively Boolean."/>
- <rule id="15.5" groups="required" name="Every switch statement shall have at least one case clause."/>
- </category>
-
- <category id="16" name="Functions">
- <rule id="16.1" groups="required" name="Functions shall not be defined with variable numbers of arguments."/>
- <rule id="16.3" groups="required" name="Identifiers shall be given for all of the parameters in a functuion protoype declaration."/>
- <rule id="16.4" groups="required" name="The identifiers used in the declaration and definition of a function shall be identical."/>
- <rule id="16.5" groups="required" name="Functions with no parameters shall be declared with parameter type void."/>
- <rule id="16.7" groups="advisory" name="A pointer parameter in a function prototype shall be declared as pointer to const if the pointer is not used to modify the adressed object."/>
- <rule id="16.8" groups="required" name="All exit paths from a function with non-void return type shall have an explicit return statement with an expression."/>
- <rule id="16.9" groups="required" name="A function identifier shall only be used with either a preceding &amp;, or with a parenthesized parameter list, which may be empty."/>
- </category>
-
- <category id="17" name="Pointers and arrays">
- <rule id="17.4" groups="required" name="Array indexing shall be the only allowed form of pointer arithmetic."/>
- <rule id="17.5" groups="advisory" name="The declaration of objects should contain no more than 2 levels of pointer indirection."/>
- <rule id="17.6" groups="required" name="The address of an object with automatic storage shall not be assigned to another object that may persist after the first object has ceased to exist."/>
- </category>
-
- <category id="18" name="Structures and unions">
- <rule id="18.1" groups="required" name="All structure or union types shall be complete at the end of a translation unit."/>
- <rule id="18.4" groups="required" name="Unions shall not be used."/>
- </category>
-
- <category id="19" name="Preprocessing directives">
- <rule id="19.1" groups="advisory" name="#include statements in a file should only be preceded by other preprocessor directives or comments."/>
- <rule id="19.2" groups="advisory" name="Non-standard characters should not occur in header file hnames in #include directives."/>
- <rule id="19.3" groups="required" name="The #include directive shall be followed by either a &lt;filename&gt; or &quot;filename&quot; sequence."/>
- <rule id="19.4" groups="required" name="C macros shall only expand to a braced initializer, a constant, a parenthesized expression, a type qualifier, a storage class specifier, or a do-while-zero construct."/>
- <rule id="19.5" groups="required" name="Macros shall not be #define'd or #undef'd within a block."/>
- <rule id="19.6" groups="required" name="#undef shall not be used."/>
- <rule id="19.7" groups="advisory" name="A function should be used in preference to a function-like macro."/>
- <rule id="19.8" groups="required" name="A function-like macro shall not be invoked without all of its arguments."/>
- <rule id="19.9" groups="required" name="Arguments to a function-like macro shall not contain tokens that look like preprocessing directives."/>
- <rule id="19.10" groups="required" name="In the definition of a function-like macro each instance of a parameter shall be enclosed in parentheses unless it it used as the operand of # or ##."/>
- <rule id="19.11" groups="required" name="All macro identifiers in preprocessor directives shall be defined before use, except in #ifdef and #ifndef preprocessor directives and the defined() operator."/>
- <rule id="19.12" groups="required" name="There shall be at most one occurrence of the # or ## preprocessor operators in a single macro definition."/>
- <rule id="19.13" groups="advisory" name="The # and ## preprocessor operators should not be used."/>
- <rule id="19.14" groups="required" name="The defined preprocessor operator shall only be used in one of the two standard forms."/>
- <rule id="19.15" groups="required" name="Precautions shall be taken in order to prevent the contents of a header file being included twice."/>
- <rule id="19.16" groups="required" name="Preprocessoing directives shall be syntactically meaningful even when excluded by the preprocessor."/>
- <rule id="19.17" groups="required" name="All #else, #elif and #endif preprocessor directives shall reside in the same file as the #if or #ifdef directive to which they are related."/>
- </category>
-
- <category id="20" name="Standard libraries">
- <rule id="20.1" groups="required" name="Reserved identifiers, macros and functions in the standard library, shall not be defined, redefined or undefined."/>
- <rule id="20.2" groups="required" name="The names of standard library macros, obhjects and functions shall not be reused."/>
- <rule id="20.4" groups="required" name="Dynamic heap memory allocation shall not be used."/>
- <rule id="20.5" groups="required" name="The error indicator errno shall not be used."/>
- <rule id="20.6" groups="required" name="The macro offsetof, in library &lt;stddef.h&gt;, shall not be used."/>
- <rule id="20.7" groups="required" name="The setjmp macro and the longjmp function shall not be used."/>
- <rule id="20.8" groups="required" name="The signal handling facilities of &lt;signal.h&gt; shall not be used."/>
- <rule id="20.9" groups="required" name="The input/output library &lt;stdio.h&gt; shall not be used in production code."/>
- <rule id="20.10" groups="required" name="The library functions atof, atoi and atol from library &lt;stdlib.h&gt; shall not be used."/>
- <rule id="20.11" groups="required" name="The library functions abort, exit, getenv and system from library &lt;stdlib.h&gt; shall not be used."/>
- <rule id="20.12" groups="required" name="The time handling functions of library &lt;time.h&gt; shall not be used."/>
- </category>
-
- </body>
- </METADATA>
- </OPTION>
-
- <OPTION tag='CMD_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--cmd_file</NAME>
- <ALIAS>-@</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Read options from specified file </TIP>
- <HELP>Read additional compile options the specified filename.</HELP>
- </OPTION>
-
- <OPTION tag='COMPILE_ONLY'>
- <TYPE>cmdline</TYPE>
- <NAME>--compile_only</NAME>
- <ALIAS>-c</ALIAS>
- <TIP>Disable linking (overrides -z)</TIP>
- <HELP>Disable linking, overriding -z (if used).</HELP>
- </OPTION>
-
- <OPTION tag='COMPILER_REVISION'>
- <TYPE>cmdline</TYPE>
- <NAME>--compiler_revision</NAME>
- <TIP>Print compiler revision and exit</TIP>
- <HELP>Print out the compiler release revision and exit.</HELP>
- </OPTION>
-
- <OPTION tag='COPY_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--copy_file</NAME>
- <ALIAS>-ahc</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Simulate source '.copy filename'</TIP>
- <HELP>Simulate source '.copy filename'</HELP>
- </OPTION>
-
- <OPTION tag='CPP_DEFAULT'>
- <TYPE>simple</TYPE>
- <NAME>--cpp_default</NAME>
- <ALIAS>-fg</ALIAS>
- <TIP>Treat C files as C++ files</TIP>
- <HELP>Treat C files as C++ files</HELP>
- </OPTION>
-
- <OPTION tag='CPP_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--cpp_extension</NAME>
- <ALIAS>-ep</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for C++ files (default is .cpp)</TIP>
- <HELP>Extension for C++ files (default is .cpp)</HELP>
- </OPTION>
-
- <OPTION tag='CPP_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--cpp_file</NAME>
- <ALIAS>-fp</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>File is a C++ file (default for .C .cpp .cc)</TIP>
- <HELP>File is a C++ file (default for .C .cpp .cc)</HELP>
- </OPTION>
-
- <OPTION tag='CREATE_PCH'>
- <TYPE>simple</TYPE>
- <NAME>--create_pch</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Create a precompiled header file as named</TIP>
- <HELP>Create a precompiled header file with the name specified. This option specifies the filename for the precompiled header file. If this option is not used, the precompiled header file will use the primary source file name as its filename with .pch as suffix.</HELP>
- </OPTION>
-
- <OPTION tag='CROSS_REFERENCE'>
- <TYPE>simple</TYPE>
- <NAME>--cross_reference</NAME>
- <ALIAS>-ax</ALIAS>
- <TIP>Generate cross reference file</TIP>
- <HELP>Generate cross reference file</HELP>
- </OPTION>
-
- <OPTION tag='DEBUG_SOFTWARE_PIPELINE'>
- <TYPE>simple</TYPE>
- <NAME>--debug_software_pipeline</NAME>
- <ALIAS>-mw</ALIAS>
- <TIP>Generate verbose software pipelining information</TIP>
- <HELP>Generate verbose software pipelining information</HELP>
- <CHAIN>
- <TAG>KEEP_ASM</TAG>
- <TEXT>--keep_asm</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='DEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--define</NAME>
- <ALIAS>-D</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>NAME[=value]</DESCRIPTION>
- </ARG>
- <TIP>Pre-define NAME</TIP>
- <HELP>Pre-define a symbol with the id 'NAME', optionally setting it's contents to 'value'.</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_ERROR'>
- <TYPE>simple</TYPE>
- <NAME>--diag_error</NAME>
- <ALIAS>-pdse</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as error</TIP>
- <HELP>Treat diagnostic <id> as error</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_REMARK'>
- <TYPE>simple</TYPE>
- <NAME>--diag_remark</NAME>
- <ALIAS>-pdsr</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as remark</TIP>
- <HELP>Treat diagnostic <id> as remark</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_SUPPRESS'>
- <TYPE>simple</TYPE>
- <NAME>--diag_suppress</NAME>
- <ALIAS>-pds</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Suppress diagnostic <id></TIP>
- <HELP>Suppress diagnostic <id></HELP>
- </OPTION>
-
- <OPTION tag='DIAG_WARNING'>
- <TYPE>simple</TYPE>
- <NAME>--diag_warning</NAME>
- <ALIAS>-pdsw</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as warning</TIP>
- <HELP>Treat diagnostic <id> as warning</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_WRAP'>
- <TYPE>simple</TYPE>
- <NAME>--diag_wrap</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Wrap diagnostic messages</TIP>
- <HELP>Set diagnostic messages to wrap at 79 columns (on) or not (off).</HELP>
- </OPTION>
-
- <OPTION tag='DISABLE_PUSH_POP'>
- <TYPE>simple</TYPE>
- <NAME>--disable_push_pop</NAME>
- <TIP>Disable push-pop optimization.</TIP>
- <HELP>Disable code-size optimization that calls RTS functions _push_rts() and _pop_rts().</HELP>
- </OPTION>
-
- <OPTION tag='DISABLE_SOFTWARE_PIPELINE'>
- <TYPE>simple</TYPE>
- <NAME>--disable_software_pipeline</NAME>
- <ALIAS>-mu</ALIAS>
- <TIP>Disable software pipelining</TIP>
- <HELP>Disable software pipelining</HELP>
- </OPTION>
-
- <OPTION tag='DISPLAY_ERROR_NUMBER'>
- <TYPE>simple</TYPE>
- <NAME>--display_error_number</NAME>
- <ALIAS>-pden</ALIAS>
- <TIP>Emit diagnostic identifier numbers</TIP>
- <HELP>Emit the diagnostic identifier numbers along with diagnostic messages. These identifiers can be used with options such as -pds to suppress a specific diagnostic.</HELP>
- </OPTION>
-
- <OPTION tag='DPREL'>
- <TYPE>simple</TYPE>
- <NAME>--dprel</NAME>
- <TIP>Always use DP-relative addressing for data (ELF only)</TIP>
- <HELP>Always use DP-relative addressing for data (ELF only)</HELP>
- </OPTION>
-
- <OPTION tag='DSBT'>
- <TYPE>simple</TYPE>
- <NAME>--dsbt</NAME>
- <TIP>Generate addressing via Dynamic Segment Base Table</TIP>
- <HELP>This option causes the compiler to load the DP from the Data Segment Address Table (DBST) for every function marked exported. This allows each dynamic object to have its own near DP segment and allows efficient near DP addressing in each dynamic module.</HELP>
- </OPTION>
-
- <OPTION tag='EMBEDDED_CPP'>
- <TYPE>simple</TYPE>
- <NAME>--embedded_cpp</NAME>
- <ALIAS>-pe</ALIAS>
- <TIP>Embedded C++</TIP>
- <HELP>Enable support for embedded C++</HELP>
- <RESETS>CPLUSPLUS03</RESETS>
- </OPTION>
-
- <OPTION tag='EMIT_WARNINGS_AS_ERRORS'>
- <TYPE>simple</TYPE>
- <NAME>--emit_warnings_as_errors</NAME>
- <ALIAS>-pdew</ALIAS>
- <TIP>Treat warnings as errors</TIP>
- <HELP>Treat warnings as errors</HELP>
- <CONFLICT>NO_WARNINGS</CONFLICT>
- </OPTION>
-
- <OPTION tag='ENTRY_HOOK'>
- <TYPE>simple</TYPE>
- <NAME>--entry_hook</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>hook_function_name</DESCRIPTION>
- <DEFAULT>__entry_hook</DEFAULT>
- </ARG>
- <TIP>Insert this call at entry to each function</TIP>
- <HELP>Insert this call at entry to each function</HELP>
- </OPTION>
-
- <OPTION tag='ENTRY_PARM'>
- <TYPE>simple</TYPE>
- <NAME>--entry_parm</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>name,address,none</DESCRIPTION>
- <ONEOF>name</ONEOF>
- <ONEOF>address</ONEOF>
- <ONEOF>none</ONEOF>
- </ARG>
- <TIP>Pass caller's name or address to entry hook</TIP>
- <HELP>Pass caller's name or address to entry hook</HELP>
- </OPTION>
-
- <OPTION tag='EXCEPTIONS'>
- <TYPE>simple</TYPE>
- <NAME>--exceptions</NAME>
- <TIP>Enable C++ exception handling</TIP>
- <HELP>Enable C++ exception handling</HELP>
- <CHAIN>
- <TAG>RTTI</TAG>
- <TEXT>--rtti</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>DISABLE_CUSTOM_CALL_CONV</TAG>
- <TEXT>--disable_custom_call_conv</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='EXIT_HOOK'>
- <TYPE>simple</TYPE>
- <NAME>--exit_hook</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>hook_function_name</DESCRIPTION>
- <DEFAULT>__exit_hook</DEFAULT>
- </ARG>
- <TIP>Insert this call at exit from each function</TIP>
- <HELP>Insert this call at exit from each function</HELP>
- </OPTION>
-
- <OPTION tag='EXIT_PARM'>
- <TYPE>simple</TYPE>
- <NAME>--exit_parm</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>name,address,none</DESCRIPTION>
- <ONEOF>name</ONEOF>
- <ONEOF>address</ONEOF>
- <ONEOF>none</ONEOF>
- </ARG>
- <TIP>Pass caller's name or address to exit hook</TIP>
- <HELP>Pass caller's name or address to exit hook</HELP>
- </OPTION>
-
- <OPTION tag='EXPORT_ALL_CPP_VTBL'>
- <TYPE>simple</TYPE>
- <NAME>--export_all_cpp_vtbl</NAME>
- <TIP>Export C++ virtual tables by default</TIP>
- <HELP>If a c++ class is not exported, its virtual table and typeinfo are not exported. This option exports these symbols for all classes.</HELP>
- </OPTION>
-
- <OPTION tag='EXTERN_C_CAN_THROW'>
- <TYPE>simple</TYPE>
- <NAME>--extern_c_can_throw</NAME>
- <TIP>Allow extern C functions to propagate exceptions</TIP>
- <HELP>This option is only supported under EABI for table-driven exception handling (TDEH). This option is valid only when `--exceptions` is also present. This option allows a function defined in C++ with extern `C` linkage to propagate exceptions.</HELP>
- </OPTION>
-
- <OPTION tag='FLOAT_OPERATIONS_ALLOWED'>
- <TYPE>simple</TYPE>
- <NAME>--float_operations_allowed</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>all,32,64,none</DESCRIPTION>
- <ONEOF>all</ONEOF>
- <ONEOF>32</ONEOF>
- <ONEOF>64</ONEOF>
- <ONEOF>none</ONEOF>
- </ARG>
- <TIP>Floating point precision accepted by compiler</TIP>
- <HELP>Control the acceptable precision of floating point operations. The default is all.</HELP>
- </OPTION>
-
- <OPTION tag='FP_MODE'>
- <TYPE>simple</TYPE>
- <NAME>--fp_mode</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>relaxed,strict</DESCRIPTION>
- <ONEOF>relaxed</ONEOF>
- <ONEOF>strict</ONEOF>
- <DEFAULT>strict</DEFAULT>
- </ARG>
- <TIP>Floating Point mode</TIP>
- <HELP>Specify a floating point mode. In relaxed mode if the result of a double-precision floating point expression is assigned to a single-precision floating-point or an integer, the computations in the expression are converted to single-precision computations. Any double-precision constants in the expression are also converted to single-precision if they will fit. Hardware instructions may replace floating point library calls when available. Floating point arithmetic reassociation is also allowed. This behavior is not ISO conformant, but results in faster/smaller code, with some loss in accuracy.</HELP>
- </OPTION>
-
- <OPTION tag='FP_NOT_ASSOCIATIVE'>
- <TYPE>simple</TYPE>
- <NAME>--fp_not_associative</NAME>
- <ALIAS>-mc</ALIAS>
- <TIP>Do not reorder floating point operations</TIP>
- <HELP>Do not reorder floating point operations</HELP>
- <CHAIN>
- <TAG>FP_REASSOC</TAG>
- <TEXT>--fp_reassoc=off</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='FP_REASSOC'>
- <TYPE>simple</TYPE>
- <NAME>--fp_reassoc</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Allow reassociation of FP arithmetic</TIP>
- <HELP>Set to on to allow reassociation of floating point arithmetic even in cases where the reassociation will result in a slightly different answer.</HELP>
- </OPTION>
-
- <OPTION tag='GCC'>
- <TYPE>simple</TYPE>
- <NAME>--gcc</NAME>
- <TIP>Enable support for GCC extensions (DEPRECATED)</TIP>
- <HELP>This option enables the support for GCC extensions. This feature is incompatible with strict ANSI mode.</HELP>
- <CHAIN>
- <TAG>RELAXED_ANSI</TAG>
- <TEXT>--relaxed_ansi</TEXT>
- </CHAIN>
- <CONFLICT>STRICT_ANSI</CONFLICT>
- </OPTION>
-
- <OPTION tag='GEN_ACP_RAW'>
- <TYPE>simple</TYPE>
- <NAME>--gen_acp_raw</NAME>
- <ALIAS>-pl</ALIAS>
- <TIP>Output raw listing to .rl file</TIP>
- <HELP>Output raw listing to .rl file</HELP>
- </OPTION>
-
- <OPTION tag='GEN_ACP_XREF'>
- <TYPE>simple</TYPE>
- <NAME>--gen_acp_xref</NAME>
- <ALIAS>-px</ALIAS>
- <TIP>Output xref listing to .crl file</TIP>
- <HELP>Output xref listing to .crl file</HELP>
- </OPTION>
-
- <OPTION tag='GEN_FUNC_SUBSECTIONS'>
- <TYPE>simple</TYPE>
- <NAME>--gen_func_subsections</NAME>
- <ALIAS>-mo</ALIAS>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Place each function in a separate subsection</TIP>
- <HELP>Place each function in a separate subsection</HELP>
- <OVERRIDES>USE_DEAD_FUNCS_LIST</OVERRIDES>
- <OVERRIDES>RAMFUNC</OVERRIDES>
- </OPTION>
-
- <OPTION tag='GEN_OPT_INFO'>
- <TYPE>simple</TYPE>
- <NAME>--gen_opt_info</NAME>
- <ALIAS>-on</ALIAS>
- <ARG>
- <TYPE>RANGE</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>0-2</DESCRIPTION>
- <RANGE low='0' high='2'/>
- </ARG>
- <TIP>Generate optimizer information file at level [0-2]</TIP>
- <HELP>Set the optimizer information file level, or disable with 0. Level 1 includes basic information. Level 2 includes detailed information. The file will be created in the assembly directory if a custom asm directory is specified on the command line otherwise it will be created in the object file directory.</HELP>
- </OPTION>
-
- <OPTION tag='GEN_PROFILE_INFO'>
- <TYPE>simple</TYPE>
- <NAME>--gen_profile_info</NAME>
- <TIP>Generate profile feedback data</TIP>
- <HELP>Instrument the object code that is generated for a compilation with path profiling information. The compiler will annotate the code that is generated for an application so that, when executed, the application can generate information about which code paths were executed and how often. This profile data can then be used by subsequent compiles to analyze code coverage or call graph information to assist with subsequent development.</HELP>
- <CONFLICT>ANALYZE</CONFLICT>
- <CONFLICT>USE_PROFILE_INFO</CONFLICT>
- </OPTION>
-
- <OPTION tag='HELP'>
- <TYPE>cmdline</TYPE>
- <NAME>--help</NAME>
- <ALIAS>-h</ALIAS>
- <TIP>Show help screen</TIP>
- <HELP>Show usage information. When followed by another option or a phrase display that option's detailed information, or search for options related to that phrase.</HELP>
- </OPTION>
-
- <OPTION tag='IMPORT_HELPER_FUNCTIONS'>
- <TYPE>simple</TYPE>
- <NAME>--import_helper_functions</NAME>
- <TIP>Treat compiler helper functions as imported refs</TIP>
- <HELP>This option tells the compiler to treat calls to compiler helper functions as imported references. Compiler helper functions are part of the runtime support library. This option is useful in platforms that support dynamic shared objects (DSO/DLL) where the OS can provide runtime support in a shared object. Without this option, the compiler treats helper function calls as non-imported references and the supporting runtime functions are statically linked in by the static linker.</HELP>
- </OPTION>
-
- <OPTION tag='IMPORT_UNDEF'>
- <TYPE>simple</TYPE>
- <NAME>--import_undef</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Import all undefined symbols</TIP>
- <HELP>This option imports all undefined symbols.</HELP>
- </OPTION>
-
- <OPTION tag='INCLUDE_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--include_file</NAME>
- <ALIAS>-ahi</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Simulate source '.include filename'</TIP>
- <HELP>Simulate source '.include filename'</HELP>
- </OPTION>
-
- <OPTION tag='INCLUDE_PATH'>
- <TYPE>simple</TYPE>
- <NAME>--include_path</NAME>
- <ALIAS>-I</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Add dir to #include search path</TIP>
- <HELP>Add the specified dir(ectory) to the #include file search path list.</HELP>
- </OPTION>
-
- <OPTION tag='INLINE_PLT'>
- <TYPE>simple</TYPE>
- <NAME>--inline_plt</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Inline the import function call stub.</TIP>
- <HELP>The linker generates an import function call stub to call an imported function. This linker generated call stub is called 'Procedure Linkage Table' (PLT) entry. The PLT entry is similar to a trampoline. The performance of the generated code can be improved if the PLT entry is inlined. This option makes the compiler inline the PLT. Note that the use of this option can increase the code size in some cases. Also the dynamic load time can increase as the dynamic linker needs to patch more entries</HELP>
- </OPTION>
-
- <OPTION tag='INTERRUPT_THRESHOLD'>
- <TYPE>simple</TYPE>
- <NAME>--interrupt_threshold</NAME>
- <ALIAS>-mi</ALIAS>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>#</DESCRIPTION>
- </ARG>
- <TIP>Specify maximum disabled interrupt cycles</TIP>
- <HELP>Specify the maximum number of cycles that interrupts may be disabled.</HELP>
- </OPTION>
-
- <OPTION tag='ISSUE_REMARKS'>
- <TYPE>simple</TYPE>
- <NAME>--issue_remarks</NAME>
- <ALIAS>-pdr</ALIAS>
- <TIP>Issue remarks</TIP>
- <HELP>Issue remarks, which are normally suppressed.</HELP>
- </OPTION>
-
- <OPTION tag='KEEP_ASM'>
- <TYPE>simple</TYPE>
- <NAME>--keep_asm</NAME>
- <PREFERREDALIAS>-k</PREFERREDALIAS>
- <TIP>Keep the generated assembly language (.asm) file</TIP>
- <HELP>Keep the generated assembly language (.asm) file</HELP>
- </OPTION>
-
- <OPTION tag='KEEP_UNNEEDED_STATICS'>
- <TYPE>simple</TYPE>
- <NAME>--keep_unneeded_statics</NAME>
- <TIP>Do not delete unreferenced static variables</TIP>
- <HELP>The parser, by default, will remark about and then remove any unreferenced static variables. This option will keep the parser from deleting unreferenced static variables and any static functions that are, in turn referenced by these variables.</HELP>
- </OPTION>
-
- <OPTION tag='KR_COMPATIBLE'>
- <TYPE>simple</TYPE>
- <NAME>--kr_compatible</NAME>
- <ALIAS>-pk</ALIAS>
- <TIP>K & R compatibility</TIP>
- <HELP>Enable K & R C compatibility.</HELP>
- <RESETS>C89</RESETS>
- <RESETS>C99</RESETS>
- </OPTION>
-
- <OPTION tag='LINUX'>
- <TYPE>simple</TYPE>
- <NAME>--linux</NAME>
- <TIP>Generate code for Linux</TIP>
- <HELP>Set all the necessary options to build code for Linux.</HELP>
- <CHAIN>
- <TAG>ABI</TAG>
- <TEXT>--abi=eabi</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>DSBT</TAG>
- <TEXT>--dsbt</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>GEN_PIC</TAG>
- <TEXT>--gen_pic</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>STATIC_TLS</TAG>
- <TEXT>--static_tls=off</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='LIST_DIRECTORY'>
- <TYPE>simple</TYPE>
- <NAME>--list_directory</NAME>
- <ALIAS>-ff</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Listing/xref file directory (default is .obj dir)</TIP>
- <HELP>Listing/xref file directory (default is .obj dir)</HELP>
- <CHAIN>
- <TAG>ASM_LISTING</TAG>
- <TEXT>--asm_listing</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='LISTING_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--listing_extension</NAME>
- <ALIAS>-es</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for listing files (default is .lst)</TIP>
- <HELP>Extension for listing files (default is .lst)</HELP>
- </OPTION>
-
- <OPTION tag='LLOPT'>
- <TYPE>simple</TYPE>
- <NAME>--llopt</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>0,1,2,3</DESCRIPTION>
- <ONEOF>0</ONEOF>
- <ONEOF>1</ONEOF>
- <ONEOF>2</ONEOF>
- <ONEOF>3</ONEOF>
- </ARG>
- <TIP>LLVM Optimization Level</TIP>
- <HELP>Run LLVM with specified optimization level</HELP>
- </OPTION>
-
- <OPTION tag='MACHINE_REGS'>
- <TYPE>simple</TYPE>
- <NAME>--machine_regs</NAME>
- <TIP>Display reg operands as machine registers in asm</TIP>
- <HELP>When compiling linear assembly, register operands can be displayed in the assembly file as either machine registers or symbolic registers. Symbolic registers is the default. Use this option to display machine registers in the assembly file when compiling linear assembly. When compiling C/C++ machine registers are the default.</HELP>
- </OPTION>
-
- <OPTION tag='MEM_MODEL__CONST'>
- <TYPE>simple</TYPE>
- <NAME>--mem_model:const</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>data,far,far_aggregates</DESCRIPTION>
- <ONEOF>data</ONEOF>
- <ONEOF>far</ONEOF>
- <ONEOF>far_aggregates</ONEOF>
- <DEFAULT>data</DEFAULT>
- </ARG>
- <TIP>Const access model</TIP>
- <HELP>Const access model</HELP>
- </OPTION>
-
- <OPTION tag='MEM_MODEL__DATA'>
- <TYPE>simple</TYPE>
- <NAME>--mem_model:data</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>near,far,far_aggregates</DESCRIPTION>
- <ONEOF>near</ONEOF>
- <ONEOF>far</ONEOF>
- <ONEOF>far_aggregates</ONEOF>
- <DEFAULT>far_aggregates</DEFAULT>
- </ARG>
- <TIP>Data access model</TIP>
- <HELP>Data access model</HELP>
- </OPTION>
-
- <OPTION tag='MISRA_ADVISORY'>
- <TYPE>simple</TYPE>
- <NAME>--misra_advisory</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>error,warning,remark,suppress</DESCRIPTION>
- <ONEOF>error</ONEOF>
- <ONEOF>warning</ONEOF>
- <ONEOF>remark</ONEOF>
- <ONEOF>suppress</ONEOF>
- </ARG>
- <TIP>Set severity of MISRA 'advisory' rule class</TIP>
- <HELP>Set diagnostic severity level for the MISRA advisory class of rules. See the --check_misra option for further information.</HELP>
- </OPTION>
-
- <OPTION tag='MISRA_REQUIRED'>
- <TYPE>simple</TYPE>
- <NAME>--misra_required</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>error,warning,remark,suppress</DESCRIPTION>
- <ONEOF>error</ONEOF>
- <ONEOF>warning</ONEOF>
- <ONEOF>remark</ONEOF>
- <ONEOF>suppress</ONEOF>
- </ARG>
- <TIP>Set severity of MISRA 'required' rule class</TIP>
- <HELP>Set the diagnostic severity level for the MISRA required class of rules. See the --check_misra option for further information.</HELP>
- </OPTION>
-
- <OPTION tag='MULTIBYTE_CHARS'>
- <TYPE>simple</TYPE>
- <NAME>--multibyte_chars</NAME>
- <ALIAS>-pc</ALIAS>
- <TIP>Multibyte character support</TIP>
- <HELP>Enable parser support for multibyte character sequences in comments, string literals, and character constants.</HELP>
- </OPTION>
-
- <OPTION tag='MULTITHREAD'>
- <TYPE>simple</TYPE>
- <NAME>--multithread</NAME>
- <TIP>Multi-threading is assumed</TIP>
- <HELP>Indicate that application uses multi-threading or prefers to be linked with a thread-safe version of the RTS library</HELP>
- <CHAIN>
- <TAG>USE_LIBC_TLS</TAG>
- <TEXT>--use_libc_tls</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='NO_BAD_ALIASES'>
- <TYPE>simple</TYPE>
- <NAME>--no_bad_aliases</NAME>
- <ALIAS>-mt</ALIAS>
- <TIP>Assume no irregular alias or loop behavior</TIP>
- <HELP>Assume no irregular alias or loop behavior</HELP>
- </OPTION>
-
- <OPTION tag='NO_COMPRESS'>
- <TYPE>simple</TYPE>
- <NAME>--no_compress</NAME>
- <TIP>Disable compression for 6400+</TIP>
- <HELP>This option disables compression (use of 16-bit instructions) for 6400+. It also tells the assembler to (1) prevent labeled execute packets from spanning fetch packet boundaries, (2) pad the end of code sections to 32-byte boundaries, and (3) handle .align directives. Normally for 6400+, these are the responsibilities of the compressor (cmp6x).</HELP>
- </OPTION>
-
- <OPTION tag='NO_CONST_CLINK'>
- <TYPE>simple</TYPE>
- <NAME>--no_const_clink</NAME>
- <TIP>Do not generate .clink for .const sections</TIP>
- <HELP>Do not generate .clink directives for const global arrays. By default these arrays are placed in a .const subsection and conditionally linked.</HELP>
- </OPTION>
-
- <OPTION tag='NO_INLINING'>
- <TYPE>simple</TYPE>
- <NAME>--no_inlining</NAME>
- <ALIAS>-pi</ALIAS>
- <TIP>Ignore inline keyword</TIP>
- <HELP>Ignore the inline keyword while parsing.</HELP>
- </OPTION>
-
- <OPTION tag='NO_INTRINSICS'>
- <TYPE>simple</TYPE>
- <NAME>--no_intrinsics</NAME>
- <ALIAS>-pn</ALIAS>
- <TIP>Disable intrinsic functions</TIP>
- <HELP>Disable intrinsic functions in the parser.</HELP>
- </OPTION>
-
- <OPTION tag='NO_RELOAD_ERRORS'>
- <TYPE>simple</TYPE>
- <NAME>--no_reload_errors</NAME>
- <TIP>Prevent loop buffer reload-related error detection</TIP>
- <HELP>Prevent detection of loop buffer reload-related errors. Accept loop buffer assembly code that would normally cause the assembler to issue loop buffer reload-related errors.</HELP>
- </OPTION>
-
- <OPTION tag='NO_WARNINGS'>
- <TYPE>simple</TYPE>
- <NAME>--no_warnings</NAME>
- <ALIAS>-pdw</ALIAS>
- <TIP>Suppress warnings</TIP>
- <HELP>Suppress all parser warnings.</HELP>
- <CONFLICT>EMIT_WARNINGS_AS_ERRORS</CONFLICT>
- </OPTION>
-
- <OPTION tag='OBJ_DIRECTORY'>
- <TYPE>simple</TYPE>
- <NAME>--obj_directory</NAME>
- <ALIAS>-fr</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Object file directory (default is .)</TIP>
- <HELP>Object file directory (default is .)</HELP>
- </OPTION>
-
- <OPTION tag='OBJ_EXTENSION'>
- <TYPE>simple</TYPE>
- <NAME>--obj_extension</NAME>
- <ALIAS>-eo</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>.ext</DESCRIPTION>
- </ARG>
- <TIP>Extension for object files (default is .obj)</TIP>
- <HELP>Extension for object files (default is .obj)</HELP>
- <CONFLICT>OUTPUT_FILE</CONFLICT>
- </OPTION>
-
- <OPTION tag='OBJ_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--obj_file</NAME>
- <ALIAS>-fo</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>File is an object file (default for .obj)</TIP>
- <HELP>File is an object file (default for .obj)</HELP>
- </OPTION>
-
- <OPTION tag='OPENMP'>
- <TYPE>simple</TYPE>
- <NAME>--openmp</NAME>
- <ALIAS>--omp</ALIAS>
- <TIP>Enable support for OpenMP 3.0</TIP>
- <HELP>Enable support for OpenMP 3.0</HELP>
- <CHAIN>
- <TAG>MULTITHREAD</TAG>
- <TEXT>--multithread</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='OPT_FOR_SPACE'>
- <TYPE>simple</TYPE>
- <NAME>--opt_for_space</NAME>
- <PREFERREDALIAS>-ms</PREFERREDALIAS>
- <ARG>
- <TYPE>RANGE</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>0-3</DESCRIPTION>
- <RANGE low='0' high='3'/>
- <DEFAULT>0</DEFAULT>
- </ARG>
- <TIP>Optimize for code size</TIP>
- <HELP>Optimize for code size</HELP>
- </OPTION>
-
- <OPTION tag='OPT_FOR_SPEED'>
- <TYPE>simple</TYPE>
- <NAME>--opt_for_speed</NAME>
- <ALIAS>-mf</ALIAS>
- <ARG>
- <TYPE range_type='slider'>RANGE</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>0-5</DESCRIPTION>
- <RANGE low='0' low_description='size' high='5' high_description='speed'/>
- <DEFAULT>4</DEFAULT>
- </ARG>
- <TIP>Speed vs. size trade-offs </TIP>
- <HELP>Control speed vs. size trade-offs in optimization. A value of 5 indicates fully optimizing for speed with a potentially large code size penalty, while a value of 0 indicates fully optimizing for size. Values between 0 and 5 indicate trade-offs between the two extremes.</HELP>
- </OPTION>
-
- <OPTION tag='OPT_LEVEL'>
- <TYPE>simple</TYPE>
- <NAME>--opt_level</NAME>
- <PREFERREDALIAS>-O</PREFERREDALIAS>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>off,0,1,2,3</DESCRIPTION>
- <ONEOF>off</ONEOF>
- <ONEOF description='Register Optimizations'>0</ONEOF>
- <ONEOF description='Local Optimizations'>1</ONEOF>
- <ONEOF description='Global Optimizations'>2</ONEOF>
- <ONEOF description='Interprocedure Optimizations'>3</ONEOF>
- <DEFAULT>2</DEFAULT>
- </ARG>
- <TIP>Optimization level</TIP>
- <HELP>Set compiler optimization level.
- Level 0 includes register optimizations. Level 1 adds local optimizations. Level 2 further adds global optimizations. Level 3 further adds interprocedure optimizations.</HELP>
- </OPTION>
-
- <OPTION tag='OPTIMIZE_WITH_DEBUG'>
- <TYPE>simple</TYPE>
- <NAME>--optimize_with_debug</NAME>
- <ALIAS>-mn</ALIAS>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Optimize fully in the presence of debug (DEPRECATED)</TIP>
- <HELP>Optimize fully in the presence of debug (DEPRECATED)</HELP>
- </OPTION>
-
- <OPTION tag='OUTPUT_ALL_SYMS'>
- <TYPE>simple</TYPE>
- <NAME>--output_all_syms</NAME>
- <ALIAS>-as</ALIAS>
- <TIP>Keep local symbols in output file</TIP>
- <HELP>Keep local symbols in output file</HELP>
- </OPTION>
-
- <OPTION tag='OUTPUT_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--output_file</NAME>
- <ALIAS>-fe</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Compilation output file name, can override --obj_directory</TIP>
- <HELP>Compilation output file name, can override --obj_directory</HELP>
- <CONFLICT>OBJ_EXTENSION</CONFLICT>
- </OPTION>
-
- <OPTION tag='PCH'>
- <TYPE>simple</TYPE>
- <NAME>--pch</NAME>
- <TIP>Automatically create/use precompiled headers</TIP>
- <HELP>Automatically create and/or use precompiled header files. This option will enable EDG parser to provide a mechanism for, in effect, taking a snapshot of the state of the compilation at a particular point and writing it to a disk file before completing the parsing; then, when recompiling the same source file or compiling another file with the same set of header files, it can recognize the `snapshot point`, and reload this file instead of recompile these headers. In this way, compilation time can be reduced.</HELP>
- </OPTION>
-
- <OPTION tag='PCH_DIR'>
- <TYPE>simple</TYPE>
- <NAME>--pch_dir</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Specify precompiled header path</TIP>
- <HELP>Specify path where precompiled header file will reside. This option will direct the parser to put the generated precompiled header file in the specified directory. If this option is not used, the precompiled header file will be put into the same directory as the primary source file</HELP>
- </OPTION>
-
- <OPTION tag='PCH_VERBOSE'>
- <TYPE>simple</TYPE>
- <NAME>--pch_verbose</NAME>
- <TIP>Info on considered & unused precompiled headers</TIP>
- <HELP>This option displays a message for each precompiled header file that is considered but can not be used. It also gives the reason why it can not be used.</HELP>
- </OPTION>
-
- <OPTION tag='PENDING_INSTANTIATIONS'>
- <TYPE>simple</TYPE>
- <NAME>--pending_instantiations</NAME>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>#</DESCRIPTION>
- </ARG>
- <TIP>limit pending template instantiations</TIP>
- <HELP>The number of template instantiations that may be in progress at any given time. Use 0 to specify an unlimited number.</HELP>
- </OPTION>
-
- <OPTION tag='PIC'>
- <TYPE>simple</TYPE>
- <NAME>--pic</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>near,far</DESCRIPTION>
- <ONEOF>near</ONEOF>
- <ONEOF>far</ONEOF>
- <DEFAULT>near</DEFAULT>
- </ARG>
- <TIP>Position-independent addressing for a shared object</TIP>
- <HELP>Generate position-independent addressing for a dynamic shared object. All externally visible objects will be addressed through a Global Offset Table (GOT).</HELP>
- <CHAIN>
- <TAG>DSBT</TAG>
- <TEXT>--dsbt</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='PP_DIRECTORY'>
- <TYPE>cmdline</TYPE>
- <NAME>--pp_directory</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Preprocessor file directory (default is .)</TIP>
- <HELP>Place preprocessor output files in specified directory. The directory must exist prior to compiler invocation.</HELP>
- </OPTION>
-
- <OPTION tag='PREINCLUDE'>
- <TYPE>simple</TYPE>
- <NAME>--preinclude</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Specify a preinclude file</TIP>
- <HELP>Include the source code of the indicated file at the beginning of the compilation. This can be used to establish standard macro definitions, etc. The file name is searched for in the directories on the include search list. The files are processed in the order in which they were specified.</HELP>
- </OPTION>
-
- <OPTION tag='PREPROC_DEPENDENCY'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_dependency</NAME>
- <ALIAS>-ppd</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Generate include file dependency information</TIP>
- <HELP>Generate a dependency list for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include all files included in the source file as well as any of the files included. Also see the -ppa option to continue compilation after generating the dependency list (similar to gcc).</HELP>
- <CONFLICT>PREPROC_ONLY</CONFLICT>
- <CONFLICT>PREPROC_WITH_LINE</CONFLICT>
- <CONFLICT>PREPROC_WITH_COMMENT</CONFLICT>
- <OVERRIDES>PREPROC_INCLUDES</OVERRIDES>
- <OVERRIDES>PREPROC_MACROS</OVERRIDES>
- </OPTION>
-
- <OPTION tag='PREPROC_INCLUDES'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_includes</NAME>
- <ALIAS>-ppi</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Generate first-level include file list</TIP>
- <HELP>Generate an include list for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include only those files directly included by the source file. Also see the -ppa option to continue compilation after generating the include list (similar to gcc).</HELP>
- <CONFLICT>PREPROC_ONLY</CONFLICT>
- <CONFLICT>PREPROC_WITH_COMMENT</CONFLICT>
- <CONFLICT>PREPROC_WITH_LINE</CONFLICT>
- <OVERRIDES>PREPROC_MACROS</OVERRIDES>
- <OVERRIDES>PREPROC_DEPENDENCY</OVERRIDES>
- </OPTION>
-
- <OPTION tag='PREPROC_MACROS'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_macros</NAME>
- <ALIAS>-ppm</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Generate list of pre- & user-defined macros</TIP>
- <HELP>Generate a list of predefined and user defined macros for the source file into the file <filename>.pp and then exit. Optionally, name the output file. The output will include only those files directly included by the source file. Also see the -ppa option to continue compilation after generating the macro list (similar to gcc).</HELP>
- <CONFLICT>PREPROC_ONLY</CONFLICT>
- <CONFLICT>PREPROC_WITH_COMMENT</CONFLICT>
- <CONFLICT>PREPROC_WITH_LINE</CONFLICT>
- <OVERRIDES>PREPROC_INCLUDES</OVERRIDES>
- <OVERRIDES>PREPROC_DEPENDENCY</OVERRIDES>
- </OPTION>
-
- <OPTION tag='PREPROC_ONLY'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_only</NAME>
- <ALIAS>-ppo</ALIAS>
- <TIP>Preprocess only</TIP>
- <HELP>Only preprocess the source file(s) and then stop.</HELP>
- <CONFLICT>PREPROC_INCLUDES</CONFLICT>
- <CONFLICT>PREPROC_MACROS</CONFLICT>
- <CONFLICT>PREPROC_DEPENDENCY</CONFLICT>
- </OPTION>
-
- <OPTION tag='PREPROC_WITH_COMMENT'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_with_comment</NAME>
- <ALIAS>-ppc</ALIAS>
- <TIP>Preprocess only; maintain comments</TIP>
- <HELP>Only preprocess the source file(s) and then stop; maintain source comments in the output.</HELP>
- <CONFLICT>PREPROC_INCLUDES</CONFLICT>
- <CONFLICT>PREPROC_MACROS</CONFLICT>
- <CONFLICT>PREPROC_DEPENDENCY</CONFLICT>
- </OPTION>
-
- <OPTION tag='PREPROC_WITH_COMPILE'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_with_compile</NAME>
- <ALIAS>-ppa</ALIAS>
- <TIP>Continue compilation after using -pp<X> options.</TIP>
- <HELP>This option instructs the compiler to additionally continue compilation of the source file (rather than exiting) after generating a pre-processing .pp output file such as those generated by -ppd (dependencies) -ppi (included files), or -ppm (macros).</HELP>
- </OPTION>
-
- <OPTION tag='PREPROC_WITH_LINE'>
- <TYPE>cmdline</TYPE>
- <NAME>--preproc_with_line</NAME>
- <ALIAS>-ppl</ALIAS>
- <TIP>Preprocess only; maintain line directives</TIP>
- <HELP>Only preprocess the source file(s) and then stop; maintain #line directives in the output..</HELP>
- <CONFLICT>PREPROC_DEPENDENCY</CONFLICT>
- <CONFLICT>PREPROC_INCLUDES</CONFLICT>
- <CONFLICT>PREPROC_MACROS</CONFLICT>
- </OPTION>
-
- <OPTION tag='PRINTF_SUPPORT'>
- <TYPE>simple</TYPE>
- <NAME>--printf_support</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>nofloat,minimal,full</DESCRIPTION>
- <ONEOF>nofloat</ONEOF>
- <ONEOF>minimal</ONEOF>
- <ONEOF>full</ONEOF>
- </ARG>
- <TIP>Level of printf/scanf support required</TIP>
- <HELP>The printf and scanf families of functions are large because they provide complex formatting capabilities, which may not be required in typical embedded applications. Use this option to reduce code size by eliminating features. This option must be specified at link time.
- Use '--printf_support=nofloat' to exclude support for printing and scanning floating values. All format specifiers except %f, %F, %g, %G, %e, and %E are supported.
- Use '--printf_support=minimal' to exclude support for width and precision flags and all format specifiers except %%, %d %o, %c, %s, and %x.</HELP>
- </OPTION>
-
- <OPTION tag='PROFILE__BREAKPT'>
- <TYPE>simple</TYPE>
- <NAME>--profile:breakpt</NAME>
- <TIP>Compile for breakpoint-based profiling</TIP>
- <HELP>Disable optimizations that cannot be handled by a breakpoint-based profiler</HELP>
- <CONFLICT>SYMDEBUG__NONE</CONFLICT>
- </OPTION>
-
- <OPTION tag='PROFILE__POWER'>
- <TYPE>simple</TYPE>
- <NAME>--profile:power</NAME>
- <TIP>Compile for power profiling</TIP>
- <HELP>Enable power profiling support by inserting NOPs into the frame code. These NOPs can then be instrumented by the power profiling tooling to track power usage of functions. If the power profiling tool is not used, this option will increase the cycle count of each function because of the NOPs. This switch also disables optimizations that cannot be handled by the power-profiler.</HELP>
- <CONFLICT>SYMDEBUG__NONE</CONFLICT>
- </OPTION>
-
- <OPTION tag='PROGRAM_LEVEL_COMPILE'>
- <TYPE>cmdline</TYPE>
- <NAME>--program_level_compile</NAME>
- <ALIAS>-pm</ALIAS>
- <TIP>Program mode compilation</TIP>
- <HELP>Enable program mode compilation.</HELP>
- </OPTION>
-
- <OPTION tag='QUIET'>
- <TYPE>simple</TYPE>
- <NAME>--quiet</NAME>
- <ALIAS>-q</ALIAS>
- <TIP>Quiet Mode</TIP>
- <HELP>Suppress common compiler non-diagnostic output. Remarks, errors and warnings will still be generated, as well as feature specific status.</HELP>
- <RESETS>SUPER_QUIET</RESETS>
- <RESETS>VERBOSE</RESETS>
- </OPTION>
-
- <OPTION tag='RAMFUNC'>
- <TYPE>simple</TYPE>
- <NAME>--ramfunc</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Run functions from RAM.</TIP>
- <HELP>Indicate that each function will be run out of RAM. Functions will be placed in RAM and optimized for RAM execution. Equivalent to specifying __attribute__((ramfunc)) on all functions in the translation units compiled with this option. For additional information, see http://processors.wiki.ti.com/index.php/Ramfunc_Attribute</HELP>
- <OVERRIDES>GEN_FUNC_SUBSECTIONS</OVERRIDES>
- <OVERRIDES>USE_DEAD_FUNCS_LIST</OVERRIDES>
- </OPTION>
-
- <OPTION tag='RELAXED_ANSI'>
- <TYPE>simple</TYPE>
- <NAME>--relaxed_ansi</NAME>
- <ALIAS>-pr</ALIAS>
- <TIP>Relaxed parsing (non-strict ANSI)</TIP>
- <HELP>Enable relaxed ANSI source parsing mode.</HELP>
- <RESETS>STRICT_ANSI</RESETS>
- </OPTION>
-
- <OPTION tag='REMOVE_HOOKS_WHEN_INLINING'>
- <TYPE>simple</TYPE>
- <NAME>--remove_hooks_when_inlining</NAME>
- <TIP>Remove entry/exit hooks from inlined functions</TIP>
- <HELP>Remove the entry and exit hooks from the bodies of inlined functions.</HELP>
- </OPTION>
-
- <OPTION tag='RTTI'>
- <TYPE>simple</TYPE>
- <NAME>--rtti</NAME>
- <ALIAS>-rtti</ALIAS>
- <TIP>Support C++ run-time type information</TIP>
- <HELP>Support C++ run-time type information</HELP>
- </OPTION>
-
- <OPTION tag='RUN_LINKER'>
- <TYPE>cmdline</TYPE>
- <NAME>--run_linker</NAME>
- <ALIAS>-z</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>arguments</DESCRIPTION>
- </ARG>
- <TIP>Perform link using options following</TIP>
- <HELP>After compiling all the source files, perform a link and pass all the options following this option to the linker.</HELP>
- </OPTION>
-
- <OPTION tag='SAT_REASSOC'>
- <TYPE>simple</TYPE>
- <NAME>--sat_reassoc</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>off</DEFAULT>
- </ARG>
- <TIP>Allow reassociation of sat arithmetic</TIP>
- <HELP>Set to on to allow reassociation of saturating arithmetic even in cases where the reassociation will cause saturation to occur differently.</HELP>
- </OPTION>
-
- <OPTION tag='SECTION_SIZES'>
- <TYPE>simple</TYPE>
- <NAME>--section_sizes</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Output section size summary information.</TIP>
- <HELP>Output section size summary information for code, const, and data.</HELP>
- </OPTION>
-
- <OPTION tag='SET_ERROR_LIMIT'>
- <TYPE>simple</TYPE>
- <NAME>--set_error_limit</NAME>
- <ALIAS>-pdel</ALIAS>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>count</DESCRIPTION>
- </ARG>
- <TIP>Set error limit to <count></TIP>
- <HELP>Set error limit to <count></HELP>
- </OPTION>
-
- <OPTION tag='SILICON_VERSION'>
- <TYPE>simple</TYPE>
- <NAME>--silicon_version</NAME>
- <PREFERREDALIAS>-mv</PREFERREDALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- <DEFAULT>6500</DEFAULT>
- </ARG>
- <TIP>Target processor version</TIP>
- <HELP>Target processor version</HELP>
- </OPTION>
-
- <OPTION tag='SINGLE_INLINE'>
- <TYPE>simple</TYPE>
- <NAME>--single_inline</NAME>
- <TIP>Inline functions only called once.</TIP>
- <HELP>Inline function that are called only once. Will inline these functions even if auto inlining has been turned off (-oi0)</HELP>
- </OPTION>
-
- <OPTION tag='SKIP_ASSEMBLER'>
- <TYPE>cmdline</TYPE>
- <NAME>--skip_assembler</NAME>
- <ALIAS>-n</ALIAS>
- <TIP>Compile only; do not assemble</TIP>
- <HELP>Compile only; do not assemble</HELP>
- <CHAIN>
- <TAG>KEEP_ASM</TAG>
- <TEXT>--keep_asm</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='SPECULATE_LOADS'>
- <TYPE>simple</TYPE>
- <NAME>--speculate_loads</NAME>
- <ALIAS>-mh</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>bytes|'auto'</DESCRIPTION>
- </ARG>
- <TIP>Specify speculative load byte count threshold or 'auto'</TIP>
- <HELP>Specify the number of bytes the compiler is allowed to speculatively load beyond the proven allocated memory.
- The argument 0 (-mh=0) has a special meaning and turns off speculative loads.
- The special argument 'auto' (-mh=auto) means the compiler chooses the number of bytes and also adds required padding during link step.
- -mh with no argument means no limit on the number of bytes loaded speculatively by the compiler. </HELP>
- </OPTION>
-
- <OPTION tag='SPECULATE_UNKNOWN_LOADS'>
- <TYPE>simple</TYPE>
- <NAME>--speculate_unknown_loads</NAME>
- <TIP>Speculate loads with unbounded address ranges</TIP>
- <HELP>Speculate loads with unbounded address ranges</HELP>
- </OPTION>
-
- <OPTION tag='SRC_INTERLIST'>
- <TYPE>simple</TYPE>
- <NAME>--src_interlist</NAME>
- <ALIAS>-s</ALIAS>
- <TIP>Generate interlisted assembly file</TIP>
- <HELP>Generate interlisted assembly file</HELP>
- <OVERRIDES>C_SRC_INTERLIST</OVERRIDES>
- </OPTION>
-
- <OPTION tag='STATIC_TEMPLATE_INSTANTIATION'>
- <TYPE>simple</TYPE>
- <NAME>--static_template_instantiation</NAME>
- <TIP>Do static early template instantiation</TIP>
- <HELP>All template entities are instantiated as needed in the file. The instantiations are given internal (static) linkage.</HELP>
- </OPTION>
-
- <OPTION tag='STD_LIB_FUNC_DEFINED'>
- <TYPE>singlefile</TYPE>
- <NAME>--std_lib_func_defined</NAME>
- <ALIAS>-ol1</ALIAS>
- <TIP>File contains an RTS library function.</TIP>
- <HELP>File contains an RTS library function.</HELP>
- </OPTION>
-
- <OPTION tag='STD_LIB_FUNC_NOT_DEFINED'>
- <TYPE>singlefile</TYPE>
- <NAME>--std_lib_func_not_defined</NAME>
- <ALIAS>-ol2</ALIAS>
- <TIP>File does not define any RTS library func (def.)</TIP>
- <HELP>File does not define any RTS library func (def.)</HELP>
- </OPTION>
-
- <OPTION tag='STD_LIB_FUNC_REDEFINED'>
- <TYPE>singlefile</TYPE>
- <NAME>--std_lib_func_redefined</NAME>
- <ALIAS>-ol0</ALIAS>
- <TIP>File redefines an RTS library function.</TIP>
- <HELP>File redefines an RTS library function.</HELP>
- </OPTION>
-
- <OPTION tag='STRICT_ANSI'>
- <TYPE>simple</TYPE>
- <NAME>--strict_ansi</NAME>
- <ALIAS>-ps</ALIAS>
- <TIP>Strict ANSI mode (errors)</TIP>
- <HELP>Enable strict ANSI source parsing mode. Any source violating strict ANSI guidelines will generate a parsing error.</HELP>
- <CONFLICT>GCC</CONFLICT>
- <RESETS>RELAXED_ANSI</RESETS>
- </OPTION>
-
- <OPTION tag='STRIP_COFF_UNDERSCORE'>
- <TYPE>simple</TYPE>
- <NAME>--strip_coff_underscore</NAME>
- <TIP>Aid for transitioning hand-coded assembly from COFF to ELF</TIP>
- <HELP>Strip underscores from externally defined or referenced symbols to aid transition of hand-coded assembly code from COFF to ELF.</HELP>
- </OPTION>
-
- <OPTION tag='SUPER_QUIET'>
- <TYPE>simple</TYPE>
- <NAME>--super_quiet</NAME>
- <ALIAS>-qq</ALIAS>
- <TIP>Super Quiet Mode</TIP>
- <HELP>Suppress all compiler non-diagnostic output. Remarks, errors and warnings will still be generated.</HELP>
- <RESETS>VERBOSE</RESETS>
- <RESETS>QUIET</RESETS>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__COFF'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:coff</NAME>
- <TIP>Full symbolic debug (COFF, deprecated)</TIP>
- <HELP>Enable full symbolic COFF debugging in the generated object or out file (DEPRECATED).</HELP>
- <OVERRIDES>SYMDEBUG__NONE</OVERRIDES>
- <OVERRIDES>SYMDEBUG__SKELETAL</OVERRIDES>
- <OVERRIDES>SYMDEBUG__DWARF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__PROFILE_COFF</OVERRIDES>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__DWARF'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:dwarf</NAME>
- <PREFERREDALIAS>-g</PREFERREDALIAS>
- <TIP>Full symbolic debug</TIP>
- <HELP>Enable full symbolic DWARF debugging in the generated object or out file.</HELP>
- <OVERRIDES>SYMDEBUG__COFF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__NONE</OVERRIDES>
- <OVERRIDES>SYMDEBUG__SKELETAL</OVERRIDES>
- <OVERRIDES>SYMDEBUG__PROFILE_COFF</OVERRIDES>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__DWARF_VERSION'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:dwarf_version</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>2,3,4</DESCRIPTION>
- <ONEOF>2</ONEOF>
- <ONEOF>3</ONEOF>
- <ONEOF>4</ONEOF>
- </ARG>
- <TIP>Specify DWARF version</TIP>
- <HELP>Specify DWARF version</HELP>
- <CONFLICT>SYMDEBUG__NONE</CONFLICT>
- <CONFLICT>SYMDEBUG__COFF</CONFLICT>
- <CONFLICT>SYMDEBUG__PROFILE_COFF</CONFLICT>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__KEEP_ALL_TYPES'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:keep_all_types</NAME>
- <TIP>Keep unreferenced type info (default for elf w/ debug)</TIP>
- <HELP>Keep referenced type info (default for elf w/ debug)</HELP>
- <CHAIN>
- <TAG>KEEP_UNNEEDED_TYPES</TAG>
- <TEXT>--keep_unneeded_types=true</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__NONE'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:none</NAME>
- <TIP>Suppress all symbolic debug generation</TIP>
- <HELP>Disable debug and suppress all symbolic debug information from being included in the generated object or out file.</HELP>
- <CONFLICT>OCS_ACTIVE</CONFLICT>
- <CONFLICT>PROFILE__POWER</CONFLICT>
- <CONFLICT>PROFILE__BREAKPT</CONFLICT>
- <OVERRIDES>SYMDEBUG__PROFILE_COFF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__DWARF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__SKELETAL</OVERRIDES>
- <OVERRIDES>SYMDEBUG__COFF</OVERRIDES>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__PROFILE_COFF'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:profile_coff</NAME>
- <TIP>Function profile debug (COFF, deprecated)</TIP>
- <HELP>Adds the necessary debug directives to the object file which are needed by the profiler to allow function level profiling with minimal impact on optimization (if optimization is enabled). Using -g may hinder some optimizations to ensure that debugability is maintained, while this option will not hinder optimization.
- You will still be able to set breakpoints and profile on function-level boundaries, but you will not be able to single-step through code as with full debug ability.</HELP>
- <OVERRIDES>SYMDEBUG__SKELETAL</OVERRIDES>
- <OVERRIDES>SYMDEBUG__DWARF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__COFF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__NONE</OVERRIDES>
- </OPTION>
-
- <OPTION tag='SYMDEBUG__SKELETAL'>
- <TYPE>simple</TYPE>
- <NAME>--symdebug:skeletal</NAME>
- <TIP>Symbolic debug for program analysis (DEPRECATED)</TIP>
- <HELP>Enable symbolic debug information for program analysis. (DEPRECATED)</HELP>
- <OVERRIDES>SYMDEBUG__COFF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__NONE</OVERRIDES>
- <OVERRIDES>SYMDEBUG__DWARF</OVERRIDES>
- <OVERRIDES>SYMDEBUG__PROFILE_COFF</OVERRIDES>
- </OPTION>
-
- <OPTION tag='SYMS_IGNORE_CASE'>
- <TYPE>simple</TYPE>
- <NAME>--syms_ignore_case</NAME>
- <ALIAS>-ac</ALIAS>
- <TIP>Symbol names are not case-significant</TIP>
- <HELP>Symbol names are not case-significant</HELP>
- </OPTION>
-
- <OPTION tag='TARGET_COMPATIBILITY_6200'>
- <TYPE>simple</TYPE>
- <NAME>--target_compatibility_6200</NAME>
- <ALIAS>-mb</ALIAS>
- <TIP>Enable 62xx compatibility (Option disabled)</TIP>
- <HELP>Enable 62xx compatibility (Option disabled)</HELP>
- <CHAIN>
- <TAG>DISABLE_PUSH_POP</TAG>
- <TEXT>--disable_push_pop</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>DISABLE_STRASGI_64PLUS</TAG>
- <TEXT>--disable_strasgi_64plus</TEXT>
- </CHAIN>
- <CHAIN>
- <TAG>DISABLE_CUSTOM_CALL_CONV</TAG>
- <TEXT>--disable_custom_call_conv</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='TEMP_DIRECTORY'>
- <TYPE>simple</TYPE>
- <NAME>--temp_directory</NAME>
- <ALIAS>-ft</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Temporary file directory (default is .)</TIP>
- <HELP>Temporary file directory (default is .)</HELP>
- </OPTION>
-
- <OPTION tag='TOOL_VERSION'>
- <TYPE>simple</TYPE>
- <NAME>--tool_version</NAME>
- <ALIAS>-version</ALIAS>
- <TIP>Print version numbers for each tool</TIP>
- <HELP>Print version numbers for each tool</HELP>
- </OPTION>
-
- <OPTION tag='UNDEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--undefine</NAME>
- <ALIAS>-U</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>NAME</DESCRIPTION>
- </ARG>
- <TIP>Undefine NAME</TIP>
- <HELP>Undefine the symbol with the id 'NAME'.</HELP>
- </OPTION>
-
- <OPTION tag='USE_CONST_FOR_ALIAS_ANALYSIS'>
- <TYPE>simple</TYPE>
- <NAME>--use_const_for_alias_analysis</NAME>
- <ALIAS>-ox</ALIAS>
- <TIP>Use const to disambiguate pointers.</TIP>
- <HELP>Treats pointer-to-const as an indication that no other store within the pointer's scope will affect the pointer's target.</HELP>
- </OPTION>
-
- <OPTION tag='USE_PCH'>
- <TYPE>simple</TYPE>
- <NAME>--use_pch</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>filename</DESCRIPTION>
- </ARG>
- <TIP>Precompiled header file for compilation</TIP>
- <HELP>This option specifies the file name of the precompiled header file for this compilation.</HELP>
- </OPTION>
-
- <OPTION tag='USE_PROFILE_INFO'>
- <TYPE>simple</TYPE>
- <NAME>--use_profile_info</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>filelist</DESCRIPTION>
- </ARG>
- <TIP>Use profile feedback file(s)</TIP>
- <HELP>This option is used in combination with the --analyze option to generate analysis information about code coverage or call graph information in the form of CSV files. This information can then be read and interpreted by other tools. For example, the cache layout tool, clt6x, can be used to interpret the call graph information and produce a preferred function order that can be incorporated into the application link. The compiler can only generate one kind of analysis information for a given invocation of the compiler.</HELP>
- <CONFLICT>GEN_PROFILE_INFO</CONFLICT>
- </OPTION>
-
- <OPTION tag='VECTYPES'>
- <TYPE>simple</TYPE>
- <NAME>--vectypes</NAME>
- <ALIAS>--vtypes</ALIAS>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Support OpenCL C-like vector types</TIP>
- <HELP>Support OpenCL C-like vector types</HELP>
- <CHAIN>
- <TAG>USE_G3</TAG>
- <TEXT>--use_g3</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='VERBOSE'>
- <TYPE>simple</TYPE>
- <NAME>--verbose</NAME>
- <TIP>Display banner and function progress information</TIP>
- <HELP>Display progress information and toolset version when executing.</HELP>
- <RESETS>QUIET</RESETS>
- <RESETS>SUPER_QUIET</RESETS>
- </OPTION>
-
- <OPTION tag='VERBOSE_DIAGNOSTICS'>
- <TYPE>simple</TYPE>
- <NAME>--verbose_diagnostics</NAME>
- <ALIAS>-pdv</ALIAS>
- <TIP>Verbose diagnostics</TIP>
- <HELP>Enable verbose diagnostic information from the parser, including the source line of the error and an indicator of the error position within the line.</HELP>
- </OPTION>
-
- <OPTION tag='VISIBILITY'>
- <TYPE>simple</TYPE>
- <NAME>--visibility</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>default,protected,hidden</DESCRIPTION>
- <ONEOF>default</ONEOF>
- <ONEOF>protected</ONEOF>
- <ONEOF>hidden</ONEOF>
- </ARG>
- <TIP>Specify visibility of global symbols.</TIP>
- <HELP>This option specifies the ELF visibility attribute of the global symbols. The ELF visibility attribute controls if and how the symbol can be accessed by other modules.</HELP>
- </OPTION>
-
- <OPTION tag='WCHAR_T'>
- <TYPE>simple</TYPE>
- <NAME>--wchar_t</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>16,32</DESCRIPTION>
- <ONEOF>16</ONEOF>
- <ONEOF>32</ONEOF>
- <DEFAULT>16</DEFAULT>
- </ARG>
- <TIP>Set the size (in bits) of the C/C++ type wchar_t (16,32)</TIP>
- <HELP>Designate the size of the C/C++ type wchar_t. In EABI mode users can choose either 16-bit or 32-bit wchar_t type. Note that objects built with 16-bit wchar_t are not compatible with 32-bit wchar_t objects. The default is 16-bit wchar_t.</HELP>
- </OPTION>
-
- <OPTION tag='WRITE_DIAGNOSTICS_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--write_diagnostics_file</NAME>
- <ALIAS>-pdf</ALIAS>
- <TIP>Output diagnostic to .err file</TIP>
- <HELP>Write diagnostics to an .err file instead of the standard output. The file name with be the same as the source file but with an .err extension.</HELP>
- </OPTION>
-
- <OPTION tag='W'>
- <TYPE>simple</TYPE>
- <NAME>-W</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>-W[warning_argument]</DESCRIPTION>
- </ARG>
- <TIP>Give Clang warning argument</TIP>
- <HELP>Forwards a warning argument to Clang</HELP>
- </OPTION>
-
- <MUTEX tag='MUTEX_QUIET_LEVEL'>
- <NAME>Quiet Level</NAME>
-
- <SEVERITY>RESET</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>VERBOSE</MEMBER>
- <MEMBER>QUIET</MEMBER>
- <MEMBER>SUPER_QUIET</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_DEBUGGING_MODEL'>
- <NAME>Debugging model</NAME>
-
- <SEVERITY>OVERRIDE</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>SYMDEBUG__DWARF</MEMBER>
- <MEMBER>SYMDEBUG__COFF</MEMBER>
- <MEMBER>SYMDEBUG__PROFILE_COFF</MEMBER>
- <MEMBER>SYMDEBUG__NONE</MEMBER>
- <MEMBER>SYMDEBUG__SKELETAL</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_SOURCE_INTERLIST'>
- <NAME>Source interlist</NAME>
-
- <SEVERITY>OVERRIDE</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>SRC_INTERLIST</MEMBER>
- <MEMBER>C_SRC_INTERLIST</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_C_DIALECT'>
- <NAME>C Dialect</NAME>
-
- <SEVERITY>RESET</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>C89</MEMBER>
- <MEMBER>C99</MEMBER>
- <MEMBER>KR_COMPATIBLE</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_C___DIALECT'>
- <NAME>C++ Dialect</NAME>
-
- <SEVERITY>RESET</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>CPLUSPLUS03</MEMBER>
- <MEMBER>EMBEDDED_CPP</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_LANGUAGE_MODE'>
- <NAME>Language mode</NAME>
-
- <SEVERITY>RESET</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>RELAXED_ANSI</MEMBER>
- <MEMBER>STRICT_ANSI</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_PREPROCESSOR_ANALYSIS_OPTIONS'>
- <NAME>Preprocessor Analysis Options</NAME>
-
- <SEVERITY>OVERRIDE</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>PREPROC_DEPENDENCY</MEMBER>
- <MEMBER>PREPROC_INCLUDES</MEMBER>
- <MEMBER>PREPROC_MACROS</MEMBER>
- </MUTEX>
- <MUTEX tag='MUTEX_FUNCTION_SUBSECTIONS'>
- <NAME>Function Subsections</NAME>
-
- <SEVERITY>OVERRIDE</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>GEN_FUNC_SUBSECTIONS</MEMBER>
- <MEMBER>RAMFUNC</MEMBER>
- </MUTEX>
- </DEFINITIONS>
- <BASIC>
- </BASIC>
- <CATEGORY tag='PROCESSOR'>
- <NAME>Processor Options:</NAME>
-
- <MEMBER>SILICON_VERSION</MEMBER>
- <MEMBER>BIG_ENDIAN</MEMBER>
- <MEMBER>ABI</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='BASICOPT'>
- <NAME>Optimization:</NAME>
-
- <MEMBER>OPT_LEVEL</MEMBER>
- <MEMBER>OPT_FOR_SPEED</MEMBER>
- <MEMBER>OPT_FOR_SPACE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='INCLUDES'>
- <NAME>Include Options:</NAME>
-
- <MEMBER>INCLUDE_PATH</MEMBER>
- <MEMBER>PREINCLUDE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='PERFORMANCE'>
- <NAME>Performance Advisor:</NAME>
-
- <MEMBER>ADVICE__PERFORMANCE_DIR</MEMBER>
- <MEMBER>ADVICE__PERFORMANCE_FILE</MEMBER>
- <MEMBER>ADVICE__PERFORMANCE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='ADVANCED'>
- <NAME>Advanced Options:</NAME>
-
- <MEMBERCAT>CONTROL</MEMBERCAT>
- <MEMBERCAT>SYMDEBUG</MEMBERCAT>
- <MEMBERCAT>PARSER</MEMBERCAT>
- <MEMBERCAT>PREPROC</MEMBERCAT>
- <MEMBERCAT>DEFINES</MEMBERCAT>
- <MEMBERCAT>PDIAG</MEMBERCAT>
- <MEMBERCAT>MODEL</MEMBERCAT>
- <MEMBERCAT>OPTIM</MEMBERCAT>
- <MEMBERCAT>OCS</MEMBERCAT>
- <MEMBERCAT>HOOK</MEMBERCAT>
- <MEMBERCAT>FEEDBACK</MEMBERCAT>
- <MEMBERCAT>LIB</MEMBERCAT>
- <MEMBERCAT>GRAPH</MEMBERCAT>
- <MEMBERCAT>ASM</MEMBERCAT>
- <MEMBERCAT>FILE</MEMBERCAT>
- <MEMBERCAT>DIRECTORY</MEMBERCAT>
- <MEMBERCAT>FILEEXT</MEMBERCAT>
- <MEMBERCAT>INTERNAL</MEMBERCAT>
- <MEMBERCAT>DYNAMIC</MEMBERCAT>
- <MEMBERCAT>CMDFILES</MEMBERCAT>
- <MEMBERCAT>MISRA</MEMBERCAT>
- </CATEGORY>
-
- <CATEGORY tag='CONTROL'>
- <NAME>Control Options:</NAME>
-
- <MEMBER>COMPILE_ONLY</MEMBER>
- <MEMBER>SKIP_ASSEMBLER</MEMBER>
- <MEMBER>HELP</MEMBER>
- <MEMBER>RUN_LINKER</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='SYMDEBUG'>
- <NAME>Advanced Debug Options:</NAME>
-
- <MEMBER>MUTEX_DEBUGGING_MODEL</MEMBER>
- <MEMBER>OPTIMIZE_WITH_DEBUG</MEMBER>
- <MEMBER>SYMDEBUG__KEEP_ALL_TYPES</MEMBER>
- <MEMBER>MACHINE_REGS</MEMBER>
- <MEMBER>SYMDEBUG__DWARF_VERSION</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='PARSER'>
- <NAME>Language Options:</NAME>
-
- <MEMBER>MUTEX_C_DIALECT</MEMBER>
- <MEMBER>MUTEX_C___DIALECT</MEMBER>
- <MEMBER>MUTEX_LANGUAGE_MODE</MEMBER>
- <MEMBER>KEEP_UNNEEDED_STATICS</MEMBER>
- <MEMBER>EXTERN_C_CAN_THROW</MEMBER>
- <MEMBER>MULTIBYTE_CHARS</MEMBER>
- <MEMBER>PCH</MEMBER>
- <MEMBER>VECTYPES</MEMBER>
- <MEMBER>GEN_ACP_XREF</MEMBER>
- <MEMBER>EXCEPTIONS</MEMBER>
- <MEMBER>PROGRAM_LEVEL_COMPILE</MEMBER>
- <MEMBER>CPP_DEFAULT</MEMBER>
- <MEMBER>PENDING_INSTANTIATIONS</MEMBER>
- <MEMBER>GEN_ACP_RAW</MEMBER>
- <MEMBER>PCH_VERBOSE</MEMBER>
- <MEMBER>RTTI</MEMBER>
- <MEMBER>GCC</MEMBER>
- <MEMBER>NO_INLINING</MEMBER>
- <MEMBER>USE_PCH</MEMBER>
- <MEMBER>FLOAT_OPERATIONS_ALLOWED</MEMBER>
- <MEMBER>NO_INTRINSICS</MEMBER>
- <MEMBER>CREATE_PCH</MEMBER>
- <MEMBER>PCH_DIR</MEMBER>
- <MEMBER>STATIC_TEMPLATE_INSTANTIATION</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='PREPROC'>
- <NAME>Parser Preprocessing Options:</NAME>
-
- <MEMBER>MUTEX_PREPROCESSOR_ANALYSIS_OPTIONS</MEMBER>
- <MEMBER>PREPROC_WITH_COMMENT</MEMBER>
- <MEMBER>PREPROC_ONLY</MEMBER>
- <MEMBER>PREPROC_WITH_COMPILE</MEMBER>
- <MEMBER>PREPROC_WITH_LINE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='DEFINES'>
- <NAME>Predefined Symbols:</NAME>
-
- <MEMBER>LLOPT</MEMBER>
- <MEMBER>UNDEFINE</MEMBER>
- <MEMBER>DEFINE</MEMBER>
- <MEMBER>W</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='PDIAG'>
- <NAME>Diagnostic Options:</NAME>
-
- <MEMBER>MUTEX_QUIET_LEVEL</MEMBER>
- <MEMBER>TOOL_VERSION</MEMBER>
- <MEMBER>DIAG_SUPPRESS</MEMBER>
- <MEMBER>DIAG_WRAP</MEMBER>
- <MEMBER>DIAG_WARNING</MEMBER>
- <MEMBER>COMPILER_REVISION</MEMBER>
- <MEMBER>SECTION_SIZES</MEMBER>
- <MEMBER>ISSUE_REMARKS</MEMBER>
- <MEMBER>VERBOSE_DIAGNOSTICS</MEMBER>
- <MEMBER>NO_WARNINGS</MEMBER>
- <MEMBER>EMIT_WARNINGS_AS_ERRORS</MEMBER>
- <MEMBER>WRITE_DIAGNOSTICS_FILE</MEMBER>
- <MEMBER>SET_ERROR_LIMIT</MEMBER>
- <MEMBER>DIAG_ERROR</MEMBER>
- <MEMBER>DISPLAY_ERROR_NUMBER</MEMBER>
- <MEMBER>DIAG_REMARK</MEMBER>
- <MEMBER>BUFFER_DIAGNOSTICS</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='MODEL'>
- <NAME>Runtime Model Options:</NAME>
-
- <MEMBER>MUTEX_FUNCTION_SUBSECTIONS</MEMBER>
- <MEMBER>NO_RELOAD_ERRORS</MEMBER>
- <MEMBER>PROFILE__POWER</MEMBER>
- <MEMBER>NO_BAD_ALIASES</MEMBER>
- <MEMBER>SAT_REASSOC</MEMBER>
- <MEMBER>USE_CONST_FOR_ALIAS_ANALYSIS</MEMBER>
- <MEMBER>FP_REASSOC</MEMBER>
- <MEMBER>WCHAR_T</MEMBER>
- <MEMBER>INTERRUPT_THRESHOLD</MEMBER>
- <MEMBER>MEM_MODEL__DATA</MEMBER>
- <MEMBER>NO_COMPRESS</MEMBER>
- <MEMBER>TARGET_COMPATIBILITY_6200</MEMBER>
- <MEMBER>DEBUG_SOFTWARE_PIPELINE</MEMBER>
- <MEMBER>SPECULATE_LOADS</MEMBER>
- <MEMBER>DISABLE_SOFTWARE_PIPELINE</MEMBER>
- <MEMBER>DPREL</MEMBER>
- <MEMBER>PROFILE__BREAKPT</MEMBER>
- <MEMBER>MEM_MODEL__CONST</MEMBER>
- <MEMBER>FP_NOT_ASSOCIATIVE</MEMBER>
- <MEMBER>SPECULATE_UNKNOWN_LOADS</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='OPTIM'>
- <NAME>Advanced Optimizations:</NAME>
-
- <MEMBER>MULTITHREAD</MEMBER>
- <MEMBER>REMOVE_HOOKS_WHEN_INLINING</MEMBER>
- <MEMBER>GEN_OPT_INFO</MEMBER>
- <MEMBER>DISABLE_PUSH_POP</MEMBER>
- <MEMBER>OPENMP</MEMBER>
- <MEMBER>SINGLE_INLINE</MEMBER>
- <MEMBER>AUTO_INLINE</MEMBER>
- <MEMBER>CALL_ASSUMPTIONS</MEMBER>
- <MEMBER>FP_MODE</MEMBER>
- <MEMBER>ALIASED_VARIABLES</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='HOOK'>
- <NAME>Entry/Exit Hook Options:</NAME>
-
- <MEMBER>EXIT_HOOK</MEMBER>
- <MEMBER>EXIT_PARM</MEMBER>
- <MEMBER>ENTRY_HOOK</MEMBER>
- <MEMBER>ENTRY_PARM</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='FEEDBACK'>
- <NAME>Feedback and Analysis Options:</NAME>
-
- <MEMBER>ANALYZE</MEMBER>
- <MEMBER>GEN_PROFILE_INFO</MEMBER>
- <MEMBER>USE_PROFILE_INFO</MEMBER>
- <MEMBER>ANALYZE_ONLY</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LIB'>
- <NAME>Library Function Assumptions:</NAME>
-
- <MEMBER>STD_LIB_FUNC_NOT_DEFINED</MEMBER>
- <MEMBER>PRINTF_SUPPORT</MEMBER>
- <MEMBER>STD_LIB_FUNC_REDEFINED</MEMBER>
- <MEMBER>STD_LIB_FUNC_DEFINED</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='ASM'>
- <NAME>Assembler Options:</NAME>
-
- <MEMBER>KEEP_ASM</MEMBER>
- <MEMBER>MUTEX_SOURCE_INTERLIST</MEMBER>
- <MEMBER>ASM_LISTING</MEMBER>
- <MEMBER>ASM_UNDEFINE</MEMBER>
- <MEMBER>ASM_DEPENDENCY</MEMBER>
- <MEMBER>STRIP_COFF_UNDERSCORE</MEMBER>
- <MEMBER>SYMS_IGNORE_CASE</MEMBER>
- <MEMBER>INCLUDE_FILE</MEMBER>
- <MEMBER>ABSOLUTE_LISTING</MEMBER>
- <MEMBER>COPY_FILE</MEMBER>
- <MEMBER>OUTPUT_ALL_SYMS</MEMBER>
- <MEMBER>ASM_DEFINE</MEMBER>
- <MEMBER>CROSS_REFERENCE</MEMBER>
- <MEMBER>ASM_INCLUDES</MEMBER>
- <MEMBER>NO_CONST_CLINK</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='FILE'>
- <NAME>File Type Specifier:</NAME>
-
- <MEMBER>CPP_FILE</MEMBER>
- <MEMBER>C_FILE</MEMBER>
- <MEMBER>OBJ_FILE</MEMBER>
- <MEMBER>ASM_FILE</MEMBER>
- <MEMBER>AP_FILE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='DIRECTORY'>
- <NAME>Directory Specifier:</NAME>
-
- <MEMBER>PP_DIRECTORY</MEMBER>
- <MEMBER>OBJ_DIRECTORY</MEMBER>
- <MEMBER>ASM_DIRECTORY</MEMBER>
- <MEMBER>TEMP_DIRECTORY</MEMBER>
- <MEMBER>LIST_DIRECTORY</MEMBER>
- <MEMBER>ABS_DIRECTORY</MEMBER>
- <MEMBER>OUTPUT_FILE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='FILEEXT'>
- <NAME>Default File Extensions:</NAME>
-
- <MEMBER>OBJ_EXTENSION</MEMBER>
- <MEMBER>ASM_EXTENSION</MEMBER>
- <MEMBER>AP_EXTENSION</MEMBER>
- <MEMBER>CPP_EXTENSION</MEMBER>
- <MEMBER>LISTING_EXTENSION</MEMBER>
- <MEMBER>C_EXTENSION</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='DYNAMIC'>
- <NAME>Dynamic Linking Support Options:</NAME>
-
- <MEMBER>EXPORT_ALL_CPP_VTBL</MEMBER>
- <MEMBER>INLINE_PLT</MEMBER>
- <MEMBER>DSBT</MEMBER>
- <MEMBER>IMPORT_UNDEF</MEMBER>
- <MEMBER>PIC</MEMBER>
- <MEMBER>VISIBILITY</MEMBER>
- <MEMBER>LINUX</MEMBER>
- <MEMBER>IMPORT_HELPER_FUNCTIONS</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='CMDFILES'>
- <NAME>Command Files:</NAME>
-
- <MEMBER>CMD_FILE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='MISRA'>
- <NAME>MISRA-C:2004:</NAME>
-
- <MEMBER>MISRA_REQUIRED</MEMBER>
- <MEMBER>CHECK_MISRA</MEMBER>
- <MEMBER>MISRA_ADVISORY</MEMBER>
- </CATEGORY>
-
- </TOOL>
- <TOOL>
- <TAG>LINKER</TAG>
- <TOOLNAME>C/C++ LINKER</TOOLNAME>
- <DEFINITIONS>
- <OPTION tag='ABSOLUTE_EXE'>
- <TYPE>simple</TYPE>
- <NAME>--absolute_exe</NAME>
- <ALIAS>-a</ALIAS>
- <TIP>Produce absolute executable object file (default)</TIP>
- <HELP>Produce absolute executable object file (default)</HELP>
- </OPTION>
-
- <OPTION tag='ARG_SIZE'>
- <TYPE>simple</TYPE>
- <NAME>--arg_size</NAME>
- <ALIAS>--args</ALIAS>
- <ARG>
- <TYPE>HEXNUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>Set C argc/argv memory size</TIP>
- <HELP>Set C argc/argv memory size</HELP>
- </OPTION>
-
- <OPTION tag='BIND_NOW'>
- <TYPE>simple</TYPE>
- <NAME>--bind_now</NAME>
- <TIP>Disable Linux default lazy binding mechanisms</TIP>
- <HELP>Disable Linux default lazy binding mechanisms</HELP>
- </OPTION>
-
- <OPTION tag='BUFFER_DIAGNOSTICS'>
- <TYPE>simple</TYPE>
- <NAME>--buffer_diagnostics</NAME>
- <ALIAS>-pdb</ALIAS>
- <TIP>Line buffer diagnostic output</TIP>
- <HELP>Line buffer diagnostic output to reduce message mixing when compiling in parallel.</HELP>
- </OPTION>
-
- <OPTION tag='CINIT_COMPRESSION'>
- <TYPE>simple</TYPE>
- <NAME>--cinit_compression</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>compression_kind</DESCRIPTION>
- <DEFAULT>rle</DEFAULT>
- </ARG>
- <TIP>Compress ELF C style auto initialization data</TIP>
- <HELP>Specify the compression to apply to the c auto initialization data</HELP>
- </OPTION>
-
- <OPTION tag='COMPRESS_DWARF'>
- <TYPE>simple</TYPE>
- <NAME>--compress_dwarf</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Aggressively reduce size of the DWARF information</TIP>
- <HELP>Aggressively reduce the size of the DWARF information. When this option used, the DWARF information is parsed and examined to look for and eliminate duplicate types, and builds a .debug_abbrev table for the whole program.</HELP>
- </OPTION>
-
- <OPTION tag='COPY_COMPRESSION'>
- <TYPE>simple</TYPE>
- <NAME>--copy_compression</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>compression_kind</DESCRIPTION>
- <DEFAULT>rle</DEFAULT>
- </ARG>
- <TIP>Compress ELF sections copied using copy tables</TIP>
- <HELP>Overlays can be managed by using linker generated copy tables. To save ROM space, the linker can compress the data copied by copy tables. The compressed data is decompressed during copy.</HELP>
- </OPTION>
-
- <OPTION tag='DEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--define</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>name=value</DESCRIPTION>
- </ARG>
- <TIP>Pre-define preprocessor macro _name_ to _value_</TIP>
- <HELP>Pre-define preprocessor macro _name_ to _value_</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_ERROR'>
- <TYPE>simple</TYPE>
- <NAME>--diag_error</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as error</TIP>
- <HELP>Treat diagnostic <id> as error</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_REMARK'>
- <TYPE>simple</TYPE>
- <NAME>--diag_remark</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as remark</TIP>
- <HELP>Treat diagnostic <id> as remark</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_SUPPRESS'>
- <TYPE>simple</TYPE>
- <NAME>--diag_suppress</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Suppress diagnostic <id></TIP>
- <HELP>Suppress diagnostic <id></HELP>
- </OPTION>
-
- <OPTION tag='DIAG_WARNING'>
- <TYPE>simple</TYPE>
- <NAME>--diag_warning</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>id</DESCRIPTION>
- </ARG>
- <TIP>Treat diagnostic <id> as warning</TIP>
- <HELP>Treat diagnostic <id> as warning</HELP>
- </OPTION>
-
- <OPTION tag='DIAG_WRAP'>
- <TYPE>simple</TYPE>
- <NAME>--diag_wrap</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Wrap diagnostic messages</TIP>
- <HELP>Set diagnostic messages to wrap at 79 columns (on) or not (off).</HELP>
- </OPTION>
-
- <OPTION tag='DISABLE_AUTO_RTS'>
- <TYPE>simple</TYPE>
- <NAME>--disable_auto_rts</NAME>
- <TIP>Disable automatic RTS selection</TIP>
- <HELP>Do not attempt to automatically select and link a runtime library.</HELP>
- </OPTION>
-
- <OPTION tag='DISABLE_CLINK'>
- <TYPE>simple</TYPE>
- <NAME>--disable_clink</NAME>
- <ALIAS>-j</ALIAS>
- <TIP>Disable conditional linking and ignore .clink</TIP>
- <HELP>Disable conditional linking; ignore all .clink directives.</HELP>
- </OPTION>
-
- <OPTION tag='DISABLE_PP'>
- <TYPE>simple</TYPE>
- <NAME>--disable_pp</NAME>
- <TIP>Don't use C preprocessor for command files</TIP>
- <HELP>This disables preprocessing of linker command files.</HELP>
- </OPTION>
-
- <OPTION tag='DISPLAY_ERROR_NUMBER'>
- <TYPE>simple</TYPE>
- <NAME>--display_error_number</NAME>
- <TIP>Emit diagnostic identifier numbers</TIP>
- <HELP>Emit diagnostic identifier numbers</HELP>
- </OPTION>
-
- <OPTION tag='DSBT_INDEX'>
- <TYPE>simple</TYPE>
- <NAME>--dsbt_index</NAME>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>index</DESCRIPTION>
- </ARG>
- <TIP>The DSBT index of this component</TIP>
- <HELP>The Data Segment Base Table (DSBT) contains the Data Page (DP) pointer for each component (executable or shared object) in a dynamic linking system. A dynamic component uses a unique index to access its DP value. This index can be allocated at run time by the dynamic loader or can be statically assigned via this option. The index value should be less than the DSBT size. </HELP>
- </OPTION>
-
- <OPTION tag='DSBT_SIZE'>
- <TYPE>simple</TYPE>
- <NAME>--dsbt_size</NAME>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>The size of Data Segment Base Table (DSBT) in words</TIP>
- <HELP>The Data Segment Base Table (DSBT) contains the Data Page (DP) pointer for each component (executable or shared object) in a dynamic linking system. Each dynamic component in the system has an entry in the DSBT. This option specifies the size of the DSBT, and should be no less than the number of dynamic components in the system.</HELP>
- </OPTION>
-
- <OPTION tag='DYNAMIC'>
- <TYPE>simple</TYPE>
- <NAME>--dynamic</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>exe,lib</DESCRIPTION>
- <ONEOF>exe</ONEOF>
- <ONEOF>lib</ONEOF>
- <DEFAULT>exe</DEFAULT>
- </ARG>
- <TIP>Generate dynamic executable or a dynamic library</TIP>
- <HELP>Generate a dynamic executable or a dynamic library for use in an application that is dynamically linked and relocated at load time</HELP>
- </OPTION>
-
- <OPTION tag='ECC__DATA_ERROR'>
- <TYPE>simple</TYPE>
- <NAME>--ecc:data_error</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>(address|symbol+offset),[page,]bitmask</DESCRIPTION>
- </ARG>
- <TIP>Introduce bit errors</TIP>
- <HELP>--ecc:data_error=(address|symbol+offset),[page,]bitmask - Introduce bit errors in the outfile. The bits to be flipped in the outfile are located in the unit at the specified offset. The offset is relative to either the origin of the page, or relative to the position of the base symbol, if specified. The default page is zero, and any page may be specified. The bits to be flipped at the specified location are indicated by set bits in the bitmask. In effect, the data in the outfile will be the bitwise-exclusive-or of the bitmask with original code or data. Bit errors can only be applied to initialized data, such as the contents of Flash memory. The effective address of the error must lie inside either the output memory range or the input memory range of an ECC specification.</HELP>
- </OPTION>
-
- <OPTION tag='ECC__ECC_ERROR'>
- <TYPE>simple</TYPE>
- <NAME>--ecc:ecc_error</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>(address|symbol+offset),[page,]bitmask</DESCRIPTION>
- </ARG>
- <TIP>Introduce bit errors in ECC memory</TIP>
- <HELP>--ecc:ecc_error=(address|symbol+offset),[page,]bitmask - Introduce bit errors in corresponding ECC memory. This option behaves like the --ecc:data_error option, except that the bits are not flipped in the code/data memory at the specified location. Instead, the bits are flipped in the ECC memory area that corresponds to the specified location. The bitmask is 8 bits wide. In the presence of mirroring, bits will be flipped in all mirrored copies of the corresponding ECC byte. The effective address of the error must lie inside the input memory range of an ECC specification.</HELP>
- </OPTION>
-
- <OPTION tag='EMIT_WARNINGS_AS_ERRORS'>
- <TYPE>simple</TYPE>
- <NAME>--emit_warnings_as_errors</NAME>
- <ALIAS>-pdew</ALIAS>
- <TIP>Treat warnings as errors</TIP>
- <HELP>Treat warnings as errors</HELP>
- <CONFLICT>NO_WARNINGS</CONFLICT>
- </OPTION>
-
- <OPTION tag='ENTRY_POINT'>
- <TYPE>simple</TYPE>
- <NAME>--entry_point</NAME>
- <ALIAS>-e</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>symbol</DESCRIPTION>
- </ARG>
- <TIP>Specify program entry point for the output module</TIP>
- <HELP>Specify program entry point for the output module</HELP>
- <CONFLICT>NO_ENTRY_POINT</CONFLICT>
- </OPTION>
-
- <OPTION tag='EXPORT'>
- <TYPE>simple</TYPE>
- <NAME>--export</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym</DESCRIPTION>
- </ARG>
- <TIP>Export specified symbol</TIP>
- <HELP>This option makes the specified global symbol an exported definition. Global symbols that are given restricted (hidden) visibility by source code annotations will not be exported by this option.</HELP>
- </OPTION>
-
- <OPTION tag='FILL_VALUE'>
- <TYPE>simple</TYPE>
- <NAME>--fill_value</NAME>
- <ALIAS>-f</ALIAS>
- <ARG>
- <TYPE>HEXNUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>value</DESCRIPTION>
- </ARG>
- <TIP>Default fill value for holes in output sections</TIP>
- <HELP>Set the default fill value for filling holes in output sections.</HELP>
- </OPTION>
-
- <OPTION tag='FINI'>
- <TYPE>simple</TYPE>
- <NAME>--fini</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym</DESCRIPTION>
- </ARG>
- <TIP>Specify the symbol name of the finalization code</TIP>
- <HELP>This option sets the entry point symbol for finalization code. The dynamic loader calls the finalization code when it unloads a dynamically loaded object. When this option is used, the linker generates the DT_FINI dynamic tag and sets it to the address of the symbol.</HELP>
- <CHAIN>
- <TAG>RETAIN</TAG>
- <TEXT>--retain=$sym</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='FORCED_STATIC_BINDING'>
- <TYPE>simple</TYPE>
- <NAME>--forced_static_binding</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Force all import references to bind during static linking</TIP>
- <HELP>Force all import references to bind during static linking.</HELP>
- </OPTION>
-
- <OPTION tag='GLOBALIZE'>
- <TYPE>simple</TYPE>
- <NAME>--globalize</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>pattern</DESCRIPTION>
- </ARG>
- <TIP>Do not localize symbols matching pattern</TIP>
- <HELP>The option '--localize=l_pattern' makes the symbols matching the l_pattern hidden. The '--globalilze=g_pattern' option excludes symbols matching g_pattern from symbol localization provided g_pattern is more restrictive than l_pattern. </HELP>
- </OPTION>
-
- <OPTION tag='HEAP_SIZE'>
- <TYPE>simple</TYPE>
- <NAME>--heap_size</NAME>
- <ALIAS>-heap</ALIAS>
- <ALIAS>--heap</ALIAS>
- <ARG>
- <TYPE>HEXNUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>Heap size for C/C++ dynamic memory allocation</TIP>
- <HELP>Specify the maximum heap size for C/C++ dynamic memory allocation.</HELP>
- </OPTION>
-
- <OPTION tag='HIDE'>
- <TYPE>simple</TYPE>
- <NAME>--hide</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>pattern</DESCRIPTION>
- </ARG>
- <TIP>Hide symbols matching pattern</TIP>
- <HELP>Hide the symbols matching the pattern by changing the name to empty string</HELP>
- </OPTION>
-
- <OPTION tag='IMPORT'>
- <TYPE>simple</TYPE>
- <NAME>--import</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym</DESCRIPTION>
- </ARG>
- <TIP>Import specified symbol</TIP>
- <HELP>This option makes specified global symbol an imported references. Global symbols that are given restricted (hidden) visibility by source code annotations will not be imported by this option.</HELP>
- </OPTION>
-
- <OPTION tag='INIT'>
- <TYPE>simple</TYPE>
- <NAME>--init</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym</DESCRIPTION>
- </ARG>
- <TIP>Specify the symbol name of the initialization code</TIP>
- <HELP>This option sets the entry point symbol for initialization code. The dynamic loader calls the initialization code when it loads a dynamically loaded object. When this option is used, the linker generates the DT_INIT dynamic tag and sets it to the address of the symbol.</HELP>
- <CHAIN>
- <TAG>RETAIN</TAG>
- <TEXT>--retain=$sym</TEXT>
- </CHAIN>
- </OPTION>
-
- <OPTION tag='ISSUE_REMARKS'>
- <TYPE>simple</TYPE>
- <NAME>--issue_remarks</NAME>
- <TIP>Issue remarks</TIP>
- <HELP>Issue remarks</HELP>
- </OPTION>
-
- <OPTION tag='LIBRARY'>
- <TYPE>simple</TYPE>
- <NAME>--library</NAME>
- <PREFERREDALIAS>-l</PREFERREDALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>file</DESCRIPTION>
- </ARG>
- <TIP>Include library file or command file as input</TIP>
- <HELP>Include library file or command file as input</HELP>
- </OPTION>
-
- <OPTION tag='LINKER_HELP'>
- <TYPE>cmdline</TYPE>
- <NAME>--linker_help</NAME>
- <ALIAS>-help</ALIAS>
- <ALIAS>--help</ALIAS>
- <TIP>Display usage information</TIP>
- <HELP>Display usage information. Followed by another option, will display detailed information on that option.</HELP>
- </OPTION>
-
- <OPTION tag='LOCALIZE'>
- <TYPE>simple</TYPE>
- <NAME>--localize</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>pattern</DESCRIPTION>
- </ARG>
- <TIP>Make the symbols matching pattern local</TIP>
- <HELP>Given a symbol name pattern, make all the symbols matching this pattern local</HELP>
- </OPTION>
-
- <OPTION tag='MAKE_GLOBAL'>
- <TYPE>simple</TYPE>
- <NAME>--make_global</NAME>
- <ALIAS>-g</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>symbol</DESCRIPTION>
- </ARG>
- <TIP>Don't make global symbol static if -h is specified</TIP>
- <HELP>Don't make global symbol static if -h is specified</HELP>
- </OPTION>
-
- <OPTION tag='MAKE_STATIC'>
- <TYPE>simple</TYPE>
- <NAME>--make_static</NAME>
- <ALIAS>-h</ALIAS>
- <TIP>Make all global symbols static</TIP>
- <HELP>Make all global symbols static</HELP>
- </OPTION>
-
- <OPTION tag='MAP_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--map_file</NAME>
- <PREFERREDALIAS>-m</PREFERREDALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>file</DESCRIPTION>
- </ARG>
- <TIP>Link information (map) listed into <file></TIP>
- <HELP>Produce a listing of all input and output sections into <file>.</HELP>
- </OPTION>
-
- <OPTION tag='MAPFILE_CONTENTS'>
- <TYPE>simple</TYPE>
- <NAME>--mapfile_contents</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>attribute</DESCRIPTION>
- </ARG>
- <TIP>Display attribute settings in map file</TIP>
- <HELP>Enable the display of <attribute> or disable with no<attribute> in the linker generated map file. Multiple attributes can be specified by separating them with commas (e.g. --mapfile_contents=sections,nosymbols). Type --mapfile_contents=help for a list of attributes.</HELP>
- </OPTION>
-
- <OPTION tag='MINIMIZE_TRAMPOLINES'>
- <TYPE>simple</TYPE>
- <NAME>--minimize_trampolines</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>postorder,off</DESCRIPTION>
- <ONEOF>postorder</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>postorder</DEFAULT>
- </ARG>
- <TIP>Select trampoline minimization algorithm</TIP>
- <HELP>This option attempts to place sections so as to minimize the number of far call trampolines required, possibly at the expense of optimal memory packing. The argument selects a heuristic to use. The 'postorder' heuristic attempts to place functions before their callers so that the PC-relative offset is known when the caller is placed.</HELP>
- </OPTION>
-
- <OPTION tag='MULTITHREAD'>
- <TYPE>simple</TYPE>
- <NAME>--multithread</NAME>
- <TIP>Multi-threading is used; choose thread-safe RTS library</TIP>
- <HELP>Multi-threading is used; choose thread-safe RTS library</HELP>
- </OPTION>
-
- <OPTION tag='NO_DEMANGLE'>
- <TYPE>simple</TYPE>
- <NAME>--no_demangle</NAME>
- <TIP>Don't demangle symbol names in diagnostics</TIP>
- <HELP>Don't demangle symbol names in diagnostics</HELP>
- </OPTION>
-
- <OPTION tag='NO_SYM_MERGE'>
- <TYPE>simple</TYPE>
- <NAME>--no_sym_merge</NAME>
- <ALIAS>-b</ALIAS>
- <TIP>No type merging in symbolic debugging information</TIP>
- <HELP>Disable type merging in symbolic debugging information.</HELP>
- </OPTION>
-
- <OPTION tag='NO_SYMTABLE'>
- <TYPE>simple</TYPE>
- <NAME>--no_symtable</NAME>
- <ALIAS>-s</ALIAS>
- <TIP>Strip symbol table and line number entries</TIP>
- <HELP>Strip symbol table and line number entries</HELP>
- </OPTION>
-
- <OPTION tag='NO_WARNINGS'>
- <TYPE>simple</TYPE>
- <NAME>--no_warnings</NAME>
- <TIP>Suppress warnings</TIP>
- <HELP>Suppress warnings</HELP>
- <CONFLICT>EMIT_WARNINGS_AS_ERRORS</CONFLICT>
- </OPTION>
-
- <OPTION tag='OUTPUT_FILE'>
- <TYPE>simple</TYPE>
- <NAME>--output_file</NAME>
- <PREFERREDALIAS>-o</PREFERREDALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>file</DESCRIPTION>
- </ARG>
- <TIP>Specify output file name</TIP>
- <HELP>Full filename of the output file.</HELP>
- </OPTION>
-
- <OPTION tag='PREFERRED_ORDER'>
- <TYPE>simple</TYPE>
- <NAME>--preferred_order</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>function</DESCRIPTION>
- </ARG>
- <TIP>Add <function> to preferred placement order list</TIP>
- <HELP>Insert a function into the preferred function order list for placement. Functions that are close to each other in the preferred function order list will tend to be placed close together (increase program locality between them). Static functions of the same name can be distinguished from each other by prefixing the function name with the path and file in which the function is defined followed by a ':' character to delimit the beginning of the function name.</HELP>
- </OPTION>
-
- <OPTION tag='PRIORITY'>
- <TYPE>simple</TYPE>
- <NAME>--priority</NAME>
- <ALIAS>-priority</ALIAS>
- <TIP>Search libraries in priority order</TIP>
- <HELP>Search libraries in priority order</HELP>
- </OPTION>
-
- <OPTION tag='RAM_MODEL'>
- <TYPE>simple</TYPE>
- <NAME>--ram_model</NAME>
- <ALIAS>-cr</ALIAS>
- <TIP>Link using RAM autoinitialization model</TIP>
- <HELP>Link using RAM autoinitialization model</HELP>
- <RESETS>ROM_MODEL</RESETS>
- </OPTION>
-
- <OPTION tag='RELOCATABLE'>
- <TYPE>simple</TYPE>
- <NAME>--relocatable</NAME>
- <ALIAS>-r</ALIAS>
- <TIP>Produce a relocatable output module</TIP>
- <HELP>Produce a relocatable output module</HELP>
- </OPTION>
-
- <OPTION tag='REREAD_LIBS'>
- <TYPE>simple</TYPE>
- <NAME>--reread_libs</NAME>
- <ALIAS>-x</ALIAS>
- <TIP>Reread libraries; resolve backward references</TIP>
- <HELP>Reread libraries; resolve backward references</HELP>
- </OPTION>
-
- <OPTION tag='RETAIN'>
- <TYPE>simple</TYPE>
- <NAME>--retain</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym_or_scn_spec</DESCRIPTION>
- </ARG>
- <TIP>Specify symbols/sections to be retained by linker</TIP>
- <HELP>When --unused_section_elimination is enabled, the ELF linker does not include a section in the final link if it is not needed in the executable to resolve references. This option can be used to tell the linker to retain a list of sections that would otherwise be not retained. This option accepts the wild cards '*' and '?' and when wild cards are used, the argument should be in quotes. The following option parameters are accepted:
- --retain=symbol_spec retains sections that define symbol matching the argument. For ex, --retain='init*' retains sections that define symbols that start with 'init'. User may not specify --retain='*'.
- --retain=file_spec(scn_spec [,scn_spec ...]) retains sections matching scn_spec(s) from files matching file_spec. For ex, the argument '*(.initvec)' causes the linker to retain .initvec sections from all input files.
- NOTE: User can specify --retain='*(*)' to retain all the sections from all the input object files. Note that this does not prevent sections from library members from being optimized out. If you want to totally disable unused section elimination, please use --unused_section_elimination=off.
- --retain=ar_spec<mem_spec, [mem_spec ...]>(scn_spec, [scn_spec ...]) retains sections matching scn_spec(s) from members matching mem_spec(s) from archive files matching ar_spec. For ex, rts32eabi.lib<printf.obj>(.text) causes the linker to retain .text section from printf.obj in rts32eabi.lib. If the library is specified with -l option (-lrts32eabi.lib) the library search path is used to search the library. User may not specify '*<*>(*)'. </HELP>
- </OPTION>
-
- <OPTION tag='ROM'>
- <TYPE>simple</TYPE>
- <NAME>--rom</NAME>
- <TIP>Create a ROM object</TIP>
- <HELP>This option allows the creation of ROM object module</HELP>
- </OPTION>
-
- <OPTION tag='ROM_MODEL'>
- <TYPE>simple</TYPE>
- <NAME>--rom_model</NAME>
- <ALIAS>-c</ALIAS>
- <TIP>Link using ROM autoinitialization model</TIP>
- <HELP>Link using ROM autoinitialization model</HELP>
- <RESETS>RAM_MODEL</RESETS>
- </OPTION>
-
- <OPTION tag='RPATH'>
- <TYPE>simple</TYPE>
- <NAME>--rpath</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Add directory to beginning of dynamic library search path</TIP>
- <HELP>The specified directory will be searched BEFORE the directories in LD_LIBRARY_PATH</HELP>
- </OPTION>
-
- <OPTION tag='RUN_ABS'>
- <TYPE>cmdline</TYPE>
- <NAME>--run_abs</NAME>
- <ALIAS>-abs</ALIAS>
- <TIP>Produce absolute listing file</TIP>
- <HELP>Produce absolute listing file</HELP>
- </OPTION>
-
- <OPTION tag='RUNPATH'>
- <TYPE>simple</TYPE>
- <NAME>--runpath</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Add directory to end of dynamic library search path</TIP>
- <HELP>The specified directory will be searched AFTER the directories in LD_LIBRARY_PATH</HELP>
- </OPTION>
-
- <OPTION tag='SCAN_LIBRARIES'>
- <TYPE>simple</TYPE>
- <NAME>--scan_libraries</NAME>
- <ALIAS>-scanlibs</ALIAS>
- <TIP>Scan libraries for duplicate symbol definitions</TIP>
- <HELP>Check whether symbol definitions that are pulled into the link are duplicated in any of the libraries included in the build. This information is typically ignored as the linker will pull in the first definition it encounters.</HELP>
- </OPTION>
-
- <OPTION tag='SEARCH_PATH'>
- <TYPE>simple</TYPE>
- <NAME>--search_path</NAME>
- <PREFERREDALIAS>-i</PREFERREDALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>dir</DESCRIPTION>
- </ARG>
- <TIP>Add <dir> to library search path</TIP>
- <HELP>Alter the library-search algorithm to look in dir before looking in the default location. This option must appear before the -l option.</HELP>
- </OPTION>
-
- <OPTION tag='SET_ERROR_LIMIT'>
- <TYPE>simple</TYPE>
- <NAME>--set_error_limit</NAME>
- <ARG>
- <TYPE>NUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>count</DESCRIPTION>
- </ARG>
- <TIP>Set error limit to <count></TIP>
- <HELP>Set error limit to <count></HELP>
- </OPTION>
-
- <OPTION tag='SONAME'>
- <TYPE>simple</TYPE>
- <NAME>--soname</NAME>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>soname</DESCRIPTION>
- </ARG>
- <TIP>Specify ELF shared object file name</TIP>
- <HELP>Specify ELF shared object file name</HELP>
- </OPTION>
-
- <OPTION tag='STACK_SIZE'>
- <TYPE>simple</TYPE>
- <NAME>--stack_size</NAME>
- <ALIAS>-stack</ALIAS>
- <ALIAS>--stack</ALIAS>
- <ARG>
- <TYPE>HEXNUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>Set C system stack size</TIP>
- <HELP>Set C system stack size</HELP>
- </OPTION>
-
- <OPTION tag='STRICT_COMPATIBILITY'>
- <TYPE>simple</TYPE>
- <NAME>--strict_compatibility</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Strict compatibility checking</TIP>
- <HELP>Strict compatibility checking</HELP>
- </OPTION>
-
- <OPTION tag='SYMBOL_MAP'>
- <TYPE>simple</TYPE>
- <NAME>--symbol_map</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>refname=defname</DESCRIPTION>
- </ARG>
- <TIP>Specify a symbol map, mapping refname to defname</TIP>
- <HELP>Symbol mapping allows a symbol reference to be resolved by a symbol with different name. Symbol mapping allows functions to be overridden with alternate definitions. This feature can be used to patch in alternate implementations, which provide patches (bug fixes) or alternate functionality. For example, the option --symbol_map='foo=foo_patch' makes the linker resolve any references to foo by the definition foo_patch.</HELP>
- </OPTION>
-
- <OPTION tag='TRAMPOLINE_MIN_SPACING'>
- <TYPE>simple</TYPE>
- <NAME>--trampoline_min_spacing</NAME>
- <ARG>
- <TYPE>HEXNUMBER</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>size</DESCRIPTION>
- </ARG>
- <TIP>Minimum space between non-adjacent trampolines</TIP>
- <HELP>When trampoline reservations are spaced more closely than this limit, try to make them adjacent. A higher value minimizes fragmentation, but may result in more trampolines. A lower value may reduce trampolines, at the expense of fragmentation and linker running time. Specifying 0 for this option disables coalescing. The default is 16K.</HELP>
- </OPTION>
-
- <OPTION tag='TRAMPOLINES'>
- <TYPE>simple</TYPE>
- <NAME>--trampolines</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Generate far call trampolines</TIP>
- <HELP>Generate far call trampolines</HELP>
- </OPTION>
-
- <OPTION tag='UNDEF_SYM'>
- <TYPE>simple</TYPE>
- <NAME>--undef_sym</NAME>
- <ALIAS>-u</ALIAS>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>sym</DESCRIPTION>
- </ARG>
- <TIP>Add <sym> to symbol table as an unresolved symbol</TIP>
- <HELP>Add <sym> to symbol table as an unresolved symbol</HELP>
- </OPTION>
-
- <OPTION tag='UNDEFINE'>
- <TYPE>simple</TYPE>
- <NAME>--undefine</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>name</DESCRIPTION>
- </ARG>
- <TIP>Undefine preprocessor macro _name_</TIP>
- <HELP>Undefine preprocessor macro _name_</HELP>
- </OPTION>
-
- <OPTION tag='UNHIDE'>
- <TYPE>simple</TYPE>
- <NAME>--unhide</NAME>
- <ARG>
- <TYPE>STRINGLIST</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>pattern</DESCRIPTION>
- </ARG>
- <TIP>Exclude symbols matching pattern from hiding</TIP>
- <HELP>The option --hide=hide_pattern makes the symbols matching the hide_pattern hidden. The --unhide=unhide_pattern option excludes symbols matching unhide_pattern from symbol hiding provided unhide_pattern is more restrictive than hide_pattern. </HELP>
- </OPTION>
-
- <OPTION tag='UNUSED_SECTION_ELIMINATION'>
- <TYPE>simple</TYPE>
- <NAME>--unused_section_elimination</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Eliminate sections not needed in the executable</TIP>
- <HELP>In order to minimize memory use, the linker does not include a section that is not needed to resolve any references in the final executable. --unused_section_elimination=off can be used to disable this optimization.</HELP>
- </OPTION>
-
- <OPTION tag='VERBOSE_DIAGNOSTICS'>
- <TYPE>simple</TYPE>
- <NAME>--verbose_diagnostics</NAME>
- <TIP>Verbose diagnostics</TIP>
- <HELP>Verbose diagnostics</HELP>
- </OPTION>
-
- <OPTION tag='WARN_SECTIONS'>
- <TYPE>simple</TYPE>
- <NAME>--warn_sections</NAME>
- <ALIAS>-w</ALIAS>
- <TIP>Warn if an unspecified output section is created</TIP>
- <HELP>Warn if an unspecified output section is created</HELP>
- </OPTION>
-
- <OPTION tag='XML_LINK_INFO'>
- <TYPE>simple</TYPE>
- <NAME>--xml_link_info</NAME>
- <ALIAS>-xml_link_info</ALIAS>
- <ARG>
- <TYPE>STRING</TYPE>
- <STATUS>required</STATUS>
- <DESCRIPTION>file</DESCRIPTION>
- </ARG>
- <TIP>Detailed link information data-base into <file></TIP>
- <HELP>Produce a detailed link information data-base into the file named <file>.</HELP>
- </OPTION>
-
- <OPTION tag='ZERO_INIT'>
- <TYPE>simple</TYPE>
- <NAME>--zero_init</NAME>
- <ARG>
- <TYPE>ONEOF</TYPE>
- <STATUS>optional</STATUS>
- <DESCRIPTION>on,off</DESCRIPTION>
- <ONEOF>on</ONEOF>
- <ONEOF>off</ONEOF>
- <DEFAULT>on</DEFAULT>
- </ARG>
- <TIP>Zero initialize ELF uninitialized sections</TIP>
- <HELP>This option indicates that the linker should generate compressed cinit table records that zero initializes ELF uninitialized sections during boot. This option is ignored if --rom_model option is not specified.</HELP>
- </OPTION>
-
- <MUTEX tag='MUTEX_INITIALIZATION_MODEL'>
- <NAME>Initialization model</NAME>
-
- <SEVERITY>RESET</SEVERITY>
- <STATUS>optional</STATUS>
- <MEMBER>ROM_MODEL</MEMBER>
- <MEMBER>RAM_MODEL</MEMBER>
- </MUTEX>
- </DEFINITIONS>
- <BASIC>
- </BASIC>
- <CATEGORY tag='LNKBASIC'>
- <NAME>Basic Options:</NAME>
-
- <MEMBER>OUTPUT_FILE</MEMBER>
- <MEMBER>MAP_FILE</MEMBER>
- <MEMBER>STACK_SIZE</MEMBER>
- <MEMBER>HEAP_SIZE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKDIR'>
- <NAME>File Search Path:</NAME>
-
- <MEMBER>LIBRARY</MEMBER>
- <MEMBER>SEARCH_PATH</MEMBER>
- <MEMBER>PRIORITY</MEMBER>
- <MEMBER>REREAD_LIBS</MEMBER>
- <MEMBER>DISABLE_AUTO_RTS</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKADV'>
- <NAME>Advanced Options:</NAME>
-
- <MEMBERCAT>LNKCPP</MEMBERCAT>
- <MEMBERCAT>LNKDIAG</MEMBERCAT>
- <MEMBERCAT>LNKOUTF</MEMBERCAT>
- <MEMBERCAT>LNKSYM</MEMBERCAT>
- <MEMBERCAT>LNKRTENV</MEMBERCAT>
- <MEMBERCAT>LNKOPT</MEMBERCAT>
- <MEMBERCAT>LNKMISC</MEMBERCAT>
- <MEMBERCAT>LNKINT</MEMBERCAT>
- <MEMBERCAT>DYNAMIC</MEMBERCAT>
- <MEMBERCAT>LNKULP</MEMBERCAT>
- <MEMBERCAT>LNKADVICE</MEMBERCAT>
- </CATEGORY>
-
- <CATEGORY tag='LNKCPP'>
- <NAME>Command File Preprocessing:</NAME>
-
- <MEMBER>UNDEFINE</MEMBER>
- <MEMBER>DEFINE</MEMBER>
- <MEMBER>DISABLE_PP</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKDIAG'>
- <NAME>Diagnostics:</NAME>
-
- <MEMBER>BUFFER_DIAGNOSTICS</MEMBER>
- <MEMBER>DIAG_ERROR</MEMBER>
- <MEMBER>ISSUE_REMARKS</MEMBER>
- <MEMBER>NO_DEMANGLE</MEMBER>
- <MEMBER>VERBOSE_DIAGNOSTICS</MEMBER>
- <MEMBER>SET_ERROR_LIMIT</MEMBER>
- <MEMBER>WARN_SECTIONS</MEMBER>
- <MEMBER>NO_WARNINGS</MEMBER>
- <MEMBER>DIAG_WARNING</MEMBER>
- <MEMBER>DIAG_REMARK</MEMBER>
- <MEMBER>EMIT_WARNINGS_AS_ERRORS</MEMBER>
- <MEMBER>DISPLAY_ERROR_NUMBER</MEMBER>
- <MEMBER>DIAG_SUPPRESS</MEMBER>
- <MEMBER>DIAG_WRAP</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKOUTF'>
- <NAME>Linker Output:</NAME>
-
- <MEMBER>XML_LINK_INFO</MEMBER>
- <MEMBER>RUN_ABS</MEMBER>
- <MEMBER>MAPFILE_CONTENTS</MEMBER>
- <MEMBER>ECC__DATA_ERROR</MEMBER>
- <MEMBER>ROM</MEMBER>
- <MEMBER>ECC__ECC_ERROR</MEMBER>
- <MEMBER>ABSOLUTE_EXE</MEMBER>
- <MEMBER>RELOCATABLE</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKSYM'>
- <NAME>Symbol Management:</NAME>
-
- <MEMBER>MAKE_STATIC</MEMBER>
- <MEMBER>NO_SYM_MERGE</MEMBER>
- <MEMBER>NO_SYMTABLE</MEMBER>
- <MEMBER>UNHIDE</MEMBER>
- <MEMBER>RETAIN</MEMBER>
- <MEMBER>UNDEF_SYM</MEMBER>
- <MEMBER>ENTRY_POINT</MEMBER>
- <MEMBER>HIDE</MEMBER>
- <MEMBER>LOCALIZE</MEMBER>
- <MEMBER>SCAN_LIBRARIES</MEMBER>
- <MEMBER>GLOBALIZE</MEMBER>
- <MEMBER>SYMBOL_MAP</MEMBER>
- <MEMBER>MAKE_GLOBAL</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKRTENV'>
- <NAME>Runtime Environment:</NAME>
-
- <MEMBER>MUTEX_INITIALIZATION_MODEL</MEMBER>
- <MEMBER>FILL_VALUE</MEMBER>
- <MEMBER>TRAMPOLINES</MEMBER>
- <MEMBER>ARG_SIZE</MEMBER>
- <MEMBER>MULTITHREAD</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKOPT'>
- <NAME>Linktime Optimization:</NAME>
-
- <MEMBER>COPY_COMPRESSION</MEMBER>
- <MEMBER>UNUSED_SECTION_ELIMINATION</MEMBER>
- <MEMBER>CINIT_COMPRESSION</MEMBER>
- <MEMBER>COMPRESS_DWARF</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='LNKMISC'>
- <NAME>Miscellaneous:</NAME>
-
- <MEMBER>STRICT_COMPATIBILITY</MEMBER>
- <MEMBER>DISABLE_CLINK</MEMBER>
- <MEMBER>PREFERRED_ORDER</MEMBER>
- <MEMBER>ZERO_INIT</MEMBER>
- <MEMBER>MINIMIZE_TRAMPOLINES</MEMBER>
- <MEMBER>LINKER_HELP</MEMBER>
- <MEMBER>TRAMPOLINE_MIN_SPACING</MEMBER>
- </CATEGORY>
-
- <CATEGORY tag='DYNAMIC'>
- <NAME>Dynamic Linking Support Options:</NAME>
-
- <MEMBER>EXPORT</MEMBER>
- <MEMBER>INIT</MEMBER>
- <MEMBER>DSBT_INDEX</MEMBER>
- <MEMBER>RPATH</MEMBER>
- <MEMBER>IMPORT</MEMBER>
- <MEMBER>BIND_NOW</MEMBER>
- <MEMBER>DSBT_SIZE</MEMBER>
- <MEMBER>DYNAMIC</MEMBER>
- <MEMBER>RUNPATH</MEMBER>
- <MEMBER>FORCED_STATIC_BINDING</MEMBER>
- <MEMBER>SONAME</MEMBER>
- <MEMBER>FINI</MEMBER>
- </CATEGORY>
-
- </TOOL>
- </TOOLSET>
|