НАЗВА

whereis - визначення місця виконуваних файлів, коду та сторінки підручника програми

КОРОТКИЙ ОПИС

whereis [параметри] [-BMS каталог... -f] назва...

ОПИС

whereis locates the binary, source and manual files for the specified command names. The supplied names are first stripped of leading pathname components. Prefixes of s. resulting from use of source code control are also dealt with. whereis then attempts to locate the desired program in the standard Linux places, and in the places specified by $PATH and $MANPATH.

Обмеження пошуку (параметри -b, -m і -s) є накопичувальними і застосовуються до наступних взірців назва у командному рядку. Кожне нове обмеження пошуку скидає маску пошуку. Наприклад,

whereis -bm ls tr -m gcc

виконує пошук виконуваних файлів та сторінок підручника «ls» і «tr» і лише сторінок підручника «gcc».

Параметри -B, -M і -S скидають шляхи пошуку для наступних взірців _назва>. Наприклад,

whereis -m ls -M /usr/share/man/man1 -f cal

шукає сторінки підручника для «ls» в усіх типових каталогах, але для «cal» лише у каталозі /usr/share/man/man1.

ПАРАМЕТРИ

-b

Шукати виконувані файли.

-m

Шукати підручники.

-s

Шукати початковий код.

-u

Показувати назви команд лише для незвичайних записів. Команду називають незвичайною, якщо у неї не один запис для кожного явним чином заданого типу. Таким чином, «whereis -m -u *» наказує вивести ті файли у поточному каталозі, у яких немає файла документації або є декілька файлів документації.

-B список

Обмежити місця, де whereis шукатиме виконувані файли, списком каталогів, які відокремлено пробілами.

-M _список>

Обмежити місця, де whereis шукатиме підручники та документацію у форматі info, списком каталогів, які відокремлено пробілами.

-S _список>

Обмежити місця, де whereis шукатиме файли з початковим кодом, списком каталогів, які відокремлено пробілами.

-f

Завершує список каталогів і вказує, що розпочато список назв файлів. Має бути використано, якщо використано будь-який з параметрів -B, -M або -S.

-l

Вивести список чинних шляхів пошуку, якими користується whereis. Якщо не вказано жодного з параметрів -B, -M або -S, використання цього параметра призведе до виведення вбудованих до системи шляхів, які команда зможе знайти.

-g

Interpret the next names as a glob(7) patterns. whereis always compares only filenames (aka basename) and never complete path. Using directory names in the pattern has no effect. Donâ��t forget that the shell interprets the pattern when specified on the command line without quotes. Itâ��s necessary to use quotes for the name, for example:

whereis -g 'find*'

-h, --help

Вивести текст довідки і завершити роботу.

-V, --version

Вивести дані щодо версії і завершити роботу.

ШЛЯХИ ДЛЯ ПОШУКУ ФАЙЛІВ

Типово, whereis намагається знайти файли у вбудованих до системи каталогах, які визначено за допомогою взірців із символами-замінниками. Команда спробує скористатися вмістом змінних середовища $PATH і $MANPATH, як типовими каталогами для пошуку. Найпростішим способом визначити шляхи, які буде використано, є додавання параметра -l. Результат застосування -B, -M і -S буде показано, якщо скористатися -l.

СЕРЕДОВИЩЕ

WHEREIS_DEBUG=all

вмикає показ діагностичних повідомлень.

ПРИКЛАДИ

Щоб знайти усі файли у /usr/bin, які не документовано у /usr/man/man1 або які не мають початкових кодів у /usr/src, віддайте таку команду:

cd /usr/bin
whereis -u -ms -M /usr/man/man1 -S /usr/src -f *

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

Для звітування щодо вад скористайтеся системою стеження за вадами - <https://github.com/util-linux/util-linux/issues>.

ДОСТУП ДО ПРОГРАМИ

Програма whereis є частиною пакунка util-linux, який можна отримати з архіву ядра Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.