.\" 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-ENVIRONMENT" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-environment \- دستور محیط‌ها (Environment) در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 environment {list|info} [options] [<environment\-spec>...]\fP
.sp
\fBdnf5 environment {install|remove|upgrade} [options] <group\-spec|environment\-spec>...\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBenvironment\fP در \fBDNF5\fP چندین پرس‌وجو برای دریافت اطلاعات درباره محیط‌ها و گروه‌های مرتبط با آن‌ها ارائه می‌دهد و همچنین برای نصب محیط‌ها به کار می‌رود. برای پرس‌وجوی گروه‌ها، از دستور جداگانه \fBgroup\fP استفاده کنید.
.sp
آرگومان‌های اختیاری \fBenvironment\-spec\fP را می‌توان برای فیلتر کردن محیط‌ها با شناسه یا نام‌های مشخص‌شده ارسال کرد. دستورات install، remove و upgrade هم \fBenvironment\-spec\fP و هم \fBgroup\-spec\fP را می‌پذیرند، اما در صورتی که هم محیط‌ها و هم گروه‌ها مطابقت داشته باشند، تنها محیط‌ها تحت تأثیر قرار می‌گیرند.
.SH "زیردستورها (SUBCOMMANDS)"
.INDENT 0.0
.TP
.B \fBlist\fP
فهرست کردن تمام محیط‌های منطبق، چه در میان محیط‌های نصب‌شده و چه محیط‌های موجود (در دسترس). اگر چیزی مشخص نشود، تمام محیط‌های شناخته‌شده فهرست می‌شوند. گزینه‌های \fB\-\-installed\fP و \fB\-\-available\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
.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 environment list\fP
.nf
نمایش فهرستی از تمام محیط‌ها.
.fi
.sp
.TP
.B \fBdnf5 environment info \(dqKDE Plasma Workspaces\(dq\fP
.nf
نمایش اطلاعات دقیق درباره محیط \fBKDE\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.