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 command 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 considered a superset of Tcl,
       allowing the former to be used to run scripts written  for  the  latter.   This  means  that,  while  Awk
       programs  will  generally  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

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.

GNU                                             December 17, 2018                                     DEJAGNU(1)