Whamcloud - gitweb
LUDOC-276 protocol: Document RPCs for setattr
[doc/protocol.git] / mds_reint.txt
1 Command 36: MDS_REINT
2 ~~~~~~~~~~~~~~~~~~~~~
3 [[mds-reint-rpm]]
4
5 An RPC that implements an operation that will change the information
6 on an MDT.
7
8 REINT_SETATTR
9 ^^^^^^^^^^^^^
10 [[mds-reint-setattr-rpc]]
11
12 An RPC that implements the 'setattr' sub-command of the MDS_REINT.
13
14 .MDS_REINT:REINT_SETATTR Generic Packet Structure
15 image::mds-reint-setattr-generic.png["MDS_REINT:REINT_SETATTR Generic Packet Structure",height=100]
16
17 //////////////////////////////////////////////////////////////////////
18 The mds-reint-setattr-generic.png diagram resembles this text art:
19
20         MDS_REINT:
21       --REINT_SETATTR-request-------------------------------------
22       | ptlrpc_body | mdt_rec_setattr | lustre_capa | mdt_ioepoc |
23         eadata | llog_cookie | ldlm_request |
24       ------------------------------------------------------------
25
26       --REINT_SETATTR-reply----------------------------------
27       | ptlrpc_body | mdt_body | mdt_md | acl | lustre_capa |
28         lustre_capa |
29       -------------------------------------------------------
30 //////////////////////////////////////////////////////////////////////
31
32 'ptlrpc_body'::
33 RPC descriptor.
34
35 'mdt_rec_setattr'::
36 Information pertinent to setting attributes on the MDT.
37
38 'lustre_capa'::
39 So called "capabilities" structure. This is deprecated in recent
40 versions of Lustre, and commonly appears in the packet header as a zero
41 length buffer.
42
43 'mdt_ioepoch'::
44 Identifying "epoch" information. This buffer is optional and will
45 appear as zero length in some packets.
46
47 'eadata'::
48 Information about extended attributes. This buffer is optional and will
49 appear as zero length in some packets.
50
51 'llog_cookie'::
52 A log handle.  This buffer is optional and will appear as zero length
53 in some packets.
54
55 'ldlm_request'::
56 A structure specifying a lock that can be the subject of early lock
57 cancellation. See <<early-lock-cancellation>>.
58
59 'mdt_body'::
60 Metadata about the resource.
61
62 'mdt_md'::
63 Layout data for the resource. This buffer is optional and will appear
64 as zero length in some packets.
65
66 'acl'::
67 Access control list data. This buffer is optional and will appear as
68 zero length in some packets.
69