func HasPriorDriver(rootstring)bool

func IsDriverNotSupported(errerror)bool

func IsRegistered(namestring)bool

func ParseStorageOptKeyValue(optstring) (keystring, valuestring, errerror)

func Register(namestring, initFuncInitFunc)error

type CreateOpts struct {MountLabelstringStorageOpt map[string]string}

type DiffDriver interface {// Diff produces an archive of the changes between the specified// layer and its parent layer which may be "".Diff(id, parentstring) (io.ReadCloser,error)// Changes produces a list of changes between the specified layer// and its parent layer. If parent is "", then all changes will be ADD changes.Changes(id, parentstring) ([]archive.Change,error)// ApplyDiff extracts the changeset from the given diff into the// layer with the specified id and parent, returning the size of the// new layer in bytes.// The archive.Reader must be an uncompressed stream.ApplyDiff(id, parentstring, diffio.Reader) (sizeint64, errerror)// DiffSize calculates the changes between the specified id// and its parent and returns the size in bytes of the changes// relative to its base filesystem directory.DiffSize(id, parentstring) (sizeint64, errerror)}

type DiffGetterDriver interface {Driver// DiffGetter returns an interface to efficiently retrieve the contents// of files in a layer.DiffGetter(idstring) (FileGetCloser,error)}

type Driver interface {ProtoDriverDiffDriver}

funcNew¶

func New(driverNamestring, configOptions) (Driver,error)

New creates the driver and initializes it at the specified root.

It is recommended to pass a name for the driver to use, but If no nameis provided, it attempts to detect the prior storage driver based onexisting state, or otherwise selects a storage driver based on a prioritylist and the underlying filesystem.

It returns an error if the requested storage driver is not supported,if scanning prior drivers is ambiguous (i.e., if state is found formultiple drivers), or if no compatible driver is available for theplatform and underlying filesystem.

funcNewNaiveDiffDriver¶

func NewNaiveDiffDriver(driverProtoDriver, idMapuser.IdentityMapping)Driver

NewNaiveDiffDriver returns a fully functional driver that wraps thegiven ProtoDriver and adds the capability of the following methods whichit may or may not support on its own:

Diff(id, parent string) (archive.Archive, error)Changes(id, parent string) ([]archive.Change, error)ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error)DiffSize(id, parent string) (size int64, err error)

type ErrUnSupported interface {NotSupported()}

type FileGetCloser interface {storage.FileGetter// Close cleans up any resources associated with the FileGetCloser.Close()error}

type InitFunc func(rootstring, options []string, idMapuser.IdentityMapping) (Driver,error)

type NaiveDiffDriver struct {ProtoDriverIDMapuser.IdentityMapping// If true, allow ApplyDiff to succeed in spite of failures to set// extended attributes on the unpacked files due to the destination// filesystem not supporting them or a lack of permissions. The// resulting unpacked layer may be subtly broken.BestEffortXattrsbool}

func (*NaiveDiffDriver)ApplyDiff¶

func (gdw *NaiveDiffDriver) ApplyDiff(id, parentstring, diffio.Reader) (sizeint64, _error)

ApplyDiff extracts the changeset from the given diff into thelayer with the specified id and parent, returning the size of thenew layer in bytes.

func (*NaiveDiffDriver)Changes¶

func (gdw *NaiveDiffDriver) Changes(id, parentstring) ([]archive.Change,error)

Changes produces a list of changes between the specified layerand its parent layer. If parent is "", then all changes will be ADD changes.

func (*NaiveDiffDriver)Diff¶

func (gdw *NaiveDiffDriver) Diff(id, parentstring) (archio.ReadCloser, retErrerror)

Diff produces an archive of the changes between the specifiedlayer and its parent layer which may be "".

func (*NaiveDiffDriver)DiffSize¶

func (gdw *NaiveDiffDriver) DiffSize(id, parentstring) (sizeint64, _error)

DiffSize calculates the changes between the specified layerand its parent and returns the size in bytes of the changesrelative to its base filesystem directory.

type NotSupportedErrorstring

func (NotSupportedError)Error¶

func (eNotSupportedError) Error()string

func (NotSupportedError)NotSupported¶

func (eNotSupportedError) NotSupported()

NotSupported signals that a graph-driver is not supported.

type Options struct {RootstringDriverOptions       []stringIDMapuser.IdentityMappingExperimentalEnabledbool}

type ProtoDriver interface {// String returns a string representation of this driver.String()string// CreateReadWrite creates a new, empty filesystem layer that is ready// to be used as the storage for a container. Additional options can// be passed in opts. parent may be "" and opts may be nil.CreateReadWrite(id, parentstring, opts *CreateOpts)error// Create creates a new, empty, filesystem layer with the// specified id and parent and options passed in opts. Parent// may be "" and opts may be nil.Create(id, parentstring, opts *CreateOpts)error// Remove attempts to remove the filesystem layer with this id.Remove(idstring)error// Get returns the mountpoint for the layered filesystem referred// to by this id. You can optionally specify a mountLabel or "".// Returns the absolute path to the mounted layered filesystem.Get(id, mountLabelstring) (fsstring, errerror)// Put releases the system resources for the specified id,// e.g, unmounting layered filesystem.Put(idstring)error// Exists returns whether a filesystem layer with the specified// ID exists on this driver.Exists(idstring)bool// Status returns a set of key-value pairs which give low// level diagnostic status about this driver.Status() [][2]string// GetMetadata returns a set of key-value pairs which give driver-specific// low-level information about the image/container that the driver is managing.GetMetadata(idstring) (map[string]string,error)// Cleanup performs necessary tasks to release resources// held by the driver, e.g., unmounting all layered filesystems// known to this driver.Cleanup()error}