2.00;librarian, revision 2.00, 84/04/09
LBR (LIBRARIAN) -- Combine object modules into a library.
usage: LBR {-C | -UPD} library_pathname [module_pathname] [-DEL] [-EX] [-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.
ARGUMENTS
-C | -UPD 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)".
-C library_pathname
Create a new library file. An error message is issued if
the named file already exists. You must specify the name
of an output library file with either the -C[REATE] or
-UPD[ATE] option before issuing any other option which
requires some operation on a library (such as adding a
module to a library, extracting a module from a library, or
generating a report about a library).
-DEL module_pathname
Remove an object module from the library. If a module of
the given name cannot be found in the library, a warning is
issued.
-EX module_pathname [-O [pathname] ]
Extract the named module from the library. If the pathname
modifier is given, the module will be copied to that
pathname. Otherwise, the module is copied to a file having
the same name as the 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 Generate and issue messages for warning-level errors. For
example, if you specify -REPL for a file, and one of the
modules found in the specified file does not already exist,
the librarian generates a warning that the module does not
already exist, but was added anyway.
-NMSGS Do not generate messages for warning-level errors. For
example, if you specify -REPL for a file, and one of the
modules found in the specified file does not already exist,
the librarian generates a warning that the module does not
already exist, but was added anyway.
-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.
-UPD library_pathname
Update an existing library file. An error message is
issued if the named file does not already exist. You must
specify the name of an output library file with either the
-C[REATE] or -UPD[ATE] option before any other option is
given which requires some operation on a library (such as
adding a module to a library, extracting a module from a
library, or generating a report about a library).
- (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 System Command Reference Manual for detailed examples of
LBR.