'\" t
.\" Man page for mandb
.\"
.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with the
.\" man-db distribution.
.\"
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MANDB 8 2021-02-08 2.9.4 "Утилиты просмотра справочных страниц"
.SH НАЗВАНИЕ
mandb \- создаёт или обновляет кэши index справочных страниц
.SH СИНТАКСИС
\fBmandb\fP [\|\fB\-dqsucpt?V\fP\|] [\|\fB\-C\fP \fIфайл\fP\|] [\|\fImanpath\fP\|]
.br
\fBmandb\fP [\|\fB\-dqsut\fP\|] [\|\fB\-C\fP \fIфайл\fP\|] \fB\-f\fP \fIимя_файла\fP\ .\|.\|.
.SH ОПИСАНИЕ
\fBmandb\fP используется для инициализации или ручного обновления кэшей базы
данных \fBindex\fP. В кэшах содержится информация о текущем состоянии системы
справочных страниц, а хранящаяся в них информация используется утилитами
man\-db для повышения скорости работы и функциональности.

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

Указываемые при запуске \fBmandb\fP необязательные пути (через двоеточие)
заменят внутренний путь поиска иерархии системных справочных страниц,
определённый из файла настроек man\-db.
.SH "КЭШИ БАЗЫ ДАННЫХ"
\fBmandb\fP может быть собрана с поддержкой одного из следующих типов баз
данных:

.TS
tab (@);
l l l.
Название@Асинхронность@Имя файла
_
Berkeley db@Да@\fIindex.bt\fP
GNU gdbm@Да@\fIindex.db\fP
UNIX ndbm@Нет@\fIindex.(dir|pag)\fP
.TE

Типы баз данных, которые поддерживают асинхронные обновления, предоставляют
лучшее отношение скорости к возможности повреждения в случае неожиданного
прерывания работы. Если это происходит, может потребоваться перезапустить
\fBmandb\fP с параметром \fB\-c\fP, чтобы пересоздать базы данных с нуля.
.SH ПАРАМЕТРЫ
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
Показывать отладочную информацию.
.TP 
.if  !'po4a'hide' .BR \-q ", " \-\-quiet
Не выдавать предупреждения.
.TP 
.if  !'po4a'hide' .BR \-s ", " \-\-no-straycats
Не тратить время на поиск или добавление информации в базы данных по stray
cats.
.TP 
.if  !'po4a'hide' .BR \-p ", " \-\-no-purge
Не тратить время на проверку удалённых справочных страниц или их вычистку из
баз данных.
.TP 
.if  !'po4a'hide' .BR \-c ", " \-\-create
По умолчанию, \fBmandb\fP пытается обновить любые ранее созданные базы
данных. Если база данных не существует, то она будет создана. Этот параметр
заставляет \fBmandb\fP удалить имеющиеся базы данных и пересоздать их с нуля,
и заключает в себе \fB\-\-no\-purge.\fP Это может быть необходимо при повреждении
базы данных, или если в будущем будет использоваться новая схема хранения
базы данных.
.TP 
.if  !'po4a'hide' .BR \-u ", " \-\-user-db
Создать только пользовательские базы данных, даже имея права на запись,
необходимые для создания системных баз данных.
.TP 
.if  !'po4a'hide' .BR \-t ", " \-\-test
Выполнить проверку на правильность справочных страниц в иерархическом пути
поиска. При указании этого параметра \fBmandb\fP не изменяет существующие
базы данных.
.TP 
.if  !'po4a'hide' .BR \-f ", " \-\-filename
Обновить записи только для заданного файла. Этот параметр не для
повседневного использования; он используется для служебных целей \fBman\fP,
когда она собрана с параметром \fBMAN_DB_UPDATES\fP и обнаруживает, что
страница устарела. Это подразумевает \fB\-p\fP и выключает \fB\-c\fP и \fB\-s\fP.
.TP 
\fB\-C\ \fP\fIфайл\fP,\ \fB\-\-config\-file=\fP\fIфайл\fP
Использовать указанный пользовательский файл настройки вместо значения по
умолчанию \fI~/.manpath\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
Показать это справочное сообщение и закончить работу.
.TP 
.if  !'po4a'hide' .B \-\-usage
Показать короткое сообщение об использовании и завершить работу.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
Показать версию и закончить работу.
.SH "КОД ВЫХОДА"
.TP 
.if  !'po4a'hide' .B 0
Успешное выполнение программы.
.TP 
.if  !'po4a'hide' .B 1
Ошибка при использовании, в синтаксисе или файле настроек.
.TP 
.if  !'po4a'hide' .B 2
Ошибка при работе.
.TP 
.if  !'po4a'hide' .B 3
Работа процесса\-потомка завершилась неудачно.
.SH ДИАГНОСТИКА
Во время создания базы данных могут появляться следующие предупреждения.
.TP 
\fB<имя файла>: ошибка анализа страниц(ы) программой whatis\fP
Программа whatis пыталась извлечь строки из указанного <файла>, но
это не удалось. Обычно, эта ошибка возникает, если справочная страница плохо
написана, а если таких сообщений возникает много, то, скорее всего, в
системе содержатся нестандартные справочные страницы, несовместимые с
анализатором man\-db whatis. Более подробное описание смотрите в разделе
\fBЧТО АНАЛИЗИРУЕТСЯ\fP на странице \fBlexgrog\fP(1).
.TP 
\fB<имя файла>: повисшая символическая ссылка\fP
<Файл> не существует, но на него ссылаются по символической
ссылке. При дальнейшей диагностике, обычно, появятся сообщения, указывающие
на <файл> с неправильной ссылкой.
.TP 
\fB<имя файла>: неверная символическая ссылка или ROFF `.so' запрос\fP
<Файл>, или указывает на символическую ссылку, или содержит ROFF
include запрос на несуществующий файл.
.TP 
\fB<имя файла>: игнорируется фиктивное имя файла\fP
<Файл> может (или не может) быть допустимой справочной страницей, но
это имя неправильно. Обычно, это происходит со справочными страницами,
имеющими раздельческое расширение <x>, но лежащими в разделе
<y>.
.TP 
\fB<маска имени файла>: конкурирующие расширения\fP
Шаблон <маска имени файла> не является уникальным. Обычно, это
происходит из\-за существования одновременно сжатой и несжатой версии одной и
той же справочной страницы. Все страницы кроме самой новой игнорируются.
.SH ФАЙЛЫ
.TP 
.if  !'po4a'hide' .I /etc/manpath.config
Файл настройки man\-db.
.TP 
.if  !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag)
Соответствующий FHS глобальный кэш базы данных \fIindex\fP.
.PP
Места, где кэш базы данных находился ранее:
.TP 
.if  !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag)
Традиционный кэш глобальной базы данных \fIindex\fP.
.TP 
.if  !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag)
Альтернативный или соответствующий FSSTND, глобальный кэш базы данных
\fIindex\fP.
.SH "СМОТРИТЕ ТАКЖЕ"
.if  !'po4a'hide' .BR lexgrog (1),
.if  !'po4a'hide' .BR man (1),
.if  !'po4a'hide' .BR manpath (5),
.if  !'po4a'hide' .BR catman (8)
.PP
Прежде в этой странице был раздел \fBЧТО АНАЛИЗИРУЕТСЯ\fP, но теперь он
перенесён в \fBlexgrog\fP(1).
.SH АВТОР
.nf
.if  !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk).
.if  !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi
.SH ОШИБКИ
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db