和loadAndInit子程序

用途

将模块装入到当前过程中。

语法

int *load ( ModuleName, Flags, LibraryPath)
char *ModuleName;
uint Flags;
char *LibraryPath;

int *loadAndInit ( ModuleName, Flags, LibraryPath)
char *ModuleName;
uint Flags;
char *LibraryPath;

描述

load 和 loadAndInit 子例程将指定的模块装入到调用进程的地址空间中。 模块可以是常规文件，也可以是归档的成员。 将新模块添加到 32 位进程的地址空间时，装入操作可能会导致中断值发生更改。

负载 子例程不是用于装入 C++ 模块的首选方法。 改用loadAndInit子程序。 loadAndInit子程序使用与load相同的接口，但执行 C++ 初始化。

执行 子例程类似于 负载 子例程，但以下情况除外:

• 负载 子例程不会将当前程序替换为新的程序。
• exec 子例程没有显式库路径参数; 它只有 LIBPATH 和 LD_LIBRARY_PATH 环境变量。 此外，当使用 执行 子例程的程序具有比调用者更多的特权 (例如，在使用 set-UID 程序的情况下) 时，将忽略这些库路径环境变量。

可以通过两种方式中的一种将大型应用程序拆分为一个或多个模块，以允许在同一进程中执行。 第一种方法是单独创建每个应用程序的模块，并在需要时使用 负载 来显式装入模块。 另一种方法是在通过定义导入和导出的符号创建模块时指定这些模块之间的关系。

模块可以从其他模块导入符号。 每当从一个或多个其他模块导入符号时，如果尚未装入必需的模块，并且未将导入的符号指定为延迟导入，那么将自动装入这些模块以解析符号引用。 这些模块可以是库或个别文件中的归档成员，并且可以具有共享或专用文件特征，以控制装入这些模块的方式和位置。

当共享模块 (通常是共享库归档的成员) 的访问许可权允许共享时，即当它们具有其他读许可权时，会将这些模块装入到共享库区域。 专用模块以及不具有共享所需许可权的共享模块将装入到流程专用区域中。

当装入器解析符号时，它使用与该符号一起记录的文件名来查找导出该符号的模块。 如果文件名包含任何 / (斜杠) 字符，那么将直接使用它，并且必须指定相应的文件或归档成员。 但是，如果文件名是基本名称 (不包含 / 个字符) ，那么装入器将在缺省库路径中指定的目录中搜索具有该基本名称的文件 (即，模块或归档)。

LibraryPath 是一个字符串，其中包含一个或多个以冒号分隔的目录路径名。 有关库路径搜索的信息，请参阅 正在搜索从属模块 部分。

当进程在 跟踪 控制下执行时，在 负载 处理完成后将重新复制该进程的部分地址空间。 对于 32 位进程，将重新复制主程序文本 1 在第 1 段中装入) 和共享库模块 (在第 13 段中装入)。 对这些段的任何断点或其他修改都必须在 负载 调用后重新插入。 对于 64 位进程，在执行 负载 调用后，将重新复制共享库模块。 将通过将 _SLWTED 标志设置为 等所返回的状态来通知调试器，以便它可以重新插入断点。

当在 跟踪 控制下执行的进程调用 负载时，将通过在 等返回的状态中设置 _SLWTED 标志来通知调试器。 新装入到共享库段中的任何模块都将复制到进程的这些段的专用副本中，以便调试器可以检查或修改这些模块。

负载 子例程将调用新模块及其任何从属项的初始化例程 (初始化 例程) (如果尚未装入这些例程)。

当进程终止或执行 执行 子例程时，此子例程装入的模块将自动卸装。 通过调用 卸载 子例程显式卸装它们。

正在搜索从属模块

装入操作和 exec 操作在其从属模块搜索机制方面略有不同。 在将模块添加到正在运行的进程 (装入操作) 的地址空间时，将使用下一节中概述的规则来查找指定的模块。 请注意，依赖关系可能松散定义为树，但模块之间也可能存在递归关系。 以下组件可能用于创建完整的库搜索路径:

1. 如果设置了 L_LIBPATH_EXEC 标志，那么将显示在执行时使用的库搜索路径。
2. LibraryPath 参数的值 (如果非空)。 请注意，空字符串是指引用当前工作目录的有效搜索路径。 如果 LibraryPath 参数为 NULL ，那么将改为使用 LIBPATH 环境变量的值，或者使用 LD_LIBRARY_PATH 环境变量 (如果未设置 LIBPATH )。
3. 要装入的模块的装入程序部分中包含的库搜索路径 ( ModuleName 参数)。
4. 包含在正在装入其直接从属项的模块的装入程序部分中的库搜索路径。 请注意，在搜索每个模块的直接从属项时，每个模块的信息都会更改。

要查找 ModuleName 模块，请使用组件 1 和 2。 要查找从属项，将按顺序使用组件 1 2 3 和 4。 请注意，如果已属于正在运行的过程的任何模块满足新装入的模块的依赖关系需求，那么不会再次装入预先存在的模块。

对于聚集搜索规范的每个冒号分隔部分，如果找不到基本名称，那么将继续执行搜索。 此外，如果需要的文件不是归档成员，那么搜索将继续经过具有错误对象方式的文件。 如果需要归档成员，那么在找到文件名的第一个匹配项时搜索将停止。 如果文件的格式不正确，或者如果归档不包含必需的归档成员，或者未导出必需符号的定义，那么将发生错误。 如果对从属模块指定了相对路径名或绝对路径名，那么不会执行库路径搜索。

模块中存储的库搜索路径是在链接编辑时指定的。

如果指定的模块具有非常长的依赖关系链 (例如， lib1.a，依赖于 lib2.a，依赖于 lib3.a等) ，那么 负载 子例程可能导致调用过程失败。 这是因为装入器在固定大小堆栈上以递归方式处理此类关系。 仅当处理具有一千多个元素的依赖关系链时，才会显示此限制。

参数

返回值

成功完成后， load 和 loadAndInit 子例程将返回指向模块入口点的函数的指针。 如果该模块没有入口点，那么返回该模块的数据部分的地址。

错误代码

如果 load 和 loadAndInit 子例程失败，那么将返回空指针，不装入模块，并设置 errno 全局变量以指示错误。 如果对于要显式装入或自动装入的模块，下列其中一个或多个子例程 load 和 loadAndInit 子例程将失败: