6205 Sdiff usr/src/tools/scripts/nightly.1onbld

Print this page

6205 onbld manuals should be declared as 1onbld
Reviewed by: Dan McDonald <danmcd@omniti.com>
Reviewed by: Josef Sipek <jeffpc@josefsipek.net>

   2 .\" " The contents of this file are subject to the terms of the
   3 .\" " Common Development and Distribution License (the "License").
   4 .\" " You may not use this file except in compliance with the License.
   5 .\" "
   6 .\" " You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   7 .\" " or http://www.opensolaris.org/os/licensing.
   8 .\" " See the License for the specific language governing permissions
   9 .\" " and limitations under the License.
  10 .\" "
  11 .\" " When distributing Covered Code, include this CDDL HEADER in each
  12 .\" " file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  13 .\" " If applicable, add the following below this CDDL HEADER, with the
  14 .\" " fields enclosed by brackets "[]" replaced with your own identifying
  15 .\" " information: Portions Copyright [yyyy] [name of copyright owner]
  16 .\" "
  17 .\" " CDDL HEADER END
  18 .\" "
  19 .\" "Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
  20 .\" "Copyright 2012 Joshua M. Clulow <josh@sysmgr.org>
  21 .\" "
  22 .TH nightly 1 "Jan 28, 2014"
  23 .SH NAME
  24 .I nightly
  25 \- build an OS-Net consolidation overnight
  26 .SH SYNOPSIS
  27 \fBnightly [-in] [-V VERS] <env_file>\fP
  28 .LP
  29 .SH DESCRIPTION
  30 .IX "OS-Net build tools" "nightly" "" "\fBnightly\fP"
  31 .LP
  32 .I nightly,
  33 the mother of all build scripts,
  34 can bringover, build, archive, package, error check, and
  35 generally do everything it takes to
  36 turn OS/Net consolidation source code into useful stuff.
  37 It is customizable to permit you to run anything from a
  38 simple build to all of the cross-checking a gatekeeper
  39 needs.  The advantage to using
  40 .I nightly
  41 is that you build things correctly, consistently and
  42 automatically, with the best practices; building with

 190 .B \-C
 191 Check for cstyle/hdrchk errors
 192 .TP
 193 .B \-f
 194 Check for unreferenced files.  Since the full workspace must be built
 195 in order to accurately identify unreferenced files, -f is ignored for
 196 incremental (-i) builds, or builds that do not include -l, and -p.
 197 .TP
 198 .B \-r
 199 Check the ELF runtime attributes of all dynamic objects
 200 .TP
 201 .B \-l
 202 Do "make lint" in $LINTDIRS (default: $SRC n)
 203 .TP
 204 .B \-N
 205 Do not run protocmp or checkpaths (note: this option is not
 206 recommended, especially in conjunction with the \-p option)
 207 .TP
 208 .B \-w
 209 Report which proto area objects differ between this and the last build.
 210 See wsdiff(1) for details. Note that the proto areas used for comparison
 211 are the last ones constructed as part of the build. As an example, if both
 212 a non-debug and debug build are performed (in that order), then the debug
 213 proto area will be used for comparison (which might not be what you want).
 214 .LP
 215 .B Groups of options
 216 .TP 10
 217 .B \-G
 218 Gate keeper default group of options (-u)
 219 .TP
 220 .B \-I
 221 Integration engineer default group of options (-mpu)
 222 .TP
 223 .B \-R
 224 Default group of options for building a release (-mp)
 225 
 226 .LP
 227 .B Miscellaneous options
 228 .TP 10
 229 .B \-V VERS
 230 set the build version string to VERS, overriding VERSION

 543 .LP
 544 If present, nightly executes this file just prior to executing the
 545 .I env
 546 file.  
 547 .SH EXAMPLES
 548 .LP
 549 Start with the example file in usr/src/tools/env/developer.sh
 550 (or gatekeeper.sh), copy to myenv and make your changes.
 551 .LP
 552 .PD 0
 553 # grep NIGHTLY_OPTIONS myenv
 554 .LP
 555 NIGHTLY_OPTIONS="-ACrlapDm"
 556 .LP
 557 export NIGHTLY_OPTIONS
 558 .LP
 559 # /opt/onbld/bin/nightly -i myenv
 560 .PD
 561 .LP
 562 .SH SEE ALSO
 563 .BR bldenv (1)

   2 .\" " The contents of this file are subject to the terms of the
   3 .\" " Common Development and Distribution License (the "License").
   4 .\" " You may not use this file except in compliance with the License.
   5 .\" "
   6 .\" " You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   7 .\" " or http://www.opensolaris.org/os/licensing.
   8 .\" " See the License for the specific language governing permissions
   9 .\" " and limitations under the License.
  10 .\" "
  11 .\" " When distributing Covered Code, include this CDDL HEADER in each
  12 .\" " file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  13 .\" " If applicable, add the following below this CDDL HEADER, with the
  14 .\" " fields enclosed by brackets "[]" replaced with your own identifying
  15 .\" " information: Portions Copyright [yyyy] [name of copyright owner]
  16 .\" "
  17 .\" " CDDL HEADER END
  18 .\" "
  19 .\" "Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
  20 .\" "Copyright 2012 Joshua M. Clulow <josh@sysmgr.org>
  21 .\" "
  22 .TH nightly 1ONBLD "Jan 28, 2014"
  23 .SH NAME
  24 .I nightly
  25 \- build an OS-Net consolidation overnight
  26 .SH SYNOPSIS
  27 \fBnightly [-in] [-V VERS] <env_file>\fP
  28 .LP
  29 .SH DESCRIPTION
  30 .IX "OS-Net build tools" "nightly" "" "\fBnightly\fP"
  31 .LP
  32 .I nightly,
  33 the mother of all build scripts,
  34 can bringover, build, archive, package, error check, and
  35 generally do everything it takes to
  36 turn OS/Net consolidation source code into useful stuff.
  37 It is customizable to permit you to run anything from a
  38 simple build to all of the cross-checking a gatekeeper
  39 needs.  The advantage to using
  40 .I nightly
  41 is that you build things correctly, consistently and
  42 automatically, with the best practices; building with

 190 .B \-C
 191 Check for cstyle/hdrchk errors
 192 .TP
 193 .B \-f
 194 Check for unreferenced files.  Since the full workspace must be built
 195 in order to accurately identify unreferenced files, -f is ignored for
 196 incremental (-i) builds, or builds that do not include -l, and -p.
 197 .TP
 198 .B \-r
 199 Check the ELF runtime attributes of all dynamic objects
 200 .TP
 201 .B \-l
 202 Do "make lint" in $LINTDIRS (default: $SRC n)
 203 .TP
 204 .B \-N
 205 Do not run protocmp or checkpaths (note: this option is not
 206 recommended, especially in conjunction with the \-p option)
 207 .TP
 208 .B \-w
 209 Report which proto area objects differ between this and the last build.
 210 See wsdiff(1ONBLD) for details. Note that the proto areas used for comparison
 211 are the last ones constructed as part of the build. As an example, if both
 212 a non-debug and debug build are performed (in that order), then the debug
 213 proto area will be used for comparison (which might not be what you want).
 214 .LP
 215 .B Groups of options
 216 .TP 10
 217 .B \-G
 218 Gate keeper default group of options (-u)
 219 .TP
 220 .B \-I
 221 Integration engineer default group of options (-mpu)
 222 .TP
 223 .B \-R
 224 Default group of options for building a release (-mp)
 225 
 226 .LP
 227 .B Miscellaneous options
 228 .TP 10
 229 .B \-V VERS
 230 set the build version string to VERS, overriding VERSION

 543 .LP
 544 If present, nightly executes this file just prior to executing the
 545 .I env
 546 file.  
 547 .SH EXAMPLES
 548 .LP
 549 Start with the example file in usr/src/tools/env/developer.sh
 550 (or gatekeeper.sh), copy to myenv and make your changes.
 551 .LP
 552 .PD 0
 553 # grep NIGHTLY_OPTIONS myenv
 554 .LP
 555 NIGHTLY_OPTIONS="-ACrlapDm"
 556 .LP
 557 export NIGHTLY_OPTIONS
 558 .LP
 559 # /opt/onbld/bin/nightly -i myenv
 560 .PD
 561 .LP
 562 .SH SEE ALSO
 563 .BR bldenv (1ONBLD)