1
0
mirror of https://github.com/samba-team/samba.git synced 2025-02-14 01:57:53 +03:00
samba-mirror/lib/util/become_daemon.h
Samuel Cabrero 309c81e7e2 daemons: Do not notify systemd in child processes started by main samba
When samba runs as ADDC only the main 'samba' daemon have to notify
its status to systemd because our systemd unit files contains implied
NotifyAccess=main since commit d1740fb3d5a72cb49e30b330bb0b01e7ef3e09cc.

This commit adds a function to disable the systemd notification in the
smbd and winbinddd child processes started by the main 'samba' daemon in
AD DC mode to avoid warnings like:

systemd[1]: samba-ad-dc.service: Got notification message from PID 26194,
	    but reception only permitted for main PID 26187
systemd[1]: samba-ad-dc.service: Got notification message from PID 26222,
	    but reception only permitted for main PID 26187

$ pstree -p
...
├─samba(26187)─┬─tfork(26189)(26188)───s3fs[master](26189)───tfork(26194)(26193)───smbd(26194)─┬─cleanupd(+
│              │                                                                               ├─lpqd(2623+
│              │                                                                               └─smbd-noti+
│              ├─tfork(26191)(26190)───rpc[master](26191)─┬─tfork(26198)(26195)───rpc(0)(26198)
│              │                                          ├─tfork(26200)(26199)───rpc(1)(26200)
│              │                                          ├─tfork(26206)(26201)───rpc(2)(26206)
│              │                                          └─tfork(26212)(26207)───rpc(3)(26212)
│              ├─tfork(26196)(26192)───nbt[master](26196)
│              ├─tfork(26202)(26197)───wrepl[master](26202)
│              ├─tfork(26204)(26203)───ldap[master](26204)─┬─tfork(26242)(26241)───ldap(0)(26242)
│              │                                           ├─tfork(26244)(26243)───ldap(1)(26244)
│              │                                           ├─tfork(26246)(26245)───ldap(2)(26246)
│              │                                           └─tfork(26248)(26247)───ldap(3)(26248)
│              ├─tfork(26208)(26205)───cldap[master](26208)
│              ├─tfork(26210)(26209)───kdc[master](26210)───tfork(26218)(26215)───krb5kdc(26218)
│              ├─tfork(26213)(26211)───drepl[master](26213)
│              ├─tfork(26216)(26214)───winbindd[master(26216)───tfork(26222)(26219)───winbindd(26222)───wi+
│              ├─tfork(26220)(26217)───ntp_signd[maste(26220)
│              ├─tfork(26223)(26221)───kcc[master](26223)
│              ├─tfork(26225)(26224)───dnsupdate[maste(26225)
│              └─tfork(26227)(26226)───dns[master](26227)

Signed-off-by: Samuel Cabrero <scabrero@samba.org>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
2021-03-01 03:50:35 +00:00

99 lines
3.0 KiB
C

/*
Unix SMB/CIFS implementation.
Samba utility functions
Copyright (C) Andrew Tridgell 1992-1998
Copyright (C) Jeremy Allison 2001-2002
Copyright (C) Simo Sorce 2001
Copyright (C) Jim McDonough (jmcd@us.ibm.com) 2003.
Copyright (C) James J Myers 2003
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _BECOME_DAEMON_H
#define _BECOME_DAEMON_H
#include <stdbool.h>
/**
* @file become_daemon.h
*
* @brief Utilities for demonising
*/
/**
* @brief Close the low 3 file descriptors and open /dev/null in their place
*
* @param[in] stdin_too Should stdin be closed?
* @param[in] stdout_too Should stdout be closed?
* @param[in] stderr_too Should stderr be closed?
**/
void close_low_fds(bool stdin_too, bool stdout_too, bool stderr_too);
/**
* @brief Enable or disable daemon status systemd notifications
*
* When samba runs as AD DC only the main 'samba' process has to
* notify systemd. Child processes started by the main 'samba', like
* smbd and winbindd should call this function to disable sd_notify()
* calls.
*
* @param[in] enable True to enable notifications, false to disable
**/
void daemon_sd_notifications(bool enable);
/**
* @brief Become a daemon, optionally discarding the controlling terminal
*
* @param[in] do_fork Should the process fork?
* @param[in] no_session Don't start a new session
* @param[in] log_stdour Should stdout be closed?
**/
void become_daemon(bool do_fork, bool no_session, bool log_stdout);
/**
* @brief Exit daemon and log an error message at ERR level
*
* Optionally report failure to systemd if systemd integration is
* enabled.
*
* @param[in] msg Message to log, generated from error if NULL
* @param[in] error Errno of error that occurred
**/
void exit_daemon(const char *msg, int error);
/**
* @brief Log at ERR level that the daemon is ready to serve connections
*
* Optionally report status to systemd if systemd integration is enabled.
*
* @param[in] daemon Name of daemon to include it message
**/
void daemon_ready(const char *daemon);
/**
* @brief Log at ERR level the specified daemon status
*
* For example if it is not ready to serve connections and is waiting
* for some event to happen.
*
* Optionally report status to systemd if systemd integration is enabled.
*
* @param[in] daemon Name of daemon to include it message
* @param[in] msg Message to log
**/
void daemon_status(const char *daemon, const char *msg);
#endif /* _BECOME_DAEMON_H */