GNU Rush – a restricted user shell (split by section):   Section:   Chapter:FastBack: Configuration File   Up: Configuration File   FastForward: Default Configuration   Contents: Table of ContentsIndex: Concept Index

4.2 Syntax

The ‘rush’ configuration consists of statements.

A statement consists of a keyword and optional arguments, separated by any amount of whitespace. Each statement occupies one line in the configuration file and is terminated by a newline character. Extremely long statements may be split across several physical lines by ending each line except the last with a backslash followed by a newline.

Statements may be separated by any amount of empty lines or comments.

The first statement in a configuration file indicates the syntax version. It has the following form:

rush 2.0

This statement is mandatory. In its absence, the file will be treated as a legacy configuration file3. To avoid confusion, a notice message to that effect will be printed.

Statements that follow form logical groups. Each group begins with a rule or global statement.

The global statement introduces global settings. It affects all statements that follow it.

The rule statement introduces a single rush rule, that defines how to process a particular command.

These statements are described in the sections that follow.

Footnotes

(3)

For the discussion of the legacy syntax, please refer to http://www.gnu.org.ua/software/rush/legacy.

GNU Rush – a restricted user shell (split by section):   Section:   Chapter:FastBack: Configuration File   Up: Configuration File   FastForward: Default Configuration   Contents: Table of ContentsIndex: Concept Index