NAME

ada.lmgr − create, examine, and modify an Ada library

SYNOPSIS

ada.lmgr [ -I | -P | familyname ]

Remarks:

This command requires installation of optional Ada software (not included with the standard HP-UX operating system) before it can be used. 

DESCRIPTION

Ada.lmgr, the Ada library manager, can be used to create, examine, and modify the contents of an Ada library. 

Units in a library within a particular family can be dependent on units in another library in the same family and a program can be composed (bound) using units from any number of libraries in a given family. 

Libraries that are members of different families are normally invisible to each other and cannot access each other’s units.  There is one exception to this rule:  libraries belonging to the INSTALLATION family (a family provided with the Ada compilation system) are accessible to libraries in any other family. 

Only one of the options -I, -P, or familyname may be specified.  If no family is specified, the PUBLIC family is assumed. 

The following options are recognized:

−I Manipulate libraries in the installation family. 

−P Manipulate libraries in the public family. 

Ada.lmgr is an interactive tool that, when executed, prompts with "Library_Manager." Commands are then entered to examine or modify the contents of a library. 

For the syntax and semantics of the commands, refer to the "Ada User’s Guide," or use the available online help facility in the library manager. 

The following commands can be typed in response to the "Library_Manager" prompt:

Default Set default values for commands. 

Erase Remove an Ada library. 

Global Set global characteristics for commands. 

Help Obtain help on the various ada.lmgr commands. 

Invoke Read ada.lmgr commands from a file. 

List List the Ada libraries in an Ada family. 

New Create a new Ada library. 

Other Change the current family. 

Protect Mark the current library as either read-only or update-allowed. 

Quit Leave ada.lmgr. 

Rename Rename an Ada library. 

System Execute a shell command. 

Unlock Unlock a locked Ada library. 

View Display information about the current family. 

The help command provides online help for all commands. 

If the file .ada.lmgrrc exists in the user’s home directory, its commands are executed before the first prompt is issued. 

If the file .ada.lmgrdf exists in the user’s home directory, its commands are executed after those in .ada.lmgrrc (if present) and before the first prompt is issued.  The commands in this file are DEFAULT commands saved automatically by the use of the DEFAULTS => KEEP parameter of the QUIT command. 

Environment Variables

The environment variable ADA_PATH is associated with all components of the Ada compilation system.  It must be set properly and exported before any component of the Ada compilation system (including ada.lmgr) can be used (see ada(1), Environment Variables). 

Locks

To ensure the integrity of their internal data structures, Ada libraries and families are locked for the duration of operations that are performed on them.  Normally Ada families are locked only briefly when libraries within them are manipulated.  However, sometimes multiple Ada libraries must be locked for longer periods during a single operation.  If more than one library must be locked for a single operation, at most one library is locked for updating and all other locked libraries are locked for read-only. 

An Ada family or library locked for updating cannot be accessed in any way by any part of the Ada compilation system except by the locking agent.  However, an Ada family or library locked for reading can be accessed by any part of the Ada compilation system for read-only purposes. 

If ada.lmgr cannot obtain a lock after a suitable number of retries, it displays an informational message and terminates. 

Under some circumstances, an Ada family or Ada library may be locked, but the locking program(s) may have terminated (for example, due to system crash or network failure).  If you determine that the Ada family or Ada library is locked but should not be locked, you can remove the lock. 

Use ada.unlock(1) to unlock an Ada library and ada.funlock(1) to unlock an Ada family.  However, unlocking should be done with care.  If an Ada family or Ada library is actually locked by a tool, unlocking it permits access by other tools that might find the contents invalid or might damage the Ada family or Ada library. 

AUTHOR

Ada.lmgr was developed by HP and Alsys. 

FILES

$HOME/.ada.lmgrrc User start up commands. 

$HOME/.ada.lmgrdf User start up defaults. 

$ADA_PATH/ada.lmgr Ada interactive library manager command. 

$ADA_PATH/adacli Ada command language interpreter. 

$ADA_PATH/ada.mngrs.bin
Ada components manager subprocess.

$ADA_PATH/ada.lmgr.hlp
Ada library manager help command data.

$ADA_PATH/ada.lmgr.btl
Ada library manager command tables.

SEE ALSO

ada(1), ada.fmgr(1), ada.format(1), ada.funlock(1), ada.lsfam(1), ada.lslib(1), ada.make(1), ada.mkfam(1), ada.mklib(1), ada.mvfam(1), ada.mvlib(1), ada.probe(1), ada.protect(1), ada.rmfam(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1), ada.xref(1),

Ada User’s Guide (Series 300).

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989