GNU Rush
	Restricted User Shell	Sergey Poznyakoff

• Main
• Downloads
• Documentation

7 Test Mode

GNU Rush provides a special test mode, intended to test configuration files and to emulate execution of commands. Test mode is enabled by the --test command line option (aliases: --lint, -t). When rush is given this option, the following occurs:

1. All diagnostic messages are redirected to standard error, instead of syslog.
2. If a single non-option argument is present, it is taken as a name of the configuration file to use.
3. The configuration file is parsed. If parsing fails, the program exits with the code 1.
4. If the -c option is present, rush processes its argument as usual (see Operation), except that the command itself is not executed.
5. Otherwise, if -i option is present, rush emulates interactive usage, but does not execute the final command.

An exit status of 0 means no errors, 1 means an error has occurred.

You can also emulate access by a particular user, by supplying his user name via the --user (-u) option. This option implies --test.

In test mode, you can set debugging level (see Debugging) from the command line, using the --debug (-d) command line option. It expects a single number specifying debugging level as its argument. The debugging level set this way overrides settings from the configuration file.

Here are several examples that illustrate the use of test mode in various cases:

1. Test default configuration file:

   $ rush --test
   

2. Test configuration file sample.rc:

   $ rush --test sample.rc
   

3. Test interactive access

   $ rush --test -i sample.rc
   

4. Test the configuration file and emulate execution of the command cvs server. Use debugging level 2:

   $ rush --test --debug=2 -c "cvs server"
   

5. Same, but for user ‘jeff’:

   $ rush --user=jeff --debug=2 -c "cvs server"
   

   Note, that you don’t need to specify --test along with --user or -i options.

6. Same, but use sample.rc instead of the default configuration file:

   $ rush --test --debug=2 -c "cvs server" sample.rc