Simple Commands¶

Простая команда simple command - это последовательность необязательных переменных, за которыми следуют слова (разделенные пробелом blank) и перенаправления, которые завершаются управляющим оператором control operator. Первое слово определяет команду, которая должна быть выполнена. Это слово передается в качестве нулевого аргумента. Остальные слова передаются в качестве аргументов вызываемой команды.

Возвращаемое значение простой команды simple command - это статус её завершения или 128+n, если команда завершается по сигналу n.

Pipelines¶

Конвейер (канал) pipeline представляет собой последовательность из одной или нескольких команд, разделенных одним из управляющих операторов | или |&. Формат конвейера следующий:

Стандартный вывод команды command1 подключен через канал к стандартному вводу команды command2. Это подключение выполняется перед любыми перенаправлениями, указанными в command1(смотрите раздел ПЕРЕНАПРАВЛЕНИЕ ниже). Если |& является оператором конвейера, то стандартная ошибка команд command1, в дополнение к ее стандартному выходу, связана со стандартным входом команд command2 через конвейер. Это сокращение от 2>&1 |. Это неявное перенаправление стандартной ошибки на стандартный выход выполняется после любых перенаправлений, указанных в command1.

Возвращаемый статус конвейера - это статус завершения последней команды, если только не включена опция pipefail. Если опция pipefail включена, то статус возврата конвейера равен значению последней (самой правой) команды, которая завершается с ненулевым статусом или нулю, если все команды завершаются успешно. Если зарезервированное слово ! предшествует конвейеру, то статус завершения этого конвейера является логическим отрицанием статуса завершения, как описано выше. Если конвейер выполняется синхронно, то оболочка ожидает завершения всех команд в конвейере, прежде чем возвратить значение.

Если зарезервированное слово time предшествует конвейеру, то оболочка сообщает о прошедшем времени, а также о пользовательском и системном времени, затраченном на его выполнение, когда конвейер завершается. Опция -p изменяет формат вывода на указанное POSIX . Когда оболочка находится в режиме posix, то она не распознает time как зарезервированное слово, если следующий токен начинается с “-”. Значение переменной TIMEFORMAT представляет собой строку формата, которая определяет, как должна отображаться информация о времени. Смотрите описание переменной TIMEFORMAT ниже в подразделе Переменные оболочки.

Когда оболочка находится в режиме posix, time может отображаться само по себе как единственное слово в простой команде. В этом случае оболочка отображает общее пользовательское и системное время, затраченное оболочкой и ее дочерними элементами. Переменная TIMEFORMAT определяет формат информации о времени.

Каждая команда в конвейере с несколькими командами, где создаются конвейеры, выполняется в подоболочке subshell, которая является отдельным процессом. Описание подоболочек и среды подоболочек приведено в разделе СРЕДА ВЫПОЛНЕНИЯ КОМАНД. Если опция lastpipe включена с помощью встроенной команды shopt (смотрите описание shopt ниже), а управление заданиями не активировано, то последний элемент конвейера может быть запущен процессом оболочки.

Списки¶

Список list - это последовательность из одного или нескольких конвейеров, разделенных одним из операторов ;, &, && или || и необязательно завершающихся одним из ;, & или <newline>.

В этом списке операторы && и || имеют одинаковый приоритет, а за ними следуют операторы ; и &, которые также имеют одинаковый приоритет.

Вместо точки с запятой для разделения команд в списке list может присутствовать последовательность из одной или нескольких новых строк.

Если команда завершается управляющим оператором &, то оболочка выполняет команду в фоновом режиме background в подоболочке. Оболочка не ожидает завершения команды и возвращаемый статус равен 0. Они называются асинхронными asynchronous командами. Команды, разделенные символом ;, выполняются последовательно; оболочка ожидает завершения выполнения каждой команды по очереди. Статус возврата - это статус завершения последней выполненной команды.

Списки И и ИЛИ представляют собой последовательности из одного или нескольких конвейеров, разделенных управляющими операторами && и ||, соответственно. Списки И и ИЛИ выполняются с левой ассоциативностью. Список И имеет вид

command2 выполняется тогда и только тогда, когда command1 возвращает нулевой статус завершения (успех).

Список ИЛИ имеет вид

Команда command2 выполняется тогда и только тогда, когда команда command1 возвращает ненулевой статус завершения. Возвращаемый статус списков И и ИЛИ - это статус завершения последней команды, выполненной в списке.

Compound Commands¶

Составная команда compound command - это одна из следующих команд. В большинстве случаев список list в описании команды может быть отделен от остальной части команды одной или несколькими символами новой строки, за которыми может следовать новая строка вместо точки с запятой.

(list)

Список list выполняется в подоболочке (описание окружающей среды подоболочки приведено в разделе СРЕДА ВЫПОЛНЕНИЯ КОМАНД ниже). Назначение переменных и встроенные команды, влияющие на окружающую среду команды, перестают действовать после завершения выполнения команды. Статус возврата - это статус выхода из списка list.

{ list; }

Список list выполняется в текущей среде командной строки. list должен завершаться новой строкой или точкой с запятой. Это называется групповая команда group command. Статус возврата - это статус завершения списка list.

Обратите внимание, что в отличие от метасимволов ( и ), метасимволы { и } являются зарезервированными словами reserved words и должны встречаться там, где разрешено распознавание зарезервированных слов. Поскольку они не приводят к разрыву слов, то они должны быть отделены от списка listпробелом или другим метасимволом оболочки.

((expression))

Арифметическое выражение expression вычисляется в соответствии с правилами, описанными ниже в разделе АРИФМЕТИЧЕСКИЕ ВЫЧИСЛЕНИЯ. Если значение выражения не равно нулю, то статус возврата равен 0; в противном случае статус возврата равен 1. Выражение expression расширяется так же, как если бы оно было заключено в двойные кавычки, но неэкранированные символы двойных кавычек в expression не обрабатываются специальным образом и удаляются. Поскольку это потенциально может привести к появлению пустых строк, эта команда обрабатывает их как выражения, значение которых равно 0.

[[ expression ]]

Вычислить условное выражение expression и вернуть нулевой (true) или ненулевой (false) статус. Выражения состоят из основных элементов, описанных ниже в разделе УСЛОВНЫЕ ВЫРАЖЕНИЯ. Слова между [[ и ]] не разделяются на слова и не расширяются названием пути. Оболочка выполняет расширение тильдой, расширение параметров и переменных, арифметическое расширение, замену команд, замену процессов и удаление кавычек в этих словах. Условные операторы, такие как -f, должны быть без кавычек, чтобы их можно было распознать как основные.

При использовании совместно с [[ операторы < и > выполняют лексикографическую сортировку с использованием текущей локали.

Смотрите описание встроенной команды test (в разделе ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ) при обработке параметров (т.е. отсутствующих параметров).

Когда используются операторы == и !=, строка справа от оператора считается шаблоном и сопоставляется в соответствии с правилами, описанными ниже в подразделе Сопоставление с шаблоном, как если бы была включена опция оболочки extglob. Оператор = эквивалентен ==. Если включена опция оболочки nocasematch, то сопоставление выполняется без учета регистра буквенных символов. Возвращаемое значение равно 0, если строка соответствует (==) или не соответствует (!=) шаблону, и 1 в противном случае. Если какая-либо часть шаблона заключена в кавычки, заключенная в кавычки часть сопоставляется как строка: каждый символ в заключенной в кавычки части соответствует сам себе, вместо того чтобы иметь какое-либо специальное значение для сопоставления с шаблоном.

Доступен дополнительный двоичный оператор =~, имеющий тот же приоритет, что и == и !=. При его использовании строка справа от оператора считается POSIX расширением регулярного выражения и соответствующим образом согласованным (используя интерфейсы POSIX regcomp и regexec, обычно описываемым в regex(3)). Возвращаемое значение равно 0, если строка соответствует шаблону, и 1 в противном случае. Если регулярное выражение синтаксически некорректно, возвращаемое значение условного выражения равно 2. Если включена опция оболочки nocasematch, сопоставление выполняется без учета регистра буквенных символов.

Если какая-либо часть шаблона заключена в кавычки, то часть, заключенная в кавычки, сопоставляется буквально, как указано выше. Если шаблон хранится в переменной оболочки, то при расширении переменной, заключенной в кавычки, весь шаблон должен быть сопоставлен буквально. Внимательно относитесь к выражениям в квадратных скобках в регулярных выражениях, поскольку обычные кавычки и шаблонные символы теряют свое значение между квадратными скобками.

Совпадение завершается успешно, если шаблон соответствует какой-либо части строки. Закрепите шаблон с помощью операторов регулярных выражений ^ и $, чтобы заставить его соответствовать всей строке.

Переменная массива BASH_REMATCH записывает, какие части строки соответствуют шаблону. Элемент BASH_REMATCH с индексом 0 содержит часть строки, соответствующую всему регулярному выражению. Подстроки, соответствующие вложенным в скобки выражениям в регулярном выражении, сохраняются в остальных индексах BASH_REMATCH. Элемент BASH_REMATCH с индексом n - это часть строки, соответствующая n-му подвыражению, заключенному в круглые скобки. Bash устанавливает значение BASH_REMATCH в глобальной области видимости; объявление его как локальной переменной приведет к неожиданным результатам.

Выражения могут быть объединены с помощью следующих операторов, перечисленных в порядке убывания приоритета:

for name [ [ in word ... ] ; ] do list ; done

Сначала расширяется список слов, следующих за in, генерируя список элементов. Затем переменная name присваивается каждому элементу этого списка по очереди, и list выполняется каждый раз. Если in word опущены, то команда for выполняет list один раз для каждого установленного позиционного параметра (смотрите раздел ПАРАМЕТРЫ ниже). Статус возврата - это статус завершения последней выполненной команды. Если при расширении списка элементов, следующих за in, список (list) пуст, то команды не выполняются, и статус возврата равен 0.

for (( expr1 ; expr2 ; expr3 )) [;] do list ; done

Сначала вычислить арифметическое выражение expr1 в соответствии с правилами, описанными ниже в разделе АРИФМЕТИЧЕСКИЕ ВЫЧИСЛЕНИЯ. Затем повторно вычислить арифметическое выражение expr2, пока оно не станет равным нулю. Каждый раз, когда значение expr2 принимает ненулевое значение, выполнить list и вычислить арифметическое выражение expr3. Если какое-либо выражение опущено, то оно ведет себя так, как будто его значение равно 1. Возвращаемое значение - это статус завершения последней выполненной команды в списке list или ненулевое значение, если какое-либо из выражений является недопустимым.

Использовать встроенные команды break и continue (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже) для управления выполнением цикла.

select name [ in word ] ; do list ; done

Сначала раскрыть список слов, следующих за in, создав список элементов, и вывести набор развернутых слов в стандартную ошибку, при этом каждому из набора предшествует номер. Если in word пропущено, то вывести позиционные параметры (смотрите раздел ПАРАМЕТРЫ ниже). Затем select отобразит запрос PS3 и считает строку из стандартного ввода. Если строка содержит число, соответствующее одному из отображаемых слов, то select устанавливает значение name для этого слова. Если строка пуста, то select снова отображает слова и запрашивает запрос. Если EOF считан, то select завершает работу и возвращает значение 1. Для любого другого значения name устанавливается значение нольl. Прочитанная строка сохраняется в переменной REPLY. Команда list выполняется после каждого выбора, пока не будет выполнена команда break. Статус завершения команды select - это статус завершения последней команды, выполненной в list, или нулевой, если команды не были выполнены.

case word in [ [(] pattern [ | pattern ] ... ) list ;; ] ... esac

Команда case сначала разворачивает слово word и пытается сопоставить его с каждым шаблоном pattern по очереди, начиная с первого к последнему, используя правила сопоставления, описанные в подразделе Сопоставление с шаблоном ниже. Список шаблонов - это набор из одного или нескольких шаблонов, разделенных символами , а оператор ) завершает список шаблонов. Слово word расширяется с помощью тильды, параметров и переменных, арифметического расширения, подстановки команд, подстановки процессов и удаления кавычек. Каждый шаблон pattern расширяется с помощью тильды, параметров и переменных, арифметического расширения, подстановки команд, подстановки процессов и удаления кавычек. Если включена опция оболочки nocasematch, то сопоставление выполняется без учета регистра буквенных символов. Предложение clause - это список шаблонов и связанный с ним список list.

Когда найдено совпадение, команда case выполняет соответствующую команду из списка list. Если оператор ;; завершает предложение case, то команда case завершается после первого совпадения. Использование ;& вместо ;; приводит к продолжению выполнения list, связанного списком шаблонов. Использование ;;& вместо ;; приводит к тому, что оболочка проверяет следующий список шаблонов, если таковой имеется, и выполняет любой связанный с list, если совпадение завершается успешно, продолжая выполнение команды case, как если бы список шаблонов не совпадал. Статус выхода равен нулю, если ни один шаблон не совпадает.

В противном случае это статус завершения последней команды, выполненной в последнем списке list.

if list; then list; [ elif list; then list; ] ... [ else list; ] fi

Выполняется if list. Если ее статус завершения равен нулю, то выполняется then list. В противном случае каждый elif list выполняется по очереди, и если его статус завершения равен нулю, то выполняется then list и команда завершается. В противном случае выполняется else list, если это присутствует. Статус завершения - это статус завершения последней выполненной команды или ноль, если ни одно из условий не является истинным.

while list-1; do list-2; done

until list-1; do list-2; done

Команда while непрерывно выполняет список list-2 до тех пор, пока последняя команда в списке list-1 не вернет нулевой статус завершения. Команда until идентична команде while, за исключением того, что проверка отменяется: list-2 выполняется до тех пор, пока последняя команда в list-1 не вернет ненулевой статус завершения. Статус завершения команд while и until - это статус завершения последней команды, выполненной в list-2, или ноль, если ни одна из них не была выполнена.

Coprocesses¶

Сопроцесс coprocess - это команда оболочки, перед которой стоит зарезервированное слово coproc. Сопроцесс выполняется асинхронно в подоболочке, как если бы команда была завершена с помощью управляющего оператора &, при этом между исполняющей оболочкой и сопроцессом устанавливается двусторонняя связь.

Синтаксис для сопроцесса следующий:

При этом создается сопроцесс с названием NAME. Команда command может быть как простой, так и составной командой (смотрите выше). NAME - это наименование переменной оболочки. Если NAME не указано, то по умолчанию используется наименование COPROC.

Рекомендуемая форма для использования в сопроцессе - это

Эта форма предпочтительнее, поскольку простые команды приводят к тому, что сопроцесс всегда называется COPROC, и она проще в использовании и более полная, чем другие составные команды.

Если command является составной командой, то NAME является необязательным. Слово, следующее за coproc, определяет, интерпретируется ли это слово как название переменной: оно интерпретируется как NAME, если это не зарезервированное слово, которое вводит составную команду. Если command является простой командой, то NAME не допускается; это делается для того, чтобы избежать путаницы между NAME и первым словом простой команды.

Когда выполняется сопроцесс, оболочка создает переменную массива (смотрите подраздел Массивы ниже) с названием NAME в контексте исполняющей оболочкой. Стандартный вывод command подключается по конвейеру к файловому дескриптору в исполняющей оболочке, и этому файловому дескриптору присваивается значение NAME[0]. Стандартный ввод command подключается по конвейеру к файловому дескриптору в исполняющей оболочке, и этот файловый дескриптор присваивается NAME[1]. Этот конвейер устанавливается перед любыми перенаправлениями, указанными командой (смотрите раздел ПЕРЕНАПРАВЛЕНИЕ ниже). Файловые дескрипторы могут использоваться в качестве аргументов для команд оболочки и перенаправлений с использованием стандартных расширений слов. Файловые дескрипторы, кроме тех, которые созданы для выполнения команд и обработки подстановок, недоступны в подоболочках.

Идентификатор процесса оболочки ID, созданный для выполнения сопроцесса, доступен в виде значения переменной NAME_PID. Встроенная команда wait может использоваться для ожидания завершения сопроцесса.

Поскольку сопроцесс создается как асинхронная команда, то команда coproc всегда возвращает результат успешно. Возвращаемый статус сопроцесса - это статус завершения command.

Определения функций оболочки¶

Функция оболочки - это объект, который вызывается как простая команда и выполняет сложную команду с новым набором позиционных параметров. Функции оболочки объявляются следующим образом:

fname () compound-command [redirection]

function fname [()] compound-command [redirection]

Это определяет функцию с названием fname. Зарезервированное слово function необязательно. Если указано зарезервированное слово function, то скобки необязательны. Тело функции body - это составная команда compound-command (смотрите подраздел Составные команды выше). Эта команда обычно представляет собой список команд list между { и }, но может быть любой командой, указанной в подразделе Составные команды выше. Если используется зарезервированное слово function, но скобки не указаны, то рекомендуется использовать фигурные скобки. Составная команда compound-command выполняется всякий раз, когда fname указано в качестве названия простой команды. В режиме posix name должно быть допустимым названием для оболочки и не может быть названием одного из POSIX special builtins. В режиме по умолчанию названием функции может быть любое слово без кавычек, которое не содержит $.

Любые перенаправления (смотрите раздел ПЕРЕНАПРАВЛЕНИЕ ниже), указанные при определении функции, выполняются при ее выполнении.

Статус завершения определения функции равен нулю, если только не возникает синтаксическая ошибка или функция с таким же названием, доступная только для чтения, уже не существует. При выполнении статус завершения функции равен статусу завершения последней команды, выполненной в её еле (смотрите раздел ФУНКЦИИ ниже).

Перевод строк¶

Строка, заключенная в двойные кавычки, перед которой стоит знак доллара ($"string"), переводится в соответствии с текущей локалью. Инфраструктура gettext выполняет поиск и преобразование, используя переменные оболочки LC_MESSAGES, TEXTDOMAINDIR и TEXTDOMAIN. Если текущей локалью является C или POSIX, и если перевод недоступен или если строка не переведена, то знак доллара игнорируется, а строка обрабатывается как заключенная в двойные кавычки, как описано выше. Это форма двойных кавычек, поэтому строка по умолчанию остается заключенной в двойные кавычки независимо от того, переведена она и заменена или нет. Если опция noexpand_translation включена с помощью встроенной функции shopt, то переведенные строки заключаются в одинарные, а не в двойные кавычки. Смотрите описание команды shopt ниже в разделе ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ.

Позиционные параметры¶

Позиционный параметр positional parameter - это параметр, обозначаемый одной или несколькими цифрами, отличными от цифры 0. Позиционные параметры назначаются из аргументов командной строки при ее вызове и могут быть переназначены с помощью встроенной команды set. Позиционные параметры не могут быть назначены с помощью команды присваивания. Позиционные параметры временно заменяются при выполнении функции оболочки (смотрите раздел ФУНКЦИИ ниже).

Если позиционный параметр, состоящий более чем из одной цифры, раскрывается, то он должен быть заключен в фигурные скобки (смотрите раздел РАСШИРЕНИЕ ниже). Без фигурных скобок цифра, следующая за $, может относиться только к одному из первых девяти позиционных параметров ($1-$9) или к специальному параметру $0 (смотрите следующий раздел).

Специальные параметры¶

Оболочка обрабатывает несколько параметров особым образом. На эти параметры можно только ссылаться; присвоение им значений запрещено. Специальные параметры обозначаются одним из следующих символов.

*

($*) Расширяется до позиционных параметров, начиная с единицы. Если расширение не заключено в двойные кавычки, каждый позиционный параметр расширяется до отдельного слова. В контекстах, где выполняется расширение слов, эти слова подлежат дальнейшему разбиению на слова и расширению названия пути. Когда расширение происходит в двойных кавычках, оно расширяется до одного слова со значением каждого параметра, разделенного первым символом переменной IFS. То есть, "$*" эквивалентно "$1c$2c...", где c - это первый символ значения переменной IFS. Если значение IFS не задано, то параметры разделяются пробелами. Если значение IFS равно ноль, то параметры объединяются без промежуточных разделителей.

@

($@) Расширяется до позиционных параметров, начиная с единицы. В контекстах, где выполняется разбиение слов, это расширяет каждый позиционный параметр до отдельного слова; если они не заключены в двойные кавычки, эти слова подлежат разбиению на слова. В контекстах, где разделение слов не выполняется, например, в части значений оператора присваивания, оно расширяется до одного слова, при этом каждый позиционный параметр разделяется пробелом. Когда расширение происходит в двойных кавычках и выполняется разделение слов, каждый параметр расширяется до отдельного слова. Таким образом, "$@" эквивалентно "$1" "$2" ... Если в слове используется расширение в двойных кавычках в пределах слова расширение первого параметра соединяется с расширением начальной части исходного слова, а расширение последнего параметра соединяется с расширением последней части исходного слова. Когда позиционных параметров нет, "$@" и $@ расширяются до нуля (т.е. удаляются).

#

($#) Расширяется до количества позиционных параметров в десятичной системе счисления.

?

($?) Расширяется до статуса завершения последней выполненной команды.

-

($-) Расширяется до флагов текущей опции, указанных при вызове встроенной командой set или установленных самой оболочкой (например, опцией -i).

$

($$) Расширяется до идентификатора процесса ID оболочки. В подоболочке он расширяется до идентификатора процесса родительской оболочки, а не подоболочки.

!

($!) Расширяется до идентификатора процесса задания, которое последним было переведено в фоновый режим, независимо от того, выполняется ли оно как асинхронная команда или с использованием встроенной команды bg (смотрите раздел УПРАВЛЕНИЕ ЗАДАНИЕМ ниже).

0

($0) Расширяется до названия оболочки или сценария оболочки. Это значение задается при инициализации оболочки. Если bash вызывается файлом команд, то $0 присваивается название этого файла. Если bash запускается с опцией -c, то $0 присваивается значение первого аргумента после строки, которая должна быть выполнена, если таковая присутствует. В противном случае ей присваивается значение названия файла, используемого для вызова bash, как указано в нулевом аргументе.

Переменные оболочки¶

Оболочка устанавливает следующие переменные:

_

($_, символ подчеркивания) Это слово имеет несколько значений в зависимости от контекста. При запуске оболочки _ задается как путь, используемый для вызова оболочки или исполняемого сценария оболочки, который передается в окружающей среде или в списке аргументов. Впоследствии, после расширения, он расширяется до последнего аргумента предыдущей простой команды, выполненной на переднем плане. Также устанавливается полный путь, используемый для вызова каждой команды, которая выполняется и помещается в окружающую среду, экспортируемую для этой команды. При проверке почты $_ расширяется до названия проверяемого в данный момент почтового файла.

BASH

Расширяется до полного названия файла, используемого для вызова этого экземпляра bash.

BASHOPTS

Список включенных опций оболочки, разделенных двоеточием. Каждое слово в списке является допустимым аргументом для опции -s для встроенной команды shopt (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже). Опции, отображаемые в BASHOPTS, - это те, о которых shopt сообщает как о on. Если эта переменная присутствует в окружающей среде при запуске bash, то оболочка включает каждую опцию в списке перед чтением любых файлов запуска. Если эта переменная экспортирована, то дочерние оболочки будут включать каждую опцию в списке. Эта переменная доступна только для чтения.

BASHPID

Расширяется до идентификатора ID текущего процесса bash. Это отличается от $$ при определенных обстоятельствах, например, для подоболочек, которые не требуют повторной инициализации bash. Присвоение BASHPID не имеет никакого эффекта. Если значение BASHPID не задано, то оно теряет свои специальные свойства, даже если впоследствии оно будет сброшено.

BASH_ALIASES

Переменная ассоциативного массива, элементы которой соответствуют внутреннему списку псевдонимов, поддерживаемому встроенной командой alias. Элементы, добавленные в этот массив, отображаются в списке псевдонимов; однако сброс настроек элементов массива в настоящее время не приводит к удалению псевдонимов из списка псевдонимов. Если значение BASH_ALIASES не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_ARGC

Переменная массива, значения которой представляют собой количество параметров в каждом кадре текущего стека вызовов для выполнения bash. Количество параметров текущей подпрограммы (функции оболочки или сценария, выполняемого с помощью команд . или source) находится в верхней части стека. Когда выполняется подпрограмма, количество переданных параметров записывается в BASH_ARGC. Оболочка устанавливает значение BASH_ARGC только в режиме расширенной отладки (смотрите описание опции extdebug для встроенной команды shopt ниже). Установка extdebug после того, как оболочка начала выполнять сценарий, или обращение к этой переменной, когда значение extdebug не задано, может привести к несогласованным значениям. Присвоения BASH_ARGC не имеют никакого эффекта и оно не может быть отменено.

BASH_ARGV

Переменная массива, содержащая все параметры текущего стека вызовов для выполнения bash. Последний параметр последнего вызова подпрограммы находится в верхней части стека; первый параметр начального вызова находится в нижней части стека. Когда выполняется подпрограмма, оболочка помещает предоставленные параметры в BASH_ARGV. Оболочка устанавливает значение BASH_ARGV только в режиме расширенной отладки (смотрите описание параметра extdebug для встроенной команды shopt ниже). Установка extdebug после того, как оболочка начала выполнять сценарий, или обращение к этой переменной, когда значение extdebug не задано, может привести к несогласованным значениям. Присвоения BASH_ARGV не имеют никакого эффекта и оно не может быть отменено.

BASH_ARGV0

При обращении к этой переменной она расширяется до названия оболочки или сценария оболочки (идентично $0; смотрите описание специального параметра 0 выше). Присвоение значения BASH_ARGV0 присваивает $0 то же значение. Если значение BASH_ARGV0 не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_CMDS

Переменная ассоциативного массива, элементы которой соответствуют внутренней хэш-таблице команд, поддерживаемой встроенной командой hash. Добавление элементов в этот массив приводит к их отображению в хэш-таблице; однако удаление элементов массива в настоящее время не приводит к удалению названий команд из хэш-таблицы. Если значение BASH_CMDS не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_COMMAND

Расширяется до команды, которая выполняется в данный момент или вот-вот будет выполнена, если только оболочка не выполняет команду в результате перехвата, и в этом случае это команда, выполняющаяся во время перехвата. Если значение BASH_COMMAND не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_EXECUTION_STRING

Аргумент команды для опции вызова -c.

BASH_LINENO

Переменная массива, элементами которой являются номера строк в исходных файлах, в которых был вызван каждый соответствующий элемент FUNCNAME. ${BASH_LINENO[$i]} - это номер строки в исходном файле (${BASH_SOURCE[$i+1]}), где ${FUNCNAME[$i]} был вызван (или ${BASH_LINENO[$i-1]}, если на него ссылаются в другой функции оболочки). Используйте LINENO, чтобы получить текущий номер строки. Присвоение BASH_LINENO не имеет никакого эффекта и не может быть отменено.

BASH_LOADABLES_PATH

Список каталогов, разделенных двоеточием, в которых команда enable выполняет поиск динамически загружаемых встроенных команд.

BASH_MONOSECONDS

При каждом обращении к этой переменной она расширяется до значения, возвращаемого системными монотонными часами, если таковые имеются. Если монотонных часов нет, это эквивалентно EPOCHSECONDS. Если значение BASH_MONOSECONDS не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_REMATCH

Переменная массива, элементы которой присваиваются двоичным оператором =~ условной команде [[. Элемент с индексом 0 - это часть строки, соответствующая всему регулярному выражению. Элемент с индексом n - это часть строки, соответствующая n-му подвыражению, заключенному в круглые скобки.

BASH_SOURCE

Переменная массива, элементами которой являются названия исходных файлов, в которых определены соответствующие названия функций оболочки в переменной массива FUNCNAME. Функция оболочки ${FUNCNAME[$i]} определена в файле ${BASH_SOURCE[$i]} и вызывается из ${BASH_SOURCE[$i+1]}. Присвоения BASH_SOURCE не имеют никакого эффекта и не могут быть отменены.

BASH_SUBSHELL

Увеличивается на единицу в каждой подоболочке или окружающей среде подоболочек, когда оболочка начинает выполняться в этой среде. Начальное значение равно 0. Если значение BASH_SUBSHELL не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

BASH_TRAPSIG

Присваивается номер сигнала, соответствующий выполняемому действию перехватчика во время его выполнения. Смотрите описание trap в разделе ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже для получения информации о номерах сигналов и выполнении перехватчика trap.

BASH_VERSINFO

Переменная массива, доступная только для чтения, элементы которой содержат информацию о версии для данного экземпляра bash. Элементам массива присваиваются следующие значения:

BASH_VERSION

Расширяется до строки, описывающей версию этого экземпляра bash (например, реализация 5.2.37(3)).

COMP_CWORD

Индекс слова в ${COMP_WORDS}, содержащего текущее положение курсора. Эта переменная доступна только в функциях оболочки, вызываемых средствами завершения программы (смотрите подраздел Завершение программы ниже).

COMP_KEY

Клавиша (или последняя клавиша в последовательности клавиш), используемая для вызова текущей функции завершения. Эта переменная доступна только в функциях командной строки и внешних командах, вызываемых средствами программируемого завершения (смотрите подраздел Программируемое завершение ниже).

COMP_LINE

Текущая командная строка. Эта переменная доступна только в функциях оболочки и внешних командах, вызываемых средствами завершения программы (смотрите подраздел Завершение программы ниже).

COMP_POINT

Индекс текущей позиции курсора относительно начала текущей команды. Если текущая позиция курсора находится в конце текущей команды, то значение этой переменной равно ${#COMP_LINE}. Эта переменная доступна только в функциях оболочки и внешних командах, вызываемых средствами завершения программ (смотрите подраздел Завершение программы ниже).

COMP_TYPE

Присваивается целочисленное значение, соответствующее типу попытки завершения, вызвавшей вызов функции завершения: TAB, для обычного завершения - ?, для перечисления завершений после последовательных табуляций - !, для перечисления альтернатив при частичном завершении слова - @, вывод списка дополнений, если слово не изменено, или % для завершения меню. Эта переменная доступна только в функциях оболочки и внешних командах, вызываемых средствами программируемого завершения (смотрите Программируемое завершение ниже).

COMP_WORDBREAKS

Набор символов, которые библиотека readline обрабатывает как разделители слов при выполнении завершения слова. Если значение COMP_WORDBREAKS не задано, то оно теряет свои специальные свойства, даже если впоследствии оно будет сброшено.

COMP_WORDS

Переменная типа массива (смотрите Массивы ниже), состоящая из отдельных слов в текущей командной строке. Строка разбивается на слова так, как ее разбила бы readline, используя COMP_WORDBREAKS, как описано выше. Эта переменная доступна только в функциях оболочки, вызываемых средствами программируемого завершения (см. подраздел Завершение программ ниже).

COPROC

Переменная массива (смотрите подраздел Массивы ниже), созданная для хранения дескрипторов файлов для вывода и ввода в не именованный сопроцесс (смотрите подраздел Сопроцессы выше).

DIRSTACK

Переменная массива (смотрите подраздел Массивы ниже), содержащая текущее содержимое стека каталогов. Каталоги отображаются в стеке в том порядке, в котором они отображаются встроенной командой dirs. Присвоение элементам этого массива переменной может использоваться для изменения каталогов, уже находящихся в стеке, но для добавления и удаления каталогов необходимо использовать встроенные команды pushd и popd. Присвоение этой переменной не изменяет текущий каталог. Если DIRSTACK не установлено, то это теряет свои специальные свойства, даже если впоследствии будет сброшено.

EPOCHREALTIME

При каждом обращении к этому параметру он увеличивается до количества секунд, прошедших с начала эпохи Unix (смотрите time(3)), в виде значения с плавающей запятой с микросекундной детализацией. Присвоения EPOCHREALTIME игнорируются. Если EPOCHREALTIME не установлено, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

EPOCHSECONDS

Каждый раз, когда этот параметр ссылается, он расширяется до количества секунд с момента начала эпохи Unix (смотрите time(3)). Установка EPOCHSECONDS игнорируется. Если EPOCHSECONDS не задан, то он теряет свои специальные свойства, даже если впоследствии будет сброшен.

EUID

Расширяется до эффективного пользовательского идентификатора для текущего пользователя, инициализированного при запуске оболочки. Эта переменная доступна только для чтения.

FUNCNAME

Переменная массива, содержащая названия всех функций оболочки, в настоящее время в стеке вызовов выполнения.Элемент с индексом 0-это название любой в настоящее время выполняющейся функцию оболочки.Самый нижний элемент (тот, который с самым большим индексом) “main”. Эта переменная существует только при выполнении функции оболочки. Установка FUNCNAME не действует.Если FUNCNAME не установлена, то она теряет свои специальные свойства, даже если впоследствии будет сброшена.

Эта переменная может использоваться с BASH_LINENO и BASH_SOURCE. Каждому элементу FUNCNAME соответствуют элементы в BASH_LINENO и BASH_SOURCE для описания стека вызовов. Например, ${FUNCNAME[$i]} была вызвана из файла ${BASH_SOURCE[$i+1]} с номером строки ${BASH_LINENO[$i]}. Встроенная команда caller отображает текущий стек вызовов, используя эту информацию.

GROUPS

Переменная массива, содержащая список групп, членом которых является текущий пользователь. Присвоения GROUPS не имеют значения. Если значение GROUPS не задано, то оно теряет свои специальные свойства, даже если впоследствии оно будет сброшено.

HISTCMD

Номер истории или индекс в списке истории текущей команды. Присвоения HISTCMD не имеют никакого эффекта. Если значение HISTCMD не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

HOSTNAME

Автоматически устанавливается на название текущего хоста.

HOSTTYPE

Автоматически устанавливает строку, однозначно описывающую тип завершения, на котором выполняется bash. Значение по умолчанию зависит от системы.

LINENO

При каждом обращении к этому параметру оболочка подставляет десятичное число, представляющее текущий порядковый номер строки (начинающийся с 1) в скрипте или функции. Если его нет в скрипте или функции, то не гарантируется, что подставленное значение будет значимым. Если параметр LINENO не установлен, то он теряет свои специальные свойства, даже если впоследствии будет сброшен.

MACHTYPE

Автоматически устанавливает строку, полностью описывающую тип системы, на которой выполняется bash, в стандартном формате GNU cpu-company-system. Значение по умолчанию зависит от системы.

MAPFILE

Переменная массива (смотрите подраздел Массивы ниже), созданная для хранения текста, считываемого из встроенного файла mapfile, когда название переменной не указано.

OLDPWD

Предыдущий рабочий каталог, заданный командой cd.

OPTARG

Значение последнего аргумента опции, обработанного встроенной командой getopts (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже).

OPTIND

Индекс следующего аргумента, который будет обработан встроенной командой getopts (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже).

OSTYPE

Автоматически устанавливает строку, описывающую операционную систему, в которой выполняется bash. Значение по умолчанию зависит от системы.

PIPESTATUS

Переменная массива (смотрите подраздел Массивы ниже), содержащая список значений статуса завершения команд в конвейере переднего плана, который может состоять только из простой команды (смотрите раздел ГРАММАТИКА ОБОЛОЧКИ выше). Bash устанавливает PIPESTATUS после выполнения многоэлементных конвейеров, конвейеров с синхронизацией и отменой, простых команд, вложенных оболочек, созданных с помощью оператора, составных команд [[ и ((, а также после возникновения ошибок, которые приводят к появлению прерываний оболочки при выполнения команды.

PPID

Идентификатор процесса родительской оболочки. Эта переменная доступна только для чтения.

PWD

Текущий рабочий каталог, заданный командой cd.

RANDOM

При каждом обращении к этому параметру он расширяется до случайного целого числа в диапазоне от 0 до 32767. Присвоение значения RANDOM инициализирует (определяет) последовательность случайных чисел. При вводе в генератор случайных чисел того же постоянного значения получается та же последовательность значений. Если значение RANDOM не задано, то оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

READLINE_ARGUMENT

Любой числовой аргумент, переданный команде readline, которая была определена с помощью “bind -x” (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже), когда он был вызван.

READLINE_LINE

Содержимое буфера строк readline, предназначенного для использования с “bind -x” (смотрите ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже).

READLINE_MARK

Положение метки (сохраненной точки вставки) в буфере строк readline для использования с “bind -x” (смотрите ниже раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ). Символы между точкой вставки и меткой часто называются region.

READLINE_POINT

Положение точки вставки в буфере строк readline для использования с “bind -x” (смотрите ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже).

REPLY

Устанавливается в строку ввода, считываемую встроенной командой read, когда аргументы не указаны.

SECONDS

При каждом обращении к этому параметру он увеличивается до количества секунд с момента вызова оболочки. Если значение переменной SECONDS задано, то при последующих обращениях к ней возвращается значение, равное количеству секунд с момента присвоения плюс присвоенное значение. Количество секунд при вызове оболочки и текущее время всегда определяются путем запроса системных часов с разрешением в одну секунду. Если значение SECONDS не задано, оно теряет свои специальные свойства, даже если впоследствии оно будет сброшено.

SHELLOPTS

Список включенных опций оболочки, разделенных двоеточием. Каждое слово в списке является допустимым аргументом для опции -o для встроенной команды set (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже). Опции, отображаемые в SHELLOPTS, указаны как on в set -o. Если эта переменная присутствует в окружающей среде при запуске bash, то оболочка включает каждую опцию в списке перед чтением любых файлов запуска. Если эта переменная экспортирована, то дочерние оболочки будут включать каждую опцию в списке. Эта переменная доступна только для чтения.

SHLVL

Увеличивается на единицу при каждом запуске экземпляра bash.

SRANDOM

При каждом обращении к этой переменной она преобразуется в 32-разрядное псевдослучайное число. Генератор случайных чисел не является линейным в системах, поддерживающих /dev/urandom или arc4random(3), поэтому каждое возвращаемое число не имеет отношения к числам, предшествующим ему. Когда генератор случайных чисел не может быть запущен, тогда присвоения этой переменной значений не имеют эффекта. Если SRANDOM сброшено, оно теряет свои специальные свойства, даже если впоследствии будет сброшено.

UID

Расширяется до идентификатора текущего пользователя, инициализируемого при запуске командной строки. Эта переменная доступна только для чтения.

Оболочка использует следующие переменные. В некоторых случаях bash присваивает переменной значение по умолчанию; эти случаи описаны ниже.

BASH_COMPAT

Это значение используется для настройки уровня совместимости оболочки. Описание различных уровней совместимости и их последствий смотрите в разделе РЕЖИМ СОВМЕСТИМОСТИ ОБОЛОЧКИ ниже. Значением может быть десятичное число (например, 4,2) или целое число (например, 42), соответствующее желаемому уровню совместимости. Если значение для BASH_COMPAT не задано или имеет значение пустой строки, то уровень совместимости устанавливается по умолчанию для текущей версии. Если для BASH_COMPAT задано значение, которое не соответствует ни одному из допустимых уровней совместимости, то оболочка выводит сообщение об ошибке и устанавливает уровень совместимости по умолчанию для текущей версии. Подмножество допустимых значений соответствует уровням совместимости, описанным ниже в разделе РЕЖИМ СОВМЕСТИМОСТИ ОБОЛОЧКИ. Например, 4.2 и 42 являются допустимыми значениями, которые соответствуют опции compat42 команды shopt и устанавливают уровень совместимости равным 42. Текущая версия также является допустимым значением.

BASH_ENV

Если этот параметр задан, когда bash выполняет сценарий оболочки, то его расширенное значение интерпретируется как название файла, содержащее команды для инициализации оболочки перед чтением и выполнением команд из сценария. Значение BASH_ENV подвергается расширению параметров, замене командами и арифметическому расширению, прежде чем оно будет интерпретировано как название файла. PATH не используется для поиска результирующего названия файла.

BASH_XTRACEFD

Если задано целое число, соответствующее допустимому файловому дескриптору, то bash записывает выходные данные трассировки, сгенерированные при “set -x” включении для этого файлового дескриптора, вместо стандартной ошибки. Файловый дескриптор закрывается, если BASH_XTRACEFD сброшено или ему присвоено новое значение. Сброс значения BASH_XTRACEFD или присвоение ему пустой строки приводит к отправке выходных данных трассировки со стандартной ошибкой. Обратите внимание, что установка значения BASH_XTRACEFD равным 2 (файловый дескриптор стандартной ошибки), а затем сброс этого значения приведет к закрытию стандартной ошибки.

CDPATH

Путь поиска для команды cd. Это разделенный двоеточием список каталогов, в котором оболочка выполняет поиск каталогов, указанных в качестве аргументов команды cd. Примерным значением является “.:~:/usr”.

CHILD_MAX

Задайте количество завершенных дочерних значений статуса, которые должна запомнить оболочка. Bash не позволит уменьшить это значение ниже POSIX - требуемый минимум, и существует максимальное значение (в настоящее время 8192), которое не может быть превышено. Минимальное значение зависит от системы.

COLUMNS

Используется командой select для определения ширины терминала при печати списков. Устанавливается автоматически, если включена опция checkwinsize или в интерактивной командной строке при получении команды SIGWINCH.

COMPREPLY

Переменная массива, из которой bash считывает возможные завершения, сгенерированные функцией оболочки, вызываемой программируемым средством завершения (смотрите подраздел Программируемое завершение ниже). Каждый элемент массива содержит одно возможное завершение.

EMACS

Если bash найдет эту переменную в окружающей среде, когда оболочка запускается со значением “t”, предполагающем, что оболочка запущена в буфере оболочки Emacs, и отключено редактирование строк.

ENV

Расширяется и выполняется аналогично BASH_ENV (смотрите раздел ВЫЗОВ выше) при вызове интерактивной оболочки в режиме posix.

EXECIGNORE

Список шаблонов оболочки, разделенных двоеточием (смотрите подраздел Сопоставление с шаблоном), определяющий набор названий файлов, которые будут игнорироваться при поиске команд с использованием PATH. Файлы, полные пути к которым соответствуют одному из этих шаблонов, не считаются исполняемыми файлами для целей завершения и выполнения команд с помощью поиска PATH. Это не влияет на поведение команд [, test и [[. Полные пути в хэш-таблице команд не зависят от EXECIGNORE. Используйте эту переменную, чтобы игнорировать файлы общей библиотеки, которые имеют установленный бит исполняемого файла, но не являются исполняемыми файлами. При сопоставлении с шаблоном учитывается настройка опции оболочки extglob.

FCEDIT

Редактор по умолчанию для встроенной команды fc.

FIGNORE

Разделенный двоеточием список суффиксов, которые следует игнорировать при заполнении названия файла (смотрите БИБЛИОТЕКА READLINE ниже). Название файла, суффикс которого совпадает с одной из записей в FIGNORE, исключается из списка совпадающих названий файлов. Примерным значением является “.o:~” (При присвоении значения этой переменной, содержащего тильду, необходимо заключать значение в кавычки).

FUNCNEST

Если задано числовое значение, большее 0, то это определяет максимальный уровень вложенности функции. Вызовы функций, превышающие этот уровень вложенности, приводят к прерыванию текущей команды.

GLOBIGNORE

Список шаблонов, разделенных двоеточием, определяющий набор названий файлов, которые будут игнорироваться при расширении названия пути. Если название файла, соответствующее шаблону расширения названия пути, также соответствует одному из шаблонов в GLOBIGNORE, то оно удаляется из списка совпадений. Сопоставление с наблоном выполняется с учетом настройки опции оболочки extglob.

GLOBSORT

Управляет тем, как сортируются результаты расширения названия пути. Значение этой переменной определяет критерии сортировки и порядок сортировки результатов расширения названия пути. Если эта переменная не задана или имеет значение нулевой строки, то при расширении названия пути используется историческое поведение сортировки по названию в лексикографическом порядке возрастания, как определено переменной оболочки LC_COLLATE.

Если задано, допустимое значение начинается с необязательного +, которое игнорируется, или -, которое меняет порядок сортировки с восходящего на нисходящий, за которым следует спецификатор сортировки. Допустимыми спецификаторами сортировки являются name, numeric, size, mtime, atime, ctime и blocks, которые сортируют файлы по названию, названию в числовом, а не лексикографическом порядке, т.е. размеру файла, времяни модификации, времяни доступа, времяни изменения индекса и количеству блоков, соответственно. Если какой-либо из ключей, отличных от названия, сравнивается как равный (например, если два файла имеют одинаковый размер), то при сортировке название используется в качестве вторичного ключа сортировки.

Например, значение -mtime сортирует результаты в порядке убывания по времени изменения (сначала самое новое).

Спецификатор numeric рассматривает названия, состоящие исключительно из цифр, т.е. как числа и сортирует их по их числовому значению (таким образом “2” сортирует до “10”, например). При использовании numeric названия, не содержащие цифр, сортируются после всех названий, состоящих из цифр, и сортируются по названию традиционным способом.

Спецификатор сортировки nosort полностью отключает сортировку; bash возвращает результаты в том порядке, в котором они считываются из файловой системы, игнорируя любые начальные значения -.

Если спецификатор сортировки отсутствует, то по умолчанию используется значение name, поэтому значение + эквивалентно нулевой строке, а значение - выполняет сортировку по названию в порядке убывания. Любое недопустимое значение восстанавливает историческое поведение сортировки.

HISTCONTROL

Разделенный двоеточием список значений, определяющий порядок сохранения команд в списке истории. Если список значений содержит ignorespace, то строки, начинающиеся с символа space, не сохраняются в списке истории. Значение ignoredups приводит к тому, что строки, соответствующие предыдущей записи в истории, не сохраняются. Значение ignoreboth является сокращением для ignorespace и ignoredups. Значение erasedups приводит к удалению всех предыдущих строк, соответствующих текущей строке, из списка истории, прежде чем эта строка будет сохранена. Любое значение, отсутствующее в приведенном выше списке, игнорируется. Если значение HISTCONTROL не задано или не содержит допустимого значения, то bash сохраняет все строки, прочитанные синтаксическим анализатором оболочки, в списке истории, в зависимости от значения HISTIGNORE. Если первая строка многострочной составной команды была сохранена, то вторая и последующие строки не проверяются и добавляются в историю независимо от значения HISTCONTROL. Если первая строка не была сохранена, то вторая и последующие строки команды также не будут сохранены.

HISTFILE

Название файла, в котором сохраняется история команд (смотрите раздел ИСТОРИЯ ниже). Bash присваивает значение по умолчанию, равное ~/.bash_history. Если значение HISTFILE не задано или равно нулю, то оболочка не сохраняет историю команд при завершении работы.

HISTFILESIZE

Максимальное количество строк, содержащихся в файле истории. Когда этой переменной присваивается значение, файл истории при необходимости сокращается, чтобы содержать не более количества записей истории, общее количество которых не превышает этого количества строк, путем удаления самых старых записей. Если список истории содержит многострочные записи, файл истории может содержать больше строк, чем это максимальное значение, чтобы избежать частичных записей истории. Файл истории также сокращается до этого размера после его записи при выходе из оболочки или с помощью встроенной команды history. Если значение равно 0, то файл истории сокращается до нулевого размера. Нечисловые значения и числовые значения, меньшие нуля, запрещают усечение. Оболочка устанавливает значение по умолчанию в HISTSIZE после чтения любых файлов запуска.

HISTIGNORE

Разделенный двоеточием список шаблонов, используемых для определения того, какие командные строки следует сохранить в списке истории. Если командная строка соответствует одному из шаблонов в значении HISTIGNORE, то она не сохраняется в списке истории. Каждый шаблон привязывается к началу строки и должен соответствовать всей строке (bash неявно добавляет “*”). Каждый шаблон проверяется на соответствие строке после применения проверок, указанных в HISTCONTROL. В дополнение к обычным символам, соответствующим шаблону оболочки, “&” совпадающим с предыдущей строкой журнала. Обратная косая черта закрывает строку “&”; обратная косая черта удаляется перед попыткой сопоставления. Если первая строка многострочной составной команды была сохранена, вторая и последующие строки не проверяются и добавляются в журнал независимо от значения HISTIGNORE. Если первая строка не была сохранена, то вторая и последующие строки команды также не будут сохранены. Сопоставление с шаблоном выполняется с учетом настройки опции оболочки extglob.

HISTIGNORE выполняет часть функций HISTCONTROL. Шаблон из “&” идентичен “ignoredups”, и шаблон “[ ]*” идентичен “ignorespace”. Объединение этих двух шаблонов, разделенных двоеточием, обеспечивает функциональность “ignoreboth”.

HISTSIZE

Количество команд, которые необходимо запомнить в истории команд (смотрите раздел ИСТОРИЯ. Если значение равно 0, то команды не сохраняются в списке истории. Числовые значения, меньшие нуля, приводят к тому, что каждая команда сохраняется в списке истории (ограничений нет). После прочтения любых файлов запуска оболочка устанавливает значение по умолчанию равным 500.

HISTTIMEFORMAT

Если эта переменная установлена, а не равна нулю, то ее значение используется в качестве строки формата strftime(3) для печати отметки времени, связанной с каждой записью истории, отображаемой встроенной командой history. Если эта переменная установлена, то оболочка записывает временные метки в файл истории, чтобы их можно было сохранять во время сеансов оболочки. При этом используется символ комментария к истории, чтобы отличать временные метки от других строк истории.

HOME

Домашний каталог текущего пользователя; аргумент по умолчанию для встроенной команды cd. Значение этой переменной также используется при расширении тильды.

HOSTFILE

Содержит название файла в том же формате, /etc/hosts который может прочитать оболочка, когда ей потребуется ввести название хоста. Список возможных дополнений названия хоста может быть изменен во время работы оболочки; при следующей попытке завершения названия хоста после изменения значения bash добавляет содержимое нового файла в существующий список. Если переменная HOSTFILE задана, но не имеет значения или не содержит названия файла, доступного для чтения, то оболочка bash попытается прочитать /etc/hosts чтобы получить список возможных дополнений к названию хоста. Если значение HOSTFILE не задано, то bash очищает список названий хостов.

IFS

Внутренний разделитель полей Internal Field Separator, который используется для разделения слов после расширения и для разделения строк на слова с помощью встроенной команды read. Разделение слов описано ниже в разделе РАСШИРЕНИЕ. Значение по умолчанию равно “<space><tab><newline>”.

IGNOREEOF

Управляет действием интерактивной оболочки при получении символа EOF в качестве единственного входного сигнала. Если задано, то это значение равно количеству последовательных символов EOF, которые должны быть введены в качестве первых символов в строке ввода перед завершением работы bash. Если переменная задана, но не имеет числового значения или значение равно нулю, то значение по умолчанию равно 10. Если значение не задано, то EOF означает окончание ввода в оболочку.

INPUTRC

Название файла для файла запуска readline, которое переопределяет значение по умолчанию ~/.inputrc (смотрите раздел БИБЛИОТЕКА READLINE ниже).

INSIDE_EMACS

Если эта переменная появляется в окружающей среде при запуске оболочки, то bash предполагает, что она выполняется внутри буфера оболочки Emacs и может отключить редактирование строк, в зависимости от значения TERM.

LANG

Используется для определения локали для любой категории, не выбранной специально, с помощью переменной, начинающейся с LC_.

LC_ALL

Эта переменная переопределяет значение LANG и любой другой переменной LC_, определяющей локаль.

LC_COLLATE

Эта переменная определяет порядок сопоставления, используемый при сортировке результатов расширения названия пути, и определяет диапазон выражений , классов эквивалентности и сопоставляющих последовательностей при расширении названия пути и сопоставлении с образцом.

LC_CTYPE

Эта переменная определяет интерпретацию символов и поведение классов символов при расширении названия пути и сопоставлении с шаблоном.

LC_MESSAGES

Эта переменная определяет локаль, используемую для перевода строк, заключенных в двойные кавычки, перед которыми стоит символ $.

LC_NUMERIC

Эта переменная определяет категорию локали, используемой для форматирования чисел.

LC_TIME

Эта переменная определяет категорию локали, используемой для форматирования данных и времени.

LINES

Используется командой select для определения длины столбца при печати списков выбора. Устанавливается автоматически, если включена опция checkwinsize, или в интерактивной оболочке при получении SIGWINCH.

MAIL

Если в качестве значения задано название файла или каталога, а переменная MAILPATH не задана, то bash информирует пользователя о поступлении почты в указанный файл или каталог в формате Maildir.

MAILCHECK

Указывает, как часто (в секундах) bash проверяет почту. Значение по умолчанию равно 60 секундам. Когда приходит время проверять почту, оболочка выполняет это перед отображением основного запроса. Если эта переменная не задана или ей присвоено значение, которое не является числом, большим или равным нулю, то оболочка отключает проверку почты.

MAILPATH

Разделенный двоеточием список названий файлов, которые необходимо проверить на наличие почты. Сообщение, которое будет распечатываться при поступлении почты в определенный файл, можно указать, отделив название файла от сообщения символом “?”. При использовании в тексте сообщения, $_ расширяется до названия текущего почтового файла. Например:

MAILPATH='/var/mail/bfox?"You have mail":~/shell-mail?"$_ has mail!"'

OPTERR

Если установлено значение 1, то bash отображает сообщения об ошибках, сгенерированные встроенной командой getopts (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже). OPTERR инициализируется значением 1 при каждом вызове оболочки или выполнении сценария оболочки.

PATH

Путь поиска команд. Это разделенный двоеточием список каталогов, в которых оболочка выполняет поиск команд (смотрите раздел ВЫПОЛНЕНИЕ КОМАНДЫ ниже). Название каталога нулевой длины (null) в значении PATH указывает на текущий каталог. Название каталога с нулевым значением может быть представлено в виде двух смежных двоеточий или в виде начального или конечного двоеточия. Путь по умолчанию зависит от системы и устанавливается администратором, устанавливающим bash. Обычно используется следующее значение

/usr/local/bin:/usr/local/sbin:.if  0<78n .br
/usr/bin:/usr/sbin:/bin:/sbin

POSIXLY_CORRECT

Если эта переменная находится в окружающей среде при запуске bash, то оболочка переходит в режим posix перед чтением файлов запуска, как если бы была указана опция вызова --posix. Если она установлена во время работы оболочки, то bash включает режим posix, как если бы команда “set -o posix” была выполнена. Когда оболочка переходит в режим posix, она устанавливает эту переменную, если она еще не была установлена.

PROMPT_COMMAND

Если эта переменная задана и является массивом, то значение каждого заданного элемента выполняется как команда перед выдачей каждого основного запроса. Если эта переменная задана, но не является массивом, то ее значение используется в качестве команды для выполнения.

PROMPT_DIRTRIM

Если задано значение, большее нуля, то это значение используется в качестве количества завершающих компонентов каталога, которые будут сохранены при расширении командной строки \w и \W (смотрите раздел ПОДСКАЗКИ ниже). Удаленные символы заменяются многоточием.

PS0

Значение этого параметра раскрывается (смотрите ПОДСКАЗКА ниже) и отображается интерактивной оболочкой после считывания команды и перед ее выполнением.

PS1

Значение этого параметра раскрывается (смотрите ниже раздел " ПОДСКАЗКИ") и используется в качестве основной строки запроса. Значение по умолчанию - “\s-\v\$ ”.

PS2

Значение этого параметра расширяется, как и в случае с PS1 и используется в качестве дополнительной строки запроса. По умолчанию используется “> ”.

PS3

Значение этого параметра используется в качестве запроса для команды select (смотрите раздел ГРАММАТИКА ОБОЛОЧКИ выше).

PS4

Значение этого параметра расширяется, как и в случае с PS1 и значение выводится перед отображением каждой команды bash во время трассировки выполнения. Первый символ расширенного значения PS4 при необходимости повторяется несколько раз, чтобы указать несколько косвенных уровней. По умолчанию используется “+ ”.

SHELL

Эта переменная расширяется до полного пути к оболочке. Если она не задана при запуске оболочки, то bash присваивает ей полный путь к оболочке входа текущего пользователя.

TIMEFORMAT

Значение этого параметра используется в качестве строки формата, указывающей, как должна отображаться информация о времени для конвейеров с префиксом зарезервированного слова time. Символ % вводит управляющую последовательность, которая расширяется до значения времени или другой информации. Ниже приведены управляющие последовательности и их значения; квадратные скобки обозначают необязательные части.

Необязательно p - это цифра, определяющая точность precision, т. е. количество дробных разрядов после десятичной точки. Значение 0 не приводит к выводу десятичной точки или дроби. time выводит не более шести цифр после запятой; значения p, превышающие 6, изменяются на 6. Если p не указано, то time выводит три цифры после десятичной точки.

Необязательная величина l задает более длинный формат, включая минуты, для формы MMmSS.FFs. Значение p определяет, будет ли включена дробная часть или нет.

Если эта переменная не задана, то bash действует так, как если бы она имела значение $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Если значение равно нулю, то bash не отображает никакой временной информации. При отображении строки формата добавляется завершающая новая строка.

TMOUT

Если задано значение, большее нуля, то встроенная команда read использует это значение в качестве тайм-аута по умолчанию. Команда select завершается, если входные данные не поступают по истечении TMOUT секунд, когда входные данные поступают с терминала. В интерактивной оболочке это значение интерпретируется как количество секунд, в течение которых требуется дождаться ввода строки после выдачи основного запроса. Bash завершает работу после ожидания этого количества секунд, если полная строка ввода не поступает.

TMPDIR

Если задано, то bash использует его значение в качестве названия каталога, в котором bash создает временные файлы для использования оболочкой.

auto_resume

Эта переменная управляет взаимодействием консоли с пользователем и управлением заданиями. Если эта переменная установлена, то простые команды, состоящие всего из одного слова, без перенаправлений, рассматриваются как кандидаты на возобновление существующего остановленного задания. Здесь не допускается двусмысленность; если есть несколько заданий, начинающихся со слова или содержащих его, то выбирается задание, к которому был последний доступ. В данном контексте название name остановленного задания - это командная строка, используемая для его запуска, как показано в jobs. Если задано значение exact, то слово должно точно соответствовать названию остановленного задания; если задано значение substring, то слово должно соответствовать подстроке названия остановленного задания. Значение substring обеспечивает функциональность, аналогичную идентификатору задания %? (смотрите раздел УПРАВЛЕНИЕ ЗАДАНИЕМ ниже). Если задано любое другое значение (например, prefix), то слово должно быть префиксом названия остановленного задания; это обеспечивает функциональность, аналогичную идентификатору задания %string.

histchars

Два или три символа, которые управляют расширением истории, быстрой заменой и токенизацией (смотрите раздел РАСШИРЕНИЕ ИСТОРИИ ниже). Первый символ - это символ history expansion, с которого обычно начинается с расширения истории “!”. Второй символ - это символ quick substitution (быстрая замена), обычно “^”. если он появляется в качестве первого символа в строке, то подстановка в историю повторяет предыдущую команду, заменяя одну строку другой. Необязательный третий символ - это символ комментария к истории history comment, обычно “#”, который указывает на то, что оставшаяся часть строки является комментарием, когда она появляется в качестве первого символа слова. Символ комментария к истории отключает подстановку в историю оставшихся слов в строке. Это не обязательно приводит к тому, что синтаксический анализатор оболочки обрабатывает оставшуюся часть строки как комментарий.

Массивы¶

Bash предоставляет одномерные индексированные и ассоциативные массивы переменных. В качестве индексированного массива может использоваться любая переменная; встроенная команда declare явно определяет массив. Нет ни максимального ограничения на размер массива, ни каких-либо требований к тому, чтобы элементы индексировались или назначались последовательно. Ссылки на индексированные массивы выполняются с использованием арифметических выражений, которые должны быть расширены до целого числа (смотрите ниже раздел АРИФМЕТИЧЕСКИЕ ВЫЧИСЛЕНИЯ) и основаны на нуле; ссылки на ассоциативные массивы выполняются с использованием произвольных строк. Если не указано иное, то индексы индексированных массивов должны быть неотрицательными целыми числами.

Оболочка выполняет расширение параметров и переменных, арифметическое расширение, подстановку команд и удаление кавычек из индексов массива. Поскольку это потенциально может привести к появлению пустых строк, то индексация по нижнему индексу рассматривает их как выражения, значение которых равно 0.

Оболочка выполняет расширение тильдой, расширение параметрами и переменными, арифметическое расширение, подстановку команд и удаление кавычек в индексах ассоциативного массива. Пустые строки не могут использоваться в качестве ключей ассоциативного массива.

Bash автоматически создает индексированный массив, если какой-либо переменной присваивается значение с использованием синтаксиса

Ассоциативные массивы создаются с помощью

Атрибуты могут быть заданы для переменной массива с помощью встроенных команд declare и readonly. Каждый атрибут применяется ко всем элементам массива.

Массивы присваиваются с помощью значений вида name=(value1 ... valuen), где каждое значение valueможет иметь вид [subscript]=string. Для присвоения индексированных массивов не требуется ничего, кроме строки string. Каждое значение value в списке расширяется с помощью расширений оболочки, описанных ниже в разделе РАСШИРЕНИЕ, но значения value, которые являются допустимыми значениями переменных, включая скобки и подстрочный индекс, не подвергаются расширению скобок и разделению слов, как для значений отдельных переменных.

При присвоении индексов индексированным массивам, если указаны необязательные скобки и нижний индекс, то присваивается этот индекс; в противном случае индекс присваиваемого элемента является последним индексом, плюс единица. Индексация начинается с нуля.

При присвоении значений ассоциативному массиву слова в составном присваивании могут быть либо выражениями присваивания, для которых требуется нижний индекс, либо списком слов, который интерпретируется как последовательность чередующихся ключей и значений: name=( key1 value1 key2 value2 ...). Они обрабатываются аналогично name=( [key1]=value1 [key2]=value2 ...). Первое слово в списке определяет, как будут интерпретироваться остальные слова; все значения в списке должны быть одного типа. При использовании пар ключ/значение ключи не должны отсутствовать или быть пустыми; последнее пропущенное значение обрабатывается как пустая строка.

Этот синтаксис также поддерживается встроенной командой declare. Отдельные элементы массива могут быть назначены с использованием синтаксиса name[subscript]=value, представленного выше.

При присвоении индексов индексированному массиву, если name содержит отрицательное число, то это число интерпретируется как относительное к единице, превышающей максимальный индекс name, поэтому отрицательные индексы отсчитываются от конца массива, а индекс, равный -1, ссылается на последний элемент массива.

Этот “+=” оператор присваивается переменной массива при присваивании с использованием синтаксиса составного присваивания; смотрите раздел ПАРАМЕТРЫ выше.

Ссылка на элемент массива выполняется с помощью ${name[subscript]}. Фигурные скобки необходимы, чтобы избежать конфликтов при расширении названия пути. Если subscript равен @ или *, то слово расширяется до всех элементов name, если только это не указано в описании встроенного кода или расширения слова. Эти индексы различаются только в том случае, если слово заключено в двойные кавычки. Если слово заключено в двойные кавычки, то {name[*]} расширяется до одного слова со значением каждого элемента массива, разделенного первым символом специальной переменной IFS, а ${name[@]} расширяет каждый элемент name до отдельного слова. Когда элементов массива нет, ${name[@]} расширяется до нуля. Если расширение в двойных кавычках происходит внутри слова, то расширение первого параметра соединяется с начальной частью расширения исходного слова, а расширение последнего параметра соединяется с последней частью расширения исходного слова. Это аналогично расширению специальных параметров * и @ (смотрите подраздел Специальные параметры выше).

${#name[subscript]} расширяется до длины ${name[subscript]}. Если индекс subscript равен * или @, то расширение равно количеству элементов в массиве.

Если значение subscript, используемое для ссылки на элемент индексированного массива, равно числу, меньшему нуля, то оно интерпретируется относительное к единице, превышающей максимальный индекс массива, поэтому отрицательные индексы отсчитываются от конца массива, а индекс, равный -1, ссылается на последний элемент.

Ссылка на переменную массива без нижнего индекса эквивалентна ссылке на массив с нижним индексом, равным 0. Любая ссылка на переменную с использованием допустимого нижнего индекса является допустимой; bash при необходимости создает массив.

Переменная массива считается заданной, если индексу присвоено значение. Строка ноль является допустимым значением.

Можно получить ключи (индексы) массива, а также значения. Выражения ${!name[@]} и ${!name[*]} расширяются до индексов, присвоенных переменной массива name. Обработка при использовании двойных кавычек аналогична расширению специальных параметров @ и * в двойных кавычках.

Встроенная команда unset используется для уничтожения массивов. Команда unset name[subscript] удаляет элемент массива с индексом subscript как для индексированных, так и для ассоциативных массивов. Отрицательные индексы индексированных массивов интерпретируются так, как описано выше. Сброс последнего элемента переменной массива не приводит к сбросу значения переменной. Команда unset name, где name приводит к удалению всего массива. Команда unset name[subscript] ведет себя по-разному в зависимости от того, является ли name индексированным или ассоциативным массивом, когда subscript равен * или @. Если name является ассоциативным массивом, то элемент с индексом * или @ сбрасывается. Если name является индексированным массивом, то команда unset удаляет все элементы, но не удаляет сам массив.

При использовании названия переменной с индексом в качестве аргумента команды, например, с помощью команды unset, без использования синтаксиса расширения слов, описанного выше (например, unset a[4]), аргумент подлежит расширению названия пути. Заключите аргумент в кавычки, если расширение названия пути нежелательно (например, unset 'a[4]').

Встроенные команды declare, local и readonly поддерживают опцию -a для указания индексированного массива и опцию -A для указания ассоциативного массива. Если указаны обе опции, то приоритет имеет опция -A. Встроенная команда read поддерживает опцию -a, чтобы преобразовать список слов, считываемых из стандартного ввода, в массив. Встроенные команды set и declare отображают значения массива таким образом, чтобы их можно было повторно использовать в качестве значений. Другие встроенные команды также принимают аргументы типа "array name" (например, mapfile); подробности смотрите в описаниях отдельных встроенных команд ниже. Оболочка предоставляет ряд встроенных переменных массива.

Расширение скобок¶

Расширение в скобках Brace expansion - это механизм генерации произвольных строк с общим префиксом и суффиксом, каждый из которых может быть пустым. Этот механизм аналогичен расширению названия пути pathname expansion, но генерируемые названия файлов необязательно должны существовать. Шаблоны, которые будут раскрываться фигурными скобками, формируются из необязательной преамбулы preamble, за которым следует либо последовательность строк, разделенная запятыми, либо выражение последовательности между парой фигурных скобок, за которым следует необязательный постскриптум postscript. К каждой строке, заключенной в фигурные скобки, добавляется преамбула, а затем к каждой результирующей строке добавляется постскриптум, расширяющийся слева направо.

Раскрытие в фигурных скобках может быть вложенным. Результаты каждой развернутой строки не сортируются; раскрытие в фигурных скобках сохраняет порядок слева направо. Например, a{d,c,b}e расширяется в “ade ace abe”.

Выражение последовательности принимает форму x..y[..incr], где x и y являются либо целыми числами, либо отдельными буквами, а incr, необязательное приращение, равное целому числу. Когда вводятся целые числа, то выражение расширяется до каждого числа от x до y, включительно. Если x или y начинаются с нуля, то каждый созданный член будет содержать одинаковое количество цифр, при необходимости заменяя их нулями. Когда вводятся буквы, то выражение расширяется до каждого символа лексикографически от x до y, включительно, используя локаль C. Обратите внимание, что и x, и y должны быть одного типа (целые или буквенные). При указании приращения оно используется как разница между каждым членом. Приращение по умолчанию равно 1 или -1, соответственно.

Раскрытие скобок выполняется перед любыми другими расширениями, и в результате сохраняются все символы, характерные для других расширений. Это строго текстовое дополнение. Оболочка Bash не применяет никакой синтаксической интерпретации к контексту расширения или к тексту между фигурными скобками.

Корректно оформленное расширение в виде фигурных скобок должно содержать открывающие и закрывающие скобки без кавычек и, по крайней мере, одну запятую без кавычек или корректное выражение последовательности. Любое неправильно оформленное расширение в виде фигурных скобок останется без изменений.

A “{” или Q , может быть заключено в кавычки с обратной косой чертой, чтобы оно не считалось частью выражения в фигурных скобках. Чтобы избежать конфликтов с расширением параметра “${” например, считается, что в строке скобка не может быть расширена и запрещено расширение скобки до её закрытия “}”.

Эта конструкция обычно используется в качестве сокращения, когда общий префикс генерируемых строк длиннее, чем в приведенном ниже примере:

mkdir /usr/local/src/bash/{old,new,dist,bugs}

chown root /usr/{ucb/{ex,edit},lib/{ex?.?*,how_ex}}

Расширение фигурной скобки приводит к небольшой несовместимости с предыдущими версиями sh. sh не обрабатывает открывающие или закрывающие фигурные скобки специально, когда они появляются как часть слова, и сохраняет их в выходных данных. Bash удаляет фигурные скобки из слов в результате расширения фигурной скобки. Например, слово, введенное в sh как “file{1,2}” в выходных данных отображается идентично. Bash выводит это слово как “file1 file2” после раскрытия фигурной скобки. Запустите bash с помощью опции +B или отключите раскрытие фигурной скобки с помощью опции +B для команды set (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже) для обеспечения строгой совместимости с sh.

Расширение тильды¶

Если слово начинается с символа тильды без кавычек ( “~”), все символы, предшествующие первой косой черте без кавычек (или все символы, если косая черта без кавычек отсутствует), считаются префиксом тильды tilde-prefix. Если ни один из символов в префиксе тильды не заключен в кавычки, то символы в префиксе тильды, следующие за тильдой, рассматриваются как возможные названия входа login name. Если это имя пользователя является пустой строкой, то тильда заменяется значением параметра оболочки HOME. Если значение HOME не задано, то тильда расширяется до домашнего каталога пользователя, выполняющего оболочку. В противном случае префикс тильды заменяется на домашний каталог, связанный с указанным названием входа.

Если префикс тильды является “~+”, значением переменной оболочки PWD, то он заменяет префикс тильды. Если префикс тильды является “~-”, оболочка заменяет значение переменной оболочки OLDPWD, если оно задано. Если символы, следующие за тильдой в префиксе тильды, состоят из числа N, необязательно с префиксом a “+” или “-”, префикс тильды заменяется соответствующим элементом из стека каталогов, поскольку он отображался бы при вызове встроенной команды dirs с символами, следующими за тильдой в префиксе тильды, в качестве аргумента. Если символы, следующие за тильдой в префиксе тильды, состоят из числа без начальной буквы “+” или “-”, расширение тильды предполагает “+”.

Результаты расширения тильдой обрабатываются так, как если бы они были заключены в кавычки, поэтому замена не требует разделения слов и расширения пути к ним.

Если введено неверное название для входа в оболочку или произошел сбой при расширении тильды, то префикс тильды остается неизменным.

Bash проверяет каждое присвоение переменной на наличие префиксов тильды без кавычек, следующих непосредственно за : или первым = и выполняет расширение тильды в этих случаях. Следовательно, можно использовать названия файлов с тильдами при присвоении PATH, MAILPATH и CDPATH и оболочка присвоит расширенное значение.

Bash также выполняет расширение тильдой слов, удовлетворяющих условиям присвоения переменных (как описано выше в разделе ПАРАМЕТРЫ), когда они появляются в качестве аргументов для простых команд. Bash не выполняет этого, за исключением команд declaration , перечисленных выше, в режиме posix.

Расширение параметра¶

Этот “$” символ указывает на расширение параметра, замену команды или арифметическое расширение. Название параметра или расширяемый символ могут быть заключены в фигурные скобки, которые необязательны, но служат для защиты расширяемой переменной от следующих непосредственно за ней символов, которые могут быть интерпретированы как часть названия.

При использовании фигурных скобок соответствующая конечная фигурная скобка является первой “}” не экранируется обратной косой чертой или строкой, заключенной в кавычки, и не используется во встроенном арифметическом расширении, замене команд или расширении параметров.

Основной формой расширения параметров является

${parameter}

который заменяет значение parameter. Фигурные скобки обязательны, если parameter является позиционным параметром, содержащим более одной цифры, или если за parameter следует символ, который не следует интерпретировать как часть его названия. Параметр parameter является параметром оболочки, как описано выше (ПАРАМЕТРЫ) или ссылкой на массив (Массивы).

Если первый символ parameter является восклицательным знаком (!), а parameter не является nameref, то это вводит определенный уровень косвенности. Bash использует значение, сформированное путем расширения остальной части parameter, в качестве нового параметра parameter; затем этот новый параметр расширяется, и это значение используется в остальной части расширения, а не в расширении исходного параметра parameter. Это называется косвенным расширением indirect expansion. Значение может быть расширено с помощью тильды, параметра, подстановки команд и арифметического расширения. Если parameter является значением nameref, то оно расширяется до названия параметра, на который ссылается parameter, вместо выполнения полного косвенного расширения для обеспечения совместимости. Исключением из этого правила являются расширения ${!prefix*} и ${!name[@]}, описанные ниже. Восклицательный знак должен стоять непосредственно за левой фигурной скобкой, чтобы ввести косвенность.

В каждом из приведенных ниже случаев слово word может быть расширено тильдой, расширено параметром, подменено командой и расширено арифметически.

Если не выполняется расширение подстроки, используя описанные ниже формы (например, :-), bash проверяет наличие параметра, который не задан или равен нулю. Без двоеточия выполняется проверка только для параметра, который не задан.

${parameter:-word}

Использовать значения по умолчанию Use Default Values. Если значение parameter не задано или равно нулю, то оно заменяется расширением слова word. В противном случае подставляется значение parameter.

${parameter:=word}

Присвоение значения по умолчанию Assign Default Values. Если значение parameter не задано или равно нулю, расширение слова word присваивается параметру parameter и расширение является окончательным значением параметра parameter. Позиционные параметры и специальные параметры не могут быть назначены таким образом.

${parameter:?word}

Ошибка отображения, если значение равно нулю или не задано Display Error if Null or Unset. Если параметр parameter равен нулю или не задан, то оболочка записывает расширение слова word (или соответствующее сообщение, если слово word отсутствует) в стандартную ошибку и, если оболочка не является интерактивной, то она завершает работу с ненулевым статусом. Интерактивная оболочка не существует, но она не выполняет команду, связанную с расширением. В противном случае подставляется значение parameter.

${parameter:+word}

Использование альтернативного значения Use Alternate Value. Если значение parameter равно нулю или не задано, ничего не заменяется, в противном случае заменяется расширение слова word. Значение parameter не используется.

${parameter:offset}

${parameter:offset:length}

Расширение подстроки Substring Expansion. Расширяется до символов length значения parameter, начиная с символа, указанного в смещении offset. Если parameter равен @ или *, то индексированный массив, подписанный @ или * или ассоциативное название массива, то результаты будут отличаться, как описано ниже. Если значение :length опущено (первая форма, приведенная выше), то оно расширяется до подстроки значения offset, начинающегося с символа, указанного в parameter и продолжающегося до конца значения. Если значение offset опущено, то оно рассматривается как 0. Если значение length опущено, но двоеточие после offset присутствует, то оно рассматривается как 0. Значения length и offset являются арифметическими выражениями (смотрите раздел АРИФМЕТИЧЕСКИЕ ВЫЧИСЛЕНИЯ ниже).

Если значение offset равно числу, меньшему нуля, то это значение используется в качестве смещения в символах от конца значения parameter. Если значение длины length равно числу, меньшему нуля, это интерпретируется как смещение в символах от конца значения parameter, а не на количество символов, а расширением являются символы между offset и этим результатом. Примечание. Отрицательное смещение должно быть отделено от двоеточия по крайней мере одним пробелом, чтобы его не перепутать с расширением :-.

Если параметр parameter равен @ или *, то результатом будет длина length позиционных параметров, начинающихся со смещения offset. При отрицательном значении offset берется значение относительно значения, превышающего наибольший позиционный параметр, поэтому значение смещения, равное -1, вычисляется как значение последнего позиционного параметра (или 0, если позиционных параметров нет). Это ошибка расширения, если значение length равно числу, меньшему нуля.

Если parameter - это название индексированного массива, подписанное символом @ или *, то результатом будет length элементов массива, начинающихся с ${parameter[offset]}. Значение offset берется отрицательным относительно значения, на единицу превышающего максимальный индекс указанного массива. Если значение length меньше нуля, то это является ошибкой расширения.

Расширение подстроки, примененное к ассоциативному массиву, приводит к неопределенным результатам.

Индексация подстрок выполняется на основе нуля, если не используются позиционные параметры, и в этом случае индексация начинается с 1 по умолчанию. Если значение offset равно 0 и используются позиционные параметры, то префиксу списка присваивается значение $0.

${!prefix*}

${!prefix@}

Названия, соответствующие префиксу Names matching prefix. Расширяется до названий переменных, названия которых начинаются с prefix, отделенных первым символом специальной переменной IFS. Когда используется @ и расширение отображается в двойных кавычках, то каждое название переменной расширяется до отдельного слова.

${!name[@]}

${!name[*]}

Список ключей массива List of array keys. Если name является переменной массива, то расширяется до списка индексов массива (ключей), назначенных в name. Если name не является массивом, то расширяется до 0, если задано значение name, и ноль в противном случае. Когда используется @ и расширение приведено в двойных кавычках, то каждый ключ расширяется до отдельного слова.

${#parameter}

Длина параметра Parameter length. Заменяет длину в символах расширенного значения параметра parameter. Если parameter равен * или @, то заменяемое значение представляет собой количество позиционных параметров. Если parameter - это название массива, подписанное символом * или @, то подставляемое значение - это - количество элементов в массиве. Если parameter - это название индексированного массива, подписанное отрицательным числом, то это число интерпретируется как число отнесенное к единице, превышающей максимальный индекс parameter, поэтому отрицательные индексы отсчитываются от конца массива, а индекс, равный -1, ссылается на последний элемент.

${parameter#word}

${parameter##word}

Удаление шаблона совпадающего префикса Remove matching prefix pattern. Слово wordрасширяется для получения шаблона, как и при расширении названия пути, и сопоставляется с расширенным значением параметра parameter с использованием правил, описанных в подразделе Сопоставление с шаблоном ниже. Если шаблон совпадает с началом значения parameter, то результатом расширения является расширенное значение parameter с кратчайшим совпадающим шаблоном (это “#” регистр) или удаляется самый длинный совпадающий шаблон (это “##” регистр). Если параметр parameter равен @ или *, то операция удаления шаблона применяется к каждому позиционному параметру по очереди, и в результате получается расширенный список. Если parameter является переменной массива с индексом @ или *, то операция удаления шаблона применяется к каждому элементу массива по очереди, а расширение - это результирующий список.

${parameter%word}

${parameter%%word}

Удаление шаблона совпадающего суффикса Remove matching suffix pattern. Слово word расширяется для получения шаблона точно так же, как при расширении названия пути, и сопоставляется с расширенным значением параметра parameter с использованием правил, описанных в подразделе Сопоставление с шаблоном ниже. Если шаблон соответствует конечной части расширенного значения parameter, то результатом расширения является расширенное значение parameter с кратчайшим совпадающим шаблоном (это “%” регистр) или удаляется самый длинный совпадающий шаблон (это “%%” регистр). Если параметр parameter равен @ или *, то операция удаления шаблона применяется к каждому позиционному параметру по очереди, и в результате получается расширенный список. Если parameter является переменной массива с индексом @ или *, то операция удаления шаблона применяется к каждому элементу массива по очереди, а расширение - это результирующий список.

${parameter/pattern/string}

${parameter//pattern/string}

${parameter/#pattern/string}

${parameter/%pattern/string}

Подстановка шаблона Pattern substitution. Шаблон pattern расширяется для получения шаблона и сопоставляется с расширенным значением parameter, как описано в подразделе Сопоставление с шаблоном ниже. Самое длинное совпадение с pattern в расширенном значении заменяется на string. Строка string подвергается расширению тильдой, расширению параметрами и переменными, арифметическому расширению, замене команд и процессов, а также удалению кавычек.

В первой приведенной выше форме заменяется только первое совпадение. Если есть две косые черты, разделяющие параметр parameter и шаблон pattern (вторая приведенная выше форма), то все совпадения pattern заменяются на строку string. Если шаблону patternпредшествует # (третья форма выше), то это должно совпадать с началом расширенного значения parameter. Если pattern предшествует % (четвертая форма выше), то это должно совпадать с расширенным значением parameter.

Если расширение string равно нулю, то совпадения с pattern удаляются, а символ /, следующий за pattern, может быть опущен.

Если опция оболочки patsub_replacement включена с помощью shopt, то все экземпляры & без кавычек в строке string заменяются соответствующей частью pattern.

Заключение в кавычки любой части строки string препятствует замене при расширении заключенной в кавычки части, включая строки для замены, хранящиеся в переменных оболочки. Обратная косая черта заменяет & в string ; обратная косая черта удаляется, чтобы разрешить использование литерала & в заменяющей строке. Обратная косая черта также может использоваться для экранирования обратной косой черты; \\ приводит к буквальной обратной косой черте при замене. Пользователи должны быть осторожны, если string заключена в двойные кавычки, чтобы избежать нежелательного взаимодействия между обратной косой чертой и двойными кавычками, поскольку обратная косая черта имеет особое значение в двойных кавычках. Замена шаблона выполняет проверку на наличие & без кавычек после расширения string; программисты оболочки должны указывать в кавычках все вхождения &, которые они хотят понимать буквально при замене, и убедиться, что все вхождения &, которые они хотят заменить, не заключены в кавычки.

Подобно операторам удаления шаблонов, двойные кавычки, окружающие строку замены, заключают расширенные символы в кавычки, в то время как двойные кавычки, заключающие всю замену параметра, этого не делают, поскольку расширение выполняется в контексте, который не учитывает никакие заключающие двойные кавычки.

Если включена опция оболочки nocasematch, то сопоставление выполняется без учета регистра буквенных символов.

Если параметр parameter равен @ или *, то операция подстановки применяется к каждому позиционному параметру по очереди и в результате получается расширенный список. Если parameter является переменной массива с индексом @ или *, то операция подстановки применяется к каждому элементу массива по очереди, а расширение является результирующим списком.

${parameter^pattern}

${parameter^^pattern}

${parameter,pattern}

${parameter,,pattern}

Изменение регистра Case modification. Это расширение изменяет регистр буквенных символов в параметре parameter. Сначала шаблон pattern расширяется для создания шаблона, как описано ниже в подразделе Сопоставление с шаблоном. Затем Bash проверяет символы в расширенном значении parameter на соответствие с pattern, как описано ниже. Если символ соответствует шаблону, то его регистр изменяется. Шаблон не должен пытаться соответствовать более чем одному символу.

Используется “^” для преобразования строчных букв, соответствующих шаблону pattern , в заглавные; “,” преобразует соответствующие заглавные буквы в строчные. Варианты ^ и , проверяют первый символ в расширенном значении и преобразуют его регистр, если он соответствует шаблону pattern; варианты ^^ и ,, проверяют все символы в расширенном значении и преобразуют каждый из них, который соответствует pattern. Если pattern опущен, то он обрабатывается как ?, который соответствует каждому символу.

Если параметр parameter равен @ или *, то операция изменения регистра применяется к каждому позиционному параметру по очереди, и в результате получается расширенный список. Если parameter является переменной массива с индексом @ или *, то операция изменения регистра применяется к каждому элементу массива по очереди, а расширение является результирующим списком.

${parameter@operator}

Преобразование параметра Parameter transformation. Расширение представляет собой либо преобразование значения параметр parameter, либо информации о самом parameter, в зависимости от значения оператора operator. Каждый operator состоит из одной буквы:

Подстановка команд¶

Подстановка команды Command substitution позволяет при выводе команды заменить саму команду. Существует две стандартные формы:

Bash протизводит расширение, выполняя command в окружающей среде подоболочки и заменяя подстановку команды стандартным выводом команды, при этом удаляются все завершающие новые строки. Встроенные новые строки не удаляются, но они могут быть удалены при разделении слов. Команда подстановки $(cat file) может быть заменена эквивалентной, но более быстрой командой $(< file).

При замене обратной кавычки в старом стиле обратная косая черта сохраняет свое буквальное значение, за исключением тех случаев, когда за ней следует $, ` или \. Первая обратная кавычка, перед которой не стоит обратная косая черта, завершает замену команды. При использовании формы $(command) все символы, заключенные в круглые скобки, составляют команду; ни один из них не обрабатывается специально.

Существует альтернативная форма замены команд:

которая выполняет команду command в текущей окружающей среде и записывает свои выходные данные, опять же с удалением завершающих новых строк.

Символ c, следующий за открывающей фигурной скобкой, должен быть пробелом, знаком табуляции, новой строкой или |, а закрывающая фигурная скобка должна находиться в позиции, в которой может отображаться зарезервированное слово (т.е. перед ним должен стоять символ завершения команды: точка с запятой). Bash позволяет соединять закрывающую фигурную скобку с остальными символами без добавления метасимвола оболочки, как это обычно требуется для зарезервированного слова.

Любые побочные эффекты command вступают в силу немедленно в текущей окружающей среде и сохраняются в текущей среде после завершения выполнения команды (например, встроенная команда exit завершает работу оболочки).

Этот тип подстановки команд внешне напоминает выполнение не именованной функции оболочки: локальные переменные создаются так же, как при выполнении функции оболочки, а встроенная команда return принудительно завершает выполнение команды command; однако остальная окружающая среда, включая позиционные параметры, совместно используется вызывающей стороной.

Если первым символом, следующим за открытой фигурной скобкой, является |, то конструкция расширяется до значения переменной команды REPLY после выполнения command, без удаления завершающих символов новой строки, а стандартный вывод command остается таким же, как и в вызывающей оболочке. Bash создает REPLY как изначально не установленную локальную переменную при выполнении command и восстанавливает REPLY до значения, которое оно имело до замены команды, после завершение command, как и в случае с любой локальной переменной.

Замены команд могут быть вложенными. Для вложения при использовании формы с обратными кавычками, закройте внутренние кавычки обратной косой чертой.

Если замена выполняется в двойных кавычках, то bash не выполняет разбиение слов и результаты расширения пути.

Арифметическое расширение¶

Арифметическое расширение вычисляет арифметическое выражение и подставляет результат. Формат арифметического расширения следующий:

Старый формат $[expression] устарел и будет удален в следующих версиях bash.

Это расширение expression расширяется так же, как если бы оно было заключено в двойные кавычки, но неэкранированные символы двойных кавычек в expression не обрабатываются специальным образом и удаляются. Все токены в выражении расширяются с помощью параметров и переменных, заменяются командой и удаляются кавычки. Результат обрабатывается как вычисляемое арифметическое выражение. Поскольку способ, которым Bash обрабатывает двойные кавычки, потенциально может привести к появлению пустых строк, арифметическое расширение рассматривает их как выражения, значение которых равно 0. Арифметические расширения могут быть вложенными.

Вычисление выполняется в соответствии с правилами, перечисленными ниже в разделе АРИФМЕТИЧЕСКИЕ ВЫЧИСЛЕНИЯ. Если значение expression неверно, то bash выводит сообщение о стандартной ошибке и не выполняет подстановку, а также не выполняет команду, связанную с расширением.

Подстановка процесса¶

Подстановка процесса Process substitution позволяет ссылаться на входные или выходные данные процесса, используя название файла. Она принимает форму <(list) или >(list). Процесс список list выполняется асинхронно, а его входные или выходные данные отображаются в виде названия файла. Это, полученное в результате расширения, название файла передается в качестве аргумента текущей команде.

Если используется форма >(list), то запись в файл обеспечивает ввод данных для list. Если используется форма <(list), то при чтении файла выводится list. Между < или > и левой круглой скобкой не должно быть пробела, иначе конструкция будет интерпретирована как перенаправление.

Замена процессов поддерживается в системах, поддерживающих именованные каналы (FIFOs) или метод именования открытых файлов /dev/fd.

При наличии возможности подстановка процесса выполняется одновременно с расширением параметров и переменных, подстановкой команд и арифметическим расширением.

Разделение слов¶

Оболочка проверяет результаты расширения параметров, подстановки команд и арифметического расширения, которые не были заключены в двойные кавычки, на предмет word splitting. Слова, которые не были расширены, не разбиваются.

Оболочка обрабатывает каждый символ IFS как разделитель и разбивает результаты других расширений на слова, используя эти символы в качестве разделителей полей.

Символ IFS whitespace - это пробел, определенный выше (смотрите подраздел Определения), который появляется в значении IFS. Пробел, табуляция и новая строка всегда считаются пробелами, даже если они не входят в категорию пробел space в локали.

Если значение IFS не задано, то разделение поля выполняется так, как если бы его значением было <space><tab><newline>, а эти символы рассматриваются как пробелы IFS. Если значение IFS равно нулю, то разбиение слов не происходит, но неявные нулевые аргументы (см. ниже) все равно удаляются.

Разделение слов начинается с удаления последовательностей пробельных символов IFS из начала и конца результатов предыдущих расширений, затем происходит разделение оставшихся слов.

Если значение IFS состоит исключительно из пробелов IFS, то любая последовательность символов IFS разделяет поле, поэтому поле состоит из символов, которые не являются пробелами IFS без кавычек, а пустые поля являются результатом только заключения в кавычки.

Если IFS содержит символ, не являющийся пробельным, то любой символ в значении IFS, который не является пробельным, вместе с любыми соседними символами IFS, отделяют поле. Это означает, что соседние разделители, отличные от пробелов IFS, создают пустое поле. Последовательность символов пробелов IFS также ограничивает поле.

Явные нулевые аргументы ("" или '') сохраняются и передаются командам в виде пустых строк. Неявные нулевые аргументы без кавычек, возникающие в результате расширения параметров, и не имеющие значений, удаляются. При расширении параметра без значения, заключенного в двойные кавычки, создается поле ноль, которое сохраняется и передается команде в виде пустой строки.

Когда аргумент ноль, заключенный в кавычки, появляется как часть слова, расширение которого не равно нулю, то при разделении слов удаляется нулевая часть аргумента, оставляя ненулевое расширение. То есть становится “-d''” словом “-d” после разделения слов и удаления нулевого аргумента.

Расширение названия пути¶

После разделения слов, если не установлена опция -f, bash проверяет каждое слово на наличие символов *, ? и [. Если один из этих символов обнаружен и не заключен в кавычки, то слово рассматривается как шаблон pattern и заменяется отсортированным списком названий файлов, соответствующих шаблону (смотрите подраздел Сопоставление с шаблоном ниже), в зависимости от значения переменной оболочки GLOBSORT.

If no matching filenames are found, and the shell option nullglob is not enabled, the word is left unchanged. If the nullglob option is set, and no matches are found, the word is removed. If the failglob shell option is set, and no matches are found, bash prints an error message and does not execute the command. If the shell option nocaseglob is enabled, the match is performed without regard to the case of alphabetic characters. Note that when using range expressions like [a-z] (see below), letters of the other case may be included, depending on the setting of LC_COLLATE.

Когда для расширения названия пути используется шаблон, то символ “.” в начале названия или сразу после него должна быть явно указана косая черта, если только не задана опция оболочки dotglob. Для соответствия названий файлов . и .., шаблон должен начинаться “.” (например, “.?”), даже если задана опция dotglob. Если опция оболочки globskipdots включена, то названия файлов . и .. никогда не будут совпадает, даже если шаблон начинается с “.”. Если названия путей не совпадают, то “.” символ не обрабатывается особым образом.

При сопоставлении названия пути символ косой черты всегда должен быть явно сопоставлен с косой чертой в шаблоне, но в других контекстах сопоставлений он может быть сопоставлен со специальным символом шаблона, как описано ниже в подразделе Сопоставление с шаблоном.

Смотрите описание команды shopt ниже в разделе ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ для получения описаний опций оболочки nocaseglob, nullglob, globskipdots, failglob и dotglob.

Переменная оболочки GLOBIGNORE может использоваться для ограничения набора названий файлов, соответствующих шаблону pattern. Если задано значение GLOBIGNORE, т все совпадающие названия файлов, которые также соответствуют одному из шаблонов в GLOBIGNORE, удаляются из списка совпадений. Если установлена опция nocaseglob, то сопоставление с шаблонами в GLOBIGNORE выполняется без учета регистра. Названия файлов . и .. всегда игнорируется, если задано не нулевое значение GLOBIGNORE. Однако установка для GLOBIGNORE ненулевого значения приводит к включению опции оболочки dotglob, поэтому все остальные названия файлов, начинающиеся с “.” совпадение. Чтобы вернуть прежнее поведение при игнорировании названий файлов, начинающихся с “.”, создает “.*” один из шаблонов в GLOBIGNORE. Опция dotglob отключена, если параметр GLOBIGNORE не установлен. При сопоставлении с шаблоном GLOBIGNORE учитывается настройка опции оболочки extglob.

Значение переменной оболочки GLOBSORT определяет порядок сортировки результатов расширения названия пути, как описано выше в подразделе Переменные оболочки.

Сопоставление с шаблоном

Любой символ, который появляется в шаблоне, за исключением специальных символов шаблона, описанных ниже, соответствует самому себе. Символ NUL может не встречаться в шаблоне. Обратная косая черта заменяет следующий символ; при сопоставлении экранирующая обратная косая черта отбрасывается. Специальные символы шаблона должны быть заключены в кавычки, если они должны быть подобраны буквально.

Специальные символы шаблона имеют следующие значения:

Если включена опция оболочки extglob с помощью встроенной команды shopt, то оболочка распознает несколько расширенных операторов сопоставления с шаблоном. В следующем описании список шаблонов pattern-list - это список из одного или нескольких шаблонов, разделенных символом |. Составные части могут быть сформированы с использованием одного или нескольких следующих подшаблонов:

Опция extglob изменяет поведение синтаксического анализатора, поскольку круглые скобки обычно рассматриваются как операторы с синтаксическим значением. Чтобы обеспечить корректный анализ расширенных шаблонов сопоставления, убедитесь, что extglob включено перед анализом конструкций, содержащих шаблоны, включая функции оболочки и замены команд.

При сопоставлении названий файлов опция оболочки dotglob определяет набор проверяемых названий файлов: когда включено dotglob, набор названий файлов включает все файлы, начинающиеся с “.”, but . и .. должен соответствовать шаблону или вложенному шаблону, начинающемуся с точки; если он отключен, то в набор не включаются названия файлов, начинающиеся с “.” если только шаблон или субшаблон не начинается с “.”. Если опция оболочки globskipdots включена, то названия файлов . и .. никогда не появляется в наборе. Как указано выше, “.” имеет особое значение только при совпадениях названий файлов.

Сложное расширенное сопоставления с шаблоном с длинными строками выполняется медленно, особенно если шаблоны содержат чередования, а строки содержат множество совпадений. Используйте отдельные совпадения с более короткими строками или используйте массивы строк вместо одной длинной строки.

Удаление кавычки¶

После предыдущих расширений все не заключенные в кавычки символы \, ' и ", которые не были получены в результате одного из вышеуказанных расширений, будут удалены.

Перенаправление ввода¶

При перенаправлении ввода открывается файл, название которого является результатом расширения слова word для чтения по файловому дескриптору n или стандартный ввод (файловый дескриптор 0), если n не указано.

Общий формат для перенаправления входных данных следующий:

Перенаправление вывода¶

При перенаправлении выходных данных открывается файл, название которого является результатом расширения слова word для записи в файловом дескрипторе n или стандартный вывод (файловый дескриптор 1), если n не указано. Если файл не существует, то он создается; если он существует, то он обрезается до нулевого размера.

Общий формат для перенаправления выходных данных следующий:

Если оператором перенаправления является > и включена опция noclobber для встроенной команды set, то перенаправление завершается ошибкой, если файл, название которого является результатом расширения слова word, существует и является обычным файлом. Если оператором перенаправления является >| или оператором перенаправления является >, а опция noclobber для встроенной команды set не включена, то bash попытается перенаправить, даже если файл, названный word существует.

Добавление перенаправленных выходных данных¶

При перенаправлении вывода таким образом открывается файл, название которого является результатом расширения слова word для добавления к файловому дескриптору n, или стандартный вывод (файловый дескриптор 1), если n не указано. Если файл не существует, то он создается.

Общий формат для добавления выходных данных следующий:

Перенаправление стандартного вывода и стандартной ошибки¶

Эта конструкция перенаправляет как стандартный вывод (файловый дескриптор 1), так и стандартный вывод об ошибке (файловый дескриптор 2) в файл, название которого является расширением слова word.

Существует два формата для перенаправления стандартного вывода и стандартной ошибки:

Из двух форматов предпочтительнее первый. Семантически это эквивалентно

При использовании второго формата слово word может не расширяться до числа или -. Если это так, то, по соображениям совместимости, применяются другие операторы перенаправления (смотрите подраздел Дублирование файловых дескрипторов ниже).

Добавление стандартного вывода и стандартной ошибки¶

Эта конструкция добавляет как стандартный вывод (файловый дескриптор 1), так и стандартный вывод об ошибке (файловый дескриптор 2) к файлу, название которого является расширением слова word.

Формат для добавления стандартного вывода и стандартной ошибки следующий:

Это семантически эквивалентно

(смотрите подраздел Дублирование файловых дескрипторов ниже).

Здесь документы¶

Перенаправление "Здесь документы" (Here Documents) предписывает оболочке считывать входные данные из текущего источника до тех пор, пока она не прочитает строку, содержащую только разделитель delimiter (без завершающих пробелов). Все строки, прочитанные до этого момента, затем становятся стандартными входными данными (или файловым дескриптором n, если указано n) для команды.

Формат документов here-documents следующий:

[n]<<[-]word


        here-document
delimiter

Оболочка не выполняет расширение параметров и переменных, подстановку команд, арифметическое расширение или расширение названия пути для слова word.

Если какая-либо часть слова word заключена в кавычки, то разделитель delimiter является результатом удаления кавычек в слове word и строки в документе here-document не расширяются. Если word не заключено в кавычки, то delimiter - это само слово word и текст документа here-document обрабатывается аналогично строке, заключенной в двойные кавычки: все строки документа here-document подвергаются расширению параметров, замене командами и арифметическому расширению, последовательность символов \<newline> трактуется буквально, а \ необходимо использовать для заключения в кавычки символов \, $ и `; однако символы двойных кавычек не имеют специального значения.

Если оператором перенаправления является <<-, то оболочка удаляет все начальные символы табуляции из строк ввода и строки, содержащей delimiter. Это позволяет естественным образом использовать отступы в текстовых документах в сценариях оболочки.

Если разделитель не заключен в кавычки, то последовательность \<newline> рассматривается как продолжение строки: две строки соединяются, а обратная косая черта-новая строка удаляется. Это происходит при чтении документа here-document, перед проверкой наличия конечного разделителя, поэтому соединенные строки могут образовывать конечный разделитель.

Здесь строки¶

Вариант документов "Здесь строки" (Here Strings) имеет следующий формат:

[n]<<<word

Слово word расширяется с помощью тильды, параметров и переменных, подстановки команд, арифметического расширения и удаления кавычек. Расширение названия пути и разделение слов не выполняются. Результат передается в виде отдельной строки с добавлением новой строки к команде при ее стандартном вводе (или файловому дескриптору n, если указано n).

Дублирование файловых дескрипторов¶

Оператор перенаправления

используется для дублирования входных файловых дескрипторов. Если слово word расширяется до одной или нескольких цифр, то файловый дескриптор n становится копией этого файлового дескриптора. Ошибка перенаправления возникает, если цифры в word не указывают на файловый дескриптор, открытый для ввода. Если значение word равно -, то файловый дескриптор n закрыт. Если n не указано, то используется стандартный ввод (файловый дескриптор 0).

Оператор перенаправления

используется аналогично для дублирования выходных файловых дескрипторов. Если n не указано, то используется стандартный вывод (файловый дескриптор 1). Если цифры в word не указывают файловый дескриптор, открытый для вывода, то это означает ошибку перенаправления. Если значение word равно -, то файловый дескриптор n закрывается. В качестве особого случая, если n опущено, а word не расширяется до одной или нескольких цифр или -, это перенаправляет стандартный вывод и стандартную ошибку, как описано ранее.

Перемещение файловых дескрипторов¶

Оператор перенаправления

перемещает файловый дескриптор со значением digit в файловый дескриптор со значением n или в стандартный ввод (файловый дескриптор 0), если n не указано. Дескриптор со значением digit закрывается после дублирования в n.

Аналогично, оператор перенаправления

перемещает файловый дескриптор со значением digit в файловый дескриптор со значением n или в стандартный вывод (файловый дескриптор 1), если n не указано.

Открытие файловых дескрипторов для чтения и записи¶

Оператор перенаправления

открывает файл, название которого является расширением слова word, как для чтения, так и для записи по файловому дескриптору n или по файловому дескриптору 0, если n не указано. Если файл не существует, то он создается.

Формат библиотеки Readline¶

В этом подразделе используются концепции редактирования в стиле редактора Emacs и его обозначения для нажатия клавиш. Управляющие клавиши обозначаются C-key, например, C-n означает Control-N. Аналогично, клавиша meta обозначаются M-key, поэтому M-x означает Мета-X. Мета-клавиша часто обозначается “Alt” или “Option”.

На клавиатурах без клавиши Meta M-x означает ESC x, т.е. нажать и отпустить клавишу Escape, затем последовательно нажать и отпустить клавишу x. Таким образом, ESC становится префиксом meta prefix. Комбинация M-C-x означает ESC Control-x: нажать и отпустить клавишу Escape, затем нажать и удерживать клавишу Control, одновременно нажимая клавишу x, затем отпустить обе клавиши.

На некоторых клавиатурах модификатор мета-клавиши выдает символы с установленным восьмым разрядом (0200). Вы можете использовать переменную enable-meta-key, чтобы контролировать, будет ли это выполняться, если клавиатура это позволяет. На многих других устройствах терминал или эмулятор терминала преобразует мета-клавишу в последовательность клавиш, начинающуюся с ESC, как описано в предыдущем параграфе.

Если ваша клавиша Meta создает последовательность клавиш с мета-префиксом ESC, то вы можете настроить привязки клавиш M-key, которые вы указываете (смотрите подраздел Привязки клавиш библиотеки Readline ниже), аналогично, установив переменную force-meta-prefix.

Командам библиотеки Readline могут присваиваться числовые значения аргументов arguments, которые обычно используются для подсчета повторений. Однако иногда значение имеет знак аргумента. Передача отрицательного аргумента команде, которая действует в прямом направлении (например, kill-line) заставляет эту команду действовать в обратном направлении. Ниже приведены команды, поведение которых с аргументами отличается от этого.

Точка point - это текущее положение курсора, а метка mark относится к сохраненному положению курсора. Текст между точкой и меткой называется область region. В библиотеке Readline есть концепция активной области active region: когда область активна, тогда readline повторно отображает область, используя значение переменной active-region-start-color. Переменная enable-active-region это включает и выключает. Несколько команд делают область активной; они приведены ниже.

Когда команда описывается как удаляющая текст killing, то удаленный текст сохраняется для возможного использования в будущем (при "выдергивании" yanking). Уничтоженный (удалённый) текст сохраняется в кольце удаления kill ring. При последовательном удалении удаленный текст объединяется в один блок, который можно удалить за один раз. Команды, которые не удаляют текст, разделяют фрагменты текста в кольце удаления.

Инициализация библиотеки Readline¶

Библиотека Readline настраивается путем ввода команд в файл инициализации (файл inputrc). Название этого файла берется из значения переменной оболочки INPUTRC. Если эта переменная не задана, то по умолчанию используется ~/.inputrc. Если этот файл не существует или не может быть прочитан, то readline выполняет поиск /etc/inputrc. Когда запускается программа, использующая библиотеку readline, тогда readline считывает файл инициализации и устанавливает найденные в нем привязки клавиш и переменные, прежде чем считывать любой пользовательский ввод.

В файле inputrc разрешено использовать только несколько основных конструкций. Пустые строки игнорируются. Строки, начинающиеся с #, являются комментариями. Строки, начинающиеся с $, обозначают условные конструкции. Остальные строки обозначают привязки клавиш и настройки переменных.

Привязки клавиш по умолчанию в этом разделе могут быть изменены с помощью команд привязки клавиш в файле inputrc. Программы, использующие библиотеку readline, включая bash, могут добавлять свои собственные команды и привязки.

Например, размещение

ввод в inputrc заставил бы M-C-u выполнить команду readline универсальный аргумент universal-argument.

Привязки клавиш могут содержать следующие символические названия: DEL, ESC, ESCAPE, LFD, NEWLINE, RET, RETURN, RUBOUT (деструктивный обратный пробел), SPACE, SPC и TAB.

В дополнение к названиям команд, readline позволяет привязывать клавиши к строке, которая вставляется при нажатии клавиши (macro). Различие между макросом и командой заключается в том, что макрос заключен в одинарные или двойные кавычки.

Привязки клавиш библиотеки Readline¶

Синтаксис для управления привязками клавиш в файле inputrc прост. Все, что требуется, - это название команды или текст макроса и последовательность клавиш, к которой он должен быть привязан. Последовательность клавиш может быть указана одним из двух способов: 1) в виде символического названия клавиши, возможно, с префиксами Meta- или Control- 2) или в виде последовательности клавиш, состоящей из одного или нескольких символов, заключенных в двойные кавычки. Последовательность клавиш и название разделяются двоеточием. Между названием и двоеточием не должно быть пробелов.

При использовании формы keyname:function-name или macro, keyname - это название клавиши на английском языке. Например:

Control-u: universal-argument
Meta-Rubout: backward-kill-word
Control-o: "> output"

В приведенном выше примере C-u привязана к функции universal-argument, M-DEL привязана к функции backward-kill-word, а C-o привязана к запуску макроса, выраженного с правой стороны (то есть для вставки текста “> output” в строку).

Во второй форме, "keyseq":function-name или macro, keyseq отличается от приведенной выше keyname тем, что строки, обозначающие всю последовательность клавиш, могут быть указаны путем заключения последовательности в двойные кавычки. Можно использовать некоторые экранирующие клавиши в стиле GNU Emacs, как в следующем примере, но ни одно из символических названий не распознается.

"\C-u": universal-argument
"\C-x\C-r": re-read-init-file
"\e[11~": "Function Key 1"

В этом примере клавиша C-u снова привязана к функции universal-argument. Клавиша C-x C-r привязана к функции re-read-init-file, а ESC [ 1 1 ~ привязана к вставке текста “Function Key 1”.

Полный набор escape-последовательностей в стиле GNU Emacs, доступных при указании клавишных последовательностей, представлен следующим образом

В дополнение к экранирующим последовательностям в стиле GNU Emacs доступен второй набор экранирующих символов с обратной косой чертой:

При вводе текста макроса необходимо использовать одинарные или двойные кавычки для указания определения макроса. Предполагается, что текст без кавычек является названием функции. Описанные выше экранирующие обратные косые черты раскрываются в теле макроса. Обратная косая черта заключает в кавычки любой другой символ в тексте макроса, включая " и '.

Bash отобразит или изменит текущие привязки клавиш readline с помощью встроенной команды bind. Опции -o emacs или -o vi для встроенной команды set (смотрите ниже раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ) изменяют режим редактирования во время интерактивного использования.

Переменные Readline¶

В Readline есть переменные, которые можно использовать для дальнейшей настройки её поведения. Переменная может быть задана в файле inputrc с помощью инструкции вида

За исключением случаев, когда это указано, переменные readline могут принимать значения "Включено" On или "Выключено" Off (без учета регистра). Нераспознанные названия переменных игнорируются. Когда readline считывает значение переменной, пустые или нулевые значения, “on” (без учета регистра) и “1” эквивалентны On. Все остальные значения эквивалентны Off.

Команда bind -V выводит список текущих названий и значений переменных readline (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже).

Переменными и их значениями по умолчанию являются:

active-region-start-color

Строковая переменная, которая управляет цветом текста и фоном при отображении текста в активной области (смотрите описание функции enable-active-region ниже). Эта строка не должна занимать никаких физических позиций символов на дисплее, поэтому она должна состоять только из терминальных escape-последовательностей. Она выводится на терминал перед отображением текста в активной области. Значение этой переменной возвращается к значению по умолчанию при каждом изменении типа терминала. Значение по умолчанию - это строка, которая переводит терминал в режим ожидания, как указано в описании терминала terminfo. Примерное значение может быть следующим “\e[01;33m”.

active-region-end-color

Строковая переменная, которая “undoes” эффекты "активная область-начальный цвет" active-region-start-color и восстанавливает “normal” отображение на дисплее терминала после отображения текста в активной области. Эта строка не должна занимать никаких физических позиций символов на дисплее, поэтому она должна состоять только из управляющих последовательностей терминала. Она выводится на терминал после отображения текста в активной области. Эта переменная возвращается к значению по умолчанию при каждом изменении типа терминала. Значением по умолчанию является строка, которая выводит терминал из режима ожидания, как указано в описании терминала terminfo. Примерным значением может быть “\e[0m”.

bell-style (audible)

Управляет тем, что происходит, когда readline хочет вызвать звонок терминала. Если задано значение none, то readline никогда не вызовет звонок. Если задано значение visible, то readline использует видимый звонок, если он доступен. Если установлено значение audible, то readline попытается вызвать звуковой звонок терминала.

bind-tty-special-chars (On)

Если задано значение On, то readline пытается привязать управляющие символы, которые специально обрабатываются драйвером терминала ядра, к их эквивалентам readline. Они переопределяют описанные здесь привязки readline по умолчанию. Тип “stty -a” в приглашении bash, чтобы просмотреть текущие настройки вашего терминала, включая специальные управляющие символы (обычно cchars).

blink-matching-paren (Off)

Если установлено значение On, то readline пытается на короткое время переместить курсор на открывающую скобку при вставке закрывающей скобки.

colored-completion-prefix (Off)

Если задано значение On, то при выводе списка завершений readline отображает общий префикс набора возможных завершений, используя другой цвет. Определения цвета взяты из значения переменной окружения LS_COLORS. Если имеется определение цвета $LS_COLORS для обычного суффикса “.readline-colored-completion-prefix”, readline использует этот цвет для общего префикса вместо его значения по умолчанию.

colored-stats (Off)

Если задано значение On, то readline отображает возможные завершения, используя разные цвета, чтобы указать тип файла. Определения цвета берутся из значения переменной среды окружения LS_COLORS.

comment-begin (

“#”) Строка, которую вставляет команда readline insert-comment. Эта команда привязана к M-# в режиме emacs и к # в режиме vi.

completion-display-width (-1)

Количество столбцов экрана, используемых для отображения возможных совпадений при выполнении завершения. Значение игнорируется, если оно меньше 0 или больше ширины экрана терминала. При значении 0 совпадения отображаются по одному в строке. Значение по умолчанию равно -1.

completion-ignore-case (Off)

Если задано значение On, то readline выполняет сопоставление названий файлов и завершение без учета регистра.

completion-map-case (Off)

Если задано значение On и включено значение "Завершение-игнорирования регистра", то readline обрабатывает дефисы (-) и подчеркивания (_) как эквивалентные при сопоставлении названий файлов и завершений без учета регистра.

completion-prefix-display-length (0)

Максимальная длина в символах общего префикса в списке возможных дополнений, который отображается без изменений. Если задано значение, большее нуля, то readline заменяет общие префиксы, длина которых превышает это значение, многоточием при отображении возможных дополнений. Если завершение начинается с точки, а начальная строка readline завершает названия файлов, то вместо многоточия используются три символа подчеркивания.

completion-query-items (100)

Это определяет, когда пользователя запрашивают о просмотре количества возможных завершений, сгенерированных командой возможные завершения possible-completions. Может быть установлено любое целое значение, большее или равное нулю. Если количество возможных завершений больше или равно значению этой переменной, то readline запрашивает, желает ли пользователь просмотреть их; в противном случае readline просто выводит их список в терминале. Нулевое значение означает, что readline никогда не должна задавать запрос; отрицательные значения рассматриваются как нулевые.

convert-meta (On)

Если задано значение On, то readline преобразует считываемые символы, для которых установлен восьмой бит, в последовательность клавиш ASCII, очищая восьмой бит и добавляя к нему escape-символ (преобразуя символ в мета-префикс). Значение по умолчанию - On, но readline устанавливает значение Off, если локаль содержит символы, кодировки которых могут включать байты с установленным восьмым разрядом. Эта переменная зависит от категории локали LC_CTYPE и может изменяться при изменении локали. Эта переменная также влияет на привязку клавиш; смотрите описание Принудительный мета-префикс ниже.

disable-completion (Off)

Если задано значение On, то readline запрещает завершение слова. Символы завершения вставляются в строку так, как если бы они были сопоставлены с self-insert.

echo-control-characters (On)

Если установлено значение On, в операционных системах, которые указывают, что они его поддерживают, то readline отображает символ, соответствующий сигналу, генерируемому с клавиатуры.

editing-mode (emacs)

Определяет, будет ли readline использовать набор привязок клавиш, аналогичный Emacs или vi. Режим редактирования editing-mode может быть установлен либо в emacs, либо в vi.

emacs-mode-string (@)

Если включена переменная show-mode-in-prompt, то эта строка отображается непосредственно перед последней строкой основного приглашения, когда включен режим редактирования emacs. Значение раскрывается как привязка к клавише, поэтому доступен стандартный набор мета- и управляющих префиксов, а также escape-последовательностей с обратной косой чертой. Символы \1 и \2 являются начальными и конечными последовательностями непечатаемых символов, которые могут быть использованы для встраивания последовательности управления терминалом в строку режима.

enable-active-region (On)

Когда для этой переменной задано значение On, тогда readline позволяет определенным командам обозначать область как active. Когда область активна, тогда readline выделяет текст в области, используя значение переменной active-region-start-color, значение которой по умолчанию равно строке, включающей режим выделения терминала. В активной области отображается текст, вставленный с помощью вставки в квадратных скобках и любой соответствующий текст, найденный с помощью инкрементального и не инкрементального поиска по истории.

enable-bracketed-paste (On)

Если установлено значение On, то readline настраивает терминал на вставку каждой вставки в буфер редактирования в виде отдельной строки символов, вместо того чтобы обрабатывать каждый символ так, как если бы он был прочитан с клавиатуры. Это называется "режим вставки в квадратных скобках" bracketed-paste mode; он предотвращает выполнение readline любых команд редактирования, связанных с последовательностями клавиш, появляющимися во вставленном тексте.

enable-keypad (Off)

Если установлено значение On, то readline пытается включить клавиатуру приложения при его вызове. В некоторых системах это необходимо для включения клавиш со стрелками.

enable-meta-key (On)

Если установлено значение On, то readline пытается включить любую клавишу мета-модификатор, которая, как утверждается, поддерживается терминалом. На многих терминалах мета-клавиша используется для отправки восьмибитных символов; эта переменная проверяет возможности терминала, что указывает на то, что терминал может включать и отключать режим, который устанавливает восьмой бит символа (0200), если мета-клавиша удерживается нажатой при вводе символа (метасимвол).

expand-tilde (Off)

Если задано значение On, то readline выполняет расширение тильды при попытке завершения слова.

force-meta-prefix (Off)

Если установлено значение On, то readline изменяет свое поведение при привязке клавишных последовательностей, содержащих \M- или Meta- (смотрите подраздел Привязки клавиш выше), преобразуя клавишную последовательность вида \M-C или Meta-C в две последовательность символов ESC C (добавление префикса meta). Если для force-meta-prefix задано значение Off (по умолчанию), то readline использует значение переменной convert-meta для того, чтобы определить, следует ли выполнять это преобразование: если для convert-meta задано значение On, то readline выполняет преобразование, описанное выше; если это Off, то readline преобразует C в метасимвол, устанавливая восьмой бит (0200).

history-preserve-point (Off)

Если установлено значение On, то код истории пытается поместить точку в одно и то же место в каждой строке истории, полученной с помощью previous-history или next-history.

history-size (unset)

Задаёт максимальное количество записей истории, сохраняемых в списке истории. Если задано нулевое значение, то все существующие записи истории удаляются, а новые записи не сохраняются. Если задано значение меньше нуля, то количество записей истории не ограничено. По умолчанию bash устанавливает максимальное количество записей истории в значение переменной оболочки HISTSIZE. Если присвоить history-size нечисловое значение, то максимальное количество записей истории будет равно 500.

horizontal-scroll-mode (Off)

Установка для этой переменной значения On заставляет readline использовать для отображения одну строку, прокручивая вводимые данные по горизонтали на одной строке экрана, когда их длина становится больше ширины экрана не переходя на новую строку. Эта настройка автоматически включается для терминалов высотой 1.

input-meta (Off)

Если установлено значение On, то readline разрешает восьмибитный ввод (то есть не очищает восьмой бит в считываемых символах), независимо от того, что, по утверждению терминала, он может поддерживать. Значение по умолчанию - Off, но readline устанавливает значение On, если локаль содержит символы, кодировки которых могут включать байты с установленным восьмым разрядом. Эта переменная зависит от категории локали LC_CTYPE и ее значение может меняться при изменении локали. Название meta-flag является синонимом input-meta.

isearch-terminators (

“C-[C-j”) Строка символов, которая должна завершать инкрементальный поиск без последующего выполнения символа в качестве команды. Если этой переменной не было присвоено значение, то символы ESC и C-j завершают инкрементальный поиск.

keymap (emacs)

Устанавливает текущую комбинацию клавиш readline. Допустимыми названиями комбинаций клавиш могут быть emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command и vi-insert; emacs эквивалентно emacs-standard. Значение по умолчанию - emacs; значение "Режим редактирования" editing-modeтакже влияет на раскладку клавиш по умолчанию.

keyseq-timeout (500)

Указывает время, в течение которого readline будет ожидать символ при считывании неоднозначной последовательности клавиш (которая может сформировать полную последовательность клавиш, используя уже прочитанные входные данные или может потребовать дополнительного ввода для завершения более длинной последовательности клавиш). Если readline не получает никаких входных данных в течение тайм-аута, то она использует более короткую, но полную последовательность клавиш. Значение указывается в миллисекундах, поэтому значение 1000 означает, что readline будет ждать дополнительного ввода в течение одной секунды. Если для этой переменной задано значение, меньшее или равное нулю или нечисловое значение, то readline ожидает нажатия другой клавиши, чтобы решить, какую последовательность клавиш следует выполнить.

mark-directories (On)

Если задано значение On, то к окончанию названий каталогов добавляется косая черта.

mark-modified-lines (Off)

Если установлено значение On, то readline отображает строки журнала, которые были изменены, с предшествующей звездочкой (*).

mark-symlinked-directories (Off)

Если задано значение On, то к завершенным названиям, которые являются символическими ссылками на каталоги, добавляется косая черта, в зависимости от значения mark-directories.

match-hidden-files (On)

Эта переменная, если ей присвоено значение On, заставляет readline сопоставлять файлы, названия которых начинаются с “.” (скрытые файлы) при заполнении названия файла. Если установлено значение Off, то пользователь должен указать начальную “.” в названии файла, которое должно быть заполнено.

menu-complete-display-prefix (Off)

Если установлено значение On, то при завершении в меню отображается общий префикс списка возможных завершений (который может быть пустым) перед циклическим просмотром списка.

output-meta (Off)

Если задано значение On, то readline отображает символы с установленным восьмым разрядом напрямую, а не в виде escape-последовательности с мета-префиксом. Значение по умолчанию - Off, но readline устанавливает значение On, если локаль содержит символы, кодировки которых могут включать байты с установленным восьмым разрядом. Эта переменная зависит от категории локали LC_CTYPE и ее значение может измениться при изменении локали.

page-completions (On)

Если установлено значение On, то readline использует внутренний пейджер, похожий на more(1), для одновременного отображения экрана, полного возможных завершений.

prefer-visible-bell

Смотрите bell-style.

print-completions-horizontally (Off)

Если установлено значение On, то readline отображает завершения с совпадениями, отсортированными по горизонтали в алфавитном порядке, а не вниз по экрану.

revert-all-at-newline (Off)

Если установлено значение On, то readline отменит все изменения в строках истории, прежде чем вернуться при выполнении accept-line. По умолчанию строки истории могут быть изменены и сохранены в отдельных списках отмены при вызовах readline.

search-ignore-case (Off)

Если установлено значение On, то readline выполняет инкрементный и неинкрементный поиски по списку истории без учета регистра.

show-all-if-ambiguous (Off)

Это изменяет поведение функций завершения по умолчанию. Если задано значение On, то слова, которые имеют более одного возможного завершения, сразу же отображаются в списке совпадений, а не выдается звонок колокольчика.

show-all-if-unmodified (Off)

Это изменяет поведение функций завершения по умолчанию аналогично show-all-if-ambiguous. Если задано значение On, то слова, которые имеют более одного возможного завершения без какого-либо возможного частичного завершения (возможные завершения не имеют общего префикса), то они сразу же отображаются в списке совпадений, а не вызывают звонок колокольчика.

show-mode-in-prompt (Off)

Если задано значение On, то добавляется в начало запроса строка, указывающая режим редактирования: emacs, команда или вставка vi. Строки режима могут быть заданы пользователем (например, emacs-mode-string).

skip-completed-text (Off)

Если задано значение On, то это изменяет поведение завершения по умолчанию при вставке одного совпадения в строку. Оно активно только при выполнении завершения в середине слова. Если включено, то readline не вставляет символы завершения, которые соответствуют символам после точки в завершаемом слове, поэтому части слова, следующие за курсором, не дублируются.

vi-cmd-mode-string ((cmd))

Если включена переменная show-mode-in-prompt, то эта строка отображается непосредственно перед последней строкой основного приглашения, когда включен режим редактирования vi и в командном режиме. Значение раскрывается как привязка к клавише, поэтому доступен стандартный набор мета- и управляющих префиксов, а также escape-последовательностей с обратной косой чертой. Символы \1 и \2 являются начальными и конечными последовательностями непечатаемых символов, которые могут быть использованы для встраивания последовательности управления терминалом в строку режима.

vi-ins-mode-string ((ins))

Если включена переменная show-mode-in-prompt, то эта строка отображается непосредственно перед последней строкой основного приглашения, когда включен режим редактирования vi в режиме вставки. Значение раскрывается как привязка к клавише, поэтому доступен стандартный набор мета- и управляющих префиксов, а также escape-последовательностей с обратной косой чертой. Символы \1 и \2 являются начальными и конечными последовательностями непечатаемых символов, которые могут быть использованы для встраивания последовательности управления терминалом в строку режима.

visible-stats (Off)

Если задано значение On, то при выводе возможных дополнений к названию файла добавляется символ, обозначающий тип файла, как указано в stat(2).

Конструкции условий Readline¶

В библиотеке Readline реализована функция, схожая по смыслу с функциями условной компиляции препроцессора Cи, которая позволяет выполнять привязку клавиш и настройки переменных в результате тестов. Доступны четыре директивы синтаксического анализа.

$if

Конструкция $if позволяет создавать привязки в зависимости от режима редактирования, используемого терминала или приложения, использующего readline. Текст теста после любого оператора сравнения продолжается до конца строки; если не указано иное, для его выделения не требуется никаких символов.

$if Bash
# Процитировать текущее или предыдущее слово
"\C-xq": "\eb\"\ef\""
$endif

$else

Команды в этой ветви директивы $if выполняются в случае сбоя теста.

$endif

Эта команда, как видно из предыдущего примера, завершает выполнение команды $if.

$include

Эта директива принимает в качестве аргумента одно название файла и считывает команды и привязки клавиш из этого файла. Например, следующая директива будет выглядеть следующим образом /etc/inputrc:

$include  /etc/inputrc

Поиск¶

Библиотека Readline предоставляет команды для поиска строк, содержащих указанную строку, в истории команд (смотрите ниже раздел ИСТОРИЯ). Существует два режима поиска: инкрементальный incremental и не инкрементальный non-incremental.

Инкрементальный поиск начинается до того, как пользователь закончит вводить строку поиска. По мере ввода каждого символа в строке поиска readline отображает следующую запись из истории, соответствующую введенной строке. Для инкрементального поиска требуется ровно столько символов, сколько необходимо для поиска нужной записи в истории. При использовании режима редактирования emacs введите C-r, чтобы выполнить поиск в истории в обратном направлении в поисках определенной строки. При вводе C-s выполняется поиск в истории в прямом (вперёд) направлении. Символы, присутствующие в значении переменной isearch-terminators, используются для завершения инкрементального поиска. Если этой переменной не было присвоено значение, то ESC и C-j завершают инкрементальный поиск. C-g прерывает инкрементальный поиск и восстанавливает исходную строку. Когда поиск завершается, запись журнала, содержащая строку поиска, становится текущей строкой.

Чтобы найти другие совпадающие записи в списке истории, введите C-r или C-s, соответственно. При этом выполняется поиск в истории в обратном или прямом направлениях в поисках следующей записи, соответствующей введенной строке поиска. Любая другая последовательность клавиш, связанная с командой терминала readline, завершает поиск и выполняет эту команду. Например, новая строка завершает поиск и принимает строку, тем самым выполняя команду из списка истории. Команда перемещения завершит поиск, сделает последнюю найденную строку текущей и начнет редактирование.

Readline запоминает последнюю строку инкрементального поиска. Если две строки C-r вводятся без каких-либо промежуточных символов, определяющих новую строку поиска, то readline использует любую запомненную строку поиска.

При не инкрементальном поиске строка поиска считывается целиком, прежде чем начать поиск совпадающих записей в истории. Строка поиска может быть введена пользователем или быть частью содержимого текущей строки.

Названия команд Readline¶

Ниже приведен список названий команд и последовательности клавиш по умолчанию, к которым они привязаны. Названия команд без соответствующей последовательности клавиш по умолчанию не привязаны.

В следующих описаниях "точка" point обозначает текущее положение курсора, а "метка" mark - положение курсора, сохраненное командой set-mark. Текст между точкой и меткой называется областью region. В Readline есть концепция активной области active region: когда область активна, тогда readline повторно отображает область, используя значение переменной active-region-start-color. Переменная readline enable-active-region включает и выключает эту переменную. Несколько команд устанавливают область в активное состояние; они описаны ниже.

Команды перемещения¶

beginning-of-line (C-a)

Перейти к началу текущей строки. На некоторых клавиатурах это также может быть связано с клавишей Home.

end-of-line (C-e)

Перейти к концу строки. На некоторых клавиатурах это также может быть связано с клавишей End.

forward-char (C-f)

Переместить символ вперед. На некоторых клавиатурах это также может быть связано с клавишей со стрелкой вправо.

backward-char (C-b)

Переместить символ назад. На некоторых клавиатурах это также может быть связано с клавишей со стрелкой влево.

forward-word (M-f)

Перейти к концу следующего слова. Слова состоят из буквенно-цифровых символов (букв и цифр).

backward-word (M-b)

Вернуться к началу текущего или предыдущего слова. Слова состоят из буквенно-цифровых символов (букв и цифр).

shell-forward-word (M-C-f)

Перейти к концу следующего слова. Слова разделяются метасимволами, не заключенными в кавычки.

shell-backward-word (M-C-b)

Вернуться к началу текущего или предыдущего слова. Слова разделяются метасимволами оболочки, не заключенными в кавычки.

previous-screen-line

Попытаться переместить точку в тот же столбец физического экрана в предыдущей строке физического экрана. Это не даст желаемого эффекта, если текущая строка readline занимает не более одной физической строки или если точка не превышает длину приглашения плюс ширину экрана.

next-screen-line

Попытаться переместить точку в тот же столбец физического экрана в следующей строке физического экрана. Это не даст желаемого эффекта, если текущая строка readline занимает не более одной физической строки или если длина текущей строки readline не превышает длину приглашения плюс ширина экрана.

clear-display (M-C-l)

Очистить экран и, если возможно, буфер обратной прокрутки терминала, затем перечертить текущую строку, оставив текущую строку в верхней части экрана.

clear-screen (C-l)

Очистить экран, затем переместить текущую строку, оставив ее в верхней части экрана. Используя числовой аргумент, обновить текущую строку, не очищая экран.

redraw-current-line

Обновить текущую строку.

Команды управления историей¶

accept-line (Newline, Return)

Принимать строку независимо от того, где находится курсор. Если эта строка непустая, то добавить ее в список истории в соответствии с состоянием переменных HISTCONTROL и HISTIGNORE. Если строка является измененной строкой истории, то восстановить ее в исходном состоянии.

previous-history (C-p)

Извлекать предыдущую команду из списка истории, перемещаясь назад по списку. Это также может быть связано с клавишей со стрелкой вверх на некоторых клавиатурах.

next-history (C-n)

Извлечь следующую команду из списка истории, продвигаясь по списку вперед. Это также может быть связано с клавишей со стрелкой вниз на некоторых клавиатурах.

beginning-of-history (M-<)

Перейти на первую строку в истории.

end-of-history (M->)

Перейти к концу истории ввода, т.е. к строке, которая вводится в данный момент.

operate-and-get-next (C-o)

Принимать текущую строку для выполнения, как если бы была введена новая строка и извлекать следующую строку относительно текущей строки из журнала для редактирования. Числовой аргумент, если он указан, указывает, какую запись журнала следует использовать вместо текущей строки.

fetch-history

Используя числовой аргумент, извлечь эту запись из списка истории и сделать ее текущей строкой. Когда аргумент не определён, тогда вернуться к первой записи в списке истории.

reverse-search-history (C-r)

Искать в обратном направлении, начиная с текущей строки и двигаясь “up” по списку истории по мере необходимости. Это пошаговый поиск. Эта команда устанавливает область в соответствии с соответствующим текстом и активирует область.

forward-search-history (C-s)

Искать вперед, начиная с текущей строки и двигаясь “down” по списку истории по мере необходимости. Это пошаговый поиск. Эта команда устанавливает область в соответствии с соответствующим текстом и активирует область.

non-incremental-reverse-search-history (M-p)

Искать назад по списку истории, начиная с текущей строки, используя неинкрементный поиск по строке, предоставленной пользователем. Строка поиска может совпадать с любым местом в строке истории.

non-incremental-forward-search-history (M-n)

Искать вперёд по списку истории, используя не инкрементальный поиск по строке, предоставленной пользователем. Строка поиска может совпадать с любым местом в строке истории.

history-search-backward

Искать назад по списку истории в поисках последовательности символов между началом текущей строки и точкой. Строка поиска должна совпадать с началом строки истории. Это не инкрементальный поиск. Это может быть связано с нажатием клавиши Page Up key ("Открыть страницу") на некоторых клавиатурах.

history-search-forward

Искать по списку истории в поисках последовательности символов между началом текущей строки и точкой. Строка поиска должна совпадать с началом строки истории. Это не инкрементальный поиск. На некоторых клавиатурах это может быть связано с нажатием клавиши Page Down ("Перелистывание страницы вниз").

history-substring-search-backward

Искать в списке истории назад в поисках последовательности символов между началом текущей строки и точкой. Строка поиска может совпадать с любым местом в строке истории. Это не инкрементальный поиск.

history-substring-search-forward

Выполнить поиск вперед по истории в поисках последовательности символов между началом текущей строки и точкой. Строка поиска может совпадать с любым местом в строке истории. Это не инкрементальный поиск.

yank-nth-arg (M-C-y)

Вставить первый аргумент предыдущей команды (обычно второе слово в предыдущей строке) в точку. С аргументом n вставьте n-е слово из предыдущей команды (слова в предыдущей команде начинаются со слова 0). Отрицательный аргумент вставляет n-е слово из конца предыдущей команды. Как только аргумент n вычислен, для извлечения n-го слова используются средства расширения истории, как если бы “!n” расширение истории было задано заранее.

yank-last-arg (M-., M-_)

Вставить последний аргумент в предыдущую команду (последнее слово предыдущей записи в истории). С числовым аргументом ведёт себя точно так же, как с yank-nth-arg. Последовательные вызовы yank-last-arg перемещают назад по списку истории, по очереди вставляя последнее слово (или слово, указанное аргументом для первого вызова) из каждой строки. Любой числовой аргумент, передаваемый этим последовательным вызовам, определяет направление перемещения по истории. Отрицательный аргумент переключает направление перемещения по истории (назад или вперед). При этом используются средства расширения истории для извлечения последнего слова, как если бы “!$” расширение истории было задано заранее.

shell-expand-line (M-C-e)

Расширение слов выполнялось в оболочке. При этом выполняется расширение псевдонима и истории, используются кавычки $'string' и $"string", расширение тильды, расширение параметров и переменных, арифметическое расширение, замена команд и процессов, разделение слов и удаление кавычек. Явный аргумент запрещает замену команд и процессов. Описание расширения истории смотрите в разделе РАСШИРЕНИЕ ИСТОРИИ ниже.

history-expand-line (M-^)

Выполнить расширение истории в текущей строке. Описание расширения истории смотрите в разделе РАСШИРЕНИЕ ИСТОРИИ ниже.

magic-space

Выполнить расширение истории в текущей строке и вставить пробел. Описание расширения истории смотрите в разделе РАСШИРЕНИЕ ИСТОРИИ ниже.

alias-expand-line

Выполнить расширение псевдонима в текущей строке. Описание расширения псевдонима приведено в разделе ПСЕВДОНИМЫ выше.

history-and-alias-expand-line

Выполнить расширение истории и псевдонима в текущей строке.

insert-last-argument (M-., M-_)

Синоним для yank-last-arg.

edit-and-execute-command (C-x C-e)

Вызвать редактор в текущей командной строке и выполнить результат в виде команд оболочки. Bash пытается вызвать $VISUAL, $EDITOR и emacs в качестве редактора в указанном порядке.

Команды изменения текста¶

end-of-file (usually C-d)

Символ, обозначающий конец файла, заданный, например, с помощью stty(1). Если этот символ считывается, когда в строке нет символов, а точка находится в начале строки, то readline интерпретирует его как конец ввода и возвращает EOF.

delete-char (C-d)

Удалить символ в точке. Если эта функция привязана к тому же символу, что и символ tty EOF, как это обычно бывает с C-d, то смотрите выше, чтобы узнать об эффектах. Это также может быть связано с клавишей Delete на некоторых клавиатурах.

backward-delete-char (Rubout)

Удалить символ, находящийся за курсором. Если задан числовой аргумент, то сохранить удаленный текст в кольце удаления.

forward-backward-delete-char

Удалить символ под курсором, если только курсор не находится в конце строки, в этом случае символ, расположенный за курсором, будет удален.

quoted-insert (C-q, C-v)

Добавить следующий введенный символ в строку буквально. Вот как, например, вставлять такие символы, как C-q.

tab-insert (C-v TAB)

Вставить символ табуляции.

self-insert (a, b, A, 1, !, ...)

Вставить введенный символ.

bracketed-paste-begin

Эта функция предназначена для привязки к “bracketed paste” escape-последовательности, отправляемой некоторыми терминалами и такая привязка назначается по умолчанию. Это позволяет readline вставлять текст как единое целое, не обрабатывая каждый символ так, как если бы он был прочитан с клавиатуры. Вставленные символы вставляются так, как если бы каждый из них был привязан к самостоятельной вставке self-insert вместо выполнения каких-либо команд редактирования.

Вставка в квадратных скобках устанавливает область в соответствии со вставленным текстом и активирует эту область.

transpose-chars (C-t)

Перетащить символ перед точкой вперед по символу в точке, также перемещая точку вперед. Если точка находится в конце строки, то это перемещает два символа перед точкой. Отрицательные аргументы не действуют.

transpose-words (M-t)

Перетащить слово перед точкой за слово после точки, перемещая точку также за это слово. Если точка находится в конце строки, то это перемещает последние два слова в строке.

shell-transpose-words (M-C-t)

Перетащить слово перед точкой за слово после точки, перемещая точку также и за это слово. Если точка вставки находится в конце строки, это перемещает последние два слова в строке. Границы слов такие же, как у shell-forward-word и shell-backward-word.

upcase-word (M-u)

Ввести текущее (или следующее) слово в верхнем регистре. Если аргумент отрицательный, то ввести предыдущее слово в верхнем регистре, но не перемещать точку.

downcase-word (M-l)

Ввести текущее (или следующее) слово в нижнем регистре. Если аргумент отрицательный, то ввести предыдущее слово в нижнем регистре, но не перемещать точку.

capitalize-word (M-c)

Указать текущее (или следующее) слово с заглавной буквы. При отрицательном аргументе указать предыдущее слово с заглавной буквы, но не перемещать точку.

overwrite-mode

Переключить режим перезаписи. При явном положительном числовом аргументе переключится в режим перезаписи. При явном отрицательном числовом аргументе переключится в режим вставки. Эта команда влияет только на режим emacs; В режиме vi перезапись выполняется по-другому. Каждый вызов readline() начинается в режиме вставки.

В режиме перезаписи символы, связанные с self-insert, заменяют текст в точке, а не сдвигают текст вправо. Символы, связанные с backward-delete-char, заменяют символ перед точкой на пробел. По умолчанию эта команда не привязана, но может быть привязана к клавише "Insert" на некоторых клавиатурах.

Уничтожение и выдёргивание¶

kill-line (C-k)

Уничтожить текст от точки до конца текущей строки. Используя числовой аргумент с отрицательным значением, уничтожить текст в обратном направлении от курсора к началу строки.

backward-kill-line (C-x Rubout)

Уничтожить в обратном порядке, с самого начала текущей строки. С отрицательным числовым аргументом уничтожить вперед от курсора к концу строки.

unix-line-discard (C-u)

Уничтожить в обратном порядке от точки к началу строки, сохраняя уничтоженный текст в кольце удаления.

kill-whole-line

Уничтожить все символы в текущей строке, независимо от того, где находится точка.

kill-word (M-d)

Удалить от точки до конца текущего слова или, если между словами, то до конца следующего слова. Границы слов совпадают с теми, которые используются в forward-word.

backward-kill-word (M-Rubout)

Удалить слово, стоящее за точкой. Границы слов совпадают с теми, которые используются в backward-word.

shell-kill-word (M-C-d)

Удалить от точки до конца текущего слова или, если между словами, то до конца следующего слова. Границы слов совпадают с теми, которые используются в shell-forward-word.

shell-backward-kill-word

Удалить слово, стоящее за точкой. Границы слов совпадают с теми, которые используются в shell-backward-word.

unix-word-rubout (C-w)

Уничтожить слово за точкой, используя пробел в качестве границы слова, сохранив уничтоженный текст в кольце удаления.

unix-filename-rubout

Удалить слово за точкой, используя пробел и символ косой черты в качестве границ слова, сохранив уничтоженный текст в кольце удаления.

delete-horizontal-space (M-\)

Удалить все пробелы и знаки табуляции вокруг точки.

kill-region

Удалить текст в текущей области.

copy-region-as-kill

Скопировать текст из этой области в буфер удаления, чтобы его можно было немедленно извлечь.

copy-backward-word

Скопировать слово перед точкой в буфер удаления. Границы слов совпадают с backward-word.

copy-forward-word

Скопировать слово, следующее за точкой, в буфер удаления. Границы слов такие же, как и в forward-word.

yank (C-y)

Извлечь верхнюю часть из кольца удалённых в буфере около точки.

yank-pop (M-y)

Повернуть кольцо удалённых и извлечь новый верх. Работает только после yank или yank-pop.

Числовые аргументы¶

digit-argument (M-0, M-1, ..., M--)

Добавить эту цифру к уже имеющемуся аргументу или определить новый аргумент. M - определяет отрицательный аргумент.

universal-argument

Это еще один способ указать аргумент. Если за командой universal-argument следует одна или несколько цифр, с необязательным начальным знаком минус, то эти цифры определяют аргумент. Если за командой universal-argument следуют цифры, то выполнение снова заканчивается числовым аргументом, иначе игнорируется. В качестве специального случая, если за этой командой сразу следует символ, который не является ни цифрой, ни знаком минус, то количество аргументов для следующей команды умножается на четыре. Изначально количество аргументов равно единице, поэтому при выполнении этой функции в первый раз количество аргументов увеличивается на четыре, во второй раз количество аргументов увеличивается до шестнадцати и так далее.

Завершение¶

complete (TAB)

Попытаться выполнить заполнение текста перед точкой. Bash пытается завершить, сначала проверяя наличие каких-либо программируемых завершений для командного слова (смотрите подраздел Программируемое завершение ниже), в противном случае обрабатывает текст как переменную (если текст начинается с $), название пользователя (если текст начинается с ~)., названия хоста (если текст начинается с @) или команды (включая псевдонимы, функции и встроенные команды) по очереди. Если ни один из них не приводит к совпадению, то выполняется возврат к завершению названия файла.

possible-completions (M-?)

Вывести список возможные дополнения к тексту перед точкой. При отображении завершений readline устанавливает количество столбцов, используемых для отображения, равным значению completion-display-width, значению переменной оболочки COLUMNS или ширине экрана, в указанном порядке.

insert-completions (M-*)

Вставить все дополнения к тексту перед точкой, которые были бы сгенерированы с помощью possible-completions, разделив их пробелом.

menu-complete

Аналогично complete, но заменяет слово, которое необходимо завершить, одним совпадением из списка возможных завершений. Повторное выполнение шагов menu-complete по списку возможных завершений, вставляя каждое совпадение по очереди. В конце списка завершений клавиша menu-complete нажимает клавишу звонка (в зависимости от настройки bell-style) и восстанавливает исходный текст. Аргумент n перемещает на n позиций в списке совпадений вперед; отрицательный аргумент перемещает их назад по списку. Эта команда предназначена для привязки к клавише TAB, но по умолчанию не привязана.

menu-complete-backward

Идентична menu-complete, но перемещает назад по списку возможных вариантов завершения, как если бы для menu-complete был задан отрицательный аргумент. По умолчанию эта команда не привязана.

export-completions

Выполнить заполнение слова перед точкой, как описано выше и записать список возможных завершений в выходной поток readline, используя следующий формат и записывая информацию в отдельных строках:

Если совпадений нет, то первая строка будет выглядеть следующим образом “0”, и эта команда не выводит никаких выходных данных после S:E. Если есть только одно совпадение, то выводится единственная строка, содержащая его. Если имеется более одного совпадения, то в первой строке после S выводится общий префикс совпадений, который может быть пустым :E, затем совпадения в последующих строках. В этом случае N будет содержать первую строку с общим префиксом.

Пользователь или приложение должны иметь возможность использовать пустую строку. Цель состоит в том, чтобы пользователь или приложение считывали N строк после строки, содержащей S:E, чтобы получить список совпадений. По умолчанию эта команда не привязана.

delete-char-or-list

Удалить символ под курсором, если он не находится в начале или конце строки (например, delete-char). В конце строки она ведет себя аналогично possible-completions. По умолчанию эта команда не привязана.

complete-filename (M-/)

Попробывать ввести название файла в текст перед точкой.

possible-filename-completions (C-x /)

Вывести возможные варианты завершения текста перед точкой, рассматривая его как название файла.

complete-username (M-~)

Попытаться закончить текст перед точкой, рассматривая его как название пользователя.

possible-username-completions (C-x ~)

Показать возможные варианты окончания текста перед точкой, рассматривая его как название пользователя.

complete-variable (M-$)

Попытаться завершить работу над текстом перед точкой, рассматривая его как переменную оболочки.

possible-variable-completions (C-x $)

Показать возможные варианты завершения текста перед точкой, рассматривая его как переменную оболочки.

complete-hostname (M-@)

Показать возможные варианты завершения текста перед точкой, рассматривая его как название хоста.

possible-hostname-completions (C-x @)

Показать возможные варианты завершения текста перед точкой, рассматривая его как название хоста.

complete-command (M-!)

Попытаться завершить текст перед точкой, рассматривая его как название команды. При завершении команды выполняется попытка сопоставления текста с псевдонимами, зарезервированными словами, функциями оболочки, встроенными элементами оболочки и, наконец, с названиями исполняемых файлов в указанном порядке.

possible-command-completions (C-x !)

Показать возможные варианты завершения текста перед точкой, рассматривая его как название команды.

dynamic-complete-history (M-TAB)

Попытаться завершить текст перед точкой, сравнив текст с записями в списке истории на предмет возможных совпадений по завершению.

dabbrev-expand

Попробовать завершить меню с текстом перед точкой, сравнив текст со строками из списка истории на предмет возможного совпадения завершений.

complete-into-braces (M-{)

Выполнить заполнение названия файла и вставить список возможных вариантов, заключенный в фигурные скобки, чтобы список был доступен командной строке (смотрите подраздел Расширение фигурных скобок выше).

Макросы клавиатуры¶

start-kbd-macro (C-x ()

Начать сохранять символы, введенные в текущий макрос клавиатуры.

end-kbd-macro (C-x ))

Прекратить сохранять символы, введенные в текущий макрос клавиатуры и сохранить определение.

call-last-kbd-macro (C-x e)

Повторно выполнить последний определенный макрос клавиатуры, сделав так, чтобы символы в макросе отображались так, как если бы они были набраны с клавиатуры.

print-last-kbd-macro ()

Вывести последний определенный макрос клавиатуры в формате, подходящем для файла inputrc.

Разное¶

re-read-init-file (C-x C-r)

Прочитать содержимое файла inputrc и включить в него все найденные там привязки или назначения переменных.

abort (C-g)

Прервать текущую команду редактирования и выдать сигнал звонка на терминал (в соответствии с настройкой bell-style).

do-lowercase-version (M-A, M-B, M-x, ...)

Если измененный символ x имеет верхний регистр, то выполнить команду, привязанную к соответствующему измененному символу нижнего регистра. Поведение не определено, если x уже имеет нижний регистр.

prefix-meta (ESC)

Преобразовать следующий введенный символ. ESC f, эквивалентно Meta-f.

undo (C-_, C-x C-u)

Пошаговая отмена, запомненного отдельно для каждой строки.

revert-line (M-r)

Отменить все изменения, внесенные в эту строку. Это похоже на выполнение команды undo необходимое количество раз, чтобы вернуть строку в исходное состояние.

tilde-expand (M-&)

Выполнить расширение тильдой текущего слова.

set-mark (C-@, M-<space>)

Установить метку в точку. Если указан числовой аргумент, то установить метку в это положение.

exchange-point-and-mark (C-x C-x)

Заменить точку на метку. Установить текущее положение курсора на сохраненное, затем установить метку на прежнее положение курсора.

character-search (C-])

Прочитать символ и переместите указатель на следующее его появление. Отрицательный аргумент выполняет поиск предыдущих появлений.

character-search-backward (M-C-])

Прочитать символ и переместить указатель на предыдущее его использование. Отрицательный аргумент выполняет поиск последующих появлений.

skip-csi-sequence

Прочитать достаточное количество символов, чтобы использовать последовательность из нескольких клавиш, например, определенную для таких клавиш, как Home и End. Последовательности CSI начинаются с индикатора контрольной последовательности (CSI), обычно ESC [. Если эта последовательность привязана к “\e[”, клавишам, создающим последовательности CSI, то не действуют, если они явно не привязаны к команде readline, вместо того чтобы вставлять случайные символы в буфер редактирования. По умолчанию это не привязано, но обычно привязывается к ESC [.

insert-comment (M-#)

Если без числового аргумента, то вставить значение переменной readline comment-begin в начало текущей строки. Если указан числовой аргумент, то эта команда действует как переключатель: если символы в начале строки не соответствуют значению comment-begin, то вставить значение; в противном случае удалить символы в comment-begin из начала строки. В любом случае строка принимается так, как если бы была введена новая строка. Значение по умолчанию для comment-begin приводит к тому, что эта команда преобразует текущую строку в комментарий оболочки. Если числовой аргумент приводит к удалению символа комментария, то строка будет выполнена оболочкой.

spell-correct-word (C-x s)

Выполнить исправление орфографии в текущем слове, указав его в качестве каталога или названия файла, таким же образом, как опции cdspell оболочки. Границы слов совпадают с границами, используемыми в опции shell-forward-word.

glob-complete-word (M-g)

Рассматривать слово перед точкой как шаблон для расширения названия пути с неявным добавлением звездочки, затем использовать этот шаблон для создания списка совпадающих названий файлов для возможных завершений.

glob-expand-word (C-x *)

Использовать слово перед точкой как шаблон для расширения названия пути и вставить список совпадающих названий файлов, заменив это слово. Если указан числовой аргумент, то добавить символ * перед расширением названия пути.

glob-list-expansions (C-x g)

Отобразить список расширений, которые были бы сгенерированы с помощью glob-expand-word и повторно отобразить строку. Если указан числовой аргумент, то добавить * перед расширением названия пути.

dump-functions

Вывести все функции и их привязки к клавишам в поток вывода readline. Если указан числовой аргумент, то выходные данные форматируются таким образом, чтобы их можно сделать частью файла inputrc.

dump-variables

Вывести все настраиваемые переменные readline и их значения в поток вывода readline. Если указан числовой аргумент, то выходные данные форматируются таким образом, чтобы их можно сделать частью файла inputrc.

dump-macros

Вывести все последовательности клавиш readline, привязанные к макросам и строки, в которые они выводят в выходной поток readline. Если указан числовой аргумент, то выходные данные форматируются таким образом, чтобы их можно сделать частью файла inputrc.

execute-named-command (M-x)

Прочитать название команды с возможностью привязки readline из входных данных и выполнить функцию, к которой она привязана, как если бы последовательность клавиш, к которой она была привязана, была указана во входных данных. Если эта функция снабжена числовым аргументом, то этот аргумент будет передан функции, которая выполняется.

display-shell-version (C-x C-v)

Вывести информацию о данной версии оболочки bash.

Завершение программ¶

Когда пользователь пытается выполнить ввод слова для команды или аргумента команды, для которой была определена спецификация завершения compspec с использованием встроенной команды complete (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже), то readline вызывает программируемые средства завершения.

Во-первых, bash определяет название команды. Если для этой команды была определена спецификация завершения, то спецификация завершения используется для создания списка возможных завершений для слова. Если командным словом является пустая строка (попытка завершения в начале пустой строки), то bash использует любую спецификацию завершения, определенную опцией -E для complete. Опция -I для complete указывает на то, что командное слово является первым в строке словом, не подлежащим присвоению или словом после разделителя команд, такого как ; или |. Обычно это указывает на завершение названия команды.

Если командным словом является полное название пути, то bash сначала выполняет поиск спецификации завершения для полного названия пути. Если для полного названия пути нет спецификации завершения, то bash пытается найти спецификацию завершения для части, следующей за последней косой чертой. Если эти поиски не приводят к получению спецификации завершения или если для командного слова нет спецификации завершения, то bash использует любую спецификацию завершения, определенную опцией -D для complete по умолчанию. Если спецификация завершения по умолчанию отсутствует, то bash выполняет расширение псевдонима для командного слова в качестве последнего средства и пытается найти спецификацию завершения для командного слова, полученного в результате любого успешного расширения.

Если спецификация завершения не найдена, то bash выполняет завершение по умолчанию, как описано выше в подразделе Завершение. В противном случае, как только спецификация завершения найдена, bash использует её для создания списка совпадающих слов.

Сначала bash выполняет действия actions, указанные в спецификации завершения. Это возвращает только совпадения, которые являются префиксами завершаемого слова. Когда для заполнения названия файла или каталога используется опция -f или -d, то bash использует переменную оболочки FIGNORE для фильтрации совпадений.

Далее, программируемое завершение генерирует совпадения, указанные с помощью шаблона расширения названия пути, предоставленного в качестве аргумента опции -G. Слова, сгенерированные с помощью шаблона, не обязательно должны совпадать с завершаемым словом. Bash использует переменную FIGNORE для фильтрации совпадений, но не использует переменную оболочки GLOBIGNORE.

Далее при завершении используется строка, указанная в качестве аргумента опции -W. Сначала строка разделяется с использованием символов в специальной переменной IFS в качестве разделителей. Это позволяет использовать кавычки оболочки внутри строки, чтобы обеспечить механизм для слов, содержащих метасимволы оболочки или символы в значении IFS. Затем каждое слово расширяется с помощью фигурных скобок, тильды, параметров и переменных, подстановки команд и арифметического расширения, как описано выше в разделе РАСШИРЕНИЯ. Результаты разбиваются по правилам, описанным выше в подразделе Разделение слов. Результаты расширения сопоставляются по префиксу с завершаемым словом, а совпадающие слова становятся возможными завершениями.

После того, как эти совпадения были сгенерированы, bash выполняет любую функцию оболочки или команду, указанную с помощью опций -F и -C. Когда вызывается команда или функция, тогда bash присваивает значения переменным COMP_LINE, COMP_POINT, COMP_KEY и COMP_TYPE, как описано выше в подразделе Переменные оболочки. Если вызывается функция, то bash также устанавливает переменные COMP_WORDS и COMP_CWORD. Когда вызывается функция или команда, тогда первый аргумент ($1) - это название команды, аргументы которой завершаются, второй аргумент ($2) - это завершаемое слово, а третий аргумент ($3) - это слово предшествующее завершаемому слову в текущей командной строке. Нет никакой фильтрации сгенерированных завершений по завершаемому слову; функция или команда имеют полную свободу в генерации совпадений и им не нужно соответствовать префиксу слова.

Сначала вызывается любая функция, указанная с помощью -F. Функция может использовать любые средства оболочки, включая описанные ниже встроенные команды compgen и compopt, для генерации совпадений. Она должна поместить возможные завершения в переменную массива COMPREPLY, по одному для каждого элемента массива.

Далее, любая команда, указанная с опцией -C, вызывается в среде, эквивалентной подстановке команд. В стандартном выводе должен быть список завершений, по одному на строку. При необходимости символ новой строки будет заменен обратной косой чертой. Они добавляются к набору возможных завершений.

После генерации всех возможных завершений, bash применяет любой фильтр, указанный с помощью опции -X, к заверениям в списке. Фильтр представляет собой шаблон, используемый для расширения названием пути; буква & в шаблоне заменяется текстом завершаемого слова. Букву & можно экранировать обратной косой чертой; обратная косая черта удаляется перед попыткой сопоставления. Любое завершение, соответствующее шаблону, удаляется из списка. Начальная буква ! отменяет соответствие шаблону; в этом случае bash удаляет любое завершение, которое не соответствует шаблону. Если включена опция оболочки nocasematch, то bash выполняет сопоставление без учета регистра буквенных символов.

Наконец, программируемое завершение добавляет любой префикс и суффикс, указанные с помощью опций -P и -S, соответственно, к каждому завершению и возвращает результат в readline в виде списка возможных завершений.

Если ранее примененные действия не привели к каким-либо совпадениям, а опция -o dirnames была указана в complete при определении спецификации завершения, то bash попытается заполнить название каталога.

Если опция -o plusdirs была указана в complete при определении спецификации завершения, то bash попытается заполнить название каталога и добавит любые совпадения к набору возможных завершений.

По умолчанию, если найдена спецификация завершения, то всё, что она генерирует, возвращается в коде завершения в качестве полного набора возможных завершений. Завершения bash по умолчанию и readline по умолчанию для завершения названия файла отключены. Если опция -o bashdefault была указана в complete при определении спецификации завершения и спецификация завершения не генерирует совпадений, то bash выполняет попытку завершения по умолчанию. Если при выполнении спецификации завершения и, при попытке, при выполнении bash завершений по умолчанию не будет получено совпадений, а опция -o default была указана в complete при определении спецификации завершения, то программируемое завершение выполняет завершение readline по умолчанию.

Опции, указанные в complete и compopt, могут управлять тем, как readline обрабатывает завершения. Например, опция -o fullquote указывает readline заключать совпадения в кавычки, как если бы они были названиями файлов. Смотрите описание complete ниже для получения более подробной информации.

Когда спецификация завершения указывает, что она хочет завершить название каталога, тогда программируемые функции завершения заставляют readline добавлять косую черту к завершенным названиям, которые являются символическими ссылками на каталоги, в зависимости от значения переменной mark-directories readline, независимо от установки переменной mark-symlinked-directories readline.

Существует некоторая поддержка динамического изменения завершений. Это наиболее полезно при использовании в сочетании с завершением по умолчанию, указанным с помощью complete -D. Функции оболочки, выполняемые как функции завершения, могут указывать, что завершение следует повторить, возвращая статус завершения, равный 124. Если функция оболочки возвращает значение 124 и изменяет спецификацию завершения, связанную с командой, для которой выполняется попытка завершения (указывается в качестве первого аргумента при выполнении функции), то программируемое завершение перезапускается с самого начала с попыткой найти новую спецификацию завершения для этой команды. Это может быть использовано для динамического создания набора завершений по мере попытки завершения, вместо того чтобы загружать их все сразу.

Например, предполагая, что существует библиотека спецификаций завершения, каждая из которых хранится в файле, соответствующем названию команды, следующая функция завершения по умолчанию будет загружать завершения динамически:

_completion_loader()
{


  . "/etc/bash_completion.d/$1.sh".if  0<80n \


>/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader.if  0<80n \


-o bashdefault -o default

Указатели событий¶

Указатель события - это ссылка на запись в списке истории. Указатель события состоит из части слова, начинающейся с символа расширения истории и заканчивающейся указателем слова, если оно присутствует, или окончанием слова. Если ссылка не является абсолютной, то события отображаются относительно текущего положения в списке истории.

!

Запустить подстановку в истории, за исключением случаев, когда за ней следуют пробел blank, новая строка, возврат каретки, = или, когда опция оболочки extglob включена с помощью встроенной команды shopt, (.

!n

Обратиться к записи списка истории n.

!-n

Обратиться к текущей записи за вычетом n.

!!

Обратиться к предыдущей записи. Это синоним слова “!-1”.

!string

Обратится к самой последней команде, предшествующей текущей позиции в списке истории, начинающейся со строки string.

!?string[?]

Обратиться к самой последней команде, предшествующей текущей позиции в списке истории, содержащей строку string. Конечная буква ? может быть опущена, если за string сразу следует новая строка. Если string отсутствует, то используется строка из самого последнего поиска; если предыдущей строки поиска нет, то это ошибка.

^string1^string2^

Быстрая замена. Повторить предыдущую команду, заменив строку string1 на строку string2. Эквивалентно “!!:s^string1^string2^” (смотрите подраздел Модификаторы ниже).

!#

На данный момент введена вся командная строка целиком.

Указатели слова¶

Указатели слов используются для выбора нужных слов из события. Они необязательны; если указатель слова не указан, то в расширении истории используется всё событие целиком. Символ : отделяет спецификацию события от обозначения слова. Он может быть опущен, если укзатель слова начинается с ^, $, *, - или %. Слова нумеруются с начала строки, причем первое слово обозначается 0 (ноль). Слова вставляются в текущую строку через одинарные пробелы.

0 (zero)

Нулевое слово. Для оболочки это командное слово.

n

Слово n.

^

Первый аргумент: слово word 1.

$

Последнее слово. Обычно это последний аргумент, но он расширяется до нулевого слова, если в строке есть только одно слово.

%

Первое слово, совпадающее с самым последним “?string?” выполнять поиск, если строка поиска начинается с символа, который является частью слова. По умолчанию поиск начинается с конца каждой строки и продолжается до начала, поэтому первое найденное слово находится ближе всего к концу строки.

x-y

Диапазон слов; “-y” сократить “0-y”.

*

Все слова, кроме нулевого. Это синоним слова “1-$”. Использовать *, если в событии есть только одно слово, то это не является ошибкой; в этом случае оно расширяется до пустой строки.

x*

Сокращение x-$.

x-

Сокращает x-$ как x*, но опускает последнее слово. Если x отсутствует, то по умолчанию оно равно 0.

Если обозначение слова указано без указания события, то в качестве события используется предыдущая команда, эквивалентно !!.

Модификаторы¶

После необязательного указателя слова, расширение может включать последовательность из одного или нескольких следующих модификаторов, каждому из которых предшествует “:”. Они изменяют или редактируют слово или фразы, выбранные из истории событий.

h

Удалить завершающий компонент названия пути, оставив только заголовок.

t

Удалить все начальные компоненты названия пути, оставив только концевые.

r

Удалить завершающий суффикс формы .xxx, оставив основное название.

e

Удалить все, кроме завершающего суффикса.

p

Вывести новую команду, но не выполнять ее.

q

Закавычивать замененные слова, но избегать дальнейших замен.

x

Замененные слова заключить в кавычки, как в q, но разбить на слова в пробелах blanksи в новой строке. Модификаторы q и x являются взаимоисключающими; при расширении используется последний из них.

s/old/new/

Заменить старое old на новое new вместо первого символа в строке событий. В качестве разделителя вместо / может использоваться любой символ. Последний разделитель необязателен, если он является последним символом в строке событий. Разделители в old и new заключены в одиночную обратную косую черту. Если в new появляется символ &, то он заменяется на old. Одиночная обратная косая черта заключает & в кавычки. Если значение old равно нолю, то оно устанавливается равным последней замене old или, если предыдущие замены в истории не выполнялись, то последней замене string в поиске !?string[?]. Если значение new равно нолю, то все совпадающие значения old удаляются.

&

Повторить предыдущую замену.

g

Вызывает применение изменений ко всей строке событий. Используется в сочетании с “:s” (например, “:gs/old/new/”) или “:&”. При использовании с “:s”, вместо / можно использовать любой разделитель, а последний разделитель необязателен, если он является последним символом строки события. Символ a может использоваться как синоним символа g.

G

Применить следующие “s” или “&” изменить один раз каждое слово в строке событий.