fish - интерактивная оболочка

Синтаксис

fish [OPTIONS] [-c command] [FILE] [ARGUMENTS...]

Описание

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

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

• -c или --command=COMMANDS выполняют указанные команды вместо чтения из командной строки, передавая дополнительные позиционные аргументы через $argv. Обратите внимание, что, в отличие от других оболочек, первый аргумент — не имя программы ($0), а просто первый обычный аргумент.
• -C или --init-command=COMMANDS выполняют указанные команды после чтения конфигурации, прежде чем запускать команду, указанную в -c, или читать интерактивный ввод.
• -d или --debug=DEBUG_CATEGORIES включают вывод отладки и задают шаблон для сопоставления категорий отладки. Подробности см. ниже в разделе Отладка.
• -o или --debug-output=DEBUG_FILE задают путь к файлу для получения вывода отладки, включая категории и fish_trace. По умолчанию используется stderr.
• -i или --interactive задают, что fish должна запускаться в интерактивном режиме.
• -l или --login задают, что fish должна запускаться как оболочка входа.
• -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 предоставляет обширную поддержку отладки скриптов 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.