1 <?xml version="1.0"?><!--*-nxml-*--> 2 <!DOCTYPE manpage SYSTEM "xmltoman.dtd"> 3 <?xml-stylesheet type="text/xsl" href="xmltoman.xsl" ?> 4 5 <!-- 6 This file is part of avahi. 7 8 avahi is free software; you can redistribute it and/or modify it 9 under the terms of the GNU Lesser General Public License as 10 published by the Free Software Foundation; either version 2.1 of the 11 License, or (at your option) any later version. 12 13 avahi is distributed in the hope that it will be useful, but WITHOUT 14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 15 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General 16 Public License for more details. 17 18 You should have received a copy of the GNU Lesser General Public 19 License along with avahi; if not, write to the Free Software 20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 21 USA. 22 --> 23 24 <manpage name="avahi-autoipd" section="8" desc="IPv4LL network address configuration daemon"> 25 26 <synopsis> 27 <cmd>avahi-autoipd [<arg>options</arg>] <arg>interface</arg></cmd> 28 <cmd>avahi-autoipd <opt>--kill</opt> <arg>interface</arg></cmd> 29 <cmd>avahi-autoipd <opt>--refresh</opt> <arg>interface</arg></cmd> 30 <cmd>avahi-autoipd <opt>--check</opt> <arg>interface</arg></cmd> 31 </synopsis> 32 33 <description> 34 <p>avahi-autoipd implements IPv4LL, "Dynamic Configuration of 35 IPv4 Link-Local Addresses" (IETF RFC3927), a protocol for 36 automatic IP address configuration from the link-local 37 169.254.0.0/16 range without the need for a central server. It 38 is primarily intended to be used in ad-hoc networks which lack a 39 DHCP server.</p> 40 41 <p>IPv4LL is part of the Zeroconf stack.</p> 42 43 <p>avahi-autoipd can be used as stand-alone address allocator 44 or as plugin for a DHCP client such as ISC's dhclient, where it 45 can be used as fallback solution if no DHCP server is found.</p> 46 47 <p>To allow communication between hosts that have only an IPv4LL 48 address assigned and hosts that only have a routable IP address 49 assigned you may add the following routes to both network 50 configurations:</p> 51 52 <p><opt>route add -net 169.254.0.0 netmask 255.255.0.0 dev eth0 metric 99</opt></p> 53 <p><opt>route add default dev eth0 metric 99</opt></p> 54 55 <p>See http://developer.apple.com/qa/qa2004/qa1357.html for more information.</p> 56 </description> 57 58 <options> 59 60 <option> 61 <p><opt>-D | --daemonize</opt></p> 62 <optdesc><p>Daemonize after startup. Implies <opt>--syslog</opt>.</p></optdesc> 63 </option> 64 65 <option> 66 <p><opt>-k | --kill</opt></p> 67 <optdesc><p>Kill an already running avahi-autoipd on the specified network interface. (Equivalent to sending a SIGTERM)</p></optdesc> 68 </option> 69 70 <option> 71 <p><opt>-r | --refresh</opt></p> 72 <optdesc><p>Tell an already running avahi-autoipd to re-announce the acquired IP address on the specified network interface. (Equivalent to sending a SIGHUP)</p></optdesc> 73 </option> 74 75 <option> 76 <p><opt>-c | --check</opt></p> 77 <optdesc><p>Return 0 as return code if avahi-autoipd is already running for the specified network interface.</p></optdesc> 78 </option> 79 80 <option> 81 <p><opt>-s | --syslog</opt></p> 82 <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt>.</p></optdesc> 83 </option> 84 85 <option> 86 <p><opt>--debug</opt></p> 87 <optdesc><p>Enable verbose mode.</p></optdesc> 88 </option> 89 90 <option> 91 <p><opt>--no-drop-root</opt></p> 92 <optdesc><p>Don't drop root privileges after startup. We recommend not to use this option.</p></optdesc> 93 </option> 94 95 <option> 96 <p><opt>--no-chroot</opt></p> 97 <optdesc><p>Don't <manref section="2" name="chroot"/> the daemon. This option is only available when compiled with chroot() support.</p></optdesc> 98 </option> 99 100 <option> 101 <p><opt>-S | --start=</opt></p> 102 <optdesc><p>Try to acquire the specified IP address, which must be from the IPv4LL range 169.254.0.0/16.</p></optdesc> 103 </option> 104 105 <option> 106 <p><opt>-w | --wait</opt></p> 107 <optdesc><p>Wait until a IP address has been successfully acquired before detaching. Only valid in combination with <opt>--daemonize</opt>.</p></optdesc> 108 </option> 109 110 <option> 111 <p><opt>--force-bind</opt></p> 112 <optdesc><p>Acquire an IPv4LL address, even if a routable address has been configured on the interface.</p></optdesc> 113 </option> 114 115 <option> 116 <p><opt>--no-proc-title</opt></p> 117 <optdesc><p>Don't change the process name while 118 running. Unless this option is specified avahi-autoipd will 119 reflect its current state and the IP address in the process 120 title.</p></optdesc> 121 </option> 122 123 <option> 124 <p><opt>-h | --help</opt></p> 125 <optdesc><p>Show help.</p></optdesc> 126 </option> 127 128 <option> 129 <p><opt>-v | --version</opt></p> 130 <optdesc><p>Show version information.</p></optdesc> 131 </option> 132 133 </options> 134 135 <section name="Files"> 136 137 <p><file>@pkgsysconfdir (a] /avahi-autoipd.action</file>: the script to run when an IP address as been acquired or is lost.</p> 138 139 </section> 140 141 <section name="Signals"> 142 <p><arg>SIGINT, SIGTERM</arg>: avahi-autoipd will shutdown. (Same as <opt>--kill</opt>)</p> 143 <p><arg>SIGHUP</arg>: avahi-autoipd will re-announce the acquired IP address. (Same as <opt>--refresh</opt>)</p> 144 </section> 145 146 <section name="Authors"> 147 <p>The Avahi Developers <@PACKAGE_BUGREPORT@>; Avahi is 148 available from <url href="@PACKAGE_URL@"/></p> 149 </section> 150 151 <section name="See also"> 152 <p> 153 <manref name="autoipd.action" section="8"/>, <manref name="dhclient" section="8"/> 154 </p> 155 156 <p>http://avahi.org/wiki/AvahiAutoipd documents how avahi-autoipd is best packaged and integrated into distributions.</p> 157 </section> 158 159 <section name="Comments"> 160 <p>This man page was written using <manref name="xml2man" section="1" 161 href="http://masqmail.cx/xml2man/"/> by Oliver Kurth.</p> 162 </section> 163 164 </manpage> 165
