НАЗВА

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

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

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

ОПИС

whereis визначає місце зберігання виконуваних файлів, файлів із початковим кодом та файлів підручника для вказаних назв програм З наданих назв спершу буде вилучено початкові компоненти шляху. Також буде оброблено префікси s., які є наслідком використання керування початковим кодом. Потім whereis спробує знайти бажану програму у стандартних каталогах Linux та каталогах, які вказано за допомогою змінних середовища $PATH і $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/.