'\" t
.\"     Title: pkgcli
.\"    Author: Matthias Klumpp <matthias@tenstral.net>
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net>
.\"      Date: 26. November 2025
.\"    Manual: pkgcli
.\"    Source: PackageKit
.\"  Language: Persian
.\"
.TH "PKGCLI" "1" "26\&. November 2025" "PackageKit" "pkgcli"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pkgcli \- کلاینت خط فرمان برای PackageKit
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpkgcli\fR\ 'u
\fBpkgcli\fR [\fBGLOBAL\-OPTIONS\fR...] \fICOMMAND\fR [\fBCOMMAND\-OPTIONS\fR...] [\fIARGUMENTS\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBpkgcli\fR
یک کلاینت خط فرمان برای PackageKit است؛ واسطی مستقل از توزیع برای مدیر بسته‌های سیستم‌عامل\&. این ابزار مجموعه‌ای از زیردستورها را برای پرس‌وجو و مدیریت بسته‌های نرم‌افزاری، مخازن و تاریخچه تراکنش‌ها فراهم می‌کند\&.
.PP
برای دریافت فهرستی از دستورات در دسترس از
\fBpkgcli\fR
\fB\-\-help\fR
و برای راهنمای اختصاصی هر دستور از
\fBpkgcli\fR
\fICOMMAND\fR
\fB\-\-help\fR
استفاده کنید\&.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.PP
گزینه‌های زیر پیش از نام دستور پردازش می‌شوند و بر بیشتر زیردستورها تأثیر می‌گذارند:
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه
\fBpkgcli\fR
و خروج\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش راهنمای عمومی و فهرستی از دستورات در دسترس\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
ارائه حداقل خروجی ممکن\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
نمایش خروجی با جزئیات بیشتر و حالت اشکال‌زدایی (دیباگ)\&.
.RE
.PP
\fB\-\-json\fR
.RS 4
ارائه خروجی نتایج در قالب JSON مناسب برای پردازش با سایر ابزارها\&. خروجی در قالب JSONL (خطوط JSON)، با یک شیء JSON در هر خط تولید می‌شود\&.
.RE
.PP
\fB\-\-no\-color\fR
.RS 4
غیرفعال کردن خروجی رنگی ترمینال\&. این گزینه در صورت تنظیم بودن متغیر محیطی
\fBNO_COLOR\fR
نیز فعال می‌شود\&.
.RE
.PP
\fB\-y\fR, \fB\-\-yes\fR
.RS 4
پاسخ مثبت (yes) به تمام پرسش‌ها و اجرا در حالت غیرتعاملی\&.
.RE
.PP
\fB\-f\fR, \fB\-\-filter\fR=\fIFILTER\fR
.RS 4
اعمال یک یا چند فیلتر هنگام پرس‌وجوی بسته‌ها، مانند محدود کردن نتایج به بسته‌های نصب‌شده یا موجود\&. می‌توانید تمام گزینه‌های فیلتر پشتیبانی‌شده را با اجرای
\fBpkgcli organization\fR
مشاهده کنید\&.
.RE
.PP
\fB\-n\fR, \fB\-\-background\fR
.RS 4
اشاره به این‌که دستور فوری نیست و در صورت پشتیبانی می‌تواند از پهنای باند شبکه آزاد و تنظیمات صرفه‌جویی در انرژی استفاده کند\&.
.RE
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر در دسترس هستند:
.PP
\fBbackend\fR
.RS 4
نمایش اطلاعات درباره بک‌اند فعلی PackageKit، از جمله نام بک‌اند، نسخه و نقش‌های پشتیبانی‌شده توسط آن\&.
.RE
.PP
\fBhistory\fR
.RS 4
نمایش فهرستی از تراکنش‌های اخیر مدیریت بسته (مانند عملیات‌های نصب، حذف و به‌روزرسانی انجام‌شده روی سیستم)\&.
.RE
.PP
\fBsearch\fR
.RS 4
جستجو برای بسته‌های منطبق با یک الگوی مشخص\&. آرگومان اول می‌تواند اختیاری و یکی از مقادیر
name،
details،
file
یا
group
باشد تا جستجو به دامنه انتخابی محدود شود\&. اگر فقط یک آرگومان داده شود، جستجو در تمام جزئیات بسته (نام، خلاصه و توضیحات) انجام می‌شود\&.
.RE
.PP
\fBlist\fR
.RS 4
فهرست کردن بسته‌ها، با امکان فیلتر اختیاری بر اساس وضعیت نصب یا الگوی نام\&. همراه با
\fB\-\-filter\fR
استفاده شود تا فقط بسته‌های نصب‌شده، موجود یا سایر دسته‌بندی‌های بسته نمایش داده شوند\&.
.RE
.PP
\fBshow\fR
.RS 4
نمایش اطلاعات دقیق درباره یک یا چند بسته، شامل نسخه، اندازه، توضیحات، مجوز و اطلاعات مخزن\&.
.RE
.PP
\fBlist\-depends\fR
.RS 4
فهرست کردن تمام بسته‌هایی که بسته مشخص‌شده به آن‌ها وابسته است\&. از گزینه
\fB\-\-recursive\fR
برای فهرست کردن وابستگی‌های کل زنجیره استفاده کنید\&.
.RE
.PP
\fBlist\-requiring\fR
.RS 4
فهرست کردن بسته‌هایی که به بسته مشخص‌شده وابسته هستند یا به آن نیاز دارند\&.
.RE
.PP
\fBwhat\-provides\fR
.RS 4
یافتن و فهرست کردن بسته‌هایی که یک قابلیت، کتابخانه اشتراکی یا مسیر فایل مشخص را ارائه می‌دهند\&.
.RE
.PP
\fBfiles\fR
.RS 4
نمایش فهرستی از تمام فایل‌های موجود در بسته مشخص‌شده\&.
.RE
.PP
\fBlist\-updates\fR
.RS 4
فهرست کردن تمام به‌روزرسانی‌های موجود برای نرم‌افزارهای نصب‌شده\&.
.RE
.PP
\fBshow\-update\fR
.RS 4
نمایش اطلاعات دقیق درباره یک به‌روزرسانی خاص، شامل گزارش تغییرات، هشدارهای امنیتی و سایر متاداده‌های به‌روزرسانی\&.
.RE
.PP
\fBresolve\fR
.RS 4
تفکیک نام‌ها یا شناسه‌های بسته به وضعیت آن‌ها، برای نمایش این‌که آیا نصب‌شده، موجود یا ناموجود هستند\&.
.RE
.PP
\fBorganization\fR
.RS 4
نمایش فیلترهای بسته موجود (مانند installed، available، newest)، گروه‌ها (مانند system، development، graphics) و دسته‌بندی‌هایی که می‌توان برای پرس‌وجوی بسته‌ها استفاده کرد\&.
.RE
.PP
\fBshow\-os\-upgrade\fR
.RS 4
بررسی و نمایش اطلاعات درباره ارتقاهای موجود سیستم‌عامل یا توزیع، مانند ارتقا به نسخه جدیدتر سیستم‌عامل\&.
.RE
.PP
\fBlast\-time\fR
.RS 4
نمایش زمان سپری‌شده از آخرین تراکنش یک نقش مشخص، مانند آخرین به‌روزرسانی بسته یا بازخوانی کش\&.
.RE
.PP
\fBrefresh\fR
.RS 4
بازخوانی کش متاداده محلی بسته‌ها با بارگیری آخرین اطلاعات بسته از مخازن پیکربندی‌شده\&. این دستور باید پیش از بررسی به‌روزرسانی‌ها یا جستجو برای بسته‌های جدید اجرا شود\&.
.RE
.PP
\fBinstall\fR
.RS 4
نصب یک یا چند بسته بر اساس نام، یا نصب فایل‌های محلی بسته در صورتی که به جای نام، یک مسیر ارائه شده باشد\&.
.RE
.PP
\fBremove\fR
.RS 4
حذف یک یا چند بسته نصب‌شده از سیستم\&. این کار در صورتی که بسته‌های وابسته دیگر مورد نیاز نباشند، ممکن است آن‌ها را نیز حذف کند\&. برای پاک‌سازی بسته‌های بلااستفاده از گزینه
\-\-autoremove
استفاده کنید\&.
.RE
.PP
\fBupdate\fR
.RS 4
نصب به‌روزرسانی‌های موجود برای تمام بسته‌های نصب‌شده روی سیستم، یا برای بسته‌های خاص در صورت مشخص شدن به عنوان آرگومان\&.
.RE
.PP
\fBupgrade\fR
.RS 4
اجرای ارتقای سیستم به نسخه‌های جدیدتر بسته یا انتشار جدید توزیع\&. این عمل ممکن است شامل ارتقای نسخه‌های اصلی و تغییرات چشمگیر باشد\&.
.RE
.PP
\fBdownload\fR
.RS 4
بارگیری فایل‌های بسته به سیستم محلی بدون نصب آن‌ها\&. این عمل برای نصب آفلاین یا بازرسی بسته کاربرد دارد\&.
.RE
.PP
\fBoffline\-update\fR
.RS 4
آماده‌سازی، راه‌اندازی، لغو یا بازرسی به‌روزرسانی‌های آفلاین سیستم\&. به‌روزرسانی‌های آفلاین در زمان راه‌اندازی سیستم و پیش از اجرای محیط میزکار اعمال می‌شوند تا بسته‌های حیاتی سیستم با اطمینان به‌روزرسانی شوند\&.
.RE
.PP
\fBinstall\-sig\fR
.RS 4
نصب امضای رمزنگاری‌شده برای یک بسته جهت اعتبارسنجی اصالت و یکپارچگی آن\&.
.RE
.PP
\fBrepair\fR
.RS 4
تلاش برای تعمیر خودکار مشکلات سیستم مدیریت بسته، مانند وابستگی‌های ناسازگار، پایگاه‌داده‌های خراب یا تراکنش‌های متوقف‌شده\&.
.RE
.PP
\fBquit\fR
.RS 4
درخواست از دیمن PackageKit برای خروج تمیز پس از تکمیل تمام عملیات در حال انجام\&. دیمن در صورت نیاز مجدداً به صورت خودکار راه‌اندازی می‌شود\&.
.RE
.PP
\fBrepo\-list\fR
.RS 4
نمایش فهرستی از تمام مخازن نرم‌افزاری پیکربندی‌شده، همراه با شناسه‌ها، توضیحات و وضعیت فعال یا غیرفعال آن‌ها\&.
.RE
.PP
\fBrepo\-enable\fR
.RS 4
فعال‌سازی مخزنی که قبلاً غیرفعال شده است، تا امکان نصب و به‌روزرسانی بسته‌ها از آن مخزن فراهم شود\&.
.RE
.PP
\fBrepo\-disable\fR
.RS 4
غیرفعال‌سازی یک مخزن جهت جلوگیری از نصب یا به‌روزرسانی بسته‌ها از آن منبع، ضمن حفظ پیکربندی مخزن\&.
.RE
.PP
\fBrepo\-remove\fR
.RS 4
حذف کامل یک مخزن از پیکربندی سیستم\&. این عمل دائمی است و در صورت نیاز در آینده، مخزن باید دوباره اضافه شود\&. این دستور شناسه مخزن (repository\-ID) را به عنوان پارامتر می‌پذیرد\&.
.RE
.PP
\fBmonitor\fR
.RS 4
پایش و نمایش بلادرنگ رویدادهای تراکنش PackageKit و تغییرات وضعیت روی گذرگاه (bus)\&. این گزینه برای اشکال‌زدایی یا مشاهده فعالیت‌های مدیریت بسته مفید است\&.
.RE
.PP
برای اطلاعات دقیق‌تر درباره نحوه استفاده، از جمله گزینه‌ها و آرگومان‌های پشتیبانی‌شده برای هر دستور، از
\fBpkgcli\fR
\fICOMMAND\fR
\fB\-\-help\fR
استفاده کنید\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
کدهای خروج زیر توسط
\fBpkgcli\fR
استفاده می‌شوند:
.PP
0
.RS 4
دستور با موفقیت پایان یافت\&.
.RE
.PP
1
.RS 4
یک خطای نامشخص رخ داد\&.
.RE
.PP
2
.RS 4
ساختار دستوری نامعتبر یا گزینه‌های خط فرمان نادرست ارائه شده است\&.
.RE
.PP
3
.RS 4
مجوز ناکافی برای اجرای عملیات درخواستی\&.
.RE
.PP
4
.RS 4
اطلاعات یا بسته‌های مورد نیاز یافت نشدند\&.
.RE
.PP
5
.RS 4
تراکنش شکست خورد\&.
.RE
.PP
ممکن است کدهای خروج دیگری نیز برای شرایط خطای خاص‌تر توسط دستورات جداگانه به کار گرفته شوند\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fBNO_COLOR\fR
.RS 4
اگر روی هر مقدار غیرخالی تنظیم شده باشد، خروجی رنگی را غیرفعال می‌کند؛ معادل ارسال گزینه
\fB\-\-no\-color\fR\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
جستجو برای بسته‌های مرتبط با ویرایشگرهای متن
.RS 4
\fBpkgcli search editor\fR
.RE
.PP
جستجو فقط در نام بسته‌ها
.RS 4
\fBpkgcli search name python3\fR
.RE
.PP
نمایش اطلاعات دقیق درباره یک بسته
.RS 4
\fBpkgcli show nano\fR
.RE
.PP
نصب یک بسته به صورت غیرتعاملی
.RS 4
\fBpkgcli \-\-yes install nano\fR
.RE
.PP
فهرست کردن تمام بسته‌های نصب‌شده
.RS 4
\fBpkgcli \-\-filter=installed list\fR
.RE
.PP
بررسی به‌روزرسانی‌های موجود
.RS 4
\fBpkgcli refresh && pkgcli list\-updates\fR
.RE
.PP
فهرست کردن وابستگی‌های یک بسته
.RS 4
\fBpkgcli list\-depends inkscape\fR
.RE
.PP
یافتن بسته‌ای که کدک ویدیویی AV1 در GStreamer را ارائه می‌دهد
.RS 4
\fBpkgcli what\-provides "gstreamer1(decoder\-video/x\-av1)"\fR
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBappstreamcli\fR(1)، و مستندات PackageKit در
\m[blue]\fB\%https://www.freedesktop.org/software/PackageKit\fR\m[]\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBMatthias Klumpp\fR <\&matthias@tenstral\&.net\&>
.RS 4
توسعه‌دهنده
.RE
.PP
\fBRichard Hughes\fR <\&richard@hughsie\&.com\&>
.RS 4
توسعه‌دهنده
.RE
.SH "حق نشر (COPYRIGHT)"
.br
Copyright \(co 2012-2026 Matthias Klumpp
.br