1SYSTEMD-ACTIVATE(8)            systemd-activate            SYSTEMD-ACTIVATE(8)
2
3
4

NAME

6       systemd-activate - Test socket activation of daemons
7

SYNOPSIS

9       /usr/lib/systemd/systemd-activate [OPTIONS...] daemon [OPTIONS...]
10

DESCRIPTION

12       systemd-activate can be used to launch a socket activated daemon from
13       the command line for testing purposes. It can also be used to launch
14       single instances of the daemon per connection (inetd-style).
15
16       The daemon to launch and its options should be specifed after options
17       intended for systemd-activate.
18
19       If the -a option is given, file descriptor of the connection will be
20       used as the standard input and output of the launched process.
21       Otherwise, standard input and output will be inherited, and sockets
22       will be passed through file descriptors 3 and higher. Sockets passed
23       through $LISTEN_FDS to systemd-activate will be passed through to the
24       dameon, in the original positions. Other sockets specified with
25       --listen will use consecutive descriptors.
26

OPTIONS

28       -l address, --listen=address
29           Listen on this address. Takes a string like "2000" or
30           "127.0.0.1:2001".
31
32       -a, --accept
33           Launch a separate instance of daemon per connection and pass the
34           connection socket as standard input and standard output.
35
36       -E VAR[=VALUE], --setenv=VAR[=VALUE]
37           Add this variable to the environment of the launched process. If
38           VAR is followed by "=", assume that it is a variable–value pair.
39           Otherwise, obtain the value from the environment of
40           systemd-activate itself.
41
42       -h, --help
43           Print a short help text and exit.
44
45       --version
46           Print a short version string and exit.
47

ENVIRONMENT VARIABLES

49       $LISTEN_FDS, $LISTEN_PID
50           See sd_listen_fds(3).
51
52       $SYSTEMD_LOG_TARGET, $SYSTEMD_LOG_LEVEL, $SYSTEMD_LOG_COLOR,
53       $SYSTEMD_LOG_LOCATION
54           Same as in systemd(1).
55

EXAMPLES

57       Example 1. Run an echo server on port 2000
58
59           $ /usr/lib/systemd/systemd-activate -l 2000 -a cat
60
61       Example 2. Run a socket activated instance of systemd-journal-
62       gatewayd(8)
63
64           $ /usr/lib/systemd/systemd-activate -l 19531 /usr/lib/systemd/systemd-journal-gatewayd
65

SEE ALSO

67       systemd(1), systemd.socket(5), systemd.service(5), cat(1)
68
69
70
71systemd 219                                                SYSTEMD-ACTIVATE(8)
Impressum