man-pages/man5/avahi.service.5.html
2021-03-31 01:06:50 +01:00

76 lines
5.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of avahi.service</TITLE>
</HEAD><BODY>
<H1>avahi.service</H1>
Section: File Formats (5)<BR>Updated: User<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
avahi.service - avahi-daemon static service file
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>/etc/avahi/services/*.service
</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<I>/etc/avahi/services/*.service</I> are XML fragments containing static DNS-SD service data. Every service file can contain multiple service definitions which share the same name. This is useful for publishing service data for services which implement multiple protocols. (i.e. a printer implementing _ipp._tcp and _printer._tcp)
<A NAME="lbAE">&nbsp;</A>
<H2>XML TAGS</H2>
<DL COMPACT>
<DT id="1"><B>&lt;service-group&gt;</B> The document tag of avahi service files. Should contain one <B>&lt;name&gt;</B> and one or more <B>&lt;service&gt;</B> elements.<DD>
<DT id="2"><B>&lt;name replace-wildcards=&quot;yes|no&quot;&gt;</B> The service name. If <B>replace-wildcards</B> is &quot;yes&quot;, any occurence of the string &quot;%h&quot; will be replaced by the local host name. This can be used for service names like &quot;Remote Terminal on %h&quot;. If <B>replace-wildcards</B> is not specified, defaults to &quot;no&quot;.<DD>
<DT id="3"><B>&lt;service protocol=&quot;ipv4|ipv6|any&quot;&gt;</B> Contains the service information for exactly one service type. Should contain one <B>&lt;type&gt;</B> and one <B>&lt;port&gt;</B> element. Optionally it may contain one <B>&lt;domain-name&gt;</B>, one <B>&lt;host-name&gt;</B>, any number of <B>&lt;subtype&gt;</B> and any number of <B>&lt;txt-record&gt;</B> elements. The attribute <B>protocol</B> specifies the protocol to advertise the service on. If <B>any</B> is used (which is the default), the service will be advertised on both IPv4 and IPv6.<DD>
<DT id="4"><B>&lt;type&gt;</B> Contains the DNS-SD service type for this service. e.g. &quot;_http._tcp&quot;.<DD>
<DT id="5"><B>&lt;subtype&gt;</B> Contains an additional DNS-SD service subtype for this service. e.g. &quot;_anon._sub._<A HREF="ftp://ftp._tcp">ftp._tcp</A>&quot;.<DD>
<DT id="6"><B>&lt;domain-name&gt;</B> The domain name this service should be registered. If omited defaults to the default domain of the avahi daemon. (probably .local)<DD>
<DT id="7"><B>&lt;host-name&gt;</B> The host name of the host that provides this service. This should be a host that is resolvable by multicast or unicast DNS. Please note that you need to specify a fully-qualified domain name (FQDN) here, i.e. .local is not appended implicitly! The host name doesn't need to be part of the domain specified in <B>&lt;domain-name&gt;</B>. See <B><A HREF="/cgi-bin/man/man2html?5+avahi.hosts">avahi.hosts</A>(5)</B> for more information how to publish additional host name mappings.<DD>
<DT id="8"><B>&lt;port&gt;</B> The IP port number the service listens on.<DD>
<DT id="9"><B>&lt;txt-record value-format=&quot;text|binary-hex|binary-base64&quot;&gt;</B> DNS-SD TXT record data. If <B>value-format</B> is &quot;text&quot;, the value of the TXT record is taken verbatim. If <B>value-format</B> is &quot;binary-hex&quot; then the value of TXT record is decoded by taking pairs of characters after the &quot;=&quot; char and interpreting them as the textual representation of the two-digit hexadecimal number. Both uppercase and lowercase hexadecimal digits are allowed. The 0x or 0X prefix is not allowed. This requires the length of the value to be even. If <B>value-format</B> is &quot;binary-base64&quot; then the value of TXT record is decoded with a base64 decoder. The character set used is A-Za-z0-9+/. This requires the length of the value to be a multiple of 4, with &quot;=&quot; as padding at the end. If <B>value-format</B> is not specified, defaults to &quot;text&quot;. Examples (all the values are decoded to the string &quot;value&quot; without quotes):<DD>
<P>
&lt;txt-record&gt;key=value&lt;txt-record&gt;
<P>
&lt;txt-record value-format=&quot;text&quot;&gt;key=value&lt;txt-record&gt;
<P>
&lt;txt-record value-format=&quot;binary-hex&quot;&gt;key=76616c7565&lt;txt-record&gt;
<P>
&lt;txt-record value-format=&quot;binary-base64&quot;&gt;key=dmFsdWU=&lt;txt-record&gt;
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHORS</H2>
The Avahi Developers &lt;avahi (at) lists (dot) freedesktop (dot) org&gt;; Avahi is available from <B><A HREF="http://avahi.org/">http://avahi.org/</A></B>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+avahi-daemon">avahi-daemon</A>(8)</B>, <B><A HREF="/cgi-bin/man/man2html?5+avahi.hosts">avahi.hosts</A>(5)</B>
<A NAME="lbAH">&nbsp;</A>
<H2>COMMENTS</H2>
This man page was written using <B><A HREF="/cgi-bin/man/man2html?1+xml2man">xml2man</A>(1)</B> by Oliver Kurth.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="13"><A HREF="#lbAE">XML TAGS</A><DD>
<DT id="14"><A HREF="#lbAF">AUTHORS</A><DD>
<DT id="15"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="16"><A HREF="#lbAH">COMMENTS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:02 GMT, March 31, 2021
</BODY>
</HTML>