mirror of
https://github.com/systemd/systemd.git
synced 2024-11-27 04:03:36 +08:00
503 lines
17 KiB
XML
503 lines
17 KiB
XML
<?xml version="1.0"?>
|
|
<!--*-nxml-*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
|
|
<!ENTITY % entities SYSTEM "custom-entities.ent" >
|
|
%entities;
|
|
]>
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
|
|
<refentry id="org.freedesktop.network1" conditional='ENABLE_NETWORKD'
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
<refentryinfo>
|
|
<title>org.freedesktop.network1</title>
|
|
<productname>systemd</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>org.freedesktop.network1</refentrytitle>
|
|
<manvolnum>5</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>org.freedesktop.network1</refname>
|
|
<refpurpose>The D-Bus interface of systemd-networkd</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1>
|
|
<title>Introduction</title>
|
|
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
is a system service that manages and configures network interfaces. This page describes the D-Bus
|
|
interface.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>The Manager Object</title>
|
|
|
|
<para>The service exposes the following interfaces on the Manager object on the bus:</para>
|
|
|
|
<programlisting executable="systemd-networkd" node="/org/freedesktop/network1" interface="org.freedesktop.network1.Manager">
|
|
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 { ... };
|
|
};
|
|
</programlisting>
|
|
|
|
<!--method ListLinks is not documented!-->
|
|
|
|
<!--method GetLinkByName is not documented!-->
|
|
|
|
<!--method GetLinkByIndex is not documented!-->
|
|
|
|
<!--method SetLinkNTP is not documented!-->
|
|
|
|
<!--method SetLinkDNS is not documented!-->
|
|
|
|
<!--method SetLinkDNSEx is not documented!-->
|
|
|
|
<!--method SetLinkDomains is not documented!-->
|
|
|
|
<!--method SetLinkDefaultRoute is not documented!-->
|
|
|
|
<!--method SetLinkLLMNR is not documented!-->
|
|
|
|
<!--method SetLinkMulticastDNS is not documented!-->
|
|
|
|
<!--method SetLinkDNSOverTLS is not documented!-->
|
|
|
|
<!--method SetLinkDNSSEC is not documented!-->
|
|
|
|
<!--method SetLinkDNSSECNegativeTrustAnchors is not documented!-->
|
|
|
|
<!--method RevertLinkNTP is not documented!-->
|
|
|
|
<!--method RevertLinkDNS is not documented!-->
|
|
|
|
<!--method RenewLink is not documented!-->
|
|
|
|
<!--method ForceRenewLink is not documented!-->
|
|
|
|
<!--method ReconfigureLink is not documented!-->
|
|
|
|
<!--method Reload is not documented!-->
|
|
|
|
<!--method DescribeLink is not documented!-->
|
|
|
|
<!--method Describe is not documented!-->
|
|
|
|
<!--property OperationalState is not documented!-->
|
|
|
|
<!--property CarrierState is not documented!-->
|
|
|
|
<!--property AddressState is not documented!-->
|
|
|
|
<!--property IPv4AddressState is not documented!-->
|
|
|
|
<!--property IPv6AddressState is not documented!-->
|
|
|
|
<!--property OnlineState is not documented!-->
|
|
|
|
<!--property NamespaceId is not documented!-->
|
|
|
|
<!--Autogenerated cross-references for systemd.directives, do not edit-->
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Manager"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Manager"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="ListLinks()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="GetLinkByName()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="GetLinkByIndex()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkNTP()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDNSEx()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDomains()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDefaultRoute()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkLLMNR()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkMulticastDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDNSOverTLS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDNSSEC()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLinkDNSSECNegativeTrustAnchors()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="RevertLinkNTP()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="RevertLinkDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="RenewLink()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="ForceRenewLink()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="ReconfigureLink()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="Reload()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="DescribeLink()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="Describe()"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="OperationalState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="CarrierState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="IPv4AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="IPv6AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="OnlineState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="NamespaceId"/>
|
|
|
|
<!--End of Autogenerated section-->
|
|
|
|
<para>
|
|
Provides information about the manager.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Link Object</title>
|
|
|
|
<programlisting executable="systemd-networkd" node="/org/freedesktop/network1/link/_1" interface="org.freedesktop.network1.Link">
|
|
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 { ... };
|
|
};
|
|
</programlisting>
|
|
|
|
<!--method SetNTP is not documented!-->
|
|
|
|
<!--method SetDNS is not documented!-->
|
|
|
|
<!--method SetDNSEx is not documented!-->
|
|
|
|
<!--method SetDomains is not documented!-->
|
|
|
|
<!--method SetDefaultRoute is not documented!-->
|
|
|
|
<!--method SetLLMNR is not documented!-->
|
|
|
|
<!--method SetMulticastDNS is not documented!-->
|
|
|
|
<!--method SetDNSOverTLS is not documented!-->
|
|
|
|
<!--method SetDNSSEC is not documented!-->
|
|
|
|
<!--method SetDNSSECNegativeTrustAnchors is not documented!-->
|
|
|
|
<!--method RevertNTP is not documented!-->
|
|
|
|
<!--method RevertDNS is not documented!-->
|
|
|
|
<!--method Renew is not documented!-->
|
|
|
|
<!--method ForceRenew is not documented!-->
|
|
|
|
<!--method Reconfigure is not documented!-->
|
|
|
|
<!--method Describe is not documented!-->
|
|
|
|
<!--property OperationalState is not documented!-->
|
|
|
|
<!--property CarrierState is not documented!-->
|
|
|
|
<!--property AddressState is not documented!-->
|
|
|
|
<!--property IPv4AddressState is not documented!-->
|
|
|
|
<!--property IPv6AddressState is not documented!-->
|
|
|
|
<!--property OnlineState is not documented!-->
|
|
|
|
<!--property AdministrativeState is not documented!-->
|
|
|
|
<!--property BitRates is not documented!-->
|
|
|
|
<!--Autogenerated cross-references for systemd.directives, do not edit-->
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPServer"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPServer"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetNTP()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDNSEx()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDomains()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDefaultRoute()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetLLMNR()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetMulticastDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDNSOverTLS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDNSSEC()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="SetDNSSECNegativeTrustAnchors()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="RevertNTP()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="RevertDNS()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="Renew()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="ForceRenew()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="Reconfigure()"/>
|
|
|
|
<variablelist class="dbus-method" generated="True" extra-ref="Describe()"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="OperationalState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="CarrierState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="IPv4AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="IPv6AddressState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="OnlineState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="AdministrativeState"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="BitRates"/>
|
|
|
|
<!--End of Autogenerated section-->
|
|
|
|
<para>
|
|
Provides information about interfaces.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Network Object</title>
|
|
|
|
<programlisting executable="systemd-networkd" node="/org/freedesktop/network1/network/_1" interface="org.freedesktop.network1.Network">
|
|
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 { ... };
|
|
};
|
|
</programlisting>
|
|
|
|
<!--property Description is not documented!-->
|
|
|
|
<!--property SourcePath is not documented!-->
|
|
|
|
<!--property MatchMAC is not documented!-->
|
|
|
|
<!--property MatchPath is not documented!-->
|
|
|
|
<!--property MatchDriver is not documented!-->
|
|
|
|
<!--property MatchType is not documented!-->
|
|
|
|
<!--property MatchName is not documented!-->
|
|
|
|
<!--Autogenerated cross-references for systemd.directives, do not edit-->
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Network"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Network"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="Description"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="SourcePath"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="MatchMAC"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="MatchPath"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="MatchDriver"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="MatchType"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="MatchName"/>
|
|
|
|
<!--End of Autogenerated section-->
|
|
|
|
<para>
|
|
Provides information about .network files.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>DHCP Server Object</title>
|
|
|
|
<programlisting executable="systemd-networkd" node="/org/freedesktop/network1/link/_1" interface="org.freedesktop.network1.DHCPServer">
|
|
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 { ... };
|
|
};
|
|
</programlisting>
|
|
|
|
<!--property Leases is not documented!-->
|
|
|
|
<!--Autogenerated cross-references for systemd.directives, do not edit-->
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPServer"/>
|
|
|
|
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPServer"/>
|
|
|
|
<variablelist class="dbus-property" generated="True" extra-ref="Leases"/>
|
|
|
|
<!--End of Autogenerated section-->
|
|
|
|
<para>
|
|
Provides information about leases.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Examples</title>
|
|
|
|
<example>
|
|
<title>Introspect <interfacename>org.freedesktop.network1.Manager</interfacename> on the bus</title>
|
|
|
|
<programlisting>
|
|
$ gdbus introspect --system \
|
|
--dest org.freedesktop.network1 \
|
|
--object-path /org/freedesktop/network1
|
|
</programlisting>
|
|
</example>
|
|
|
|
<example>
|
|
<title>Introspect <interfacename>org.freedesktop.network1.Link</interfacename> on the bus</title>
|
|
|
|
<programlisting>
|
|
$ gdbus introspect --system \
|
|
--dest org.freedesktop.network1 \
|
|
--object-path /org/freedesktop/network1/link/_11
|
|
</programlisting>
|
|
</example>
|
|
</refsect1>
|
|
|
|
<xi:include href="org.freedesktop.locale1.xml" xpointer="versioning"/>
|
|
</refentry>
|