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=COMMAND

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

-C или --init-command=COMMANDS

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

-d или --debug=DEBUG_CATEGORIES

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

-o или --debug-output=DEBUG_FILE

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

-i или --interactive

Интерпретатор команд работает в интерактивном режиме.

-l или --login

Действовать так, как будто интерпретатор запущен как логин-оболочка.

-N или --no-config

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

-n или --no-execute

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

-p или --profile=PROFILE_FILE

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

--profile-startup=PROFILE_FILE

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

-P или --private

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

--print-rusage-self

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

--print-debug-categories

Вывести все категории отладки, а затем выйти.

-v или --version

Вывести версию и выйти.

-f или --features=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* включает отладку reader и отключает отладку ast).

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