LUDOC-296 protocol: Rearrange presentation to be more top-down

[doc/protocol.git] / mds_getattr.txt

diff --git a/mds_getattr.txt b/mds_getattr.txt
index 7a0d3d4..5399d7b 100644 (file)
--- a/mds_getattr.txt
+++ b/mds_getattr.txt
@@ -2,10 +2,35 @@ RPC 33: MDS GETATTR - Get MDS Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 [[mds-getattr-rpc]]
 
-.MDS_GETATTR (33)
-[options="header"]
-|====
-| request       | reply
-| mdt_body_capa | mds_getattr_server
-|====
+.MDS_GETATTR Generic Packet Structure
+image::mds-getattr-generic.png["MDS_GETATTR Generic Packet Structure",height=100]
 
+//////////////////////////////////////////////////////////////////////
+The mds-getattr-generic.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>>.
+
+include::struct_mdt_body.txt[]
+
+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.