read(1)
NAME
read − shell built-in function to receive from standard input (keyboard)
SYNOPSIS
sh
read name ...
csh
set variable = $<
ksh
read [ −prsu[ n ] ] [ name?prompt ] [ name ... ]
DESCRIPTION
sh
One line is read from the standard input and, using the internal field separator, IFS (normally space or tab), to delimit word boundaries, the first word is assigned to the first name, the second word to the second name, etc., with leftover words assigned to the last name. Lines can be continued using \newline. Characters other than newline can be quoted by preceding them with a backslash. These backslashes are removed before words are assigned to names, and no interpretation is done on the character that follows the backslash. The return code is 0, unless an EOF is encountered.
csh
The notation
set variable = $<
loads one line of standard input as the value for variable. (See csh(1)).
ksh
The shell input mechanism. One line is read and is broken up into fields using the characters in IFS as separators. The escape character, (\), is used to remove any special meaning for the next character and for line continuation. In raw mode, −r, the \ character is not treated specially. The first field is assigned to the first name, the second field to the second name, etc., with leftover fields assigned to the last name. The −p option causes the input line to be taken from the input pipe of a process spawned by the shell using │&. If the −s flag is present, the input will be saved as a command in the history file. The flag −u can be used to specify a one digit file descriptor unit n to read from. The file descriptor can be opened with the exec special command. The default value of n is 0. If name is omitted then REPLY is used as the default name. The exit status is 0 unless the input file is not open for reading or an end-of-file is encountered. An end-of-file with the −p option causes cleanup for this process so that another can be spawned. If the first argument contains a ?, the remainder of this word is used as a prompt on standard error when the shell is interactive. The exit status is 0 unless an end-of-file is encountered.
SEE ALSO
SunOS 5.4 — Last change: 15 Apr 1994