233 .LP
234 .B Source Build options
235 .TP 10
236 .B \-S E | D | H
237 Build the Export, Domestic, or Hybrid source product. Only Export and
238 Domestic are truly buildable at this time.
239 .TP 10
240 .B \-S O
241 Simulate an OpenSolaris build on a full tree. This can be used by
242 internal developers to ensure that they haven't broken the build for
243 external developers.
244 .LP
245 Source build options only make sense for a full internal tree (open
246 and closed source). Only one source build option can be specified at
247 a time.
248
249 .LP
250 .B Miscellaneous options
251 .TP 10
252 .B \-O
253 generate deliverables for OpenSolaris. Tarballs containing signed
254 cryptographic binaries and binaries
255 of closed-source components are put in $CODEMGR_WS. (The
256 cryptographic tarballs are copies of the
257 ones that are put in the parent directory of
258 $PKGARCHIVE.)
259 .TP 10
260 .B \-V VERS
261 set the build version string to VERS, overriding VERSION
262 .TP
263 .B \-X
264 Copies the proto area and packages from the IHV and IHV-bin gates into the
265 nightly proto and package areas. This is only available on i386. See
266 .B REALMODE ENVIRONMENT VARIABLES
267 and
268 .B BUILDING THE IHV WORKSPACE
269 below.
270
271 .LP
272 .SH ENVIRONMENT VARIABLES
273 .LP
274 Here is a list of prominent environment variables that
275 .I nightly
276 references and the meaning of each variable.
277 .LP
278 .RE
531 corresponding variable for Mercurial or Subversion, which are assumed
532 to be installed in the default path.
533 .RE
534 .LP
535 .B OPEN_SRCDIR
536 .RS 5
537 The open source tree is copied to this directory when simulating an
538 OpenSolaris build (\fB\-S O\fR). It defaults to $CODEMGR_WS/open_src.
539 .LP
540 .RE
541 .B ON_CLOSED_BINS
542 .RS 5
543 OpenSolaris builds do not contain the closed source tree. Instead,
544 the developer downloads a closed binaries tree and unpacks it.
545 .B ON_CLOSED_BINS
546 tells nightly
547 where to find these closed binaries, so that it can add them into the
548 build.
549 .LP
550 .RE
551 .B ON_CRYPTO_BINS
552 .RS 5
553 This is the path to a compressed tarball that contains debug
554 cryptographic binaries that have been signed to allow execution
555 outside of Sun, e.g., $PARENT_WS/packages/$MACH/on-crypto.$MACH.bz2.
556 .I nightly
557 will automatically adjust the path for non-debug builds. This tarball
558 is needed if the closed-source tree is not present. Also, it is
559 usually needed when generating OpenSolaris deliverables from a project
560 workspace. This is because most projects do not have access to the
561 necessary key and certificate that would let them sign their own
562 cryptographic binaries.
563 .LP
564 .RE
565 .B CHECK_PATHS
566 .RS 5
567 Normally, nightly runs the 'checkpaths' script to check for
568 discrepancies among the files that list paths to other files, such as
569 exception lists and req.flg. Set this flag to 'n' to disable this
570 check, which appears in the nightly output as "Check lists of files."
571 .RE
572 .LP
573 .B CHECK_DMAKE
574 .RS 5
575 Nightly validates that the version of dmake encountered is known to be
576 safe to use. Set this flag to 'n' to disable this test, allowing any
577 version of dmake to be used.
578 .RE
579 .LP
580 .B MULTI_PROTO
581 .RS 5
582 If "no" (the default),
583 .I nightly
584 will reuse $ROOT for both the DEBUG and non-DEBUG builds. If "yes",
|
233 .LP
234 .B Source Build options
235 .TP 10
236 .B \-S E | D | H
237 Build the Export, Domestic, or Hybrid source product. Only Export and
238 Domestic are truly buildable at this time.
239 .TP 10
240 .B \-S O
241 Simulate an OpenSolaris build on a full tree. This can be used by
242 internal developers to ensure that they haven't broken the build for
243 external developers.
244 .LP
245 Source build options only make sense for a full internal tree (open
246 and closed source). Only one source build option can be specified at
247 a time.
248
249 .LP
250 .B Miscellaneous options
251 .TP 10
252 .B \-O
253 generate deliverables for OpenSolaris. Tarballs containing binaries
254 of closed-source components are put in $CODEMGR_WS.
255 .TP 10
256 .B \-V VERS
257 set the build version string to VERS, overriding VERSION
258 .TP
259 .B \-X
260 Copies the proto area and packages from the IHV and IHV-bin gates into the
261 nightly proto and package areas. This is only available on i386. See
262 .B REALMODE ENVIRONMENT VARIABLES
263 and
264 .B BUILDING THE IHV WORKSPACE
265 below.
266
267 .LP
268 .SH ENVIRONMENT VARIABLES
269 .LP
270 Here is a list of prominent environment variables that
271 .I nightly
272 references and the meaning of each variable.
273 .LP
274 .RE
527 corresponding variable for Mercurial or Subversion, which are assumed
528 to be installed in the default path.
529 .RE
530 .LP
531 .B OPEN_SRCDIR
532 .RS 5
533 The open source tree is copied to this directory when simulating an
534 OpenSolaris build (\fB\-S O\fR). It defaults to $CODEMGR_WS/open_src.
535 .LP
536 .RE
537 .B ON_CLOSED_BINS
538 .RS 5
539 OpenSolaris builds do not contain the closed source tree. Instead,
540 the developer downloads a closed binaries tree and unpacks it.
541 .B ON_CLOSED_BINS
542 tells nightly
543 where to find these closed binaries, so that it can add them into the
544 build.
545 .LP
546 .RE
547 .B CHECK_PATHS
548 .RS 5
549 Normally, nightly runs the 'checkpaths' script to check for
550 discrepancies among the files that list paths to other files, such as
551 exception lists and req.flg. Set this flag to 'n' to disable this
552 check, which appears in the nightly output as "Check lists of files."
553 .RE
554 .LP
555 .B CHECK_DMAKE
556 .RS 5
557 Nightly validates that the version of dmake encountered is known to be
558 safe to use. Set this flag to 'n' to disable this test, allowing any
559 version of dmake to be used.
560 .RE
561 .LP
562 .B MULTI_PROTO
563 .RS 5
564 If "no" (the default),
565 .I nightly
566 will reuse $ROOT for both the DEBUG and non-DEBUG builds. If "yes",
|