From: NeilBrown <neilb@suse.de>
Date: Mon, 4 Mar 2013 06:25:36 +0000 (+1100)
Subject: mdadm.8: Detail use for IMSM_NO_PLATFORM environment variable.
X-Git-Tag: mdadm-3.3-rc1~104
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=401f095c39b732b4247bd728cb493eb7bb692298;p=thirdparty%2Fmdadm.git

mdadm.8: Detail use for IMSM_NO_PLATFORM environment variable.

Suggested-by: Marcin Tomczak <marcin.tomczak@intel.com>
---

diff --git a/mdadm.8.in b/mdadm.8.in
index a3abc2d2..1c06533c 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -2710,6 +2710,21 @@ to '1', the
 .I mdadm
 will create and devices that are needed.
 
+.TP
+.B IMSM_NO_PLATFORM
+A key value of IMSM metadata is that it allows interoperability with
+boot ROMs on Intel platforms, and with other major operating systems.
+Consequently,
+.I mdadm
+will only allow an IMSM array to be created or modified if detects
+that it is running on an Intel platform which supports IMSM, and
+supports the particular configuration of IMSM that is being requested
+(some functionality requires newer OROM support).
+
+These checks can be suppressed by setting IMSM_NO_PLATFORM=1 in the
+environment.  This can be useful for testing or for disaster
+recovery.  You should be aware that interoperability may be
+compromised by setting this value.
 .SH EXAMPLES
 
 .B "  mdadm \-\-query /dev/name-of-device"