CLIENT-GETREDIR(3valkey)

💅 CLIENT-GETREDIR — the valkey manual page, bestie edition ✨

okay so you're reading the Valkey Command Manual entry for client-getredir, and honestly? it's a lil cutie with a big job. let's get into it 🫶

---

✨ NAME ✨

client-getredir — returns the client ID to which the connection's tracking notifications are redirected.

like. it tells you where the notifications are going. that's it. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

CLIENT GETREDIR

no args, no drama, no notes. just run it. 💅

---

🦋 DESCRIPTION 🦋

so this command hands you back the client ID that we're redirecting our valkey-client-side-caching(7) tracking notifications to.

here's the lore: you set a client to redirect to when you use valkey-client-tracking(7) CLIENT TRACKING to turn tracking on. but — and this is the important part — we did not want to force all the client library implementations to have to remember the ID that notifications get redirected to. that's mean. that's not slay.

so this command exists to improve introspection and let clients check later whether redirection is even active, and if it is, which client ID it's heading towards. periodt. 👑

---

💖 REPLY 💖

you get one of these, depending on the situation:

• valkey-protocol(7) Integer reply: 0 when we're not redirecting notifications to any client.
• valkey-protocol(7) Integer reply: -1 if client tracking is not enabled.
• valkey-protocol(7) Integer reply: the ID of the client to which notification are being redirected.

ngl, 0 vs -1 is the whole plot twist here. one means "no redirect target", the other means "tracking isn't even on". don't mix them up bestie 😭

---

🔥 COMPLEXITY 🔥

O(1)

constant time. instant. ate and left no crumbs. ⭐

---

👑 ACL CATEGORIES 👑

@connection @slow

---

🧚 HISTORY 🧚

• Available since: 6.0.0

---

🌈 SEE ALSO 🌈

auth(3valkey), client(3valkey), client-caching(3valkey), client-capa(3valkey), client-getname(3valkey), client-help(3valkey), client-id(3valkey), client-import-source(3valkey), client-info(3valkey), client-kill(3valkey), client-list(3valkey), client-no-evict(3valkey), client-no-touch(3valkey), client-pause(3valkey), client-reply(3valkey), client-setinfo(3valkey), client-setname(3valkey), client-tracking(3valkey), client-trackinginfo(3valkey), client-unblock(3valkey), client-unpause(3valkey), echo(3valkey), hello(3valkey), ping(3valkey), quit(3valkey), reset(3valkey), select(3valkey)

the whole client command friend group, basically. go say hi. 💜

---

and that's a wrap!! this page is from valkey version 9.0.0, dated 2025-10-21. ty for reading my little manpage bestie, go redirect those notifications responsibly 💖✨🎀