Series 300 Only

NAME

ada.mvlib − move (rename) an Ada library

SYNOPSIS

ada.mvlib [ -f ] fromlib tolib

DESCRIPTION

The Ada library fromlib is moved (renamed) to tolib.  The contents of tolib are completely replaced with the contents of fromlib. 

If tolib exists, it must be a member of the same family as fromlib. 

If the standard input is a terminal, ada.mvlib requests confirmation before replacing an existing tolib.  Confirmation is not requested if the −f option is given or if the standard input is not a terminal. 

Write permission is required in the parent directory of both fromlib and tolib. 

The following options are recognized:

−f Do not ask for confirmation if tolib already exists; remove tolib and rename fromlib. 

Environment Variables

Two environment variables, ADA_PATH and ADA_PREDEF_LIB, are associated with all components of the the Ada compilation system.  Both must be set properly and exported before any component of the Ada compilation system (including ada.mvlib) 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 a library is added, removed, or renamed; however, sometimes multiple Ada libraries must be locked for longer periods during a single operation.  If more than one library is locked, ada places an exclusive lock on one library, for updating, and a shared lock on any others to remain open for read-only purposes. 

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 part which holds the lock.  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.mvlib cannot obtain a lock, it displays an informational message and terminates. 

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

Use ada.unlock(1) to unlock an Ada library and the UNLOCK command of ada.fmgr(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 which might find the contents invalid or might damage the Ada family or Ada library. 

DIAGNOSTICS

Ada.mvlib returns exit status 0 if the operation was successful; otherwise, a diagnostic is issued and a non-zero exit status is returned. 

If fromlib is not an Ada library or tolib exists and is not an Ada library, a diagnostic is issued and no action is taken. 

WARNINGS

An Ada library is a directory containing files for the use of the Ada compilation system.  Users are strongly discouraged from placing any user files or directories in Ada library directories.  User files/directories in Ada libraries are subject to damage by or might interfere with proper operation of the Ada compilation system.  In particular, ada.mvlib does not preserve such user files when renaming (moving) an Ada library, and is unable to overwrite an existing Ada library (effectively destroying it) if the existing Ada library directory contains any subdirectories. 

AUTHOR

Ada.mvlib was developed by HP and Alsys. 

FILES

$ADA_PATH/ada.lmgr.bin
Ada library 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.mklib(1), ada.probe(1), ada.protect(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1).  ada.xref(1). 
 
Ada User’s Guide (Series 300), HP Part No. 98860-90000. 

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  May 11, 2021