LIB56000

Section: User Commands (1)
Updated: 1 June 1987
Index Return to Main Contents

NAME

lib56000 - Motorola DSP56000 Librarian

SYNOPSIS

lib56000 [ -a | -c | -d | -l | -r | -u | -x ] library [files...]

DESCRIPTION

lib56000 is a utility that allows separate files to be grouped together into a single file. The resulting library file can then be used for linking by the DSP56000 Cross Linker program or for general-purpose archival storage.

library is an operating system compatible filename (including optional pathname) indicating the library file to create or access. If no extension is supplied, the librarian will automatically append .lib to the filename. If no pathname is specified, the librarian will look for the library in the current directory. files is a list of operating system compatible filenames separated by blanks. For input operations the filenames may also contain an optional pathname; the path is stripped when the file is written to the library. For output operations only the filename should be used to refer to library modules.

OPTIONS

Only one of the following command line options may be given for each invocation of the librarian. Option letters may be entered in either upper or lower case. If no option is given, the librarian operates as if the -U option were specified.

-a: This option adds the modules in the file list to the named library. The library file must exist, and the modules must not already be in the library.
-c: Create a new library file and add any specified modules to it. If the library file already exists, an error is issued.
-d: Delete named modules from the library. If the module is not in the library, an error is issued.
-l: List library contents. This option lists the module name as contained in the library header, the module size (minus library overhead), and the date and time the file was stored into the library. The listing output is routed to standard output so that it may be redirected to a file if desired.
-r: This option replaces the named modules in the given library. The modules must already be present in the library file.
-u: This option updates the specified modules if they exist in the library; otherwise it adds them to the end of the library file.
-x: Extract named modules from the library. The resulting files are given the name of the modules as stored in the library module header. All files are created in the current working directory.