vfs

type AbstractDir interface {
	// Stat returns the directory mode.
	Stat() (mode fs.FileMode)
	// ModTime returns the directory's modified time.
	ModTime() time.Time
	// ReadDir returns all entries in the directory.
	ReadDir() ([]AbstractDirEntry, error)
	// Lookup returns the entry for the given name, or nil if not found.
	Lookup(name string) (AbstractEntry, error)
}

type AbstractDirEntry struct {
	Name  string
	IsDir bool
	Mode  fs.FileMode
	Size  uint64
}

type AbstractEntry struct {
	File    AbstractFile
	Dir     AbstractDir
	Symlink AbstractSymlink
}

type AbstractFile interface {
	// Stat returns the file size and mode.
	Stat() (size uint64, mode fs.FileMode)
	// ModTime returns the file's modified time.
	ModTime() time.Time
	// ReadAt reads up to size bytes starting at offset off.
	ReadAt(off uint64, size uint32) ([]byte, error)
	// WriteAt writes data at offset off. Returns error if not writable.
	WriteAt(off uint64, data []byte) error
	// Truncate sets the file size. Returns error if not supported.
	Truncate(size uint64) error
}

type AbstractOwner interface {
	Owner() (uid, gid uint32)
}

type AbstractSymlink interface {
	// Stat returns the symlink's mode (permission bits are used; file type is ignored).
	Stat() fs.FileMode
	// ModTime returns the modified time for the symlink.
	ModTime() time.Time
	// Target returns the symlink target.
	Target() string
}

type BytesFile struct {
	// contains filtered or unexported fields
}

type ExportedNode struct {
	ID            uint64
	Name          string
	Parent        uint64
	Mode          fs.FileMode
	Size          uint64
	IsModified    bool
	HasBlocks     bool
	HasAbstract   bool
	SymlinkTarget string
}

type ModuleFile struct {
	Path string      // relative path within lib/modules/<version>/
	Data []byte      // file content
	Mode fs.FileMode // file mode
}

type OSDirBackend struct {
	// contains filtered or unexported fields
}

type SnapshotOptions struct {
	// Excludes contains path patterns to exclude from the snapshot.
	// Patterns use glob-style matching (*, ?, []).
	Excludes []string
}

type VirtioFsBackend interface {
	virtio.FsBackend
	AddAbstractFile(filePath string, file AbstractFile) error
	AddAbstractDir(dirPath string, dir AbstractDir) error
	SetAbstractRoot(dir AbstractDir) error
	// AddKernelModules adds kernel module files at /lib/modules/<version>/.
	AddKernelModules(version string, files []ModuleFile) error
	// CaptureLayer captures all filesystem modifications as a layer.
	CaptureLayer(opts *SnapshotOptions) (*fslayer.LayerData, error)
	// FreezeCurrentLayer marks the current state as a layer boundary.
	FreezeCurrentLayer() uint64
}