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.