UNLOG(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 UNLOG — bestie, it's time to log OUT

okay so, welcome to unlog(1) from the AFS Command Reference ✨ this is the little command that says "bye tokens, we're done here" — let's get into it 🫶

🌸 NAME

unlog — discards all of the issuer's tokens 💖

✨ SYNOPSIS

unlog [-cell <cell name>+] [-help]

unlog [-c <cell name>+] [-h]

🦋 DESCRIPTION

So here's the vibe: by default, unlog throws away every single token the issuer is currently holding. All of them. Gone. Bye 👋

But if you only want to nuke tokens for certain cells and leave the rest alone? Just name those cells with the -cell argument. That's it, that's the whole thing 💁‍♀️

And here's a lil fact that matters: a token belongs to one client machine only. So destroying tokens on one machine has no effect on tokens sitting on another machine. They don't share, they don't gossip, nothing 🧚

⚠️ CAUTIONS — read this one, fr fr

Specifying one or more cell names can cause a brief authentication outage during which the issuer has no valid tokens in any cell. Not dramatic for no reason — here's why it happens: the command actually discards all tokens first and then restores the ones for cells you didn't name with -cell. So there's a tiny window where you're token-less everywhere 😭

And that outage can sometimes interrupt the operation of jobs that require authentication. So like… maybe don't run this mid-important-job, bestie 💀

👑 OPTIONS

  • -cell <cell name>+ — specifies each cell for to discard the token 🌈 If you leave this argument out entirely, the Cache Manager discards all tokens. You can give the fully qualified domain name, or a shortened form — but heads up: if you go short, whether it resolves successfully depends on whether a name resolution service is available at the time the command is issued (think Domain Name Service, or a local host table) ✨
  • -help — prints the online help for this command 💖 All other valid options are ignored. It's help mode, nothing else gets a say.

🎀 EXAMPLES

This one discards all the tokens. Every last one, no survivors:

% unlog

And this one discards only the tokens for the "prod.example.com" and "testcell.example.org" cells — everything else stays safe and sound 🫶

% unlog -cell prod.example.com testcell

💜 PRIVILEGE REQUIRED

None 🎉 you don't need any special powers for this one, main character energy comes free

🌈 SEE ALSO

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 OpenAFS, dated 2026-07-27, filed under UNLOG(1) — now go forth and discard those tokens responsibly 🦋⭐

📦 where this page comes from