4.2 Bash 内建命令（Bash Builtin Commands）

这一节所描述的是 Bash 中独有的，或经过扩展的内建命令。其中有一些命令是定义在 POSIX 标准中的。

alias

alias [-p] [name[=value] ...]

如果“alias”命令不带有任何参数或使用了“-p”选项，则将别名列表表示为可用于再次输入的格式输出到标准输出中。如果提供了参数，则为每个给出“value”值的“name”进行别名定义。如果没有给出“value”，则打印出该别名的名称和值。关于别名的描述，请参考 6.6 节《别名》。

bind

bind [-m keymap] [-lpsvPSVX] bind [-m keymap] [-q function] [-u function] [-r keyseq] bind [-m keymap] -f filename bind [-m keymap] -x keyseq:shell-command bind [-m keymap] keyseq:function-name bind [-m keymap] keyseq:readline-command

显示当前读取行（Readline）的键和函数的绑定，或将读取行函数或宏与一个键序列绑定，或设置一个读取行变量。每一个非选项参数是一个命令，其可以出现在读取行初始化文件（参见 8.3《Readline 初始化文件》）中。但每一个绑定或命令必须作为一个分开的参数进行传递；例如，““\C-x\C-r”:re-read-init-file”。

如果下列选项出现，则具有如下含义：

返回状态是零，除非提供了一个无效的选项或出现了一个错误。

builtin

builtin [shell-builtin [args]]

运行一个 shell 内建命令，并将参数“args”传入，最后返回该命令的退出状态。在定义一个与 shell 内建命令重名的函数时，在该函数中保留内建命令的功能时，该命令非常有用。如果“shell-builtin”不是一个内建命令时，会返回非零状态。

caller

caller [expr]

返回任意活动的子程序调用（一个 shell 函数或一个使用“.”或“source”内建命令执行的脚本）的上下文。

不加参数“expr”时，“caller”显示当前子程序调用的行号和源文件名。如果提供的“expr”是一个非负整数，则 caller 显示的是当前执行调用堆栈中相对位置的行号、子程序名称和源文件。这个额外的信息是有用的，例如打印堆栈追踪。当前 frame 是“frame 0”。

返回状态值为零，除非 shell 没有执行一个子程序调用或“expr”没有对应到调用堆栈中的一个有效位置。

command

command [-pVv] command [arguments ...]

运行带有“arguments”参数的“command”命令，忽略任何和参数“command”相同名称的函数。只执行 shell 内建命令或在 PATH 变量中搜索到的命令。如果有一个 shell 函数，其名称是 ls，在函数中运行“command ls”就会执行外部命令 ls，而不是递归调用该函数。“-p”选项的含义是使用变量 PATH 为默认值，用于确保可找到所有的标准命令工具。如果找不到要运行的命令或出现了一个错误，则返回状态值为 127，否则返回命令“command”的退出状态。

如果提供了“-V”或“-v”选项，则打印命令“command”的描述。“-v”选项使用单一单词来表示调用“command”的命令名或文件名；“-V”选项则产生更多的说明。在这种情况下，如果找到命令则返回状态零，否则返回非零。

declare

declare [-aAfFgiIlnrtux] [-p] [name[=value] ...]

声明变量并给其设置属性。如果没有给出变量名，则显示所有变量的值。

“-p”选项用于显示每个“name”所代表的变量的值和属性。当使用“-p”选项时还带有“name”参数，其它附加选项除了“-f”和“-F”之外，都会被忽略。

当出现“-p”选项并且未给出“name”参数时，“declare”将会显示带有由其它选项指定的属性的所有变量的属性和变量值。如果在使用“-p”时没有其它选项出现，则“declare”显示所有变量的属性和值。“-f”选项用于只显示 shell 函数。

“-F”选项不会显示函数定义，仅显示函数名和属性。如果使用“shopt”命令开启了 shell 选项“extdebug”，将显示每个“name”的定义所在的源文件名和所在行数。

即使当“declare”执行在 shell 函数内部，“-g”选项也会在全局作用域强制创建或修改变量。但在其它情况下，该选项会被忽略。

“-I”选项会使本地变量继承自附近作用或中具有相同“name”名的现有变量的属性（“nameref”属性除外）和值。如果没有现有变量存在，本地变量在初始时重置。

下列选项常用于对带有指定属性的变量进行限制输出或给出变量属性：

使用加号“+”替换选项前面的减号“-”来关闭属性。但例外是“+a”和“+A”不能用于摧毁数组变量，“+r”不能用于移除只读属性。在函数中使用“declare”时，其会将每个“name”变量本地化，就像使用了“local”命令一样，但使用“-g”选项时除外。如果一个变量名后跟随着“=value”，则该变量的值将设置为“value”。

当使用“-a”或“-A”和复合赋值语法来创建数组变量时，直到后继赋值发生时附加属性才会生效。

返回状态为零，除非下列情况发生：

• 试图使用“-f foo=bar”形式定义一个函数。
• 试图对只读变量进行赋值。
• 试图在不使用复合赋值语法情况下对数组变量进行赋值（参见 6.7《数组》）。
• 变量名“name”不是一个有效的 shell 变量名。
• 试图关闭只读变量的只读属性。
• 试图关闭数组变量的数组属性。
• 试图使用“-f”选项显示一个不存在的函数。

echo

echo [-neE] [arg ...]

使用空格作为分隔符和使用换行作为终止符来输出参数“arg”。返回状态为零，除非出现一个写错误。如果指定了“-n”，则抑制尾部的换行。如果给出“-e”选项，则开启反斜线转义字符解释器。“-E”选项则是关闭反斜线转义字符解释器，即使系统默认对其转义。shell 选项“xpg_echo”默认可以用来动态确定 echo 是否对转义字符进行转义扩展。“echo”不会将“—”解释为选项结束。

下列是“echo”解释转义列表：

enable

enable [-a] [-dnps] [-f filename] [name ...]

用于开启或禁用 shell 内建命令。禁用一个内建命令可以使一个与该内建命令同名的外部命令直接执行，而不用指定完整路径，即使 shell 通常情况下在搜索外部命令前先对内建命令进行搜索。如果使用了“-n”选项，则禁用“name”参数所代表的内建命令。否则，则是开启该内建命令。例如，要直接使用一个在“$PATH”中叫 test 的外部命令而不是 shell 的内建命令 test 时，先键入“enable -n test”来禁用内建命令。

如果“-p”选项出现，或没有给出 name 参数，则打印 shell 内建命令列表。不带有其它参数时，列表所包含的是所有开启的 shell 内建命令。“-a”选项意味着列出的内建命令列表具有指示该命令是处于开启还是关闭状态。

在支持动态加载的系统中，“-f”选项意味着从共享对象 filename 中加载新内建命令。“-d”选项会删除使用“-f”选项加载进来的内建命令。

如果没有选项出现，则显示一个 shell 内建命令列表。“-s”选项只显示 POSIX 特定的内建命令。如果在使用“-s”的同时加入“-f”，则新加载的内建命令就变为特定内建命令。

返回状态为零，除非“name”不是一个 shell 内建命令或从共享对象中加载新内建命令时出错。

help

help [-dms] [pattern]

显示关于内建命令的帮助信息。如果指定了“pattern”，“help”则给出所有匹配“pattern”的命令的详细帮助。否则将打印内建命令列表。

如果出现选项，则具有以下含义：

返回状态为零，除非“pattern”没有匹配到任何命令。

let

let expression [expression ...]

内建命令“let”允许在 shell 变量上执行算术运算。每一个表达式“expression”可以依据下面 6.5 节《Shell 算术运算》中的规则进行表达式运算。如果最后一个表达式运算结果为 0，则“let”返回 1；否则返回 0。

local

local [option] name[=value] ...

对于命令中的每一个参数，会创建以“name”命名的本地变量，并将“value”赋值给它。“declare”命令的所有选项是该命令可接受的选项。“local”只能用于函数内部；它将变量“name”的作用域设置为在该函数和其子函数中可见。如果“name”是“-”，则 shell 选项集合只作用于调用“local”命令的函数内部：在函数内部使用“set”内建命令所改变的 shell 选项，会在函数返回时将其还原到初始值。还原操作所产生的作用就像使用“set”命令将选项值设置为函数调用之前的状态一样。返回状态为零，除非在函数外部使用了“local”命令，或提供了一个无效的“name”，或“name”是一个只读变量。

logout

logout [n]

退出已登录的 shell，向 shell 的父进程返回状态“n”。

mapfile

mapfile [-d delim] [-n count] [-O origin] [-s count] [-t] [-u fd] [-C callback] [-c quantum] [array]

从标准输入读取多行并存入索引数组变量“array”中。如果提供了“-u”选项，则从文件描述符“fd”中读取。变量 MAPFILE 是默认的数组“array”。如果提供了选项，则具有下列含义：

如果在指定了“-C”时未指定“-c”，则默认的配额“quantum”为 5000。当执行“callback”时，其提供要分配的下一个数组元素的索引位置，并且将分配给那个元素的行作为附加参数。在行读取后，将其分配给数组元素之前运行“callback”。

如果没有明确给出“origin”位置，“mapfile”会在数组“array”赋值前将其清空。

“mapfile”返回成功状态，除非提供了一个无效的选项或选项参数，或数组是无效的或不可被赋值的，或数组不是索引数组。

printf

printf [-v var] format [arguments]

按照“format”的格式将格式化后的“arguments”写入到标准输出。“-v”选项会将要打印到标准输出的结果分配到变量“var”中。

“format”的格式是包含了三种对象类型的字符串：明文字符，可直接复制到标准输出；字符转义序列，转换后复制到标准输出；格式规范，每个规范都会打印后面的连续参数“argument”。

除了 printf(1)中的标准格式，printf 还会解释下列扩展：

“%b”、“%q”和“%T”可以在格式规范中指定字段的宽度和精度，并且扩展后的参数需要比原始值使用更多字节（或更宽的字段）来表示这一字段，通常所包含的字符要多于原始字符。

除了开头允许使用加号“+”或减号“-”，对于非字符串格式标识符的参数都被视为 C 语言常量。并且如果开头的字符是单引号或双引号，则后面跟随的字符值是 ASCII 值。

“format”参数按需求对所有“arguments”参数进行格式化。如果“format”需要的参数个数比“arguments”提供的个数要多的话，格式化规范行为就会为所需的额外参数提供适当的 0 值或空字符串。命令成功的返回值是零，失败为非零值。

read

read [-ers] [-a aname] [-d delim] [-i text] [-n nchars] [-N nchars] [-p prompt] [-t timeout] [-u fd] [name ...]

从标准输入或从“-u”选项提供的参数“fd”代表的文件描述符中读取一行。之后使用在 3.5.7《单词分割》中描述的规则进行单词分割，并且将第一个单词分配给第一个“name”参数，将第二个单词分配给第二个“name”参数，以此例推。如果单词个数多于“name”个数，则多余的单词和其之间的分隔符都分配给最后一个“name”参数。如果单词个数少于“name”个数，则剩余“name”参数将被分配为空（empty）值。使用变量“IFS”中的字符将读取行中的单词分割，其分割规则是与 shell 用于扩展分割的一样（参见 3.5.7《单词分割》）。可以使用反斜线“\”移除其后面一个字符的特殊含义和用于行的继续读取。

如果出现下列选项，则具有以下含义：

如果没有给出“name”参数，不包含尾部分隔符的未做任何更改的读取行将分配给变量 REPLY。正常退出状态为零，除非遭遇“end-of-file”，或“read”超时（在这种情况下返回值大于 128），或变量赋值出错（例如对读取变量进行赋值），或在“-u”选项使用时给出了一个无效的文件描述符。

readarray

readarray [-d delim] [-n count] [-O origin] [-s count] [-t] [-u fd] [-C callback] [-c quantum] [array]

从标准输入读取行，或如果使用了“-u”选项则从文件描述符读取，之后存入索引数组变量“array”中。与“mapfile”命令相同。

source

source filename

与 Bourne Shell 内建命令“.”相同。

type

type [-afptP] [name ...]

对于每一个给出的“name”参数，如果将其用做一个命令名，则对其进行解释说明。

如果使用了“-t”选项，“type”则打印“alias”、“function”、“builtin”、“file”或“keyword”其中的一个单词来表示该命令是一个别名、shell 函数、shell 内建命令、磁盘文件或是一个保留字。如果找不到“name”，则不会打印任何信息，并且返回失败状态。

如果使用了“-p”选项，“type”会返回“name”代表的可执行的磁盘文件名，或如果“name”在使用“-t”时返回的不是一个“file”类型，则什么都不返回。

“-P”选项对每一个“name”参数在 PATH 路径中进行强制搜索，即使该在使用“-t”时不会返回“file”类型。

如果一个命令已经被缓冲到哈希表中，“-p”和“-P”则打印这个哈希值，这并不需要该文件首先出现在“$PATH”中。

如果“-a”选项出现，“type”会将所有包含可执行的“name”文件位置返回。当且仅当同时没有“-p”选项出现，其还会列出别名和函数。

如果“-f”选项出现，“type”不会试图去寻找 shell 函数。

如果所有“name”参数都找到，则返回状态零。如果有一个没有找到，则返回非零。

typeset

typeset [-afFgrxilnrtux] [-p] [name[=value] ...]

“typeset”命令是用于兼容 Korn shell。它与内建命令“declare”用法类似。

ulimit

ulimit [-HS] -a ulimit [-HS] [-bcdefiklmnpqrstuvxPRT] [limit]

如果系统允许的话，“ulimit”可通过可用资源提供对 shell 启动的进程进行控制。如果给出下列选项，则具有下列含义：

如果给出“limit”参数，并且没有使用“-a”选项，则“limit”则是指定资源的新值。“limit”特殊值“hard”、“soft”和“unlimited”分别代表当前的硬限制、当前的软限制和没有限制。一旦设置了一个硬限制，其不能被非根用户进行增量设置；软限制最大可以增加到硬限制的值。否则，除非提供“-H”选项，则只打印所指定资源的软限制当前值。当指定了多于一个的资源，如果所提供的限制名称和单位正确，则打印在其值的前面。当在设置新限制时，如果“-H”和“-S”选项都没有出现，则对硬、软两种限制都进行设置。如果没有选项给出，则假定为使用了“-f”选项。所有的值是以 1024 字节为一个增量单位，除了“-t”是使用的秒为单位；“-R”是使用毫秒；“-p”是使用 512 字节块为单位；“-P”、“-T”、“-b”、“-k”、“-n”和“-u”则是没有设定增量单位；并且，当在 POSIX 模式中，“-c”和“-f”则是使用 512 字节作为增量单位。

正常返回状态为零，除非给出了一个无效选项或参数，或当设置新限制时出现了一个错误。

unalias

unalias [-a] [name ... ]

从别名列表中删除给出的每一个“name”参数所代表的别名。如果“-a”选项出现，则删除所有别名。在 6.6《别名》一节有对别名的详细说明。