apropos

apropos – narzędzie terminalowe w systemach Linux i UNIX, które przeszukuje bazy danych podręcznika systemowego (man) pod kątem podanego słowa kluczowego.
Umożliwia szybkie odnalezienie komend i narzędzi związanych z danym tematem, nawet jeśli użytkownik nie zna dokładnej nazwy komendy.
Dostępne w większości systemów POSIX, w tym w dystrybucjach opartych na Debianie, Red Hat, Arch, Alpine i macOS.

Składnia

apropos [opcje] <szukana_fraza>

Domyślnie przeszukuje wszystkie sekcje podręcznika man.
Fraza może zawierać wyrażenia regularne.
Wyniki zawierają nazwę komendy, numer sekcji i krótki opis.

Parametry

Parametr	Opis
`<fraza>`	Słowo kluczowe, którego apropos ma szukać w bazie manuala.
`-e`	Dokładne dopasowanie nazwy (pełne wyrażenie).
`-a`	Zwraca tylko te wyniki, które pasują do wszystkich fraz (AND logiczny).
`-s <sekcja>`	Przeszukuje tylko wskazaną sekcję podręcznika.
`--help`	Wyświetla pomoc dotyczącą użycia komendy.
`--version`	Informacja o wersji programu.

Przykłady użycia

# Przykład 1: Wyszukiwanie komend związanych z hasłem "archive"
apropos archive

# Przykład 2: Dokładne dopasowanie słowa "printf"
apropos -e printf

# Przykład 3: Szukanie tylko w sekcji 2 podręcznika
apropos -s 2 fork

Uwagi

Baza whatis: apropos korzysta z bazy whatis.db, którą należy aktualizować komendą sudo mandb.
Uprawnienia: zwykle nie wymaga podniesionych uprawnień, ale mandb może wymagać sudo.
Wyrażenia regularne: domyślnie nie działa jak grep – apropos przeszukuje opisy i nazwy narzędzi.

Najczęściej spotykane błędy i jak je naprawić

Błąd / Komunikat	Przyczyna	Rozwiązanie
`nothing appropriate`	Brak wyników dla frazy	Sprawdź pisownię lub użyj bardziej ogólnego słowa kluczowego.
`mandb: can't create`	Brak uprawnień do aktualizacji bazy manuala	Wykonaj `sudo mandb`.
Nieczytelne znaki w wynikach	Problem z kodowaniem terminala	Ustaw poprawne kodowanie UTF-8 w terminalu.

Linki i źródła

man7.org – apropos(1) – oficjalna dokumentacja.
The Linux Command Library – apropos – skrócone opisy i przykłady użycia.