DNF5DAEMON-DBUS-API(8) dnf5 DNF5DAEMON-DBUS-API(8)

dnf5daemon-dbus-api - مرجع D-Bus API برای dnf5daemon

متدها و آرگومان‌های D-Bus. تولیدشده از روی XMLهای D-Bus.

نکته: در حالی که بیشتر متدهای زیر می‌توانند با موفقیت توسط یک کاربر عادی فراخوانی شوند، احراز هویت توسط یک کاربر مدیر (اداری) برای برخی از آن‌ها الزامی است (به عنوان مثال Goal.do_transaction()، Repo.confirm_key()، Repo.enable()، Repo.disable()). این احراز هویت با فراخوانی متد CheckAuthorization() از رابط D-Bus با نام org.freedesktop.PolicyKit1.Authority در Polkit مدیریت می‌شود. پرچم (فلگ) AllowUserInteraction برای این فراخوانی تنظیم شده است، که نشان می‌دهد در صورت در دسترس بودن یک عامل احراز هویت، فراخوانی در حالی که از کاربر درخواست احراز هویت می‌شود مسدود می‌گردد. یک مهلت زمانی سخت‌کدشده ۲ دقیقه‌ای برای تعامل با کاربر تنظیم شده است.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- پیکربندی نشست - آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
session_object_path (o) -- مسیر شیء به شیء نشست ایجادشده

یک نشست جدید باز می‌کند.

از گزینه‌های پیکربندی زیر پشتیبانی می‌شود:

•
در صورت true بودن، اطلاعات مربوط به بسته‌های نصب‌شده فعلی بارگذاری می‌شود.
•
در صورت true بودن، اطلاعات مربوط به بسته‌های موجود در مخازن فعال بارگذاری می‌شود.
•
بازنویسی گزینه‌های پیکربندی.
•
بازنویسی متغیر releasever که برای جایگزینی‌ها در پیکربندی‌های مخزن استفاده می‌شود.
•
بازنویسی لوکال (locale) سرور برای این نشست. بر زبانی که در پیام‌های خطای مختلف استفاده می‌شود تأثیر می‌گذارد.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
session_object_path (o) -- مسیر شیء نشستی که باید بسته شود
مقادیر بازگشتی (Returns)
•
success (b) -- مقدار بولی که نشان می‌دهد آیا نشست درخواستی با موفقیت بسته شد یا خیر

نشست را در مسیر شیء داده‌شده می‌بندد.

مقادیر بازگشتی (Returns)
•
success (b) -- مقدار true در صورتی که مخازن با موفقیت بارگذاری شوند، در غیر این صورت false.

صریحاً درخواست بارگذاری متاداده مخازن را می‌دهد.

آرگومان‌ها (Arguments)
  • cache_type (s) -- نوع کش برای پاک‌سازی. انواع پشتیبانی‌شده عبارتند از "all"، "packages"، "metadata"، "dbcache" و "expire-cache".
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار true در صورتی که کش با موفقیت پاک‌سازی شود، در غیر این صورت false.
  • error_msg (s) -- رشته، شامل خطاهای رخ‌داده هنگام پاک‌سازی کش.

داده‌های کش‌شده را حذف یا منقضی می‌کند.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
cache_type (s) -- نوع کش برای پاک‌سازی. انواع پشتیبانی‌شده عبارتند از "all"، "packages"، "metadata"، "dbcache" و "expire-cache".
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار true در صورتی که کش با موفقیت پاک‌سازی شود، در غیر این صورت false.
  • error_msg (s) -- رشته، شامل خطاهای رخ‌داده هنگام پاک‌سازی کش.

داده‌های کش‌شده را حذف یا منقضی می‌کند.

این معادل فراخوانی "clean_with_options()" با گزینه‌های خالی است.

مقادیر بازگشتی (Returns)
  • success (b) -- مقدار true در صورتی که نشست با موفقیت بازنشانی شود، در غیر این صورت false.
  • error_msg (s) -- رشته، شامل خطاهای رخ‌داده هنگام بازنشانی نشست

نشست را کاملاً بازنشانی می‌کند.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • download_id (s) -- شناسه یکتای شیء دانلودشده (مخزن یا بسته)
  • description (s) -- توضیحات شیء دانلودشده
  • total_to_download (x) -- کل بایت‌ها برای دانلود

یک دانلود جدید آغاز شده است.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • download_id (s) -- شناسه یکتای شیء دانلودشده (مخزن یا بسته)
  • total_to_download (x) -- کل بایت‌ها برای دانلود
  • downloaded (x) -- بایت‌های دانلودشده تاکنون

پیشرفت در دانلود.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • download_id (s) -- شناسه یکتای شیء دانلودشده (مخزن یا بسته)
  • message (s) -- یک پیام خطا
  • url (s) -- نشانی URL در حال دانلود
  • metadata (s) -- برای دانلود متاداده مخزن، شامل نوع متاداده است

شکست آینه (mirror) در حین دانلود.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • download_id (s) -- شناسه یکتای شیء دانلودشده (مخزن یا بسته)
  • transfer_status (u) -- وضعیت انتقال طبق libdnf5::repo::DownloadCallbacks::TransferStatus (مقادیر: 0 - موفقیت‌آمیز، 1 - از قبل موجود است، 2 - خطا)
  • message (s) -- پیام خطا در صورت ناموفق بودن دانلود

دانلود به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • key_id (s) -- شناسه کلید OpenPGP
  • user_ids (as) -- شناسه کاربر
  • key_fingerprint (s) -- اثر انگشت کلید OpenPGP
  • key_url (s) -- نشانی URL کلید OpenPGP
  • timestamp (x) -- برچسب زمانی ایجاد کلید

درخواست تأیید درون‌ریزی (import) کلید مخزن.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • key_id (s) -- شناسه کلید OpenPGP
  • user_ids (as) -- شناسه کاربر
  • key_fingerprint (s) -- اثر انگشت کلید OpenPGP
  • key_url (s) -- نشانی URL کلید OpenPGP
  • timestamp (x) -- برچسب زمانی ایجاد کلید

سیگنال اطلاعاتی صادرشده پس از درون‌ریزی موفقیت‌آمیز کلید مخزن.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
repositories (aa{sv}) -- آرایه‌ای از مخازن بازگردانده‌شده با ویژگی‌های درخواستی

دریافت فهرست مخازنی که با فیلترهای داده‌شده مطابقت دارند.

از گزینه‌های زیر پشتیبانی می‌شود:

•
هر مخزنی با شناسه‌ای که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
•
فهرست ویژگی‌های مخزن که بازگردانده می‌شوند
•
هنگامی که روی "enabled" یا "disabled" تنظیم شود، فقط مخازن فعال / غیرفعال فهرست می‌شوند. هر مقدار دیگری به این معنی است که همه مخازن بازگردانده می‌شوند.
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • key_id (s) -- شناسه کلید مورد نظر
  • confirmed (b) -- آیا درون‌ریزی کلید توسط کاربر تأیید شده است یا خیر
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی

تأیید درون‌ریزی کلید OpenPGP مخزن.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • key_id (s) -- شناسه کلید مورد نظر
  • confirmed (b) -- آیا درون‌ریزی کلید توسط کاربر تأیید شده است یا خیر

تأیید درون‌ریزی کلید OpenPGP مخزن.

این معادل فراخوانی "confirm_key_with_options()" با گزینه‌های خالی است.

آرگومان‌ها (Arguments)
  • repo_ids (as) -- آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید فعال شوند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی

فعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
repo_ids (as) -- آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید فعال شوند

فعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.

این معادل فراخوانی "enable_with_options()" با گزینه‌های خالی است.

آرگومان‌ها (Arguments)
  • repo_ids (as) -- آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید غیرفعال شوند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی

غیرفعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
repo_ids (as) -- آرایه‌ای از رشته‌ها شامل تمام شناسه‌های مخازنی که باید غیرفعال شوند

غیرفعال‌سازی مخازن بر اساس فهرست شناسه‌های داده‌شده.

این معادل فراخوانی "disable_with_options()" با گزینه‌های خالی است.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
packages (aa{sv}) -- آرایه‌ای از بسته‌های بازگردانده‌شده با ویژگی‌های درخواستی

دریافت فهرست بسته‌هایی که با فیلترهای داده‌شده مطابقت دارند. از آنجا که این متد بسته‌ها را مستقیماً در پیام پاسخ متد D-Bus که اندازه محدودی دارد بازمی‌گرداند، این احتمال وجود دارد که اندازه مجموعه بسته‌های درخواستی از این حد فراتر رود. اگر تعداد زیادی بسته و/یا تعداد زیادی ویژگی بسته درخواست می‌کنید، لطفاً استفاده از متد list_fd() را در نظر بگیرید.

از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:

•
فهرست ویژگی‌های بسته که بازگردانده می‌شوند. ویژگی‌های پشتیبانی‌شده عبارتند از: 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.
•
تطبیق الگوها با NEVRAهای بسته‌های موجود
•
تطبیق الگوها با قابلیت‌های ارائه‌شده (provides) بسته‌های موجود
•
تطبیق الگوها با نام فایل‌های موجود در بسته‌های موجود
•
تطبیق الگوها با نام باینری‌های موجود در /usr/(s)bin در بسته‌های موجود
•
گنجاندن بسته‌های rpm سورس (source rpms) در نتایج
•
نادیده گرفتن بزرگی و کوچکی حروف هنگام تطبیق الگوها
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
•
هر بسته‌ای که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
•
محدود کردن بسته‌ها به یکی از موارد "all"، "installed"، "available"، "upgrades"، "upgradable"
•
محدود کردن مجموعه حاصل فقط به بسته‌های معماری‌های داده‌شده
•
محدود کردن مجموعه حاصل فقط به بسته‌های مخازن داده‌شده
•
محدود کردن مجموعه حاصل به تنها <limit> عدد از جدیدترین بسته‌ها برای هر نام و معماری
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را ارائه می‌دهند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که به هر یک از قابلیت‌های داده‌شده نیاز دارند (requires)، آن را بهبود می‌بخشند (enhances)، توصیه می‌کنند (recommends)، پیشنهاد می‌دهند (suggests) یا تکمیل می‌کنند (supplements)
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که به هر یک از قابلیت‌های داده‌شده نیاز دارند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را توصیه می‌کنند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را بهبود می‌بخشند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را پیشنهاد می‌دهند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را تکمیل می‌کنند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که هر یک از قابلیت‌های داده‌شده را منسوخ می‌کنند
•
محدود کردن مجموعه حاصل فقط به بسته‌هایی که با هر یک از قابلیت‌های داده‌شده تداخل دارند

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
  • file_descriptor (h) -- توصیف‌گر فایل بازشده برای نوشتن که جهت انتقال داده استفاده می‌شود
مقادیر بازگشتی (Returns)
•
transfer_id (s) -- شناسه این انتقال. برای ارسال سیگنال پایان انتقال استفاده می‌شود.

بازیابی فهرستی از بسته‌ها که با فیلترهای ارائه‌شده مطابقت دارند. بسته‌ها به صورت جریانی از اشیاء JSON منتقل می‌شوند که هر شیء JSON نمایانگر یک بسته به عنوان یک دیکشنری است. این جریان سپس در توصیف‌گر فایل داده‌شده (file_descriptor) نوشته می‌شود. برخلاف متد list()، این رویکرد با مشکل بزرگی حجم داده‌های خروجی مواجه نمی‌شود. سرور یک مهلت زمانی ۳۰ ثانیه‌ای دارد که در طول آن در صورت پر بودن پایپ (pipe)، منتظر می‌ماند تا کلاینت داده‌ها را از پایپ بخواند.

از همان گزینه‌های متد list() پشتیبانی می‌شود.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم نصب شوند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار نصب

علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای نصب.

از @options زیر پشتیبانی می‌شود:

•
شناسه‌های مخازنی که بسته‌ها می‌توانند از آن‌ها نصب شوند.
•
اینکه آیا حل‌کننده وابستگی می‌تواند بسته‌های با وابستگی‌های خراب را برای حل تراکنش نادیده بگیرد یا خیر.
•
اینکه آیا بسته‌های ناموجود می‌توانند نادیده گرفته شوند یا خیر.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم ارتقا یابند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار ارتقا

علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای ارتقا.

از @options زیر پشتیبانی می‌شود:

•
شناسه‌های مخازنی که بسته‌ها می‌توانند از آن‌ها ارتقا یابند.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها که باید از روی سیستم حذف شوند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار حذف

علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای حذف.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها برای همگام‌سازی با جدیدترین نسخه‌های موجود
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار distro_sync

از @options زیر پشتیبانی می‌شود:

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم تنزل یابند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار تنزل

علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای تنزل نسخه.

از @options زیر پشتیبانی می‌شود:

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • pkg_specs (as) -- آرایه‌ای از مشخصات بسته‌ها که باید روی سیستم دوباره نصب شوند
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار نصب مجدد

علامت‌گذاری بسته‌های مشخص‌شده با @pkg_specs برای نصب مجدد.

از @options زیر پشتیبانی می‌شود:

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار system_upgrade

آماده‌سازی یک تراکنش برای ارتقا به انتشار جدید توزیع. تراکنش آماده‌شده باید در حین راه‌اندازی مجدد اجرا شود (گزینه offline از متد do_transaction در رابط Goal را ببینید). این متد متکی به این است که گزینه releasever در طول فراخوانی open_session() به درستی روی انتشار جدید توزیع تنظیم شده باشد.

از @options زیر پشتیبانی می‌شود:

•
به‌طور پیش‌فرض system_upgrade مانند dnf distro-sync عمل می‌کند و همیشه بسته‌ها را از انتشار جدید نصب می‌کند، حتی اگر از نسخه نصب‌شده فعلی قدیمی‌تر باشند. در صورت تنظیم روی "upgrade"، بسته‌های انتشار جدید در صورتی که از نسخه نصب‌شده فعلی قدیمی‌تر باشند نصب نمی‌شوند (مانند رفتار dnf upgrade).
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته
  • processed (t) -- مقدار پردازش‌شده تاکنون
  • total (t) -- کل مقدار برای پردازش

پیشرفت کلی در پردازش آیتم‌های تراکنش. درست قبل از پردازش یک آیتم فراخوانی می‌شود.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • total (t) -- تعداد عناصر در تراکنش rpm

درست قبل از اجرای تراکنش rpm ارسال می‌شود.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • success (b) -- مقدار true در صورتی که تراکنش rpm با موفقیت تکمیل شده باشد

درست پس از پایان اجرای تراکنش rpm ارسال می‌شود.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته
  • action (u) -- یکی از مقادیر شمارش dnfdaemon::RpmTransactionItem::Actions
  • total (t) -- فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات

پردازش (نصب یا حذف) بسته آغاز شده است.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته
  • processed (t) -- بخشی از بسته که تاکنون نصب/حذف شده است
  • total (t) -- فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات

پیشرفت در پردازش بسته. توجه داشته باشید که یک محدودیت سخت‌کدشده وجود دارد که برای جلوگیری از تحت فشار قرار گرفتن کاربر یا D-Bus با سیگنال‌های بیش از حد، از ارسال بیش از یک سیگنال در هر ۴۰۰ میلی‌ثانیه جلوگیری می‌کند. برای بسته‌های کوچک‌تر ممکن است هیچ سیگنال پیشرفتی ارسال نشود یا فقط سیگنال پیشرفت شروع با مقدار @processed برابر با ۰ ارسال گردد.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته
  • total (t) -- فضای دیسک اشغال‌شده/آزادشده توسط بسته پس از پایان عملیات

پردازش بسته به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
  • scriptlet_type (u) -- نوع اسکریپت‌لت آغازشده (pre، post، ...)

اسکریپت‌لت آغاز شده است.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
  • scriptlet_type (u) -- نوع اسکریپت‌لت آغازشده (pre، post، ...)
  • return_code (t) -- مقدار بازگشتی اسکریپت

اسکریپت‌لت با موفقیت به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته‌ای که اسکریپت به آن تعلق دارد
  • scriptlet_type (u) -- نوع اسکریپت‌لت آغازشده (pre، post، ...)
  • return_code (t) -- مقدار بازگشتی اسکریپت

اسکریپت‌لت با خطا به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • total (t) -- کل مقدار برای پردازش

اعتبارسنجی فایل‌های بسته آغاز شد.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • processed (t) -- مقدار پردازش‌شده تاکنون
  • total (t) -- کل مقدار برای پردازش

پیشرفت در پردازش بسته.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • total (t) -- کل مقدار برای پردازش

اعتبارسنجی فایل‌های بسته به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • total (t) -- کل مقدار برای پردازش

آماده‌سازی بسته‌های تراکنش آغاز شد.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • processed (t) -- مقدار پردازش‌شده تاکنون
  • total (t) -- کل مقدار برای پردازش

پیشرفت در آماده‌سازی بسته‌های تراکنش.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • total (t) -- کل مقدار برای پردازش

آماده‌سازی بسته‌های تراکنش به پایان رسید.

آرگومان‌ها (Arguments)
  • session_object_path (o) -- مسیر شیء نشست dnf5daemon
  • nevra (s) -- شناسه کامل NEVRAی بسته

خطا هنگام استخراج (unpack) بسته.

آرگومان‌ها (Arguments)
  • success (b) -- مقدار true در صورتی که انتقال با موفقیت پایان یافته باشد
  • transfer_id (s) -- شناسه انتقال پایان‌یافته
  • error_msg (s) -- پیام خطا در صورتی که انتقال موفقیت‌آمیز نبوده باشد.

به کاربر اطلاع می‌دهد که نوشتن در توصیف‌گر فایل با transfer_id داده‌شده پایان یافته و توصیف‌گر بسته شده است.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار حل وابستگی
مقادیر بازگشتی (Returns)
  • transaction_items (a(sssa{sv}a{sv})) -- آرایه‌ای از چندتایی‌های (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} است. در حال حاضر ویژگی "reason_change_group_id" برای شناسه گروه هدف در صورتی که عمل ReasonChange و دلیل Group باشد استفاده می‌شود، و "replaces" شامل برداری از شناسه‌های بسته‌هایی است که توسط این آیتم جایگزین می‌شوند. در نهایت، شیء یک نگاشت {attribute: value} است و (بر اساس object_type) نشان‌دهنده بسته، گروه، محیط، یا ماژول است. این ویژگی‌های بسته بازگردانده می‌شوند: "name"، "epoch"، "version"، "release"، "arch"، "repo_id"، "from_repo_id"، "package_size"، "install_size"، "evr" و "reason". برای گروه‌ها، شیء شامل ویژگی‌های "groupid" و "name" است.
  • result (u) -- مشکلات شناسایی‌شده در طول حل تراکنش. مقادیر ممکن عبارتند از: 0 - بدون مشکل، 1 - بدون مشکل، اما برخی اطلاعات / هشدارها وجود دارند، یا 2 - حل وابستگی با شکست مواجه شد.

حل کردن تراکنش.

از @options زیر پشتیبانی می‌شود:
•
اینکه آیا حذف بسته نصب‌شده برای حل تراکنش مجاز است یا خیر.
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

مقادیر بازگشتی (Returns)
•
problems (as) -- آرایه‌ای از رشته‌ها شامل تمام مشکلات یافت‌شده در طول حل تراکنش.

تمام مشکلات یافت‌شده در طول حل تراکنش را به عنوان پیام‌های قابل خواندن برای انسان بازمی‌گرداند.

مقادیر بازگشتی (Returns)
•
problems (aa{sv}) -- آرایه‌ای از نگاشت‌های {key: value}

تمام مشکلات یافت‌شده در حین حل تراکنش را به عنوان ساختارها بازمی‌گرداند. این فهرست کلیدهای مشکل است: همیشه موجود: 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 زیرین

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر اجرای تراکنش

اجرای تراکنش حل‌شده.

از @options زیر پشتیبانی می‌شود:
•
افزودن یک یادداشت (کامنت) به تراکنش.
•
در صورت true بودن، تراکنش برای اجرا در طول راه‌اندازی مجدد بعدی آماده می‌شود. در غیر این صورت، بلافاصله اجرا خواهد شد.
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.
•
در صورت true بودن، فقط مجموعه بسته‌های حل‌شده را بدون اجرای یک تراکنش RPM دانلود می‌کند. همراه با گزینه offline، فایل‌های تراکنش آفلاین آماده می‌شوند، اما اجرای تراکنش آغاز نمی‌شود.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

مقادیر بازگشتی (Returns)
  • success (b) -- مقدار true در صورتی که لغو با موفقیت درخواست شده باشد
  • error_msg (s) -- پیام خطا در صورتی که لغو رد شده باشد

لغو تراکنشی که توسط do_transaction() آغاز شده بود. تراکنش فقط در مرحله دانلود بسته قابل لغو است. هنگامی که تراکنش RPM آغاز شد، لغو دیگر مجاز نیست.

بازنشانی تراکنش rpm آماده‌شده. پس از این فراخوانی، نشست آماده اجرای یک تراکنش rpm دیگر است.

مقادیر بازگشتی (Returns)
  • pending (b) -- مقدار بولی، مقدار true در صورتی که یک تراکنش آفلاین معلق وجود داشته باشد
  • transaction_status (a{sv}) -- وضعیت تراکنش آفلاین dnf5 فعلی

بررسی می‌کند که آیا یک تراکنش آفلاین پیکربندی‌شده برای راه‌اندازی مجدد بعدی که توسط dnf5 آغاز شده وجود دارد یا خیر و وضعیت آن را بازمی‌گرداند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، در صورت بروز خطا در حین لغو تراکنش، یا اگر تراکنش آفلاین توسط ابزاری غیر از dnf5 آغاز شده باشد، false را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت لغو شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، true را بازمی‌گرداند.
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام لغو تراکنش

لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده است. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزار دیگر لغو نمی‌شوند.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، در صورت بروز خطا در حین لغو تراکنش، یا اگر تراکنش آفلاین توسط ابزاری غیر از dnf5 آغاز شده باشد، false را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت لغو شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، true را بازمی‌گرداند.
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام لغو تراکنش

لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده است. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزار دیگر لغو نمی‌شوند.

این معادل فراخوانی "cancel_with_options()" با گزینه‌های خالی است.

مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، در صورت بروز خطا در طول پاک‌سازی تراکنش، false را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت پاک‌سازی شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، true را بازمی‌گرداند.
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام پاک‌سازی تراکنش

لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده و حذف تمام داده‌های ذخیره‌شده تراکنش آفلاین، از جمله بسته‌های دانلودشده. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزاری دیگر تحت تأثیر قرار نمی‌گیرند.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv})
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، در صورت بروز خطا در طول پاک‌سازی تراکنش، false را بازمی‌گرداند. اگر تراکنش آفلاین با موفقیت پاک‌سازی شود یا هیچ تراکنش آفلاینی پیکربندی نشده باشد، true را بازمی‌گرداند.
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام پاک‌سازی تراکنش

لغو تراکنش آفلاین dnf5 که برای راه‌اندازی مجدد بعدی پیکربندی شده و حذف تمام داده‌های ذخیره‌شده تراکنش آفلاین، از جمله بسته‌های دانلودشده. به‌روزرسانی‌های آفلاین زمان‌بندی‌شده توسط ابزاری دیگر تحت تأثیر قرار نمی‌گیرند.

این معادل فراخوانی "clean_with_options()" با گزینه‌های خالی است.

آرگومان‌ها (Arguments)
  • action (s) -- رشته، یکی از "poweroff" یا "reboot". در صورت تنظیم روی "poweroff"، سیستم پس از اعمال تراکنش آفلاین خاموش خواهد شد. در غیر این صورت سیستم مجدداً راه‌اندازی می‌شود.
  • options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، مقدار true در صورتی که عمل با موفقیت تنظیم شده باشد
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام تنظیم عمل

تنظیم عملی که باید پس از اعمال تراکنش آفلاین انجام شود. اگر action برابر با "poweroff" باشد، سیستم خاموش می‌شود، در غیر این صورت راه‌اندازی مجدد خواهد شد (که پیش‌فرض است). در صورتی که هیچ تراکنش آفلاین زمان‌بندی‌شده‌ای وجود نداشته باشد، یا تراکنش با استفاده از libdnf5 زمان‌بندی نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
action (s) -- رشته، یکی از "poweroff" یا "reboot". در صورت تنظیم روی "poweroff"، سیستم پس از اعمال تراکنش آفلاین خاموش خواهد شد. در غیر این صورت سیستم مجدداً راه‌اندازی می‌شود.
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، مقدار true در صورتی که عمل با موفقیت تنظیم شده باشد
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام تنظیم عمل

تنظیم عملی که باید پس از اعمال تراکنش آفلاین انجام شود. اگر action برابر با "poweroff" باشد، سیستم خاموش می‌شود، در غیر این صورت راه‌اندازی مجدد خواهد شد (که پیش‌فرض است). در صورتی که هیچ تراکنش آفلاین زمان‌بندی‌شده‌ای وجود نداشته باشد، یا تراکنش با استفاده از libdnf5 زمان‌بندی نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.

این معادل فراخوانی "set_finish_action_with_options()" با گزینه‌های خالی است.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار برای تغییر رفتار فراخوانی
مقادیر بازگشتی (Returns)
  • success (b) -- مقدار بولی، مقدار true در صورتی که تراکنش آفلاین با موفقیت برای بوت بعدی زمان‌بندی شده باشد
  • error_msg (s) -- رشته، شامل خطای رخ‌داده هنگام زمان‌بندی تراکنش

زمان‌بندی تراکنش آفلاین آماده‌شده برای بوت بعدی. این کار پیوند نمادین جادویی /system-update را ایجاد کرده و وضعیت تراکنش را روی "ready" قرار می‌دهد. سیستم مجدداً راه‌اندازی نخواهد شد؛ فراخواننده مسئول آغاز راه‌اندازی مجدد در زمان مناسب است.

در صورتی که تراکنش آفلاینی در وضعیت "download-complete" یا "ready" وجود نداشته باشد، یا تراکنش با استفاده از libdnf5 آماده نشده باشد، ممکن است این فراخوانی با شکست مواجه شود.

از @options زیر پشتیبانی می‌شود:
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
groups (aa{sv}) -- آرایه‌ای از گروه‌های بازگردانده‌شده با ویژگی‌های درخواستی

دریافت فهرست گروه‌هایی که با فیلترهای داده‌شده مطابقت دارند.

از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:

•
فهرست ویژگی‌های گروه که بازگردانده می‌شوند
•
تطبیق الگوها با شناسه‌های گروه‌ها
•
تطبیق الگوها با نام‌های گروه‌ها
•
محدود کردن گروه‌ها به یکی از موارد "all"، "installed"، "available"
•
گنجاندن گروه‌های مخفی در نتیجه
•
هر گروهی که با هر یک از الگوها مطابقت داشته باشد بازگردانده می‌شود
•
تنها شامل گروه‌هایی می‌شود که حاوی بسته‌های داده‌شده هستند
•
کد زبان برای ویژگی‌های translated_name و translated_description
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
advisories (aa{sv}) -- آرایه‌ای از توصیه‌نامه‌های بازگردانده‌شده با ویژگی‌های درخواستی

دریافت فهرست توصیه‌نامه‌های امنیتی که با فیلترهای داده‌شده مطابقت دارند.

از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:

•
فهرست ویژگی‌های توصیه‌نامه که در آرایه advisories بازگردانده می‌شوند. ویژگی‌های پشتیبانی‌شده عبارتند از "advisoryid"، "name"، "title"، "type"، "severity"، "status"، "vendor"، "description"، "buildtime"، "message"، "rights"، "collections" و "references".
•
محدود کردن توصیه‌نامه‌های بازگردانده‌شده بر اساس ارتباط آن‌ها با بسته‌های نصب‌شده. مقادیر پذیرفته‌شده عبارتند از:
  • "available" برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده
  • "all" - برای بازگرداندن همه توصیه‌نامه‌ها
  • "installed" - برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های برابر یا قدیمی‌تر بسته‌های نصب‌شده
  • "updates" - برای بازگرداندن تنها توصیه‌نامه‌های حاوی نسخه‌های جدیدتر بسته‌های نصب‌شده که یک به‌روزرسانی برای آن‌ها موجود است
•
تنها در نظر گرفتن توصیه‌نامه‌هایی با یکی از شناسه‌های توصیه‌نامه داده‌شده. مقادیر باید شناسه‌های دقیق توصیه‌نامه باشند (مثلاً "FEDORA-2025-beb4c9a336" یا "RHSA-2024:1234"). الگوهای عام و نام بسته‌ها در این گزینه پذیرفته نمی‌شوند.
•
تنها در نظر گرفتن توصیه‌نامه‌هایی از انواع داده‌شده. انواع ممکن عبارتند از "security"، "bugfix"، "enhancement" و "newpackage".
•
تنها در نظر گرفتن توصیه‌نامه‌های حاوی بسته‌هایی با نام‌های منطبق بر یکی از الگوهای عام داده‌شده. تطبیق بر روی نام‌های پایه بسته انجام می‌شود (برای مثال "kernel"، "bash"، "buildah"). رشته‌های NEVRA یا قالب‌های name.arch پشتیبانی نمی‌شوند.
•
تنها در نظر گرفتن توصیه‌نامه‌هایی با شدت داده‌شده. مقادیر ممکن عبارتند از "critical"، "important"، "moderate"، "low" و "none".
•
تنها در نظر گرفتن توصیه‌نامه‌هایی که به شناسه تیکت Bugzilla داده‌شده ارجاع می‌دهند. مقادیر مورد انتظار شناسه‌های عددی هستند، مثلاً 123456.
•
تنها در نظر گرفتن توصیه‌نامه‌هایی که به شناسه CVE داده‌شده ارجاع می‌دهند. مقادیر مورد انتظار شناسه‌های رشته‌ای در قالب CVE هستند، مثلاً CVE-2201-0123.
•
تنها در نظر گرفتن توصیه‌نامه‌هایی که به یک تیکت Bugzilla ارجاع می‌دهند.
•
تنها در نظر گرفتن توصیه‌نامه‌هایی که به یک تیکت CVE ارجاع می‌دهند.
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
changeset (a{saa{sv}}) -- یک دیکشنری به صورت {"<type_of_change>":[<package>,<package>,...]}

دریافت فهرستی از بسته‌هایی که اخیراً تغییر کرده‌اند. نتیجه نمایانگر تفاوت بین مجموعه بسته‌های نصب‌شده فعلی و مجموعه در یک نقطه زمانی معین است.

کلید "type_of_change" در دیکشنری خروجی می‌تواند یکی از موارد زیر باشد: "installed"، "removed"، "upgraded" یا "downgraded". بسته‌ها در خروجی به صورت دیکشنری‌هایی شامل مجموعه ویژگی‌های درخواستی برای بسته‌های تغییریافته نمایش داده می‌شوند.

برای بسته‌های نصب‌شده، ارتقایافته و تنزل‌یافته، نسخه نصب‌شده فعلی بازگردانده می‌شود.

برای بسته‌های ارتقایافته و تنزل‌یافته، ویژگی‌های "original_evr" و "original_arch" نیز گنجانده شده‌اند که شامل EVR و معماری بسته پیش از تغییر است.

در صورت درخواست، بسته‌های ارتقایافته ممکن است شامل یک فیلد فهرست "advisories" نیز باشند که نام به‌روزرسانی‌های حاوی نسخه ارتقایافته (یعنی نسخه نصب‌شده فعلی) بسته را نشان می‌دهد. اگر گزینه "all_advisories" تنظیم شده باشد، توصیه‌نامه‌ها برای تمام نسخه‌های بین نسخه اصلی و نسخه نصب‌شده فعلی نیز گنجانده می‌شوند.

برای بسته‌های حذف‌شده، تنها نام، معماری و evr نسخه حذف‌شده ارائه می‌شود.

تمام بسته‌ها در خروجی شامل یک ویژگی "transaction_time" (عدد uint64، برچسب زمانی یونیکس) هستند که نشان می‌دهد چه زمانی تراکنشی که باعث تغییر شده تکمیل شده است.

از گزینه‌ها و فیلترهای زیر پشتیبانی می‌شود:

•
اینکه آیا بسته‌های ارتقایافته در خروجی گنجانده شوند یا خیر.
•
اینکه آیا بسته‌های تنزل‌یافته در خروجی گنجانده شوند یا خیر.
•
اینکه آیا بسته‌های نصب‌شده در خروجی گنجانده شوند یا خیر.
•
اینکه آیا بسته‌های حذف‌شده در خروجی گنجانده شوند یا خیر.
•
اینکه آیا ویژگی "advisories" به ویژگی‌های بسته‌های ارتقایافته افزوده شود یا خیر.
•
تنها همراه با include_advisory=true معنا دارد. توصیه‌نامه‌ها برای تمام نسخه‌های بین نسخه اصلی و نسخه نصب‌شده فعلی را نیز شامل می‌شود.
•
فهرست ویژگی‌های بسته که برای هر بسته تغییریافته بازگردانده می‌شود. ویژگی‌های پشتیبانی‌شده همان موارد متد list() در رابط Rpm هستند.
•
دریافت تغییرات از یک نقطه زمانی معین.
•
هنگامی که عملیات توسط کاربر انجام می‌شود روی "true" تنظیم می‌شود، بنابراین تعامل با کاربر مانند اعلان‌های رمز عبور امکان‌پذیر است.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

آرگومان‌ها (Arguments)
•
options (a{sv}) -- آرایه‌ای از جفت‌های کلید/مقدار
مقادیر بازگشتی (Returns)
•
transactions (aa{sv}) -- آرایه‌ای از تراکنش‌ها به همراه بسته‌های آن‌ها

دریافت فهرستی از تراکنش‌ها از پایگاه داده تاریخچه. هر تراکنش شامل متاداده و تغییرات دسته‌بندی‌شده بسته است.

بسته‌ها در هر دسته به عنوان دیکشنری‌های حاوی مجموعه ویژگی‌های درخواستی نمایش داده می‌شوند. برای بسته‌های ارتقایافته و تنزل‌یافته، ویژگی "original_evr" به همراه EVR اصلی بسته گنجانده شده است.

از گزینه‌های زیر پشتیبانی می‌شود:

•
حداکثر تعداد تراکنش‌ها برای بازگرداندن.
•
تنها تراکنش‌های تکمیل‌شده پس از این زمان را بازمی‌گرداند.
•
در صورت true بودن، قدیمی‌ترین تراکنش‌ها را ابتدا بازمی‌گرداند. پیش‌فرض جدیدترین در ابتدا است.
•
فیلتر کردن به تراکنش‌های حاوی بسته‌هایی با این نام‌ها.
•
فهرست ویژگی‌های تراکنش برای گنجاندن. موارد پشتیبانی‌شده: id, start, end, user_id, description, status, releasever, comment.
•
فهرست ویژگی‌های بسته برای گنجاندن. موارد پشتیبانی‌شده: name, epoch, version, release, arch, evr, repo_id, action, reason.
•
اینکه آیا فهرست‌های بسته‌ها (نصب‌شده، حذف‌شده، ارتقایافته، تنزل‌یافته) گنجانده شوند یا خیر.

گزینه‌های ناشناخته نادیده گرفته می‌شوند.

فایل AUTHORS.md را در توزیع سورس‌کد dnf5 ببینید.

مشارکت‌کنندگان پروژه dnf5.

September 6, 2026