Whamcloud - gitweb
37c305ec4011e95d0dc780406aa6fc82650891a8
[doc/protocol.git] / struct_lustre_handle.txt
1 Lustre Handle
2 ^^^^^^^^^^^^^
3 [[struct-lustre-handle]]
4
5 A 'lustre_handle' is an opaque cookie that identifies some local object
6 to another node or another layer in the software stack.  It is not the
7 physical address of the data structure in memory to avoid memory
8 corruption in case the object has been freed, but rather a cookie in a
9 lookup table that provides a layer of indirection that can safely
10 determine if the object still exists or not.
11
12 A 'lustre_handle' can identify a variety of different types of objects,
13 such as client-target connections, open file handles, DLM lock handles,
14 etc.  The meaning of the handle is dependent on the context in which it
15 is used.
16
17 [source,c]
18 ----
19 struct lustre_handle {
20         __u64 cookie;
21 };
22 ----
23