Whamcloud - gitweb
90150e92a9e719c501b4e1c1c56661c052ce3c0d
[doc/protocol.git] / ldlm_bl_callback.txt
1 Command 104: LDLM_BL_CALLBACK
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3 [[ldlm-bl-callback-rpc]]
4
5 An RPC that assists with getting a lock back from an entity that has
6 it.
7
8 .LDLM_BL_CALLBACK Generic Packet Structure
9 image::ldlm-bl-callback-generic.png["LDLM_BL_CALLBACK Generic Packet Structure",height=100]
10
11 //////////////////////////////////////////////////////////////////////
12 The ldlm-bl-callback-generic.png diagram resembles this text
13 art:
14
15        LDLM_BL_CALLBACK:
16       --request---------------------
17       | ptlrpc_body | ldlm_request |
18       ------------------------------
19       --reply--------
20       | ptlrpc_body |
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 notifies the recipient that the lock should be
27 returned once and dirty write data has been flushed.  The Reply is
28 just an acknowledgment of receipt, and doesn't carry any further
29 information about the lock or the resource.
30
31 'ptlrpc_body'::
32 RPC descriptor.
33
34 'ldlm_request'::
35 Description of the lock being requested. Which resource is the target,
36 what lock is current, and what lock desired.
37