NAME<\/a> ifplugd \u2212 A link detection daemon for ethernet devices<\/p>\n ifplugd [<\/b>options<\/i>]<\/b><\/p>\n ifplugd is a daemon which will automatically configure your ethernet device when a cable is plugged in and automatically unconfigure it if the cable is pulled. This is useful on laptops with on-board network adapters, since it will only configure the interface when a cable is really connected.<\/p>\n It uses your distribution\u2019s native ifup\/ifdown programs, but can be configured to do anything you wish when the state of the interface changes. It may ignore short unplugged whiles (-d<\/b> option) or plugged whiles (-u<\/b> option).<\/p>\n ifplugd may be used in “compatibility mode” by specifying -F on the command line. Than ifplugd will treat network drivers which do not support link beat querying as always online.<\/p>\n -a | –no-auto<\/b><\/p>\n Do not enable interface automatically (default: off)<\/p>\n -n | –no-daemon<\/b><\/p>\n Do not daemonize (for debugging) (default: off)<\/p>\n -s | –no-syslog<\/b><\/p>\n Do not use syslog, use stdout instead (for debugging) (default: off).<\/p>\n -b | –no-beep<\/b><\/p>\n Do not beep (off)<\/p>\n -f | –ignore-fail<\/b><\/p>\n Ignore detection failure, retry instead. Failure is treated as “no link”. (default: off)<\/p>\n -F | –ignore-fail-positive<\/b><\/p>\n Ignore detection failure, retry instead. Failure is treated as “link detected”. (default: off)<\/p>\n -i | –iface=<\/b> IFACE<\/i><\/p>\n Specify ethernet interface (default: eth0)<\/p>\n -r | –run=<\/b> EXEC<\/i><\/p>\n Specify program to execute when link status changes (default: \/etc\/ifplugd\/ifplugd.action<\/i>)<\/p>\n -I | –ignore-retval<\/b><\/p>\n Don\u2019t exit on nonzero return value of program executed on link change. (default: off)<\/p>\n -t | –poll-time=<\/b> SECS<\/i><\/p>\n Specify poll time in seconds (default: 1)<\/p>\n -u | –delay-up=<\/b> SECS<\/i><\/p>\n Specify delay for configuring interface (default: 0)<\/p>\n -d | –delay-down=<\/b> SECS<\/i><\/p>\n Specify delay for deconfiguring interface (default: 5)<\/p>\n -m | –api-mode=<\/b> MODE<\/i><\/p>\n Force a specific link beat detection ioctl() API. Possible values are auto, iff, wlan, ethtool, mii, and priv for automatic detection, interface flag (IFF_RUNNING), wireless extension, SIOCETHTOOL, SIOCGMIIREG resp. SIOCPRIV. Only the first character of the argument is relevant, case insensitive. (default: auto)<\/p>\n -p | –no-startup<\/b><\/p>\n Don\u2019t call the script to bring up network on deamon start (default: off)<\/p>\n -q | –no-shutdown<\/b><\/p>\n Don\u2019t call the script for network shutdown on deamon quit (default: off)<\/p>\n -w | –wait-on-fork<\/b><\/p>\n When daemonizing, wait until the background process finished with the initial link beat detection. When this is enabled, the parent process will return the link status on exit. 1 means link beat detected, 2 stands for link beat not detected, everything else is an error.<\/p>\n -W | –wait-on-kill<\/b><\/p>\n When killing a running daemon (with -k) wait until the daemon died.<\/p>\n -x | –extra-arg=<\/b> ARG<\/i><\/p>\n Specify an extra argument to be passed to the action script.<\/p>\n -M | –monitor<\/b><\/p>\n Don\u2019t fail when the network interface is not available, instead use NETLINK to monitor device avaibility. The is useful for PCMCIA devices and similar.<\/p>\n -h | –help<\/b><\/p>\n Show help<\/p>\n -k | –kill<\/b><\/p>\n Kill a running daemon (Specify -i to select the daemon instance to kill)<\/p>\n -c | –check-running<\/b><\/p>\n Check if a daemon is running for a given network interface. Sets the return value to 0 if a daemon is already running or to 255 if not.<\/p>\n -v | –version<\/b><\/p>\n Show version<\/p>\n -S | –supend<\/b><\/p>\n Suspend a running daemon. The daemon will no longer check the link status until it is resumed (-R) again. (Specify -i to select the daemon instance to suspend.)<\/p>\n -R | –resume<\/b><\/p>\n Resume a suspended daemon. (Specify -i to select the daemon instance to resume.)<\/p>\n -z | –info<\/b><\/p>\n Request that a running daemon shall write its status information to syslog. (Specify -i to select the daemon instance to send the request to.)<\/p>\n \/etc\/ifplugd\/ifplugd.conf<\/i>: this file is sourced by the init script \/etc\/init.d\/ifplugd<\/i> and contains the interface to be monitored and the options to be used.<\/p>\n \/etc\/ifplugd\/ifplugd.action<\/i>: this is the script which will be called by the daemon whenever the state of the interface changes. It takes two areguments: the first is the interface name (eg. eth0), the second either “up” or “down”.<\/p>\n \/var\/run\/ifplugd. The action script will be called with two environment variables set:<\/p>\n IFPLUGD_PREVIOUS<\/i> The previous link status. Either “up”, “down”, “error” or “disabled”. The former values should be obvious, the latter is set on daemon startup.<\/p>\n IFPLUGD_CURRENT<\/i> The current link status. See above for possible values.<\/p>\n SIGINT, SIGTERM<\/i> ifplugd will quit, possibly running the shutdown script. This is issued by passing -k to ifplugd.<\/p>\n SIGQUIT<\/i> ifplugd will quit, the shutdown script is never run.<\/p>\n SIGHUP<\/i> ifplugd will write its status information to syslog. This is issued by -z.<\/p>\n SIGUSR1<\/i> ifplugd will go to suspend mode. (-S)<\/p>\n SIGUSR2<\/i> ifplugd will resume from suspend mode. (-R)<\/p>\n ifplugd was written by Lennart Poettering
SYNOPSIS<\/a>
DESCRIPTION<\/a>
OPTIONS<\/a>
FILES<\/a>
ENVIRONMENT<\/a>
SIGNALS<\/a>
AUTHOR<\/a>
SEE ALSO<\/a>
COMMENTS<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
OPTIONS <\/a> <\/h2>\n
FILES <\/a> <\/h2>\n
ENVIRONMENT <\/a> <\/h2>\n
SIGNALS <\/a> <\/h2>\n
AUTHOR <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n