summaryrefslogtreecommitdiff
path: root/static/openbsd/man4/diskmap.4
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 14:02:27 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 14:02:27 -0400
commit6d8bdc65446a704d0750217efd05532fc641ea7d (patch)
tree8ae6d698b3c9801750a8b117b3842fb369872a3a /static/openbsd/man4/diskmap.4
parent2f467bd7ff8f8db0dafa40426166491d7f57f368 (diff)
docs: OpenBSD Man Pages Added
Diffstat (limited to 'static/openbsd/man4/diskmap.4')
-rw-r--r--static/openbsd/man4/diskmap.458
1 files changed, 58 insertions, 0 deletions
diff --git a/static/openbsd/man4/diskmap.4 b/static/openbsd/man4/diskmap.4
new file mode 100644
index 00000000..6f953329
--- /dev/null
+++ b/static/openbsd/man4/diskmap.4
@@ -0,0 +1,58 @@
+.\" $OpenBSD: diskmap.4,v 1.3 2015/09/10 17:55:21 schwarze Exp $
+.\"
+.\" Copyright (c) 2010 Joel Sing <jsing@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: September 10 2015 $
+.Dt DISKMAP 4
+.Os
+.Sh NAME
+.Nm diskmap
+.Nd disklabel UID mapping interface
+.Sh SYNOPSIS
+.In sys/dkio.h
+.Sh DESCRIPTION
+The
+.Nm
+driver provides userland applications with a means to map a disklabel UID to
+an actual device and open that device in one atomic operation.
+This is achieved via the DIOCMAP
+.Xr ioctl 2
+command.
+.Pp
+The ability to use a disklabel UID is helpful in situations
+where a disk may appear to the operating system under different device names.
+For example,
+plugging USB keys into differently configured systems (think sd0 or sd1),
+or swapping between IDE and AHCI on a disk controller (wd0 or sd0).
+Although the device names may change,
+the operating system is still able to identify the disk by its UID.
+.Sh FILES
+.Bl -tag -width /dev/diskmap -compact
+.It Pa /dev/diskmap
+diskmap device
+.El
+.Sh SEE ALSO
+.Xr ioctl 2 ,
+.Xr disklabel 8
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 4.8 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Joel Sing .