OSF

NAME

ldr_install −  Installs a module in the current process’ private known package table

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <loader.h>
int ldr_install(
const char ∗mod_name);

PARAMETERS

mod_namePoints to the name of the module to be installed. 

DESCRIPTION

The ldr_install() function installs a specified module in the current process’ private known package table.  The private known package table is inherited copy-on-write by the process’ children.  This makes the packages exported by the module available for symbol resolution for modules loaded into this process and its children, overriding any module exporting the package in the global known package table. 

RETURN VALUES

Upon successful completion, the ldr_install() function returns 0 (zero).  Otherwise, a negative value is returned and errno is set to indicate the error. 

ERRORS

If the ldr_install() function fails, errno may be set to the following value:

[EEXIST]The module was previously loaded in the known package table of this process. 

[ENOENT]The named file does not exist. 

[EACCES]Search permission is denied, or the file exists and the user does not have read access. 

[ENOEXEC]The file is not in a recognized format. 

[ENOSPC]The process’ private known package table is full and cannot be expanded. 

RELATED INFORMATION

Functions: load(3), ldr_remove(3)