mounts

Documentation

Index

• Variables
• type MountPoint
  • func (m *MountPoint) Cleanup(ctx context.Context) error
  • func (m *MountPoint) LiveRestore(ctx context.Context) error
  • func (m *MountPoint) Path() string
  • func (m *MountPoint) Setup(ctx context.Context, mountLabel string, rootIDs idtools.Identity, ...) (path string, cleanup func(context.Context) error, retErr error)
• type Parser
  • func NewLCOWParser() Parser
  • func NewLinuxParser() Parser
  • func NewParser() Parser
  • func NewWindowsParser() Parser

Variables

var ErrVolumeTargetIsRoot = errors.New("invalid specification: destination can't be '/'")

ErrVolumeTargetIsRoot is returned when the target destination is root. It's used by both LCOW and Linux parsers.

Types

type MountPoint

type MountPoint struct {
	// Source is the source path of the mount.
	// E.g. `mount --bind /foo /bar`, `/foo` is the `Source`.
	Source string
	// Destination is the path relative to the container root (`/`) to the mount point
	// It is where the `Source` is mounted to
	Destination string
	// RW is set to true when the mountpoint should be mounted as read-write
	RW bool
	// Name is the name reference to the underlying data defined by `Source`
	// e.g., the volume name
	Name string
	// Driver is the volume driver used to create the volume (if it is a volume)
	Driver string
	// Type of mount to use, see `Type<foo>` definitions in github.com/docker/docker/api/types/mount
	Type mounttypes.Type `json:",omitempty"`
	// Volume is the volume providing data to this mountpoint.
	// This is nil unless `Type` is set to `TypeVolume`
	Volume volume.Volume `json:"-"`

	// Mode is the comma separated list of options supplied by the user when creating
	// the bind/volume mount.
	// Note Mode is not used on Windows
	Mode string `json:"Relabel,omitempty"` // Originally field was `Relabel`"

	// Propagation describes how the mounts are propagated from the host into the
	// mount point, and vice-versa.
	// See https://www.kernel.org/doc/Documentation/filesystems/sharedsubtree.txt
	// Note Propagation is not used on Windows
	Propagation mounttypes.Propagation `json:",omitempty"` // Mount propagation string

	// Specifies if data should be copied from the container before the first mount
	// Use a pointer here so we can tell if the user set this value explicitly
	// This allows us to error out when the user explicitly enabled copy but we can't copy due to the volume being populated
	CopyData bool `json:"-"`
	// ID is the opaque ID used to pass to the volume driver.
	// This should be set by calls to `Mount` and unset by calls to `Unmount`
	ID string `json:",omitempty"`

	// Spec is a copy of the API request that created this mount.
	Spec mounttypes.Mount

	// Some bind mounts should not be automatically created.
	// (Some are auto-created for backwards-compatibility)
	// This is checked on the API but setting this here prevents race conditions.
	// where a bind dir existed during validation was removed before reaching the setup code.
	SkipMountpointCreation bool
	// contains filtered or unexported fields
}

MountPoint is the intersection point between a volume and a container. It specifies which volume is to be used and where inside a container it should be mounted.

Note that this type is embedded in `container.Container` object and persisted to disk. Changes to this struct need to by synced with on disk state.

func (*MountPoint) Cleanup

func (m *MountPoint) Cleanup(ctx context.Context) error

Cleanup frees resources used by the mountpoint and cleans up all the paths returned by Setup that hasn't been cleaned up by the caller.

func (*MountPoint) LiveRestore

func (m *MountPoint) LiveRestore(ctx context.Context) error

func (*MountPoint) Path

func (m *MountPoint) Path() string

Path returns the path of a volume in a mount point.

func (*MountPoint) Setup

func (m *MountPoint) Setup(ctx context.Context, mountLabel string, rootIDs idtools.Identity, checkFun func(m *MountPoint) error) (path string, cleanup func(context.Context) error, retErr error)

Setup sets up a mount point by either mounting the volume if it is configured, or creating the source directory if supplied. The, optional, checkFun parameter allows doing additional checking before creating the source directory on the host.

The returned path can be a temporary path, caller is responsible to call the returned cleanup function as soon as the path is not needed. Cleanup doesn't unmount the underlying volumes (if any), it only frees up the resources that were needed to guarantee that the path still points to the same target (to avoid TOCTOU attack).

Cleanup function doesn't need to be called when error is returned.

type Parser

type Parser interface {
	ParseMountRaw(raw, volumeDriver string) (*MountPoint, error)
	ParseMountSpec(cfg mount.Mount) (*MountPoint, error)
	ParseVolumesFrom(spec string) (string, string, error)
	DefaultPropagationMode() mount.Propagation
	ConvertTmpfsOptions(opt *mount.TmpfsOptions, readOnly bool) (string, error)
	DefaultCopyMode() bool
	ValidateVolumeName(name string) error
	ReadWrite(mode string) bool
	IsBackwardCompatible(m *MountPoint) bool
	HasResource(m *MountPoint, absPath string) bool
	ValidateTmpfsMountDestination(dest string) error
	ValidateMountConfig(mt *mount.Mount) error
}

Parser represents a platform specific parser for mount expressions

func NewLCOWParser

func NewLCOWParser() Parser

NewLCOWParser creates a parser with Linux Containers on Windows semantics.

func NewLinuxParser

func NewLinuxParser() Parser

NewLinuxParser creates a parser with Linux semantics.

func NewParser

func NewParser() Parser

NewParser creates a parser for the current host OS

func NewWindowsParser

func NewWindowsParser() Parser

NewWindowsParser creates a parser with Windows semantics.