diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/Makefile.am | 121 | ||||
| -rw-r--r-- | man/avahi-autoipd.8.xml.in | 28 | ||||
| -rw-r--r-- | man/avahi-autoipd.action.8.xml.in | 20 | ||||
| -rw-r--r-- | man/avahi-bookmarks.1.xml.in | 26 | ||||
| -rw-r--r-- | man/avahi-browse.1.xml.in | 4 | ||||
| -rw-r--r-- | man/avahi-daemon.8.xml.in | 28 | ||||
| -rw-r--r-- | man/avahi-daemon.conf.5.xml.in | 654 | ||||
| -rw-r--r-- | man/avahi-discover.1.xml.in | 24 | ||||
| -rw-r--r-- | man/avahi-dnsconfd.8.xml.in | 29 | ||||
| -rw-r--r-- | man/avahi-dnsconfd.action.8.xml.in | 24 | ||||
| -rw-r--r-- | man/avahi-publish.1.xml.in | 24 | ||||
| -rw-r--r-- | man/avahi-resolve.1.xml.in | 24 | ||||
| -rw-r--r-- | man/avahi-set-host-name.1.xml.in | 22 | ||||
| -rw-r--r-- | man/avahi.hosts.5.xml.in | 18 | ||||
| -rw-r--r-- | man/avahi.service.5.xml.in | 22 | ||||
| -rw-r--r-- | man/bssh.1.xml.in | 2 | ||||
| -rw-r--r-- | man/xmltoman.css | 2 | ||||
| -rw-r--r-- | man/xmltoman.dtd | 6 | ||||
| -rw-r--r-- | man/xmltoman.xsl | 2 |
19 files changed, 487 insertions, 593 deletions
diff --git a/man/Makefile.am b/man/Makefile.am index 7d08828..d38267c 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -1,5 +1,3 @@ -# $Id$ - # This file is part of avahi. # # avahi is free software; you can redistribute it and/or modify it @@ -83,125 +81,24 @@ man_MANS += \ endif endif -avahi-browse.1.xml: avahi-browse.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-publish.1.xml: avahi-publish.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-resolve.1.xml: avahi-resolve.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-set-host-name.1.xml: avahi-set-host-name.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-daemon.8.xml: avahi-daemon.8.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@servicedir\@,$(servicedir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-discover.1.xml: avahi-discover.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-bookmarks.1.xml: avahi-bookmarks.1.xml.in Makefile - sed -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-dnsconfd.8.xml: avahi-dnsconfd.8.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-daemon.conf.5.xml: avahi-daemon.conf.5.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-dnsconfd.action.8.xml: avahi-dnsconfd.action.8.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi.service.5.xml: avahi.service.5.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ +%.xml: %.xml.in Makefile + $(AM_V_GEN) sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ -e 's,@servicedir\@,$(servicedir),g' \ -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi.hosts.5.xml: avahi.hosts.5.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-autoipd.action.8.xml: avahi-autoipd.action.8.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -avahi-autoipd.8.xml: avahi-autoipd.8.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ - -bssh.1.xml: bssh.1.xml.in Makefile - sed -e 's,@pkgsysconfdir\@,$(pkgsysconfdir),g' \ - -e 's,@PACKAGE_BUGREPORT\@,$(PACKAGE_BUGREPORT),g' \ - -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ + -e 's,@PACKAGE_URL\@,$(PACKAGE_URL),g' $< > $@ if USE_XMLTOMAN CLEANFILES += $(man_MANS) -avahi-browse.1: avahi-browse.1.xml Makefile - xmltoman $< > $@ - -avahi-publish.1: avahi-publish.1.xml Makefile - xmltoman $< > $@ - -avahi-resolve.1: avahi-resolve.1.xml Makefile - xmltoman $< > $@ - -avahi-set-host-name.1: avahi-set-host-name.1.xml Makefile - xmltoman $< > $@ - -avahi-daemon.8: avahi-daemon.8.xml Makefile - xmltoman $< > $@ - -avahi-discover.1: avahi-discover.1.xml Makefile - xmltoman $< > $@ - -avahi-bookmarks.1: avahi-bookmarks.1.xml Makefile - xmltoman $< > $@ - -avahi-dnsconfd.8: avahi-dnsconfd.8.xml Makefile - xmltoman $< > $@ - -avahi-daemon.conf.5: avahi-daemon.conf.5.xml Makefile - xmltoman $< > $@ - -avahi-dnsconfd.action.8: avahi-dnsconfd.action.8.xml Makefile - xmltoman $< > $@ - -avahi.service.5: avahi.service.5.xml Makefile - xmltoman $< > $@ - -avahi.hosts.5: avahi.hosts.5.xml Makefile - xmltoman $< > $@ - -avahi-autoipd.action.8: avahi-autoipd.action.8.xml Makefile - xmltoman $< > $@ +%.1: %.1.xml Makefile + $(AM_V_GEN)xmltoman $< > $@ -avahi-autoipd.8: avahi-autoipd.8.xml Makefile - xmltoman $< > $@ +%.5: %.5.xml Makefile + $(AM_V_GEN)xmltoman $< > $@ -bssh.1: bssh.1.xml Makefile - xmltoman $< > $@ +%.8: %.8.xml Makefile + $(AM_V_GEN)xmltoman $< > $@ xmllint: $(noinst_DATA) for f in $(noinst_DATA) ; do \ diff --git a/man/avahi-autoipd.8.xml.in b/man/avahi-autoipd.8.xml.in index 2e7bb67..477beb8 100644 --- a/man/avahi-autoipd.8.xml.in +++ b/man/avahi-autoipd.8.xml.in @@ -2,21 +2,19 @@ <!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 @@ -31,7 +29,7 @@ <cmd>avahi-autoipd <opt>--refresh</opt> <arg>interface</arg></cmd> <cmd>avahi-autoipd <opt>--check</opt> <arg>interface</arg></cmd> </synopsis> - + <description> <p>avahi-autoipd implements IPv4LL, "Dynamic Configuration of IPv4 Link-Local Addresses" (IETF RFC3927), a protocol for @@ -56,7 +54,7 @@ <p>See http://developer.apple.com/qa/qa2004/qa1357.html for more information.</p> </description> - + <options> <option> @@ -91,7 +89,7 @@ <option> <p><opt>--no-drop-root</opt></p> - <optdesc><p>Don't drop root priviliges after startup. We recommend not to use this option.</p></optdesc> + <optdesc><p>Don't drop root privileges after startup. We recommend not to use this option.</p></optdesc> </option> <option> @@ -108,7 +106,7 @@ <p><opt>-w | --wait</opt></p> <optdesc><p>Wait until a IP address has been sucessfully acquired before detaching. Only valid in combination with <opt>--daemonize</opt>.</p></optdesc> </option> - + <option> <p><opt>--force-bind</opt></p> <optdesc><p>Acquire an IPv4LL address, even if a routable address has been configured on the interface.</p></optdesc> @@ -135,9 +133,9 @@ </options> <section name="Files"> - + <p><file>@pkgsysconfdir@/avahi-autoipd.action</file>: the script to run when an IP address as been acquired or is lost.</p> - + </section> <section name="Signals"> @@ -149,7 +147,7 @@ <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is available from <url href="@PACKAGE_URL@"/></p> </section> - + <section name="See also"> <p> <manref name="autoipd.action" section="8"/>, <manref name="dhclient" section="8"/> @@ -157,10 +155,10 @@ <p>http://avahi.org/wiki/AvahiAutoipd documents how avahi-autoipd is best packaged and integrated into distributions.</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> diff --git a/man/avahi-autoipd.action.8.xml.in b/man/avahi-autoipd.action.8.xml.in index 1eb6750..9dea446 100644 --- a/man/avahi-autoipd.action.8.xml.in +++ b/man/avahi-autoipd.action.8.xml.in @@ -2,21 +2,19 @@ <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> -<!-- $Id: avahi-autoipd.action.8.xml.in 263 2005-08-07 19:53:39Z lennart $ --> - -<!-- +<!-- 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 @@ -28,7 +26,7 @@ <synopsis> <cmd>@pkgsysconfdir@/avahi-autoipd.action</cmd> </synopsis> - + <description> <p><file>avahi-autoipd.action</file> is the action script that is called whenever an IP address has been acquired by @@ -36,7 +34,7 @@ script should add or remove the specified address from the specified network interface.</p> </description> - + <section name="Parameters"> <option> @@ -70,16 +68,16 @@ <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is available from <url href="@PACKAGE_URL@"/></p> </section> - + <section name="See also"> <p> <manref name="avahi-autoipd" section="8"/>, <manref name="dhclient-script" section="8"/>, <manref name="ip" section="8"/>, <manref name="ifconfig" section="8"/> </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> diff --git a/man/avahi-bookmarks.1.xml.in b/man/avahi-bookmarks.1.xml.in index 9bebd76..d863e2b 100644 --- a/man/avahi-bookmarks.1.xml.in +++ b/man/avahi-bookmarks.1.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,7 +26,7 @@ <synopsis> <cmd>avahi-bookmarks</cmd> </synopsis> - + <description> <p>A web service for listing HTTP services that are announced via mDNS/DNS-SD using the Avahi daemon. avahi-bookmarks opens a @@ -36,9 +34,9 @@ returning a dynamic web site containing links to all services of type _http._tcp on the LAN. Point your browser to http://localhost:8080/ to make use of avahi-bookmarks.</p> - + </description> - + <options> <option> <p><opt>-p | --port=</opt> <arg>PORT</arg></p> @@ -69,11 +67,11 @@ locally. This option conflicts with -H.</p></optdesc> </option> - + <option> <p><opt>-d | --domain</opt>=<arg>DOMAIN</arg></p> <optdesc><p>The domain to browse for services in.</p></optdesc> - </option> + </option> <option> <p><opt>-h | --help</opt></p> @@ -86,16 +84,16 @@ <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is available from <url href="@PACKAGE_URL@"/></p> </section> - + <section name="See also"> <p> <manref name="avahi-browse" section="1"/>, <manref name="avahi-daemon" section="8"/> </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> diff --git a/man/avahi-browse.1.xml.in b/man/avahi-browse.1.xml.in index 90b2d35..b13d4fc 100644 --- a/man/avahi-browse.1.xml.in +++ b/man/avahi-browse.1.xml.in @@ -2,8 +2,6 @@ <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> -<!-- $Id$ --> - <!-- This file is part of avahi. @@ -93,7 +91,7 @@ <option> <p><opt>-p | --parsable</opt></p> - <optdesc><p>Make output easily parsable for usage in scripts. If enabled fields are seperated by semicolons (;), service names are escaped. It is recommended to combine this with <opt>--no-db-lookup</opt>.</p></optdesc> + <optdesc><p>Make output easily parsable for usage in scripts. If enabled fields are separated by semicolons (;), service names are escaped. It is recommended to combine this with <opt>--no-db-lookup</opt>.</p></optdesc> </option> <option> diff --git a/man/avahi-daemon.8.xml.in b/man/avahi-daemon.8.xml.in index b45e8c1..e93fc73 100644 --- a/man/avahi-daemon.8.xml.in +++ b/man/avahi-daemon.8.xml.in @@ -2,21 +2,19 @@ <!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 @@ -31,7 +29,7 @@ <cmd>avahi-daemon <opt>--reload</opt></cmd> <cmd>avahi-daemon <opt>--check</opt></cmd> </synopsis> - + <description> <p>The Avahi mDNS/DNS-SD daemon implements Apple's Zeroconf architecture (also known as "Rendezvous" or "Bonjour"). The daemon @@ -44,7 +42,7 @@ (a libc NSS plugin, providing name resolution via mDNS). Finally there is the D-Bus interface which provides a rich object oriented interface to D-Bus enabled applications.</p> - + <p>Upon startup avahi-daemon interprets its configuration file <file>@pkgsysconfdir@/avahi-daemon.conf</file> and reads XML fragments from <file>@servicedir@/*.service</file> which may @@ -53,7 +51,7 @@ <file>avahi-daemon.conf</file> the file <file>/etc/resolv.conf</file> will be read, too.</p> </description> - + <options> <option> @@ -83,7 +81,7 @@ <option> <p><opt>--no-drop-root</opt></p> - <optdesc><p>Don't drop root priviliges after startup and don't require daemon to be started as root. We recommend not to use this option.</p></optdesc> + <optdesc><p>Don't drop root privileges after startup and don't require daemon to be started as root. We recommend not to use this option.</p></optdesc> </option> <option> @@ -134,13 +132,13 @@ </options> <section name="Files"> - + <p><file>@pkgsysconfdir@/avahi-daemon.conf</file>: the default configuration file for avahi-daemon, <manref name="avahi-daemon.conf" section="5"/> for more information.</p> <p><file>@pkgsysconfdir@/hosts</file>: additional static hostname mappings to publish in mDNS, see <manref name="avahi.hosts" section="5"/> for more information.</p> <p><file>@servicedir@/*.service</file>: static service definitions, see <manref name="avahi.service" section="5"/> for more information.</p> - + </section> <section name="Signals"> @@ -155,7 +153,7 @@ <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.conf" section="5"/>, <manref name="avahi.hosts" section="5"/>, <manref name="avahi.service" section="5"/>, <manref name="avahi-dnsconfd" section="8"/>, <manref name="avahi-set-host-name" section="1"/> @@ -163,10 +161,10 @@ <p>http://avahi.org/wiki/AvahiAndUnicastDotLocal documents the problems when using Avahi in a unicast DNS zone .local.</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> diff --git a/man/avahi-daemon.conf.5.xml.in b/man/avahi-daemon.conf.5.xml.in index 08992fa..62f3a9d 100644 --- a/man/avahi-daemon.conf.5.xml.in +++ b/man/avahi-daemon.conf.5.xml.in @@ -2,8 +2,6 @@ <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> -<!-- $Id$ --> - <!-- This file is part of avahi. @@ -23,315 +21,343 @@ USA. --> - <manpage name="avahi-daemon.conf" section="5" desc="avahi-daemon configuration file"> - - <synopsis> - <cmd>@pkgsysconfdir@/avahi-daemon.conf</cmd> - </synopsis> - - <description> - <p><file>avahi-daemon.conf</file> is the configuration file for avahi-daemon.</p> - </description> - - <section name="Section [Server]"> - - <option> - <p><opt>host-name=</opt> Set the host name avahi-daemon tries - to register on the LAN. If omited defaults to the system host - name as set with the sethostname() system call.</p> - </option> - - <option> - <p><opt>domain-name=</opt> Set the default domain name avahi-daemon - tries to register its host name and services on the LAN in. If - omitted defaults to ".local".</p> - </option> - - <option> - <p><opt>browse-domains=</opt> Set a comma seperated list of - browsing domains (in addition to the default one and those - announced inside the default browsing domain). Please note - that the user may specify additional browsing domains on the - client side, either by setting $AVAHI_BROWSE_DOMAINS to a list - of colon seperated domains or by adding them to the XDG config - file <file>~/.config/avahi/browse-domains</file> (seperated by - newlines).</p> - - </option> - - <option> - <p><opt>use-ipv4=</opt> Takes a boolean value ("yes" or - "no"). If set to "no" avahi-daemon will not use IPv4 - sockets. Default is "yes".</p> - </option> - - <option> - <p><opt>use-ipv6=</opt> Takes a boolean value ("yes" or - "no"). If set to "no" avahi-daemon will not use IPv6 - sockets. Default is "yes".</p> - </option> - - <option> - <p><opt>allow-interfaces=</opt> Set a comma seperated list of - allowed network interfaces that should be used by the - avahi-daemon. Other interfaces will be ignored. If set to the - empty list all local interfaces except loopback and - point-to-point will be used.</p> - </option> - - <option> - <p><opt>deny-interfaces=</opt> Set a comma seperated list of - network interfaces that should be ignored by avahi-daemon. - Other not specified interfaces will be used, unless - <opt>allow-interfaces</opt> is set. This option takes - precedence over <opt>deny-interfaces</opt>.</p> - </option> - - <option> - <p><opt>check-response-ttl=</opt> Takes a boolean value ("yes" - or "no"). If set to "yes", an additional security check is - activated: incoming IP packets will be ignored unless the IP - TTL is 255. Earlier mDNS specifications required this - check. Since this feature may be incompatible with newer - implementations of mDNS it defaults to "no". On the other hand - it provides extra security.</p> - </option> - - <option> - <p><opt>use-iff-running=</opt> Takes a boolean value ("yes" or - "no"). If set to "yes" avahi-daemon monitors the IFF_RUNNING - flag bit which is used by some (modern) network drivers to - tell user space if a network cable is plugged in (in case of - copper ethernet), or the network card is associated with some - kind of network (in case of WLAN). If IFF_RUNNING is set - avahi-daemon will automatically announce its services on that - network. Unfortunately far too many network drivers do not - support this flag or support it in a broken way. Therefore - this option defaults to "no".</p> - </option> - - <option> - <p><opt>enable-dbus=</opt> Takes either "yes", "no" or - "warn". If set to "yes" avahi-daemon connects to D-Bus, - offering an object oriented client API. It is only available - if Avahi has been compiled with <opt>--enable-dbus</opt> in - which case it defaults to "yes". "warn" behaves like "yes", - but the daemon starts up even when it fails to connect to a - D-Bus daemon. In addition, if the connection to the D-Bus - daemon is terminated we try to reconnect. (Unless we are in a - chroot() environment where this definitely will fail.) </p> - </option> - - <option> - <p><opt>disallow-other-stacks=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes" no other process is allowed - to bind to UDP port 5353. This effectively impedes other mDNS - stacks from running on the host. Use this as a security - measure to make sure that only Avahi is responsible for mDNS - traffic. Please note that we do not recommend running multiple - mDNS stacks on the same host simultaneously. This hampers - reliability and is a waste of resources. However, to not annoy - people this option defaults to "no".</p> - </option> - - <option> - <p><opt>allow-point-to-point=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes" avahi-daemon will make use of - interfaces with the POINTOPOINT flag set. This option defaults - to "no" as it might make mDNS unreliable due to usually large - latencies with such links and opens a potential security hole - by allowing mDNS access from Internet connections. Use with - care and YMMV!</p> - </option> - - </section> - - <section name="Section [wide-area]"> - <option> - <p><opt>enable-wide-area=</opt> Takes a boolean value - ("yes" or "no"). Enable wide-area DNS-SD, aka - DNS-SD over unicast DNS. If this is enabled only domains - ending in .local will be resolved on mDNS, all other domains - are resolved via unicast DNS. If you want to maintain multiple - different multicast DNS domains even with this option enabled - we encourage you to use subdomains of .local, such as - "kitchen.local". This option defaults to "yes".</p> - </option> - - </section> - - <section name="Section [publish]"> - - <option><p><opt>disable-publishing=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes", no record will be published by - Avahi, not even address records for the local host. Avahi will - be started in a querying-only mode. Use this is a security - measure. This option defaults to "no"</p></option> - - <option><p><opt>disable-user-service-publishing=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes", Avahi will still publish - address records and suchlike but will not allow user - applications to publish services. Use this is a security - measure. This option defaults to "no"</p></option> - - <option> - <p><opt>add-service-cookie=</opt> Takes a boolean value ("yes" - or "no"). If set to "yes" an implicit TXT entry will be added - to all locally registered services, containing a cookie value - which is chosen randomly on daemon startup. This can be used - to detect if two services on two different - interfaces/protocols are actually identical. Defaults to - "no".</p> - </option> - - <option> - <p><opt>publish-addresses=</opt> Takes a boolean value ("yes" - or "no"). If set to "yes" avahi-daemon will register mDNS - address records for all local IP addresses. Unless you want to - use avahi-daemon exclusively for browsing it's recommended to - enable this. If you plan to register local services you need - to enable this option. Defaults to "yes".</p> - </option> - - <option> - <p><opt>publish-hinfo=</opt> Takes a boolean value ("yes" or - "no"). If set to "yes" avahi-daemon will register an mDNS - HINFO record on all interfaces which contains information - about the local operating system and CPU, which might be - useful for administrative purposes. This is recommended by the - mDNS specification but not required. For the sake of privacy - you might choose to disable this feature. Defaults to - "yes."</p> - </option> - - <option> - <p><opt>publish-workstation=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes" avahi-daemon will register a - service of type "_workstation._tcp" on the local LAN. This - might be useful for administrative purposes (i.e. browse for - all PCs on the LAN), but is not required or recommended by any - specification. Newer MacOS X releases register a service of - this type. Defaults to "yes".</p> - </option> - - <option> - <p><opt>publish-domain=</opt> Takes a boolean value ("yes" or - "no"). If set to "yes" avahi-daemon will announce the locally - used domain name (see above) for browsing by other - hosts. Defaults to "yes".</p> - </option> - - <option> - <p><opt>publish-dns-servers=</opt> Takes a comma seperated - list of IP addresses for unicast DNS servers. You can use this - to announce unicast DNS servers via mDNS. When used in - conjunction with avahi-dnsconfd on the client - side this allows DHCP-like configuration of unicast DNS - servers.</p> - </option> - - <option> - <p><opt>publish-resolv-conf-dns-servers=</opt> Takes a boolean - value ("yes" or "no"). If set to "yes" avahi-daemon will - publish the unicast DNS servers specified in - <file>/etc/resolv.conf</file> in addition to those specified - with <opt>publish-dns-servers</opt>. Send avahi-daemon a - SIGHUP to have it reload this file. Defaults to "no".</p> - </option> - - <option> - <p><opt>publish-aaaa-on-ipv4=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes" avahi-daemon will publish an - IPv6 AAAA record via IPv4, i.e. the local IPv6 addresses can be - resolved using an IPv4 transport. Only useful when IPv4 is - enabled with <opt>use-ipv4=true</opt>. Defaults to "yes".</p> - </option> - - <option> - <p><opt>publish-a-on-ipv6=</opt> Takes a boolean value - ("yes" or "no"). If set to "yes" avahi-daemon will publish an - IPv4 A record via IPv6, i.e. the local IPv4 addresses can be - resolved using an IPv6 transport. Only useful when IPv6 is - enabled with <opt>use-ipv6=true</opt>. Defaults to "no".</p> - </option> - - </section> - - <section name="Section [reflector]"> - <option> - <p><opt>enable-reflector=</opt> Takes a boolean value ("yes" - or "no"). If set to "yes" avahi-daemon will reflect incoming - mDNS requests to all local network interfaces, effectively - allowing clients to browse mDNS/DNS-SD services on all - networks connected to the gateway. The gateway is somewhat - intelligent and should work with all kinds of mDNS traffic, - though some functionality is lost (specifically the unicast - reply bit, which is used rarely anyway). Make sure to not run - multiple reflectors between the same networks, this might - cause them to play Ping Pong with mDNS packets. Defaults to - "no".</p> - </option> - - <option> - <p><opt>reflect-ipv=</opt> Takes a boolean value ("yes" or - "no"). If set to "yes" and <opt>enable-reflector</opt> is - enabled, avahi-daemon will forward mDNS traffic between IPv4 - and IPv6, which is usually not recommended. Defaults to "no".</p> - </option> - </section> - - <section name="Section [rlimits]"> - <p>This section is used to define system resource limits for the - daemon. See <manref section="2" name="setrlimit"/> for more - information. If any of the options is not specified in the configuration - file, avahi-daemon does not change it from the system - defaults.</p> - - - <option> - <p><opt>rlimit-as=</opt> Value in bytes for RLIMIT_AS (maximum size of the process's virtual memory). Sensible values are heavily system dependent.</p> - </option> - - <option> - <p><opt>rlimit-core=</opt> Value in bytes for RLIMIT_CORE (maximum core file size). Unless you want to debug avahi-daemon, it is safe to set this to 0.</p> - </option> - - <option> - <p><opt>rlimit-data=</opt> Value in bytes for RLIMIT_DATA (maximum size of the process's data segment). Sensible values are heavily system dependent.</p> - </option> - - <option> - <p><opt>rlimit-fsize=</opt> Value for RLIMIT_FSIZE (maximum size of files the process may create). Since avahi-daemon shouldn't write any files to disk, it is safe to set this to 0.</p> - </option> - - <option> - <p><opt>rlimit-nofile=</opt> Value for RLIMIT_NOFILE (open file descriptors). avahi-daemon shouldn't need more than 15 to 20 open file descriptors concurrently.</p> - </option> - - <option> - <p><opt>rlimit-stack=</opt> Value in bytes for RLIMIT_STACK (maximum size of the process stack). Sensible values are heavily system dependent.</p> - </option> - - <option> - <p><opt>rlimit-nproc=</opt> Value for RLIMIT_NPROC (number of process of user). avahi-daemon forks of a helper process on systems where <manref name="chroot" section="2"/> is available. Therefore this value should not be set below 2.</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-dnsconfd" section="8"/> - </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> +<manpage name="avahi-daemon.conf" section="5" desc="avahi-daemon configuration file"> + + <synopsis> + <cmd>@pkgsysconfdir@/avahi-daemon.conf</cmd> + </synopsis> + + <description> + <p><file>avahi-daemon.conf</file> is the configuration file for avahi-daemon.</p> + </description> + + <section name="Section [Server]"> + + <option> + <p><opt>host-name=</opt> Set the host name avahi-daemon tries + to register on the LAN. If omited defaults to the system host + name as set with the sethostname() system call.</p> + </option> + + <option> + <p><opt>domain-name=</opt> Set the default domain name avahi-daemon + tries to register its host name and services on the LAN in. If + omitted defaults to ".local".</p> + </option> + + <option> + <p><opt>browse-domains=</opt> Set a comma separated list of + browsing domains (in addition to the default one and those + announced inside the default browsing domain). Please note + that the user may specify additional browsing domains on the + client side, either by setting $AVAHI_BROWSE_DOMAINS to a list + of colon separated domains or by adding them to the XDG config + file <file>~/.config/avahi/browse-domains</file> (separated by + newlines).</p> + + </option> + + <option> + <p><opt>use-ipv4=</opt> Takes a boolean value ("yes" or + "no"). If set to "no" avahi-daemon will not use IPv4 + sockets. Default is "yes".</p> + </option> + + <option> + <p><opt>use-ipv6=</opt> Takes a boolean value ("yes" or + "no"). If set to "no" avahi-daemon will not use IPv6 + sockets. Default is "yes".</p> + </option> + + <option> + <p><opt>allow-interfaces=</opt> Set a comma separated list of + allowed network interfaces that should be used by the + avahi-daemon. Traffic on other interfaces will be ignored. If + set to an empty list all local interfaces except loopback and + point-to-point will be used.</p> + </option> + + <option> + <p><opt>deny-interfaces=</opt> Set a comma separated list of + network interfaces that should be ignored by avahi-daemon. + Other not specified interfaces will be used, unless + <opt>allow-interfaces=</opt> is set. This option takes + precedence over <opt>allow-interfaces=</opt>.</p> + </option> + + <option> + <p><opt>check-response-ttl=</opt> Takes a boolean value ("yes" + or "no"). If set to "yes", an additional security check is + activated: incoming IP packets will be ignored unless the IP + TTL is 255. Earlier mDNS specifications required this + check. Since this feature may be incompatible with newer + implementations of mDNS it defaults to "no". On the other hand + it provides extra security.</p> + </option> + + <option> + <p><opt>use-iff-running=</opt> Takes a boolean value ("yes" or + "no"). If set to "yes" avahi-daemon monitors the IFF_RUNNING + flag bit which is used by some (modern) network drivers to + tell user space if a network cable is plugged in (in case of + copper ethernet), or the network card is associated with some + kind of network (in case of WLAN). If IFF_RUNNING is set + avahi-daemon will automatically announce its services on that + network. Unfortunately far too many network drivers do not + support this flag or support it in a broken way. Therefore + this option defaults to "no".</p> + </option> + + <option> + <p><opt>enable-dbus=</opt> Takes either "yes", "no" or + "warn". If set to "yes" avahi-daemon connects to D-Bus, + offering an object oriented client API. It is only available + if Avahi has been compiled with <opt>--enable-dbus</opt> in + which case it defaults to "yes". "warn" behaves like "yes", + but the daemon starts up even when it fails to connect to a + D-Bus daemon. In addition, if the connection to the D-Bus + daemon is terminated we try to reconnect. (Unless we are in a + chroot() environment where this definitely will fail.) </p> + </option> + + <option> + <p><opt>disallow-other-stacks=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes" no other process is allowed + to bind to UDP port 5353. This effectively impedes other mDNS + stacks from running on the host. Use this as a security + measure to make sure that only Avahi is responsible for mDNS + traffic. Please note that we do not recommend running multiple + mDNS stacks on the same host simultaneously. This hampers + reliability and is a waste of resources. However, to not annoy + people this option defaults to "no".</p> + </option> + + <option> + <p><opt>allow-point-to-point=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes" avahi-daemon will make use of + interfaces with the POINTOPOINT flag set. This option defaults + to "no" as it might make mDNS unreliable due to usually large + latencies with such links and opens a potential security hole + by allowing mDNS access from Internet connections. Use with + care and YMMV!</p> + </option> + + <option> + <p><opt>cache-entries-max=</opt> Takes an unsigned integer + specifying how many resource records are cached per + interface. Bigger values allow mDNS work correctly in large LANs + but also increase memory consumption.</p> + </option> + + <option> + <p><opt>clients-max=</opt> Takes an unsigned integer. The + maximum number of concurrent D-Bus clients allowed. If the + maximum number is reached further clients will be refused until + at least one existing client disconnects.</p> + </option> + + <option> + <p><opt>objects-per-client-max=</opt> Takes an unsigned + integer. The maximum number of objects (entry groups, browsers, + resolvers) that may be registered per client at a time. If the + maximum number is reached further object creation will be + refused until at least one object is freed.</p> + </option> + + <option> + <p><opt>entries-per-entry-group-max=</opt> Takes an unsigned + integer. The maximum number of entries (resource records) per + entry group at a time. If the maximum number is reached further + resource records may not be added to an entry group.</p> + </option> + + </section> + + <section name="Section [wide-area]"> + <option> + <p><opt>enable-wide-area=</opt> Takes a boolean value + ("yes" or "no"). Enable wide-area DNS-SD, aka + DNS-SD over unicast DNS. If this is enabled only domains + ending in .local will be resolved on mDNS, all other domains + are resolved via unicast DNS. If you want to maintain multiple + different multicast DNS domains even with this option enabled + we encourage you to use subdomains of .local, such as + "kitchen.local". This option defaults to "yes".</p> + </option> + + </section> + + <section name="Section [publish]"> + + <option><p><opt>disable-publishing=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes", no record will be published by + Avahi, not even address records for the local host. Avahi will + be started in a querying-only mode. Use this is a security + measure. This option defaults to "no"</p></option> + + <option><p><opt>disable-user-service-publishing=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes", Avahi will still publish + address records and suchlike but will not allow user + applications to publish services. Use this is a security + measure. This option defaults to "no"</p></option> + + <option> + <p><opt>add-service-cookie=</opt> Takes a boolean value ("yes" + or "no"). If set to "yes" an implicit TXT entry will be added + to all locally registered services, containing a cookie value + which is chosen randomly on daemon startup. This can be used + to detect if two services on two different + interfaces/protocols are actually identical. Defaults to + "no".</p> + </option> + + <option> + <p><opt>publish-addresses=</opt> Takes a boolean value ("yes" + or "no"). If set to "yes" avahi-daemon will register mDNS + address records for all local IP addresses. Unless you want to + use avahi-daemon exclusively for browsing it's recommended to + enable this. If you plan to register local services you need + to enable this option. Defaults to "yes".</p> + </option> + + <option> + <p><opt>publish-hinfo=</opt> Takes a boolean value ("yes" or + "no"). If set to "yes" avahi-daemon will register an mDNS + HINFO record on all interfaces which contains information + about the local operating system and CPU, which might be + useful for administrative purposes. This is recommended by the + mDNS specification but not required. For the sake of privacy + you might choose to disable this feature. Defaults to + "yes."</p> + </option> + + <option> + <p><opt>publish-workstation=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes" avahi-daemon will register a + service of type "_workstation._tcp" on the local LAN. This + might be useful for administrative purposes (i.e. browse for + all PCs on the LAN), but is not required or recommended by any + specification. Newer MacOS X releases register a service of + this type. Defaults to "yes".</p> + </option> + + <option> + <p><opt>publish-domain=</opt> Takes a boolean value ("yes" or + "no"). If set to "yes" avahi-daemon will announce the locally + used domain name (see above) for browsing by other + hosts. Defaults to "yes".</p> + </option> + + <option> + <p><opt>publish-dns-servers=</opt> Takes a comma separated + list of IP addresses for unicast DNS servers. You can use this + to announce unicast DNS servers via mDNS. When used in + conjunction with avahi-dnsconfd on the client + side this allows DHCP-like configuration of unicast DNS + servers.</p> + </option> + + <option> + <p><opt>publish-resolv-conf-dns-servers=</opt> Takes a boolean + value ("yes" or "no"). If set to "yes" avahi-daemon will + publish the unicast DNS servers specified in + <file>/etc/resolv.conf</file> in addition to those specified + with <opt>publish-dns-servers</opt>. Send avahi-daemon a + SIGHUP to have it reload this file. Defaults to "no".</p> + </option> + + <option> + <p><opt>publish-aaaa-on-ipv4=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes" avahi-daemon will publish an + IPv6 AAAA record via IPv4, i.e. the local IPv6 addresses can be + resolved using an IPv4 transport. Only useful when IPv4 is + enabled with <opt>use-ipv4=true</opt>. Defaults to "yes".</p> + </option> + + <option> + <p><opt>publish-a-on-ipv6=</opt> Takes a boolean value + ("yes" or "no"). If set to "yes" avahi-daemon will publish an + IPv4 A record via IPv6, i.e. the local IPv4 addresses can be + resolved using an IPv6 transport. Only useful when IPv6 is + enabled with <opt>use-ipv6=true</opt>. Defaults to "no".</p> + </option> + + </section> + + <section name="Section [reflector]"> + <option> + <p><opt>enable-reflector=</opt> Takes a boolean value ("yes" + or "no"). If set to "yes" avahi-daemon will reflect incoming + mDNS requests to all local network interfaces, effectively + allowing clients to browse mDNS/DNS-SD services on all + networks connected to the gateway. The gateway is somewhat + intelligent and should work with all kinds of mDNS traffic, + though some functionality is lost (specifically the unicast + reply bit, which is used rarely anyway). Make sure to not run + multiple reflectors between the same networks, this might + cause them to play Ping Pong with mDNS packets. Defaults to + "no".</p> + </option> + + <option> + <p><opt>reflect-ipv=</opt> Takes a boolean value ("yes" or + "no"). If set to "yes" and <opt>enable-reflector</opt> is + enabled, avahi-daemon will forward mDNS traffic between IPv4 + and IPv6, which is usually not recommended. Defaults to "no".</p> + </option> + </section> + + <section name="Section [rlimits]"> + <p>This section is used to define system resource limits for the + daemon. See <manref section="2" name="setrlimit"/> for more + information. If any of the options is not specified in the configuration + file, avahi-daemon does not change it from the system + defaults.</p> + + <option> + <p><opt>rlimit-as=</opt> Value in bytes for RLIMIT_AS (maximum size of the process's virtual memory). Sensible values are heavily system dependent.</p> + </option> + + <option> + <p><opt>rlimit-core=</opt> Value in bytes for RLIMIT_CORE (maximum core file size). Unless you want to debug avahi-daemon, it is safe to set this to 0.</p> + </option> + + <option> + <p><opt>rlimit-data=</opt> Value in bytes for RLIMIT_DATA (maximum size of the process's data segment). Sensible values are heavily system dependent.</p> + </option> + + <option> + <p><opt>rlimit-fsize=</opt> Value for RLIMIT_FSIZE (maximum size of files the process may create). Since avahi-daemon shouldn't write any files to disk, it is safe to set this to 0.</p> + </option> + + <option> + <p><opt>rlimit-nofile=</opt> Value for RLIMIT_NOFILE (open file descriptors). avahi-daemon shouldn't need more than 15 to 20 open file descriptors concurrently.</p> + </option> + + <option> + <p><opt>rlimit-stack=</opt> Value in bytes for RLIMIT_STACK (maximum size of the process stack). Sensible values are heavily system dependent.</p> + </option> + + <option> + <p><opt>rlimit-nproc=</opt> Value for RLIMIT_NPROC (number of process of user). avahi-daemon forks of a helper process on systems where <manref name="chroot" section="2"/> is available. Therefore this value should not be set below 2.</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-dnsconfd" section="8"/> + </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> diff --git a/man/avahi-discover.1.xml.in b/man/avahi-discover.1.xml.in index 5d4f878..e311f1f 100644 --- a/man/avahi-discover.1.xml.in +++ b/man/avahi-discover.1.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,34 +26,34 @@ <synopsis> <cmd>avahi-discover</cmd> </synopsis> - + <description> <p>Show a real-time graphical browse list for mDNS/DNS-SD network services running on the local LAN using the Avahi daemon.</p> - + </description> - + <options> <p>avahi-discover takes no command line arguments at the moment.</p> </options> - + <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-browse" section="1"/> </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> diff --git a/man/avahi-dnsconfd.8.xml.in b/man/avahi-dnsconfd.8.xml.in index c74e1ba..e01ab44 100644 --- a/man/avahi-dnsconfd.8.xml.in +++ b/man/avahi-dnsconfd.8.xml.in @@ -2,21 +2,19 @@ <!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 @@ -31,7 +29,7 @@ <cmd>avahi-dnsconfd <opt>--refresh</opt></cmd> <cmd>avahi-dnsconfd <opt>--check</opt></cmd> </synopsis> - + <description> <p>avahi-dnsconfd connects to a running avahi-daemon and runs the script <file>@pkgsysconfdir@/dnsconfd.action</file> for each unicast DNS @@ -39,7 +37,7 @@ configuring unicast DNS servers in a DHCP-like fashion with mDNS.</p> </description> - + <options> <option> @@ -47,6 +45,11 @@ <optdesc><p>Daemonize after startup and redirect log messages to syslog.</p></optdesc> </option> + <option> + <p><opt>-s | --syslog</opt></p> + <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt>.</p></optdesc> + </option> + <option> <p><opt>-k | --kill</opt></p> <optdesc><p>Kill an already running avahi-dnsconfd. (equivalent to sending a SIGTERM)</p></optdesc> @@ -75,9 +78,9 @@ </options> <section name="Files"> - + <p><file>@pkgsysconfdir@/avahi-dnsconfd.action</file>: the script to run when a DNS server is found or removed.</p> - + </section> <section name="Signals"> @@ -89,16 +92,16 @@ <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-dnsconfd.action" section="8"/> </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> diff --git a/man/avahi-dnsconfd.action.8.xml.in b/man/avahi-dnsconfd.action.8.xml.in index 6811422..f4ae37e 100644 --- a/man/avahi-dnsconfd.action.8.xml.in +++ b/man/avahi-dnsconfd.action.8.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,7 +26,7 @@ <synopsis> <cmd>@pkgsysconfdir@/avahi-dnsconfd.action</cmd> </synopsis> - + <description> <p><file>avahi-dnsconfd.action</file> is the action script that is called whenever a new unicast DNS server is found or @@ -36,7 +34,7 @@ with avahi patches <file>/etc/resolv.conf</file> to reflect the changed unicast DNS server configuration.</p> </description> - + <section name="Parameters"> <option> @@ -61,7 +59,7 @@ <option> <p><opt>AVAHI_INTERFACE</opt> Contains the textual interface name the corresponds with argv[3]. (e.g. "eth0")</p> </option> - + <option><p><opt>AVAHI_INTERFACE_DNS_SERVERS</opt> Contains a list of all DNS servers that avahi-dnsconfd found on the interface <opt>$AVAHI_INTERFACE</opt>, separated by @@ -71,22 +69,22 @@ DNS server that avahi-dnsconfd found on all interfaces, separated by spaces.</p></option> - </section> + </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-dnsconfd" section="8"/>, <manref name="avahi-daemon" section="8"/> </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> diff --git a/man/avahi-publish.1.xml.in b/man/avahi-publish.1.xml.in index 5ab476a..bb8dbda 100644 --- a/man/avahi-publish.1.xml.in +++ b/man/avahi-publish.1.xml.in @@ -2,21 +2,19 @@ <!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 @@ -31,11 +29,11 @@ <cmd>avahi-publish -a [<arg>options</arg>] <arg>host name</arg> <arg>address</arg></cmd> <cmd>avahi-publish-address [<arg>options</arg>] <arg>host name</arg> <arg>address</arg></cmd> </synopsis> - + <description> <p>Register an mDNS/DNS-SD service or host name/address mapping using the Avahi daemon.</p> </description> - + <options> <p>When calling in service registration mode, specify a DNS-SD @@ -45,7 +43,7 @@ command line. When calling in address/host name registration mode specify a fully qualified host name and an address (IPv4 or IPv6).</p> - + <option> <p><opt>-s | --service</opt></p> <optdesc><p>Register a service. avahi-publish-service is equivalent to avahi-publish -s.</p></optdesc> @@ -102,12 +100,12 @@ </option> </options> - + <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-resolve" section="1"/>, <manref @@ -115,10 +113,10 @@ name="avahi-daemon" section="8"/> </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> diff --git a/man/avahi-resolve.1.xml.in b/man/avahi-resolve.1.xml.in index 3f9bbc6..e444cb9 100644 --- a/man/avahi-resolve.1.xml.in +++ b/man/avahi-resolve.1.xml.in @@ -2,21 +2,19 @@ <!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 @@ -31,13 +29,13 @@ <cmd>avahi-resolve --address <arg>address ...</arg></cmd> <cmd>avahi-resolve-address <arg>address ...</arg></cmd> </synopsis> - + <description> <p>Resolve one or more mDNS/DNS host name(s) to IP address(es) (and vice versa) using the Avahi daemon.</p> </description> - + <options> - + <p>When passing -n, specify one or more fully qualified mDNS/DNS host name(s) (e.g. "foo.local") to resolve into IP addresses on the command line. When passing -a, specify one or more IP address @@ -90,18 +88,18 @@ <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is available from <url href="@PACKAGE_URL@"/></p> </section> - + <section name="See also"> <p> - <manref name="avahi-publish-address" section="1"/>, + <manref name="avahi-publish-address" section="1"/>, <manref name="avahi-daemon" section="8"/> </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> diff --git a/man/avahi-set-host-name.1.xml.in b/man/avahi-set-host-name.1.xml.in index a49db10..407bbe7 100644 --- a/man/avahi-set-host-name.1.xml.in +++ b/man/avahi-set-host-name.1.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,15 +26,15 @@ <synopsis> <cmd>avahi-set-host-name <arg>host-name</arg></cmd> </synopsis> - + <description> <p>Set the mDNS host name of a currently running Avahi daemon. The effect of this operation is not persistent across daemon restarts. This operation is usually privileged.</p> </description> - + <options> - + <option> <p><opt>-v | --verbose</opt></p> <optdesc><p>Enable verbose mode.</p></optdesc> @@ -60,16 +58,16 @@ <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"/> </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> diff --git a/man/avahi.hosts.5.xml.in b/man/avahi.hosts.5.xml.in index 5a92547..eff2848 100644 --- a/man/avahi.hosts.5.xml.in +++ b/man/avahi.hosts.5.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,7 +26,7 @@ <synopsis> <cmd>@pkgsysconfdir@/hosts</cmd> </synopsis> - + <description> <p><file>@pkgsysconfdir@/hosts</file> is a file which may be used to define static host name to IP address mappings for multicast @@ -46,17 +44,17 @@ <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.service" 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> diff --git a/man/avahi.service.5.xml.in b/man/avahi.service.5.xml.in index 0005903..6598617 100644 --- a/man/avahi.service.5.xml.in +++ b/man/avahi.service.5.xml.in @@ -2,21 +2,19 @@ <!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 @@ -28,16 +26,16 @@ <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 @@ -108,17 +106,17 @@ <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> diff --git a/man/bssh.1.xml.in b/man/bssh.1.xml.in index 2a3fdcf..6df640d 100644 --- a/man/bssh.1.xml.in +++ b/man/bssh.1.xml.in @@ -2,8 +2,6 @@ <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> -<!-- $Id$ --> - <!-- This file is part of avahi. diff --git a/man/xmltoman.css b/man/xmltoman.css index 4c80847..6b3235b 100644 --- a/man/xmltoman.css +++ b/man/xmltoman.css @@ -1,5 +1,3 @@ -/* $Id$ */ - /*** This file is part of avahi. diff --git a/man/xmltoman.dtd b/man/xmltoman.dtd index 50158dc..968dd5f 100644 --- a/man/xmltoman.dtd +++ b/man/xmltoman.dtd @@ -1,6 +1,4 @@ -<!-- $Id$ --> - -<!-- +<!-- This file is part of avahi. avahi is free software; you can redistribute it and/or modify it under @@ -15,7 +13,7 @@ You should have received a copy of the GNU 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. + Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. --> <!ELEMENT manpage (synopsis | description | section | options | seealso)*> diff --git a/man/xmltoman.xsl b/man/xmltoman.xsl index 96c9d81..1a344c2 100644 --- a/man/xmltoman.xsl +++ b/man/xmltoman.xsl @@ -19,8 +19,6 @@ Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. --> -<!-- $Id$ --> - <xsl:output method="xml" version="1.0" encoding="iso-8859-15" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" indent="yes"/> <xsl:template match="/manpage"> |