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) є накопичувальними і застосовуються до наступних взірців назва у командному рядку. Кожне нове обмеження пошуку скидає маску пошуку. Наприклад,
виконує пошук виконуваних файлів та сторінок підручника «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:
-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/>.