NAME

ada.lsfam − list information about an Ada family

SYNOPSIS

ada.lsfam [ -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.lsfam lists pertinent information about the family familyname

The information Ada.lsfam prints includes the full path name of the family being listed, whether the family is a user or installation family, the associated installation family if it is a user family, the family creation date, the last modification date of the family and the number of libraries in the family. 

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

The following options are recognized:

−I List information about the INSTALLATION family. 

−P List information about the PUBLIC family. 

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.lsfam) 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.lsfam cannot obtain a lock after 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 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.lsfam returns exit status 0 if the Ada family was successfully listed; otherwise, a diagnostic is issued and a non-zero exit status is returned. 

AUTHOR

Ada.lsfam was developed by HP and Alsys. 

FILES

$ADA_PATH/ada.lsfam Ada family list 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.lmgr(1), ada.lslib(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.make(1),

Ada User’s Guide (Series 300).

INTERNATIONAL SUPPORT

8-bit file names. 

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