.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk\-query" "8" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk-query \- پرس‌وجو از اطلاعات بسته در پایگاه داده apk
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBapk query\fR [<\fIoptions\fR>.\&.\&.\&] \fIquery\fR.\&.\&.\&
.PP
\fBapk query\fR [<\fIoptions\fR>.\&.\&.\&] \fB\-\-recursive\fR \fIconstraints\fR.\&.\&.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBapk query\fR بسته‌های منطبق را در منابع انتخاب‌شده جستجو می‌کند.\&
.PP
در حالت پیش‌فرض، مشخص‌کننده‌های \fIquery\fR به این صورت تفسیر می‌شوند:
.RS 4
\fBname{[<>\(ti=]version}\fR
.RS 4
انتخاب بسته‌ها بر اساس \fBname\fR و تطابق اختیاری \fBversion\fR.\&
.RE
\fBtext\fR
.RS 4
انتخاب بسته‌ها بر اساس تطابق فیلدهای انتخاب‌شده با \fBtext\fR.\&
.PP
.RE
.RE
در حالت \fB\-\-recursive\fR، مقدار \fIconstraints\fR فهرستی از وابستگی‌ها را برای برآورده شدن مشخص می‌کند و از الگوریتم حل‌کننده (solver) برای تعیین فهرستی از بسته‌ها که این محدودیت‌ها را برآورده می‌کنند استفاده می‌شود.\&
.PP
پرس‌وجو در مراحل زیر اجرا می‌شود:
.PD 0
.IP 1. 4
هر رشته \fIquery\fR به طور مستقل برای انتخاب بسته‌های کاندید اجرا می‌شود
.IP 2. 4
اگر \fB\-\-all\-matches\fR مشخص نشده باشد، بهترین کاندید برای عبارت داده‌شده به فهرست بسته‌های نتیجه اضافه می‌شود
.IP 3. 4
فهرست بسته‌های حاصل مرتب‌سازی می‌شود
.PD
.PP
.SH "گزینه‌های پرس‌وجو (QUERY OPTIONS)"
.PP
اپلت‌هایی که از مشخص‌کننده‌های پرس‌وجو پشتیبانی می‌کنند گزینه‌های زیر را می‌شناسند:
.PP
\fB\-\-all\-matches\fR
.RS 4
انتخاب تمام بسته‌های منطبق.\& به طور پیش‌فرض فقط بهترین تطابق برای هر عنصر پرس‌وجو انتخاب می‌شود.\&
.PP
.RE
\fB\-\-available\fR
.RS 4
فیلتر کردن انتخاب به بسته‌های موجود و در دسترس.\&
.PP
.RE
\fB\-\-fields\fR \fIFIELDS\fR[:\fIREVERSE_FIELD\fR]
.RS 4
فهرستی جداشده با کاما از فیلدها برای گنجاندن در خروجی.\& یک مشخصه اختیاری برای تعیین فیلد خروجی جهت فیلدهای وابستگی معکوس ساختگی (synthetic reverse dependency) را می‌توان تعیین کرد (\fBname\fR، \fBpackage\fR یا \fBorigin\fR).\&
.PP
.RE
\fB\-\-format\fR \fIFORMATSPEC\fR
.RS 4
تعیین قالب خروجی از میان \fBdefault\fR، \fByaml\fR یا \fBjson\fR.\& قالب \fBdefault\fR خروجی متنی خوانا برای انسان است.\&
.PP
.RE
\fB\-\-from\fR \fIFROMSPEC\fR
.RS 4
جستجوی بسته‌ها از: \fBsystem\fR (همه منابع سیستمی)، \fBrepositories\fR (به جز پایگاه داده نصب‌شده)، \fBinstalled\fR (به جز مخازن معمولی) یا \fBnone\fR (فقط مخازن خط فرمان).\&
.PP
.RE
\fB\-\-installed\fR
.RS 4
فیلتر کردن انتخاب به بسته‌های نصب‌شده.\&
.PP
.RE
\fB\-\-match\fR \fIFIELDS\fR
.RS 4
فهرستی جداشده با کاما از فیلدها برای تطابق پرس‌وجو با آن‌ها.\&
.PP
.RE
\fB\-\-recursive\fR
.RS 4
اجرای الگوریتم حل‌کننده با \fIconstraints\fR مشخص‌شده برای انتخاب بسته‌ها.\&
.PP
.RE
\fB\-\-summarize\fR \fIFIELD\fR[:\fIREVERSE_FIELD\fR]
.RS 4
تولید خلاصه‌ای از فیلد مشخص‌شده از تمام موارد منطبق.\& خلاصه برای فیلدهای زیر در دسترس است: \fBpackage\fR، \fBname\fR، \fBorigin\fR، \fBdepends\fR، \fBprovides\fR، \fBreplaces\fR، \fBinstall_if\fR، \fBrecommends\fR، \fBreverse\-depends\fR و \fBreverse\-install\-if\fR.\&
.PP
.RE
\fB\-\-upgradable\fR
.RS 4
فیلتر کردن انتخاب به بسته‌های قابل ارتقا.\&
.PP
.RE
\fB\-\-world\fR
.RS 4
گنجاندن وابستگی‌های \fBapk\-world\fR(5) در محدودیت‌ها.\& به طور ضمنی فعال‌کننده \fB\-\-recursive\fR است.\&
.PP
.RE
\fB\-\-orphaned\fR
.RS 4
فیلتر کردن انتخاب به بسته‌های یتیم (orphaned).\&
.PP
.RE
.SH "فیلدها (FIELDS)"
.PP
نام فیلدها برای گزینه‌های \fB\-\-match\fR و \fB\-\-fields\fR و همچنین برای خروجی قابل پردازش ماشین (json و yaml) همگی با حروف کوچک هستند.\& برای قالب پیش‌فرض خوانا برای انسان، فیلدها با حروف بزرگ شروع می‌شوند.\&
.PP
فیلدهای متاداده بسته زیر در دسترس هستند:
\fBname\fR، \fBversion\fR، \fBdescription\fR، \fBarch\fR، \fBlicense\fR، \fBorigin\fR، \fBmaintainer\fR، \fBurl\fR، \fBcommit\fR، \fBbuild\-time\fR، \fBinstalled\-size\fR، \fBfile\-size\fR، \fBprovider\-priority\fR، \fBdepends\fR، \fBprovides\fR، \fBreplaces\fR، \fBinstall\-if\fR، \fBlayer\fR، \fBtags\fR، \fBtriggers\fR، \fBscripts\fR و \fBreplaces\-priority\fR.\&
برای شرح این فیلدها بخش‌های \fBpackage info metadata\fR و \fBpackage metadata\fR در \fBapk\-package\fR(8) را ببینید.\&
.PP
علاوه بر این، فیلدهای زیر نیز در دسترس هستند:
.PP
\fBcontents\fR
.RS 4
نام فایل‌های موجود در یک بسته.\&
.PP
.RE
\fBdownload\-url\fR
.RS 4
نشانی کامل (URL) برای بارگیری بسته.\&
.PP
.RE
\fBowner\fR
.RS 4
جستجوی بسته مالک برای نام مسیر داده‌شده.\& (فقط برای \fB\-\-match\fR)
.PP
.RE
\fBpackage\fR
.RS 4
شناسه بسته در قالب \fBname\fR\-\fBversion\fR (مانند package\-1.\&0\-r0).\&
.PP
.RE
\fBrepositories\fR
.RS 4
فهرست مخازنی که بسته در آن‌ها در دسترس است.\&
.PP
.RE
\fBstatus\fR
.RS 4
وضعیت یک بسته نصب‌شده.\& فهرستی از یک یا چند کلیدواژه زیر:
.PD 0
.IP \(bu 4
\fBinstalled\fR
.IP \(bu 4
\fBbroken\-files\fR
.IP \(bu 4
\fBbroken\-scripts\fR
.IP \(bu 4
\fBbroken\-xattr\fR
.PD
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
# جستجوی تمام بسته‌هایی که با apk شروع می‌شوند
.br
apk query "apk*"
.PP
# نمایش بسته مالک فایل اجرایی sensors در قالب json
.br
apk query \-\-format json \-\-match owner /usr/bin/sensors
.PP
# نمایش apk\-tools و وابستگی‌های آن در قالب yaml
.br
apk query \-\-format yaml \-\-recursive apk\-tools
.PP
# چاپ بسته‌های منبع برای تمام بسته‌های ارائه‌دهنده cmd:apk
.br
apk query \-\-match name,provides cmd:apk \-\-fields origin
.PP
# چاپ بسته‌های منبع با نام وابستگی مشخص
.br
apk query \-\-match depends so:libapk.\&so.\&2.\&14.\&9 \-\-fields origin