documentation/3338: finding docs on partition names

From: Phil Pennock <Phil.Pennock(at)globnix.org>
Date: Mon Jun 30 2003 - 10:08:11 EDT

>Number: 3338
>Category: documentation
>Synopsis: finding docs on partition names
>Confidential: no
        

	System      : OpenBSD 3.2
	Architecture: OpenBSD.sparc
	Machine     : sparc

>Description:

I'd never realised that disklabel(8) could be safely used even on partitions without BSD disklabel stuff, and would then report the OS view of the partitions and the right naming.

The way in which OpenBSD merges the BIOS partitions, MS-DOS stuff, and its own BSD disklabel slices had never been as clear as it could have been. This isn't aided by the inconsistency that fd0c is "correct".

Here's some simple extra doc references; judging by some recent list mails these might reduce the number of erroneous problem reports from people trying sd0a or sd0c instead of sd0i (or, more correctly, whatever disklabel reports).

>How-To-Repeat:

Unlearn large chunks of what an OpenBSD Team developer already knows.

>Fix:

Patch against a CVS tree updated within the last hour (from a site which syncs every three hours):

Index: sbin/mount/mount.8

---

RCS file: /cvs/src/sbin/mount/mount.8,v
retrieving revision 1.44

diff -u -r1.44 mount.8
--- sbin/mount/mount.8	24 Jun 2003 20:19:20 -0000	1.44
+++ sbin/mount/mount.8	30 Jun 2003 13:45:50 -0000

@@ -69,6 +69,10 @@
 .Ar special
 device must correspond to a partition registered in the  .Xr disklabel 5 .

+Note that
+.Xr disklabel 8
+reports all partitions that the OS can see, handling all mapping of the
+underlying partitioning method, not merely BSD disklabel slices.

 .Pp
 The system maintains a list of currently mounted file systems.  If no arguments are given to
@@ -318,6 +322,9 @@

 .Li # mount -t msdos /dev/fd0a /mnt/floppy
 .Pp
 .Li # mount host:/path/name /mnt/nfs
+.Pp
+.Li # disklabel sd0
+.Li # mount -t msdos /dev/sd0i /mnt/usb-storage
 .Pp
 .Ed
 .Sh SEE ALSO

Index: sbin/mount_msdos/mount_msdos.8

---

RCS file: /cvs/src/sbin/mount_msdos/mount_msdos.8,v retrieving revision 1.17
diff -u -r1.17 mount_msdos.8

--- sbin/mount_msdos/mount_msdos.8	18 Apr 2003 22:16:24 -0000	1.17
+++ sbin/mount_msdos/mount_msdos.8	30 Jun 2003 13:45:50 -0000

@@ -178,3 +178,10 @@
 .Pp
 Note that Windows 95/98 handles only access dates,  but not access times.

+.Pp
+.Ox
+uses device partition letters starting with the letter
+.Li i
+for MS-DOS file-systems.  Use
+.Xr disklabel 8
+to view the letters used on a given device.

Index: share/man/man4/umass.4

---

RCS file: /cvs/src/share/man/man4/umass.4,v retrieving revision 1.3
diff -u -r1.3 umass.4

--- share/man/man4/umass.4	26 Sep 2002 22:09:53 -0000	1.3
+++ share/man/man4/umass.4	30 Jun 2003 13:45:51 -0000

@@ -50,9 +50,16 @@
 .Nm
 driver provides support for USB mass storage class devices.

 .Sh SEE ALSO
+.Xr disklabel 8 ,
 .Xr scsi 4 ,
 .Xr uhub 4 ,
 .Xr usb 4
+.Sh NOTES
+No matter what the filesystem used on the device, using
+.Xr disklabel 8
+with no options and the device name as a parameter will report the

+naming-scheme used by
+.Ox .
 .Sh HISTORY
 The
 .Nm

>Release-Note:
Received on Mon Jun 30 10:28:49 2003