table of contents
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, чтобы пересоздать базы данных с нуля.
ПАРАМЕТРЫ¶
- -d, --debug
- Показывать отладочную информацию.
- -q, --quiet
- Не выдавать предупреждения.
- -s, --no-straycats
- Не тратить время на поиск или добавление информации в базы данных по stray cats.
- -p, --no-purge
- Не тратить время на проверку удалённых справочных страниц или их вычистку из баз данных.
- -c, --create
- По умолчанию, mandb пытается обновить любые ранее созданные базы данных. Если база данных не существует, то она будет создана. Этот параметр заставляет mandb удалить имеющиеся базы данных и пересоздать их с нуля, и заключает в себе --no-purge. Это может быть необходимо при повреждении базы данных, или если в будущем будет использоваться новая схема хранения базы данных.
- -u, --user-db
- Создать только пользовательские базы данных, даже имея права на запись, необходимые для создания системных баз данных.
- -t, --test
- Выполнить проверку на правильность справочных страниц в иерархическом пути поиска. При указании этого параметра mandb не изменяет существующие базы данных.
- -f, --filename
- Обновить записи только для заданного файла. Этот параметр не для повседневного использования; он используется для служебных целей man, когда она собрана с параметром MAN_DB_UPDATES и обнаруживает, что страница устарела. Это подразумевает -p и выключает -c и -s.
- -C файл, --config-file=файл
- Использовать указанный пользовательский файл настройки вместо значения по умолчанию ~/.manpath.
- -?, --help
- Показать это справочное сообщение и закончить работу.
- --usage
- Показать короткое сообщение об использовании и завершить работу.
- -V, --version
- Показать версию и закончить работу.
КОД ВЫХОДА¶
- 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/cjwatson/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
2022-03-17 | 2.10.2 |