]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - usr.sbin/sade/devices.c
Remove references to ze and zp drivers.
[FreeBSD/FreeBSD.git] / usr.sbin / sade / devices.c
1 /*
2  * The new sysinstall program.
3  *
4  * This is probably the last program in the `sysinstall' line - the next
5  * generation being essentially a complete rewrite.
6  *
7  * $FreeBSD$
8  *
9  * Copyright (c) 1995
10  *      Jordan Hubbard.  All rights reserved.
11  *
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions and the following disclaimer,
17  *    verbatim and that no modifications are made prior to this
18  *    point in the file.
19  * 2. Redistributions in binary form must reproduce the above copyright
20  *    notice, this list of conditions and the following disclaimer in the
21  *    documentation and/or other materials provided with the distribution.
22  *
23  * THIS SOFTWARE IS PROVIDED BY JORDAN HUBBARD ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL JORDAN HUBBARD OR HIS PETS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, LIFE OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  */
36
37 #include "sysinstall.h"
38 #include <sys/fcntl.h>
39 #include <sys/param.h>
40 #include <sys/socket.h>
41 #include <sys/ioctl.h>
42 #include <sys/errno.h>
43 #include <sys/time.h>
44 #include <net/if.h>
45 #include <net/if_var.h>
46 #include <net/if_dl.h>
47 #include <netinet/in.h>
48 #include <netinet/in_var.h>
49 #include <arpa/inet.h>
50 #include <ctype.h>
51
52 /* how much to bias minor number for a given /dev/<ct#><un#>s<s#> slice */
53 #define SLICE_DELTA     (0x10000)
54
55 static Device *Devices[DEV_MAX];
56 static int numDevs;
57
58 static struct _devname {
59     DeviceType type;
60     char *name;
61     char *description;
62     int major, minor, delta, max;
63     char dev_type;
64 } device_names[] = {
65     { DEVICE_TYPE_CDROM,        "cd%dc",        "SCSI CDROM drive",     6, 2, 8, 4, 'b'                         },
66     { DEVICE_TYPE_CDROM,        "mcd%da",       "Mitsumi (old model) CDROM drive",      7, 0, 8, 4, 'b'         },
67     { DEVICE_TYPE_CDROM,        "scd%da",       "Sony CDROM drive - CDU31/33A type",    16, 0, 8, 4, 'b'        },
68 #ifdef notdef
69     { DEVICE_TYPE_CDROM,        "matcd%da",     "Matsushita CDROM ('sound blaster' type)", 17, 0, 8, 4, 'b'     },
70 #endif
71     { DEVICE_TYPE_CDROM,        "acd%dc",       "ATAPI/IDE CDROM",      31, 2, 8, 4, 'b'                        },
72     { DEVICE_TYPE_TAPE,         "rsa%d",        "SCSI tape drive",      14, 0, 16, 4, 'c'                       },
73     { DEVICE_TYPE_TAPE,         "rwt%d",        "Wangtek tape drive",   10, 0, 1, 4, 'c'                        },
74     { DEVICE_TYPE_DISK,         "da%d",         "SCSI disk device",     4, 65538, 8, 16, 'b'                    },
75     { DEVICE_TYPE_DISK,         "rda%d",        "SCSI disk device",     13, 65538, 8, 16, 'c'                   },
76     { DEVICE_TYPE_DISK,         "ad%d",         "ATA/IDE disk device",  30, 65538, 8, 16, 'b'   },
77     { DEVICE_TYPE_DISK,         "rad%d",        "ATA/IDE disk device",  116, 65538, 8, 16, 'c'  },
78     { DEVICE_TYPE_DISK,         "fla%d",        "M-Systems DiskOnChip Flash device", 28, 65538, 8, 16, 'b'      },
79     { DEVICE_TYPE_DISK,         "rfla%d",       "M-Systems DiskOnChip Flash devicee",   102, 65538, 8, 16, 'c'  },
80     { DEVICE_TYPE_DISK,         "afd%d",        "ATAPI/IDE floppy device",      32, 65538, 8, 4, 'b'            },
81     { DEVICE_TYPE_DISK,         "rafd%d",       "ATAPI/IDE floppy device",      118, 65538, 8, 4, 'c'           },
82     { DEVICE_TYPE_DISK,         "mlxd%d",       "Mylex RAID disk",      27, 65538, 8, 4, 'b'                    },
83     { DEVICE_TYPE_DISK,         "rmlxd%d",      "Mylex RAID disk",      131, 65538, 8, 4, 'c'                   },
84     { DEVICE_TYPE_DISK,         "amrd%d",       "AMI MegaRAID drive",   35, 65538, 8, 4, 'b'                    },
85     { DEVICE_TYPE_DISK,         "ramrd%d",      "AMI MegaRAID drive",   133, 65538, 8, 4, 'c'                   },
86     { DEVICE_TYPE_FLOPPY,       "fd%d",         "floppy drive unit A",  2, 0, 64, 4, 'b'                        },
87     { DEVICE_TYPE_FLOPPY,       "worm%d",       "SCSI optical disk / CDR",      23, 0, 1, 4, 'b'                },
88     { DEVICE_TYPE_NETWORK,      "fpa",          "DEC DEFPA PCI FDDI card"                                       },
89     { DEVICE_TYPE_NETWORK,      "sr",           "SDL T1/E1 sync serial PCI card"                                },
90     { DEVICE_TYPE_NETWORK,      "cc3i",         "SDL HSSI sync serial PCI card"                                 },
91     { DEVICE_TYPE_NETWORK,      "en",           "Efficient Networks ATM PCI card"                               },
92     { DEVICE_TYPE_NETWORK,      "dc",           "DEC/Intel 21143 (and clones) PCI fast ethernet card"           },
93     { DEVICE_TYPE_NETWORK,      "de",           "DEC DE435 PCI NIC or other DC21040-AA based card"              },
94     { DEVICE_TYPE_NETWORK,      "fxp",          "Intel EtherExpress Pro/100B PCI Fast Ethernet card"            },
95     { DEVICE_TYPE_NETWORK,      "ed",           "Novell NE1000/2000; 3C503; NE2000-compatible PCMCIA"           },
96     { DEVICE_TYPE_NETWORK,      "ep",           "3Com 3C509 ethernet card/3C589 PCMCIA"                         },
97     { DEVICE_TYPE_NETWORK,      "el",           "3Com 3C501 ethernet card"                                      },
98     { DEVICE_TYPE_NETWORK,      "ex",           "Intel EtherExpress Pro/10 ethernet card"                       },
99     { DEVICE_TYPE_NETWORK,      "fe",           "Fujitsu MB86960A/MB86965A ethernet card"                       },
100     { DEVICE_TYPE_NETWORK,      "ie",           "AT&T StarLAN 10 and EN100; 3Com 3C507; NI5210"                 },
101     { DEVICE_TYPE_NETWORK,      "ix",           "Intel Etherexpress ethernet card"                              },
102     { DEVICE_TYPE_NETWORK,      "le",           "DEC EtherWorks 2 or 3 ethernet card"                           },
103     { DEVICE_TYPE_NETWORK,      "lnc",          "Lance/PCnet (Isolan/Novell NE2100/NE32-VL) ethernet"           },
104     { DEVICE_TYPE_NETWORK,      "rl",           "RealTek 8129/8139 PCI ethernet card"           },
105     { DEVICE_TYPE_NETWORK,      "sf",           "Adaptec AIC-6915 PCI ethernet card"            },
106     { DEVICE_TYPE_NETWORK,      "sis",          "SiS 900/SiS 7016 PCI ethernet card"            },
107     { DEVICE_TYPE_NETWORK,      "ste",          "Sundance ST201 PCI ethernet card"              },
108     { DEVICE_TYPE_NETWORK,      "sk",           "SysKonnect PCI gigabit ethernet card"          },
109     { DEVICE_TYPE_NETWORK,      "tx",           "SMC 9432TX ethernet card"                                      },
110     { DEVICE_TYPE_NETWORK,      "ti",           "Alteon Networks PCI gigabit ethernet card"             },
111     { DEVICE_TYPE_NETWORK,      "tl",           "Texas Instruments ThunderLAN PCI ethernet card"                },
112     { DEVICE_TYPE_NETWORK,      "vr",           "VIA VT3043/VT86C100A Rhine PCI ethernet card"                          },
113     { DEVICE_TYPE_NETWORK,      "vx",           "3COM 3c590 / 3c595 ethernet card"                              },
114     { DEVICE_TYPE_NETWORK,      "wb",           "Winbond W89C840F PCI ethernet card"                            },
115     { DEVICE_TYPE_NETWORK,      "xl",           "3COM 3c90x / 3c90xB PCI ethernet card"                         },
116     { DEVICE_TYPE_NETWORK,      "cuaa%d",       "%s on device %s (COM%d)",      28, 128, 1, 16, 'c'             },
117     { DEVICE_TYPE_NETWORK,      "lp",           "Parallel Port IP (PLIP) peer connection"                       },
118     { DEVICE_TYPE_NETWORK,      "lo",           "Loop-back (local) network interface"                           },
119     { 0 },
120 };
121
122 Device *
123 new_device(char *name)
124 {
125     Device *dev;
126
127     dev = safe_malloc(sizeof(Device));
128     bzero(dev, sizeof(Device));
129     if (name)
130         SAFE_STRCPY(dev->name, name);
131     return dev;
132 }
133
134 /* Stubs for unimplemented strategy routines */
135 Boolean
136 dummyInit(Device *dev)
137 {
138     return TRUE;
139 }
140
141 FILE *
142 dummyGet(Device *dev, char *dist, Boolean probe)
143 {
144     return NULL;
145 }
146
147 void
148 dummyShutdown(Device *dev)
149 {
150     return;
151 }
152
153 static int
154 deviceTry(struct _devname dev, char *try, int i)
155 {
156     int fd;
157     char unit[80];
158     mode_t m;
159     dev_t d;
160     int fail;
161
162     snprintf(unit, sizeof unit, dev.name, i);
163     snprintf(try, FILENAME_MAX, "/dev/%s", unit);
164     fd = open(try, O_RDONLY);
165     if (fd >= 0)
166         return fd;
167     m = 0640;
168     if (dev.dev_type == 'c')
169         m |= S_IFCHR;
170     else
171         m |= S_IFBLK;
172     d = makedev(dev.major, dev.minor + (i * dev.delta));
173     fail = mknod(try, m, d);
174     fd = open(try, O_RDONLY);
175     if (fd >= 0)
176         return fd;
177     else if (!fail)
178         (void)unlink(try);
179     /* Don't try a "make-under" here since we're using a fixit floppy in this case */
180     snprintf(try, FILENAME_MAX, "/mnt/dev/%s", unit);
181     fd = open(try, O_RDONLY);
182     return fd;
183 }
184
185 /* Register a new device in the devices array */
186 Device *
187 deviceRegister(char *name, char *desc, char *devname, DeviceType type, Boolean enabled,
188                Boolean (*init)(Device *), FILE * (*get)(Device *, char *, Boolean),
189                void (*shutdown)(Device *), void *private)
190 {
191     Device *newdev = NULL;
192
193     if (numDevs == DEV_MAX)
194         msgFatal("Too many devices found!");
195     else {
196         newdev = new_device(name);
197         newdev->description = desc;
198         newdev->devname = devname;
199         newdev->type = type;
200         newdev->enabled = enabled;
201         newdev->init = init ? init : dummyInit;
202         newdev->get = get ? get : dummyGet;
203         newdev->shutdown = shutdown ? shutdown : dummyShutdown;
204         newdev->private = private;
205         Devices[numDevs] = newdev;
206         Devices[++numDevs] = NULL;
207     }
208     return newdev;
209 }
210
211 /* Reset the registered device chain */
212 void
213 deviceReset(void)
214 {
215     int i;
216
217     for (i = 0; i < numDevs; i++) {
218         Devices[i]->shutdown(Devices[i]);
219
220         /* XXX this potentially leaks Devices[i]->private if it's being
221          * used to point to something dynamic, but you're not supposed
222          * to call this routine at such times that some open instance
223          * has its private ptr pointing somewhere anyway. XXX
224          */
225         free(Devices[i]);
226     }
227     Devices[numDevs = 0] = NULL;
228 }
229
230 /* Get all device information for devices we have attached */
231 void
232 deviceGetAll(void)
233 {
234     int i, j, fd, s;
235     struct ifconf ifc;
236     struct ifreq *ifptr, *end;
237     int ifflags;
238     char buffer[INTERFACE_MAX * sizeof(struct ifreq)];
239     char **names;
240
241     msgNotify("Probing devices, please wait (this can take a while)...");
242     /* First go for the network interfaces.  Stolen shamelessly from ifconfig! */
243     ifc.ifc_len = sizeof(buffer);
244     ifc.ifc_buf = buffer;
245
246     s = socket(AF_INET, SOCK_DGRAM, 0);
247     if (s < 0)
248         goto skipif;    /* Jump over network iface probing */
249
250     if (ioctl(s, SIOCGIFCONF, (char *) &ifc) < 0)
251         goto skipif;    /* Jump over network iface probing */
252
253     ifflags = ifc.ifc_req->ifr_flags;
254     end = (struct ifreq *) (ifc.ifc_buf + ifc.ifc_len);
255     for (ifptr = ifc.ifc_req; ifptr < end; ifptr++) {
256         char *descr;
257
258         /* If it's not a link entry, forget it */
259         if (ifptr->ifr_ifru.ifru_addr.sa_family != AF_LINK)
260             goto loopend;
261
262         /* Eliminate network devices that don't make sense */
263         if (!strncmp(ifptr->ifr_name, "lo", 2))
264             goto loopend;
265
266         /* If we have a slip device, don't register it */
267         if (!strncmp(ifptr->ifr_name, "sl", 2)) {
268             goto loopend;
269         }
270         /* And the same for ppp */
271         if (!strncmp(ifptr->ifr_name, "tun", 3) || !strncmp(ifptr->ifr_name, "ppp", 3)) {
272             goto loopend;
273         }
274         /* Try and find its description */
275         for (i = 0, descr = NULL; device_names[i].name; i++) {
276             int len = strlen(device_names[i].name);
277
278             if (!ifptr->ifr_name || !ifptr->ifr_name[0])
279                 continue;
280             else if (!strncmp(ifptr->ifr_name, device_names[i].name, len)) {
281                 descr = device_names[i].description;
282                 break;
283             }
284         }
285         if (!descr)
286             descr = "<unknown network interface type>";
287
288         deviceRegister(ifptr->ifr_name, descr, strdup(ifptr->ifr_name), DEVICE_TYPE_NETWORK, TRUE,
289                        mediaInitNetwork, NULL, mediaShutdownNetwork, NULL);
290         msgDebug("Found a network device named %s\n", ifptr->ifr_name);
291         close(s);
292         if ((s = socket(AF_INET, SOCK_DGRAM, 0)) < 0)
293             continue;
294
295 loopend:
296         if (ifptr->ifr_addr.sa_len)     /* I'm not sure why this is here - it's inherited */
297             ifptr = (struct ifreq *)((caddr_t)ifptr + ifptr->ifr_addr.sa_len - sizeof(struct sockaddr));
298     }
299
300 skipif:
301     /* Next, try to find all the types of devices one might need
302      * during the second stage of the installation.
303      */
304     for (i = 0; device_names[i].name; i++) {
305         for (j = 0; j < device_names[i].max; j++) {
306             char try[FILENAME_MAX];
307
308             switch(device_names[i].type) {
309             case DEVICE_TYPE_CDROM:
310                 fd = deviceTry(device_names[i], try, j);
311                 if (fd >= 0 || errno == EBUSY) {        /* EBUSY if already mounted */
312                     char n[BUFSIZ];
313
314                     if (fd >= 0) close(fd);
315                     snprintf(n, sizeof n, device_names[i].name, j);
316                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
317                                          DEVICE_TYPE_CDROM, TRUE, mediaInitCDROM, mediaGetCDROM,
318                                          mediaShutdownCDROM, NULL);
319                     msgDebug("Found a CDROM device for %s\n", try);
320                 }
321                 break;
322
323             case DEVICE_TYPE_TAPE:
324                 fd = deviceTry(device_names[i], try, j);
325                 if (fd >= 0) {
326                     char n[BUFSIZ];
327
328                     close(fd);
329                     snprintf(n, sizeof n, device_names[i].name, j);
330                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
331                                    DEVICE_TYPE_TAPE, TRUE, mediaInitTape, mediaGetTape, mediaShutdownTape, NULL);
332                     msgDebug("Found a TAPE device for %s\n", try);
333                 }
334                 break;
335
336             case DEVICE_TYPE_DISK:
337                 fd = deviceTry(device_names[i], try, j);
338                 if (fd >= 0 && RunningAsInit) {
339                     dev_t d;
340                     mode_t m;
341                     int s, fail;
342                     char unit[80], slice[80];
343
344                     close(fd);
345                     /* Make associated slice entries */
346                     for (s = 1; s < 8; s++) {
347                         snprintf(unit, sizeof unit, device_names[i].name, j);
348                         snprintf(slice, sizeof slice, "/dev/%ss%d", unit, s);
349                         d = makedev(device_names[i].major, device_names[i].minor +
350                                     (j * device_names[i].delta) + (s * SLICE_DELTA));
351                         m = 0640;
352                         if (device_names[i].dev_type == 'c')
353                             m |= S_IFCHR;
354                         else
355                             m |= S_IFBLK;
356                         fail = mknod(slice, m, d);
357                         fd = open(slice, O_RDONLY);
358                         if (fd >= 0)
359                             close(fd);
360                         else if (!fail)
361                             (void)unlink(slice);
362                     }
363                 }
364                 break;
365
366             case DEVICE_TYPE_FLOPPY:
367                 fd = deviceTry(device_names[i], try, j);
368                 if (fd >= 0) {
369                     char n[BUFSIZ];
370
371                     close(fd);
372                     snprintf(n, sizeof n, device_names[i].name, j);
373                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
374                                    DEVICE_TYPE_FLOPPY, TRUE, mediaInitFloppy, mediaGetFloppy,
375                                    mediaShutdownFloppy, NULL);
376                     msgDebug("Found a floppy device for %s\n", try);
377                 }
378                 break;
379
380             case DEVICE_TYPE_NETWORK:
381                 fd = deviceTry(device_names[i], try, j);
382                 /* The only network devices that you can open this way are serial ones */
383                 if (fd >= 0) {
384                     char *newdesc, *cp;
385
386                     close(fd);
387                     cp = device_names[i].description;
388                     /* Serial devices get a slip and ppp device each, if supported */
389                     newdesc = safe_malloc(strlen(cp) + 40);
390                     sprintf(newdesc, cp, "SLIP interface", try, j + 1);
391                     deviceRegister("sl0", newdesc, strdup(try), DEVICE_TYPE_NETWORK, TRUE, mediaInitNetwork,
392                                    NULL, mediaShutdownNetwork, NULL);
393                     msgDebug("Add mapping for %s to sl0\n", try);
394                     newdesc = safe_malloc(strlen(cp) + 50);
395                     sprintf(newdesc, cp, "PPP interface", try, j + 1);
396                     deviceRegister("ppp0", newdesc, strdup(try), DEVICE_TYPE_NETWORK, TRUE, mediaInitNetwork,
397                                    NULL, mediaShutdownNetwork, NULL);
398                     msgDebug("Add mapping for %s to ppp0\n", try);
399                 }
400                 break;
401
402             default:
403                 break;
404             }
405         }
406     }
407
408     /* Finally, go get the disks and look for DOS partitions to register */
409     if ((names = Disk_Names()) != NULL) {
410         int i;
411
412         for (i = 0; names[i]; i++) {
413             Chunk *c1;
414             Disk *d;
415
416             d = Open_Disk(names[i]);
417             if (!d)
418                 msgFatal("Unable to open disk %s", names[i]);
419
420             deviceRegister(names[i], names[i], d->name, DEVICE_TYPE_DISK, FALSE,
421                            dummyInit, dummyGet, dummyShutdown, d);
422             msgDebug("Found a disk device named %s\n", names[i]);
423
424             /* Look for existing DOS partitions to register as "DOS media devices" */
425             for (c1 = d->chunks->part; c1; c1 = c1->next) {
426                 if (c1->type == fat || c1->type == extended) {
427                     Device *dev;
428                     char devname[80];
429
430                     /* Got one! */
431                     snprintf(devname, sizeof devname, "/dev/%s", c1->name);
432                     dev = deviceRegister(c1->name, c1->name, strdup(devname), DEVICE_TYPE_DOS, TRUE,
433                                          mediaInitDOS, mediaGetDOS, mediaShutdownDOS, NULL);
434                     dev->private = c1;
435                     msgDebug("Found a DOS partition %s on drive %s\n", c1->name, d->name);
436                 }
437             }
438         }
439         free(names);
440     }
441 }
442
443 /* Rescan all devices, after closing previous set - convenience function */
444 void
445 deviceRescan(void)
446 {
447     deviceReset();
448     deviceGetAll();
449 }
450
451 /*
452  * Find all devices that match the criteria, allowing "wildcarding" as well
453  * by allowing NULL or ANY values to match all.  The array returned is static
454  * and may be used until the next invocation of deviceFind().
455  */
456 Device **
457 deviceFind(char *name, DeviceType class)
458 {
459     static Device *found[DEV_MAX];
460     int i, j;
461
462     j = 0;
463     for (i = 0; i < numDevs; i++) {
464         if ((!name || !strcmp(Devices[i]->name, name))
465             && (class == DEVICE_TYPE_ANY || class == Devices[i]->type))
466             found[j++] = Devices[i];
467     }
468     found[j] = NULL;
469     return j ? found : NULL;
470 }
471
472 Device **
473 deviceFindDescr(char *name, char *desc, DeviceType class)
474 {
475     static Device *found[DEV_MAX];
476     int i, j;
477
478     j = 0;
479     for (i = 0; i < numDevs; i++) {
480         if ((!name || !strcmp(Devices[i]->name, name)) &&
481             (!desc || !strcmp(Devices[i]->description, desc)) &&
482             (class == DEVICE_TYPE_ANY || class == Devices[i]->type))
483             found[j++] = Devices[i];
484     }
485     found[j] = NULL;
486     return j ? found : NULL;
487 }
488
489 int
490 deviceCount(Device **devs)
491 {
492     int i;
493
494     if (!devs)
495         return 0;
496     for (i = 0; devs[i]; i++);
497     return i;
498 }
499
500 /*
501  * Create a menu listing all the devices of a certain type in the system.
502  * The passed-in menu is expected to be a "prototype" from which the new
503  * menu is cloned.
504  */
505 DMenu *
506 deviceCreateMenu(DMenu *menu, DeviceType type, int (*hook)(dialogMenuItem *d), int (*check)(dialogMenuItem *d))
507 {
508     Device **devs;
509     int numdevs;
510     DMenu *tmp = NULL;
511     int i, j;
512
513     devs = deviceFind(NULL, type);
514     numdevs = deviceCount(devs);
515     if (!numdevs)
516         return NULL;
517     tmp = (DMenu *)safe_malloc(sizeof(DMenu) + (sizeof(dialogMenuItem) * (numdevs + 1)));
518     bcopy(menu, tmp, sizeof(DMenu));
519     for (i = 0; devs[i]; i++) {
520         tmp->items[i].prompt = devs[i]->name;
521         for (j = 0; j < numDevs; j++) {
522             if (devs[i] == Devices[j]) {
523                 tmp->items[i].title = Devices[j]->description;
524                 break;
525             }
526         }
527         if (j == numDevs)
528             tmp->items[i].title = "<unknown device type>";
529         tmp->items[i].fire = hook;
530         tmp->items[i].checked = check;
531     }
532     tmp->items[i].title = NULL;
533     return tmp;
534 }