vfs

package
v0.1.8 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 9, 2026 License: MIT Imports: 14 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type DirEntry 

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

func NewDirEntry 

func NewDirEntry(name string, isDir bool, mode os.FileMode, info FileInfo) DirEntry

func (DirEntry) Info 

func (de DirEntry) Info() (fs.FileInfo, error)

func (DirEntry) IsDir 

func (de DirEntry) IsDir() bool

func (DirEntry) Name 

func (de DirEntry) Name() string

func (DirEntry) Type 

func (de DirEntry) Type() fs.FileMode

type FileInfo 

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

func NewFileInfo 

func NewFileInfo(name string, size int64, mode os.FileMode, modTime time.Time, isDir bool) FileInfo

func (FileInfo) IsDir 

func (fi FileInfo) IsDir() bool

func (FileInfo) ModTime 

func (fi FileInfo) ModTime() time.Time

func (FileInfo) Mode 

func (fi FileInfo) Mode() os.FileMode

func (FileInfo) Name 

func (fi FileInfo) Name() string

func (FileInfo) Size 

func (fi FileInfo) Size() int64

func (FileInfo) Sys 

func (fi FileInfo) Sys() any

type Handle 

type Handle interface {
	io.Reader
	io.Writer
	io.Seeker
	io.Closer
	ReadAt(p []byte, off int64) (int, error)
	WriteAt(p []byte, off int64) (int, error)
	Stat() (FileInfo, error)
	Sync() error
	Truncate(size int64) error
}

type MemoryProvider 

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

func NewMemoryProvider 

func NewMemoryProvider() *MemoryProvider

func (*MemoryProvider) Create 

func (p *MemoryProvider) Create(path string, mode os.FileMode) (Handle, error)

func (*MemoryProvider) Mkdir 

func (p *MemoryProvider) Mkdir(path string, mode os.FileMode) error

func (*MemoryProvider) MkdirAll 

func (p *MemoryProvider) MkdirAll(path string, mode os.FileMode) error

func (*MemoryProvider) Open 

func (p *MemoryProvider) Open(path string, flags int, mode os.FileMode) (Handle, error)

func (*MemoryProvider) ReadDir 

func (p *MemoryProvider) ReadDir(path string) ([]DirEntry, error)

func (*MemoryProvider) ReadFile 

func (p *MemoryProvider) ReadFile(path string) ([]byte, error)
func (p *MemoryProvider) Readlink(path string) (string, error)

func (*MemoryProvider) Readonly 

func (p *MemoryProvider) Readonly() bool

func (*MemoryProvider) Remove 

func (p *MemoryProvider) Remove(path string) error

func (*MemoryProvider) RemoveAll 

func (p *MemoryProvider) RemoveAll(path string) error

func (*MemoryProvider) Rename 

func (p *MemoryProvider) Rename(oldPath, newPath string) error

func (*MemoryProvider) Stat 

func (p *MemoryProvider) Stat(path string) (FileInfo, error)
func (p *MemoryProvider) Symlink(target, link string) error

func (*MemoryProvider) WriteFile 

func (p *MemoryProvider) WriteFile(path string, data []byte, mode os.FileMode) error

type MountRouter 

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

func NewMountRouter 

func NewMountRouter(mounts map[string]Provider) *MountRouter

func (*MountRouter) AddMount 

func (r *MountRouter) AddMount(path string, provider Provider)

func (*MountRouter) Create 

func (r *MountRouter) Create(path string, mode os.FileMode) (Handle, error)

func (*MountRouter) Mkdir 

func (r *MountRouter) Mkdir(path string, mode os.FileMode) error

func (*MountRouter) Open 

func (r *MountRouter) Open(path string, flags int, mode os.FileMode) (Handle, error)

func (*MountRouter) ReadDir 

func (r *MountRouter) ReadDir(path string) ([]DirEntry, error)
func (r *MountRouter) Readlink(path string) (string, error)

func (*MountRouter) Readonly 

func (r *MountRouter) Readonly() bool

func (*MountRouter) Remove 

func (r *MountRouter) Remove(path string) error

func (*MountRouter) RemoveAll 

func (r *MountRouter) RemoveAll(path string) error

func (*MountRouter) RemoveMount 

func (r *MountRouter) RemoveMount(path string)

func (*MountRouter) Rename 

func (r *MountRouter) Rename(oldPath, newPath string) error

func (*MountRouter) Stat 

func (r *MountRouter) Stat(path string) (FileInfo, error)
func (r *MountRouter) Symlink(target, link string) error

type OpCode 

type OpCode uint8
const (
	OpLookup OpCode = iota
	OpGetattr
	OpSetattr
	OpRead
	OpWrite
	OpCreate
	OpMkdir
	OpUnlink
	OpRmdir
	OpRename
	OpOpen
	OpRelease
	OpReaddir
	OpFsync
	OpMkdirAll
)

type OverlayProvider 

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

func NewOverlayProvider 

func NewOverlayProvider(upper, lower Provider) *OverlayProvider

func (*OverlayProvider) Create 

func (p *OverlayProvider) Create(path string, mode os.FileMode) (Handle, error)

func (*OverlayProvider) Mkdir 

func (p *OverlayProvider) Mkdir(path string, mode os.FileMode) error

func (*OverlayProvider) Open 

func (p *OverlayProvider) Open(path string, flags int, mode os.FileMode) (Handle, error)

func (*OverlayProvider) ReadDir 

func (p *OverlayProvider) ReadDir(path string) ([]DirEntry, error)
func (p *OverlayProvider) Readlink(path string) (string, error)

func (*OverlayProvider) Readonly 

func (p *OverlayProvider) Readonly() bool

func (*OverlayProvider) Remove 

func (p *OverlayProvider) Remove(path string) error

func (*OverlayProvider) RemoveAll 

func (p *OverlayProvider) RemoveAll(path string) error

func (*OverlayProvider) Rename 

func (p *OverlayProvider) Rename(oldPath, newPath string) error

func (*OverlayProvider) Stat 

func (p *OverlayProvider) Stat(path string) (FileInfo, error)
func (p *OverlayProvider) Symlink(target, link string) error

func (*OverlayProvider) WhiteoutPath 

func (p *OverlayProvider) WhiteoutPath(path string) error

type Provider 

type Provider interface {
	Readonly() bool
	Stat(path string) (FileInfo, error)
	ReadDir(path string) ([]DirEntry, error)
	Open(path string, flags int, mode os.FileMode) (Handle, error)
	Create(path string, mode os.FileMode) (Handle, error)
	Mkdir(path string, mode os.FileMode) error
	Remove(path string) error
	RemoveAll(path string) error
	Rename(oldPath, newPath string) error
	Symlink(target, link string) error
	Readlink(path string) (string, error)
}

type ReadonlyProvider 

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

func NewReadonlyProvider 

func NewReadonlyProvider(inner Provider) *ReadonlyProvider

func (*ReadonlyProvider) Create 

func (p *ReadonlyProvider) Create(path string, mode os.FileMode) (Handle, error)

func (*ReadonlyProvider) Mkdir 

func (p *ReadonlyProvider) Mkdir(path string, mode os.FileMode) error

func (*ReadonlyProvider) Open 

func (p *ReadonlyProvider) Open(path string, flags int, mode os.FileMode) (Handle, error)

func (*ReadonlyProvider) ReadDir 

func (p *ReadonlyProvider) ReadDir(path string) ([]DirEntry, error)
func (p *ReadonlyProvider) Readlink(path string) (string, error)

func (*ReadonlyProvider) Readonly 

func (p *ReadonlyProvider) Readonly() bool

func (*ReadonlyProvider) Remove 

func (p *ReadonlyProvider) Remove(path string) error

func (*ReadonlyProvider) RemoveAll 

func (p *ReadonlyProvider) RemoveAll(path string) error

func (*ReadonlyProvider) Rename 

func (p *ReadonlyProvider) Rename(oldPath, newPath string) error

func (*ReadonlyProvider) Stat 

func (p *ReadonlyProvider) Stat(path string) (FileInfo, error)
func (p *ReadonlyProvider) Symlink(target, link string) error

type RealFSProvider 

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

func NewRealFSProvider 

func NewRealFSProvider(root string) *RealFSProvider

func (*RealFSProvider) Create 

func (p *RealFSProvider) Create(path string, mode os.FileMode) (Handle, error)

func (*RealFSProvider) Mkdir 

func (p *RealFSProvider) Mkdir(path string, mode os.FileMode) error

func (*RealFSProvider) Open 

func (p *RealFSProvider) Open(path string, flags int, mode os.FileMode) (Handle, error)

func (*RealFSProvider) ReadDir 

func (p *RealFSProvider) ReadDir(path string) ([]DirEntry, error)
func (p *RealFSProvider) Readlink(path string) (string, error)

func (*RealFSProvider) Readonly 

func (p *RealFSProvider) Readonly() bool

func (*RealFSProvider) Remove 

func (p *RealFSProvider) Remove(path string) error

func (*RealFSProvider) RemoveAll 

func (p *RealFSProvider) RemoveAll(path string) error

func (*RealFSProvider) Rename 

func (p *RealFSProvider) Rename(oldPath, newPath string) error

func (*RealFSProvider) Stat 

func (p *RealFSProvider) Stat(path string) (FileInfo, error)
func (p *RealFSProvider) Symlink(target, link string) error

type VFSDirEntry 

type VFSDirEntry struct {
	Name  string `cbor:"name"`
	IsDir bool   `cbor:"is_dir"`
	Mode  uint32 `cbor:"mode"`
	Size  int64  `cbor:"size"`
}

type VFSRequest 

type VFSRequest struct {
	Op      OpCode `cbor:"op"`
	Path    string `cbor:"path,omitempty"`
	NewPath string `cbor:"new_path,omitempty"`
	Handle  uint64 `cbor:"fh,omitempty"`
	Offset  int64  `cbor:"off,omitempty"`
	Size    uint32 `cbor:"sz,omitempty"`
	Data    []byte `cbor:"data,omitempty"`
	Flags   uint32 `cbor:"flags,omitempty"`
	Mode    uint32 `cbor:"mode,omitempty"`
}

type VFSResponse 

type VFSResponse struct {
	Err     int32         `cbor:"err"`
	Stat    *VFSStat      `cbor:"stat,omitempty"`
	Data    []byte        `cbor:"data,omitempty"`
	Written uint32        `cbor:"written,omitempty"`
	Handle  uint64        `cbor:"fh,omitempty"`
	Entries []VFSDirEntry `cbor:"entries,omitempty"`
}

type VFSServer 

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

func NewVFSServer 

func NewVFSServer(provider Provider) *VFSServer

func (*VFSServer) HandleConnection 

func (s *VFSServer) HandleConnection(conn net.Conn)

HandleConnection handles a single VFS connection. Exported for use by platform-specific backends.

func (*VFSServer) Serve 

func (s *VFSServer) Serve(listener net.Listener) error

func (*VFSServer) ServeUDS 

func (s *VFSServer) ServeUDS(socketPath string) error

ServeUDS starts the VFS server on a Unix domain socket This is used by Firecracker vsock which exposes guest vsock ports as UDS

func (*VFSServer) ServeUDSBackground 

func (s *VFSServer) ServeUDSBackground(socketPath string) (stop func(), err error)

ServeUDSBackground starts the VFS server on a Unix domain socket in a goroutine Returns a function to stop the server

type VFSStat 

type VFSStat struct {
	Size    int64  `cbor:"size"`
	Mode    uint32 `cbor:"mode"`
	ModTime int64  `cbor:"mtime"`
	IsDir   bool   `cbor:"is_dir"`
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.