HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

src/oom/oomd-manager.h

4,039 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: b82b1799eb656e3bb95686da945a2b7a5bd414bd

Lines 1–104 of 104

/* SPDX-License-Identifier: LGPL-2.1-or-later */
#pragma once
 
#include "conf-parser-forward.h"
#include "constants.h"
#include "forward.h"
#include "oomd-conf.h"
#include "oomd-util.h"
 
#define RULESET_DIRS ((const char* const*) CONF_PATHS_STRV("systemd/oomd/rules.d"))
 
/* Polling interval for monitoring stats */
#define SWAP_INTERVAL_USEC 150000 /* 0.15 seconds */
/* Pressure counters are lagging (~2 seconds) compared to swap so polling too frequently just wastes CPU */
#define MEM_PRESSURE_INTERVAL_USEC (1 * USEC_PER_SEC)
 
/* Rules evaluate both pressure and swap metrics; align on the slower-moving metric
 * (pressure counters lag ~2s), so polling faster than 1s just wastes CPU. */
#define RULESETS_INTERVAL_USEC MEM_PRESSURE_INTERVAL_USEC
 
/* Take action if 10s of memory pressure > 60 for more than 30s. We use the "full" value from PSI so this is the
 * percentage of time all tasks were delayed (i.e. unproductive).
 * Generally 60 or higher might be acceptable for something like system.slice with no memory.high set; processes in
 * system.slice are assumed to be less latency sensitive. */
#define DEFAULT_MEM_PRESSURE_DURATION_USEC (30 * USEC_PER_SEC)
#define DEFAULT_MEM_PRESSURE_LIMIT_PERCENT 60
#define DEFAULT_SWAP_USED_LIMIT_PERCENT 90
 
/* Only tackle candidates with large swap usage. */
#define THRESHOLD_SWAP_USED_PERCENT 5
 
#define RECLAIM_DURATION_USEC (30 * USEC_PER_SEC)
#define POST_ACTION_DELAY_USEC (15 * USEC_PER_SEC)
 
typedef enum OomdAction {
        OOMD_ACTION_NONE,
        OOMD_ACTION_KILL_ALL,
        OOMD_ACTION_KILL_BY_PGSCAN,
        OOMD_ACTION_KILL_BY_SWAP,
        _OOMD_ACTION_MAX,
        _OOMD_ACTION_INVALID = -EINVAL,
} OomdAction;
 
typedef struct OomdRuleset {
        char *name;
        int memory_pressure_above; /* permyriad (0-10000), or -1 for unset */
        int swap_above;            /* permyriad (0-10000), or -1 for unset */
        OomdAction action;
        usec_t lasting_usec;
        Hashmap *start_times; /* key: cgroup path (char*) -> value: heap-allocated timestamp (usec_t*) */
        bool warned_no_swap;  /* latched once we've warned that kill-by-swap is misconfigured */
} OomdRuleset;
 
typedef struct Manager {
        sd_bus *bus;
        sd_event *event;
 
        Hashmap *polkit_registry;
 
        bool dry_run;
        int swap_used_limit_permyriad;
        loadavg_t default_mem_pressure_limit;
        usec_t default_mem_pressure_duration_usec;
 
        /* k: cgroup paths -> v: OomdCGroupContext
         * Used to detect when to take action. */
        Hashmap *monitored_swap_cgroup_contexts;
        Hashmap *monitored_mem_pressure_cgroup_contexts;
        Hashmap *monitored_mem_pressure_cgroup_contexts_candidates;
        Hashmap *monitored_rules_cgroup_contexts;
        Hashmap *monitored_rules_cgroup_contexts_candidates;
 
        OomdSystemContext system_context;
 
        usec_t mem_pressure_post_action_delay_start;
        usec_t rules_post_action_delay_start;
 
        sd_event_source *swap_context_event_source;
        sd_event_source *mem_pressure_context_event_source;
        sd_event_source *rules_context_event_source;
 
        /* This varlink object is used to manage the subscription from systemd-oomd to PID1 which it uses to
         * listen for changes in ManagedOOM settings (oomd client - systemd server). */
        sd_varlink *varlink_client;
        /* This varlink server object is used to manage systemd-oomd's varlink server which is used by user
         * managers to report changes in ManagedOOM settings (oomd server - systemd client). */
        sd_varlink_server *varlink_server;
 
        usec_t prekill_timeout;
        Set *kill_states; /* currently ongoing OomdKillState operations */
        Hashmap *rulesets;
} Manager;
 
Manager* manager_free(Manager *m);
DEFINE_TRIVIAL_CLEANUP_FUNC(Manager*, manager_free);
 
int manager_new(Manager **ret);
 
int manager_start(Manager *m, bool dry_run, int fd);
 
int manager_get_dump_string(Manager *m, char **ret);
 
CONFIG_PARSER_PROTOTYPE(config_parse_oomd_default);