PKGCLI(1)

pkgcli

PKGCLI(1)

نام (NAME)

pkgcli - کلاینت خط فرمان برای PackageKit

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

pkgcli [GLOBAL-OPTIONS...] COMMAND [COMMAND-OPTIONS...] [ARGUMENTS...]

توضیحات (DESCRIPTION)

دستور pkgcli یک کلاینت خط فرمان برای PackageKit است؛ واسطی مستقل از توزیع برای مدیر بسته‌های سیستم‌عامل. این ابزار مجموعه‌ای از زیردستورها را برای پرس‌وجو و مدیریت بسته‌های نرم‌افزاری، مخازن و تاریخچه تراکنش‌ها فراهم می‌کند.

برای دریافت فهرستی از دستورات در دسترس از pkgcli --help و برای راهنمای اختصاصی هر دستور از pkgcli COMMAND --help استفاده کنید.

گزینه‌های عمومی (GLOBAL OPTIONS)

گزینه‌های زیر پیش از نام دستور پردازش می‌شوند و بر بیشتر زیردستورها تأثیر می‌گذارند:

-v, --version

نمایش نسخه pkgcli و خروج.

-h, --help

نمایش راهنمای عمومی و فهرستی از دستورات در دسترس.

-q, --quiet

ارائه حداقل خروجی ممکن.

--verbose

نمایش خروجی با جزئیات بیشتر و حالت اشکال‌زدایی (دیباگ).

--json

ارائه خروجی نتایج در قالب JSON مناسب برای پردازش با سایر ابزارها. خروجی در قالب JSONL (خطوط JSON)، با یک شیء JSON در هر خط تولید می‌شود.

--no-color

غیرفعال کردن خروجی رنگی ترمینال. این گزینه در صورت تنظیم بودن متغیر محیطی NO_COLOR نیز فعال می‌شود.

-y, --yes

پاسخ مثبت (yes) به تمام پرسش‌ها و اجرا در حالت غیرتعاملی.

-f, --filter=FILTER

اعمال یک یا چند فیلتر هنگام پرس‌وجوی بسته‌ها، مانند محدود کردن نتایج به بسته‌های نصب‌شده یا موجود. می‌توانید تمام گزینه‌های فیلتر پشتیبانی‌شده را با اجرای pkgcli organization مشاهده کنید.

-n, --background

اشاره به این‌که دستور فوری نیست و در صورت پشتیبانی می‌تواند از پهنای باند شبکه آزاد و تنظیمات صرفه‌جویی در انرژی استفاده کند.

دستورات (COMMANDS)

دستورات زیر در دسترس هستند:

backend

نمایش اطلاعات درباره بک‌اند فعلی PackageKit، از جمله نام بک‌اند، نسخه و نقش‌های پشتیبانی‌شده توسط آن.

history

نمایش فهرستی از تراکنش‌های اخیر مدیریت بسته (مانند عملیات‌های نصب، حذف و به‌روزرسانی انجام‌شده روی سیستم).

search

جستجو برای بسته‌های منطبق با یک الگوی مشخص. آرگومان اول می‌تواند اختیاری و یکی از مقادیر name، details، file یا group باشد تا جستجو به دامنه انتخابی محدود شود. اگر فقط یک آرگومان داده شود، جستجو در تمام جزئیات بسته (نام، خلاصه و توضیحات) انجام می‌شود.

list

فهرست کردن بسته‌ها، با امکان فیلتر اختیاری بر اساس وضعیت نصب یا الگوی نام. همراه با --filter استفاده شود تا فقط بسته‌های نصب‌شده، موجود یا سایر دسته‌بندی‌های بسته نمایش داده شوند.

show

نمایش اطلاعات دقیق درباره یک یا چند بسته، شامل نسخه، اندازه، توضیحات، مجوز و اطلاعات مخزن.

list-depends

فهرست کردن تمام بسته‌هایی که بسته مشخص‌شده به آن‌ها وابسته است. از گزینه --recursive برای فهرست کردن وابستگی‌های کل زنجیره استفاده کنید.

list-requiring

فهرست کردن بسته‌هایی که به بسته مشخص‌شده وابسته هستند یا به آن نیاز دارند.

what-provides

یافتن و فهرست کردن بسته‌هایی که یک قابلیت، کتابخانه اشتراکی یا مسیر فایل مشخص را ارائه می‌دهند.

files

نمایش فهرستی از تمام فایل‌های موجود در بسته مشخص‌شده.

list-updates

فهرست کردن تمام به‌روزرسانی‌های موجود برای نرم‌افزارهای نصب‌شده.

show-update

نمایش اطلاعات دقیق درباره یک به‌روزرسانی خاص، شامل گزارش تغییرات، هشدارهای امنیتی و سایر متاداده‌های به‌روزرسانی.

resolve

تفکیک نام‌ها یا شناسه‌های بسته به وضعیت آن‌ها، برای نمایش این‌که آیا نصب‌شده، موجود یا ناموجود هستند.

organization

نمایش فیلترهای بسته موجود (مانند installed، available، newest)، گروه‌ها (مانند system، development، graphics) و دسته‌بندی‌هایی که می‌توان برای پرس‌وجوی بسته‌ها استفاده کرد.

show-os-upgrade

بررسی و نمایش اطلاعات درباره ارتقاهای موجود سیستم‌عامل یا توزیع، مانند ارتقا به نسخه جدیدتر سیستم‌عامل.

last-time

نمایش زمان سپری‌شده از آخرین تراکنش یک نقش مشخص، مانند آخرین به‌روزرسانی بسته یا بازخوانی کش.

refresh

بازخوانی کش متاداده محلی بسته‌ها با بارگیری آخرین اطلاعات بسته از مخازن پیکربندی‌شده. این دستور باید پیش از بررسی به‌روزرسانی‌ها یا جستجو برای بسته‌های جدید اجرا شود.

install

نصب یک یا چند بسته بر اساس نام، یا نصب فایل‌های محلی بسته در صورتی که به جای نام، یک مسیر ارائه شده باشد.

remove

حذف یک یا چند بسته نصب‌شده از سیستم. این کار در صورتی که بسته‌های وابسته دیگر مورد نیاز نباشند، ممکن است آن‌ها را نیز حذف کند. برای پاک‌سازی بسته‌های بلااستفاده از گزینه --autoremove استفاده کنید.

update

نصب به‌روزرسانی‌های موجود برای تمام بسته‌های نصب‌شده روی سیستم، یا برای بسته‌های خاص در صورت مشخص شدن به عنوان آرگومان.

upgrade

اجرای ارتقای سیستم به نسخه‌های جدیدتر بسته یا انتشار جدید توزیع. این عمل ممکن است شامل ارتقای نسخه‌های اصلی و تغییرات چشمگیر باشد.

download

بارگیری فایل‌های بسته به سیستم محلی بدون نصب آن‌ها. این عمل برای نصب آفلاین یا بازرسی بسته کاربرد دارد.

offline-update

آماده‌سازی، راه‌اندازی، لغو یا بازرسی به‌روزرسانی‌های آفلاین سیستم. به‌روزرسانی‌های آفلاین در زمان راه‌اندازی سیستم و پیش از اجرای محیط میزکار اعمال می‌شوند تا بسته‌های حیاتی سیستم با اطمینان به‌روزرسانی شوند.

install-sig

نصب امضای رمزنگاری‌شده برای یک بسته جهت اعتبارسنجی اصالت و یکپارچگی آن.

repair

تلاش برای تعمیر خودکار مشکلات سیستم مدیریت بسته، مانند وابستگی‌های ناسازگار، پایگاه‌داده‌های خراب یا تراکنش‌های متوقف‌شده.

quit

درخواست از دیمن PackageKit برای خروج تمیز پس از تکمیل تمام عملیات در حال انجام. دیمن در صورت نیاز مجدداً به صورت خودکار راه‌اندازی می‌شود.

repo-list

نمایش فهرستی از تمام مخازن نرم‌افزاری پیکربندی‌شده، همراه با شناسه‌ها، توضیحات و وضعیت فعال یا غیرفعال آن‌ها.

repo-enable

فعال‌سازی مخزنی که قبلاً غیرفعال شده است، تا امکان نصب و به‌روزرسانی بسته‌ها از آن مخزن فراهم شود.

repo-disable

غیرفعال‌سازی یک مخزن جهت جلوگیری از نصب یا به‌روزرسانی بسته‌ها از آن منبع، ضمن حفظ پیکربندی مخزن.

repo-remove

حذف کامل یک مخزن از پیکربندی سیستم. این عمل دائمی است و در صورت نیاز در آینده، مخزن باید دوباره اضافه شود. این دستور شناسه مخزن (repository-ID) را به عنوان پارامتر می‌پذیرد.

monitor

پایش و نمایش بلادرنگ رویدادهای تراکنش PackageKit و تغییرات وضعیت روی گذرگاه (bus). این گزینه برای اشکال‌زدایی یا مشاهده فعالیت‌های مدیریت بسته مفید است.

برای اطلاعات دقیق‌تر درباره نحوه استفاده، از جمله گزینه‌ها و آرگومان‌های پشتیبانی‌شده برای هر دستور، از pkgcli COMMAND --help استفاده کنید.