.\" 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 "DNF5DAEMON-DBUS-API" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5daemon-dbus-api \- مرجع D-Bus API برای dnf5daemon
.SH "خلاصه دستور (SYNOPSIS)"
.sp
متدها و آرگومان‌های D\-Bus. تولیدشده از روی XMLهای D\-Bus.
.SH "توضیحات (DESCRIPTION)"
.sp
نکته: در حالی که بیشتر متدهای زیر می‌توانند با موفقیت توسط یک کاربر عادی فراخوانی شوند، احراز هویت توسط یک کاربر مدیر (اداری) برای برخی از آن‌ها الزامی است (به عنوان مثال \fIGoal.do_transaction()\fP، \fIRepo.confirm_key()\fP، \fIRepo.enable()\fP، \fIRepo.disable()\fP). این احراز هویت با فراخوانی متد \fICheckAuthorization()\fP از رابط D\-Bus با نام \fIorg.freedesktop.PolicyKit1.Authority\fP در Polkit مدیریت می‌شود. پرچم (فلگ) \fIAllowUserInteraction\fP برای این فراخوانی تنظیم شده است، که نشان می‌دهد در صورت در دسترس بودن یک عامل احراز هویت، فراخوانی در حالی که از کاربر درخواست احراز هویت می‌شود مسدود می‌گردد. یک مهلت زمانی سخت‌کدشده ۲ دقیقه‌ای برای تعامل با کاربر تنظیم شده است.
.SH "رابط‌ها (INTERFACES)"
.SS "رابط org.rpm.dnf.v0.SessionManager"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.SessionManager
.INDENT 7.0
.TP
.B method open_session(a{sv} options) -> (o session_object_path)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ پیکربندی نشست \- آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء به شیء نشست ایجادشده
.UNINDENT
.UNINDENT
.sp
یک نشست جدید باز می‌کند.
.sp
از گزینه‌های پیکربندی زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B load_system_repo: bool, default true
در صورت true بودن، اطلاعات مربوط به بسته‌های نصب‌شده فعلی بارگذاری می‌شود.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B load_available_repos: bool, default true
در صورت true بودن، اطلاعات مربوط به بسته‌های موجود در مخازن فعال بارگذاری می‌شود.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B config: map {string: string}
بازنویسی گزینه‌های پیکربندی.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B releasever: string
بازنویسی متغیر releasever که برای جایگزینی‌ها در پیکربندی‌های مخزن استفاده می‌شود.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B locale: string
بازنویسی لوکال (locale) سرور برای این نشست. بر زبانی که در پیام‌های خطای مختلف استفاده می‌شود تأثیر می‌گذارد.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method close_session(o session_object_path) -> (b success)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشستی که باید بسته شود
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی که نشان می‌دهد آیا نشست درخواستی با موفقیت بسته شد یا خیر
.UNINDENT
.UNINDENT
.sp
نشست را در مسیر شیء داده‌شده می‌بندد.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.Base"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.Base
.INDENT 7.0
.TP
.B method read_all_repos() -> (b success)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار \fItrue\fP در صورتی که مخازن با موفقیت بارگذاری شوند، در غیر این صورت \fIfalse\fP.
.UNINDENT
.UNINDENT
.sp
صریحاً درخواست بارگذاری متاداده مخازن را می‌دهد.
.UNINDENT
.INDENT 7.0
.TP
.B method clean_with_options(s cache_type, a{sv} options) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBcache_type\fP (\fIs\fP) \-\-\ نوع کش برای پاک‌سازی. انواع پشتیبانی‌شده عبارتند از \(dqall\(dq، \(dqpackages\(dq، \(dqmetadata\(dq، \(dqdbcache\(dq و \(dqexpire\-cache\(dq.
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار \fItrue\fP در صورتی که کش با موفقیت پاک‌سازی شود، در غیر این صورت \fIfalse\fP.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطاهای رخ‌داده هنگام پاک‌سازی کش.
.UNINDENT
.UNINDENT
.sp
داده‌های کش‌شده را حذف یا منقضی می‌کند.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method clean(s cache_type) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBcache_type\fP (\fIs\fP) \-\-\ نوع کش برای پاک‌سازی. انواع پشتیبانی‌شده عبارتند از \(dqall\(dq، \(dqpackages\(dq، \(dqmetadata\(dq، \(dqdbcache\(dq و \(dqexpire\-cache\(dq.
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار \fItrue\fP در صورتی که کش با موفقیت پاک‌سازی شود، در غیر این صورت \fIfalse\fP.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطاهای رخ‌داده هنگام پاک‌سازی کش.
.UNINDENT
.UNINDENT
.sp
داده‌های کش‌شده را حذف یا منقضی می‌کند.
.sp
این معادل فراخوانی \(dqclean_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method reset() -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار \fItrue\fP در صورتی که نشست با موفقیت بازنشانی شود، در غیر این صورت \fIfalse\fP.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطاهای رخ‌داده هنگام بازنشانی نشست
.UNINDENT
.UNINDENT
.sp
نشست را کاملاً بازنشانی می‌کند.
.UNINDENT
.INDENT 7.0
.TP
.B signal download_add_new(o session_object_path, s download_id, s description, x total_to_download)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBdownload_id\fP (\fIs\fP) \-\-\ شناسه یکتای شیء دانلودشده (مخزن یا بسته)
.IP \(bu 2
\fBdescription\fP (\fIs\fP) \-\-\ توضیحات شیء دانلودشده
.IP \(bu 2
\fBtotal_to_download\fP (\fIx\fP) \-\-\ کل بایت‌ها برای دانلود
.UNINDENT
.UNINDENT
.sp
یک دانلود جدید آغاز شده است.
.UNINDENT
.INDENT 7.0
.TP
.B signal download_progress(o session_object_path, s download_id, x total_to_download, x downloaded)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBdownload_id\fP (\fIs\fP) \-\-\ شناسه یکتای شیء دانلودشده (مخزن یا بسته)
.IP \(bu 2
\fBtotal_to_download\fP (\fIx\fP) \-\-\ کل بایت‌ها برای دانلود
.IP \(bu 2
\fBdownloaded\fP (\fIx\fP) \-\-\ بایت‌های دانلودشده تاکنون
.UNINDENT
.UNINDENT
.sp
پیشرفت در دانلود.
.UNINDENT
.INDENT 7.0
.TP
.B signal download_mirror_failure(o session_object_path, s download_id, s message, s url, s metadata)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBdownload_id\fP (\fIs\fP) \-\-\ شناسه یکتای شیء دانلودشده (مخزن یا بسته)
.IP \(bu 2
\fBmessage\fP (\fIs\fP) \-\-\ یک پیام خطا
.IP \(bu 2
\fBurl\fP (\fIs\fP) \-\-\ نشانی URL در حال دانلود
.IP \(bu 2
\fBmetadata\fP (\fIs\fP) \-\-\ برای دانلود متاداده مخزن، شامل نوع متاداده است
.UNINDENT
.UNINDENT
.sp
شکست آینه (mirror) در حین دانلود.
.UNINDENT
.INDENT 7.0
.TP
.B signal download_end(o session_object_path, s download_id, u transfer_status, s message)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBdownload_id\fP (\fIs\fP) \-\-\ شناسه یکتای شیء دانلودشده (مخزن یا بسته)
.IP \(bu 2
\fBtransfer_status\fP (\fIu\fP) \-\-\ وضعیت انتقال طبق libdnf5::repo::DownloadCallbacks::TransferStatus (مقادیر: 0 \- موفقیت‌آمیز، 1 \- از قبل موجود است، 2 \- خطا)
.IP \(bu 2
\fBmessage\fP (\fIs\fP) \-\-\ پیام خطا در صورت ناموفق بودن دانلود
.UNINDENT
.UNINDENT
.sp
دانلود به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal repo_key_import_request(o session_object_path, s key_id, as user_ids, s key_fingerprint, s key_url, x timestamp)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBkey_id\fP (\fIs\fP) \-\-\ شناسه کلید OpenPGP
.IP \(bu 2
\fBuser_ids\fP (\fIas\fP) \-\-\ شناسه کاربر
.IP \(bu 2
\fBkey_fingerprint\fP (\fIs\fP) \-\-\ اثر انگشت کلید OpenPGP
.IP \(bu 2
\fBkey_url\fP (\fIs\fP) \-\-\ نشانی URL کلید OpenPGP
.IP \(bu 2
\fBtimestamp\fP (\fIx\fP) \-\-\ برچسب زمانی ایجاد کلید
.UNINDENT
.UNINDENT
.sp
درخواست تأیید درون‌ریزی (import) کلید مخزن.
.UNINDENT
.INDENT 7.0
.TP
.B signal repo_key_imported(o session_object_path, s key_id, as user_ids, s key_fingerprint, s key_url, x timestamp)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBkey_id\fP (\fIs\fP) \-\-\ شناسه کلید OpenPGP
.IP \(bu 2
\fBuser_ids\fP (\fIas\fP) \-\-\ شناسه کاربر
.IP \(bu 2
\fBkey_fingerprint\fP (\fIs\fP) \-\-\ اثر انگشت کلید OpenPGP
.IP \(bu 2
\fBkey_url\fP (\fIs\fP) \-\-\ نشانی URL کلید OpenPGP
.IP \(bu 2
\fBtimestamp\fP (\fIx\fP) \-\-\ برچسب زمانی ایجاد کلید
.UNINDENT
.UNINDENT
.sp
سیگنال اطلاعاتی صادرشده پس از درون‌ریزی موفقیت‌آمیز کلید مخزن.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.rpm.Repo"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.rpm.Repo
.INDENT 7.0
.TP
.B method list(a{sv} options) -> (aa{sv} repositories)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBrepositories\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از مخازن بازگردانده‌شده با ویژگی‌های درخواستی
.UNINDENT
.UNINDENT
.sp
دریافت فهرست مخازنی که با فیلترهای داده‌شده مطابقت دارند.
.sp
از گزینه‌های زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B patterns: list of strings
هر مخزنی با شناسه‌ای که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B repo_attrs: list of strings
فهرست ویژگی‌های مخزن که بازگردانده می‌شوند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B enable_disable: string (default \(dqenabled\(dq)
هنگامی که روی \(dqenabled\(dq یا \(dqdisabled\(dq تنظیم شود، فقط مخازن فعال / غیرفعال فهرست می‌شوند. هر مقدار دیگری به این معنی است که همه مخازن بازگردانده می‌شوند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method confirm_key_with_options(s key_id, b confirmed, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBkey_id\fP (\fIs\fP) \-\-\ شناسه کلید مورد نظر
.IP \(bu 2
\fBconfirmed\fP (\fIb\fP) \-\-\ آیا درون‌ریزی کلید توسط کاربر تأیید شده است یا خیر
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.UNINDENT
.sp
تأیید درون‌ریزی کلید OpenPGP مخزن.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method confirm_key(s key_id, b confirmed) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBkey_id\fP (\fIs\fP) \-\-\ شناسه کلید مورد نظر
.IP \(bu 2
\fBconfirmed\fP (\fIb\fP) \-\-\ آیا درون‌ریزی کلید توسط کاربر تأیید شده است یا خیر
.UNINDENT
.UNINDENT
.sp
تأیید درون‌ریزی کلید OpenPGP مخزن.
.sp
این معادل فراخوانی \(dqconfirm_key_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method enable_with_options(as repo_ids, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBrepo_ids\fP (\fIas\fP) \-\-\ آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید فعال شوند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.UNINDENT
.sp
فعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method enable(as repo_ids) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBrepo_ids\fP (\fIas\fP) \-\-\ آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید فعال شوند
.UNINDENT
.UNINDENT
.sp
فعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.
.sp
این معادل فراخوانی \(dqenable_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method disable_with_options(as repo_ids, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBrepo_ids\fP (\fIas\fP) \-\-\ آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید غیرفعال شوند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.UNINDENT
.sp
غیرفعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method disable(as repo_ids) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBrepo_ids\fP (\fIas\fP) \-\-\ آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید غیرفعال شوند
.UNINDENT
.UNINDENT
.sp
غیرفعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.
.sp
این معادل فراخوانی \(dqdisable_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.rpm.Rpm"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.rpm.Rpm
.INDENT 7.0
.TP
.B method list(a{sv} options) -> (aa{sv} packages)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBpackages\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از بسته‌های بازگردانده‌شده با ویژگی‌های درخواستی
.UNINDENT
.UNINDENT
.sp
دریافت فهرست بسته‌هایی که با فیلترهای داده‌شده مطابقت دارند.
از آنجا که این متد بسته‌ها را مستقیماً در پیام پاسخ متد D\-Bus که اندازه محدودی دارد بازمی‌گرداند، این احتمال وجود دارد که اندازه مجموعه بسته‌های درخواستی از این حد فراتر رود. اگر تعداد زیادی بسته و/یا تعداد زیادی ویژگی بسته درخواست می‌کنید، لطفاً استفاده از متد list_fd() را در نظر بگیرید.
.sp
از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B package_attrs: list of strings
فهرست ویژگی‌های بسته که بازگردانده می‌شوند. ویژگی‌های پشتیبانی‌شده عبارتند از: name, epoch, version, release, arch, repo_id, from_repo_id, is_installed, install_size, download_size, buildtime, install_time, sourcerpm, summary, url, license, description, files, changelogs, provides, requires, requires_pre, conflicts, obsoletes, recommends, suggests, enhances, supplements, evr, nevra, full_nevra, reason, vendor, group.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_nevra: bool (default true)
تطبیق الگوها با NEVRAهای بسته‌های موجود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_provides: bool (default true)
تطبیق الگوها با قابلیت‌های ارائه‌شده (provides) بسته‌های موجود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_filenames: bool (default true)
تطبیق الگوها با نام فایل‌های موجود در بسته‌های موجود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_binaries: bool (default true)
تطبیق الگوها با نام باینری‌های موجود در \fI/usr/(s)bin\fP در بسته‌های موجود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_src: bool (default true)
گنجاندن بسته‌های rpm سورس (source rpms) در نتایج
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B icase: bool (default true)
نادیده گرفتن بزرگی و کوچکی حروف هنگام تطبیق الگوها
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B patterns: list of strings
هر بسته‌ای که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B scope: string (default \(dqall\(dq)
محدود کردن بسته‌ها به یکی از موارد \(dqall\(dq، \(dqinstalled\(dq، \(dqavailable\(dq، \(dqupgrades\(dq، \(dqupgradable\(dq
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B arch: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌های معماری‌های داده‌شده
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B repo: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌های مخازن داده‌شده
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B latest\-limit: int
محدود کردن مجموعه حاصل به تنها <limit> عدد از جدیدترین بسته‌ها برای هر نام و معماری
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatprovides: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را ارائه می‌دهند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatdepends: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که به هر یک از قابلیت‌های داده‌شده نیاز دارند (requires)، آن را بهبود می‌بخشند (enhances)، توصیه می‌کنند (recommends)، پیشنهاد می‌دهند (suggests) یا تکمیل می‌کنند (supplements)
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatrequires: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که به هر یک از قابلیت‌های داده‌شده نیاز دارند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatrecommends: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را توصیه می‌کنند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatenhances: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را بهبود می‌بخشند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatsuggests: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را پیشنهاد می‌دهند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatsupplements: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را تکمیل می‌کنند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatobsoletes: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را منسوخ می‌کنند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B whatconflicts: list of strings
محدود کردن مجموعه حاصل فقط به بسته‌هایی که با هر یک از قابلیت‌های داده‌شده تداخل دارند
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method list_fd(a{sv} options, h file_descriptor) -> (s transfer_id)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.IP \(bu 2
\fBfile_descriptor\fP (\fIh\fP) \-\-\ توصیف‌گر فایل بازشده برای نوشتن که جهت انتقال داده استفاده می‌شود
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBtransfer_id\fP (\fIs\fP) \-\-\ شناسه این انتقال. برای ارسال سیگنال پایان انتقال استفاده می‌شود.
.UNINDENT
.UNINDENT
.sp
بازیابی فهرستی از بسته‌ها که با فیلترهای ارائه‌شده مطابقت دارند.
بسته‌ها به صورت جریانی از اشیاء JSON منتقل می‌شوند که هر شیء JSON نمایانگر یک بسته به عنوان یک دیکشنری است. این جریان سپس در توصیف‌گر فایل داده‌شده (file_descriptor) نوشته می‌شود.
برخلاف متد list()، این رویکرد با مشکل بزرگی حجم داده‌های خروجی مواجه نمی‌شود.
سرور یک مهلت زمانی ۳۰ ثانیه‌ای دارد که در طول آن در صورت پر بودن پایپ (pipe)، منتظر می‌ماند تا کلاینت داده‌ها را از پایپ بخواند.
.sp
از همان گزینه‌های متد list() پشتیبانی می‌شود.
.UNINDENT
.INDENT 7.0
.TP
.B method install(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم نصب شوند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار نصب
.UNINDENT
.UNINDENT
.sp
علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای نصب.
.sp
از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B repo_ids: list of strings
شناسه‌های مخازنی که بسته‌ها می‌توانند از آن‌ها نصب شوند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B skip_broken: boolean, default false
اینکه آیا حل‌کننده وابستگی می‌تواند بسته‌های با وابستگی‌های خراب را برای حل تراکنش نادیده بگیرد یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B skip_unavailable: boolean, default false
اینکه آیا بسته‌های ناموجود می‌توانند نادیده گرفته شوند یا خیر.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method upgrade(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم ارتقا یابند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار ارتقا
.UNINDENT
.UNINDENT
.sp
علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای ارتقا.
.sp
از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B repo_ids: list of strings
شناسه‌های مخازنی که بسته‌ها می‌توانند از آن‌ها ارتقا یابند.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method remove(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها که باید از روی سیستم حذف شوند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار حذف
.UNINDENT
.UNINDENT
.sp
علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای حذف.
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method distro_sync(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها برای همگام‌سازی با جدیدترین نسخه‌های موجود
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار distro_sync
.UNINDENT
.UNINDENT
.sp
از @options زیر پشتیبانی می‌شود:
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method downgrade(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم تنزل یابند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار تنزل
.UNINDENT
.UNINDENT
.sp
علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای تنزل نسخه.
.sp
از @options زیر پشتیبانی می‌شود:
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method reinstall(as pkg_specs, a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBpkg_specs\fP (\fIas\fP) \-\-\ آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم دوباره نصب شوند
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار نصب مجدد
.UNINDENT
.UNINDENT
.sp
علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای نصب مجدد.
.sp
از @options زیر پشتیبانی می‌شود:
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method system_upgrade(a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار system_upgrade
.UNINDENT
.UNINDENT
.sp
آماده‌سازی یک تراکنش برای ارتقا به انتشار جدید توزیع. تراکنش آماده‌شده باید در حین راه‌اندازی مجدد اجرا شود (گزینه \fIoffline\fP از متد \fIdo_transaction\fP در رابط \fIGoal\fP را ببینید).
این متد متکی به این است که گزینه \fIreleasever\fP در طول فراخوانی \fIopen_session()\fP به درستی روی انتشار جدید توزیع تنظیم شده باشد.
.sp
از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B mode: string (one of \(dqdistrosync\(dq, \(dqupgrade\(dq, default is \(dqdistrosync\(dq)
به‌طور پیش‌فرض system_upgrade مانند \fIdnf distro\-sync\fP عمل می‌کند و همیشه بسته‌ها را از انتشار جدید نصب می‌کند، حتی اگر از نسخه نصب‌شده فعلی قدیمی‌تر باشند. در صورت تنظیم روی \(dqupgrade\(dq، بسته‌های انتشار جدید در صورتی که از نسخه نصب‌شده فعلی قدیمی‌تر باشند نصب نمی‌شوند (مانند رفتار \fIdnf upgrade\fP).
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_elem_progress(o session_object_path, s nevra, t processed, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته
.IP \(bu 2
\fBprocessed\fP (\fIt\fP) \-\-\ مقدار پردازش‌شده تاکنون
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
پیشرفت کلی در پردازش آیتم‌های تراکنش. درست قبل از پردازش یک آیتم فراخوانی می‌شود.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_before_begin(o session_object_path, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ تعداد عناصر در تراکنش rpm
.UNINDENT
.UNINDENT
.sp
درست قبل از اجرای تراکنش rpm ارسال می‌شود.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_after_complete(o session_object_path, b success)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار true در صورتی که تراکنش rpm با موفقیت تکمیل شده باشد
.UNINDENT
.UNINDENT
.sp
درست پس از پایان اجرای تراکنش rpm ارسال می‌شود.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_action_start(o session_object_path, s nevra, u action, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته
.IP \(bu 2
\fBaction\fP (\fIu\fP) \-\-\ یکی از مقادیر شمارش dnfdaemon::RpmTransactionItem::Actions
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات
.UNINDENT
.UNINDENT
.sp
پردازش (نصب یا حذف) بسته آغاز شده است.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_action_progress(o session_object_path, s nevra, t processed, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته
.IP \(bu 2
\fBprocessed\fP (\fIt\fP) \-\-\ بخشی از بسته که تاکنون نصب/حذف شده است
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات
.UNINDENT
.UNINDENT
.sp
پیشرفت در پردازش بسته.
توجه داشته باشید که یک محدودیت سخت‌کدشده وجود دارد که برای جلوگیری از تحت فشار قرار گرفتن کاربر یا D\-Bus با سیگنال‌های بیش از حد، از ارسال بیش از یک سیگنال در هر ۴۰۰ میلی‌ثانیه جلوگیری می‌کند.
برای بسته‌های کوچک‌تر ممکن است هیچ سیگنال پیشرفتی ارسال نشود یا فقط سیگنال پیشرفت شروع با مقدار @processed برابر با ۰ ارسال گردد.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_action_stop(o session_object_path, s nevra, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات
.UNINDENT
.UNINDENT
.sp
پردازش بسته به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_script_start(o session_object_path, s nevra, u scriptlet_type)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
.IP \(bu 2
\fBscriptlet_type\fP (\fIu\fP) \-\-\ نوع اسکریپت‌لت آغازشده (pre، post، ...)
.UNINDENT
.UNINDENT
.sp
اسکریپت‌لت آغاز شده است.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_script_stop(o session_object_path, s nevra, u scriptlet_type, t return_code)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
.IP \(bu 2
\fBscriptlet_type\fP (\fIu\fP) \-\-\ نوع اسکریپت‌لت آغازشده (pre، post، ...)
.IP \(bu 2
\fBreturn_code\fP (\fIt\fP) \-\-\ مقدار بازگشتی اسکریپت
.UNINDENT
.UNINDENT
.sp
اسکریپت‌لت با موفقیت به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_script_error(o session_object_path, s nevra, u scriptlet_type, t return_code)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
.IP \(bu 2
\fBscriptlet_type\fP (\fIu\fP) \-\-\ نوع اسکریپت‌لت آغازشده (pre، post، ...)
.IP \(bu 2
\fBreturn_code\fP (\fIt\fP) \-\-\ مقدار بازگشتی اسکریپت
.UNINDENT
.UNINDENT
.sp
اسکریپت‌لت با خطا به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_verify_start(o session_object_path, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
اعتبارسنجی فایل‌های بسته آغاز شد.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_verify_progress(o session_object_path, t processed, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBprocessed\fP (\fIt\fP) \-\-\ مقدار پردازش‌شده تاکنون
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
پیشرفت در پردازش بسته.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_verify_stop(o session_object_path, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
اعتبارسنجی فایل‌های بسته به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_transaction_start(o session_object_path, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
آماده‌سازی بسته‌های تراکنش آغاز شد.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_transaction_progress(o session_object_path, t processed, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBprocessed\fP (\fIt\fP) \-\-\ مقدار پردازش‌شده تاکنون
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
پیشرفت در آماده‌سازی بسته‌های تراکنش.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_transaction_stop(o session_object_path, t total)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBtotal\fP (\fIt\fP) \-\-\ کل مقدار برای پردازش
.UNINDENT
.UNINDENT
.sp
آماده‌سازی بسته‌های تراکنش به پایان رسید.
.UNINDENT
.INDENT 7.0
.TP
.B signal transaction_unpack_error(o session_object_path, s nevra)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsession_object_path\fP (\fIo\fP) \-\-\ مسیر شیء نشست dnf5daemon
.IP \(bu 2
\fBnevra\fP (\fIs\fP) \-\-\ شناسه کامل NEVRAی بسته
.UNINDENT
.UNINDENT
.sp
خطا هنگام استخراج (unpack) بسته.
.UNINDENT
.INDENT 7.0
.TP
.B signal write_to_fd_finished(b success, s transfer_id, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار true در صورتی که انتقال با موفقیت پایان یافته باشد
.IP \(bu 2
\fBtransfer_id\fP (\fIs\fP) \-\-\ شناسه انتقال پایان‌یافته
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ پیام خطا در صورتی که انتقال موفقیت‌آمیز نبوده باشد.
.UNINDENT
.UNINDENT
.sp
به کاربر اطلاع می‌دهد که نوشتن در توصیف‌گر فایل با transfer_id داده‌شده پایان یافته و توصیف‌گر بسته شده است.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.Goal"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.Goal
.INDENT 7.0
.TP
.B method resolve(a{sv} options) -> (a(sssa{sv}a{sv}) transaction_items, u result)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار حل وابستگی
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBtransaction_items\fP (\fIa(sssa{sv}a{sv})\fP) \-\-\ آرایه‌ای از چندتایی‌های (object_type, action, reason, {transaction_item_attributes}, {object}). مورد object_type یکی از مقادیر libdnf5::transaction::TransactionItemType، مورد action یکی از مقادیر libdnf5::transaction::TransactionItemAction و مورد reason یکی از مقادیر شمارش‌های libdnf5::transaction::TransactionItemReason است. هر یک از این شمارش‌ها با استفاده از متدهای متناظر libdnf5::transaction::*_to_string() به صورت رشته نمایش داده می‌شوند. بخش transaction_item_attributes یک نگاشت {attribute: value} است. در حال حاضر ویژگی \(dqreason_change_group_id\(dq برای شناسه گروه هدف در صورتی که عمل ReasonChange و دلیل Group باشد استفاده می‌شود، و \(dqreplaces\(dq شامل برداری از شناسه‌های بسته‌هایی است که توسط این آیتم جایگزین می‌شوند. در نهایت، شیء یک نگاشت {attribute: value} است و (بر اساس object_type) نشان‌دهنده بسته، گروه، محیط، یا ماژول است. این ویژگی‌های بسته بازگردانده می‌شوند: \(dqname\(dq، \(dqepoch\(dq، \(dqversion\(dq، \(dqrelease\(dq، \(dqarch\(dq، \(dqrepo_id\(dq، \(dqfrom_repo_id\(dq، \(dqpackage_size\(dq، \(dqinstall_size\(dq، \(dqevr\(dq و \(dqreason\(dq. برای گروه‌ها، شیء شامل ویژگی‌های \(dqgroupid\(dq و \(dqname\(dq است.
.IP \(bu 2
\fBresult\fP (\fIu\fP) \-\-\ مشکلات شناسایی‌شده در طول حل تراکنش. مقادیر ممکن عبارتند از: 0 \- بدون مشکل، 1 \- بدون مشکل، اما برخی اطلاعات / هشدارها وجود دارند، یا 2 \- حل وابستگی با شکست مواجه شد.
.UNINDENT
.UNINDENT
.sp
حل کردن تراکنش.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B allow_erasing: boolean, default false
اینکه آیا حذف بسته نصب‌شده برای حل تراکنش مجاز است یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method get_transaction_problems_string() -> (as problems)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBproblems\fP (\fIas\fP) \-\-\ آرایه‌ای از رشته‌ها شامل تمام مشکلات یافت‌شده در طول حل تراکنش.
.UNINDENT
.UNINDENT
.sp
تمام مشکلات یافت‌شده در طول حل تراکنش را به عنوان پیام‌های قابل خواندن برای انسان بازمی‌گرداند.
.UNINDENT
.INDENT 7.0
.TP
.B method get_transaction_problems() -> (aa{sv} problems)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBproblems\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از نگاشت‌های {key: value}
.UNINDENT
.UNINDENT
.sp
تمام مشکلات یافت‌شده در حین حل تراکنش را به عنوان ساختارها بازمی‌گرداند. این فهرست کلیدهای مشکل است:
همیشه موجود:
action \- به include/libdnf5/base/goal_elements.hpp: GoalAction مراجعه کنید
problem \- به include/libdnf5/base/goal_elements.hpp: GoalProblem مراجعه کنید
اختیاری:
goal_job_settings \- به صورت {string: variant}، تنظیمات استفاده‌شده برای حل هدف (goal)
spec \- رشته، معمولاً NEVRAی بسته تحت تأثیر
additional_data \- آرایه‌ای از رشته‌ها، جزئیات بیشتر در مورد مشکل
solver_problems \- مشکلات گزارش‌شده توسط libsolv زیرین
.UNINDENT
.INDENT 7.0
.TP
.B method do_transaction(a{sv} options) -> ()
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر اجرای تراکنش
.UNINDENT
.UNINDENT
.sp
اجرای تراکنش حل‌شده.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B comment: string
افزودن یک یادداشت (کامنت) به تراکنش.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B offline: boolean, default false
در صورت true بودن، تراکنش برای اجرا در طول راه‌اندازی مجدد بعدی آماده می‌شود. در غیر این صورت، بلافاصله اجرا خواهد شد.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B downloadonly: boolean, default false, since 5.2.16
در صورت true بودن، فقط مجموعه بسته‌های حل‌شده را بدون اجرای یک تراکنش RPM دانلود می‌کند. همراه با گزینه offline، فایل‌های تراکنش آفلاین آماده می‌شوند، اما اجرای تراکنش آغاز نمی‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method cancel() -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار true در صورتی که لغو با موفقیت درخواست شده باشد
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ پیام خطا در صورتی که لغو رد شده باشد
.UNINDENT
.UNINDENT
.sp
لغو تراکنشی که توسط \fIdo_transaction()\fP آغاز شده بود. تراکنش فقط در مرحله دانلود بسته قابل لغو است. هنگامی که تراکنش RPM آغاز شد، لغو دیگر مجاز نیست.
.UNINDENT
.INDENT 7.0
.TP
.B method reset() -> ()
بازنشانی تراکنش rpm آماده‌شده. پس از این فراخوانی، نشست آماده اجرای یک تراکنش rpm دیگر است.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.Offline"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.Offline
.INDENT 7.0
.TP
.B method get_status() -> (b pending, a{sv} transaction_status)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBpending\fP (\fIb\fP) \-\-\ مقدار بولی، مقدار true در صورتی که یک تراکنش آفلاین معلق وجود داشته باشد
.IP \(bu 2
\fBtransaction_status\fP (\fIa{sv}\fP) \-\-\ وضعیت تراکنش آفلاین dnf5 فعلی
.UNINDENT
.UNINDENT
.sp
بررسی می‌کند که آیا یک تراکنش آفلاین پیکربندی‌شده برای راه‌اندازی مجدد بعدی که توسط dnf5 آغاز شده وجود دارد یا خیر و وضعیت آن را بازمی‌گرداند.
.UNINDENT
.INDENT 7.0
.TP
.B method cancel_with_options(a{sv} options) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، در صورت بروز خطا در حین لغو تراکنش، یا اگر تراکنش آفلاین توسط ابزاری غیر از dnf5 آغاز شده باشد، \fIfalse\fP را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت لغو شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، \fItrue\fP را بازمی‌گرداند.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام لغو تراکنش
.UNINDENT
.UNINDENT
.sp
لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده است. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزار دیگر لغو نمی‌شوند.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method cancel() -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، در صورت بروز خطا در حین لغو تراکنش، یا اگر تراکنش آفلاین توسط ابزاری غیر از dnf5 آغاز شده باشد، \fIfalse\fP را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت لغو شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، \fItrue\fP را بازمی‌گرداند.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام لغو تراکنش
.UNINDENT
.UNINDENT
.sp
لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده است. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزار دیگر لغو نمی‌شوند.
.sp
این معادل فراخوانی \(dqcancel_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method clean_with_options() -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، در صورت بروز خطا در طول پاک‌سازی تراکنش، \fIfalse\fP را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت پاک‌سازی شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، \fItrue\fP را بازمی‌گرداند.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام پاک‌سازی تراکنش
.UNINDENT
.UNINDENT
.sp
لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده و حذف تمام داده‌های ذخیره‌شده تراکنش آفلاین، از جمله بسته‌های دانلودشده. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزاری دیگر تحت تأثیر قرار نمی‌گیرند.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method clean(a{sv} options) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP)
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، در صورت بروز خطا در طول پاک‌سازی تراکنش، \fIfalse\fP را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت پاک‌سازی شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، \fItrue\fP را بازمی‌گرداند.
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام پاک‌سازی تراکنش
.UNINDENT
.UNINDENT
.sp
لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده و حذف تمام داده‌های ذخیره‌شده تراکنش آفلاین، از جمله بسته‌های دانلودشده. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزاری دیگر تحت تأثیر قرار نمی‌گیرند.
.sp
این معادل فراخوانی \(dqclean_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method set_finish_action_with_options(s action, a{sv} options) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBaction\fP (\fIs\fP) \-\-\ رشته، یکی از \(dqpoweroff\(dq یا \(dqreboot\(dq. در صورت تنظیم روی \(dqpoweroff\(dq، سیستم پس از اعمال تراکنش آفلاین خاموش خواهد شد. در غیر این صورت سیستم مجدداً راه‌اندازی می‌شود.
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، مقدار true در صورتی که عمل با موفقیت تنظیم شده باشد
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام تنظیم عمل
.UNINDENT
.UNINDENT
.sp
تنظیم عملی که باید پس از اعمال تراکنش آفلاین انجام شود. اگر \fIaction\fP برابر با \(dqpoweroff\(dq باشد، سیستم خاموش می‌شود، در غیر این صورت راه‌اندازی مجدد خواهد شد (که پیش‌فرض است).
در صورتی که هیچ تراکنش آفلاین زمان‌بندی‌شده‌ای وجود نداشته باشد، یا تراکنش با استفاده از libdnf5 زمان‌بندی نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method set_finish_action(s action) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBaction\fP (\fIs\fP) \-\-\ رشته، یکی از \(dqpoweroff\(dq یا \(dqreboot\(dq. در صورت تنظیم روی \(dqpoweroff\(dq، سیستم پس از اعمال تراکنش آفلاین خاموش خواهد شد. در غیر این صورت سیستم مجدداً راه‌اندازی می‌شود.
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، مقدار true در صورتی که عمل با موفقیت تنظیم شده باشد
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام تنظیم عمل
.UNINDENT
.UNINDENT
.sp
تنظیم عملی که باید پس از اعمال تراکنش آفلاین انجام شود. اگر \fIaction\fP برابر با \(dqpoweroff\(dq باشد، سیستم خاموش می‌شود، در غیر این صورت راه‌اندازی مجدد خواهد شد (که پیش‌فرض است).
در صورتی که هیچ تراکنش آفلاین زمان‌بندی‌شده‌ای وجود نداشته باشد، یا تراکنش با استفاده از libdnf5 زمان‌بندی نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.
.sp
این معادل فراخوانی \(dqset_finish_action_with_options()\(dq با گزینه‌های خالی است.
.UNINDENT
.INDENT 7.0
.TP
.B method schedule_for_next_boot(a{sv} options) -> (b success, s error_msg)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBsuccess\fP (\fIb\fP) \-\-\ مقدار بولی، مقدار true در صورتی که تراکنش آفلاین با موفقیت برای بوت بعدی زمان‌بندی شده باشد
.IP \(bu 2
\fBerror_msg\fP (\fIs\fP) \-\-\ رشته، شامل خطای رخ‌داده هنگام زمان‌بندی تراکنش
.UNINDENT
.UNINDENT
.sp
زمان‌بندی تراکنش آفلاین آماده‌شده برای بوت بعدی. این کار پیوند نمادین جادویی
/system\-update را ایجاد کرده و وضعیت تراکنش را روی \(dqready\(dq قرار می‌دهد. سیستم مجدداً راه‌اندازی نخواهد شد؛
فراخواننده مسئول آغاز راه‌اندازی مجدد در زمان مناسب است.
.sp
در صورتی که تراکنش آفلاینی در وضعیت \(dqdownload\-complete\(dq یا \(dqready\(dq وجود نداشته باشد،
یا تراکنش با استفاده از libdnf5 آماده نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.
.INDENT 7.0
.TP
.B از @options زیر پشتیبانی می‌شود:
.INDENT 7.0
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default true
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.comps.Group"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.comps.Group
.INDENT 7.0
.TP
.B method list(a{sv} options) -> (aa{sv} groups)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBgroups\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از گروه‌های بازگردانده‌شده با ویژگی‌های درخواستی
.UNINDENT
.UNINDENT
.sp
دریافت فهرست گروه‌هایی که با فیلترهای داده‌شده مطابقت دارند.
.sp
از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B attributes: list of strings
فهرست ویژگی‌های گروه که بازگردانده می‌شوند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B match_group_id: bool (default true)
تطبیق الگوها با شناسه‌های گروه‌ها
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B match_group_name: bool (default false)
تطبیق الگوها با نام‌های گروه‌ها
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B scope: string (default \(dqall\(dq)
محدود کردن گروه‌ها به یکی از موارد \(dqall\(dq، \(dqinstalled\(dq، \(dqavailable\(dq
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_hidden: bool (default false)
گنجاندن گروه‌های مخفی در نتیجه
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B patterns: list of strings
هر گروهی که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B contains_pkgs: list of strings
تنها شامل گروه‌هایی می‌شود که حاوی بسته‌های داده‌شده هستند
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B lang: string (default current locale)
کد زبان برای ویژگی‌های translated_name و translated_description
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.Advisory"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.Advisory
.INDENT 7.0
.TP
.B method list(a{sv} options) -> (aa{sv} advisories)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBadvisories\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از توصیه‌نامه‌های بازگردانده‌شده با ویژگی‌های درخواستی
.UNINDENT
.UNINDENT
.sp
دریافت فهرست توصیه‌نامه‌های امنیتی که با فیلترهای داده‌شده مطابقت دارند.
.sp
از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B advisory_attrs: list of strings
فهرست ویژگی‌های توصیه‌نامه که در آرایه \fIadvisories\fP بازگردانده می‌شوند. ویژگی‌های پشتیبانی‌شده عبارتند از \(dqadvisoryid\(dq، \(dqname\(dq، \(dqtitle\(dq، \(dqtype\(dq، \(dqseverity\(dq، \(dqstatus\(dq، \(dqvendor\(dq، \(dqdescription\(dq، \(dqbuildtime\(dq، \(dqmessage\(dq، \(dqrights\(dq، \(dqcollections\(dq و \(dqreferences\(dq.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B availability: string, default \(dqavailable\(dq
محدود کردن توصیه‌نامه‌های بازگردانده‌شده بر اساس ارتباط آن‌ها با بسته‌های نصب‌شده. مقادیر پذیرفته‌شده عبارتند از:
.INDENT 7.0
.IP \(bu 2
\(dqavailable\(dq برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده
.IP \(bu 2
\(dqall\(dq \- برای بازگرداندن همه توصیه‌نامه‌ها
.IP \(bu 2
\(dqinstalled\(dq \- برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های برابر یا قدیمی‌تر بسته‌های نصب‌شده
.IP \(bu 2
\(dqupdates\(dq \- برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده که یک به‌روزرسانی برای آن‌ها موجود است
.UNINDENT
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B names: list of strings
تنها در نظر گرفتن توصیه‌نامه‌هایی با یکی از شناسه‌های توصیه‌نامه داده‌شده. مقادیر باید شناسه‌های دقیق توصیه‌نامه باشند (مثلاً \(dqFEDORA\-2025\-beb4c9a336\(dq یا \(dqRHSA\-2024:1234\(dq). الگوهای عام و نام بسته‌ها در این گزینه پذیرفته نمی‌شوند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B types: list of strings
تنها در نظر گرفتن توصیه‌نامه‌هایی از انواع داده‌شده. انواع ممکن عبارتند از \(dqsecurity\(dq، \(dqbugfix\(dq، \(dqenhancement\(dq و \(dqnewpackage\(dq.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B contains_pkgs: list of strings
تنها در نظر گرفتن توصیه‌نامه‌های حاوی بسته‌هایی با نام‌های منطبق بر یکی از الگوهای عام داده‌شده. تطبیق بر روی نام‌های پایه بسته انجام می‌شود (برای مثال \(dqkernel\(dq، \(dqbash\(dq، \(dqbuildah\(dq). رشته‌های NEVRA یا قالب‌های name.arch پشتیبانی نمی‌شوند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B severities: list of strings
تنها در نظر گرفتن توصیه‌نامه‌هایی با شدت داده‌شده. مقادیر ممکن عبارتند از \(dqcritical\(dq، \(dqimportant\(dq، \(dqmoderate\(dq، \(dqlow\(dq و \(dqnone\(dq.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B reference_bzs: list of strings
تنها در نظر گرفتن توصیه‌نامه‌هایی که به شناسه تیکت Bugzilla داده‌شده ارجاع می‌دهند. مقادیر مورد انتظار شناسه‌های عددی هستند، مثلاً 123456.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B reference_cves: list of strings
تنها در نظر گرفتن توصیه‌نامه‌هایی که به شناسه CVE داده‌شده ارجاع می‌دهند. مقادیر مورد انتظار شناسه‌های رشته‌ای در قالب CVE هستند، مثلاً CVE\-2201\-0123.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_bz: boolean, default False
تنها در نظر گرفتن توصیه‌نامه‌هایی که به یک تیکت Bugzilla ارجاع می‌دهند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B with_cve: boolean, default False
تنها در نظر گرفتن توصیه‌نامه‌هایی که به یک تیکت CVE ارجاع می‌دهند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.UNINDENT
.SS "رابط org.rpm.dnf.v0.History"
.INDENT 0.0
.TP
.B interface org.rpm.dnf.v0.History
.INDENT 7.0
.TP
.B method recent_changes(a{sv} options) -> (a{saa{sv}} changeset)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBchangeset\fP (\fIa{saa{sv}}\fP) \-\-\ یک دیکشنری به صورت {\(dq<type_of_change>\(dq:[<package>,<package>,...]}
.UNINDENT
.UNINDENT
.sp
دریافت فهرستی از بسته‌هایی که اخیراً تغییر کرده‌اند. نتیجه نمایانگر تفاوت بین مجموعه بسته‌های نصب‌شده فعلی و مجموعه در یک نقطه زمانی معین است.
.sp
کلید \(dqtype_of_change\(dq در دیکشنری خروجی می‌تواند یکی از موارد زیر باشد: \(dqinstalled\(dq، \(dqremoved\(dq، \(dqupgraded\(dq یا \(dqdowngraded\(dq. بسته‌ها در خروجی به صورت دیکشنری‌هایی شامل مجموعه ویژگی‌های درخواستی برای بسته‌های تغییریافته نمایش داده می‌شوند.
.sp
برای بسته‌های نصب‌شده، ارتقایافته و تنزل‌یافته، نسخه نصب‌شده فعلی بازگردانده می‌شود.
.sp
برای بسته‌های ارتقایافته و تنزل‌یافته، ویژگی‌های \(dqoriginal_evr\(dq و \(dqoriginal_arch\(dq نیز گنجانده شده‌اند که شامل EVR و معماری بسته پیش از تغییر است.
.sp
در صورت درخواست، بسته‌های ارتقایافته ممکن است شامل یک فیلد فهرست \(dqadvisories\(dq نیز باشند که نام به‌روزرسانی‌های حاوی نسخه ارتقایافته (یعنی نسخه نصب‌شده فعلی) بسته را نشان می‌دهد. اگر گزینه \(dqall_advisories\(dq تنظیم شده باشد، توصیه‌نامه‌ها برای تمام نسخه‌های بین نسخه اصلی و نسخه نصب‌شده فعلی نیز گنجانده می‌شوند.
.sp
برای بسته‌های حذف‌شده، تنها نام، معماری و evr نسخه حذف‌شده ارائه می‌شود.
.sp
تمام بسته‌ها در خروجی شامل یک ویژگی \(dqtransaction_time\(dq (عدد uint64، برچسب زمانی یونیکس) هستند که نشان می‌دهد چه زمانی تراکنشی که باعث تغییر شده تکمیل شده است.
.sp
از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B upgraded_packages: boolean, default \(dqtrue\(dq
اینکه آیا بسته‌های ارتقایافته در خروجی گنجانده شوند یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B downgraded_packages: boolean, default \(dqtrue\(dq
اینکه آیا بسته‌های تنزل‌یافته در خروجی گنجانده شوند یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B installed_packages: boolean, default \(dqtrue\(dq
اینکه آیا بسته‌های نصب‌شده در خروجی گنجانده شوند یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B removed_packages: boolean, default \(dqtrue\(dq
اینکه آیا بسته‌های حذف‌شده در خروجی گنجانده شوند یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B include_advisory: boolean, default \(dqtrue\(dq
اینکه آیا ویژگی \(dqadvisories\(dq به ویژگی‌های بسته‌های ارتقایافته افزوده شود یا خیر.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B all_advisories: boolean, default \(dqfalse\(dq
تنها همراه با include_advisory=true معنا دارد. توصیه‌نامه‌ها برای تمام نسخه‌های بین نسخه اصلی و نسخه نصب‌شده فعلی را نیز شامل می‌شود.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B package_attrs: list of strings, default [\(dqname\(dq, \(dqsummary\(dq, \(dqevr\(dq, \(dqarch\(dq]
فهرست ویژگی‌های بسته که برای هر بسته تغییریافته بازگردانده می‌شود. ویژگی‌های پشتیبانی‌شده همان موارد متد list() در رابط Rpm هستند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B since: int64, unix timestamp
دریافت تغییرات از یک نقطه زمانی معین.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interactive: boolean, default false
هنگامی که عملیات توسط کاربر انجام می‌شود روی \(dqtrue\(dq تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 7.0
.TP
.B method list(a{sv} options) -> (aa{sv} transactions)
.INDENT 7.0
.TP
.B "آرگومان‌ها (Arguments)"
.INDENT 7.0
.IP \(bu 2
\fBoptions\fP (\fIa{sv}\fP) \-\-\ آرایه‌ای از جفت‌های کلید/مقدار
.UNINDENT
.TP
.B "مقادیر بازگشتی (Returns)"
.INDENT 7.0
.IP \(bu 2
\fBtransactions\fP (\fIaa{sv}\fP) \-\-\ آرایه‌ای از تراکنش‌ها به همراه بسته‌های آن‌ها
.UNINDENT
.UNINDENT
.sp
دریافت فهرستی از تراکنش‌ها از پایگاه داده تاریخچه. هر تراکنش شامل متاداده و تغییرات دسته‌بندی‌شده بسته است.
.sp
بسته‌ها در هر دسته به عنوان دیکشنری‌های حاوی مجموعه ویژگی‌های درخواستی نمایش داده می‌شوند. برای بسته‌های ارتقایافته و تنزل‌یافته، ویژگی \(dqoriginal_evr\(dq به همراه EVR اصلی بسته گنجانده شده است.
.sp
از گزینه‌های زیر پشتیبانی می‌شود:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B limit: int64
حداکثر تعداد تراکنش‌ها برای بازگرداندن.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B since: int64, unix timestamp
تنها تراکنش‌های تکمیل‌شده پس از این زمان را بازمی‌گرداند.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B reverse: boolean, default \(dqfalse\(dq
در صورت true بودن، قدیمی‌ترین تراکنش‌ها را ابتدا بازمی‌گرداند. پیش‌فرض جدیدترین در ابتدا است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B contains_pkgs: list of strings
فیلتر کردن به تراکنش‌های حاوی بسته‌هایی با این نام‌ها.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B transaction_attrs: list of strings, default [\(dqid\(dq, \(dqstart\(dq, \(dqend\(dq, \(dquser_id\(dq, \(dqdescription\(dq, \(dqstatus\(dq]
فهرست ویژگی‌های تراکنش برای گنجاندن. موارد پشتیبانی‌شده: id, start, end, user_id, description, status, releasever, comment.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B package_attrs: list of strings, default [\(dqname\(dq, \(dqarch\(dq, \(dqevr\(dq]
فهرست ویژگی‌های بسته برای گنجاندن. موارد پشتیبانی‌شده: name, epoch, version, release, arch, evr, repo_id, action, reason.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B include_packages: boolean, default \(dqtrue\(dq
اینکه آیا فهرست‌های بسته‌ها (نصب‌شده، حذف‌شده، ارتقایافته، تنزل‌یافته) گنجانده شوند یا خیر.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه‌های ناشناخته نادیده گرفته می‌شوند.
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
فایل AUTHORS.md را در توزیع سورس‌کد dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان پروژه dnf5.
.\" End of generated man page.