commit bash-20190524 snapshot

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.5 from
 bashref.texi.
 
 This text is a brief description of the features that are present in the
-Bash shell (version 5.0, 20 April 2019).
+Bash shell (version 5.0, 20 May 2019).
 
-   This is Edition 5.0, last updated 20 April 2019, of 'The GNU Bash
+   This is Edition 5.0, last updated 20 May 2019, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.0.
 
    Copyright (C) 1988-2018 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in the
-Bash shell (version 5.0, 20 April 2019).  The Bash home page is
+Bash shell (version 5.0, 20 May 2019).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.0, last updated 20 April 2019, of 'The GNU Bash
+   This is Edition 5.0, last updated 20 May 2019, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.0.
 
    Bash contains features that appear in other popular shells, and some
@@ -5408,9 +5408,9 @@ Variables::).
      The current working directory as set by the 'cd' builtin.
 
 'RANDOM'
-     Each time this parameter is referenced, a random integer between 0
-     and 32767 is generated.  Assigning a value to this variable seeds
-     the random number generator.
+     Each time this parameter is referenced, it expands to a random
+     integer between 0 and 32767.  Assigning a value to this variable
+     seeds the random number generator.
 
 'READLINE_LINE'
      The contents of the Readline line buffer, for use with 'bind -x'
@@ -5430,9 +5430,9 @@ Variables::).
      the number of seconds since the assignment.
 
 'SHELL'
-     The full pathname to the shell is kept in this environment
-     variable.  If it is not set when the shell starts, Bash assigns to
-     it the full pathname of the current user's login shell.
+     This environment variable expands to the full pathname to the
+     shell.  If it is not set when the shell starts, Bash assigns to it
+     the full pathname of the current user's login shell.
 
 'SHELLOPTS'
      A colon-separated list of enabled shell options.  Each word in the
@@ -5448,6 +5448,15 @@ Variables::).
      This is intended to be a count of how deeply your Bash shells are
      nested.
 
+'SRANDOM'
+     This variable expands to a 32-bit pseudo-random number each time it
+     is referenced.  The random number generator is not linear on
+     systems that support '/dev/urandom' or 'arc4random', so each
+     returned number has no relationship to the numbers preceding it.
+     The random number generator cannot be seeded, so assignments to
+     this variable have no effect.  If 'SRANDOM' is unset, it loses its
+     special properties, even if it is subsequently reset.
+
 'TIMEFORMAT'
      The value of this parameter is used as a format string specifying
      how the timing information for pipelines prefixed with the 'time'
@@ -6558,6 +6567,18 @@ with the exception that the following are disallowed or not performed:
 Shell Scripts::), 'rbash' turns off any restrictions in the shell
 spawned to execute the script.
 
+   The restricted shell mode is only one component of a useful
+restricted environment.  It should be accompanied by setting 'PATH' to a
+value that allows execution of only a few verified commands (commands
+that allow shell escapes are particularly vulnerable), leaving the user
+in a non-writable directory other than his home directory after login,
+not allowing the restricted shell to execute shell scripts, and cleaning
+the environment of variables that cause some commands to modify their
+behavior (e.g., 'VISUAL' or 'PAGER').
+
+   Modern systems provide more secure ways to implement a restricted
+environment, such as 'jails', 'zones', or 'containers'.
+
 
 File: bashref.info,  Node: Bash POSIX Mode,  Prev: The Restricted Shell,  Up: Bash Features
 
@@ -11314,12 +11335,13 @@ D.3 Parameter and Variable Index
                                                               (line 291)
 * skip-completed-text:                   Readline Init File Syntax.
                                                               (line 297)
+* SRANDOM:                               Bash Variables.      (line 628)
 * TEXTDOMAIN:                            Locale Translation.  (line  11)
 * TEXTDOMAINDIR:                         Locale Translation.  (line  11)
-* TIMEFORMAT:                            Bash Variables.      (line 628)
-* TMOUT:                                 Bash Variables.      (line 666)
-* TMPDIR:                                Bash Variables.      (line 678)
-* UID:                                   Bash Variables.      (line 682)
+* TIMEFORMAT:                            Bash Variables.      (line 637)
+* TMOUT:                                 Bash Variables.      (line 675)
+* TMPDIR:                                Bash Variables.      (line 687)
+* UID:                                   Bash Variables.      (line 691)
 * vi-cmd-mode-string:                    Readline Init File Syntax.
                                                               (line 310)
 * vi-ins-mode-string:                    Readline Init File Syntax.
@@ -11688,134 +11710,134 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top891
-Node: Introduction2805
-Node: What is Bash?3021
-Node: What is a shell?4135
-Node: Definitions6673
-Node: Basic Shell Features9624
-Node: Shell Syntax10843
-Node: Shell Operation11869
-Node: Quoting13162
-Node: Escape Character14462
-Node: Single Quotes14947
-Node: Double Quotes15295
-Node: ANSI-C Quoting16573
-Node: Locale Translation17832
-Node: Comments18728
-Node: Shell Commands19346
-Node: Simple Commands20218
-Node: Pipelines20849
-Node: Lists23781
-Node: Compound Commands25572
-Node: Looping Constructs26584
-Node: Conditional Constructs29079
-Node: Command Grouping40247
-Node: Coprocesses41726
-Node: GNU Parallel43629
-Node: Shell Functions47687
-Node: Shell Parameters54770
-Node: Positional Parameters59183
-Node: Special Parameters60083
-Node: Shell Expansions63837
-Node: Brace Expansion65960
-Node: Tilde Expansion68683
-Node: Shell Parameter Expansion71300
-Node: Command Substitution85733
-Node: Arithmetic Expansion87088
-Node: Process Substitution88020
-Node: Word Splitting89140
-Node: Filename Expansion91084
-Node: Pattern Matching93614
-Node: Quote Removal97600
-Node: Redirections97895
-Node: Executing Commands107453
-Node: Simple Command Expansion108123
-Node: Command Search and Execution110053
-Node: Command Execution Environment112429
-Node: Environment115413
-Node: Exit Status117072
-Node: Signals118742
-Node: Shell Scripts120709
-Node: Shell Builtin Commands123224
-Node: Bourne Shell Builtins125262
-Node: Bash Builtins146012
-Node: Modifying Shell Behavior174937
-Node: The Set Builtin175282
-Node: The Shopt Builtin185695
-Node: Special Builtins203365
-Node: Shell Variables204344
-Node: Bourne Shell Variables204781
-Node: Bash Variables206885
-Node: Bash Features237345
-Node: Invoking Bash238244
-Node: Bash Startup Files244257
-Node: Interactive Shells249360
-Node: What is an Interactive Shell?249770
-Node: Is this Shell Interactive?250419
-Node: Interactive Shell Behavior251234
-Node: Bash Conditional Expressions254721
-Node: Shell Arithmetic259298
-Node: Aliases262115
-Node: Arrays264735
-Node: The Directory Stack270100
-Node: Directory Stack Builtins270884
-Node: Controlling the Prompt273852
-Node: The Restricted Shell276773
-Node: Bash POSIX Mode278598
-Node: Job Control289531
-Node: Job Control Basics289991
-Node: Job Control Builtins294955
-Node: Job Control Variables299695
-Node: Command Line Editing300851
-Node: Introduction and Notation302522
-Node: Readline Interaction304145
-Node: Readline Bare Essentials305336
-Node: Readline Movement Commands307119
-Node: Readline Killing Commands308079
-Node: Readline Arguments309997
-Node: Searching311041
-Node: Readline Init File313227
-Node: Readline Init File Syntax314486
-Node: Conditional Init Constructs334925
-Node: Sample Init File339121
-Node: Bindable Readline Commands342238
-Node: Commands For Moving343442
-Node: Commands For History345291
-Node: Commands For Text349586
-Node: Commands For Killing352974
-Node: Numeric Arguments355455
-Node: Commands For Completion356594
-Node: Keyboard Macros360785
-Node: Miscellaneous Commands361472
-Node: Readline vi Mode367425
-Node: Programmable Completion368332
-Node: Programmable Completion Builtins376112
-Node: A Programmable Completion Example386807
-Node: Using History Interactively392054
-Node: Bash History Facilities392738
-Node: Bash History Builtins395743
-Node: History Interaction400274
-Node: Event Designators403894
-Node: Word Designators405113
-Node: Modifiers406750
-Node: Installing Bash408152
-Node: Basic Installation409289
-Node: Compilers and Options412547
-Node: Compiling For Multiple Architectures413288
-Node: Installation Names414981
-Node: Specifying the System Type415799
-Node: Sharing Defaults416515
-Node: Operation Controls417188
-Node: Optional Features418146
-Node: Reporting Bugs428664
-Node: Major Differences From The Bourne Shell429858
-Node: GNU Free Documentation License446710
-Node: Indexes471887
-Node: Builtin Index472341
-Node: Reserved Word Index479168
-Node: Variable Index481616
-Node: Function Index497367
-Node: Concept Index510670
+Node: Top887
+Node: Introduction2797
+Node: What is Bash?3013
+Node: What is a shell?4127
+Node: Definitions6665
+Node: Basic Shell Features9616
+Node: Shell Syntax10835
+Node: Shell Operation11861
+Node: Quoting13154
+Node: Escape Character14454
+Node: Single Quotes14939
+Node: Double Quotes15287
+Node: ANSI-C Quoting16565
+Node: Locale Translation17824
+Node: Comments18720
+Node: Shell Commands19338
+Node: Simple Commands20210
+Node: Pipelines20841
+Node: Lists23773
+Node: Compound Commands25564
+Node: Looping Constructs26576
+Node: Conditional Constructs29071
+Node: Command Grouping40239
+Node: Coprocesses41718
+Node: GNU Parallel43621
+Node: Shell Functions47679
+Node: Shell Parameters54762
+Node: Positional Parameters59175
+Node: Special Parameters60075
+Node: Shell Expansions63829
+Node: Brace Expansion65952
+Node: Tilde Expansion68675
+Node: Shell Parameter Expansion71292
+Node: Command Substitution85725
+Node: Arithmetic Expansion87080
+Node: Process Substitution88012
+Node: Word Splitting89132
+Node: Filename Expansion91076
+Node: Pattern Matching93606
+Node: Quote Removal97592
+Node: Redirections97887
+Node: Executing Commands107445
+Node: Simple Command Expansion108115
+Node: Command Search and Execution110045
+Node: Command Execution Environment112421
+Node: Environment115405
+Node: Exit Status117064
+Node: Signals118734
+Node: Shell Scripts120701
+Node: Shell Builtin Commands123216
+Node: Bourne Shell Builtins125254
+Node: Bash Builtins146004
+Node: Modifying Shell Behavior174929
+Node: The Set Builtin175274
+Node: The Shopt Builtin185687
+Node: Special Builtins203357
+Node: Shell Variables204336
+Node: Bourne Shell Variables204773
+Node: Bash Variables206877
+Node: Bash Features237824
+Node: Invoking Bash238723
+Node: Bash Startup Files244736
+Node: Interactive Shells249839
+Node: What is an Interactive Shell?250249
+Node: Is this Shell Interactive?250898
+Node: Interactive Shell Behavior251713
+Node: Bash Conditional Expressions255200
+Node: Shell Arithmetic259777
+Node: Aliases262594
+Node: Arrays265214
+Node: The Directory Stack270579
+Node: Directory Stack Builtins271363
+Node: Controlling the Prompt274331
+Node: The Restricted Shell277252
+Node: Bash POSIX Mode279734
+Node: Job Control290667
+Node: Job Control Basics291127
+Node: Job Control Builtins296091
+Node: Job Control Variables300831
+Node: Command Line Editing301987
+Node: Introduction and Notation303658
+Node: Readline Interaction305281
+Node: Readline Bare Essentials306472
+Node: Readline Movement Commands308255
+Node: Readline Killing Commands309215
+Node: Readline Arguments311133
+Node: Searching312177
+Node: Readline Init File314363
+Node: Readline Init File Syntax315622
+Node: Conditional Init Constructs336061
+Node: Sample Init File340257
+Node: Bindable Readline Commands343374
+Node: Commands For Moving344578
+Node: Commands For History346427
+Node: Commands For Text350722
+Node: Commands For Killing354110
+Node: Numeric Arguments356591
+Node: Commands For Completion357730
+Node: Keyboard Macros361921
+Node: Miscellaneous Commands362608
+Node: Readline vi Mode368561
+Node: Programmable Completion369468
+Node: Programmable Completion Builtins377248
+Node: A Programmable Completion Example387943
+Node: Using History Interactively393190
+Node: Bash History Facilities393874
+Node: Bash History Builtins396879
+Node: History Interaction401410
+Node: Event Designators405030
+Node: Word Designators406249
+Node: Modifiers407886
+Node: Installing Bash409288
+Node: Basic Installation410425
+Node: Compilers and Options413683
+Node: Compiling For Multiple Architectures414424
+Node: Installation Names416117
+Node: Specifying the System Type416935
+Node: Sharing Defaults417651
+Node: Operation Controls418324
+Node: Optional Features419282
+Node: Reporting Bugs429800
+Node: Major Differences From The Bourne Shell430994
+Node: GNU Free Documentation License447846
+Node: Indexes473023
+Node: Builtin Index473477
+Node: Reserved Word Index480304
+Node: Variable Index482752
+Node: Function Index498576
+Node: Concept Index511879
 
 End Tag Table