Function IsPermission

oserror/oserror.go:42–58

IsPermission returns a boolean indicating whether the error is known to report that permission is denied. It is satisfied by ErrPermission as well as some syscall errors. This function differs from os.IsPermission() in that it can identify an error through wrapping layers.

(err error)

// This function differs from os.IsPermission() in that it
// can identify an error through wrapping layers.
func IsPermission(err error) bool {
	// errors.Is() is not able to peek through os.SyscallError,
	// whereas os.IsPermission() can. Conversely, os.IsPermission()
	// cannot peek through Unwrap, whereas errors.Is() can. So we
	// need to try both.
	if errors.Is(err, ErrPermission) || os.IsPermission(errors.UnwrapAll(err)) {
		return true
	}
	// If a syscall errno representing ErrPermission was encoded on a
	// different platform, and decoded here, then it will show up as
	// neither a syscall errno here nor an ErrPermission; instead it
	// shows up as an OpaqueErrno. We test this here.
	if o := (*errbase.OpaqueErrno)(nil); errors.As(err, &o) {
		return o.Is(ErrPermission)
	}
	return false
}

// IsExist returns a boolean indicating whether the error is known to report
// that a file or directory already exists. It is satisfied by ErrExist as