2007-03-18: ksh93 add-on tarballs for OpenSolaris

2007-03-18: ksh93 add-on tarballs for OpenSolaris

These tarballs are intended to be installed over an existing OpenSolaris i386 or SPARC installation and provide ksh93s_final_20070111 for testing and evaluation purposed ONLY.Please report any problems/errors/bugs/comments to the ksh93-integration project bugzilla or the ksh93-integration mailinglist (please subscribe before posting).

Install instructions:

1. Download the tarball:
   1* i386/AMD64: ksh93_integration_20070318_snapshot_i386.tar.bz2 (list files)
   1* SPARC: ksh93_integration_20070318_snapshot_sparc.tar.bz2 (list files)
2. Verify the MD5 checksum:
   1* i386/AMD64: MD5(ksh93_integration_20070318_snapshot_i386.tar.bz2)= 1df38f1ade798a3fbff4f1250a8a211b
   1* SPARC: MD5(ksh93_integration_20070318_snapshot_sparc.tar.bz2)= 2a594b17b22844443aef2154a164d020
3. Login as user "root":
4. Change directory to / and unpack the tarball with /usr/bin/tar using the "xvof" option ("o" is very important to set the file ownership to "root")

Example for i386/AMD64:

  $ cd /tmp
  $ wget http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20070318_snapshot_i386.tar.bz2
  $ /usr/sfw/bin/openssl md5 ksh93_integration_20070318_snapshot_i386.tar.bz2
  MD5(ksh93_integration_20070318_snapshot_i386.tar.bz2)= 1df38f1ade798a3fbff4f1250a8a211b
  # cd /
  # sync ; sync
  # bzcat </tmp/ksh93_integration_20070318_snapshot_i386.tar.bz2 | tar -xvof -
  # sync ; sync

Example for SPARC:

  $ cd /tmp
  $ wget http://www.opensolaris.org/os/project/ksh93-integration/downloads/ksh93_integration_20070318_snapshot_sparc.tar.bz2
  $ /usr/sfw/bin/openssl md5 ksh93_integration_20070318_snapshot_sparc.tar.bz2
  MD5(ksh93_integration_20070318_snapshot_sparc.tar.bz2)= 2a594b17b22844443aef2154a164d020
  # cd /
  # sync ; sync
  # bzcat </tmp/ksh93_integration_20070318_snapshot_sparc.tar.bz2 | tar -xvof -
  # sync ; sync

Notes:

• This tarball matches ksh93s_final (=ast-ksh.2007-01-11) with many many changes since the last version. Please test the binaries extensively.
• The diffs between Solaris Nevada B51 and the current ksh93-integration tree can be obtained via
  svn diff -r 500:647 svn://svn.genunix.org/on/branches/ksh93/gisburn/prototype004/usr or as unified diff (12MB, MD5 checksum is 0ea00a2f410f742ed8c99321f26d2842).
• 64bit binaries and libraries are now included (and used by default if the hardware is 64bit capable)
• AST l10n utilities are stored in /usr/ast/bin/.
• If you wish to use ksh93 as login shell you have to create the file /etc/shells (see shells(4) manual page) to include it in the list of "allowed" system login shells:
   Example /etc/shells file (created using $ cat usr/src/lib/libc/port/gen/getusershell.c | egrep '.*".*/(bin|sbin)/.*".*' | sed 's/[",]//g' | sort -u #):

{{code}}/bin/bash
/bin/csh
/bin/jsh
/bin/ksh
/bin/ksh93
/bin/pfcsh
/bin/pfksh
/bin/pfsh
/bin/sh
/bin/tcsh
/bin/zsh
/sbin/jsh
/sbin/pfsh
/sbin/sh
/usr/bin/bash
/usr/bin/csh
/usr/bin/jsh
/usr/bin/ksh
/usr/bin/ksh93
/usr/bin/pfcsh
/usr/bin/pfksh
/usr/bin/pfsh
/usr/bin/sh
/usr/bin/tcsh
/usr/bin/zsh
/usr/sfw/bin/zsh
/usr/xpg4/bin/sh
{{/code}}

• libcmd.so is replaced with a version which includes both the ksh93 builtin commands and the private Solaris API of previous libcmd versions.
• The tarball was simply created from an OS/Net B51 proto/ subdir via collecting the files listed by $ find $ROOT '!' -type d | sed 's/.*\/root_sparc\///' | egrep "/(lib|llib-l)(cmd|ast|shell|dll|pp)|/(ksh|rksh|pfksh)|include/ast|usr/ast/" | egrep -v cmdutils | sort #.
• The tarballs do not provide a manual page for ksh93. Please use the manual page for ksh93r in the meantime.
• "multiline" input mode was temporary disabled in the default configuration due small issues.
• The ksh93 binaries can be build from source like this:
  (Instructions are for Solaris i386/AMD64; SPARC requires minor adjustments)
  1. Pull sources and extract closed bin stuff (files can be obtained from opensolaris.org):
      $ mkdir test_x86 ; cd test_x86
      $ svn checkout -r 647 svn://svn.genunix.org/on/branches/ksh93/gisburn/prototype004/usr
      $ bzcat <../download/on-closed-bins-b51.i386.tar.bz2 | tar -xf -
      $ cd .. 
  2. Create opensolaris.sh.
      This is the usual opensolaris.sh with the paths adjusted to match your location of the sources.
      Example for the changes applies to opensolaris.sh (for my workspace):

~--- ./test1_x86/usr/src/tools/env/opensolaris.sh        Thu Sep 14 13:17:59 2006
+++ ./opensolaris.sh    Sun Jul 30 00:50:08 2006
@@ -43,10 +43,10 @@
 # This is a variable for the rest of the script - GATE doesn't matter to
 # nightly itself
-GATE=testws;                   export GATE
+GATE=test1_x86;                        export GATE
 # CODEMGR_WS - where is your workspace at (or what should nightly name it)
-CODEMGR_WS="/export/$GATE";                    export CODEMGR_WS
+CODEMGR_WS="/home/test001/ksh93/on_build1/$GATE";                      export CODEMGR_WS
 # Location of encumbered binaries.
 ON_CLOSED_BINS="$CODEMGR_WS/closed";           export ON_CLOSED_BINS

• 1. Run "bldenv":
      $ env - SHELL=$SHELL TERM=$TERM HOME=$HOME LOGNAME=$LOGNAME DISPLAY=$DISPLAY LANG=C LC_ALL=C PAGER=less MANPATH=$MANPATH /opt/onbld/bin/bldenv opensolaris.sh #
  2. Build it (the quick way):
      $ cd test_x86/usr/src
      $ time nice make setup 2>&1 | tee -a buildlog_setup.log
      $ time nice dmake install >buildlog.log 2>&1