نام (NAME)

dnf5-needs-restarting - دستور بررسی نیاز به راه‌اندازی مجدد در DNF5

خلاصه دستور (SYNOPSIS)

dnf5 needs-restarting [-p | --processes [-e | --exclude-services]] [-s | --services] [-r | --reboothint] [--json]

توضیحات (DESCRIPTION)

دستور needs-restarting مشخص می‌کند که آیا برای اعمال کامل تغییرات ناشی از نصب و ارتقای بسته‌ها، نیاز به راه‌اندازی مجدد (reboot) سیستم وجود دارد یا خیر. بدون هیچ گزینه‌ای، dnf5 needs-restarting گزارش می‌دهد که آیا از زمان بالا آمدن سیستم (boot)، بسته‌های مهمی نصب یا ارتقا یافته‌اند یا خیر. این مجموعه بسته‌های مهم شامل هسته لینوکس (kernel)، systemd، تمام بسته‌های فهرست‌شده در: https://access.redhat.com/solutions/27943 و هر بسته‌ای است که با مشاوره یا اعلان دارای برچسب reboot_suggested مشخص شده باشد.

اگر راه‌اندازی مجدد سیستم توصیه شود، یا هنگامی که با گزینه --services فراخوانی شده باشد و هر یک از سرویس‌های systemd نیاز به راه‌اندازی مجدد داشته باشند، دستور needs-restarting با کد خروج 1 پایان می‌یابد. اگر هیچ اقدامی توصیه نشود، needs-restarting با کد خروج 0 خارج خواهد شد.

گزینه‌ها (OPTIONS)

-p, --processes

فهرست کردن فرایندهایی که نیاز به راه‌اندازی مجدد دارند. اگر بسته‌ای که فایل اجرایی در حال اجرا را فراهم می‌کند یا هر یک از وابستگی‌های آن از زمان شروع فرایند به‌روزرسانی شده باشند، راه‌اندازی مجدد آن فرایند توصیه خواهد شد.

-e, --exclude-services

همراه با گزینه -p, --processes استفاده می‌شود و فرایندهایی را که توسط سرویس‌های systemd مدیریت می‌شوند فیلتر و حذف می‌کند.

-s, --services

فهرست کردن سرویس‌های systemd که نیاز به راه‌اندازی مجدد دارند. اگر بسته‌ای که سرویس را ارائه می‌دهد یا هر یک از وابستگی‌های آن از زمان شروع سرویس به‌روزرسانی شده باشند، راه‌اندازی مجدد آن سرویس توصیه خواهد شد. توجه داشته باشید که این رویکرد در پیشنهاد راه‌اندازی مجدد نسبتاً تهاجمی عمل می‌کند، حتی در مواقعی که راه‌اندازی مجدد اکیداً ضروری نباشد.

-r, --reboothint

هیچ تأثیری ندارد و صرفاً برای سازگاری با DNF 4 حفظ شده است. دستور "dnf4 needs-restarting -r" عملکردی مشابه با "dnf5 needs-restarting" ارائه می‌دهد.

--json

درخواست قالب خروجی JSON برای نتایج ماشین‌خوان.

خروجی JSON (JSON OUTPUT)

•: dnf5 needs-restarting --json

این دستور یک آرایه JSON شامل یک شیء منفرد حاوی اطلاعات راهنمای راه‌اندازی مجدد (reboot hint) برمی‌گرداند. این شیء شامل فیلدهای زیر است:

type (string) - نوع خروجی، همیشه برابر با "reboot".
reboot_required (boolean) - مشخص می‌کند که آیا به راه‌اندازی مجدد نیاز است یا خیر.
packages (array of strings) - فهرست بسته‌هایی که از زمان بالا آمدن سیستم به‌روزرسانی شده‌اند.
documentation (string) - پیوند به مستنداتی که دلیل لزوم راه‌اندازی مجدد را توضیح می‌دهد.

•: dnf5 needs-restarting --services --json

این دستور یک آرایه JSON از اشیاء برمی‌گرداند که هر شیء یک سرویس systemd را که نیاز به راه‌اندازی مجدد دارد توصیف می‌کند. هر شیء شامل فیلدهای زیر است:

type (string) - نوع خروجی، همیشه برابر با "unit".
unit (string) - نام سرویس systemd.

•: dnf5 needs-restarting --processes --json

این دستور یک آرایه JSON از اشیاء برمی‌گرداند که هر شیء یک فرایند در حال اجرا را که نیاز به راه‌اندازی مجدد دارد توصیف می‌کند. هر شیء شامل فیلدهای زیر است:

type (string) - نوع خروجی، همیشه برابر با "process".
pid (integer) - شناسه فرایند (Process ID).
cmdline (array of strings) - خط فرمان اجرای فرایند.
package (string) - بسته‌ای که فایل اجرایی را ارائه می‌دهد.

گزینه --json هنگام استفاده از --processes می‌تواند با --exclude-services ترکیب شود تا فرایندهای تحت مدیریت سرویس‌های systemd فیلتر و حذف شوند (مانند dnf5 needs-restarting --processes --exclude-services --json).

در صورت خالی بودن نتایج برای سرویس‌ها یا فرایندها، این دستورات مقدار [] را برمی‌گردانند. برای راهنمایی راه‌اندازی مجدد (reboot hint)، حتی اگر راه‌اندازی مجدد توصیه نشود، دستور یک آرایه JSON شامل یک شیء منفرد برمی‌گرداند که در آن reboot_required برابر با false، آرایه packages خالی و پیوند documentation قرار دارد.

نویسندگان (AUTHORS)

بخش AUTHORS.md را در توزیع منبع dnf5 ببینید.

حق نشر (COPYRIGHT)

مشارکت‌کنندگان در پروژه dnf5.