1 checkpaths(1ONBLD)            illumos Build Tools           checkpaths(1ONBLD)
   2 
   3 
   4 
   5 NAME
   6        checkpaths - check file path containing files
   7 
   8 SYNOPSIS
   9        checkpaths [-b] [root_paths...]
  10 
  11 DESCRIPTION
  12        checkpaths inspects the contents of various files within an OS-Net
  13        workspace to ensure that the file paths listed in those files are
  14        valid.  This provides an integrity check of the workspace to catch
  15        cases where a file was removed or renamed without updating the
  16        corresponding inc.flg, cry_files, or exception_list entry.
  17 
  18        checkpaths is typically called from nightly(1ONBLD).  It may be invoked
  19        interactively within a workspace, and requires that at least
  20        $CODEMGR_WS is set to a valid workspace.  It is not necessary that a
  21        full build has been performed in the workspace to be tested, but if
  22        full build(s) are not available under the $CODEMGR_WS/proto/ directory,
  23        then the corresponding exclusion lists are not verified.
  24 
  25 OPTIONS
  26        The following options are supported:
  27 
  28        -b  Disable processing of files that list derived (built) objects.
  29            This should be set if the $CODEMGR_WS/proto/ directory exists, but
  30            the contents are known to be bad.  nightly(1ONBLD) will typically
  31            set this flag if the build fails.
  32 
  33        root_paths...
  34            By default, checkpaths validates all of the proto areas for known
  35            architectures that exist in the $CODEMGR_WS/proto/ directory.  To
  36            specify other root directories, list them as arguments on the
  37            command line.  It is an error if any of the root paths specified
  38            does not end with a known architecture.
  39 
  40 ENVIRONMENT VARIABLES
  41        CODEMGR_WS
  42            The root of your TeamWare workspace, which is the directory
  43            containing Codemgr_wsdata.
  44 
  45        SRC
  46            The location of your ON source tree.  Defaults to
  47            $CODEMGR_WS/usr/src/ if not specified.
  48 
  49 SEE ALSO
  50        nightly(1ONBLD).
  51 
  52 
  53 
  54                                25 September 2003            checkpaths(1ONBLD)