No specific user configuration
[platform/upstream/bash.git] / doc / rbash.0
1 RBASH(1)                                                              RBASH(1)
2
3
4
5 N\bNA\bAM\bME\bE
6        rbash - restricted bash, see b\bba\bas\bsh\bh(1)
7
8 R\bRE\bES\bST\bTR\bRI\bIC\bCT\bTE\bED\bD S\bSH\bHE\bEL\bLL\bL
9        If b\bba\bas\bsh\bh is started with the name r\brb\bba\bas\bsh\bh, or the -\b-r\br option is supplied at
10        invocation, the shell becomes restricted.  A restricted shell  is  used
11        to  set  up an environment more controlled than the standard shell.  It
12        behaves identically to b\bba\bas\bsh\bh with the exception that the  following  are
13        disallowed or not performed:
14
15        +\bo      changing directories with c\bcd\bd
16
17        +\bo      setting or unsetting the values of S\bSH\bHE\bEL\bLL\bL, P\bPA\bAT\bTH\bH, E\bEN\bNV\bV, or B\bBA\bAS\bSH\bH_\b_E\bEN\bNV\bV
18
19        +\bo      specifying command names containing /\b/
20
21        +\bo      specifying a filename containing a /\b/ as an  argument  to  the  .\b.
22               builtin command
23
24        +\bo      specifying  a  filename containing a slash as an argument to the
25               -\b-p\bp option to the h\bha\bas\bsh\bh builtin command
26
27        +\bo      importing function definitions from  the  shell  environment  at
28               startup
29
30        +\bo      parsing  the  value  of  S\bSH\bHE\bEL\bLL\bLO\bOP\bPT\bTS\bS from the shell environment at
31               startup
32
33        +\bo      redirecting output using the >, >|, <>, >&, &>, and >> redirect-
34               ion operators
35
36        +\bo      using the e\bex\bxe\bec\bc builtin command to replace the shell with another
37               command
38
39        +\bo      adding or deleting builtin commands with the -\b-f\bf and  -\b-d\bd  options
40               to the e\ben\bna\bab\bbl\ble\be builtin command
41
42        +\bo      using  the  e\ben\bna\bab\bbl\ble\be  builtin  command  to  enable  disabled shell
43               builtins
44
45        +\bo      specifying the -\b-p\bp option to the c\bco\bom\bmm\bma\ban\bnd\bd builtin command
46
47        +\bo      turning off restricted mode with s\bse\bet\bt +\b+r\br or s\bse\bet\bt +\b+o\bo r\bre\bes\bst\btr\bri\bic\bct\bte\bed\bd.
48
49        These restrictions are enforced after any startup files are read.
50
51        When a command that is found to be a shell script  is  executed,  r\brb\bba\bas\bsh\bh
52        turns  off any restrictions in the shell spawned to execute the script.
53
54 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
55        bash(1)
56
57
58
59 GNU Bash-4.0                      2004 Apr 20                         RBASH(1)