In computing, process substitution is a form of inter-process communication that allows the input or output of a command to appear as a file. The command is substituted in-line, where a file name would normally occur, by the command shell. This allows programs that normally only accept files to directly read from or write to another program.
Process substitution was available as a compile-time option for ksh88, the 1988 version of the Korn shell from Bell Labs. The Bash shell provided process substitution no later than version 1.14, released in 1994.
The following examples use Korn shell syntax.
$ diff <(sort file1) <(sort file2)
<(command) expression tells the command interpreter to run command and make its output appear as a file. The command can be any arbitrarily complex shell command.
Without process substitution, the alternatives are:
- Save the output of the command(s) to a temporary file, then read the temporary file(s).
$ sort file2 > /tmp/file2.sorted $ sort file1 | diff - /tmp/file2.sorted $ rm /tmp/file2.sorted
- Create a named pipe (also known as a FIFO), start one command writing to the named pipe in the background, then run the other command with the named pipe as input.
$ mkfifo /tmp/sort2.fifo $ sort file2 > /tmp/sort2.fifo & $ sort file1 | diff - /tmp/sort2.fifo $ rm /tmp/sort2.fifo
Both alternatives are more cumbersome.
Process substitution can also be used to capture output that would normally go to a file, and redirect it to the input of a process. The Bash syntax for writing to a process is
>(command). Here is an example using the
gzip commands that counts the lines in a file with
wc -l and compresses it with
gzip in one pass:
$ tee >(wc -l >&2) < bigfile | gzip > bigfile.gz
The main advantages of process substitution over its alternatives are:
- Simplicity: The commands can be given in-line; there is no need to save temporary files or create named pipes first.
- Performance: Reading directly from another process is often faster than having to write a temporary file to disk, then read it back in. This also saves disk space.
- Parallelism: The substituted process can be running concurrently with the command reading its output or writing its input, taking advantage of multiprocessing to reduce the total time for the computation.
Under the hood, process substitution has two implementations. On systems which support
/dev/fd (most Unix-like systems) it works by calling the
pipe() system call, which returns a file descriptor
$fd for a new anonymous pipe, then creating the string
/dev/fd/$fd, and substitutes that on the command line. On systems without
/dev/fd support, it calls
mkfifo with a new temporary filename to create a named pipe, and substitutes this filename on the command line. To illustrate the steps involved, consider the following simple command substitution on a system with
$ diff file1 <(sort file2)
The steps the shell performs are:
- Create a new anonymous pipe. This pipe will be accessible with something like
/dev/fd/63; you can see it with a command like
- Execute the substituted command in the background (
sort file2in this case), piping its output to the anonymous pipe.
- Execute the primary command, replacing the substituted command with the path of the anonymous pipe. In this case, the full command might expand to something like
diff file1 /dev/fd/63.
- When execution is finished, close the anonymous pipe.
For named pipes, the execution differs solely in the creation and deletion of the pipe; they are created with
mkfifo (which is given a new temporary file name) and removed with
unlink. All other aspects remain the same.
Process substitution has some limitations:
- No file seeking: the "files" created are not seekable, which means the process reading or writing to the file cannot perform random access; it must read or write once from start to finish. Programs that explicitly check the type of a file before opening it may refuse to work with process substitution, because the "file" resulting from process substitution is not a regular file.
- No exit codes: "It is not possible to obtain the exit code of a process substitution command from the shell that created the process substitution."
- Rosenblatt, Bill; Robbins, Arnold (April 2002). "Appendix A.2". Learning the Korn Shell (2nd ed.). O'Reilly & Associates. ISBN 0-596-00195-9.
- Ramey, Chet (August 18, 1994). Bash 1.14 release notes. Free Software Foundation. Available in the Gnu source archive of version 1.14.7 as of 12 February 2016.
- "ProcessSubstitution". Greg's Wiki. 27 Jun 2011.
- "Bash Reference Manual". The GNU Project. Free Software Foundation. 23 December 2009. Retrieved 1 Oct 2011.
- Cooper, Mendel (30 Aug 2011). "Advanced Bash-Scripting Guide". The Linux Documentation Project. Retrieved 1 Oct 2011.
- Frazier, Mitch (22 May 2008). "Bash Process Substitution". Linux Journal. Retrieved 1 Oct 2011.