FS_TRACE(1)

💅 FS_TRACE(1) — the fs_trace page, bestie edition 🎀

okay so real talk, this one lives in the AFS Command Reference and it's literally called fs_trace. buckle up. ✨

---

🌸 NAME 🌸

fs_trace — turn AFS Cache Manager tracing on, or off. that's the whole vibe check. on/off. a little toggle situation. 🦋

✨ SYNOPSIS ✨

fs trace [-on|-off] [-reset] [-dump]

look at her. four little flags. so demure. 💅

💜 DESCRIPTION 💜

so what does this icon actually do? four things, bestie:

• enables AFS Cache Manager tracing
• disables AFS Cache Manager tracing
• resets the trace log
• dumps the log

and here's the part you need to know 👀 — when you dump the log, two files get created in the Windows Temporary directory: afs-buffer.log and afsd.log. and if files with those names already exist?? they get replaced. gone. no warning. so maybe check first, iykyk. 😭

💀 CAUTIONS 💀

this command is only available on Windows. periodt. not Linux, not macOS, not your friend's weird FreeBSD box. Windows only. 🪟

🎀 OPTIONS 🎀

any combination of these may be specified — you can stack 'em like your rings ✨ — except that -on and -off cannot be specified at the same time (they are literally opposites, bestie, pick a lane 💀).

• -on — turn tracing on. let there be light. 🔥
• -off — turn tracing off. lights out. 🌙
• -reset — resets the tracing information, discarding any trace-information collected up to this time. yes, discarding. throw it away. bye girl 👋
• -dump — creates a dump file containing the trace information. give me the receipts 📄

⭐ OUTPUT ⭐

if it worked, the output of this command (for any option) will be:

AFS tracing enabled

and if it was unsuccessful:

AFS tracing disabled

that's it. that's the whole output situation. yes, it says enabled even when you were trying to turn it off — that's not a typo, that's just how she is. 🙈

🌈 EXAMPLES 🌈

want to start tracing? slay, run this:

% fs trace -on

want to dump the current contents, reset the trace log, and then turn tracing off — all in one go, because we're efficient like that? 👑

% fs trace -dump -reset -off

ate. no crumbs. 💅

👑 PRIVILEGE REQUIRED 👑

the issuer must be have AFS Client Administrator access to issue this command. (yes, the original says "must be have" — i'm not fixing it, i'm respecting the ancestors 🫶). no admin access, no command. that's the rule. 🔐

🦋 SEE ALSO 🦋

• fs(1) — go read the parent page, she raised this whole family

💖 COPYRIGHT 💖

Copyright 2008. This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Mike Robinson (mike@endpoint.com) for OpenAFS.

---

okay that's the whole page, you're officially educated 🧚✨ this little beauty is from OpenAFS, dated 2026-06-25, and that's FS_TRACE(1) signing off. mwah 💋 no cap, go enable some tracing responsibly. 🌸💜🎀