.TH plocate\-build 8 "Oct 2020" plocate\-build
.SH "نام (NAME)"
plocate\-build \- ایجاد نمایه برای plocate

.SH "خلاصه دستور (SYNOPSIS)"
.B plocate-build
.I "[OPTION]..."
.I "MLOCATE_DB"
.I "PLOCATE_DB"

.SH "توضیحات (DESCRIPTION)"
دستور
.B plocate\-build
یک نمایه برای
.BR plocate (1)
از روی نمایه‌ای که پیش‌تر توسط
.BR updatedb (8)
از بستهٔ
.BR mlocate (1)
ایجاد شده است، تولید می‌کند. بیشتر کاربران ترجیح می‌دهند از
.BR updatedb (8)
مخصوص خود plocate استفاده کنند که مستقیم‌تر است.
اگر
.I PLOCATE_DB
از قبل وجود داشته باشد، (به‌صورت غیراتمیک) بازنویسی خواهد شد. این فایل به‌گونه‌ای ساخته می‌شود که برای همه کاربران قابل خواندن نباشد (world-readable نباشد)، زیرا بررسی نهایی دسترسی هنگام جستجو توسط
.BR plocate (1)
انجام می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-block\-size\fR \fISIZE\fR
ایجاد بلوک‌هایی که هرکدام شامل
.I SIZE
نام فایل هستند، فشرده‌سازی آن‌ها با یکدیگر، و در نظر گرفتن آن‌ها به عنوان یک عنصر یکسان در فهرست‌های ارسال (posting lists). این کار نمایه را کوچک‌تر می‌سازد (زیرا الگوریتم فشرده‌سازی بافت متنی بیشتری در اختیار دارد و عناصر کمتری در هر فهرست ارسال قرار می‌گیرند)، اما دقت فهرست‌های ارسال را نیز کاهش می‌دهد و بار کاری بیشتری را برای حذف موارد مثبت کاذب پس از اشتراک فهرست‌های ارسال ایجاد می‌کند.

بزرگ‌تر کردن این عدد، جستجوی خطی را (برای \fB\-\-regex\fR یا الگوهای بسیار کوتاه) سریع‌تر خواهد کرد، البته با کاهش بازده در حدود ۲۵۶ نام فایل در هر بلوک. با این حال، بیش از حد بزرگ کردن آن منجر به افزایش موارد مثبت کاذب شده و کارایی کلی را برای پرس‌وجوهای معمول کاهش می‌دهد. مقدار پیش‌فرض ۳۲ است. تنظیم آن روی ۱ یک بلوک (فشرده‌شده) به ازای هر نام فایل ایجاد می‌کند.

.TP
\fB\-p\fR, \fB\-\-plaintext\fR
ورودی را به جای یک پایگاه داده mlocate، به عنوان متن ساده (plain text) با ورودی‌های جداشده توسط خط جدید در نظر می‌گیرد.

.TP
\fB\-l\fR, \fB\-\-require\-visibility\fR \fIFLAG\fR
پرچم \*(lqrequire file visibility before reporting it\*(rq (الزام مشاهده‌پذیری فایل پیش از گزارش آن) را در پایگاه دادهٔ تولیدشده بر روی \fIFLAG\fR تنظیم می‌کند. مقدار پیش‌فرض yes است، حتی برای یک پایگاه دادهٔ mlocate که این پرچم در آن در اصل بر روی no تنظیم شده باشد (اگرچه ممکن است این مورد در آینده تغییر کند).

.TP
.B \-\-help
چاپ اطلاعات نحوه استفاده و سپس خروج موفقیت‌آمیز.

.TP
.B \-\-version
چاپ اطلاعات نسخه و سپس خروج موفقیت‌آمیز.

.SH "نویسنده (AUTHOR)"
Steinar H. Gunderson <steinar+plocate@gunderson.no>

.SH "همچنین ببینید (SEE ALSO)"
\fBplocate\fP(1),
\fB/etc/cron.daily/plocate\fR (که در توزیع کد منبع
\fBupdate\-plocate.sh\fR نامیده می‌شود)