package local

import "github.com/docker/cli/components/engine/volume/local"

Package local provides the default implementation for volumes. It is used to mount data volume containers and directories local to the host server.

Index ¶

• Constants
• Variables
• type Root
• func New(scope string, rootIDs idtools.IDPair) (*Root, error)
• func (r *Root) Create(name string, opts map[string]string) (volume.Volume, error)
• func (r *Root) DataPath(volumeName string) string
• func (r *Root) Get(name string) (volume.Volume, error)
• func (r *Root) List() ([]volume.Volume, error)
• func (r *Root) Name() string
• func (r *Root) Remove(v volume.Volume) error
• func (r *Root) Scope() string

Constants ¶

const (
	VolumeDataPathName = "_data"
)

VolumeDataPathName is the name of the directory where the volume data is stored. It uses a very distinctive name to avoid collisions migrating data between Docker versions.

Variables ¶

var (
	// ErrNotFound is the typed error returned when the requested volume name can't be found
	ErrNotFound = fmt.Errorf("volume not found")
)

Types ¶

type Root ¶

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

Root implements the Driver interface for the volume package and manages the creation/removal of volumes. It uses only standard vfs commands to create/remove dirs within its provided scope.

func New ¶

func New(scope string, rootIDs idtools.IDPair) (*Root, error)

New instantiates a new Root instance with the provided scope. Scope is the base path that the Root instance uses to store its volumes. The base path is created here if it does not exist.

func (*Root) Create ¶

func (r *Root) Create(name string, opts map[string]string) (volume.Volume, error)

Create creates a new volume.Volume with the provided name, creating the underlying directory tree required for this volume in the process.

func (*Root) DataPath ¶

func (r *Root) DataPath(volumeName string) string

DataPath returns the constructed path of this volume.

func (*Root) Get ¶

func (r *Root) Get(name string) (volume.Volume, error)

Get looks up the volume for the given name and returns it if found

func (*Root) List ¶

func (r *Root) List() ([]volume.Volume, error)

List lists all the volumes

func (*Root) Name ¶

func (r *Root) Name() string

Name returns the name of Root, defined in the volume package in the DefaultDriverName constant.

func (*Root) Remove ¶

func (r *Root) Remove(v volume.Volume) error

Remove removes the specified volume and all underlying data. If the given volume does not belong to this driver and an error is returned. The volume is reference counted, if all references are not released then the volume is not removed.

func (*Root) Scope ¶

func (r *Root) Scope() string

Scope returns the local volume scope

Source Files ¶

local.go