bdev: Add functions to verify file storage paths

[ganeti-local] / man / ganeti-os-interface.rst

diff --git a/man/ganeti-os-interface.rst b/man/ganeti-os-interface.rst
index 21bc66d..000880c 100644 (file)
--- a/man/ganeti-os-interface.rst
+++ b/man/ganeti-os-interface.rst
@@ -30,6 +30,12 @@ common set of variables will be exported for all commands, and some
 of them might have extra ones. Note that all counts are
 zero-based.
 
+Since Ganeti version 2.5, the environment will be cleaned up before
+being passed to scripts, therefore they will not inherit the environment
+in with which the ganeti node daemon was started. If you depend on any
+environment variables (non-Ganeti), then you will need to define or
+source them appropriately.
+
 OS_API_VERSION
     The OS API version that the rest of the environment conforms to.
 
@@ -225,12 +231,12 @@ script could be::
     #!/bin/sh
 
     case $OSP_DHCP in
-        ""|yes|no)
-            ;;
-        *)
-            echo "Invalid value '$OSP_DHCP' for the dhcp parameter" 1>&2
-            exit 1;
-            ;;
+      ""|yes|no)
+          ;;
+      *)
+        echo "Invalid value '$OSP_DHCP' for the dhcp parameter" 1>&2
+        exit 1;
+        ;;
     esac
 
     exit 0
@@ -255,9 +261,9 @@ one Ganeti version should contain the most recent version first
 variants.list
 ~~~~~~~~~~~~~
 
-variants.list is a plain text file containing all the declared
-supported variants for this OS, one per line. At least one variant
-must be supported.
+variants.list is a plain text file containing all the declared supported
+variants for this OS, one per line. If this file is missing or empty,
+then the OS won't be considered to support variants.
 
 parameters.list
 ~~~~~~~~~~~~~~~
@@ -308,8 +314,9 @@ Version 10 to 15
 
 The ``variants.list`` file has been added, so OSes should support at
 least one variant, declaring it in that file and must be prepared to
-parse the OS_VARIANT environment variable. OSes are free to support
-more variants than just the declared ones.
+parse the OS_VARIANT environment variable. OSes are free to support more
+variants than just the declared ones. Note that this file is optional;
+without it, the variants functionality is disabled.
 
 Version 5 to 10
 ^^^^^^^^^^^^^^^