summaryrefslogtreecommitdiff
path: root/usr/src/lib/libshell/misc/buildksh93.readme
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/lib/libshell/misc/buildksh93.readme')
-rw-r--r--usr/src/lib/libshell/misc/buildksh93.readme74
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.