LUDOC-276 protocol: Document RPCs for setattr

[doc/protocol.git] / data_types.txt

diff --git a/data_types.txt b/data_types.txt
index aac0f1f..ea75748 100644 (file)
--- a/data_types.txt
+++ b/data_types.txt
@@ -62,8 +62,8 @@ informs the client of the value in the 'pb_transno' field of the
 requests that do not modify the file system the 'pb_transno' field in
 the 'ptlrpc_body' is just set to 0.
 
-Structured Data Types
-~~~~~~~~~~~~~~~~~~~~~
+Miscellaneous Structured Data Types
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Extended Attributes
 ^^^^^^^^^^^^^^^^^^^
@@ -76,7 +76,8 @@ Lustre Capabilities
 ^^^^^^^^^^^^^^^^^^^
 
 A 'lustre_capa' structure conveys details about the capabilities
-supported (or requested) between a client and a given target.
+supported (or requested) between a client and a given target. I am
+told that this is deprecated in later version of Lustre.
 
 ----
 #define CAPA_HMAC_MAX_LEN       64
@@ -93,49 +94,8 @@ struct lustre_capa {
 }
 ----
 
-MDT Data
-^^^^^^^^
+include::lustre_file_ids.txt[]
 
-An 'mdt_body' structure holds details about a given MDT.
-
-----
-struct mdt_body {
-        struct lu_fid  fid1;
-        struct lu_fid  fid2;
-        struct lustre_handle handle;
-        __u64          valid;
-        __u64          size;
-       obd_time        mtime;
-       obd_time        atime;
-       obd_time        ctime;
-        __u64          blocks;
-        __u64          ioepoch;
-       __u64          t_state;
-        __u32          fsuid;
-        __u32          fsgid;
-        __u32          capability;
-        __u32          mode;
-        __u32          uid;
-        __u32          gid;
-        __u32          flags;
-        __u32          rdev;
-        __u32          nlink;
-       __u32          unused2;
-        __u32          suppgid;
-        __u32          eadatasize;
-        __u32          aclsize;
-        __u32          max_mdsize;
-        __u32          max_cookiesize;
-        __u32          uid_h;
-        __u32          gid_h;
-        __u32          padding_5;
-        __u64          padding_6;
-        __u64          padding_7;
-        __u64          padding_8;
-        __u64          padding_9;
-        __u64          padding_10;
-}; /* 216 */
-----
 
 MGS Configuration Reference
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -168,19 +128,7 @@ struct mgs_config_res {
 The 'mgs_config_res' structure returns information about the Lustre
 file system.
 
-Lustre Handle
-^^^^^^^^^^^^^
-
-----
-struct lustre_handle {
-    __u64 cookie;
-};
-----
-
-A Lustre handle is a reference to an import or an export. Those
-objects maintain state about the connection between a given client
-and a given target. The import is on the client and the corresponding
-export is on the server.
+include::lustre_handle.txt[]
 
 Lustre Message Header
 ^^^^^^^^^^^^^^^^^^^^^
@@ -604,3 +552,8 @@ struct ost_id {
 };
 ----
 
+include::mdt_structs.txt[]
+
+include::mds_reint_structs.txt[]
+
+include::ost_setattr_structs.txt[]