btrfs

README

go-btrfs

Native Go bindings for btrfs.

Status

These are in the early stages. We will try to maintain stability, but please vendor if you are relying on these directly.

Contribute

This package may not cover all the use cases for btrfs. If something you need is missing, please don't hesitate to submit a PR.

Note that due to struct alignment issues, this isn't yet fully native. Preferrably, this could be resolved, so contributions in this direction are greatly appreciated.

Documentation

Index

• func IsSubvolume(path string) error
• func SubvolCreate(path string) error
• func SubvolDelete(path string) error
• func SubvolSnapshot(dst, src string, readonly bool) error
• type Info
  • func SubvolInfo(path string) (info Info, err error)
  • func SubvolList(path string) ([]Info, error)

Functions

func IsSubvolume

func IsSubvolume(path string) error

IsSubvolume returns nil if the path is a valid subvolume. An error is returned if the path does not exist or the path is not a valid subvolume.

func SubvolCreate

func SubvolCreate(path string) error

SubvolCreate creates a subvolume at the provided path.

func SubvolDelete

func SubvolDelete(path string) error

SubvolDelete deletes the subvolumes under the given path.

func SubvolSnapshot

func SubvolSnapshot(dst, src string, readonly bool) error

SubvolSnapshot creates a snapshot in dst from src. If readonly is true, the snapshot will be readonly.

Types

type Info

type Info struct {
	ID         uint64 // subvolume id
	ParentID   uint64 // aka ref_tree
	TopLevelID uint64 // not actually clear what this is, not set for now.
	Offset     uint64 // key offset for root
	DirID      uint64

	Generation         uint64
	OriginalGeneration uint64

	UUID         string
	ParentUUID   string
	ReceivedUUID string

	Name string
	Path string // absolute path of subvolume
	Root string // path of root mount point

	Readonly bool // true if the snaps hot is readonly, extracted from flags
}

Info describes metadata about a btrfs subvolume.

func SubvolInfo

func SubvolInfo(path string) (info Info, err error)

SubvolInfo returns information about the subvolume at the provided path.

func SubvolList

func SubvolList(path string) ([]Info, error)

SubvolList will return the information for all subvolumes corresponding to the provided path.