.\" A man page for updatedb(8). -*- 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 8 "Dec 2020" plocate

.SH "نام (NAME)"
updatedb \- به‌روزرسانی پایگاه‌داده برای plocate

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

\fBupdatedb\fR [\fIگزینه‌ها\fR]...

.SH "توضیحات (DESCRIPTION)"
دستور
.B updatedb
پایگاه‌داده‌ای را ایجاد یا به‌روزرسانی می‌کند که توسط
.BR locate (1)
استفاده می‌شود.
اگر پایگاه‌داده از قبل موجود باشد،
از داده‌های آن مجدداً استفاده می‌شود
تا از خواندن دوباره دایرکتوری‌هایی که تغییر نکرده‌اند جلوگیری شود.

دستور
.B updatedb
معمولاً روزانه از طریق یک
.BR systemd.timer (8)
برای به‌روزرسانی پایگاه‌داده پیش‌فرض اجرا می‌شود.

.SH "وضعیت خروج (EXIT STATUS)"
.B updatedb
در صورت موفقیت با وضعیت خروج ۰ و در صورت بروز خطا با ۱ بازمی‌گردد.

.SH "گزینه‌ها (OPTIONS)"
متغیرهای \fBPRUNE_BIND_MOUNTS\fR، \fBPRUNEFS\fR،
.B PRUNENAMES
و
.B PRUNEPATHS
که توسط برخی از گزینه‌ها تغییر می‌یابند، با جزئیات کامل در
.BR updatedb.conf (5)
مستند شده‌اند.

.TP
\fB\-f\fR, \fB\-\-add-prunefs\fR \fIFS\fR
مواردی از فهرست جداشده با فاصله‌ی \fIFS\fR را به \fBPRUNEFS\fR اضافه می‌کند.

.TP
\fB\-n\fR, \fB\-\-add-prunenames\fR \fINAMES\fR
مواردی از فهرست جداشده با فاصله‌ی \fINAMES\fR را به \fBPRUNENAMES\fR اضافه می‌کند.

.TP
\fB\-e\fR, \fB\-\-add-prunepaths\fR \fIPATHS\fR
مواردی از فهرست جداشده با فاصله‌ی \fIPATHS\fR را به \fBPRUNEPATHS\fR اضافه می‌کند.

.TP
\fB\-\-add-single-prunepath\fR \fIPATH\fR
مسیر \fIPATH\fR را به \fBPRUNEPATHS\fR اضافه می‌کند. توجه داشته باشید که در حال حاضر این تنها راه برای افزودن مسیری است که شامل فاصله باشد.

.TP
\fB\-U\fR, \fB\-\-database\-root\fR \fIPATH\fR
تنها نتایج پویش زیردرخت سیستم‌فایلی با ریشه \fIPATH\fR را در پایگاه‌داده تولیدشده ذخیره می‌کند.
به‌طور پیش‌فرض کل سیستم‌فایل پویش می‌شود.

دستور
.BR locate (1)
بدون در نظر گرفتن قالب \fIPATH\fR،
ورودی‌ها را به‌صورت نام‌های مسیر مطلق که حاوی پیوندهای نمادین نیستند خروجی می‌دهد.

.TP
\fB\-\-debug\-pruning\fR
اطلاعات اشکال‌زدایی درباره تصمیمات هرس کردن (pruning) را در خروجی خطای استاندارد می‌نویسد.

.TP
\fB\-h\fR, \fB\-\-help\fR
خلاصه‌ای از گزینه‌های موجود را در خروجی استاندارد می‌نویسد
و با موفقیت خارج می‌شود.

.TP
\fB\-o\fR, \fB\-\-output\fR \fIFILE\fR
پایگاه‌داده را به‌جای استفاده از پایگاه‌داده پیش‌فرض، در
.I FILE
می‌نویسد.

.TP
\fB\-\-config-file\fR \fIFILE\fR
پیکربندی را به‌جای فایل پیکربندی پیش‌فرض، از \fIFILE\fR می‌خواند.
گزینه‌های خط فرمان همچنان تنظیمات این فایل را بازنویسی می‌کنند.

برای اطلاع از قالب فایل پیکربندی به
.BR updatedb.conf (5)
مراجعه کنید.

.TP
\fB\-\-prune\-bind\-mounts\fR \fIFLAG\fR
مقدار
.B PRUNE_BIND_MOUNTS
را برابر با \fIFLAG\fR تنظیم می‌کند و تنظیمات فایل پیکربندی را نادیده می‌گیرد.

.TP
\fB\-\-prunefs\fR \fIFS\fR
مقدار \fBPRUNEFS\fR را برابر با \fIFS\fR تنظیم می‌کند و تنظیمات فایل پیکربندی را نادیده می‌گیرد.

.TP
\fB\-\-prunenames\fR \fINAMES\fR
مقدار \fBPRUNENAMES\fR را برابر با \fINAMES\fR تنظیم می‌کند و تنظیمات فایل پیکربندی را نادیده می‌گیرد.

.TP
\fB\-\-prunepaths\fR \fIPATHS\fR
مقدار \fBPRUNEPATHS\fR را برابر با \fIPATHS\fR تنظیم می‌کند و تنظیمات فایل پیکربندی را نادیده می‌گیرد.

.TP
\fB\-l\fR, \fB\-\-require\-visibility\fR \fIFLAG\fR
فلگ \*(lqنیاز به رویت‌پذیری فایل قبل از گزارش آن\*(rq را در پایگاه‌داده تولیدشده بر روی \fIFLAG\fR تنظیم می‌کند.

اگر
.I FLAG
برابر با
.B 0
یا \fBno\fR باشد،
یا اگر فایل پایگاه‌داده توسط «دیگران» قابل خواندن باشد
یا مالکیت آن متعلق به \fBlocate\fR نباشد،
دستور
.BR locate (1)
ورودی‌های پایگاه‌داده را نمایش می‌دهد، حتی اگر کاربری که
.BR locate (1)
را اجرا می‌کند، امکان خواندن دایرکتوری لازم برای یافتن فایل توصیف‌شده توسط ورودی پایگاه‌داده را نداشته باشد.

اگر
.I FLAG
برابر با
.B 1
یا
.B yes
(پیش‌فرض) باشد،
دستور
.BR locate (1)
مجوزهای دایرکتوری‌های والد هر ورودی را قبل از گزارش آن به کاربر فراخوان بررسی می‌کند.
برای اینکه وجود فایل واقعاً از دید سایر کاربران مخفی بماند، گروه پایگاه‌داده روی
.B locate
تنظیم شده و مجوزهای پایگاه‌داده، خواندن آن را برای کاربرانی که از روشی غیر از
.BR locate (1)
(که دارای پرچم set-gid \fBlocate\fR است) استفاده می‌کنند، ممنوع می‌سازد.

توجه داشته باشید که فلگ رویت‌پذیری تنها در صورتی بررسی می‌شود که مالک پایگاه‌داده
.B locate
باشد و برای «دیگران» قابل خواندن نباشد.

.TP
\fB\-v\fR, \fB\-\-verbose\fR
نام مسیر فایل‌ها را به محض پیدا شدن در خروجی استاندارد می‌نویسد.

.TP
\fB\-V\fR, \fB\-\-version\fR
اطلاعات مربوط به نسخه و مجوز
.B locate
را در خروجی استاندارد نوشته و با موفقیت خارج می‌شود.

.SH "مثال‌ها (EXAMPLES)"
برای ایجاد یک پایگاه‌داده اختصاصی plocate توسط کاربری غیر از \fBroot\fR،
دستور زیر را اجرا کنید:
.RS
.B updatedb \-l 0 \-o
.I db_file
.B \-U
.I source_directory
.RE
توجه داشته باشید تمام کاربرانی که می‌توانند
.I db_file
را بخوانند، می‌توانند فهرست کاملی از فایل‌های موجود در زیردرخت \fIsource_directory\fR را دریافت کنند.

.SH "فایل‌ها (FILES)"
.TP
\fB/etc/updatedb.conf\fR
فایل پیکربندی پیش‌فرض. به
.BR updatedb.conf (5)
مراجعه کنید.
دقیقاً از همان قالبی استفاده می‌کند که توسط updatedb در
.BR mlocate (1)
استفاده می‌شود، بنابراین می‌توانند با یکدیگر به اشتراک گذاشته شوند.

.TP
\fB/var/lib/plocate/plocate.db\fR
پایگاه‌داده‌ای که به‌طور پیش‌فرض به‌روزرسانی می‌شود.

.SH "امنیت (SECURITY)"
پایگاه‌های داده‌ای که با
.B \-\-require\-visibility no
ساخته می‌شوند، به کاربران اجازه می‌دهند نام فایل‌ها و دایرکتوری‌های سایر کاربران را پیدا کنند؛
کاری که در غیر این صورت قادر به انجام آن نبودند.

.SH "نویسندگان (AUTHORS)"
Miloslav Trmac <mitr@redhat.com>
.P
Steinar H. Gunderson <steinar+plocate@gunderson.no>

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