.\" 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.CONF-VENDORPOLICY-V1_0" "5" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5.conf-vendorpolicy-v1_0 \- مرجع فایل شیوه‌نامه تغییر ارائه‌دهنده DNF5 \- نسخه ۱.۰
.SH "توضیحات (DESCRIPTION)"
.sp
این سند ساختار و نحو (syntax) فایل‌های پیکربندی شیوه‌نامه تغییر ارائه‌دهنده DNF5 را با استفاده از قالب
\fBنسخه 1.0\fP
توضیح می‌دهد.
.sp
برای اطلاعات کلی درباره فایل‌های شیوه‌نامه تغییر ارائه‌دهنده، مرجع فایل شیوه‌نامه تغییر ارائه‌دهنده DNF5 \%<#\:dnf5-vendor-change-policy-label>\& را ببینید.
.SH "ساختار فایل (FILE STRUCTURE)"
.SS "فیلدهای الزامی (Required Fields)"
.INDENT 0.0
.TP
.B \fBversion\fP
رشته
.sp
نسخه قالب فایل پیکربندی.
.sp
برای این قالب، باید روی
\fB\(dq1.0\(dq\fP\&
تنظیم شود.
.sp
این فیلد الزامی است و باید در بالاترین سطح فایل TOML مشخص شود.
.sp
مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
version = \(aq1.0\(aq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای اینکه فایل پیکربندی بر شیوه‌نامه تغییر ارائه‌دهنده اثری داشته باشد، باید نگاشت‌های ارائه‌دهنده را با استفاده از یکی از پیکربندی‌های مجاز (زیر را ببینید) تعریف کند.
.sp
اگر فایل فاقد هرگونه فهرست ارائه‌دهنده باشد، بارگیری شده و نسخه آن اعتبارسنجی می‌شود، اما هیچ قانونی تعریف نمی‌کند و بر رفتار مدیر ارائه‌دهنده تأثیری نخواهد داشت.
.UNINDENT
.UNINDENT
.SS "تعریف نگاشت ارائه‌دهنده (Vendor Mapping Definition)"
.sp
فایل می‌تواند از یکی از روش‌های تعریف ارائه‌دهنده زیر استفاده کند.
\fBتنها یک روش می‌تواند استفاده شود\fP\&.
.sp
\fBگزینه ۱: فهرست‌های جداگانه (خروجی + ورودی)\fP
.INDENT 0.0
.TP
.B \fB[[outgoing_vendors]]\fP
آرایه‌ای از جدول‌ها
.sp
فهرست ارائه‌دهندگانی که تغییر از آن‌ها مجاز است (ارائه‌دهندگان بسته خروجی).
.TP
.B \fB[[incoming_vendors]]\fP
آرایه‌ای از جدول‌ها
.sp
فهرست ارائه‌دهندگانی که تغییر به آن‌ها مجاز است (ارائه‌دهندگان بسته ورودی).
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBoutgoing_vendors\fP
و
\fBincoming_vendors\fP
باید یا هر دو وجود داشته باشند یا هر دو وجود نداشته باشند.
.UNINDENT
.UNINDENT
.sp
\fBمهم:\fP
.INDENT 0.0
.INDENT 3.5
تغییر ارائه‌دهنده هنگام جایگزینی بسته
\fBتنها در صورتی مجاز است که هر دو شرط هم‌زمان برقرار باشند\fP:
.INDENT 0.0
.IP \(bu 2
ارائه‌دهنده بسته خروجی (نصب‌شده) در
\fBoutgoing_vendors\fP
فهرست شده باشد
.IP \(bu 2
ارائه‌دهنده بسته ورودی (جدید) در
\fBincoming_vendors\fP
فهرست شده باشد
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBگزینه ۲: ارائه‌دهندگان معادل\fP
.INDENT 0.0
.TP
.B \fB[[equivalent_vendors]]\fP
آرایه‌ای از جدول‌ها
.sp
فهرست ارائه‌دهندگانی که متقابلاً معادل یکدیگرند. تغییرات در هر دو جهت بین تمام ارائه‌دهندگان موجود در این فهرست مجاز است.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
نمی‌توان
\fBequivalent_vendors\fP
را با
\fBoutgoing_vendors\fP
یا
\fBincoming_vendors\fP\&
ترکیب کرد. با این حال،
\fBequivalent_vendors\fP
در واقع یک روش نگارش خلاصه است. این معادل فهرست کردن همان ارائه‌دهندگان در هر دو
\fBoutgoing_vendors\fP
و
\fBincoming_vendors\fP\&
است.
.UNINDENT
.UNINDENT
.UNINDENT
.SS "فیلدهای ورودی ارائه‌دهنده (Vendor Entry Fields)"
.sp
هر ورودی در
\fB[[outgoing_vendors]]\fP،
\fB[[incoming_vendors]]\fP
یا
\fB[[equivalent_vendors]]\fP
می‌تواند شامل فیلدهای زیر باشد:
.INDENT 0.0
.TP
.B \fBvendor\fP
رشته
.sp
فیلد الزامی.
.sp
نام ارائه‌دهنده یا الگو برای تطبیق.
.TP
.B \fBcomparator\fP
رشته
.sp
فیلد اختیاری.
.sp
روش تطبیق مورد استفاده هنگام مقایسه رشته‌های ارائه‌دهنده.
.sp
پیش‌فرض: \fB\(dqEXACT\(dq\fP
.sp
مقادیر پشتیبانی‌شده:
.INDENT 7.0
.IP \(bu 2
\fB\(dqEXACT\(dq\fP \- تطبیق دقیق (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqIEXACT\(dq\fP \- تطبیق دقیق (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqGLOB\(dq\fP \- الگوی glob (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqIGLOB\(dq\fP \- الگوی glob (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqREGEX\(dq\fP \- عبارت باقاعده (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqIREGEX\(dq\fP \- عبارت باقاعده (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqCONTAINS\(dq\fP \- شامل رشته (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqICONTAINS\(dq\fP \- شامل رشته (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqSTARTSWITH\(dq\fP \- شروع با (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqISTARTSWITH\(dq\fP \- شروع با (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqENDSWITH\(dq\fP \- پایان با (حساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqIENDSWITH\(dq\fP \- پایان با (غیرحساس به حروف بزرگ و کوچک)
.IP \(bu 2
\fB\(dqNOT_EXACT\(dq\fP, \fB\(dqNOT_IEXACT\(dq\fP, \fB\(dqNOT_GLOB\(dq\fP, \fB\(dqNOT_IGLOB\(dq\fP, \fB\(dqNOT_CONTAINS\(dq\fP, \fB\(dqNOT_ICONTAINS\(dq\fP \- گونه‌های نفی‌شده
.UNINDENT
.TP
.B \fBexclude\fP
بولی
.sp
فیلد اختیاری.
.sp
اگر
\fBtrue\fP
باشد، ارائه‌دهنده از قاعده مستثنی می‌شود. این برای تعریف استثناها بر قواعد کلی‌تر مفید است. قواعد (ورودی‌های ارائه‌دهنده) به ترتیبی که تعریف شده‌اند پردازش می‌شوند. این بدان معناست که یک قاعده مستثنی‌سازی (exclude) باید قبل از قواعدی که ارائه‌دهنده باید از آن‌ها مستثنی شود، درج گردد.
.sp
پیش‌فرض: \fBfalse\fP
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: مجاز دانستن تغییر از \(dqVendorA\(dq به \(dqVendorB\(dq (Example 1: Allow change from \(dqVendorA\(dq to \(dqVendorB\(dq)"
.sp
این مثال کمینه‌ی پیکربندی الزامی را نشان می‌دهد که تغییر از
\(dqVendorA\(dq
به
\(dqVendorB\(dq
را مجاز می‌داند، اما نه برعکس.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version = \(aq1.0\(aq

[[outgoing_vendors]]
vendor = \(aqVendorA\(aq

[[incoming_vendors]]
vendor = \(aqVendorB\(aq
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲: مجاز دانستن تغییر از هر ارائه‌دهنده‌ای به \(dqMy Trusted Vendor\(dq (Example 2: Allow change from any vendor to \(dqMy Trusted Vendor\(dq)"
.sp
این مثال مجاز دانستن تغییر از هر ارائه‌دهنده‌ای به
\(dqMy Trusted Vendor\(dq
را نشان می‌دهد، اما نه برعکس (نیازمند قاعده صریح برای مجاز دانستن تمامی ارائه‌دهندگان است).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version = \(aq1.0\(aq

[[outgoing_vendors]]
vendor = \(aq\(aq
comparator = \(aqCONTAINS\(aq

[[incoming_vendors]]
vendor = \(aqMy Trusted Vendor\(aq
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۳: ارائه‌دهندگان معادل (Example 3: Equivalent vendors)"
.sp
این مثال ارائه‌دهندگانی را نشان می‌دهد که متقابلاً معادل یکدیگرند و تغییر در هر دو جهت را مجاز می‌دانند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version = \(aq1.0\(aq

# All following vendors are mutually equivalent
[[equivalent_vendors]]
vendor = \(aqFedora Project\(aq

[[equivalent_vendors]]
vendor = \(aqRed Hat\(aq
comparator = \(aqISTARTSWITH\(aq

[[equivalent_vendors]]
vendor = \(aqCentOS\(aq
comparator = \(aqISTARTSWITH\(aq
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۴: ارائه‌دهندگان معادل با یک استثنا (Example 4: Equivalent vendors with an exclusion)"
.sp
این مثال شیوه‌نامه ارائه‌دهنده را برای ارائه‌دهندگان مرتبط با SUSE همراه با یک استثنا برای openSUSE Build Service نشان می‌دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version = \(aq1.0\(aq

# All following vendors are mutually equivalent except excluded ones
[[equivalent_vendors]]
vendor = \(aqopenSUSE Build Service\(aq
comparator = \(aqISTARTSWITH\(aq
exclude = true

[[equivalent_vendors]]
vendor = \(aqSUSE\(aq
comparator = \(aqISTARTSWITH\(aq

[[equivalent_vendors]]
vendor = \(aqopenSUSE\(aq
comparator = \(aqISTARTSWITH\(aq
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.IP \(bu 2
مرجع فایل شیوه‌نامه تغییر ارائه‌دهنده DNF5 \%<#\:dnf5-vendor-change-policy-label>
.IP \(bu 2
مرجع فایل شیوه‌نامه تغییر ارائه‌دهنده DNF5 \- v1.1 \%<#\:dnf5-vendor-change-policy-v1-1-label>
.IP \(bu 2
\fBdnf5.conf(5)\fP, مرجع پیکربندی DNF5 \%<#\:dnf5-conf-label>
.UNINDENT
.SH "نویسندگان (AUTHORS)"
فایل AUTHORS.md را در توزیع منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان پروژه dnf5.
.\" End of generated man page.