RFC-Ref is not longer maintained; use RFC browser at: http://zvon.org/comp/r/ref-RFC.html

RFC 3530:Network File System (NFS) version 4 Proto...

RFC-Ref

Previous | Next

Frontpage | Contents | Keywords

Network File System (NFS) version 4 Protocol

1. Introduction

1.1. Changes since RFC 3010

1.2. NFS Version 4 Goals

1.3. Inconsistencies of this Document with Section 18

1.4. Overview of NFS version 4 Features

1.4.1. RPC and Security

1.4.2. Procedure and Operation Structure

1.4.3. Filesystem Model

1.4.3.1. Filehandle Types

1.4.3.2. Attribute Types

1.4.3.3. Filesystem Replication and Migration

1.4.4. OPEN and CLOSE

1.4.5. File locking

1.4.6. Client Caching and Delegation

1.5. General Definitions

2. Protocol Data Types

2.1. Basic Data Types

2.2. Structured Data Types

3. RPC and Security Flavor

3.1. Ports and Transports

3.1.1. Client Retransmission Behavior

3.2. Security Flavors

3.2.1. Security mechanisms for NFS version 4

3.2.1.1. Kerberos V5 as a security triple

3.2.1.2. LIPKEY as a security triple

3.2.1.3. SPKM-3 as a security triple

3.3. Security Negotiation

3.3.2. Security Error

3.4. Callback RPC Authentication

4.1. Obtaining the First Filehandle

4.1.1. Root Filehandle

4.1.2. Public Filehandle

4.2. Filehandle Types

4.2.1. General Properties of a Filehandle

4.2.2. Persistent Filehandle

4.2.3. Volatile Filehandle

4.2.4. One Method of Constructing a Volatile Filehandle

4.3. Client Recovery from Filehandle Expiration

5. File Attributes

5.1. Mandatory Attributes

5.2. Recommended Attributes

5.3. Named Attributes

5.4. Classification of Attributes

5.5. Mandatory Attributes - Definitions

5.6. Recommended Attributes - Definitions

5.7. Time Access

5.8. Interpreting owner and owner_group

5.9. Character Case Attributes

5.10. Quota Attributes

5.11. Access Control Lists

5.11.1. ACE type

5.11.2. ACE Access Mask

5.11.3. ACE flag

5.11.4. ACE who

5.11.5. Mode Attribute

5.11.6. Mode and ACL Attribute

5.11.7. mounted_on_fileid

6. Filesystem Migration and Replication

6.1. Replication

6.3. Interpretation of the fs_locations Attribute

6.4. Filehandle Recovery for Migration or Replication

7. NFS Server Name Space

7.1. Server Exports

7.2. Browsing Exports

7.3. Server Pseudo Filesystem

7.4. Multiple Roots

7.5. Filehandle Volatility

7.6. Exported Root

7.7. Mount Point Crossing

7.8. Security Policy and Name Space Presentation

8. File Locking and Share Reservations

8.1.1. Client ID

8.1.2. Server Release of Clientid

8.1.3. lock_owner and stateid Definition

8.1.4. Use of the stateid and Locking

8.1.5. Sequencing of Lock Requests

8.1.6. Recovery from Replayed Requests

8.1.7. Releasing lock_owner State

8.1.8. Use of Open Confirmation

8.2. Lock Ranges

8.3. Upgrading and Downgrading Locks

8.4. Blocking Locks

8.5. Lease Renewal

8.6. Crash Recovery

8.6.1. Client Failure and Recovery

8.6.2. Server Failure and Recovery

8.6.3. Network Partitions and Recovery

8.7. Recovery from a Lock Request Timeout or Abort

8.8. Server Revocation of Locks

8.9. Share Reservations

8.10. OPEN/CLOSE Operations

8.10.1. Close and Retention of State Information

8.11. Open Upgrade and Downgrade

8.12. Short and Long Leases

8.13. Clocks, Propagation Delay, and Calculating Lease Expiration

8.14. Migration, Replication and State

8.14.1. Migration and State

8.14.2. Replication and State

8.14.3. Notification of Migrated Lease

8.14.4. Migration and the Lease_time Attribute

9. Client-Side Caching

9.1. Performance Challenges for Client-Side Caching

9.2. Delegation and Callbacks

9.2.1. Delegation Recovery

9.3. Data Caching

9.3.1. Data Caching and OPENs

9.3.2. Data Caching and File Locking

9.3.3. Data Caching and Mandatory File Locking

9.3.4. Data Caching and File Identity

9.4. Open Delegation

9.4.1. Open Delegation and Data Caching

9.4.2. Open Delegation and File Locks

9.4.3. Handling of CB_GETATTR

9.4.4. Recall of Open Delegation

9.4.5. Clients that Fail to Honor Delegation Recalls

9.4.6. Delegation Revocation

9.5. Data Caching and Revocation

9.5.1. Revocation Recovery for Write Open Delegation

9.6. Attribute Caching

9.7. Data and Metadata Caching and Memory Mapped Files

9.8. Name Caching

9.9. Directory Caching

10. Minor Versioning

11. Internationalization

11.1. Stringprep profile for the utf8str_cs type

11.1.1. Intended applicability of the nfs4_cs_prep profile

11.1.2. Character repertoire of nfs4_cs_prep

11.1.3. Mapping used by nfs4_cs_prep

11.1.4. Normalization used by nfs4_cs_prep

11.1.5. Prohibited output for nfs4_cs_prep

11.1.6. Bidirectional output for nfs4_cs_prep

11.2. Stringprep profile for the utf8str_cis type

11.2.1. Intended applicability of the nfs4_cis_prep profile

11.2.2. Character repertoire of nfs4_cis_prep

11.2.3. Mapping used by nfs4_cis_prep

11.2.4. Normalization used by nfs4_cis_prep

11.2.5. Prohibited output for nfs4_cis_prep

11.2.6. Bidirectional output for nfs4_cis_prep

11.3. Stringprep profile for the utf8str_mixed type

11.3.1. Intended applicability of the nfs4_mixed_prep profile

11.3.2. Character repertoire of nfs4_mixed_prep

11.3.3. Mapping used by nfs4_cis_prep

11.3.4. Normalization used by nfs4_mixed_prep

11.3.5. Prohibited output for nfs4_mixed_prep

11.3.6. Bidirectional output for nfs4_mixed_prep

11.4. UTF-8 Related Errors

12. Error Definitions

13. NFS version 4 Requests

13.1. Compound Procedure

13.2. Evaluation of a Compound Request

13.3. Synchronous Modifying Operations

13.4. Operation Values

14. NFS version 4 Procedures

14.1. Procedure 0: NULL - No Operation

14.2. Procedure 1: COMPOUND - Compound Operations

14.2.1. Operation 3: ACCESS - Check Access Rights

14.2.2. Operation 4: CLOSE - Close File

14.2.3. Operation 5: COMMIT - Commit Cached Data

14.2.4. Operation 6: CREATE - Create a Non-Regular File Object

14.2.5. Operation 7: DELEGPURGE - Purge Delegations Awaiting Recovery

14.2.6. Operation 8: DELEGRETURN - Return Delegation

14.2.7. Operation 9: GETATTR - Get Attributes

14.2.8. Operation 10: GETFH - Get Current Filehandle

14.2.9. Operation 11: LINK - Create Link to a File

14.2.10. Operation 12: LOCK - Create Lock

14.2.11. Operation 13: LOCKT - Test For Lock

14.2.12. Operation 14: LOCKU - Unlock File

14.2.13. Operation 15: LOOKUP - Lookup Filename

14.2.14. Operation 16: LOOKUPP - Lookup Parent Directory

14.2.15. Operation 17: NVERIFY - Verify Difference in Attributes

14.2.16. Operation 18: OPEN - Open a Regular File

14.2.17. Operation 19: OPENATTR - Open Named Attribute Directory

14.2.18. Operation 20: OPEN_CONFIRM - Confirm Open

14.2.19. Operation 21: OPEN_DOWNGRADE - Reduce Open File Access

14.2.20. Operation 22: PUTFH - Set Current Filehandle

14.2.21. Operation 23: PUTPUBFH - Set Public Filehandle

14.2.22. Operation 24: PUTROOTFH - Set Root Filehandle

14.2.23. Operation 25: READ - Read from File

14.2.24. Operation 26: READDIR - Read Directory

14.2.25. Operation 27: READLINK - Read Symbolic Link

14.2.26. Operation 28: REMOVE - Remove Filesystem Object

14.2.27. Operation 29: RENAME - Rename Directory Entry

14.2.28. Operation 30: RENEW - Renew a Lease

14.2.29. Operation 31: RESTOREFH - Restore Saved Filehandle

14.2.30. Operation 32: SAVEFH - Save Current Filehandle

14.2.31. Operation 33: SECINFO - Obtain Available Security

14.2.32. Operation 34: SETATTR - Set Attributes

14.2.33. Operation 35: SETCLIENTID - Negotiate Clientid

14.2.34. Operation 36: SETCLIENTID_CONFIRM - Confirm Clientid

14.2.35. Operation 37: VERIFY - Verify Same Attributes

14.2.36. Operation 38: WRITE - Write to File

14.2.37. Operation 39: RELEASE_LOCKOWNER - Release Lockowner State

14.2.38. Operation 10044: ILLEGAL - Illegal operation

15. NFS version 4 Callback Procedures

15.1. Procedure 0: CB_NULL - No Operation

15.2. Procedure 1: CB_COMPOUND - Compound Operations

15.2.1. Operation 3: CB_GETATTR - Get Attributes

15.2.2. Operation 4: CB_RECALL - Recall an Open Delegation

15.2.3. Operation 10044: CB_ILLEGAL - Illegal Callback Operation

16. Security Considerations

17. IANA Considerations

17.1. Named Attribute Definition

17.2. ONC RPC Network Identifiers (netids)

18. RPC definition file

19. Acknowledgements

20.1. Normative References

20.2. Informative References

21. Authors' Information

21.1. Editor's Address

21.2. Authors' Addresses

22. Full Copyright Statement

23. Acknowledgement

Previous | Next

Frontpage | Contents | Keywords

RFC-Ref.org

Sister Sites

Chess-Ref.org
Law-Ref.org
InChI.info
Zvon.org