Выпуск 77

man bash(1), часть семнадцатая

Уважаемые подписчики! Этот выпуск - семнадцатый в серии, посвященной командному интерпретатору bash. Перевод закончен сегодня, 19 июля.

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

bash(1)

readonly [-apf] [имя ...]

Указанные имена помечаются как доступные только для чтения; значения соответствующих переменных нельзя изменять в дальнейшем с помощью присваивания. Если указана опция -f, функции, соответствующие именам, тоже помечаются. Опция -a ограничивает действие только массивами. Если ни одно имя не указано или задана опция -p, выдается список имен, доступных только для чтения. Опция -p вызывает выдачу результатов в формате, который можно использовать как входной. Статус выхода - 0, если только не передана недопустимая опция, одно из имен не является именем переменной или опция -f не указана перед именем, не являющимся именем функции.

return [n]

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

set [--abefhkmnptuvxBCHP] [-o опция] [аргумент ...]

При вызове без опций выдает имя и значение всех переменных командного интерпретатора в виде, пригодном для повторного выполнения присваиваний. Результат отсортирован по именам в соответствии с текущей локалью. Если опции указаны, они устанавливают или сбрасывают атрибуты командного интерпретатора. Все оставшиеся после обработки опций аргументы присваиваются последовательно в качестве значений позиционным параметрам $1, $2,... $n. Опции имеют следующие значения:

-a	Автоматически помечать изменяемые или создаваемые переменные как экспортируемые в среду для последующих команд.
-b	Сообщать о состоянии прерванных фоновых заданий немедленно, а не перед выдачей следующего первичного приглашения. Эта опция действует только если включено управление заданиями.
-e	Немедленно завершать работу, если простая команда (см. раздел "СИНТАКСИС КОМАНД" ранее) завершает работу с ненулевым статусом выхода. Работа командного интерпретатора не завершается, если закончившаяся неудачно команда является частью цикла until или while, частью оператора if, частью списка && или ||, или если к статусу выхода команды применяется отрицание с помощью оператора !.
-f	Отключить подстановку имен файлов.
-h	Запоминать местонахождение команд, найденное при выполнении. Эта опция включена по умолчанию.
-k	Помещать в среду все аргументы в виде операторов присваивания, а не только предшествующие имени команды.
-m	Режим мониторинга. Управление заданиями включено. Эта опция стандартно устанавливается для интерактивных командных интерпретаторов в системах, где управление заданиями поддерживается (см. раздел "УПРАВЛЕНИЕ ЗАДАНИЯМИ" ранее). Фоновые процессы работают в отдельной группе процессов, и строка, содержащая их статус выхода, выдается при завершении их работы.
-n	Читать команды, но не выполнять их. Эту опцию можно использовать для проверки наличия синтаксических ошибок в сценариях командного интерпретатора. Интерактивные командные интерпретаторы ее игнорируют.
-o имя_опции	Имя_опции может иметь одно из следующих значений: allexport То же, что и опция -a braceexpand То же, что и опция -B emacs Использовать интерфейс редактирования командной строки в стиле редактора emacs. Эта опция установлена по умолчанию в интерактивных командных интерпретаторах, если только они не запущены с опцией --noediting errexit То же, что и опция -e hashall То же, что и опция -h histexpand То же, что и опция -H history Включить поддержку истории выполнения команд, как описано ранее в разделе "ИСТОРИЯ ВЫПОЛНЕНИЯ КОМАНД". Эта опция установлена по умолчанию для интерактивных командных интерпретаторов./td> ignoreeof Результат такой же, как и после выполнения команды IGNOREEOF=10 (см. раздел "Переменные командного интерпретатора" ранее) keyword То же, что и опция -k monitor То же, что и опция -m noclobber То же, что и опция -C noexec То же, что и опция -n noglob То же, что и опция -f notify То же, что и опция -b nounset То же, что и опция -u onecmd То же, что и опция -t physical То же, что и опция -P posix Изменяет поведение bash на соответствующее стандарту POSIX 1003.2, там, где оно отличается privileged То же, что и опция -p verbose То же, что и опция -v vi Использовать интерфейс редактирования командной строки в стиле редактора vi./td> xtrace То же, что и опция -x. Если указана опция -o без имени_опции, выдаются значения текущих установленных опций. Если указана опция +o без имени_опции, в стандартный выходной поток выдается набор команд set, необходимый для воссоздания текущего набора опций.
-p	Включить привилегированный режим. В этом режиме файлы $ENV и $BASH_ENV не обрабатываются, функции командного интерпертатора не наследуются из среды, а переменная среды SHELLOPTS игнорируется. Если командный интерпретатор запущен с эффективным идентификатором пользователя (группы), не совпадающим с реальным, а опция -p не задана, выполняются перечилсенные действия и эффективный идентификатор устанавливается равным реальному. Если опция -p задана при запуске, эффективный идентификатор не сбрасывается. Отключение данной опции приводит к установке эффективных идентификаторов пользователя и группы равными реальным.
-t	Завершить после чтения и выполнения одной команды.
-u	При подстановке значений параметров рассматривать не установленную переменную как ошибку. При попытке подстановки значения не существующей переменной командный интерпретатор выдает сообщение об ошибке и, если он - не интерактивный, завершает работу с ненулевым статусом выхода.
-v	Выдавать строки команд по мере чтения.
-x	После подстановок в каждой простой команде выдавать значение переменной PS4, а затем - команду с результатами подстановок в аргументах.
-B	Выполнять подстановку квадратных скобок в командном интерпретаторе (см. раздел "Подстановка выражений в скобках" ранее). Эта опция установлена по умолчанию.
-C	Если эта опция установлена, bash не переписывает существующий файл при перенаправлениях с помощью операторов >, >& и <>. Это поведение можно переопределить при создании выходных файлов, применяя оператор перенаправления |> вместо >.
-H	Включить подстановку из списка истории с помощью метасимвола !. Эта опция по умолчанию установлена в интерактивных командных интерпретаторах.
-P	Если эта опция установлена, командный интерпретатор не следует по символьным связям при выполнении команд типа cd, изменяющих текущий рабочий каталог. Вместо этого, он использует физическую структуру каталогов. По умолчанию, bash следует по логической цепочке каталогов при выполнении команд, изменяющих текущий каталог.
--	Если после этой опции нет аргументов, сбрасываются значения позиционных параметров. В противном случае, позиционные параметры устанавливаются в соответствии с аргументами, даже если некоторые из них начинаются с дефиса (-).
-	Сигнализирует об окончании опций, так что все оставшиеся аргументы присваиваются позиционным параметрам. Опции -x и -v при этом отключаются. Если больше аргументов нет, позиционные параметры остаются без изменений.

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

shift [n]

Позиционные параметры n+1 ... переименовываются в $1 .... Параметры от $#-n+1 до $# сбрасываются. n должно быть неотрицательным целым числом, не превышающим $#. Если n равно 0, параметры не изменяются. Если n не указано, предполагается значение 1. Если n больше $#, поизиционные параметры не изменяются. Статус выхода - больше нуля, если n больше $# или отрицательное и 0 в противном случае.

shopt [-pqsu] [-o] [имя_опции ...]

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

-s	Включает (устанавливает) все указанные опции.
-u	Отключает (сбрасывает) все указанные опции.
-q	Подавляет выдачу стандартной информации (немногословный режим); статус выхода показывает, установлена опция или нет. Если после -q указано несколько имен_опций, статус выхода - 0, если все указанные опции включены и не 0 в противном случае.
-o	Ограничивает значения имен_опций только поддерживаемыми в опции -o встроенной команды set.

Если опция -s или -u использована без аргументов, выдается информация только об установленных или неустановленных опциях, соответственно. Если не указано иначе, опции команды shopt по умолчанию отключены (сброшены).

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

Вот список допустимых опций команды shopt:

cdable_vars

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

cdspell

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

checkhash

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

checkwinsize

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

cmdhist

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

dotglob

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

execfail

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

expand_aliases

Если эта опция установлена, псевдонимы заменяются так, как было описано ранее в разделе "ПСЕВДОНИМЫ". Эта опция включена по умолчанию в интерактивных командных интерпретаторах.

extglob

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

histappend

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

histreedit

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

histverify

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

hostcomplete

Если эта опция установлена и используется библиотека readline, bash будет пытаться выполнить подстановку имен хостов после завершения слова, содержащего символ @, (см. подраздел "Завершение" в разделе "БИБЛИОТЕКА READLINE" ранее). Эта опция включена по умолчанию.

huponexit

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

interactive_comments

Если эта опция установлена, слово, начинающееся символом #, и все остальные символы в этой строке игнорируются интерактивным команжным интерпретатором (см. раздел "КОММЕНТАРИИ" ранее). Эта опция включена по умолчанию.

lithist

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

mailwarn

Если эта опция установлена и файл, проверяемый командным интерпретатором bash как почтовый ящик, читался с момента последней проверки, выдается сообщение "The mail in имя_файла has been read".

nocaseglob

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

nullglob

Если эта опция установлена, bash подставляет пустую строку вместо шаблонов, которым не соответствует ни один файлa (см. раздел "Подстановка имен файлов" ранее), а не сам шаблон.

promptvars

Если эта опция установлена, в строках приглашения выполняется подстановка значений переменных и параметров после стандартных подстановок, описанных в разделе "ПРИГЛАШЕНИЯ" ранее. Эта опция установлена по умолчанию.

restricted_shell

Командный интерпретатор устанавливает эту опцию, если он запущен в ограниченном режиме (см. раздел "ОГРАНИЧЕННЫЙ КОМАНДНЫЙ ИНТЕРПРЕТАТОР" ниже). Значение этой опции изменять нельзя. Она не сбрасывается при выполнении файлов начального запуска, что позволяет в этих файлах учесть, является ли командный интерпретатор ограниченным.

shift_verbose

Если эта опция установлена, встроенная команда shift выдает сообщение об ошибке, когда параметр сдвига превышает количество позиционных параметров.

sourcepath

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

В следующем выпуске

Очередной выпуск будет посвящен последнему фрагменту справочного руководства bash(1). Выйдет он, вероятно, 22 июля.

С наилучшими пожеланиями,

  В.К.