release/sysinstall/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  * $Id: devices.c,v 1.93 1999/06/17 19:04:53 markm Exp $
   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     { DEVICE_TYPE_CDROM,        "matcd%da",     "Matsushita CDROM ('sound blaster' type)", 17, 0, 8, 4, 'b'     },
  69     { DEVICE_TYPE_CDROM,        "acd%dc",       "ATAPI IDE CDROM",      19, 2, 8, 4, 'b'                        },
  70     { DEVICE_TYPE_TAPE,         "rsa%d",        "SCSI tape drive",      14, 0, 16, 4, 'c'                       },
  71     { DEVICE_TYPE_TAPE,         "rwt%d",        "Wangtek tape drive",   10, 0, 1, 4, 'c'                        },
  72     { DEVICE_TYPE_DISK,         "da%d",         "SCSI disk device",     4, 65538, 8, 16, 'b'                    },
  73     { DEVICE_TYPE_DISK,         "rda%d",        "SCSI disk device",     13, 65538, 8, 16, 'c'                   },
  74     { DEVICE_TYPE_DISK,         "wd%d",         "IDE/ESDI/MFM/ST506 disk device",       0, 65538, 8, 16, 'b'    },
  75     { DEVICE_TYPE_DISK,         "rwd%d",        "IDE/ESDI/MFM/ST506 disk device",       3, 65538, 8, 16, 'c'    },
  76     { DEVICE_TYPE_DISK,         "fla%d",        "DiskOnChip2000 Flash device", 28, 65538, 8, 16, 'b'    },
  77     { DEVICE_TYPE_DISK,         "rfla%d",       "DiskOnChip2000 Flash devicee", 101, 65538, 8, 16, 'c'  },
  78     { DEVICE_TYPE_DISK,         "wfd%d",        "ATAPI floppy device",  1, 65538, 8, 4, 'b'             },
  79     { DEVICE_TYPE_DISK,         "rwfd%d",       "ATAPI floppy device",  87, 65538, 8, 4, 'c'            },
  80     { DEVICE_TYPE_FLOPPY,       "fd%d",         "floppy drive unit A",  2, 0, 64, 4, 'b'                        },
  81     { DEVICE_TYPE_FLOPPY,       "wfd%d",        "ATAPI floppy drive unit A",    1, 0, 8, 4, 'b'                 },
  82     { DEVICE_TYPE_FLOPPY,       "worm%d",       "SCSI optical disk / CDR",      23, 0, 1, 4, 'b'                },
  83     { DEVICE_TYPE_NETWORK,      "al",           "ADMtek AL981 PCI ethernet card"                                },
  84     { DEVICE_TYPE_NETWORK,      "ax",           "ASIX AX88140A PCI ethernet card"                               },
  85     { DEVICE_TYPE_NETWORK,      "fpa",          "DEC DEFPA PCI FDDI card"                                       },
  86     { DEVICE_TYPE_NETWORK,      "sr",           "SDL T1/E1 sync serial PCI card"                                },
  87     { DEVICE_TYPE_NETWORK,      "cc3i",         "SDL HSSI sync serial PCI card"                                 },
  88     { DEVICE_TYPE_NETWORK,      "en",           "Efficient Networks ATM PCI card"                               },
  89     { DEVICE_TYPE_NETWORK,      "de",           "DEC DE435 PCI NIC or other DC21040-AA based card"              },
  90     { DEVICE_TYPE_NETWORK,      "fxp",          "Intel EtherExpress Pro/100B PCI Fast Ethernet card"            },
  91     { DEVICE_TYPE_NETWORK,      "ed",           "Novell NE1000/2000; 3C503; NE2000-compatible PCMCIA"           },
  92     { DEVICE_TYPE_NETWORK,      "ep",           "3Com 3C509 ethernet card/3C589 PCMCIA"                         },
  93     { DEVICE_TYPE_NETWORK,      "el",           "3Com 3C501 ethernet card"                                      },
  94     { DEVICE_TYPE_NETWORK,      "ex",           "Intel EtherExpress Pro/10 ethernet card"                       },
  95     { DEVICE_TYPE_NETWORK,      "fe",           "Fujitsu MB86960A/MB86965A ethernet card"                       },
  96     { DEVICE_TYPE_NETWORK,      "ie",           "AT&T StarLAN 10 and EN100; 3Com 3C507; NI5210"                 },
  97     { DEVICE_TYPE_NETWORK,      "ix",           "Intel Etherexpress ethernet card"                              },
  98     { DEVICE_TYPE_NETWORK,      "le",           "DEC EtherWorks 2 or 3 ethernet card"                           },
  99     { DEVICE_TYPE_NETWORK,      "lnc",          "Lance/PCnet (Isolan/Novell NE2100/NE32-VL) ethernet"           },
 100     { DEVICE_TYPE_NETWORK,      "mx",           "Macronix 98713/98715/98725 PCI ethernet card"          },
 101     { DEVICE_TYPE_NETWORK,      "pn",           "Lite-On 82168/82169 PNIC PCI ethernet card"            },
 102     { DEVICE_TYPE_NETWORK,      "rl",           "RealTek 8129/8139 PCI ethernet card"           },
 103     { DEVICE_TYPE_NETWORK,      "tx",           "SMC 9432TX ethernet card"                                      },
 104     { DEVICE_TYPE_NETWORK,      "ti",           "Alteon Networks PCI gigabit ethernet card"             },
 105     { DEVICE_TYPE_NETWORK,      "tl",           "Texas Instruments ThunderLAN PCI ethernet card"                },
 106     { DEVICE_TYPE_NETWORK,      "vr",           "VIA VT3043/VT86C100A Rhine PCI ethernet card"                          },
 107     { DEVICE_TYPE_NETWORK,      "vx",           "3COM 3c590 / 3c595 ethernet card"                              },
 108     { DEVICE_TYPE_NETWORK,      "wb",           "Winbond W89C840F PCI ethernet card"                            },
 109     { DEVICE_TYPE_NETWORK,      "xl",           "3COM 3c90x / 3c90xB PCI ethernet card"                         },
 110     { DEVICE_TYPE_NETWORK,      "ze",           "IBM/National Semiconductor PCMCIA ethernet card"               },
 111     { DEVICE_TYPE_NETWORK,      "zp",           "3Com Etherlink III PCMCIA ethernet card"                       },
 112     { DEVICE_TYPE_NETWORK,      "cuaa%d",       "%s on device %s (COM%d)",      28, 128, 1, 16, 'c'             },
 113     { DEVICE_TYPE_NETWORK,      "lp",           "Parallel Port IP (PLIP) peer connection"                       },
 114     { DEVICE_TYPE_NETWORK,      "lo",           "Loop-back (local) network interface"                           },
 115     { 0 },
 116 };
 117
 118 Device *
 119 new_device(char *name)
 120 {
 121     Device *dev;
 122
 123     dev = safe_malloc(sizeof(Device));
 124     bzero(dev, sizeof(Device));
 125     if (name)
 126         SAFE_STRCPY(dev->name, name);
 127     return dev;
 128 }
 129
 130 /* Stubs for unimplemented strategy routines */
 131 Boolean
 132 dummyInit(Device *dev)
 133 {
 134     return TRUE;
 135 }
 136
 137 FILE *
 138 dummyGet(Device *dev, char *dist, Boolean probe)
 139 {
 140     return NULL;
 141 }
 142
 143 void
 144 dummyShutdown(Device *dev)
 145 {
 146     return;
 147 }
 148
 149 static int
 150 deviceTry(struct _devname dev, char *try, int i)
 151 {
 152     int fd;
 153     char unit[80];
 154     mode_t m;
 155     dev_t d;
 156     int fail;
 157
 158     snprintf(unit, sizeof unit, dev.name, i);
 159     snprintf(try, FILENAME_MAX, "/dev/%s", unit);
 160     fd = open(try, O_RDONLY);
 161     if (fd >= 0)
 162         return fd;
 163     m = 0640;
 164     if (dev.dev_type == 'c')
 165         m |= S_IFCHR;
 166     else
 167         m |= S_IFBLK;
 168     d = makedev(dev.major, dev.minor + (i * dev.delta));
 169     fail = mknod(try, m, d);
 170     fd = open(try, O_RDONLY);
 171     if (fd >= 0)
 172         return fd;
 173     else if (!fail)
 174         (void)unlink(try);
 175     /* Don't try a "make-under" here since we're using a fixit floppy in this case */
 176     snprintf(try, FILENAME_MAX, "/mnt/dev/%s", unit);
 177     fd = open(try, O_RDONLY);
 178     return fd;
 179 }
 180
 181 /* Register a new device in the devices array */
 182 Device *
 183 deviceRegister(char *name, char *desc, char *devname, DeviceType type, Boolean enabled,
 184                Boolean (*init)(Device *), FILE * (*get)(Device *, char *, Boolean),
 185                void (*shutdown)(Device *), void *private)
 186 {
 187     Device *newdev = NULL;
 188
 189     if (numDevs == DEV_MAX)
 190         msgFatal("Too many devices found!");
 191     else {
 192         newdev = new_device(name);
 193         newdev->description = desc;
 194         newdev->devname = devname;
 195         newdev->type = type;
 196         newdev->enabled = enabled;
 197         newdev->init = init ? init : dummyInit;
 198         newdev->get = get ? get : dummyGet;
 199         newdev->shutdown = shutdown ? shutdown : dummyShutdown;
 200         newdev->private = private;
 201         Devices[numDevs] = newdev;
 202         Devices[++numDevs] = NULL;
 203     }
 204     return newdev;
 205 }
 206
 207 /* Reset the registered device chain */
 208 void
 209 deviceReset(void)
 210 {
 211     int i;
 212
 213     for (i = 0; i < numDevs; i++) {
 214         Devices[i]->shutdown(Devices[i]);
 215
 216         /* XXX this potentially leaks Devices[i]->private if it's being
 217          * used to point to something dynamic, but you're not supposed
 218          * to call this routine at such times that some open instance
 219          * has its private ptr pointing somewhere anyway. XXX
 220          */
 221         free(Devices[i]);
 222     }
 223     Devices[numDevs = 0] = NULL;
 224 }
 225
 226 /* Get all device information for devices we have attached */
 227 void
 228 deviceGetAll(void)
 229 {
 230     int i, j, fd, s;
 231     struct ifconf ifc;
 232     struct ifreq *ifptr, *end;
 233     int ifflags;
 234     char buffer[INTERFACE_MAX * sizeof(struct ifreq)];
 235     char **names;
 236
 237     msgNotify("Probing devices, please wait (this can take a while)...");
 238     /* First go for the network interfaces.  Stolen shamelessly from ifconfig! */
 239     ifc.ifc_len = sizeof(buffer);
 240     ifc.ifc_buf = buffer;
 241
 242     s = socket(AF_INET, SOCK_DGRAM, 0);
 243     if (s < 0)
 244         goto skipif;    /* Jump over network iface probing */
 245
 246     if (ioctl(s, SIOCGIFCONF, (char *) &ifc) < 0)
 247         goto skipif;    /* Jump over network iface probing */
 248
 249     ifflags = ifc.ifc_req->ifr_flags;
 250     end = (struct ifreq *) (ifc.ifc_buf + ifc.ifc_len);
 251     for (ifptr = ifc.ifc_req; ifptr < end; ifptr++) {
 252         char *descr;
 253
 254         /* If it's not a link entry, forget it */
 255         if (ifptr->ifr_ifru.ifru_addr.sa_family != AF_LINK)
 256             goto loopend;
 257
 258         /* Eliminate network devices that don't make sense */
 259         if (!strncmp(ifptr->ifr_name, "lo", 2))
 260             goto loopend;
 261
 262         /* If we have a slip device, don't register it */
 263         if (!strncmp(ifptr->ifr_name, "sl", 2)) {
 264             goto loopend;
 265         }
 266         /* And the same for ppp */
 267         if (!strncmp(ifptr->ifr_name, "tun", 3) || !strncmp(ifptr->ifr_name, "ppp", 3)) {
 268             goto loopend;
 269         }
 270         /* Try and find its description */
 271         for (i = 0, descr = NULL; device_names[i].name; i++) {
 272             int len = strlen(device_names[i].name);
 273
 274             if (!ifptr->ifr_name || !ifptr->ifr_name[0])
 275                 continue;
 276             else if (!strncmp(ifptr->ifr_name, device_names[i].name, len)) {
 277                 descr = device_names[i].description;
 278                 break;
 279             }
 280         }
 281         if (!descr)
 282             descr = "<unknown network interface type>";
 283
 284         deviceRegister(ifptr->ifr_name, descr, strdup(ifptr->ifr_name), DEVICE_TYPE_NETWORK, TRUE,
 285                        mediaInitNetwork, NULL, mediaShutdownNetwork, NULL);
 286         msgDebug("Found a network device named %s\n", ifptr->ifr_name);
 287         close(s);
 288         if ((s = socket(AF_INET, SOCK_DGRAM, 0)) < 0)
 289             continue;
 290
 291 loopend:
 292         if (ifptr->ifr_addr.sa_len)     /* I'm not sure why this is here - it's inherited */
 293             ifptr = (struct ifreq *)((caddr_t)ifptr + ifptr->ifr_addr.sa_len - sizeof(struct sockaddr));
 294     }
 295
 296 skipif:
 297     /* Next, try to find all the types of devices one might need
 298      * during the second stage of the installation.
 299      */
 300     for (i = 0; device_names[i].name; i++) {
 301         for (j = 0; j < device_names[i].max; j++) {
 302             char try[FILENAME_MAX];
 303
 304             switch(device_names[i].type) {
 305             case DEVICE_TYPE_CDROM:
 306                 fd = deviceTry(device_names[i], try, j);
 307                 if (fd >= 0 || errno == EBUSY) {        /* EBUSY if already mounted */
 308                     char n[BUFSIZ];
 309
 310                     if (fd >= 0) close(fd);
 311                     snprintf(n, sizeof n, device_names[i].name, j);
 312                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
 313                                          DEVICE_TYPE_CDROM, TRUE, mediaInitCDROM, mediaGetCDROM,
 314                                          mediaShutdownCDROM, NULL);
 315                     msgDebug("Found a CDROM device for %s\n", try);
 316                 }
 317                 break;
 318
 319             case DEVICE_TYPE_TAPE:
 320                 fd = deviceTry(device_names[i], try, j);
 321                 if (fd >= 0) {
 322                     char n[BUFSIZ];
 323
 324                     close(fd);
 325                     snprintf(n, sizeof n, device_names[i].name, j);
 326                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
 327                                    DEVICE_TYPE_TAPE, TRUE, mediaInitTape, mediaGetTape, mediaShutdownTape, NULL);
 328                     msgDebug("Found a TAPE device for %s\n", try);
 329                 }
 330                 break;
 331
 332             case DEVICE_TYPE_DISK:
 333                 fd = deviceTry(device_names[i], try, j);
 334                 if (fd >= 0 && RunningAsInit) {
 335                     dev_t d;
 336                     mode_t m;
 337                     int s, fail;
 338                     char unit[80], slice[80];
 339
 340                     close(fd);
 341                     /* Make associated slice entries */
 342                     for (s = 1; s < 8; s++) {
 343                         snprintf(unit, sizeof unit, device_names[i].name, j);
 344                         snprintf(slice, sizeof slice, "/dev/%ss%d", unit, s);
 345                         d = makedev(device_names[i].major, device_names[i].minor +
 346                                     (j * device_names[i].delta) + (s * SLICE_DELTA));
 347                         m = 0640;
 348                         if (device_names[i].dev_type == 'c')
 349                             m |= S_IFCHR;
 350                         else
 351                             m |= S_IFBLK;
 352                         fail = mknod(slice, m, d);
 353                         fd = open(slice, O_RDONLY);
 354                         if (fd >= 0)
 355                             close(fd);
 356                         else if (!fail)
 357                             (void)unlink(slice);
 358                     }
 359                 }
 360                 break;
 361
 362             case DEVICE_TYPE_FLOPPY:
 363                 fd = deviceTry(device_names[i], try, j);
 364                 if (fd >= 0) {
 365                     char n[BUFSIZ];
 366
 367                     close(fd);
 368                     snprintf(n, sizeof n, device_names[i].name, j);
 369                     deviceRegister(strdup(n), device_names[i].description, strdup(try),
 370                                    DEVICE_TYPE_FLOPPY, TRUE, mediaInitFloppy, mediaGetFloppy,
 371                                    mediaShutdownFloppy, NULL);
 372                     msgDebug("Found a floppy device for %s\n", try);
 373                 }
 374                 break;
 375
 376             case DEVICE_TYPE_NETWORK:
 377                 fd = deviceTry(device_names[i], try, j);
 378                 /* The only network devices that you can open this way are serial ones */
 379                 if (fd >= 0) {
 380                     char *newdesc, *cp;
 381
 382                     close(fd);
 383                     cp = device_names[i].description;
 384                     /* Serial devices get a slip and ppp device each, if supported */
 385                     newdesc = safe_malloc(strlen(cp) + 40);
 386                     sprintf(newdesc, cp, "SLIP interface", try, j + 1);
 387                     deviceRegister("sl0", newdesc, strdup(try), DEVICE_TYPE_NETWORK, TRUE, mediaInitNetwork,
 388                                    NULL, mediaShutdownNetwork, NULL);
 389                     msgDebug("Add mapping for %s to sl0\n", try);
 390                     newdesc = safe_malloc(strlen(cp) + 50);
 391                     sprintf(newdesc, cp, "PPP interface", try, j + 1);
 392                     deviceRegister("ppp0", newdesc, strdup(try), DEVICE_TYPE_NETWORK, TRUE, mediaInitNetwork,
 393                                    NULL, mediaShutdownNetwork, NULL);
 394                     msgDebug("Add mapping for %s to ppp0\n", try);
 395                 }
 396                 break;
 397
 398             default:
 399                 break;
 400             }
 401         }
 402     }
 403
 404     /* Finally, go get the disks and look for DOS partitions to register */
 405     if ((names = Disk_Names()) != NULL) {
 406         int i;
 407
 408         for (i = 0; names[i]; i++) {
 409             Chunk *c1;
 410             Disk *d;
 411
 412             d = Open_Disk(names[i]);
 413             if (!d)
 414                 msgFatal("Unable to open disk %s", names[i]);
 415
 416             deviceRegister(names[i], names[i], d->name, DEVICE_TYPE_DISK, FALSE,
 417                            dummyInit, dummyGet, dummyShutdown, d);
 418             msgDebug("Found a disk device named %s\n", names[i]);
 419
 420             /* Look for existing DOS partitions to register as "DOS media devices" */
 421             for (c1 = d->chunks->part; c1; c1 = c1->next) {
 422                 if (c1->type == fat || c1->type == extended) {
 423                     Device *dev;
 424                     char devname[80];
 425
 426                     /* Got one! */
 427                     snprintf(devname, sizeof devname, "/dev/%s", c1->name);
 428                     dev = deviceRegister(c1->name, c1->name, strdup(devname), DEVICE_TYPE_DOS, TRUE,
 429                                          mediaInitDOS, mediaGetDOS, mediaShutdownDOS, NULL);
 430                     dev->private = c1;
 431                     msgDebug("Found a DOS partition %s on drive %s\n", c1->name, d->name);
 432                 }
 433             }
 434         }
 435         free(names);
 436     }
 437 }
 438
 439 /* Rescan all devices, after closing previous set - convenience function */
 440 void
 441 deviceRescan(void)
 442 {
 443     deviceReset();
 444     deviceGetAll();
 445 }
 446
 447 /*
 448  * Find all devices that match the criteria, allowing "wildcarding" as well
 449  * by allowing NULL or ANY values to match all.  The array returned is static
 450  * and may be used until the next invocation of deviceFind().
 451  */
 452 Device **
 453 deviceFind(char *name, DeviceType class)
 454 {
 455     static Device *found[DEV_MAX];
 456     int i, j;
 457
 458     j = 0;
 459     for (i = 0; i < numDevs; i++) {
 460         if ((!name || !strcmp(Devices[i]->name, name))
 461             && (class == DEVICE_TYPE_ANY || class == Devices[i]->type))
 462             found[j++] = Devices[i];
 463     }
 464     found[j] = NULL;
 465     return j ? found : NULL;
 466 }
 467
 468 Device **
 469 deviceFindDescr(char *name, char *desc, DeviceType class)
 470 {
 471     static Device *found[DEV_MAX];
 472     int i, j;
 473
 474     j = 0;
 475     for (i = 0; i < numDevs; i++) {
 476         if ((!name || !strcmp(Devices[i]->name, name)) &&
 477             (!desc || !strcmp(Devices[i]->description, desc)) &&
 478             (class == DEVICE_TYPE_ANY || class == Devices[i]->type))
 479             found[j++] = Devices[i];
 480     }
 481     found[j] = NULL;
 482     return j ? found : NULL;
 483 }
 484
 485 int
 486 deviceCount(Device **devs)
 487 {
 488     int i;
 489
 490     if (!devs)
 491         return 0;
 492     for (i = 0; devs[i]; i++);
 493     return i;
 494 }
 495
 496 /*
 497  * Create a menu listing all the devices of a certain type in the system.
 498  * The passed-in menu is expected to be a "prototype" from which the new
 499  * menu is cloned.
 500  */
 501 DMenu *
 502 deviceCreateMenu(DMenu *menu, DeviceType type, int (*hook)(dialogMenuItem *d), int (*check)(dialogMenuItem *d))
 503 {
 504     Device **devs;
 505     int numdevs;
 506     DMenu *tmp = NULL;
 507     int i, j;
 508
 509     devs = deviceFind(NULL, type);
 510     numdevs = deviceCount(devs);
 511     if (!numdevs)
 512         return NULL;
 513     tmp = (DMenu *)safe_malloc(sizeof(DMenu) + (sizeof(dialogMenuItem) * (numdevs + 1)));
 514     bcopy(menu, tmp, sizeof(DMenu));
 515     for (i = 0; devs[i]; i++) {
 516         tmp->items[i].prompt = devs[i]->name;
 517         for (j = 0; j < numDevs; j++) {
 518             if (devs[i] == Devices[j]) {
 519                 tmp->items[i].title = Devices[j]->description;
 520                 break;
 521             }
 522         }
 523         if (j == numDevs)
 524             tmp->items[i].title = "<unknown device type>";
 525         tmp->items[i].fire = hook;
 526         tmp->items[i].checked = check;
 527     }
 528     tmp->items[i].title = NULL;
 529     return tmp;
 530 }