LUDOC-297 protocol: Update protocol document

[doc/protocol.git] / struct_lustre_handle.txt

diff --git a/struct_lustre_handle.txt b/struct_lustre_handle.txt
index 37c305e..99d76c0 100644 (file)
--- a/struct_lustre_handle.txt
+++ b/struct_lustre_handle.txt
@@ -1,18 +1,12 @@
-Lustre Handle
-^^^^^^^^^^^^^
+.Lustre Handle
 [[struct-lustre-handle]]
-
-A 'lustre_handle' is an opaque cookie that identifies some local object
-to another node or another layer in the software stack.  It is not the
-physical address of the data structure in memory to avoid memory
-corruption in case the object has been freed, but rather a cookie in a
-lookup table that provides a layer of indirection that can safely
-determine if the object still exists or not.
-
-A 'lustre_handle' can identify a variety of different types of objects,
-such as client-target connections, open file handles, DLM lock handles,
-etc.  The meaning of the handle is dependent on the context in which it
-is used.
+****
+A 'lustre_handle' is an opaque cookie that identifies some local
+object to another node or another layer in the software stack.  It can
+identify a variety of different types of objects, such as
+client-target connections, open file handles, DLM lock handles, etc.
+The meaning of the handle is dependent on the context in which it is
+used.
 
 [source,c]
 ----
@@ -20,4 +14,4 @@ struct lustre_handle {
         __u64 cookie;
 };
 ----
-
+****