package graphdriver
import "github.com/docker/docker/daemon/graphdriver"
Index ¶
- Constants
- Variables
- func Register(name string, initFunc InitFunc) error
- type Checker
- type DiffGetterDriver
- type Driver
- func GetDriver(name, home string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error)
- func New(root string, name string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error)
- func NewNaiveDiffDriver(driver ProtoDriver, uidMaps, gidMaps []idtools.IDMap) Driver
- type FileGetCloser
- type FsMagic
- type InitFunc
- type NaiveDiffDriver
- func (gdw *NaiveDiffDriver) ApplyDiff(id, parent string, diff archive.Reader) (size int64, err error)
- func (gdw *NaiveDiffDriver) Changes(id, parent string) ([]archive.Change, error)
- func (gdw *NaiveDiffDriver) Diff(id, parent string) (arch archive.Archive, err error)
- func (gdw *NaiveDiffDriver) DiffSize(id, parent string) (size int64, err error)
- type ProtoDriver
- type RefCounter
Constants ¶
const ( // FsMagicUnsupported is a predefined constant value other than a valid filesystem id. FsMagicUnsupported = FsMagic(0x00000000) )
Variables ¶
var ( // ErrNotSupported returned when driver is not supported. ErrNotSupported = errors.New("driver not supported") // ErrPrerequisites retuned when driver does not meet prerequisites. ErrPrerequisites = errors.New("prerequisites for driver not satisfied (wrong filesystem?)") // ErrIncompatibleFS returned when file system is not supported. ErrIncompatibleFS = fmt.Errorf("backing file system is unsupported for this graph driver") )
var ( // ApplyUncompressedLayer defines the unpack method used by the graph // driver. ApplyUncompressedLayer = chrootarchive.ApplyUncompressedLayer )
Functions ¶
func Register ¶
Register registers an InitFunc for the driver.
Types ¶
type Checker ¶
type Checker interface { // IsMounted returns true if the provided path is mounted for the specific checker IsMounted(path string) bool }
Checker makes checks on specified filesystems.
type DiffGetterDriver ¶
type DiffGetterDriver interface { Driver // DiffGetter returns an interface to efficiently retrieve the contents // of files in a layer. DiffGetter(id string) (FileGetCloser, error) }
DiffGetterDriver is the interface for layered file system drivers that provide a specialized function for getting file contents for tar-split.
type Driver ¶
type Driver interface { ProtoDriver // Diff produces an archive of the changes between the specified // layer and its parent layer which may be "". Diff(id, parent string) (archive.Archive, 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, parent string) ([]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, parent string, diff archive.Reader) (size int64, err error) // 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, parent string) (size int64, err error) }
Driver is the interface for layered/snapshot file system drivers.
func GetDriver ¶
func GetDriver(name, home string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error)
GetDriver initializes and returns the registered driver
func New ¶
func New(root string, name string, options []string, uidMaps, gidMaps []idtools.IDMap) (Driver, error)
New creates the driver and initializes it at the specified root.
func NewNaiveDiffDriver ¶
func NewNaiveDiffDriver(driver ProtoDriver, uidMaps, gidMaps []idtools.IDMap) Driver
NewNaiveDiffDriver returns a fully functional driver that wraps the given ProtoDriver and adds the capability of the following methods which it 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 FileGetCloser ¶
type FileGetCloser interface { storage.FileGetter // Close cleans up any resources associated with the FileGetCloser. Close() error }
FileGetCloser extends the storage.FileGetter interface with a Close method for cleaning up.
type FsMagic ¶
type FsMagic uint32
FsMagic unsigned id of the filesystem in use.
func GetFSMagic ¶
GetFSMagic returns the filesystem id given the path.
type InitFunc ¶
InitFunc initializes the storage driver.
type NaiveDiffDriver ¶
type NaiveDiffDriver struct { ProtoDriver // contains filtered or unexported fields }
NaiveDiffDriver takes a ProtoDriver and adds the capability of the Diffing methods which it may or may not support on its own. See the comment on the exported NewNaiveDiffDriver function below. Notably, the AUFS driver doesn't need to be wrapped like this.
func (*NaiveDiffDriver) ApplyDiff ¶
func (gdw *NaiveDiffDriver) ApplyDiff(id, parent string, diff archive.Reader) (size int64, err 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.
func (*NaiveDiffDriver) Changes ¶
func (gdw *NaiveDiffDriver) Changes(id, parent string) ([]archive.Change, 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.
func (*NaiveDiffDriver) Diff ¶
func (gdw *NaiveDiffDriver) Diff(id, parent string) (arch archive.Archive, err error)
Diff produces an archive of the changes between the specified layer and its parent layer which may be "".
func (*NaiveDiffDriver) DiffSize ¶
func (gdw *NaiveDiffDriver) DiffSize(id, parent string) (size int64, err error)
DiffSize calculates the changes between the specified layer and its parent and returns the size in bytes of the changes relative to its base filesystem directory.
type ProtoDriver ¶
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. CreateReadWrite(id, parent, mountLabel string, storageOpt map[string]string) error // Create creates a new, empty, filesystem layer with the // specified id and parent and mountLabel. Parent and mountLabel may be "". Create(id, parent, mountLabel string, storageOpt map[string]string) error // Remove attempts to remove the filesystem layer with this id. Remove(id string) 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, mountLabel string) (dir string, err error) // Put releases the system resources for the specified id, // e.g, unmounting layered filesystem. Put(id string) error // Exists returns whether a filesystem layer with the specified // ID exists on this driver. Exists(id string) bool // Status returns a set of key-value pairs which give low // level diagnostic status about this driver. Status() [][2]string // Returns a set of key-value pairs which give low level information // about the image/container driver is managing. GetMetadata(id string) (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 }
ProtoDriver defines the basic capabilities of a driver. This interface exists solely to be a minimum set of methods for client code which choose not to implement the entire Driver interface and use the NaiveDiffDriver wrapper constructor.
Use of ProtoDriver directly by client code is not recommended.
type RefCounter ¶
type RefCounter struct {
// contains filtered or unexported fields
}
RefCounter is a generic counter for use by graphdriver Get/Put calls
func NewRefCounter ¶
func NewRefCounter(c Checker) *RefCounter
NewRefCounter returns a new RefCounter
func (*RefCounter) Decrement ¶
func (c *RefCounter) Decrement(path string) int
Decrement decreases the ref count for the given id and returns the current count
func (*RefCounter) Increment ¶
func (c *RefCounter) Increment(path string) int
Increment increaes the ref count for the given id and returns the current count
Source Files ¶
counter.go driver.go driver_unsupported.go fsdiff.go plugin_unsupported.go
Directories ¶
- Version
- v1.12.4
- Published
- Dec 12, 2016
- Platform
- js/wasm
- Imports
- 13 packages
- Last checked
- 3 minutes ago –
Tools for package owners.