[PATCH] imsm: Add NO_IMSM_PLATFORM flag description to manual.

[Marcin Tomczak <marcin.tomczak@intel.com>]

In exceptional cases user can use NO_IMSM_PLATFORM flag to use IMSM
metadata RAIDs without valid Intel platform. With this flag set
mdadm does not perform any compatibility checks.

Note: Usage of this flag may lead to data loss!

Signed-off-by: Marcin Tomczak <marcin.tomczak@intel.com>
---
 mdadm.8.in |   19 +++++++++++++++++++
 1 files changed, 19 insertions(+), 0 deletions(-)

diff --git a/mdadm.8.in b/mdadm.8.in
index 535cc39..3ef20c7 100644
--- a/mdadm.8.in
+++ b/mdadm.8.in
@@ -2714,6 +2714,25 @@ to '1', the
 .I mdadm
 will create and devices that are needed.
 
+.TP
+.B IMSM_NO_PLATFORM
+ATTENTION! Usage of this flag is extremely dangerous! You should use
+this flag only when you know what you are doing and when it is
+necessary. Make a backup before any action. You use it on your own
+responsibility - unpredictable effects may appear much later.
+
+The IMSM_NO_PLATFORM flag concerns only IMSM metadata. By default, IMSM
+metadata is supported only by Intel based platforms with OROM and it's
+shared between Linux, Microsoft Windows and OROM, thus you can switch
+between these environments safely. When you use a mdadm command and the
+value of the flag is set to '1', then mdadm does not care about the
+hardware configuration and OROM restrictions. It may cause a
+compatibility problem and OROM or Windows can, for example, set the
+state of the RAID volume to failed and then you may lose all your data.
+Other possible scenario is that created RAID Volume will be
+incompatible with target platform's OROM and volume will not be
+assembled on that platform.
+
 .SH EXAMPLES
 
 .B "  mdadm \-\-query /dev/name-of-device"

---------------------------------------------------------------------
Intel Technology Poland sp. z o.o.
z siedziba w Gdansku
ul. Slowackiego 173
80-298 Gdansk

Sad Rejonowy Gdansk Polnoc w Gdansku, 
VII Wydzial Gospodarczy Krajowego Rejestru Sadowego, 
numer KRS 101882

NIP 957-07-52-316
Kapital zakladowy 200.000 zl

This e-mail and any attachments may contain confidential material for
the sole use of the intended recipient(s). Any review or distribution
by others is strictly prohibited. If you are not the intended
recipient, please contact the sender and delete all copies.