mandb - создание или обновление кэшей индекса страниц руководства
СИНТАКСИС
mandb [-dqsucpt?V] [-C file] [manpath]
mandb [-dqsut] [-C file] -f filename ...
ОПИСАНИЕ
mandb используется для инициализации или ручного обновления кэшей базы данных индекса. Кэши содержат информацию, относящуюся к текущему состоянию системы страниц руководства, и информация, хранящаяся в них, используется утилитами man-db для повышения их скорости и функциональности.
При создании или обновлении индекса mandb будет предупреждать о неправильных запросах .so ROFF, неверных именах файлов страниц руководства и страницах руководства, из которых невозможно извлечь информацию whatis.
Передача mandb необязательного пути, разделенного двоеточиями, переопределит внутренний системный иерархический путь поиска страниц руководства, определенный в файле конфигурации man-db.
БАЗЫ ДАННЫХ
mandb может быть скомпилирован с поддержкой любого из следующих типов баз данных.
Имя Async Имя файла
Berkeley db Да index.bt
GNU gdbm Да index.db
UNIX ndbm Нет index.(dir|pag)
Типы баз данных, поддерживающие асинхронные обновления, обеспечивают повышенную скорость за счет возможной потери данных в случае необычного завершения работы. В редком случае, когда это произошло, может потребоваться повторный запуск mandb с опцией -c для пересоздания баз данных с нуля.
ОПЦИИ
-d, --debug
Вывод отладочной информации.
-q, --quiet
Не выводить предупреждений.
-s, --no-straycats
Не тратить время на поиск или добавление информации в базы данных относительно "блуждающих кошек".
-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 file, --config-file=file
Использовать этот пользовательский файл конфигурации вместо файла по умолчанию \~/.manpath.
-?, --help
Показать сообщение об использовании, а затем выйти.
--usage
Вывести краткое сообщение об использовании и выйти.
-V, --version
Показать версию, а затем выйти.
СТАТУС ВЫХОДА
0 Успешное выполнение программы.
1 Ошибка использования, синтаксическая ошибка или ошибка файла конфигурации.
2 Ошибка выполнения.
3 Дочерний процесс завершился с ошибкой.
СООБЩЕНИЯ
Во время построения базы данных могут быть выведены следующие предупреждающие сообщения.
<filename>: не удалось выполнить разбор whatis для страницы(sec)
Попытка извлечь строку(и) whatis из указанного <filename> не удалась. Обычно это связано с плохо написанной страницей руководства, но если выводится много таких сообщений, скорее всего, в системе содержатся нестандартные страницы руководства, несовместимые с анализатором whatis man-db. Подробную информацию см. в разделе WHATIS PARSING в lexgrog(1).
<filename>: является висячей символической ссылкой
<filename> не существует, но на него ссылается символическая ссылка. Обычно выводится дополнительная диагностическая информация для определения имени файла <filename> нарушившей ссылки.
<filename>: неверная символическая ссылка или запрос ROFF `.so`
<filename> либо является символической ссылкой на файл, не существующий, либо содержит запрос включения ROFF в файл, не существующий.
<filename>: игнорируется неверное имя файла
<filename> может быть или не быть действительной страницей руководства, но его имя недействительно. Обычно это происходит, когда страница руководства с расширением раздела <x> помещается в раздел страницы руководства <y>.
<filename_mask>: конкурирующие расширения
Подстановочный знак <filename_mask> не является уникальным. Обычно это вызвано существованием сжатой и несжатой версии одной и той же страницы руководства. Игнорируются все, кроме самой последней.
ФАЙЛЫ
/etc/manpath.config
Файл конфигурации man-db.
/var/cache/man/index.(bt|db|dir|pag)
Соответствующий FHS глобальный кэш базы данных индекса.
Более старые местоположения для кэша базы данных включали:
/usr/man/index.(bt|db|dir|pag)
Традиционный глобальный кэш базы данных индекса.
/var/catman/index.(bt|db|dir|pag)
Альтернативный или соответствующий FSSTND глобальный кэш базы данных индекса.
СМОТРИТЕ ТАКЖЕ
lexgrog(1), man(1), manpath(5), catman(8)
Раздел WHATIS PARSING, ранее содержавшийся в этой странице руководства, теперь является частью lexgrog(1).
АВТОР
Wilf. (_)
Fabrizio Polacco (_).
Colin Watson (_).
ОШИБКИ
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db