Cross Reference: /illumos-gate/usr/src/lib/libshell/common/tests/

README.tests
#### ksh93 test suite

## Intro
The directory /usr/demo/ksh/tests/ contains the ksh93 test suite
which is used to verify the correct behaviour of ksh93.

The test suite is split into modules with the ending *.sh
and a frontend called "shtests" which is used to run the tests.


## Basic description:
/usr/demo/ksh/tests/shtests <options> <varname=value> <testmodule>

<options> may be:
    -a execute test module one time as normal script code
       and a 2nd time as compiled shell script. The env
       variable SHCOMP defines the version of the shell
       compiler being used (default is "${SHELL%/*}/shcomp",
       however it is recommended to explicitly set SHCOMP
       to /usr/bin/shcomp).
    -c execute test module as compiled shell script
    -s execute test module as normal shell script
    -t do not print timing information
    -v use VMDEBUG
<varname=value>
    Sets one or more environment variables to value "value".
<testmodule>
    file name of test module


## Basic usage in Solaris >= 11 and OpenSolaris/Indiana:
The tests can be executed like this:
$ export SHELL=<path-to-ksh93-executable>
$ export SHCOMP=/usr/bin/shcomp
for t in /usr/demo/ksh/tests/*.sh ; do
    $SHELL /usr/demo/ksh/tests/shtests -a "$t"
done

Note that you MUST NOT use "/usr/bin/ksh93" as value for
SHELL since /usr/bin/ksh93 on Solaris is a wrapper which
selects a suitable executable in /usr/bin/<isa>/ksh93
based on the hardware capabilities defined via /usr/bin/isalist

Valid values for SHELL are:
- SHELL=/usr/bin/i86/ksh93      # 32bit i386
- SHELL=/usr/bin/amd64/ksh93    # 64bit AMD64
- SHELL=/usr/bin/sparcv7/ksh93  # 32bit SPARC
- SHELL=/usr/bin/sparcv9/ksh93  # 64bit SPARC
- SHELL=/usr/bin/s390/ksh93     # 32bit SystemZ
- SHELL=/usr/bin/s390x/ksh93    # 64bit SystemZ

# EOF.
Name	Date	Size
..	2010-04-03 18:48:44	26
alias.sh	2010-04-03 18:48:44	3.7 KiB
append.sh	2010-04-03 18:48:44	2.8 KiB
arith.sh	2010-04-03 18:48:44	16 KiB
arrays.sh	2010-04-03 18:48:44	14.6 KiB
arrays2.sh	2010-04-03 18:48:44	4 KiB
attributes.sh	2010-04-03 18:48:44	11 KiB
basic.sh	2010-04-03 18:48:44	14.5 KiB
bracket.sh	2010-04-03 18:48:44	10.3 KiB
builtins.sh	2010-04-03 18:48:44	17.5 KiB
case.sh	2010-04-03 18:48:44	2.4 KiB
comvar.sh	2010-04-03 18:48:44	15.1 KiB
coprocess.sh	2010-04-03 18:48:44	7.2 KiB
cubetype.sh	2010-04-03 18:48:44	8.5 KiB
enum.sh	2010-04-03 18:48:44	2.8 KiB
exit.sh	2010-04-03 18:48:44	2.8 KiB
expand.sh	2010-04-03 18:48:44	5 KiB
functions.sh	2010-04-03 18:48:44	36.8 KiB
glob.sh	2010-04-03 18:48:44	10.8 KiB
grep.sh	2010-04-03 18:48:44	3.3 KiB
heredoc.sh	2010-04-03 18:48:44	8.4 KiB
io.sh	2010-04-03 18:48:44	14 KiB
nameref.sh	2010-04-03 18:48:44	9.6 KiB
options.sh	2010-04-03 18:48:44	17.1 KiB
path.sh	2010-04-03 18:48:44	11 KiB
pointtype.sh	2010-04-03 18:48:44	4.9 KiB
quoting.sh	2010-04-03 18:48:44	13.1 KiB
quoting2.sh	2010-04-03 18:48:44	6.8 KiB
README.tests	2009-10-28 18:36:39	1.8 KiB
recttype.sh	2010-04-03 18:48:44	2.3 KiB
restricted.sh	2010-04-03 18:48:44	3.7 KiB
return.sh	2010-04-03 18:48:44	4.3 KiB
select.sh	2010-04-03 18:48:44	2.1 KiB
shtests	2010-04-03 18:48:44	3.1 KiB
sigchld.sh	2010-04-03 18:48:44	4 KiB
signal.sh	2010-04-03 18:48:44	8.3 KiB
statics.sh	2010-04-03 18:48:44	3.9 KiB
subshell.sh	2010-04-03 18:48:44	12.3 KiB
substring.sh	2010-04-03 18:48:44	19.4 KiB
sun_solaris_array_default_datatype.sh	2010-04-03 18:48:44	12.6 KiB
sun_solaris_builtin_poll.sh	2009-10-28 18:36:39	2.4 KiB
sun_solaris_builtin_sum.sh	2010-04-03 18:48:44	5.5 KiB
sun_solaris_builtin_tail.sh	2010-04-03 18:48:44	11.8 KiB
sun_solaris_command_substitution.sh	2010-04-03 18:48:44	11.5 KiB
sun_solaris_compound_misc.sh	2010-04-03 18:48:44	6.1 KiB
sun_solaris_compound_nameref.sh	2010-04-03 18:48:44	4.5 KiB
sun_solaris_compoundvario.sh	2010-04-03 18:48:44	9.9 KiB
sun_solaris_cr_6687139_command_substitution_exec_redirection_allocation_loop.sh	2010-04-03 18:48:44	5.7 KiB
sun_solaris_cr_6713682_compound_var_bleeds_through_subshell.sh	2010-04-03 18:48:44	5.4 KiB
sun_solaris_cr_6722134_background_CHLD_trap.sh	2010-04-03 18:48:44	3.4 KiB
sun_solaris_cr_6753538_subshell_leaks_umask.sh	2010-04-03 18:48:44	3 KiB
sun_solaris_cr_6754020_weird_square_bracket_expansion.sh	2010-04-03 18:48:44	2.1 KiB
sun_solaris_cr_6763594_command_failure_execs_twice.sh	2010-04-03 18:48:44	3 KiB
sun_solaris_cr_6766246_pattern_matching_bug.sh	2010-04-03 18:48:44	5.2 KiB
sun_solaris_cr_6769332_substitutions_terminate_shell_after_257_iterations.sh	2010-04-03 18:48:44	3.1 KiB
sun_solaris_cr_6777491_lacks_arithmetric_function_iszero.sh	2010-04-03 18:48:44	2.7 KiB
sun_solaris_cr_6778077_sigthaw_trap.sh	2010-04-03 18:48:44	2.6 KiB
sun_solaris_cr_6789247_printf_hexfloat_rounding.sh	2010-04-03 18:48:44	3.8 KiB
sun_solaris_cr_6800929_large_command_substitution_hang.sh	2010-04-03 18:48:44	7.4 KiB
sun_solaris_cr_6805792_varmovetest1.sh	2010-04-03 18:48:44	3.4 KiB
sun_solaris_cr_6805794_character_to_wchar_not_working.sh	2010-04-03 18:48:44	2.8 KiB
sun_solaris_cr_6805795_negative_zero.sh	2010-04-03 18:48:44	3.8 KiB
sun_solaris_cr_6807179_shellpattern_uses_getpwnam.sh	2010-04-03 18:48:44	3.5 KiB
sun_solaris_cr_6835835_builtin_cat_n_broken.sh	2010-04-03 18:48:44	4.2 KiB
sun_solaris_cr_6848486_echo_test_with_test_undefined_executes_test_builtin.sh	2010-04-03 18:48:44	3.2 KiB
sun_solaris_cr_6855875_typeset_hexfloat_has_too_few_digits.sh	2010-04-03 18:48:44	4.5 KiB
sun_solaris_cr_6862121_shbinexec_kernel_module_defunct.sh	2010-04-03 18:48:44	3.3 KiB
sun_solaris_cr_6881017_background_process_in_subshell_hangs_caller.sh	2010-04-03 18:48:44	2.5 KiB
sun_solaris_cr_6887363_shell_sometimes_mishandles_return_value_of_its_child_process.sh	2010-04-03 18:48:44	4.4 KiB
sun_solaris_cr_6904557_wc_no_longer_counts_number_of_bytes_correctly.sh	2010-04-03 18:48:44	5.1 KiB
sun_solaris_cr_6904575_cut_-d_with_multibyte_character_no_longer_works.sh	2010-04-03 18:48:44	5.1 KiB
sun_solaris_cr_6904878_join_-t_no_longer_works_with_multibyte_char_separator.sh	2010-04-03 18:48:44	5.1 KiB
sun_solaris_cr_6907460_EXIT_trap_handlers_are_sometimes_executed_twice.sh	2010-04-03 18:48:44	4.5 KiB
sun_solaris_cr_xxxxxxxx_template.sh	2010-04-03 18:48:44	1.6 KiB
sun_solaris_getconf.sh	2010-04-03 18:48:44	5.4 KiB
sun_solaris_local_compound_nameref001.sh	2009-10-28 18:36:39	1.4 KiB
sun_solaris_locale_misc.sh	2010-04-03 18:48:44	5.4 KiB
sun_solaris_staticvariables.sh	2010-04-03 18:48:44	3.4 KiB
sun_solaris_vartree001.sh	2010-04-03 18:48:44	5.6 KiB
sun_solaris_vartree002.sh	2010-04-03 18:48:44	11.4 KiB
sun_solaris_vartree003.sh	2010-04-03 18:48:44	5.6 KiB
tilde.sh	2010-04-03 18:48:44	2.9 KiB
timetype.sh	2010-04-03 18:48:44	3.5 KiB
treemove.sh	2009-10-28 18:36:39	2.1 KiB
types.sh	2010-04-03 18:48:44	9.7 KiB
variables.sh	2010-04-03 18:48:44	16.1 KiB
vartree1.sh	2010-04-03 18:48:44	6.4 KiB
vartree2.sh	2010-04-03 18:48:44	10.7 KiB