Whamcloud - gitweb
LUDOC-270 doc: describe more connect flags
[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