| DNF5-ADVISORY(8) | dnf5 | DNF5-ADVISORY(8) |
نام (NAME)
dnf5-advisory - دستور مشاورهها و هشدارهای امنیتی در DNF5
خلاصه دستور (SYNOPSIS)
dnf5 advisory <subcommand> [options] [<advisory-spec>...]
توضیحات (DESCRIPTION)
دستور advisory در DNF5 چندین پرسوجو برای دریافت اطلاعات درباره مشاورهها (advisories) و بستههای مرتبط با آنها ارائه میدهد.
آرگومانهای اختیاری advisory-spec میتوانند برای فیلتر کردن فقط مشاورههای دارای نامهای مشخص ارسال شوند.
نکته:
زیردستورها (SUBCOMMANDS)
- list
-
فهرست کردن مشاورههای منطبق با معیارهای مشخصشده. جدولی را با ستونهای زیر نمایش میدهد: Name (شناسه مشاوره)، Type، Severity، Package (NEVRA)، و Issued (تاریخ). هنگامی که --with-bz یا --with-cve مشخص شده باشد، ستون نخست شناسه مرجع Bugzilla یا CVE را به جای نام مشاوره نشان میدهد. بستههای مشاوره نصبشده به رنگ سبز برجسته میشوند.
- info
-
چاپ اطلاعات تفصیلی درباره مشاورهها. برای هر مشاوره منطبق، موارد زیر را نمایش میدهد: Name، Title، Severity، Type، Status، Vendor، تاریخ Issued، Description، Message، Rights، References (شامل Title، Id، Type، و URL)، و بستهها/ماژولهای تحت تأثیر سازماندهیشده بر اساس مجموعه.
- summary
-
چاپ تعداد خلاصهوار مشاورهها بر اساس نوع و شدت. یک خلاصه سلسلهمراتبی را نمایش میدهد که تعداد مشاورهها را در هر دسته نشان میدهد: Security (با زیردستههای: Critical، Important، Moderate، Low، Other)، Bugfix، Enhancement، و Other. سربرگ خروجی حالت فیلتر را مشخص میکند: Available (پیشفرض)، All، Installed، یا Updates.
گزینهها (OPTIONS)
- --all
-
نمایش مشاورههای حاوی هر نسخهای از بستههای نصبشده.
- --available
-
نمایش مشاورههای حاوی نسخههای جدیدتر بستههای نصبشده. این رفتار پیشفرض است.
- --installed
-
نمایش مشاورههای حاوی نسخههای برابر و قدیمیتر بستههای نصبشده.
- --updates
-
نمایش مشاورههای حاوی نسخههای جدیدتر بستههای نصبشده که نسخه جدیدتری برای آنها در دسترس است.
- --contains-pkgs=PACKAGE_NAME,...
-
نمایش تنها مشاورههای حاوی بستههای با نامهای مشخصشده. این یک گزینه فهرستی است. تنها با بستههای نصبشده تطبیق داده میشود. از الگوهای انطباق (Globs) پشتیبانی میشود.
- --security
-
شامل کردن محتوای موجود در مشاورههای امنیتی.
- --bugfix
-
شامل کردن محتوای موجود در مشاورههای رفع باگ (bugfix).
- --enhancement
-
شامل کردن محتوای موجود در مشاورههای بهبود و ارتقا (enhancement).
- --newpackage
-
شامل کردن محتوای موجود در مشاورههای بسته جدید (newpackage).
- --advisory-severities=ADVISORY_SEVERITY,...
-
شامل کردن محتوای موجود در مشاورههای با درجه شدت مشخصشده. این یک گزینه فهرستی است. مقادیر پذیرفتهشده عبارتند از: critical، important، moderate، low، none.
- --bzs=BUGZILLA_ID,...
-
شامل کردن محتوای موجود در مشاورههایی که تیکتی با شناسه Bugzilla دادهشده را رفع میکنند. این یک گزینه فهرستی است. مقادیر مورد انتظار شناسههای عددی هستند، مانند 123123. هر دستور تراکنش (install، upgrade) در صورت نبود مشاورهای که تیکت مشخصشده را رفع کند، با خطا مواجه خواهد شد؛ این مورد را میتوان با استفاده از سوییچ --skip-unavailable دور زد.
- --cves=CVE_ID,...
-
شامل کردن محتوای موجود در مشاورههایی که تیکتی با شناسه CVE (آسیبپذیریها و افشاهای رایج) دادهشده را رفع میکنند. این یک گزینه فهرستی است. مقادیر مورد انتظار شناسههای رشتهای در قالب CVE هستند، مانند CVE-2201-0123. هر دستور تراکنش (install، upgrade) در صورت نبود مشاورهای که تیکت مشخصشده را رفع کند، با خطا مواجه خواهد شد؛ این مورد را میتوان با استفاده از سوییچ --skip-unavailable دور زد.
- --with-bz
-
تنها نمایش مشاورههایی که به یک تیکت Bugzilla ارجاع میدهند.
- --with-cve
-
تنها نمایش مشاورههایی که به یک تیکت CVE ارجاع میدهند.
- --json
-
درخواست قالب خروجی JSON برای نتایج ماشینخوان. تنها برای زیردستورهای list و info در دسترس است.
مثالها (EXAMPLES)
- dnf5 advisory info FEDORA-2022-07aa56297a
-
نمایش اطلاعات تفصیلی درباره مشاوره با نام دادهشده.
- dnf5 advisory summary --contains-pkgs=kernel,kernel-core --with-bz
-
نمایش خلاصهای از مشاورههای حاوی بستههای kernel یا kernel-core و دارای ارجاع به هر تیکت Bugzilla.
- dnf5 advisory list --security --advisory-severities=important
-
نمایش فهرستی از مشاورههای امنیتی یا مشاورههای با شدت important.
- dnf5 advisory list --json
-
فهرست کردن تمام مشاورهها در قالب JSON برای پردازش برنامهنویسی.
- dnf5 advisory list --json --with-cve
-
فهرست کردن مشاورههای دارای ارجاع به CVE در قالب JSON (قالب گسترشیافته).
- dnf5 advisory info FEDORA-2022-07aa56297a --json
-
نمایش اطلاعات تفصیلی درباره مشاوره در قالب JSON.
خروجی JSON (JSON OUTPUT)
- •
- dnf5 advisory list --json
این دستور یک آرایه JSON برمیگرداند که هر عنصر آن یک مشاوره را توصیف میکند.
قالب پایه (بدون --with-cve یا --with-bz):
- name (string) - شناسه مشاوره.
- type (string) - نوع مشاوره (security، bugfix، enhancement).
- severity (string) - سطح شدت مشاوره.
- nevra (string) - نام-دوره:نسخه-انتشار.معماری بسته (Package name-epoch:version-release.architecture).
- buildtime (integer) - زمان ساخت مشاوره، به وقت UNIX.
قالب گسترشیافته (با --with-cve یا --with-bz):
- advisory_name (string) - شناسه مشاوره.
- advisory_type (string) - نوع مشاوره (security، bugfix، enhancement).
- advisory_severity (string) - سطح شدت مشاوره.
- advisory_buildtime (integer) - زمان ساخت مشاوره، به وقت UNIX.
- nevra (string) - نام-دوره:نسخه-انتشار.معماری بسته (Package name-epoch:version-release.architecture).
- references (array) - فهرست ارجاعها (CVE/Bugzilla). هر ارجاع شامل موارد زیر است:
- reference_id (string) - شناسه مرجع (مانند CVE-2024-1234).
- reference_type (string) - نوع مرجع (cve یا bugzilla).
- •
- dnf5 advisory info --json
این دستور یک آرایه JSON برمیگرداند که هر عنصر آن شامل اطلاعات تفصیلی مشاوره است. هر شیء مشاوره شامل فیلدهای زیر است:
- Name (string) - نام/شناسه مشاوره.
- Title (string) - عنوان مشاوره.
- Type (string) - نوع مشاوره (security، bugfix، enhancement).
- Severity (string) - سطح شدت مشاوره.
- Status (string) - وضعیت مشاوره.
- Vendor (string) - ارائهدهنده/سازنده مشاوره.
- Issued (integer) - زمان صدور مشاوره، به وقت UNIX.
- Description (string) - توضیحات تفصیلی مشاوره.
- Message (string) - پیام مشاوره.
- Rights (string) - اطلاعات حقوق نشر/کپیرایت مشاوره.
- references (array) - فهرست ارجاعها (CVE، Bugzilla و غیره). هر ارجاع شامل موارد زیر است:
- Title (string) - عنوان مرجع.
- Id (string) - شناسه مرجع (مانند CVE-2024-1234).
- Type (string) - نوع مرجع (cve، bugzilla و غیره).
- Url (string) - نشانی URL مرجع.
- •
- collections (object) - مجموعههای بسته و ماژول تحت تأثیر مشاوره:
- packages (array) - فهرست NEVRAهای بستههای تحت تأثیر (تنها در صورت وجود بستهها موجود است).
- modules (array) - فهرست NSVCAهای ماژولهای تحت تأثیر (تنها در صورت وجود ماژولها موجود است).
برای نتایج خالی:
- دستور dnf5 advisory list --json مقدار [] (آرایه خالی) را برمیگرداند.
- دستور dnf5 advisory info --json مقدار [] (آرایه خالی) را برمیگرداند.
نویسندگان (AUTHORS)
بخش AUTHORS.md را در توزیع منبع dnf5 ببینید.
حق نشر (COPYRIGHT)
مشارکتکنندگان در پروژه dnf5.
| September 6, 2026 |