[thirdparty/bash.git] / doc / rbash.0

RBASH(1)                    General Commands Manual                   RBASH(1)


N\bNA\bAM\bME\bE
       rbash - restricted bash, see b\bba\bas\bsh\bh(1)

R\bRE\bES\bST\bTR\bRI\bIC\bCT\bTE\bED\bD S\bSH\bHE\bEL\bLL\bL
       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
       invocation, the shell becomes restricted.  A restricted shell  is  used
       to  set  up an environment more controlled than the standard shell.  It
       behaves identically to b\bba\bas\bsh\bh with the exception that the  following  are
       disallowed or not performed:

       +\bo      changing directories with c\bcd\bd

       +\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

       +\bo      specifying command names containing /\b/

       +\bo      specifying  a  filename  containing  a /\b/ as an argument to the .\b.
              builtin command

       +\bo      specifying a filename containing a slash as an argument  to  the
              -\b-p\bp option to the h\bha\bas\bsh\bh builtin command

       +\bo      importing  function  definitions  from  the shell environment at
              startup

       +\bo      parsing the value of S\bSH\bHE\bEL\bLL\bLO\bOP\bPT\bTS\bS from  the  shell  environment  at
              startup

       +\bo      redirecting output using the >, >|, <>, >&, &>, and >> redirect-
              ion operators

       +\bo      using the e\bex\bxe\bec\bc builtin command to replace the shell with another
              command

       +\bo      adding  or  deleting builtin commands with the -\b-f\bf and -\b-d\bd options
              to the e\ben\bna\bab\bbl\ble\be builtin command

       +\bo      using the  e\ben\bna\bab\bbl\ble\be  builtin  command  to  enable  disabled  shell
              builtins

       +\bo      specifying the -\b-p\bp option to the c\bco\bom\bmm\bma\ban\bnd\bd builtin command

       +\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.

       These restrictions are enforced after any startup files are read.

       When  a  command  that is found to be a shell script is executed, r\brb\bba\bas\bsh\bh
       turns off any restrictions in the shell spawned to execute the script.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
       bash(1)


GNU Bash-4.0                      2004 Apr 20                         RBASH(1)
Commit	Line	Data
a0c0a00f	1	RBASH(1) General Commands Manual RBASH(1)
17345e5a JA	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
a0c0a00f	21	+\bo specifying a filename containing a /\b/ as an argument to the .\b.
17345e5a JA	22	builtin command
17345e5a JA	23
a0c0a00f	24	+\bo specifying a filename containing a slash as an argument to the
17345e5a JA	25	-\b-p\bp option to the h\bha\bas\bsh\bh builtin command
17345e5a JA	26
a0c0a00f	27	+\bo importing function definitions from the shell environment at
17345e5a JA	28	startup
17345e5a JA	29
a0c0a00f	30	+\bo parsing the value of S\bSH\bHE\bEL\bLL\bLO\bOP\bPT\bTS\bS from the shell environment at
17345e5a JA	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
a0c0a00f	39	+\bo adding or deleting builtin commands with the -\b-f\bf and -\b-d\bd options
17345e5a JA	40	to the e\ben\bna\bab\bbl\ble\be builtin command
17345e5a JA	41
a0c0a00f	42	+\bo using the e\ben\bna\bab\bbl\ble\be builtin command to enable disabled shell
17345e5a JA	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
a0c0a00f CR	51	When a command that is found to be a shell script is executed, r\brb\bba\bas\bsh\bh
a0c0a00f CR	52	turns off any restrictions in the shell spawned to execute the script.
17345e5a JA	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)