]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/run/run.c
Merge pull request #24499 from medhefgo/format-signedness
[thirdparty/systemd.git] / src / run / run.c
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2
3 #include <getopt.h>
4 #include <stdio.h>
5 #include <fcntl.h>
6 #include <sys/stat.h>
7 #include <sys/types.h>
8
9 #include "sd-bus.h"
10 #include "sd-event.h"
11
12 #include "alloc-util.h"
13 #include "bus-error.h"
14 #include "bus-locator.h"
15 #include "bus-map-properties.h"
16 #include "bus-unit-util.h"
17 #include "bus-wait-for-jobs.h"
18 #include "calendarspec.h"
19 #include "env-util.h"
20 #include "exit-status.h"
21 #include "fd-util.h"
22 #include "format-util.h"
23 #include "main-func.h"
24 #include "parse-argument.h"
25 #include "parse-util.h"
26 #include "path-util.h"
27 #include "pretty-print.h"
28 #include "process-util.h"
29 #include "ptyfwd.h"
30 #include "signal-util.h"
31 #include "spawn-polkit-agent.h"
32 #include "strv.h"
33 #include "terminal-util.h"
34 #include "unit-def.h"
35 #include "unit-name.h"
36 #include "user-util.h"
37
38 static bool arg_ask_password = true;
39 static bool arg_scope = false;
40 static bool arg_remain_after_exit = false;
41 static bool arg_no_block = false;
42 static bool arg_wait = false;
43 static const char *arg_unit = NULL;
44 static const char *arg_description = NULL;
45 static const char *arg_slice = NULL;
46 static bool arg_slice_inherit = false;
47 static bool arg_send_sighup = false;
48 static BusTransport arg_transport = BUS_TRANSPORT_LOCAL;
49 static const char *arg_host = NULL;
50 static bool arg_user = false;
51 static const char *arg_service_type = NULL;
52 static const char *arg_exec_user = NULL;
53 static const char *arg_exec_group = NULL;
54 static int arg_nice = 0;
55 static bool arg_nice_set = false;
56 static char **arg_environment = NULL;
57 static char **arg_property = NULL;
58 static enum {
59 ARG_STDIO_NONE, /* The default, as it is for normal services, stdin connected to /dev/null, and stdout+stderr to the journal */
60 ARG_STDIO_PTY, /* Interactive behaviour, requested by --pty: we allocate a pty and connect it to the TTY we are invoked from */
61 ARG_STDIO_DIRECT, /* Directly pass our stdin/stdout/stderr to the activated service, useful for usage in shell pipelines, requested by --pipe */
62 ARG_STDIO_AUTO, /* If --pipe and --pty are used together we use --pty when invoked on a TTY, and --pipe otherwise */
63 } arg_stdio = ARG_STDIO_NONE;
64 static char **arg_path_property = NULL;
65 static char **arg_socket_property = NULL;
66 static char **arg_timer_property = NULL;
67 static bool arg_with_timer = false;
68 static bool arg_quiet = false;
69 static bool arg_aggressive_gc = false;
70 static char *arg_working_directory = NULL;
71 static bool arg_shell = false;
72 static char **arg_cmdline = NULL;
73
74 STATIC_DESTRUCTOR_REGISTER(arg_environment, strv_freep);
75 STATIC_DESTRUCTOR_REGISTER(arg_property, strv_freep);
76 STATIC_DESTRUCTOR_REGISTER(arg_path_property, strv_freep);
77 STATIC_DESTRUCTOR_REGISTER(arg_socket_property, strv_freep);
78 STATIC_DESTRUCTOR_REGISTER(arg_timer_property, strv_freep);
79 STATIC_DESTRUCTOR_REGISTER(arg_working_directory, freep);
80 STATIC_DESTRUCTOR_REGISTER(arg_cmdline, strv_freep);
81
82 static int help(void) {
83 _cleanup_free_ char *link = NULL;
84 int r;
85
86 r = terminal_urlify_man("systemd-run", "1", &link);
87 if (r < 0)
88 return log_oom();
89
90 printf("%s [OPTIONS...] COMMAND [ARGUMENTS...]\n"
91 "\n%sRun the specified command in a transient scope or service.%s\n\n"
92 " -h --help Show this help\n"
93 " --version Show package version\n"
94 " --no-ask-password Do not prompt for password\n"
95 " --user Run as user unit\n"
96 " -H --host=[USER@]HOST Operate on remote host\n"
97 " -M --machine=CONTAINER Operate on local container\n"
98 " --scope Run this as scope rather than service\n"
99 " -u --unit=UNIT Run under the specified unit name\n"
100 " -p --property=NAME=VALUE Set service or scope unit property\n"
101 " --description=TEXT Description for unit\n"
102 " --slice=SLICE Run in the specified slice\n"
103 " --slice-inherit Inherit the slice\n"
104 " --no-block Do not wait until operation finished\n"
105 " -r --remain-after-exit Leave service around until explicitly stopped\n"
106 " --wait Wait until service stopped again\n"
107 " --send-sighup Send SIGHUP when terminating\n"
108 " --service-type=TYPE Service type\n"
109 " --uid=USER Run as system user\n"
110 " --gid=GROUP Run as system group\n"
111 " --nice=NICE Nice level\n"
112 " --working-directory=PATH Set working directory\n"
113 " -d --same-dir Inherit working directory from caller\n"
114 " -E --setenv=NAME[=VALUE] Set environment variable\n"
115 " -t --pty Run service on pseudo TTY as STDIN/STDOUT/\n"
116 " STDERR\n"
117 " -P --pipe Pass STDIN/STDOUT/STDERR directly to service\n"
118 " -q --quiet Suppress information messages during runtime\n"
119 " -G --collect Unload unit after it ran, even when failed\n"
120 " -S --shell Invoke a $SHELL interactively\n\n"
121 "Path options:\n"
122 " --path-property=NAME=VALUE Set path unit property\n\n"
123 "Socket options:\n"
124 " --socket-property=NAME=VALUE Set socket unit property\n\n"
125 "Timer options:\n"
126 " --on-active=SECONDS Run after SECONDS delay\n"
127 " --on-boot=SECONDS Run SECONDS after machine was booted up\n"
128 " --on-startup=SECONDS Run SECONDS after systemd activation\n"
129 " --on-unit-active=SECONDS Run SECONDS after the last activation\n"
130 " --on-unit-inactive=SECONDS Run SECONDS after the last deactivation\n"
131 " --on-calendar=SPEC Realtime timer\n"
132 " --on-timezone-change Run when the timezone changes\n"
133 " --on-clock-change Run when the realtime clock jumps\n"
134 " --timer-property=NAME=VALUE Set timer unit property\n"
135 "\nSee the %s for details.\n",
136 program_invocation_short_name,
137 ansi_highlight(),
138 ansi_normal(),
139 link);
140
141 return 0;
142 }
143
144 static int add_timer_property(const char *name, const char *val) {
145 char *p;
146
147 assert(name);
148 assert(val);
149
150 p = strjoin(name, "=", val);
151 if (!p)
152 return log_oom();
153
154 if (strv_consume(&arg_timer_property, p) < 0)
155 return log_oom();
156
157 return 0;
158 }
159
160 static int parse_argv(int argc, char *argv[]) {
161
162 enum {
163 ARG_VERSION = 0x100,
164 ARG_USER,
165 ARG_SYSTEM,
166 ARG_SCOPE,
167 ARG_DESCRIPTION,
168 ARG_SLICE,
169 ARG_SLICE_INHERIT,
170 ARG_SEND_SIGHUP,
171 ARG_SERVICE_TYPE,
172 ARG_EXEC_USER,
173 ARG_EXEC_GROUP,
174 ARG_NICE,
175 ARG_ON_ACTIVE,
176 ARG_ON_BOOT,
177 ARG_ON_STARTUP,
178 ARG_ON_UNIT_ACTIVE,
179 ARG_ON_UNIT_INACTIVE,
180 ARG_ON_CALENDAR,
181 ARG_ON_TIMEZONE_CHANGE,
182 ARG_ON_CLOCK_CHANGE,
183 ARG_TIMER_PROPERTY,
184 ARG_PATH_PROPERTY,
185 ARG_SOCKET_PROPERTY,
186 ARG_NO_BLOCK,
187 ARG_NO_ASK_PASSWORD,
188 ARG_WAIT,
189 ARG_WORKING_DIRECTORY,
190 ARG_SHELL,
191 };
192
193 static const struct option options[] = {
194 { "help", no_argument, NULL, 'h' },
195 { "version", no_argument, NULL, ARG_VERSION },
196 { "user", no_argument, NULL, ARG_USER },
197 { "system", no_argument, NULL, ARG_SYSTEM },
198 { "scope", no_argument, NULL, ARG_SCOPE },
199 { "unit", required_argument, NULL, 'u' },
200 { "description", required_argument, NULL, ARG_DESCRIPTION },
201 { "slice", required_argument, NULL, ARG_SLICE },
202 { "slice-inherit", no_argument, NULL, ARG_SLICE_INHERIT },
203 { "remain-after-exit", no_argument, NULL, 'r' },
204 { "send-sighup", no_argument, NULL, ARG_SEND_SIGHUP },
205 { "host", required_argument, NULL, 'H' },
206 { "machine", required_argument, NULL, 'M' },
207 { "service-type", required_argument, NULL, ARG_SERVICE_TYPE },
208 { "wait", no_argument, NULL, ARG_WAIT },
209 { "uid", required_argument, NULL, ARG_EXEC_USER },
210 { "gid", required_argument, NULL, ARG_EXEC_GROUP },
211 { "nice", required_argument, NULL, ARG_NICE },
212 { "setenv", required_argument, NULL, 'E' },
213 { "property", required_argument, NULL, 'p' },
214 { "tty", no_argument, NULL, 't' }, /* deprecated alias */
215 { "pty", no_argument, NULL, 't' },
216 { "pipe", no_argument, NULL, 'P' },
217 { "quiet", no_argument, NULL, 'q' },
218 { "on-active", required_argument, NULL, ARG_ON_ACTIVE },
219 { "on-boot", required_argument, NULL, ARG_ON_BOOT },
220 { "on-startup", required_argument, NULL, ARG_ON_STARTUP },
221 { "on-unit-active", required_argument, NULL, ARG_ON_UNIT_ACTIVE },
222 { "on-unit-inactive", required_argument, NULL, ARG_ON_UNIT_INACTIVE },
223 { "on-calendar", required_argument, NULL, ARG_ON_CALENDAR },
224 { "on-timezone-change",no_argument, NULL, ARG_ON_TIMEZONE_CHANGE},
225 { "on-clock-change", no_argument, NULL, ARG_ON_CLOCK_CHANGE },
226 { "timer-property", required_argument, NULL, ARG_TIMER_PROPERTY },
227 { "path-property", required_argument, NULL, ARG_PATH_PROPERTY },
228 { "socket-property", required_argument, NULL, ARG_SOCKET_PROPERTY },
229 { "no-block", no_argument, NULL, ARG_NO_BLOCK },
230 { "no-ask-password", no_argument, NULL, ARG_NO_ASK_PASSWORD },
231 { "collect", no_argument, NULL, 'G' },
232 { "working-directory", required_argument, NULL, ARG_WORKING_DIRECTORY },
233 { "same-dir", no_argument, NULL, 'd' },
234 { "shell", no_argument, NULL, 'S' },
235 {},
236 };
237
238 bool with_trigger = false;
239 int r, c;
240
241 assert(argc >= 0);
242 assert(argv);
243
244 while ((c = getopt_long(argc, argv, "+hrH:M:E:p:tPqGdSu:", options, NULL)) >= 0)
245
246 switch (c) {
247
248 case 'h':
249 return help();
250
251 case ARG_VERSION:
252 return version();
253
254 case ARG_NO_ASK_PASSWORD:
255 arg_ask_password = false;
256 break;
257
258 case ARG_USER:
259 arg_user = true;
260 break;
261
262 case ARG_SYSTEM:
263 arg_user = false;
264 break;
265
266 case ARG_SCOPE:
267 arg_scope = true;
268 break;
269
270 case 'u':
271 arg_unit = optarg;
272 break;
273
274 case ARG_DESCRIPTION:
275 arg_description = optarg;
276 break;
277
278 case ARG_SLICE:
279 arg_slice = optarg;
280 break;
281
282 case ARG_SLICE_INHERIT:
283 arg_slice_inherit = true;
284 break;
285
286 case ARG_SEND_SIGHUP:
287 arg_send_sighup = true;
288 break;
289
290 case 'r':
291 arg_remain_after_exit = true;
292 break;
293
294 case 'H':
295 arg_transport = BUS_TRANSPORT_REMOTE;
296 arg_host = optarg;
297 break;
298
299 case 'M':
300 arg_transport = BUS_TRANSPORT_MACHINE;
301 arg_host = optarg;
302 break;
303
304 case ARG_SERVICE_TYPE:
305 arg_service_type = optarg;
306 break;
307
308 case ARG_EXEC_USER:
309 arg_exec_user = optarg;
310 break;
311
312 case ARG_EXEC_GROUP:
313 arg_exec_group = optarg;
314 break;
315
316 case ARG_NICE:
317 r = parse_nice(optarg, &arg_nice);
318 if (r < 0)
319 return log_error_errno(r, "Failed to parse nice value: %s", optarg);
320
321 arg_nice_set = true;
322 break;
323
324 case 'E':
325 r = strv_env_replace_strdup_passthrough(&arg_environment, optarg);
326 if (r < 0)
327 return log_error_errno(r, "Cannot assign environment variable %s: %m", optarg);
328
329 break;
330
331 case 'p':
332 if (strv_extend(&arg_property, optarg) < 0)
333 return log_oom();
334
335 break;
336
337 case 't': /* --pty */
338 if (IN_SET(arg_stdio, ARG_STDIO_DIRECT, ARG_STDIO_AUTO)) /* if --pipe is already used, upgrade to auto mode */
339 arg_stdio = ARG_STDIO_AUTO;
340 else
341 arg_stdio = ARG_STDIO_PTY;
342 break;
343
344 case 'P': /* --pipe */
345 if (IN_SET(arg_stdio, ARG_STDIO_PTY, ARG_STDIO_AUTO)) /* If --pty is already used, upgrade to auto mode */
346 arg_stdio = ARG_STDIO_AUTO;
347 else
348 arg_stdio = ARG_STDIO_DIRECT;
349 break;
350
351 case 'q':
352 arg_quiet = true;
353 break;
354
355 case ARG_ON_ACTIVE:
356 r = add_timer_property("OnActiveSec", optarg);
357 if (r < 0)
358 return r;
359
360 arg_with_timer = true;
361 break;
362
363 case ARG_ON_BOOT:
364 r = add_timer_property("OnBootSec", optarg);
365 if (r < 0)
366 return r;
367
368 arg_with_timer = true;
369 break;
370
371 case ARG_ON_STARTUP:
372 r = add_timer_property("OnStartupSec", optarg);
373 if (r < 0)
374 return r;
375
376 arg_with_timer = true;
377 break;
378
379 case ARG_ON_UNIT_ACTIVE:
380 r = add_timer_property("OnUnitActiveSec", optarg);
381 if (r < 0)
382 return r;
383
384 arg_with_timer = true;
385 break;
386
387 case ARG_ON_UNIT_INACTIVE:
388 r = add_timer_property("OnUnitInactiveSec", optarg);
389 if (r < 0)
390 return r;
391
392 arg_with_timer = true;
393 break;
394
395 case ARG_ON_CALENDAR: {
396 _cleanup_(calendar_spec_freep) CalendarSpec *cs = NULL;
397
398 r = calendar_spec_from_string(optarg, &cs);
399 if (r < 0)
400 return log_error_errno(r, "Failed to parse calendar event specification: %m");
401
402 /* Let's make sure the given calendar event is not in the past */
403 r = calendar_spec_next_usec(cs, now(CLOCK_REALTIME), NULL);
404 if (r == -ENOENT)
405 /* The calendar event is in the past — let's warn about this, but install it
406 * anyway as is. The service manager will trigger the service right away.
407 * Moreover, the server side might have a different clock or timezone than we
408 * do, hence it should decide when or whether to run something. */
409 log_warning("Specified calendar expression is in the past, proceeding anyway.");
410 else if (r < 0)
411 return log_error_errno(r, "Failed to calculate next time calendar expression elapses: %m");
412
413 r = add_timer_property("OnCalendar", optarg);
414 if (r < 0)
415 return r;
416
417 arg_with_timer = true;
418 break;
419 }
420
421 case ARG_ON_TIMEZONE_CHANGE:
422 r = add_timer_property("OnTimezoneChange", "yes");
423 if (r < 0)
424 return r;
425
426 arg_with_timer = true;
427 break;
428
429 case ARG_ON_CLOCK_CHANGE:
430 r = add_timer_property("OnClockChange", "yes");
431 if (r < 0)
432 return r;
433
434 arg_with_timer = true;
435 break;
436
437 case ARG_TIMER_PROPERTY:
438
439 if (strv_extend(&arg_timer_property, optarg) < 0)
440 return log_oom();
441
442 arg_with_timer = arg_with_timer ||
443 STARTSWITH_SET(optarg,
444 "OnActiveSec=",
445 "OnBootSec=",
446 "OnStartupSec=",
447 "OnUnitActiveSec=",
448 "OnUnitInactiveSec=",
449 "OnCalendar=");
450 break;
451
452 case ARG_PATH_PROPERTY:
453
454 if (strv_extend(&arg_path_property, optarg) < 0)
455 return log_oom();
456
457 break;
458
459 case ARG_SOCKET_PROPERTY:
460
461 if (strv_extend(&arg_socket_property, optarg) < 0)
462 return log_oom();
463
464 break;
465
466 case ARG_NO_BLOCK:
467 arg_no_block = true;
468 break;
469
470 case ARG_WAIT:
471 arg_wait = true;
472 break;
473
474 case ARG_WORKING_DIRECTORY:
475 r = parse_path_argument(optarg, true, &arg_working_directory);
476 if (r < 0)
477 return r;
478
479 break;
480
481 case 'd': {
482 _cleanup_free_ char *p = NULL;
483
484 r = safe_getcwd(&p);
485 if (r < 0)
486 return log_error_errno(r, "Failed to get current working directory: %m");
487
488 if (empty_or_root(p))
489 arg_working_directory = mfree(arg_working_directory);
490 else
491 free_and_replace(arg_working_directory, p);
492 break;
493 }
494
495 case 'G':
496 arg_aggressive_gc = true;
497 break;
498
499 case 'S':
500 arg_shell = true;
501 break;
502
503 case '?':
504 return -EINVAL;
505
506 default:
507 assert_not_reached();
508 }
509
510 /* If we are talking to the per-user instance PolicyKit isn't going to help */
511 if (arg_user)
512 arg_ask_password = false;
513
514 with_trigger = !!arg_path_property || !!arg_socket_property || arg_with_timer;
515
516 /* currently, only single trigger (path, socket, timer) unit can be created simultaneously */
517 if ((int) !!arg_path_property + (int) !!arg_socket_property + (int) arg_with_timer > 1)
518 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
519 "Only single trigger (path, socket, timer) unit can be created.");
520
521 if (arg_shell) {
522 /* If --shell is imply --pty --pipe --same-dir --service-type=exec --wait --collect, unless otherwise
523 * specified. */
524
525 if (!arg_scope) {
526 if (arg_stdio == ARG_STDIO_NONE)
527 arg_stdio = ARG_STDIO_AUTO;
528
529 if (!arg_working_directory) {
530 r = safe_getcwd(&arg_working_directory);
531 if (r < 0)
532 return log_error_errno(r, "Failed to get current working directory: %m");
533 }
534
535 if (!arg_service_type) {
536 arg_service_type = strdup("exec");
537 if (!arg_service_type)
538 return log_oom();
539 }
540
541 arg_wait = true;
542 }
543
544 arg_aggressive_gc = true;
545 }
546
547 if (arg_stdio == ARG_STDIO_AUTO)
548 /* If we both --pty and --pipe are specified we'll automatically pick --pty if we are connected fully
549 * to a TTY and pick direct fd passing otherwise. This way, we automatically adapt to usage in a shell
550 * pipeline, but we are neatly interactive with tty-level isolation otherwise. */
551 arg_stdio = isatty(STDIN_FILENO) && isatty(STDOUT_FILENO) && isatty(STDERR_FILENO) ?
552 ARG_STDIO_PTY :
553 ARG_STDIO_DIRECT;
554
555 if (argc > optind) {
556 char **l;
557
558 if (arg_shell)
559 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "If --shell is used, no command line is expected.");
560
561 l = strv_copy(argv + optind);
562 if (!l)
563 return log_oom();
564
565 strv_free_and_replace(arg_cmdline, l);
566
567 } else if (arg_shell) {
568 _cleanup_free_ char *s = NULL;
569 char **l;
570
571 r = get_shell(&s);
572 if (r < 0)
573 return log_error_errno(r, "Failed to determine shell: %m");
574
575 l = strv_new(s);
576 if (!l)
577 return log_oom();
578
579 strv_free_and_replace(arg_cmdline, l);
580
581 } else if (!arg_unit || !with_trigger)
582 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "Command line to execute required.");
583
584 if (arg_user && arg_transport == BUS_TRANSPORT_REMOTE)
585 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
586 "Execution in user context is not supported on remote systems.");
587
588 if (arg_scope && arg_transport == BUS_TRANSPORT_REMOTE)
589 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
590 "Scope execution is not supported on remote systems.");
591
592 if (arg_scope && (arg_remain_after_exit || arg_service_type))
593 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
594 "--remain-after-exit and --service-type= are not supported in --scope mode.");
595
596 if (arg_stdio != ARG_STDIO_NONE && (with_trigger || arg_scope))
597 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
598 "--pty/--pipe is not compatible in timer or --scope mode.");
599
600 if (arg_stdio != ARG_STDIO_NONE && arg_transport == BUS_TRANSPORT_REMOTE)
601 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
602 "--pty/--pipe is only supported when connecting to the local system or containers.");
603
604 if (arg_stdio != ARG_STDIO_NONE && arg_no_block)
605 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
606 "--pty/--pipe is not compatible with --no-block.");
607
608 if (arg_scope && with_trigger)
609 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
610 "Path, socket or timer options are not supported in --scope mode.");
611
612 if (arg_timer_property && !arg_with_timer)
613 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
614 "--timer-property= has no effect without any other timer options.");
615
616 if (arg_wait) {
617 if (arg_no_block)
618 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
619 "--wait may not be combined with --no-block.");
620
621 if (with_trigger)
622 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
623 "--wait may not be combined with path, socket or timer operations.");
624
625 if (arg_scope)
626 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
627 "--wait may not be combined with --scope.");
628 }
629
630 return 1;
631 }
632
633 static int transient_unit_set_properties(sd_bus_message *m, UnitType t, char **properties) {
634 int r;
635
636 r = sd_bus_message_append(m, "(sv)", "Description", "s", arg_description);
637 if (r < 0)
638 return bus_log_create_error(r);
639
640 if (arg_aggressive_gc) {
641 r = sd_bus_message_append(m, "(sv)", "CollectMode", "s", "inactive-or-failed");
642 if (r < 0)
643 return bus_log_create_error(r);
644 }
645
646 return bus_append_unit_property_assignment_many(m, t, properties);
647 }
648
649 static int transient_cgroup_set_properties(sd_bus_message *m) {
650 _cleanup_free_ char *name = NULL;
651 _cleanup_free_ char *slice = NULL;
652 int r;
653 assert(m);
654
655 if (arg_slice_inherit) {
656 char *end;
657
658 if (arg_user)
659 r = cg_pid_get_user_slice(0, &name);
660 else
661 r = cg_pid_get_slice(0, &name);
662 if (r < 0)
663 return log_error_errno(r, "Failed to get PID slice: %m");
664
665 end = endswith(name, ".slice");
666 if (!end)
667 return -ENXIO;
668 *end = 0;
669 }
670
671 if (!isempty(arg_slice) && !strextend_with_separator(&name, "-", arg_slice))
672 return log_oom();
673
674 if (!name)
675 return 0;
676
677 r = unit_name_mangle_with_suffix(name, "as slice",
678 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
679 ".slice", &slice);
680 if (r < 0)
681 return log_error_errno(r, "Failed to mangle name '%s': %m", arg_slice);
682
683 r = sd_bus_message_append(m, "(sv)", "Slice", "s", slice);
684 if (r < 0)
685 return bus_log_create_error(r);
686
687 return 0;
688 }
689
690 static int transient_kill_set_properties(sd_bus_message *m) {
691 int r;
692
693 assert(m);
694
695 if (arg_send_sighup) {
696 r = sd_bus_message_append(m, "(sv)", "SendSIGHUP", "b", arg_send_sighup);
697 if (r < 0)
698 return bus_log_create_error(r);
699 }
700
701 return 0;
702 }
703
704 static int transient_service_set_properties(sd_bus_message *m, const char *pty_path) {
705 bool send_term = false;
706 int r;
707
708 assert(m);
709
710 r = transient_unit_set_properties(m, UNIT_SERVICE, arg_property);
711 if (r < 0)
712 return r;
713
714 r = transient_kill_set_properties(m);
715 if (r < 0)
716 return r;
717
718 r = transient_cgroup_set_properties(m);
719 if (r < 0)
720 return r;
721
722 if (arg_wait || arg_stdio != ARG_STDIO_NONE) {
723 r = sd_bus_message_append(m, "(sv)", "AddRef", "b", 1);
724 if (r < 0)
725 return bus_log_create_error(r);
726 }
727
728 if (arg_remain_after_exit) {
729 r = sd_bus_message_append(m, "(sv)", "RemainAfterExit", "b", arg_remain_after_exit);
730 if (r < 0)
731 return bus_log_create_error(r);
732 }
733
734 if (arg_service_type) {
735 r = sd_bus_message_append(m, "(sv)", "Type", "s", arg_service_type);
736 if (r < 0)
737 return bus_log_create_error(r);
738 }
739
740 if (arg_exec_user) {
741 r = sd_bus_message_append(m, "(sv)", "User", "s", arg_exec_user);
742 if (r < 0)
743 return bus_log_create_error(r);
744 }
745
746 if (arg_exec_group) {
747 r = sd_bus_message_append(m, "(sv)", "Group", "s", arg_exec_group);
748 if (r < 0)
749 return bus_log_create_error(r);
750 }
751
752 if (arg_nice_set) {
753 r = sd_bus_message_append(m, "(sv)", "Nice", "i", arg_nice);
754 if (r < 0)
755 return bus_log_create_error(r);
756 }
757
758 if (arg_working_directory) {
759 r = sd_bus_message_append(m, "(sv)", "WorkingDirectory", "s", arg_working_directory);
760 if (r < 0)
761 return bus_log_create_error(r);
762 }
763
764 if (pty_path) {
765 r = sd_bus_message_append(m,
766 "(sv)(sv)(sv)(sv)",
767 "StandardInput", "s", "tty",
768 "StandardOutput", "s", "tty",
769 "StandardError", "s", "tty",
770 "TTYPath", "s", pty_path);
771 if (r < 0)
772 return bus_log_create_error(r);
773
774 send_term = true;
775
776 } else if (arg_stdio == ARG_STDIO_DIRECT) {
777 r = sd_bus_message_append(m,
778 "(sv)(sv)(sv)",
779 "StandardInputFileDescriptor", "h", STDIN_FILENO,
780 "StandardOutputFileDescriptor", "h", STDOUT_FILENO,
781 "StandardErrorFileDescriptor", "h", STDERR_FILENO);
782 if (r < 0)
783 return bus_log_create_error(r);
784
785 send_term = isatty(STDIN_FILENO) || isatty(STDOUT_FILENO) || isatty(STDERR_FILENO);
786 }
787
788 if (send_term) {
789 const char *e;
790
791 e = getenv("TERM");
792 if (e) {
793 _cleanup_free_ char *n = NULL;
794
795 n = strjoin("TERM=", e);
796 if (!n)
797 return log_oom();
798
799 r = sd_bus_message_append(m,
800 "(sv)",
801 "Environment", "as", 1, n);
802 if (r < 0)
803 return bus_log_create_error(r);
804 }
805 }
806
807 if (!strv_isempty(arg_environment)) {
808 r = sd_bus_message_open_container(m, 'r', "sv");
809 if (r < 0)
810 return bus_log_create_error(r);
811
812 r = sd_bus_message_append(m, "s", "Environment");
813 if (r < 0)
814 return bus_log_create_error(r);
815
816 r = sd_bus_message_open_container(m, 'v', "as");
817 if (r < 0)
818 return bus_log_create_error(r);
819
820 r = sd_bus_message_append_strv(m, arg_environment);
821 if (r < 0)
822 return bus_log_create_error(r);
823
824 r = sd_bus_message_close_container(m);
825 if (r < 0)
826 return bus_log_create_error(r);
827
828 r = sd_bus_message_close_container(m);
829 if (r < 0)
830 return bus_log_create_error(r);
831 }
832
833 /* Exec container */
834 if (!strv_isempty(arg_cmdline)) {
835 r = sd_bus_message_open_container(m, 'r', "sv");
836 if (r < 0)
837 return bus_log_create_error(r);
838
839 r = sd_bus_message_append(m, "s", "ExecStart");
840 if (r < 0)
841 return bus_log_create_error(r);
842
843 r = sd_bus_message_open_container(m, 'v', "a(sasb)");
844 if (r < 0)
845 return bus_log_create_error(r);
846
847 r = sd_bus_message_open_container(m, 'a', "(sasb)");
848 if (r < 0)
849 return bus_log_create_error(r);
850
851 r = sd_bus_message_open_container(m, 'r', "sasb");
852 if (r < 0)
853 return bus_log_create_error(r);
854
855 r = sd_bus_message_append(m, "s", arg_cmdline[0]);
856 if (r < 0)
857 return bus_log_create_error(r);
858
859 r = sd_bus_message_append_strv(m, arg_cmdline);
860 if (r < 0)
861 return bus_log_create_error(r);
862
863 r = sd_bus_message_append(m, "b", false);
864 if (r < 0)
865 return bus_log_create_error(r);
866
867 r = sd_bus_message_close_container(m);
868 if (r < 0)
869 return bus_log_create_error(r);
870
871 r = sd_bus_message_close_container(m);
872 if (r < 0)
873 return bus_log_create_error(r);
874
875 r = sd_bus_message_close_container(m);
876 if (r < 0)
877 return bus_log_create_error(r);
878
879 r = sd_bus_message_close_container(m);
880 if (r < 0)
881 return bus_log_create_error(r);
882 }
883
884 return 0;
885 }
886
887 static int transient_scope_set_properties(sd_bus_message *m) {
888 int r;
889
890 assert(m);
891
892 r = transient_unit_set_properties(m, UNIT_SCOPE, arg_property);
893 if (r < 0)
894 return r;
895
896 r = transient_kill_set_properties(m);
897 if (r < 0)
898 return r;
899
900 r = transient_cgroup_set_properties(m);
901 if (r < 0)
902 return r;
903
904 r = sd_bus_message_append(m, "(sv)", "PIDs", "au", 1, (uint32_t) getpid_cached());
905 if (r < 0)
906 return bus_log_create_error(r);
907
908 return 0;
909 }
910
911 static int transient_timer_set_properties(sd_bus_message *m) {
912 int r;
913
914 assert(m);
915
916 r = transient_unit_set_properties(m, UNIT_TIMER, arg_timer_property);
917 if (r < 0)
918 return r;
919
920 /* Automatically clean up our transient timers */
921 r = sd_bus_message_append(m, "(sv)", "RemainAfterElapse", "b", false);
922 if (r < 0)
923 return bus_log_create_error(r);
924
925 return 0;
926 }
927
928 static int make_unit_name(sd_bus *bus, UnitType t, char **ret) {
929 const char *unique, *id;
930 char *p;
931 int r;
932
933 assert(bus);
934 assert(t >= 0);
935 assert(t < _UNIT_TYPE_MAX);
936
937 r = sd_bus_get_unique_name(bus, &unique);
938 if (r < 0) {
939 sd_id128_t rnd;
940
941 /* We couldn't get the unique name, which is a pretty
942 * common case if we are connected to systemd
943 * directly. In that case, just pick a random uuid as
944 * name */
945
946 r = sd_id128_randomize(&rnd);
947 if (r < 0)
948 return log_error_errno(r, "Failed to generate random run unit name: %m");
949
950 if (asprintf(ret, "run-r" SD_ID128_FORMAT_STR ".%s", SD_ID128_FORMAT_VAL(rnd), unit_type_to_string(t)) < 0)
951 return log_oom();
952
953 return 0;
954 }
955
956 /* We managed to get the unique name, then let's use that to name our transient units. */
957
958 id = startswith(unique, ":1."); /* let' strip the usual prefix */
959 if (!id)
960 id = startswith(unique, ":"); /* the spec only requires things to start with a colon, hence
961 * let's add a generic fallback for that. */
962 if (!id)
963 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
964 "Unique name %s has unexpected format.",
965 unique);
966
967 p = strjoin("run-u", id, ".", unit_type_to_string(t));
968 if (!p)
969 return log_oom();
970
971 *ret = p;
972 return 0;
973 }
974
975 typedef struct RunContext {
976 sd_bus *bus;
977 sd_event *event;
978 PTYForward *forward;
979 sd_bus_slot *match;
980
981 /* Current state of the unit */
982 char *active_state;
983 bool has_job;
984
985 /* The exit data of the unit */
986 uint64_t inactive_exit_usec;
987 uint64_t inactive_enter_usec;
988 char *result;
989 uint64_t cpu_usage_nsec;
990 uint64_t ip_ingress_bytes;
991 uint64_t ip_egress_bytes;
992 uint64_t io_read_bytes;
993 uint64_t io_write_bytes;
994 uint32_t exit_code;
995 uint32_t exit_status;
996 } RunContext;
997
998 static void run_context_free(RunContext *c) {
999 assert(c);
1000
1001 c->forward = pty_forward_free(c->forward);
1002 c->match = sd_bus_slot_unref(c->match);
1003 c->bus = sd_bus_unref(c->bus);
1004 c->event = sd_event_unref(c->event);
1005
1006 free(c->active_state);
1007 free(c->result);
1008 }
1009
1010 static void run_context_check_done(RunContext *c) {
1011 bool done;
1012
1013 assert(c);
1014
1015 if (c->match)
1016 done = STRPTR_IN_SET(c->active_state, "inactive", "failed") && !c->has_job;
1017 else
1018 done = true;
1019
1020 if (c->forward && done) /* If the service is gone, it's time to drain the output */
1021 done = pty_forward_drain(c->forward);
1022
1023 if (done)
1024 sd_event_exit(c->event, EXIT_SUCCESS);
1025 }
1026
1027 static int map_job(sd_bus *bus, const char *member, sd_bus_message *m, sd_bus_error *error, void *userdata) {
1028 bool *b = userdata;
1029 const char *job;
1030 uint32_t id;
1031 int r;
1032
1033 r = sd_bus_message_read(m, "(uo)", &id, &job);
1034 if (r < 0)
1035 return r;
1036
1037 *b = id != 0 || !streq(job, "/");
1038 return 0;
1039 }
1040
1041 static int run_context_update(RunContext *c, const char *path) {
1042
1043 static const struct bus_properties_map map[] = {
1044 { "ActiveState", "s", NULL, offsetof(RunContext, active_state) },
1045 { "InactiveExitTimestampMonotonic", "t", NULL, offsetof(RunContext, inactive_exit_usec) },
1046 { "InactiveEnterTimestampMonotonic", "t", NULL, offsetof(RunContext, inactive_enter_usec) },
1047 { "Result", "s", NULL, offsetof(RunContext, result) },
1048 { "ExecMainCode", "i", NULL, offsetof(RunContext, exit_code) },
1049 { "ExecMainStatus", "i", NULL, offsetof(RunContext, exit_status) },
1050 { "CPUUsageNSec", "t", NULL, offsetof(RunContext, cpu_usage_nsec) },
1051 { "IPIngressBytes", "t", NULL, offsetof(RunContext, ip_ingress_bytes) },
1052 { "IPEgressBytes", "t", NULL, offsetof(RunContext, ip_egress_bytes) },
1053 { "IOReadBytes", "t", NULL, offsetof(RunContext, io_read_bytes) },
1054 { "IOWriteBytes", "t", NULL, offsetof(RunContext, io_write_bytes) },
1055 { "Job", "(uo)", map_job, offsetof(RunContext, has_job) },
1056 {}
1057 };
1058
1059 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1060 int r;
1061
1062 r = bus_map_all_properties(c->bus,
1063 "org.freedesktop.systemd1",
1064 path,
1065 map,
1066 BUS_MAP_STRDUP,
1067 &error,
1068 NULL,
1069 c);
1070 if (r < 0) {
1071 sd_event_exit(c->event, EXIT_FAILURE);
1072 return log_error_errno(r, "Failed to query unit state: %s", bus_error_message(&error, r));
1073 }
1074
1075 run_context_check_done(c);
1076 return 0;
1077 }
1078
1079 static int on_properties_changed(sd_bus_message *m, void *userdata, sd_bus_error *error) {
1080 RunContext *c = userdata;
1081
1082 assert(m);
1083 assert(c);
1084
1085 return run_context_update(c, sd_bus_message_get_path(m));
1086 }
1087
1088 static int pty_forward_handler(PTYForward *f, int rcode, void *userdata) {
1089 RunContext *c = userdata;
1090
1091 assert(f);
1092
1093 if (rcode < 0) {
1094 sd_event_exit(c->event, EXIT_FAILURE);
1095 return log_error_errno(rcode, "Error on PTY forwarding logic: %m");
1096 }
1097
1098 run_context_check_done(c);
1099 return 0;
1100 }
1101
1102 static int start_transient_service(
1103 sd_bus *bus,
1104 int *retval) {
1105
1106 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1107 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1108 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1109 _cleanup_free_ char *service = NULL, *pty_path = NULL;
1110 _cleanup_close_ int master = -1;
1111 int r;
1112
1113 assert(bus);
1114 assert(retval);
1115
1116 if (arg_stdio == ARG_STDIO_PTY) {
1117
1118 if (arg_transport == BUS_TRANSPORT_LOCAL) {
1119 master = posix_openpt(O_RDWR|O_NOCTTY|O_CLOEXEC|O_NONBLOCK);
1120 if (master < 0)
1121 return log_error_errno(errno, "Failed to acquire pseudo tty: %m");
1122
1123 r = ptsname_malloc(master, &pty_path);
1124 if (r < 0)
1125 return log_error_errno(r, "Failed to determine tty name: %m");
1126
1127 if (unlockpt(master) < 0)
1128 return log_error_errno(errno, "Failed to unlock tty: %m");
1129
1130 } else if (arg_transport == BUS_TRANSPORT_MACHINE) {
1131 _cleanup_(sd_bus_unrefp) sd_bus *system_bus = NULL;
1132 _cleanup_(sd_bus_message_unrefp) sd_bus_message *pty_reply = NULL;
1133 const char *s;
1134
1135 r = sd_bus_default_system(&system_bus);
1136 if (r < 0)
1137 return log_error_errno(r, "Failed to connect to system bus: %m");
1138
1139 r = sd_bus_call_method(system_bus,
1140 "org.freedesktop.machine1",
1141 "/org/freedesktop/machine1",
1142 "org.freedesktop.machine1.Manager",
1143 "OpenMachinePTY",
1144 &error,
1145 &pty_reply,
1146 "s", arg_host);
1147 if (r < 0)
1148 return log_error_errno(r, "Failed to get machine PTY: %s", bus_error_message(&error, r));
1149
1150 r = sd_bus_message_read(pty_reply, "hs", &master, &s);
1151 if (r < 0)
1152 return bus_log_parse_error(r);
1153
1154 master = fcntl(master, F_DUPFD_CLOEXEC, 3);
1155 if (master < 0)
1156 return log_error_errno(errno, "Failed to duplicate master fd: %m");
1157
1158 pty_path = strdup(s);
1159 if (!pty_path)
1160 return log_oom();
1161 } else
1162 assert_not_reached();
1163 }
1164
1165 /* Optionally, wait for the start job to complete. If we are supposed to read the service's stdin
1166 * lets skip this however, because we should start that already when the start job is running, and
1167 * there's little point in waiting for the start job to complete in that case anyway, as we'll wait
1168 * for EOF anyway, which is going to be much later. */
1169 if (!arg_no_block && arg_stdio == ARG_STDIO_NONE) {
1170 r = bus_wait_for_jobs_new(bus, &w);
1171 if (r < 0)
1172 return log_error_errno(r, "Could not watch jobs: %m");
1173 }
1174
1175 if (arg_unit) {
1176 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1177 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1178 ".service", &service);
1179 if (r < 0)
1180 return log_error_errno(r, "Failed to mangle unit name: %m");
1181 } else {
1182 r = make_unit_name(bus, UNIT_SERVICE, &service);
1183 if (r < 0)
1184 return r;
1185 }
1186
1187 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1188 if (r < 0)
1189 return bus_log_create_error(r);
1190
1191 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1192 if (r < 0)
1193 return bus_log_create_error(r);
1194
1195 /* Name and mode */
1196 r = sd_bus_message_append(m, "ss", service, "fail");
1197 if (r < 0)
1198 return bus_log_create_error(r);
1199
1200 /* Properties */
1201 r = sd_bus_message_open_container(m, 'a', "(sv)");
1202 if (r < 0)
1203 return bus_log_create_error(r);
1204
1205 r = transient_service_set_properties(m, pty_path);
1206 if (r < 0)
1207 return r;
1208
1209 r = sd_bus_message_close_container(m);
1210 if (r < 0)
1211 return bus_log_create_error(r);
1212
1213 /* Auxiliary units */
1214 r = sd_bus_message_append(m, "a(sa(sv))", 0);
1215 if (r < 0)
1216 return bus_log_create_error(r);
1217
1218 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1219
1220 r = sd_bus_call(bus, m, 0, &error, &reply);
1221 if (r < 0)
1222 return log_error_errno(r, "Failed to start transient service unit: %s", bus_error_message(&error, r));
1223
1224 if (w) {
1225 const char *object;
1226
1227 r = sd_bus_message_read(reply, "o", &object);
1228 if (r < 0)
1229 return bus_log_parse_error(r);
1230
1231 r = bus_wait_for_jobs_one(w, object, arg_quiet, arg_user ? STRV_MAKE_CONST("--user") : NULL);
1232 if (r < 0)
1233 return r;
1234 }
1235
1236 if (!arg_quiet)
1237 log_info("Running as unit: %s", service);
1238
1239 if (arg_wait || arg_stdio != ARG_STDIO_NONE) {
1240 _cleanup_(run_context_free) RunContext c = {
1241 .cpu_usage_nsec = NSEC_INFINITY,
1242 .ip_ingress_bytes = UINT64_MAX,
1243 .ip_egress_bytes = UINT64_MAX,
1244 .io_read_bytes = UINT64_MAX,
1245 .io_write_bytes = UINT64_MAX,
1246 .inactive_exit_usec = USEC_INFINITY,
1247 .inactive_enter_usec = USEC_INFINITY,
1248 };
1249 _cleanup_free_ char *path = NULL;
1250
1251 c.bus = sd_bus_ref(bus);
1252
1253 r = sd_event_default(&c.event);
1254 if (r < 0)
1255 return log_error_errno(r, "Failed to get event loop: %m");
1256
1257 if (master >= 0) {
1258 assert_se(sigprocmask_many(SIG_BLOCK, NULL, SIGWINCH, SIGTERM, SIGINT, -1) >= 0);
1259 (void) sd_event_add_signal(c.event, NULL, SIGINT, NULL, NULL);
1260 (void) sd_event_add_signal(c.event, NULL, SIGTERM, NULL, NULL);
1261
1262 if (!arg_quiet)
1263 log_info("Press ^] three times within 1s to disconnect TTY.");
1264
1265 r = pty_forward_new(c.event, master, PTY_FORWARD_IGNORE_INITIAL_VHANGUP, &c.forward);
1266 if (r < 0)
1267 return log_error_errno(r, "Failed to create PTY forwarder: %m");
1268
1269 pty_forward_set_handler(c.forward, pty_forward_handler, &c);
1270
1271 /* Make sure to process any TTY events before we process bus events */
1272 (void) pty_forward_set_priority(c.forward, SD_EVENT_PRIORITY_IMPORTANT);
1273 }
1274
1275 path = unit_dbus_path_from_name(service);
1276 if (!path)
1277 return log_oom();
1278
1279 r = sd_bus_match_signal_async(
1280 bus,
1281 &c.match,
1282 "org.freedesktop.systemd1",
1283 path,
1284 "org.freedesktop.DBus.Properties",
1285 "PropertiesChanged",
1286 on_properties_changed, NULL, &c);
1287 if (r < 0)
1288 return log_error_errno(r, "Failed to request properties changed signal match: %m");
1289
1290 r = sd_bus_attach_event(bus, c.event, SD_EVENT_PRIORITY_NORMAL);
1291 if (r < 0)
1292 return log_error_errno(r, "Failed to attach bus to event loop: %m");
1293
1294 r = run_context_update(&c, path);
1295 if (r < 0)
1296 return r;
1297
1298 r = sd_event_loop(c.event);
1299 if (r < 0)
1300 return log_error_errno(r, "Failed to run event loop: %m");
1301
1302 if (c.forward) {
1303 char last_char = 0;
1304
1305 r = pty_forward_get_last_char(c.forward, &last_char);
1306 if (r >= 0 && !arg_quiet && last_char != '\n')
1307 fputc('\n', stdout);
1308 }
1309
1310 if (arg_wait && !arg_quiet) {
1311
1312 /* Explicitly destroy the PTY forwarder, so that the PTY device is usable again, with its
1313 * original settings (i.e. proper line breaks), so that we can show the summary in a pretty
1314 * way. */
1315 c.forward = pty_forward_free(c.forward);
1316
1317 if (!isempty(c.result))
1318 log_info("Finished with result: %s", strna(c.result));
1319
1320 if (c.exit_code == CLD_EXITED)
1321 log_info("Main processes terminated with: code=%s/status=%u",
1322 sigchld_code_to_string(c.exit_code), c.exit_status);
1323 else if (c.exit_code > 0)
1324 log_info("Main processes terminated with: code=%s/status=%s",
1325 sigchld_code_to_string(c.exit_code), signal_to_string(c.exit_status));
1326
1327 if (timestamp_is_set(c.inactive_enter_usec) &&
1328 timestamp_is_set(c.inactive_exit_usec) &&
1329 c.inactive_enter_usec > c.inactive_exit_usec)
1330 log_info("Service runtime: %s",
1331 FORMAT_TIMESPAN(c.inactive_enter_usec - c.inactive_exit_usec, USEC_PER_MSEC));
1332
1333 if (c.cpu_usage_nsec != NSEC_INFINITY)
1334 log_info("CPU time consumed: %s",
1335 FORMAT_TIMESPAN(DIV_ROUND_UP(c.cpu_usage_nsec, NSEC_PER_USEC), USEC_PER_MSEC));
1336
1337 if (c.ip_ingress_bytes != UINT64_MAX)
1338 log_info("IP traffic received: %s", FORMAT_BYTES(c.ip_ingress_bytes));
1339
1340 if (c.ip_egress_bytes != UINT64_MAX)
1341 log_info("IP traffic sent: %s", FORMAT_BYTES(c.ip_egress_bytes));
1342
1343 if (c.io_read_bytes != UINT64_MAX)
1344 log_info("IO bytes read: %s", FORMAT_BYTES(c.io_read_bytes));
1345
1346 if (c.io_write_bytes != UINT64_MAX)
1347 log_info("IO bytes written: %s", FORMAT_BYTES(c.io_write_bytes));
1348 }
1349
1350 /* Try to propagate the service's return value. But if the service defines
1351 * e.g. SuccessExitStatus, honour this, and return 0 to mean "success". */
1352 if (streq_ptr(c.result, "success"))
1353 *retval = 0;
1354 else if (streq_ptr(c.result, "exit-code") && c.exit_status > 0)
1355 *retval = c.exit_status;
1356 else if (streq_ptr(c.result, "signal"))
1357 *retval = EXIT_EXCEPTION;
1358 else
1359 *retval = EXIT_FAILURE;
1360 }
1361
1362 return 0;
1363 }
1364
1365 static int acquire_invocation_id(sd_bus *bus, sd_id128_t *ret) {
1366 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1367 _cleanup_(sd_bus_message_unrefp) sd_bus_message *reply = NULL;
1368 const void *p;
1369 size_t l;
1370 int r;
1371
1372 assert(bus);
1373 assert(ret);
1374
1375 r = sd_bus_get_property(bus,
1376 "org.freedesktop.systemd1",
1377 "/org/freedesktop/systemd1/unit/self",
1378 "org.freedesktop.systemd1.Unit",
1379 "InvocationID",
1380 &error,
1381 &reply,
1382 "ay");
1383 if (r < 0)
1384 return log_error_errno(r, "Failed to request invocation ID for scope: %s", bus_error_message(&error, r));
1385
1386 r = sd_bus_message_read_array(reply, 'y', &p, &l);
1387 if (r < 0)
1388 return bus_log_parse_error(r);
1389
1390 if (l != sizeof(sd_id128_t))
1391 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "Invalid UUID size, %zu != %zu.", l, sizeof(sd_id128_t));
1392
1393 memcpy(ret, p, l);
1394 return 0;
1395 }
1396
1397 static int start_transient_scope(sd_bus *bus) {
1398 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1399 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1400 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1401 _cleanup_strv_free_ char **env = NULL, **user_env = NULL;
1402 _cleanup_free_ char *scope = NULL;
1403 const char *object = NULL;
1404 sd_id128_t invocation_id;
1405 int r;
1406
1407 assert(bus);
1408 assert(!strv_isempty(arg_cmdline));
1409
1410 r = bus_wait_for_jobs_new(bus, &w);
1411 if (r < 0)
1412 return log_oom();
1413
1414 if (arg_unit) {
1415 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1416 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1417 ".scope", &scope);
1418 if (r < 0)
1419 return log_error_errno(r, "Failed to mangle scope name: %m");
1420 } else {
1421 r = make_unit_name(bus, UNIT_SCOPE, &scope);
1422 if (r < 0)
1423 return r;
1424 }
1425
1426 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1427 if (r < 0)
1428 return bus_log_create_error(r);
1429
1430 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1431 if (r < 0)
1432 return bus_log_create_error(r);
1433
1434 /* Name and Mode */
1435 r = sd_bus_message_append(m, "ss", scope, "fail");
1436 if (r < 0)
1437 return bus_log_create_error(r);
1438
1439 /* Properties */
1440 r = sd_bus_message_open_container(m, 'a', "(sv)");
1441 if (r < 0)
1442 return bus_log_create_error(r);
1443
1444 r = transient_scope_set_properties(m);
1445 if (r < 0)
1446 return r;
1447
1448 r = sd_bus_message_close_container(m);
1449 if (r < 0)
1450 return bus_log_create_error(r);
1451
1452 /* Auxiliary units */
1453 r = sd_bus_message_append(m, "a(sa(sv))", 0);
1454 if (r < 0)
1455 return bus_log_create_error(r);
1456
1457 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1458
1459 r = sd_bus_call(bus, m, 0, &error, &reply);
1460 if (r < 0)
1461 return log_error_errno(r, "Failed to start transient scope unit: %s", bus_error_message(&error, r));
1462
1463 r = sd_bus_message_read(reply, "o", &object);
1464 if (r < 0)
1465 return bus_log_parse_error(r);
1466
1467 r = bus_wait_for_jobs_one(w, object, arg_quiet, arg_user ? STRV_MAKE_CONST("--user") : NULL);
1468 if (r < 0)
1469 return r;
1470
1471 r = acquire_invocation_id(bus, &invocation_id);
1472 if (r < 0)
1473 return r;
1474
1475 r = strv_extendf(&user_env, "INVOCATION_ID=" SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL(invocation_id));
1476 if (r < 0)
1477 return log_oom();
1478
1479 if (arg_nice_set) {
1480 if (setpriority(PRIO_PROCESS, 0, arg_nice) < 0)
1481 return log_error_errno(errno, "Failed to set nice level: %m");
1482 }
1483
1484 if (arg_exec_group) {
1485 gid_t gid;
1486
1487 r = get_group_creds(&arg_exec_group, &gid, 0);
1488 if (r < 0)
1489 return log_error_errno(r, "Failed to resolve group %s: %m", arg_exec_group);
1490
1491 if (setresgid(gid, gid, gid) < 0)
1492 return log_error_errno(errno, "Failed to change GID to " GID_FMT ": %m", gid);
1493 }
1494
1495 if (arg_exec_user) {
1496 const char *home, *shell;
1497 uid_t uid;
1498 gid_t gid;
1499
1500 r = get_user_creds(&arg_exec_user, &uid, &gid, &home, &shell, USER_CREDS_CLEAN|USER_CREDS_PREFER_NSS);
1501 if (r < 0)
1502 return log_error_errno(r, "Failed to resolve user %s: %m", arg_exec_user);
1503
1504 if (home) {
1505 r = strv_extendf(&user_env, "HOME=%s", home);
1506 if (r < 0)
1507 return log_oom();
1508 }
1509
1510 if (shell) {
1511 r = strv_extendf(&user_env, "SHELL=%s", shell);
1512 if (r < 0)
1513 return log_oom();
1514 }
1515
1516 r = strv_extendf(&user_env, "USER=%s", arg_exec_user);
1517 if (r < 0)
1518 return log_oom();
1519
1520 r = strv_extendf(&user_env, "LOGNAME=%s", arg_exec_user);
1521 if (r < 0)
1522 return log_oom();
1523
1524 if (!arg_exec_group) {
1525 if (setresgid(gid, gid, gid) < 0)
1526 return log_error_errno(errno, "Failed to change GID to " GID_FMT ": %m", gid);
1527 }
1528
1529 if (setresuid(uid, uid, uid) < 0)
1530 return log_error_errno(errno, "Failed to change UID to " UID_FMT ": %m", uid);
1531 }
1532
1533 env = strv_env_merge(environ, user_env, arg_environment);
1534 if (!env)
1535 return log_oom();
1536
1537 if (!arg_quiet)
1538 log_info("Running scope as unit: %s", scope);
1539
1540 execvpe(arg_cmdline[0], arg_cmdline, env);
1541
1542 return log_error_errno(errno, "Failed to execute: %m");
1543 }
1544
1545 static int start_transient_trigger(
1546 sd_bus *bus,
1547 const char *suffix) {
1548
1549 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1550 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1551 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1552 _cleanup_free_ char *trigger = NULL, *service = NULL;
1553 const char *object = NULL;
1554 int r;
1555
1556 assert(bus);
1557
1558 r = bus_wait_for_jobs_new(bus, &w);
1559 if (r < 0)
1560 return log_oom();
1561
1562 if (arg_unit) {
1563 switch (unit_name_to_type(arg_unit)) {
1564
1565 case UNIT_SERVICE:
1566 service = strdup(arg_unit);
1567 if (!service)
1568 return log_oom();
1569
1570 r = unit_name_change_suffix(service, suffix, &trigger);
1571 if (r < 0)
1572 return log_error_errno(r, "Failed to change unit suffix: %m");
1573 break;
1574
1575 case UNIT_TIMER:
1576 trigger = strdup(arg_unit);
1577 if (!trigger)
1578 return log_oom();
1579
1580 r = unit_name_change_suffix(trigger, ".service", &service);
1581 if (r < 0)
1582 return log_error_errno(r, "Failed to change unit suffix: %m");
1583 break;
1584
1585 default:
1586 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1587 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1588 ".service", &service);
1589 if (r < 0)
1590 return log_error_errno(r, "Failed to mangle unit name: %m");
1591
1592 r = unit_name_mangle_with_suffix(arg_unit, "as trigger",
1593 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1594 suffix, &trigger);
1595 if (r < 0)
1596 return log_error_errno(r, "Failed to mangle unit name: %m");
1597
1598 break;
1599 }
1600 } else {
1601 r = make_unit_name(bus, UNIT_SERVICE, &service);
1602 if (r < 0)
1603 return r;
1604
1605 r = unit_name_change_suffix(service, suffix, &trigger);
1606 if (r < 0)
1607 return log_error_errno(r, "Failed to change unit suffix: %m");
1608 }
1609
1610 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1611 if (r < 0)
1612 return bus_log_create_error(r);
1613
1614 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1615 if (r < 0)
1616 return bus_log_create_error(r);
1617
1618 /* Name and Mode */
1619 r = sd_bus_message_append(m, "ss", trigger, "fail");
1620 if (r < 0)
1621 return bus_log_create_error(r);
1622
1623 /* Properties */
1624 r = sd_bus_message_open_container(m, 'a', "(sv)");
1625 if (r < 0)
1626 return bus_log_create_error(r);
1627
1628 if (streq(suffix, ".path"))
1629 r = transient_unit_set_properties(m, UNIT_PATH, arg_path_property);
1630 else if (streq(suffix, ".socket"))
1631 r = transient_unit_set_properties(m, UNIT_SOCKET, arg_socket_property);
1632 else if (streq(suffix, ".timer"))
1633 r = transient_timer_set_properties(m);
1634 else
1635 assert_not_reached();
1636 if (r < 0)
1637 return r;
1638
1639 r = sd_bus_message_close_container(m);
1640 if (r < 0)
1641 return bus_log_create_error(r);
1642
1643 r = sd_bus_message_open_container(m, 'a', "(sa(sv))");
1644 if (r < 0)
1645 return bus_log_create_error(r);
1646
1647 if (!strv_isempty(arg_cmdline)) {
1648 r = sd_bus_message_open_container(m, 'r', "sa(sv)");
1649 if (r < 0)
1650 return bus_log_create_error(r);
1651
1652 r = sd_bus_message_append(m, "s", service);
1653 if (r < 0)
1654 return bus_log_create_error(r);
1655
1656 r = sd_bus_message_open_container(m, 'a', "(sv)");
1657 if (r < 0)
1658 return bus_log_create_error(r);
1659
1660 r = transient_service_set_properties(m, NULL);
1661 if (r < 0)
1662 return r;
1663
1664 r = sd_bus_message_close_container(m);
1665 if (r < 0)
1666 return bus_log_create_error(r);
1667
1668 r = sd_bus_message_close_container(m);
1669 if (r < 0)
1670 return bus_log_create_error(r);
1671 }
1672
1673 r = sd_bus_message_close_container(m);
1674 if (r < 0)
1675 return bus_log_create_error(r);
1676
1677 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1678
1679 r = sd_bus_call(bus, m, 0, &error, &reply);
1680 if (r < 0)
1681 return log_error_errno(r, "Failed to start transient %s unit: %s", suffix + 1, bus_error_message(&error, r));
1682
1683 r = sd_bus_message_read(reply, "o", &object);
1684 if (r < 0)
1685 return bus_log_parse_error(r);
1686
1687 r = bus_wait_for_jobs_one(w, object, arg_quiet, arg_user ? STRV_MAKE_CONST("--user") : NULL);
1688 if (r < 0)
1689 return r;
1690
1691 if (!arg_quiet) {
1692 log_info("Running %s as unit: %s", suffix + 1, trigger);
1693 if (!strv_isempty(arg_cmdline))
1694 log_info("Will run service as unit: %s", service);
1695 }
1696
1697 return 0;
1698 }
1699
1700 static bool shall_make_executable_absolute(void) {
1701 if (strv_isempty(arg_cmdline))
1702 return false;
1703 if (arg_transport != BUS_TRANSPORT_LOCAL)
1704 return false;
1705
1706 FOREACH_STRING(f, "RootDirectory=", "RootImage=", "ExecSearchPath=", "MountImages=", "ExtensionImages=")
1707 if (strv_find_startswith(arg_property, f))
1708 return false;
1709
1710 return true;
1711 }
1712
1713 static int run(int argc, char* argv[]) {
1714 _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL;
1715 _cleanup_free_ char *description = NULL;
1716 int r, retval = EXIT_SUCCESS;
1717
1718 log_show_color(true);
1719 log_parse_environment();
1720 log_open();
1721
1722 r = parse_argv(argc, argv);
1723 if (r <= 0)
1724 return r;
1725
1726 if (shall_make_executable_absolute()) {
1727 /* Patch in an absolute path to fail early for user convenience, but only when we can do it
1728 * (i.e. we will be running from the same file system). This also uses the user's $PATH,
1729 * while we use a fixed search path in the manager. */
1730
1731 _cleanup_free_ char *command = NULL;
1732 r = find_executable(arg_cmdline[0], &command);
1733 if (r < 0)
1734 return log_error_errno(r, "Failed to find executable %s: %m", arg_cmdline[0]);
1735
1736 free_and_replace(arg_cmdline[0], command);
1737 }
1738
1739 if (!arg_description) {
1740 description = strv_join(arg_cmdline, " ");
1741 if (!description)
1742 return log_oom();
1743
1744 if (arg_unit && isempty(description)) {
1745 r = free_and_strdup(&description, arg_unit);
1746 if (r < 0)
1747 return log_oom();
1748 }
1749
1750 arg_description = description;
1751 }
1752
1753 /* If --wait is used connect via the bus, unconditionally, as ref/unref is not supported via the limited direct
1754 * connection */
1755 if (arg_wait || arg_stdio != ARG_STDIO_NONE || (arg_user && arg_transport != BUS_TRANSPORT_LOCAL))
1756 r = bus_connect_transport(arg_transport, arg_host, arg_user, &bus);
1757 else
1758 r = bus_connect_transport_systemd(arg_transport, arg_host, arg_user, &bus);
1759 if (r < 0)
1760 return bus_log_connect_error(r, arg_transport);
1761
1762 if (arg_scope)
1763 r = start_transient_scope(bus);
1764 else if (arg_path_property)
1765 r = start_transient_trigger(bus, ".path");
1766 else if (arg_socket_property)
1767 r = start_transient_trigger(bus, ".socket");
1768 else if (arg_with_timer)
1769 r = start_transient_trigger(bus, ".timer");
1770 else
1771 r = start_transient_service(bus, &retval);
1772 if (r < 0)
1773 return r;
1774
1775 return retval;
1776 }
1777
1778 DEFINE_MAIN_FUNCTION_WITH_POSITIVE_FAILURE(run);