How to save output or errors to a file with Linux shell redirection
Standard Input, Standard Output and Standard Error
A running program, or process, needs to read input from somewhere and write output to somewhere. A command run from the shell prompt normally reads its input from the keyboard and sends its output to its terminal window.
A process uses numbered channels called ﬁle descriptors to get input and send output. All processes start with at least three ﬁle descriptors. Standard input (channel 0) reads input from the keyboard. Standard output (channel 1) sends normal output to the terminal. Standard error (channel 2) sends error messages to the terminal. If a program opens separate connections to other ﬁles, it may use higher-numbered ﬁle descriptors.
|NUMBER||CHANNEL NAME||DESCRIPTION||DEFAULT CONNECTION||USAGE|
|0||stdin||Standard input||Keyboard||read only|
|1||stdout||Standard output||Terminal||write only|
|2||stderr||Standard error||Terminal||write only|
|3+||filename||Other files||none||read and/or write|
Redirecting output to a file
I/O redirection changes how the process gets its input or output. Instead of getting input from the keyboard, or sending output and errors to the terminal, the process reads from or writes to ﬁles. Redirection lets you save messages to a ﬁle that are normally sent to the terminal window. Alternatively, you can use redirection to discard output or errors, so they are not displayed on the terminal or saved.
Redirecting stdout suppresses process output from appearing on the terminal. As seen in the following table, redirecting only stdout does not suppress stderr error messages from displaying on the terminal. If the ﬁle does not exist, it will be created. If the ﬁle does exist and the redirection is not one that appends to the ﬁle, the ﬁle’s contents will be overwritten. If you want to discard messages, the special ﬁle /dev/null quietly discards channel output redirected to it and is always an empty ﬁle.
|> file||redirect stdout to overwrite a file|
|» file||redirect stdout to append to a file|
|2> file||redirect stderr to overwrite a file|
|2> /dev/null||discard stderr error messages by redirecting to /dev/null|
|> file 2>&1||redirect stdout and stderr to overwrite the same file|
|» file 2>&1||redirect stdout and stderr to append to the same file|
> file 2>&1
However, the next sequence does redirection in the opposite order. This redirects standard error to the default place for standard output (the terminal window, so no change) and then redirects only standard output to file.
2>&1 > file
Because of this, some people prefer to use the merging redirection operators:
&>file instead of >file 2>&1 &>>file instead of >>file 2>&1 (in Bash 4)
However, other system administrators and programmers who also use other shells related to bash (known as Bourne-compatible shells) for scripting commands think that the newer merging redirection operators should be avoided, because they are not standardized or implemented in all of those shells and have other limitations.
Examples for Output Redirection
Many routine administration tasks are simpliﬁed by using redirection. Use the previous table to assist while considering the following examples:
1. Save a time stamp for later reference.
[[email protected] ~]$ date > /tmp/saved-timestamp
2. Copy the last 100 lines from a log ﬁle to another ﬁle.
[[email protected] ~]$ tail -n 100 /var/log/dmesg > /tmp/last-100-boot-messages
3. Concatenate four ﬁles into one.
[[email protected] ~]$ cat file1 file2 file3 file4 > /tmp/all-four-in-one
4. List the home directory’s hidden and regular ﬁle names into a ﬁle.
[[email protected] ~]$ ls -a > /tmp/my-file-names
5. Append output to an existing ﬁle.
[[email protected] ~]$ echo "new line of information" >> /tmp/many-lines-of-information [[email protected] ~]$ diff previous-file current-file >> /tmp/tracking-changes-made
6. The next few commands generate error messages because some system directories are inaccessible to normal users. Observe as the error messages are redirected. Redirect errors to a ﬁle while viewing normal command output on the terminal.
[[email protected] ~]$ find /etc -name passwd 2> /tmp/errors
7. Save process output and error messages to separate ﬁles.
[[email protected] ~]$ find /etc -name passwd > /tmp/output 2> /tmp/errors
8. Ignore and discard error messages.
[[email protected] ~]$ find /etc -name passwd > /tmp/output 2> /dev/null
9. Store output and generated errors together.
[[email protected] ~]$ find /etc -name passwd &> /tmp/save-both
10. Append output and generated errors to an existing ﬁle.
[[email protected] ~]$ find /etc -name passwd >> /tmp/save-both 2>&1