4680 nightly and bldenv need to set LC_ALL if they want to fully override the locale
[illumos-gate.git] / usr / src / tools / scripts / bldenv.sh
blob26a93cab4aaea64f75b46ff2e4705b4b99f1d21b
1 #!/usr/bin/ksh93
3 # CDDL HEADER START
5 # The contents of this file are subject to the terms of the
6 # Common Development and Distribution License (the "License").
7 # You may not use this file except in compliance with the License.
9 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 # or http://www.opensolaris.org/os/licensing.
11 # See the License for the specific language governing permissions
12 # and limitations under the License.
14 # When distributing Covered Code, include this CDDL HEADER in each
15 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 # If applicable, add the following below this CDDL HEADER, with the
17 # fields enclosed by brackets "[]" replaced with your own identifying
18 # information: Portions Copyright [yyyy] [name of copyright owner]
20 # CDDL HEADER END
24 # Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
25 # Copyright 2011 Nexenta Systems, Inc. All rights reserved.
27 # Uses supplied "env" file, based on /opt/onbld/etc/env, to set shell variables
28 # before spawning a shell for doing a release-style builds interactively
29 # and incrementally.
32 function fatal_error
34 print -u2 "${progname}: $*"
35 exit 1
38 function usage
40 OPTIND=0
41 getopts -a "${progname}" "${USAGE}" OPT '-?'
42 exit 2
45 typeset -r USAGE=$'+
46 [-?\n@(#)\$Id: bldenv (OS/Net) 2008-04-06 \$\n]
47 [-author?OS/Net community <tools-discuss@opensolaris.org>]
48 [+NAME?bldenv - spawn shell for interactive incremental OS-Net
49 consolidation builds]
50 [+DESCRIPTION?bldenv is a useful companion to the nightly(1) script for
51 doing interactive and incremental builds in a workspace
52 already built with nightly(1). bldenv spawns a shell set up
53 with the same environment variables taken from an env_file,
54 as prepared for use with nightly(1).]
55 [+?In addition to running a shell for interactive use, bldenv
56 can optionally run a single command in the given environment,
57 in the vein of sh -c or su -c. This is useful for
58 scripting, when an interactive shell would not be. If the
59 command is composed of multiple shell words or contains
60 other shell metacharacters, it must be quoted appropriately.]
61 [+?bldenv is particularly useful for testing Makefile targets
62 like clobber, install and _msg, which otherwise require digging
63 through large build logs to figure out what is being
64 done.]
65 [+?By default, bldenv will invoke the shell specified in
66 $SHELL. If $SHELL is not set or is invalid, csh will be
67 used.]
68 [c?force the use of csh, regardless of the value of $SHELL.]
69 [f?invoke csh with the -f (fast-start) option. This option is valid
70 only if $SHELL is unset or if it points to csh.]
71 [d?set up environment for doing DEBUG builds (default is non-DEBUG)]
72 [t?set up environment to use the tools in usr/src/tools (this is the
73 default, use +t to use the tools from /opt/onbld)]
75 <env_file> [command]
77 [+EXAMPLES]{
78 [+?Example 1: Interactive use]{
79 [+?Use bldenv to spawn a shell to perform a DEBUG build and
80 testing of the Makefile targets clobber and install for
81 usr/src/cmd/true.]
82 [+\n% rlogin wopr-2 -l gk
83 {root::wopr-2::49} bldenv -d /export0/jg/on10-se.env
84 Build type is DEBUG
85 RELEASE is 5.10
86 VERSION is wopr-2::on10-se::11/01/2001
87 RELEASE_DATE is May 2004
88 The top-level `setup\' target is available to build headers
89 and tools.
90 Using /usr/bin/tcsh as shell.
91 {root::wopr-2::49}
92 {root::wopr-2::49} cd $SRC/cmd/true
93 {root::wopr-2::50} make
94 {root::wopr-2::51} make clobber
95 /usr/bin/rm -f true true.po
96 {root::wopr-2::52} make
97 /usr/bin/rm -f true
98 cat true.sh > true
99 chmod +x true
100 {root::wopr-2::53} make install
101 install -s -m 0555 -u root -g bin -f /export0/jg/on10-se/proto/root_sparc/usr/bin true
102 `install\' is up to date.]
104 [+?Example 2: Non-interactive use]{
105 [+?Invoke bldenv to create SUNWonbld with a single command:]
106 [+\nexample% bldenv onnv_06 \'cd $SRC/tools && make pkg\']
109 [+SEE ALSO?\bnightly\b(1)]
112 # main
113 builtin basename
115 # boolean flags (true/false)
116 typeset flags=(
117 typeset c=false
118 typeset f=false
119 typeset d=false
120 typeset O=false
121 typeset o=false
122 typeset t=true
123 typeset s=(
124 typeset e=false
125 typeset h=false
126 typeset d=false
127 typeset o=false
131 typeset progname="$(basename -- "${0}")"
133 OPTIND=1
134 SUFFIX="-nd"
136 while getopts -a "${progname}" "${USAGE}" OPT ; do
137 case ${OPT} in
138 c) flags.c=true ;;
139 +c) flags.c=false ;;
140 f) flags.f=true ;;
141 +f) flags.f=false ;;
142 d) flags.d=true SUFFIX="" ;;
143 +d) flags.d=false SUFFIX="-nd" ;;
144 t) flags.t=true ;;
145 +t) flags.t=false ;;
146 \?) usage ;;
147 esac
148 done
149 shift $((OPTIND-1))
151 # test that the path to the environment-setting file was given
152 if (( $# < 1 )) ; then
153 usage
156 # force locale to C
157 export \
158 LANG=C \
159 LC_ALL=C \
160 LC_COLLATE=C \
161 LC_CTYPE=C \
162 LC_MESSAGES=C \
163 LC_MONETARY=C \
164 LC_NUMERIC=C \
165 LC_TIME=C
167 # clear environment variables we know to be bad for the build
168 unset \
169 LD_OPTIONS \
170 LD_LIBRARY_PATH \
171 LD_AUDIT \
172 LD_BIND_NOW \
173 LD_BREADTH \
174 LD_CONFIG \
175 LD_DEBUG \
176 LD_FLAGS \
177 LD_LIBRARY_PATH_64 \
178 LD_NOVERSION \
179 LD_ORIGIN \
180 LD_LOADFLTR \
181 LD_NOAUXFLTR \
182 LD_NOCONFIG \
183 LD_NODIRCONFIG \
184 LD_NOOBJALTER \
185 LD_PRELOAD \
186 LD_PROFILE \
187 CONFIG \
188 GROUP \
189 OWNER \
190 REMOTE \
191 ENV \
192 ARCH \
193 CLASSPATH
196 # Setup environment variables
198 if [[ -f /etc/nightly.conf ]]; then
199 source /etc/nightly.conf
202 if [[ -f "$1" ]]; then
203 if [[ "$1" == */* ]]; then
204 source "$1"
205 else
206 source "./$1"
208 else
209 if [[ -f "/opt/onbld/env/$1" ]]; then
210 source "/opt/onbld/env/$1"
211 else
212 printf \
213 'Cannot find env file as either %s or /opt/onbld/env/%s\n' \
214 "$1" "$1"
215 exit 1
218 shift
220 # contents of stdenv.sh inserted after next line:
221 # STDENV_START
222 # STDENV_END
224 # Check if we have sufficient data to continue...
225 [[ -v CODEMGR_WS ]] || fatal_error "Error: Variable CODEMGR_WS not set."
226 [[ -d "${CODEMGR_WS}" ]] || fatal_error "Error: ${CODEMGR_WS} is not a directory."
227 [[ -f "${CODEMGR_WS}/usr/src/Makefile" ]] || fatal_error "Error: ${CODEMGR_WS}/usr/src/Makefile not found."
229 # must match the getopts in nightly.sh
230 OPTIND=1
231 NIGHTLY_OPTIONS="-${NIGHTLY_OPTIONS#-}"
232 while getopts '+0ABCDdFfGIilMmNnpRrtUuwW' FLAG "$NIGHTLY_OPTIONS"
234 case "$FLAG" in
235 t) flags.t=true ;;
236 +t) flags.t=false ;;
237 *) ;;
238 esac
239 done
241 POUND_SIGN="#"
242 # have we set RELEASE_DATE in our env file?
243 if [ -z "$RELEASE_DATE" ]; then
244 RELEASE_DATE=$(LC_ALL=C date +"%B %Y")
246 BUILD_DATE=$(LC_ALL=C date +%Y-%b-%d)
247 BASEWSDIR=$(basename -- "${CODEMGR_WS}")
248 DEV_CM="\"@(#)SunOS Internal Development: $LOGNAME $BUILD_DATE [$BASEWSDIR]\""
249 export DEV_CM RELEASE_DATE POUND_SIGN
251 print 'Build type is \c'
252 if ${flags.d} ; then
253 print 'DEBUG'
254 unset RELEASE_BUILD
255 unset EXTRA_OPTIONS
256 unset EXTRA_CFLAGS
257 else
258 # default is a non-DEBUG build
259 print 'non-DEBUG'
260 export RELEASE_BUILD=
261 unset EXTRA_OPTIONS
262 unset EXTRA_CFLAGS
265 # update build-type variables
266 PKGARCHIVE="${PKGARCHIVE}${SUFFIX}"
268 # Set PATH for a build
269 PATH="/opt/onbld/bin:/opt/onbld/bin/${MACH}:/opt/SUNWspro/bin:/usr/ccs/bin:/usr/bin:/usr/sbin:/usr/ucb:/usr/etc:/usr/openwin/bin:/usr/sfw/bin:/opt/sfw/bin:."
270 if [[ "${SUNWSPRO}" != "" ]]; then
271 export PATH="${SUNWSPRO}/bin:$PATH"
274 if [[ -n "${MAKE}" ]]; then
275 if [[ -x "${MAKE}" ]]; then
276 export PATH="$(dirname -- "${MAKE}"):$PATH"
277 else
278 print "\$MAKE (${MAKE}) is not a valid executible"
279 exit 1
283 TOOLS="${SRC}/tools"
284 TOOLS_PROTO="${TOOLS}/proto/root_${MACH}-nd" ; export TOOLS_PROTO
286 if "${flags.t}" ; then
287 export ONBLD_TOOLS="${ONBLD_TOOLS:=${TOOLS_PROTO}/opt/onbld}"
289 export STABS="${TOOLS_PROTO}/opt/onbld/bin/${MACH}/stabs"
290 export CTFSTABS="${TOOLS_PROTO}/opt/onbld/bin/${MACH}/ctfstabs"
291 export GENOFFSETS="${TOOLS_PROTO}/opt/onbld/bin/genoffsets"
293 export CTFCONVERT="${TOOLS_PROTO}/opt/onbld/bin/${MACH}/ctfconvert"
294 export CTFMERGE="${TOOLS_PROTO}/opt/onbld/bin/${MACH}/ctfmerge"
296 export CTFCVTPTBL="${TOOLS_PROTO}/opt/onbld/bin/ctfcvtptbl"
297 export CTFFINDMOD="${TOOLS_PROTO}/opt/onbld/bin/ctffindmod"
299 PATH="${TOOLS_PROTO}/opt/onbld/bin/${MACH}:${PATH}"
300 PATH="${TOOLS_PROTO}/opt/onbld/bin:${PATH}"
301 export PATH
304 export DMAKE_MODE=${DMAKE_MODE:-parallel}
306 DEF_STRIPFLAG="-s"
308 TMPDIR="/tmp"
310 export \
311 PATH TMPDIR \
312 POUND_SIGN \
313 DEF_STRIPFLAG \
314 RELEASE_DATE
315 unset \
316 CFLAGS \
317 LD_LIBRARY_PATH
319 # a la ws
320 ENVLDLIBS1=
321 ENVLDLIBS2=
322 ENVLDLIBS3=
323 ENVCPPFLAGS1=
324 ENVCPPFLAGS2=
325 ENVCPPFLAGS3=
326 ENVCPPFLAGS4=
327 PARENT_ROOT=
328 PARENT_TOOLS_ROOT=
330 if [[ "$MULTI_PROTO" != "yes" && "$MULTI_PROTO" != "no" ]]; then
331 printf \
332 'WARNING: invalid value for MULTI_PROTO (%s); setting to "no".\n' \
333 "$MULTI_PROTO"
334 export MULTI_PROTO="no"
337 [[ "$MULTI_PROTO" == "yes" ]] && export ROOT="${ROOT}${SUFFIX}"
339 ENVLDLIBS1="-L$ROOT/lib -L$ROOT/usr/lib"
340 ENVCPPFLAGS1="-I$ROOT/usr/include"
341 MAKEFLAGS=e
343 export \
344 ENVLDLIBS1 \
345 ENVLDLIBS2 \
346 ENVLDLIBS3 \
347 ENVCPPFLAGS1 \
348 ENVCPPFLAGS2 \
349 ENVCPPFLAGS3 \
350 ENVCPPFLAGS4 \
351 MAKEFLAGS \
352 PARENT_ROOT \
353 PARENT_TOOLS_ROOT
355 printf 'RELEASE is %s\n' "$RELEASE"
356 printf 'VERSION is %s\n' "$VERSION"
357 printf 'RELEASE_DATE is %s\n\n' "$RELEASE_DATE"
359 if [[ -f "$SRC/Makefile" ]] && egrep -s '^setup:' "$SRC/Makefile" ; then
360 print "The top-level 'setup' target is available \c"
361 print "to build headers and tools."
362 print ""
364 elif "${flags.t}" ; then
365 printf \
366 'The tools can be (re)built with the install target in %s.\n\n' \
367 "${TOOLS}"
371 # place ourselves in a new task, respecting BUILD_PROJECT if set.
373 /usr/bin/newtask -c $$ ${BUILD_PROJECT:+-p$BUILD_PROJECT}
375 if [[ "${flags.c}" == "false" && -x "$SHELL" && \
376 "$(basename -- "${SHELL}")" != "csh" ]]; then
377 # $SHELL is set, and it's not csh.
379 if "${flags.f}" ; then
380 print 'WARNING: -f is ignored when $SHELL is not csh'
383 printf 'Using %s as shell.\n' "$SHELL"
384 exec "$SHELL" ${@:+-c "$@"}
386 elif "${flags.f}" ; then
387 print 'Using csh -f as shell.'
388 exec csh -f ${@:+-c "$@"}
390 else
391 print 'Using csh as shell.'
392 exec csh ${@:+-c "$@"}
395 # not reached