S6-FDHOLDER-STORE(8)

NAME
s6-fdholder-store - connect to an s6-fdholderd daemon listening on a Unix domain socket, and give it a copy of one of its open file descriptors for the daemon to hold

SYNOPSIS
s6-fdholder-store [-d fd] [-T fdtimeout] [-t timeout] path id

DESCRIPTION
s6-fdholder-store connects to an s6-fdholderd(8) server process listening on path.

It attempts to pass a copy of its standard input, or of its descriptor fd, to the server, with identifier id.

OPTIONS

-d fd
    Store descriptor number fd. By default, fd is 0 (i.e. the program's stdin will be stored).

-T fdtimeout
    The descriptor is stored with an expiration time of fdtimeout milliseconds, which means the s6-fdholderd(8) daemon will close and get rid of the descriptor after this time. By default, fdtimeout is 0, which means infinite - no expiration time.

-t timeout
    If the operation cannot be processed in timeout milliseconds, then fail with an error message. Communications with the server should be near-instant, so this option is only here to protect users against programming errors (connecting to the wrong socket, for instance).

EXIT STATUS

0   Success.

1   The server denied the operation. The meanings of the error messages are explained in s6-fdholder-error-codes(7).

100 Wrong usage.

111 System call failed - this includes attempting to connect to a nonexistent socket, or one where no s6-fdholderd(8) daemon is listening.

EXAMPLES
    s6-ipcserver-socketbinder /tmp/mysocket s6-fdholder-store /service/fdholderd/s MYSOCKET

will open a Unix domain socket, bind it to /tmp/mysocket and listen to incoming connections, then give it to an s6-fdholderd(8) instance listening on /service/fdholderd/s, with no expiration date, with the “MYSOCKET” identifier. Another program will be able to retrieve the socket later, using s6-fdholder-retrieve(8).

SEE ALSO
s6-fdholder-daemon(8), s6-fdholder-delete(8), s6-fdholder-getdump(8), s6-fdholder-list(8), s6-fdholder-retrieve(8), s6-fdholder-setdump(8), s6-fdholder-transferdump(8), s6-fdholderd(8)

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

AUTHORS
Laurent Bercot Alexis <flexibeast@gmail.com> (man page port)