1hirte-agent(1)              General Commands Manual             hirte-agent(1)
2
3
4

NAME

6       hirte-agent - Agent managing services on the local machine
7
8

SYNOPSIS

10       hirte-agent [options]
11
12

DESCRIPTION

14       Hirte  is a systemd service controller intended for multi-node environ‐
15       ment with a predefined number of nodes and with a focus on highly regu‐
16       lated  environment such as those requiring functional safety (for exam‐
17       ple in cars).
18
19
20       A hirte-agent establishes a peer-to-peer connection to  hirte  and  ex‐
21       poses its API to manage systemd units on it.
22
23
24       hirte-agent [OPTIONS]
25
26

OPTIONS

28   --help, -h
29       Print usage statement and exit.
30
31
32   --host, -H
33       The  host used by hirte-agent to connect to hirte. Must be a valid IPv4
34       or IPv6. This option will overwrite the host defined in the  configura‐
35       tion file.
36
37
38   --port, -p
39       The  port  on  which  hirte is listening for connection request and the
40       hirte-agent is connecting to. This option will overwrite the  port  de‐
41       fined in the configuration file. (default: 842)
42
43
44   --address, -a
45       DBus  address  used  by  hirte-agent  to  connect  to  hirte.  See  man
46       sd_bus_set_address for its format.  Overrides any setting  of  Manager‐
47       Host  or  ManagerPort  defined in the configuration file as well as the
48       respective CLI options.
49
50
51   --name, -n
52       The unique name of this hirte-agent used for registering at hirte. This
53       option will overwrite the port defined in the configuration file.
54
55
56   --interval, -i
57       The  interval  between two heartbeat signals sent to hirte in millisec‐
58       onds. This option will overwrite the heartbeat interval defined in  the
59       configuration file.
60
61
62   --config, -c
63       Path  to  the  configuration  file,  see hirte-agent.conf(5). (default:
64       /etc/hirte/agent.conf)
65
66
67   --user
68       Connect to the user systemd instance instead of the system one.
69
70

Environment Variables

72       hirte-agent understands the following environment variables that can be
73       used  to  override the settings from the configuration file (see hirte-
74       agent.conf(5)).
75
76
77   HIRTE_LOG_LEVEL
78       The level used for logging. Supported values are:
79
80
81              • DEBUG
82
83              • INFO
84
85              • WARN
86
87              • ERROR
88
89
90
91   HIRTE_LOG_TARGET
92       The target where logs are written to. Supported values are:
93
94
95              • stderr
96
97              • stderr-full
98
99              • journald
100
101
102
103   HIRTE_LOG_IS_QUIET
104       If this flag is set to true, no logs are written by hirte.
105
106

Exit Codes

108       TBD
109
110

CONFIGURATION FILES

112       hirte-agent.conf(5)                        ⟨https://github.com/contain‐
113       ers/hirte/blob/main/doc/man/hirte-agent.conf.5.md⟩
114
115
116
117                                                                hirte-agent(1)
Impressum