Man page - mandb(8)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANDB

НАЗВАНИЕ
СИНТАКСИС
ОПИСАНИЕ
КЭШИ БАЗЫ ДАННЫХ
ПАРАМЕТРЫ
КОД ВЫХОДА
ДИАГНОСТИКА
ФАЙЛЫ
СМОТРИТЕ ТАКЖЕ
АВТОР
ОШИБКИ

НАЗВАНИЕ

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

СИНТАКСИС

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

ОПИСАНИЕ

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

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

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

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

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

Image grohtml-597961-1.png

Типы баз данных, которые поддерживают асинхронные обновления, предоставляют лучшее отношение скорости к возможности повреждения в случае неожиданного прерывания работы. Если это происходит, может потребоваться перезапустить 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/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db