man-pages/man8/avahi-autoipd.8.html
2021-03-31 01:06:50 +01:00

119 lines
5.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of avahi-autoipd</TITLE>
</HEAD><BODY>
<H1>avahi-autoipd</H1>
Section: Maintenance Commands (8)<BR>Updated: User<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
avahi-autoipd - IPv4LL network address configuration daemon
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>avahi-autoipd [</B><I>options</I><B>] </B><I>interface</I><B>
<P>
avahi-autoipd --kill </B><I>interface</I><B>
<P>
avahi-autoipd --refresh </B><I>interface</I><B>
<P>
avahi-autoipd --check </B><I>interface</I><B>
</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
avahi-autoipd implements IPv4LL, &quot;Dynamic Configuration of IPv4 Link-Local Addresses&quot; (IETF RFC3927), a protocol for automatic IP address configuration from the link-local 169.254.0.0/16 range without the need for a central server. It is primarily intended to be used in ad-hoc networks which lack a DHCP server.
<P>
IPv4LL is part of the Zeroconf stack.
<P>
avahi-autoipd can be used as stand-alone address allocator or as plugin for a DHCP client such as ISC's dhclient, where it can be used as fallback solution if no DHCP server is found.
<P>
To allow communication between hosts that have only an IPv4LL address assigned and hosts that only have a routable IP address assigned you may add the following routes to both network configurations:
<P>
<B>route add -net 169.254.0.0 netmask 255.255.0.0 dev eth0 metric 99</B>
<P>
<B>route add default dev eth0 metric 99</B>
<P>
See <A HREF="http://developer.apple.com/qa/qa2004/qa1357.html">http://developer.apple.com/qa/qa2004/qa1357.html</A> for more information.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-D | --daemonize</B><DD>
Daemonize after startup. Implies <B>--syslog</B>.
<DT id="2"><B>-k | --kill</B><DD>
Kill an already running avahi-autoipd on the specified network interface. (Equivalent to sending a SIGTERM)
<DT id="3"><B>-r | --refresh</B><DD>
Tell an already running avahi-autoipd to re-announce the acquired IP address on the specified network interface. (Equivalent to sending a SIGHUP)
<DT id="4"><B>-c | --check</B><DD>
Return 0 as return code if avahi-autoipd is already running for the specified network interface.
<DT id="5"><B>-s | --syslog</B><DD>
Log to syslog instead of STDERR. Implied by <B>--daemonize</B>.
<DT id="6"><B>--debug</B><DD>
Enable verbose mode.
<DT id="7"><B>--no-drop-root</B><DD>
Don't drop root privileges after startup. We recommend not to use this option.
<DT id="8"><B>--no-chroot</B><DD>
Don't <B><A HREF="/cgi-bin/man/man2html?2+chroot">chroot</A>(2)</B> the daemon. This option is only available when compiled with chroot() support.
<DT id="9"><B>-S | --start=</B><DD>
Try to acquire the specified IP address, which must be from the IPv4LL range 169.254.0.0/16.
<DT id="10"><B>-w | --wait</B><DD>
Wait until a IP address has been successfully acquired before detaching. Only valid in combination with <B>--daemonize</B>.
<DT id="11"><B>--force-bind</B><DD>
Acquire an IPv4LL address, even if a routable address has been configured on the interface.
<DT id="12"><B>--no-proc-title</B><DD>
Don't change the process name while running. Unless this option is specified avahi-autoipd will reflect its current state and the IP address in the process title.
<DT id="13"><B>-h | --help</B><DD>
Show help.
<DT id="14"><B>-v | --version</B><DD>
Show version information.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<I>/etc/avahi/avahi-autoipd.action</I>: the script to run when an IP address as been acquired or is lost.
<A NAME="lbAG">&nbsp;</A>
<H2>SIGNALS</H2>
<I>SIGINT, SIGTERM</I>: avahi-autoipd will shutdown. (Same as <B>--kill</B>)
<P>
<I>SIGHUP</I>: avahi-autoipd will re-announce the acquired IP address. (Same as <B>--refresh</B>)
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHORS</H2>
The Avahi Developers &lt;avahi (at) lists (dot) freedesktop (dot) org&gt;; Avahi is available from <B><A HREF="http://avahi.org/">http://avahi.org/</A></B>
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+avahi-autoipd.action">avahi-autoipd.action</A>(8)</B>, <B><A HREF="/cgi-bin/man/man2html?8+dhclient">dhclient</A>(8)</B>
<P>
<A HREF="http://avahi.org/wiki/AvahiAutoipd">http://avahi.org/wiki/AvahiAutoipd</A> documents how avahi-autoipd is best packaged and integrated into distributions.
<A NAME="lbAJ">&nbsp;</A>
<H2>COMMENTS</H2>
This man page was written using <B><A HREF="/cgi-bin/man/man2html?1+xml2man">xml2man</A>(1)</B> by Oliver Kurth.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="19"><A HREF="#lbAF">FILES</A><DD>
<DT id="20"><A HREF="#lbAG">SIGNALS</A><DD>
<DT id="21"><A HREF="#lbAH">AUTHORS</A><DD>
<DT id="22"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="23"><A HREF="#lbAJ">COMMENTS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:11 GMT, March 31, 2021
</BODY>
</HTML>