• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

systemd / systemd / 19603132989

22 Nov 2025 10:41PM UTC coverage: 72.453% (-0.07%) from 72.518%
19603132989

push

github

YHNdnzj
docs: Document cast formatting rules

308192 of 425371 relevant lines covered (72.45%)

1182701.2 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

96.83
/src/basic/unit-def.c
1
/* SPDX-License-Identifier: LGPL-2.1-or-later */
2

3
#include "alloc-util.h"
4
#include "bus-label.h"
5
#include "glyph-util.h"
6
#include "string-table.h"
7
#include "string-util.h"
8
#include "unit-def.h"
9
#include "unit-name.h"
10

11
char* unit_dbus_path_from_name(const char *name) {
170,255✔
12
        _cleanup_free_ char *e = NULL;
170,255✔
13

14
        assert(name);
170,255✔
15

16
        e = bus_label_escape(name);
170,255✔
17
        if (!e)
170,255✔
18
                return NULL;
19

20
        return strjoin("/org/freedesktop/systemd1/unit/", e);
170,255✔
21
}
22

23
int unit_name_from_dbus_path(const char *path, char **name) {
616,562✔
24
        const char *e;
616,562✔
25
        char *n;
616,562✔
26

27
        e = startswith(path, "/org/freedesktop/systemd1/unit/");
616,562✔
28
        if (!e)
616,562✔
29
                return -EINVAL;
30

31
        n = bus_label_unescape(e);
607,901✔
32
        if (!n)
607,901✔
33
                return -ENOMEM;
34

35
        *name = n;
607,901✔
36
        return 0;
607,901✔
37
}
38

39
const char* unit_dbus_interface_from_type(UnitType t) {
313,979✔
40

41
        static const char *const table[_UNIT_TYPE_MAX] = {
313,979✔
42
                [UNIT_SERVICE]   = "org.freedesktop.systemd1.Service",
43
                [UNIT_SOCKET]    = "org.freedesktop.systemd1.Socket",
44
                [UNIT_TARGET]    = "org.freedesktop.systemd1.Target",
45
                [UNIT_DEVICE]    = "org.freedesktop.systemd1.Device",
46
                [UNIT_MOUNT]     = "org.freedesktop.systemd1.Mount",
47
                [UNIT_AUTOMOUNT] = "org.freedesktop.systemd1.Automount",
48
                [UNIT_SWAP]      = "org.freedesktop.systemd1.Swap",
49
                [UNIT_TIMER]     = "org.freedesktop.systemd1.Timer",
50
                [UNIT_PATH]      = "org.freedesktop.systemd1.Path",
51
                [UNIT_SLICE]     = "org.freedesktop.systemd1.Slice",
52
                [UNIT_SCOPE]     = "org.freedesktop.systemd1.Scope",
53
        };
54

55
        if (t < 0)
313,979✔
56
                return NULL;
57
        if (t >= _UNIT_TYPE_MAX)
313,979✔
58
                return NULL;
59

60
        return table[t];
313,979✔
61
}
62

63
const char* unit_dbus_interface_from_name(const char *name) {
31✔
64
        UnitType t;
31✔
65

66
        t = unit_name_to_type(name);
31✔
67
        if (t < 0)
31✔
68
                return NULL;
69

70
        return unit_dbus_interface_from_type(t);
31✔
71
}
72

73
static const char* const unit_type_table[_UNIT_TYPE_MAX] = {
74
        [UNIT_SERVICE]   = "service",
75
        [UNIT_SOCKET]    = "socket",
76
        [UNIT_TARGET]    = "target",
77
        [UNIT_DEVICE]    = "device",
78
        [UNIT_MOUNT]     = "mount",
79
        [UNIT_AUTOMOUNT] = "automount",
80
        [UNIT_SWAP]      = "swap",
81
        [UNIT_TIMER]     = "timer",
82
        [UNIT_PATH]      = "path",
83
        [UNIT_SLICE]     = "slice",
84
        [UNIT_SCOPE]     = "scope",
85
};
86

87
DEFINE_STRING_TABLE_LOOKUP(unit_type, UnitType);
86,597,372✔
88

89
static const char* const unit_load_state_table[_UNIT_LOAD_STATE_MAX] = {
90
        [UNIT_STUB]        = "stub",
91
        [UNIT_LOADED]      = "loaded",
92
        [UNIT_NOT_FOUND]   = "not-found",
93
        [UNIT_BAD_SETTING] = "bad-setting",
94
        [UNIT_ERROR]       = "error",
95
        [UNIT_MERGED]      = "merged",
96
        [UNIT_MASKED]      = "masked",
97
};
98

99
DEFINE_STRING_TABLE_LOOKUP(unit_load_state, UnitLoadState);
7,092✔
100

101
/* Keep in sync with man/unit-states.xml */
102
static const char* const unit_active_state_table[_UNIT_ACTIVE_STATE_MAX] = {
103
        [UNIT_ACTIVE]       = "active",
104
        [UNIT_RELOADING]    = "reloading",
105
        [UNIT_INACTIVE]     = "inactive",
106
        [UNIT_FAILED]       = "failed",
107
        [UNIT_ACTIVATING]   = "activating",
108
        [UNIT_DEACTIVATING] = "deactivating",
109
        [UNIT_MAINTENANCE]  = "maintenance",
110
        [UNIT_REFRESHING]   = "refreshing",
111
};
112

113
DEFINE_STRING_TABLE_LOOKUP(unit_active_state, UnitActiveState);
37,226✔
114

115
static const char* const freezer_state_table[_FREEZER_STATE_MAX] = {
116
        [FREEZER_RUNNING]            = "running",
117
        [FREEZER_FREEZING]           = "freezing",
118
        [FREEZER_FREEZING_BY_PARENT] = "freezing-by-parent",
119
        [FREEZER_FROZEN]             = "frozen",
120
        [FREEZER_FROZEN_BY_PARENT]   = "frozen-by-parent",
121
        [FREEZER_THAWING]            = "thawing",
122
};
123

124
DEFINE_STRING_TABLE_LOOKUP(freezer_state, FreezerState);
58,352✔
125

126
/* Maps in-progress freezer states to the corresponding finished state */
127
static const FreezerState freezer_state_finish_table[_FREEZER_STATE_MAX] = {
128
        [FREEZER_FREEZING]           = FREEZER_FROZEN,
129
        [FREEZER_FREEZING_BY_PARENT] = FREEZER_FROZEN_BY_PARENT,
130
        [FREEZER_THAWING]            = FREEZER_RUNNING,
131

132
        /* Finished states trivially map to themselves */
133
        [FREEZER_RUNNING]            = FREEZER_RUNNING,
134
        [FREEZER_FROZEN]             = FREEZER_FROZEN,
135
        [FREEZER_FROZEN_BY_PARENT]   = FREEZER_FROZEN_BY_PARENT,
136
};
137

138
FreezerState freezer_state_finish(FreezerState state) {
2,835✔
139
        assert(state >= 0);
2,835✔
140
        assert(state < _FREEZER_STATE_MAX);
2,835✔
141

142
        return freezer_state_finish_table[state];
2,835✔
143
}
144

145
FreezerState freezer_state_objective(FreezerState state) {
2,835✔
146
        FreezerState objective;
2,835✔
147

148
        objective = freezer_state_finish(state);
2,835✔
149
        if (objective == FREEZER_FROZEN_BY_PARENT)
2,835✔
150
                objective = FREEZER_FROZEN;
×
151

152
        return objective;
2,835✔
153
}
154

155
static const char* const unit_marker_table[_UNIT_MARKER_MAX] = {
156
        [UNIT_MARKER_NEEDS_RELOAD]  = "needs-reload",
157
        [UNIT_MARKER_NEEDS_RESTART] = "needs-restart",
158
};
159

160
DEFINE_STRING_TABLE_LOOKUP(unit_marker, UnitMarker);
×
161

162
static const char* const automount_state_table[_AUTOMOUNT_STATE_MAX] = {
163
        [AUTOMOUNT_DEAD]    = "dead",
164
        [AUTOMOUNT_WAITING] = "waiting",
165
        [AUTOMOUNT_RUNNING] = "running",
166
        [AUTOMOUNT_FAILED]  = "failed",
167
};
168

169
DEFINE_STRING_TABLE_LOOKUP(automount_state, AutomountState);
360✔
170

171
static const char* const device_state_table[_DEVICE_STATE_MAX] = {
172
        [DEVICE_DEAD]      = "dead",
173
        [DEVICE_TENTATIVE] = "tentative",
174
        [DEVICE_PLUGGED]   = "plugged",
175
};
176

177
DEFINE_STRING_TABLE_LOOKUP(device_state, DeviceState);
83,309✔
178

179
static const char* const mount_state_table[_MOUNT_STATE_MAX] = {
180
        [MOUNT_DEAD]               = "dead",
181
        [MOUNT_MOUNTING]           = "mounting",
182
        [MOUNT_MOUNTING_DONE]      = "mounting-done",
183
        [MOUNT_MOUNTED]            = "mounted",
184
        [MOUNT_REMOUNTING]         = "remounting",
185
        [MOUNT_UNMOUNTING]         = "unmounting",
186
        [MOUNT_REMOUNTING_SIGTERM] = "remounting-sigterm",
187
        [MOUNT_REMOUNTING_SIGKILL] = "remounting-sigkill",
188
        [MOUNT_UNMOUNTING_SIGTERM] = "unmounting-sigterm",
189
        [MOUNT_UNMOUNTING_SIGKILL] = "unmounting-sigkill",
190
        [MOUNT_FAILED]             = "failed",
191
        [MOUNT_CLEANING]           = "cleaning",
192
};
193

194
DEFINE_STRING_TABLE_LOOKUP(mount_state, MountState);
22,784✔
195

196
static const char* const path_state_table[_PATH_STATE_MAX] = {
197
        [PATH_DEAD]    = "dead",
198
        [PATH_WAITING] = "waiting",
199
        [PATH_RUNNING] = "running",
200
        [PATH_FAILED]  = "failed",
201
};
202

203
DEFINE_STRING_TABLE_LOOKUP(path_state, PathState);
1,015✔
204

205
static const char* const scope_state_table[_SCOPE_STATE_MAX] = {
206
        [SCOPE_DEAD]         = "dead",
207
        [SCOPE_START_CHOWN]  = "start-chown",
208
        [SCOPE_RUNNING]      = "running",
209
        [SCOPE_ABANDONED]    = "abandoned",
210
        [SCOPE_STOP_SIGTERM] = "stop-sigterm",
211
        [SCOPE_STOP_SIGKILL] = "stop-sigkill",
212
        [SCOPE_FAILED]       = "failed",
213
};
214

215
DEFINE_STRING_TABLE_LOOKUP(scope_state, ScopeState);
2,249✔
216

217
static const char* const service_state_table[_SERVICE_STATE_MAX] = {
218
        [SERVICE_DEAD]                       = "dead",
219
        [SERVICE_CONDITION]                  = "condition",
220
        [SERVICE_START_PRE]                  = "start-pre",
221
        [SERVICE_START]                      = "start",
222
        [SERVICE_START_POST]                 = "start-post",
223
        [SERVICE_RUNNING]                    = "running",
224
        [SERVICE_EXITED]                     = "exited",
225
        [SERVICE_REFRESH_EXTENSIONS]         = "refresh-extensions",
226
        [SERVICE_RELOAD]                     = "reload",
227
        [SERVICE_RELOAD_SIGNAL]              = "reload-signal",
228
        [SERVICE_RELOAD_NOTIFY]              = "reload-notify",
229
        [SERVICE_RELOAD_POST]                = "reload-post",
230
        [SERVICE_STOP]                       = "stop",
231
        [SERVICE_STOP_WATCHDOG]              = "stop-watchdog",
232
        [SERVICE_STOP_SIGTERM]               = "stop-sigterm",
233
        [SERVICE_STOP_SIGKILL]               = "stop-sigkill",
234
        [SERVICE_STOP_POST]                  = "stop-post",
235
        [SERVICE_FINAL_WATCHDOG]             = "final-watchdog",
236
        [SERVICE_FINAL_SIGTERM]              = "final-sigterm",
237
        [SERVICE_FINAL_SIGKILL]              = "final-sigkill",
238
        [SERVICE_FAILED]                     = "failed",
239
        [SERVICE_DEAD_BEFORE_AUTO_RESTART]   = "dead-before-auto-restart",
240
        [SERVICE_FAILED_BEFORE_AUTO_RESTART] = "failed-before-auto-restart",
241
        [SERVICE_DEAD_RESOURCES_PINNED]      = "dead-resources-pinned",
242
        [SERVICE_AUTO_RESTART]               = "auto-restart",
243
        [SERVICE_AUTO_RESTART_QUEUED]        = "auto-restart-queued",
244
        [SERVICE_CLEANING]                   = "cleaning",
245
        [SERVICE_MOUNTING]                   = "mounting",
246
};
247

248
DEFINE_STRING_TABLE_LOOKUP(service_state, ServiceState);
39,062✔
249

250
static const char* const slice_state_table[_SLICE_STATE_MAX] = {
251
        [SLICE_DEAD]   = "dead",
252
        [SLICE_ACTIVE] = "active",
253
};
254

255
DEFINE_STRING_TABLE_LOOKUP(slice_state, SliceState);
7,660✔
256

257
static const char* const socket_state_table[_SOCKET_STATE_MAX] = {
258
        [SOCKET_DEAD]             = "dead",
259
        [SOCKET_START_PRE]        = "start-pre",
260
        [SOCKET_START_OPEN]       = "start-open",
261
        [SOCKET_START_CHOWN]      = "start-chown",
262
        [SOCKET_START_POST]       = "start-post",
263
        [SOCKET_LISTENING]        = "listening",
264
        [SOCKET_DEFERRED]         = "deferred",
265
        [SOCKET_RUNNING]          = "running",
266
        [SOCKET_STOP_PRE]         = "stop-pre",
267
        [SOCKET_STOP_PRE_SIGTERM] = "stop-pre-sigterm",
268
        [SOCKET_STOP_PRE_SIGKILL] = "stop-pre-sigkill",
269
        [SOCKET_STOP_POST]        = "stop-post",
270
        [SOCKET_FINAL_SIGTERM]    = "final-sigterm",
271
        [SOCKET_FINAL_SIGKILL]    = "final-sigkill",
272
        [SOCKET_FAILED]           = "failed",
273
        [SOCKET_CLEANING]         = "cleaning",
274
};
275

276
DEFINE_STRING_TABLE_LOOKUP(socket_state, SocketState);
32,804✔
277

278
static const char* const swap_state_table[_SWAP_STATE_MAX] = {
279
        [SWAP_DEAD]                 = "dead",
280
        [SWAP_ACTIVATING]           = "activating",
281
        [SWAP_ACTIVATING_DONE]      = "activating-done",
282
        [SWAP_ACTIVE]               = "active",
283
        [SWAP_DEACTIVATING]         = "deactivating",
284
        [SWAP_DEACTIVATING_SIGTERM] = "deactivating-sigterm",
285
        [SWAP_DEACTIVATING_SIGKILL] = "deactivating-sigkill",
286
        [SWAP_FAILED]               = "failed",
287
        [SWAP_CLEANING]             = "cleaning",
288
};
289

290
DEFINE_STRING_TABLE_LOOKUP(swap_state, SwapState);
77✔
291

292
static const char* const target_state_table[_TARGET_STATE_MAX] = {
293
        [TARGET_DEAD]   = "dead",
294
        [TARGET_ACTIVE] = "active",
295
};
296

297
DEFINE_STRING_TABLE_LOOKUP(target_state, TargetState);
22,624✔
298

299
static const char* const timer_state_table[_TIMER_STATE_MAX] = {
300
        [TIMER_DEAD]    = "dead",
301
        [TIMER_WAITING] = "waiting",
302
        [TIMER_RUNNING] = "running",
303
        [TIMER_ELAPSED] = "elapsed",
304
        [TIMER_FAILED]  = "failed",
305
};
306

307
DEFINE_STRING_TABLE_LOOKUP(timer_state, TimerState);
2,167✔
308

309
static const char* const unit_dependency_table[_UNIT_DEPENDENCY_MAX] = {
310
        [UNIT_REQUIRES]               = "Requires",
311
        [UNIT_REQUISITE]              = "Requisite",
312
        [UNIT_WANTS]                  = "Wants",
313
        [UNIT_BINDS_TO]               = "BindsTo",
314
        [UNIT_PART_OF]                = "PartOf",
315
        [UNIT_UPHOLDS]                = "Upholds",
316
        [UNIT_REQUIRED_BY]            = "RequiredBy",
317
        [UNIT_REQUISITE_OF]           = "RequisiteOf",
318
        [UNIT_WANTED_BY]              = "WantedBy",
319
        [UNIT_BOUND_BY]               = "BoundBy",
320
        [UNIT_UPHELD_BY]              = "UpheldBy",
321
        [UNIT_CONSISTS_OF]            = "ConsistsOf",
322
        [UNIT_CONFLICTS]              = "Conflicts",
323
        [UNIT_CONFLICTED_BY]          = "ConflictedBy",
324
        [UNIT_BEFORE]                 = "Before",
325
        [UNIT_AFTER]                  = "After",
326
        [UNIT_ON_SUCCESS]             = "OnSuccess",
327
        [UNIT_ON_SUCCESS_OF]          = "OnSuccessOf",
328
        [UNIT_ON_FAILURE]             = "OnFailure",
329
        [UNIT_ON_FAILURE_OF]          = "OnFailureOf",
330
        [UNIT_TRIGGERS]               = "Triggers",
331
        [UNIT_TRIGGERED_BY]           = "TriggeredBy",
332
        [UNIT_PROPAGATES_RELOAD_TO]   = "PropagatesReloadTo",
333
        [UNIT_RELOAD_PROPAGATED_FROM] = "ReloadPropagatedFrom",
334
        [UNIT_PROPAGATES_STOP_TO]     = "PropagatesStopTo",
335
        [UNIT_STOP_PROPAGATED_FROM]   = "StopPropagatedFrom",
336
        [UNIT_JOINS_NAMESPACE_OF]     = "JoinsNamespaceOf",
337
        [UNIT_REFERENCES]             = "References",
338
        [UNIT_REFERENCED_BY]          = "ReferencedBy",
339
        [UNIT_IN_SLICE]               = "InSlice",
340
        [UNIT_SLICE_OF]               = "SliceOf",
341
};
342

343
DEFINE_STRING_TABLE_LOOKUP(unit_dependency, UnitDependency);
108,108✔
344

345
void unit_types_list(void) {
35✔
346
        DUMP_STRING_TABLE(unit_dependency, UnitDependency, _UNIT_DEPENDENCY_MAX);
1,120✔
347
}
35✔
348

349
static const char* const notify_access_table[_NOTIFY_ACCESS_MAX] = {
350
        [NOTIFY_NONE] = "none",
351
        [NOTIFY_MAIN] = "main",
352
        [NOTIFY_EXEC] = "exec",
353
        [NOTIFY_ALL]  = "all",
354
};
355

356
DEFINE_STRING_TABLE_LOOKUP(notify_access, NotifyAccess);
10,925✔
357

358
static const char* const job_mode_table[_JOB_MODE_MAX] = {
359
        [JOB_FAIL]                 = "fail",
360
        [JOB_LENIENT]              = "lenient",
361
        [JOB_REPLACE]              = "replace",
362
        [JOB_REPLACE_IRREVERSIBLY] = "replace-irreversibly",
363
        [JOB_ISOLATE]              = "isolate",
364
        [JOB_FLUSH]                = "flush",
365
        [JOB_IGNORE_DEPENDENCIES]  = "ignore-dependencies",
366
        [JOB_IGNORE_REQUIREMENTS]  = "ignore-requirements",
367
        [JOB_TRIGGERING]           = "triggering",
368
        [JOB_RESTART_DEPENDENCIES] = "restart-dependencies",
369
};
370

371
DEFINE_STRING_TABLE_LOOKUP(job_mode, JobMode);
11,878✔
372

373
/* This table maps ExecDirectoryType to the setting it is configured with in the unit */
374
static const char* const exec_directory_type_table[_EXEC_DIRECTORY_TYPE_MAX] = {
375
        [EXEC_DIRECTORY_RUNTIME]       = "RuntimeDirectory",
376
        [EXEC_DIRECTORY_STATE]         = "StateDirectory",
377
        [EXEC_DIRECTORY_CACHE]         = "CacheDirectory",
378
        [EXEC_DIRECTORY_LOGS]          = "LogsDirectory",
379
        [EXEC_DIRECTORY_CONFIGURATION] = "ConfigurationDirectory",
380
};
381

382
DEFINE_STRING_TABLE_LOOKUP(exec_directory_type, ExecDirectoryType);
126,268✔
383

384
Glyph unit_active_state_to_glyph(UnitActiveState state) {
815✔
385
        static const Glyph map[_UNIT_ACTIVE_STATE_MAX] = {
815✔
386
                [UNIT_ACTIVE]       = GLYPH_BLACK_CIRCLE,
387
                [UNIT_RELOADING]    = GLYPH_CIRCLE_ARROW,
388
                [UNIT_REFRESHING]   = GLYPH_CIRCLE_ARROW,
389
                [UNIT_INACTIVE]     = GLYPH_WHITE_CIRCLE,
390
                [UNIT_FAILED]       = GLYPH_MULTIPLICATION_SIGN,
391
                [UNIT_ACTIVATING]   = GLYPH_BLACK_CIRCLE,
392
                [UNIT_DEACTIVATING] = GLYPH_BLACK_CIRCLE,
393
                [UNIT_MAINTENANCE]  = GLYPH_WHITE_CIRCLE,
394
        };
395

396
        if (state < 0)
815✔
397
                return _GLYPH_INVALID;
398

399
        assert(state < _UNIT_ACTIVE_STATE_MAX);
815✔
400
        return map[state];
815✔
401
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc