Provided by: systemd_251.4-1ubuntu7_amd64
NAME
org.freedesktop.network1 - The D-Bus interface of systemd-networkd
INTRODUCTION
systemd-networkd.service(8) is a system service that manages and configures network interfaces. This page describes the D-Bus interface.
THE MANAGER OBJECT
The service exposes the following interfaces on the Manager object on the bus: node /org/freedesktop/network1 { interface org.freedesktop.network1.Manager { methods: ListLinks(out a(iso) links); GetLinkByName(in s name, out i ifindex, out o path); GetLinkByIndex(in i ifindex, out s name, out o path); SetLinkNTP(in i ifindex, in as servers); SetLinkDNS(in i ifindex, in a(iay) addresses); SetLinkDNSEx(in i ifindex, in a(iayqs) addresses); SetLinkDomains(in i ifindex, in a(sb) domains); SetLinkDefaultRoute(in i ifindex, in b enable); SetLinkLLMNR(in i ifindex, in s mode); SetLinkMulticastDNS(in i ifindex, in s mode); SetLinkDNSOverTLS(in i ifindex, in s mode); SetLinkDNSSEC(in i ifindex, in s mode); SetLinkDNSSECNegativeTrustAnchors(in i ifindex, in as names); RevertLinkNTP(in i ifindex); RevertLinkDNS(in i ifindex); RenewLink(in i ifindex); ForceRenewLink(in i ifindex); ReconfigureLink(in i ifindex); Reload(); DescribeLink(in i ifindex, out s json); Describe(out s json); properties: readonly s OperationalState = '...'; readonly s CarrierState = '...'; readonly s AddressState = '...'; readonly s IPv4AddressState = '...'; readonly s IPv6AddressState = '...'; readonly s OnlineState = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly t NamespaceId = ...; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; }; Provides information about the manager.
LINK OBJECT
node /org/freedesktop/network1/link/_1 { interface org.freedesktop.network1.Link { methods: SetNTP(in as servers); SetDNS(in a(iay) addresses); SetDNSEx(in a(iayqs) addresses); SetDomains(in a(sb) domains); SetDefaultRoute(in b enable); SetLLMNR(in s mode); SetMulticastDNS(in s mode); SetDNSOverTLS(in s mode); SetDNSSEC(in s mode); SetDNSSECNegativeTrustAnchors(in as names); RevertNTP(); RevertDNS(); Renew(); ForceRenew(); Reconfigure(); Describe(out s json); properties: readonly s OperationalState = '...'; readonly s CarrierState = '...'; readonly s AddressState = '...'; readonly s IPv4AddressState = '...'; readonly s IPv6AddressState = '...'; readonly s OnlineState = '...'; readonly s AdministrativeState = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("false") readonly (tt) BitRates = ...; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; interface org.freedesktop.network1.DHCPServer { ... }; }; Provides information about interfaces.
NETWORK OBJECT
node /org/freedesktop/network1/network/_1 { interface org.freedesktop.network1.Network { properties: @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s Description = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly s SourcePath = '...'; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly as MatchMAC = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly as MatchPath = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly as MatchDriver = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly as MatchType = ['...', ...]; @org.freedesktop.DBus.Property.EmitsChangedSignal("const") readonly as MatchName = ['...', ...]; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; }; Provides information about .network files.
DHCP SERVER OBJECT
node /org/freedesktop/network1/link/_1 { interface org.freedesktop.network1.DHCPServer { properties: readonly a(uayayayayt) Leases = [...]; }; interface org.freedesktop.DBus.Peer { ... }; interface org.freedesktop.DBus.Introspectable { ... }; interface org.freedesktop.DBus.Properties { ... }; }; Provides information about leases.
EXAMPLES
Example 1. Introspect org.freedesktop.network1.Manager on the bus $ gdbus introspect --system \ --dest org.freedesktop.network1 \ --object-path /org/freedesktop/network1 Example 2. Introspect org.freedesktop.network1.Link on the bus $ gdbus introspect --system \ --dest org.freedesktop.network1 \ --object-path /org/freedesktop/network1/link/_11
VERSIONING
These D-Bus interfaces follow the usual interface versioning guidelines[1].
NOTES
1. the usual interface versioning guidelines http://0pointer.de/blog/projects/versioning-dbus.html