.\" 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-DO" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5\-do \- اجرای چندین عملیات مدیریت بسته در یک تراکنش واحد در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 do [options] [arguments]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBdo\fP یک دستور جامع برای مدیریت بسته‌ها در DNF5 است. این دستور به کاربر امکان می‌دهد چندین
عملیات مختلف (\fBinstall\fP، \fBremove\fP، \fBupgrade\fP، \fBdowngrade\fP و \fBreinstall\fP) را تعیین کند.
.sp
برخلاف اجرای مجموعه‌ای از دستورات مجزا (\fBinstall\fP، \fBremove\fP، \fBupgrade\fP، \fBdowngrade\fP و \fBreinstall\fP)،
دستور \fBdo\fP تمام عملیات درخواستی را با هم مدیریت کرده و آن‌ها را در یک تراکنش منفرد اجرا می‌کند.
این امر موجب ساده‌سازی عملیات پیچیده و افزایش کارایی آن‌ها می‌شود.
.sp
تفاوت دیگر این است که دستور \fBdo\fP امکان تعیین صریح نوع اشیاء در تراکنش را فراهم می‌کند:
\fBpackage\fP، \fBgroup\fP یا \fBauto\fP\&. برای نوع \fBgroup\fP، می‌توان مشخص کرد که شناسه گروه (group ID)
یا نام گروه (group name) استفاده شود. به‌طور پیش‌فرض، نوع \fBauto\fP فعال است. در این حالت، دستور \fBdo\fP
مانند سایر دستورات رفتار کرده و نوع شیء را از روی مشخصه آن استنباط می‌کند. برای مثال، اگر یک مشخصه
با نویسه \fB@\fP آغاز شود، به‌عنوان شناسه گروه یا یک ماژول در نظر گرفته می‌شود.
.sp
عملیات مجزا و انواع اشیاء از طریق گزینه‌ها تعیین می‌شوند و با یکدیگر قابل ترکیب هستند.
.sp
سایر گزینه‌ها معنا و کاربردی مشابه با دستورات متناظر (\fBinstall\fP، \fBremove\fP، \fBupgrade\fP، \fBdowngrade\fP
و \fBreinstall\fP) دارند. استثناها گزینه‌های \fB\-\-installed\-from\-repo\fP و \fB\-\-from\-repo\fP هستند. اگرچه این
گزینه‌ها معنای یکسانی دارند، اما تنها بر بسته‌هایی اعمال می‌شوند که پس از آن‌ها در خط فرمان قرار گیرند.
علاوه بر این، می‌توان آن‌ها را با مقادیر مختلف تکرار کرد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-\-action\fP
.nf
عملیاتی که باید روی موارد بعدی انجام شود.
.fi
.sp
.sp
این گزینه اجباری است و باید پیش از موارد (اشیاء) تراکنش قرار گیرد. دستور do به
این اطلاعات نیاز دارد تا بداند چه عملیاتی را روی موارد مشخص‌شده انجام دهد.
پشتیبانی می‌کند از: \fBinstall\fP، \fBremove\fP، \fBupgrade\fP، \fBdowngrade\fP، \fBreinstall\fP\&.
.TP
.B \fB\-\-type\fP
.nf
نوع موارد بعدی.
.fi
.sp
.sp
پشتیبانی می‌کند از: \fBauto\fP، \fBpackage\fP، \fBgroup\fP\&. حالت \fBauto\fP پیش‌فرض است مگر اینکه از گزینه \fBtype\fP استفاده شود.
.TP
.B \fB\-\-allowerasing\fP
.nf
اجازه به حذف بسته‌های نصب‌شده برای برطرف‌سازی هرگونه مشکل احتمالی در وابستگی‌ها.
.fi
.sp
.TP
.B \fB\-\-skip\-broken\fP
.nf
حل مشکلات وابستگی از طریق حذف بسته‌های مشکل‌ساز از تراکنش.
.fi
.sp
.TP
.B \fB\-\-skip\-unavailable\fP
.nf
اجازه به صرف‌نظر کردن از بسته‌هایی که در مخازن در دسترس نیستند. تمام بسته‌های موجود نصب خواهند شد.
.fi
.sp
.TP
.B \fB\-\-allow\-downgrade\fP
.nf
فعال‌سازی دانگرید (برگشت به نسخه قبلی) وابستگی‌ها هنگام حل عملیات درخواستی.
.fi
.sp
.TP
.B \fB\-\-no\-allow\-downgrade\fP
.nf
غیرفعال‌سازی دانگرید وابستگی‌ها هنگام حل عملیات درخواستی.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
.nf
فیلتر کردن بسته‌های نصب‌شده بر اساس شناسه مخزنی که از آن نصب شده‌اند.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-from\-repo=REPO_ID,...\fP
.nf
بسته‌ها (یا قابلیت‌های ارائه‌شده توسط آن‌ها) که صریحاً در خط فرمان مشخص شده‌اند، تنها در مخازن تعیین‌شده جستجو می‌شوند.
این مخازن به‌طور خودکار فعال می‌گردند.
قواعد فعال‌سازی و غیرفعال‌سازی مخازن همچنان برقرار است. وابستگی‌های این بسته‌ها از هر مخزن فعال حل خواهند شد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-from\-vendor=VENDOR,...\fP
.nf
فهرستی از ارائه‌دهندگان که با کاما یا فاصله جدا شده‌اند. الگوهای تطبیق (Globs) پشتیبانی می‌شوند (مانند \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
بسته‌ها (یا قابلیت‌های ارائه‌شده توسط آن‌ها) که صریحاً در خط فرمان مشخص شده‌اند، تنها از ارائه‌دهندگان تعیین‌شده جستجو خواهند شد.
بررسی تغییر ارائه‌دهنده برای این بسته‌ها \fBنادیده گرفته می‌شود (bypassed)\fP.
برای بسته‌هایی که وابستگی‌ها را برآورده می‌کنند، ارائه‌دهنده نادیده گرفته شده یا سیاست‌های تغییر ارائه‌دهنده (در صورت تنظیم \fBallow_vendor_change=0\fP) همچنان اعمال خواهد شد.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-downloadonly\fP
.nf
بارگیری مجموعه بسته‌های حل‌شده بدون اجرای یک تراکنش RPM.
.fi
.sp
.TP
.B \fB\-\-offline\fP
.nf
ذخیره تراکنش برای اجرا به‌صورت برون‌خط (آفلاین). دستور \fBdnf5\-offline(8)\fP، بخش Offline command \%<#\:offline-command-ref-label>\& را ببینید.
.fi
.sp
.TP
.B \fB\-\-transient\fP
تنها روی سیستم‌های bootc (کانتینرهای قابل بوت) کاربرد دارد. اجرای تراکنش‌ها با استفاده از یک لایه روگرفت گذرا (transient overlay) که در راه‌اندازی بعدی سیستم از بین می‌رود. همچنین گزینه پیکربندی persistence \%<#\:persistence-options-label> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-advisories=ADVISORY_NAME,...\fP
.nf
شامل کردن محتوای موجود در توصیه‌نامه‌ها (advisories) با نام مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های توصیه‌نامه هستند؛ مانند \fIFEDORA\-2201\-123\fP\&.
هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای در فهرست موجود نباشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ \-\-skip\-unavailable قابل رد کردن است.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
.nf
شامل کردن محتوای موجود در توصیه‌نامه‌ها با سطح اهمیت مشخص‌شده.
این یک گزینه از نوع فهرستی است.
مقادیر پذیرفته‌شده عبارتند از: \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 ID) داده‌شده را برطرف می‌کنند.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های عددی هستند؛ مانند \fI123123\fP\&.
هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای برای برطرف کردن تیکت مشخص‌شده وجود نداشته باشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ \-\-skip\-unavailable قابل رد کردن است.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-cves=CVE_ID,...\fP
.nf
شامل کردن محتوای موجود در توصیه‌نامه‌هایی که تیکت مربوط به شناسه آسیب‌پذیری و افشای عمومی (CVE) داده‌شده را برطرف می‌کنند.
این یک گزینه از نوع فهرستی است.
مقادیر مورد انتظار شناسه‌های متنی در قالب CVE هستند؛ مانند \fICVE\-2201\-0123\fP\&.
هر دستور تراکنش (نصب، ارتقا) در صورتی که توصیه‌نامه‌ای برای برطرف کردن تیکت مشخص‌شده وجود نداشته باشد با خطا مواجه خواهد شد؛ این مورد با استفاده از سوییچ \-\-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
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B \fBdnf5 do \-\-action=install tito\fP
نصب بسته \fBtito\fP.
.TP
.B \fBdnf5 do \-\-action=remove sddm\-wayland\-plasma \-\-action=install sddm\-x11\fP
جایگزینی بسته \fBsddm\-wayland\-plasma\fP با \fBsddm\-x11\fP\&.
.TP
.B \fBdnf5 do \-\-action=install \-\-type=group id=office \(aqname=Games and Entertainment\(aq \-\-type=package iftop \-\-action=remove atop\fP
نصب گروه \fBoffice\fP (با شناسه)، گروه \fBGames and Entertainment\fP (با نام)، و بسته \fBiftop\fP، و حذف بسته \fBatop\fP.
.TP
.B \fBdnf5 do \-\-action=install pkg \-\-from\-repo=myrepo1 pkg1 \-\-from\-repo=myrepo2 pkg2 \-\-action=remove \-\-installed\-from\-repo=compromised_repo \(aq*\(aq\fP
نصب بسته \fBpkg\fP از هر یک از مخازن فعال، به همراه بسته \fBpkg1\fP از مخزن \fBmyrepo1\fP و بسته \fBpkg2\fP از مخزن \fBmyrepo2\fP. وابستگی‌های این بسته‌ها از هر مخزن فعالی حل و نصب می‌شوند. علاوه بر این، حذف تمام بسته‌های نصب‌شده از مخزن \fBcompromised_repo\fP\&.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-install(8)\fP، دستور Install \%<#\:install-command-ref-label>
\fBdnf5\-remove(8)\fP، دستور Remove \%<#\:remove-command-ref-label>
\fBdnf5\-upgrade(8)\fP، دستور Upgrade \%<#\:upgrade-command-ref-label>
\fBdnf5\-downgrade(8)\fP، دستور Downgrade \%<#\:downgrade-command-ref-label>
\fBdnf5\-reinstall(8)\fP، دستور Reinstall \%<#\:reinstall-command-ref-label>
\fBdnf5\-advisory(8)\fP، دستور Advisory \%<#\:advisory-command-ref-label>
\fBdnf5\-specs(7)\fP، مشخصات الگوها \%<#\:specs-misc-ref-label>
.fi
.sp
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
AUTHORS.md را در توزیع کد منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان در پروژه dnf5.
.\" End of generated man page.