Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

osfs

package module

Go to main page

Versions in this module

v0

v0.3.0

Oct 8, 2026

v0.2.0

Sep 30, 2026

Changes in this version

+ const DefaultMaxReadFile

+ var ErrTooLarge = errors.New("osfs: file too large to read whole")

type FS

+ func OpenRoot(r *os.Root, opts ...Option) (*FS, error)

type Option

+ func MaxReadFile(n int64) Option

v0.1.0

Sep 29, 2026

Changes in this version

+ var ErrReadOnly = errors.New("osfs: read-only filesystem")

+ type FS struct

+ func Open(dir string, opts ...Option) (*FS, error)

+ func (fsys *FS) Chmod(p string, perm os.FileMode) error

+ func (fsys *FS) Chown(p string, uid, gid uint32) error

+ func (fsys *FS) Chtimes(p string, atime, mtime time.Time) error

+ func (fsys *FS) Close() error

+ func (fsys *FS) DeleteDir(p string) error

+ func (fsys *FS) DeleteFile(p string) error

+ func (fsys *FS) Link(oldPath, newPath string) error

+ func (fsys *FS) ListDir(p string) ([]filesystem.DirEntry, error)

+ func (fsys *FS) MkDir(p string, perm os.FileMode) error

+ func (fsys *FS) OpenFile(p string) (filesystem.File, error)

+ func (fsys *FS) ReadFile(p string) ([]byte, error)

+ func (fsys *FS) ReadLink(p string) (string, error)

+ func (fsys *FS) Rename(oldPath, newPath string) error

+ func (fsys *FS) Stat(p string) (filesystem.Stat, error)

+ func (fsys *FS) Symlink(target, linkPath string) error

+ func (fsys *FS) Truncate(p string, size int64) error

+ func (fsys *FS) Usage() (total, free uint64, err error)

+ func (fsys *FS) WriteFile(p string, data []byte, perm os.FileMode) error

+ type Option func(*options)

+ func ReadOnly() Option