که در آن M، N و K اعدادی (در قالب دهدهی، هگز یا اوکتال) هستند. مقادیر
مجاز برای هر یک از 'config'، 'config1' و 'config2' توسط مدخل‌های
متناظر در /sys/bus/event_source/devices/<pmu>/format/* مشخص می‌شوند.
پارامترهای param1 و param2 به عنوان قالب‌هایی برای PMU در این مسیر تعریف شده‌اند:
/sys/bus/event_source/devices/<pmu>/format/*

همچنین برخی پارامترها وجود دارند که در .../<pmu>/format/* تعریف نشده‌اند.
این پارامترها می‌توانند برای بازنویسی مقادیر پیکربندی پیش‌فرض برای هر رویداد استفاده شوند.
در اینجا برخی از پارامترهای رایج آورده شده است:
- 'period': تنظیم دوره نمونه‌برداری رویداد
- 'freq': تنظیم فرکانس نمونه‌برداری رویداد
- 'time': غیرفعال/فعال‌سازی برچسب زمانی. مقادیر مجاز عبارتند از ۱ برای
          فعال کردن برچسب زمانی و ۰ برای غیرفعال کردن آن.
          مقدار پیش‌فرض ۱ است.
- 'call-graph': غیرفعال/فعال‌سازی گراف فراخوانی. رشته‌های مجاز عبارتند از "fp" برای
               حالت FP،‏ "dwarf" برای حالت DWARF،‏ "lbr" برای حالت LBR و
               "no" برای غیرفعال کردن گراف فراخوانی.
- 'stack-size': اندازه پشته کاربر برای حالت dwarf
- 'name' : نام رویداد تعریف‌شده توسط کاربر. نقل‌قول تکی (') می‌تواند برای
          نادیده‌گیری نمادها در نام جهت جلوگیری از تجزیه توسط پوسته و ابزار استفاده شود
          مانند این: name=\'CPU_CLK_UNHALTED.THREAD:cmask=0x1\'.
- 'aux-output': تولید رکوردهای AUX به جای رویدادها. این مورد نیازمند این است
                که یک رویداد ناحیه AUX نیز مشخص شده باشد.
- 'aux-action': مقدار "pause" یا "resume" برای متوقف ساختن یا ازسرگیری یک رویداد
                ناحیه AUX (سرگروه) هنگام وقوع این رویداد.
                مقدار "start-paused" روی خود رویداد ناحیه AUX، آن را
                در وضعیت متوقف‌شده آغاز می‌کند.
- 'aux-sample-size': تنظیم اندازه نمونه برای نمونه‌برداری ناحیه AUX. اگر گزینه
'--aux-sample' استفاده شده باشد، مقدار aux-sample-size=0 را برای غیرفعال کردن
نمونه‌برداری ناحیه AUX برای این رویداد تنظیم کنید.

برای پارامترهای بیشتر به صفحه راهنمای perf-list(1) مراجعه کنید.

نکته: اگر کاربر به طور صریح گزینه‌هایی را تنظیم کند که با پارامترها در تضاد باشند،
مقدار تنظیم‌شده توسط پارامترها نادیده گرفته شده و بازنویسی خواهد شد.

همچنین پارامترهای پیکربندی ویژهٔ درایور PMU در مسیر
.../<pmu>/format/* تعریف نشده‌اند. هر پارامتر پیکربندی که پیش از
آن حرف '@' بیاید، در فضای کاربری تفسیر نشده و مستقیماً به درایور
PMU فرستاده می‌شود. برای نمونه:

perf record -e some_event/@cfg1,@cfg2=config/ ...

باعث می‌شود 'cfg1' و 'cfg2=config' برای پردازش بیشتر به
درایور PMU مرتبط با رویداد ارسال شوند. هیچ محدودیتی روی چیستی
پارامترهای پیکربندی وجود ندارد، تا زمانی که معنای آن‌ها توسط
درایور PMU درک و پشتیبانی شود.

در مورد tracepointها، گزینه‌های چندگانهٔ '--filter' با استفاده
از '&&' با یکدیگر ترکیب می‌شوند.

یک PMU ردگیری سخت‌افزاری، قابلیت خود برای پذیرش تعدادی فیلتر نشانی
را با مشخص کردن یک مقدار غیرصفر در مسیر
/sys/bus/event_source/devices/<pmu>/nr_addr_filters اعلام می‌کند.

فیلترهای نشانی ساختار زیر را دارند:

filter|start|stop|tracestop <start> [/ <size>] [@<file name>]

که در آن:
- 'filter': محدوده‌ای را مشخص می‌کند که ردگیری خواهد شد.
- 'start': نشانی‌ای را مشخص می‌کند که ردگیری از آن آغاز می‌شود.
- 'stop': نشانی‌ای را مشخص می‌کند که ردگیری در آن متوقف می‌شود.
- 'tracestop': محدوده‌ای را مشخص می‌کند که ردگیری درون آن متوقف خواهد شد.

پارامتر <file name> نام فایل شیء (object file)، و <start> آفست کد مورد نظر
برای ردگیری در آن فایل، و <size> اندازهٔ محدوده برای ردگیری است.
فیلترهای 'start' و 'stop' نیازی به تعیین <size> ندارند.

اگر هیچ فایل شیئی مشخص نشده باشد، هسته پیش‌فرض فرض می‌شود، که در این حالت
نشانی شروع باید یک نشانی معتبر از حافظهٔ جاری هسته باشد.

همچنین <start> می‌تواند با مشخص کردن نام یک نماد (symbol) تعیین شود. اگر
نام نماد یکتا نباشد، می‌توان با درج #n رفع ابهام کرد؛ جایی که 'n'
نماد n-اُم را به ترتیب نشانی انتخاب می‌کند. به‌طور متناوب، #0، #g یا #G
فقط یک نماد سراسری (global) را انتخاب می‌کنند. همچنین <size> می‌تواند با
تعیین نام یک نماد مشخص شود، که در این حالت اندازه تا انتهای آن نماد
محاسبه خواهد شد. برای فیلترهای 'filter' و 'tracestop'،
اگر <size> حذف شده باشد و <start> یک نماد باشد، اندازه تا پایان آن
نماد محاسبه می‌گردد.

اگر <size> حذف شود و <start> برابر با '*' باشد، نقطه شروع و اندازه از
اولین و آخرین نمادها محاسبه خواهند شد، یعنی برای ردگیری کل
فایل.

اگر نام نمادها (یا '*') ارائه شوند، باید با نویسه‌های فاصله
احاطه گردند.

فیلتر ارائه‌شده به هسته لزوماً با آنچه وارد شده است یکسان نیست.
برای مشاهده فیلتری که ارسال شده است، از گزینه -v استفاده کنید.

اگر ناحیه ردگیری در یک نگاشت واحد قرار نداشته باشد، هسته ممکن است
قادر به پیکربندی آن نباشد. رویدادهای MMAP (یا /proc/<pid>/maps) را
می‌توان بررسی کرد تا امکان‌پذیر بودن آن مشخص شود.

فیلترهای چندگانه را می‌توان با فاصله یا کاما از یکدیگر جدا کرد.

یک فیلتر BPF می‌تواند به داده‌های نمونه دسترسی داشته باشد و بر اساس
داده‌ها تصمیم‌گیری کند. کاربران برای استفاده از فیلتر BPF باید
نوع نمونه مناسبی را تنظیم کنند. فیلترهای BPF نیازمند دسترسی ریشه (root) هستند.

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

  --filter 'period > 1000, cpu == 1'
یا
  --filter 'mem_op == load || mem_op == store, mem_lvl > l1'

فیلتر نخست تنها نمونه‌هایی با period بزرگ‌تر از 1000 و شماره CPU برابر
با 1 را می‌پذیرد. فیلتر دوم هر یک از عملیات‌های حافظه load و store
را می‌پذیرد، اما سطح حافظه آن باید بالاتر از L1 باشد. از آن‌جا که
فیلدهای mem_op و mem_lvl از data_source (حافظه) می‌آیند، فقط با رویدادهایی
کار می‌کنند که فیلد data_source را مقداردهی کرده باشند.

همچنین کاربر باید جمع‌آوری آن اطلاعات را درخواست کند (در حالت بالا با
گزینه -d). در غیر این صورت، پیام زیر نمایش داده خواهد شد.

$ sudo perf record -e cycles --filter 'mem_op == load'
Error: cycles event does not have PERF_SAMPLE_DATA_SRC
 Hint: please add -d option to perf record.
failed to set filter "BPF" on event cycles with 22 (Invalid argument)

در اصل عبارت فیلتر BPF به این صورت است:

<term> <operator> <value> (("," | "||") <term> <operator> <value>)*

عبارت <term> می‌تواند یکی از موارد زیر باشد:
  ip, id, tid, pid, cpu, time, addr, period, txn, weight, phys_addr,
  code_pgsz, data_pgsz, weight1, weight2, weight3, ins_lat, retire_lat,
  p_stage_cyc, mem_op, mem_lvl, mem_snoop, mem_remote, mem_lock,
  mem_dtlb, mem_blk, mem_hops, uid, gid

عملگر <operator> می‌تواند یکی از عملگرهای زیر باشد:
  ==, !=, >, >=, <, <=, &

مقدار <value> می‌تواند یکی از موارد زیر باشد:
  <number> (برای هر عبارت)
  na, load, store, pfetch, exec (برای mem_op)
  l1, l2, l3, l4, cxl, io, any_cache, lfb, ram, pmem (برای mem_lvl)
  na, none, hit, miss, hitm, fwd, peer (برای mem_snoop)
  remote (برای mem_remote)
  na, locked (برای mem_locked)
  na, l1_hit, l1_miss, l2_hit, l2_miss, any_hit, any_miss, walk, fault (برای mem_dtlb)
  na, by_data, by_addr (برای mem_blk)
  hops0, hops1, hops2, hops3 (برای mem_hops)

نکته: دقت آستانه اندازه تا حد زیادی به پیکربندی شما بستگی دارد
- تعداد و اندازه بافرهای حلقه‌ای شما (-m). این مقدار معمولاً
برای اندازه‌های بزرگ‌تر (مانند >5M) دقیق‌تر است؛ برای مقادیر
کمتر انتظار اندازه‌های متفاوتی را داشته باشید.

یک کاربرد احتمالی این است که با وقوع یک رویداد بیرونی، فایل perf.data را که سپس احتمالاً از طریق perf script پردازش می‌شود، تکه‌تکه کنید تا تصمیم بگیرید آیا آن تصویر لحظه‌ای (snapshot) خاص از perf.data باید نگه‌داری شود یا خیر.

مستلزم --timestamp-filename، --no-buildid و --no-buildid-cache است. دلیل دو مورد آخر کاهش سربار جابه‌جایی فایل داده است. با این حال می‌توانید آن‌ها را با دستور زیر فعال کنید:

--switch-output --no-no-buildid  --no-no-buildid-cache

--switch-output-event

از همان نحو --event استفاده می‌کند؛ این رویداد ضبط نخواهد شد و صرفاً به منظور جابه‌جایی فایل perf.data به محض پردازش رویداد --switch-output توسط یک ریسه جانبی مجزا به کار می‌رود.

این ریسه جانبی برای اهداف دیگری نیز استفاده می‌شود، مانند پردازش رکوردهای PERF_RECORD_BPF_EVENT به محض وقوع، استعلام اطلاعات تکمیلی BPF از هسته و غیره.

--switch-max-files=N

--dry-run

دستور perf record --dry-run -e در صورتی که llvm.dump-obj در فایل پیکربندی روی true تنظیم شده باشد، می‌تواند مانند یک کامپایلر اسکریپت BPF عمل کند.

--synth=TYPE

رویدادهای هسته (و برخی موارد دیگر) صرف‌نظر از انتخاب این گزینه ثبت می‌شوند. برای مثال، --synth=no رویدادهای MMAP را برای هسته و ماژول‌ها در بر خواهد داشت.

انواع موجود عبارتند از:

هنگامی که --overwrite و --switch-output استفاده شوند، perf رویدادها را ضبط کرده و دور می‌ریزد تا زمانی که سیگنالی دریافت کند؛ به این معنی که رویدادی غیرعادی شناسایی شده که گرفتن یک تصویر لحظه‌ای (snapshot) از جدیدترین رویدادها — رویدادهایی که در آن لحظه در بافر حلقه‌ای جای می‌گیرند — را توجیه می‌کند.

ویژگی overwrite همچنین می‌تواند برای یک رویداد با استفاده از عبارات پیکربندی تنظیم یا لغو شود. برای مثال: cycles/overwrite/ و instructions/no-overwrite/.

مستلزم --tail-synthesize است.

--kcore

--max-size=<size>

-F  نمایش تنها بسامد نمونه‌برداری استفاده‌شده برای هر رویداد.
-v  نمایش همه فیلدها.
-g  نمایش اطلاعات گروه رویداد.

#!/bin/bash

ctl_dir=/tmp/

ctl_fifo=${ctl_dir}perf_ctl.fifo
test -p ${ctl_fifo} && unlink ${ctl_fifo}
mkfifo ${ctl_fifo}
exec {ctl_fd}<>${ctl_fifo}

ctl_ack_fifo=${ctl_dir}perf_ctl_ack.fifo
test -p ${ctl_ack_fifo} && unlink ${ctl_ack_fifo}
mkfifo ${ctl_ack_fifo}
exec {ctl_fd_ack}<>${ctl_ack_fifo}

sleep 5  && echo 'enable' >&${ctl_fd} && read -u ${ctl_fd_ack} e1 && echo "enabled(${e1})"
sleep 10 && echo 'disable' >&${ctl_fd} && read -u ${ctl_fd_ack} d1 && echo "disabled(${d1})"

exec {ctl_fd_ack}>&-
unlink ${ctl_ack_fifo}

exec {ctl_fd}>&-
unlink ${ctl_fifo}

wait -n ${perf_pid}
exit $?

<cpus mask 1>/<affinity mask 1>:<cpus mask 2>/<affinity mask 2>:...

0,2-4/2-4:1,5-7/5-7

اگر URLs مشخص نشود، از مقدار متغیر محیطی سامانه‌ای
DEBUGINFOD_URLS استفاده می‌شود.

توجه داشته باشید که در حال حاضر BPF فقط می‌تواند با استفاده از
اشاره‌گر فریم ("fp") رد پشته را جمع‌آوری کند. بنابراین برنامه‌های ساخته‌شده
بدون اشاره‌گر فریم ممکن است نشانی‌های ساختگی ببینند.

پروفایل‌سازی off-cpu از دو نوع نمونه تشکیل شده است: نمونه‌های مستقیم، که
رفتار یکسانی با نمونه‌های عادی دارند، و نمونه‌های انباشته‌شده، ذخیره‌شده
در نگاشت رد پشتهٔ BPF، که پس از تمام نمونه‌های عادی ارائه می‌شوند.