S6-IPCCLIENT(8)

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.

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 the following variables set:

PROTO
    Always set to IPC.

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)

[1] 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)