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-retrievec.html | 68 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 doc/s6-fdholder-retrievec.html (limited to 'doc/s6-fdholder-retrievec.html') diff --git a/doc/s6-fdholder-retrievec.html b/doc/s6-fdholder-retrievec.html new file mode 100644 index 0000000..5724ee0 --- /dev/null +++ b/doc/s6-fdholder-retrievec.html @@ -0,0 +1,68 @@ + + + + + s6: the s6-fdholder-retrievec program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The `s6-fdholder-retrievec` program

+ +

+s6-fdholder-retrievec talks to a +fd-holding daemon on its open +descriptors 6 and 7, and retrieves a file descriptor from it, +then executes a program. +

+ +

Interface

+ +

+     s6-fdholder-retrievec [ -D ] [ -t timeout ] id prog...
+

+ +

s6-fdholder-retrievec expects to talk to a listening +s6-fdholderd program on its descriptors 6 and 7.
It attempts to retrieve a copy of the file descriptor that has been +stored into that daemon under identifier id. +
It then executes into prog..., with the retrieved +file descriptor as standard input.

+ +

Options

+ +

-D : delete the file descriptor from the server's +storage after retrieval. This option requires writing rights over the +given identifier as well as reading rights: check the server's +configuration.
-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.

+ +

Notes

+ +

s6-fdholder-retrievec is the "internal" version of +s6-fdholder-retrieve. It simply +expects to be run as a UCSPI client, i.e. talking to the server +over descriptors 6 and 7, instead of connecting to the server +itself.
The error messages for the s6-fdholder suite are explained +here.

+ + + -- cgit v1.2.3

The s6-fdholder-retrievec program

Interface

Options

Notes

The `s6-fdholder-retrievec` program