Debian Codegraph @

upstream/debian-unstable/man8/samba-dcerpcd.8

raw
1 '\" t
2 .\" Title: samba-dcerpcd
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.24.3-Debian-4.24.3+dfsg-1
8 .\" Language: English
9 .\"
10 .TH "SAMBA\-DCERPCD" "8" "05/26/2026" "Samba 4\&.24\&.3\-Debian\-4\&.24\&.3+dfs" "System Administration tools"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 samba-dcerpcd \- This is one of Samba\*(Aqs 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 daemon, the global smb\&.conf option \m[blue]\fBrpc start on demand helpers = false\fR\m[] MUST be set to allow samba\-dcerpcd to start standalone\&.
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 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>] [<\&.\&.\&.>]
35 .SH "DESCRIPTION"
36 .PP
37 This tool is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 samba\-dcerpcd can be used in two ways\&. In the normal case without startup script modification and the global smb\&.conf option
42 \m[blue]\fBrpc start on demand helpers = true\fR\m[]
43 is set (the default setting), it is invoked on demand from
44 smbd
45 or
46 winbind
47 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
48 smbd
49 or
50 winbind
51 via system startup scripts\&. If invoked as a standalone daemon or started from system startup scripts the global smb\&.conf option
52 \m[blue]\fBrpc start on demand helpers = false\fR\m[]
53 MUST be set to false\&. If the global smb\&.conf option
54 \m[blue]\fBrpc start on demand helpers = true\fR\m[]
55 is set to true or left as default,
56 samba\-dcerpcd
57 will fail to start and log an error message\&.
58 .PP
59 Note that when Samba is run in the Active Directory Domain Controller mode the
60 samba
61 AD code will still provide its normal DCERPC services whilst allowing samba\-dcerpcd to provide services like SRVSVC in the same way that
62 smbd
63 used to in this configuration\&.
64 .PP
65 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\&.
66 .PP
67 When a client connects,
68 samba\-dcerpcd
69 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,
70 samba\-dcerpcd
71 will ask it to shut down again\&.
72 .SH "OPTIONS"
73 .PP
74 \-D|\-\-daemon
75 .RS 4
76 If specified, this parameter causes the server to operate as a daemon\&. That is, it detaches itself and runs in the background, fielding requests on the appropriate port\&. Operating the server as a daemon is useful for running
77 samba\-dcerpcd
78 outside of the Samba framework\&. However, it can also be used in this way within Samba for member servers if configured to start up via system startup scripts\&. This switch is assumed if
79 samba\-dcerpcd
80 is executed on the command line of a shell\&.
81 .RE
82 .PP
83 \-i|\-\-interactive
84 .RS 4
85 If this parameter is specified it causes the server to run "interactively", not as a daemon, even if the server is executed on the command line of a shell\&. Setting this parameter negates the implicit daemon mode when run from the command line\&.
86 samba\-dcerpcd
87 will only accept one connection and terminate\&. It will also log to standard output, as if the
88 \-S
89 parameter had been given\&.
90 .RE
91 .PP
92 \-F|\-\-foreground
93 .RS 4
94 If specified, this parameter causes the main
95 samba\-dcerpcd
96 process to not daemonize, i\&.e\&. double\-fork and disassociate with the terminal\&. Child processes are still spawned as normal to service each connection request, but the main process does not exit\&. This operation mode is suitable for running
97 samba\-dcerpcd
98 under process supervisors such as
99 supervise
100 and
101 svscan
102 from Daniel J\&. Bernstein\*(Aqs
103 daemontools
104 package, or the AIX process monitor\&.
105 .RE
106 .PP
107 \-\-no\-process\-group
108 .RS 4
109 Do not create a new process group for samba\-dcerpcd\&.
110 .RE
111 .PP
112 \-\-libexec\-rpcds
113 .RS 4
114 Offer RPC services for all daemons in Samba\*(Aqs LIBEXECDIR, all programs starting with "rpcd_" are assumed to offer RPC services\&. If you don\*(Aqt use the
115 \-\-libexec\-rpcds
116 option, you can explicitly list all RPC service helpers explicitly on the command line\&.
117 .RE
118 .PP
119 \-\-np\-helper
120 .RS 4
121 Run
122 samba\-dcerpcd
123 on demand opening named pipe sockets as helpers for
124 smbd
125 or
126 winbind\&. In order to run in this mode, the global smb\&.conf option
127 \m[blue]\fBrpc start on demand helpers = true\fR\m[]
128 must be set to true (this is the default setting)\&.
129 .RE
130 .PP
131 \-\-ready\-signal\-fd=<fd>
132 .RS 4
133 Report service readiness via this fd to
134 smbd
135 or
136 winbind\&. Only for internal use\&.
137 .RE
138 .SH "AUTHOR"
139 .PP
140 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\&.