new file mode 100644
@@ -0,0 +1,40 @@
+OPAL_READ_NVRAM
+===============
+::
+
+ #define OPAL_READ_NVRAM 7
+
+ int64_t opal_read_nvram(uint64_t buffer, uint64_t size, uint64_t offset)
+
+Arguments
+---------
+::
+
+ uint64_t buffer
+ uint64_t size
+ uint64_t offset
+
+``buffer``
+ the data from nvram will be copied to ``buffer``
+
+``size``
+ the data of size ``size`` will be copied
+
+``offset``
+ the data will be copied from address equal to base ``nvram_image`` plus ``offset``
+
+``OPAL_READ_NVRAM`` call requests OPAL to read the data from system NVRAM
+memory into a memory buffer. The data at ``offset`` from nvram_image
+will be copied to memory ``buffer`` of size ``size``.
+
+Return Values
+-------------
+
+``OPAL_SUCCESS``
+ data from nvram to memory ``buffer`` copied successfully
+
+``OPAL_PARAMETER``
+ a parameter ``offset`` or ``size`` was incorrect
+
+``OPAL_HARDWARE``
+ either nvram is not initialized or permanent error related to nvram hardware.