etc/devd: revise default devd.conf(5)
[dragonfly.git] / etc / devd.conf
1 # $FreeBSD: head/etc/devd.conf 261894 2014-02-14 15:31:48Z avg $
2 #
3 # Refer to devd.conf(5) and devd(8) man pages for the details on how to
4 # run and configure devd.
5 #
6
7 # NB: All regular expressions have an implicit ^$ around them.
8 # NB: device-name is shorthand for 'match device-name'
9
10 options {
11         # Each "directory" directive adds a directory to the list of
12         # directories that we scan for files.  Files are loaded in the order
13         # that they are returned from readdir(3).  The rule-sets are combined
14         # to create a DFA that's used to match events to actions.
15         directory "/etc/devd";
16         directory "/usr/local/etc/devd";
17         pid-file "/var/run/devd.pid";
18
19         # Setup some shorthand for regex that we use later in the file.
20         #XXX Yes, these are gross -- imp
21         set scsi-controller-regex
22                 "(aac|adv|adw|amd|amr|asr|bt|ciss|dpt|\
23                 ida|iir|ips|isp|mlx|mly|mpr|mps|mpt|ncr|sym|trm)\
24                 [0-9]+";
25         set wifi-driver-regex
26                 "(ath|bwn|iwi|iwm|iwn|ral|rum|run|urtwn|wi|wpi)[0-9]+";
27 };
28
29 # Note that the attach/detach with the highest value wins, so that one can
30 # override these general rules.
31
32 #
33 # Configure the interface on attach.  Due to a historical accident, this
34 # script is called pccard_ether.
35 #
36 # NB: DETACH events are ignored; the kernel should handle all cleanup
37 #     (routes, arp cache).  Beware of races against immediate create
38 #     of a device with the same name; e.g.
39 #     ifconfig bridge0 destroy; ifconfig bridge0 create
40 #
41 #notify 0 {
42 #       match "system"          "IFNET";
43 #       match "subsystem"       "!usbus[0-9]+";
44 #       match "type"            "ATTACH";
45 #       action "/etc/pccard_ether $subsystem start";
46 #};
47
48 #
49 # Try to start DHCP client on Ethernet-like interfaces when the link comes
50 # up.  Only devices that are configured to support DHCP will actually
51 # run it.  No link down rule exists because DHCP client automatically exits
52 # when the link goes down.
53 #
54 #notify 0 {
55 #       match "system"          "IFNET";
56 #       match "type"            "LINK_UP";
57 #       media-type              "ethernet";
58 #       action "/etc/rc.d/dhcp_client quietstart $subsystem";
59 #};
60
61 #
62 # Like Ethernet devices, but separate because 802.11 requires spawning
63 # wlan(4) interface.
64 #
65 #attach 0 {
66 #       device-name "$wifi-driver-regex";
67 #       action "/etc/pccard_ether $device-name startchildren";
68 #};
69 #detach 0 {
70 #       device-name "$wifi-driver-regex";
71 #       action "/etc/pccard_ether $device-name stopchildren";
72 #};
73 #notify 0 {
74 #       match "system"          "IFNET";
75 #       match "type"            "LINK_UP";
76 #       media-type              "802.11";
77 #       action "/etc/rc.d/dhcp_client quietstart $subsystem";
78 #};
79
80 # An entry like this might be in a different file, but is included here
81 # as an example of how to override things.  Normally 'ed50' would match
82 # the above attach/detach stuff, but the value of 100 makes it
83 # hard wired to 1.2.3.4.
84 attach 100 {
85         device-name "ed50";
86         action "ifconfig $device-name inet 1.2.3.4 netmask 0xffff0000";
87 };
88 detach 100 {
89         device-name "ed50";
90 };
91
92 # When a USB Bluetooth dongle appears, activate it
93 #attach 100 {
94 #       device-name "ubt[0-9]+";
95 #       action "/etc/rc.d/bluetooth quietstart $device-name";
96 #};
97 #detach 100 {
98 #       device-name "ubt[0-9]+";
99 #       action "/etc/rc.d/bluetooth quietstop $device-name";
100 #};
101
102 # Firmware downloader for Atheros AR3011 based USB Bluetooth devices
103 #attach 100 {
104 #       match "vendor" "0x0cf3";
105 #       match "product" "0x3000";
106 #       action "sleep 2 && /usr/sbin/ath3kfw -d $device-name -f /usr/local/etc/ath3k-1.fw";
107 #};
108
109 # When a USB keyboard arrives, attach it as the console keyboard.
110 #attach 100 {
111 #       device-name "ukbd0";
112 #       action "/etc/rc.d/syscons setkeyboard /dev/ukbd0";
113 #};
114 #detach 100 {
115 #       device-name "ukbd0";
116 #       action "/etc/rc.d/syscons setkeyboard /dev/kbd0";
117 #};
118
119 #notify 100 {
120 #       match "system" "DEVFS";
121 #       match "subsystem" "CDEV";
122 #       match "type" "CREATE";
123 #       match "cdev" "atp[0-9]+";
124 #
125 #       action "/etc/rc.d/moused quietstart $cdev";
126 #};
127
128 notify 100 {
129         match "system" "DEVFS";
130         match "subsystem" "CDEV";
131         match "type" "CREATE";
132         match "cdev" "ums[0-9]+";
133
134         action "/etc/rc.d/moused quietstart $cdev";
135 };
136
137 #notify 100 {
138 #       match "system" "DEVFS";
139 #       match "subsystem" "CDEV";
140 #       match "type" "CREATE";
141 #       match "cdev" "wsp[0-9]+";
142 #
143 #       action "/etc/rc.d/moused quietstart $cdev";
144 #};
145
146 notify 100 {
147         match "system" "DEVFS";
148         match "subsystem" "CDEV";
149         match "type" "DESTROY";
150         match "cdev" "ums[0-9]+";
151
152         action "/etc/rc.d/moused quietstop $cdev";
153 };
154
155 # Firmware download into the ActiveWire board. After the firmware download is
156 # done, the device detaches and reappears as something new and shiny
157 # automatically.
158 attach 100 {
159         match "vendor"  "0x0854";
160         match "product" "0x0100";
161         match "release" "0x0000";
162         action "/usr/local/bin/ezdownload -f /usr/local/share/usb/firmware/0854.0100.0_01.hex $device-name";
163 };
164
165 # Firmware download for Entrega Serial DB25 adapter.
166 attach 100 {
167         match "vendor"  "0x1645";
168         match "product" "0x8001";
169         match "release" "0x0101";
170         action "if ! kldstat -n usio > /dev/null 2>&1 ; then kldload usio; fi; /usr/sbin/ezdownload -v -f /usr/share/usb/firmware/1645.8001.0101 /dev/$device-name";
171 };
172
173 # This entry starts the ColdSync tool in daemon mode. Make sure you have an up
174 # to date /usr/local/etc/palms. We override the 'listen' settings for port and
175 # type in /usr/local/etc/coldsync.conf.
176 notify 100 {
177         match "system"          "USB";
178         match "subsystem"       "DEVICE";
179         match "type"            "ATTACH";
180         match "vendor"          "0x082d";
181         match "product"         "0x0100";
182         match "release"         "0x0100";
183         action "/usr/local/bin/coldsync -md -p /dev/$cdev -t usb";
184 };
185
186 #
187 # Rescan SCSI device-names on attach, but not detach.  However, it is
188 # disabled by default due to reports of problems.
189 #
190 attach 0 {
191         device-name "$scsi-controller-regex";
192 //      action "camcontrol rescan all";
193 };
194
195 # Don't even try to second guess what to do about drivers that don't
196 # match here.  Instead, pass it off to syslog.  Commented out for the
197 # moment, as the pnpinfo variable isn't set in devd yet.  Individual
198 # variables within the bus supplied pnpinfo are set.
199 nomatch 0 {
200 #       action "logger Unknown device: $pnpinfo $location $bus";
201 };
202
203 # Various logging of unknown devices.
204 nomatch 10 {
205         match "bus" "uhub[0-9]+";
206         action "logger Unknown USB device: vendor $vendor product $product \
207                 bus $bus";
208 };
209
210 # Some PC-CARDs don't offer numerical manufacturer/product IDs, just
211 # show the CIS info there.
212 nomatch 20 {
213         match "bus" "pccard[0-9]+";
214         match "manufacturer" "0xffffffff";
215         match "product" "0xffffffff";
216         action "logger Unknown PCCARD device: CISproduct $cisproduct \
217                 CIS-vendor $cisvendor bus $bus";
218 };
219
220 nomatch 10 {
221         match "bus" "pccard[0-9]+";
222         action "logger Unknown PCCARD device: manufacturer $manufacturer \
223                 product $product CISproduct $cisproduct CIS-vendor \
224                 $cisvendor bus $bus";
225 };
226
227 nomatch 10 {
228         match "bus" "cardbus[0-9]+";
229         action "logger Unknown Cardbus device: device $device class $class \
230                 vendor $vendor bus $bus";
231 };
232
233 # Switch power profiles when the AC line state changes.
234 #notify 10 {
235 #       match "system"          "ACPI";
236 #       match "subsystem"       "ACAD";
237 #       action "/etc/rc.d/power_profile $notify";
238 #};
239
240 # Notify all users before beginning emergency shutdown when we get
241 # a _CRT or _HOT thermal event and we're going to power down the system
242 # very soon.
243 notify 10 {
244         match "system"          "ACPI";
245         match "subsystem"       "Thermal";
246         match "notify"          "0xcc";
247         action "logger -p kern.emerg 'WARNING: system temperature too high, shutting down soon!'";
248 };
249
250 # User requested suspend, so perform preparation steps and then execute
251 # the actual suspend process.
252 notify 10 {
253         match "system"          "ACPI";
254         match "subsystem"       "Suspend";
255         action "/etc/rc.suspend acpi $notify";
256 };
257 notify 10 {
258         match "system"          "ACPI";
259         match "subsystem"       "Resume";
260         action "/etc/rc.resume acpi $notify";
261 };
262
263 /* EXAMPLES TO END OF FILE
264
265 # An example of something that a vendor might install if you were to
266 # add their device.  This might reside in /usr/local/etc/devd/deqna.conf.
267 # A deqna is, in this hypothetical example, a pccard ethernet-like device.
268 # Students of history may know other devices by this name, and will get
269 # the in-jokes in this entry.
270 nomatch 10 {
271         match "bus" "pccard[0-9]+";
272         match "manufacturer" "0x1234";
273         match "product" "0x2323";
274         action "kldload if_deqna";
275 };
276 attach 10 {
277         device-name "deqna[0-9]+";
278         action "/etc/pccard_ether $device-name start";
279 };
280 detach 10 {
281         device-name "deqna[0-9]+";
282         action "/etc/pccard_ether $device-name stop";
283 };
284
285 # Examples of notify hooks.  A notify is a generic way for a kernel
286 # subsystem to send event notification to userland.
287
288 # Here are some examples of ACPI notify handlers.  ACPI subsystems that
289 # generate notifies include the AC adapter, power/sleep buttons,
290 # control method batteries, lid switch, and thermal zones.
291 #
292 # Information returned is not always the same as the ACPI notify
293 # events.  See the ACPI specification for more information about
294 # notifies.  Here is the information returned for each subsystem:
295 #
296 # ACAD:            AC line state (0 is offline, 1 is online)
297 # Button:          Button pressed (0 for power, 1 for sleep)
298 # CMBAT:           ACPI battery events
299 # Lid:             Lid state (0 is closed, 1 is open)
300 # RCTL:            Resource limits
301 # Suspend, Resume: Suspend and resume notification
302 # Thermal:         ACPI thermal zone events
303 #
304 # This example calls a script when the AC state changes, passing the
305 # notify value as the first argument.  If the state is 0x00, it might
306 # call some sysctls to implement economy mode.  If 0x01, it might set
307 # the mode to performance.
308 notify 10 {
309         match "system"          "ACPI";
310         match "subsystem"       "ACAD";
311         action                  "/etc/acpi_ac $notify";
312 };
313
314 # This example works around a memory leak in PostgreSQL, restarting
315 # it when the "user:pgsql:swap:devctl=1G" rctl(8) rule gets triggered.
316 notify 0 {
317         match "system"          "RCTL";
318         match "rule"            "user:70:swap:.*";
319         action                  "/usr/local/etc/rc.d/postgresql restart";
320 };
321
322 */