1 cfa37a7b 2004-04-10 devnull .TH CAT 1
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull cat, read \- catenate files
 4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
 5 cfa37a7b 2004-04-10 devnull .B cat
 6 cfa37a7b 2004-04-10 devnull [
 7 cfa37a7b 2004-04-10 devnull .I file ...
 8 cfa37a7b 2004-04-10 devnull ]
 9 cfa37a7b 2004-04-10 devnull .br
10 cfa37a7b 2004-04-10 devnull .B read
11 cfa37a7b 2004-04-10 devnull [
12 cfa37a7b 2004-04-10 devnull .B -m
13 cfa37a7b 2004-04-10 devnull ] [
14 cfa37a7b 2004-04-10 devnull .B -n
15 cfa37a7b 2004-04-10 devnull .I nline
16 cfa37a7b 2004-04-10 devnull ] [
17 cfa37a7b 2004-04-10 devnull .I file ...
18 cfa37a7b 2004-04-10 devnull ]
19 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
20 cfa37a7b 2004-04-10 devnull .I Cat
21 cfa37a7b 2004-04-10 devnull reads each
22 cfa37a7b 2004-04-10 devnull .I file
23 cfa37a7b 2004-04-10 devnull in sequence and writes it on the standard output.
24 cfa37a7b 2004-04-10 devnull Thus
25 cfa37a7b 2004-04-10 devnull .IP
26 cfa37a7b 2004-04-10 devnull .L
27 cfa37a7b 2004-04-10 devnull cat file
28 cfa37a7b 2004-04-10 devnull .LP
29 cfa37a7b 2004-04-10 devnull prints a file and
30 cfa37a7b 2004-04-10 devnull .IP
31 cfa37a7b 2004-04-10 devnull .L
32 cfa37a7b 2004-04-10 devnull cat file1 file2 >file3
33 cfa37a7b 2004-04-10 devnull .LP
34 cfa37a7b 2004-04-10 devnull concatenates the first two files and places the result
35 cfa37a7b 2004-04-10 devnull on the third.
36 cfa37a7b 2004-04-10 devnull .PP
37 cfa37a7b 2004-04-10 devnull If no
38 cfa37a7b 2004-04-10 devnull .I file
39 cfa37a7b 2004-04-10 devnull is given,
40 cfa37a7b 2004-04-10 devnull .I cat 
41 cfa37a7b 2004-04-10 devnull reads from the standard input.
42 cfa37a7b 2004-04-10 devnull Output is buffered in blocks matching the input.
43 cfa37a7b 2004-04-10 devnull .PP
44 cfa37a7b 2004-04-10 devnull .I Read
45 cfa37a7b 2004-04-10 devnull copies to standard output exactly one line from the named
46 cfa37a7b 2004-04-10 devnull .IR file ,
47 cfa37a7b 2004-04-10 devnull default standard input.
48 cfa37a7b 2004-04-10 devnull It is useful in interactive
49 cfa37a7b 2004-04-10 devnull .IR rc (1)
50 cfa37a7b 2004-04-10 devnull scripts.
51 cfa37a7b 2004-04-10 devnull .PP
52 cfa37a7b 2004-04-10 devnull The
53 cfa37a7b 2004-04-10 devnull .B -m
54 cfa37a7b 2004-04-10 devnull flag causes it to continue reading and writing multiple lines until end of file;
55 cfa37a7b 2004-04-10 devnull .B -n
56 cfa37a7b 2004-04-10 devnull causes it to read no more than
57 cfa37a7b 2004-04-10 devnull .I nline
58 cfa37a7b 2004-04-10 devnull lines.
59 cfa37a7b 2004-04-10 devnull .PP
60 cfa37a7b 2004-04-10 devnull Read always executes a single
61 cfa37a7b 2004-04-10 devnull .B write
62 cfa37a7b 2004-04-10 devnull for each line of input, which can be helpful when
63 cfa37a7b 2004-04-10 devnull preparing input to programs that expect line-at-a-time data.
64 cfa37a7b 2004-04-10 devnull It never reads any more data from the input than it prints to the output.
65 cfa37a7b 2004-04-10 devnull .SH SOURCE
66 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/cat.c
67 cfa37a7b 2004-04-10 devnull .br
68 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/read.c
69 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
70 cfa37a7b 2004-04-10 devnull .IR cp (1)
71 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
72 cfa37a7b 2004-04-10 devnull .I Read
73 cfa37a7b 2004-04-10 devnull exits with status
74 cfa37a7b 2004-04-10 devnull .B eof
75 cfa37a7b 2004-04-10 devnull on end of file or, in the
76 cfa37a7b 2004-04-10 devnull .B -n
77 cfa37a7b 2004-04-10 devnull case, if it doesn't read
78 cfa37a7b 2004-04-10 devnull .I nlines
79 cfa37a7b 2004-04-10 devnull lines.
80 cfa37a7b 2004-04-10 devnull .SH BUGS
81 cfa37a7b 2004-04-10 devnull Beware of
82 cfa37a7b 2004-04-10 devnull .L "cat a b >a"
83 cfa37a7b 2004-04-10 devnull and
84 cfa37a7b 2004-04-10 devnull .LR "cat a b >b" ,
85 cfa37a7b 2004-04-10 devnull which
86 cfa37a7b 2004-04-10 devnull destroy input files before reading them.