WHEREIS(1)                   Polecenia uzytkownika                  WHEREIS(1)

NAZWA
       whereis - odnajduje pliki binarne, zrodlowe i strony podrecznika dla
       danego polecenia

SKLADNIA
       whereis [opcje] [-BMS katalog... -f] nazwa...

OPIS
       whereis lokalizuje pliki binarne, zrodlowe i podreczniki systemowe dla
       zadanych nazw polecen. Z podanych nazw wstepnie usuwana jest poczatkowa
       skladowa okreslajaca sciezke. Przedrostki s. wynikajace z uzycia
       kontroli kodu zrodlowego sa rowniez obslugiwane. Nastepnie whereis
       usiluje zlokalizowac polozenie zadanego programu, poslugujac sie lista
       standardowych miejsc linuksowych oraz w miejscach okreslonych zmiennymi
       $PATH i $MANPATH.

       Ograniczenia wyszukiwania (opcje -b, -m i -s) lacza sie i sa stosowane
       do kolejnych wzorow nazw w wierszu polecen. Kazde nowe ograniczenie
       wyszukiwania resetuje maske szukania, np.

          whereis -bm ls tr -m gcc

       wyszukuje stron podrecznika i plikow binarnych do "ls" i "tr", a do
       "gcc" jedynie stron podrecznika systemowego.

       Opcje -B, -M i -S resetuja sciezki szukania dla kolejnych wzorcow nazw,
       np.

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

       szuka podrecznikow systemowych do "ls" we wszystkich domyslnych
       sciezkach, a do "cal" jedynie w katalogu /usr/share/man/man1.

OPCJE
       -b
           Szuka plikow binarnych.

       -m
           Szuka podrecznikow systemowych.

       -s
           Szuka zrodel.

       -u
           Pokazuje jedynie nazwy polecen z nietypowymi wpisami, tzn. te,
           ktore nie maja jednej pozycji dla kazdego zadanego typu. Zatem
           "whereis -m -u *" wyszukuje pliki w biezacym katalogu, ktore nie
           maja dokumentacji lub maja wiecej niz jedna.

       -B lista
           Ogranicza miejsca, gdzie whereis szuka plikow binarnych, do
           oddzielonej spacjami listy katalogow.

       -M lista
           Ogranicza miejsca, gdzie whereis szuka podrecznikow systemowych i
           dokumentacji w formacie Info, do oddzielonej spacjami listy
           katalogow.

       -S lista
           Ogranicza miejsca, gdzie whereis szuka zrodel, do oddzielonej
           spacjami listy katalogow.

       -f
           Konczy liste katalogow i sygnalizuje poczatek nazw plikow. Musi byc
           uzyte, jesli zastosowano jedna z opcji -B, -M lub -S.

       -l
           Wypisuje liste efektywnie przeszukiwanych sciezek, ktorej uzywa
           whereis. Gdy nie poda sie zadnej z opcji -B, -M ani -S, wypisane
           zostana ustalone na sztywno sciezki, ktore polecenie bylo w stanie
           znalezc w tym systemie.

       -g
           Interpretuje nazwy jako wzorce glob(7). whereis zawsze porownuje
           jedynie nazwy plikow (inaczej basename), a nie pelne sciezki.
           Korzystanie z nazw katalogow we wzorcu nie przynosi efektu. Prosze
           nie zapominac, ze jesli podaloby sie wzorzec bez cudzyslowow,
           zinterpretowalaby go powloka. Konieczne jest zatem ujecie nazwy w
           cudzyslow np.:

              whereis -g 'find*'

       -h, --help
           Wyswietla ten tekst i wychodzi.

       -V, --version
           Wyswietla wersje i wychodzi.

SCIEZKI PRZESZUKIWANIA PLIKOW
       Domyslnie whereis probuje znajdowac pliki w zakodowanych na sztywno
       sciezkach, ktore sa zdefiniowane za pomoca masek. Polecenie probuje
       skorzystac z zawartosci zmiennych srodowiskowych $PATH i $MANPATH jako
       domyslnych sciezek wyszukiwania. Najprostsza metoda poznania tych
       sciezek jest skorzystanie z opcji -l. Dzialanie opcji -B, -M i -S jest
       odzwierciedlone przez -l.

SRODOWISKO
       WHEREIS_DEBUG=all
           wlacza wyjscie debugowania.

PRZYKLADY
       Aby znalezc wszystkie pliki w /usr/bin, ktore nie maja dokumentacji w
       /usr/man/man1 ani zrodla w /usr/src:

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

ZGLASZANIE BLEDOW
       Problemy nalezy zglaszac w systemie sledzenia bledow
       <https://github.com/util-linux/util-linux/issues>.

DOSTEPNOSC
       Polecenie whereis jest czescia pakietu util-linux, ktory mozna pobrac
       ze strony Archiwum jadra Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                   2025-03-29                        WHEREIS(1)