.\" /usr/share/man/man8/dphys-hotplug.8(.gz)
.\" author Neil Franklin, last modification 2005.05.27
.\" copyright ETH Zuerich Physics Departement
.\"   use under either modified/non-advertising BSD or GPL license

.TH DPHYS-HOTPLUG 8 "2005.05.27" "D-PHYS Hotplug Actions"

.SH NAME

dphys-hotplug \- call action scripts driven by hotplug events

.SH SYNOPSIS

.B dphys-hotplug

.SH DESCRIPTION

Run a set of action scripts for each arriving hotplug event.
.PP
For each type of events (usb, pci, isapnp, net, ieee1394, printer, ...) have
an set of scripts that are run, which can do site specific actions.
.PP
These are all run after the standard /sbin/hotplug has done its job, so
allowing users to add stuff, using the full standard environment.

.SH OPTIONS

To get debugging output create an empty file \fI/dphys-hotplug.debug\fP.
Scripts called are supposed to also give debugging output if such an file,
called \fI/dphys-hotplug-<event-type>-<scriptname>.debug\fP is present.

.SH CONFIG

Must be activated, by telling kernel to call this script instead of the
standard hotplug script. This is done by doing:
.PP
.nf
/bin/echo /usr/sbin/dphys-hotplug > /proc/sys/kernel/hotplug
.fi
.PP
This is best done out of an \fI/etc/init.d\fP startup script.

.SH FILES

.TP
.B /etc/dphys-hotplug.d/<event-type>.<scriptname>
Action scripts (old names) to be run for each <event-type> event. An example
scripts name could be like this: \fI/etc/dphys-hotplug.d/usb.storage\fP.
.TP
.B /etc/dphys-hotplug.d/<event-type>-<scriptname>
Action scripts (new names) to be run for each <event-type> event. An example
scripts name could be like this: \fI/etc/dphys-hotplug.d/usb-storage\fP.

.SH AUTHOR

franklin@phys.ethz.ch, http://www.phys.ethz.ch/~franklin/