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

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