Lines Matching +full:read +full:- +full:1

5 .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
8 …formation Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifica…
13 .TH READ 1 "Dec 18, 2007"
15 read \- read a line from standard input
19 \fB/usr/bin/read\fR [\fB-r\fR] \fIvar\fR...
25 \fBread\fR \fIname\fR...
37 \fBread\fR [\fB-prsu\fR [\fIn\fR]] [\fIname\fR ? \fIprompt\fR] [\fIname\fR]...
43 \fBread\fR [\fB-Aprs\fR] [\fB-d\fR \fIdelim\fR] [\fB-n\fR \fInsize\fR] [\fB-N\fR \fInsize\fR] [\fB-…
47 .SS "/usr/bin/read"
50 The \fBread\fR utility reads a single line from standard input.
53 By default, unless the \fB-r\fR option is specified, backslash (\fB\e\fR) acts
55 shell is interactive, \fBread\fR prompts for a continuation line when:
60 The shell reads an input line ending with a backslash, unless the \fB-r\fR
67 A here-document is not terminated after a \fBNEWLINE\fR character is entered.
80 current shell execution environment. If it is called in a sub-shell or separate
85 \fB(read foo)
86 nohup read ...
87 find . -exec read ... \e;\fR
101 One line is read from the standard input and, using the internal field
109 code is \fB0\fR, unless an end-of-file is encountered.
125 \fBcsh\fR(1)).
129 The shell input mechanism. One line is read and is broken up into fields using
132 continuation. In raw mode, the \fB-r\fR, the \fB,\fR and the \fB\e\fR character
135 assigned to the last \fIname\fR. The \fB-p\fR option causes the input line to
137 If the \fB-s\fR flag is present, the input is saved as a command in the history
138 file. The flag \fB-u\fR can be used to specify a one digit file descriptor unit
139 \fIn\fR to read from. The file descriptor can be opened with the \fBexec\fR
142 \fB0\fR unless the input file is not open for reading or an end-of-file is
143 encountered. An end-of-file with the \fB-p\fR option causes cleanup for this
146 when the shell is interactive. The exit status is \fB0\fR unless an end-of-file
151 \fBread\fR reads a line from standard input and breaks it into fields using the
154 character and for line continuation unless the \fB-r\fR option is specified.
163 When \fIvar\fR has the binary attribute and \fB-n\fR or \fB-N\fR is specified,
164 the bytes that are read are stored directly into \fIvar\fR.
167 If you specify \fB?\fR\fIprompt\fR after the first \fIvar\fR, \fBread\fR
170 .SS "/usr/bin/read, ksh"
173 The following option is supported by \fB/usr/bin/read\fR and \fBksh\fR:
177 \fB\fB-r\fR\fR
191 \fB\fB-A\fR\fR
201 \fB\fB-d\fR \fIdelim\fR\fR
204 Read until delimiter \fIdelim\fR instead of to the end of line.
210 \fB\fB-n\fR \fInsize\fR\fR
213 Read at most \fInsize\fR bytes. Binary field size is in bytes.
219 \fB\fB-N\fR \fInsize\fR\fR
222 Read exactly \fInsize\fR bytes. Binary field size is in bytes.
228 \fB\fB-p\fR\fR
231 Read from the current co-process instead of standard input. An end of file
232 causes \fBread\fR to disconnect the co-process so that another can be created.
238 \fB\fB-r\fR\fR
247 \fB\fB-s\fR\fR
256 \fB\fB-t\fR \fItimeout\fR\fR
265 \fB\fB-u\fR \fIfd\fR\fR
268 Read from file descriptor number \fIfd\fR instead of standard input. The
275 \fB\fB-v\fR\fR
292 The name of an existing or non-existing shell variable.
297 \fBExample 1 \fRUsing the \fBread\fR Command
300 The following example for \fB/usr/bin/read\fR prints a file with the first
306 example% \fBwhile read -r xx yy
318 that affect the execution of \fBread\fR: \fBLANG\fR, \fBLC_ALL\fR,
336 when a line ending with a backslash is read and the \fB-r\fR option was not
337 specified, or if a here-document is not terminated after a NEWLINE character is
360 End-of-file was detected or an error occurred.
367 .SS "/usr/bin/read, csh, ksh, sh"
398 \fBcsh\fR(1), \fBksh\fR(1), \fBksh93\fR(1), \fBline\fR(1), \fBset\fR(1),
399 \fBsh\fR(1), \fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)