DK(4)

DK(4) | Device Drivers 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 automatically 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 corresponding name is created.

`DKWEDGE_METHOD_BSDLABEL`
  BSD disklabel detection method. For each configured 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) partitioning detection method, with support for Extended MBRs.

  For every partition in the MBR a wedge is created and named like a regular partition name, i.e. the device name, unit number and a partition letter, for example “wd0e”. Primary partitions start with ‘e’, extended partitions start with ‘i’.

`DKWEDGE_METHOD_RDB`
  Amiga Rigid Disk Block (RDB) partitioning detection 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.

January 6, 2021 | NetBSD 10.1