NAZWA

       whereis - znajdź pliki binarne, źródłowe i strony podręcznika dla danego polecenia

SKŁADNIA

       whereis [opcje] [-BMS katalog...  -f] nazwa_pliku...

OPIS

       whereis  lokalizuje  pliki  binarne,  źródłowe  i  podręczniki systemowe dla zadanych nazw
       poleceń. Z podanych nazw wstępnie usuwana jest  początkowa  składowa  określająca  ścieżkę
       oraz  ewentualne  (pojedyncze)  kończące rozszerzenie postaci .ext, np. .c. Przedrostki s.
       wynikające z użycia kontroli kodu źródłowego są  również  obsługiwane.  Następnie  whereis
       usiłuje  zlokalizować  położenie  żądanego  programu,  posługując  się listą standardowych
       miejsc linuksowych oraz w miejscach określonych zmiennymi $PATH i $MANPATH.

       Ograniczenia wyszukiwania (opcje -b, -m i -s) łączą się i są stosowane do kolejnych wzorów
       nazw w wierszu poleceń. Każde nowe ograniczenie wyszukiwania resetuje maskę szukania, np.

              whereis -bm ls tr -m gcc

       wyszukuje  stron  podręcznika  i plików binarnych do "ls" i "tr", a do "gcc" jedynie stron
       podręcznika systemowego.

       Opcje -B, -M i -S resetują ścieżki szukania dla kolejnych wzorców nazw, np.

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

       szuka podręczników systemowych do "ls" we wszystkich  domyślnych  ścieżkach,  a  do  "cal"
       jedynie w katalogu /usr/share/man/man1.

OPCJE

       -b     Szuka plików binarnych.

       -m     Szuka podręczników systemowych.

       -s     Szuka źródeł.

       -u     Pokazuje  jedynie  nazwy  poleceń  z  nietypowymi  wpisami, tzn. te, które nie mają
              jednej pozycji dla każdego zadanego typu.  Zatem "whereis -m -u *" wyszukuje  pliki
              w bieżącym katalogu, które nie mają dokumentacji lub mają więcej niż jedną.

       -B lista
              Ogranicza  miejsca,  gdzie  whereis  szuka plików binarnych do oddzielonej spacjami
              listy katalogów.

       -M lista
              Ogranicza miejsca, gdzie whereis szuka podręczników systemowych  i  dokumentacji  w
              formacie Info do oddzielonej spacjami listy katalogów.

       -S lista
              Ogranicza  miejsca,  gdzie  whereis  szuka  źródeł  do  oddzielonej  spacjami listy
              katalogów.

       -f     Kończy listę katalogów i sygnalizuje początek nazw plików. Musi  być  użyte,  jeśli
              zastosowano jedną z opcji -B, -M lub -S.

       -l     Wypisuje  listę  efektywnie  przeszukiwanych ścieżek, której używa whereis. Gdy nie
              poda się żadnej z opcji -B,  -M  ani  -S,  wypisane  zostaną  ustalone  na  sztywno
              ścieżki, które polecenie było w stanie znaleźć w tym systemie.

PRZYKŁAD

       Aby  znaleźć wszystkie pliki w /usr/bin, które nie mają dokumentacji w /usr/share/man/man1
       ani źródła w /usr/src:

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

ŚCIEŻKI PRZESZUKIWANIA PLIKÓW

       Domyślnie whereis próbuje znajdować pliki w zakodowanych na sztywno  ścieżkach,  które  są
       zdefiniowane   za  pomocą masek.  Polecenie  próbuje  skorzystać  z  zawartości  zmiennych
       środowiskowych  $PATH  i  $MANPATH  jako  domyślnych  ścieżek  wyszukiwania.   Najprostszą
       metodą poznania  tych  ścieżek  jest  skorzystanie z opcji -l. Działanie opcji -B, -M i -S
       jest odzwierciedlone przez -l.

ŚRODOWISKO

       WHEREIS_DEBUG=all
              włącza wyjście debugowania.

DOSTĘPNOŚĆ

       Polecenie whereis jest częścią pakietu util-linux i jest dostępne z Archiwum  jądra  Linux
       ⟨ftp://ftp.kernel.org/pub/linux/utils/util-linux/⟩.

TŁUMACZENIE

       Autorami  polskiego tłumaczenia niniejszej strony podręcznika man są: Wojtek Kotwica (PTM)
       <wkotwica@post.pl>,    Robert    Luberda    <robert@debian.org>    i     Michał     Kułach
       <michal.kulach@gmail.com>.

       Polskie  tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
       stronie  http://sourceforge.net/projects/manpages-pl/.  Jest   zgodne   z   wersją    2.28
       oryginału.