summaryrefslogtreecommitdiff
path: root/docs-xml/smbdotconf/misc/rpcserver.xml
blob: fcc63fe5fd85cfdd1d228e15b98af72c8c5f301b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<samba:parameter name="rpc_server"
                 context="G"
		 type="string"
		 advanced="1" print="1"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
	<para>
		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.
	</para>

	<para>
		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 option.
	</para>

	<itemizedlist>
		<listitem><para>epmapper     - Endpoint Mapper</para></listitem>
		<listitem><para>winreg       - Remote Registry Service</para></listitem>
		<listitem><para>srvsvc       - Remote Server Services</para></listitem>
		<listitem><para>lsarpc       - Local Security Authority</para></listitem>
		<listitem><para>samr         - Security Account Management</para></listitem>
		<listitem><para>netlogon     - Netlogon Remote Protocol</para></listitem>
		<listitem><para>netdfs       - Settings for Distributed File System</para></listitem>
		<listitem><para>dssetup      - Active Directory Setup</para></listitem>
		<listitem><para>wkssvc       - Workstation Services</para></listitem>
		<listitem><para>spoolss      - Network Printing Spooler</para></listitem>
		<listitem><para>svcctl       - Service Control</para></listitem>
		<listitem><para>ntsvcs       - Plug and Play Services</para></listitem>
		<listitem><para>eventlog     - Event Logger</para></listitem>
		<listitem><para>initshutdown - Init Shutdown Service</para></listitem>
	</itemizedlist>

	<para>
		Three possible values currently supported are:
		<command moreinfo="none">embedded</command>
		<command moreinfo="none">external</command>
		<command moreinfo="none">disabled</command>
	</para>

	<para>
		The classic method is to run every pipe as an internal function
		<emphasis>embedded</emphasis> in smbd. The defaults may vary
		depending on the service.
	</para>

	<para>
		Choosing the <emphasis>external</emphasis> option allows to run
		a separate daemon or even a completely independent (3rd party)
		server capable of interfacing with samba via the MS-RPC
		interface over named pipes.
	</para>

	<para>
		Currently in Samba3 we support three daemons, spoolssd, epmd and
		lsasd. These daemons can be enabled using the
		<emphasis>rpc_daemon</emphasis> option. For spoolssd you have
		to to enable the daemon and proxy the named pipe with:
	</para>

	<para>
		Examples:
		<programlisting>
			rpc_daemon:lsasd = fork
			rpc_server:lsarpc = external
			rpc_server:samr = external
			rpc_server:netlogon = external

			rpc_server:spoolss = external
			rpc_server:epmapper = disabled
		</programlisting>
	</para>

	<para>
		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!

		<programlisting>
			rpc_server:tcpip = yes
		</programlisting>
	</para>

</description>

<value type="default">embedded</value>
</samba:parameter>