.\" 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-GROUP" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-group \- دستور گروه‌ها (Group) در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 group {list|info} [options] [<group\-spec>...]\fP
.sp
\fBdnf5 group {install|remove|upgrade} [options] <group\-spec|environment\-spec>...\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgroup\fP در \fBDNF5\fP چندین پرس‌وجو برای دریافت اطلاعات درباره گروه‌ها و بسته‌های مرتبط با آن‌ها ارائه می‌دهد و همچنین برای نصب گروه‌ها به کار می‌رود.
برای پرس‌وجوی محیط‌ها، از دستور جداگانه \fBenvironment\fP استفاده کنید.
نکته: در \fBdnf\-4\fP هم محیط‌ها و هم گروه‌ها با دستور \fBgroup\fP فهرست می‌شدند.
.sp
آرگومان‌های اختیاری \fBgroup\-spec\fP را می‌توان برای فیلتر کردن گروه‌ها با شناسه یا نام‌های مشخص‌شده ارسال کرد. دستورات install، remove و upgrade هم \fBgroup\-spec\fP و هم \fBenvironment\-spec\fP را می‌پذیرند، اما در صورتی که هم گروه‌ها و هم محیط‌ها مطابقت داشته باشند، تنها گروه‌ها تحت تأثیر قرار می‌گیرند.
.SH "زیردستورها (SUBCOMMANDS)"
.INDENT 0.0
.TP
.B \fBlist\fP
فهرست کردن تمام گروه‌های منطبق، چه در میان گروه‌های نصب‌شده و چه گروه‌های موجود (در دسترس). اگر چیزی مشخص نشود، تمام گروه‌های شناخته‌شده فهرست می‌شوند. گزینه‌های \fB\-\-installed\fP و \fB\-\-available\fP فهرست درخواستی را محدود می‌کنند. اگر از گزینه \fB\-\-hidden\fP استفاده شود، گروه‌های پنهان نیز در فهرست گنجانده می‌شوند.
.TP
.B \fBinfo\fP
چاپ اطلاعات دقیق درباره گروه‌ها.
این دستور همان گزینه‌های زیردستور \fBlist\fP را می‌پذیرد.
.TP
.B \fBinstall\fP
علامت‌گذاری محیط‌ها یا گروه‌های مشخص‌شده به‌عنوان نصب‌شده و نصب گروه‌ها و بسته‌هایی که شامل می‌شوند.
.sp
اگر یک محیط یا گروه از قبل (به‌طور جزئی) نصب شده باشد، این دستور گروه‌ها و بسته‌های مفقود و ناموجود در آن را نصب می‌کند.
.sp
در صورتی که هم گروه‌ها و هم محیط‌ها مطابقت داشته باشند، تنها گروه‌ها تحت تأثیر قرار می‌گیرند.
.sp
برای محیط‌ها، تمام گروه‌ها از فهرست گروه‌های آن‌ها (grouplist) و گروه‌های پیش‌فرض از فهرست گزینه‌های اختیاری آن‌ها (optionlist) نصب می‌شوند.
.sp
اگر گزینه \fB\-\-with\-optional\fP استفاده شود، بسته‌های اختیاری (\fBOptional\fP) گروه‌ها نیز شامل می‌شوند. به‌طور پیش‌فرض، تمام بسته‌های اجباری (\fBMandatory\fP) و پیش‌فرض (\fBDefault\fP) در صورت امکان نصب خواهند شد. بسته‌های شرطی (\fBConditional\fP) در صورتی نصب می‌شوند که نیازمندی‌های آن‌ها برآورده شود. این مورد می‌تواند از طریق group_package_types در \fBdnf5.conf(5)\fP \%<#\:group-package-types-options-label>\& پیکربندی شود.
.sp
اگر گزینه \fB\-\-no\-packages\fP استفاده شود، هیچ بسته‌ای توسط این دستور نصب نخواهد شد. تنها بسته‌های گروهی که در حال حاضر نصب هستند به‌عنوان نصب‌شده با گروه‌ها در نظر گرفته می‌شوند.
.TP
.B \fBremove\fP
علامت‌گذاری محیط‌ها یا گروه‌های مشخص‌شده به‌عنوان حذف‌شده و حذف گروه‌ها و بسته‌هایی که شامل می‌شوند، مگر اینکه به یک محیط یا گروه نصب‌شده دیگر تعلق داشته باشند، به صورت صریح توسط کاربر نصب شده باشند یا (در مورد بسته‌ها) به‌عنوان یک وابستگی نصب شده باشند.
.sp
در صورتی که هم گروه‌ها و هم محیط‌ها مطابقت داشته باشند، تنها گروه‌ها تحت تأثیر قرار می‌گیرند.
.sp
اگر گزینه \fB\-\-no\-packages\fP استفاده شود، هیچ بسته‌ای توسط این دستور حذف نخواهد شد.
.TP
.B \fBupgrade\fP
ارتقای تعریف محیط‌ها و گروه‌های مشخص‌شده و گروه‌ها و بسته‌هایی که شامل می‌شوند. اگر گروه‌ها یا بسته‌های جدیدی از زمان نصب محیط‌ها یا گروه‌ها به تعاریف فعلی اضافه شده باشند، گروه‌ها و بسته‌های جدید نصب خواهند شد. به همین ترتیب، اگر برخی از گروه‌ها یا بسته‌ها از تعریف حذف شده باشند، آن‌ها حذف خواهند شد مگر اینکه به دلیل دیگری نصب شده باشند (متعلق به محیط یا گروه نصب‌شده دیگری باشند، به صورت صریح توسط کاربر نصب شده باشند یا به‌عنوان یک وابستگی نصب شده باشند).
.sp
در صورتی که هم گروه‌ها و هم محیط‌ها مطابقت داشته باشند، تنها گروه‌ها تحت تأثیر قرار می‌گیرند.
.UNINDENT
.SH "گزینه‌های LIST و INFO (OPTIONS FOR LIST AND INFO)"
.INDENT 0.0
.TP
.B \fB\-\-available\fP
.nf
نمایش تنها گروه‌های موجود (در دسترس)؛ آن‌هایی که نصب نشده‌اند اما برای \fBDNF5\fP شناخته‌شده هستند\&.
.fi
.sp
.TP
.B \fB\-\-installed\fP
.nf
نمایش تنها گروه‌های نصب‌شده\&.
.fi
.sp
.TP
.B \fB\-\-hidden\fP
.nf
نمایش گروه‌های پنهان\&.
.fi
.sp
.TP
.B \fB\-\-contains\-pkgs=PACKAGE_NAME,...\fP
.nf
نمایش تنها گروه‌هایی که شامل بسته‌هایی با نام‌های مشخص‌شده هستند. این یک گزینه فهرستی است و از الگوهای تطبیق (globs) پشتیبانی می‌کند\&.
.fi
.sp
.UNINDENT
.SH "گزینه‌های INSTALL، REMOVE و UPGRADE (OPTIONS FOR INSTALL, REMOVE AND UPGRADE)"
.INDENT 0.0
.TP
.B \fB\-\-with\-optional\fP
.nf
شامل کردن بسته‌های اختیاری از گروه‌ها.
با دستور \fBinstall\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-no\-packages\fP
.nf
عمل کردن منحصراً بر روی محیط‌ها و گروه‌ها بدون دستکاری هیچ‌گونه بسته‌ای.
با دستورات \fBinstall\fP و \fBremove\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-allowerasing\fP
.nf
اجازه دادن به حذف بسته‌های نصب‌شده برای حل هرگونه مشکل احتمالی وابستگی.
با دستورات \fBinstall\fP و \fBupgrade\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-skip\-broken\fP
.nf
حل هرگونه مشکل وابستگی با حذف بسته‌های ایجادکننده مشکل از تراکنش.
با دستور \fBinstall\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-skip\-unavailable\fP
.nf
اجازه نادیده گرفتن بسته‌هایی که امکان نصب یا ارتقای آن‌ها وجود ندارد.
با دستورات \fBinstall\fP و \fBupgrade\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-allow\-downgrade\fP
.nf
فعال‌سازی امکان تنزل نسخه (downgrade) وابستگی‌ها هنگام حل عملیات درخواستی.
با دستورات \fBinstall\fP و \fBupgrade\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-no\-allow\-downgrade\fP
.nf
غیرفعال‌سازی امکان تنزل نسخه (downgrade) وابستگی‌ها هنگام حل عملیات درخواستی.
با دستورات \fBinstall\fP و \fBupgrade\fP استفاده می‌شود.
.fi
.sp
.TP
.B \fB\-\-downloadonly\fP
.nf
دانلود مجموعه بسته‌های حل‌شده بدون اجرای تراکنش RPM.
با دستورات \fBinstall\fP و \fBupgrade\fP استفاده می‌شود.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-offline\fP
.nf
ذخیره تراکنش برای اجرا به‌صورت آفلاین. دستور offline در \%<#\:offline-command-ref-label>، \fBdnf5\-offline(8)\fP\& را ببینید.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-transient\fP
تنها در سیستم‌های bootc (کانتینرهای قابل بوت) قابل اعمال است. انجام تراکنش‌ها با استفاده از یک لایه موقت (transient overlay) که در راه‌اندازی مجدد بعدی از بین خواهد رفت. همچنین گزینه پیکربندی persistence \%<#\:persistence-options-label> را ببینید.
.TP
.B \fB\-\-store=PATH\fP
.nf
ذخیره تراکنش جاری در یک دایرکتوری در \fBPATH\fP مشخص‌شده به‌جای اجرای آن.
تراکنش ذخیره‌شده را می‌توان با دستور replay در \%<#\:replay-command-ref-label>، \fBdnf5\-replay(8)\fP\& انجام داد.
توجه داشته باشید که شناسه مخازن در تراکنش ذخیره‌شده به \fB@stored_transaction(repo_id)\fP تغییر می‌یابند؛ این امر ضروری است
زیرا در طول بازپخش، مخازن ذخیره‌شده بازسازی می‌شوند و ممکن است با مخازن موجود تداخل پیدا کنند
(این مورد برای مخزن ویژه @System اعمال نمی‌شود).
.fi
.sp
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B \fBdnf5 group list \-\-hidden\fP
.nf
نمایش فهرستی از تمام گروه‌ها، از جمله گروه‌های پنهان.
.fi
.sp
.TP
.B \fBdnf5 group info *xfce*\fP
.nf
نمایش اطلاعات دقیق درباره تمام گروه‌های مرتبط با \fBXfce\fP\&.
.fi
.sp
.TP
.B \fBdnf5 group install mysql \-\-with\-optional\fP
.nf
نصب گروه \fBmysql\fP شامل بسته‌های اختیاری.
.fi
.sp
.TP
.B \fBdnf5 group upgrade mysql\fP
.nf
تطبیق بسته‌های گروه \fBmysql\fP با تعریف فعلی این گروه.
.fi
.sp
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-comps(7)\fP, گروه‌ها و محیط‌های Comps \%<#\:comps-misc-ref-label>
\fBdnf5\-specs(7)\fP, مشخصات الگوها \%<#\:specs-misc-ref-label>
.fi
.sp
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
فایل AUTHORS.md را در توزیع منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان در پروژه dnf5.
.\" End of generated man page.