FSTRACE_HELP(8)

✨ FSTRACE_HELP(8) ✨

okay bestie, we're in the AFS Command Reference manual, section 8 (admin commands, the spicy ones 💅). This is fstrace_help, and she's here to hand you the help text for the fstrace family. no cap.

---

🌸 NAME 🌸

fstrace_help — displays help for fstrace commands 🫶

---

🎀 SYNOPSIS 🎀

fstrace help [-topic <help string>+] [-help]

fstrace h [-t <help string>+] [-h]

---

🦋 DESCRIPTION 🦋

so the way that fstrace help works is: it shows you the complete online help entry — that's the short description plus the syntax statement — for every command operation code you named in the -topic argument. one entry per topic, slay. 👑

but hold up, if you just... don't give a -topic? then the output only gives you the first line (the name and the short description) of the online help entry for every single fstrace command. it's giving table of contents, honestly.

and listen — if what you actually want is to find every fstrace command whose name or short description contains a keyword you're hunting for, that's a different girl. go use the fstrace apropos command for that one. iykyk 🔍

---

💖 OPTIONS 💖

• -topic <help string>+ — tells her which commands to show the complete online help entry for. ⚠️ important: you omit the fstrace part of the command name, bestie — you only give the operation code. like, specify clear, not fstrace clear. (the fstrace is implied, she knows who she's working for.) if you leave this argument out entirely, the output just briefly describes every fstrace command.
• -help — prints the online help for this command. every other valid option gets ignored when you use it, periodt. 💅

---

🌈 OUTPUT 🌈

the online help entry for each fstrace command is made of two or three lines:

• the first line names the command and briefly describes what it does 🎯
• the second line lists aliases for the command, if there are any 👯
• the final line, which starts with the string "Usage", lists the command's options in the prescribed order. and psst — online help entries use the same symbols (like brackets, for example) as the reference pages in this document, so read it the same way. ✨

---

🍓 EXAMPLES 🍓

the following command displays the online help entry for the fstrace setset command:

% fstrace help -topic setset
fstrace setset: set state of event sets
Usage: fstrace setset [-set <set_name>+] [-active] [-inactive]
[-dormant] [-help]

look at her go 😭 iconic

---

👑 PRIVILEGE REQUIRED 👑

None

(no special privileges, we love a low-stakes queen 💜)

---

🧚 SEE ALSO 🧚

fstrace(8), fstrace_apropos(8)

go read those too, they're the sister pages, no gatekeeping here 🫶

---

📜 COPYRIGHT 📜

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 whole page, bestie 💖 this was brought to you by OpenAFS, dated 2026-07-27, under the FSTRACE_HELP(8) name — go forth and -topic responsibly 🌟