summaryrefslogtreecommitdiffstats
path: root/man/org.freedesktop.resolve1.xml
diff options
context:
space:
mode:
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 54f0a18..e6bc573 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>
@@ -634,6 +648,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>
@@ -688,8 +705,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"/>