| DNF5-UPGRADE(8) | dnf5 | DNF5-UPGRADE(8) |
نام (NAME)
dnf5-upgrade - دستور ارتقای بستهها در DNF5
خلاصه دستور (SYNOPSIS)
dnf5 upgrade [options] [<package-spec-NPFB>|@<group-spec>|@<environment-spec>...]
توضیحات (DESCRIPTION)
دستور upgrade در DNF5 برای ارتقای بستهها، گروهها یا محیطهای نصبشده به نسخه جدیدتر موجود به کار میرود.
از آنجا که گروهها و محیطها دارای نسخه نیستند، ارتقای آنها اساساً به معنای همگامسازی با تعاریف موجود فعلی است. علاوه بر این، ارتقای گروه موجب ارتقای تمام بستههای موجود در آن گروه میشود و ارتقای محیط نیز تمامی گروههای موجود در آن محیط را ارتقا میدهد.
گزینهها (OPTIONS)
- --minimal
-
ارتقای بستهها فقط به پایینترین نسخههای موجود که توصیهنامههایی از نوع bugfix، enhancement، security یا newpackage را برطرف میکنند. در صورتی که از هر گزینهای برای محدود کردن توصیهنامهها استفاده شود، بستهها را فقط به پایینترین نسخههایی ارتقا میدهد که توصیهنامههای منطبق با ویژگیهای توصیهنامه انتخابشده را برطرف میکنند.
- --allowerasing
-
اجازه حذف بستههای نصبشده برای حل هرگونه مشکل وابستگی احتمالی.
- --skip-unavailable
-
اجازه نادیده گرفتن بستههایی که ارتقای آنها ممکن نیست. تمامی بستههای باقیمانده ارتقا داده خواهند شد.
- --allow-downgrade
-
فعالسازی امکان تنزل نسخه (downgrade) وابستگیها هنگام حل عملیات درخواستشده.
- --no-allow-downgrade
-
غیرفعالسازی امکان تنزل نسخه (downgrade) وابستگیها هنگام حل عملیات درخواستشده.
- --destdir=<path>
-
تعیین دایرکتوری مورد استفاده برای دانلود بستهها. مکان پیشفرض، دایرکتوری کاری فعلی است. این گزینه بهطور خودکار گزینه downloadonly را فعال میکند.
- --installed-from-repo=REPO_ID,...
-
فیلتر کردن بستههای نصبشده بر اساس شناسه مخزنی که از آن نصب شدهاند.
- --from-repo=REPO_ID,...
-
بستهها (یا قابلیتهای ارائهشده توسط آنها) که صریحاً در خط فرمان مشخص شدهاند، تنها در مخازن تعیینشده جستجو خواهند شد. این مخازن بهطور خودکار فعال میشوند. فعالسازی و غیرفعالسازی مخازن همچنان اعمال میشود. وابستگیهای این بستهها از هر مخزن فعالی حل خواهند شد.
- --from-vendor=VENDOR,...
-
فهرستی از ارائهدهندگان (توزیعکنندگان) جداشده با کاما یا فاصله. الگوهای تطبیق (Globs) پشتیبانی میشوند (مانند --from-vendor='Fedora\ project, vendorA, vendorB*, vendorC'). بستهها (یا قابلیتهای ارائهشده توسط آنها) که صریحاً در خط فرمان مشخص شدهاند، تنها از ارائهدهندگان تعیینشده جستجو خواهند شد. بررسی تغییر ارائهدهنده برای این بستهها نادیده گرفته میشود. ارائهدهنده نادیده گرفته میشود یا خطمشیهای تغییر ارائهدهنده (در صورت تنظیم allow_vendor_change=0) همچنان برای بستههایی که وابستگیها را برآورده میکنند استفاده خواهد شد.
- --downloadonly
-
فقط دانلود بستهها برای تراکنش (بدون اعمال تغییرات).
- --offline
-
ذخیره تراکنش برای اجرا بهصورت آفلاین. دستور offline را ببینید: <#offline-command-ref-label>، dnf5-offline(8).
- --transient
- تنها در سیستمهای bootc (کانتینرهای قابل بوت) کاربرد دارد. انجام تراکنشها با استفاده از یک لایه گذرا (transient overlay) که در راهاندازی مجدد بعدی از دست خواهد رفت. همچنین گزینه پیکربندی persistence را ببینید: <#persistence-options-label>.
- --store=PATH
-
ذخیره تراکنش فعلی در یک دایرکتوری در PATH مشخصشده بهجای اجرای آن. تراکنش ذخیرهشده را میتوان توسط دستور replay اجرا کرد: <#replay-command-ref-label>، dnf5-replay(8). توجه داشته باشید که شناسههای مخزن در تراکنش ذخیرهشده به @stored_transaction(repo_id) تغییر مییابند (mangled)؛ این کار لازم است زیرا هنگام بازپخش، مخازن ذخیرهشده دوباره ایجاد میشوند و ممکن است با مخازن موجود تداخل پیدا کنند (این مورد برای مخزن ویژه @System اعمال نمیشود).
- --advisories=ADVISORY_NAME,...
-
شامل محتوای موجود در توصیهنامهها (advisories) با نام مشخصشده. این یک گزینه از نوع فهرستی است. مقادیر مورد انتظار شناسههای توصیهنامه هستند، مانند FEDORA-2201-123. هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیهنامه در فهرست با خطا مواجه خواهد شد؛ این مورد را میتوان با استفاده از سوییچ --skip-unavailable دور زد.
- --advisory-severities=ADVISORY_SEVERITY,...
-
شامل محتوای موجود در توصیهنامهها با سطح اهمیت (severity) مشخصشده. این یک گزینه از نوع فهرستی است. مقادیر پذیرفتهشده عبارتند از: critical، important، moderate، low، none.
- --bzs=BUGZILLA_ID,...
-
شامل محتوای موجود در توصیهنامههایی که تیکتی با شناسه Bugzilla دادهشده را برطرف میکنند. این یک گزینه از نوع فهرستی است. مقادیر مورد انتظار شناسههای عددی هستند، مانند 123123. هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیهنامهای برای برطرف کردن تیکت دادهشده با خطا مواجه خواهد شد؛ این مورد را میتوان با استفاده از سوییچ --skip-unavailable دور زد.
- --cves=CVE_ID,...
-
شامل محتوای موجود در توصیهنامههایی که تیکتی با شناسه CVE (Common Vulnerabilities and Exposures) دادهشده را برطرف میکنند. این یک گزینه از نوع فهرستی است. مقادیر مورد انتظار شناسههای رشتهای در قالب CVE هستند، مانند CVE-2201-0123. هر دستور تراکنش (install، upgrade) در صورت عدم وجود توصیهنامهای برای برطرف کردن تیکت دادهشده با خطا مواجه خواهد شد؛ این مورد را میتوان با استفاده از سوییچ --skip-unavailable دور زد.
- --security
-
شامل محتوای موجود در توصیهنامههای امنیتی.
- --bugfix
-
شامل محتوای موجود در توصیهنامههای رفع باگ.
- --enhancement
-
شامل محتوای موجود در توصیهنامههای بهبود و ارتقا.
- --newpackage
-
شامل محتوای موجود در توصیهنامههای بسته جدید.
مثالها (EXAMPLES)
- dnf5 upgrade
-
ارتقای تمام بستههای نصبشده به جدیدترین نسخه موجود.
- dnf5 upgrade tito
-
ارتقای بسته tito.
همچنین ببینید (SEE ALSO)
dnf5-advisory(8)، دستور توصیهنامه <#advisory-command-ref-label> dnf5-specs(7)، مشخصات الگوها <#specs-misc-ref-label>
نویسندگان (AUTHORS)
فایل AUTHORS.md را در توزیع سورسکد dnf5 ببینید.
حق نشر (COPYRIGHT)
مشارکتکنندگان پروژه dnf5.
| September 6, 2026 |