1<?xml version="1.0"?><!--*-nxml-*-->
2<!DOCTYPE manpage SYSTEM "xmltoman.dtd">
3<?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?>
4
5<!-- $Id$ -->
6
7<!-- 
8  This file is part of avahi.
9 
10  avahi is free software; you can redistribute it and/or modify it
11  under the terms of the GNU Lesser General Public License as
12  published by the Free Software Foundation; either version 2.1 of the
13  License, or (at your option) any later version.
14 
15  avahi is distributed in the hope that it will be useful, but WITHOUT
16  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
17  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
18  Public License for more details.
19 
20  You should have received a copy of the GNU Lesser General Public
21  License along with avahi; if not, write to the Free Software
22  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
23  USA.
24-->
25
26  <manpage name="avahi-bookmarks" section="1" desc="Web service showing mDNS/DNS-SD announced HTTP services using the Avahi daemon">
27
28	<synopsis>
29      <cmd>avahi-bookmarks</cmd>
30	</synopsis>
31	
32    <description>
33      <p>A web service for listing HTTP services that are announced
34      via mDNS/DNS-SD using the Avahi daemon. avahi-bookmarks opens a
35      TCP socket on port 8080 and waits for incoming HTTP connections
36      returning a dynamic web site containing links to all services of
37      type _http._tcp on the LAN. Point your browser to
38      http://localhost:8080/ to make use of avahi-bookmarks.</p>
39      
40	</description>
41	
42    <options>
43      <option>
44        <p><opt>-p | --port=</opt> <arg>PORT</arg></p>
45        <optdesc><p>Specify a TCP port number to listen on. If omitted defaults to 8080.</p></optdesc>
46      </option>
47
48      <option>
49        <p><opt>-a | --address=</opt> <arg>address</arg></p>
50        <optdesc><p>Specify an IP address to listen on. If omitted defaults to 127.0.0.1. Specify 0.0.0.0 if you want to allow remote access.</p></optdesc>
51      </option>
52
53      <option>
54        <p><opt>-H | --host-names</opt></p>
55        <optdesc><p>Create links pointing to mDNS host names instead
56        of resolved IP addreses. This is only compatible with your
57        browser if you run some kind of local NSS module to resolve
58        mDNS host names (e.g. nss-mdns). If both -A and -H are ommited
59        avahi-bookmarks detects whether NSS support is available
60        locally. This option conflicts with -A.</p></optdesc>
61      </option>
62
63      <option>
64        <p><opt>-A | --addresses</opt></p>
65        <optdesc><p>Create links pointing to numeric IP addresses
66        instead of mDNS host names. This will break access to hosts
67        running virtual servers. If both -A and -H are ommited
68        avahi-bookmarks detects whether NSS support is available
69        locally. This option conflicts with -H.</p></optdesc>
70      </option>
71
72    
73      <option>
74        <p><opt>-d | --domain</opt>=<arg>DOMAIN</arg></p>
75        <optdesc><p>The domain to browse for services in.</p></optdesc>
76      </option> 
77
78	  <option>
79		<p><opt>-h | --help</opt></p>
80		<optdesc><p>Show help</p></optdesc>
81	  </option>
82
83    </options>
84
85	<section name="Authors">
86	  <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
87	  available from <url href="@PACKAGE_URL@"/></p>
88	</section>
89	
90	<section name="See also">
91	  <p>
92        <manref name="avahi-browse" section="1"/>, <manref name="avahi-daemon" section="8"/>
93	  </p>
94	</section>
95	
96	<section name="Comments">
97	  <p>This man page was written using <manref name="xml2man" section="1"
98		  href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p>
99	</section>
100	
101  </manpage>
102