4.3. Special Device Driver Files

4.3.1. What Special Files Are
4.3.2. Naming Conventions for Special Files
4.3.3. Creating Special Files

This section reviews the special device driver files required for file system support.

If your target is an NFS client only (all its files are physically located on another system, such as the host workstation), you can skip this section.

4.3.1. What Special Files Are

The C5 system requires you to use special (7S) device driver files to access the hardware devices where file systems reside. This means that disk labeling and other operations on uninitialized and unmounted file systems must be done using special files.

Each disk partition corresponds to at least one special file. Unless you plan to use a raw partition directly — without a file system— you must be able to access each partition in both block (buffered) mode and raw (character) mode, so you must create not just one special file per partition, but two. Each special file:

  • Refers to either a block or a raw device. Block devices are used by file systems. Raw devices are used primarily for file system administration.

  • Has a major number. Major numbers are used by the system to select the corresponding device driver when several devices are configured. Major numbers are the same for all devices managed by a given device driver and a given access method (raw or block). For example, all devices corresponding to hard disk partitions using raw mode have the same major number.

  • Has a minor number. Minor numbers are not used directly by the system, but by the selected device driver. Minor numbers are different for each partition on a device. Their scope is limited to the device described by the major number, so special files with different major numbers may share the same minor number. One minor number corresponds to one partition.

4.3.2. Naming Conventions for Special Files

Special files normally reside in the /dev directory, which is mounted at boot time. By convention, special file names follow the form /dev/rsuffix for raw (character) mode and /dev/suffix for buffered (block) mode. See also Section 9.3, “Supported Devices”.

The suffix is made up of:

  • A string of letters referring to the device driver name, such as sd for a SCSI disk, rd for a RAM disk, hd for an IDE disk or flash for flash,

  • Followed by a digit representing the disk unit number, such as 0, 1, 2 and so forth (except for special files not related to file systems, such as tty device files),

  • Terminated by a single letter referring to the partition, such as a, b, ... h.

[Caution]Caution

Special care must be taken with partition c. Partition c represents the whole disk and therefore must not be used to support a file system.

Because file systems are based on BSD 4.4 as implemented in FreeBSD 4.1, the same limitations found in FreeBSD 4.1 apply to C5 file system management. According to limitations imposed by FreeBSD, a disk can be divided into a maximum of eight different partitions for IDE and SCSI devices, two partitions for RAM devices. Partitions can be left undefined. Partitions are named using a single character in the range from a to h, each letter corresponding to one of the eight partitions for IDE and SCSI devices. For RAM devices, only partitions a and c are available.

[Note]Note

The C5 operating system differs from FreeBSD 4.1 in that the latter does not distinguish between raw devices and block devices. With the C5 operating system both forms of special files are retained for backward compatibility. It is recommended to use the block device.

4.3.3. Creating Special Files

You create special files using mknod( 1M) on the C5 system. Generally, you create the special files you need at boot time by including commands in the system initialization file, sysadm.ini( 4CC).

Procedure 4.2. Creating Special Files at Boot Time

To create special files at boot time using the sysadm.ini( 4CC) file embedded in the system image, follow this procedure:

  1. Change to the directory containing sysadm.ini:

    host% cd 
    build_dir/conf
  2. Include commands of the following form in sysadm.ini using the C_INIT(1M) built-in command mknod(1M):

    mknod /dev/name [b|c] 
    maj_nbr min_nbr

    where name follows the pattern described in Section 4.3.2, “Naming Conventions for Special Files”, b represents a buffered (block) device, c represents a character (raw) device, maj_nbr is the major number of the device and min_nbr is the minor number of the partition on the device. The following table lists memory devices by major number:

    Major Number

    Device

    Mode

    3

    ISA/IDE disk

    character (raw) and block (buffered)

    4

    CD_ROM disk

    character (raw)

    7

    Flash device

    character (raw)and block (buffered)

    9

    SCSI disk

    character (raw) and block (buffered)

    13

    RAM disk

    character (raw) and block (buffered)

    15

    SCSI CD-ROM

    character (raw)

    17

    RAWFLASH

    character (raw)

    23

    BPF

    character (raw)

    24

    NVRAM

    character (raw)

    Note that RAM disk devices used for memory banks conventionally have major numbers 11 and 12 and are used internally by the system to make the contents of the memory banks, including the system image, available for use at boot time.

  3. Build the system image to include modifications to sysadm.ini :

    host% cd ..
    
    host% make 
    system_image_name

Procedure 4.3. Creating Special Files Manually

To create special files manually on a running C5 target system:

  • Run commands on the target of the type:

    host% rsh 
    target mknod dev/name [b|c] 
    maj_nbr min_nbr

    Where name follows the pattern described in Section 4.3.2, “Naming Conventions for Special Files”, b represents a buffered (block) device, c represents a character (raw) device, maj_nbr is the major number of the device and min_nbr is the minor number of the partition on the device.