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

[doc/protocol.git] / mds_reint.txt

diff --git a/mds_reint.txt b/mds_reint.txt
index 2491047..ce48981 100644 (file)
--- a/mds_reint.txt
+++ b/mds_reint.txt
@@ -21,8 +21,10 @@ typedef enum {
 } mds_reint_t, mdt_reint_t;
 ----
 
-REINT_SETATTR
-^^^^^^^^^^^^^
+include::struct_mdt_rec_reint.txt[]
+
+REINT_SETATTR RPC
+^^^^^^^^^^^^^^^^^
 [[mds-reint-setattr-rpc]]
 
 An RPC that implements the 'setattr' sub-command of the MDS_REINT.
@@ -45,15 +47,8 @@ The mds-reint-setattr-generic.png diagram resembles this text art:
       -------------------------------------------------------
 //////////////////////////////////////////////////////////////////////
 
-The second buffer ('mdt_rec_setattr' in the above) is one of the
-variants specific to the particular REINT as given by the
-'mdt_reint_t' opcode. Each such variant has the same number and size
-of fields, but how the fields are interpreted varies slightly between
-variiants. For all the variant structures refer to
-<<mds-reint-structs>>.
-
-REINT_SETXATTR
-^^^^^^^^^^^^^^
+REINT_SETXATTR RPC
+^^^^^^^^^^^^^^^^^^
 [[mds-reint-setxattr-rpc]]
 
 An RPC that implements the 'setxattr' sub-command of the MDS_REINT.
@@ -79,11 +74,9 @@ The mds-reint-setxattr-generic.png diagram resembles this text art:
 'ptlrpc_body'::
 RPC descriptor.
 
-'mdt_rec_setattr'::
-Information pertinent to setting attributes on the MDT.
+include::struct_mdt_rec_setattr.txt[]
 
-'mdt_rec_setxattr'::
-Information pertinent to setting extended attributes on the MDT.
+include::struct_mdt_rec_setxattr.txt[]
 
 'lustre_capa'::
 So called "capabilities" structure. This is deprecated in recent