Simple Commands¶

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

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

Pipelines¶

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

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

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

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

Когда оболочка находится в режиме posix mode, тогда за 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 не обрабатываются специальным образом и удаляются.

[[ expression ]]

Возвращает статус 0 или 1 в зависимости от вычисления условного выражения expression. Выражения состоят из основных элементов, описанных ниже в разделе УСЛОВНЫЕ ВЫРАЖЕНИЯ. Слова между [[ и ]] не подвергаются разделению на слова и расширению названия пути. Оболочка выполняет расширение тильды, расширение параметров, переменных, арифметическое расширение, замену команд, замену процессов и удаление кавычек для этих слов (расширения, которые были бы сделаны, если бы слова были заключены в двойные кавычки). Условные операторы типа -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, список пуст, то команды не выполняются, а статус возврата равен 0.

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

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

select name [ in word ] ; do list ; done

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

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

Команда case сначала разворачивает слово word и пытается сопоставить его с каждым шаблоном pattern по очереди, используя правила сопоставления, описанные в разделе Сопоставление с шаблоном ниже. Поле word расширяется с помощью тильды, параметров и переменных, арифметического расширения, подстановки команд, подстановки процессов и удаления кавычек. Каждый шаблон pattern расширяется с помощью тильды, параметров и переменных, арифметического расширения, подстановки команд, подстановки процессов и удаления кавычек. Если включена опция оболочки nocasematch, то сопоставление выполняется без учета регистра буквенных символов. При обнаружении совпадения выполняется соответствующая операция list. Если используется оператор ;;, то после первого совпадения с шаблоном последующие попытки сопоставления не предпринимаются. Использование ;& вместо ;; приводит к продолжению выполнения с 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]. Этот конвейер устанавливается перед любыми перенаправлениями, указанными командой (смотрите раздел ПЕРЕНАПРАВЛЕНИЕ ниже). Файловые дескрипторы могут использоваться в качестве аргументов для команд оболочки и перенаправлений с использованием стандартных расширений слов. Файловые дескрипторы, кроме тех, которые созданы для выполнения команд и обработки подстановок, недоступны в подоболочках.

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

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

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

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

fname () compound-command [redirection]

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

Это определяет функцию с названием fname. Зарезервированное слово function необязательно. Если указано зарезервированное слово function, то скобки необязательны. Функция body - это составная команда (смотрите подраздел Составные команды выше). Эта команда обычно представляет собой список команд list между { and }, но может быть любой командой, указанной в подразделе "Составные команды" выше. Если используется зарезервированное слово function, но скобки не указаны, то рекомендуется использовать фигурные скобки. Составная команда выполняется всякий раз, когда указано fname в качестве названия простой команды. В режиме posix mode, fname должно быть допустимым названием оболочки name и может не совпадать с названием одной из команд POSIX special builtins. В режиме по умолчанию названием функции может быть любое командное слово без кавычек, не содержащее $. Любые перенаправления (смотрите раздел ПЕРЕНАПРАВЛЕНИЕ ниже), указанные при определении функции, выполняются при ее выполнении. Статус завершения указанной функции равен нулю, если только не возникает синтаксическая ошибка или функция с таким же названием и доступная только для чтения, уже не существует. При выполнении статус завершения функции равен статусу завершения последней команды, выполненной в теле функции. Смотрите раздел ФУНКЦИИ ниже.

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

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

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

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

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

*

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

@

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

#

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

?

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

-

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

$

Расширяется до идентификатора процесса оболочки. В подоболочке этот параметр расширяется до идентификатора процесса текущей оболочки, а не подоболочки.

!

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

0

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

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

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

_

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

BASH

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

BASHOPTS

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

BASHPID

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

BASH_ALIASES

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

BASH_ARGC

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

BASH_ARGV

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

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_LOADABLES_PATH

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

BASH_REMATCH

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

BASH_SOURCE

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

BASH_SUBSHELL

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

BASH_VERSINFO

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

BASH_VERSION

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

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 игнорируются. Если значение If HISTCMD не задано, то она теряет свои специальные свойства, даже если впоследствии она будет сброшена.

HOSTNAME

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

HOSTTYPE

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

LINENO

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

MACHTYPE

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

MAPFILE

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

OLDPWD

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

OPTARG

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

OPTIND

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

OSTYPE

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

SHLVL

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

SRANDOM

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

UID

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

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

BASH_COMPAT

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

BASH_ENV

Если этот параметр задан, когда bash выполняет скрипт оболочки, то его значение интерпретируется как название файла, содержащего команды для инициализации оболочки, как в ~/.bashrc. Значение 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 mode.

EXECIGNORE

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

FCEDIT

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

FIGNORE

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

FUNCNEST

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

GLOBIGNORE

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

HISTCONTROL

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

HISTFILE

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

HISTFILESIZE

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

HISTIGNORE

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

HISTSIZE

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

HISTTIMEFORMAT

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

HOME

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

HOSTFILE

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

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

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

OPTERR

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

PATH

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

POSIXLY_CORRECT

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

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 десятичная точка или дробная часть не выводятся. Можно указать не более трех знаков после запятой; значения p, превышающие 3, изменяются на 3. Если p не указано, используется значение 3.

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

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

TMOUT

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

TMPDIR

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

auto_resume

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

histchars

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

Массивы¶

Bash предоставляет одномерные индексированные и ассоциативные массивы переменных. В качестве индексированного массива может использоваться любая переменная. Встроенная команда declare явно объявляет массив. Максимальный размер массива не ограничен, равно как и не требуется, чтобы элементы индексировались или присваивались последовательно. Ссылки на индексированные массивы используются с использованием целых чисел (включая арифметические выражения) и основаны на нуле; ссылки на ассоциативные массивы используются с использованием произвольных строк. Если не указано иное, то индексы в индексированных массивах должны быть целыми неотрицательными числами.

Индексированный массив создается автоматически, если какой-либо переменной присваивается значение с использованием синтаксиса name[subscript]=value. Значение subscript обрабатывается как арифметическое выражение, которое должно быть преобразовано в число. Чтобы явно объявить индексированный массив, используйте declare -a name (смотрите раздел ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ ниже). Также допустимо declare -a name[subscript] ; subscript игнорируется.

Ассоциативные массивы создаются с помощью команды declare -A name.

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

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

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

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

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

На любой элемент массива можно ссылаться с помощью ${name[subscript]}. Фигурные скобки необходимы для того, чтобы избежать конфликтов при расширении названия пути. Если subscript равен @ или *, то слово расширяется до всех элементов name. Эти нижние индексы (subscript) различаются только в том случае, если слово заключено в двойные кавычки. Если слово заключено в двойные кавычки, то ${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], где subscript - это * или @, ведет себя по-разному в зависимости от того, является ли name индексированным или ассоциативным массивом. Если name является ассоциативным массивом, то элемент с индексом * или @ удаляется. Если name является индексированным массивом, то команда unset удаляет все элементы, но не удаляет сам массив.

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

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

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

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

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

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

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

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

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

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

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

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

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

Если название для входа неверное или тильда не используется, то слово остается неизмененным.

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

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

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

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

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

${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:offset}

${parameter:offset:length}

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

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

Если параметр parameter равен @ или *, то результатом будет длина length позиционных параметров, начинающихся с offset. Отрицательное значении offset берется относительно значения, на единицу превышающего наибольший позиционный параметр, поэтому значение смещения, равное -1, вычисляется как значение последнего позиционного параметра. Если значение 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 соответствующее самому короткому шаблону (в случае “%”) или соответствующее самому длинному шаблону (в случае “%%” case). Если 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 равно нулю, то совпадения с parameter удаляются. Если string имеет значение ноль, то совпадения с parameter удаляются, а /, следующее за parameter, может быть опущено.

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

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

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

${parameter^pattern}

${parameter^^pattern}

${parameter,pattern}

${parameter,,pattern}

Изменение регистра Case modification. Это расширение изменяет регистр буквенных символов в параметре parameter. Шаблон pattern расширяется для создания шаблона, как и при расширении названия пути. Каждый символ в расширенном значении параметра parameter проверяется на соответствие pattern и, если он соответствует шаблону, то преобразуется его регистр. Шаблон не должен пытаться соответствовать более чем одному символу. Оператор ^ преобразует строчные буквы, соответствующие pattern, в прописные; оператор , преобразует соответствующие прописные буквы в строчные. Расширения ^^ и ,, преобразуют каждый совпадающий символ в расширенное значение; расширения ^ и , сопоставляют и преобразуют только первый символ в расширенном значении. Если pattern опущен, то он обрабатывается как ?, который соответствует каждому символу. Если parameter равен @ или *, то операция изменения регистра применяется к каждому позиционному параметру по очереди и в результате получается расширенный список. Если parameter является переменной массива с индексом @ или *, то операция изменения регистра применяется к каждому элементу массива по очереди, а расширение - это результирующий список.

${parameter@operator}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После разделения слов, если не определена опция -f, то bash проверяет каждое слово на наличие символов *, ? и [. Если один из этих символов появляется и не заключен в кавычки, то слово рассматривается как шаблон pattern и заменяется отсортированным по алфавиту списком названий файлов, соответствующих шаблону (смотрите подраздел Сопоставление с шаблоном выше). Если совпадающие названия файлов не найдены, а опция оболочки nullglob не определена, то слово остается без изменений. Если задана опция nullglob и совпадений не найдено, то слово удаляется. Если задана опция оболочки failglob и совпадений не найдено, то выводится сообщение об ошибке и команда не выполняется. Если включена опция оболочки nocaseglob, то сопоставление выполняется без учета регистра буквенных символов. Примечание. При использовании выражений диапазона, таких как [a-z] (смотрите ниже), могут использоваться другие буквы, в зависимости от установки переменной LC_COLLATE. Когда для расширения названия пути используется шаблон, то для символа `." в начале названия или непосредственно после косой черты должно быть указано явное соответствие, если только не задана опция оболочки dotglob. Чтобы названия файлов соответствовали `." и `..", шаблон должен начинаться с `." (например, `.?"), даже если задано значение dotglob. Если определена опция оболочки globskipdots, то названия файлов `." и `.." никогда не совпадают, даже если шаблон начинается с `.". Если названия путей не совпадают, то символ `." не обрабатывается специальным образом. При сопоставлении названия пути символ косой черты всегда должен быть явно сопоставлен с косой чертой в шаблоне, но в других контекстах сопоставления он может быть сопоставлен со специальным символом шаблона, как описано выше в подразделе Сопоставление с шаблоном. Смотрите описание shopt выше в разделе ВСТРОЕННЫЕ КОМАНДЫ ОБОЛОЧКИ в описании опций оболочки nocaseglob, nullglob, globskipdots, failglob и dotglob.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[n]<<[-]word


        here-document
delimiter

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

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

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

Вариант документов "Здесь строки" (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 (на клавиатурах без клавиши meta M-x означает ESC x, то есть нажмите клавишу Escape, а затем клавишу x). Таким образом, ESC становится префиксом meta. Комбинация M-C-x означает ESC-Control-x или нажмите клавишу Escape, затем удерживайте клавишу Control, одновременно нажимая клавишу x.)

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

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

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

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

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

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

Распознаются следующие названия: RUBOUT, DEL, ESC, LFD, NEWLINE, RET, RETURN, SPC, SPACE и TAB.

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

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

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

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

В приведенном выше примере 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, а ESC [ 1 1 ~ привязана к вставке текста ``Function Key 1''.

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

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

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

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

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

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

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

active-region-start-color

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

active-region-end-color

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

bell-style (audible)

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

bind-tty-special-chars (On)

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

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 и включено completion-ignore-case, то readline рассматривает дефисы (-) и подчеркивания (_) как эквивалентные при сопоставлении названий файлов и завершений без учета регистра.

completion-prefix-display-length (0)

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

completion-query-items (100)

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

convert-meta (On)

Если установлено значение On, readline преобразует символы с установленным восьмым битом в последовательность клавиш ASCII, удаляя восьмой бит и добавляя в качестве префикса символ escape (по сути, используя escape в качестве meta prefix). Значение по умолчанию - 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)

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

enable-bracketed-paste (On)

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

enable-keypad (Off)

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

enable-meta-key (On)

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

expand-tilde (Off)

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

history-preserve-point (Off)

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

history-size (unset)

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

horizontal-scroll-mode (Off)

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

input-meta (Off)

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

isearch-terminators (“C-[C-J”)

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

keymap (emacs)

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

keyseq-timeout (500)

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

mark-directories (On)

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

mark-modified-lines (Off)

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

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, для одновременного отображения экрана, полного возможных завершений.

print-completions-horizontally (Off)

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

revert-all-at-newline (Off)

Если установлено значение On, то readline отменит все изменения в строках истории, прежде чем вернуться при выполнении accept-line. По умолчанию строки истории могут быть изменены и сохранять отдельные списки отмены при вызовах 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 реализует средство, аналогичное по смыслу функциям условной компиляции препроцессора Си, которое позволяет выполнять привязку клавиш и настройки переменных в результате тестов. Используются четыре директивы синтаксического анализа.

$if

The $if construct allows bindings to be made based on the editing mode, the terminal being used, or the application using readline. The text of the test, after any comparison operator,
extends to the end of the line; unless otherwise noted, no characters are required to isolate it.

$if Bash
# Quote the current or previous word
"\C-xq": "\eb\"\ef\""
$endif

$endif

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

$else

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

$include

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

$include  /etc/inputrc

Поиск¶

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

Инкрементальный поиск начинается до того, как пользователь закончит вводить строку поиска. По мере ввода каждого символа в строке поиска readline отображает следующую запись из истории, соответствующую введенной строке. Для добавочного поиска требуется ровно столько символов, сколько необходимо для поиска нужной записи в истории. Символы, присутствующие в значении переменной isearch-terminators, используются для завершения инкрементального поиска. Если этой переменной не было присвоено значение, то символы Escape и Control-J завершат инкрементальный поиск. Функция Control-G прервет инкрементальный поиск и восстановит исходную строку. Когда поиск завершается, запись журнала, содержащая строку поиска, становится текущей строкой.

Чтобы найти другие совпадающие записи в списке истории, введите Control-S или Control-R, соответственно. Это приведет к поиску в истории следующей записи, соответствующей введенной строке поиска. Любая другая последовательность клавиш, связанная с командой readline, завершит поиск и выполнит эту команду. Например, команда newline завершит поиск и примет строку, тем самым выполнив команду из списка истории.

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

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

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

Ниже приведен список названий команд и последовательности клавиш по умолчанию, к которым они привязаны. Названия команд без соответствующей последовательности клавиш по умолчанию не привязаны. В следующих описаниях точка point обозначает текущее положение курсора, а метка mark - положение курсора, сохраненное командой set-mark. Текст между точкой и меткой называется областью region.

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

beginning-of-line (C-a)

Перейти к началу текущей строки.

end-of-line (C-e)

Перейти к окончанию строки.

forward-char (C-f)

Перемещаться вперед по символам.

backward-char (C-b)

Переместить символ назад.

forward-word (M-f)

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

backward-word (M-b)

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

shell-forward-word

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

shell-backward-word

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

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. Если строка является измененной строкой истории, то восстановить ее в исходном состоянии.

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)

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

forward-search-history (C-s)

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

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

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

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

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

history-search-forward

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

history-search-backward

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

history-substring-search-backward

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

history-substring-search-forward

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

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

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

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

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

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

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

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''. Если этот символ считывается, когда в строке нет символов, а точка находится в начале строки, то readline интерпретирует его как конец ввода и возвращает EOF.

delete-char (C-d)

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

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, !, ...)

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

transpose-chars (C-t)

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

transpose-words (M-t)

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

upcase-word (M-u)

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

downcase-word (M-l)

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

capitalize-word (M-c)

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

overwrite-mode

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

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

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

Удалить от точки до конца текущего слова или, если между словами, то до конца следующего слова. Границы слов совпадают с теми, которые используются в 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-?)

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

insert-completions (M-*)

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

menu-complete

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

menu-complete-backward

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

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), обычно ESC-[. Если эта последовательность привязана к "\[", то клавиши, создающие такие последовательности, не будут иметь эффекта, если они явно не привязаны к команде 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, привязанные к макросам, а также строки, которые они выводят. Если указан числовой аргумент, то выходные данные форматируются таким образом, что их можно сделать частью файла inputrc.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

_completion_loader()
{
. "/etc/bash_completion.d/$1.sh" >/dev/null 2>&1 && return 124
}
complete -D -F _completion_loader -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.

^

Это первый аргумент. То есть слово 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/

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

&

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

g

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

G

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