如果没有配置–orphan-handling 选项，则默认为 place 处理方式。

**–unique[=SECTION]**：
使用该选项，链接器会对匹配的指定输入段，创建一个单独的同名输出段。该选项可以使用多次。

-v && –version && -V :
该选项显示链接器的版本号。

-x && –discard-all :
该选项用于从输出文件中删除所有局部符号。（局部符号只在定义它们的模块中可见，如局部变量、静态函数等。这些符号在链接过程中不再需要，因为它们对其他模块不可见，所以也不会对最终的可执行文件或库产生影响。）

-X && –discard-locals :
临时本地符号（以系统特定的本地标签前缀开头）由编译器或汇编器生成，用于临时性标记某些代码或数据块，但它们不应该被链接到最终的输出文件中。
该选项用于删除所有临时本地符号，减少输出文件大小。

-y symbol && –trace-symbol=symbol :
该选项用于打印包含特定符号的输入文件，该选项可以使用多次，用来追踪不同的符号。

-Y path ：
将指定路径添加到默认的库搜索路径中。（该选项是用来兼容Solaris系统）

-z keyword ：
用于向链接器传递特定的关键字参数 keyword ，其中 keyword 是链接器的一些特定功能或行为的标志。 keywork 例如：

–accept-unknown-input-arch && –no-accept-unknown-input-arch ：
这两个选项用于控制链接器对输入文件的处理方式：

一般情况下，不同架构的文件是无法链接在一起的，因为它们的二进制格式和指令集不兼容。然而一些特殊的情况下，例如在进行跨平台开发时，可能会使用一些特殊的技术或工具，使得不同的架构代码可以链接在一起。

–as-needed && –no-as-needed :

–copy-dt-needed-entries && –no-copy-dt-needed-entries ：

-Bdynamic && -dy && -call_shared :
该选项用来指示链接器在生成可执行文件时，查找和链接到动态库。
该选项存在多个变体，是为了兼容不同的系统。

-Bgroup：
该选用 仅用于支持ELF和动态库的系统中 。
使用该选项，可以让 运行时链接器 仅在库对象及其依赖的库内进行库符号查找，不会搜索其它库。使用该选项，确保了库符号解析在一个封闭的组内进行，有助于避免符号冲突。并且由于减少了链接器的搜索范围，可以提高程序的启动速度。
例如：
gcc -Wl,-Bgroup -lgroup1 -Wl,-Bgroup -lgroup2 -o my_program
库 libgroup1 和 libgroup2 被放到两个独立的组中，如果 libgroup1 和 libgroup2 中均存在函数 foo ，则链接器在解析 libgroup1 中的 foo 函数时，仅会在 libgroup1 及其依赖库中检索。在解析 libgroup2 中的 foo 函数时，仅会在 libgroup2 及其依赖库中检索。

-Bstatic && -dn && -non_shared && -static ：
该选项控制链接器不要使用共享库，使用静态库。 不同的变体是为了兼容不同的系统。该选项可以使用多次，它会影响其后的 -l 选项。

-Bsymbolic :
在创建共享库时使用该选项，会指示链接器将程序中对全局符号的引用绑定到共享库内部的定义。该选项有助于减少共享库和主程序之间的符号冲突，确保共享库的符号定义不会被外部定义覆盖。
例如，共享库：

1
2
3
4
5
6

// libexample.c
int counter = 0;

void increment() {
    counter++;
}

1
2
3
4
5
6
7
8
9
10
11

// main.c
#include <stdio.h>

extern




    
 void increment();
int counter = 10; // 主程序中的 counter

int main() {
    increment();
    printf("Counter: %d\n", counter);
    return 0;
}

如果共享库编译时没有指定 -Bsymbolic 选项，当主程序调用increment时，由于符号解析是在运行时进行的，increment函数会增加主程序中的counter，输出的counter值为11。

-Bsymbolic-functions ：
该选项作用和选项 -Bsymbolic 类似，但该选项专门用于函数符号。
创建共享库时指定该选项，链接器会将对全局函数符号的引用绑定到共享库内部的定义。

-Bno-symbolic：
该选项用于取消之前指定的 -Bsymbolic 和 -Bsymbolic-functions` 选项的作用

–dynamic-list=dynamic-list-file ：
该选项可以用来指定一个文件，该文件中包含一个全局符号列表。
创建共享库时指定该选项，则对文件中所列符号的引用不会绑定到共享库内部。
例如：
文件 dynamic-list.txt

1
2
3
4

{
  global_init;
  global_cleanup;
};

使用该命令创建共享库：
gcc -shared -o libexample.so obj1.o obj2.o -Wl,--dynamic-list=dynamic-list.txt
–dynamic-list=dynamic-list.txt 选项告诉链接器读取 dynamic-list.txt 文件，并根据其中列出的符号来处理符号绑定。这样，即使 libexample.so 中定义了 global_init 和 global_cleanup，它们也不会被绑定到库内部的定义，允许外部程序在运行时提供这些函数的替代实现。

创建可执行文件时指定该选项，会将文件中所列的符号添加到可执行文件符号列表中。
例如：
文件：dynamic-list.txt

1
2
3

{
  plugin_interface;
};

使用该命令创建可执行程序：
gcc -o app main.o -Wl,--dynamic-list=dynamic-list.txt
–dynamic-list=dynamic-list.txt 选项告诉链接器读取 dynamic-list.txt 文件，并将其中列出的符号添加到可执行文件的符号表中。这样，当 app 加载动态插件时，插件可以找到并使用 plugin_interface 符号，即使它是在 app 中定义的。

–dynamic-list-data ：
创建共享库时使用该选项，会使得共享库中的全局符号，包含在动态符号表中。其它链接到这个库的程序，可以访问这些全局符号。

创建可执行程序时使用该选项，会使得程序中定义的全局符号包含在动态符号表中，当程序在运行时动态加载一个插件（共享库），该插件可以访问动态符号表中的全局符号。

动态符号表：由链接器创建，包含了程序中所有需要在运行时进行符号解析的全局符号。ELF文件中被标记为ALLOC（A）。

–dynamic-list-cpp-new ：
使用该选项，链接器会创建一个内置的动态列表，专门用于C++的new 和 delete 操作符。这个选项在构建共享的libstdc++库（c++内存管理共享库）时非常有用。

-dynamic-list-cpp-typeinfo：
使用该链接选项，链接器会创建内置的动态列表，这个列表专门用于C++运行时类型识别（RTTI）。RTTI允许程序在运行时确定对象的类型。在C++中，typeid 操作符和 dynamic_cast 转换通常用于此目的。

当构建共享库或可执行文件时，使用 -dynamic-list-cpp-typeinfo 选项可以确保与类型识别相关的符号（如类型信息对象和类型名称）被包含在动态符号表中，用于支持跨模块的类型检查和转换，特别是程序中使用了多态和需要在运行时进行类型安全检查时。

–check-sections && –no-check-sections ：
这两个选项用于控制链接器是否检查分配给每个段（section）的地址是否有重叠。
–check-sections 是默认行为，链接器会进行检查。

–copy-dt-needed-entries && –no-copy-dt-needed-entries ：

–cref ：
该选项用于生成交叉引用表。表格中包含每个符号的定义位置（文件），以及引用位置（文件）。

–ctf-variables && –no-ctf-variables ：
CTF调试信息格式中存在一个特定段，该段包含了程序中那些没有出现在任何符号表中的变量的名称和类型。由于这些变量不能通过传统调试器按地址查找，因此一般情况下用于存储它们类型和名称的空间是浪费的（类型信息小，但名称消息可能比较大）。

–ctf-share-types=method：
该选项用来调整CTF在不同翻译单元（不同源文件）之间共享类型的方法，method取值有：

CTF（Compact Type Format）：一种在不同翻译单元之间共享类型信息的格式。

–no-define-common：
该选项用于控制链接器如何处理公共符号。默认情况下，连接器会为公共符号（通常是由多个不同的文件共享的未初始化全局变量）分配地址。当使用该选项后，链接器不会为公共符号分配地址。

例如：
在 file1.c 中，声明了一个未初始化的全局变量：int myGlobalVar;
在 file2.c 中，也声明了同样的全局变量：int myGlobalVar;
在这种情况下，myGlobalVar 就是一个公共符号。因为它在两个不同的源文件中被声明，但没有在任何地方被明确地初始化。当这个两个文件被编译为对象文件后，链接器在链接它们时，会将两个声明合并为一个单一的全局变量，这样myGlobalVar 在程序任何地方都指向相同的内存地址。
如果使用了–no-define-common 选项，则链接器不会为 myGlobalVar 分配地址，这种情况下如果myGlobalVar 被定义在一个共享库中，它的地址将在运行时由动态链接器分配。（如果使用了该选项，但共享库中也没有定义myGlobalVar，那么链接器可能会发出警告或错误，因为找不到定义。不过也存在一些机制可以处理符号未定义的情况，如弱符号或符号别名）

–force-group-allocation：
该选项用于控制链接器如何处理段组（section groups）。段组是一组相关的段，在链接脚本中以组的形式定义，以便它们可以作为一个整体进行管理。
默认情况下，在最终链接（final link）过程中，链接器会将段组成员放置在输出文件中，就像普通的输入段一样，并且删除段组的定义。这意味着段组成员将被视为独立的节，并且在输出文件中没有特别的组结构。
但是，当进行可重定位链接（relocatable link，通常与 -r 选项一起使用）时，段组的默认行为可能会有所不同。使用 –force-group-allocation 选项可以确保即使在可重定位链接中，段组成员也会被当作普通输入节来处理，并且删除段组的定义。好处：

–defsym=symbol=expression ：
该选项用于在输出文件中创建一个全局符号，其值为表达式结果。链接器会按照 --defsym 和 -T 选项的顺序进行处理，例如：

1

ld --defsym=start=0x8000 --defsym=size=0x1000 -T script.ld

在处理链接脚本之前，定义了两个符号 start （值为0x8000）和 size (值为0x1000)，这些符号可以在链接脚本中使用。

–demangle[=style] && –no-demangle ：
该选项用于控制链接器是否在错误消息和其他输出中对符号名称进行解码（demangle），这里的解码，即将编译器生成的修饰过的的符号名称（mangled name， 例如C++编译器会对用户函数名添加额外的参数、返回值等信息来构成最终的函数符号）转换为易读形式。 连接器默认会进行解码。
调试程序时，有时可能需要看到真实使用的符号名称，此时可以使用 --no-demangle 选项。

–dynamic-linker=file：
该选项用于设置动态链接，该选项只在生成动态链接的ELF可执行文件时才有意义。
默认的动态链接器一般正确的，除非明确需要使用特定的动态链接器，一般不应该使用该选项。

–no-dynamic-linker :
该选项只对包含动态重定位的ELF可执行文件有意义。使用该选项，链接器不会在生成的ELF文件中添加用于请求动态链接器的信息。这意味着，生成的可执行文件在加载时不会请求动态链接器来处理动态重定位。（除非有其它适当的机制来处理重定位或可执行文件本身是一个完全静态链接的可执行文件，否则不应该使用该选项）

–disable-multiple-abs-defs：
该选项用于确保在链接过程中，每个符号只有一个唯一的定义。

–fatal-warnings && –no-fatal-warnings :
用于控制是否将所有链接警告当做错误处理。

-w && –no-warnings：
该选项用于告诉链接器不显示任何警告或错误信息。如果已经启用了 --fatal-warnings ，这个选项会覆盖它。如果明确知道输出文件存在问题，但需要生成该输出文件进行分析时，可以使用该选项。

–force-exe-suffix :
该选项用于确保输出文件有.exe后缀。
该选项一般用于在使用unix makefiles 在windows上运行时。

–gc-sections && –no-gc-sections :
该选项用于控制链接器，对于未使用的输入段段，是否从最终输出的二进制文件中移除。
如果开启了未使用段的垃圾回收，一般情况下，链接器能自动识别和保留必要的段，但在复杂项目中，可能需要开发者提供额外的指示来确保所有必要的代码和数据被正确处理。

–print-gc-sections && –no-print-gc-sections ：
用来控制，是否在标准错误输出上，输出所有被垃圾收集器移除的段。

–gc-keep-exported ：
启用 --gc-sections 选项后，使用该选项，链接器不会将那些具有默认或受保护可见性的全局符号所在的段移除（即使它们当前没有被直接引用）。
默认可见性：可被任意模块访问的全局符号。
受保护可见性：允许符号在其自己的模块及派生的模块中被访问，但不允许其它模块访问。

–print-output-format ：
该选项用于打印输出文件的格式名称。

–print-memory-usage ：
使用该选项，会在标准输出上打印一个内存使用报告，输出由MEMORY命令创建的内存区域的已用大小、总大小和已用百分比。

–target-help ：
使用该选项，会在标准输出上打印特定于目标的选项摘要。例如：
arm-linux-gnueabi-gcc --target-help
执行此命令后，编译器会列出所有适用于 ARM 目标的特定编译选项，例如针对 ARM 处理器的优化选项、指令集选择等。

-Map=mapfile ：
使用该选项，链接器会创建一个链接映射文件 mapfile ，该文件中包含了程序如何被链接的详细信息。

–no-keep-memory ：
使用该选项，告诉连链接器在运行过程中优化运行内存的使用，而不是速度。通常情况下，链接器会将输入文件的符号表缓存到内存中，以加快链接速度。对于大型项目如果在链接时遇到内存不足的问题，可以使用这个选项，使得链接器在有限内存资源下完成链接工作。

–no-undefined && -z defs :
正常创建可执行文件时，如果存在对无法解析符号的引用，链接过程会进行报错。
使用该选项，用于进一步确保链接器，对于引用无法解析符号的情况，会报告错误。因为创建共享库时，如果存在对无法解析符号的引用，可能默认情况下链接器不会报错（预期这些符号将在运行时由其它共享库或主程序进行解析）。使用该选项，可以确保在创建共享库时，所有符号都已解析。

–allow-multiple-definition && -z muldefs ：
通常情况下，如果一个符号被定义了多次，链接器会进行报错。
该选项允许一个符号存在多个定义，并且会使用第一个定义。除非确定不会引起问题，否则不应该使用该选项。

-allow-shlib-undefined && –no-allow-shlib-undefined :
该选项用于控制在共享库中是否允许存在未定义的符号。

–error-handling-script=scriptname ：
该选项项允许指定一个脚本，该脚本会在链接器遇到错误时被调用。目前，这个选项支持两种错误类型：缺失的符号和缺失的库。当这些错误发生时，链接器会传递两个参数给脚本：关键词 “undefined-symbol” 或 “missing-lib” 以及未定义符号或缺失库的名称。

–no-undefined-version :
该选项用于确保所有符号都有一个定义的版本信息。
例如，一个共享库，对外的API，可以通过指定版本信息来实现迭代目的。当链接这个共享库时，就可以通过指定版本来实现不同版本功能的控制。

-default-symver ：
该选项用于为那些未指定版本的 导出符号 创建并使用一个默认的符号版本，这个默认版本通常是由库的soname决定的。这样可以在不改变源代码的情况下，为库提供一定程度的符号版本控制。

–default-imported-symver ：
该选项的作用是为那些未指定版本的 导入符号 （imported symbols）创建并使用一个默认的符号版本，这个默认版本通常是共享对象的 soname。

–no-warn-mismatch :
该选项是告诉链接器在遇到可能不匹配的输入文件时不要发出错误信息。通常情况下，如果尝试将为不同处理器编译的文件或具有不同字节顺序（endianness）的文件链接在一起，链接器会报错。使用这个选项后，链接器会忽略这些潜在的错误，并继续执行链接过程。

这个选项应该谨慎使用，只有在已经采取了某些特殊措施，确保链接器的错误信息可以忽略的情况下才能使用。例如，虽然某些文件报告为不匹配，但实际上是兼容的，或者有其他机制来处理这些不匹配的问题。

–no-warn-search-mismatch :
链接器进行库搜索时，如果发现一个不兼容的库，通常链接器会给出一个警告。该选项的作用是关闭这个警告。

–no-whole-archive ：
链接选项 --no-whole-archive 用于关闭之前通过 --whole-archive 选项启用的效果。
--whole-archive 选项会告诉链接器将后续归档文件（通常是静态库文件，如 .a 文件）中的所有符号都加载到链接的目标文件中。这通常用于确保静态库中未被直接引用的对象也被包含在最终的可执行文件或共享库中。

–noinhibit-exec ：
该选项的作用是即使在链接过程中出现错误，只要最终的可执行文件仍然可用，链接器也会保留它。通常情况下，如果链接器在链接过程中遇到任何错误，它都不会生成输出文件，而是直接退出。但是，当使用了 –noinhibit-exec 选项后，即使出现非致命的链接错误，链接器仍然会生成并保留输出文件
应该谨慎使用该选项，因为它可能会导致生成的可执行文件包含未解决的错误，这在生产环境中可能会引起更大的问题。

-nostdlib :
该选项让链接器不要默认链接标准库，仅在链接命令行上显示指定的库目录中搜索库（链接脚本中指定的库搜索目录也被忽略）。

–oformat=output-format ：
该选项用于指定输出目标文件的二进制格式。
通常情况下，不需要手动指定 --oformat ，因为连接器 ld 应该已经根据机器的默认配置选择了最常用的目标文件格式作为输出格式。
output-format 是一个文本字符串，它是由 BFD（Binary File Descriptor）库支持的特定格式的名称。你可以使用 objdump -i 命令列出所有可用的二进制格式。
此外，如果在连接器脚本中使用了 OUTPUT_FORMAT 命令来指定输出格式，那么 –oformat 选项会覆盖这个设置。

--out-implib file :
使用该选项，链接器在生成可执行文件（例如 DLL 或 ELF 程序）的同时会生成对应的导入库（import library）
导入库：

-pie && –pic-executable ：
该选项用于创建位置无关的可执行文件（Position Independent Executable）。
位置无关可执行文件是一种特殊的可执行文件，它在运行时由操作系统加载，并且可以在内存中的任何位置执行。这与普通的可执行文件不同，后者在加载时会被放置到固定的内存地址上。该选项只在ELF 平台上支持。

-no-pie ：
该选项用于生成位置相关的可执行文件（Position Dependent Executable）。该选项是链接器的默认行为。

–relax && –no-relax ：
该选项用于开启/关闭链接器执行执行与目标平台相关的全局优化。例如：

注意：全局优化可能会导致一些调试信息丢失，因为优化后的代码可能与源代码之间的映射不再一一对应。因此，在需要进行符号调试的情况下，我们需要权衡是否启用全局优化。

–retain-symbols-file=filename ：
该选项用于保留指定文件中列出的符号，而丢弃其他所有符号。
注意，该功能会影响调试器（无法找到符号，导致不能显示相关信息）。

-rpath=dir ：
该选项用于将目录添加到运行时库搜索路径中，确保程序在运行时能够正确找到所需的共享库。
所有 -rpath 参数都会被连接起来，并传递给运行时链接器，它会在运行时使用这些路径来定位共享对象。如果在链接 ELF 可执行文件时未使用 -rpath，则会使用环境变量 LD_RUN_PATH 的内容（如果已定义）。

-rpath-link=dir ：
该选项用于在链接时指定运行时库搜索路径，与 -rpath 类似，但仅在链接时有效，不影响运行时。

该选项可以用于解决共享库之间的依赖关系。当一个共享库引用另一个共享库时，链接器会使用 -rpath-link 指定的路径来查找所需的共享库。这样，即使在编译和链接阶段，共享库之间的依赖关系也能够得到正确解析。
例如，我们需要使用两个共享库libA.so 和 libB.so，libA.so 中的某个函数需要调用 libB.so 中的函数。在编译和链接阶段，我们可以使用 -rpath-link 选项来指定 libB.so 的搜索路径，以确保在运行时能够正确加载它。

-shared && -Bshareable ：
该选项用于告诉链接器，创建共享库（动态链接库）而不是可执行文件。

–sort-common && –sort-common=ascending && –sort-common=descending ：
该选项用于控制公共符号（common symbols）的排序方式。公共符号是在多个目标文件中定义的、但没有被初始化的全局变量或函数。排序是为了避免由于对齐约束而导致符号之间出现间隙。

–sort-section=name ：
使用该选项，会在链接脚本中的所有通配符段（wildcard section）模式上应用 SORT_BY_NAME 排序（按照段的名称进行排序）。排序后，链接器会按照段名称的字母顺序将相应的目标文件段放置在输出文件中。
例如，如果链接脚本中有以下通配符段模式：
*(.text)
*(.data)
*(.bss)
使用该选项后，链接器会按照 .bss、.data、.text 的顺序将相应的段放置在输出文件中。

–sort-section=alignment ：
使用该选项，会在链接脚本中的所有通配符段（wildcard section）模式上应用 SORT_BY_ALIGNMENT 排序（按照段的对齐方式进行排序）。

–spare-dynamic-tags=count ：
用于指定在 ELF 共享对象的 .dynamic 段中保留多少个空槽位（empty slots）。这些空槽位可能会被后处理工具使用。例如，prelinker 可能需要在 .dynamic 段中添加一些标记。

.dynamic 段是 ELF 文件中的一个段，它包含了动态链接器（如 ld.so）在运行时所需的信息，这些信息包括共享库的依赖关系、符号表、重定位表等。

**–split-by-file[=size]**：
该选项告诉链接器在链接过程中为每个输入文件创建一个新的输出段。size 是一个可选参数，用于指定输出段的大小，如果指定了 size，那么当输出段的大小达到或超过指定的大小时，链接器会创建一个新的输出段。

–split-by-reloc[=count]
该选项用于在输出文件中创建额外的段（sections），以确保单个输出段不包含超过 count 个重定位项（relocations）

–stats ：
该选项用于计算并显示链接器操作的统计信息，例如连接器执行时间和内存使用情况。

–sysroot=directory
该选项用于设置目标平台根目录，它会影响编译和链接过程中查找头文件和链接库的位置。
默认情况下，编译器会在 /usr/include 目录中搜索头文件，以及在 /usr/lib 目录中搜索依赖库,当设置了 --sysroot=dir 后，编译器会从 dir/usr/include 搜索头文件，从 dir/usr/lib 搜索依赖库。

–traditional-format
该选项用于请求链接器使用传统的输出格式，而不是默认的格式。
例如，在 SunOS 上，ld 会合并符号字符串表中的重复条目。这可以将完整调试信息的输出文件大小减少超过 30%，但这也会导致SunOS 的 dbx 程序无法读取生成的程序（但 gdb 没有问题）。使用 --traditional-format 选项可以告诉链接器不要合并重复的条目，以便保留这些重复的信息。

–section-start=sectionname=org
该选项用于在输出文件中定位一个段（section），并指定其绝对地址为 org 指定的值。你可以在命令行中使用此选项多次，以定位多个段。
例如：
ld --section-start=mysection=0x12345678 -o my_output_file my_object_files.o
使用此命令后，链接器将确保 mysection 段位于输出文件中的地址 0x12345678 处。

-Tbss=org && -Tdata=org && -Ttext=org :
与选项 --section-start 的作用一样，sectionname被限定为.bss、.data、.text。

-Ttext-segment=org :
该选项用于指定 ELF 可执行文件中 .text 段的起始地址。
.text 段是用于存放程序的机器代码的区域，通常是程序的入口点。org 是一个地址值，表示 .text 段的起始地址。
该选项和 -Ttext=org 的作用一样。

-Trodata-segment=org ：
该选项用于指定只读数据（read-only data）所在的段的起始地址

-Tldata-segment=org :
该选项用于指定 x86-64 中型内存模型（medium memory model）下的 ELF 可执行文件或共享对象中 ldata 段的起始地址。ldata 段通常用于存放局部变量和临时数据。

–unresolved-symbols=method ：
该选项用于指定处理未解析符号（unresolved symbols）的方式：

通常链接器会为每个报告的未解析符号生成错误消息，但选项 –warn-unresolved-symbols 可以将其更改为警告。

–dll-verbose && –verbose[=NUMBER] :
这两个选项可以显示链接器的版本号，并列出支持的链接器仿真（linker emulations）。它还会显示哪些输入文件可以打开，哪些不能，以及链接器正在使用的链接脚本。

–version-script=version-scriptfile :
该选项用于指定版本脚本（version script）的名称。在创建共享库时，版本脚本用于指定关于正在创建的库的版本层次结构的附加信息。有利于共享库的版本控制。

-warn-common：
使用该选项，链接器会对common符号合并动作可能存在的问题，发出警告。

以 C 为例，三种全局符号如：

–warn-common 选项可以产生五种警告。每个警告由一对行组成：第一行描述刚刚遇到的符号，第二行描述具有相同名称的先前符号。这两个符号中的一个或两个将是 common 符号。

将 common 符号转换为引用，因为已经存在该符号的定义。

1
2
3

file(section): warning: common of `symbol'
   overridden by definition
file(section): warning: defined here

将 common 符号转换为引用，因为后面遇到了该符号的定义。这与前一种情况相同，只是符号的顺序不同。

1
2
3

file(section): warning: definition of `symbol'
   overriding common
file(section): warning: common is here

将 common 符号与先前相同大小的 common 符号合并。

1
2
3

file(section): warning: multiple common
   of `symbol'
file(section): warning: previous common is here

将 common 符号与先前较大的 common 符号合并。

1
2
3

file(section): warning: common of `symbol'
   overridden by larger common
file(section): warning: larger common is here

将 common 符号与先前较小的 common 符号合并。这与前一种情况相同，只是符号的顺序不同。

1
2
3

file(section): warning: common of `symbol'
   overriding smaller common
file(section): warning: smaller common is here

–warn-execstack
–warn-execstack-objects
–no-warn-execstack
在 ELF 平台上，当链接器被要求创建一个包含可执行堆栈的输出文件时，可能会生成警告消息。

备注：可执行堆栈是指程序运行时的堆栈区域，用于存储函数调用和局部变量。如果一个程序的堆栈区域被标记为可执行，那么它可以执行代码，这可能会导致安全风险。例如，缓冲区溢出漏洞可能导致恶意代码覆盖堆栈上的返回地址，从而控制程序的执行流程。

–error-execstack && –no-error-execstack：

–warn-multiple-gp ：
该选项用于在输出文件中警告是否需要多个全局指针值。
这仅对某些处理器（例如 Alpha 处理器）有意义。具体而言，某些处理器将大值常量放在一个特殊的节（section）中。一个特殊的寄存器（全局指针）指向该节的中间位置，以便通过基址寄存器相对寻址模式高效地加载常量。由于基址寄存器相对模式中的偏移量是固定且相对较小的（例如 16 位），这限制了常量池的最大大小。因此，在大型程序中，通常需要使用多个全局指针值，以便能够寻址所有可能的常量。使用该选项在在出现此情况时发出警告。

–warn-once ：
使用该选项，链接器在每个未定义的符号（undefined symbol）上只发出一次警告，而不是每个引用该符号的模块都发出一次。
例如，如果代码中有多个模块引用了同一个未定义的符号，使用该选项后，只会在第一次引用时发出警告，可以避免刷屏（频繁重复的警告消息）。

–warn-rwx-segments && –no-warn-rwx-segments ：
这两个选项用于控制在创建可加载的、非零大小的段时，是否发出警告。

这种段造成的潜在安全漏洞：例如，如果这样的段被用作缓冲区，且存在缓冲区溢出漏洞，攻击者可以通过向缓冲区写入超出其分配大小的数据来覆盖相邻内存区域。这可能导致程序崩溃、数据泄漏或执行恶意代码。

–warn-section-align :
使用该选项后，如果输出段的地址因为边界对齐而发生变化，则链接器发出警告。

–warn-textrel ：
使用该选项，当创建一个位置无关的可执行文件或共享对象时，如果链接器添加了 DT_TEXTREL ，则发出警告。
DT_TEXTREL 是一个动态链接器标记，表示某个段（通常是代码段）的重定位表中包含了对代码段的重定位。这可能会导致潜在的安全问题，因为它允许在运行时修改代码段，这可能被恶意代码利用。

在链接过程中，重定位表（relocation table）记录了需要在程序加载到内存后进行修正的地址。这些修正通常涉及到符号的地址，例如函数、变量或其他标识符的地址。对于代码段（通常是 .text 段），重定位表中的条目指示了需要在运行时修改的地址。（如果重定位表中存在对代码段的修正，那么在运行时，这些修正可能会导致代码被修改。这可能被恶意代码利用，例如插入恶意指令或破坏原始代码的完整性。）

–warn-alternate-em :
使用该选项后，如果目标文件中存在多个版本的ELF机器码，链接器会发出警告。（多个版本的机器码，可能是由于不同编译器、优化选项等因素导致的）

–warn-unresolved-symbols：
设置改选项后，如果存在未解析的符号（unresolved symbol），则将生成警告而不是错误。

–error-unresolved-symbols：
使用该选项后，在链接过程中，如果存在未解析的符号（unresolved symbol），则将生成错误而不是警告。

–whole-archive ：
使用该选项后，链接器会将指定的归档文件中的每个目标文件都包含在最终的可执行文件或共享库中，而不仅仅是搜索归档文件以获取所需的目标文件。
使用GCC时，GCC会在链接中添加自己的归档文件列表。因此，在列出归档文件后，应该使用 -Wl,-no-whole-archive， 避免–whole-archive选项影响到GCC添加的归档文件。

–wrap=symbol ：
使用该选项，链接器会为指定的符号创建一个包装函数。例如：

1
2
3
4
5
6

void *
__wrap_malloc (size_t c)
{
  printf ("malloc called with %zu\n", c);
  return __real_malloc (c);
}

如果在链接选项中指定了：–wrap=malloc ，那么所有对 malloc 的调用都将调用 __wrap_malloc 函数。在 __wrap_malloc 中对 __real_malloc 的调用将实际调用真正的 malloc 函数。

–eh-frame-hdr：
使用此选项时，会创建一个名为.eh_frame_hdr的特殊段，该段包含了一种压缩过的异常处理框架信息，用于加速异常处理的查找。

–no-eh-frame-hdr：
使用此选项时，不会创建.eh_frame_hdr段。

–no-ld-generated-unwind-info：
使用此选项时，会请求创建.eh_frame段的异常展开信息（unwind info）。默认情况下，如果链接器支持生成展开信息，这个选项会被打开。
总之，.eh_frame段用于处理异常和堆栈展开，而–no-ld-generated-unwind-info选项影响是否生成这些信息

–enable-new-dtags && –enable-new-dtags：

这两个选项可以用来控制 ELF 文件中动态标签的生成方式，以适应不同的系统需求。
在 ELF 文件中，动态标签是指用于描述共享库、符号表、重定位信息和其他运行时特性的标签。这些标签存储在 ELF 文件的动态段中，通常是 .dynamic 段。这些标签允许操作系统和运行时环境在加载可执行文件或共享库时进行必要的初始化和配置。
在 ELF 文件中，新/旧动态标签指的是不同版本之间对动态标签的修改或更新。具体来说：

–hash-size=number :
该选项用于将链接器哈希表的默认大小设置为接近number的素数。
增加此值可以减少链接器执行任务所需的时间，但会增加内存需求。减小此值可以降低内存需求，但会牺牲一些速度。

–hash-style=style
该选项用于设置链接器的哈希表（hash tables）的类型。哈希表用于加速符号查找和重定位等链接器任务。
style 可以是以下三种配置之一：

默认情况下，取决于链接器的配置，对于大多数基于 Linux 的系统，默认值是 both。

–compress-debug-sections=none
–compress-debug-sections=zlib
–compress-debug-sections=zlib-gnu
–compress-debug-sections=zlib-gabi
–compress-debug-sections=zstd
这几个选项用于控制是否对调试进行压缩，以及选择压缩算法。
压缩调试段可以显著减少ELF文件的大小，但是压缩调试信息会增加链接过程的时间，因为链接器需要额外的时间来压缩数据。并且在调试过程中，调试器需要解压缩调试信息。

–reduce-memory-overheads ：
使用该选项，链接器运行时会使用更少的内存，但是链接速度会降低。（如果编译时出现内存不够问题时可以使用）

–max-cache-size=size ：
该选项用于设置链接器在内存中缓存输入文件的重定位信息和符号表的最大大小。默认情况下，链接器会无限制地缓存这些信息，这有助于加快链接过程，因为可以快速访问这些数据。
使用该选项，可以指定一个最大的缓存大小（即size），这样在内存受限的系统上进行链接操作时，可以防止链接器使用过多内存而导致系统变慢或崩溃。

–build-id && –build-id=style ：
该链接选项用于在ELF或COFF格式的输出文件中创建一个包含唯一标识符的节。这个标识符用于唯一地识别链接后的文件

–package-metadata=JSON ：
该选项用于在ELF格式的输出文件中创建一个名为 .note.package 的节。这个节的内容是按照包元数据规范以JSON格式编写的。这允许将JSON中包含的元数据直接嵌入到ELF文件中，以便于分发和部署时的识别和验证。