Debian Codegraph @

upstream/debian-trixie/man5/org.freedesktop.machine1.5

raw
1 '\" t
2 .TH "ORG\&.FREEDESKTOP\&.MACHINE1" "5" "" "systemd 257.13" "org.freedesktop.machine1"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 org.freedesktop.machine1 \- The D\-Bus interface of systemd\-machined
24 .SH "INTRODUCTION"
25 .PP
26 \fBsystemd-machined.service\fR(8)
27 is a system service that keeps track of locally running virtual machines and containers\&. This page describes the D\-Bus interface\&.
28 .SH "THE MANAGER OBJECT"
29 .PP
30 The service exposes the following interfaces on the Manager object on the bus:
31 .sp
32 .if n \{\
33 .RS 4
34 .\}
35 .nf
36 node /org/freedesktop/machine1 {
37 interface org\&.freedesktop\&.machine1\&.Manager {
38 methods:
39 GetMachine(in s name,
40 out o machine);
41 GetImage(in s name,
42 out o image);
43 GetMachineByPID(in u pid,
44 out o machine);
45 ListMachines(out a(ssso) machines);
46 ListImages(out a(ssbttto) images);
47 @org\&.freedesktop\&.systemd1\&.Privileged("true")
48 CreateMachine(in s name,
49 in ay id,
50 in s service,
51 in s class,
52 in u leader,
53 in s root_directory,
54 in a(sv) scope_properties,
55 out o path);
56 @org\&.freedesktop\&.systemd1\&.Privileged("true")
57 CreateMachineWithNetwork(in s name,
58 in ay id,
59 in s service,
60 in s class,
61 in u leader,
62 in s root_directory,
63 in ai ifindices,
64 in a(sv) scope_properties,
65 out o path);
66 @org\&.freedesktop\&.systemd1\&.Privileged("true")
67 RegisterMachine(in s name,
68 in ay id,
69 in s service,
70 in s class,
71 in u leader,
72 in s root_directory,
73 out o path);
74 @org\&.freedesktop\&.systemd1\&.Privileged("true")
75 RegisterMachineWithNetwork(in s name,
76 in ay id,
77 in s service,
78 in s class,
79 in u leader,
80 in s root_directory,
81 in ai ifindices,
82 out o path);
83 UnregisterMachine(in s name);
84 TerminateMachine(in s id);
85 KillMachine(in s name,
86 in s whom,
87 in i signal);
88 GetMachineAddresses(in s name,
89 out a(iay) addresses);
90 GetMachineSSHInfo(in s name,
91 out s ssh_address,
92 out s ssh_private_key_path);
93 GetMachineOSRelease(in s name,
94 out a{ss} fields);
95 @org\&.freedesktop\&.systemd1\&.Privileged("true")
96 OpenMachinePTY(in s name,
97 out h pty,
98 out s pty_path);
99 OpenMachineLogin(in s name,
100 out h pty,
101 out s pty_path);
102 OpenMachineShell(in s name,
103 in s user,
104 in s path,
105 in as args,
106 in as environment,
107 out h pty,
108 out s pty_path);
109 BindMountMachine(in s name,
110 in s source,
111 in s destination,
112 in b read_only,
113 in b mkdir);
114 CopyFromMachine(in s name,
115 in s source,
116 in s destination);
117 CopyToMachine(in s name,
118 in s source,
119 in s destination);
120 CopyFromMachineWithFlags(in s name,
121 in s source,
122 in s destination,
123 in t flags);
124 CopyToMachineWithFlags(in s name,
125 in s source,
126 in s destination,
127 in t flags);
128 OpenMachineRootDirectory(in s name,
129 out h fd);
130 GetMachineUIDShift(in s name,
131 out u shift);
132 RemoveImage(in s name);
133 RenameImage(in s name,
134 in s new_name);
135 CloneImage(in s name,
136 in s new_name,
137 in b read_only);
138 MarkImageReadOnly(in s name,
139 in b read_only);
140 GetImageHostname(in s name,
141 out s hostname);
142 GetImageMachineID(in s name,
143 out ay id);
144 GetImageMachineInfo(in s name,
145 out a{ss} machine_info);
146 GetImageOSRelease(in s name,
147 out a{ss} os_release);
148 SetPoolLimit(in t size);
149 SetImageLimit(in s name,
150 in t size);
151 CleanPool(in s mode,
152 out a(st) images);
153 MapFromMachineUser(in s name,
154 in u uid_inner,
155 out u uid_outer);
156 MapToMachineUser(in u uid_outer,
157 out s machine_name,
158 out o machine_path,
159 out u uid_inner);
160 MapFromMachineGroup(in s name,
161 in u gid_inner,
162 out u gid_outer);
163 MapToMachineGroup(in u gid_outer,
164 out s machine_name,
165 out o machine_path,
166 out u gid_inner);
167 signals:
168 MachineNew(s machine,
169 o path);
170 MachineRemoved(s machine,
171 o path);
172 properties:
173 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
174 readonly s PoolPath = \*(Aq\&.\&.\&.\*(Aq;
175 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
176 readonly t PoolUsage = \&.\&.\&.;
177 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
178 readonly t PoolLimit = \&.\&.\&.;
179 };
180 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
181 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
182 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
183 };
184 .fi
185 .if n \{\
186 .RE
187 .\}
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234 .SS "Methods"
235 .PP
236 \fBGetMachine()\fR
237 may be used to get the machine object path for the machine with the specified name\&. Similarly,
238 \fBGetMachineByPID()\fR
239 gets the machine object the specified PID belongs to if there is any\&.
240 .PP
241 \fBGetImage()\fR
242 may be used to get the image object path of the image with the specified name\&.
243 .PP
244 \fBListMachines()\fR
245 returns an array of all currently registered machines\&. The structures in the array consist of the following fields: machine name, machine class, an identifier for the service that registered the machine and the machine object path\&.
246 .PP
247 \fBListImages()\fR
248 returns an array of all currently known images\&. The structures in the array consist of the following fields: image name, type, read\-only flag, creation time, modification time, current disk space, and image object path\&.
249 .PP
250 \fBCreateMachine()\fR
251 may be used to register a new virtual machine or container with
252 \fBsystemd\-machined\fR, creating a scope unit for it\&. It accepts the following arguments: a machine name chosen by the registrar, an optional UUID as a 32 byte array, a string that identifies the service that registers the machine, a class string, the PID of the leader process of the machine, an optional root directory of the container, and an array of additional properties to use for the scope registration\&. The virtual machine name must be suitable as a hostname, and hence should follow the usual DNS hostname rules, as well as the Linux hostname restrictions\&. Specifically, only 7 bit ASCII is permitted, a maximum length of 64 characters is enforced, only characters from the set
253 "a\-zA\-Z0\-9\-_\&."
254 are allowed, the name may not begin with a dot, and it may not contain two dots immediately following each other\&. Container and VM managers should ideally use the hostname used internally in the machine for this parameter\&. This recommendation is made in order to make the machine name naturally resolvable using
255 \fBnss-mymachines\fR(8)\&. If a container manager needs to embed characters outside of the indicated range, escaping is required, possibly using
256 "_"
257 as the escape character\&. Another (somewhat natural) option would be to utilize Internet IDNA encoding\&. The UUID is passed as a 32 byte array or, if no suitable UUID is available, an empty array (zero length) or zeroed out array shall be passed\&. The UUID should identify the virtual machine/container uniquely and should ideally be the same UUID that
258 /etc/machine\-id
259 in the VM/container is initialized from\&. The service string can be free\-form, but it is recommended to pass a short lowercase identifier like
260 "systemd\-nspawn",
261 "libvirt\-lxc"
262 or similar\&. The class string should be either
263 "container"
264 or
265 "vm"
266 indicating whether the machine to register is of the respective class\&. The leader PID should be the host PID of the init process of the container or the encapsulating process of the VM\&. If the root directory of the container is known and available in the host\*(Aqs hierarchy, it should be passed (note that this is for informational purposes only, and will not be used otherwise)\&. Otherwise, pass the empty string instead\&. Finally, the scope properties are passed as array in the same way as to PID1\*(Aqs
267 \fBStartTransientUnit()\fR
268 method\&. Calling this method will internally register a transient scope unit for the calling client (utilizing the passed scope_properties) and move the leader PID into it\&. The method returns an object path for the registered machine object that implements the
269 org\&.freedesktop\&.machine1\&.Machine
270 interface (see below)\&. Also see the
271 \m[blue]\fBNew Control Group Interfaces\fR\m[]\&\s-2\u[1]\d\s+2
272 for details about scope units and how to alter resource control settings on the created machine at runtime\&.
273 .PP
274 \fBRegisterMachine()\fR
275 is similar to
276 \fBCreateMachine()\fR\&. However, it only registers a machine and does not create a scope unit for it\&. Instead, the caller\*(Aqs unit is registered\&. We recommend to only use this method for container or VM managers that are run multiple times, one instance for each container/VM they manage, and are invoked as system services\&.
277 .PP
278 \fBCreateMachineWithNetwork()\fR
279 and
280 \fBRegisterMachineWithNetwork()\fR
281 are similar to
282 \fBCreateMachine()\fR
283 and
284 \fBRegisterMachine()\fR
285 but take an extra argument: an array of network interface indices that point towards the virtual machine or container\&. The interface indices should reference one or more network interfaces on the host that can be used to communicate with the guest\&. Commonly, the passed interface index refers to the host side of a "veth" link (in case of containers), a "tun"/"tap" link (in case of VMs), or the host side of a bridge interface that bridges access to the VM/container interfaces\&. Specifying this information is useful to enable support for link\-local IPv6 communication to the machines since the scope field of sockaddr_in6 can be initialized by the specified ifindex\&.
286 \fBnss-mymachines\fR(8)
287 makes use of this information\&.
288 .PP
289 \fBKillMachine()\fR
290 sends a UNIX signal to the machine\*(Aqs processes\&. As its arguments, it takes a machine name (as originally passed to
291 \fBCreateMachine()\fR
292 or returned by
293 \fBListMachines()\fR), an identifier that specifies what precisely to send the signal to (either
294 "leader"
295 or
296 "all"), and a numeric UNIX signal integer\&.
297 .PP
298 \fBTerminateMachine()\fR
299 terminates a virtual machine, killing its processes\&. It takes a machine name as its only argument\&.
300 .PP
301 \fBGetMachineAddresses()\fR
302 retrieves the IP addresses of a container\&. This method returns an array of pairs consisting of an address family specifier (\fBAF_INET\fR
303 or
304 \fBAF_INET6\fR) and a byte array containing the addresses\&. This is only supported for containers that make use of network namespacing\&.
305 .PP
306 \fBGetMachineSSHInfo()\fR
307 retrieves the SSH information of a machine\&. This method returns two strings, the SSH address which can be used to tell SSH where to connect, and the path to the SSH private key required for the connection to succeed\&.
308 .PP
309 \fBGetMachineOSRelease()\fR
310 retrieves the OS release information of a container\&. This method returns an array of key value pairs read from the
311 \fBos-release\fR(5)
312 file in the container and is useful to identify the operating system used in a container\&.
313 .PP
314 \fBOpenMachinePTY()\fR
315 allocates a pseudo TTY in the container and returns a file descriptor and its path\&. This is equivalent to transitioning into the container and invoking
316 \fBposix_openpt\fR(3)\&.
317 .PP
318 \fBOpenMachineLogin()\fR
319 allocates a pseudo TTY in the container and ensures that a getty login prompt of the container is running on the other end\&. It returns the file descriptor of the PTY and the PTY path\&. This is useful for acquiring a pty with a login prompt from the container\&.
320 .PP
321 \fBOpenMachineShell()\fR
322 allocates a pseudo TTY in the container, as the specified user, and invokes the executable at the specified path with a list of arguments (starting from argv[0]) and an environment block\&. It then returns the file descriptor of the PTY and the PTY path\&.
323 .PP
324 \fBBindMountMachine()\fR
325 bind mounts a file or directory from the host into the container\&. Its arguments consist of a machine name, the source directory on the host, the destination directory in the container, and two booleans, one indicating whether the bind mount shall be read\-only, the other indicating whether the destination mount point shall be created first, if it is missing\&.
326 .PP
327 \fBCopyFromMachine()\fR
328 copies files or directories from a container into the host\&. It takes a container name, a source directory in the container and a destination directory on the host as arguments\&.
329 \fBCopyToMachine()\fR
330 does the opposite and copies files from a source directory on the host into a destination directory in the container\&.
331 \fBCopyFromMachineWithFlags()\fR
332 and
333 \fBCopyToMachineWithFlags()\fR
334 do the same but take an additional flags argument\&.
335 .PP
336 \fBRemoveImage()\fR
337 removes the image with the specified name\&.
338 .PP
339 \fBRenameImage()\fR
340 renames the specified image\&.
341 .PP
342 \fBCloneImage()\fR
343 clones the specified image under a new name\&. It also takes a boolean argument indicating whether the resulting image shall be read\-only or not\&.
344 .PP
345 \fBMarkImageReadOnly()\fR
346 toggles the read\-only flag of an image\&.
347 .PP
348 \fBSetPoolLimit()\fR
349 sets an overall quota limit on the pool of images\&.
350 .PP
351 \fBSetImageLimit()\fR
352 sets a per\-image quota limit\&.
353 .PP
354 \fBMapFromMachineUser()\fR,
355 \fBMapToMachineUser()\fR,
356 \fBMapFromMachineGroup()\fR, and
357 \fBMapToMachineGroup()\fR
358 may be used to map UIDs/GIDs from the host user namespace to a container user namespace or vice versa\&.
359 .SS "Signals"
360 .PP
361 \fBMachineNew()\fR
362 and
363 \fBMachineRemoved()\fR
364 are sent whenever a new machine is registered or removed\&. These signals carry the machine name and the object path to the corresponding
365 org\&.freedesktop\&.machine1\&.Machine
366 interface (see below)\&.
367 .SS "Properties"
368 .PP
369 \fIPoolPath\fR
370 specifies the file system path where images are written to\&.
371 .PP
372 \fIPoolUsage\fR
373 specifies the current usage size of the image pool in bytes\&.
374 .PP
375 \fIPoolLimit\fR
376 specifies the size limit of the image pool in bytes\&.
377 .SH "MACHINE OBJECTS"
378 .sp
379 .if n \{\
380 .RS 4
381 .\}
382 .nf
383 node /org/freedesktop/machine1/machine/rawhide {
384 interface org\&.freedesktop\&.machine1\&.Machine {
385 methods:
386 Terminate();
387 Kill(in s whom,
388 in i signal);
389 GetAddresses(out a(iay) addresses);
390 GetSSHInfo(out s ssh_address,
391 out s ssh_private_key_path);
392 GetOSRelease(out a{ss} fields);
393 GetUIDShift(out u shift);
394 OpenPTY(out h pty,
395 out s pty_path);
396 OpenLogin(out h pty,
397 out s pty_path);
398 OpenShell(in s user,
399 in s path,
400 in as args,
401 in as environment,
402 out h pty,
403 out s pty_path);
404 BindMount(in s source,
405 in s destination,
406 in b read_only,
407 in b mkdir);
408 CopyFrom(in s source,
409 in s destination);
410 CopyTo(in s source,
411 in s destination);
412 CopyFromWithFlags(in s source,
413 in s destination,
414 in t flags);
415 CopyToWithFlags(in s source,
416 in s destination,
417 in t flags);
418 OpenRootDirectory(out h fd);
419 properties:
420 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
421 readonly s Name = \*(Aq\&.\&.\&.\*(Aq;
422 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
423 readonly ay Id = [\&.\&.\&.];
424 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
425 readonly t Timestamp = \&.\&.\&.;
426 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
427 readonly t TimestampMonotonic = \&.\&.\&.;
428 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
429 readonly s Service = \*(Aq\&.\&.\&.\*(Aq;
430 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
431 readonly s Unit = \*(Aq\&.\&.\&.\*(Aq;
432 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
433 readonly u Leader = \&.\&.\&.;
434 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
435 readonly s Class = \*(Aq\&.\&.\&.\*(Aq;
436 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
437 readonly s RootDirectory = \*(Aq\&.\&.\&.\*(Aq;
438 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
439 readonly ai NetworkInterfaces = [\&.\&.\&.];
440 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
441 readonly u VSockCID = \&.\&.\&.;
442 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
443 readonly s SSHAddress = \*(Aq\&.\&.\&.\*(Aq;
444 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
445 readonly s SSHPrivateKeyPath = \*(Aq\&.\&.\&.\*(Aq;
446 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
447 readonly s State = \*(Aq\&.\&.\&.\*(Aq;
448 };
449 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
450 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
451 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
452 };
453 .fi
454 .if n \{\
455 .RE
456 .\}
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487 .SS "Methods"
488 .PP
489 \fBTerminate()\fR
490 and
491 \fBKill()\fR
492 terminate/kill the machine\&. These methods take the same arguments as
493 \fBTerminateMachine()\fR
494 and
495 \fBKillMachine()\fR
496 on the Manager interface, respectively\&.
497 .PP
498 \fBGetAddresses()\fR,
499 \fBGetSSHInfo()\fR
500 and
501 \fBGetOSRelease()\fR
502 get the IP address, SSH connection and OS release information from the machine\&. These methods take the same arguments as
503 \fBGetMachineAddresses()\fR,
504 \fBGetMachineSSHInfo()\fR
505 and
506 \fBGetMachineOSRelease()\fR
507 of the Manager interface, respectively\&.
508 .SS "Properties"
509 .PP
510 \fIName\fR
511 is the machine name as it was passed in during registration with
512 \fBCreateMachine()\fR
513 on the manager object\&.
514 .PP
515 \fIId\fR
516 is the machine UUID\&.
517 .PP
518 \fITimestamp\fR
519 and
520 \fITimestampMonotonic\fR
521 are the realtime and monotonic timestamps when the virtual machines where created in microseconds since the epoch\&.
522 .PP
523 \fIService\fR
524 contains a short string identifying the registering service as passed in during registration of the machine\&.
525 .PP
526 \fIUnit\fR
527 is the systemd scope or service unit name for the machine\&.
528 .PP
529 \fILeader\fR
530 is the PID of the leader process of the machine\&.
531 .PP
532 \fIClass\fR
533 is the class of the machine and is either the string "vm" (for real VMs based on virtualized hardware) or "container" (for lightweight userspace virtualization sharing the same kernel as the host)\&.
534 .PP
535 \fIRootDirectory\fR
536 is the root directory of the container if it is known and applicable or the empty string\&.
537 .PP
538 \fINetworkInterfaces\fR
539 contains an array of network interface indices that point towards the container, the VM or the host\&. For details about this information see the description of
540 \fBCreateMachineWithNetwork()\fR
541 above\&.
542 .PP
543 \fIVSockCID\fR
544 is the VSOCK CID of the VM if it is known, or
545 \fBVMADDR_CID_ANY\fR
546 otherwise\&.
547 .PP
548 \fISSHAddress\fR
549 is the address of the VM in a format
550 \fBssh\fR
551 can understand if it is known or the empty string\&.
552 .PP
553 \fISSHPrivateKeyPath\fR
554 is the path to the SSH private key of the VM if it is known or the empty string\&.
555 .PP
556 \fIState\fR
557 is the state of the machine and is one of
558 "opening",
559 "running", or
560 "closing"\&. Note that the state machine is not considered part of the API and states might be removed or added without this being considered API breakage\&.
561 .SH "EXAMPLES"
562 .PP
563 \fBExample\ \&1.\ \&Introspect org\&.freedesktop\&.machine1\&.Manager on the bus\fR
564 .sp
565 .if n \{\
566 .RS 4
567 .\}
568 .nf
569 $ gdbus introspect \-\-system \e
570 \-\-dest org\&.freedesktop\&.machine1 \e
571 \-\-object\-path /org/freedesktop/machine1
572 .fi
573 .if n \{\
574 .RE
575 .\}
576 .PP
577 \fBExample\ \&2.\ \&Introspect org\&.freedesktop\&.machine1\&.Machine on the bus\fR
578 .sp
579 .if n \{\
580 .RS 4
581 .\}
582 .nf
583 $ gdbus introspect \-\-system \e
584 \-\-dest org\&.freedesktop\&.machine1 \e
585 \-\-object\-path /org/freedesktop/machine1/machine/rawhide
586 .fi
587 .if n \{\
588 .RE
589 .\}
590 .SH "VERSIONING"
591 .PP
592 These D\-Bus interfaces follow
593 \m[blue]\fBthe usual interface versioning guidelines\fR\m[]\&\s-2\u[2]\d\s+2\&.
594 .SH "HISTORY"
595 .SS "The Manager Object"
596 .PP
597 \fBCopyFromMachineWithFlags()\fR
598 and
599 \fBCopyToMachineWithFlags()\fR
600 were added in version 252\&.
601 .PP
602 \fBGetMachineSSHInfo()\fR
603 was added in version 256\&.
604 .SS "Machine Objects"
605 .PP
606 \fBCopyFromWithFlags()\fR
607 and
608 \fBCopyToWithFlags()\fR
609 were added in version 252\&.
610 .PP
611 \fBGetSSHInfo()\fR,
612 \fIVSockCID\fR,
613 \fISSHAddress\fR
614 and
615 \fISSHPrivateKeyPath\fR
616 were added in version 256\&.
617 .SH "SEE ALSO"
618 .PP
619 \fBsystemd\fR(1), \fBsystemd-machined.service\fR(8), \fBmachinectl\fR(1)
620 .SH "NOTES"
621 .IP " 1." 4
622 New Control Group Interfaces
623 .RS 4
624 \%https://systemd.io/CONTROL_GROUP_INTERFACE
625 .RE
626 .IP " 2." 4
627 the usual interface versioning guidelines
628 .RS 4
629 \%https://0pointer.de/blog/projects/versioning-dbus.html
630 .RE