Skip to content

SeaweedFS is a distributed storage system for object storage (S3), file systems, Iceberg table buckets, and Lance vector buckets, designed to handle billions of files with O(1) disk access and effortless horizontal scaling.

3.0 KB
Raw Blame
package mount

import (
	"errors"
	"strings"
	"syscall"

	"github.com/seaweedfs/go-fuse/v2/fuse"
	"google.golang.org/grpc/codes"
	"google.golang.org/grpc/status"

	"github.com/seaweedfs/seaweedfs/weed/pb/filer_pb"
)

func grpcErrorToFuseStatus(err error) fuse.Status {
	if err == nil {
		return fuse.OK
	}

	// Unpack error for inspection
	if s, ok := status.FromError(err); ok {
		switch s.Code() {
		case codes.OK:
			return fuse.OK
		case codes.Canceled, codes.DeadlineExceeded:
			return fuse.Status(syscall.ETIMEDOUT)
		case codes.Unavailable:
			return fuse.Status(syscall.EAGAIN)
		case codes.ResourceExhausted:
			return fuse.Status(syscall.EAGAIN) // Or syscall.ENOSPC
		case codes.PermissionDenied:
			return fuse.Status(syscall.EACCES)
		case codes.Unauthenticated:
			return fuse.Status(syscall.EPERM)
		case codes.NotFound:
			return fuse.ENOENT
		case codes.AlreadyExists:
			return fuse.Status(syscall.EEXIST)
		case codes.InvalidArgument:
			return fuse.EINVAL
		}
	}

	// String matching for errors that don't have proper gRPC codes but are known
	errStr := err.Error()
	if strings.Contains(errStr, "transport") {
		return fuse.Status(syscall.EAGAIN)
	}
	// Add other string matches if necessary

	return fuse.EIO
}

// isStorageFullError reports whether a chunk upload failed because the cluster
// has no writable volume left (disks full and volume growth failed). The
// master's message reaches the mount as plain text inside
// AssignVolumeResponse.Error, so match on text rather than a status code.
func isStorageFullError(err error) bool {
	if err == nil {
		return false
	}
	errStr := strings.ToLower(err.Error())
	return strings.Contains(errStr, "no writable volumes") ||
		strings.Contains(errStr, "no free volumes")
}

// writeErrorToFuseStatus maps a dirty-page write/flush failure to the status
// returned to the kernel: ENOSPC when the cluster is out of space, EIO otherwise.
func writeErrorToFuseStatus(err error) fuse.Status {
	if isStorageFullError(err) {
		return fuse.Status(syscall.ENOSPC)
	}
	return fuse.EIO
}

// isRetryableFilerError reports whether a filer RPC error looks transient
// enough to retry. It takes a conservative whitelist approach: only errors
// that clearly describe a permanent application-level failure
// (NotFound/AlreadyExists/InvalidArgument/PermissionDenied/Unauthenticated/
// FailedPrecondition) short-circuit the retry loop. Everything else —
// transport errors, Canceled/Unavailable/ResourceExhausted, or errors with no
// gRPC status — is treated as potentially transient and retried.
func isRetryableFilerError(err error) bool {
	if err == nil {
		return false
	}
	// CreateEntry reports a failed write condition in its response, not as a status.
	if errors.Is(err, filer_pb.ErrPreconditionFailed) {
		return false
	}
	if s, ok := status.FromError(err); ok {
		switch s.Code() {
		case codes.NotFound,
			codes.AlreadyExists,
			codes.InvalidArgument,
			codes.PermissionDenied,
			codes.Unauthenticated,
			codes.FailedPrecondition:
			return false
		}
	}
	return true
}