]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/run/run.c
projects / thirdparty / systemd.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
Merge pull request #20303 from andir/sysconfig-example
[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 with_trigger = !!arg_path_property || !!arg_socket_property || arg_with_timer;
511
512 /* currently, only single trigger (path, socket, timer) unit can be created simultaneously */
513 if ((int) !!arg_path_property + (int) !!arg_socket_property + (int) arg_with_timer > 1)
514 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
515 "Only single trigger (path, socket, timer) unit can be created.");
516
517 if (arg_shell) {
518 /* If --shell is imply --pty --pipe --same-dir --service-type=exec --wait --collect, unless otherwise
519 * specified. */
520
521 if (!arg_scope) {
522 if (arg_stdio == ARG_STDIO_NONE)
523 arg_stdio = ARG_STDIO_AUTO;
524
525 if (!arg_working_directory) {
526 r = safe_getcwd(&arg_working_directory);
527 if (r < 0)
528 return log_error_errno(r, "Failed to get current working directory: %m");
529 }
530
531 if (!arg_service_type) {
532 arg_service_type = strdup("exec");
533 if (!arg_service_type)
534 return log_oom();
535 }
536
537 arg_wait = true;
538 }
539
540 arg_aggressive_gc = true;
541 }
542
543 if (arg_stdio == ARG_STDIO_AUTO)
544 /* If we both --pty and --pipe are specified we'll automatically pick --pty if we are connected fully
545 * to a TTY and pick direct fd passing otherwise. This way, we automatically adapt to usage in a shell
546 * pipeline, but we are neatly interactive with tty-level isolation otherwise. */
547 arg_stdio = isatty(STDIN_FILENO) && isatty(STDOUT_FILENO) && isatty(STDERR_FILENO) ?
548 ARG_STDIO_PTY :
549 ARG_STDIO_DIRECT;
550
551 if (argc > optind) {
552 char **l;
553
554 if (arg_shell)
555 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "If --shell is used, no command line is expected.");
556
557 l = strv_copy(argv + optind);
558 if (!l)
559 return log_oom();
560
561 strv_free_and_replace(arg_cmdline, l);
562
563 } else if (arg_shell) {
564 _cleanup_free_ char *s = NULL;
565 char **l;
566
567 r = get_shell(&s);
568 if (r < 0)
569 return log_error_errno(r, "Failed to determine shell: %m");
570
571 l = strv_new(s);
572 if (!l)
573 return log_oom();
574
575 strv_free_and_replace(arg_cmdline, l);
576
577 } else if (!arg_unit || !with_trigger)
578 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "Command line to execute required.");
579
580 if (arg_user && arg_transport == BUS_TRANSPORT_REMOTE)
581 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
582 "Execution in user context is not supported on remote systems.");
583
584 if (arg_scope && arg_transport == BUS_TRANSPORT_REMOTE)
585 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
586 "Scope execution is not supported on remote systems.");
587
588 if (arg_scope && (arg_remain_after_exit || arg_service_type))
589 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
590 "--remain-after-exit and --service-type= are not supported in --scope mode.");
591
592 if (arg_stdio != ARG_STDIO_NONE && (with_trigger || arg_scope))
593 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
594 "--pty/--pipe is not compatible in timer or --scope mode.");
595
596 if (arg_stdio != ARG_STDIO_NONE && arg_transport == BUS_TRANSPORT_REMOTE)
597 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
598 "--pty/--pipe is only supported when connecting to the local system or containers.");
599
600 if (arg_stdio != ARG_STDIO_NONE && arg_no_block)
601 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
602 "--pty/--pipe is not compatible with --no-block.");
603
604 if (arg_scope && with_trigger)
605 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
606 "Path, socket or timer options are not supported in --scope mode.");
607
608 if (arg_timer_property && !arg_with_timer)
609 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
610 "--timer-property= has no effect without any other timer options.");
611
612 if (arg_wait) {
613 if (arg_no_block)
614 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
615 "--wait may not be combined with --no-block.");
616
617 if (with_trigger)
618 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
619 "--wait may not be combined with path, socket or timer operations.");
620
621 if (arg_scope)
622 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
623 "--wait may not be combined with --scope.");
624 }
625
626 return 1;
627 }
628
629 static int transient_unit_set_properties(sd_bus_message *m, UnitType t, char **properties) {
630 int r;
631
632 r = sd_bus_message_append(m, "(sv)", "Description", "s", arg_description);
633 if (r < 0)
634 return bus_log_create_error(r);
635
636 if (arg_aggressive_gc) {
637 r = sd_bus_message_append(m, "(sv)", "CollectMode", "s", "inactive-or-failed");
638 if (r < 0)
639 return bus_log_create_error(r);
640 }
641
642 r = bus_append_unit_property_assignment_many(m, t, properties);
643 if (r < 0)
644 return r;
645
646 return 0;
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 char *n;
794
795 n = strjoina("TERM=", e);
796 r = sd_bus_message_append(m,
797 "(sv)",
798 "Environment", "as", 1, n);
799 if (r < 0)
800 return bus_log_create_error(r);
801 }
802 }
803
804 if (!strv_isempty(arg_environment)) {
805 r = sd_bus_message_open_container(m, 'r', "sv");
806 if (r < 0)
807 return bus_log_create_error(r);
808
809 r = sd_bus_message_append(m, "s", "Environment");
810 if (r < 0)
811 return bus_log_create_error(r);
812
813 r = sd_bus_message_open_container(m, 'v', "as");
814 if (r < 0)
815 return bus_log_create_error(r);
816
817 r = sd_bus_message_append_strv(m, arg_environment);
818 if (r < 0)
819 return bus_log_create_error(r);
820
821 r = sd_bus_message_close_container(m);
822 if (r < 0)
823 return bus_log_create_error(r);
824
825 r = sd_bus_message_close_container(m);
826 if (r < 0)
827 return bus_log_create_error(r);
828 }
829
830 /* Exec container */
831 if (!strv_isempty(arg_cmdline)) {
832 r = sd_bus_message_open_container(m, 'r', "sv");
833 if (r < 0)
834 return bus_log_create_error(r);
835
836 r = sd_bus_message_append(m, "s", "ExecStart");
837 if (r < 0)
838 return bus_log_create_error(r);
839
840 r = sd_bus_message_open_container(m, 'v', "a(sasb)");
841 if (r < 0)
842 return bus_log_create_error(r);
843
844 r = sd_bus_message_open_container(m, 'a', "(sasb)");
845 if (r < 0)
846 return bus_log_create_error(r);
847
848 r = sd_bus_message_open_container(m, 'r', "sasb");
849 if (r < 0)
850 return bus_log_create_error(r);
851
852 r = sd_bus_message_append(m, "s", arg_cmdline[0]);
853 if (r < 0)
854 return bus_log_create_error(r);
855
856 r = sd_bus_message_append_strv(m, arg_cmdline);
857 if (r < 0)
858 return bus_log_create_error(r);
859
860 r = sd_bus_message_append(m, "b", false);
861 if (r < 0)
862 return bus_log_create_error(r);
863
864 r = sd_bus_message_close_container(m);
865 if (r < 0)
866 return bus_log_create_error(r);
867
868 r = sd_bus_message_close_container(m);
869 if (r < 0)
870 return bus_log_create_error(r);
871
872 r = sd_bus_message_close_container(m);
873 if (r < 0)
874 return bus_log_create_error(r);
875
876 r = sd_bus_message_close_container(m);
877 if (r < 0)
878 return bus_log_create_error(r);
879 }
880
881 return 0;
882 }
883
884 static int transient_scope_set_properties(sd_bus_message *m) {
885 int r;
886
887 assert(m);
888
889 r = transient_unit_set_properties(m, UNIT_SCOPE, arg_property);
890 if (r < 0)
891 return r;
892
893 r = transient_kill_set_properties(m);
894 if (r < 0)
895 return r;
896
897 r = transient_cgroup_set_properties(m);
898 if (r < 0)
899 return r;
900
901 r = sd_bus_message_append(m, "(sv)", "PIDs", "au", 1, (uint32_t) getpid_cached());
902 if (r < 0)
903 return bus_log_create_error(r);
904
905 return 0;
906 }
907
908 static int transient_timer_set_properties(sd_bus_message *m) {
909 int r;
910
911 assert(m);
912
913 r = transient_unit_set_properties(m, UNIT_TIMER, arg_timer_property);
914 if (r < 0)
915 return r;
916
917 /* Automatically clean up our transient timers */
918 r = sd_bus_message_append(m, "(sv)", "RemainAfterElapse", "b", false);
919 if (r < 0)
920 return bus_log_create_error(r);
921
922 return 0;
923 }
924
925 static int make_unit_name(sd_bus *bus, UnitType t, char **ret) {
926 const char *unique, *id;
927 char *p;
928 int r;
929
930 assert(bus);
931 assert(t >= 0);
932 assert(t < _UNIT_TYPE_MAX);
933
934 r = sd_bus_get_unique_name(bus, &unique);
935 if (r < 0) {
936 sd_id128_t rnd;
937
938 /* We couldn't get the unique name, which is a pretty
939 * common case if we are connected to systemd
940 * directly. In that case, just pick a random uuid as
941 * name */
942
943 r = sd_id128_randomize(&rnd);
944 if (r < 0)
945 return log_error_errno(r, "Failed to generate random run unit name: %m");
946
947 if (asprintf(ret, "run-r" SD_ID128_FORMAT_STR ".%s", SD_ID128_FORMAT_VAL(rnd), unit_type_to_string(t)) < 0)
948 return log_oom();
949
950 return 0;
951 }
952
953 /* We managed to get the unique name, then let's use that to name our transient units. */
954
955 id = startswith(unique, ":1."); /* let' strip the usual prefix */
956 if (!id)
957 id = startswith(unique, ":"); /* the spec only requires things to start with a colon, hence
958 * let's add a generic fallback for that. */
959 if (!id)
960 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
961 "Unique name %s has unexpected format.",
962 unique);
963
964 p = strjoin("run-u", id, ".", unit_type_to_string(t));
965 if (!p)
966 return log_oom();
967
968 *ret = p;
969 return 0;
970 }
971
972 typedef struct RunContext {
973 sd_bus *bus;
974 sd_event *event;
975 PTYForward *forward;
976 sd_bus_slot *match;
977
978 /* Current state of the unit */
979 char *active_state;
980 bool has_job;
981
982 /* The exit data of the unit */
983 uint64_t inactive_exit_usec;
984 uint64_t inactive_enter_usec;
985 char *result;
986 uint64_t cpu_usage_nsec;
987 uint64_t ip_ingress_bytes;
988 uint64_t ip_egress_bytes;
989 uint64_t io_read_bytes;
990 uint64_t io_write_bytes;
991 uint32_t exit_code;
992 uint32_t exit_status;
993 } RunContext;
994
995 static void run_context_free(RunContext *c) {
996 assert(c);
997
998 c->forward = pty_forward_free(c->forward);
999 c->match = sd_bus_slot_unref(c->match);
1000 c->bus = sd_bus_unref(c->bus);
1001 c->event = sd_event_unref(c->event);
1002
1003 free(c->active_state);
1004 free(c->result);
1005 }
1006
1007 static void run_context_check_done(RunContext *c) {
1008 bool done;
1009
1010 assert(c);
1011
1012 if (c->match)
1013 done = STRPTR_IN_SET(c->active_state, "inactive", "failed") && !c->has_job;
1014 else
1015 done = true;
1016
1017 if (c->forward && done) /* If the service is gone, it's time to drain the output */
1018 done = pty_forward_drain(c->forward);
1019
1020 if (done)
1021 sd_event_exit(c->event, EXIT_SUCCESS);
1022 }
1023
1024 static int map_job(sd_bus *bus, const char *member, sd_bus_message *m, sd_bus_error *error, void *userdata) {
1025 bool *b = userdata;
1026 const char *job;
1027 uint32_t id;
1028 int r;
1029
1030 r = sd_bus_message_read(m, "(uo)", &id, &job);
1031 if (r < 0)
1032 return r;
1033
1034 *b = id != 0 || !streq(job, "/");
1035 return 0;
1036 }
1037
1038 static int run_context_update(RunContext *c, const char *path) {
1039
1040 static const struct bus_properties_map map[] = {
1041 { "ActiveState", "s", NULL, offsetof(RunContext, active_state) },
1042 { "InactiveExitTimestampMonotonic", "t", NULL, offsetof(RunContext, inactive_exit_usec) },
1043 { "InactiveEnterTimestampMonotonic", "t", NULL, offsetof(RunContext, inactive_enter_usec) },
1044 { "Result", "s", NULL, offsetof(RunContext, result) },
1045 { "ExecMainCode", "i", NULL, offsetof(RunContext, exit_code) },
1046 { "ExecMainStatus", "i", NULL, offsetof(RunContext, exit_status) },
1047 { "CPUUsageNSec", "t", NULL, offsetof(RunContext, cpu_usage_nsec) },
1048 { "IPIngressBytes", "t", NULL, offsetof(RunContext, ip_ingress_bytes) },
1049 { "IPEgressBytes", "t", NULL, offsetof(RunContext, ip_egress_bytes) },
1050 { "IOReadBytes", "t", NULL, offsetof(RunContext, io_read_bytes) },
1051 { "IOWriteBytes", "t", NULL, offsetof(RunContext, io_write_bytes) },
1052 { "Job", "(uo)", map_job, offsetof(RunContext, has_job) },
1053 {}
1054 };
1055
1056 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1057 int r;
1058
1059 r = bus_map_all_properties(c->bus,
1060 "org.freedesktop.systemd1",
1061 path,
1062 map,
1063 BUS_MAP_STRDUP,
1064 &error,
1065 NULL,
1066 c);
1067 if (r < 0) {
1068 sd_event_exit(c->event, EXIT_FAILURE);
1069 return log_error_errno(r, "Failed to query unit state: %s", bus_error_message(&error, r));
1070 }
1071
1072 run_context_check_done(c);
1073 return 0;
1074 }
1075
1076 static int on_properties_changed(sd_bus_message *m, void *userdata, sd_bus_error *error) {
1077 RunContext *c = userdata;
1078
1079 assert(m);
1080 assert(c);
1081
1082 return run_context_update(c, sd_bus_message_get_path(m));
1083 }
1084
1085 static int pty_forward_handler(PTYForward *f, int rcode, void *userdata) {
1086 RunContext *c = userdata;
1087
1088 assert(f);
1089
1090 if (rcode < 0) {
1091 sd_event_exit(c->event, EXIT_FAILURE);
1092 return log_error_errno(rcode, "Error on PTY forwarding logic: %m");
1093 }
1094
1095 run_context_check_done(c);
1096 return 0;
1097 }
1098
1099 static int start_transient_service(
1100 sd_bus *bus,
1101 int *retval) {
1102
1103 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1104 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1105 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1106 _cleanup_free_ char *service = NULL, *pty_path = NULL;
1107 _cleanup_close_ int master = -1;
1108 int r;
1109
1110 assert(bus);
1111 assert(retval);
1112
1113 if (arg_stdio == ARG_STDIO_PTY) {
1114
1115 if (arg_transport == BUS_TRANSPORT_LOCAL) {
1116 master = posix_openpt(O_RDWR|O_NOCTTY|O_CLOEXEC|O_NONBLOCK);
1117 if (master < 0)
1118 return log_error_errno(errno, "Failed to acquire pseudo tty: %m");
1119
1120 r = ptsname_malloc(master, &pty_path);
1121 if (r < 0)
1122 return log_error_errno(r, "Failed to determine tty name: %m");
1123
1124 if (unlockpt(master) < 0)
1125 return log_error_errno(errno, "Failed to unlock tty: %m");
1126
1127 } else if (arg_transport == BUS_TRANSPORT_MACHINE) {
1128 _cleanup_(sd_bus_unrefp) sd_bus *system_bus = NULL;
1129 _cleanup_(sd_bus_message_unrefp) sd_bus_message *pty_reply = NULL;
1130 const char *s;
1131
1132 r = sd_bus_default_system(&system_bus);
1133 if (r < 0)
1134 return log_error_errno(r, "Failed to connect to system bus: %m");
1135
1136 r = sd_bus_call_method(system_bus,
1137 "org.freedesktop.machine1",
1138 "/org/freedesktop/machine1",
1139 "org.freedesktop.machine1.Manager",
1140 "OpenMachinePTY",
1141 &error,
1142 &pty_reply,
1143 "s", arg_host);
1144 if (r < 0)
1145 return log_error_errno(r, "Failed to get machine PTY: %s", bus_error_message(&error, r));
1146
1147 r = sd_bus_message_read(pty_reply, "hs", &master, &s);
1148 if (r < 0)
1149 return bus_log_parse_error(r);
1150
1151 master = fcntl(master, F_DUPFD_CLOEXEC, 3);
1152 if (master < 0)
1153 return log_error_errno(errno, "Failed to duplicate master fd: %m");
1154
1155 pty_path = strdup(s);
1156 if (!pty_path)
1157 return log_oom();
1158 } else
1159 assert_not_reached();
1160 }
1161
1162 /* Optionally, wait for the start job to complete. If we are supposed to read the service's stdin
1163 * lets skip this however, because we should start that already when the start job is running, and
1164 * there's little point in waiting for the start job to complete in that case anyway, as we'll wait
1165 * for EOF anyway, which is going to be much later. */
1166 if (!arg_no_block && arg_stdio == ARG_STDIO_NONE) {
1167 r = bus_wait_for_jobs_new(bus, &w);
1168 if (r < 0)
1169 return log_error_errno(r, "Could not watch jobs: %m");
1170 }
1171
1172 if (arg_unit) {
1173 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1174 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1175 ".service", &service);
1176 if (r < 0)
1177 return log_error_errno(r, "Failed to mangle unit name: %m");
1178 } else {
1179 r = make_unit_name(bus, UNIT_SERVICE, &service);
1180 if (r < 0)
1181 return r;
1182 }
1183
1184 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1185 if (r < 0)
1186 return bus_log_create_error(r);
1187
1188 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1189 if (r < 0)
1190 return bus_log_create_error(r);
1191
1192 /* Name and mode */
1193 r = sd_bus_message_append(m, "ss", service, "fail");
1194 if (r < 0)
1195 return bus_log_create_error(r);
1196
1197 /* Properties */
1198 r = sd_bus_message_open_container(m, 'a', "(sv)");
1199 if (r < 0)
1200 return bus_log_create_error(r);
1201
1202 r = transient_service_set_properties(m, pty_path);
1203 if (r < 0)
1204 return r;
1205
1206 r = sd_bus_message_close_container(m);
1207 if (r < 0)
1208 return bus_log_create_error(r);
1209
1210 /* Auxiliary units */
1211 r = sd_bus_message_append(m, "a(sa(sv))", 0);
1212 if (r < 0)
1213 return bus_log_create_error(r);
1214
1215 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1216
1217 r = sd_bus_call(bus, m, 0, &error, &reply);
1218 if (r < 0)
1219 return log_error_errno(r, "Failed to start transient service unit: %s", bus_error_message(&error, r));
1220
1221 if (w) {
1222 const char *object;
1223
1224 r = sd_bus_message_read(reply, "o", &object);
1225 if (r < 0)
1226 return bus_log_parse_error(r);
1227
1228 r = bus_wait_for_jobs_one(w, object, arg_quiet);
1229 if (r < 0)
1230 return r;
1231 }
1232
1233 if (!arg_quiet)
1234 log_info("Running as unit: %s", service);
1235
1236 if (arg_wait || arg_stdio != ARG_STDIO_NONE) {
1237 _cleanup_(run_context_free) RunContext c = {
1238 .cpu_usage_nsec = NSEC_INFINITY,
1239 .ip_ingress_bytes = UINT64_MAX,
1240 .ip_egress_bytes = UINT64_MAX,
1241 .io_read_bytes = UINT64_MAX,
1242 .io_write_bytes = UINT64_MAX,
1243 .inactive_exit_usec = USEC_INFINITY,
1244 .inactive_enter_usec = USEC_INFINITY,
1245 };
1246 _cleanup_free_ char *path = NULL;
1247
1248 c.bus = sd_bus_ref(bus);
1249
1250 r = sd_event_default(&c.event);
1251 if (r < 0)
1252 return log_error_errno(r, "Failed to get event loop: %m");
1253
1254 if (master >= 0) {
1255 assert_se(sigprocmask_many(SIG_BLOCK, NULL, SIGWINCH, SIGTERM, SIGINT, -1) >= 0);
1256 (void) sd_event_add_signal(c.event, NULL, SIGINT, NULL, NULL);
1257 (void) sd_event_add_signal(c.event, NULL, SIGTERM, NULL, NULL);
1258
1259 if (!arg_quiet)
1260 log_info("Press ^] three times within 1s to disconnect TTY.");
1261
1262 r = pty_forward_new(c.event, master, PTY_FORWARD_IGNORE_INITIAL_VHANGUP, &c.forward);
1263 if (r < 0)
1264 return log_error_errno(r, "Failed to create PTY forwarder: %m");
1265
1266 pty_forward_set_handler(c.forward, pty_forward_handler, &c);
1267
1268 /* Make sure to process any TTY events before we process bus events */
1269 (void) pty_forward_set_priority(c.forward, SD_EVENT_PRIORITY_IMPORTANT);
1270 }
1271
1272 path = unit_dbus_path_from_name(service);
1273 if (!path)
1274 return log_oom();
1275
1276 r = sd_bus_match_signal_async(
1277 bus,
1278 &c.match,
1279 "org.freedesktop.systemd1",
1280 path,
1281 "org.freedesktop.DBus.Properties",
1282 "PropertiesChanged",
1283 on_properties_changed, NULL, &c);
1284 if (r < 0)
1285 return log_error_errno(r, "Failed to request properties changed signal match: %m");
1286
1287 r = sd_bus_attach_event(bus, c.event, SD_EVENT_PRIORITY_NORMAL);
1288 if (r < 0)
1289 return log_error_errno(r, "Failed to attach bus to event loop: %m");
1290
1291 r = run_context_update(&c, path);
1292 if (r < 0)
1293 return r;
1294
1295 r = sd_event_loop(c.event);
1296 if (r < 0)
1297 return log_error_errno(r, "Failed to run event loop: %m");
1298
1299 if (c.forward) {
1300 char last_char = 0;
1301
1302 r = pty_forward_get_last_char(c.forward, &last_char);
1303 if (r >= 0 && !arg_quiet && last_char != '\n')
1304 fputc('\n', stdout);
1305 }
1306
1307 if (arg_wait && !arg_quiet) {
1308
1309 /* Explicitly destroy the PTY forwarder, so that the PTY device is usable again, with its
1310 * original settings (i.e. proper line breaks), so that we can show the summary in a pretty
1311 * way. */
1312 c.forward = pty_forward_free(c.forward);
1313
1314 if (!isempty(c.result))
1315 log_info("Finished with result: %s", strna(c.result));
1316
1317 if (c.exit_code == CLD_EXITED)
1318 log_info("Main processes terminated with: code=%s/status=%i",
1319 sigchld_code_to_string(c.exit_code), c.exit_status);
1320 else if (c.exit_code > 0)
1321 log_info("Main processes terminated with: code=%s/status=%s",
1322 sigchld_code_to_string(c.exit_code), signal_to_string(c.exit_status));
1323
1324 if (timestamp_is_set(c.inactive_enter_usec) &&
1325 timestamp_is_set(c.inactive_exit_usec) &&
1326 c.inactive_enter_usec > c.inactive_exit_usec)
1327 log_info("Service runtime: %s",
1328 FORMAT_TIMESPAN(c.inactive_enter_usec - c.inactive_exit_usec, USEC_PER_MSEC));
1329
1330 if (c.cpu_usage_nsec != NSEC_INFINITY)
1331 log_info("CPU time consumed: %s",
1332 FORMAT_TIMESPAN(DIV_ROUND_UP(c.cpu_usage_nsec, NSEC_PER_USEC), USEC_PER_MSEC));
1333
1334 if (c.ip_ingress_bytes != UINT64_MAX)
1335 log_info("IP traffic received: %s", FORMAT_BYTES(c.ip_ingress_bytes));
1336
1337 if (c.ip_egress_bytes != UINT64_MAX)
1338 log_info("IP traffic sent: %s", FORMAT_BYTES(c.ip_egress_bytes));
1339
1340 if (c.io_read_bytes != UINT64_MAX)
1341 log_info("IO bytes read: %s", FORMAT_BYTES(c.io_read_bytes));
1342
1343 if (c.io_write_bytes != UINT64_MAX)
1344 log_info("IO bytes written: %s", FORMAT_BYTES(c.io_write_bytes));
1345 }
1346
1347 /* Try to propagate the service's return value. But if the service defines
1348 * e.g. SuccessExitStatus, honour this, and return 0 to mean "success". */
1349 if (streq_ptr(c.result, "success"))
1350 *retval = 0;
1351 else if (streq_ptr(c.result, "exit-code") && c.exit_status > 0)
1352 *retval = c.exit_status;
1353 else if (streq_ptr(c.result, "signal"))
1354 *retval = EXIT_EXCEPTION;
1355 else
1356 *retval = EXIT_FAILURE;
1357 }
1358
1359 return 0;
1360 }
1361
1362 static int acquire_invocation_id(sd_bus *bus, sd_id128_t *ret) {
1363 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1364 _cleanup_(sd_bus_message_unrefp) sd_bus_message *reply = NULL;
1365 const void *p;
1366 size_t l;
1367 int r;
1368
1369 assert(bus);
1370 assert(ret);
1371
1372 r = sd_bus_get_property(bus,
1373 "org.freedesktop.systemd1",
1374 "/org/freedesktop/systemd1/unit/self",
1375 "org.freedesktop.systemd1.Unit",
1376 "InvocationID",
1377 &error,
1378 &reply,
1379 "ay");
1380 if (r < 0)
1381 return log_error_errno(r, "Failed to request invocation ID for scope: %s", bus_error_message(&error, r));
1382
1383 r = sd_bus_message_read_array(reply, 'y', &p, &l);
1384 if (r < 0)
1385 return bus_log_parse_error(r);
1386
1387 if (l != sizeof(sd_id128_t))
1388 return log_error_errno(SYNTHETIC_ERRNO(EINVAL), "Invalid UUID size, %zu != %zu.", l, sizeof(sd_id128_t));
1389
1390 memcpy(ret, p, l);
1391 return 0;
1392 }
1393
1394 static int start_transient_scope(sd_bus *bus) {
1395 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1396 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1397 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1398 _cleanup_strv_free_ char **env = NULL, **user_env = NULL;
1399 _cleanup_free_ char *scope = NULL;
1400 const char *object = NULL;
1401 sd_id128_t invocation_id;
1402 int r;
1403
1404 assert(bus);
1405 assert(!strv_isempty(arg_cmdline));
1406
1407 r = bus_wait_for_jobs_new(bus, &w);
1408 if (r < 0)
1409 return log_oom();
1410
1411 if (arg_unit) {
1412 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1413 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1414 ".scope", &scope);
1415 if (r < 0)
1416 return log_error_errno(r, "Failed to mangle scope name: %m");
1417 } else {
1418 r = make_unit_name(bus, UNIT_SCOPE, &scope);
1419 if (r < 0)
1420 return r;
1421 }
1422
1423 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1424 if (r < 0)
1425 return bus_log_create_error(r);
1426
1427 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1428 if (r < 0)
1429 return bus_log_create_error(r);
1430
1431 /* Name and Mode */
1432 r = sd_bus_message_append(m, "ss", scope, "fail");
1433 if (r < 0)
1434 return bus_log_create_error(r);
1435
1436 /* Properties */
1437 r = sd_bus_message_open_container(m, 'a', "(sv)");
1438 if (r < 0)
1439 return bus_log_create_error(r);
1440
1441 r = transient_scope_set_properties(m);
1442 if (r < 0)
1443 return r;
1444
1445 r = sd_bus_message_close_container(m);
1446 if (r < 0)
1447 return bus_log_create_error(r);
1448
1449 /* Auxiliary units */
1450 r = sd_bus_message_append(m, "a(sa(sv))", 0);
1451 if (r < 0)
1452 return bus_log_create_error(r);
1453
1454 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1455
1456 r = sd_bus_call(bus, m, 0, &error, &reply);
1457 if (r < 0)
1458 return log_error_errno(r, "Failed to start transient scope unit: %s", bus_error_message(&error, r));
1459
1460 r = sd_bus_message_read(reply, "o", &object);
1461 if (r < 0)
1462 return bus_log_parse_error(r);
1463
1464 r = bus_wait_for_jobs_one(w, object, arg_quiet);
1465 if (r < 0)
1466 return r;
1467
1468 r = acquire_invocation_id(bus, &invocation_id);
1469 if (r < 0)
1470 return r;
1471
1472 r = strv_extendf(&user_env, "INVOCATION_ID=" SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL(invocation_id));
1473 if (r < 0)
1474 return log_oom();
1475
1476 if (arg_nice_set) {
1477 if (setpriority(PRIO_PROCESS, 0, arg_nice) < 0)
1478 return log_error_errno(errno, "Failed to set nice level: %m");
1479 }
1480
1481 if (arg_exec_group) {
1482 gid_t gid;
1483
1484 r = get_group_creds(&arg_exec_group, &gid, 0);
1485 if (r < 0)
1486 return log_error_errno(r, "Failed to resolve group %s: %m", arg_exec_group);
1487
1488 if (setresgid(gid, gid, gid) < 0)
1489 return log_error_errno(errno, "Failed to change GID to " GID_FMT ": %m", gid);
1490 }
1491
1492 if (arg_exec_user) {
1493 const char *home, *shell;
1494 uid_t uid;
1495 gid_t gid;
1496
1497 r = get_user_creds(&arg_exec_user, &uid, &gid, &home, &shell, USER_CREDS_CLEAN|USER_CREDS_PREFER_NSS);
1498 if (r < 0)
1499 return log_error_errno(r, "Failed to resolve user %s: %m", arg_exec_user);
1500
1501 if (home) {
1502 r = strv_extendf(&user_env, "HOME=%s", home);
1503 if (r < 0)
1504 return log_oom();
1505 }
1506
1507 if (shell) {
1508 r = strv_extendf(&user_env, "SHELL=%s", shell);
1509 if (r < 0)
1510 return log_oom();
1511 }
1512
1513 r = strv_extendf(&user_env, "USER=%s", arg_exec_user);
1514 if (r < 0)
1515 return log_oom();
1516
1517 r = strv_extendf(&user_env, "LOGNAME=%s", arg_exec_user);
1518 if (r < 0)
1519 return log_oom();
1520
1521 if (!arg_exec_group) {
1522 if (setresgid(gid, gid, gid) < 0)
1523 return log_error_errno(errno, "Failed to change GID to " GID_FMT ": %m", gid);
1524 }
1525
1526 if (setresuid(uid, uid, uid) < 0)
1527 return log_error_errno(errno, "Failed to change UID to " UID_FMT ": %m", uid);
1528 }
1529
1530 env = strv_env_merge(environ, user_env, arg_environment);
1531 if (!env)
1532 return log_oom();
1533
1534 if (!arg_quiet)
1535 log_info("Running scope as unit: %s", scope);
1536
1537 execvpe(arg_cmdline[0], arg_cmdline, env);
1538
1539 return log_error_errno(errno, "Failed to execute: %m");
1540 }
1541
1542 static int start_transient_trigger(
1543 sd_bus *bus,
1544 const char *suffix) {
1545
1546 _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
1547 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL, *reply = NULL;
1548 _cleanup_(bus_wait_for_jobs_freep) BusWaitForJobs *w = NULL;
1549 _cleanup_free_ char *trigger = NULL, *service = NULL;
1550 const char *object = NULL;
1551 int r;
1552
1553 assert(bus);
1554
1555 r = bus_wait_for_jobs_new(bus, &w);
1556 if (r < 0)
1557 return log_oom();
1558
1559 if (arg_unit) {
1560 switch (unit_name_to_type(arg_unit)) {
1561
1562 case UNIT_SERVICE:
1563 service = strdup(arg_unit);
1564 if (!service)
1565 return log_oom();
1566
1567 r = unit_name_change_suffix(service, suffix, &trigger);
1568 if (r < 0)
1569 return log_error_errno(r, "Failed to change unit suffix: %m");
1570 break;
1571
1572 case UNIT_TIMER:
1573 trigger = strdup(arg_unit);
1574 if (!trigger)
1575 return log_oom();
1576
1577 r = unit_name_change_suffix(trigger, ".service", &service);
1578 if (r < 0)
1579 return log_error_errno(r, "Failed to change unit suffix: %m");
1580 break;
1581
1582 default:
1583 r = unit_name_mangle_with_suffix(arg_unit, "as unit",
1584 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1585 ".service", &service);
1586 if (r < 0)
1587 return log_error_errno(r, "Failed to mangle unit name: %m");
1588
1589 r = unit_name_mangle_with_suffix(arg_unit, "as trigger",
1590 arg_quiet ? 0 : UNIT_NAME_MANGLE_WARN,
1591 suffix, &trigger);
1592 if (r < 0)
1593 return log_error_errno(r, "Failed to mangle unit name: %m");
1594
1595 break;
1596 }
1597 } else {
1598 r = make_unit_name(bus, UNIT_SERVICE, &service);
1599 if (r < 0)
1600 return r;
1601
1602 r = unit_name_change_suffix(service, suffix, &trigger);
1603 if (r < 0)
1604 return log_error_errno(r, "Failed to change unit suffix: %m");
1605 }
1606
1607 r = bus_message_new_method_call(bus, &m, bus_systemd_mgr, "StartTransientUnit");
1608 if (r < 0)
1609 return bus_log_create_error(r);
1610
1611 r = sd_bus_message_set_allow_interactive_authorization(m, arg_ask_password);
1612 if (r < 0)
1613 return bus_log_create_error(r);
1614
1615 /* Name and Mode */
1616 r = sd_bus_message_append(m, "ss", trigger, "fail");
1617 if (r < 0)
1618 return bus_log_create_error(r);
1619
1620 /* Properties */
1621 r = sd_bus_message_open_container(m, 'a', "(sv)");
1622 if (r < 0)
1623 return bus_log_create_error(r);
1624
1625 if (streq(suffix, ".path"))
1626 r = transient_unit_set_properties(m, UNIT_PATH, arg_path_property);
1627 else if (streq(suffix, ".socket"))
1628 r = transient_unit_set_properties(m, UNIT_SOCKET, arg_socket_property);
1629 else if (streq(suffix, ".timer"))
1630 r = transient_timer_set_properties(m);
1631 else
1632 assert_not_reached();
1633 if (r < 0)
1634 return r;
1635
1636 r = sd_bus_message_close_container(m);
1637 if (r < 0)
1638 return bus_log_create_error(r);
1639
1640 r = sd_bus_message_open_container(m, 'a', "(sa(sv))");
1641 if (r < 0)
1642 return bus_log_create_error(r);
1643
1644 if (!strv_isempty(arg_cmdline)) {
1645 r = sd_bus_message_open_container(m, 'r', "sa(sv)");
1646 if (r < 0)
1647 return bus_log_create_error(r);
1648
1649 r = sd_bus_message_append(m, "s", service);
1650 if (r < 0)
1651 return bus_log_create_error(r);
1652
1653 r = sd_bus_message_open_container(m, 'a', "(sv)");
1654 if (r < 0)
1655 return bus_log_create_error(r);
1656
1657 r = transient_service_set_properties(m, NULL);
1658 if (r < 0)
1659 return r;
1660
1661 r = sd_bus_message_close_container(m);
1662 if (r < 0)
1663 return bus_log_create_error(r);
1664
1665 r = sd_bus_message_close_container(m);
1666 if (r < 0)
1667 return bus_log_create_error(r);
1668 }
1669
1670 r = sd_bus_message_close_container(m);
1671 if (r < 0)
1672 return bus_log_create_error(r);
1673
1674 polkit_agent_open_if_enabled(arg_transport, arg_ask_password);
1675
1676 r = sd_bus_call(bus, m, 0, &error, &reply);
1677 if (r < 0)
1678 return log_error_errno(r, "Failed to start transient %s unit: %s", suffix + 1, bus_error_message(&error, r));
1679
1680 r = sd_bus_message_read(reply, "o", &object);
1681 if (r < 0)
1682 return bus_log_parse_error(r);
1683
1684 r = bus_wait_for_jobs_one(w, object, arg_quiet);
1685 if (r < 0)
1686 return r;
1687
1688 if (!arg_quiet) {
1689 log_info("Running %s as unit: %s", suffix + 1, trigger);
1690 if (!strv_isempty(arg_cmdline))
1691 log_info("Will run service as unit: %s", service);
1692 }
1693
1694 return 0;
1695 }
1696
1697 static int run(int argc, char* argv[]) {
1698 _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL;
1699 _cleanup_free_ char *description = NULL;
1700 int r, retval = EXIT_SUCCESS;
1701
1702 log_show_color(true);
1703 log_parse_environment();
1704 log_open();
1705
1706 r = parse_argv(argc, argv);
1707 if (r <= 0)
1708 return r;
1709
1710 if (!strv_isempty(arg_cmdline) &&
1711 arg_transport == BUS_TRANSPORT_LOCAL &&
1712 !strv_find_startswith(arg_property, "RootDirectory=") &&
1713 !strv_find_startswith(arg_property, "RootImage=")) {
1714 /* Patch in an absolute path to fail early for user convenience, but only when we can do it
1715 * (i.e. we will be running from the same file system). This also uses the user's $PATH,
1716 * while we use a fixed search path in the manager. */
1717
1718 _cleanup_free_ char *command = NULL;
1719 r = find_executable(arg_cmdline[0], &command);
1720 if (r < 0)
1721 return log_error_errno(r, "Failed to find executable %s: %m", arg_cmdline[0]);
1722
1723 free_and_replace(arg_cmdline[0], command);
1724 }
1725
1726 if (!arg_description) {
1727 description = strv_join(arg_cmdline, " ");
1728 if (!description)
1729 return log_oom();
1730
1731 if (arg_unit && isempty(description)) {
1732 r = free_and_strdup(&description, arg_unit);
1733 if (r < 0)
1734 return log_oom();
1735 }
1736
1737 arg_description = description;
1738 }
1739
1740 /* If --wait is used connect via the bus, unconditionally, as ref/unref is not supported via the limited direct
1741 * connection */
1742 if (arg_wait || arg_stdio != ARG_STDIO_NONE || (arg_user && arg_transport != BUS_TRANSPORT_LOCAL))
1743 r = bus_connect_transport(arg_transport, arg_host, arg_user, &bus);
1744 else
1745 r = bus_connect_transport_systemd(arg_transport, arg_host, arg_user, &bus);
1746 if (r < 0)
1747 return bus_log_connect_error(r);
1748
1749 if (arg_scope)
1750 r = start_transient_scope(bus);
1751 else if (arg_path_property)
1752 r = start_transient_trigger(bus, ".path");
1753 else if (arg_socket_property)
1754 r = start_transient_trigger(bus, ".socket");
1755 else if (arg_with_timer)
1756 r = start_transient_trigger(bus, ".timer");
1757 else
1758 r = start_transient_service(bus, &retval);
1759 if (r < 0)
1760 return r;
1761
1762 return retval;
1763 }
1764
1765 DEFINE_MAIN_FUNCTION_WITH_POSITIVE_FAILURE(run);
Unnamed repository; edit this file 'description' to name the repository.