Man page - mandb(8)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANDB

ІМʼЯ
СИНОПСИС
ОПИС
КЕШИ БАЗ ДАНИХ
ПАРАМЕТРИ
СТАТУС ВИХОДУ
ДІАГНОСТИКА
ФАЙЛИ
ДИВ. ТАКОЖ
АВТОР
ПОМИЛКИ

ІМʼЯ

mandb - створює або оновлює кеші індексу сторінок довідки

СИНОПСИС

mandb [ -dqsucpt?V ] [ -C файл ] [ шляхи_до_man ]
mandb [ -dqsut ] [ -C файл ] -f імʼя_файлу ...

ОПИС

mandb використовується для ініціалізації або ручного оновлення кешів бази даних індексі . Ці кеші містять інформацію, що стосується поточного стану системи сторінок довідки, а інформація, збережена в них, використовується утилітами man-db для покращення їхньої швидкості та функціональності.

Під час створення або оновлення індексу mandb попереджатиме про неправильні запити ROFF .so, хибні імена файлів сторінок довідки та сторінки довідки, з яких не можливо розібрати whatis .

Надання mandb необовʼязкового шляху, розділеного двокрапкою, перевизначить внутрішній системний ієрархічний шлях пошуку сторінок довідки, визначений на основі інформації, знайденої у файлі конфігурації man-db.

КЕШИ БАЗ ДАНИХ

mandb може бути скомпільовано з підтримкою будь-якого з наступних типів баз даних.

Image grohtml-586111-1.png

Ті типи баз даних, які підтримують асинхронні оновлення, забезпечують покращену швидкість за рахунок можливого пошкодження у разі незвичайного завершення. У незвичайному випадку, коли це сталося, можливо необхідно повторно запустити 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