xref: /illumos-gate/usr/src/tools/scripts/checkpaths.1onbld (revision 1ee1bcba6f9a17099e11b5bb0d1eeab71c729aa3)
Copyright 2005 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.

CDDL HEADER START

The contents of this file are subject to the terms of the
Common Development and Distribution License, Version 1.0 only
(the "License"). You may not use this file except in compliance
with the License.

You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.

When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]

CDDL HEADER END

CHECKPATHS 1ONBLD "Sep 25, 2003"
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:

4 -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.

4 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).