Help Center/ Scalable File Service/ FAQs/ Others/ How Do I Handle a Service Failure Reported During a Listing Operation in a General Purpose File System?
Updated on 2025-07-22 GMT+08:00

How Do I Handle a Service Failure Reported During a Listing Operation in a General Purpose File System?

Symptom

Both client A and client B mount the same directory of an NFS general purpose file system. When client A performs a listing operation for this directory, client B deletes some files or directories from the same directory at the same time, and then client A receives a service failure (Unknown error 523).

Possible Cause

NFS lists directory contents with chunks and uses a cookie to keep track of where the client is in a directory listing. During a listing, if the cookie required in the next chunk is deleted by a concurrent operation, the server side returns NFS3ERR_BAD_COOKIE, and the NFS client retries. If the preceding scenario occurs after several retries, a client side error is reported.

Solution

When listing a directory of an NFS general purpose file system, avoid creating or deleting filers or directories in that directory at the same time. For details, see NFS Version 3 Protocol Specification.