<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
-<!-- $Id$ -->
-
-<!--
+<!--
This file is part of avahi.
-
+
avahi is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version.
-
+
avahi is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
Public License for more details.
-
+
You should have received a copy of the GNU Lesser General Public
License along with avahi; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
<synopsis>
<cmd>@servicedir@/*.service</cmd>
</synopsis>
-
+
<description> <p><file>@servicedir@/*.service</file> 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)</p> </description>
-
+ implementing _ipp._tcp and _printer._tcp)</p> </description>
+
<section name="XML Tags">
-
+
<option>
<p><opt><service-group></opt> The document tag of avahi
service files. Should contain one <opt><name></opt> and one or more
</option>
<option>
- <p><opt><name replace-wildcards="yes|no"/></opt> The
+ <p><opt><name replace-wildcards="yes|no"></opt> The
service name. If <opt>replace-wildcards</opt> is "yes", any
occurence of the string "%h" will be replaced by the local
host name. This can be used for service names like "Remote
</option>
<option>
- <p><opt><service></opt> Contains the service information
- for exactly one service type. Should contain one
- <opt><type></opt> and one <opt><port></opt>
- element. Optionally it may contain one
+ <p><opt><service protocol="ipv4|ipv6|any"></opt>
+ Contains the service information for exactly one service
+ type. Should contain one <opt><type></opt> and one
+ <opt><port></opt> element. Optionally it may contain one
<opt><domain-name></opt>, one
- <opt><host-name></opt> and multiple
- <opt><txt-record></opt> elements.</p>
+ <opt><host-name></opt>, any number of
+ <opt><subtype></opt> and any number of
+ <opt><txt-record></opt> elements. The attribute
+ <opt>protocol</opt> specifies the protocol to advertise the
+ service on. If <opt>any</opt> is used (which is the default),
+ the service will be advertised on both IPv4 and IPv6.</p>
</option>
-
<option>
<p><opt><type></opt> Contains the DNS-SD service type for this service. e.g. "_http._tcp".</p>
</option>
+ <option>
+ <p><opt><subtype></opt> Contains an additional DNS-SD service subtype for this service. e.g. "_anon._sub._ftp._tcp".</p>
+ </option>
+
<option>
<p><opt><domain-name></opt> The domain name this service
should be registered. If omited defaults to the default domain
<option>
<p><opt><host-name></opt> The host name of the host that
- provides this service. This should be a mDNS resolvable host
- name. Please note that you need to specify a fully-qualified
- domain name (FQDN) here, i.e. .local is not appended! The host
- name needs not to be part of the domain specified in
- <opt><domain-name></opt>.</p>
+ 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
+ <opt><domain-name></opt>. See <manref name="avahi.hosts"
+ section="5"/> for more information how to publish additional
+ host name mappings.</p>
</option>
<option>
<p><opt><port></opt> The IP port number the service listens on.</p>
</option>
- <option>
- <p><opt><protocol></opt> The protocol to advertise the service on, can be any of <opt>ipv4</opt>, <opt>ipv6</opt> or <opt>any</opt>.</p>
- </option>
-
<option>
<p><opt><txt-record></opt> DNS-SD TXT record data.</p>
</option>
</section>
<section name="Authors">
- <p>The avahi developers <@PACKAGE_BUGREPORT@>; avahi is
+ <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is
available from <url href="@PACKAGE_URL@"/></p>
</section>
-
+
<section name="See also">
<p>
- <manref name="avahi-daemon" section="8"/>
+ <manref name="avahi-daemon" section="8"/>, <manref name="avahi.hosts" section="5"/>
</p>
</section>
-
+
<section name="Comments">
<p>This man page was written using <manref name="xml2man"
section="1" href="http://masqmail.cx/xml2man/"/> by Oliver
Kurth.</p>
</section>
-
+
</manpage>