'\" 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 docs/COPYING.GPLv2 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 2025-05-02 2.13.1 "Утиліти переглядача довідки" .SH ІМʼЯ mandb \- створює або оновлює кеші індексу сторінок довідки .SH СИНОПСИС \fBmandb\fP [\|\fB\-dqsucpt?V\fP\|] [\|\fB\-C\fP \fIфайл\fP\|] [\|\fIшляхи_до_man\fP\|] .br \fBmandb\fP [\|\fB\-dqsut\fP\|] [\|\fB\-C\fP \fIфайл\fP\|] \fB\-f\fP \fIімʼя_файлу\fP\ .\|.\|. .SH ОПИС \fBmandb\fP використовується для ініціалізації або ручного оновлення кешів бази даних \fBіндексі\fP. Ці кеші містять інформацію, що стосується поточного стану системи сторінок довідки, а інформація, збережена в них, використовується утилітами man\-db для покращення їхньої швидкості та функціональності. Під час створення або оновлення індексу \fBmandb\fP попереджатиме про неправильні запити ROFF .so, хибні імена файлів сторінок довідки та сторінки довідки, з яких не можливо розібрати \fBwhatis\fP. Надання \fBmandb\fP необовʼязкового шляху, розділеного двокрапкою, перевизначить внутрішній системний ієрархічний шлях пошуку сторінок довідки, визначений на основі інформації, знайденої у файлі конфігурації man\-db. .SH "КЕШИ БАЗ ДАНИХ" \fBmandb\fP може бути скомпільовано з підтримкою будь\-якого з наступних типів баз даних. .TS tab (@); l l l. Імʼя@Асинхронний@Імʼя файлу _ Берклійська база даних@Так@\fIindex.bt\fP GNU gdbm@Так@\fIindex.db\fP UNIX ndbm@Ні@\fIіндекс.(каталог|сторінка)\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 Не витрачати час на пошук або додавання інформації про безхатьків у базах даних. .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\(ti/.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 рядки з вказаного не вдалася. Це зазвичай спричинено погано написаною сторінкою довідки, але якщо багато таких повідомлень виникає, ймовірно, система містить нестандартні сторінки довідки, які несумісні з аналізатором whatis man\-db. Для отримання додаткової інформації дивіться розділ \fBWHATIS PARSING\fP у \fBlexgrog\fP(1). .TP \fB: це недійсне символічне посилання\fP не існує, але він є посиланням символічного типу. Зазвичай видаються додаткові діагностичні дані для визначення порушуючого посилання. .TP \fB: помилкове символічне посилання або неправильний запит ROFF «.so»\fP є символьним посиланням на або містить запит на включення ROFF до неіснуючого файлу. .TP \fB: ігнорування неправильного імені файлу\fP може бути або не бути дійсною сторінкою довідки, але його імʼя є недійсним. Це зазвичай через те, що сторінка довідки з розширенням секції поміщена в секцію сторінок довідки . .TP \fB: конфліктні розширення\fP Шаблон не є унікальним. Це зазвичай спричинено наявністю як стиснутої, так і розпакованої версії однієї й тієї ж сторінки довідника. Ігноруються всі, окрім найновішої. .SH ФАЙЛИ .TP .if !'po4a'hide' .I /etc/man_db.conf конфігураційний файл man\-db. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt|db|dir|pag) Сумісний з FHS глобальний кеш \fIіндексу\fP бази даних. .PP Старі розташування кешу бази даних включали: .TP .if !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag) Традиційний глобальний кеш \fIіндексу\fP бази даних. .TP .if !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag) Альтернативний або сумісний з FSSTND глобальний кеш бази даних \fIіндексу\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РОЗБІР WHATIS\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://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db