PowerAda aunitmv

From OC Systems Wiki!
Jump to: navigation, search


NAME

aunitmv - move a unit

SYNOPSIS

aunitmv [-hf] SourceSublibrary TargetSublibrary 
        { -I | Name ... }

DESCRIPTION

This command moves one or more units from one sublibrary to another sublibrary.

OPTIONS

-h
Requests help for the command. If specified, all other options and parameters (except possibly erroneous ones) are ignored.
-f
Indicates that the names specified are source file names, not compilation unit names. All units associated with each of the source files will be moved.
You can specify a source file name either with or without a full directory path. However a sublibrary can contain compilation units from different files with the same base name; you might have some units in the file /u/smith/the_file.ada and other units in the file /u/jones/the_file.ada. If you use the -f option to move all units associated with the source file the_file.ada, the aunitmv command returns an error. In such a case specify the full path name for the source file.
-I
Specifies that a list of names will be read from standard input. If the -f option is specified, the names are interpreted as file names. Otherwise the names are interpreted as compilation unit names.
If "--" is found in a line read from standard input, the remainder of the line is ignored.
This option can appear anywhere on the command line; if you use it you cannot also specify a file name as the last command-line parameter.

PARAMETERS

SourceSublibrary
Specifies the name of the sublibrary from which the unit is to be moved. If it is not in the current directory, specify its name as either a relative or absolute path name.
TargetSublibrary
Specifies the name of the sublibrary to which the unit is to be moved. If it is not in the current directory, specify its name as either a relative or absolute path name.
Name . . .
Specifies the names of the compilation units or source files that will be used in this move operation.
If the -f option is specified, the name parameter refers to a source file name containing the units to be moved.
If the -f option is not specified, the name parameter refers to an Ada compilation unit name to be moved. Each unit name must be prefixed with either lib/ or sec/.

RESTRICTIONS

If the source file that contains a compilation unit contains other units as well, you cannot move just one of the units to another sublibrary. Use the -f option, specifying the file name, to move all the units contained in the file.

This restriction does not apply to a source file containing the specification and body of a compilation unit. Both specification and body are moved at the same time by the aunitmv command.

When you move a compilation unit from one sublibrary to another, the target sublibrary cannot already contain a compilation unit with the same name as the one being moved, or the move operation will fail.

When you use the -f option to move compilation units, the source file specified can contain a set of compilation units. The target sublibrary must not contain a compilation unit with the same name as any unit in this set or the move operation will fail.

FILES

$POWERADA/bin/aunitmv

the aunitmv program image

RETURN CODES

Below is a list of the possible values returned by aunitmv. Refer to Return Codes for CommandsReturn Codes for Commands for details about the meaning of these return s.

0, 1, 2, 3, 4, 5, 10, 16, 99

ENVIRONMENT VARIABLES

POWERADA
This must be defined and indicate the powerada/ada95 directory in the PowerAda installation.

BUGS/LIMITATIONS

See Problems and Questions at the beginning of this Appendix.