From 8daa83a594a2e98f39d764422bfbdbc62c9efd44 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 19:20:00 +0200 Subject: Adding upstream version 2:4.20.0+dfsg. Signed-off-by: Daniel Baumann --- docs-xml/manpages/samba-dcerpcd.8.xml | 210 ++++++++++++++++++++++++++++++++++ 1 file changed, 210 insertions(+) create mode 100644 docs-xml/manpages/samba-dcerpcd.8.xml (limited to 'docs-xml/manpages/samba-dcerpcd.8.xml') diff --git a/docs-xml/manpages/samba-dcerpcd.8.xml b/docs-xml/manpages/samba-dcerpcd.8.xml new file mode 100644 index 0000000..2df4f27 --- /dev/null +++ b/docs-xml/manpages/samba-dcerpcd.8.xml @@ -0,0 +1,210 @@ + + + + + + samba-dcerpcd + 8 + Samba + System Administration tools + &doc.version; + + + + + 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 daemon, + the global smb.conf option 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> + <...> + + + + + DESCRIPTION + + 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 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 false + MUST be set to false. If the global smb.conf option + 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. + + + + + + OPTIONS + + + + -D|--daemon + 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 + samba-dcerpcd 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 samba-dcerpcd is executed on the + command line of a shell. + + + + -i|--interactive + 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. samba-dcerpcd will only + accept one connection and terminate. It will also log + to standard output, as if the -S + parameter had been given. + + + + + -F|--foreground + If specified, this parameter causes + the main samba-dcerpcd 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 samba-dcerpcd + under process supervisors such as + supervise and + svscan from Daniel J. Bernstein's + daemontools package, or the AIX + process monitor. + + + + --no-process-group + Do not create a new process group for + samba-dcerpcd. + + + + + --libexec-rpcds + Offer RPC services for all daemons in + Samba's LIBEXECDIR, all programs starting with + "rpcd_" are assumed to offer RPC + services. If you don't use the + --libexec-rpcds option, you can + explicitly list all RPC service helpers explicitly on + the command line. + + + + --np-helper + Run samba-dcerpcd + on demand opening named pipe sockets as helpers for + smbd or winbind. + In order to run in this mode, the global smb.conf + option true must be set to true + (this is the default setting). + + + + --ready-signal-fd=<fd> + Report service readiness via this fd + to smbd. Only for internal use. + + + + + + + AUTHOR + + + 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. + + + + -- cgit v1.2.3