'\" t
.\" Man page for mandb
.\"
.\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc
.TH MANDB 8 "2025-05-02" "2.13.1" "Manual pager utils"
.SH "نام (NAME)"
mandb \- ایجاد یا به‌روزرسانی کش‌های نمایه صفحات راهنما
.SH "خلاصه دستور (SYNOPSIS)"
.B mandb
.RB [\| \-dqsucpt?V \|]
.RB [\| \-C
.IR file \|]
.RI [\| manpath \|]
.br
.B mandb
.RB [\| \-dqsut \|]
.RB [\| \-C
.IR file \|]
.B \-f
.IR filename \ .\|.\|.
.SH "توضیحات (DESCRIPTION)"
.B mandb
برای مقداردهی اولیه یا به‌روزرسانی دستی کش‌های پایگاه دادهٔ
.B index
به کار می‌رود.
این کش‌ها حاوی اطلاعات مربوط به وضعیت فعلی سیستم صفحات راهنما هستند و اطلاعات ذخیره‌شده درون آن‌ها توسط ابزارهای man-db برای افزایش سرعت و بهبود کارایی استفاده می‌شود.

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

ارائه یک مسیر اختیاری جداشده با دونقطه به
.B mandb
مسیر جستجوی سلسله‌مراتبی داخلی سیستم برای صفحات راهنما را، که بر اساس اطلاعات پرونده پیکربندی man-db تعیین می‌شود، لغو و جایگزین خواهد کرد.
.SH "حافظه‌های موقت پایگاه‌داده (DATABASE CACHES)"
.B mandb
می‌تواند با پشتیبانی از هر یک از انواع پایگاه‌های دادهٔ زیر کامپایل شود.

.TS
tab (@);
l l l.
نام@ناهمگام@نام پرونده
_
Berkeley db@بله@\fIindex.bt\fR
GNU gdbm@بله@\fIindex.db\fR
UNIX ndbm@خیر@\fIindex.(dir|pag)\fR
.TE

آن دسته از انواع پایگاه‌های داده که از به‌روزرسانی‌های ناهمگام پشتیبانی می‌کنند، سرعت بیشتری را به بهای احتمال خرابی در صورت پایان غیرعادی ارائه می‌دهند.
در شرایط غیرعادی که این اتفاق رخ داده باشد، ممکن است لازم باشد
.B mandb
با گزینهٔ
.B \-c
برای ایجاد دوبارهٔ پایگاه‌های داده از ابتدا مجدداً اجرا شود.
.SH "گزینهها (OPTIONS)"
.TP
.BR \-d ", " \-\-debug
چاپ اطلاعات اشکال‌زدایی.
.TP
.BR \-q ", " \-\-quiet
عدم تولید هشدارها.
.TP
.BR \-s ", " \-\-no-straycats
صرف نکردن زمان برای جست‌وجو یا افزودن اطلاعات مربوط به صفحه‌های سرگردان (stray cats) به پایگاه‌های داده.
.TP
.BR \-p ", " \-\-no-purge
صرف نکردن زمان برای بررسی صفحه‌های راهنمای حذف‌شده و پاک‌سازی آن‌ها از پایگاه‌های داده.
.TP
.BR \-c ", " \-\-create
به‌طور پیش‌فرض،
.B mandb
تلاش می‌کند هر پایگاه‌داده‌ای را که پیش‌تر ایجاد شده است به‌روزرسانی کند.
اگر پایگاه‌داده‌ای وجود نداشته باشد، آن را ایجاد خواهد کرد.
این گزینه
.B mandb
را وادار می‌کند پایگاه‌های دادهٔ قبلی را حذف کرده و آن‌ها را از ابتدا بازسازی کند، و متضمن
.B \-\-no-purge
نیز هست.
این امر ممکن است در صورتی که پایگاه‌داده‌ای آسیب ببیند یا اگر در آینده ساختار ذخیره‌سازی پایگاه‌دادهٔ جدیدی معرفی شود، لازم باشد.
.TP
.BR \-u ", " \-\-user-db
تنها ایجاد پایگاه‌های دادهٔ کاربر، حتی با وجود دسترسی‌های نوشتن لازم برای ایجاد پایگاه‌های دادهٔ سیستم.
.TP
.BR \-t ", " \-\-test
بررسی‌های صحت را روی صفحات راهنما در مسیر جستجوی سلسله‌مراتبی انجام می‌دهد.
با این گزینه،
.B mandb
پایگاه‌های دادهٔ موجود را تغییر نخواهد داد.
.TP
.BR \-f ", " \-\-filename
تنها مدخل‌های مربوط به نام فایل داده‌شده را به‌روزرسانی می‌کند.
این گزینه برای استفادهٔ عمومی نیست؛ در صورتی که
.B man
با گزینهٔ
.B MAN_DB_UPDATES
کامپایل شده باشد و تشخیص دهد که صفحه‌ای قدیمی است، به‌طور داخلی توسط آن استفاده می‌شود.
این گزینه مستلزم
.B \-p
بوده و گزینه‌های
.B \-c
و
.BR \-s
را غیرفعال می‌کند.
.TP
.BI \-C\  file \fR,\ \fB\-\-config\-file= file
استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض
.IR \(ti/.manpath .
.TP
.BR \-? ", " \-\-help
نمایش پیام راهنمای استفاده، سپس خروج.
.TP
.B \-\-usage
چاپ یک پیام کوتاه راهنمای استفاده و خروج.
.TP
.BR \-V ", " \-\-version
نمایش نسخه، سپس خروج.
.SH "کدهای خروج (EXIT CODES)"
.TP
.B 0
اجرای موفقیت‌آمیز برنامه.
.TP
.B 1
خطای نحوهٔ استفاده، نحو یا فایل پیکربندی.
.TP
.B 2
خطای عملیاتی.
.TP
.B 3
شکست در فرآیند فرزند.
.SH "عیب‌یابی (DIAGNOSTICS)"
پیام‌های هشدار زیر ممکن است هنگام ساخت پایگاه داده صادر شوند.
.TP
.B <filename>: whatis parse for page(sec) failed
تلاش برای استخراج خط(وط) whatis از <filename> داده‌شده با شکست مواجه شد.
این مورد معمولاً به دلیل نگارش نامناسب صفحهٔ راهنما رخ می‌دهد، اما اگر پیام‌های مشابه زیادی
صادر شوند، به احتمال زیاد سیستم شامل صفحات راهنمای غیراستانداردی است
که با تجزیه‌کنندهٔ whatis در man-db ناسازگار هستند.
برای اطلاعات بیشتر به بخش
.B WHATIS PARSING
در
.BR lexgrog (1)
مراجعه کنید.
.TP
.B <filename>: is a dangling symlink
پرونده <filename> وجود ندارد اما توسط یک پیوند نمادین ارجاع داده شده است.
معمولاً هشدارهای تشخیصی بیشتری برای شناسایی <filename> پیوند معیوب صادر می‌شود.
.TP
.B <filename>: bad symlink or ROFF `.so' request
پرونده <filename> یا یک پیوند نمادین به یک فایل ناموجود است، یا شامل درخواست درج ROFF (.so) به یک فایل ناموجود می‌باشد.
.TP
.B <filename>: ignoring bogus filename
پرونده <filename> ممکن است یک صفحه راهنمای معتبر باشد یا نباشد، اما نام آن نامعتبر است.
این مورد معمولاً به دلیل قرار گرفتن یک صفحه راهنما با پسوند بخش <x> در بخش <y> صفحات راهنما رخ می‌دهد.
.TP
.B <filename_mask>: competing extensions
الگوی جانشین <filename_mask> یکتا نیست.
این حالت معمولاً ناشی از وجود هر دو نسخه فشرده‌شده و فشرده‌نشده از یک صفحه راهنما است.
همه موارد به جز جدیدترین آن‌ها نادیده گرفته می‌شوند.
.SH "فایل‌ها (FILES)"
.TP
.I /etc/man_db.conf
پرونده پیکربندی man-db.
.TP
.I /var/cache/man/index.(bt|db|dir|pag)
حافظه پنهان سراسری پایگاه‌داده
.I index
سازگار با استاندارد FHS.
.PP
مکان‌های قدیمی‌تر برای حافظه پنهان پایگاه‌داده شامل موارد زیر بودند:
.TP
.I /usr/man/index.(bt|db|dir|pag)
حافظه پنهان سنتی پایگاه‌داده سراسری
.I index .
.TP
.I /var/catman/index.(bt|db|dir|pag)
حافظه پنهان پایگاه‌داده سراسری
.I index
جایگزین یا سازگار با FSSTND.
.SH "همچنین ببینید (SEE ALSO)"
.BR lexgrog (1),
.BR man (1),
.BR manpath (5),
.BR catman (8)
.PP
بخش
.B "WHATIS PARSING"
که پیش‌تر در این صفحه راهنما قرار داشت، اکنون بخشی از
.BR lexgrog (1)
است.
.SH "نویسندگان (AUTHORS)"
.nf
Wilf.\& (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
.fi
.SH "باگها (BUGS)"
https://gitlab.com/man-db/man-db/\-/issues
.br
https://savannah.nongnu.org/bugs/?group=man\-db