4.9. Saving Your Output
System administrators (and other human beings too) see a lot of critical messages fly by on the computer screen. It's often important to save these messages so you can scrutinize them later, or (all too often) send them to a friend who can figure out what went wrong. So, in this section, we'll explain a little bit about redirection, a powerful feature provided by Unix shells. If you come from MS-DOS, you have probably seen a similar, but more limited, type of redirection.
$ ls /usr/bin > ~/Binaries
A listing of /usr/bin will be stored in your home directory in a file named Binaries. If Binaries had already existed, the > would wipe out what was there and replace it with the output of the ls command. Overwriting a current file is a common user error. If your shell is csh or tcsh, you can prevent overwriting with the command:
And in bash you can achieve the same effect by entering:
$ noclobber=1 It doesn't have to be 1; any value will have the same effect.
Another (and perhaps more useful) way to prevent overwriting is to append new output. For instance, having saved a listing of /usr/bin, suppose we now want to add the contents of /bin to that file. We can append it to the end of the Binaries file by specifying two greater-than signs:
$ ls /bin >> ~/Binaries
You will find the technique of output redirection very useful when you are running a utility many times and saving the output for troubleshooting.
Most Unix programs have two output streams. One is called the standard output, and the other is the standard error. If you're a C programmer you'll recognize these: the standard error is the file named stderr to which you print messages.
The > character does not redirect the standard error. It's useful when you want to save legitimate output without mucking up a file with error messages. But what if the error messages are what you want to save? This is quite common during troubleshooting. The solution is to use a greater-than sign followed by an ampersand. (This construct works in almost every modern UNIX shell.) It redirects both the standard output and the standard error. For instance:
$ gcc invinitjig.c >& error-msg
This command saves all the messages from the gcc compiler in a file named error-msg. (Of course, the object code is not saved there. It's stored in invinitjig.o as always.) On the Bourne shell and bash you can also say it slightly differently:
$ gcc invinitjig.c &> error-msg
Now let's get really fancy. Suppose you want to save the error messages but not the regular output--the standard error but not the standard output. In the Bourne-compatible shells you can do this by entering the following:
$ gcc invinitjig.c 2> error-msg
The shell arbitrarily assigns the number 1 to the standard output and the number 2 to the standard error. So the above command saves only the standard error.
Finally, suppose you want to throw away the standard output--keep it from appearing on your screen. The solution is to redirect it to a special file called /dev/null. (You've heard people say things like "Send your criticisms to /dev/null"? Well, this is where the phrase came from.) The /dev directory is where Unix systems store special files that refer to terminals, tape drives, and other devices. But /dev/null is unique; it's a place you can send things so that they disappear into a black hole. For example, the following command saves the standard error and throws away the standard output:
$ gcc invinitjig.c 2>error-msg >/dev/null
So now you should be able to isolate exactly the output you want.
In case you've wondered whether the less-than sign (<) means anything to the shell: yes, it does. It causes commands to take their input from a file. But most commands allow you to specify input files on their command lines anyway, so this "input redirection" is rarely necessary.
Sometimes you want one utility to operate on the output of another utility. For instance, you can use the sort command to put the output of other commands into a more useful order. A crude way to do this would be to save output from one command in a file, and then run sort on it. For instance:
$ du > du_output $ sort -n du_output
$ du | sort -n
The shell sends all the input from the du program to the sort program.
$ du 10 ./zoneinfo/Australia 13 ./zoneinfo/US 9 ./zoneinfo/Canada 4 ./zoneinfo/Mexico 5 ./zoneinfo/Brazil 3 ./zoneinfo/Chile 20 ./zoneinfo/SystemV 118 ./zoneinfo 298 ./ghostscript/doc 183 ./ghostscript/examples 3289 ./ghostscript/fonts . . .
So we have decided to run it through sort with the -n and -r options. The -n option means "sort in numerical order" instead of the default ASCII sort, and the -r option means "reverse the usual order" so that the highest number appears first. The result is output that quickly shows you which directories and files hog the most space:
$ du | sort -rn 34368 . 16005 ./emacs 16003 ./emacs/20.4 13326 ./emacs/20.4/lisp 4039 ./ghostscript 3289 ./ghostscript/fonts . . .
Since there are so many files, we had better use a second pipe to send output through the more command (one of the more common uses of pipes):
$ du | sort -rn | more 34368 . 16005 ./emacs 16003 ./emacs/20.4 13326 ./emacs/20.4/lisp 4039 ./ghostscript 3289 ./ghostscript/fonts . . .
Copyright © 2001 O'Reilly & Associates. All rights reserved.