1BASH_BUILTINS(1)            General Commands Manual           BASH_BUILTINS(1)
2
3
4

NAME

6       bash,  :,  .,  [, alias, bg, bind, break, builtin, caller, cd, command,
7       compgen, complete, compopt,  continue,  declare,  dirs,  disown,  echo,
8       enable,  eval,  exec, exit, export, false, fc, fg, getopts, hash, help,
9       history, jobs, kill, let, local, logout, mapfile, popd, printf,  pushd,
10       pwd,  read, readonly, return, set, shift, shopt, source, suspend, test,
11       times, trap, true, type, typeset, ulimit, umask, unalias, unset, wait -
12       bash built-in commands, see bash(1)
13

BASH BUILTIN COMMANDS

15       Unless otherwise noted, each builtin command documented in this section
16       as accepting options preceded by - accepts -- to signify the end of the
17       options.  The :, true, false, and test/[ builtins do not accept options
18       and do not treat -- specially.  The exit, logout, return,  break,  con‐
19       tinue,  let,  and shift builtins accept and process arguments beginning
20       with - without requiring --.  Other builtins that accept arguments  but
21       are  not  specified  as accepting options interpret arguments beginning
22       with - as invalid options and require -- to  prevent  this  interpreta‐
23       tion.
24       : [arguments]
25              No  effect;  the command does nothing beyond expanding arguments
26              and performing any specified redirections.  The return status is
27              zero.
28
29        .  filename [arguments]
30       source filename [arguments]
31              Read  and  execute  commands  from filename in the current shell
32              environment and return the exit status of the last command  exe‐
33              cuted  from  filename.   If  filename  does not contain a slash,
34              filenames in PATH are used  to  find  the  directory  containing
35              filename.  The file searched for in PATH need not be executable.
36              When bash is  not  in  posix  mode,  the  current  directory  is
37              searched  if no file is found in PATH.  If the sourcepath option
38              to the shopt builtin command is turned  off,  the  PATH  is  not
39              searched.   If any arguments are supplied, they become the posi‐
40              tional parameters when  filename  is  executed.   Otherwise  the
41              positional  parameters  are  unchanged.   If  the  -T  option is
42              enabled, source inherits any trap on DEBUG; if it  is  not,  any
43              DEBUG  trap  string  is  saved  and  restored around the call to
44              source, and source unsets the DEBUG trap while it executes.   If
45              -T  is not set, and the sourced file changes the DEBUG trap, the
46              new value is retained when source completes.  The return  status
47              is the status of the last command exited within the script (0 if
48              no commands are executed), and false if filename is not found or
49              cannot be read.
50
51       alias [-p] [name[=value] ...]
52              Alias with no arguments or with the