Module Name: src
Committed By: jym
Date: Tue Jun 7 17:13:43 UTC 2011
Modified Files:
src/share/man/man4: xbdback.4
Log Message:
Document the naming convention.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/xbdback.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/xbdback.4
diff -u src/share/man/man4/xbdback.4:1.2 src/share/man/man4/xbdback.4:1.3
--- src/share/man/man4/xbdback.4:1.2 Tue Jan 11 10:48:05 2011
+++ src/share/man/man4/xbdback.4 Tue Jun 7 17:13:43 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: xbdback.4,v 1.2 2011/01/11 10:48:05 wiz Exp $
+.\" $NetBSD: xbdback.4,v 1.3 2011/06/07 17:13:43 jym Exp $
.\"
.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd January 8, 2011
+.Dd June 7, 2011
.Dt XBDBACK 4 xen
.Os
.Sh NAME
@@ -42,15 +42,39 @@
used by
.Tn Xen
domains to offer a block device interface, similar to a hard disk.
+.Nm
+interfaces are backed either by a physical device directly,
+or an image file mounted through
+.Xr vnd 4 .
.Pp
+All
+.Nm
+interfaces follow the
+.Dq xbdbackXiY
+naming convention, where
+.Sq X
+represents the guest domain identifier, and
+.Sq Y
+an arbitrary identifier.
+This identifier is usually associated to the device node as seen
+by the guest using
+.Xr major 3
+and
+.Xr minor 3
+numbers.
+For example, identifier
+.Do 769 Dc Po 0x301 Pc
+means major
+.Em 3
+and minor
+.Em 1 ,
+identified as
+.Dq hda1
+under Linux convention.
For
.Nx ,
the guest device name specified in the guest configuration file
does not matter, and can be chosen arbitrarily.
-.Nm
-interfaces are backed either by a physical device directly,
-or an image file mounted through
-.Xr vnd 4 .
.Pp
A
.Nm
