LUDOC-297 protocol: Update protocol document

[doc/protocol.git] / ost_punch.txt

diff --git a/ost_punch.txt b/ost_punch.txt
index 73b1ed9..0413f0d 100644 (file)
--- a/ost_punch.txt
+++ b/ost_punch.txt
@@ -4,29 +4,41 @@ RPC 10: OST_PUNCH
 
 An RPC that modifies the size attribute of a resource on an OST.
 
-.OST_PUNCH Generic Packet Structure
-image::ost-punch-generic.png["OST_PUNCH Generic Packet Structure",height=100]
+.OST_PUNCH Request Packet Structure
+image::ost-punch-request.png["OST_PUNCH Request Packet Structure",height=50]
 
 //////////////////////////////////////////////////////////////////////
-The ost-punch-generic.png diagram resembles this text art:
+The ost-punch-request.png diagram resembles this text art:
 
        OST_PUNCH:
       --request-------------------------------
       | ptlrpc_body | ost_body | lustre_capa |
       ----------------------------------------
+//////////////////////////////////////////////////////////////////////
+
+'ptlrpc_body'::
+RPC descriptor. See <<struct-ptlrpc-body>>.
+
+'ost_body'::
+Metadata about the resource. See <struct-ost-body>>.
+
+include::struct_lustre_capa.txt[]
+
+.OST_PUNCH Reply Packet Structure
+image::ost-punch-reply.png["OST_PUNCH Reply Packet Structure",height=50]
+
+//////////////////////////////////////////////////////////////////////
+The ost-punch-reply.png diagram resembles this text art:
+
+       OST_PUNCH:
       --reply-------------------
       | ptlrpc_body | ost_body |
       --------------------------
 //////////////////////////////////////////////////////////////////////
 
 'ptlrpc_body'::
-RPC descriptor.
+RPC descriptor. See <<struct-ptlrpc-body>>.
 
 'ost_body'::
 Metadata about the resource, as it appears on the OST.
 
-'lustre_capa'::
-So called "capabilities" structure. This is deprecated in recent
-versions of Lustre, and commonly appears in the packet header as a zero
-length buffer.
-