NFSv4.1-rfc5661

Internet Engineering Task Force (IETF) S. Shepler, Ed.

Request for Comments: 5661 Storspeed, Inc.

Category: Standards Track M. Eisler, Ed.

ISSN: 2070-1721 D. Noveck, Ed.

NetApp

January 2010

Network File System (NFS) Version 4 Minor Version 1 Protocol

Abstract

This document describes the Network File System (NFS) version 4 minor

considered a separate protocol. Thus, this document neither updates

nor obsoletes RFC 3530. NFS minor version 1 is deemed superior to

NFS minor version 0 with no loss of functionality, and its use is

preferred over version 0. Both NFS minor versions 0 and 1 can be

used simultaneously on the same network, between the same client and

server.

Status of This Memo

This is an Internet Standards Track document.

This document is a product of the Internet Engineering Task Force

(IETF). It represents the consensus of the IETF community. It has

Shepler, et al. Standards Track [Page 1]

RFC 5661 NFSv4.1 January 2010

Copyright Notice

Copyright (c) 2010 IETF Trust and the persons identified as the

document authors. All rights reserved.

This document is subject to BCP 78 and the IETF Trust’s Legal

Provisions Relating to IETF Documents

(http://trustee.ietf.org/license-info) in effect on the date of

publication of this document. Please review these documents

carefully, as they describe your rights and restrictions with respect

to this document. Code Components extracted from this document must

include Simplified BSD License text as described in Section 4.e of

the Trust Legal Provisions and are provided without warranty as

described in the Simplified BSD License.

Shepler, et al. Standards Track [Page 2]

RFC 5661 NFSv4.1 January 2010

Table of Contents

1. Introduction ....................................................9

1.1. The NFS Version 4 Minor Version 1 Protocol .................9

1.2. Requirements Language ......................................9

1.3. Scope of This Document .....................................9

1.4. NFSv4 Goals ...............................................10

1.5. NFSv4.1 Goals .............................................10

1.6. General Definitions .......................................11

1.7. Overview of NFSv4.1 Features ..............................13

1.8. Differences from NFSv4.0 ..................................17

2. Core Infrastructure ............................................18

2.1. Introduction ..............................................18

2.2. RPC and XDR ...............................................19

2.3. COMPOUND and CB_COMPOUND ..................................22

2.10. Session ..................................................40

3. Protocol Constants and Data Types ..............................86

3.1. Basic Constants ...........................................86

3.2. Basic Data Types ..........................................87

3.3. Structured Data Types .....................................89

4. Filehandles ....................................................97

4.1. Obtaining the First Filehandle ............................98

4.2. Filehandle Types ..........................................99

4.3. One Method of Constructing a Volatile Filehandle .........101

4.4. Client Recovery from Filehandle Expiration ...............102

5.1. REQUIRED Attributes ......................................104

5.2. RECOMMENDED Attributes ...................................104

6. Access Control Attributes .....................................126

6.1. Goals ....................................................126

6.2. File Attributes Discussion ...............................128

Shepler, et al. Standards Track [Page 3]

RFC 5661 NFSv4.1 January 2010

6.3. Common Methods ...........................................144

6.4. Requirements .............................................147

7. Single-Server Namespace .......................................153

7.1. Server Exports ...........................................153

7.2. Browsing Exports .........................................153

7.3. Server Pseudo File System ................................154

7.4. Multiple Roots ...........................................155

7.5. Filehandle Volatility ....................................155

7.6. Exported Root ............................................155

7.7. Mount Point Crossing .....................................156

7.8. Security Policy and Namespace Presentation ...............156

8. State Management ..............................................157

8.1. Client and Session ID ....................................158

8.2. Stateid Definition .......................................158

8.3. Lease Renewal ............................................167

9. File Locking and Share Reservations ...........................184

9.1. Opens and Byte-Range Locks ...............................184

9.2. Lock Ranges ..............................................188

9.3. Upgrading and Downgrading Locks ..........................188

9.4. Stateid Seqid Values and Byte-Range Locks ................189

9.5. Issues with Multiple Open-Owners .........................189

9.6. Blocking Locks ...........................................190

9.7. Share Reservations .......................................191

9.8. OPEN/CLOSE Operations ....................................192

9.9. Open Upgrade and Downgrade ...............................192

9.11. Reclaim of Open and Byte-Range Locks ....................194

10. Client-Side Caching ..........................................194

11.1. Location Attributes .....................................228

11.2. File System Presence or Absence .........................229

11.3. Getting Attributes for an Absent File System ............230

Shepler, et al. Standards Track [Page 4]

RFC 5661 NFSv4.1 January 2010

11.4. Uses of Location Information ............................232

11.5. Location Entries and Server Identity ....................236

11.6. Additional Client-Side Considerations ...................237

11.7. Effecting File System Transitions .......................238

11.8. Effecting File System Referrals .........................251

11.9. The Attribute fs_locations ..............................258

11.10. The Attribute fs_locations_info ........................261

11.11. The Attribute fs_status ................................273

12. Parallel NFS (pNFS) ..........................................277

12.1. Introduction ............................................277

12.2. pNFS Definitions ........................................278

12.3. pNFS Operations .........................................284

12.4. pNFS Attributes .........................................285

12.5. Layout Semantics ........................................285

12.6. pNFS Mechanics ..........................................300

13.3. File Layout Data Types ..................................312

13.4. Interpreting the File Layout ............................317

13.5. Data Server Multipathing ................................324

13.6. Operations Sent to NFSv4.1 Data Servers .................325

13.7. COMMIT through Metadata Server ..........................327

13.8. The Layout Iomode .......................................328

13.9. Metadata and Data Server State Coordination .............329

13.10. Data Server Component File Size ........................332

13.11. Layout Revocation and Fencing ..........................333

13.12. Security Considerations for the File Layout Type .......334

14.1. Stringprep profile for the utf8str_cs type ..............336

14.2. Stringprep profile for the utf8str_cis type .............337

17. Operations: REQUIRED, RECOMMENDED, or OPTIONAL ...............403

18. NFSv4.1 Operations ...........................................407

18.1. Operation 3: ACCESS - Check Access Rights ...............407

Shepler, et al. Standards Track [Page 5]