a.mklib(1)
NAME
a.mklib − make library directory
FORMAT
a.mklib [-f -v] [-t target] [new_VADS_library [parent_VADS_library]]
a.mklib [-f -v] [-i] [new_VADS_library [parent_VADS_library]]
DESCRIPTION
a.mklib creates and initializes a new VADS library directory, creating three files (GVAS_table, ada.lib, and gnrx.lib) and four directories (.lines, .imports, .nets, and .objects). It constructs library pointers in ada.lib to all libraries available from the parent library and to the parent library itself. As a result, Ada units in the new library can reference all Ada units defined by the parent library and all units that were accessible from the parent library.
If no libraries are unspecified, the current working directory is initialized with the default parents, below.
If parent_VADS_library is unspecified, the default directories are the verdixlib and standard libraries for the default VADS version. The file /usr/lib/VADS contains a list of each version of VADS available on the machine; the default is the first VADS veersion listed. The -i or -t options may be used to override the default and create a VADS library for a particular target version. The tool a.vadsrc may also be used to create a local configuration file either in the current directory, or in the user’s $HOME directory, .vadsrc so that future libraries created in a directory below the current directory will reference a particular VADS version. (See a.vadsrc for details.)
The -f option will force initialization of the VADS library structure, overwriting any existing components and deleting any existing lock files.
OPTION
-f (force) Create VADS library structure even if some components are already present.
-i (interactive) Display all versions of VADS installed on the system and prompt for selection of VADS version.
-t target (target) Create a library for a specific target machine.
-v (verbose) Display the library search list and target directives.
EXAMPLE
If the user is positioned at the directory /usr/babbage/code and the VADS library olddir exists below it in the UNIX hierarchy, the command
a.mklib newdir olddir
creates the library directory /usr/babbage/code/newdir and provides access to the Ada compilation units previously compiled in the olddir library directory. Any units available to olddir from other libraries are now available from newdir as well.
FILES
GVAS_table address assignment file
ada.lib library reference file
gnrx.lib generic instantiation reference file
.lines line number reference files directory
.imports imported Ada units directory
.nets Ada net files directory
.objects Ada object files directory
.vadsrc local default configuration file
/usr/lib/VADS system-wide VADS version reference file
DIAGNOSTICS
An error is reported and no action is taken (without the -f option) if new_VADS_library contains any VADS components or lock files or if the name specified exists but is not a directory.