src/core/manager-dump.c

   1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
   2
   3 #include "build.h"
   4 #include "fd-util.h"
   5 #include "fileio.h"
   6 #include "hashmap.h"
   7 #include "manager-dump.h"
   8 #include "memstream-util.h"
   9 #include "unit-serialize.h"
  10
  11 void manager_dump_jobs(Manager *s, FILE *f, char **patterns, const char *prefix) {
  12         Job *j;
  13
  14         assert(s);
  15         assert(f);
  16
  17         HASHMAP_FOREACH(j, s->jobs) {
  18
  19                 if (!strv_fnmatch_or_empty(patterns, j->unit->id, FNM_NOESCAPE))
  20                         continue;
  21
  22                 job_dump(j, f, prefix);
  23         }
  24 }
  25
  26 void manager_dump_units(Manager *s, FILE *f, char **patterns, const char *prefix) {
  27         Unit *u;
  28         const char *t;
  29
  30         assert(s);
  31         assert(f);
  32
  33         HASHMAP_FOREACH_KEY(u, t, s->units) {
  34                 if (u->id != t)
  35                         continue;
  36
  37                 if (!strv_fnmatch_or_empty(patterns, u->id, FNM_NOESCAPE))
  38                         continue;
  39
  40                 unit_dump(u, f, prefix);
  41         }
  42 }
  43
  44 static void manager_dump_header(Manager *m, FILE *f, const char *prefix) {
  45
  46         /* NB: this is a debug interface for developers. It's not supposed to be machine readable or be
  47          * stable between versions. We take the liberty to restructure it entirely between versions and
  48          * add/remove fields at will. */
  49
  50         fprintf(f, "%sManager: systemd " STRINGIFY(PROJECT_VERSION) " (" GIT_VERSION ")\n", strempty(prefix));
  51         fprintf(f, "%sFeatures: %s\n", strempty(prefix), systemd_features);
  52
  53         for (ManagerTimestamp q = 0; q < _MANAGER_TIMESTAMP_MAX; q++) {
  54                 const dual_timestamp *t = m->timestamps + q;
  55
  56                 if (dual_timestamp_is_set(t))
  57                         fprintf(f, "%sTimestamp %s: %s\n",
  58                                 strempty(prefix),
  59                                 manager_timestamp_to_string(q),
  60                                 timestamp_is_set(t->realtime) ? FORMAT_TIMESTAMP(t->realtime) :
  61                                                                 FORMAT_TIMESPAN(t->monotonic, 1));
  62         }
  63 }
  64
  65 void manager_dump(Manager *m, FILE *f, char **patterns, const char *prefix) {
  66         assert(m);
  67         assert(f);
  68
  69         /* If no pattern is provided, dump the full manager state including the manager version, features and
  70          * so on. Otherwise limit the dump to the units/jobs matching the specified patterns. */
  71         if (!patterns)
  72                 manager_dump_header(m, f, prefix);
  73
  74         manager_dump_units(m, f, patterns, prefix);
  75         manager_dump_jobs(m, f, patterns, prefix);
  76 }
  77
  78 int manager_get_dump_string(Manager *m, char **patterns, char **ret) {
  79         _cleanup_(memstream_done) MemStream ms = {};
  80         FILE *f;
  81
  82         assert(m);
  83         assert(ret);
  84
  85         f = memstream_init(&ms);
  86         if (!f)
  87                 return -errno;
  88
  89         manager_dump(m, f, patterns, NULL);
  90
  91         return memstream_finalize(&ms, ret, NULL);
  92 }
  93
  94 void manager_test_summary(Manager *m) {
  95         assert(m);
  96
  97         printf("-> By units:\n");
  98         manager_dump_units(m, stdout, /* patterns= */ NULL, "\t");
  99
 100         printf("-> By jobs:\n");
 101         manager_dump_jobs(m, stdout, /* patterns= */ NULL, "\t");
 102 }