summaryrefslogtreecommitdiffstats
path: root/man/org.freedesktop.resolve1.xml
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-25 02:54:52 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-25 02:54:52 +0000
commit51fac37bb20c9440a9a4e0a20846c139364d6d13 (patch)
tree77c11a0dffc2c15542689f3a51d12d5076c477e8 /man/org.freedesktop.resolve1.xml
parentAdding upstream version 255.4. (diff)
downloadsystemd-51fac37bb20c9440a9a4e0a20846c139364d6d13.tar.xz
systemd-51fac37bb20c9440a9a4e0a20846c139364d6d13.zip
Adding upstream version 255.5.upstream/255.5
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/org.freedesktop.resolve1.xml')
-rw-r--r--man/org.freedesktop.resolve1.xml39
1 files changed, 27 insertions, 12 deletions
diff --git a/man/org.freedesktop.resolve1.xml b/man/org.freedesktop.resolve1.xml
index f9cba4f..c6b0153 100644
--- a/man/org.freedesktop.resolve1.xml
+++ b/man/org.freedesktop.resolve1.xml
@@ -156,16 +156,6 @@ node /org/freedesktop/resolve1 {
};
</programlisting>
- <!--method RegisterService is not documented!-->
-
- <!--method UnregisterService is not documented!-->
-
- <!--method FlushCaches is not documented!-->
-
- <!--method ResetServerFeatures is not documented!-->
-
- <!--property DNSSECNegativeTrustAnchors is not documented!-->
-
<!--Autogenerated cross-references for systemd.directives, do not edit-->
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.resolve1.Manager"/>
@@ -433,6 +423,30 @@ node /org/freedesktop/resolve1 {
<para>The <function>RevertLink()</function> method may be used to revert all per-link settings
described above to the defaults.</para>
+ <para>The <function>FlushCaches()</function> flushes all resource record caches maintained by the
+ resolver, and ensures that any subsequent lookups re-request their responses from their sources.</para>
+
+ <para>The <function>ResetServerFeatures()</function> flushes any feature information learned about
+ remote DNS servers. This ensures that subsequent lookups will be initially attempted at the highest DNS
+ protocol feature level again, possibly requiring a (potentially slow) downgrade cycle to recognize the
+ supported feature level again.</para>
+
+ <para>The <function>RegisterService()</function> method may be used to register a DNS-SD service on the
+ host. This functionality is closely related to the functionality provided by
+ <citerefentry><refentrytitle>systemd.dnssd</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ files. It takes a server identifier string as first parameter (this is jus a local identifier, and
+ should be chosen so that it neither collides with the basename of <filename>*.dnssd</filename> files
+ nor with names chosen by other IPC clients). It also takes a name template string for the DNS-SD
+ service name visible on the network. This string is subject to specifier expansation, as documented for
+ the <varname>Name=</varname> setting in <filename>*.dnssd</filename> files. It also takes a service
+ type string containing the DNS-SD service type, as well as an IP port, a priority/weight pair for the
+ DNS-SD SRV record. Finally, it takes an array of TXT record data. It returns an object path which may be
+ used as handle to the registered service.</para>
+
+ <para>The <function>UnregisterService()</function> method undoes the effect of
+ <function>RegisterService()</function> and deletes a DNS-SD service previously created via IPC
+ again.</para>
+
<refsect3>
<title>The Flags Parameter</title>
@@ -635,6 +649,9 @@ node /org/freedesktop/resolve1 {
enabled. Possible values are <literal>yes</literal> (enabled), <literal>no</literal> (disabled),
<literal>udp</literal> (only the UDP listener is enabled), and <literal>tcp</literal> (only the TCP
listener is enabled).</para>
+
+ <para>The <varname>DNSSECNegativeTrustAnchors</varname> property contains a list of recognized DNSSEC
+ negative trust anchors and contains a list of domains.</para>
</refsect2>
</refsect1>
@@ -689,8 +706,6 @@ node /org/freedesktop/resolve1/link/_1 {
};
</programlisting>
- <!--property DNSSECNegativeTrustAnchors is not documented!-->
-
<!--Autogenerated cross-references for systemd.directives, do not edit-->
<variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.resolve1.Link"/>