Scroll to navigation

MANDB(8) Утилиты просмотра справочных страниц MANDB(8)

НАЗВАНИЕ

mandb - создаёт или обновляет кэши index справочных страниц

СИНТАКСИС

mandb [-dqsucpt?V] [-C файл] [manpath]
mandb [-dqsut] [-C файл] -f имя_файла ...

ОПИСАНИЕ

mandb используется для инициализации или ручного обновления кэшей базы данных index. В кэшах содержится информация о текущем состоянии системы справочных страниц, а хранящаяся в них информация используется утилитами man-db для повышения скорости работы и функциональности.

При создании или обновлении index, mandb предупреждает о неверных запросах ROFF .so, фиктивных именах файлов справочных страниц и справочных страницах, которые не удалось проанализировать с помощью whatis.

Указываемые при запуске mandb необязательные пути (через двоеточие) заменят внутренний путь поиска иерархии системных справочных страниц, определённый из файла настроек man-db.

КЭШИ БАЗЫ ДАННЫХ

mandb может быть собрана с поддержкой одного из следующих типов баз данных:

Название Асинхронность Имя файла
Berkeley db Да index.bt
GNU gdbm Да index.db
UNIX ndbm Нет index.(dir|pag)

Типы баз данных, которые поддерживают асинхронные обновления, предоставляют лучшее отношение скорости к возможности повреждения в случае неожиданного прерывания работы. Если это происходит, может потребоваться перезапустить mandb с параметром -c, чтобы пересоздать базы данных с нуля.

ПАРАМЕТРЫ

Показывать отладочную информацию.
Не выдавать предупреждения.
Не тратить время на поиск или добавление информации в базы данных по stray cats.
Не тратить время на проверку удалённых справочных страниц или их вычистку из баз данных.
По умолчанию, mandb пытается обновить любые ранее созданные базы данных. Если база данных не существует, то она будет создана. Этот параметр заставляет mandb удалить имеющиеся базы данных и пересоздать их с нуля, и заключает в себе --no-purge. Это может быть необходимо при повреждении базы данных, или если в будущем будет использоваться новая схема хранения базы данных.
Создать только пользовательские базы данных, даже имея права на запись, необходимые для создания системных баз данных.
Выполнить проверку на правильность справочных страниц в иерархическом пути поиска. При указании этого параметра mandb не изменяет существующие базы данных.
Обновить записи только для заданного файла. Этот параметр не для повседневного использования; он используется для служебных целей man, когда она собрана с параметром MAN_DB_UPDATES и обнаруживает, что страница устарела. Это подразумевает -p и выключает -c и -s.
Use this user configuration file rather than the default of ~/.manpath.
-?, --help
Показать это справочное сообщение и закончить работу.
Показать короткое сообщение об использовании и завершить работу.
Показать версию и закончить работу.

КОД ВЫХОДА

0
Успешное выполнение программы.
1
Ошибка при использовании, в синтаксисе или файле настроек.
2
Ошибка при работе.
3
Работа процесса-потомка завершилась неудачно.

ДИАГНОСТИКА

Во время создания базы данных могут появляться следующие предупреждения.

<имя файла>: ошибка анализа страниц(ы) программой whatis
Программа whatis пыталась извлечь строки из указанного <файла>, но это не удалось. Обычно, эта ошибка возникает, если справочная страница плохо написана, а если таких сообщений возникает много, то, скорее всего, в системе содержатся нестандартные справочные страницы, несовместимые с анализатором man-db whatis. Более подробное описание смотрите в разделе ЧТО АНАЛИЗИРУЕТСЯ на странице lexgrog(1).
<имя файла>: повисшая символическая ссылка
<Файл> не существует, но на него ссылаются по символической ссылке. При дальнейшей диагностике, обычно, появятся сообщения, указывающие на <файл> с неправильной ссылкой.
<имя файла>: неверная символическая ссылка или ROFF `.so' запрос
<Файл>, или указывает на символическую ссылку, или содержит ROFF include запрос на несуществующий файл.
<имя файла>: игнорируется фиктивное имя файла
<Файл> может (или не может) быть допустимой справочной страницей, но это имя неправильно. Обычно, это происходит со справочными страницами, имеющими раздельческое расширение <x>, но лежащими в разделе <y>.
<маска имени файла>: конкурирующие расширения
Шаблон <маска имени файла> не является уникальным. Обычно, это происходит из-за существования одновременно сжатой и несжатой версии одной и той же справочной страницы. Все страницы кроме самой новой игнорируются.

ФАЙЛЫ

/etc/manpath.config
Файл настройки man-db.
/var/cache/man/index.(bt|db|dir|pag)
Соответствующий FHS глобальный кэш базы данных index.

Места, где кэш базы данных находился ранее:

/usr/man/index.(bt|db|dir|pag)
Традиционный кэш глобальной базы данных index.
/var/catman/index.(bt|db|dir|pag)
Альтернативный или соответствующий FSSTND, глобальный кэш базы данных index.

СМОТРИТЕ ТАКЖЕ

lexgrog(1), man(1), manpath(5), catman(8)

Прежде в этой странице был раздел ЧТО АНАЛИЗИРУЕТСЯ, но теперь он перенесён в lexgrog(1).

АВТОР

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

ОШИБКИ

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2023-09-23 2.12.0