Whamcloud - gitweb
LUDOC-294 protocol: Bring in new connection documentation
[doc/protocol.git] / ldlm_cp_callback.txt
1 Command 105: LDLM_CP_CALLBACK
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3 [[ldlm-cp-callback-rpc]]
4
5 An RPC that notifies an entity that a requested lock is now available.
6
7 .LDLM_CP_CALLBACK Generic Packet Structure
8 image::ldlm-cp-callback-generic.png["LDLM_CP_CALLBACK Generic Packet Structure",height=100]
9
10 //////////////////////////////////////////////////////////////////////
11 The ldlm-cp-callback-generic.png diagram resembles this text
12 art:
13
14        LDLM_CP_CALLBACK:
15       --request-------------------------------
16       | ptlrpc_body | ldlm_request | ost_lvb |
17       ----------------------------------------
18       --reply--------
19       | ptlrpc_body |
20       ---------------
21 //////////////////////////////////////////////////////////////////////
22
23 The request RPC identifies the relevant resource that already had a
24 request pending. It notifies the original requester that it now has
25 the stated lock, along with attribute information the about the
26 resource. The reply is just an acknowledgment of receipt, and doesn't
27 carry any further information about the lock or the resource.
28
29 'ptlrpc_body'::
30 RPC descriptor.
31
32 'ldlm_request'::
33 Description of the lock being requested. Which resource is the target,
34 what lock is current, and what lock desired.
35
36 'ost_lvb'::
37 Attribute data associated with a resource on an OST.
38