s6
Software
skarnet.org

The s6-fdholder-getdump program

s6-fdholder-getdump connects to a fd-holding daemon listening on a Unix domain socket, and retrieves its entire state: file descriptors with their identifiers and expiration dates. It then executes a program with those file descriptors still open, and the state stored in the environment.

Interface

     s6-fdholder-getdump [ -t timeout ] path prog...

Options

Exit codes

Environment format

prog... is executed with the following environment variables set:

Usage example

   s6-fdholder-getdump /service/fdholderd/s s6-fdholder-setdump /service/fdholderd-2/s

will get the state of the s6-fdholderd daemon listening on the /service/fdholderd/s socket, and transmit it to the other s6-fdholderd daemon listening on the /service/fdholderd-2/s socket. Note that in this precise case, the s6-fdholder-transferdump program does the same thing more efficiently.

Notes