.\" 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-VERSIONLOCK" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-versionlock \- قفل کردن نسخه بسته‌ها جهت جلوگیری از ارتقا در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 versionlock <subcommand> <package\-spec\-N>...\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBversionlock\fP در \fBDNF5\fP مجموعه‌ای از نام‌ها و نسخه‌ها را برای بسته‌ها دریافت کرده و تمامی نسخه‌های دیگر آن بسته‌ها را مستثنی می‌کند. این کار به شما امکان می‌دهد بسته‌ها را در برابر به‌روزرسانی توسط نسخه‌های جدیدتر محافظت کنید. همچنین، این دستور نسخه مشخصی از یک بسته را برای مستثنی کردن از به‌روزرسانی‌ها می‌پذیرد؛ به عنوان مثال هنگامی که لازم است از یک انتشار خاص از بسته‌ای که مشکلات شناخته‌شده‌ای دارد صرف‌نظر شود.
.sp
این افزونه تک‌تک مدخل‌های فایل قفل نسخه را پیمایش کرده و هر بسته‌ای با نام داده‌شده را که با شرایط ذکرشده در فایل مطابقت نداشته باشد، مستثنی می‌کند. این کار اساساً مشابه استفاده از \fIdnf5 \-\-exclude\fP برای خود نام بسته است (چرا که نمی‌توانید بسته‌های نصب‌شده را مستثنی کنید)، اما dnf همچنان نسخه‌هایی را که نصب کرده‌اید یا قفل نسخه شده‌اند را در دسترس در نظر می‌گیرد تا دستور \fIdnf reinstall\fP همچنان کار کند.
.sp
توجه داشته باشید که دستور versionlock هیچ‌گونه استثنایی را در عملیات‌های غیرتراکنشی مانند \fIrepoquery\fP، \fIlist\fP، \fIinfo\fP و غیره اعمال نمی‌کند.
.SH "زیردستورها (SUBCOMMANDS)"
.INDENT 0.0
.TP
.B \fBadd\fP
.nf
افزودن قفل نسخه برای تمام بسته‌های موجود منطبق با مشخصه. این بدان معناست که تنها نسخه‌هایی از بسته‌ها که توسط \fBpackage\-spec\-N\fP مشخص شده‌اند برای عملیات‌های تراکنش در دسترس خواهند بود. شناسه‌های NEVRA برای قفل شدن، ابتدا در میان بسته‌های نصب‌شده و سپس (در صورت پیدا نشدن) در میان تمام بسته‌های در دسترس فعلی جستجو می‌شوند.
.fi
.sp
.TP
.B \fBexclude\fP
.nf
افزودن یک استثنا (در قفل نسخه) برای بسته‌های موجود منطبق با مشخصه. این بدان معناست که بسته‌های مشخص‌شده توسط \fBpackage\-spec\-N\fP از عملیات‌های تراکنش مستثنی خواهند شد.
.fi
.sp
.TP
.B \fBclear\fP
.nf
حذف تمام مدخل‌های قفل نسخه.
.fi
.sp
.TP
.B \fBdelete\fP
.nf
حذف هرگونه مدخل منطبق قفل نسخه.
.fi
.sp
.TP
.B \fBlist\fP
.nf
فهرست کردن مدخل‌های فعلی قفل نسخه.
.fi
.sp
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B \fBdnf5 versionlock add acpi\fP
.nf
اگر بسته acpi نصب شده باشد، آن را روی نسخه نصب‌شده فعلی قفل می‌کند. اگر نصب نشده باشد، acpi را روی هر یک از نسخه‌های موجود فعلی قفل می‌کند.
.fi
.sp
.TP
.B \fBdnf5 versionlock list\fP
.nf
نمایش پیکربندی فعلی قفل نسخه.
.fi
.sp
.TP
.B \fBdnf5 versionlock delete acpi\fP
.nf
حذف هرگونه قانون برای بسته acpi.
.fi
.sp
.TP
.B \fBdnf5 versionlock exclude iftop\-1.2.3\-7.fc38\fP
.nf
مستثنی کردن انتشار iftop\-1.2.3\-7.fc38.
.fi
.sp
.UNINDENT
.SH "قالب فایل قفل نسخه (VERSIONLOCK FILE FORMAT)"
.sp
فایل قفل نسخه یک فایل TOML است که در مسیر \fI/etc/dnf/versionlock.toml\fP ذخیره می‌شود.
این فایل باید شامل کلید \fIversion\fP باشد؛ نسخه پشتیبانی‌شده فعلی \fI1.0\fP است.
سپس شامل \fIpackages\fP است \- فهرستی از مدخل‌های قفل‌گذاری. هر مدخل از نام بسته و فهرستی از شرایط تشکیل شده است. مشخصه نام بسته از همان تطبیق الگوی عمومی (glob) شل پشتیبانی می‌کند. برای مطابقت داشتن یک بسته، تمام شرایط باید برقرار باشند (با استفاده از عملگر منطقی AND ترکیب می‌شوند). سپس تمام مدخل‌ها با استفاده از عملیات منطقی OR با یکدیگر ترکیب می‌شوند.
.SS "نمونه فایل قفل نسخه (Example of versionlock file)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version = \(dq1.0\(dq

# keep package bash on version 0:5.2.15\-5.fc39
[[packages]]
name = \(dqbash\(dq               # name of the package
comment = \(dqdescription\(dq     # optional description of the entry
[[packages.conditions]]     # conditions for the package \(dqbash\(dq
key = \(dqevr\(dq                 # epoch, evr, and arch keys are supported
comparator = \(dq=\(dq            # <, <=, =, >=, >, and != operators are supported
value = \(dq0:5.2.15\-5.fc39\(dq   # pattern to match

# exclude iftop\-1.2.3\-7.fc38 version (versionlock exclude iftop\-1.2.3\-7.fc38)
[[packages]]
name = \(dqiftop\(dq
[[packages.conditions]]
key = \(dqevr\(dq
comparator = \(dq!=\(dq
value = \(dq0:1.0\-0.31.pre4.fc39\(dq

# keep acpi on major version 3
[[packages]]
name = \(dqacpi\(dq
[[packages.conditions]]
key = \(dqevr\(dq
comparator = \(dq<\(dq
value = \(dq4\(dq
[[packages.conditions]]
key = \(dqevr\(dq
comparator = \(dq>=\(dq
value = \(dq3\(dq

# keep all *nvidia* packages on version 3:570.*
[[packages]]
name = \(dq*nvidia*\(dq
[[packages.conditions]]
key = \(dqevr\(dq
comparator = \(dq>=\(dq
value = \(dq3:570\(dq
[[packages.conditions]]
key = \(dqevr\(dq
comparator = \(dq<\(dq
value = \(dq3:571\(dq
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.INDENT 3.5
.nf
\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.