docs-xml/smbdotconf/misc/rpcdaemon.xml

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