LUDOC-298 protocl: Editorial pass through the document.

[doc/protocol.git] / ost_setattr.txt

diff --git a/ost_setattr.txt b/ost_setattr.txt
index b282e00..a91c303 100644 (file)
--- a/ost_setattr.txt
+++ b/ost_setattr.txt
@@ -18,8 +18,21 @@ The ost-setattr-request.png diagram resembles this text art:
 
 include::struct_ptlrpc_body.txt[]
 
+[NOTE]
+The RPC descriptor just described is the first buffer in the
+OST_SETATTR request message. It will also appear as the first buffer
+of every other RPC request or reply sent between entities. Refer back
+to the above discussion when examining other RPC messages. The next
+section describes the 'struct ost_body' which is the second (and
+final) buffer in an OST_SETATTR request message.
+
 include::struct_ost_body.txt[]
 
+The above discussion described the structure of the OST_SETATTR
+request message. In this case the reply message sturcture looks much
+the same. It uses the same to buffers, and oly changes their contents
+to reflect that the message is a reply rather than a requsest.
+
 .OST_SETATTR Reply Packet Structure
 image::ost-setattr-reply.png["OST_SETATTR Reply Packet Structure",height=50]
 
@@ -33,8 +46,8 @@ The ost-setattr-reply.png diagram resembles this text art:
 //////////////////////////////////////////////////////////////////////
 
 'ptlrpc_body'::
-RPC descriptor. See <<struct-ptlrpc-body>>.
+The RPC descriptor. See <<struct-ptlrpc-body>>.
 
 'ost_body'::
-Metadata about the resource. See <struct-ost-body>>.
+Metadata about the resource. See <<struct-ost-body>>.