intf

Documentation

Index

• type RootfsCloner
• type ShiftfsMgr
• type SubidAlloc
• type VolMgr

Types

type RootfsCloner

type RootfsCloner interface {

	// Creates a clone of the container's rootfs; returns the path to the cloned rootfs.
	CreateClone(id, origRootfs string) (string, error)

	// Removes a rootfs clone for the given container
	RemoveClone(id string) error

	// Chowns (recursively) the clone rootfs by the given user and group ID offset
	ChownClone(id string, uidOffset, gidOffset int32) error

	// Undoes the actions of ChownClone()
	RevertChown(id string) error

	// Notifies rootfsCloner that container has been stopped (but not removed)
	ContainerStopped(id string) error

	// Performs cleanup (e.g., removes all clones, unmounts all mounts created by the cloner)
	RemoveAll()
}

The RootfsCloner interface defines the interface exposed by the sysbox-mgr rootfs cloner

type ShiftfsMgr

type ShiftfsMgr interface {

	// Set shiftfs marks on the given paths; if createMarkpoint is true, create
	// new moutpoint directories for each of the given paths. Returns a list of
	// the paths where the shiftfs marks are set.
	Mark(id string, mounts []shiftfs.MountPoint, createMarkpoint bool) ([]shiftfs.MountPoint, error)

	// Remove shiftfs marks associated with the given container
	Unmark(id string, mount []shiftfs.MountPoint) error

	// Remove shiftfs marks associated with all containers (best effort, ignore errors)
	UnmarkAll()
}

The ShiftfsMgr interface defines the interface exposed by the sysbox-mgr shiftfs manager

type SubidAlloc

type SubidAlloc interface {

	// Allocates an unused range of 'size' uids and gids for the container with the given 'id'.
	// Max supported 'size' is 2^32.
	// Possible errors are nil, "exhausted", or "invalid-size".
	Alloc(id string, size uint64) (uint32, uint32, error)

	// Free releases a previously allocated uid and gid range for the container with the
	// given 'id'. Possible errors are nil and "not-found" (if the container with the
	// given 'id' has no allocations).
	Free(id string) error
}

The SubidAlloc interface defines the interface exposed by the entity that performs or subuid and subgid allocations

type VolMgr

type VolMgr interface {

	// Creates a volume for the sys container with the given 'id'. This function
	// returns an OCI mount spec (which is passed back to sysbox-runc to setup the actual mount).
	// 'rootfs' is the absolute path the container's rootfs.
	// 'mountpoint' is the volume's mountpoint (relative to the container's rootfs)
	// 'uid' and 'gid' are the uid(gid) of the container root process in the host's namespace.
	// 'chownOnSync' indicates if the volMgr should chown when copying to/from the container's rootfs
	// 'perm' indicates the permissions for the created volume.
	CreateVol(id, rootfs, mountpoint string, uid, gid uint32, chownOnSync bool, perm os.FileMode) ([]specs.Mount, error)

	// Destroys a volume for the container with the given 'id'.
	DestroyVol(id string) error

	// Sync the contents of the volume back to container's rootfs
	SyncOut(id string) error

	// Sync and destroys all volumes (best effort, ignore errors)
	SyncOutAndDestroyAll()
}

The VolMgr interface defines the interface exposed by the sysbox-mgr entities that manage the creation of volumes on the host that are bind-mounted into the sys container.