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