| DNF5-HISTORY(8) | dnf5 | DNF5-HISTORY(8) |
نام (NAME)
dnf5-history - مدیریت تاریخچه تراکنشها در DNF5
خلاصه دستور (SYNOPSIS)
dnf5 history <subcommand> [options] [<transaction-spec>]
توضیحات (DESCRIPTION)
دستور history در DNF5 به کاربر امکان میدهد آنچه را که در تراکنشهای گذشته رخ داده مشاهده کند و چندین عملیات را روی این تراکنشها، مانند بازگردانی (undo) و تکرار مجدد (redo)، ارائه میدهد. برای استفاده از تراکنشها در این دستورات، فرض بر این است که آنها در هنگام فعال بودن گزینه پیکربندی history_record ثبت شدهاند.
برای اطلاعات بیشتر درباره <transaction-spec> به dnf5-specs(7)، بخش مشخصات الگوها (Patterns specification) <#transaction-spec-label> مراجعه کنید.
زیردستورها (SUBCOMMANDS)
- list
-
فهرست کردن اطلاعات مربوط به تراکنشهای ثبتشده در سیستم. اگر هیچ <transaction-spec> مشخص نشود، از تمام تراکنشها استفاده میکند.
- info
-
چاپ جزئیات مربوط به تراکنشهای مشخصشده. اگر هیچ <transaction-spec> مشخص نشود، از آخرین تراکنش استفاده میکند.
- undo
-
بازگردانی تمام اقدامات حاصل از تراکنش مشخصشده. دقیقاً باید یک تراکنش توسط <transaction-spec> مشخص شود.
- redo
-
تکرار مجدد تراکنش مشخصشده. بهطور خودکار از --ignore-extras و --ignore-installed استفاده میکند. برخلاف سایر دستورات تاریخچه، این دستور دلایل بستههای تراکنش را که از قبل نصب شدهاند بازنویسی میکند. این دستور برای تکمیل تراکنشهای نیمهکاره مفید است. دقیقاً باید یک تراکنش توسط <transaction-spec> مشخص شود.
- rollback
-
بازگردانی تمامی تراکنشهایی که پس از تراکنش مشخصشده انجام شدهاند. دقیقاً باید یک تراکنش توسط <transaction-spec> مشخص شود.
- store
-
ذخیره تراکنش در یک دایرکتوری. اگر هیچ <transaction-spec> مشخص نشود، از آخرین تراکنش استفاده میکند.
گزینههای LIST و INFO (OPTIONS FOR LIST AND INFO)
- --reverse
-
معکوس کردن ترتیب تراکنشها در خروجی.
- --contains-pkgs=PACKAGE_NAME,...
-
نمایش تنها تراکنشهایی که شامل بستههایی با نامهای مشخصشده هستند. این یک گزینه لیستی است. الگوهای سراسری (Globs) پشتیبانی میشوند.
- --json
-
درخواست قالب خروجی JSON برای نتایج ماشینخوان. تنها برای زیردستورهای list و info در دسترس است.
گزینههای UNDO، ROLLBACK و REDO (OPTIONS FOR UNDO, ROLLBACK AND REDO)
- --skip-unavailable
-
اجازه رد کردن عملیات بستههایی که امکان انجام آنها وجود ندارد.
- --offline
-
ذخیره تراکنش برای اجرا بهصورت آفلاین. دستور offline را ببینید <#offline-command-ref-label>، dnf5-offline(8).
- --transient
- تنها در سیستمهای bootc (کانتینرهای قابل بوت) کاربرد دارد. انجام تراکنشها با استفاده از یک لایه موقت (transient overlay) که با راهاندازی مجدد بعدی از بین خواهد رفت. همچنین گزینه پیکربندی persistence <#persistence-options-label> را ببینید.
- --store=PATH
-
ذخیره تراکنش جاری در دایرکتوری واقع در PATH مشخصشده بهجای اجرای آن. تراکنش ذخیرهشده را میتوان با دستور replay اجرا کرد <#replay-command-ref-label>، dnf5-replay(8). توجه داشته باشید که شناسههای مخزن در تراکنش ذخیرهشده به @stored_transaction(repo_id) تبدیل میشوند؛ این کار لازم است چرا که هنگام اجرای مجدد، مخازن ذخیرهشده بازسازی میشوند و ممکن است با مخازن موجود تداخل ایجاد کنند (این موضوع برای مخزن ویژه @System صدق نمیکند).
گزینههای UNDO و ROLLBACK (OPTIONS FOR UNDO AND ROLLBACK)
- --ignore-extras
-
بستههای اضافی واردشده به تراکنش خطا در نظر گرفته نشوند. آنها همچنان بهعنوان هشدار گزارش خواهند شد.
- --ignore-installed
-
عدم تطابق میان بستههای نصبشده و بستههای تراکنش ذخیرهشده خطا در نظر گرفته نشود. آنها همچنان بهعنوان هشدار گزارش خواهند شد. استفاده از این گزینه میتواند منجر به یک تراکنش خالی شود. برای عملیات نصب، بستههای از قبل نصبشده نادیده گرفته میشوند. برای عملیات ارتقا، گروهها یا محیطهایی که نصب نشدهاند نادیده گرفته میشوند. برای عملیات حذف، بستهها/گروهها/محیطهای نصبنشده نادیده گرفته میشوند.
مثالها (EXAMPLES)
- dnf5 history list
-
فهرست کردن تمام تراکنشها، بهطوری که جدیدترین تراکنش در ابتدا نمایش داده میشود.
- dnf5 history info 4
-
نمایش اطلاعات دقیق درباره چهارمین تراکنش.
- dnf5 history info last
-
نمایش اطلاعات دقیق درباره آخرین تراکنش.
- dnf5 history info last-1
-
نمایش اطلاعات دقیق درباره تراکنش یکی مانده به آخر.
- dnf5 history list 4..8
-
فهرست کردن تراکنشهایی با شناسه در محدوده ۴ تا ۸.
- dnf5 history undo last
-
بازگردانی آخرین تراکنش.
- dnf5 history undo 4 --ignore-extras
-
بازگردانی چهارمین تراکنش با نادیده گرفتن بستههای اضافی واردشده به تراکنش بازگردانی.
- dnf5 history list --json
-
فهرست کردن تمام تراکنشها در قالب JSON برای پردازش خودکار برنامهای.
- dnf5 history info last --json
-
نمایش اطلاعات دقیق درباره آخرین تراکنش در قالب JSON همراه با جزئیات کامل بستهها.
خروجی JSON (JSON OUTPUT)
- •
- dnf5 history list --json
این دستور یک آرایه JSON برمیگرداند که هر عنصر آن یک تراکنش را توصیف میکند. هر شیء تراکنش شامل فیلدهای زیر است:
- id (integer) - شناسه تراکنش.
- command_line (string) - خط فرمانی که تراکنش را آغاز کرد.
- start_time (integer) - زمان شروع تراکنش، به وقت UNIX.
- end_time (integer) - زمان پایان تراکنش، به وقت UNIX.
- user_id (integer) - شناسه کاربری که تراکنش را آغاز کرد.
- status (string) - وضعیت تراکنش، معمولاً "Ok".
- releasever (string) - نسخه انتشار سیستم هنگام وقوع تراکنش.
- altered_count (integer) - تعداد بستههای تغییریافته در تراکنش.
- •
- dnf5 history info --json
این دستور یک آرایه JSON برمیگرداند که هر عنصر آن یک تراکنش را توصیف میکند. هر شیء تراکنش شامل فیلدهای زیر است:
- id (integer) - شناسه تراکنش.
- start_time (integer) - زمان شروع تراکنش، به وقت UNIX.
- end_time (integer) - زمان پایان تراکنش، به وقت UNIX.
- rpmdb_version_begin (string) - نسخه پایگاه داده RPM پیش از تراکنش.
- rpmdb_version_end (string) - نسخه پایگاه داده RPM پس از تراکنش.
- user_id (integer) - شناسه کاربری که تراکنش را آغاز کرد.
- user_name (string) - نام و جزئیات کاربری که تراکنش را آغاز کرد.
- status (string) - وضعیت تراکنش، معمولاً "Ok".
- releasever (string) - نسخه انتشار سیستم هنگام وقوع تراکنش.
- description (string) - خط فرمانی که تراکنش را آغاز کرد.
- comment (string) - نظر کاربر برای تراکنش (معمولاً خالی).
- packages (array) - فهرست بستههای تغییریافته در تراکنش. هر شیء بسته شامل موارد زیر است:
- nevra (string) - نام-دوره:نسخه-انتشار.معماری بسته (Package name-epoch:version-release.architecture).
- action (string) - عملیات انجامشده (Install، Remove، Upgrade و غیره).
- reason (string) - دلیل عملیات (User، Dependency و غیره).
- repository (string) - مخزنی که بسته از آن آمده است.
- groups (array) - فهرست گروههای بستههای تغییریافته (تنها در صورت تغییر گروهها وجود دارد).
- environments (array) - فهرست محیطهای بستههای تغییریافته (تنها در صورت تغییر محیطها وجود دارد).
برای نتایج خالی، هر دو دستور [] برمیگردانند.
همچنین ببینید (SEE ALSO)
dnf5-specs(7), Patterns specification <#specs-misc-ref-label>
نویسندگان (AUTHORS)
بخش AUTHORS.md را در توزیع منبع dnf5 ببینید.
حق نشر (COPYRIGHT)
مشارکتکنندگان در پروژه dnf5.
| September 6, 2026 |