From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Brownell Date: Tue, 16 Jan 2001 19:17:13 +0000 Subject: PATCH/2.4.0 -- hotplug docs MIME-Version: 1 Content-Type: multipart/mixed; boundary="----=_NextPart_000_11B2_01C07FAD.E0967380" Message-Id: List-Id: To: linux-hotplug@vger.kernel.org This is a multi-part message in MIME format. ------=_NextPart_000_11B2_01C07FAD.E0967380 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Hi Linus, Could you include this patch in 2.4.1 ? No code changes ... it just points folk to the current place for getting information and tools for hotplugging (http://linux-hotplug.sourceforge.net/) and updates a few other points in the documentation. - Dave ------=_NextPart_000_11B2_01C07FAD.E0967380 Content-Type: application/octet-stream; name="hotplug-doc.patch" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="hotplug-doc.patch" --- linux/Documentation-2.4.0/Configure.help Tue Jan 16 10:47:27 2001=0A= +++ linux/Documentation/Configure.help Tue Jan 16 10:51:54 2001=0A= @@ -2625,13 +2625,14 @@=0A= =0A= One well known example of this is PCMCIA- or PC-cards, credit-card=0A= size devices such as network cards, modems or hard drives which are=0A= - plugged into slots found on all modern laptop computers.=0A= + plugged into slots found on all modern laptop computers. Another=0A= + example, used on modern desktops as well as laptops, is USB.=0A= =0A= - Another example, used on modern desktops as well as laptops, is USB.=0A= - Enable HOTPLUG with USB and KMOD, and your kernel will automatically=0A= - call out to a user mode "policy agent" to load modules and set up=0A= - software needed to use USB devices you plug in. Get agent software=0A= - (at http://www.linux-usb.org/policy.html) and install it.=0A= + Enable HOTPLUG and KMOD, and build a modular kernel. Get agent=0A= + software (at http://linux-hotplug.sourceforge.net) and install it.=0A= + Then your kernel will automatically call out to a user mode "policy=0A= + agent" (/sbin/hotplug) to load modules and set up software needed=0A= + to use devices as you hotplug them.=0A= =0A= PCMCIA/Cardbus support=0A= CONFIG_PCMCIA=0A= --- linux/Documentation-2.4.0/usb/hotplug.txt Tue Jan 16 10:47:53 2001=0A= +++ linux/Documentation/usb/hotplug.txt Tue Jan 16 11:01:16 2001=0A= @@ -1,4 +1,4 @@=0A= -USB HOTPLUGGING=0A= +LINUX HOTPLUGGING=0A= =0A= In hotpluggable busses like USB (and Cardbus PCI), end-users plug = devices=0A= into the bus with power on. In most cases, users expect the devices to = become=0A= @@ -8,7 +8,7 @@=0A= loading a kernel module; newer drivers can use modutils to=0A= publish their device (and class) support to user utilities.=0A= =0A= - - Bind a driver to that device. That's done using the USB=0A= + - Bind a driver to that device. Bus frameworks do that using a=0A= device driver's probe() routine.=0A= =0A= - Tell other subsystems to configure the new device. Print=0A= @@ -26,6 +26,10 @@=0A= such programs are called "policy agents" here. Typically they involve=0A= shell scripts that dispatch to more familiar administration tools.=0A= =0A= +Because some of those actions rely on information about drivers = (metadata)=0A= +that is currently available only when the drivers are dynamically = linked,=0A= +you get the best hotplugging when you configure a highly modular system.=0A= +=0A= =0A= KERNEL HOTPLUG HELPER (/sbin/hotplug)=0A= =0A= @@ -40,9 +44,14 @@=0A= dispatch; any other argument and environment parameters are specified by=0A= the subsystem making that invocation.=0A= =0A= -A reference implementation of a /sbin/hotplug script is available at the=0A= -http://www.linux-usb.org website, which works USB for but also knows = how to=0A= -delegate to any /etc/hotplug/$TYPE.agent policy agent present.=0A= +Hotplug software and other resources is available at:=0A= +=0A= + http://linux-hotplug.sourceforge.net=0A= +=0A= +Mailing list information is also available at that site.=0A= +=0A= +=0A= +------------------------------------------------------------------------= --=0A= =0A= =0A= USB POLICY AGENT=0A= ------=_NextPart_000_11B2_01C07FAD.E0967380-- _______________________________________________ Linux-hotplug-devel mailing list http://linux-hotplug.sourceforge.net Linux-hotplug-devel@lists.sourceforge.net http://lists.sourceforge.net/lists/listinfo/linux-hotplug-devel