|SAMBA-DCERPCD(8)||System Administration tools||SAMBA-DCERPCD(8)|
samba-dcerpcd - This is one of Samba's DCERPC server processes that can listen on sockets where RPC services are offered and is the parent process of the DCERPC services it invokes. Unless separately invoked it is started on demand from smbd or winbind and serves DCERPC only over named pipes (np) as a helper process. This will be the standard setup for most installations (standalone/member server/AD server) unless they modify their startup scripts. Note in when Samba is configured as an Active Directory Domain controller the samba process that invokes smbd will still provide its normal DCERPC services, not samba-dcerpcd. When separately invoked by system startup scripts or a a daemon, the global smb.conf option rpc start on demand helpers = false MUST be set to allow samba-dcerpcd to start standalone.
samba-dcerpcd [-D|--daemon] [-i|--interactive] [-F|--foreground] [--no-process-group] [-d <debug level>] [--debug-stdout] [--configfile=<configuration file>] [--option=<name>=<value>] [--leak-report] [--leak-report-full] [-V|--version] [--libexec-rpcds] [--np-helper] [--ready-signal-fd=<fd>] [<SERVICE_1>] [<SERVICE_2>] [<...>]
This tool is part of the samba(7) suite.
samba-dcerpcd can be used in two ways. In the normal case without startup script modification and the global smb.conf option rpc start on demand helpers = true is set (the default setting), it is invoked on demand from smbd or winbind with a command line containing --np-helper to serve DCERPC over named pipes (np). It can also be used in a standalone mode where it is started separately from smbd or winbind via system startup scripts. If invoked as a standalone daemon or started from system startup scripts the global smb.conf option rpc start on demand helpers = false MUST be set to false. If the global smb.conf option rpc start on demand helpers = true is set to true or left as default, samba-dcerpcd will fail to start and log an error message.
Note that when Samba is run in the Active Directory Domain Controller mode the samba AD code will still provide its normal DCERPC services whilst allowing samba-dcerpcd to provide services like SRVSVC in the same way that smbd used to in this configuration.
The standalone mode can also be useful for use outside of the Samba framework, for example, use with the Linux kernel SMB2 server ksmbd or possibly other SMB2 server implementations. In this mode it behaves like inetd and listens on sockets on behalf of RPC server implementations.
When a client connects, samba-dcerpcd will start the relevant RPC service binary on demand and hand over the connection to that service. When an RPC service has been idle for a while, samba-dcerpcd will ask it to shut down again.
The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.