.\" 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-NEEDS-RESTARTING" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-needs-restarting \- دستور بررسی نیاز به راه‌اندازی مجدد در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 needs\-restarting [\-p | \-\-processes [\-e | \-\-exclude\-services]] [\-s | \-\-services] [\-r | \-\-reboothint] [\-\-json]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBneeds\-restarting\fP مشخص می‌کند که آیا برای اعمال کامل تغییرات ناشی از نصب و ارتقای بسته‌ها، نیاز به راه‌اندازی مجدد (reboot) سیستم وجود دارد یا خیر. بدون هیچ گزینه‌ای، \fBdnf5 needs\-restarting\fP گزارش می‌دهد که آیا از زمان بالا آمدن سیستم (boot)، بسته‌های مهمی نصب یا ارتقا یافته‌اند یا خیر. این مجموعه بسته‌های مهم شامل هسته لینوکس (kernel)، systemd، تمام بسته‌های فهرست‌شده در: \%<https://\:access\:.redhat\:.com/\:solutions/\:27943> و هر بسته‌ای است که با مشاوره یا اعلان دارای برچسب \fBreboot_suggested\fP مشخص شده باشد.
.sp
اگر راه‌اندازی مجدد سیستم توصیه شود، یا هنگامی که با گزینه \fB\-\-services\fP فراخوانی شده باشد و هر یک از سرویس‌های systemd نیاز به راه‌اندازی مجدد داشته باشند، دستور \fBneeds\-restarting\fP با کد خروج 1 پایان می‌یابد. اگر هیچ اقدامی توصیه نشود، \fBneeds\-restarting\fP با کد خروج 0 خارج خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-p, \-\-processes\fP
.nf
فهرست کردن فرایندهایی که نیاز به راه‌اندازی مجدد دارند. اگر بسته‌ای که فایل اجرایی در حال اجرا را فراهم می‌کند یا هر یک از وابستگی‌های آن از زمان شروع فرایند به‌روزرسانی شده باشند، راه‌اندازی مجدد آن فرایند توصیه خواهد شد.
.fi
.sp
.TP
.B \fB\-e, \-\-exclude\-services\fP
.nf
همراه با گزینه \fB\-p, \-\-processes\fP استفاده می‌شود و فرایندهایی را که توسط سرویس‌های systemd مدیریت می‌شوند فیلتر و حذف می‌کند.
.fi
.sp
.TP
.B \fB\-s, \-\-services\fP
.nf
فهرست کردن سرویس‌های systemd که نیاز به راه‌اندازی مجدد دارند. اگر بسته‌ای که سرویس را ارائه می‌دهد یا هر یک از وابستگی‌های آن از زمان شروع سرویس به‌روزرسانی شده باشند، راه‌اندازی مجدد آن سرویس توصیه خواهد شد. توجه داشته باشید که این رویکرد در پیشنهاد راه‌اندازی مجدد نسبتاً تهاجمی عمل می‌کند، حتی در مواقعی که راه‌اندازی مجدد اکیداً ضروری نباشد.
.fi
.sp
.TP
.B \fB\-r, \-\-reboothint\fP
.nf
هیچ تأثیری ندارد و صرفاً برای سازگاری با DNF 4 حفظ شده است. دستور \(dqdnf4 needs\-restarting \-r\(dq عملکردی مشابه با \(dqdnf5 needs\-restarting\(dq ارائه می‌دهد.
.fi
.sp
.TP
.B \fB\-\-json\fP
.nf
درخواست قالب خروجی JSON برای نتایج ماشین‌خوان.
.fi
.sp
.UNINDENT
.SH "خروجی JSON (JSON OUTPUT)"
.INDENT 0.0
.IP \(bu 2
\fBdnf5 needs\-restarting \-\-json\fP
.UNINDENT
.sp
این دستور یک آرایه JSON شامل یک شیء منفرد حاوی اطلاعات راهنمای راه‌اندازی مجدد (reboot hint) برمی‌گرداند. این شیء شامل فیلدهای زیر است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBtype\fP (string) \- نوع خروجی، همیشه برابر با \(dqreboot\(dq.
.IP \(bu 2
\fBreboot_required\fP (boolean) \- مشخص می‌کند که آیا به راه‌اندازی مجدد نیاز است یا خیر.
.IP \(bu 2
\fBpackages\fP (array of strings) \- فهرست بسته‌هایی که از زمان بالا آمدن سیستم به‌روزرسانی شده‌اند.
.IP \(bu 2
\fBdocumentation\fP (string) \- پیوند به مستنداتی که دلیل لزوم راه‌اندازی مجدد را توضیح می‌دهد.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBdnf5 needs\-restarting \-\-services \-\-json\fP
.UNINDENT
.sp
این دستور یک آرایه JSON از اشیاء برمی‌گرداند که هر شیء یک سرویس systemd را که نیاز به راه‌اندازی مجدد دارد توصیف می‌کند. هر شیء شامل فیلدهای زیر است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBtype\fP (string) \- نوع خروجی، همیشه برابر با \(dqunit\(dq.
.IP \(bu 2
\fBunit\fP (string) \- نام سرویس systemd.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBdnf5 needs\-restarting \-\-processes \-\-json\fP
.UNINDENT
.sp
این دستور یک آرایه JSON از اشیاء برمی‌گرداند که هر شیء یک فرایند در حال اجرا را که نیاز به راه‌اندازی مجدد دارد توصیف می‌کند. هر شیء شامل فیلدهای زیر است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBtype\fP (string) \- نوع خروجی، همیشه برابر با \(dqprocess\(dq.
.IP \(bu 2
\fBpid\fP (integer) \- شناسه فرایند (Process ID).
.IP \(bu 2
\fBcmdline\fP (array of strings) \- خط فرمان اجرای فرایند.
.IP \(bu 2
\fBpackage\fP (string) \- بسته‌ای که فایل اجرایی را ارائه می‌دهد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه \fB\-\-json\fP هنگام استفاده از \fB\-\-processes\fP می‌تواند با \fB\-\-exclude\-services\fP ترکیب شود تا فرایندهای تحت مدیریت سرویس‌های systemd فیلتر و حذف شوند (مانند \fBdnf5 needs\-restarting \-\-processes \-\-exclude\-services \-\-json\fP).
.sp
در صورت خالی بودن نتایج برای سرویس‌ها یا فرایندها، این دستورات مقدار \fB[]\fP را برمی‌گردانند\&. برای راهنمایی راه‌اندازی مجدد (reboot hint)، حتی اگر راه‌اندازی مجدد توصیه نشود، دستور یک آرایه JSON شامل یک شیء منفرد برمی‌گرداند که در آن \fBreboot_required\fP برابر با false، آرایه \fBpackages\fP خالی و پیوند \fBdocumentation\fP قرار دارد.
.SH "نویسندگان (AUTHORS)"
بخش AUTHORS.md را در توزیع منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان در پروژه dnf5.
.\" End of generated man page.