2.5.5.7 Perform File Operation Using NFS

  • Article

This use case supports the Two Applications Communicate via a Shared File use case (2.5.3). The application accesses an NFS file using the NFS version 2 protocol [RFC1094] or the NFS version 3 [RFC1813] protocol.

Context of Use: To read or write a file in an NFS share directory.

Goal: To perform a file operation (such as Read or Write) on a file in an NFS network share directory.

Actors

  • Application

  • File Client

  • NFS File Service

  • Authentication Service

Stakeholders

  • User

Preconditions

  • The client and server computers are configured in a domain.

  • A file share has been created on the file server.

  • The User has successfully opened a file on the file share and obtained a file handle.

Main Success Scenario

Trigger: The Application receives a request from the User to perform a file operation on a file for which the Application has a file handle.

  1. The Application directs the file client to send a request to the NFS File Service, in order to use the file handle to perform the requested operation (as described in [RFC1094] section 2.2 or [RFC1813] section 3.3).

  2. The NFS file service returns the result to the Application as described in [RFC1094] section 2.2 or [RFC1813] section 3.3.

Post Condition

None.

Extensions:

  1. If an RPC time-out occurs, the Application displays an error message, and the use case ends in failure.

  2. If an RPC authentication fails, the Application displays an error message, and the use case ends in failure.

  3. If a protocol error code is returned from the NFS File Service, the Application displays an error message corresponding to the RPC error code returned, and the use case aborts.