NAME

ada.rmlib − remove an Ada library

SYNOPSIS

ada.rmlib [ -f ] libraryname

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.rmlib removes the Ada library (directory) libraryname. 

If the standard input is a terminal, ada.rmlib requests confirmation before removing an Ada library.  Confirmation is not requested if the −f option is given or if the standard input is not a terminal. 

Removal of an Ada library requires write permission in its parent directory and recursively in all its subdirectories, but neither read nor write permission on the files within it. 

The following option is recognized:

−f Do not ask for confirmation before removing the Ada library. 

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.rmlib) 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.  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.rmlib 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 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 locked but is should not be locked, you may 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. 

DIAGNOSTICS

Ada.rmlib returns exit status 0 if the Ada library was successfully removed; otherwise, a diagnostic is issued and a non-zero exit status is returned. 

WARNINGS

An Ada library is a directory containing files used by 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.rmlib attempts to remove all such files and subdirectories. 

Lack of write permission to the parent directory or subdirectories causes ada.rmlib to fail to correctly remove the Ada library and leads to partial destruction of the structure under the Ada library. 

Removing an Ada library when your current working directory is the Ada library directory or a subdirectory of the Ada library directory might lead to an incompletely removed Ada library. 

AUTHOR

Ada.rmlib was developed by HP and Alsys. 

FILES

$ADA_PATH/ada.rmlib Ada remove library command. 

$ADA_PATH/adacli Ada command language interpreter. 

$ADA_PATH/ada.mngrs.bin Ada component 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.lmgr(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.umgr(1), ada.unlock(1), ada.xref(1),

Ada User’s Guide (Series 300).

EXTERNAL INFLUENCES

International Code Set Support

Single-byte character code sets are supported within file names. 

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