Debian Codegraph @

src/shared/common-signal.h

raw
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3
4 #include <syslog.h>
5
6 #include "shared-forward.h"
7
8 /* All our long-running services should implement a SIGRTMIN+18 handler that can be used to trigger certain
9 * actions that affect service runtime. The specific action is indicated via the "value integer" you can pass
10 * along realtime signals. This is mostly intended for debugging purposes and is entirely asynchronous in
11 * nature. Specifically, these are the commands:
12 *
13 * Currently available operations:
14 *
15 * • Change maximum log level
16 * • Change log target
17 * • Invoke memory trimming, like under memory pressure
18 * • Write glibc malloc() allocation info to logs
19 *
20 * How to use this? Via a command like the following:
21 *
22 * /usr/bin/kill -s RTMIN+18 -q 768 1
23 *
24 * (This will tell PID 1 to trim its memory use.)
25 *
26 * or:
27 *
28 * systemctl kill --kill-value=0x300 -s RTMIN+18 systemd-journald
29 *
30 * (This will tell journald to trim its memory use.)
31 */
32
33 enum {
34 _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE = 0x100,
35 COMMON_SIGNAL_COMMAND_LOG_EMERG = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_EMERG,
36 COMMON_SIGNAL_COMMAND_LOG_ALERT = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_ALERT,
37 COMMON_SIGNAL_COMMAND_LOG_CRIT = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_CRIT,
38 COMMON_SIGNAL_COMMAND_LOG_ERR = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_ERR,
39 COMMON_SIGNAL_COMMAND_LOG_WARNING = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_WARNING,
40 COMMON_SIGNAL_COMMAND_LOG_NOTICE = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_NOTICE,
41 COMMON_SIGNAL_COMMAND_LOG_INFO = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_INFO,
42 COMMON_SIGNAL_COMMAND_LOG_DEBUG = _COMMON_SIGNAL_COMMAND_LOG_LEVEL_BASE + LOG_DEBUG,
43 _COMMON_SIGNAL_COMMAND_LOG_LEVEL_END = COMMON_SIGNAL_COMMAND_LOG_DEBUG,
44
45 COMMON_SIGNAL_COMMAND_CONSOLE = 0x200,
46 COMMON_SIGNAL_COMMAND_JOURNAL,
47 COMMON_SIGNAL_COMMAND_KMSG,
48 COMMON_SIGNAL_COMMAND_NULL,
49
50 COMMON_SIGNAL_COMMAND_MEMORY_PRESSURE = 0x300,
51 COMMON_SIGNAL_COMMAND_MALLOC_INFO,
52
53 /* Private signals start at 0x500 */
54 _COMMON_SIGNAL_COMMAND_PRIVATE_BASE = 0x500,
55 _COMMON_SIGNAL_COMMAND_PRIVATE_END = 0xfff,
56 };
57
58 struct sigrtmin18_info {
59 sd_event_handler_t memory_pressure_handler;
60 void *memory_pressure_userdata;
61 };
62
63 int sigrtmin18_handler(sd_event_source *s, const struct signalfd_siginfo *si, void *userdata);