Blame - Documentation/filesystems/nfs/nfs41-server.txt - kernel/msm-4.9

2009-04-03 08:29:20 +0300

[diff] [blame]

1

NFSv4.1 Server Implementation

2

3

Server support for minorversion 1 can be controlled using the

4

/proc/fs/nfsd/versions control file. The string output returned

5

by reading this file will contain either "+4.1" or "-4.1"

6

correspondingly.

7

J. Bruce Fields

4bd8eab

2013-11-19 09:50:48 -0500

[diff] [blame]

8

Currently, server support for minorversion 1 is enabled by default.

9

It can be disabled at run time by writing the string "-4.1" to

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

10

the /proc/fs/nfsd/versions control file. Note that to write this

J. Bruce Fields

4bd8eab

2013-11-19 09:50:48 -0500

[diff] [blame]

11

control file, the nfsd service must be taken down. You can use rpc.nfsd

12

for this; see rpc.nfsd(8).

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

13

J. Bruce Fields

285a0f0

2009-09-20 17:01:33 -0400

[diff] [blame]

14

(Warning: older servers will interpret "+4.1" and "-4.1" as "+4" and

15

"-4", respectively. Therefore, code meant to work on both new and old

16

kernels must turn 4.1 on or off *before* turning support for version 4

17

on or off; rpc.nfsd does this correctly.)

18

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

19

The NFSv4 minorversion 1 (NFSv4.1) implementation in nfsd is based

J. Bruce Fields

73834d6

2010-01-20 17:17:04 -0500

[diff] [blame]

20

on RFC 5661.

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

21

22

From the many new features in NFSv4.1 the current implementation

23

focuses on the mandatory-to-implement NFSv4.1 Sessions, providing

24

"exactly once" semantics and better control and throttling of the

25

resources allocated for each client.

26

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

27

The table below, taken from the NFSv4.1 document, lists

28

the operations that are mandatory to implement (REQ), optional

29

(OPT), and NFSv4.0 operations that are required not to implement (MNI)

30

in minor version 1. The first column indicates the operations that

31

are not supported yet by the linux server implementation.

32

33

The OPTIONAL features identified and their abbreviations are as follows:

34

pNFS Parallel NFS

35

FDELG File Delegations

36

DDELG Directory Delegations

37

38

The following abbreviations indicate the linux server implementation status.

39

I Implemented NFSv4.1 operations.

40

NS Not Supported.

Christoph Hellwig

2014-09-25 11:28:02 +0200

[diff] [blame]

41

NS* Unimplemented optional feature.

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

Operations

+----------------------+------------+--------------+----------------+

46

47

48

| | MNI | or OPT) | |

49

+----------------------+------------+--------------+----------------+

50

J. Bruce Fields

cb73a9f

2012-11-01 18:09:48 -0400

[diff] [blame]

51

I | BACKCHANNEL_CTL | REQ | | Section 18.33 |

J. Bruce Fields

2011-07-18 18:40:21 -0400

[diff] [blame]

52

I | BIND_CONN_TO_SESSION | REQ | | Section 18.34 |

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

I | CREATE_SESSION | REQ | | Section 18.36 |

| | | (REQ) | |

J. Bruce Fields

292a417

2012-11-07 19:41:51 -0500

[diff] [blame]

61

I | DESTROY_CLIENTID | REQ | | Section 18.50 |

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

62

I | DESTROY_SESSION | REQ | | Section 18.37 |

63

I | EXCHANGE_ID | REQ | | Section 18.35 |

J. Bruce Fields

2011-07-18 18:40:21 -0400

[diff] [blame]

64

I | FREE_STATEID | REQ | | Section 18.38 |

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

65

Christoph Hellwig

2014-09-25 11:28:02 +0200

[diff] [blame]

66

67

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

68

69

Christoph Hellwig

2014-09-25 11:28:02 +0200

[diff] [blame]

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

NS*| OPENATTR | OPT | | Section 18.17 |

82

| OPEN_CONFIRM | MNI | | N/A |

J. Bruce Fields

2010-04-19 15:11:28 -0400

[diff] [blame]

90

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

91

| RELEASE_LOCKOWNER | MNI | | N/A |

92

93

94

| RENEW | MNI | | N/A |

J. Bruce Fields

2011-07-18 18:40:21 -0400

[diff] [blame]

98

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

99

100

I | SEQUENCE | REQ | | Section 18.46 |

101

102

| SETCLIENTID | MNI | | N/A |

103

| SETCLIENTID_CONFIRM | MNI | | N/A |

104

NS | SET_SSV | REQ | | Section 18.47 |

J. Bruce Fields

2011-07-18 18:40:21 -0400

[diff] [blame]

105

I | TEST_STATEID | REQ | | Section 18.48 |

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

Callback Operations

+-------------------------+-----------+-------------+---------------+

113

114

115

| | MNI | or OPT) | |

116

+-------------------------+-----------+-------------+---------------+

117

Christoph Hellwig

2014-09-25 11:28:02 +0200

[diff] [blame]

118

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

119

Christoph Hellwig

2014-09-25 11:28:02 +0200

[diff] [blame]

120

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

121

NS*| CB_NOTIFY_LOCK | OPT | | Section 20.11 |

| | | (REQ) | |

| | | (REQ) | |

NS | CB_RECALL_SLOT | REQ | | Section 20.8 |

| | | (REQ) | |

| | | (REQ) | |

| | | (REQ) | |

+-------------------------+-----------+-------------+---------------+

139

140

Implementation notes:

141

J. Bruce Fields

4bd8eab

2013-11-19 09:50:48 -0500

[diff] [blame]

142

SSV:

143

* The spec claims this is mandatory, but we don't actually know of any

144

implementations, so we're ignoring it for now. The server returns

145

NFS4ERR_ENCR_ALG_UNSUPP on EXCHANGE_ID, which should be future-proof.

146

147

GSS on the backchannel:

148

* Again, theoretically required but not widely implemented (in

149

particular, the current Linux client doesn't request it). We return

150

NFS4ERR_ENCR_ALG_UNSUPP on CREATE_SESSION.

151

J. Bruce Fields

285a0f0

2009-09-20 17:01:33 -0400

[diff] [blame]

152

DELEGPURGE:

153

* mandatory only for servers that support CLAIM_DELEGATE_PREV and/or

154

CLAIM_DELEG_PREV_FH (which allows clients to keep delegations that

155

persist across client reboots). Thus we need not implement this for

156

now.

157

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

158

EXCHANGE_ID:

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

159

* implementation ids are ignored

160

161

CREATE_SESSION:

162

* backchannel attributes are ignored

Benny Halevy

2009-04-03 08:29:20 +0300

[diff] [blame]

163

164

SEQUENCE:

165

* no support for dynamic slot table renegotiation (optional)

166

Andy Adamson

ddc04fd

2009-09-23 21:32:21 -0400

[diff] [blame]

167

Nonstandard compound limitations:

168

* No support for a sessions fore channel RPC compound that requires both a

169

ca_maxrequestsize request and a ca_maxresponsesize reply, so we may

170

fail to live up to the promise we made in CREATE_SESSION fore channel

171

negotiation.

J. Bruce Fields