dejagnu - DejaGnu auxiliary command launcher
dejagnu <command> [--help | options...] dejagnu --help dejagnu --version
DEJAGNU(1) User's Reference Manual DEJAGNU(1)
NAME
dejagnu -- DejaGnu auxiliary command launcher
SYNOPSIS
dejagnu <command> [--help | options...]
dejagnu --help
dejagnu --version
DESCRIPTION
The dejagnu command finds a script that implements the requested command,
selects from multiple implementations if available according to a fixed
internal list, and executes the command.
OPTIONS
--help Print a help message instead of running a command. If no com-
mand is given, prints brief usage for dejagnu itself.
-V, --version
Print a version banner for the launcher itself including the
version of DejaGnu. Any command given is ignored.
-v, --verbose
Emit additional output describing the operation of the dejagnu
launcher itself. This option is also passed on to the invoked
command.
All arguments after the command name are passed to the invoked command.
ENVIRONMENT
DEJAGNULIBS If set, the location of DejaGnu's library in the filesystem.
The search described in FILES does not happen if DEJAGNULIBS
is set.
AWK Full file name for an Awk interpreter that may or may not
actually be GNU Awk. If not set, PATH will be searched for
an awk program. If the Awk interpreter is actually GNU Awk,
the --posix option will be given if an Awk implementation is
used.
GAWK Full file name for GNU Awk. If not set, PATH will be
searched for a gawk program.
BASH Full file name for GNU Bash. If not set, PATH will be
searched for a bash program. Note that Bash itself sets
this variable, even when run as sh, even when running a
script.
EXPECT Full file name for Expect, which is a Tcl interpreter with
the Expect extension already loaded. If not set, PATH will
be searched for an expect program. Note that the DejaGnu
core is written in Expect, so this interpreter should always
be available.
TCLSH Full file name for a Tcl interpreter. If not set, PATH will
be searched for a tclsh program.
Note that GNU Awk is considered a superset of Awk and that Expect is con-
sidered a superset of Tcl, allowing the former to be used to run scripts
written for the latter. This means that, while Awk programs will gener-
ally be run with GNU extensions disabled using the --posix option to GNU
Awk, Tcl programs may be run with either tclsh or expect and should be
written accordingly.
FILES
$DEJAGNULIBS/commands If DEJAGNULIBS is set, all command scripts are
expected to be in this directory.
Otherwise, the first directory that actually exists in the following list
is used, where @bindir@ represents the directory containing dejagnu
itself.
@bindir@/../share/dejagnu/commands
@bindir@/../../share/dejagnu/commands
/usr/share/dejagnu/commands
/usr/local/share/dejagnu/commands
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------------+
|Availability | developer/test/dejagnu |
+---------------+------------------------+
|Stability | Uncommitted |
+---------------+------------------------+
SEE ALSO
The full documentation for DejaGnu is maintained as a Texinfo manual. If
the info program is properly installed at your site, the command info
dejagnu should give you access to the complete manual.
AUTHORS
Jacob Bachmeyer
BUGS
The command name must precede all other arguments due to limitations of
the shell.
NOTES
Source code for open source software components in Oracle Solaris can be
found at https://www.oracle.com/downloads/opensource/solaris-source-code-
downloads.html.
This software was built from source available at https://github.com/ora-
cle/solaris-userland. The original community source was downloaded from
https://ftp.gnu.org/gnu/dejagnu/dejagnu-1.6.3.tar.gz.
Further information about this software can be found on the open source
community website at https://www.gnu.org/software/dejagnu.
GNU December 17, 2018 GNU