-A
-a-e
-f-h
-k-m
-n

ksh(1)

ksh(1)

read

[ -prsu[ n ] ] [ name ] [?prompt ] [ name ... ]

 

The shell input mechanism. One line is read and broken up into words using the charac-

 

ters in IFS as separators. In -rraw mode, \ at the end of a line does not signify line

 

continuation. The ®rst word is assigned to the ®rst name, the second word to the second

 

name, etc., with remaining words assigned to the last name. The -poption causes the

 

input line to be taken from the input pipe of a process spawned by the shell using &. If

 

the -soption is present, the input is saved as a command in the history ®le. The option

 

-ucan be used to specify a one-digit ®le descriptor unit to read from. The ®le descriptor

 

can be opened with the exec special command. The default value of n is 0. If name is

 

omitted, REPLY is used as the default name. The return code is 0, unless an end-of-®le is

 

encountered. An end-of-®le with the -poption causes cleanup for this process so that

 

another process can be spawned. If the ®rst argument contains a ?, the remainder of this

 

word is used as a prompt when the shell is interactive. If the given ®le descriptor is open

 

for writing and is a terminal device, the prompt is placed on this unit. Otherwise the

 

prompt is issued on ®le descriptor 2. The return code is 0, unless an end-of-®le is encoun-

 

tered. See also read(1).

%% readonly [ name[ =value ] ... ]

The given names are marked read-only and these names cannot be changed by subsequent assignment.

% return [ n ]

Causes a shell function to return to the invoking script with the return status speci®ed by n. If n is omitted, the return status is that of the last command executed. Only the low 8 bits of n are passed back to the caller. If return is invoked while not in a function or executing a script by the . (dot) built-in command, it has the same effect as an exit com- mand.

set [ ±aefhkmnopstuvx ±o option ] ... [ ±A name ] [ arg ... ] The following options are used for this command:

Array assignment. Unset the variable name and assign values sequentially from the list arg. If +A is used, the variable name is not unset ®rst.

All subsequent de®ned parameters are automatically exported.

If the shell is non-interactive and if a command fails, execute the ERR trap, if set, and exit immediately. This mode is disabled while reading pro®les. Disables ®le name generation.

Each command whose name is an identi®er becomes a tracked alias when ®rst encountered.

All parameter assignment arguments (not just those that precede the command name) are placed in the environment for a command.

Background jobs are run in a separate process group and a line is printed upon completion. The exit status of background jobs is reported in a completion message. This option is turned on automatically for interactive shells.

Read commands and check them for syntax errors, but do not execute them.

 

The

-noption is ignored for interactive shells.

 

 

 

 

-o

The

-oargument takes any of several option names, but only one option can

 

be speci®ed with each

-ooption. If none is supplied, the current option set-

 

tings are printed. The

-oargument option names follow:

 

 

 

allexport

Same as -a.

 

 

 

 

 

 

bgnice

All background jobs are run at a lower priority.

 

 

errexit

Same as -e.

 

 

 

 

 

 

emacs

Activates

an

emacs-style

in-line

editor

for

command

 

 

 

entry.

 

 

 

 

 

 

 

gmacs

Activates

a

gmacs-style

in-line

editor

for

command

 

 

 

entry.

 

 

 

 

 

 

 

ignoreeof

The

shell

does not exit on end-of-®le.

The

command

 

 

 

exit must be used.

 

 

 

 

 

keyword

Same as -k.

 

 

 

 

 

 

markdirs

All directory names resulting from ®le name generation

 

 

 

have a trailing / appended.

 

 

 

 

 

monitor

Same as -m.

 

 

 

 

 

 

noclobber

Prevents

redirection > from truncating

existing ®les.

 

 

 

Requires

> to truncate a ®le when turned on.

 

HP-UX Release 11i: December 2000

 

− 14 −

 

 

 

 

Section 1−409

k