From 8bffa1c19fd05f4f04dad4b5b98f85b94f23113c Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 26 Jan 2015 22:26:57 +0000 Subject: - added s6-fdholder-delete(c) - small s6-fdholder-* fixes - s6-fdholder documentation (in review) - s6_svstatus_* bugfix (thanks Olivier Brunel) --- doc/s6-fdholder-transferdumpc.html | 82 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 doc/s6-fdholder-transferdumpc.html (limited to 'doc/s6-fdholder-transferdumpc.html') diff --git a/doc/s6-fdholder-transferdumpc.html b/doc/s6-fdholder-transferdumpc.html new file mode 100644 index 0000000..7bd6aa0 --- /dev/null +++ b/doc/s6-fdholder-transferdumpc.html @@ -0,0 +1,82 @@ + + + + + s6: the s6-fdholder-transferdumpc program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The `s6-fdholder-transferdumpc` program

+ +

+s6-fdholder-transferdumpc talks to two +fd-holding daemons: the source of the +transfer on its +standard input, and the destination of the transfer on its standard output, +both being +open Unix domain sockets. It retrieves the entire storage state of +the source daemon and dumps it into the destination daemon. +

+ +

Interface

+ +

+     s6-fdholder-transferdumpc [ -t timeoutfrom ] [ -T timeoutto ]
+

+ +

s6-fdholder-transferdumpc expects to talk to a listening +s6-fdholderd program on its descriptor 0 and +to another one on its descriptor 1.
It gets the entire set of file descriptors from the first +server, with their identifiers and possibly expiration dates.
It stores that set into the second server. The set is +added to the second server, which keeps the descriptors +it was already holding.
It then exits 0, or 1 if a server returned an error.

+ +

Options

+ +

-t timeoutfrom : if the set-retrieving +operation cannot be processed in timeoutfrom 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.
-T timeoutto : same thing with the +set-storing operation.

+ +

Notes

+ +

s6-fdholder-transferdumpc is the "internal" version of +s6-fdholder-transferdump. It simply +expects to be run with file descriptors already open to both +servers; s6-fdholder-transferdump +takes care of all the plumbing.
The error messages for the s6-fdholder suite are explained +here.
Dumping the entire state of s6-fdholderd +requires special authorizations. Make sure the s6-fdholderd instances are +configured to accept +dump-getting and dump-setting requests from your client.
The point of the +s6-fdholder-transferdump and +s6-fdholder-transferdumpc programs is to move a set of fds from one +daemon to another, for instance in the event that the first one has to +to shut down for an upgrade.

+ + + -- cgit v1.3.1

The s6-fdholder-transferdumpc program

Interface

Options

Notes

The `s6-fdholder-transferdumpc` program