diff options
Diffstat (limited to 'docs-xml/smbdotconf/misc/rpcdaemon.xml')
| -rw-r--r-- | docs-xml/smbdotconf/misc/rpcdaemon.xml | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/docs-xml/smbdotconf/misc/rpcdaemon.xml b/docs-xml/smbdotconf/misc/rpcdaemon.xml new file mode 100644 index 0000000000..e84db21ddb --- /dev/null +++ b/docs-xml/smbdotconf/misc/rpcdaemon.xml @@ -0,0 +1,69 @@ +<samba:parameter name="rpc_daemon" + context="G" + type="string" + advanced="1" print="1" + xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> +<description> + <para> + Defines whether to use the embedded code or start a separate daemon + for the defined rpc services. + The rpc_daemon prefix must be followed by the server name, and a value. + </para> + + <para> + Two possible values are currently supported: + <command moreinfo="none">disabled</command> + <command moreinfo="none">fork</command> + </para> + + <para> + The classic method is to run rpc services as internal daemons + embedded in smbd, therefore the external daemons are + <emphasis>disabled</emphasis> by default. + </para> + + <para> + Choosing the <emphasis>fork</emphasis> option will cause samba to fork + a separate proces for each daemon configured this way. Each daemon may + in turn fork a number of children used to handle requests from multiple + smbds and direct tcp/ip connections (if the Endpoint Mapper is + enabled). Communication with smbd happens over named pipes and require + that said pipes are forward to the external daemon (see <smbconfoption + name="rpc_server"/>). + </para> + + <para> + Forked RPC Daemons support dynamically forking children to handle + connections. The heuristics about how many children to keep around and + how fast to allow them to fork and also how many clients each child is + allowed to handle concurrently is defined by parametrical options named + after the daemon. + Five options are currently supported: + <command moreinfo="none">prefork_min_children</command> + <command moreinfo="none">prefork_max_children</command> + <command moreinfo="none">prefork_spawn_rate</command> + <command moreinfo="none">prefork_max_allowed_clients</command> + <command moreinfo="none">prefork_child_min_life</command> + + To set one of these options use the follwing syntax: + <programlisting> + damonname:prefork_min_children = 5 + </programlisting> + </para> + + <para> + Samba includes separate daemons for spoolss and the lsarpc/lsass, + netlogon and samr pipes. Currently three daemons are available and they + are called: + <command moreinfo="none">empd</command> + <command moreinfo="none">lsasd</command> + <command moreinfo="none">spoolssd</command> + Example: + <programlisting> + rpc_daemon:spoolssd = fork + </programlisting> + </para> +</description> + +<value type="default">disabled</value> +</samba:parameter> |