mount

Documentation

Index

• Variables
• type FilterFunc
  • func FstypeFilter(fstype ...string) FilterFunc
  • func ParentsFilter(path string) FilterFunc
  • func PrefixFilter(prefix string) FilterFunc
  • func SingleEntryFilter(mp string) FilterFunc
• type Info
  • func GetMounts(f FilterFunc) ([]*Info, error)
  • func GetMountsFromReader(reader io.Reader, f FilterFunc) ([]*Info, error)
  • func PidMountInfo(pid int) ([]*Info, error)
• type Mount
  • func ParseVolumn(s string) (*Mount, error)
  • func (m *Mount) Apply(rootfs string) error

Variables

var (
	ErrInvalidVolumn = errors.New("Invalid volumn format")
)

Types

type FilterFunc

type FilterFunc func(*Info) (skip, stop bool)

FilterFunc is a type defining a callback function for GetMount(), used to filter out mountinfo entries we're not interested in, and/or stop further processing if we found what we wanted.

It takes a pointer to the Info struct (not fully populated, currently only Mountpoint, Fstype, Source, and (on Linux) VfsOpts are filled in), and returns two booleans:

• skip: true if the entry should be skipped
• stop: true if parsing should be stopped after the entry

func FstypeFilter

func FstypeFilter(fstype ...string) FilterFunc

FstypeFilter returns all entries that match provided fstype(s).

func ParentsFilter

func ParentsFilter(path string) FilterFunc

ParentsFilter returns all entries whose mount points can be parents of a path specified, discarding others.

For example, given `/var/lib/docker/something`, entries like `/var/lib/docker`, `/var` and `/` are returned.

func PrefixFilter

func PrefixFilter(prefix string) FilterFunc

PrefixFilter discards all entries whose mount points do not start with a specific prefix

func SingleEntryFilter

func SingleEntryFilter(mp string) FilterFunc

SingleEntryFilter looks for a specific entry

type Info

type Info struct {
	// ID is a unique identifier of the mount (may be reused after umount).
	ID int

	// Parent indicates the ID of the mount parent (or of self for the top of the
	// mount tree).
	Parent int

	// Major indicates one half of the device ID which identifies the device class.
	Major int

	// Minor indicates one half of the device ID which identifies a specific
	// instance of device.
	Minor int

	// Root of the mount within the filesystem.
	Root string

	// Mountpoint indicates the mount point relative to the process's root.
	Mountpoint string

	// Opts represents mount-specific options.
	Opts string

	// Optional represents optional fields.
	Optional string

	// Fstype indicates the type of filesystem, such as EXT3.
	Fstype string

	// Source indicates filesystem specific information or "none".
	Source string

	// VfsOpts represents per super block options.
	VfsOpts string
}

Info reveals information about a particular mounted filesystem. This struct is populated from the content in the /proc/<pid>/mountinfo file.

func GetMounts

func GetMounts(f FilterFunc) ([]*Info, error)

GetMounts retrieves a list of mounts for the current running process, with an optional filter applied (use nil for no filter).

func GetMountsFromReader

func GetMountsFromReader(reader io.Reader, f FilterFunc) ([]*Info, error)

GetMountsFromReader retrieves a list of mounts from the reader provided, with an optional filter applied (use nil for no filter). This can be useful in tests or benchmarks that provide a fake mountinfo data.

func PidMountInfo

func PidMountInfo(pid int) ([]*Info, error)

PidMountInfo collects the mounts for a specific process ID. If the process ID is unknown, it is better to use `GetMounts` which will inspect "/proc/self/mountinfo" instead.

type Mount

type Mount struct {
	// Source path for the mount.
	Source string `json:"source"`

	// Destination path for the mount inside the container.
	Destination string `json:"destination"`

	// Device the mount is for.
	Device string `json:"device"`

	// Mount flags.
	Flags uintptr `json:"flags"`

	// Propagation Flags
	PropagationFlags []uintptr `json:"propagation_flags"`

	// Mount data applied to the mount.
	Data string `json:"data"`

	// Relabel source if set, "z" indicates shared, "Z" indicates unshared.
	Relabel string `json:"relabel"`
}

func ParseVolumn

func ParseVolumn(s string) (*Mount, error)

func (*Mount) Apply

func (m *Mount) Apply(rootfs string) error