ksh(1)

 

 

 

 

ksh(1)

 

 

inside a function, a new instance of the parameter name is created. The parameter value

 

 

and type are restored when the function completes. The following list of attributes can be

 

 

speci®ed:

Left justify and remove leading blanks from value. If n is non-zero, it de®nes

 

 

-L

 

 

 

the width of the ®eld. Otherwise, it is determined by the width of the value of

 

 

 

®rst assignment. When the name is assigned, the value is ®lled on the right

 

 

 

with blanks or truncated, if necessary, to ®t into the ®eld. Leading zeros are

 

 

 

removed if the -Zoption is also set. The -Roption is turned off.

 

 

 

-R

Right justify and ®ll with leading blanks. If n is non-zero, it de®nes the width of

 

 

 

the ®eld. Otherwise, it is determined by the width of the value of ®rst assign-

 

 

 

ment. The ®eld is left-®lled with blanks or truncated from the end if the param-

 

 

 

eter is reassigned. The -Loption is turned off.

 

 

 

 

-Z

Right justify and ®ll with leading zeros if the ®rst non-blank character is a digit

 

 

 

and the

-Loption has not been set. If n is non-zero, it de®nes the width of the

 

 

 

®eld. Otherwise, it is determined by the width of the value of ®rst assignment.

 

 

-f

Cause name to refer to function names rather than parameter names.

No

 

 

 

assignments can be made to the name declared with the typeset statement.

 

 

 

The only other valid options are -t(which turns on execution tracing for this

 

 

 

function) and -x(which allows the function to remain in effect across shell pro-

 

 

 

cedures executed in the same process environment).

 

 

 

 

-i

Parameter is an integer. This makes arithmetic faster.

If n is non-zero,

it

 

 

 

de®nes the output arithmetic base; otherwise the ®rst assignment determines

 

 

 

the output base.

 

 

 

 

-l

Convert

all uppercase characters to lowercase. The uppercase -uoption

is

 

 

 

turned off.

 

 

 

 

-r

Any given name is marked "read only" and cannot be changed by subsequent

 

 

 

assignment.

 

 

 

 

-t

Tag the named parameters. Tags are user de®nable and have no special mean-

 

 

 

ing to the shell.

 

 

 

 

-u

Convert all lowercase characters to uppercase characters.

The lowercase -l

 

 

 

option is turned off.

 

 

 

 

-x

Mark any given name for automatic export to the environment of subsequently

 

 

 

executed commands.

 

 

 

 

 

Using + instead of - causes these options to be turned off. If no name argu-

 

 

 

ments are given but options are speci®ed, a list of names (and optionally the

 

 

 

values) of the parameters that have these options set is

printed. Using

+

 

 

 

instead of - retains the values to be printed. If neither names nor options are

 

 

 

given, the names and attributes of all parameters are printed.

 

ulimit

[ n ]

If n is given, impose a size limit of n 512 byte blocks on ®les written by child processes (®les

 

 

of any size can be read). If n is not given, the current limit is printed.

 

 

umask

[ mask ]

 

 

 

 

 

 

The user ®le-creation mask is set to mask (see umask(2)). mask can either be an octal

 

 

number or a symbolic value as described in chmod(1). If a symbolic value is given, the new

 

 

umask value is the complement of the result of applying mask to the complement of the

 

 

previous umask value. If mask is omitted, the current value of the mask is printed. See

 

 

also umask(1).

 

 

 

unalias name ...

 

 

 

 

 

 

The parameters given by the list of names are removed from the alias list.

 

unset

[ -f]

name ...

 

 

 

 

 

 

The parameters given by the list of names are unassigned; that is, their values and attri-

 

 

butes are erased.

Read-only variables cannot be unset. If the -foption is set, names

 

 

refer to function names. Unsetting ERRNO, LINENO, MAILCHECK, OPTARG, OPTIND,

 

 

RANDOM, SECONDS, TMOUT, and _ removes their special meaning even if they are subse-

 

 

quently assigned to.

 

 

% wait [ job ]

Wait for the speci®ed job to terminate or stop, and report its status. This status becomes

 

 

the return code for the wait command. If job is not given, wait waits for all currently

 

 

active child processes to terminate or stop. The termination status returned is that of the

 

 

last process. See Jobs for a description of the format of a job.

 

 

HP-UX Release 11i: December 2000

− 16 −

Section 1411

k