CHECKPATHS(1ONBLD) illumos Build Tools CHECKPATHS(1ONBLD)

NAME

checkpaths - check file path containing files

SYNOPSIS

checkpaths [-b] [root_paths...]

DESCRIPTION

checkpaths inspects the contents of various files within an OS-Net workspace to ensure that the file paths listed in those files are valid. This provides an integrity check of the workspace to catch cases where a file was removed or renamed without updating the corresponding inc.flg, cry_files, or exception_list entry.

checkpaths is typically called from nightly(1ONBLD). It may be invoked interactively within a workspace, and requires that at least $CODEMGR_WS is set to a valid workspace. It is not necessary that a full build has been performed in the workspace to be tested, but if full build(s) are not available under the $CODEMGR_WS/proto/ directory, then the corresponding exclusion lists are not verified.

OPTIONS

The following options are supported:
-b
Disable processing of files that list derived (built) objects. This should be set if the $CODEMGR_WS/proto/ directory exists, but the contents are known to be bad. nightly(1ONBLD) will typically set this flag if the build fails.
root_paths...
By default, checkpaths validates all of the proto areas for known architectures that exist in the $CODEMGR_WS/proto/ directory. To specify other root directories, list them as arguments on the command line. It is an error if any of the root paths specified does not end with a known architecture.

ENVIRONMENT VARIABLES

CODEMGR_WS
The root of your TeamWare workspace, which is the directory containing Codemgr_wsdata.

SRC

The location of your ON source tree. Defaults to $CODEMGR_WS/usr/src/ if not specified.

SEE ALSO

nightly(1ONBLD).
September 25, 2003