docs-xml/smbdotconf/misc/rpcserver.xml

   1 <samba:parameter name="rpc_server"
   2                  context="G"
   3                  type="string"
   4                  advanced="1" print="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7         <para>
   8         Defines what kind of rpc server to use for a named pipe.
   9         The rpc_server prefix must be followed by the pipe name, and a value.
  10         </para>
  11
  12         <para>
  13         Three possible values are currently supported:
  14                 <command moreinfo="none">embedded</command>
  15                 <command moreinfo="none">daemon</command>
  16                 <command moreinfo="none">external</command>
  17         </para>
  18
  19         <para>
  20         The classic method is to run every pipe as an internal function
  21         <emphasis>embedded</emphasis> in smbd.
  22         </para>
  23
  24         <para>
  25         An alternative method is to fork a <emphasis>daemon</emphasis>
  26         early on at smbd startup time. This is supported only for selected
  27         pipes.
  28         </para>
  29
  30         <para>
  31         Choosing the <emphasis>external</emphasis> option allows to run a
  32         completely independent (3rd party) server capable of interfacing
  33         with samba via the MS-RPC interface over named pipes.
  34         </para>
  35
  36         <para>
  37         Currently only the spoolss pipe can be configured in
  38         <emphasis>daemon</emphasis> mode like this:
  39         <programlisting>
  40         rpc_server:spoolss = daemon
  41         </programlisting>
  42         </para>
  43 </description>
  44
  45 <value type="default">none</value>
  46 </samba:parameter>