reset-ftrace(8)

📦 version 1.0.1~20200130+git49b8cdf, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

✨ reset-ftrace — the manual, but make it cute ✨

ok so bestie, welcome to reset-ftrace(8), a System Manager's Manual situation, and it's literally about resetting the state of ftrace and turning off ALL the tracing. it was written for Linux ftrace. iykyk 💅

🌸 NAME 🌸

reset-ftrace — resets the state of ftrace, disabling all tracing. written for Linux ftrace, no cap. 🦋

🎀 SYNOPSIS 🎀

reset-ftrace [-fhq]

✨ DESCRIPTION ✨

so what it does is reset the state of a bunch of different ftrace files, and it shows you the before state AND the after state, because we love transparency in this house. 👑

ngl this one is probably only gonna be useful to the ftrace hacker girlies who, while they're off developing ftrace software, keep getting the subsystem stuck in a partially active state, and just want a quick lil way to reset everything. check the end of this script for the actual files it resets, and add more if you need more — the script is right there, go off. 💖

WARNING: only use this if and when you are 100% sure there are no other active ftrace sessions on your system, because otherwise it will kill them. like, actually end them. so do a vibe check on your system first, bestie, fr fr. 😭

🧚 REQUIREMENTS 🧚

  • FTRACE CONFIG.

that's it, that's the requirement. slay. ✨

💅 OPTIONS 💅

  • -f — Force. if the ftrace lock file exists (/var/tmp/.ftrace-lock), it deletes it. bye bye lock file 🫶
  • -h — prints the usage message. the classic cry for help option, iconic.
  • -q — Quiet. it still runs, it just doesn't print any output. main character energy but silent. 🤫

🌈 EXAMPLES 🌈

reset the various ftrace files:

# reset-ftrace

🍓 SOURCE 🍓

this is from the perf-tools collection. 💜

https://github.com/brendangregg/perf-tools

also look under the examples directory for a text file containing example usage, output, and commentary for this tool. it's giving documentation, we love to see it. 📚

⭐ OS ⭐

Linux. obviously. 🐧

🔥 STABILITY 🔥

Unstable — in development. so like, she's growing, she's evolving, be gentle. 🦋

👑 AUTHOR 👑

Brendan Gregg 💖

💀 SEE ALSO 💀

perf(1)

and that's the whole page bestie!! this one came out of the USER COMMANDS section, dated 2014-07-07, and that's the tea. go reset some ftrace state, you got this. 💅✨🎀

📦 where this page comes from