OSF

NAME

lib_admin − administer shared libraries

SYNOPSIS

lib_admin [-i] [-p] [-o global_file] [-v] database

FLAGS

-iDo not install any libraries. This flag overrides the install attribute from the database file. 

-pDo not preload any libraries.  This flag overrides the preload attribute from the database file. 

-o global_fileCreate the loader global data file with the specified output file name rather than with the default file, /var/adm/loader/ldr_global.dat.  Note that the standalone loader (/sbin/loader) only looks for its loader global data file using the default pathname. 

-vRun in verbose mode and print more information about each install or preload operation as it occurs. 

DESCRIPTION

You use the lib_admin program to manage the set of shared libraries available to all applications programs.  lib_admin installs a list of shared libraries into the Global Known Package table, thus making them available to the the program loader in resolving unresolved symbols during program loading.  In addition, lib_admin can optionally preload specified libraries, resulting in faster startup of programs using those libraries. 

The lib_admin command normally runs from /etc/init during system initialization to install and preload the shared libraries needed by the other commands.  You can, however, run the lib_admin command at any time to change the set of libraries that are installed or preloaded on the system. 

The lib_admin command creates an output file, the loader global data file, which contains the Global Known Package table and the cache of preloaded library information.  By default, this file is named /var/adm/loader/ldr_global.dat.  The standalone loader (/sbin/loader) maps the loader global data file to obtain access to the Global Known Package table and preload cache. 

A database file drives the actions of the lib_admin command. This file lists all of the shared libraries and the default installation options for each library.  The database file is in “attributes file” format and consists of a series of entries, one per shared library.  The database file can also be in stanza file format. Entries are separated by one or more blank lines.  Each entry has the following format:

library_name
         attribute=value
         attribute=value

where library_name is specified as an absolute pathname; that is, a pathname beginning with ’/’.  A colon (:) marks the end of the library_name specification.  Note that the attribute lines begin with a tab and the file ends with a blank line. 

The following attribute=value specifications are valid:

       •The install attribute takes either a true or false value, specifying whether or not the library is to be installed. 

       •The preload attribute takes either a true or false value, specifying whether or not the library is to be preloaded. 

For example, an entry in database for a library named /usr/shlib/libthis.so could look like this:

/usr/shlib/libthis.so:
        install=true
        preload=false

FILES

/sbin/lib_admin
Specifies the command path

/var/adm/loader/ldr_global.dat
The default loader global data file

/var/adm/loader/ldrXXXXXXXX.X
Binary data files containing the regions of preloaded libraries

RELATED INFORMATION

Commands:  init(8)

Functions:  ldr_install(2), ldr_remove(2), load(2), exec(2), exec_with_loader(2)

Files:  stanza(4)

DEC OSF/1 Programmer’s Guide