.\" A man page for updatedb.conf. -*- nroff -*-
.\"
.\" Copyright (C) 2005, 2007, 2008 Red Hat, Inc. All rights reserved.
.\"
.\" This copyrighted material is made available to anyone wishing to use,
.\" modify, copy, or redistribute it subject to the terms and conditions of the
.\" GNU General Public License v.2.
.\"
.\" This program is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 
.\" more details.
.\"
.\" You should have received a copy of the GNU General Public License along
.\" with this program; if not, write to the Free Software Foundation, Inc.,
.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\"
.\" Author: Miloslav Trmac <mitr@redhat.com>
.TH updatedb.conf 5 "Oct 2020" plocate

.SH "نام (NAME)"
/etc/updatedb.conf \- فایل پیکربندی برای updatedb(8)

.SH "توضیحات (DESCRIPTION)"
فایل
.B /etc/updatedb.conf
یک فایل متنی است.
خطوط خالی نادیده گرفته می‌شوند.
نویسهٔ
.B #
خارج از یک رشتهٔ درون نقل‌قول، آغازگر توضیحی است که تا انتهای خط ادامه می‌یابد.

سایر خطوط باید به شکل زیر باشند:
.RS
.I VARIABLE
.B =
\fB"\fIVALUE\fB"\fR
.RE

فاصله‌های خالی بین عناصر نادیده گرفته می‌شوند.
.I VARIABLE
یک رشتهٔ الفبایی-عددی است که با رقم آغاز نمی‌شود.
.I VALUE
می‌تواند شامل هر نویسه‌ای به‌جز \fB\(dq\fR باشد.
هیچ سازوکار گریزی (Escape) درون
.I VALUE
پشتیبانی نمی‌شود و هیچ راهی برای نوشتن
.I VALUE
در بیش از یک خط وجود ندارد.

مقادیر ناشناخته برای
.I VARIABLE
خطا محسوب می‌شوند.
متغیرهای تعریف‌شده عبارتند از:

.TP
\fBPRUNEFS\fR
فهرستی از انواع سیستم‌های فایل (مطابق آنچه در \fB/etc/mtab\fR استفاده می‌شود) که با فاصله از هم جدا شده‌اند و نباید توسط
.BR updatedb (8)
پویش شوند.
تطابق نوع سیستم فایل به بزرگی و کوچکی حروف حساس نیست. به‌طور پیش‌فرض، هیچ نوع سیستم فایلی نادیده گرفته نمی‌شود.

هنگامی که پویش یک سیستم فایل نادیده گرفته می‌شود،
تمامی سیستم‌های فایل سوارشده در زیرشاخهٔ آن نیز نادیده گرفته می‌شوند،
حتی اگر نوع آن‌ها با هیچ مدخلی در \fBPRUNEFS\fR مطابقت نداشته باشد.

.TP
\fBPRUNENAMES\fR
فهرستی از نام پوشه‌ها (بدون مسیر) که با فاصله از هم جدا شده‌اند و نباید توسط
.BR updatedb (8)
پویش شوند.
به‌طور پیش‌فرض، هیچ نام پوشه‌ای نادیده گرفته نمی‌شود.

توجه داشته باشید که تنها پوشه‌ها را می‌توان مشخص کرد و هیچ سازوکار الگویی (مانند globbing) استفاده نمی‌شود.

.TP
\fBPRUNEPATHS\fR
فهرستی از مسیرهای پوشه‌هایی که با فاصله از هم جدا شده‌اند و نباید توسط
.BR updatedb (8)
پویش شوند.
هر مسیر باید دقیقاً به همان شکلی باشد که پوشه توسط
.BR locate (1)
گزارش می‌شود.

به‌طور پیش‌فرض، هیچ مسیری نادیده گرفته نمی‌شود.

.TP
\fBPRUNE_BIND_MOUNTS\fR
یکی از رشته‌های \fB0\fR، \fBno\fR، \fB1\fR یا \fByes\fR.
اگر
.B PRUNE_BIND_MOUNTS
برابر با \fB1\fR یا \fByes\fR باشد،
نقاط سوارشدن متصل (Bind mounts) توسط
.BR updatedb (8)
پویش نمی‌شوند.
تمامی سیستم‌های فایل سوارشده در زیرشاخهٔ یک bind mount نیز نادیده گرفته می‌شوند،
حتی اگر خودشان bind mount نباشند.
به‌عنوان یک استثنا، bind mount یک پوشه روی خودش نادیده گرفته نمی‌شود.
توجه داشته باشید که زیرحجم‌های (Subvolumes) Btrfs در داخل هسته به‌صورت bind mount مدیریت می‌شوند (ببینید:
.BR btrfs-subvolume (8))،
و بنابراین در صورتی که ریشهٔ سیستم فایل را نیز سوار کرده باشید، ممکن است نادیده گرفته شوند.
برای خنثی کردن این مورد، پوشهٔ ریشهٔ خود را نیز به یک زیرحجم Btrfs تبدیل کنید.

به‌طور پیش‌فرض، bind mountها نادیده گرفته نمی‌شوند.

.SH "نکات (NOTES)"
هنگامی که یک پوشه با \fBPRUNEFS\fR، \fBPRUNENAMES\fR یا
\fBPRUNEPATHS\fR
تطبیق داده شود،
.BR updatedb (8)
محتویات آن پوشه را پویش نمی‌کند.
با این حال، مسیر خود پوشه در پایگاه دادهٔ ایجادشده وارد می‌شود.
برای مثال، اگر
.I /tmp
در \fBPRUNEPATHS\fR باشد،
.BR locate (1)
هیچ‌یک از فایل‌های ذخیره‌شده در \fI/tmp\fR را نشان نخواهد داد،
اما می‌تواند خود پوشهٔ
.I /tmp
را نمایش دهد.
این رفتار با پیاده‌سازی‌های سنتی
.B locate
متفاوت است.

در برخی از پیاده‌سازی‌های
.BR updatedb (8)
می‌توان از \fBPRUNEPATHS\fR برای مستثنی کردن فایل‌های غیرپوشه نیز استفاده کرد.
در این پیاده‌سازی چنین قابلیتی وجود ندارد.

فایل
.B /etc/updatedb.conf
در برخی پیاده‌سازی‌ها یک اسکریپت شل است
که انعطاف‌پذیری بسیار بیشتری در تعریف متغیرها فراهم می‌کند.
عملکرد معادل را می‌توان با استفاده از گزینه‌های خط فرمان
.BR updatedb (8)
به دست آورد.

.SH "نویسندگان (AUTHORS)"
Miloslav Trmac <mitr@redhat.com>

.SH "همچنین ببینید (SEE ALSO)"
.BR locate (1),
.BR updatedb (8)