diff options
Diffstat (limited to 'doc/s6-fdholder-retrievec.html')
| -rw-r--r-- | doc/s6-fdholder-retrievec.html | 69 |
1 files changed, 0 insertions, 69 deletions
diff --git a/doc/s6-fdholder-retrievec.html b/doc/s6-fdholder-retrievec.html deleted file mode 100644 index cd49b1b..0000000 --- a/doc/s6-fdholder-retrievec.html +++ /dev/null @@ -1,69 +0,0 @@ -<html> - <head> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <meta http-equiv="Content-Language" content="en" /> - <title>s6: the s6-fdholder-retrievec program</title> - <meta name="Description" content="s6: the s6-fdholder-retrievec program" /> - <meta name="Keywords" content="s6 s6-fdholder fd-holding fd-holder fd retrieval unix socket activation" /> - <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> --> - </head> -<body> - -<p> -<a href="index.html">s6</a><br /> -<a href="//skarnet.org/software/">Software</a><br /> -<a href="//skarnet.org/">skarnet.org</a> -</p> - -<h1> The <tt>s6-fdholder-retrievec</tt> program </h1> - -<p> -<tt>s6-fdholder-retrievec</tt> talks to a -<a href="s6-fdholderd.html">fd-holding daemon</a> on its open -descriptors 6 and 7, and retrieves a file descriptor from it, -then executes a program. -</p> - -<h2> Interface </h2> - -<pre> - s6-fdholder-retrievec [ -D ] [ -t <em>timeout</em> ] <em>id</em> <em>prog...</em> -</pre> - -<ul> - <li> s6-fdholder-retrievec expects to talk to a listening -<a href="s6-fdholderd.html">s6-fdholderd</a> program on its descriptors 6 and 7. </li> - <li> It attempts to retrieve a copy of the file descriptor that has been -stored into that daemon under identifier <em>id</em>. - <li> It then executes into <em>prog...</em>, with the retrieved -file descriptor as standard input. </li> -</ul> - -<h2> Options </h2> - -<ul> - <li> <tt>-D</tt> : 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 -<a href="s6-fdholderd.html#configuration">configuration</a>. </li> - <li> <tt>-t <em>timeout</em></tt> : if the operation cannot be -processed in <em>timeout</em> 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. </li> -</ul> - -<h2> Notes </h2> - -<ul> - <li>s6-fdholder-retrievec is the "internal" version of -<a href="s6-fdholder-retrieve.html">s6-fdholder-retrieve</a>. 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. </li> - <li> The error messages for the s6-fdholder suite are explained -<a href="s6-fdholder-errorcodes.html">here</a>. </li> -</ul> - -</body> -</html> |