S6-IPCCLIENT(8)

💖 s6-ipcclient(8) — bestie, we’re connecting to a Unix socket 💖

okay so this is the System Manager's Manual page for s6-ipcclient, the UCSPI client tool[1] for Unix domain sockets: connect to a socket, then execute into a program. fr fr it’s giving tiny networking magic ✨

---

🌸 NAME 🌸

s6-ipcclient — UCSPI client tool[1] for Unix domain sockets: connect to a socket, then execute into a program.

🎀 SYNOPSIS 🎀

s6-ipcclient [-q | -Q | -v] [-p localpath] [-l localname] path prog...

🦋 DESCRIPTION 🦋

s6-ipcclient connects to a Unix domain socket on path.

It executes into prog... with descriptor 6 reading from the socket and descriptor 7 writing to it.

s6-ipcclient is mostly used to connect a client to an s6-local-service(7) without having to implement networking in the client. For instance, the s6-sudo(8) program does this. slay 💅

✨ OPTIONS ✨

• -q — be quiet. 🤫
• -Q — be normally verbose. This is the default. 💅
• -v — be verbose. 🗣️
• -p localpath — bind the local socket to localpath before connecting to path. 🎀
• -l localname — use localname as the value of the IPCLOCALPATH environment variable. 🫶

🌈 ENVIRONMENT 🌈

prog... is run with these variables set:

• PROTO — always set to IPC. periodt.
• IPCLOCALPATH — set to the path associated with the local socket, if any. Be aware that it may contain arbitrary characters. 😭

👑 SEE ALSO 👑

• s6-accessrules-cdb-from-fs(8)
• s6-accessrules-fs-from-cdb(8)
• s6-connlimit(8)
• s6-ioconnect(8)
• s6-ipcserver(8)
• s6-ipcserver-access(8)
• s6-ipcserver-socketbinder(8)
• s6-ipcserverd(8)

Also: [1] the UCSPI protocol doc lives at https://cr.yp.to/proto/ucspi.txt 💜

This man page is ported from the authoritative documentation at: https://skarnet.org/software/s6/s6-ipcclient.html 🌟

🎀 AUTHORS 🎀

• Laurent Bercot 💖
• Alexis <flexibeast@gmail.com> (man page port) 🫶

---

with love from Debian, page S6-IPCCLIENT(8), dated September 29, 2021 — mwah 💋