.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "PKGFILE 1"
.TH PKGFILE 1 2026-08-05 "pkgfile 26" "pkgfile Manual"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
pkgfile \- کاوشگر فراداده‌های .files در alpm
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
کاربرد: \fIpkgfile\fR [عملیات] [گزینه‌ها] هدف
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور pkgfile فراداده‌های .files ایجادشده توسط \fBrepo\-add\fR(8) را برای بازیابی اطلاعات فایل‌های مربوط به بسته‌ها جستجو می‌کند. به‌طور پیش‌فرض، هدف ارائه‌شده یک نام فایل در نظر گرفته می‌شود و pkgfile بسته(هایی) را که شامل این فایل هستند برمی‌گرداند. مخازنی که pkgfile در آن‌ها جستجو می‌کند، توسط مخازن فعال‌شده در
\&\fI/etc/pacman.conf\fR
تعیین می‌شوند.
.SH "عملیات‌ها (OPERATIONS)"
.IX Header "عملیات‌ها (OPERATIONS)"
.IP "\fB\-l\fR, \fB\-\-list\fR" 4
.IX Item "-l, --list"
هدف به‌جای نام فایل، یک نام بسته در نظر گرفته می‌شود و محتویات بسته مشخص‌شده بازگردانده می‌شود. این کار امکان استفاده از ساختار repo/package (مانند "core/pacman") را برای محدود کردن دامنه جستجو فراهم می‌کند، اما فقط زمانی که
\&\fB\-\-list\fR
بدون گزینه‌های
\&\fB\-\-glob\fR
یا
\&\fB\-\-regex\fR
استفاده شود.
.IP "\fB\-s\fR, \fB\-\-search\fR" 4
.IX Item "-s, --search"
جستجو برای بسته‌هایی که شامل هدف ارائه‌شده هستند. این حالت پیش‌فرض عملیات است.
.IP "\fB\-u\fR, \fB\-\-update\fR" 4
.IX Item "-u, --update"
به‌روزرسانی فایل‌های فراداده ذخیره‌شده. توصیه می‌شود یک کران‌جاب (cron job) روزانه با این دستور ایجاد کنید تا از نتایج دقیق اطمینان حاصل شود. به‌طور پیش‌فرض، تنها مخازنی بارگیری می‌شوند که نسخه جدیدتری از آن‌ها در آینه (mirror) یافت شود. این گزینه را دو بار ارسال کنید تا بارگیری مجدد تمامی مخازن اجبار شود.
.SH "تطبیق (MATCHING)"
.IX Header "تطبیق (MATCHING)"
.IP "\fB\-b\fR, \fB\-\-binaries\fR" 4
.IX Item "-b, --binaries"
تنها فایل‌هایی را برمی‌گرداند که در یک دایرکتوری bin یا sbin قرار دارند.
.IP "\fB\-d\fR, \fB\-\-directories\fR" 4
.IX Item "-d, --directories"
علاوه بر این، دایرکتوری‌ها را نیز در نتایج جستجو لحاظ می‌کند.
.IP "\fB\-g\fR, \fB\-\-glob\fR" 4
.IX Item "-g, --glob"
فعال‌سازی تطبیق الگوی glob به سبک شل. \fBglob\fR(7) را ببینید. توجه داشته باشید که نویسه‌های عام شل (wildcards) مانند \fI*\fR و \fI?\fR هرگز با جداکننده‌های مسیر تطبیق داده نمی‌شوند. بنابراین، این نوع تطبیق برای جستجوی ورودی‌ها درون دایرکتوری‌ها مفید است، مانند \fI/usr/bin/*\fR.
.IP "\fB\-i\fR, \fB\-\-ignorecase\fR" 4
.IX Item "-i, --ignorecase"
غیرفعال‌سازی حساسیت به حروف بزرگ و کوچک در تطبیق.
.IP "\fB\-r\fR, \fB\-\-regex\fR" 4
.IX Item "-r, --regex"
فعال‌سازی تطبیق عبارت باقاعده. \fBpcre\fR(3) را ببینید.
.IP "\fB\-R\fR \fIREPO\fR, \fB\-\-repo=\fR\fIREPO\fR" 4
.IX Item "-R REPO, --repo=REPO"
جستجو تنها در مخزن مشخص‌شده.
.SH "خروجی (OUTPUT)"
.IX Header "خروجی (OUTPUT)"
.IP "\fB\-0\fR, \fB\-\-null\fR" 4
.IX Item "-0, --null"
جداسازی خروجی با بایت‌های تهی (null) به‌جای نویسه‌های خط جدید.
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 4
.IX Item "-q, --quiet"
خروجی کمتر. این گزینه برای عملیات \fB\-\-list\fR اعمال می‌شود.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
خروجی بیشتر. این گزینه برای عملیات \fB\-\-search\fR اعمال می‌شود.
.IP "\fB\-w\fR, \fB\-\-raw\fR" 4
.IX Item "-w, --raw"
جلوگیری از تراز کردن (justification) خروجی دو ستونی.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.IX Header "گزینه‌های عمومی (GENERAL OPTIONS)"
.IP "\fB\-C\fR \fIFILE\fR, \fB\-\-config=\fR\fIFILE\fR" 4
.IX Item "-C FILE, --config=FILE"
استفاده از یک فایل پیکربندی دیگر به‌جای فایل پیش‌فرض
\&\fI/etc/pacman.conf\fR.
.IP "\fB\-D\fR \fIDIRECTORY\fR, \fB\-\-cachedir=\fR\fIDIRECTORY\fR" 4
.IX Item "-D DIRECTORY, --cachedir=DIRECTORY"
استفاده از یک مسیر حافظه موقت (cache) دیگر به‌جای پیش‌فرض زمان کامپایل.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
نمایش راهنما و خروج.
.IP "\fB\-V\fR, \fB\-\-version\fR" 4
.IX Item "-V, --version"
نمایش نسخه و خروج.
.SH "روش‌های تطبیق (MATCHING HEURISTICS)"
.IX Header "روش‌های تطبیق (MATCHING HEURISTICS)"
در حالت \-\-search و بدون گزینه \-\-regex یا \-\-glob، دستور pkgfile تلاش می‌کند تا هدف ارائه‌شده را به‌عنوان یک نام فایل دقیق تطبیق دهد. اگر هدف حاوی نویسه \*(Aq/\*(Aq باشد، تطبیق با کل مسیر امتحان خواهد شد. با فعال بودن جستجوی \-\-regex و \-\-glob، دستور pkgfile همیشه تطبیق را بر اساس کل نام مسیر انجام می‌دهد.
.PP
در حالت \-\-list و بدون گزینه \-\-regex یا \-\-glob، دستور pkgfile تلاش می‌کند تا هدف ارائه‌شده را به‌عنوان یک نام بسته دقیق تطبیق دهد. اگر هدف حاوی نویسه \*(Aq/\*(Aq باشد، متن پیش از اسلش به‌عنوان یک مخزن در نظر گرفته شده و جستجو محدود خواهد شد.
.SH "قلاب‌های دستور یافت نشد (COMMAND NOT FOUND HOOKS)"
.IX Header "قلاب‌های دستور یافت نشد (COMMAND NOT FOUND HOOKS)"
.IP \fI/usr/share/doc/pkgfile/command\-not\-found.bash\fR 4
.IX Item "/usr/share/doc/pkgfile/command-not-found.bash"
.PD 0
.IP \fI/usr/share/doc/pkgfile/command\-not\-found.zsh\fR 4
.IX Item "/usr/share/doc/pkgfile/command-not-found.zsh"
.IP \fI/usr/share/doc/pkgfile/command\-not\-found.fish\fR 4
.IX Item "/usr/share/doc/pkgfile/command-not-found.fish"
.PD
توابع سازگار با zsh، bash و fish که می‌توان آن‌ها را در راه‌اندازی شل گنجاند تا هنگام یافت نشدن یک دستور اجراشده، pkgfile را اجرا کنند.
.Sp
اگر متغیر محیطی PKGFILE_PROMPT_INSTALL_MISSING تنظیم شده باشد و تنها یک بسته پیدا شود، پیامی برای نصب بسته نمایش داده خواهد شد. \fBنکته\fR: این قابلیت نیازمند برنامه \fBsudo\fR(8) است و در حال حاضر فقط توسط پیاده‌سازی‌های bash و zsh پشتیبانی می‌شود.
.SH "به‌روزرسانی خودکار (AUTOMATING UPDATES)"
.IX Header "به‌روزرسانی خودکار (AUTOMATING UPDATES)"
توصیه می‌شود از \fBpkgfiled\fR(1) برای به‌روز نگه‌داشتن پایگاه‌های داده .files همگام با اجرای \`pacman \-Fy\` (چه توسط کاربر یا یک تایمر systemd/کران‌جاب) استفاده کنید. سرویس pkgfiled می‌تواند با دستور زیر فعال شود:
.PP
.Vb 1
\&  systemctl enable \-\-now pkgfiled
.Ve
.PP
همچنین، pkgfile شامل تایمر و واحدهای سرویس systemd برای خودکارسازی به‌روزرسانی‌های دوره‌ای پایگاه‌های داده .files است. با فرض اینکه pkgfile با پشتیبانی از systemd کامپایل شده باشد، این قابلیت می‌تواند با دستور زیر فعال شود:
.PP
.Vb 1
\&  systemctl enable \-\-now pkgfile\-update.timer
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBpkgfiled\fR(1)، \fBrepo\-add\fR(8)، \fBpcre\fR(3)، \fBglob\fR(7)، \fBpacman.conf\fR(5)
.SH "نویسنده (AUTHOR)"
.IX Header "نویسنده (AUTHOR)"
Dave Reisner <d@falconindy.com>