Možnosti linkeru
LINK.exe propojí soubory a knihovny objektů Common Object File Format (COFF) a vytvoří spustitelný soubor (EXE) nebo dynamickou knihovnu (DLL).
Následující tabulka uvádí možnosti pro LINK.exe. Další informace o odkazu najdete tady:
Na příkazovém řádku nejsou možnosti linkeru rozlišovat malá a velká písmena; Například /base
a /BASE
to samé. Podrobnosti o tom, jak určit jednotlivé možnosti na příkazovém řádku nebo v sadě Visual Studio, najdete v dokumentaci k této možnosti.
Pomocí direktivy comment
pragma můžete zadat některé možnosti linkeru.
Možnosti linkeru uvedené abecedně
Možnost | Účel |
---|---|
@ |
Určuje soubor odpovědi. |
/ALIGN |
Určuje zarovnání každého oddílu. |
/ALLOWBIND |
Určuje, že knihovnu DLL nelze svázat. |
/ALLOWISOLATION |
Určuje chování pro vyhledávání manifestu. |
/APPCONTAINER |
Určuje, jestli se aplikace musí spouštět v prostředí procesu appcontainer. |
/ARM64XFUNCTIONPADMINX64 |
Určuje minimální počet bajtů odsazení mezi funkcemi x64 v imagích ARM64X.17.8 |
/ASSEMBLYDEBUG |
Přidá spravovanou DebuggableAttribute image. |
/ASSEMBLYLINKRESOURCE |
Vytvoří odkaz na spravovaný prostředek. |
/ASSEMBLYMODULE |
Určuje, že modul jazyka MSIL (Microsoft Intermediate Language) by se měl importovat do sestavení. |
/ASSEMBLYRESOURCE |
Vloží spravovaný soubor prostředků do sestavení. |
/BASE |
Nastaví základní adresu programu. |
/CETCOMPAT |
Označí binární soubor jako kompatibilní se stínovým zásobníkem CET. |
/CGTHREADS |
Nastaví počet vláken cl.exe pro optimalizaci a generování kódu při zadání generování kódu v době propojení. |
/CLRIMAGETYPE |
Nastaví typ (IJW, čistý nebo bezpečný) image CLR. |
/CLRSUPPORTLASTERROR |
Zachovává poslední kód chyby funkcí, které jsou volány prostřednictvím mechanismu volání nespravovaného kódu. |
/CLRTHREADATTRIBUTE |
Určuje atribut threading, který se má použít na vstupní bod programu CLR. |
/CLRUNMANAGEDCODECHECK |
Určuje, jestli linker použije SuppressUnmanagedCodeSecurity atribut na zástupné procedury P/Invoke generované linkerem, které volají ze spravovaného kódu do nativních knihoven DLL. |
/DEBUG |
Vytvoří informace o ladění. |
/DEBUGTYPE |
Určuje, která data se mají zahrnout do informací o ladění. |
/DEF |
Předá soubor definice modulu (.def) linkeru. |
/DEFAULTLIB |
Vyhledá zadanou knihovnu při překladu externích odkazů. |
/DELAY |
Řídí zpožděné načítání knihoven DLL. |
/DELAYLOAD |
Způsobí zpožděné načítání zadané knihovny DLL. |
/DELAYSIGN |
Částečně podepíše sestavení. |
/DEPENDENTLOADFLAG |
Nastaví výchozí příznaky závislých načtení knihovny DLL. |
/DLL |
Vytvoří knihovnu DLL. |
/DRIVER |
Vytvoří ovladač režimu jádra. |
/DYNAMICBASE |
Určuje, jestli se má vygenerovat spustitelný obrázek, který se v době načítání znovu založí pomocí funkce randomizace rozložení adresního prostoru (ASLR). |
/ENTRY |
Nastaví počáteční adresu. |
/ERRORREPORT |
Zastaralé Zasílání zpráv o chybách se řídí nastavením Zasílání zpráv o chybách systému Windows (WER). |
/EXPORT |
Exportuje funkci. |
/FILEALIGN |
Zarovná oddíly ve výstupním souboru na násobcích zadané hodnoty. |
/FIXED |
Vytvoří program, který lze načíst pouze na upřednostňovanou základní adresu. |
/FORCE |
Vynutí, aby se propojení dokončilo i s nevyřešenými symboly nebo symboly definovanými více než jednou. |
/FUNCTIONPADMIN |
Vytvoří image, která může být opravena za tepla. |
/GENPROFILE , /FASTGENPROFILE |
Obě tyto možnosti určují generování .pgd souboru linkerem pro podporu optimalizace s asistencí profilu (PGO). /GENPROFILE a /FASTGENPROFILE používají různé výchozí parametry. |
/GUARD |
Povolí ochranu ochrany toku řízení. |
/HEAP |
Nastaví velikost haldy v bajtech. |
/HIGHENTROPYVA |
Určuje podporu randomizace 64bitového adresního prostoru s vysokou entropií (ASLR). |
/IDLOUT |
Určuje název souboru a dalších výstupních .idl souborů MIDL. |
/IGNORE |
Potlačí výstup zadaných upozornění linkeru. |
/IGNOREIDL |
Zabraňuje zpracování informací o atributu .idl do souboru. |
/ILK |
Přepíše výchozí název souboru přírůstkové databáze. |
/IMPLIB |
Přepíše výchozí název knihovny importu. |
/INCLUDE |
Vynutí odkazy na symboly. |
/INCREMENTAL |
Řídí přírůstkové propojení. |
/INFERASANLIBS |
Používá odvozené knihovny sanitizátoru. |
/INTEGRITYCHECK |
Určuje, že modul vyžaduje kontrolu podpisu v době načtení. |
/KERNEL |
Vytvořte binární soubor režimu jádra. |
/KEYCONTAINER |
Určuje kontejner klíčů pro podepsání sestavení. |
/KEYFILE |
Určuje pár klíčů nebo klíčů pro podepsání sestavení. |
/LARGEADDRESSAWARE |
Informuje kompilátor, že aplikace podporuje adresy větší než 2 gigabajty. |
/LIBPATH |
Určuje cestu, která se má vyhledat před cestou knihovny prostředí. |
/LINKREPRO |
Určuje cestu k vygenerování artefaktů reproprodukování propojení. |
/LINKREPROFULLPATHRSP |
Vygeneruje soubor odpovědi obsahující absolutní cesty ke všem souborům, které linker vzal jako vstup. |
/LINKREPROTARGET |
Vygeneruje reproprodukci propojení pouze při vytváření zadaného cíle.16.1 |
/LTCG |
Určuje generování kódu v čase propojení. |
/MACHINE |
Určuje cílovou platformu. |
/MANIFEST |
Vytvoří soubor manifestu vedle sebe a volitelně ho vloží do binárního souboru. |
/MANIFESTDEPENDENCY |
Určuje <závislý oddílAssembly> v souboru manifestu. |
/MANIFESTFILE |
Změní výchozí název souboru manifestu. |
/MANIFESTINPUT |
Určuje vstupní soubor manifestu, který má linker zpracovat a vložit do binárního souboru. Tuto možnost můžete použít vícekrát k zadání více než jednoho vstupního souboru manifestu. |
/MANIFESTUAC |
Určuje, jestli se informace řízení uživatelských účtů (UAC) vloží do manifestu programu. |
/MAP |
Vytvoří soubor mapování. |
/MAPINFO |
Zahrne zadané informace do souboru map. |
/MERGE |
Kombinuje oddíly. |
/MIDL |
Určuje možnosti příkazového řádku MIDL. |
/NATVIS |
Přidá vizualizéry ladicího programu ze souboru Natvis do programové databáze (PDB). |
/NOASSEMBLY |
Potlačí vytvoření sestavení rozhraní .NET Framework. |
/NODEFAULTLIB |
Při překladu externích odkazů ignoruje všechny (nebo zadané) výchozí knihovny. |
/NOENTRY |
Vytvoří knihovnu DLL pouze pro prostředky. |
/NOFUNCTIONPADSECTION |
Zakáže odsazení funkce pro funkce v zadané části.17.8 |
/NOLOGO |
Potlačí úvodní banner. |
/NXCOMPAT |
Označí spustitelný soubor jako ověřený, aby byl kompatibilní s funkcí Prevence spuštění dat systému Windows. |
/OPT |
Řídí optimalizace LINK. |
/ORDER |
Umístí funkce COMDAT do obrázku v předem určeném pořadí. |
/OUT |
Určuje název výstupního souboru. |
/PDB |
Vytvoří soubor PDB. |
/PDBALTPATH |
Používá alternativní umístění k uložení souboru PDB. |
/PDBSTRIPPED |
Vytvoří soubor PDB, který neobsahuje žádné privátní symboly. |
/PGD |
Určuje .pgd soubor pro optimalizace s asistencí profilu. |
/POGOSAFEMODE |
Zastaralé vytvoří sestavení PGO bezpečné pro přístup z více vláken. |
/PROFILE |
Vytvoří výstupní soubor, který lze použít s profilerem nástrojů výkonu. |
/RELEASE |
Nastaví kontrolní součet v .exe záhlaví. |
/SAFESEH |
Určuje, že image bude obsahovat tabulku bezpečných obslužných rutin výjimek. |
/SECTION |
Přepíše atributy oddílu. |
/SOURCELINK |
Určuje soubor SourceLink, který se má přidat do souboru PDB. |
/STACK |
Nastaví velikost zásobníku v bajtech. |
/STUB |
Připojí program zástupných procedur MS-DOS k programu Win32. |
/SUBSYSTEM |
Řekne operačnímu systému, jak soubor spustit .exe . |
/SWAPRUN |
Řekne operačnímu systému, aby před spuštěním zkopíroval výstup linkeru do prohození souboru. |
/TIME |
Výstupní linker předává informace o časování. |
/TLBID |
Určuje ID prostředku knihovny typů generované linkerem. |
/TLBOUT |
Určuje název souboru a dalších výstupních .tlb souborů MIDL. |
/TSAWARE |
Vytvoří aplikaci, která je navržená speciálně pro spuštění v rámci terminálového serveru. |
/USEPROFILE |
K vytvoření optimalizované image používá trénovací data optimalizace s asistencí profilu. |
/VERBOSE |
Vytiskne zprávy o průběhu linkeru. |
/VERSION |
Přiřadí číslo verze. |
/WHOLEARCHIVE |
Zahrnuje každý soubor objektu ze zadaných statických knihoven. |
/WINMD |
Povolí generování souboru metadat prostředí Windows Runtime. |
/WINMDFILE |
Určuje název souboru pro výstupní soubor prostředí Windows Runtime Metadata (winmd), který je generován možností linkeru/WINMD . |
/WINMDKEYFILE |
Určuje klíč nebo pár klíčů pro podepsání souboru metadat prostředí Windows Runtime. |
/WINMDKEYCONTAINER |
Určuje kontejner klíčů pro podepsání souboru metadat systému Windows. |
/WINMDDELAYSIGN |
Částečně podepíše soubor metadat prostředí Windows Runtime umístěním.winmd veřejného klíče do souboru winmd. |
/WX |
Považuje upozornění linkeru za chyby. |
16.1 Tato možnost je dostupná od sady Visual Studio 2019 verze 16.1.
17.8 Tato možnost je dostupná od sady Visual Studio 2022 verze 17.8.
Viz také
Referenční dokumentace k sestavení jazyka C/C++
Referenční zdroje k linkeru MSVC