Whamcloud - gitweb
LUDOC-297 protocol: Update protocol document
[doc/protocol.git] / mds_getstatus.txt
1 RPC 40: MDS GETSTATUS - get the status from a target
2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3 [[mds-getstatus-rpc]]
4
5 Get the attributes of the mountpoint of the file system.
6
7 .MDS_GETSTATUS Request Packet Structure
8 image::mds-getstatus-request.png["MDS_GETSTATUS Request Packet Structure",height=50]
9
10 //////////////////////////////////////////////////////////////////////
11 The mds-getstatus-request.png diagram resembles this text art:
12
13        MDS_GETSTATUS:
14       --request-----------------
15       | ptlrpc_body | mdt_body |
16       --------------------------
17 //////////////////////////////////////////////////////////////////////
18
19 'ptlrpc_body'::
20 RPC descriptor. See <<struct-ptlrpc-body>>.
21
22 'mdt_body'::
23 See <<struct-mdt-body>>.
24
25 In the request message, the 'mdt_body' is normally empty.
26
27 .MDS_GETSTATUS Reply Packet Structure
28 image::mds-getstatus-reply.png["MDS_GETSTATUS Reply Packet Structure",height=50]
29
30 //////////////////////////////////////////////////////////////////////
31 The mds-getstatus-reply.png diagram resembles this text art:
32
33        MDS_GETSTATUS:
34       --reply-------------------
35       | ptlrpc_body | mdt_body |
36       --------------------------
37 //////////////////////////////////////////////////////////////////////
38
39 'ptlrpc_body'::
40 RPC descriptor. See <<struct-ptlrpc-body>>.
41
42 'mdt_body'::
43 See <<struct-mdt-body>>.
44
45 In the reply message, the 'mdt_body' contains only the FID of the
46 filesystem ROOT in 'mbo_fid1'.  The client can then use the returned
47 FID to fetch inode attributes for the root inode of the local
48 mountpoint.
49