Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022

dejagnu (1)


dejagnu - DejaGnu auxiliary command launcher


dejagnu <command> [--help | options...]
dejagnu --help
dejagnu --version


DEJAGNU(1)                  User's Reference Manual                 DEJAGNU(1)

     dejagnu -- DejaGnu auxiliary command launcher

     dejagnu <command> [--help | options...]
     dejagnu --help
     dejagnu --version

     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.

     --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

     All arguments after the command name are passed to the invoked command.

     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

     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

     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.

     $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





     See attributes(7) for descriptions of the following attributes:

     |Availability   | developer/test/dejagnu |
     |Stability      | Uncommitted            |

     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.

     Jacob Bachmeyer

     The command name must precede all other arguments due to limitations of
     the shell.

     Source code for open source software components in Oracle Solaris can be
     found at https://www.oracle.com/downloads/opensource/solaris-source-code-

     This software was built from source available at https://github.com/ora-
     cle/solaris-userland.  The original community source was downloaded from

     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