'\" t
.\"     Title: pkgctl-search
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-SEARCH" "1" "2026-06-21" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
pkgctl-search \- جستجوی بسته‌ها در زیرساخت مخازن گیت‌لب
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl search [OPTIONS] QUERY
.SH "توضیحات (DESCRIPTION)"
.sp
جستجوی یک عبارت در سراسر گروه بسته‌بندی گیت‌لب (GitLab).
.sp
برای استفاده از یک فیلتر، آن را در عبارت جستجوی خود بگنجانید. می‌توانید از نویسه‌های عام (*) برای تطبیق الگو (glob matching) استفاده کنید.
.sp
فیلترهای موجود برای دامنه حباب‌ها (blobs): path، extension
.sp
هر بار استفاده از دستور جستجو نیازمند احراز هویت است. برای احراز هویت در گیت‌لب یا مشاهده وضعیت احراز هویت، به دستور
\f(CR\*(Aqpkgctl auth\*(Aq\fP
مراجعه فرمایید.
.SH "نکات جستجو (SEARCH TIPS)"
.sp
.if n .RS 4
.nf
.fam C
Syntax\&  Description\&    Example
───────────────────────────────────────
"\&       Exact search\&   "gem sidekiq"
~\&       Fuzzy search\&   J~ Doe
|\&       Or\&             display | banner
+\&       And\&            display +banner
\-\&       Exclude\&        display \-banner
*\&       Partial\&        bug error 50*
\(rs\&       Escape\&         \(rs*md
#\&       Issue ID\&       #23456
!\&       Merge request\&  !23456
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "گزینه‌های فیلتر (FILTER OPTIONS)"
.sp
\fB\-\-no\-default\-filter\fP
.RS 4
عدم اعمال فیلتر پیش‌فرض (مانند \-path:keys/pgp/*.asc)
.RE
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.sp
\fB\-\-json\fP
.RS 4
فعال‌سازی چاپ در قالب JSON؛ معادل اختصاری برای \f(CR\*(Aq\-\-format json\*(Aq\fP
.RE
.sp
\fB\-F, \-\-format\fP \fIFORMAT\fP
.RS 4
قالب‌بندی نتایج را کنترل می‌کند؛ \f(CRFORMAT\fP می‌تواند \f(CR\*(Aqpretty\*(Aq\fP، \f(CR\*(Aqplain\*(Aq\fP یا \f(CR\*(Aqjson\*(Aq\fP باشد (پیش‌فرض \f(CRpretty\fP)
.RE
.sp
\fB\-N, \-\-no\-line\-number\fP
.RS 4
عدم نمایش شماره خطوط هنگام قالب‌بندی نتایج
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
pkgctl\-auth(1)
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fR"
.sp
لطفاً گزارش باگ‌ها و درخواست امکانات جدید را در سامانه پیگیری اشکالات (issue tracker) ارسال کنید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت رفع باگ‌ها انجام دهید.