storage

type CRUDDriver interface {
	NamedDriver
	ValidatingDriver

	// Create a volume.
	Create(DriverOptions) error

	// Format a volume.
	Format(DriverOptions) error

	// Destroy a volume.
	Destroy(DriverOptions) error

	// List Volumes. May be scoped by storage parameters or other data.
	List(ListOptions) ([]Volume, error)

	// Exists returns true if a volume exists. Otherwise, it returns false.
	Exists(DriverOptions) (bool, error)
}

type DriverOptions struct {
	Source    string
	Volume    Volume
	FSOptions FSOptions
	Timeout   time.Duration
	Options   map[string]string
}

type FSOptions struct {
	Type          string
	CreateCommand string
}

type ListOptions struct {
	Params Params
}

type Mount struct {
	Device   string
	Path     string
	DevMajor uint
	DevMinor uint
	Volume   Volume
}

type MountDriver interface {
	NamedDriver
	ValidatingDriver

	// Mount a Volume
	Mount(DriverOptions) (*Mount, error)

	// Unmount a volume
	Unmount(DriverOptions) error

	// Mounted shows any volumes that belong to volplugin on the host, in
	// their native representation. They yield a *Mount.
	Mounted(time.Duration) ([]*Mount, error)

	// MountPath describes the path at which the volume should be mounted.
	MountPath(DriverOptions) (string, error)
}

type NamedDriver interface {
	// Name returns the string associated with the storage backed of the driver
	Name() string
}

type Params map[string]string

type SnapshotDriver interface {
	NamedDriver
	ValidatingDriver

	// CreateSnapshot creates a named snapshot for the volume. Any error will be returned.
	CreateSnapshot(string, DriverOptions) error

	// RemoveSnapshot removes a named snapshot for the volume. Any error will be returned.
	RemoveSnapshot(string, DriverOptions) error

	// ListSnapshots returns an array of snapshot names provided a maximum number
	// of snapshots to be returned. Any error will be returned.
	ListSnapshots(DriverOptions) ([]string, error)

	// CopySnapshot copies a snapshot into a new volume. Takes a DriverOptions,
	// snap and volume name (string). Returns error on failure.
	CopySnapshot(DriverOptions, string, string) error
}

type ValidatingDriver interface {
	Validate(*DriverOptions) error
}

type Volume struct {
	Name   string
	Size   uint64
	Params Params
}