MANDB(8)

ІМʼЯ
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