TRACE-CMD-DUMP(1)              libtracefs Manual             TRACE-CMD-DUMP(1)

نام (NAME)
       trace-cmd-dump - نمایش فراداده‌های یک فایل ردگیری ایجادشده توسط
       trace-cmd record

خلاصه دستور (SYNOPSIS)
       trace-cmd dump [OPTIONS] [input-file]

توضیحات (DESCRIPTION)
       دستور trace-cmd(1) dump فراداده‌های یک فایل ردگیری ایجادشده توسط
       trace-cmd record را نمایش می‌دهد.

گزینه‌ها (OPTIONS)
       -i input-file
           به‌طور پیش‌فرض، trace-cmd dump فایل trace.dat را می‌خواند؛ اما گزینهٔ
           -i به جای آن input-file مشخص‌شده را باز می‌کند. توجه داشته باشید که
           فایل ورودی را می‌توان به عنوان آخرین مؤلفه در خط فرمان نیز مشخص کرد.

       -v, --validate
           بررسی می‌کند که آیا فایل ورودی یک فایل ردگیری معتبر ایجادشده توسط
           trace-cmd است یا خیر.

       --summary
           چاپ خلاصه‌ای از فراداده‌ها - قالب اولیه و توضیح کوتاهی از هر بخش
           فایل. در صورتی که هیچ آرگومانی مشخص نشده باشد، این عمل پیش‌فرض است.

       --head-page
           چاپ اطلاعات صفحهٔ سرآیند (header page) ذخیره‌شده در فایل.

       --head-event
           چاپ اطلاعات سرآیند رویداد (event header) ذخیره‌شده در فایل.

       --ftrace-events
           چاپ قالب‌های رویدادهای خاص ftrace.

       --systems
           چاپ اطلاعات سامانه‌های رویداد ذخیره‌شده در فایل - نام و تعداد
           رویدادها برای هر سامانه.

       --events
           چاپ قالب تمامی رویدادهای ذخیره‌شده در فایل.

       --kallsyms
           چاپ اطلاعات نگاشت آدرس‌های توابع به نام‌های توابع.

       --printk
           چاپ رشته‌های قالب trace_printk() ذخیره‌شده در فایل.

       --cmd-lines
           چاپ نگاشت شناسه فرایند (PID) به نام فرایند.

       --options
           چاپ تمامی گزینه‌های ذخیره‌شده در فایل.

       --flyrecord
           چاپ مبدأ نسبی (offset) و اندازهٔ داده‌های ردگیری برای هر CPU.

       --clock
           چاپ ساعت ردگیری (trace clock) ذخیره‌شده در فایل که برای برچسب زمانی
           رویدادهای ردگیری استفاده می‌شود.

       --all
           چاپ تمامی فراداده‌های موجود در فایل.

       --help
           چاپ اطلاعات نحوه استفاده.

       --verbose[=level]
           تنظیم سطح ثبت گزارش (log level). سطوح گزارش پشتیبانی‌شده عبارتند از
           "none"، "critical"، "error"، "warning"، "info"، "debug"، "all" یا
           شناسه‌های آن‌ها "0"، "1"، "2"، "3"، "4"، "5"، "6". تنظیم سطح گزارش
           روی یک مقدار مشخص، تمام گزارش‌های آن سطح و تمام سطوح قبلی را فعال
           می‌کند. در صورتی که سطحی تعیین نشود، مقدار پیش‌فرض "info" خواهد بود.

               مثال: فعال‌سازی تمام گزارش‌های critical ،error و warning

               trace-cmd report --verbose=warning

مثال‌ها (EXAMPLES)
           # trace-cmd dump --summary -i trace.dat

            Tracing meta data in file trace.dat:
                   [Initial format]
                           6       [Version]
                           0       [Little endian]
                           8       [Bytes in a long]
                           4096    [Page size, bytes]
                   [Header info, 205 bytes]
                   [Header event, 205 bytes]
                   [Ftrace format, 15 events]
                   [Events format, 2 systems]
                   [Kallsyms, 7144493 bytes]
                   [Trace printk, 2131 bytes]
                   [Saved command lines, 117 bytes]
                   8 [CPUs with tracing data]
                   [12 options]
                   [Flyrecord tracing data]

           # trace-cmd dump --flyrecord -i trace.dat
                   [Flyrecord tracing data]
                            7176192 0      [offset, size of cpu 0]
                            7176192 0      [offset, size of cpu 1]
                            7176192 0      [offset, size of cpu 2]
                            7176192 4096   [offset, size of cpu 3]
                            7180288 4096   [offset, size of cpu 4]
                            7184384 0      [offset, size of cpu 5]
                            7184384 0      [offset, size of cpu 6]
                            7184384 0      [offset, size of cpu 7]

           # trace-cmd dump --summary --systems -i trace.dat

            Tracing meta data in file trace.dat:
                   [Initial format]
                           6       [Version]
                           0       [Little endian]
                           8       [Bytes in a long]
                           4096    [Page size, bytes]
                   [Header info, 205 bytes]
                   [Header event, 205 bytes]
                   [Ftrace format, 15 events]
                   [Events format, 3 systems]
                           sched 23 [system, events]
                           irq 5 [system, events]
                           kvm 70 [system, events]
                   [Kallsyms, 7144493 bytes]
                   [Trace printk, 2131 bytes]
                   [Saved command lines, 157 bytes]
                   8 [CPUs with tracing data]
                   [11 options]
                   [Flyrecord tracing data]

           # trace-cmd dump --summary --systems -i trace.dat
           File trace.dat is a valid trace-cmd file

همچنین ببینید (SEE ALSO)
       trace-cmd(1), trace-cmd.dat(1)

نویسندگان (AUTHORS)
       Steven Rostedt <rostedt@goodmis.org[1]>، نویسندهٔ trace-cmd. Tzvetomir
       Stoyanov <tz.stoyanov@gmail.com[2]>، نویسندهٔ این صفحهٔ راهنما.

منابع (RESOURCES)
       https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git

کپی‌رایت و تکثیر (COPYRIGHT)
       حق نشر © 2010 شرکت Red Hat, Inc. استفاده آزاد از این نرم‌افزار تحت شرایط
       مجوز عمومی همگانی گنو (GPL) مجاز است.

نکات (NOTES)
        1. rostedt@goodmis.org
           mailto:rostedt@goodmis.org

        2. tz.stoyanov@gmail.com
           mailto:tz.stoyanov@gmail.com

libtracefs                        03/09/2026                 TRACE-CMD-DUMP(1)