Debian Codegraph @

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

raw
1 '\" t
2 .TH "ORG\&.FREEDESKTOP\&.NETWORK1" "5" "" "systemd 257.13" "org.freedesktop.network1"
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.network1 \- The D\-Bus interface of systemd\-networkd
24 .SH "INTRODUCTION"
25 .PP
26 \fBsystemd-networkd.service\fR(8)
27 is a system service that manages and configures network interfaces\&. 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/network1 {
37 interface org\&.freedesktop\&.network1\&.Manager {
38 methods:
39 ListLinks(out a(iso) links);
40 GetLinkByName(in s name,
41 out i ifindex,
42 out o path);
43 GetLinkByIndex(in i ifindex,
44 out s name,
45 out o path);
46 SetLinkNTP(in i ifindex,
47 in as servers);
48 SetLinkDNS(in i ifindex,
49 in a(iay) addresses);
50 SetLinkDNSEx(in i ifindex,
51 in a(iayqs) addresses);
52 SetLinkDomains(in i ifindex,
53 in a(sb) domains);
54 SetLinkDefaultRoute(in i ifindex,
55 in b enable);
56 SetLinkLLMNR(in i ifindex,
57 in s mode);
58 SetLinkMulticastDNS(in i ifindex,
59 in s mode);
60 SetLinkDNSOverTLS(in i ifindex,
61 in s mode);
62 SetLinkDNSSEC(in i ifindex,
63 in s mode);
64 SetLinkDNSSECNegativeTrustAnchors(in i ifindex,
65 in as names);
66 RevertLinkNTP(in i ifindex);
67 RevertLinkDNS(in i ifindex);
68 RenewLink(in i ifindex);
69 ForceRenewLink(in i ifindex);
70 ReconfigureLink(in i ifindex);
71 Reload();
72 DescribeLink(in i ifindex,
73 out s json);
74 Describe(out s json);
75 properties:
76 readonly s OperationalState = \*(Aq\&.\&.\&.\*(Aq;
77 readonly s CarrierState = \*(Aq\&.\&.\&.\*(Aq;
78 readonly s AddressState = \*(Aq\&.\&.\&.\*(Aq;
79 readonly s IPv4AddressState = \*(Aq\&.\&.\&.\*(Aq;
80 readonly s IPv6AddressState = \*(Aq\&.\&.\&.\*(Aq;
81 readonly s OnlineState = \*(Aq\&.\&.\&.\*(Aq;
82 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
83 readonly t NamespaceId = \&.\&.\&.;
84 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
85 readonly u NamespaceNSID = \&.\&.\&.;
86 };
87 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
88 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
89 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
90 };
91 .fi
92 .if n \{\
93 .RE
94 .\}
95 .sp
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126 .PP
127 Provides information about the manager\&.
128 .SS "Properties"
129 .PP
130 \fINamespaceId\fR
131 contains the inode number of the network namespace that the network service runs in\&. A client may compare this with the inode number of its own network namespace to verify whether the service manages the same network namespace\&.
132 .PP
133 \fINamespaceNSID\fR
134 contains the "nsid" identifier the kernel maintains for the network namespace, if there\*(Aqs one assigned\&.
135 .SH "LINK OBJECT"
136 .sp
137 .if n \{\
138 .RS 4
139 .\}
140 .nf
141 node /org/freedesktop/network1/link/_1 {
142 interface org\&.freedesktop\&.network1\&.Link {
143 methods:
144 SetNTP(in as servers);
145 SetDNS(in a(iay) addresses);
146 SetDNSEx(in a(iayqs) addresses);
147 SetDomains(in a(sb) domains);
148 SetDefaultRoute(in b enable);
149 SetLLMNR(in s mode);
150 SetMulticastDNS(in s mode);
151 SetDNSOverTLS(in s mode);
152 SetDNSSEC(in s mode);
153 SetDNSSECNegativeTrustAnchors(in as names);
154 RevertNTP();
155 RevertDNS();
156 Renew();
157 ForceRenew();
158 Reconfigure();
159 Describe(out s json);
160 properties:
161 readonly s OperationalState = \*(Aq\&.\&.\&.\*(Aq;
162 readonly s CarrierState = \*(Aq\&.\&.\&.\*(Aq;
163 readonly s AddressState = \*(Aq\&.\&.\&.\*(Aq;
164 readonly s IPv4AddressState = \*(Aq\&.\&.\&.\*(Aq;
165 readonly s IPv6AddressState = \*(Aq\&.\&.\&.\*(Aq;
166 readonly s OnlineState = \*(Aq\&.\&.\&.\*(Aq;
167 readonly s AdministrativeState = \*(Aq\&.\&.\&.\*(Aq;
168 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
169 readonly (tt) BitRates = \&.\&.\&.;
170 };
171 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
172 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
173 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
174 };
175 .fi
176 .if n \{\
177 .RE
178 .\}
179 .sp
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205 .PP
206 Provides information about interfaces\&.
207 .SH "NETWORK OBJECT"
208 .sp
209 .if n \{\
210 .RS 4
211 .\}
212 .nf
213 node /org/freedesktop/network1/network/_1 {
214 interface org\&.freedesktop\&.network1\&.Network {
215 properties:
216 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
217 readonly s Description = \*(Aq\&.\&.\&.\*(Aq;
218 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
219 readonly s SourcePath = \*(Aq\&.\&.\&.\*(Aq;
220 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
221 readonly as MatchMAC = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
222 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
223 readonly as MatchPath = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
224 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
225 readonly as MatchDriver = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
226 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
227 readonly as MatchType = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
228 @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const")
229 readonly as MatchName = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
230 };
231 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
232 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
233 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
234 };
235 .fi
236 .if n \{\
237 .RE
238 .\}
239 .sp
240
241
242
243
244
245
246
247
248 .PP
249 Provides information about \&.network files\&.
250 .SH "DHCP SERVER OBJECT"
251 .sp
252 .if n \{\
253 .RS 4
254 .\}
255 .nf
256 node /org/freedesktop/network1/link/_1 {
257 interface org\&.freedesktop\&.network1\&.DHCPServer {
258 properties:
259 readonly a(uayayayayt) Leases = [\&.\&.\&.];
260 };
261 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
262 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
263 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
264 interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. };
265 };
266 .fi
267 .if n \{\
268 .RE
269 .\}
270 .sp
271
272
273
274
275 .PP
276 Provides information about leases\&.
277 .SH "DHCPV4 CLIENT OBJECT"
278 .sp
279 .if n \{\
280 .RS 4
281 .\}
282 .nf
283 node /org/freedesktop/network1/link/_1 {
284 interface org\&.freedesktop\&.network1\&.DHCPv4Client {
285 properties:
286 readonly s State = \*(Aq\&.\&.\&.\*(Aq;
287 };
288 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
289 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
290 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
291 interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. };
292 };
293 .fi
294 .if n \{\
295 .RE
296 .\}
297 .sp
298
299
300
301
302 .PP
303 Provides information about DHCPv4 client status\&.
304 .SH "DHCPV6 CLIENT OBJECT"
305 .sp
306 .if n \{\
307 .RS 4
308 .\}
309 .nf
310 node /org/freedesktop/network1/link/_1 {
311 interface org\&.freedesktop\&.network1\&.DHCPv6Client {
312 properties:
313 readonly s State = \*(Aq\&.\&.\&.\*(Aq;
314 };
315 interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
316 interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
317 interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
318 interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. };
319 };
320 .fi
321 .if n \{\
322 .RE
323 .\}
324 .sp
325
326
327
328
329 .PP
330 Provides information about DHCPv6 client status\&.
331 .SH "EXAMPLES"
332 .PP
333 \fBExample\ \&1.\ \&Introspect org\&.freedesktop\&.network1\&.Manager on the bus\fR
334 .sp
335 .if n \{\
336 .RS 4
337 .\}
338 .nf
339 $ gdbus introspect \-\-system \e
340 \-\-dest org\&.freedesktop\&.network1 \e
341 \-\-object\-path /org/freedesktop/network1
342 .fi
343 .if n \{\
344 .RE
345 .\}
346 .PP
347 \fBExample\ \&2.\ \&Introspect org\&.freedesktop\&.network1\&.Link on the bus\fR
348 .sp
349 .if n \{\
350 .RS 4
351 .\}
352 .nf
353 $ gdbus introspect \-\-system \e
354 \-\-dest org\&.freedesktop\&.network1 \e
355 \-\-object\-path /org/freedesktop/network1/link/_11
356 .fi
357 .if n \{\
358 .RE
359 .\}
360 .SH "VERSIONING"
361 .PP
362 These D\-Bus interfaces follow
363 \m[blue]\fBthe usual interface versioning guidelines\fR\m[]\&\s-2\u[1]\d\s+2\&.
364 .SH "HISTORY"
365 .SS "DHCPv4 Client Object"
366 .PP
367 \fIState\fR
368 was added in version 255\&.
369 .SS "DHCPv6 Client Object"
370 .PP
371 \fIState\fR
372 was added in version 255\&.
373 .SS "Manager Object"
374 .PP
375 \fINamespaceNSID\fR
376 was added in version 256\&.
377 .SH "SEE ALSO"
378 .PP
379 \fBsystemd\fR(1), \fBsystemd-networkd.service\fR(8), \fBnetworkctl\fR(1)
380 .SH "NOTES"
381 .IP " 1." 4
382 the usual interface versioning guidelines
383 .RS 4
384 \%https://0pointer.de/blog/projects/versioning-dbus.html
385 .RE