LUDOC-276 protocol: Document RPCs for setattr

[doc/protocol.git] / ldlm_reply.txt

diff --git a/ldlm_reply.txt b/ldlm_reply.txt
new file mode 100644 (file)
index 0000000..018fd00
--- /dev/null
+++ b/ldlm_reply.txt
@@ -0,0 +1,22 @@
+LDLM Reply
+^^^^^^^^^^
+[[struct-ldlm-reply]]
+
+The 'ldlm_reply' structure is the reciprocal of the 'ldlm_request'. 
+
+----
+struct ldlm_reply {
+        __u32 lock_flags;
+        __u32 lock_padding;     /* also fix lustre_swab_ldlm_reply */
+        struct ldlm_lock_desc lock_desc;
+        struct lustre_handle lock_handle;
+        __u64  lock_policy_res1;
+        __u64  lock_policy_res2;
+};
+----
+
+It closely resembles the 'lock_request' in its structure. In this case
+it is reporting back to the initiator of the request (in the
+'lock_desc') both the lock that was actually granted, if any, and lock
+server's (possibly) updated value for what was being requested.
+