User Commands
INTERNATIONAL SUPPORT 8-bit file names
32 (Section 1) - 3 - HP-UX Release 7.0: September 1989
ADA.LSFAM(1) Series 300 Only <Requires Optional Ada Software) ADA.LSFAM(l)
NAME
ada.lsfam - list information about an Ada family SYNOPSIS
ada.1sfam [ -I I -P I 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.isfam 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 compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.lsfam) 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.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.uniock(l) to unlock an Ada library and ada.funiock(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.isfam returns exit status 0 if the Ada family was successfully listed; otherwise, a diagnostic is issued and a non-zero exit status is returned.
ADA.LSF AM(1) Series 300 Only (Requires Optional Ada Software)
AUTHOR
FILES
Ada.lsfam was developed by HP and Alsys.
$ADA_PATH/ada.lsfam Ada family list command.
$ADA_PATH/adacii Ada command ianguage interpreter.
$ADA_PATH/ada.mngrs.bin
Ada components manager subprocess.
$ADA_P ATH/ ada.lmgr.hlp
Ada library manager help command data.
$ADA_PATH/ada.lmgr.btl Ada library manager command tables.
SEE ALSO
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lslib(l), 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.make(l),
Ada User's Guide (Series 300).
INTERNATIONAL SUPPORT 8-bit file names.
ADA.LSFAM(1)
ada.mkfam(l ), ada.rmfam(l),
34 (Section 1) - 2 - HP-UX Release 7.0: September 1989
ADA.LSLlB(l) Series 300 Only (Requires Optional Ada Software) ADA.LSLIB(1)
NAME
ada.lslib - list the libraries in an Ada family SYNOPSIS
ada.lslib [ -f I -b ] [ -I I -P I 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.lslib lists the Ada libraries in the family specified.
The user can request either a full or a brief listing of the libraries in the specified family. The default is a brief listing.
Only one of the options -f and -b, and 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:
-b -f -I -P Environment Variables
Generate a brief listing.
Generate a full listing.
List libraries in the INSTALLATION family.
List libraries in the PUBLIC family.
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.lslib) 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.lslib 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.lslib returns exit status 0 if Ada libraries were successfully listed; otherwise, a diagnostic is issued and a non-zero exit status is returned.
ADA.LSLlB(1) Series 300 Only (Requires Optional Ada Software)
AUTHOR
FILES
Ada.lslib was developed by HP and Alsys.
$ADlLPATH/ada.lslib Ada library list command.
$ADA_PATH/adadi Ada command language interpreter.
$ADA_PATH/ada.mngrs.bin
Ada components manager subprocess.
$ADA_P A TH/ ada.lmgr.hlp
Ada library manager help command data.
$ADA_PATH/ada.lmgr.btl Ada library manager command tables.
SEE ALSO
ADA.LSLlB(1)
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(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.xref(l),
Ada User's Guide (Series 300).
INTERNATIONAL SUPPORT 8-bit file names.
36 (Section 1) - 2 - HP-UX Release 7.0: September 1989
ADA.MAKE(l) Series 300 Only (Requires Optional Ada Software) ADA.MAKE(1)
NAME
ada. make - determine compilation order, update Ada libraries SYNOPSIS
ada.make [ options ] [ library ] [ files ] 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.make reads Ada source files and libraries in order to produce a minimal, correctly ordered sequence of commands necessary to compile or recompile a set of Ada compilation units.
The library argument names an Ada library that must have already been created using the ada.mklib(l) command.
Files specifies a set of Ada source files. For an application that consists of a large number of source files, the system-imposed limit on argument list length may be exceeded. For this rea-son, patterns may be given as file arguments. A pattern may contain the character *, which matches any sequence of zero or more characters. The character
*
must be escaped from the shell.If neither library nor files is specified, ada. make operates on the files in the current directory whose names end with .ad?, where? is any single alphanumeric character (see Source vs. Library Mode, below).
The command sequence generated by ada. make is written to file ada.make.out (or to the file named by the -0 option). The commands in this file can be executed by sh(l) using the com-mand "sh ada.make.out".
Options
The following options are recognized:
-a Produce commands to compile units regardless of whether they are out-of-date.
-b Emit a command to bind the unit specified by the option -r unitpattern (only allowed if unitpattern specifies a single unit).
-£ file Read library and files arguments from file. A file name of - denotes the stan-dard input.
-i Check the validity of all required units, regardless of where they reside in the family. Output may contain commands to acquire links or compile source files into any library in the family (see Multi-Library Operation, below).
- 0 outfile Name the output file outfile instead of ada.make.out.
-p Assume that all links in library and all units outside of library are valid (see Multi-Library Operation, below).
-[ unitpattern Specify which units are to be brought up to date. Unitpattern may be the name of a single unit, or may contain one or more occurrences of the character
*
1 which matches any sequence of zero or more characters in a unit name.The character
*
must be escaped from the shell.The default unitpattern is *, which selects all units in library and files.
-s searchlibrary Specify a library to be searched when a required unit is missing (no link to the unit exists in library, and the unit is not contained in files).
This option may be repeated to specify multiple libraries. Ada.make searches the libraries in the order they are given; the first correctly named unit is
ADA.MAKE(1)
-v
Series 300 Only (Requires Optional Ada Software) ADA.MAKE(1)
selected.
Enable verbose mode, which writes the ada. make command being processed and the command sent to the subprocess ada. make. bin to standard error.
Source vs. Library Mode
Ada.make can work in source mode, to produce a correct compilation order for a set of source files, in library mode, to identify files that need to be recompiled, or in a combination of these two modes. When operating on an application whose units are contained in multiple libraries, ada. make produces commands to create the required links between libraries.
When library is not specified, ada. make operates in source mode on files. If files are not given, it uses files in the current directory whose names end with .ad?, where? is any single character.
When operating in source mode, the resulting compile commands do not specify a library. The commands can be executed, however, if the environment variable ADAOPTS contains a library name (see ada(1), Environment Variables).
If library is specified, it is read to determine which units are obsolete. For each unit ada.make
Ada.make provides three modes of operation for applications that are distributed among multiple libraries. These modes determine whether the validity of units outside library is checked, and whether commands will be emitted that would alter libraries other than library.
The default mode is to check all required units, regardless of what library they reside in. Any obsolete unit, however, is recompiled into library, rather than into the library in which the obsolete unit was found.
The -p ("partial") option directs ada. make to assume that all links in library and all units outside of library are valid. No commands to acquire links are emitted. Compile commands are only emitted for units contained in files and units that were previously compiled in library.
In the preceding two modes of operation, only library is changed -- no other libraries in the
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.make) 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 part which holds the lock. An Ada family or library
38 (Section 1) - 2 - HP-UX Release 7.0: September 1989
ADA.MAKE(1) Series 300 Only (Requires Optional Ada Software) ADA.MAKE(l)
locked for reading can be accessed by any part of the Ada compilation system for read-only purposes.
If ada. make 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 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.make was developed by HP and Alsys.
$ADA_PATH/ada.make
$ADA_P ATH/ada.make.bin ada.make.out
ada. make command ada.make subprocess output file
SEE ALSO
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(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(1), ada.unlock(l), ada.xref(l),
Ada User's Guide (Series 300), Ada Tools Manual (Series 300).
ADA.MKFAM(1) Series 300 Only (Requires Optional Ada Software) ADA.MKFAM(l)
NAME
ada.mkfam - make (or reinitialize) an Ada family SYNOPSIS
ada.mkfam [ -f
1
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.mkfam creates the Ada family familyname in mode 777 (possibly altered by umask(l)). The Ada family created is used by the compiler to maintain groups of libraries which have visibility of each other.
Ada.mkfam requires write permission in the parent directory. Ada.mkfam only creates the last component of the specified path as the Ada family; all parent directories must already exist.
An Ada family is a group of Ada libraries that are visible to one another. Units in a library in a particular family can be dependent on units in another library in the same family and a pro-gram 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 INSTAL-LATION family (a family provided with the Ada compilation system) are accessible to libraries in any other family.
If familyname exists, ada.mkfam can be used to reinitialize it (thus making it an empty family).
If the standard input is a terminal, ada.mkfam requests confirmation before reinitializing an exist-ing Ada family. Confirmation is not requested if the -f option is given or if the standard input is not a terminal.
The following options are recognized:
-f Do not ask for confirmation if the family being created already exists; reinitial-ize the existing Ada family to the empty state.
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.mkfam) 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.mkfam 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 can remove the lock.
40 (Section 1) - 1 - HP-UX Release 7.0: September 1989
ADA.MKFAM(1) Series 300 Only (Requires Optional Ada Software) ADA.MKFAM(1)
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.mkfam returns exit status 0 if the Ada family directory was successfully created. Otherwise a diagnostic is issued and a non-zero exit status is returned.
WARNINGS
An Ada family 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 family directories.
User files/directories in Ada families are subject to damage by or might interfere with proper operation of the Ada compilation system. In particular, ada.mkfam does not preserve such user files when reinitializing an existing Ada family, and is unable to reinitialize an existing Ada family (effectively destroying it) if the existing Ada family directory contains any subdirectories.
AUTHOR
FILES
Ada.mkfam was developed by HP and Alsys.
$ADA_PATH/ada.mkfam Ada make family command.
$ADA_PATH/adacli Ada command language interpreter.
$ADA_PATH/ ada.mngrs.bin
Ada components manager subprocess.
$ADA_PATH/ada.fmgr.hlp
Ada library manager help command data.
$ADA]ATH/ada.fmgr.btl Ada library manager command tables.
SEE ALSO
ada(l), ada.fmgr(l), ada.format(l), ada.funlock(l), ada.1mgr(l), ada.lsfam(l), ada.lslib(l), ada.make(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.xref(l),
Ada User's Guide (Series 300).
EXTERNAL INFLUENCES
International Code Set Support
Single-byte character code sets are supported.
ADA.MKLIB(l) Series 300 Only (Requires Optional Ada Software) ADA.MKLIB(1)
NAME
ada.mklib - make (or reinitialize) an Ada library SYNOPSIS
ada.mklib [ -f ] [ -I I -P I familyname ] libraryname DESCRiPTION
Ada.mklib creates the Ada library libraryname in mode 777 (possibly altered by umask(1». The Ada library created is specified by name during subsequent compilations of Ada source, and is used by the compiler to maintain intermediate forms of Ada compilation units.
Ada.mklib requires write permission in the parent directory. Ada.mklib only creates the last com-ponent of the specified path as the Ada library; all parent directories must already exist.
The created library is made a member of an Ada family of libraries. By default, the created library is made a member of the PUBLIC family. Optionally, the created library can be made a member of any existing Ada family.
An Ada family is a group of Ada libraries that are visible to one another. Units in a library in a particular family can be dependent on units in another library in the same family and a pro-gram 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
Libraries that are members of different families are normally invisible to each other and cannot