s6

Mirror/fork of https://skarnet.org/software/s6/
git clone https://ccx.te2000.cz/git/s6
Log | Files | Refs | README | LICENSE

s6-sudo.html (2266B)

      1 <html>
      2   <head>
      3     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
      4     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
      5     <meta http-equiv="Content-Language" content="en" />
      6     <title>s6: the s6-sudo program</title>
      7     <meta name="Description" content="s6: the s6-sudo program" />
      8     <meta name="Keywords" content="s6 s6-sudo sudo setuid suid unix privilege gain getpeereid" />
      9     <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
     10   </head>
     11 <body>
     12 
     13 <p>
     14 <a href="index.html">s6</a><br />
     15 <a href="//skarnet.org/software/">Software</a><br />
     16 <a href="//skarnet.org/">skarnet.org</a>
     17 </p>
     18 
     19 <h1> The <tt>s6-sudo</tt> program </h1>
     20 
     21 <p>
     22 <tt>s6-sudo</tt> connects to a Unix domain socket and passes
     23 its standard file descriptors, command-line arguments and
     24 environment to a program running on the server side, potentially
     25 with different privileges.
     26 </p>
     27 
     28 <h2> Interface </h2>
     29 
     30 <pre>
     31      s6-sudo [ -q | -Q | -v ] [ -p <em>bindpath</em> ] [ -l <em>localname</em> ] [ -e ] [ -t <em>timeoutconn</em> ] [ -T <em>timeoutrun</em> ] <em>path</em> [ <em>args...</em> ]
     32 </pre>
     33 
     34 <ul>
     35  <li> s6-sudo executes into <tt><a href="s6-ipcclient.html">s6-ipcclient</a> <em>path</em>
     36 <a href="s6-sudoc.html">s6-sudoc</a> args...</tt> It does nothing else: it is just a
     37 convenience program. The <a href="s6-ipcclient.html">s6-ipcclient</a> program connects
     38 to a Unix socket at <em>path</em>, and the
     39 <a href="s6-sudoc.html">s6-sudoc program</a> transmits the desired elements over the
     40 socket. </li>
     41  <li> It should be used to connect to a
     42 <a href="localservice.html">local service</a> running the
     43 <a href="s6-sudod.html">s6-sudod</a> program, which will run a server program on the
     44 client's behalf. </li>
     45 </ul>
     46 
     47 <h2> Options </h2>
     48 
     49 <ul>
     50  <li> The <tt>-q</tt>, <tt>-Q</tt>, <tt>-v</tt>, <tt>-p</tt> and <tt>-l</tt>
     51 options are passed to <a href="s6-ipcclient.html">s6-ipcclient</a>. </li>
     52  <li> The <tt>-e</tt>, <tt>-t</tt> and <tt>-T</tt> options are passed to
     53 <a href="s6-sudoc.html">s6-sudoc</a>. </li>
     54  <li> Command-line arguments, if any, are also passed to
     55 <a href="s6-sudoc.html">s6-sudoc</a>, which will transmit them to
     56 <a href="s6-sudod.html">s6-sudod</a> over the socket.
     57 </ul>
     58 
     59 </body>
     60 </html>