| <?xml version="1.0"?><!--*-nxml-*--> |
| <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> |
| <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> |
| |
| <!-- |
| 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 |
| USA. |
| --> |
| |
| <manpage name="avahi.service" section="5" desc="avahi-daemon static service file"> |
| |
| <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> |
| |
| <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 |
| <opt><service></opt> elements.</p> |
| </option> |
| |
| <option> |
| <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 |
| Terminal on %h". If <opt>replace-wildcards</opt> is not |
| specified, defaults to "no".</p> |
| </option> |
| |
| <option> |
| <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>, 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 |
| of the avahi daemon. (probably .local)</p> |
| </option> |
| |
| <option> |
| <p><opt><host-name></opt> 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 |
| <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><txt-record></opt> DNS-SD TXT record data.</p> |
| </option> |
| |
| |
| </section> |
| |
| <section name="Authors"> |
| <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.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> |
