docs-xml/smbdotconf/misc/rpcdaemon.xml

   1 <samba:parameter name="rpc_daemon:DAEMON"
   2                  context="G"
   3                  type="string"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>
   7         Defines whether to use the embedded code or start a separate daemon
   8         for the defined rpc services.
   9         The rpc_daemon prefix must be followed by the server name, and a value.
  10         </para>
  11
  12         <para>
  13         Two possible values are currently supported:
  14         <programlisting>
  15                 disabled
  16                 fork
  17         </programlisting>
  18         </para>
  19
  20         <para>
  21         The classic method is to run rpc services as internal daemons
  22         embedded in smbd, therefore the external daemons are
  23         <emphasis>disabled</emphasis> by default.
  24         </para>
  25
  26         <para>
  27         Choosing the <emphasis>fork</emphasis> option will cause samba to fork
  28         a separate process for each daemon configured this way. Each daemon may
  29         in turn fork a number of children used to handle requests from multiple
  30         smbds and direct tcp/ip connections (if the Endpoint Mapper is
  31         enabled). Communication with smbd happens over named pipes and require
  32         that said pipes are forward to the external daemon (see <smbconfoption
  33         name="rpc_server"/>).
  34         </para>
  35
  36         <para>
  37         Forked RPC Daemons support dynamically forking children to handle
  38         connections. The heuristics about how many children to keep around and
  39         how fast to allow them to fork and also how many clients each child is
  40         allowed to handle concurrently is defined by parametrical options named
  41         after the daemon.
  42         Five options are currently supported:
  43         <programlisting>
  44                 prefork_min_children
  45                 prefork_max_children
  46                 prefork_spawn_rate
  47                 prefork_max_allowed_clients
  48                 prefork_child_min_life
  49         </programlisting>
  50
  51         To set one of these options use the following syntax:
  52         <programlisting>
  53         daemonname:prefork_min_children = 5
  54         </programlisting>
  55         </para>
  56
  57         <para>
  58         Samba includes separate daemons for spoolss, lsarpc/lsass,
  59         netlogon, samr, FSRVP and mdssvc(Spotlight). Currently five
  60         daemons are available and they are called:
  61         <programlisting>
  62                 epmd
  63                 lsasd
  64                 spoolssd
  65                 fssd
  66                 mdssd
  67         </programlisting>
  68         Example:
  69         <programlisting>
  70         rpc_daemon:spoolssd = fork
  71         </programlisting>
  72         </para>
  73 </description>
  74
  75 <value type="default">disabled</value>
  76 </samba:parameter>