2 .\" Copyright (c) 1994 Andrew McRae. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. The name of the author may not be used to endorse or promote products
13 .\" derived from this software without specific prior written permission.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 .\" $FreeBSD: src/usr.sbin/pccard/pccardd/pccardd.8,v 1.17.2.7 2001/08/16 15:56:12 ru Exp $
33 .Nd PC-CARD (PCMCIA) management daemon
41 .Op Fl f Ar configfile
44 is normally started at boot time, and manages the insertion
45 and removal of PC-CARD cards.
49 will read the configuration file (default name
50 .Pa /etc/defaults/pccard.conf
53 as the user configuration file)
54 and scans the available PC-CARD slots for cards.
58 such as the insertion of a new card or the removal
61 When a card is inserted, the following
65 The kernel driver detects the card insertion and applies
71 data from the attribute memory of the card, and uses
72 the manufacturer name and card version to match
73 the card description in the configuration file.
75 Once matched, a driver is allocated.
77 Once a free driver and device instance is located,
79 will (if required) allocate resources such as an ISA memory
80 block and Input/Output ports from a common pool.
82 The PC-CARD slot is configured with the I/O and memory
83 contexts allocated, and the kernel driver is attached to
86 If the attach succeeds, then specific shell commands
87 may be executed to configure the device, such as
89 to set up a network interface.
90 Separate commands may be specified
91 for each card, driver or device, and are executed in that order.
96 detects that a card has been removed, the following sequence occurs:
99 The shell commands associated with card removal are executed.
101 are intended to reset any device associated with the removed card.
102 Separate commands may exist for card, driver and device instances.
104 The PC-CARD slot resources are freed.
107 Once a card/driver instance is configured, the resources
108 bound to that instance are remembered, and if the card is removed
109 and reinserted, the same driver is allocated.
111 is that once a driver is associated with a card, the
114 routine has been called, and this usually causes driver specific
115 data areas to be initialized with the I/O ports or memory resources
116 allocated to the card.
117 Most drivers are not designed to be
118 disassociated from the hardware and then reassociated with different
120 This will change significantly when loadable kernel
121 modules are supported.
125 to reload the configuration files.
127 The start options understood by
132 Do not run as a daemon, but run in the foreground and
133 display error messages.
135 After reading the configuration file, print out a summary
138 Delays running as a daemon until after the cards have been probed and attached.
140 Don't get a list of free IRQs from kernel.
142 Configures an available IRQ. It overrides the "irq" line in
143 .Pa /etc/defaults/pccard.conf
145 .Pa /etc/pccard.conf .
146 .It Fl f Ar configfile
147 Specifies a different configuration file to be used
148 in placed of the default file
149 .Pa /etc/defaults/pccard.conf .
150 The file format is detailed in
152 and lists the PC-CARD cards recognized by
154 and the kernel drivers and devices that are used to
155 interface to the card.
158 .Bl -tag -width /etc/defaults/pccard.conf -compact
159 .It Pa /etc/defaults/pccard.conf
160 default configuration file
161 .It Pa /etc/pccard.conf
162 user configuration file
163 .It Pa /var/run/pccardd.pid
164 process id of the currently running
172 .An Andrew McRae Aq andrew@mega.com.au .
175 can set up card parameters, but cannot guarantee that
176 particular drivers can work with the card.
178 Removing cards may cause problems if system resources
179 have been associated with the card, such as network