diff options
Diffstat (limited to 'usr/src/lib/libshell/misc/buildksh93.readme')
-rw-r--r-- | usr/src/lib/libshell/misc/buildksh93.readme | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/usr/src/lib/libshell/misc/buildksh93.readme b/usr/src/lib/libshell/misc/buildksh93.readme new file mode 100644 index 0000000000..f221b17a4e --- /dev/null +++ b/usr/src/lib/libshell/misc/buildksh93.readme @@ -0,0 +1,74 @@ +# +# CDDL HEADER START +# +# The contents of this file are subject to the terms of the +# Common Development and Distribution License (the "License"). +# You may not use this file except in compliance with the License. +# +# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE +# or http://www.opensolaris.org/os/licensing. +# See the License for the specific language governing permissions +# and limitations under the License. +# +# When distributing Covered Code, include this CDDL HEADER in each +# file and include the License file at usr/src/OPENSOLARIS.LICENSE. +# If applicable, add the following below this CDDL HEADER, with the +# fields enclosed by brackets "[]" replaced with your own identifying +# information: Portions Copyright [yyyy] [name of copyright owner] +# +# CDDL HEADER END +# +# Copyright 2007 Sun Microsystems, Inc. All rights reserved. +# Use is subject to license terms. +# +# ident "%Z%%M% %I% %E% SMI" +# + +# +# buildksh93.readme +# + +* Intro: +"buildksh93.ksh" is a small build script used to build the AT&T "ast-ksh" +and "ast-open" packages using its native (nmake-based) build system +which is needed to build the iffe-generated (header) files (each time +for { 32bit SPARC, 64bit SPARC, 32bit i386, 64bit AMD64 }) which are +moved later to their matching OS/Net build directories. + + +* Note that buildksh93.ksh modifies the build behaviour of the AST build +system, including enforcing C99/XPG6 semantics (which is MANDATORY!!) +and feeding additional libraries (like libnsl, libsocket, librt etc.) +to the feature look system (called "iffe" (="if feature exists")) to +ensure all features needed for the Solaris version of ksh93 are +properly found. + + +* Example usage of the script (more information can be found in the +script itself): +## Download AT&T ksh93 sources +$ wget --http-user="I accept www.opensource.org/licenses/cpl" --http-passwd="." 'http://www.research.att.com/sw/download/beta/INIT.2007-04-18.tgz' +$ wget --http-user="I accept www.opensource.org/licenses/cpl" --http-passwd="." 'http://www.research.att.com/sw/download/beta/ast-ksh.2007-04-18.tgz' + +## Unpack the sources (32bit SPARC): +$ mkdir build32_sparc +$ cd build32_sparc +$ gunzip -c ../INIT.2007-03-28.tgz | tar -xf - +$ gunzip -c ../ast-ksh.2007-03-28.tgz | tar -xf - + +## Build ast-ksh for 32bit SPARC (build other build flags are: +# - "build.solaris.sparc.32bit.suncc" - 32bit SPARC +# - "build.solaris.sparc.64bit.suncc" - 64bit SPARC +# - "build.solaris.i386.32bit.suncc" - 32bit x86/i386 +# - "build.solaris.i386.64bit.suncc" - 64bit x86/AMD64 +# ) +$ time nice ksh ../buildksh93.ksh "build.solaris.sparc.32bit.suncc" 2>&1 | tee -a buildlog.log + +## Test ksh93 +$ time nice ksh ../buildksh93.ksh "testshell" 2>&1 | tee -a buildlog.log + +## Generated binaries and headers can be found in the arch/$(PLATFORM)/ +## subdirectory. + + +# EOF. |