FSTRACE_SETSET(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSTRACE_SETSET(8) — the AFS Command Reference, bestie edition

okay so you found the fstrace setset page, welcome, pull up a chair 🫶 this one lives in the AFS Command Reference section of the manual, and it's literally all about flipping the status of an event set. that's it. that's the whole job.

✨ NAME ✨

fstrace_setset — sets the status of an event set 💖

🎀 SYNOPSIS 🎀

fstrace setset [-set <set name>+]
    [-active] [-inactive] [-dormant] [-help]

fs sets [-s <set name>+] [-a] [-i] [-d] [-h]

🌸 DESCRIPTION 🌸

so the fstrace setset command sets the status of the "cm" kernel event set on the local machine. and why do we care?? because that status is what decides whether trace messages actually get recorded in the log buffer in kernel memory. it's giving gatekeeper, honestly. 🚪✨

💖 OPTIONS 💖

  • -set <set name>+ — names the event set you're setting the status for. the only acceptable value here is "cm", and lowkey that's also the default if you just… don't pass this argument at all. 🙈
  • -active — enables tracing for the event set and allocates kernel memory for the associated trace log buffer. you gotta provide one of this flag, the -inactive flag, or the -dormant flag — pick your fighter. 👑
  • -inactive — temporarily disables tracing for the event set, but does not change the allocation of kernel memory for the associated trace log buffer. (so it's like, paused, not cancelled, iykyk.) provide one of this flag, the -active flag, or the -dormant flag.
  • -dormant — disables tracing for the event set and frees the kernel memory that was previously allocated for the associated trace log buffer. it's the full clean exit, no crumbs. provide one of this flag, the -active flag, or the -inactive flag.
  • -help — prints the online help for this command. and fr fr, all other valid options are ignored when you do this. 😌

🌈 EXAMPLES 🌈

this one sets the cm event set's status to inactive, slay:

# fstrace setset -set cm -inactive

👑 PRIVILEGE REQUIRED 👑

the issuer must be logged in as the local superuser "root". no cap, no shortcuts, you need the root energy for this one. 🔥

🦋 SEE ALSO 🦋

fstrace(8), fstrace_lsset(8), fstrace_setlog(8)

go read those next, bestie, they're the whole friend group.

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

and that's the page!! this iconic little number is from OpenAFS, dated 2026-07-27 — catch you on the next manpage, mwah 💋✨🫶

📦 where this page comes from