Учебник по команде Linux apropos для начинающих (5 примеров)

В Linux, если вам когда-либо нужна помощь по команде, все, что вам нужно сделать, это открыть ее страницу man. Но что, если возникнет ситуация, когда необходимо быстро найти названия и описания всех доступных страниц man? Что ж, Linux позаботился об этом, так как существует команда под названием apropos, которая делает именно это.

В этом учебнике мы обсудим основы apropos, используя несколько простых для понимания примеров. Но прежде чем мы это сделаем, стоит упомянуть, что все примеры здесь были протестированы на машине с Ubuntu 16.04 LTS.

Команда apropos ищет названия и описания страниц руководства по заданному пользователем ключевому слову. Вот ее синтаксис:

apropos [OPTIONS] keyword ...

А вот что говорит о ней страница man:

       Каждая страница руководства имеет краткое описание. apropos
       ищет описания на наличие вхождений ключевого слова.

       keyword обычно является регулярным выражением, как если бы (-r) было использовано, или может
       содержать подстановочные знаки (-w), или соответствовать точному ключевому слову (-e). Используя эти
       параметры, может потребоваться заключить ключевое слово в кавычки или экранировать (
       специальные символы, чтобы предотвратить их интерпретацию оболочкой.

       Стандартные правила сопоставления позволяют делать совпадения с
       названием страницы и границами слов в описании.

       База данных, которую ищет apropos, обновляется программой mandb.
       В зависимости от вашей установки, это может выполняться периодической задачей cron,
       или может потребоваться запуск вручную после установки новых страниц руководства.

Следующие примеры в формате вопросов и ответов должны дать вам хорошее представление о том, как работает команда apropos.

Вопрос 1. Как использовать apropos?

Основное использование простое. Просто передайте ключевое слово, которое вы хотите искать, в качестве ввода команде apropos.

Например:

apropos dmesg

выдало следующий результат:

dmesg (1)            - печать или управление кольцевым буфером ядра

Конечно, вы также можете передать несколько ключевых слов.

Например:

apropos dmesg whereis

Следующий вывод в этом случае:

dmesg (1)            - печать или управление кольцевым буфером ядра  
whereis (1)          - найти бинарные, исходные и файлы страниц руководства для а...

Вопрос 2. Как заставить apropos искать точные ключевые слова?

По умолчанию ввод, который вы передаете команде apropos, не ищется точно. Например, если вы передаете ‘who’ в качестве ввода, вы также увидите, что инструмент выдает результаты, содержащие слова, такие как ‘whoami’.

Так что это не точный поиск. Однако вы можете заставить apropos искать точные ключевые слова, используя параметры командной строки -e или –exact.

Теперь вы видите, что только те записи, которые точно соответствуют ‘who’, были отображены в выводе.

Вопрос 3. Как заставить apropos отображать записи, соответствующие всем ключевым словам?

Если вы передаете несколько ключевых слов в качестве ввода команде apropos, инструмент выведет записи, которые соответствуют/содержат хотя бы одно из ключевых слов. Однако, если вы хотите, чтобы apropos выдал только те записи, которые соответствуют/содержат все ключевые слова, используйте параметр командной строки -a.

Например, вот вывод команды apropos без параметра -a:

А вот вывод с включенным параметром -a:

Вопрос 4. Как заставить apropos не обрезать вывод?

Как вы могли видеть в выводе в предыдущих вопросах и ответах, инструмент обрезает записи, если они слишком длинные. Например, посмотрите на выделенную строку в следующем выводе:

Однако, если вы хотите, вы можете заставить apropos выводить полные строки в выводе, что можно сделать с помощью параметра командной строки -l.

Вопрос 5. Как интерпретировать статус выхода apropos?

Команда apropos выдает четыре различных статуса выхода: 0, 1, 2 и 16. Вот что каждый из них представляет:

       0      Успешное выполнение программы.

       1      Ошибка использования, синтаксиса или конфигурационного файла.

       2      Операционная ошибка.

       16     Ничего не найдено, что соответствовало бы указанным критериям

Заключение

В зависимости от вашего рабочего профиля, вам может не понадобиться команда apropos на ежедневной основе, но, как вы уже поняли, она может стать спасением в определенных ситуациях. Мы обсудили некоторые параметры командной строки здесь. Чтобы узнать больше об инструменте, перейдите на его страницу man.