From 97a52f68c8185a46025dd48aea43cdd34c2a6dcd Mon Sep 17 00:00:00 2001
From: Manjunath Gorentla Venkata <manjunath@mellanox.com>
Date: Sun, 24 Nov 2019 06:22:13 -0800
Subject: [PATCH] Adding text for fence per PE interface

---
 content/shmem_pe_fence.tex | 37 +++++++++++++++++++++++++++++++++++++
 main_spec.tex              |  3 +++
 2 files changed, 40 insertions(+)
 create mode 100644 content/shmem_pe_fence.tex

diff --git a/content/shmem_pe_fence.tex b/content/shmem_pe_fence.tex
new file mode 100644
index 000000000..c24137ee7
--- /dev/null
+++ b/content/shmem_pe_fence.tex
@@ -0,0 +1,37 @@
+\apisummary{
+    Assures ordering of delivery of memory store, blocking \PUT{}, 
+    \ac{AMO}, and \OPR{put-with-signal}, as well as nonblocking 
+    \PUT{}, \OPR{put-with-signal}, and \ac{AMO}
+    routines to symmetric data objects issued by the calling \ac{PE} at the target \ac{PE}.
+}
+
+\begin{apidefinition}
+
+\begin{Csynopsis}
+void @\FuncDecl{shmem\_fence}@(int target_pe);
+void @\FuncDecl{shmem\_ctx\_fence}@(shmem_ctx_t ctx, int target_pe);
+\end{Csynopsis}
+
+\begin{apiarguments}
+    \apiargument{IN}{ctx}{A context handle specifying the context on which to perform the operation.
+        When this argument is not provided, the operation is performed on
+        the default context.}
+	\apiargument{IN}{target\_pe}{The target \ac{PE} where the operations needs
+	to be completed}
+\end{apiarguments}
+
+\apidescription{
+	The \FUNC{shmem\_pe\_fence} routine assures ordering of operations similar
+	to \FUNC{shmem\_fence}, expect that ordering is ensured only between the
+	calling \ac{PE} and the target \ac{PE}. The ordering of operations between
+	any other \acp{PE} are not guaranteed by the \FUNC{shmem\_pe\_fence} routine.
+}
+
+\apireturnvalues{
+    None.
+}
+
+\apinotes{
+}
+
+\end{apidefinition}
diff --git a/main_spec.tex b/main_spec.tex
index d11ab6857..2e6770dc7 100644
--- a/main_spec.tex
+++ b/main_spec.tex
@@ -478,6 +478,9 @@ \subsection{Memory Ordering Routines}\label{subsec:memory_order}
 \subsubsection{\textbf{SHMEM\_FENCE}}\label{subsec:shmem_fence}
 \input{content/shmem_fence.tex}
 
+\subsubsection{\textbf{SHMEM\_PE\_FENCE}}\label{subsec:shmem_pe_fence}
+\input{content/shmem_pe_fence.tex}
+
 \subsubsection{\textbf{SHMEM\_QUIET}}\label{subsec:shmem_quiet}
 \input{content/shmem_quiet.tex}