# phpman > man > rush(1)

[RUSH(1)](https://www.chedong.com/phpMan.php/man/RUSH/1/markdown)                                  Rush User Reference                                 [RUSH(1)](https://www.chedong.com/phpMan.php/man/RUSH/1/markdown)



## NAME
       rush - restricted user shell

## SYNOPSIS
       **rush**  [**-ht**]  [**-C**  _CHECK_] [**-D** _ATTR_[**,**_ATTR_...]] [**-c** _COMMAND_] [**-d** _NUMBER_] [**-i**] [**-u** _USER_] [**--debug**
       _NUMBER_] [**--dump=**_ATTR_[**,**_ATTR_...]] [**--help**] [**--show-default**] [**--usage**] [**--version**] [_FILE_]

## NOTE
       This manpage is a short description of GNU **rush**.  For a detailed discussion, including  exam‐
       ples  and  usage  recommendations,  refer  to the manual **GNU** **Rush** **--** **a** **restricted** **user** **shell**,
       available in texinfo format.  If the **info** reader and the rush documentation are properly  in‐
       stalled on your system, the command

           **info** **rush**

       should give you access to the complete manual.

       You  can  also view the manual using the info mode in [**emacs**(1)](https://www.chedong.com/phpMan.php/man/emacs/1/markdown), or find it in various formats
       online at

           **<http://www.gnu.org.ua/software/rush/manual>**

       If any discrepancies occur between this manpage and the **Manual**, the later shall be considered
       the authoritative source.

## DESCRIPTION
       GNU **rush** is a restricted user shell, designed for sites that provide limited remote access to
       their resources, such as svn or git repositories, scp, or the like.

       Upon startup **rush** analyzes its command line and examines the set of  configuration  rules  to
       determine what kind of access the user is to be granted.

## OPTIONS
### -d --debug=
              Set debugging level.  The greater is the _NUMBER_, the more verbose is the logging.  The
              debugging information is reported via [**syslog**(3)](https://www.chedong.com/phpMan.php/man/syslog/3/markdown) using **authpriv,** priority **debug**.  Maxi‐
              mum meaningful value for _NUMBER_ is **3**.

### -D --dump=
              Request  dump  mode.   Arguments  are the names of the attributes to be dumped, or the
              word **all** standing for all attributes.  Refer to the GNU Rush manual for a detailed de‐
              scription.

### -t --test --lint
              Run in test mode.  When this option is given, 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 con‐
                     figuration 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, except that
                     the command itself is not executed.

### -u --user=
              Supplies user name for use with **--test**.

### -c
              Execute _COMMAND_.

### -C --security-check=
              Add or remove configuration security check.  The argument is one of the following:

              **all**    Enable all checks.

              **owner**  Check if the file is owned by root.

              **iwgrp**, **groupwritablefile**
                     Check if the file is not group writable.

              **iwoth**, **worldwritablefile**
                     Check if the file is not world writable.

              **dir**___**iwgrp**, **groupwritabledir**
                     Check if the directory where the file resides is not group writable.

              **dir**___**iwoth**, **worldwritabledir**
                     Check if the directory where the file resides is not world writable.

              **link**   Check if the file is not a symbolic link to a file residing in a group or world
                     writable directory.

### -i
              uration allow interactive access.

### --show-default
              Show default configuration.

## SEE ALSO
       [**rush.rc**(5)](https://www.chedong.com/phpMan.php/man/rush.rc/5/markdown), [**rushlast**(1)](https://www.chedong.com/phpMan.php/man/rushlast/1/markdown), [**rushwho**(1)](https://www.chedong.com/phpMan.php/man/rushwho/1/markdown).

## AUTHORS
       Sergey Poznyakoff

## BUG REPORTS
       Report bugs to <<bug-rush@gnu.org.ua>>.

## COPYRIGHT
       Copyright © 2016 Sergey Poznyakoff
       License GPLv3+: GNU GPL version 3 or later <<http://gnu.org/licenses/gpl.html>>
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY,  to
       the extent permitted by law.



RUSH                                       August 20, 2016                                   [RUSH(1)](https://www.chedong.com/phpMan.php/man/RUSH/1/markdown)
