Ensure scratch operations happen on master core.

Change-Id: I970d645108de041d410599847edce877cb794015
Reviewed-on: http://gfw160.austin.ibm.com:8080/gerrit/275
Tested-by: Jenkins Server
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>
Reviewed-by: A. Patrick Williams III <iawillia@us.ibm.com>

1 files changed, 12 insertions, 3 deletions

diff --git a/src/include/sys/task.h b/src/include/sys/task.h
index fc1604607..9f43996c4 100644
--- a/src/include/sys/task.h
+++ b/src/include/sys/task.h
@@ -30,7 +30,7 @@
 #include <kernel/types.h>
 
 #ifdef __cplusplus
-extern "C" 
+extern "C"
 {
 #endif
 
@@ -102,8 +102,8 @@ tid_t task_exec(const char* path, void* arg);
 /** @fn task_affinity_pin
  *  @brief Pins a task onto the CPU it is currently executing on.
  *
- *  This function may be called any number of times and each should be paired 
- *  with a task_affinity_unpin call.  This is so that callers do not need to 
+ *  This function may be called any number of times and each should be paired
+ *  with a task_affinity_unpin call.  This is so that callers do not need to
  *  be concerned with affinity pinning desires of functions above and below in
  *  a call stack.
  *
@@ -121,6 +121,15 @@ void task_affinity_pin();
  */
 void task_affinity_unpin();
 
+/** @fn task_affinity_migrate_to_master
+ *  @brief Moves a task from the CPU it is on to the master core/thread.
+ *
+ *  Unless the affinity is pinned, the task could be migrated to another
+ *  core at any point in time.  Suggestion is to use task_affinity_pin
+ *  prior to this call.
+ */
+void task_affinity_migrate_to_master();
+
 #ifdef __cplusplus
 }
 #endif