From 40006cf2127df247dd6fc2200b3fac4021c1c9d8 Mon Sep 17 00:00:00 2001 From: Andreas Schneider Date: Wed, 31 Aug 2011 12:13:22 +0200 Subject: doc: Reflect the latest changes to the rpc_server option. bug #8425. --- docs-xml/smbdotconf/misc/rpcserver.xml | 84 ++++++++++++++++++++++++++-------- 1 file changed, 66 insertions(+), 18 deletions(-) (limited to 'docs-xml') diff --git a/docs-xml/smbdotconf/misc/rpcserver.xml b/docs-xml/smbdotconf/misc/rpcserver.xml index d92d203d07..6984668835 100644 --- a/docs-xml/smbdotconf/misc/rpcserver.xml +++ b/docs-xml/smbdotconf/misc/rpcserver.xml @@ -5,42 +5,90 @@ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - Defines what kind of rpc server to use for a named pipe. - The rpc_server prefix must be followed by the pipe name, and a value. + With this option you can define if a rpc service should be + running internal/embedded in smbd or should be redirected to an + external daemon like Samba4, the endpoint mapper daemon, the + spoolss daemon or the new LSA service daemon. The rpc_server + prefix must be followed by the pipe name, and a value. - Three possible values are currently supported: + This option can be set for each available rpc service in Samba. + The following list shows all available pipe names services you + can modify with this options. + + + + epmapper - Endpoint Mapper + winreg - Remote Registry Service + srvsvc - Remote Server Services + lsarpc - Local Security Authority + samr - Security Account Management + netlogon - Netlogon Remote Protocol + netdfs - Settings for Distributed File System + dssetup - Active Directory Setup + wkssvc - Workstation Services + spoolss - Network Printing Spooler + svcctl - Service Control + ntsvcs - Plug and Play Services + eventlog - Event Logger + initshutdown - Init Shutdown Service + + + + Three possible values currently supported are: embedded - daemon external + disabled + + + + The classic method is to run every pipe as an internal function + embedded in smbd. The defaults may vary + depending on the service. - The classic method is to run every pipe as an internal function - embedded in smbd. + Choosing the external option allows to run + separate daemon or even a completely independent (3rd party) + server capable of interfacing with samba via the MS-RPC + interface over named pipes. - An alternative method is to fork a daemon - early on at smbd startup time. This is supported only for selected - pipes. + Currently in Samba3 we support thre daemons, spoolssd, epmd and + lsasd. These daemons can be enabled using the + rpc_daemon option. For spoolssd you have + to to enable the deamon and proxy the named pipe with: + Currently in Samba3 we support thre daemons, spoolssd, epmd and + lsasd. These daemons can be enabled using the + rpc_daemon option. - Choosing the external option allows to run a - completely independent (3rd party) server capable of interfacing - with samba via the MS-RPC interface over named pipes. + Examples: + + rpc_daemon:lsasd = fork + rpc_server:lsarpc = external + rpc_server:samr = external + rpc_server:netlogon = external + + rpc_server:spoolss = external + rpc_server:epmapper = disabled + - Currently only the spoolss pipe can be configured in - daemon mode like this: - - rpc_server:spoolss = daemon - + There is one special option which allows you to enable rpc + services to listen for ncacn_ip_tcp connections too. Currently + this is only used for testing and doesn't scale! + + + rpc_server:tcpip = yes + + -none +embedded -- cgit