1SAMBA-DCERPCD(8)          System Administration tools         SAMBA-DCERPCD(8)
2
3
4

NAME

6       samba-dcerpcd - This is one of Samba's DCERPC server processes that can
7       listen on sockets where RPC services are offered and is the parent
8       process of the DCERPC services it invokes. Unless separately invoked it
9       is started on demand from smbd or winbind and serves DCERPC only over
10       named pipes (np) as a helper process. This will be the standard setup
11       for most installations (standalone/member server/AD server) unless they
12       modify their startup scripts. Note in when Samba is configured as an
13       Active Directory Domain controller the samba process that invokes smbd
14       will still provide its normal DCERPC services, not samba-dcerpcd. When
15       separately invoked by system startup scripts or a a daemon, the global
16       smb.conf option rpc start on demand helpers = false MUST be set to
17       allow samba-dcerpcd to start standalone.
18

SYNOPSIS

20       samba-dcerpcd [-D|--daemon] [-i|--interactive] [-F|--foreground]
21        [--no-process-group] [-d <debug level>] [--debug-stdout]
22        [--configfile=<configuration file>] [--option=<name>=<value>]
23        [--leak-report] [--leak-report-full] [-V|--version] [--libexec-rpcds]
24        [--np-helper] [--ready-signal-fd=<fd>] [<SERVICE_1>] [<SERVICE_2>]
25        [<...>]
26

DESCRIPTION

28       This tool is part of the samba(7) suite.
29
30       samba-dcerpcd can be used in two ways. In the normal case without
31       startup script modification and the global smb.conf option rpc start on
32       demand helpers = true is set (the default setting), it is invoked on
33       demand from smbd or winbind with a command line containing --np-helper
34       to serve DCERPC over named pipes (np). It can also be used in a
35       standalone mode where it is started separately from smbd or winbind via
36       system startup scripts. If invoked as a standalone daemon or started
37       from system startup scripts the global smb.conf option rpc start on
38       demand helpers = false MUST be set to false. If the global smb.conf
39       option rpc start on demand helpers = true is set to true or left as
40       default, samba-dcerpcd will fail to start and log an error message.
41
42       Note that when Samba is run in the Active Directory Domain Controller
43       mode the samba AD code will still provide its normal DCERPC services
44       whilst allowing samba-dcerpcd to provide services like SRVSVC in the
45       same way that smbd used to in this configuration.
46
47       The standalone mode can also be useful for use outside of the Samba
48       framework, for example, use with the Linux kernel SMB2 server ksmbd or
49       possibly other SMB2 server implementations. In this mode it behaves
50       like inetd and listens on sockets on behalf of RPC server
51       implementations.
52
53       When a client connects, samba-dcerpcd will start the relevant RPC
54       service binary on demand and hand over the connection to that service.
55       When an RPC service has been idle for a while, samba-dcerpcd will ask
56       it to shut down again.
57

OPTIONS

59       -D|--daemon
60           If specified, this parameter causes the server to operate as a
61           daemon. That is, it detaches itself and runs in the background,
62           fielding requests on the appropriate port. Operating the server as
63           a daemon is useful for running samba-dcerpcd outside of the Samba
64           framework. However, it can also be used in this way within Samba
65           for member servers if configured to start up via system startup
66           scripts. This switch is assumed if samba-dcerpcd is executed on the
67           command line of a shell.
68
69       -i|--interactive
70           If this parameter is specified it causes the server to run
71           "interactively", not as a daemon, even if the server is executed on
72           the command line of a shell. Setting this parameter negates the
73           implicit daemon mode when run from the command line.  samba-dcerpcd
74           will only accept one connection and terminate. It will also log to
75           standard output, as if the -S parameter had been given.
76
77       -F|--foreground
78           If specified, this parameter causes the main samba-dcerpcd process
79           to not daemonize, i.e. double-fork and disassociate with the
80           terminal. Child processes are still spawned as normal to service
81           each connection request, but the main process does not exit. This
82           operation mode is suitable for running samba-dcerpcd under process
83           supervisors such as supervise and svscan from Daniel J. Bernstein's
84           daemontools package, or the AIX process monitor.
85
86       --no-process-group
87           Do not create a new process group for samba-dcerpcd.
88
89       --libexec-rpcds
90           Offer RPC services for all daemons in Samba's LIBEXECDIR, all
91           programs starting with "rpcd_" are assumed to offer RPC services.
92           If you don't use the --libexec-rpcds option, you can explicitly
93           list all RPC service helpers explicitly on the command line.
94
95       --np-helper
96           Run samba-dcerpcd on demand opening named pipe sockets as helpers
97           for smbd or winbind. In order to run in this mode, the global
98           smb.conf option rpc start on demand helpers = true must be set to
99           true (this is the default setting).
100
101       --ready-signal-fd=<fd>
102           Report service readiness via this fd to smbd. Only for internal
103           use.
104

AUTHOR

106       The original Samba software and related utilities were created by
107       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
108       Source project similar to the way the Linux kernel is developed.
109
110
111
112Samba 4.18.9                      11/30/2023                  SAMBA-DCERPCD(8)
Impressum