User Commands
ADA.PROTECT(1)
$ADA]ATH/ada.mngrs.bin
$ADA_PATH/ada.lmgr.hlp
$ADA_PA TH/ ada.lmgr.btl SEE ALSO
Ada components manager subprocess.
Ada library manager help command data.
Ada library manager command tables.
ADA.PROTECT(1)
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.make(l), ada.mkfam(l), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.rmfam(l), ada.rmlib(l), ada.umgr(l), ada.unlock(l), ada.xref(l),
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported within file names.
ADA.RMFAM(l) Series 300 Only (Requires Optional Ada Software) ADA.RMFAM(l)
NAME
ada;rmfam - remove an Ada family SYNOPSIS
ada.rmfam [ -f ] 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.rmfam removes the Ada family (directory) familyname.
If the standard input is a terminal, ada.rmfam requests confirmation before removing an Ada family. Confirmation is not requested if the -f option is given or if the standard input is not a terminal.
Removal of an Ada family 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 family.
Environment Variables
The environment variable ADA_PATH is associated with all components of the Ada tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.rmfam) can be used (see ada(l), 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 read-ing can be accessed by any part of the Ada compilation system for read-only purposes.
If ada.rmfam 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 should not be locked, you may remove the lock.
Use ada.unlock(l) to unlock an Ada library and ada.funlock(l) to unlock an Ada family. How-ever, 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.rmfam returns exit status 0 if the Ada family was successfully removed; otherwise, a diag-nostic is issued and a non-zero exit status is returned.
WARNINGS
An Ada family is a directory containing files used by the Ada compilation system. Users are strongly discouraged from placing any user files or directories in Ada family directories. User files/directories in Ada families are subject to damage by or might interfere with proper
54 (Section 1) - 1 - HP-UX Release 7.0: September 1989
ADA.RMFAM(1) Series 300 Only (Requires Optional Ada Software) ADA.RMFAM(1)
operation of the Ada compilation system. In particular, ada.rmfam attempts to remove all such files and subdirectories.
Lack of write permission to the parent directory or subdirectories causes ada.rmfam to fail to correctly remove the Ada family and leads to partial destruction of the structure under the Ada family.
Removing an Ada family when your current working directory is the Ada family directory or a subdirectory of the Ada family directory might lead to an incompletely removed Ada family.
AUTHOR
Ada.rmfam was developed by HP and Alsys.
FILES
$ADA_PATH/ ada.rmfam
$ADA_PATH/ adac1i
$ADA_PATH/ ada.mngrs.bin
$ADA_PATH/ ada.fmgr.hlp
$ADA_PATH/ada.fmgr.btl SEE ALSO
Ada remove family command.
Ada command language interpreter.
Ada components manager subprocess.
Ada family manager help command data.
Ada family manager command tables.
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.make(1), ada.mkfam(1), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.protect(l), ada.rmlib(l), ada.umgr(l), ada.unlock(l), ada.xref(l).
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported.
ADA.RMLIB(1 ) Series 300 Only (Requires Optional Ada Software) ADA.RMLIB(1)
NAME
ada.rmlib - remove an Ada library SYNOPSIS
ada.rmlib [ -£ ] 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 -£ 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:
-£
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 compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.rmlib) can be used (see ada(l), 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 read-ing 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(l) to unlock an Ada library and ada.funlock(l) to unlock an Ada family. How-ever, 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 diag-nostic 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
56 (Section 1) - 1 - HP-UX Release 7.0: September 1989
ADA.RMLIB(1) Series 300 Only (Requires Optional Ada Software) ADA.RMLIB(l)
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_PATH/adacli
$ADA_PATH/ ada.mngrs.bin
$ADA_PATH/ ada.lmgr.hlp
$ADA_PATH/ ada.lmgr.btl SEE ALSO
Ada remove library command.
Ada command language interpreter.
Ada component manager subprocess.
Ada library manager help command data.
Ada library manager command tables.
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.make(l), ada.mkfam(l), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.protect(l), ada.rmfam(l), ada.umgr(l), ada.unlock(l), ada.xref(l),
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported within file names.
ADA.UMGR(1) Series 300 Only (Requires Optional Ada Software) ADA.UMGR(1)
NAME
ada.umgr - examine and modify an Ada library SYNOPSIS
ada.urngr [ -r I -u ] 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.umgr, the Ada unit manager, can be used to examine and modify the contents of an Ada library.
The following options are recognized:
-r Open the Ada library in read-only mode. The Ada library can only be examined, but not modified. This is the default mode.
-u Open the Ada library in update mode. The ERASE and ACQUIRE commands and the RESET option of the CHECK command require that the Ada library be opened in update mode.
Ada.umgr is an interactive tool which, when executed, prompts with 11 Unit_Manager II • Com-mands are then entered to examine or modify the contents of the Ada library.
For the syntax and semantics of the commands, refer to the Ada User's Guide, or use the avail-able online help facility in the unit manager.
The following commands can be typed in response to the IUniLManager" prompt:
Acquire
Erase units in the current Ada library.
Set global characteristics for commands.
Obtain help on the various ada.umgr commands.
Read ada.umgr commands from a file.
Compute a program closure (that is, determine whether a bind can be performed).
List units in the current Ada library.
Change the current Ada library.
Leave ada.umgr.
Execute a shell command.
List dependencies of a unit in the current Ada library.
Obtain general information about the current Ada library.
The help command provides online help for all the commands.
If the file .ada.urngrrc exists in the user's home directory, its commands are executed before the first prompt is issued.
58 (Section 1) - 1 - HP-UX Release 7.0: September 1989
ADA.UMGR(l) Series 300 Only (Requires Optional Ada Software) ADA.UMGR(l)
If the file .ada.umgrdf exists in the user's home directory, its commands are executed after those in .ada.umgrrc (if present) and before the first prompt is issued. The commands in this file are DEFAULT commands saved automatically by using the DEFAULTS
=>
KEEP parameter of the QUIT command.Environment Variables
The environment variable ADA_PATH is associated with all components of the Ada compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (induding ada.umgr) can be used (see ada(l), 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 part which holds the lock. An Ada family or library 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(l) to unlock an Ada library and ada.funlock(l) to unlock an Ada family. How-ever, 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.
AUTHOR
Ada.umgr was developed by HP and Alsys.
FILES
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.make(l), ada.mkfam(l), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.protect(l), ada.rmfam(l), ada.rmlib(l), ada.unlock(l), ada.xref(l),
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported within file names.
ADA.UNLOCK(1) Series 300 Only (Requires Optional Ada Software) ADA. UNLOCK (1)
NAME
ada.unlock - unlock an Ada library SYNOPSIS
ada.unlock 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.unlock removes all locks on an Ada library.
It is intended that ada. unlock be used to remove inappropriate locks. Such locks might be left by abnormally terminated components of the Ada compilation system or by system crashes.
Unlocking an Ada library requires write permission in its parent family's directory.
Extreme care must be used when unlocking an Ada library. If any component of the Ada com-pilation system is reading the Ada library, removing locks may cause that component to encounter internal inconsistencies and fail. In addition, if any component of the Ada compila-tion system is updating the Ada library, removing locks may cause that component to corrupt the Ada library and fail.
Environment Variables
The environment variable ADA_PATH is associated with all components of the Ada compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.unlock) can be used (see ada(I), Environment Variables).
DIAGNOSTICS
Ada.unlock returns exit status 0 if the Ada library was successfully unlocked. Otherwise a diag-nostic is issued and a non-zero exit status is returned.
AUTHOR
FILES
Ada.unlock was developed by HP and Alsys.
$ADA_PATHf ada. unlock
$ADA_PATHfadacli
$ADA_PATHf ada.mngrs.bin
$ADA_PATHfada.lmgr.hlp
$ADA_PATHfada.lmgr.btl
Ada unlock library command.
Ada command language interpreter.
Ada components manager subprocess.
Ada library manager help command data.
Ada library manager command tables.
SEE ALSO
ada(I), ada.fmgr(I), ada.format(I), ada.funlock(I), ada.lmgr(I), ada.lsfam(I), ada.lslib(I), ada.make(I), ada.mkfam(I), ada.mklib(I), ada.mvfam(I), ada.mvlib(I), ada.probe(I), ada.protect(I), ada.rmfam(l), ada.rmlib(l), ada.umgr(l), ada.xref(l),
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported within file names.
60 (Section 1) - 1 - HP-UX Release 7.0: September 1989
ADA.XREF(1) Series 300 Only (Requires Optional Ada Software) ADA.XREF(l)
NAME
ada.xref - Ada cross-referencer SYNOPSIS
ada.xref [ -1 ] file 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.xref produces a list of cross references for each name encountered in the compilation unit(s) submitted to it. Ada.xref operates in either source or library mode, as defined below:
source mode Ada.xref gathers information directly from the specified Ada source file. In this mode, ada.xref requires the source file suffix to be .ad?, where ? is any single alphanumeric character. The advantage of this mode is that the compilation unit(s) need not be compiled.
library mode Ada.xref retrieves the information which has been stored in one or more Ada program libraries at compile time. In this mode, file contains a list of compila-tion units along with the library name(s) containing the actual (as opposed to linked) compilation units. The compilation units specified must have been compiled with the -k option of the ada(1) command. The advantage of this mode is that ada.xref can identify Ada objects precisely, resolve overloading, understand deferred constants, and extend the cross-references to parent and
"withedll units not directly submitted.
The following option is recognized:
-1 Indicate library mode cross-referencing to be performed (default is source mode).
In library mode, any number of libraries can be specified, but all must belong to the same fam-ily. The library names are specified in the file using the following syntax:
use library_name
and the unit names are specified in the file using the following syntax:
unit_name [ specification I body I all]
where the optional unit parameter defines whether to cross-reference the specification, body or both the specification and body of the specified unit. By default, only the body of the specified unit_name is cross-referenced.
Environment Variables
The environment variable ADA_PATH is associated with all components of the Ada compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.xref) can be used (see ada(I), 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 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
ADA.XREF(1) Series 300 Only (Requires Optional Ada Software) ADA.XREF(1 )
purposes.
If ada.xref 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 exa~ple, due to system c-;'ash or network failure). If yo~
determine that the Ada family or Ada library is locked but should not be locked, you can remove the lock.
Use ada.unlock(l) to unlock an Ada library and ada.funlock(l) to unlock an Ada family. How-ever, 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
FILES
Ada.xref was developed by HP and Alsys.
$ADA_PATH/ada.xref
$ADA_PATH/ada.xref.bin
Ada cross-referencer command.
Ada cross-referencer subprocess.
SEE ALSO
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.make(l), ada.mkfam(l), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.protect(l), ada.rmfam(l), ada.rmlib(l), ada.umgr(l), ada.unlock(l).
Ada User's Guide (Series 300), HP Part No. 98860-90000.
Ada Tools Manual (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported within file names.
62 (Section 1) - 2 - HP-UX Release 7.0: September 1989
ADB(1) ADB(1)
NAME
adb - absolute debugger SYNOPSIS
adb [ -w ] [ -Idir ] [ objfil [ corfil ] ] DESCRIPTION
Adb is a general-purpose debugging program sensitive to the underlying architecture of the pro-cessor on ,\",hich it runs. It can be used to examine files and provide a controlled environment for the execution of HP-UX programs.
Objfil is normally an executable program file, preferably containing a symbol table; if not, the symbolic features of adb cannot be used, although the file can still be examined. The default for objfil is a.out. Corfil is assumed to be a core image file produced after executing objfil; the default for corfil is core.
Requests to adb are read from standard input and adb responds to standard output. If the -w flag is present, objfil is created (if necessary) and opened for reading and writing, to be modified using adb. The -I option specifies a directory where files read with $< or $« (see below) are sought; the default is /usr/lib/adb. Adb ignores QUIT; INTERRUPT causes return to the next
Requests to adb are read from standard input and adb responds to standard output. If the -w flag is present, objfil is created (if necessary) and opened for reading and writing, to be modified using adb. The -I option specifies a directory where files read with $< or $« (see below) are sought; the default is /usr/lib/adb. Adb ignores QUIT; INTERRUPT causes return to the next