Whamcloud - gitweb
LUDOC-296 protocol: Rearrange presentation to be more top-down
[doc/protocol.git] / mds_statfs.txt
1 RPC 41: MDS_STATFS
2 ~~~~~~~~~~~~~~~~~~
3 [[mds-statfs-rpc]]
4
5 MDS_STATFS ('pb_opc' = 41) is an RPC that queries data about the
6 underlying file system for a given MDT. It's form and use are nearly
7 identical to the OST_STATFS RPC. Refer to <<ost-statfs-rpc>> for
8 details. The only differences in MDS_STATFS are that it has a distinct
9 'pb_opc' value and it carries information about an MDT (instead of an
10 OST).  An MDT will send regular OST_STATFS RPCs to each OST in order
11 to keep its information about free space and utilization updated.
12 That allows the MDS to make more optimal file allocation decisions.
13
14 .MDS_STATFS Generic Packet Structure
15 image::mds-statfs-generic.png["MDS_STATFS Generic Packet Structure",height=100]
16
17 //////////////////////////////////////////////////////////////////////
18 The mds-statfs-generic.png diagram resembles this text art:
19
20        MDS_STATFS:
21       --request------
22       | ptlrpc_body |
23       ---------------
24       --reply---------------------
25       | ptlrpc_body | obd_statfs |
26       ----------------------------
27 //////////////////////////////////////////////////////////////////////
28
29 'ptlrpc_body':: RPC descriptor. See <<ptlrpc_body>>.
30
31 'obd_statfs':: Statfs information about the target. See
32 <struct-obd-statfs>>.