Příkazy Linux / Unix: Id

To řekne ld, aby vytvořil soubor nazvaný výstup jako výsledek propojení souboru "/lib/crt0.o" s "hello.o" a knihovny "libc.a", která bude pocházet ze standardních vyhledávacích adresářů. (Viz diskuse o volbě -l níže.)

Některé možnosti příkazového řádku na ld mohou být zadány v libovolném okamžiku příkazového řádku. Možnosti, které se vztahují k souborům, například -l nebo -T , způsobují, že soubor bude čten v místě, kde se tato možnost zobrazí v příkazovém řádku vzhledem k souborům objektů a dalším možnostem souborů. Opakování volby, které nejsou součástí souboru, s jiným argumentem, nebudou mít žádný další účinek, ani nepřepisují předchozí výskyty (ty, které jsou dále vlevo na příkazovém řádku) této možnosti. Možnosti, které mohou být významně specifikovány více než jednou, jsou uvedeny v popisu níže.

Argumenty bez možnosti jsou soubory objektů nebo archivy, které mají být propojeny. Mohou následovat, předcházet nebo být smíchány s volbami příkazového řádku, kromě toho, že mezi volbou a jeho argumentem nesmí být umístěn argument objektu.

Obvykle je odkazovač vyvolán alespoň jedním objektem, ale můžete zadat jiné formy binárních vstupních souborů pomocí příkazů -l , -R a příkazového jazyka skriptu. Pokud nejsou zadány žádné binární vstupní soubory, linker nevytváří žádný výstup a vydá zprávu No No input files .

Pokud linker nerozpozná formát souboru objektu, předpokládá, že jde o linkerový skript. Takto zadaný skript rozšiřuje hlavní linkerový skript používaný pro odkaz (buď výchozí skript propojovacího propojovacího skriptu nebo ten, který je specifikován pomocí -T ). Tato funkce dovoluje spojovacímu prvku propojit soubor, který se jeví jako objekt nebo archiv, ale ve skutečnosti pouze definuje některé hodnoty symbolů nebo používá "INPUT" nebo "GROUP" pro načtení dalších objektů. Všimněte si, že zadání skriptu tímto způsobem pouze doplňuje hlavní skript linkeru; použijte volbu -T, chcete-li úplně nahradit výchozí skript odkazovače.

U voleb, jejichž jména jsou jediné písmeno, musí být argumenty možností buď následovány písmenem volby bez mezery, nebo mohou být uvedeny jako samostatné argumenty bezprostředně po volbě, která je vyžaduje.

U voleb, jejichž jména jsou více písmen, může předcházet název možnosti buď jedna pomlčka nebo dvě; například -trace-symbol a -trace-symbol jsou ekvivalentní. Poznámka - existuje jedna výjimka z tohoto pravidla. Možnosti více písmen, které začínají písmenem "o", lze předcházet pouze dvěma pomlčkami. Toto je omezit zmatek s volbou -o . Například -omagický nastavuje název výstupního souboru na magickou, zatímco --omagic nastavuje příznak NMAGIC na výstupu.

Argumenty pro vícepísmenové volby musí být buď odděleny od názvu možnosti znakem rovnosti, nebo mohou být uvedeny jako samostatné argumenty bezprostředně po volbě, která je vyžaduje. Například --trace-symbol foo a -trace-symbol = foo jsou ekvivalentní. Používají se jedinečné zkratky názvů několika písmen.

Poznámka: pokud je linker vyvolán nepřímo přes ovladač kompilátoru (např. Gcc ), pak by všechny volby příkazového řádku linkeru měly být předpony pomocí -Wl, (nebo co je vhodné pro konkrétní ovladač kompilátoru) takto:

To je důležité, protože v opačném případě program řidiče kompilátoru může klidně spustit volbu linkeru, což má za následek špatný odkaz.

Zde je tabulka generických přepínačů příkazového řádku přijatých linkerem GNU:

klíčové slovo

Tato možnost je podporována pro kompatibilitu s HP / UX. Argument pro klíčové slovo musí být jeden z archivů řetězce , sdílený nebo výchozí . -aarchive je funkčně ekvivalentní s -Bstatic , a další dvě klíčová slova jsou funkčně ekvivalentní k -Bodynamic . Tato volba může být použita několikrát.

- Architektura

--architecture = architektura

V současném vydání ld je tato volba užitečná pouze pro architekturu rodiny Intel 960. V této konfiguraci ld argument architektury identifikuje konkrétní architekturu rodiny 960, což umožňuje některé bezpečnostní prvky a upravuje vyhledávací cestu knihovny archivu.

Budoucí verze programu ld mohou podporovat podobné funkce pro jiné rodiny architektur.

-b vstupní formát

- formát = vstupní formát

ld může být nakonfigurován tak, aby podporoval více než jeden typ souboru objektu. Pokud je vaše ld nakonfigurováno tímto způsobem, můžete použít volbu -b pro zadání binárního formátu souborů vstupních objektů, které se podle této možnosti na příkazovém řádku zobrazují. Dokonce i když je ld nakonfigurován tak, aby podporoval formáty alternativních objektů, obvykle to není nutné specifikovat, protože ld by měl být konfigurován tak, aby očekával jako výchozí vstupní formát nejběžnější formát na každém stroji. vstupní formát je textový řetězec, název určitého formátu podporovaného knihovnami BFD. (Dostupné binární formáty můžete zobrazit pomocí příkazu objdump -i .)

Tuto možnost můžete použít, pokud propojíte soubory s neobvyklým binárním formátem. Můžete také použít -b k přepínání formátů explicitně (při propojení objektových souborů různých formátů) tím, že před každou skupinou objektových souborů v určitém formátu obsahuje formát vstupu -b .

Výchozí formát je převzat z proměnné prostředí "GNUTARGET".

Můžete také definovat vstupní formát ze skriptu pomocí příkazu "TARGET";

-c MRI-commandfile

--mri-script = MRI-příkazový soubor

Pro kompatibilitu s linkery vytvořenými pomocí MRI, ld přijímá soubory skriptu napsané v alternativním, omezeném příkazovém jazyce popsaném v části Dokumenty GNU ld MRI Compatible Script Files. Vložte soubory skriptu MRI s volbou -c ; použijte volbu -T pro spouštění linkerových skriptů napsaných ve skriptovacím jazyce obecného určení. Pokud MRI-cmdfile neexistuje, ld ji vyhledá v adresářích určených libovolnými možnostmi -L .

-d

-DC

-dp

Tyto tři možnosti jsou ekvivalentní; pro kompatibilitu s ostatními linkery jsou podporovány více formulářů. Přiřazují prostor běžným symbolům, i když je určen přesunovatelný výstupní soubor (s -r ). Příkaz skriptu "FORCE_COMMON_ALLOCATION" má stejný účinek.

-e vstup

--entry = vstup

Použijte položku jako explicitní symbol pro počáteční spuštění vašeho programu spíše než výchozí vstupní bod. Pokud neexistuje symbol pojmenovaný záznam , linker se pokusí analyzovat záznam jako číslo a použije jako vstupní adresu (číslo bude interpretováno v základně 10, můžete použít přední 0x pro základnu 16 nebo vedoucí 0 pro základnu 8).

-E

--exportně dynamická

Při vytváření dynamicky propojeného spustitelného souboru přidejte všechny symboly do tabulky dynamických symbolů. Tabulka dynamických symbolů je množina symbolů, které jsou viditelné z dynamických objektů při běhu.

Pokud tuto možnost nepoužíváte, tabulka dynamických symbolů bude normálně obsahovat pouze ty symboly, na které odkazuje nějaký dynamický objekt uvedený v odkazu.

Pokud použijete "dlopen" k načtení dynamického objektu, který potřebuje odkazovat zpět na symboly definované programem, spíše než nějaký jiný dynamický objekt, pravděpodobně budete muset použít tuto možnost při propojení samotného programu.

Pomocí skriptu verze můžete také ovládat, jaké symboly by měly být přidány do tabulky dynamických symbolů, pokud to podporuje výstupní formát. Viz popis --version-script v @ ref {VERSION}.

-EB

Spojte velké objekty. To ovlivňuje výchozí formát výstupu.

-EL

Spojte malé endiánské objekty. To ovlivňuje výchozí formát výstupu.

-F

- pomocné jméno

Při vytváření sdíleného objektu ELF nastavte interní pole DT_AUXILIARY na zadaný název. To informuje dynamický linker, že tabulka symbolů sdíleného objektu by měla být použita jako pomocný filtr na tabulce symbolů názvu sdíleného objektu.

Pokud později propojíte program s tímto objektem filtru, při spuštění programu se dynamickým linkerem zobrazí pole DT_AUXILIARY. Pokud dynamický linker vyřeší nějaké symboly z objektu filtru, nejprve zkontroluje, zda existuje název sdíleného objektu. Pokud existuje, použije se namísto definice ve filtrovacím objektu. Název sdíleného objektu nemusí existovat. Název sdíleného objektu tedy může být použit k zajištění alternativní implementace určitých funkcí, snad pro ladění nebo pro specifický výkon stroje.

Tuto možnost lze zadat více než jednou. Položky DT_AUXILIARY budou vytvořeny v pořadí, ve kterém se objeví na příkazovém řádku.

-F název

- jméno filtru

Při vytváření sdíleného objektu ELF nastavte interní pole DT_FILTER na zadaný název. To informuje dynamický linker, že tabulka symbolů sdíleného objektu, který se vytváří, by měla být použita jako filtr na tabulce symbolů názvu sdíleného objektu.

Pokud později propojíte program s tímto objektem filtru, při spuštění programu se dynamickým linkerem zobrazí pole DT_FILTER. Dynamický linker vyřeší symboly podle tabulky symbolů objektu filtru jako obvykle, ale ve skutečnosti bude odkazovat na definice nalezené ve sdíleném názvu objektu. Objekt filtru lze tedy použít k výběru podmnožiny symbolů poskytnutých názvem objektu.

Někteří starší odkazující používali volbu -F v celé kompilační sadě nástrojů pro zadání formátu objektového souboru pro vstupní i výstupní objektové soubory. GNU linker používá pro tento účel další mechanismy: volby -b , -format , -format , příkaz "TARGET" v linkerových skriptech a proměnná prostředí "GNUTARGET". GNU linker ignoruje volbu -F, když nevytvoří sdílený objekt ELF.

-fini jméno

Při vytváření spustitelného nebo sdíleného objektu ELF volejte NAME, když je spustitelný nebo sdílený objekt uvolněn, nastavením DT_FINI na adresu funkce. Ve výchozím nastavení odkazovač používá funkci "_fini" jako funkci volání.

-G

Ignorováno. Za předpokladu kompatibility s jinými nástroji.

-G hodnota

--gpsize = hodnota

Nastavte maximální velikost objektů, které chcete optimalizovat, pomocí velikosti registru GP. To je smysluplné pouze pro formáty objektových souborů, jako je MIPS ECOFF, který podporuje umístění velkých a malých objektů do různých sekcí. Toto je ignorováno pro jiné formáty souborů objektů.

-h jméno

-soname = jméno

Při vytváření sdíleného objektu ELF nastavte interní pole DT_SONAME na zadaný název. Když je spustitelný soubor spojen se sdíleným objektem, který má pole DT_SONAME, pak se po spuštění spustitelného souboru dynamický linker pokusí načíst sdílený objekt zadaný pomocí pole DT_SONAME namísto použití názvu souboru daného linkeru.

-i

Proveďte přírůstkové spojení (stejně jako možnost -r ).

-init jméno

Při vytváření spustitelného nebo sdíleného objektu ELF zavolejte NAME, když je zaveden spustitelný nebo sdílený objekt, nastavením DT_INIT na adresu funkce. Ve výchozím nastavení odkazovač používá jako volání funkci "_init".

-l archiv

--library = archiv

Přidejte archiv archivních souborů do seznamu souborů, které chcete propojit. Tato volba může být použita několikrát. ld prohledá seznam svých cest pro výskyty "libarchive.a" pro každý zadaný archiv .

Na systémech, které podporují sdílené knihovny, může ld hledat také knihovny s rozšířeními jinými než ".a". Konkrétně, na systémech ELF a SunOS, ld vyhledá adresář knihovny s příponou ".so" před vyhledáním adresáře s příponou ".a". Podle konvence označuje rozšíření ".so" sdílenou knihovnu.

Linker vyhledá archiv pouze jednou, na místě, kde je zadán na příkazovém řádku. Pokud archív definuje symbol, který nebyl definován v nějakém objektu, který se objevil před archivem na příkazovém řádku, linker bude obsahovat příslušné soubory z archivu. Avšak nedefinovaný symbol v objektu, který se objeví později na příkazovém řádku, nezpůsobí, že linker znovu vyhledá archiv.

Podívejte se na možnost - ( možnost, jak přinutit odkazovač několikrát vyhledávat archivy.

Stejný archiv můžete listovat vícekrát na příkazovém řádku.

Tento typ vyhledávání archivů je pro unixové linkery standardní. Pokud používáte ld onAIX, všimněte si, že se liší od chování linkeru AIX.

-L searchdir

--library-path = searchdir

Přidat path searchdir do seznamu cest, které ld vyhledá knihovny archivu a ld řídicí skripty. Tuto možnost můžete použít několikrát. Adresáře jsou prohledávány v pořadí, ve kterém jsou zadány na příkazovém řádku. Adresáře zadané na příkazovém řádku jsou prohledávány před výchozími adresáři. Všechny možnosti -L se vztahují na všechny možnosti -l bez ohledu na pořadí, ve kterém se objevují možnosti.

Pokud vyhledávací prvek začíná znakem "=", pak bude "=" nahrazeno předponou sysroot , kterou jste zadali při nakonfigurování linkeru.

Výchozí sada hledaných cest (bez zadání s -L ) závisí na tom, který emulační režim ld používá, a v některých případech také na tom, jak byl konfigurován.

Cesta může být také zadána ve skriptu odkazu s příkazem "SEARCH_DIR". Adresáře zadané tímto způsobem jsou vyhledávány v místě, kde se v příkazovém řádku objeví skript propojení.

-m emulace

Emulace spojovacího prvku emulace . Můžete uvést dostupné emulace pomocí volby --verbose nebo -V .

Pokud se volba -m nepoužívá, emulace je převzata z proměnné prostředí "LDEMULATION", pokud je definována.

V opačném případě výchozí emulace závisí na tom, jak byl nakonfigurován linker.

-M

--print-map

Vytiskněte mapu odkazů na standardní výstup. Mapa odkazů obsahuje informace o tomto odkazu, včetně následujících:

* * *

Kde jsou soubory souborů a symboly mapovány do paměti.

* * *

Jak jsou přiděleny běžné symboly.

* * *

Do tohoto odkazu byli zařazeni všichni členové archivu se zmínkou o symbolu, který způsobil, že byl archivář vložen.

-n

--nmagický

Vypněte zarovnání stránek a označte výstup jako "NMAGIC" pokud je to možné.

-N

--omagický

Nastavte textové a datové sekce, aby byly čitelné a zapisovatelné. Nezapomeňte také na segment datových segmentů a zakázat propojení se sdílenými knihovnami. Pokud výstupní formát podporuje unixové magické čísla, označte výstup jako "OMAGIC".

- neomagický

Tato možnost vylučuje většinu účinků možnosti -N . Nastaví textový oddíl tak, aby byl pouze pro čtení, a nutí datový segment, aby byl zarovnán na stránku. Poznámka - tato možnost neumožňuje propojení se sdílenými knihovnami. Použijte -Bodynamic pro toto.

-o výstup

- výstup = výstup

Použijte výstup jako název programu vytvořeného ld ; pokud tato možnost není zadána, použije se výchozí název a.out . Příkaz skriptu "OUTPUT" může také zadat název výstupního souboru.

-O úroveň

Pokud je úroveň číselných hodnot větší než nula ld, optimalizuje výstup. To může trvat podstatně déle, a proto by pravděpodobně mělo být povoleno pouze pro poslední binární.

-q

--emit-relocs

Ponechat oddíly a obsah přemístění v plně propojených exececutables. Analýza odkazů a nástroje pro optimalizaci odkazu mohou tyto informace potřebovat, aby provedly správné úpravy spustitelných souborů. Výsledkem jsou větší spustitelné soubory.

Tato možnost je v současné době podporována pouze na platformách ELF.

-r

- lze vyměnit

Vygenerujte přemístitelný výstup --- tj. Vygenerujte výstupní soubor, který může následně sloužit jako vstup do ld . Toto se často nazývá částečné propojení . Jako vedlejší efekt v prostředích podporujících standardní magické čísla Unixu tato možnost také nastavuje magické číslo výstupního souboru na hodnotu "OMAGIC". Není-li tato možnost zadána, vytvoří se absolutní soubor. Při propojení programů C ++ tato možnost nevyřeší odkazy na konstruktory; k tomu použijte -Ur .

Pokud vstupní soubor nemá stejný formát jako výstupní soubor, částečné propojení je podporováno pouze v případě, že tento vstupní soubor neobsahuje žádné přemístění. Různé výstupní formáty mohou mít další omezení; například některé formáty založené na "a.out" nepodporují částečné propojení se vstupními soubory v jiných formátech vůbec.

Tato volba dělá totéž jako -i .

-R název souboru

- just-symbols = název souboru

Přečtěte si názvy symbolů a jejich adresy z názvu souboru , ale nepřevádějte jej ani jej nezahrnujte do výstupu. To umožňuje, aby váš výstupní soubor symbolicky odkazoval na absolutní umístění paměti definované v jiných programech. Tuto možnost můžete použít více než jednou.

Pro kompatibilitu s ostatními linkery ELF, pokud je za volbou -R následováno jméno adresáře, nikoli název souboru, bude se jednat o volbu -rath .

-s

-strip-vše

Vynechat všechny informace o symbolu z výstupního souboru.

-S

-strip-ladění

Vynechat informace o symbolovém ladění (ale ne všechny symboly) z výstupního souboru.

-t

--stopa

Vytiskněte jména vstupních souborů, jak je zpracovává ld .

-T scriptfile

--script = scriptfile

Použijte soubor scriptfile jako odkazovací skript. Tento skript nahrazuje výchozí skript linkeru ld (spíše než jeho přidání), takže příkazový soubor musí specifikovat vše potřebné k popisu výstupního souboru. Pokud soubor scriptfile neexistuje v aktuálním adresáři, vyhledá to "ld" v adresářích zadaných libovolnými předcházejícími možnostmi -L . Několik možností -T se hromadí.

-u symbol

--undefined = symbol

Symbol síly je třeba zadat do výstupního souboru jako nedefinovaný symbol. K tomu může například spouštět propojení dalších modulů ze standardních knihoven. -u lze opakovat s různými argumenty možností pro zadání dalších nedefinovaných symbolů. Tato volba je ekvivalentní příkazu "EXTERN" linker script.

-Ur

Pro cokoli jiného než programy C ++ je tato volba ekvivalentní s -r : generuje přemístitelný výstup --- tj. Výstupní soubor, který může následně sloužit jako vstup do ld . Při propojení programů C ++ -Ur nerozpozná odkazy na konstruktory, na rozdíl od -r . Nepoužívá -Ur v souborech, které byly propojeny s -Ur ; jakmile byla konstruktorová tabulka postavena, nelze ji přidat. Použijte -Ur pouze pro poslední dílčí odkaz a -r pro ostatní.

--unique [= SECTION ]

Vytvoří samostatnou výstupní sekci pro každou vstupní sekci odpovídající sekci SECTION nebo pokud chybí volitelný argument SECTION wildcard pro každou sekci vstupu. Osiřelý úsek není jednoznačně uveden v skriptu linkeru. Tuto možnost můžete použít několikrát na příkazovém řádku. Zabraňuje normální slučování vstupních úseků se stejným názvem, které mají přepsané přiřazení úseků výstupu v skriptu propojky.

-proti

--verze

-PROTI

Zobrazte číslo verze pro ld . Volba -V také uvádí seznam podporovaných emulací.

-X

-diskard-vše

Smazat všechny místní symboly.

-X

- místní obyvatelé

Smazat všechny dočasné místní symboly. Pro většinu cílů jsou to všechny lokální symboly, jejichž jména začínají písmeny L.

-y symbol

--trace-symbol = symbol

Vytiskněte název každého propojeného souboru, ve kterém se objeví symbol . Tato možnost může být zadána libovolným počtem. Na mnoha systémech je nutné předcházet podtržítko.

Tato volba je užitečná, pokud máte ve svém odkazu neurčený symbol, ale nevíte, odkud odkaz pochází.

-Y cesta

Přidat cestu k výchozí cestě hledání knihovny. Tato možnost existuje pro kompatibilitu Solaris.

-z klíčové slovo

Uznávané klíčová slova jsou "initfirst", "interpose", "loadfltr", "nodefaultlib", "nodelete", "nodlopen", "nodump", "now", " ". Ostatní ostatní klíčová slova jsou ignorována pro kompatibilitu Solaris. "initfirst" označuje objekt, který má být inicializován nejprve za běhu před jinými objekty. "interpose" označuje objekt, který se v tabulce symbolů vkládá před všechny symboly, ale primární spustitelný soubor. "loadfltr" označuje objekt, který má být zpracováván okamžitě během běhu. "nodefaultlib" označuje objekt, který bude ignorovat hledání závislostí tohoto objektu všechny výchozí cesty hledání knihovny. "nodelete" označuje, že objekt by neměl být za běhu vykládán. "nodlopen" označuje objekt, který není k dispozici pro "dlopen". "nodump" označuje, že objekt nemůže být vyhozen do "dldump". "nyní" označí objekt s ne-lazy runtime vazba. "původ" označuje objekt může obsahovat $ ORIGIN. "defs" nepovoluje nedefinované symboly. "muldefs" umožňuje několik definic. "combreloc" kombinuje více úseků přesunu a třídí je tak, aby bylo možné provést ukládání dynamických symbolů do mezipaměti.

"nocombreloc" zabraňuje kombinování více částí přemístění. "nocopyreloc" zabraňuje výrobě kopírování.

- ( archivy -)

- archiv skupiny start-end-group

Archivy by měly obsahovat seznam archivních souborů . Mohou to být buď explicitní názvy souborů nebo volby -l .

Zadané archivy jsou opakovaně prohledávány, dokud nebudou vytvořeny žádné nové nedefinované odkazy. Obvykle je archiv vyhledáván pouze jednou v pořadí, které je zadáno na příkazovém řádku. Pokud je v tomto archivu potřebný symbol pro vyřešení nedefinovaného symbolu, na který odkazuje objekt v archivu, který se objeví později na příkazovém řádku, linker by tento odkaz neuměl vyřešit. Seskupením archivů se všichni opakovaně prohledávají, dokud nebudou vyřešeny všechny možné odkazy.

Použití této možnosti má významné výkonnostní náklady. Nejlépe je použít pouze tehdy, když existují nevyhnutelné kruhové odkazy mezi dvěma nebo více archivy.

--accept-unknown-input-arch

--no-přijmout-neznámý-vstup-arch

Řekne linkeru, aby přijímal vstupní soubory, jejichž architektura nemůže být rozpoznána. Předpokladem je, že uživatel ví, co dělají, a záměrně chce propojit tyto neznámé vstupní soubory. Toto bylo výchozí chování linkeru před vydáním verze 2.14. Výchozím chováním z vydání verze 2.14 je odmítnutí takových vstupních souborů a tak byla přidána možnost -accept-unknown-input-arch pro obnovení starého chování.

- klíčové slovo

Tato možnost je ignorována pro kompatibilitu SunOS .

-Bdynamický

-dy

-call_shared

Spojení s dynamickými knihovnami. To má smysl pouze na platformách, pro které jsou podporovány sdílené knihovny . Tato možnost je zpravidla standardní pro takové platformy. Různé varianty této možnosti jsou kompatibilní s různými systémy. Tuto volbu můžete použít několikrát na příkazovém řádku: ovlivňuje vyhledávání knihovny pro volby -l, které ji následují.

-Bgroup

Nastavte příznak "DF_1_GROUP" v položce "DT_FLAGS_1" v dynamické části. To způsobí, že spojovací modul runtime zpracovává vyhledávání v tomto objektu a jeho závislosti je třeba provést pouze uvnitř skupiny. --no-nedefinováno je implicitní. Tato volba má smysl pouze na platformách ELF, které podporují sdílené knihovny .

-Bstatic

-dn

-non_shared

-statický

Nepřipojujte se ke sdíleným knihovnám. To má smysl pouze na platformách, pro které jsou podporovány sdílené knihovny. Různé varianty této možnosti jsou kompatibilní s různými systémy. Tuto volbu můžete použít několikrát na příkazovém řádku: ovlivňuje vyhledávání knihovny pro volby -l, které ji následují.

-Bsymbolický

Při vytváření sdílené knihovny vázat odkazy na globální symboly definici v rámci sdílené knihovny, pokud existuje. Obvykle je možné, že program propojený se sdílenou knihovnou přepsá definici v rámci sdílené knihovny. Tato možnost má smysl pouze na platformách ELFplatform, které podporují sdílené knihovny.

- kontrolní sekce

- nekontrolovat sekce

Požádá linker , aby nekontroloval adresy sekcí po přiřazení, aby zjistil, zda nedošlo k překrývání. Normálně linker provede tuto kontrolu a pokud zjistí nějaké překrytí, vytvoří vhodné chybové zprávy. Linker o tom ví a upravuje sekce v překryvných vrstvách. Výchozí chování lze obnovit pomocí přepínače příkazového řádku -check-sections .

--cref

Vyjměte tabulku křížových odkazů. Je-li generován soubor mapovacího odkazovače, křížová tabulka se vytiskne do souboru mapy. Jinak se tiskne na standardní výstup.

Formát tabulky je úmyslně jednoduchý, takže může být v případě potřeby snadno zpracován skriptem. Symboly jsou vytištěny, seřazeny podle názvu. U každého symbolu je uveden seznam názvů souborů. Pokud je definován symbol, první uvedený soubor je umístění definice. Zbývající soubory obsahují odkazy na symbol.

--no-define-common

Tato volba zabraňuje přiřazení adres k běžným symbolům. Příkaz skriptu "INHIBIT_COMMON_ALLOCATION" má stejný účinek.

Možnost --no-define-common umožňuje oddělit rozhodnutí přiřazení adres k běžným symbolům z výběru typu výstupního souboru; jinak nepřevoditelný typ výstupu přenáší adresy na běžné symboly. Použití --no-define-common umožňuje, aby společné symboly, které jsou odkazovány ze sdílené knihovny, byly přiřazeny adresám pouze v hlavním programu. To eliminuje nepoužívaný duplicitní prostor ve sdílené knihovně a také zabraňuje jakémukoli možnému zmatku nad vyřešením nesprávného dupliku, pokud existuje mnoho dynamických modulů se specializovanými vyhledávacími cestami pro rozlišení symbolu běhu.

--defsym symbol = výraz

Vytvořte globální symbol ve výstupním souboru obsahujícím absolutní adresu danou výrazem . Tuto možnost můžete použít tolikrát, kolikrát je potřeba pro definování více symbolů v příkazovém řádku. Pro výraz v tomto kontextu je podporována omezená forma aritmetiky: můžete zadat hexadecimální konstantu nebo název existujícího symbolu nebo použít "+" a "-" pro přidání nebo odečítání hexadecimálních konstant nebo symbolů. Pokud potřebujete mnohem propracovanější výrazy, zvažte použití příkazového jazyka linkeru ze skriptu. Poznámka: mezi symbolem , znakem rovná (`` = '') a výrazem nesmí být žádný bílý prostor.

--demangle [= style ]

--no-odizolování

Tyto možnosti určují, zda chcete v chybových zprávách a jiných výstupech odstranit názvy symbolů. Když je spojovací prvek přeměněn, snaží se prezentovat názvy symbolů čitelným způsobem: prolistuje vedoucí podtržítka, pokud jsou používány ve formátu souboru objektu, a převede názvy symbolů C ++ do uživatelsky čitelných názvů. Různí kompilátoři mají různé styly. Volitelný argument stylu vyměnitelnosti lze použít pro výběr vhodného stylu vyměnitelnosti pro kompilátor. Spojovací prvek bude výchozí, pokud není nastavena proměnná prostředí COLLECT_NO_DEMANGLE . Tyto možnosti lze použít k přepsání výchozího nastavení.

--dynamický linker

Nastavte název dynamického linkeru. To má smysl pouze při generování dynamicky spřažených spustitelných souborů ELF. Výchozí dynamický linker je normálně správný; nepoužívejte to, pokud nevíte, co děláte.

- vložené-přemístit

Tato volba je smysluplná pouze tehdy, když propojíte MIPS vložený PIC kód generovaný volbou -membedded-pic na kompilátor a assembler GNU. Způsobí, že linker vytvoří tabulku, která může být použita při běhu k přemístění všech dat, které byly staticky inicializovány na hodnoty ukazatele. Podrobné informace naleznete v kódu testsuite / ld-empic.

- varování před smrtí

Všechny varování považujte za chyby .

- force-exe-suffix

Ujistěte se, že výstupní soubor má příponu .exe.

Pokud úspěšně sestavený plně propojený výstupní soubor nemá příponu " .exe " nebo " .dll ", tato možnost nucuje linkeru zkopírovat výstupní soubor na jeden stejný název s příponou ".exe". Tato volba je užitečná při použití nemodifikovaných makefile Unix na hostiteli systému Microsoft Windows, protože některé verze systému Windows nebudou zobrazovat obraz, dokud se nezobrazí přípona ".exe".

--no-gc-sekce

--gc-sekce

Povolit sběr nepotřebných vstupních úseků. Je ignorována na cílech, které tuto možnost nepodporují. Tato volba není kompatibilní s parametrem -r , ani s dynamickým propojením. Výchozí chování (nevykonání této sbírky odpadků ) lze obnovit zadáním --no-gc-sections na příkazovém řádku.

--Pomoc

Vytiskněte souhrn možností příkazového řádku na standardní výstup a výstup.

--Target-help

Vytiskněte shrnutí všech možností pro konkrétní cíl na standardním výstupu a výstupu.

-Map mapový soubor

Vytiskněte mapu odkazů na soubor mapového souboru. Viz popis výše uvedené možnosti -M .

--no-uchovat-paměť

ld normálně optimalizuje rychlost při využití paměti tím, že ukládá tabulky symbolů vstupních souborů do paměti. Tato volba informuje, že ld místo toho optimalizuje využití paměti, tím, že podle potřeby přeformuluje tabulky symbolů. To může být nutné, pokud ld vyčerpá paměťový prostor při propojení velkého spustitelného souboru.

--no-nedefinováno

-z defs

Normálně při vytváření ne-symbolické sdílené knihovny jsou povoleny nedefinované symboly, které lze vyřešit načítacím modulem runtime. Tyto volby nepovolují takové nedefinované symboly.

--allow-multiple-definition

-z muldefs

Normálně, když je symbol definován vícekrát, odkazovač hlásí fatální chybu. Tyto možnosti umožňují několik definic a použije se první definice.

--allow-shlib-nedefinováno

Povolit nedefinované symboly ve sdílených objektech, i když je nastaveno --no-undefined. Výsledkem bude, že nedefinované symboly v běžných objektech budou ještě vyvolávat chybu, ale nedefinované symboly ve sdílených objektech budou ignorovány. Implementace no_undefined předpokládá, že runtime linker se zmáčkne na nedefinované symboly. Existuje přinejmenším jeden systém (BeOS), kde jsou nedefinované symboly v sdílených knihovnách normální, jelikož je jádro opraví při načítání, aby se zvolila, která funkce je nejvhodnější pro aktuální architekturu. IE dynamicky zvolí příslušnou funkci memset. Zřejmě je také normální, že sdílené knihovny HPPA mají neurčené symboly.

--no-nedefinovaná verze

Normálně, pokud má symbol nedefinovanou verzi, odkazovač ji bude ignorovat. Tato volba nepovoluje symboly s nedefinovanou verzí a namísto toho bude vydána fatální chyba.

--no-varování-Neshoda

Obvykle se zobrazí chybová zpráva, pokud se pokusíte spojit vstupní soubory, které jsou z nějakého důvodu nesprávné, možná proto, že byly kompilovány pro různé procesory nebo pro různé endiannesses. Tato volba říká ld , že by tyto chyby měla povolit tiše. Tato možnost by měla být používána pouze opatrně, v případech, kdy jste podnikli nějaké zvláštní kroky, které zajistí, že chyby spojovacího řetězce jsou nevhodné.

--no-celý-archiv

Vypněte efekt volby - celá archivace pro následující archivní soubory.

--noinhibit-exec

Zachovat spustitelný výstupní soubor vždy, když je stále použitelný. Obvykle linker nebude produkovat výstupní soubor, pokud narazí na chyby během procesu propojení; opustí, aniž by psal výstupní soubor, když vydává jakoukoli chybu.

-nostdlib

Na příkazovém řádku explicitně zadávejte pouze adresáře knihovny vyhledávání. Adresáře knihovny zadané v skriptech linkeru (včetně linkerových skriptů zadaných na příkazovém řádku) jsou ignorovány.

- formát formátu výstupu

ld může být nakonfigurován tak, aby podporoval více než jeden typ souboru objektu. Pokud je vaše ld takto nakonfigurováno, můžete použít volbu --oformat pro zadání binárního formátu souboru výstupního objektu. Dokonce i když je ld nakonfigurován tak, aby podporoval formáty alternativních objektů, obvykle to nemusíte specifikovat, protože ld by měl být nakonfigurován tak, aby produkoval jako výchozí výstupní formát nejběžnější formát na každém stroji. výstupní formát je textový řetězec, název určitého formátu podporovaného knihovnami BFD. (Můžete uvést dostupné binární formáty pomocí příkazu objdump -i .) Příkaz skriptu "OUTPUT_FORMAT" může také specifikovat výstupní formát, ale tato volba ho přepíše.

-qmagic

Tato možnost je ignorována pro kompatibilitu s operačním systémem Linux.

-Qy

Tato možnost je ignorována pro kompatibilitu SVR4.

--odpočinout si

Možnost s efekty závislou na stroji. Tato možnost je podporována pouze u několika cílů.

Na některých platformách prověří volba --relax globální optimalizace, která se stanou možnými, když linker řeší adresování v programu, například uvolnění adresových režimů a syntetizování nových instrukcí v souboru výstupních objektů.

Na některých platformách mohou tyto globální optimalizace vazeb času způsobit, že symbolické ladění výsledného spustitelného souboru je nemožné. To je známo, že se jedná o řadu procesorů Matsushita MN10200 a MN10300.

Na platformách, kde to není podporováno, --relax je akceptován, ale ignorován.

--retain-symbols-file název souboru

Zachovat pouze symboly uvedené v souboru název souboru , vyřadit všechny ostatní. název souboru je jednoduše plochý soubor s jedním symbolem na každý řádek. Tato volba je užitečná zejména v prostředích (např. VxWorks), kde se postupně sbírá velká globální tabulka symbolů, aby se ušetřila paměť běhu.

--retain-symbols-file neodstraňuje nedefinované symboly nebo symboly potřebné pro přemístění.

V příkazovém řádku můžete pouze zadat --retain-symbols-file . Přepíše -s a -S .

-rpath dir

Přidejte adresář do cesty hledání knihovny. Toto se používá při propojení ELFexecutable se sdílenými objekty. Argumenty všech argumentů jsou zřetězeny a předány linkeru runtime, který je používá k vyhledání sdílených objektů za běhu. Možnost -rath je také použita při hledání sdílených objektů, které jsou potřebné pro sdílené objekty explicitně zahrnuté do odkazu; viz popis možnosti -path-link . Není-li cesta použita při propojení spustitelného souboru ELF, použije se obsah proměnné prostředí "LD_RUN_PATH", pokud je definován.

Možnost -rath může být také použita na SunOS. Ve výchozím nastavení na odkazu SunOS vytvoří linker nápovědu pro vyhledávání podle runtime ze všech možností -L, které jsou uvedeny. Je-li použita volba -rath , cesta hledání bude vytvořena výhradně pomocí volby -path , ignorovat volby -L . To může být užitečné při použití příkazu gcc, který přidává mnoho možností -L, které mohou být připojeny na souborových systémech NFS.

Pro kompatibilitu s ostatními linkery ELF, pokud je za volbou -R následováno jméno adresáře, nikoli název souboru, bude se jednat o volbu -rath .

-rpath-link DIR

Pokud používáte ELF nebo SunOS, může jedna sdílená knihovna vyžadovat další. K tomu dochází, když odkaz "ld-shared" obsahuje sdílenou knihovnu jako jeden ze vstupních souborů.

Když se linker setká s takovou závislostí při provádění nesdíleného odkazu, který není přemístitelný, automaticky se pokusí nalézt požadovanou sdílenou knihovnu a zahrnout ji do odkazu, pokud není explicitně zahrnut. V takovém případě volba -path-link určuje první sadu adresářů pro vyhledávání. Možnost -path-link může určit sekvenci názvů adresářů buď zadáním seznamu názvů oddělených dvojtečkami nebo opakovaným zobrazením.

Tato možnost by měla být používána s opatrností, protože přepíše vyhledávací cestu, která byla pravděpodobně zkompilována do sdílené knihovny. V takovém případě je možné neúmyslně použít jinou vyhledávací cestu než linker runtime.

Linker používá následující vyhledávací cesty k nalezení požadovaných sdílených knihoven.

1.

Libovolné adresáře určené volbou -path-link .

2.

Libovolné adresáře určené volbou -path . Rozdíl mezi -path a -rpath-link je, že adresáře specifikované volbou -path jsou zahrnuty do spustitelného souboru a používány za běhu, zatímco volba -rpath-link je účinná pouze v čase spojení. Je to pouze nativní linker.

3.

V systému ELF, pokud nebyly použity volby -rpath a "rpath-link", vyhledejte obsah proměnné prostředí "LD_RUN_PATH". Je to pouze nativní linker.

4.

Pokud na serveru SunOS nebyla použita volba -rath , vyhledávejte libovolné adresáře zadané pomocí voleb -L .

5.

Pro nativního linkeru obsah proměnné prostředí "LD_LIBRARY_PATH".

6.

Pro přirozený odkaz ELF jsou adresáře v adresáři "DT_RUNPATH" nebo "DT_RPATH" sdílené knihovny vyhledávány pro sdílené knihovny, které potřebuje. Položky "DT_RPATH" jsou ignorovány, pokud existují položky "DT_RUNPATH".

7.

Výchozí adresáře, obvykle / lib a / usr / lib .

8.

Pro původní linker v systému ELF existuje soubor /etc/ld.so.conf , který obsahuje seznam adresářů nalezených v daném souboru.

Není-li nalezena požadovaná sdílená knihovna, odkazovač vydá varování a pokračuje v propojení.

-shared

-Barebný

Vytvořte sdílenou knihovnu. To je v současné době podporováno pouze na platformách ELF, XCOFF a SunOS. Na serveru SunOS spojovací prvek automaticky vytvoří sdílenou knihovnu, pokud není použita volba -e a na odkazu jsou neurčené symboly.

--sort-common

Tato volba udává, že ld třídí běžné symboly podle velikosti, když je umístí do příslušných výstupních sekcí. Nejprve přijdou všechny symboly jednoho bajtu, pak všechny dva byty, potom všechny čtyři bajty a pak všechno ostatní. To má zabránit mezery mezi symboly kvůli omezením zarovnání.

--split-by-file [ velikost ]

Podobně jako --split-by-reloc, ale vytvoří novou výstupní sekci pro každý vstupní soubor při dosažení velikosti . velikost je výchozí na velikost 1, pokud není zadán.

--split-by-reloc [ počet ]

Snaží se vytvořit další oddíly ve výstupním souboru tak, aby žádná samostatná část výstupu v souboru neobsahovala více než počet přemístění. To je užitečné při vytváření obrovských přemístitelných souborů pro stahování do určitých jader v reálném čase pomocí formátu souboru objektů COFF; protože COFF nemůže představovat více než 65535 přesunů v jedné sekci. Všimněte si, že to nebude fungovat s formáty souborů objektů, které nepodporují libovolné oddíly. Spojovací prvek nerozdělí jednotlivé vstupní části pro redistribuci, takže pokud jedna vstupní část obsahuje více než počet přemístění, jedna výstupní část bude obsahovat mnoho přemístění. počet výchozích hodnot je 32768.

--staty

Vypočítat a zobrazit statistiky o provozu linkeru, jako je doba provádění a využití paměti.

- tradiční formát

Pro některé cíle je výstup ld odlišný v některých ohledech od výstupu nějakého existujícího linkeru. Tento přepínač požaduje, aby místo toho používal tradiční formát.

Například na SunOS, ld kombinuje duplicitní položky v tabulce symbolů. To může snížit velikost výstupního souboru s úplnými informacemi o ladění o více než 30 procent. Bohužel, program SunOS "dbx" nemůže číst výsledný program ("gdb" nemá žádné potíže). Přepínač - tradiční formát informuje ld, že nesmí kombinovat duplicitní záznamy.

--section-start sectionname = org

Vyhledejte část ve výstupním souboru na absolutní adrese danou org . Tuto volbu můžete použít tolikrát, kolikrát je potřeba k nalezení více sekcí v příkazovém řádku. org musí být jedno hexadecimální celé číslo; pro kompatibilitu s ostatními linkery můžete vynechat přední 0x obvykle spojenou s hexadecimálními hodnotami. Poznámka: mezi názvem sekce , znakem rovnosti (`` = '') a org .

-Tbss org

-Tdata org

-Tex org

Použijte org jako výchozí adresu pro --- bss, resp. "Bss", "data" nebo "textový" segment výstupního souboru. org musí být jedno hexadecimální celé číslo; pro kompatibilitu s ostatními linkery můžete vynechat přední 0x obvykle spojenou s hexadecimálními hodnotami.

-dll-verbose

--verbose

Zobrazte číslo verze pro ld a seznam podporovaných emulací linkeru. Zobrazte, které vstupní soubory lze a nelze otevřít. Zobrazí skript propojovacího propojení, který používá linker.

--version-script = verze-scriptfile

Zadejte název skriptu verze odkazu. Toto je obvykle používáno při vytváření sdílených knihoven, které určují další informace o hierarchii verze pro vytvořenou knihovnu. Tato volba má smysl pouze na platformách ELF, které podporují sdílené knihovny.

--warn-common

Varujte, když je společný symbol kombinován s jiným běžným symbolem nebo s definicí symbolu. Unixové linkery dovolují tuto poněkud nedbalou praxi, ale linkery na některých jiných operačních systémech ne. Tato možnost vám umožní najít potenciální problémy při kombinaci globálních symbolů. Některé knihovny C bohužel tuto praxi používají, takže si můžete v knihovnách, stejně jako ve vašich programech, upozornit na symboly.

Existují tři druhy globálních symbolů, ilustrované zde v příkladech C:

int i = 1;

Definice, která se nachází v části inicializovaných dat výstupního souboru.

external int i;

Neurčený odkaz, který nevymezuje prostor. Musí existovat definice nebo společný symbol pro proměnnou někde.

int i;

Společný symbol. Pokud pro proměnnou existuje pouze jeden (nebo více) společných symbolů, jde o neinicializovanou datovou oblast výstupního souboru. Spojovací prvek spojuje více společných symbolů pro stejnou proměnnou do jediného symbolu. Jsou-li různé velikosti, vybírá největší velikost. Linker promění společný symbol do deklarace, pokud existuje definice stejné proměnné.

Možnost --warn-common může vytvořit pět druhů varování. Každé varování se skládá z dvojice řádků: první popisuje právě nalezený symbol a druhý popisuje předchozí symbol se stejným názvem. Jeden nebo oba dva symboly budou společným symbolem.

1.

Otočení společného symbolu do odkazu, protože již existuje definice symbolu.