dk(4) - NetBSD Manual Pages

DK(4)                   NetBSD Kernel Interfaces Manual                  DK(4)


NAME

     dk -- disk partition (wedge) driver


SYNOPSIS

     options DKWEDGE_AUTODISCOVER
     options DKWEDGE_METHOD_BSDLABEL
     options DKWEDGE_METHOD_GPT
     options DKWEDGE_METHOD_MBR
     options DKWEDGE_METHOD_RDB
     options DKWEDGE_METHOD_APPLE


DESCRIPTION

     The dk driver provides a disk-like interface, or wedge, to an area of a
     physical disk.  Wedges may be configured manually with dkctl(8) or auto-
     matically by the kernel upon the attachment of the physical disk.

     Wedges need to have unique names.  If a duplicate name is detected during
     auto-discovery, that partition is ignored.


KERNEL OPTIONS

     DKWEDGE_AUTODISCOVER     Automatically detect and configure wedges using
                              any available methods.

                              Currently only DKWEDGE_METHOD_GPT and
                              DKWEDGE_METHOD_APPLE are enabled by default.

                              For each partition found, a wedge with a corre-
                              sponding name is created.

     DKWEDGE_METHOD_BSDLABEL  BSD disklabel detection method.  For each con-
                              figured partition in the disklabel(5) that is
                              not of type FS_UNUSED, a wedge is created and
                              named after the d_packname field followed by `/'
                              and the partition letter `a'..`p'.

                              When the d_packname is empty or has the value
                              ``fictitious'', the regular partition names are
                              used as wedge names, i.e. the device name, unit
                              number and partition letter, for example
                              ``wd0a''.

     DKWEDGE_METHOD_GPT       Extensible Firmware Interface Globally Unique
                              Identifier Partition Table (GPT) detection
                              method.

                              For every GPT partition a wedge is created and
                              named after the partition label.  GPT partitions
                              are UTF-16-encoded, this is converted into
                              UTF-8.  If a partition has no label, its UUID is
                              used instead.

     DKWEDGE_METHOD_MBR       IBM PC-compatible Master Boot Record (MBR) par-
                              titioning detection method, with support for
                              Extended MBRs.

                              For every partition in the MBR a wedge is cre-
                              ated and named like a regular partition name,
                              i.e. the device name, unit number and a parti-
                              tion letter, for example ``wd0e''.  Primary par-
                              titions start with `e', extended partitions
                              start with `i'.

     DKWEDGE_METHOD_RDB       Amiga Rigid Disk Block (RDB) partitioning detec-
                              tion method.

     DKWEDGE_METHOD_APPLE     Apple partition map detection method.


FILES

     /dev/{,r}dk*  dk device special files.


SEE ALSO

     config(1), disklabel(8), dkctl(8), fdisk(8), gpt(8), MAKEDEV(8)


HISTORY

     The dk driver first appeared in NetBSD 3.0.


AUTHORS

     The dk driver was written by Jason R. Thorpe.

NetBSD 10.99                    January 6, 2021                   NetBSD 10.99