Bash Reference Manual Reference Documentation for Bash

1
1 Introduction
1.1 What is Bash?
Bash is the shell, or command language interpreter, for the gnu operating system. The
name is an acronym for the ‘Bourne-Again SHell’, a pun on Stephen Bourne, the author
of the direct ancestor of the current Unix shell sh, which appeared in the Seventh Edition
Bell Labs Research version of Unix.
Bash is largely compatible with sh and incorporates useful features from the Korn shell
ksh and the C shell csh. It is intended to be a conformant implementation of the ieee
posix Shell and Tools portion of the ieee posix specification (ieee Standard 1003.1). It
offers functional improvements over sh for both interactive and programming use.
While the gnu operating system provides other shells, including a version of csh, Bash
is the default shell. Like other gnu software, Bash is quite portable. It currently runs on
nearly every version of Unix and a few other operating systems − independently-supported
ports exist for ms-dos, os/2, and Windows platforms.
1.2 What is a shell?
At its base, a shell is simply a macro processor that executes commands. The term macro
processor means functionality where text and symbols are expanded to create larger expres-
sions.
A Unix shell is both a command interpreter and a programming language. As a com-
mand interpreter, the shell provides the user interface to the rich set of gnu utilities. The
programming language features allow these utilities to be combined. Files containing com-
mands can be created, and become commands themselves. These new commands have the
same status as system commands in directories such as /bin, allowing users or groups to
establish custom environments to automate their common tasks.
Shells may be used interactively or non-interactively. In interactive mode, they accept
input typed from the keyboard. When executing non-interactively, shells execute commands
read from a file.
A shell allows execution of gnu commands, both synchronously and asynchronously.
The shell waits for synchronous commands to complete before accepting more input; asyn-
chronous commands continue to execute in parallel with the shell while it reads and executes
additional commands. The redirection constructs permit fine-grained control of the input
and output of those commands. Moreover, the shell allows control over the contents of
commands’ environments.
Shells also provide a small set of built-in commands (builtins) implementing function-
ality impossible or inconvenient to obtain via separate utilities. For example, cd, break,
continue, and exec cannot be implemented outside of the shell because they directly ma-
nipulate the shell itself. The history, getopts, kill, or pwd builtins, among others, could
be implemented in separate utilities, but they are more convenient to use as builtin com-
mands. All of the shell builtins are described in subsequent sections.
While executing commands is essential, most of the power (and complexity) of shells
is due to their embedded programming languages. Like any high-level language, the shell
provides variables, flow control constructs, quoting, and functions.

---

2
Shells offer features geared specifically for interactive use rather than to augment the pro-
gramming language. These interactive features include job control, command line editing,
command history and aliases. Each of these features is described in this manual.

---

3
2 Definitions
These definitions are used throughout the remainder of this manual.
POSIX
A family of open system standards based on Unix. Bash is primarily concerned
with the Shell and Utilities portion of the posix 1003.1 standard.
blank
A space or tab character.
builtin
A command that is implemented internally by the shell itself, rather than by
an executable program somewhere in the file system.
control operator
A token that performs a control function. It is a newline or one of the following:
‘||’, ‘&&’, ‘&’, ‘;’, ‘;;’, ‘;&’, ‘;;&’, ‘|’, ‘|&’, ‘(’, or ‘)’.
exit status
The value returned by a command to its caller. The value is restricted to eight
bits, so the maximum value is 255.
field
A unit of text that is the result of one of the shell expansions. After expansion,
when executing a command, the resulting fields are used as the command name
and arguments.
filename
A string of characters used to identify a file.
job
A set of processes comprising a pipeline, and any processes descended from it,
that are all in the same process group.
job control
A mechanism by which users can selectively stop (suspend) and restart (resume)
execution of processes.
metacharacter
A character that, when unquoted, separates words. A metacharacter is a space,
tab, newline, or one of the following characters: ‘|’, ‘&’, ‘;’, ‘(’, ‘)’, ‘<’, or ‘>’.
name
A word consisting solely of letters, numbers, and underscores, and beginning
with a letter or underscore. Names are used as shell variable and function names.
Also referred to as an identifier.
operator
A control operator or a redirection operator. See Section 3.6 [Redirec-
tions], page 32, for a list of redirection operators. Operators contain at least
one unquoted metacharacter.
process group
A collection of related processes each having the same process group id.
process group ID
A unique identifier that represents a process group during its lifetime.
reserved word
A word that has a special meaning to the shell. Most reserved words introduce
shell flow control constructs, such as for and while.

---