2.14;librarian, revision 2.14, 86/11/04
LBR (LIBRARIAN) -- Combine object modules into a library.
usage: LBR {-C|-UPD} library_pathname [module_pathname] [-DEL module]
[-EX module [-O pathname]] [-L]
[-MSGS|-NMSGS] [-SYS|-NSYS] [-REPL] [-]
FORMAT
LBR {-C | -UPD} library_pathname [module_pathname] [options] [-]
The librarian manages libraries of object modules. It adds, removes, or
replaces modules in the library. As input, you must provide the pathname of a
library you want to create or update, followed by an optional list of object
module pathnames and processing options. As output, the librarian produces a
new or updated library file.
You can use LBR in two ways: by entering complete LBR command strings, or by
using the "-" (hyphen) option to ask the librarian to prompt you for multiple
strings of module_pathname arguments and options. By using prompting you can
perform several operations on object modules in the same library file, without
entering LBR each time.
For a complete description of the librarian, see the DOMAIN Binder and
Librarian Reference.
ARGUMENTS
-C[REATE] | -UPD[ATE] library_pathname
(required) The pathname of the library output file must be specified
on the command line before you can specify any option that
performs an operation on a library (such as adding to,
extracting from, or reporting about a library). The -C
(CREATE) or -UPD (UPDATE) option must be specified with the
library pathname argument to indicate whether you want to
create or update a library. Remember that only one library
output file can be specified per execution of the
librarian.
module_pathname
(optional) Specify an object module to be added into the library.
Multiple pathnames and wildcarding are permitted. If
omitted, no new object modules are added to the library.
OPTIONS
The following options instruct the librarian to perform various tasks. Note
that some options apply directly to a library, while other options act on
modules within the library. Default options are indicated by "(D)".
-DEL module Remove an object module from the library. If a module of
the given name cannot be found in the library, a warning is
issued. Note that the librarian is case-sensitive to the
name 'module'.
-EX module [-O pathname]
Extract the named module from the library. If the pathname
modifier is specified with -O, the module will be copied to
that pathname. Otherwise, the module is copied to a file
having the same name as the module. Note that the
librarian is case-sensitive to the name 'module'.
-L List a directory of the library contents to standard
output. This report shows the name of each module in the
library, with a list of section information and global
declarations and references for each module.
-MSGS (D) Cause LBR to issue purely informational messages such as a
summary of the number of errors and warnings that occurred.
-NMSGS Cause LBR to suppress issuing purely informational
messages.
-NSYS (D) Do not list global variables which are defined in the
system library when generating a listing of global
definitions and references with the -L option.
-REPL pathname
Replace, in the library, any modules found in the file
specified by pathname. This option has an effect
equivalent to first deleting all the modules found in
pathname from the library, and then adding all the modules
in pathname back into the library. The advantage gained by
using -REPL is that you do not need to know the names of
the modules in 'pathname'. Also, if you attempt to add a
module to a library without using the -REPL option, and a
module of that name does already exist, an error message is
issued. If a module found in pathname does not already
exist in the library, a warning message is issued.
-SYS List global variables which are defined in the system
library when generating a listing of global definitions and
references with the -L option.
- (hyphen alone)
Request librarian prompting for further arguments.
This command uses the command line parser, and so also accepts the standard
command options listed in HELP CL.
EXAMPLES
Refer to the DOMAIN Binder and Librarian Reference for detailed examples of
LBR.