code: 9ferno

ref: 600bbfe4aaa9ad0f73d8d73eef1b7670e5f7d3a3
dir: /man/1/read/

View raw version
.TH READ 1
.SH NAME
read \- read from standard input with optional seek
.SH SYNOPSIS
.B read
[
.BR - [ eor ]
.I offset
] [
.I count
]
.SH DESCRIPTION
.I Read
does a single read of
.I count
bytes (default:
8192 bytes)
from the standard input and writes
the result to the standard output.
If the optional
.I offset
argument is given,
.I read
will first apply
.IR sys-seek (2):
.TP
.BI -o " offset"
seek
.I offset
bytes from the start of the file
.TP
.BI -e " offset"
seek
.I offset
bytes from the end of the file
.TP
.BI -r " offset"
seek
.I offset
bytes from the standard input's current file offset
.PP
In all cases the file offset changes to
reflect the result of the seek, and the number of bytes
read.
.SH SOURCE
.B /appl/cmd/read.b
.SH DIAGNOSTICS
.I Read
prints a diagnostic and returns a non-empty exit
status
.L fail:error
on an I/O error;
it quietly returns status
.L fail:eof
if the read returns zero bytes (conventionally, end of file).
.SH SEE ALSO
.IR cat (1),
.I getline
in
.IR sh-std (1),
.IR stream (1),
.IR sys-read (2)