The readonly builtin command

Synopsis

readonly [-p] [-a] [-A] [-f] [NAME[=VALUE] ...]

Description

The readonly builtin command is used to mark variables or functions as read-only, which means unchangeable. This implies that it can't be unset anymore. A readonly variable may not be redefined in child scopes. A readonly global may not be redefined as a function local variable. Simple command environment assignments may not reference readonly variables.

Options

Option Description

-a refer to normal arrays -A refer to associative arrays -f refer to functions -p print all read-only variables or functions, -a, -A and -f can be used to filter. The output is reusable as input

An argument of -- disables further option processing.

Return status

Status Reason

0 no error !=0 invalid option !=0 invalid combination of options !=0 a given NAME is invalid

Examples

Portability considerations

in POSIX(r), only the -p option is specified

1.3 KiB Raw Blame History