Tolerate memory UEs during dump extraction.

Change-Id: I0dc57ec047beb47b557b816162d619a5b2a54108
RTC: 64619
Reviewed-on: http://gfw160.austin.ibm.com:8080/gerrit/4600
Tested-by: Jenkins Server
Reviewed-by: ADAM R. MUHLE <armuhle@us.ibm.com>
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>
Reviewed-by: A. Patrick Williams III <iawillia@us.ibm.com>

1 files changed, 21 insertions, 1 deletions

diff --git a/src/include/sys/mm.h b/src/include/sys/mm.h
index f3488b3d8..d71d5a1b3 100644
--- a/src/include/sys/mm.h
+++ b/src/include/sys/mm.h
@@ -5,7 +5,7 @@
 /*                                                                        */
 /* IBM CONFIDENTIAL                                                       */
 /*                                                                        */
-/* COPYRIGHT International Business Machines Corp. 2011,2012              */
+/* COPYRIGHT International Business Machines Corp. 2011,2013              */
 /*                                                                        */
 /* p1                                                                     */
 /*                                                                        */
@@ -141,6 +141,26 @@ void mm_icache_invalidate(void * i_addr, size_t i_cpu_word_count);
  */
 uint64_t mm_virt_to_phys( void* i_vaddr );
 
+/** @fn mm_tolerate_ue
+ *  @brief Allows a task to tolerate a memory UE without being killed.
+ *
+ *  This should be used when copying content from memory of unknown quality,
+ *  such as during a memory preserved IPL.  When a memory UE is consumed by
+ *  the task, instead of killing the task, the kernel will replace the
+ *  memory access by a special value of '0xdeadd47a'.
+ *
+ *  @param[in] i_state - Should the task tolerate memory UEs: 0 = no, 1 = yes.
+ *
+ *  Example usage:
+ *      mm_tolerate_ue(1);
+ *      memcpy(src, dest, size);
+ *      mm_tolerate_ue(0);
+ */
+void mm_tolerate_ue(uint64_t i_state);
+/** Value inserted into process when it encounters a UE, if mm_tolerate_ue is
+ *  enabled. */
+enum { MM_UE_MAGIC_VALUE = 0xdeadd47adeadd47aull };
+
 #ifdef __cplusplus
 }
 #endif