PowerAda aprojfind

From OC Systems Wiki!
Jump to: navigation, search


NAME

aprojfind - an extension to the Unix 'find' command for PowerAda projects

SYNOPSIS

aprojfind -[hLNP] [project_path] [find_arguments | -S | -D ]

DESCRIPTION

aprojfind uses the GNU find tool in conjunction with knowledge of the project hierarchy to locate files, directories, and sublibraries within the project which match certain criteria.

The find_arguments that may be provided are a subset of those supported by the GNU find command. In particular, those options that specify the output format such as -exec, -ls, -ok, -printf, -print0 are not supported. The goal is to provide the maximum flexibility, sometimes at the risk of good error recovery.

OPTIONS

-h
Prints version, and command line help information..
-D
Shows only non-sublibrary directories
-L
Shows only files in local project (no shadows)
-N
Shows only newest of multiple shadows of a file
-P
Shows only project-relative names (implies -N)
-S
Shows only sublibrary directories
find_arguments
options passed to find command

PARAMETERS

project_path
The directory name of a path which includes the project root.

FILES

$POWERADA/bin/aprojfind   -       the aprojfind program image
$POWERADA/tools/bin/gfind - the GNU find command

ENVIRONMENT VARIABLES

POWERADA
This must be defined and indicate the powerada/ada95 directory in the PowerAda installation.
POWERADA_BASELINES
Names a baselines file identifying aliases for baseline projects.

EXAMPLES

# find all files in the project that have execute permission
aprojfind -type f -perm -100
# remove all the sublibraries in the working project:
rm -r 'aprojfind -LS'

SEE ALSO

aprojls

BUGS/LIMITATIONS

aprojfind doesn't do much checking of the find_options, but just passes them along to find. In particular, options which modify the output format will break aprojfind, which parses the output.

Also, see Problems and Questions at the beginning of this Appendix.