Provided by: man-db_2.13.1-1_amd64 
ІМʼЯ
mandb - створює або оновлює кеші індексу сторінок довідки
СИНОПСИС
mandb [-dqsucpt?V] [-C файл] [шляхи_до_man]
mandb [-dqsut] [-C файл] -f імʼя_файлу ...
ОПИС
mandb використовується для ініціалізації або ручного оновлення кешів бази даних індексі. Ці кеші містять
інформацію, що стосується поточного стану системи сторінок довідки, а інформація, збережена в них,
використовується утилітами man-db для покращення їхньої швидкості та функціональності.
Під час створення або оновлення індексу mandb попереджатиме про неправильні запити ROFF .so, хибні імена
файлів сторінок довідки та сторінки довідки, з яких не можливо розібрати whatis.
Надання mandb необовʼязкового шляху, розділеного двокрапкою, перевизначить внутрішній системний
ієрархічний шлях пошуку сторінок довідки, визначений на основі інформації, знайденої у файлі конфігурації
man-db.
КЕШИ БАЗ ДАНИХ
mandb може бути скомпільовано з підтримкою будь-якого з наступних типів баз даних.
Імʼя Асинхронний Імʼя файлу
─────────────────────────────────────────────────────────────────
Берклійська база даних Так index.bt
GNU gdbm Так index.db
UNIX ndbm Ні індекс.(каталог|сторінка)
Ті типи баз даних, які підтримують асинхронні оновлення, забезпечують покращену швидкість за рахунок
можливого пошкодження у разі незвичайного завершення. У незвичайному випадку, коли це сталося, можливо
необхідно повторно запустити 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 файл, --config-file=файл
Використовуйте цей користувацький файл конфігурації замість типового у ~/.manpath).
-?, --help
Показати повідомлення про використання, а потім вийти.
--usage
Надрукувати коротке повідомлення про використання та вийти.
-V, --version
Показати версію, а потім вийти.
СТАТУС ВИХОДУ
0 Успішне виконання програми.
1 Помилка використання, синтаксису або файлу конфігурації.
2 Операційна помилка.
3 Дочірній процес не вдалося виконати.
ДІАГНОСТИКА
Під час створення бази даних можуть виникати наступні попередження.
<filename>: розбір сторінки з допомогою whatis не вдався
Спроба вилучити 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, який був у цій сторінці керівництва, тепер частина 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
2.13.1 2025-05-02 MANDB(8)