DNF5-CHECK-UPGRADE(8) dnf5 DNF5-CHECK-UPGRADE(8)

dnf5-check-upgrade - بررسی بسته‌های دارای نسخه قابل ارتقا در DNF5

dnf5 check-upgrade [options] [<package-spec-N>...]

به‌صورت غیرتعاملی وجود به‌روزرسانی‌های در دسترس را برای بسته‌های مشخص‌شده بررسی می‌کند. اگر هیچ <package-spec-N> ارائه نشود، وجود به‌روزرسانی‌ها را برای کل سیستم بررسی می‌کند.

در صورتی که به‌روزرسانی در دسترس باشد، DNF5 با کد خروج 100 خارج شده و آن‌ها را فهرست می‌کند؛ در صورت عدم وجود به‌روزرسانی، با کد خروج 0 خارج می‌شود.

اگر ترمینال در دسترس باشد، فهرست بسته‌ها رنگی خواهد بود؛ بسته‌های در دسترس برای نصب مجدد (به‌طور پیش‌فرض) با رنگ سبز برجسته و بسته‌های در دسترس برای ارتقا با رنگ آبی برجسته نمایش داده می‌شوند. این رفتار را می‌توان در dnf5.conf(5) از طریق گزینه‌های color_list_available_upgrade و color_list_available_reinstall تنظیم کرد.

چاپ گزارش تغییرات (changelogs) بسته‌ها.
شامل محتوای موجود در توصیه‌نامه‌ها (advisories) با نام مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های توصیه‌نامه هستند، مانند FEDORA-2201-123.
هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیه‌نامه در فهرست با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ --skip-unavailable دور زد.
شامل محتوای موجود در توصیه‌نامه‌ها با سطح اهمیت (severity) مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر پذیرفته‌شده عبارتند از: critical، important، moderate، low، none.
شامل محتوای موجود در توصیه‌نامه‌هایی که تیکتی با شناسه Bugzilla داده‌شده را برطرف می‌کنند.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های عددی هستند، مانند 123123.
هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیه‌نامه‌ای برای برطرف کردن تیکت داده‌شده با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ --skip-unavailable دور زد.
شامل محتوای موجود در توصیه‌نامه‌هایی که تیکتی با شناسه CVE (Common Vulnerabilities and Exposures) داده‌شده را برطرف می‌کنند.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های رشته‌ای در قالب CVE هستند، مانند CVE-2201-0123.
هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیه‌نامه‌ای برای برطرف کردن تیکت داده‌شده با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ --skip-unavailable دور زد.
شامل محتوای موجود در توصیه‌نامه‌های امنیتی.
شامل محتوای موجود در توصیه‌نامه‌های رفع باگ.
شامل محتوای موجود در توصیه‌نامه‌های بهبود و ارتقا.
شامل محتوای موجود در توصیه‌نامه‌های بسته جدید.
پایین‌ترین نسخه‌های بسته‌هایی را گزارش می‌دهد که توصیه‌نامه‌هایی از نوع bugfix، enhancement، security یا newpackage را برطرف می‌کنند. در صورتی که هر گزینه‌ای برای محدود کردن توصیه‌نامه‌ها استفاده شود، پایین‌ترین نسخه‌های بسته‌هایی را گزارش می‌دهد که توصیه‌نامه‌های منطبق با ویژگی‌های توصیه‌نامه انتخاب‌شده را برطرف می‌کنند.
درخواست قالب خروجی JSON.

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

dnf5 check-upgrade --json

این دستور یک شیء JSON با ساختار زیر را برمی‌گرداند:

  • کلیدها یک بخش از خروجی زیبای CLI را نشان می‌دهند
  • مقادیر نشان‌دهنده بسته‌های آن بخش به‌صورت آرایه‌ای از اشیاء با ساختار زیر هستند:
  • name (رشته): نام بسته
  • arch (رشته): معماری بسته
  • evr (رشته): نسخه به‌روزرسانی در دسترس
  • repository (رشته): شناسه مخزنی که به‌روزرسانی از آن در دسترس است
  • obsoletes (آرایه): (تنها برای بخش «بسته‌های منسوخ‌کننده» یا «Obsoleting packages») فهرست بسته‌هایی که این بسته را منسوخ می‌کنند (دارای همان ساختار بالا هستند، بدون obsoletes)

dnf5-specs(7), مشخصات الگوها <#specs-misc-ref-label>

See AUTHORS.md in dnf5 source distribution.

Contributors to the dnf5 project.

September 6, 2026