LUDOC-297 protocol: Update protocol document

[doc/protocol.git] / mds_getattr.txt

diff --git a/mds_getattr.txt b/mds_getattr.txt
index 5399d7b..f470f09 100644 (file)
--- a/mds_getattr.txt
+++ b/mds_getattr.txt
@@ -2,35 +2,58 @@ RPC 33: MDS GETATTR - Get MDS Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[mds-getattr-rpc]]
 
-.MDS_GETATTR Generic Packet Structure
-image::mds-getattr-generic.png["MDS_GETATTR Generic Packet Structure",height=100]
+Get attribute information for a resource on an MDT.
+
+.MDS_GETATTR Request Packet Structure
+image::mds-getattr-request.png["MDS_GETATTR Request Packet Structure",height=50]
 
 //////////////////////////////////////////////////////////////////////
-The mds-getattr-generic.png diagram resembles this text art:
+The mds-getattr-request.png diagram resembles this text art:
 
        MDS_GETATTR:
       --request-------------------------------
       | ptlrpc_body | mdt_body | lustre_capa |
       ----------------------------------------
-      --reply------------------------------------------------
-      | ptlrpc_body | mdt_body | MDS_MD | ACL | lustre_capa |
-      -------------------------------------------------------
-      | lustre_capa |
-      ---------------
 //////////////////////////////////////////////////////////////////////
 
 'ptlrpc_body'::
-RPC descriptor. See <<struct-ptlrpc_body>>.
+RPC descriptor. See <<struct-ptlrpc-body>>.
 
 include::struct_mdt_body.txt[]
 
+'lustre_capa'::
+A "capabilities" structure. See <<struct-lustre-capa>>.
+
+.MDS_GETATTR Reply Packet Structure
+image::mds-getattr-reply.png["MDS_GETATTR Reply Packet Structure",height=50]
+
+//////////////////////////////////////////////////////////////////////
+The mds-getattr-reply.png diagram resembles this text art:
+
+       MDS_GETATTR:
+      --reply----------------------------------------------
+      | ptlrpc_body | mdt_body | MDS_MD | ACL | fid1_capa |
+      -----------------------------------------------------
+      | fid2_capa |
+      ---------------
+//////////////////////////////////////////////////////////////////////
+
+'ptlrpc_body'::
+RPC descriptor. See <<struct-ptlrpc-body>>.
+
+'mdt_body'::
+Metadata about the resource. See <<struct-mdt-body>>.
+
 MDS_MD::
 Needs more detail.
 
 ACL::
 Needs more detail.
 
-'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.
+'fid1_capa'::
+The capabilities structure for the first FID in the 'mdt_body'. See
+<<struct-lustre-capa>>.
+
+'fid2_capa'::
+The capabilities structure for the second FID in the 'mdt_body'. See
+<<struct-lustre-capa>>.