Whamcloud - gitweb
LUDOC-294 protocol: Bring in new connection documentation
[doc/protocol.git] / ldlm_gl_callback.txt
1 Command 104: LDLM_GL_CALLBACK
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3 [[ldlm-gl-callback-rpc]]
4
5 An RPC that assists with getting a lock back from an entity that has
6 it.
7
8 .LDLM_GL_CALLBACK Generic Packet Structure
9 image::ldlm-gl-callback-generic.png["LDLM_GL_CALLBACK Generic Packet Structure",height=100]
10
11 //////////////////////////////////////////////////////////////////////
12 The ldlm-gl-callback-generic.png diagram resemgles this text
13 art:
14
15        LDLM_GL_CALLBACK:
16       --request---------------------
17       | ptlrpc_body | ldlm_request |
18       ------------------------------
19       --reply------------------
20       | ptlrpc_body | ost_lvb |
21       -------------------------
22 //////////////////////////////////////////////////////////////////////
23
24 The request RPC resembles the simplest LDLM_ENQUEUE RPC, but only
25 identifies the relevant resource that the destination entity already
26 had a lock on. It asks the recipient to flush its dirty write cache,
27 and notify the requester of size and time attributes once that is
28 done.  The reply updates the attributes on the requester.
29
30 'ptlrpc_body'::
31 RPC descriptor.
32
33 'ldlm_request'::
34 Description of the lock being requested. Which resource is the target,
35 what lock is current, and what lock desired.
36
37 'ost_lvb'::
38 Attribute data associated with a resource on an OST.
39