xref: /original-bsd/usr.bin/head/head.1 (revision c3e32dec)
1.\" Copyright (c) 1980, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"	@(#)head.1	8.1 (Berkeley) 06/06/93
7.\"
8.Dd
9.Dt HEAD 1
10.Os BSD 3
11.Sh NAME
12.Nm head
13.Nd display first lines of a file
14.Sh SYNOPSIS
15.Nm head
16.Op Fl n Ar count
17.Op Ar file ...
18.Sh DESCRIPTION
19This filter displays the first
20.Ar count
21lines of each of the specified files, or of the standard input if no
22files are specified.
23If
24.Ar count
25is omitted it defaults to 10.
26.Pp
27If more than a single file is specified, each file is preceded by a
28header consisting of the string
29.Dq ==> XXX <==
30where
31.Dq XXX
32is the name of the file.
33.Pp
34The
35.Nm head
36utility exits 0 on success, and >0 if an error occurs.
37.Sh SEE ALSO
38.Xr tail 1
39.Sh HISTORY
40The
41.Nm head
42command appeared in
43.Bx 3.0 .
44