vfs

Mar 11, 2026

Changes in this version

+ func Checksum(fs ReadFS, path string, algorithm crypto.Hash) ([]byte, error)

+ type ChecksumFS interface

+ Checksum func(path string, algorithm crypto.Hash) ([]byte, error)

type NotImplementedAdvancedFS

+ func (n NotImplementedAdvancedFS) Checksum(path string, algorithm crypto.Hash) ([]byte, error)

+ type ReadFS interface

+ FileRead func(path string) (ReaderAt, error)

Jan 22, 2026

Changes in this version

+ var DisablePersistentHandleDB = ContextKey("disable-persistent-handle-db")

+ type HandleFileInfo interface

+ Handle func() ([]byte, error)

Oct 1, 2025

Changes in this version

+ type OpenFS interface

+ Open func(path string) (File, error)

type WalkRemoveFS

+ Rmdir func(path string) error

Sep 29, 2025

Changes in this version

+ func Iterate(lister ListerAt, batchSize int) iter.Seq[FileInfo]

Sep 25, 2025

Changes in this version

+ var ErrInvalidHandle = fmt.Errorf("%w: invalid handle", syscall.EBADFD)

Sep 24, 2025

Changes in this version

+ const ListBufSize

+ const ReadDirBufSize

+ const Separator

+ var AllowServerChown = ContextKey("allow-chown")

+ var ErrNotImplemented = fmt.Errorf("%w: not implemented", syscall.EPERM)

+ var ErrNotSupported = syscall.EOPNOTSUPP

+ var ListWithXattrs = ContextKey("list-with-xattrs")

+ var Log = ContextKey("logger")

+ var PersistentStorage = ContextKey("persistent-storage")

+ var SkipAll = filepath.SkipAll

+ var SkipDir = filepath.SkipDir

+ var SkipSubDirs = api.SkipSubDirs

+ var UseServerInodes = ContextKey("use-serverino")

+ func Base(path string) string

+ func Bool(ctx context.Context, key ContextKey) bool

+ func Clean(path string) string

+ func Dir(path string) string

+ func Duration(ctx context.Context, key ContextKey) time.Duration

+ func FileExclusiveWriteCloser(fs FS, path string) (io.WriteCloser, error)

+ func FileReadSeekCloser(fs FS, path string) (io.ReadSeekCloser, error)

+ func FileWriteCloser(fs FS, path string, flags int) (io.WriteCloser, error)

+ func Int(ctx context.Context, key ContextKey) int

+ func IsAbs(path string) bool

+ func IsPathSeparator(c uint8) bool

+ func Join(paths ...string) string

+ func Logger(ctx context.Context) *logrus.Entry

+ func MkdirAll(fs MkdirFS, path string, perm os.FileMode) error

+ func ReadFile(fs FS, path string) ([]byte, error)

+ func RemoveAll(fs WalkRemoveFS, path string) error

+ func RunTestSuiteRO(t *testing.T, fs FS)

+ func RunTestSuiteRW(t *testing.T, fs FS)

+ func SetExtendedAttrs(fs SetExtendedAttrFS, path string, attrs Attributes) error

+ func Split(path string) (string, string)

+ func String(ctx context.Context, key ContextKey) string

+ func Walk(fs WalkableFS, root string, fn WalkFunc) error

+ func WalkRel(fs WalkableFS, root string, fn WalkRelFunc) error

+ func WriteFile(fs FS, path string, data []byte, flags int) error

+ type AdvancedFS interface

+ type AdvancedLinkFS interface

+ RealPath func(path string) (string, error)

+ type Attributes map[string][]byte

+ func (a Attributes) Delete(name string)

+ func (a Attributes) Get(name string) ([]byte, bool)

+ func (a Attributes) GetString(name string) (string, bool)

+ func (a Attributes) Set(name string, value []byte)

+ func (a Attributes) SetString(name, value string)

+ type ContextKey string

+ type FS interface

+ Chmod func(path string, mode os.FileMode) error

+ Chown func(path string, uid, gid int) error

+ Chtimes func(path string, atime, mtime time.Time) error

+ Close func() error

+ FileRead func(path string) (ReaderAt, error)

+ FileWrite func(path string, flags int) (WriterAt, error)

+ List func(path string) (ListerAt, error)

+ Mkdir func(path string, perm os.FileMode) error

+ Remove func(path string) error

+ Rename func(oldpath, newpath string) error

+ Rmdir func(path string) error

+ SetExtendedAttr func(path string, name string, value []byte) error

+ Stat func(path string) (FileInfo, error)

+ Truncate func(path string, size int64) error

+ UnsetExtendedAttr func(path string, name string) error

+ type File interface

+ Name func() string

+ Readdir func(count int) ([]FileInfo, error)

+ Stat func() (FileInfo, error)

+ Truncate func(size int64) error

+ func Open(fs OpenableFS, path string) (File, error)

+ type FileInfo interface

+ Extended func() (Attributes, error)

+ Gid func() uint32

+ NumLinks func() uint64

+ Permissions func() (*Permissions, error)

+ Uid func() uint32

+ func ListAll(lister ListerAt) ([]FileInfo, error)

+ func ReadDir(fs WalkableFS, dirname string) ([]FileInfo, error)

+ type FileInfoListerAt []FileInfo

+ func (f FileInfoListerAt) Close() error

+ func (f FileInfoListerAt) ListAt(ls []FileInfo, offset int64) (int, error)

+ type HandleFS interface

+ Handle func(path string) ([]byte, error)

+ type HandleResolveFS interface

+ Path func(handle []byte) (string, error)

+ type LinkFS interface

+ Link func(oldname, newname string) error

+ type ListerAt interface

+ Close func() error

+ ListAt func(buf []FileInfo, offset int64) (int, error)

+ type MkdirFS interface

+ Mkdir func(path string, perm os.FileMode) error

+ Stat func(path string) (FileInfo, error)

+ type NotImplementedAdvancedFS struct

+ func (n NotImplementedAdvancedFS) Handle(path string) ([]byte, error)

+ func (n NotImplementedAdvancedFS) Open(path string) (File, error)

+ func (n NotImplementedAdvancedFS) OpenFile(path string, mode int, perm os.FileMode) (File, error)

+ func (n NotImplementedAdvancedFS) Path(handle []byte) (string, error)

+ func (n NotImplementedAdvancedFS) Walk(path string, fn WalkFunc) error

+ type NotImplementedFS struct

+ func (n NotImplementedFS) Chmod(path string, mode os.FileMode) error

+ func (n NotImplementedFS) Chown(path string, uid, gid int) error

+ func (n NotImplementedFS) Chtimes(path string, atime, mtime time.Time) error

+ func (n NotImplementedFS) Close() error

+ func (n NotImplementedFS) FileRead(path string) (ReaderAt, error)

+ func (n NotImplementedFS) FileWrite(path string, flag int) (WriterAt, error)

+ func (n NotImplementedFS) List(path string) (ListerAt, error)

+ func (n NotImplementedFS) Mkdir(path string, perm os.FileMode) error

+ func (n NotImplementedFS) Remove(path string) error

+ func (n NotImplementedFS) Rename(oldpath, newpath string) error

+ func (n NotImplementedFS) Rmdir(path string) error

+ func (n NotImplementedFS) SetExtendedAttr(path, name string, value []byte) error

+ func (n NotImplementedFS) SetExtendedAttrs(path string, attrs Attributes) error

+ func (n NotImplementedFS) Stat(path string) (FileInfo, error)

+ func (n NotImplementedFS) Truncate(path string, size int64) error

+ func (n NotImplementedFS) UnsetExtendedAttr(path, name string) error

+ type NotImplementedRootFS struct

+ func (n NotImplementedRootFS) Link(path, target string) error

+ func (n NotImplementedRootFS) Lstat(path string) (FileInfo, error)

+ func (n NotImplementedRootFS) Mount(path string, fs FS, index byte) error

+ func (n NotImplementedRootFS) Readlink(path string) (string, error)

+ func (n NotImplementedRootFS) RealPath(path string) (string, error)

+ func (n NotImplementedRootFS) Symlink(path, target string) error

+ type OpenFileFS interface

+ OpenFile func(path string, flag int, perm os.FileMode) (File, error)

+ type OpenableFS interface

+ FileRead func(path string) (ReaderAt, error)

+ List func(path string) (ListerAt, error)

+ Stat func(path string) (FileInfo, error)

+ type Permissions struct

+ Delete bool

+ GetExtendedAttrs bool

+ Own bool

+ Read bool

+ SetExtendedAttrs bool

+ Write bool

+ type ReaderAt interface

+ type RootFS interface

+ Mount func(path string, fs FS, index byte) error

+ Open func(path string) (File, error)

+ type SetExtendedAttrFS interface

+ SetExtendedAttr func(path string, name string, value []byte) error

+ Stat func(path string) (FileInfo, error)

+ UnsetExtendedAttr func(path string, name string) error

+ type SetExtendedAttrsFS interface

+ SetExtendedAttrs func(path string, attrs Attributes) error

+ type SymlinkFS interface

+ Lstat func(path string) (FileInfo, error)

+ Readlink func(path string) (string, error)

+ Symlink func(target, link string) error

+ type WalkFS interface

+ Walk func(path string, walkFn WalkFunc) error

+ type WalkFunc func(path string, info FileInfo, err error) error

+ type WalkRelFunc func(path, rel string, info FileInfo, err error) error

+ type WalkRemoveFS interface

+ Remove func(path string) error

+ type WalkableFS interface

+ List func(path string) (ListerAt, error)

+ Stat func(path string) (FileInfo, error)

+ type WriterAt interface

+ type WriterAtReaderAt interface

+ func NopReaderAt(w WriterAt) WriterAtReaderAt

+ func NopWriterAt(r ReaderAt) WriterAtReaderAt