نام (NAME)

mandb - ایجاد یا به‌روزرسانی کش‌های نمایه صفحات راهنما

خلاصه دستور (SYNOPSIS)

mandb [-dqsucpt?V] [-C file] [manpath]
mandb [-dqsut] [-C file] -f filename ...

توضیحات (DESCRIPTION)

mandb برای مقداردهی اولیه یا به‌روزرسانی دستی کش‌های پایگاه دادهٔ index به کار می‌رود. این کش‌ها حاوی اطلاعات مربوط به وضعیت فعلی سیستم صفحات راهنما هستند و اطلاعات ذخیره‌شده درون آن‌ها توسط ابزارهای man-db برای افزایش سرعت و بهبود کارایی استفاده می‌شود.

هنگام ایجاد یا به‌روزرسانی یک index، mandb دربارهٔ درخواست‌های نادرست .so در ROFF، نام پرونده‌های نامعتبر صفحات راهنما و صفحات راهنمایی که whatis آن‌ها قابل تجزیه نیست، هشدار خواهد داد.

ارائه یک مسیر اختیاری جداشده با دونقطه به mandb مسیر جستجوی سلسله‌مراتبی داخلی سیستم برای صفحات راهنما را، که بر اساس اطلاعات پرونده پیکربندی man-db تعیین می‌شود، لغو و جایگزین خواهد کرد.

حافظه‌های موقت پایگاه‌داده (DATABASE CACHES)

mandb می‌تواند با پشتیبانی از هر یک از انواع پایگاه‌های دادهٔ زیر کامپایل شود.

نام	ناهمگام	نام پرونده
Berkeley db	بله	index.bt
GNU gdbm	بله	index.db
UNIX ndbm	خیر	index.(dir\|pag)

آن دسته از انواع پایگاه‌های داده که از به‌روزرسانی‌های ناهمگام پشتیبانی می‌کنند، سرعت بیشتری را به بهای احتمال خرابی در صورت پایان غیرعادی ارائه می‌دهند. در شرایط غیرعادی که این اتفاق رخ داده باشد، ممکن است لازم باشد mandb با گزینهٔ -c برای ایجاد دوبارهٔ پایگاه‌های داده از ابتدا مجدداً اجرا شود.

گزینهها (OPTIONS)

-d, --debug: چاپ اطلاعات اشکال‌زدایی.
-q, --quiet: عدم تولید هشدارها.
-s, --no-straycats: صرف نکردن زمان برای جست‌وجو یا افزودن اطلاعات مربوط به صفحه‌های سرگردان (stray cats) به پایگاه‌های داده.
-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 file, --config-file=file: استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض ~/.manpath.
-?, --help: نمایش پیام راهنمای استفاده، سپس خروج.
--usage: چاپ یک پیام کوتاه راهنمای استفاده و خروج.
-V, --version: نمایش نسخه، سپس خروج.

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز برنامه.
1: خطای نحوهٔ استفاده، نحو یا فایل پیکربندی.
2: خطای عملیاتی.
3: شکست در فرآیند فرزند.

عیب‌یابی (DIAGNOSTICS)

پیام‌های هشدار زیر ممکن است هنگام ساخت پایگاه داده صادر شوند.

<filename>: whatis parse for page(sec) failed: تلاش برای استخراج خط(وط) whatis از <filename> داده‌شده با شکست مواجه شد. این مورد معمولاً به دلیل نگارش نامناسب صفحهٔ راهنما رخ می‌دهد، اما اگر پیام‌های مشابه زیادی صادر شوند، به احتمال زیاد سیستم شامل صفحات راهنمای غیراستانداردی است که با تجزیه‌کنندهٔ whatis در man-db ناسازگار هستند. برای اطلاعات بیشتر به بخش WHATIS PARSING در lexgrog(1) مراجعه کنید.
<filename>: is a dangling symlink: پرونده <filename> وجود ندارد اما توسط یک پیوند نمادین ارجاع داده شده است. معمولاً هشدارهای تشخیصی بیشتری برای شناسایی <filename> پیوند معیوب صادر می‌شود.
<filename>: bad symlink or ROFF `.so' request: پرونده <filename> یا یک پیوند نمادین به یک فایل ناموجود است، یا شامل درخواست درج ROFF (.so) به یک فایل ناموجود می‌باشد.
<filename>: ignoring bogus filename: پرونده <filename> ممکن است یک صفحه راهنمای معتبر باشد یا نباشد، اما نام آن نامعتبر است. این مورد معمولاً به دلیل قرار گرفتن یک صفحه راهنما با پسوند بخش <x> در بخش <y> صفحات راهنما رخ می‌دهد.
<filename_mask>: competing extensions: الگوی جانشین <filename_mask> یکتا نیست. این حالت معمولاً ناشی از وجود هر دو نسخه فشرده‌شده و فشرده‌نشده از یک صفحه راهنما است. همه موارد به جز جدیدترین آن‌ها نادیده گرفته می‌شوند.

فایل‌ها (FILES)

/etc/man_db.conf: پرونده پیکربندی man-db.
/var/cache/man/index.(bt|db|dir|pag): حافظه پنهان سراسری پایگاه‌داده index سازگار با استاندارد FHS.

مکان‌های قدیمی‌تر برای حافظه پنهان پایگاه‌داده شامل موارد زیر بودند:

/usr/man/index.(bt|db|dir|pag): حافظه پنهان سنتی پایگاه‌داده سراسری index .
/var/catman/index.(bt|db|dir|pag): حافظه پنهان پایگاه‌داده سراسری index جایگزین یا سازگار با FSSTND.

همچنین ببینید (SEE ALSO)

lexgrog(1), man(1), manpath(5), catman(8)

بخش WHATIS PARSING که پیش‌تر در این صفحه راهنما قرار داشت، اکنون بخشی از lexgrog(1) است.

نویسندگان (AUTHORS)

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

باگها (BUGS)

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db