1 .\" ident       "%Z%%M% %I%     %E% SMI"
   2 .\" Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
   3 .\" Use is subject to license terms.
   4 .\"
   5 .\" CDDL HEADER START
   6 .\"
   7 .\" The contents of this file are subject to the terms of the
   8 .\" Common Development and Distribution License, Version 1.0 only
   9 .\" (the "License").  You may not use this file except in compliance
  10 .\" with the License.
  11 .\"
  12 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  13 .\" or http://www.opensolaris.org/os/licensing.
  14 .\" See the License for the specific language governing permissions
  15 .\" and limitations under the License.
  16 .\"
  17 .\" When distributing Covered Code, include this CDDL HEADER in each
  18 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  19 .\" If applicable, add the following below this CDDL HEADER, with the
  20 .\" fields enclosed by brackets "[]" replaced with your own identifying
  21 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  22 .\"
  23 .\" CDDL HEADER END
  24 .\"
  25 .TH checkpaths 1 "25 September 2003"
  26 .SH NAME
  27 .I checkpaths
  28 \- check file path containing files
  29 .SH SYNOPSIS
  30 \fBcheckpaths [-b] [root_paths...]\fP
  31 .LP
  32 .SH DESCRIPTION
  33 .IX "OS-Net build tools" "checkpaths" "" "\fBcheckpaths\fP"
  34 .LP
  35 .I checkpaths
  36 inspects the contents of various files within an OS-Net workspace to
  37 ensure that the file paths listed in those files are valid.  This
  38 provides an integrity check of the workspace to catch cases where a
  39 file was removed or renamed without updating the corresponding
  40 \fIinc.flg\fP, \fIcry_files\fP, or \fIexception_list\fP entry.
  41 .LP
  42 .I checkpaths
  43 is typically called from \fBnightly(1)\fP.  It may be invoked
  44 interactively within a workspace, and requires that at least
  45 \fI$CODEMGR_WS\fP is set to a valid workspace.  It is not necessary
  46 that a full build has been performed in the workspace to be tested,
  47 but if full build(s) are not available under the
  48 \fI$CODEMGR_WS/proto/\fP directory, then the corresponding exclusion
  49 lists are not verified.
  50 .LP
  51 .SH OPTIONS
  52 .LP
  53 The following options are supported:
  54 .TP 4
  55 .B \-b
  56 Disable processing of files that list derived (built) objects.  This
  57 should be set if the \fI$CODEMGR_WS/proto/\fP directory exists, but
  58 the contents are known to be bad.  \fBnightly(1)\fP will typically set
  59 this flag if the build fails.
  60 .LP
  61 .TP 4
  62 .B root_paths...
  63 By default, checkpaths validates all of the proto areas for known
  64 architectures that exist in the \fI$CODEMGR_WS/proto/\fP directory.
  65 To specify other root directories, list them as arguments on the
  66 command line.  It is an error if any of the root paths specified does
  67 not end with a known architecture.
  68 .LP
  69 .SH ENVIRONMENT VARIABLES
  70 .LP
  71 .B CODEMGR_WS
  72 .RS 4
  73 The root of your TeamWare workspace, which is the directory
  74 containing \fICodemgr_wsdata\fP.
  75 .RE
  76 .LP
  77 .B SRC
  78 .RS 4
  79 The location of your ON source tree.  Defaults to
  80 \fI$CODEMGR_WS/usr/src/\fP if not specified.
  81 .RE
  82 .LP
  83 .SH SEE ALSO
  84 .B nightly(1).