.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-ADVISORY" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-advisory \- دستور مشاوره‌ها و هشدارهای امنیتی در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 advisory <subcommand> [options] [<advisory\-spec>...]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBadvisory\fP در \fBDNF5\fP چندین پرس‌وجو برای دریافت اطلاعات درباره
مشاوره‌ها (advisories) و بسته‌های مرتبط با آن‌ها ارائه می‌دهد.
.sp
آرگومان‌های اختیاری \fBadvisory\-spec\fP می‌توانند برای فیلتر کردن فقط مشاوره‌های دارای نام‌های مشخص ارسال شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
دستور \fBupdateinfo\fP به عنوان یک نام مستعار سازگاری برای \fBadvisory\fP در دسترس است\&.
به عنوان مثال، \fBdnf5 updateinfo list\fP معادل \fBdnf5 advisory list\fP است\&.
.UNINDENT
.UNINDENT
.SH "زیردستورها (SUBCOMMANDS)"
.INDENT 0.0
.TP
.B \fBlist\fP
.nf
فهرست کردن مشاوره‌های منطبق با معیارهای مشخص‌شده.
جدولی را با ستون‌های زیر نمایش می‌دهد: Name (شناسه مشاوره)، Type، Severity، Package (NEVRA)، و Issued (تاریخ).
هنگامی که \fB\-\-with\-bz\fP یا \fB\-\-with\-cve\fP مشخص شده باشد، ستون نخست شناسه مرجع Bugzilla یا CVE را به جای نام مشاوره نشان می‌دهد.
بسته‌های مشاوره نصب‌شده به رنگ سبز برجسته می‌شوند.
.fi
.sp
.TP
.B \fBinfo\fP
.nf
چاپ اطلاعات تفصیلی درباره مشاوره‌ها.
برای هر مشاوره منطبق، موارد زیر را نمایش می‌دهد: Name، Title، Severity، Type، Status، Vendor، تاریخ Issued، Description، Message، Rights، References (شامل Title، Id، Type، و URL)، و بسته‌ها/ماژول‌های تحت تأثیر سازمان‌دهی‌شده بر اساس مجموعه.
.fi
.sp
.TP
.B \fBsummary\fP
.nf
چاپ تعداد خلاصه‌وار مشاوره‌ها بر اساس نوع و شدت.
یک خلاصه سلسله‌مراتبی را نمایش می‌دهد که تعداد مشاوره‌ها را در هر دسته نشان می‌دهد:
Security (با زیردسته‌های: Critical، Important، Moderate، Low، Other)، Bugfix، Enhancement، و Other.
سربرگ خروجی حالت فیلتر را مشخص می‌کند: Available (پیش‌فرض)، All، Installed، یا Updates.
.fi
.sp
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-\-all\fP
.nf
نمایش مشاوره‌های حاوی هر نسخه‌ای از بسته‌های نصب‌شده.
.fi
.sp
.TP
.B \fB\-\-available\fP
.nf
نمایش مشاوره‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده. این رفتار پیش‌فرض است.
.fi
.sp
.TP
.B \fB\-\-installed\fP
.nf
نمایش مشاوره‌های حاوی نسخه‌های برابر و قدیمی‌تر بسته‌های نصب‌شده.
.fi
.sp
.TP
.B \fB\-\-updates\fP
.nf
نمایش مشاوره‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده که نسخه جدیدتری برای آن‌ها در دسترس است.
.fi
.sp
.TP
.B \fB\-\-contains\-pkgs=PACKAGE_NAME,...\fP
.nf
نمایش تنها مشاوره‌های حاوی بسته‌های با نام‌های مشخص‌شده.
این یک گزینه فهرستی است.
تنها با بسته‌های نصب‌شده تطبیق داده می‌شود. از الگوهای انطباق (Globs) پشتیبانی می‌شود.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-security\fP
.nf
شامل کردن محتوای موجود در مشاوره‌های امنیتی.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-bugfix\fP
.nf
شامل کردن محتوای موجود در مشاوره‌های رفع باگ (bugfix).
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-enhancement\fP
.nf
شامل کردن محتوای موجود در مشاوره‌های بهبود و ارتقا (enhancement).
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-newpackage\fP
.nf
شامل کردن محتوای موجود در مشاوره‌های بسته جدید (newpackage).
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
.nf
شامل کردن محتوای موجود در مشاوره‌های با درجه شدت مشخص‌شده.
این یک گزینه فهرستی است.
مقادیر پذیرفته‌شده عبارتند از: \fIcritical\fP، \fIimportant\fP، \fImoderate\fP، \fIlow\fP، \fInone\fP\&.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-bzs=BUGZILLA_ID,...\fP
.nf
شامل کردن محتوای موجود در مشاوره‌هایی که تیکتی با شناسه Bugzilla داده‌شده را رفع می‌کنند.
این یک گزینه فهرستی است.
مقادیر مورد انتظار شناسه‌های عددی هستند، مانند \fI123123\fP\&.
هر دستور تراکنش (install، upgrade) در صورت نبود مشاوره‌ای که تیکت مشخص‌شده را رفع کند، با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ \-\-skip\-unavailable دور زد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-cves=CVE_ID,...\fP
.nf
شامل کردن محتوای موجود در مشاوره‌هایی که تیکتی با شناسه CVE (آسیب‌پذیری‌ها و افشاهای رایج) داده‌شده را رفع می‌کنند.
این یک گزینه فهرستی است.
مقادیر مورد انتظار شناسه‌های رشته‌ای در قالب CVE هستند، مانند \fICVE\-2201\-0123\fP\&.
هر دستور تراکنش (install، upgrade) در صورت نبود مشاوره‌ای که تیکت مشخص‌شده را رفع کند، با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ \-\-skip\-unavailable دور زد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-with\-bz\fP
.nf
تنها نمایش مشاوره‌هایی که به یک تیکت Bugzilla ارجاع می‌دهند.
.fi
.sp
.TP
.B \fB\-\-with\-cve\fP
.nf
تنها نمایش مشاوره‌هایی که به یک تیکت CVE ارجاع می‌دهند.
.fi
.sp
.TP
.B \fB\-\-json\fP
.nf
درخواست قالب خروجی JSON برای نتایج ماشین‌خوان.
تنها برای زیردستورهای \fBlist\fP و \fBinfo\fP در دسترس است.
.fi
.sp
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B \fBdnf5 advisory info FEDORA\-2022\-07aa56297a\fP
.nf
نمایش اطلاعات تفصیلی درباره مشاوره با نام داده‌شده.
.fi
.sp
.TP
.B \fBdnf5 advisory summary \-\-contains\-pkgs=kernel,kernel\-core \-\-with\-bz\fP
.nf
نمایش خلاصه‌ای از مشاوره‌های حاوی بسته‌های \fBkernel\fP یا \fBkernel\-core\fP و دارای ارجاع به هر تیکت Bugzilla.
.fi
.sp
.TP
.B \fBdnf5 advisory list \-\-security \-\-advisory\-severities=important\fP
.nf
نمایش فهرستی از مشاوره‌های امنیتی یا مشاوره‌های با شدت \fBimportant\fP.
.fi
.sp
.TP
.B \fBdnf5 advisory list \-\-json\fP
.nf
فهرست کردن تمام مشاوره‌ها در قالب JSON برای پردازش برنامه‌نویسی.
.fi
.sp
.TP
.B \fBdnf5 advisory list \-\-json \-\-with\-cve\fP
.nf
فهرست کردن مشاوره‌های دارای ارجاع به CVE در قالب JSON (قالب گسترش‌یافته).
.fi
.sp
.TP
.B \fBdnf5 advisory info FEDORA\-2022\-07aa56297a \-\-json\fP
.nf
نمایش اطلاعات تفصیلی درباره مشاوره در قالب JSON.
.fi
.sp
.UNINDENT
.SH "خروجی JSON (JSON OUTPUT)"
.INDENT 0.0
.IP \(bu 2
\fBdnf5 advisory list \-\-json\fP
.UNINDENT
.sp
این دستور یک آرایه JSON برمی‌گرداند که هر عنصر آن یک مشاوره را توصیف می‌کند.
.sp
\fBقالب پایه\fP (بدون \fB\-\-with\-cve\fP یا \fB\-\-with\-bz\fP):
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBname\fP (string) \- شناسه مشاوره.
.IP \(bu 2
\fBtype\fP (string) \- نوع مشاوره (security، bugfix، enhancement).
.IP \(bu 2
\fBseverity\fP (string) \- سطح شدت مشاوره.
.IP \(bu 2
\fBnevra\fP (string) \- نام\-دوره:نسخه\-انتشار.معماری بسته (Package name\-epoch:version\-release.architecture).
.IP \(bu 2
\fBbuildtime\fP (integer) \- زمان ساخت مشاوره، به وقت UNIX.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBقالب گسترش‌یافته\fP (با \fB\-\-with\-cve\fP یا \fB\-\-with\-bz\fP):
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBadvisory_name\fP (string) \- شناسه مشاوره.
.IP \(bu 2
\fBadvisory_type\fP (string) \- نوع مشاوره (security، bugfix، enhancement).
.IP \(bu 2
\fBadvisory_severity\fP (string) \- سطح شدت مشاوره.
.IP \(bu 2
\fBadvisory_buildtime\fP (integer) \- زمان ساخت مشاوره، به وقت UNIX.
.IP \(bu 2
\fBnevra\fP (string) \- نام\-دوره:نسخه\-انتشار.معماری بسته (Package name\-epoch:version\-release.architecture).
.IP \(bu 2
\fBreferences\fP (array) \- فهرست ارجاع‌ها (CVE/Bugzilla). هر ارجاع شامل موارد زیر است:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBreference_id\fP (string) \- شناسه مرجع (مانند CVE\-2024\-1234).
.IP \(bu 2
\fBreference_type\fP (string) \- نوع مرجع (cve یا bugzilla).
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBdnf5 advisory info \-\-json\fP
.UNINDENT
.sp
این دستور یک آرایه JSON برمی‌گرداند که هر عنصر آن شامل اطلاعات تفصیلی مشاوره است.
هر شیء مشاوره شامل فیلدهای زیر است:
.INDENT 0.0
.IP \(bu 2
\fBName\fP (string) \- نام/شناسه مشاوره.
.IP \(bu 2
\fBTitle\fP (string) \- عنوان مشاوره.
.IP \(bu 2
\fBType\fP (string) \- نوع مشاوره (security، bugfix، enhancement).
.IP \(bu 2
\fBSeverity\fP (string) \- سطح شدت مشاوره.
.IP \(bu 2
\fBStatus\fP (string) \- وضعیت مشاوره.
.IP \(bu 2
\fBVendor\fP (string) \- ارائه‌دهنده/سازنده مشاوره.
.IP \(bu 2
\fBIssued\fP (integer) \- زمان صدور مشاوره، به وقت UNIX.
.IP \(bu 2
\fBDescription\fP (string) \- توضیحات تفصیلی مشاوره.
.IP \(bu 2
\fBMessage\fP (string) \- پیام مشاوره.
.IP \(bu 2
\fBRights\fP (string) \- اطلاعات حقوق نشر/کپی‌رایت مشاوره.
.IP \(bu 2
\fBreferences\fP (array) \- فهرست ارجاع‌ها (CVE، Bugzilla و غیره). هر ارجاع شامل موارد زیر است:
.INDENT 2.0
.IP \(bu 2
\fBTitle\fP (string) \- عنوان مرجع.
.IP \(bu 2
\fBId\fP (string) \- شناسه مرجع (مانند CVE\-2024\-1234).
.IP \(bu 2
\fBType\fP (string) \- نوع مرجع (cve، bugzilla و غیره).
.IP \(bu 2
\fBUrl\fP (string) \- نشانی URL مرجع.
.UNINDENT
.IP \(bu 2
\fBcollections\fP (object) \- مجموعه‌های بسته و ماژول تحت تأثیر مشاوره:
.INDENT 2.0
.IP \(bu 2
\fBpackages\fP (array) \- فهرست NEVRAهای بسته‌های تحت تأثیر (تنها در صورت وجود بسته‌ها موجود است).
.IP \(bu 2
\fBmodules\fP (array) \- فهرست NSVCAهای ماژول‌های تحت تأثیر (تنها در صورت وجود ماژول‌ها موجود است).
.UNINDENT
.UNINDENT
.sp
برای نتایج خالی:
.INDENT 0.0
.IP \(bu 2
دستور \fBdnf5 advisory list \-\-json\fP مقدار \fB[]\fP (آرایه خالی) را برمی‌گرداند.
.IP \(bu 2
دستور \fBdnf5 advisory info \-\-json\fP مقدار \fB[]\fP (آرایه خالی) را برمی‌گرداند.
.UNINDENT
.SH "نویسندگان (AUTHORS)"
بخش AUTHORS.md را در توزیع منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان در پروژه dnf5.
.\" End of generated man page.