which(1) основы команды в терминале
Содержание:
НАЗВАНИЕ
which - отображает полный путь к указанным командам или сценариям.
СИНТАКСИС
which [опции] [--] имя_программы [...]
ОПИСАНИЕ
Which принимает один или более аргументов имя_программы. Для каждого из них она выводит тот полный путь к исполняемому файлу, который будет использован командной оболочкой, если имя_программы ввести в качестве команды в командной строке. Эта программа выполняет поиск исполняемых файлов или сценариев в каталогах, перечисленных в переменной окружения PATH используя тот же алгоритм, что и bash(1).
ОПЦИИ
--all, -a Выводит все совпавшие исполняемые файлы по содержимому в переменной окружения PATH, а не только первый из них.
--read-alias, -i Считывает псевдонимы, поступающие из стандартного ввода и направляет на стандартный вывод информацию по совпавшим. Эта опция полезна в сочетании с использованием псевдонима для самой команды which. Например:
alias which=´alias | which -i´.--skip-alias Игнорирует опцию `--read-alias´, если таковая имеется. Эта опция полезна для точного поиска обычных двоичных файлов, которые используют опцию `--read-alias´ в псевдониме или функции для which.
--read-functions Считывает функции, определённые в командной оболочке и поступающие из стандартного ввода, а затем направляет на стандартный вывод информацию по совпавшим. Эта опция полезна в сочетании с функциями командной оболочки для самой команды which. Например:
which() { declare -f | which --read-functions $@ }
export -f which--skip-functions Игнорирует опцию `--read-functions´, если таковая имеется. Эта опция полезна для точного поиска обычных двоичных файлов, которые используют опцию `--read-alias´ в псевдониме или функции для which.
--skip-dot Пропускает все каталоги из переменной окружения PATH, которые начинаются с точки.
--skip-tilde Пропускает все каталоги из переменной окружения PATH, имена которых начинаются с символа тильда (~), а также все исполняемые файлы, которые расположены в каталоге, указанном в переменной HOME.
--show-dot Если имя каталога из переменной окружения PATH начинается с точки и соответствующий исполняемый файл имя_программы был найден в этом пути, тогда вместо полного пути будет выведено "./имя_программы".
--show-tilde Выводит тильду, когда каталог совпадает с каталогом, указанном в переменной окружения HOME (т.е. с домашним каталогом). Эта опция игнорируется, если which вызывается суперпользователем (root).
--tty-only Не обрабатывает опции, которые находятся справа за этой опцией, если они поступают не с терминала (tty).
--version,-v,-V Выводит информацию о версии программы на стандартное устройство и завершает её работу.
--help Выводит краткое описание опций программы на стандартное устройство и завершает её работу.
КОДЫ ЗАВЕРШЕНИЯ РАБОТЫ
Программа which возвращает номера некорректных опций или -1, когда пропущен аргумент `имя_программы´.
ПРИМЕР
Обычно утилиту which используют в различных псевдонимах (C shell) или сценариях (Bourne shell) командных оболочек, например, как показано ниже:
Командная оболочка [ba]sh:
which ()
{
(alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@
}
export -f whichКомандная оболочка [t]csh:
alias which ´alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde´В следующем примере показано два возможных варианта вывода одной и той же команды which, в зависимости от контекста ее применения. В первом случае, вместо полного пути выводится ~/ и ./ (для исполняемого файла, расположенного в домашнем каталоге пользователя), когда команда which непосредственно запущена пользователем из командной строки. Во втором - команда which запущена из скрипта. Здесь будет выведен полный путь к указанной программе:
> which q2
~/bin/q2
> echo `which q2`
/home/carlo/bin/q2
ОШИБКИ
Домашний каталог определяется из переменной окружения HOME, поэтому если эта переменная будет неопределённой, это вызовет прерывание выполнения данной программы. Программа which будет считать два эквивалентных каталога различными, если один из них содержит путь с символической ссылкой.
АВТОР
Carlo Wood <carlo@gnu.org>