LUDOC-297 protocol: Update protocol document

[doc/protocol.git] / mds_getxattr.txt

diff --git a/mds_getxattr.txt b/mds_getxattr.txt
index c6960e0..40f26a1 100644 (file)
--- a/mds_getxattr.txt
+++ b/mds_getxattr.txt
@@ -4,31 +4,26 @@ RPC 49: MDS_GETXATTR
 
 An RPC that fetches extended attributes for a resource.
 
-.MDS_GETXATTR Generic Packet Structure
-image::mds-getxattr-generic.png["MDS_GETXATTR Generic Packet Structure",height=100]
+.MDS_GETXATTR Request Packet Structure
+image::mds-getxattr-request.png["MDS_GETXATTR Request Packet Structure",height=50]
 
 //////////////////////////////////////////////////////////////////////
-The mds-getxattr-generic.png diagram resembles this text art:
+The mds-getxattr-request.png diagram resembles this text art:
 
        MDS_GETXATTR:
       --request-----------------------------------------------
       | ptlrpc_body | mdt_body | lustre_capa | name | eadata |
       --------------------------------------------------------
-      --reply----------------------------
-      | ptlrpc_body | mdt_body | eadata |
-      -----------------------------------
 //////////////////////////////////////////////////////////////////////
 
 'ptlrpc_body'::
-RPC descriptor.
+RPC descriptor. See <<struct-ptlrpc-body>>.
 
 'mdt_body'::
-Metadata about the resource.
+Metadata about the resource. See <<struct-mdt-body>>.
 
 '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.
+A "capabilities" structure. See <<struct-lustre-capa>>.
 
 'name'::
 A text field supplying the name of the desired resource.
@@ -37,3 +32,25 @@ A text field supplying the name of the desired resource.
 Information about extended attributes. This buffer is optional and will
 appear as zero length in some packets.
 
+.MDS_GETXATTR Reply Packet Structure
+image::mds-getxattr-reply.png["MDS_GETXATTR Reply Packet Structure",height=50]
+
+//////////////////////////////////////////////////////////////////////
+The mds-getxattr-reply.png diagram resembles this text art:
+
+       MDS_GETXATTR:
+      --reply----------------------------
+      | ptlrpc_body | mdt_body | eadata |
+      -----------------------------------
+//////////////////////////////////////////////////////////////////////
+
+'ptlrpc_body'::
+RPC descriptor. See <<struct-ptlrpc-body>>.
+
+'mdt_body'::
+Metadata about the resource. See <<struct-mdt-body>>.
+
+'eadata'::
+Information about extended attributes. This buffer is optional and will
+appear as zero length in some packets.
+