dejagnu(1)

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

NAME

4     dejagnu — DejaGnu auxiliary command launcher
5

SYNOPSIS

7     dejagnu ⟨command⟩ [--help | options...]
8     dejagnu --help
9     dejagnu --version
10

DESCRIPTION

12     The dejagnu command finds a script that implements the requested command,
13     selects from multiple implementations if available according to a fixed
14     internal list, and executes the command.
15

OPTIONS

17     --help     Print a help message instead of running a command.  If no com‐
18                mand is given, prints brief usage for dejagnu itself.
19
20     -V, --version
21                Print a version banner for the launcher itself including the
22                version of DejaGnu.  Any command given is ignored.
23
24     -v, --verbose
25                Emit additional output describing the operation of the dejagnu
26                launcher itself.  This option is also passed on to the invoked
27                command.
28
29     All arguments after the command name are passed to the invoked command.
30

ENVIRONMENT

32     DEJAGNULIBS  If set, the location of DejaGnu's library in the filesystem.
33                  The search described in FILES does not happen if DEJAGNULIBS
34                  is set.
35
36     AWK          Full file name for an Awk interpreter that may or may not
37                  actually be GNU Awk.  If not set, PATH will be searched for
38                  an awk program.  If the Awk interpreter is actually GNU Awk,
39                  the --posix option will be given if an Awk implementation is
40                  used.
41
42     GAWK         Full file name for GNU Awk.  If not set, PATH will be
43                  searched for a gawk program.
44
45     BASH         Full file name for GNU Bash.  If not set, PATH will be
46                  searched for a bash program.  Note that Bash itself sets
47                  this variable, even when run as sh, even when running a
48                  script.
49
50     EXPECT       Full file name for Expect, which is a Tcl interpreter with
51                  the Expect extension already loaded.  If not set, PATH will
52                  be searched for an expect program.  Note that the DejaGnu
53                  core is written in Expect, so this interpreter should always
54                  be available.
55
56     TCLSH        Full file name for a Tcl interpreter.  If not set, PATH will
57                  be searched for a tclsh program.
58
59     Note that GNU Awk is considered a superset of Awk and that Expect is con‐
60     sidered a superset of Tcl, allowing the former to be used to run scripts
61     written for the latter.  This means that, while Awk programs will gener‐
62     ally be run with GNU extensions disabled using the --posix option to GNU
63     Awk, Tcl programs may be run with either tclsh or expect and should be
64     written accordingly.
65

FILES

67     $DEJAGNULIBS/commands  If DEJAGNULIBS is set, all command scripts are ex‐
68                            pected to be in this directory.
69     Otherwise, the first directory that actually exists in the following list
70     is used, where @bindir@ represents the directory containing dejagnu it‐
71     self.
72
73           @bindir@/../share/dejagnu/commands
74
75           @bindir@/../../share/dejagnu/commands
76
77           /usr/share/dejagnu/commands
78
79           /usr/local/share/dejagnu/commands
80

AUTHORS

87     Jacob Bachmeyer
88

BUGS

90     The command name must precede all other arguments due to limitations of
91     the shell.
92
93GNU                            December 17, 2018                           GNU