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. ([email protected]).
Fabrizio Polacco ([email protected]).
Colin Watson ([email protected]).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db