fish — дружественная интерактивная оболочка

Краткое описание

fish [OPTIONS] [FILE [ARG ...]]
fish [OPTIONS] [-c COMMAND [ARG ...]]

Описание

fish — это оболочка командной строки, разработанная в основном с учётом интерактивного использования. Эта страница кратко описывает параметры вызова fish. Полное руководство доступно в формате HTML с помощью команды help внутри fish и в fish-doc(1) man-странице. Руководство пользователя доступно в формате HTML по help tutorial или в man fish-tutorial.

Доступны следующие параметры:

-c или --command=КОМАНДА

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

-C или --init-command=КОМАНДЫ

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

-d или --debug=КАТЕГОРИИ_ОТЛАДКИ

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

-o или --debug-output=Файл_вывода_отладки

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

-i или --interactive

Оболочка интерактивная.

-l или --login

Действует так, как если бы была вызвана как оболочка входа.

-N или --no-config

Не читать файлы конфигурации.

-n или --no-execute

Не выполнять никакие команды, а только проверять синтаксис.

-p или --profile=Файл_профиля

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

--profile-startup=Файл_профиля

Запишет время запуска fish в указанный файл.

-P или --private

Включает режим конфиденциальности: fish не будет получать доступ к старой истории и не будет сохранять новую.

--print-rusage-self

По завершении работы fish выводит статистику из getrusage.

--print-debug-categories

Выводит все категории отладки и затем завершает работу.

-v или --version

Выводит версию и завершает работу.

-f или --features=ФЛАГИ

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

Кодовый fish возврата оболочки, как правило, — это код возврата последней фоновой команды.

Отладка

Хотя fish предоставляет обширную поддержку отладки скриптов fish, также можно отладить и отследить его внутренние механизмы. Отладку можно включить, передав параметр --debug. Например, следующая команда включает отладку событий потоков ввода-вывода фоновых задач, в дополнение к стандартным категориям: debug, error, warning и warning-path:

> fish --debug=iothread

Доступные категории перечислены по команде fish --print-debug-categories. Параметр --debug принимает список категорий, разделённых запятыми, и поддерживает синтаксис подстановок. Следующая команда включает отладку для complete, history, history-file и profile-history, а также стандартных категорий:

> fish --debug='complete,*history*'

По умолчанию сообщения отладки выводятся в stderr. Обратите внимание, что если fish_trace установлено, отслеживание выполнения также выводится по умолчанию в stderr. Вы можете вывести в файл, используя параметр --debug-output:

> fish --debug='complete,*history*' --debug-output=/tmp/fish.log --init-command='set fish_trace on'

Эти параметры также можно изменить с помощью переменных FISH_DEBUG и FISH_DEBUG_OUTPUT. Категории, включенные с помощью --debug, добавляются к категориям, включённым с помощью $FISH_DEBUG, поэтому их можно отключить, поставив перед ними символ - (reader-*,-ast* включает отладку чтения и отключает отладку ast).

Файл, указанный в параметре --debug-output, имеет приоритет над файлом в FISH_DEBUG_OUTPUT.