ІМʼЯ

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/man_db.conf: конфігураційний файл 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