.\" 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-CHECK-UPGRADE" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-check-upgrade \- بررسی بسته‌های دارای نسخه قابل ارتقا در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 check\-upgrade [options] [<package\-spec\-N>...]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
به‌صورت غیرتعاملی وجود به‌روزرسانی‌های در دسترس را برای بسته‌های مشخص‌شده بررسی می‌کند. اگر هیچ \fB<package\-spec\-N>\fP ارائه نشود، وجود به‌روزرسانی‌ها را برای کل سیستم بررسی می‌کند.
.sp
در صورتی که به‌روزرسانی در دسترس باشد، \fBDNF5\fP با کد خروج \fI100\fP خارج شده و آن‌ها را فهرست می‌کند؛ در صورت عدم وجود به‌روزرسانی، با کد خروج \fI0\fP خارج می‌شود.
.sp
اگر ترمینال در دسترس باشد، فهرست بسته‌ها رنگی خواهد بود؛ بسته‌های در دسترس برای نصب مجدد (به‌طور پیش‌فرض) با رنگ سبز برجسته و بسته‌های در دسترس برای ارتقا با رنگ آبی برجسته نمایش داده می‌شوند. این رفتار را می‌توان در \fBdnf5.conf(5)\fP از طریق گزینه‌های \fIcolor_list_available_upgrade\fP و \fIcolor_list_available_reinstall\fP تنظیم کرد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-\-changelogs\fP
.nf
چاپ گزارش تغییرات (changelogs) بسته‌ها.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-advisories=ADVISORY_NAME,...\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌ها (advisories) با نام مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های توصیه‌نامه هستند، مانند \fIFEDORA\-2201\-123\fP\&.
هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیه‌نامه در فهرست با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ \-\-skip\-unavailable دور زد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌ها با سطح اهمیت (severity) مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر پذیرفته‌شده عبارتند از: \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 (Common Vulnerabilities and Exposures) داده‌شده را برطرف می‌کنند.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های رشته‌ای در قالب CVE هستند، مانند \fICVE\-2201\-0123\fP\&.
هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیه‌نامه‌ای برای برطرف کردن تیکت داده‌شده با خطا مواجه خواهد شد؛ این مورد را می‌توان با استفاده از سوییچ \-\-skip\-unavailable دور زد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-security\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌های امنیتی.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-bugfix\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌های رفع باگ.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-enhancement\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌های بهبود و ارتقا.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-newpackage\fP
.nf
شامل محتوای موجود در توصیه‌نامه‌های بسته جدید.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-minimal\fP
.nf
پایین‌ترین نسخه‌های بسته‌هایی را گزارش می‌دهد که توصیه‌نامه‌هایی از نوع bugfix، enhancement، security یا newpackage را برطرف می‌کنند. در صورتی که هر گزینه‌ای برای محدود کردن توصیه‌نامه‌ها استفاده شود، پایین‌ترین نسخه‌های بسته‌هایی را گزارش می‌دهد که توصیه‌نامه‌های منطبق با ویژگی‌های توصیه‌نامه انتخاب‌شده را برطرف می‌کنند.
.fi
.sp
.TP
.B \fB\-\-json\fP
.nf
درخواست قالب خروجی JSON.
.fi
.sp
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B \fBdnf5 check\-upgrade\fP
.nf
چاپ فهرستی از بسته‌هایی که به‌روزرسانی در دسترس دارند.
.fi
.sp
.TP
.B \fBdnf5 check\-upgrade \-\-changelogs\fP
.nf
چاپ گزارش تغییرات برای تمامی بسته‌های دارای به‌روزرسانی معلق.
.fi
.sp
.UNINDENT
.SH "خروجی JSON (JSON OUTPUT)"
.sp
\fBdnf5 check\-upgrade \-\-json\fP
.sp
این دستور یک شیء JSON با ساختار زیر را برمی‌گرداند:
.INDENT 0.0
.IP \(bu 2
کلیدها یک بخش از خروجی زیبای CLI را نشان می‌دهند
.IP \(bu 2
مقادیر نشان‌دهنده بسته‌های آن بخش به‌صورت آرایه‌ای از اشیاء با ساختار زیر هستند:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBname\fP (رشته): نام بسته
.IP \(bu 2
\fBarch\fP (رشته): معماری بسته
.IP \(bu 2
\fBevr\fP (رشته): نسخه به‌روزرسانی در دسترس
.IP \(bu 2
\fBrepository\fP (رشته): شناسه مخزنی که به‌روزرسانی از آن در دسترس است
.IP \(bu 2
\fBobsoletes\fP (آرایه): (تنها برای بخش «بسته‌های منسوخ‌کننده» یا «Obsoleting packages») فهرست بسته‌هایی که این بسته را منسوخ می‌کنند (دارای همان ساختار بالا هستند، بدون \fBobsoletes\fP)
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-specs(7)\fP, مشخصات الگوها \%<#\:specs-misc-ref-label>
.fi
.sp
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
See AUTHORS.md in dnf5 source distribution.
.SH "حق نشر (COPYRIGHT)"
Contributors to the dnf5 project.
.\" End of generated man page.