xref: /titanic_44/usr/src/tools/env/gatekeeper.sh (revision 4802ef38608fec3c045e2daeca3894cfd276b5df)
17c478bd9Sstevel@tonic-gate#
27c478bd9Sstevel@tonic-gate# CDDL HEADER START
37c478bd9Sstevel@tonic-gate#
47c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5b84bdc30Smeem# Common Development and Distribution License (the "License").
6b84bdc30Smeem# You may not use this file except in compliance with the License.
77c478bd9Sstevel@tonic-gate#
87c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
107c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
117c478bd9Sstevel@tonic-gate# and limitations under the License.
127c478bd9Sstevel@tonic-gate#
137c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
147c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
167c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
177c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
187c478bd9Sstevel@tonic-gate#
197c478bd9Sstevel@tonic-gate# CDDL HEADER END
207c478bd9Sstevel@tonic-gate#
217c478bd9Sstevel@tonic-gate#
227c478bd9Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"
237c478bd9Sstevel@tonic-gate#
24b84bdc30Smeem# Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
257c478bd9Sstevel@tonic-gate# Use is subject to license terms.
267c478bd9Sstevel@tonic-gate#
277c478bd9Sstevel@tonic-gate#	Configuration variables for the runtime environment of the nightly
287c478bd9Sstevel@tonic-gate# build script and other tools for construction and packaging of releases.
297c478bd9Sstevel@tonic-gate# This script is sourced by 'nightly' and 'bldenv' to set up the environment
307c478bd9Sstevel@tonic-gate# for the build. This example is suitable for building a gate,
317c478bd9Sstevel@tonic-gate# which will contain the resulting packages and archives (builds of the gate
327c478bd9Sstevel@tonic-gate# are done in children and then the resulting archives, packages, and proto
337c478bd9Sstevel@tonic-gate# area are put into the parent for everyone to use). It is based off
347c478bd9Sstevel@tonic-gate# the onnv release. It sets NIGHTLY_OPTIONS to make nightly do:
357c478bd9Sstevel@tonic-gate#	DEBUG and non-DEBUG builds (-D)
367c478bd9Sstevel@tonic-gate#	creates cpio archives for bfu (-a)
377c478bd9Sstevel@tonic-gate#	creates packages for PIT/RE (-p)
387c478bd9Sstevel@tonic-gate#	checks for new interfaces in libraries (-A)
397c478bd9Sstevel@tonic-gate#	runs 'make check' (-C)
407c478bd9Sstevel@tonic-gate#	runs lint in usr/src (-l plus the LINTDIRS variable)
417c478bd9Sstevel@tonic-gate#	sends mail on completion (-m and the MAILTO variable)
427c478bd9Sstevel@tonic-gate#	updates the protolist in the parent for children to compare with (-u)
437c478bd9Sstevel@tonic-gate#	updates the proto area in the parent when done (-U)
447c478bd9Sstevel@tonic-gate#	checks for changes in ELF runpaths (-r)
457c478bd9Sstevel@tonic-gate#	checks for changes in unreferenced files (-f)
467c478bd9Sstevel@tonic-gate#
47b84bdc30SmeemNIGHTLY_OPTIONS="-aADClmpuUrf";		export NIGHTLY_OPTIONS
487c478bd9Sstevel@tonic-gate
497c478bd9Sstevel@tonic-gate# This is a variable for the rest of the script - GATE doesn't matter to
507c478bd9Sstevel@tonic-gate# nightly itself
517c478bd9Sstevel@tonic-gateGATE=onnv-gate;					export GATE
527c478bd9Sstevel@tonic-gate
537c478bd9Sstevel@tonic-gate# CODEMGR_WS - where is your workspace at (or what should nightly name it)
547c478bd9Sstevel@tonic-gate# there is only one definition here, which assumes all the gate build machines
557c478bd9Sstevel@tonic-gate# (sparc and x86) are set up the same. But remember, this is a script, so
567c478bd9Sstevel@tonic-gate# you _could_ look at $MACH or `uname -n` and set these variables differently.
577c478bd9Sstevel@tonic-gateCODEMGR_WS="/builds/$GATE";			export CODEMGR_WS
587c478bd9Sstevel@tonic-gate
597c478bd9Sstevel@tonic-gate# PARENT_WS is used to determine the parent of this workspace. This is
607c478bd9Sstevel@tonic-gate# for the options that deal with the parent workspace (such as where the
617c478bd9Sstevel@tonic-gate# proto area will go).
627c478bd9Sstevel@tonic-gatePARENT_WS="/ws/$GATE";				export PARENT_WS
637c478bd9Sstevel@tonic-gate
647c478bd9Sstevel@tonic-gate# CLONE_WS is the workspace nightly should do a bringover from. Since it's
657c478bd9Sstevel@tonic-gate# going to bringover usr/src, this could take a while, so we use the
667c478bd9Sstevel@tonic-gate# clone instead of the gate (see the gate's README).
677c478bd9Sstevel@tonic-gateCLONE_WS="/ws/onnv-clone";			export CLONE_WS
687c478bd9Sstevel@tonic-gate
69fb9f9b97Skupfer# This flag controls whether to build the closed source.  If
70fb9f9b97Skupfer# undefined, nightly(1) and bldenv(1) will set it according to whether
71fb9f9b97Skupfer# the closed tree is present.
72fb9f9b97Skupfer# CLOSED_IS_PRESENT="yes";		export CLOSED_IS_PRESENT
73fb9f9b97Skupfer
747c478bd9Sstevel@tonic-gate# The bringover, if any, is done as STAFFER.
757c478bd9Sstevel@tonic-gate# Set STAFFER to your own login as gatekeeper or integration engineer.
767c478bd9Sstevel@tonic-gate# The point is to use group "staff" and avoid referencing the parent
777c478bd9Sstevel@tonic-gate# workspace as root.
787c478bd9Sstevel@tonic-gate# Some scripts optionally send mail messages to MAILTO.
797c478bd9Sstevel@tonic-gate#
807c478bd9Sstevel@tonic-gateSTAFFER=nobody;				export STAFFER
817c478bd9Sstevel@tonic-gateMAILTO=$STAFFER;			export MAILTO
827c478bd9Sstevel@tonic-gate
837c478bd9Sstevel@tonic-gate# The project (see project(4)) under which to run this build.  If not
847c478bd9Sstevel@tonic-gate# specified, the build is simply run in a new task in the current project.
857c478bd9Sstevel@tonic-gateBUILD_PROJECT=;				export BUILD_PROJECT
867c478bd9Sstevel@tonic-gate
877c478bd9Sstevel@tonic-gate# You should not need to change the next four lines
887c478bd9Sstevel@tonic-gateLOCKNAME="`basename $CODEMGR_WS`_nightly.lock"; export LOCKNAME
897c478bd9Sstevel@tonic-gateATLOG="$CODEMGR_WS/log";			export ATLOG
907c478bd9Sstevel@tonic-gateLOGFILE="$ATLOG/nightly.log";			export LOGFILE
917c478bd9Sstevel@tonic-gateMACH=`uname -p`;				export MACH
927c478bd9Sstevel@tonic-gate
937c478bd9Sstevel@tonic-gate# REF_PROTO_LIST - for comparing the list of stuff in your proto area
947c478bd9Sstevel@tonic-gate# with. Generally this should be left alone, since you want to see differences
957c478bd9Sstevel@tonic-gate# between todays build and yesterdays.
967c478bd9Sstevel@tonic-gate#
977c478bd9Sstevel@tonic-gateREF_PROTO_LIST=$PARENT_WS/usr/src/proto_list_${MACH}; export REF_PROTO_LIST
987c478bd9Sstevel@tonic-gate
997c478bd9Sstevel@tonic-gate# where cpio archives of the OS are placed. Usually this should be left
1007c478bd9Sstevel@tonic-gate# alone too. Here they don't go in the build workspace, but in the parent.
1017c478bd9Sstevel@tonic-gate# Since this is done as root, the build machine needs root acces to
1027c478bd9Sstevel@tonic-gate# the parent over NFS.
1037c478bd9Sstevel@tonic-gateCPIODIR="${PARENT_WS}/archives/${MACH}/nightly";	export CPIODIR
1047c478bd9Sstevel@tonic-gate
1057c478bd9Sstevel@tonic-gate#
1067c478bd9Sstevel@tonic-gate#	build environment variables, including version info for mcs, motd,
1077c478bd9Sstevel@tonic-gate# motd, uname and boot messages. Mostly you shouldn't change this except
1087c478bd9Sstevel@tonic-gate# when the release slips (nah) or when starting a new release.
1097c478bd9Sstevel@tonic-gate#
1107c478bd9Sstevel@tonic-gateROOT="$CODEMGR_WS/proto/root_${MACH}";	export ROOT
1117c478bd9Sstevel@tonic-gateSRC="$CODEMGR_WS/usr/src";         	export SRC
1127c478bd9Sstevel@tonic-gateVERSION="$GATE";			export VERSION
1137c478bd9Sstevel@tonic-gate
1147c478bd9Sstevel@tonic-gate# the source product has no SCCS history, and is modified to remove source
1157c478bd9Sstevel@tonic-gate# that cannot be shipped. EXPORT_SRC is where the clear files are copied, then
1167c478bd9Sstevel@tonic-gate# modified with 'make EXPORT_SRC'.
1177c478bd9Sstevel@tonic-gateEXPORT_SRC="$CODEMGR_WS/export_src";    export EXPORT_SRC
1187c478bd9Sstevel@tonic-gate
1197c478bd9Sstevel@tonic-gate# CRYPT_SRC is similar to EXPORT_SRC, but after 'make CRYPT_SRC' the files in
1207c478bd9Sstevel@tonic-gate# xmod/cry_files are saved. They are dropped on the exportable source to create
1217c478bd9Sstevel@tonic-gate# the domestic build.
1227c478bd9Sstevel@tonic-gateCRYPT_SRC="$CODEMGR_WS/crypt_src";      export CRYPT_SRC
1237c478bd9Sstevel@tonic-gate
1247c478bd9Sstevel@tonic-gate#
1257c478bd9Sstevel@tonic-gate# the RELEASE and RELEASE_DATE variables are set in Makefile.master;
1267c478bd9Sstevel@tonic-gate# there might be special reasons to override them here, but that
1277c478bd9Sstevel@tonic-gate# should not be the case in general
1287c478bd9Sstevel@tonic-gate#
1297c478bd9Sstevel@tonic-gate# RELEASE="5.10.1";			export RELEASE
1307c478bd9Sstevel@tonic-gate# RELEASE_DATE="October 2007";		export RELEASE_DATE
1317c478bd9Sstevel@tonic-gate
1327c478bd9Sstevel@tonic-gate# proto area in parent for optionally depositing a copy of headers and
1337c478bd9Sstevel@tonic-gate# libraries corresponding to the protolibs target
1347c478bd9Sstevel@tonic-gate#
1357c478bd9Sstevel@tonic-gatePARENT_ROOT=$PARENT_WS/proto/root_$MACH; export PARENT_ROOT
1367c478bd9Sstevel@tonic-gate
1377c478bd9Sstevel@tonic-gate#
1387c478bd9Sstevel@tonic-gate#       package creation variable. This put the packages in the parent.
1397c478bd9Sstevel@tonic-gate#
1407c478bd9Sstevel@tonic-gatePKGARCHIVE="${PARENT_WS}/packages/${MACH}/nightly";	export PKGARCHIVE
1417c478bd9Sstevel@tonic-gate
1427c478bd9Sstevel@tonic-gate# we want make to do as much as it can, just in case there's more than
1437c478bd9Sstevel@tonic-gate# one problem. This is especially important with the gate, since multiple
1447c478bd9Sstevel@tonic-gate# unrelated broken things can be integrated.
1457c478bd9Sstevel@tonic-gateMAKEFLAGS=k;	export MAKEFLAGS
1467c478bd9Sstevel@tonic-gate
1477c478bd9Sstevel@tonic-gate# Magic variable to prevent the devpro compilers/teamware from sending
1487c478bd9Sstevel@tonic-gate# mail back to devpro on every use.
1497c478bd9Sstevel@tonic-gateUT_NO_USAGE_TRACKING="1"; export UT_NO_USAGE_TRACKING
1507c478bd9Sstevel@tonic-gate
1517c478bd9Sstevel@tonic-gate# Build tools - don't set these unless you know what you're doing.  These
1527c478bd9Sstevel@tonic-gate# variables allows you to get the compilers and onbld files locally or
1537c478bd9Sstevel@tonic-gate# through cachefs.  Set BUILD_TOOLS to pull everything from one location.
1547c478bd9Sstevel@tonic-gate# Alternately, you can set ONBLD_TOOLS to where you keep the contents of
1557c478bd9Sstevel@tonic-gate# SUNWonbld and SPRO_ROOT to where you keep the compilers.
1567c478bd9Sstevel@tonic-gate#
1577c478bd9Sstevel@tonic-gate#BUILD_TOOLS=/opt;				export BUILD_TOOLS
1587c478bd9Sstevel@tonic-gate#ONBLD_TOOLS=/opt/onbld;			export ONBLD_TOOLS
1597c478bd9Sstevel@tonic-gate#SPRO_ROOT=/opt/SUNspro;			export SPRO_ROOT
1607c478bd9Sstevel@tonic-gate
1617c478bd9Sstevel@tonic-gate# This goes along with lint - it is a series of the form "A [y|n]" which
1627c478bd9Sstevel@tonic-gate# means "go to directory A and run 'make lint'" Then mail me (y) the
1637c478bd9Sstevel@tonic-gate# difference in the lint output. 'y' should only be used if the area you're
1647c478bd9Sstevel@tonic-gate# linting is actually lint clean or you'll get lots of mail.
1657c478bd9Sstevel@tonic-gate# You shouldn't need to change this though.
1667c478bd9Sstevel@tonic-gate#LINTDIRS="$SRC y";	export LINTDIRS
1677c478bd9Sstevel@tonic-gate
1687c478bd9Sstevel@tonic-gate#
1697c478bd9Sstevel@tonic-gate# NT server for realmode builds
1707c478bd9Sstevel@tonic-gate#
1717c478bd9Sstevel@tonic-gate#NTSERVER=<hostname>;			export NTSERVER
1727c478bd9Sstevel@tonic-gate
1737c478bd9Sstevel@tonic-gate#
1747c478bd9Sstevel@tonic-gate# Reference to IA32 IHV workspace, proto area and packages
1757c478bd9Sstevel@tonic-gate#
1767c478bd9Sstevel@tonic-gate#IA32_IHV_WS=/ws/${GATE}-ihv;				export IA32_IHV_WS
1777c478bd9Sstevel@tonic-gate#IA32_IHV_ROOT=$IA32_IHV_WS/proto/root_i386;		export IA32_IHV_ROOT
1787c478bd9Sstevel@tonic-gate#IA32_IHV_PKGS=$IA32_IHV_WS/packages/i386/nightly;	export IA32_IHV_PKGS
1797c478bd9Sstevel@tonic-gate
1807c478bd9Sstevel@tonic-gate#
1817c478bd9Sstevel@tonic-gate# Reference to binary-only IA32 IHV packages (for boot floppy construction)
1827c478bd9Sstevel@tonic-gate#
1837c478bd9Sstevel@tonic-gate#IA32_IHV_BINARY_PKGS=/ws/${GATE}_ihv_bin
1847c478bd9Sstevel@tonic-gate#export IA32_IHV_BINARY_PKGS
1857c478bd9Sstevel@tonic-gate
1867c478bd9Sstevel@tonic-gate#
1877c478bd9Sstevel@tonic-gate# Boot floppy proto area
1887c478bd9Sstevel@tonic-gate#
1897c478bd9Sstevel@tonic-gate#DCB_ROOT="${CODEMGR_WS}/proto/root_dcb_${MACH}"
1907c478bd9Sstevel@tonic-gate#BOOTFLOPPY_ROOT="${CODEMGR_WS}/proto/root_BootFloppy_${MACH}"
1917c478bd9Sstevel@tonic-gate#export DCB_ROOT
1927c478bd9Sstevel@tonic-gate#export BOOTFLOPPY_ROOT
1937c478bd9Sstevel@tonic-gate
1947c478bd9Sstevel@tonic-gate#
1957c478bd9Sstevel@tonic-gate# Destination for sparc realmode package SUNWrmodu
1967c478bd9Sstevel@tonic-gate#
1977c478bd9Sstevel@tonic-gate#SPARC_RM_PKGARCHIVE="${CODEMGR_WS}/packages/sparc_realmode/nightly"
1987c478bd9Sstevel@tonic-gate#export SPARC_RM_PKGARCHIVE
1997c478bd9Sstevel@tonic-gate
2007c478bd9Sstevel@tonic-gate# REF_PROTO_LIST_DCB & REF_PROTO_LIST_BOOTFLOPPY
2017c478bd9Sstevel@tonic-gate# To compare the list of stuff in your DCB and BootFloppy proto areas
2027c478bd9Sstevel@tonic-gate# against. Generally this should be left alone, since you want to see
2037c478bd9Sstevel@tonic-gate# differences between todays build and yesterdays.
2047c478bd9Sstevel@tonic-gate#
2057c478bd9Sstevel@tonic-gate#REF_PROTO_LIST_DCB=$PARENT_WS/usr/src/realmode/proto_list_dcb_${MACH}
2067c478bd9Sstevel@tonic-gate#REF_PROTO_LIST_BOOTFLOPPY=$PARENT_WS/usr/src/realmode/proto_list_bootfloppy_${MACH}
2077c478bd9Sstevel@tonic-gate#export REF_PROTO_LIST_DCB
2087c478bd9Sstevel@tonic-gate#export REF_PROTO_LIST_BOOTFLOPPY
2097c478bd9Sstevel@tonic-gate
2107c478bd9Sstevel@tonic-gate# Set this flag to 'n' to disable the automatic validation of the dmake
2117c478bd9Sstevel@tonic-gate# version in use.  The default is to check it.
2127c478bd9Sstevel@tonic-gate#CHECK_DMAKE=y
2137c478bd9Sstevel@tonic-gate
2147c478bd9Sstevel@tonic-gate# Set this flag to 'n' to disable the use of 'checkpaths'.  The default,
2157c478bd9Sstevel@tonic-gate# if the 'N' option is not specified, is to run this test.
2167c478bd9Sstevel@tonic-gate#CHECK_PATHS=y
2177c478bd9Sstevel@tonic-gate
2187c478bd9Sstevel@tonic-gate# Set this flag to 'y' to enable the use of elfsigncmp to validate the
2197c478bd9Sstevel@tonic-gate# output of elfsign.  Doing so requires that 't' be set in NIGHTLY_OPTIONS.
2207c478bd9Sstevel@tonic-gate# The default is to not verify them.
2217c478bd9Sstevel@tonic-gate#VERIFY_ELFSIGN=n
222a5c06a9eSmike_s
223a5c06a9eSmike_s# BRINGOVER_FILES is the list of files nightly passes to bringover.
224fb9f9b97Skupfer# If not set the default is "usr", but it can be used for bringing
225a5c06a9eSmike_s# over deleted_files or other nifty directories.
226fb9f9b97Skupfer#BRINGOVER_FILES="usr deleted_files"
227*4802ef38Srscott
228*4802ef38Srscott# POST_NIGHTLY can be any command to be run at the end of nightly.
229*4802ef38Srscott# As its first and only argument, the command will be provided the return
230*4802ef38Srscott# status of nightly - one of "Completed", "Interrupted", or "Failed"
231*4802ef38Srscott# The log file will be available at $LOGFILE
232*4802ef38Srscott#POST_NIGHTLY=
233