HEAD(1)                 COMMAND REFERENCE                 HEAD(1)



NAME
     head - give first few lines

SYNOPSIS
     head [ -count ] [ -f ] [ file ...  ]

DESCRIPTION
     This filter gives the first count lines of each of the
     specified files, or of the standard input.  If count is
     omitted it defaults to 10.

     If more than one file is specified, the header

          ==> filename <==

     is printed before each file is displayed.

OPTIONS
     -count
         count linest are displayed.count is a decimal integer.

     -f  When reading from standard input, all input is read.
         The prevents the broken pipe message from the shell.

EXAMPLES
     The following example displays the first 20 lines of each of
     the files examp.c, example.h, and /etc/passwd.



          head -20 examp.c example.h /etc/passwd


RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     Because head buffers its input, the command



          (head -1; head -1) < /etc/passwd






Printed 10/17/86                                                1

HEAD(1)                 COMMAND REFERENCE                 HEAD(1)



     does not list the first two lines of /etc/passwd.  The first
     head command reads a 8192 byte buffer and prints the first
     line.  The second head command must therefore start at byte
     8193 of the file.

SEE ALSO
     line(1), tail(1).
















































Printed 10/17/86                                                2

%%index%%
na:72,63;
sy:135,160;
de:295,397;
op:692,300;
ex:992,275;
rv:1267,400;
ca:1667,172;1983,267;
se:2250,139;
%%index%%000000000139