DNF5-DO(8)                           dnf5                           DNF5-DO(8)

نام (NAME)
       dnf5-do - اجرای چندین عملیات مدیریت بسته در یک تراکنش واحد در DNF5

خلاصه دستور (SYNOPSIS)
       dnf5 do [options] [arguments]

توضیحات (DESCRIPTION)
       دستور do یک دستور جامع برای مدیریت بسته‌ها در DNF5 است. این دستور به
       کاربر امکان می‌دهد چندین عملیات مختلف (install، remove، upgrade،
       downgrade و reinstall) را تعیین کند.

       برخلاف اجرای مجموعه‌ای از دستورات مجزا (install، remove، upgrade،
       downgrade و reinstall)، دستور do تمام عملیات درخواستی را با هم مدیریت
       کرده و آن‌ها را در یک تراکنش منفرد اجرا می‌کند.  این امر موجب ساده‌سازی
       عملیات پیچیده و افزایش کارایی آن‌ها می‌شود.

       تفاوت دیگر این است که دستور do امکان تعیین صریح نوع اشیاء در تراکنش را
       فراهم می‌کند: package، group یا auto. برای نوع group، می‌توان مشخص کرد که
       شناسه گروه (group ID) یا نام گروه (group name) استفاده شود. به‌طور
       پیش‌فرض، نوع auto فعال است. در این حالت، دستور do مانند سایر دستورات
       رفتار کرده و نوع شیء را از روی مشخصه آن استنباط می‌کند. برای مثال، اگر
       یک مشخصه با نویسه @ آغاز شود، به‌عنوان شناسه گروه یا یک ماژول در نظر
       گرفته می‌شود.

       عملیات مجزا و انواع اشیاء از طریق گزینه‌ها تعیین می‌شوند و با یکدیگر قابل
       ترکیب هستند.

       سایر گزینه‌ها معنا و کاربردی مشابه با دستورات متناظر (install، remove،
       upgrade، downgrade و reinstall) دارند. استثناها گزینه‌های
       --installed-from-repo و --from-repo هستند. اگرچه این گزینه‌ها معنای
       یکسانی دارند، اما تنها بر بسته‌هایی اعمال می‌شوند که پس از آن‌ها در خط
       فرمان قرار گیرند.  علاوه بر این، می‌توان آن‌ها را با مقادیر مختلف تکرار
       کرد.

گزینه‌ها (OPTIONS)

       --action
              عملیاتی که باید روی موارد بعدی انجام شود.


              این گزینه اجباری است و باید پیش از موارد (اشیاء) تراکنش قرار
              گیرد. دستور do به این اطلاعات نیاز دارد تا بداند چه عملیاتی را
              روی موارد مشخص‌شده انجام دهد.  پشتیبانی می‌کند از: install،
              remove، upgrade، downgrade، reinstall.

       --type
              نوع موارد بعدی.


              پشتیبانی می‌کند از: auto، package، group. حالت auto پیش‌فرض است
              مگر اینکه از گزینه type استفاده شود.

       --allowerasing
              اجازه به حذف بسته‌های نصب‌شده برای برطرف‌سازی هرگونه مشکل احتمالی در وابستگی‌ها.


       --skip-broken
              حل مشکلات وابستگی از طریق حذف بسته‌های مشکل‌ساز از تراکنش.


       --skip-unavailable
              اجازه به صرف‌نظر کردن از بسته‌هایی که در مخازن در دسترس نیستند. تمام بسته‌های موجود نصب خواهند شد.


       --allow-downgrade
              فعال‌سازی دانگرید (برگشت به نسخه قبلی) وابستگی‌ها هنگام حل عملیات درخواستی.


       --no-allow-downgrade
              غیرفعال‌سازی دانگرید وابستگی‌ها هنگام حل عملیات درخواستی.


       --installed-from-repo=REPO_ID,...
              فیلتر کردن بسته‌های نصب‌شده بر اساس شناسه مخزنی که از آن نصب شده‌اند.


       --from-repo=REPO_ID,...
              بسته‌ها (یا قابلیت‌های ارائه‌شده توسط آن‌ها) که صریحاً در خط فرمان مشخص شده‌اند، تنها در مخازن تعیین‌شده جستجو می‌شوند.
              این مخازن به‌طور خودکار فعال می‌گردند.
              قواعد فعال‌سازی و غیرفعال‌سازی مخازن همچنان برقرار است. وابستگی‌های این بسته‌ها از هر مخزن فعال حل خواهند شد.


       --from-vendor=VENDOR,...
              فهرستی از ارائه‌دهندگان که با کاما یا فاصله جدا شده‌اند. الگوهای تطبیق (Globs) پشتیبانی می‌شوند (مانند --from-vendor='Fedora\ project, vendorA, vendorB*, vendorC').
              بسته‌ها (یا قابلیت‌های ارائه‌شده توسط آن‌ها) که صریحاً در خط فرمان مشخص شده‌اند، تنها از ارائه‌دهندگان تعیین‌شده جستجو خواهند شد.
              بررسی تغییر ارائه‌دهنده برای این بسته‌ها نادیده گرفته می‌شود (bypassed).
              برای بسته‌هایی که وابستگی‌ها را برآورده می‌کنند، ارائه‌دهنده نادیده گرفته شده یا سیاست‌های تغییر ارائه‌دهنده (در صورت تنظیم allow_vendor_change=0) همچنان اعمال خواهد شد.


       --downloadonly
              بارگیری مجموعه بسته‌های حل‌شده بدون اجرای یک تراکنش RPM.


       --offline
              ذخیره تراکنش برای اجرا به‌صورت برون‌خط (آفلاین). دستور dnf5-offline(8)، بخش Offline command <#offline-command-ref-label> را ببینید.


       --transient
              تنها روی سیستم‌های bootc (کانتینرهای قابل بوت) کاربرد دارد. اجرای
              تراکنش‌ها با استفاده از یک لایه روگرفت گذرا (transient overlay)
              که در راه‌اندازی بعدی سیستم از بین می‌رود. همچنین گزینه پیکربندی
              persistence <#persistence-options-label> را ببینید.

       --advisories=ADVISORY_NAME,...
              شامل کردن محتوای موجود در توصیه‌نامه‌ها (advisories) با نام مشخص‌شده.
              این یک گزینه از نوع فهرستی است.
              مقادیر مورد انتظار شناسه‌های توصیه‌نامه هستند؛ مانند FEDORA-2201-123.
              هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای در فهرست موجود نباشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ --skip-unavailable قابل رد کردن است.


       --advisory-severities=ADVISORY_SEVERITY,...
              شامل کردن محتوای موجود در توصیه‌نامه‌ها با سطح اهمیت مشخص‌شده.
              این یک گزینه از نوع فهرستی است.
              مقادیر پذیرفته‌شده عبارتند از: critical، important، moderate، low، none.


       --bzs=BUGZILLA_ID,...
              شامل کردن محتوای موجود در توصیه‌نامه‌هایی که تیکت مربوط به شناسه باگزیلای (Bugzilla ID) داده‌شده را برطرف می‌کنند.
              این یک گزینه از نوع فهرستی است.
              مقادیر مورد انتظار شناسه‌های عددی هستند؛ مانند 123123.
              هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای برای برطرف کردن تیکت مشخص‌شده وجود نداشته باشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ --skip-unavailable قابل رد کردن است.


       --cves=CVE_ID,...
              شامل کردن محتوای موجود در توصیه‌نامه‌هایی که تیکت مربوط به شناسه آسیب‌پذیری و افشای عمومی (CVE) داده‌شده را برطرف می‌کنند.
              این یک گزینه از نوع فهرستی است.
              مقادیر مورد انتظار شناسه‌های متنی در قالب CVE هستند؛ مانند CVE-2201-0123.
              هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای برای برطرف کردن تیکت مشخص‌شده وجود نداشته باشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ --skip-unavailable قابل رد کردن است.


       --security
              شامل کردن محتوای موجود در توصیه‌نامه‌های امنیتی.


       --bugfix
              شامل کردن محتوای موجود در توصیه‌نامه‌های رفع اشکال.


       --enhancement
              شامل کردن محتوای موجود در توصیه‌نامه‌های بهبود و قابلیت‌های افزوده.


       --newpackage
              شامل کردن محتوای موجود در توصیه‌نامه‌های بسته‌های جدید.


مثال‌ها (EXAMPLES)

       dnf5 do --action=install tito
              نصب بسته tito.

       dnf5 do --action=remove sddm-wayland-plasma --action=install sddm-x11
              جایگزینی بسته sddm-wayland-plasma با sddm-x11.

       dnf5 do --action=install --type=group id=office 'name=Games and
       Entertainment' --type=package iftop --action=remove atop
              نصب گروه office (با شناسه)، گروه Games and Entertainment (با
              نام)، و بسته iftop، و حذف بسته atop.

       dnf5 do --action=install pkg --from-repo=myrepo1 pkg1
       --from-repo=myrepo2 pkg2 --action=remove
       --installed-from-repo=compromised_repo '*'
              نصب بسته pkg از هر یک از مخازن فعال، به همراه بسته pkg1 از مخزن
              myrepo1 و بسته pkg2 از مخزن myrepo2. وابستگی‌های این بسته‌ها از هر
              مخزن فعالی حل و نصب می‌شوند. علاوه بر این، حذف تمام بسته‌های
              نصب‌شده از مخزن compromised_repo.

همچنین ببینید (SEE ALSO)
          dnf5-install(8)، دستور Install <#install-command-ref-label>
          dnf5-remove(8)، دستور Remove <#remove-command-ref-label>
          dnf5-upgrade(8)، دستور Upgrade <#upgrade-command-ref-label>
          dnf5-downgrade(8)، دستور Downgrade <#downgrade-command-ref-label>
          dnf5-reinstall(8)، دستور Reinstall <#reinstall-command-ref-label>
          dnf5-advisory(8)، دستور Advisory <#advisory-command-ref-label>
          dnf5-specs(7)، مشخصات الگوها <#specs-misc-ref-label>


نویسنده (AUTHOR)
       AUTHORS.md را در توزیع کد منبع dnf5 ببینید.

حق نشر (COPYRIGHT)
       مشارکت‌کنندگان در پروژه dnf5.

                               September 6, 2026                    DNF5-DO(8)