1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 #include "alloc-util.h"
7 #include "bus-internal.h"
9 #include "dbus-cgroup.h"
10 #include "dbus-execute.h"
11 #include "dbus-kill.h"
12 #include "dbus-manager.h"
13 #include "dbus-service.h"
14 #include "dbus-util.h"
15 #include "exit-status.h"
18 #include "parse-util.h"
19 #include "path-util.h"
21 #include "signal-util.h"
22 #include "string-util.h"
26 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_type
, service_type
, ServiceType
);
27 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_result
, service_result
, ServiceResult
);
28 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_restart
, service_restart
, ServiceRestart
);
29 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_notify_access
, notify_access
, NotifyAccess
);
30 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_emergency_action
, emergency_action
, EmergencyAction
);
31 static BUS_DEFINE_PROPERTY_GET(property_get_timeout_abort_usec
, "t", Service
, service_timeout_abort_usec
);
33 static int property_get_exit_status_set(
36 const char *interface
,
38 sd_bus_message
*reply
,
40 sd_bus_error
*error
) {
42 const ExitStatusSet
*status_set
= userdata
;
51 r
= sd_bus_message_open_container(reply
, 'r', "aiai");
55 r
= sd_bus_message_open_container(reply
, 'a', "i");
59 BITMAP_FOREACH(n
, &status_set
->status
, i
) {
62 r
= sd_bus_message_append_basic(reply
, 'i', &n
);
67 r
= sd_bus_message_close_container(reply
);
71 r
= sd_bus_message_open_container(reply
, 'a', "i");
75 BITMAP_FOREACH(n
, &status_set
->signal
, i
) {
78 str
= signal_to_string(n
);
82 r
= sd_bus_message_append_basic(reply
, 'i', &n
);
87 r
= sd_bus_message_close_container(reply
);
91 return sd_bus_message_close_container(reply
);
94 const sd_bus_vtable bus_service_vtable
[] = {
95 SD_BUS_VTABLE_START(0),
96 SD_BUS_PROPERTY("Type", "s", property_get_type
, offsetof(Service
, type
), SD_BUS_VTABLE_PROPERTY_CONST
),
97 SD_BUS_PROPERTY("Restart", "s", property_get_restart
, offsetof(Service
, restart
), SD_BUS_VTABLE_PROPERTY_CONST
),
98 SD_BUS_PROPERTY("PIDFile", "s", NULL
, offsetof(Service
, pid_file
), SD_BUS_VTABLE_PROPERTY_CONST
),
99 SD_BUS_PROPERTY("NotifyAccess", "s", property_get_notify_access
, offsetof(Service
, notify_access
), SD_BUS_VTABLE_PROPERTY_CONST
),
100 SD_BUS_PROPERTY("RestartUSec", "t", bus_property_get_usec
, offsetof(Service
, restart_usec
), SD_BUS_VTABLE_PROPERTY_CONST
),
101 SD_BUS_PROPERTY("TimeoutStartUSec", "t", bus_property_get_usec
, offsetof(Service
, timeout_start_usec
), SD_BUS_VTABLE_PROPERTY_CONST
),
102 SD_BUS_PROPERTY("TimeoutStopUSec", "t", bus_property_get_usec
, offsetof(Service
, timeout_stop_usec
), SD_BUS_VTABLE_PROPERTY_CONST
),
103 SD_BUS_PROPERTY("TimeoutAbortUSec", "t", property_get_timeout_abort_usec
, 0, 0),
104 SD_BUS_PROPERTY("RuntimeMaxUSec", "t", bus_property_get_usec
, offsetof(Service
, runtime_max_usec
), SD_BUS_VTABLE_PROPERTY_CONST
),
105 SD_BUS_PROPERTY("WatchdogUSec", "t", bus_property_get_usec
, offsetof(Service
, watchdog_usec
), SD_BUS_VTABLE_PROPERTY_CONST
),
106 BUS_PROPERTY_DUAL_TIMESTAMP("WatchdogTimestamp", offsetof(Service
, watchdog_timestamp
), 0),
107 SD_BUS_PROPERTY("PermissionsStartOnly", "b", bus_property_get_bool
, offsetof(Service
, permissions_start_only
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
), /* 😷 deprecated */
108 SD_BUS_PROPERTY("RootDirectoryStartOnly", "b", bus_property_get_bool
, offsetof(Service
, root_directory_start_only
), SD_BUS_VTABLE_PROPERTY_CONST
),
109 SD_BUS_PROPERTY("RemainAfterExit", "b", bus_property_get_bool
, offsetof(Service
, remain_after_exit
), SD_BUS_VTABLE_PROPERTY_CONST
),
110 SD_BUS_PROPERTY("GuessMainPID", "b", bus_property_get_bool
, offsetof(Service
, guess_main_pid
), SD_BUS_VTABLE_PROPERTY_CONST
),
111 SD_BUS_PROPERTY("RestartPreventExitStatus", "(aiai)", property_get_exit_status_set
, offsetof(Service
, restart_prevent_status
), SD_BUS_VTABLE_PROPERTY_CONST
),
112 SD_BUS_PROPERTY("RestartForceExitStatus", "(aiai)", property_get_exit_status_set
, offsetof(Service
, restart_force_status
), SD_BUS_VTABLE_PROPERTY_CONST
),
113 SD_BUS_PROPERTY("SuccessExitStatus", "(aiai)", property_get_exit_status_set
, offsetof(Service
, success_status
), SD_BUS_VTABLE_PROPERTY_CONST
),
114 SD_BUS_PROPERTY("MainPID", "u", bus_property_get_pid
, offsetof(Service
, main_pid
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
115 SD_BUS_PROPERTY("ControlPID", "u", bus_property_get_pid
, offsetof(Service
, control_pid
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
116 SD_BUS_PROPERTY("BusName", "s", NULL
, offsetof(Service
, bus_name
), SD_BUS_VTABLE_PROPERTY_CONST
),
117 SD_BUS_PROPERTY("FileDescriptorStoreMax", "u", bus_property_get_unsigned
, offsetof(Service
, n_fd_store_max
), SD_BUS_VTABLE_PROPERTY_CONST
),
118 SD_BUS_PROPERTY("NFileDescriptorStore", "u", bus_property_get_unsigned
, offsetof(Service
, n_fd_store
), 0),
119 SD_BUS_PROPERTY("StatusText", "s", NULL
, offsetof(Service
, status_text
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
120 SD_BUS_PROPERTY("StatusErrno", "i", bus_property_get_int
, offsetof(Service
, status_errno
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
121 SD_BUS_PROPERTY("Result", "s", property_get_result
, offsetof(Service
, result
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
122 SD_BUS_PROPERTY("ReloadResult", "s", property_get_result
, offsetof(Service
, reload_result
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
123 SD_BUS_PROPERTY("CleanResult", "s", property_get_result
, offsetof(Service
, clean_result
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
124 SD_BUS_PROPERTY("USBFunctionDescriptors", "s", NULL
, offsetof(Service
, usb_function_descriptors
), SD_BUS_VTABLE_PROPERTY_CONST
),
125 SD_BUS_PROPERTY("USBFunctionStrings", "s", NULL
, offsetof(Service
, usb_function_strings
), SD_BUS_VTABLE_PROPERTY_CONST
),
126 SD_BUS_PROPERTY("UID", "u", bus_property_get_uid
, offsetof(Unit
, ref_uid
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
127 SD_BUS_PROPERTY("GID", "u", bus_property_get_gid
, offsetof(Unit
, ref_gid
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
128 SD_BUS_PROPERTY("NRestarts", "u", bus_property_get_unsigned
, offsetof(Service
, n_restarts
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
129 SD_BUS_PROPERTY("OOMPolicy", "s", bus_property_get_oom_policy
, offsetof(Service
, oom_policy
), SD_BUS_VTABLE_PROPERTY_CONST
),
131 BUS_EXEC_STATUS_VTABLE("ExecMain", offsetof(Service
, main_exec_status
), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE
),
132 BUS_EXEC_COMMAND_LIST_VTABLE("ExecCondition", offsetof(Service
, exec_command
[SERVICE_EXEC_CONDITION
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
133 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecConditionEx", offsetof(Service
, exec_command
[SERVICE_EXEC_CONDITION
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
134 BUS_EXEC_COMMAND_LIST_VTABLE("ExecStartPre", offsetof(Service
, exec_command
[SERVICE_EXEC_START_PRE
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
135 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecStartPreEx", offsetof(Service
, exec_command
[SERVICE_EXEC_START_PRE
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
136 BUS_EXEC_COMMAND_LIST_VTABLE("ExecStart", offsetof(Service
, exec_command
[SERVICE_EXEC_START
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
137 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecStartEx", offsetof(Service
, exec_command
[SERVICE_EXEC_START
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
138 BUS_EXEC_COMMAND_LIST_VTABLE("ExecStartPost", offsetof(Service
, exec_command
[SERVICE_EXEC_START_POST
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
139 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecStartPostEx", offsetof(Service
, exec_command
[SERVICE_EXEC_START_POST
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
140 BUS_EXEC_COMMAND_LIST_VTABLE("ExecReload", offsetof(Service
, exec_command
[SERVICE_EXEC_RELOAD
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
141 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecReloadEx", offsetof(Service
, exec_command
[SERVICE_EXEC_RELOAD
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
142 BUS_EXEC_COMMAND_LIST_VTABLE("ExecStop", offsetof(Service
, exec_command
[SERVICE_EXEC_STOP
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
143 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecStopEx", offsetof(Service
, exec_command
[SERVICE_EXEC_STOP
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
144 BUS_EXEC_COMMAND_LIST_VTABLE("ExecStopPost", offsetof(Service
, exec_command
[SERVICE_EXEC_STOP_POST
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
145 BUS_EXEC_EX_COMMAND_LIST_VTABLE("ExecStopPostEx", offsetof(Service
, exec_command
[SERVICE_EXEC_STOP_POST
]), SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION
),
147 /* The following four are obsolete, and thus marked hidden here. They moved into the Unit interface */
148 SD_BUS_PROPERTY("StartLimitInterval", "t", bus_property_get_usec
, offsetof(Unit
, start_ratelimit
.interval
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
),
149 SD_BUS_PROPERTY("StartLimitBurst", "u", bus_property_get_unsigned
, offsetof(Unit
, start_ratelimit
.burst
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
),
150 SD_BUS_PROPERTY("StartLimitAction", "s", property_get_emergency_action
, offsetof(Unit
, start_limit_action
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
),
151 SD_BUS_PROPERTY("FailureAction", "s", property_get_emergency_action
, offsetof(Unit
, failure_action
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
),
152 SD_BUS_PROPERTY("RebootArgument", "s", NULL
, offsetof(Unit
, reboot_arg
), SD_BUS_VTABLE_PROPERTY_CONST
|SD_BUS_VTABLE_HIDDEN
),
156 static int bus_set_transient_exit_status(
159 ExitStatusSet
*status_set
,
160 sd_bus_message
*message
,
161 UnitWriteFlags flags
,
162 sd_bus_error
*error
) {
164 const int32_t *status
, *signal
;
165 size_t n_status
, n_signal
, i
;
168 r
= sd_bus_message_enter_container(message
, 'r', "aiai");
172 r
= sd_bus_message_read_array(message
, 'i', (const void **) &status
, &n_status
);
176 r
= sd_bus_message_read_array(message
, 'i', (const void **) &signal
, &n_signal
);
180 r
= sd_bus_message_exit_container(message
);
184 n_status
/= sizeof(int32_t);
185 n_signal
/= sizeof(int32_t);
187 if (n_status
== 0 && n_signal
== 0 && !UNIT_WRITE_FLAGS_NOOP(flags
)) {
188 exit_status_set_free(status_set
);
189 unit_write_settingf(u
, flags
, name
, "%s=", name
);
193 for (i
= 0; i
< n_status
; i
++) {
194 if (status
[i
] < 0 || status
[i
] > 255)
195 return sd_bus_error_setf(error
, SD_BUS_ERROR_INVALID_ARGS
, "Invalid status code in %s: %"PRIi32
, name
, status
[i
]);
197 if (!UNIT_WRITE_FLAGS_NOOP(flags
)) {
198 r
= bitmap_set(&status_set
->status
, status
[i
]);
202 unit_write_settingf(u
, flags
, name
, "%s=%"PRIi32
, name
, status
[i
]);
206 for (i
= 0; i
< n_signal
; i
++) {
209 str
= signal_to_string((int) signal
[i
]);
211 return sd_bus_error_setf(error
, SD_BUS_ERROR_INVALID_ARGS
, "Invalid signal in %s: %"PRIi32
, name
, signal
[i
]);
213 if (!UNIT_WRITE_FLAGS_NOOP(flags
)) {
214 r
= bitmap_set(&status_set
->signal
, signal
[i
]);
218 unit_write_settingf(u
, flags
, name
, "%s=%s", name
, str
);
225 static int bus_set_transient_std_fd(
230 sd_bus_message
*message
,
231 UnitWriteFlags flags
,
232 sd_bus_error
*error
) {
239 r
= sd_bus_message_read(message
, "h", &fd
);
243 if (!UNIT_WRITE_FLAGS_NOOP(flags
)) {
246 copy
= fcntl(fd
, F_DUPFD_CLOEXEC
, 3);
250 asynchronous_close(*p
);
257 static BUS_DEFINE_SET_TRANSIENT_PARSE(notify_access
, NotifyAccess
, notify_access_from_string
);
258 static BUS_DEFINE_SET_TRANSIENT_PARSE(service_type
, ServiceType
, service_type_from_string
);
259 static BUS_DEFINE_SET_TRANSIENT_PARSE(service_restart
, ServiceRestart
, service_restart_from_string
);
260 static BUS_DEFINE_SET_TRANSIENT_PARSE(oom_policy
, OOMPolicy
, oom_policy_from_string
);
261 static BUS_DEFINE_SET_TRANSIENT_STRING_WITH_CHECK(bus_name
, service_name_is_valid
);
263 static int bus_service_set_transient_property(
266 sd_bus_message
*message
,
267 UnitWriteFlags flags
,
268 sd_bus_error
*error
) {
271 ServiceExecCommand ci
;
278 flags
|= UNIT_PRIVATE
;
280 if (streq(name
, "PermissionsStartOnly"))
281 return bus_set_transient_bool(u
, name
, &s
->permissions_start_only
, message
, flags
, error
);
283 if (streq(name
, "RootDirectoryStartOnly"))
284 return bus_set_transient_bool(u
, name
, &s
->root_directory_start_only
, message
, flags
, error
);
286 if (streq(name
, "RemainAfterExit"))
287 return bus_set_transient_bool(u
, name
, &s
->remain_after_exit
, message
, flags
, error
);
289 if (streq(name
, "GuessMainPID"))
290 return bus_set_transient_bool(u
, name
, &s
->guess_main_pid
, message
, flags
, error
);
292 if (streq(name
, "Type"))
293 return bus_set_transient_service_type(u
, name
, &s
->type
, message
, flags
, error
);
295 if (streq(name
, "OOMPolicy"))
296 return bus_set_transient_oom_policy(u
, name
, &s
->oom_policy
, message
, flags
, error
);
298 if (streq(name
, "RestartUSec"))
299 return bus_set_transient_usec(u
, name
, &s
->restart_usec
, message
, flags
, error
);
301 if (streq(name
, "TimeoutStartUSec")) {
302 r
= bus_set_transient_usec(u
, name
, &s
->timeout_start_usec
, message
, flags
, error
);
303 if (r
>= 0 && !UNIT_WRITE_FLAGS_NOOP(flags
))
304 s
->start_timeout_defined
= true;
309 if (streq(name
, "TimeoutStopUSec"))
310 return bus_set_transient_usec(u
, name
, &s
->timeout_stop_usec
, message
, flags
, error
);
312 if (streq(name
, "RuntimeMaxUSec"))
313 return bus_set_transient_usec(u
, name
, &s
->runtime_max_usec
, message
, flags
, error
);
315 if (streq(name
, "WatchdogUSec"))
316 return bus_set_transient_usec(u
, name
, &s
->watchdog_usec
, message
, flags
, error
);
318 if (streq(name
, "FileDescriptorStoreMax"))
319 return bus_set_transient_unsigned(u
, name
, &s
->n_fd_store_max
, message
, flags
, error
);
321 if (streq(name
, "NotifyAccess"))
322 return bus_set_transient_notify_access(u
, name
, &s
->notify_access
, message
, flags
, error
);
324 if (streq(name
, "PIDFile")) {
325 _cleanup_free_
char *n
= NULL
;
328 r
= sd_bus_message_read(message
, "s", &v
);
333 n
= path_make_absolute(v
, u
->manager
->prefix
[EXEC_DIRECTORY_RUNTIME
]);
337 path_simplify(n
, true);
339 if (!path_is_normalized(n
))
340 return sd_bus_error_setf(error
, SD_BUS_ERROR_INVALID_ARGS
, "PIDFile= path '%s' is not valid", n
);
342 e
= path_startswith(n
, "/var/run/");
346 z
= path_join("/run", e
);
350 if (!UNIT_WRITE_FLAGS_NOOP(flags
))
351 log_unit_notice(u
, "Transient unit's PIDFile= property references path below legacy directory /var/run, updating %s → %s; please update client accordingly.", n
, z
);
353 free_and_replace(n
, z
);
357 if (!UNIT_WRITE_FLAGS_NOOP(flags
)) {
358 free_and_replace(s
->pid_file
, n
);
359 unit_write_settingf(u
, flags
, name
, "%s=%s", name
, strempty(s
->pid_file
));
365 if (streq(name
, "USBFunctionDescriptors"))
366 return bus_set_transient_path(u
, name
, &s
->usb_function_descriptors
, message
, flags
, error
);
368 if (streq(name
, "USBFunctionStrings"))
369 return bus_set_transient_path(u
, name
, &s
->usb_function_strings
, message
, flags
, error
);
371 if (streq(name
, "BusName"))
372 return bus_set_transient_bus_name(u
, name
, &s
->bus_name
, message
, flags
, error
);
374 if (streq(name
, "Restart"))
375 return bus_set_transient_service_restart(u
, name
, &s
->restart
, message
, flags
, error
);
377 if (streq(name
, "RestartPreventExitStatus"))
378 return bus_set_transient_exit_status(u
, name
, &s
->restart_prevent_status
, message
, flags
, error
);
380 if (streq(name
, "RestartForceExitStatus"))
381 return bus_set_transient_exit_status(u
, name
, &s
->restart_force_status
, message
, flags
, error
);
383 if (streq(name
, "SuccessExitStatus"))
384 return bus_set_transient_exit_status(u
, name
, &s
->success_status
, message
, flags
, error
);
386 ci
= service_exec_command_from_string(name
);
387 ci
= (ci
>= 0) ? ci
: service_exec_ex_command_from_string(name
);
389 return bus_set_transient_exec_command(u
, name
, &s
->exec_command
[ci
], message
, flags
, error
);
391 if (streq(name
, "StandardInputFileDescriptor"))
392 return bus_set_transient_std_fd(u
, name
, &s
->stdin_fd
, &s
->exec_context
.stdio_as_fds
, message
, flags
, error
);
394 if (streq(name
, "StandardOutputFileDescriptor"))
395 return bus_set_transient_std_fd(u
, name
, &s
->stdout_fd
, &s
->exec_context
.stdio_as_fds
, message
, flags
, error
);
397 if (streq(name
, "StandardErrorFileDescriptor"))
398 return bus_set_transient_std_fd(u
, name
, &s
->stderr_fd
, &s
->exec_context
.stdio_as_fds
, message
, flags
, error
);
403 int bus_service_set_property(
406 sd_bus_message
*message
,
407 UnitWriteFlags flags
,
408 sd_bus_error
*error
) {
410 Service
*s
= SERVICE(u
);
417 r
= bus_cgroup_set_property(u
, &s
->cgroup_context
, name
, message
, flags
, error
);
421 if (u
->transient
&& u
->load_state
== UNIT_STUB
) {
422 /* This is a transient unit, let's load a little more */
424 r
= bus_service_set_transient_property(s
, name
, message
, flags
, error
);
428 r
= bus_exec_context_set_transient_property(u
, &s
->exec_context
, name
, message
, flags
, error
);
432 r
= bus_kill_context_set_transient_property(u
, &s
->kill_context
, name
, message
, flags
, error
);
440 int bus_service_commit_properties(Unit
*u
) {
443 unit_invalidate_cgroup_members_masks(u
);
444 unit_realize_cgroup(u
);