mkdev -- call scripts to add peripheral devices


/etc/mkdev aio
/etc/mkdev apc
/etc/mkdev bitpad
/etc/mkdev cdrom
/etc/mkdev cdrom_iiop (for Tricord Intelligent I/O Processor)
/etc/mkdev cf
/etc/mkdev dda
/etc/mkdev dos
/etc/mkdev dtfs
/etc/mkdev eccd
/etc/mkdev fd
/etc/mkdev flopti
/etc/mkdev fs [ device file ]
/etc/mkdev getns0 (internal to mkdev do not use)
/etc/mkdev graphics
/etc/mkdev hd [ -hnu ]
/etc/mkdev hd ID number lun ha [ bus ]
/etc/mkdev hd drivenum ctrlnum
/etc/mkdev hd_iiop (for Tricord Intelligent I/O Processor)
/etc/mkdev [ -l ] high-sierra
/etc/mkdev hostmib
/etc/mkdev hpnp
/etc/mkdev hpps
/etc/mkdev htfs
/etc/mkdev ida
/etc/mkdev ipf
/etc/mkdev isapnp
/etc/mkdev juke
/etc/mkdev layers
/etc/mkdev lp
/etc/mkdev ls120
/etc/mkdev mmdf
/etc/mkdev modem
/etc/mkdev mouse
/etc/mkdev nis
/etc/mkdev parallel
/etc/mkdev pm
/etc/mkdev ptty
/etc/mkdev rlp
/etc/mkdev scoansi
/etc/mkdev serial
/etc/mkdev shl
/etc/mkdev snmp
/etc/mkdev streams
/etc/mkdev tape
/etc/mkdev tape_iiop (for Tricord Intelligent I/O Processor)
/etc/mkdev tcp (obsolete)
/etc/mkdev vdisk
/etc/mkdev vpixld
/etc/mkdev [-l] xenix


mkdev creates the device file(s) associated with a peripheral device. Based on the argument supplied, the mkdev command calls a script found in the directory /usr/lib/mkdev. (There may be scripts found in this directory that are specific to a given application or software package that are not documented here.) If no arguments are listed, mkdev prints a usage message.

mkdev aio
add support for asynchronous disk I/O to the kernel (see aio(HW)).

mkdev apc
add or remove support for American Power Corporation uninterruptible power supplies (UPSs).

The installation process adds the script S99apcssd to the /etc/rc2.d directory. This script starts the UPS serial port monitoring daemon ssd (/usr/lib/apc/ssd) when the system goes to multiuser mode.

When prompted, enter the full pathname of the modem control device (for example, /dev/tty1A or /dev/tty2A) and the expected battery life (default is 300 seconds). This information is written to the file /usr/lib/apc/ssd.ini which ssd reads when it starts.

For the correct cable, contact your UPS manufacturer. The cable required to use this UPS monitoring product on an American Power Conversion UPS is APC part number 940-0023A. For further information on APC UPSs, call 800-890-4APC (US and Canada) or 401-789-5735 (international).

mkdev bitpad
configure supported bitpad devices.

mkdev cdrom
add CD-ROM support to the kernel (see cdrom(HW)).

mkdev dos
initialize necessary devices and configures the system to support mounted DOS filesystems.

mkdev cf
configure the sendmail(ADMN) mailer program.

mkdev dda
add direct device access support for SCO® VP/ix® to the kernel.

mkdev dtfs
add or remove support in the kernel for the DTFS(TM) filesystem.

mkdev eccd
configure the Corollary error correction code (ECC) daemon.

mkdev fd
create bootable, root and filesystem floppy disks (see fd(HW)).

Several floppies can be created during a single mkdev fd session, but mkdev does not display a prompt to remove the first floppy and insert the next one. Insert the next floppy when mkdev prompts ``Would you like to format the floppy first? (y/n).''

mkdev flopti
identical to mkdev ls120 (see Sflp(HW)).

mkdev fs
performs the system maintenance tasks required to add a new filesystem to the system after the device is configured using mkdev hd. Use of this command is not recommended; use the SCOAdmin Filesystem Manager instead. mkdev fs creates the mountpoint and lost+found directory, and reserves slots in the lost+found directory, (if either already exist, they are used unmodified) and modifies /etc/checklist, /etc/default/filesys and /etc/default to check using fsck(ADM) and mount the filesystem using mount(ADM) or mnt(C) as appropriate.

mkdev getns0
this script is invoked by mkdev only and should not be used.

mkdev graphics
configure graphics adapters for use with applications that can take advantage of them.

mkdev hd
add a hard disk to the system by creating the necessary device files (see hd(HW)), and configuring the disk using dparam(ADM), badtrk(ADM) and fdisk(ADM). divvy(ADM) or dkconfig(ADM) can be used to create standard filesystem divisions or filesystems on virtual disks. If a SCSI hard disk is being added, the appropriate host adapter and peripheral driver are also linked into the kernel. USB devices can also be configured with mkdev hd and are configured like SCSI hard disks; see also usb(HW).

The -u option prints information about adding a disk; the -h option prints information about adding disks of a different type to the root hard disk.

The -n (non-interactive) option is used when installing the root hard disk.

Without options or arguments, mkdev hd runs interactively.

The command line syntax for disks with IDE(ST506), ESDI, IDA, and OMTI interfaces is:

mkdev hd drivenum ctrlnum

the number of the disk on the disk controller; 0 for the first, 1 for the second.

the number of the disk controller being installed. If the controller is of the same type as the root controller (ctrlnum 0), it is numbered 1 for the second, 2 for the third, and so on. If it is a different type to the root controller, the numbering starts at 0 for the first new controller of this type, and the number must be prefixed with one of the following codes:

One ESDI controller with two disks is supported on MC architecture machines.

Six Compaq IDA/Intelligent Array Expansion controllers are supported on EISA bus machines.

One OMTI controller with two disks is supported on AT architecture machines.

Two IDE controllers with two disks each are supported on AT architecture machines. MC architecture machines may have one IDE controller with two disks.

For example, the command mkdev hd 1 IDE-0 configures a second disk on the first IDE controller.

The syntax for SCSI disk installation has the form:

mkdev hd ID number lun ha [ bus ]

Here the arguments have the following meanings:

the target ID of the disk controller on the SCSI bus (0-6 for SCSI 1, 0-15 for 16-bit wide SCSI 2; note that the host adapter is usually assigned ID 7).

the number of the SCSI host adapter using the hatype driver (for example, 0 and 1 for the first and second adapters using the eiad driver; 0 for the first additional adapter using a different driver). If the root disk is not SCSI, the number must be prefixed by SCSI-; for example, SCSI-1.

the logical unit number (LUN) of the disk on the controller (always 0 for disks with embedded controllers)

the type of host adapter (supported types are listed in /etc/default/scsihas)

the number of the host adapter bus to which the disk is connected; 0 for the primary bus, 1 for the secondary, and so on. The default value is 0.

For example, the following command configures the second disk on the first Adaptec 154x SCSI adapter where the root disk is non-SCSI:

mkdev hd 1 SCSI-0 0 ad

mkdev hd must be invoked twice to install a SCSI disk. The first time, the kernel is reconfigured to support the new disk. The system must then be rebooted and mkdev hd run a second time to initialize the disk. Use the same arguments to mkdev hd both times.

mkdev [-l] high-sierra
configure support for High Sierra/ISO 9660/Rock Ridge mountable CD-ROM filesystems (see mount(ADM)).

With the -l option, mkdev does not attempt to relink the kernel.

mkdev hostmib
configure SNMP host resources MIB.

mkdev hpnp
add HP Network Printer support software and runs the HP Network Printer configuration script (see hpnpcfg(ADM)).

mkdev hpps
add or remove support in the kernel for the High Performance Pipe System (HPPS). This is the default pipe filesystem. See pipe(ADM) for more details.

mkdev htfs
add or remove support in the kernel for the HTFS(TM) filesystem.

mkdev ida
configure an intelligent disk array controller.

mkdev ipf
configure IP Filter file suitable for use in a firewall environment. (see ipf(ADMP) for more details).

mkdev isapnp
configure an ISA Plug and Play (PnP) device.

mkdev juke
configure a SCSI media changer.

mkdev layers
add support for serial terminals with AT&T windowing capabilities to the kernel (see layers(C) and layers(M) for more details).

mkdev lp
add or modify a printer configuration.

mkdev ls120
add or remove an LS-120 or other non-standard floppy drive, or list the current configuration (see Sflp(HW)).

mkdev mmdf
alter the MMDF configuration.

mkdev modem
Invokes the SCOadmin Modem Manager.

mkdev mouse
initialize necessary devices and configures the system to use any supported mouse (see mouse(HW)).

mkdev nis
initialize NIS configuration.

mkdev parallel
allow the configuration of multiple parallel ports (see parallel(HW)).

mkdev pm
enable or disable power management. Power management is automatically enabled on installation if the hardware supports it (see also apm(HW), pwrsh(ADM), pwrd(ADM), and uapm(HW). ).

mkdev rlp
configure remote printing.

mkdev ptty
add pseudo-ttys to the system.

mkdev scoansi
configures the behavior of the scoansi termcap(F) terminfo(F) database entries and the in-kernel scoansi terminal emulator. As of Release 5.0.6, console driver improvements have been made that may cause problems with applications expecting the old scoansi behavior. Basic terminal compatibility is provided in the form of scoansi-old and scoansi-new terminal database entries. SCO OpenServer systems prior to Release 5.0.6 and other UNIX systems performing remote logins should use the scoansi-old terminal type (unless the system has been reconfigured to use the old entries as described here).

You can use mkdev scoansi to change either the database entries (affecting logins) or the in-kernel scoansi emulator (affecting applications that use the scoansi control sequences). The options are:

  1. Use new (5.0.6 and later) terminal database entries

  2. Use old (pre 5.0.6) terminal database entries

  3. Use new (5.0.6 and later) in-kernel scoansi emulator

  4. Use old (pre 5.0.6) in-kernel scoansi emulator (backwards compatibility mode)
Changing the in-kernel emulator emulator causes the kernel to be relinked and the system must be rebooted. See screen(HW) for more information.

mkdev serial
create device files for use with serial cards (see serial(HW)).

The device files for the first and second ports already exist. Additional device files must be created for the ports added when expansion cards are added to the system.

mkdev shl
initialize necessary devices and configures kernel parameters associated with the number of shell layers sessions available on the system (see shl(C)).

mkdev snmp
initialize SNMP configuration.

mkdev streams
configure the kernel for STREAMS support.

mkdev tape
configure the tape driver in preparation for linking a new kernel that includes tape support (see tape(HW)). It can add:

When configuring a cartridge tape drive, the current driver configurations can be displayed, and changed if necessary. A zero in any of the fields means the driver automatically detects the type of tape device installed and uses the built-in values for that device. If the autoconfiguration values are not correct for your drive, refer to your hardware manual for the correct values, reconfigure the driver and relink the new kernel.

NOTE: Selections for Emerald, Mountain, and Everex cartridge tape drives are provided in mkdev tape for backwards compatibility only. These drives are no longer supported; in particular, they cannot be used for installations.

mkdev tape can also be used to remove a tape driver from the existing kernel.

Once the driver is configured, mkdev prompts you to relink the kernel. It also creates the appropriate device files in /dev and updates the appropriate driver /etc/conf/node.d/* file.

mkdev tcp
obsolete command: use netconfig(ADM) instead.

mkdev vdisk
add or remove support in the kernel for virtual disks. See vdisk(HW) and dkconfig(ADM) for more information.

mkdev vpixld
add the line discipline for SCO VP/ix to the system.

mkdev [-l] xenix
add or remove support for XENIX® filesystems from the kernel. With the -l option, mkdev does not attempt to relink the kernel.

The mkdev scripts prompt for the information necessary to create the associated device files.


location of scripts invoked by mkdev

list of supported SCSI host adapters

See also

badtrk(ADM), divvy(ADM), dkconfig(ADM), dktab(F), dparam(ADM), fd(HW), fdisk(ADM), filesys(F), format(C), hd(HW), jukebox(HW), lp(HW), mkfs(ADM), mknod(C), mount(ADM), mscsi(F), pipe(ADM), rc2(ADM), scsi(HW), serial(HW), Sflp(HW), usemouse(C), tape(HW), vdisk(HW), usb(HW)

The SCO OpenServer Handbook has chapters devoted to the installation of most peripheral devices.

Standards conformance

mkdev is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003