org.freedesktop.network1(5) — Linux manual page

NAME | INTRODUCTION | THE MANAGER OBJECT | LINK OBJECT | NETWORK OBJECT | DHCP SERVER OBJECT | DHCPV4 CLIENT OBJECT | DHCPV6 CLIENT OBJECT | EXAMPLES | VERSIONING | HISTORY | NOTES | COLOPHON

ORG.FREE....NETWORK1(5) org.freedesktop.network1 ORG.FREE....NETWORK1(5)

NAME         top

       org.freedesktop.network1 - The D-Bus interface of
       systemd-networkd

INTRODUCTION         top

       systemd-networkd.service(8) is a system service that manages and
       configures network interfaces. This page describes the D-Bus
       interface.

THE MANAGER OBJECT         top

       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         top

           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 { ... };
           };

       Provides information about interfaces.

NETWORK OBJECT         top

           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         top

           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 { ... };
             interface org.freedesktop.network1.Link { ... };
           };

       Provides information about leases.

DHCPV4 CLIENT OBJECT         top

           node /org/freedesktop/network1/link/_1 {
             interface org.freedesktop.network1.DHCPv4Client {
               properties:
                 readonly s State = '...';
             };
             interface org.freedesktop.DBus.Peer { ... };
             interface org.freedesktop.DBus.Introspectable { ... };
             interface org.freedesktop.DBus.Properties { ... };
             interface org.freedesktop.network1.Link { ... };
           };

       Provides information about DHCPv4 client status.

DHCPV6 CLIENT OBJECT         top

           node /org/freedesktop/network1/link/_1 {
             interface org.freedesktop.network1.DHCPv6Client {
               properties:
                 readonly s State = '...';
             };
             interface org.freedesktop.DBus.Peer { ... };
             interface org.freedesktop.DBus.Introspectable { ... };
             interface org.freedesktop.DBus.Properties { ... };
             interface org.freedesktop.network1.Link { ... };
           };

       Provides information about DHCPv6 client status.

EXAMPLES         top

       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         top

       These D-Bus interfaces follow the usual interface versioning
       guidelines[1].

HISTORY         top

   DHCPv4 Client Object
       State was added in version 255.

   DHCPv6 Client Object
       State was added in version 255.

NOTES         top

        1. the usual interface versioning guidelines
           https://0pointer.de/blog/projects/versioning-dbus.html

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have
       a bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2023-12-22.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-12-22.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

systemd 255                                      ORG.FREE....NETWORK1(5)

Pages that refer to this page: systemd.directives(7)systemd.index(7)