linux

Documentation

Index

• func New(ic *plugin.InitContext) (interface{}, error)
• func ShimConnect() shimOpt
• func ShimLocal(exchange *events.Exchange) shimOpt
• func ShimRemote(shim, daemonAddress, cgroup string, nonewns, debug bool, exitHandler func()) shimOpt
• type Config
• type Process
  • func (p *Process) CloseIO(ctx context.Context) error
  • func (p *Process) ID() string
  • func (p *Process) Kill(ctx context.Context, signal uint32, _ bool) error
  • func (p *Process) ResizePty(ctx context.Context, size runtime.ConsoleSize) error
  • func (p *Process) Start(ctx context.Context) error
  • func (p *Process) State(ctx context.Context) (runtime.State, error)
  • func (p *Process) Wait(ctx context.Context) (*runtime.Exit, error)
• type Runtime
  • func (r *Runtime) Create(ctx context.Context, id string, opts runtime.CreateOpts) (_ runtime.Task, err error)
  • func (r *Runtime) Delete(ctx context.Context, c runtime.Task) (*runtime.Exit, error)
  • func (r *Runtime) Get(ctx context.Context, id string) (runtime.Task, error)
  • func (r *Runtime) ID() string
  • func (r *Runtime) Tasks(ctx context.Context) ([]runtime.Task, error)
• type Task
  • func (t *Task) Cgroup() (cgroups.Cgroup, error)
  • func (t *Task) Checkpoint(ctx context.Context, path string, options *types.Any) error
  • func (t *Task) CloseIO(ctx context.Context) error
  • func (t *Task) DeleteProcess(ctx context.Context, id string) (*runtime.Exit, error)
  • func (t *Task) Exec(ctx context.Context, id string, opts runtime.ExecOpts) (runtime.Process, error)
  • func (t *Task) ID() string
  • func (t *Task) Info() runtime.TaskInfo
  • func (t *Task) Kill(ctx context.Context, signal uint32, all bool) error
  • func (t *Task) Metrics(ctx context.Context) (interface{}, error)
  • func (t *Task) Pause(ctx context.Context) error
  • func (t *Task) Pids(ctx context.Context) ([]runtime.ProcessInfo, error)
  • func (t *Task) Process(ctx context.Context, id string) (runtime.Process, error)
  • func (t *Task) ResizePty(ctx context.Context, size runtime.ConsoleSize) error
  • func (t *Task) Resume(ctx context.Context) error
  • func (t *Task) Start(ctx context.Context) error
  • func (t *Task) State(ctx context.Context) (runtime.State, error)
  • func (t *Task) Update(ctx context.Context, resources *types.Any) error
  • func (t *Task) Wait(ctx context.Context) (*runtime.Exit, error)

Functions

func New

func New(ic *plugin.InitContext) (interface{}, error)

New returns a configured runtime

func ShimConnect

func ShimConnect() shimOpt

ShimConnect is a shimOpt for connecting to an existing remote shim

func ShimLocal

func ShimLocal(exchange *events.Exchange) shimOpt

ShimLocal is a shimOpt for using an in process shim implementation

func ShimRemote

func ShimRemote(shim, daemonAddress, cgroup string, nonewns, debug bool, exitHandler func()) shimOpt

ShimRemote is a shimOpt for connecting and starting a remote shim

Types

type Config

type Config struct {
	// Shim is a path or name of binary implementing the Shim GRPC API
	Shim string `toml:"shim"`
	// Runtime is a path or name of an OCI runtime used by the shim
	Runtime string `toml:"runtime"`
	// RuntimeRoot is the path that shall be used by the OCI runtime for its data
	RuntimeRoot string `toml:"runtime_root"`
	// NoShim calls runc directly from within the pkg
	NoShim bool `toml:"no_shim"`
	// Debug enable debug on the shim
	ShimDebug bool `toml:"shim_debug"`
	// ShimNoMountNS prevents the runtime from putting shims into their own mount namespace.
	//
	// Putting the shim in its own mount namespace ensure that any mounts made
	// by it in order to get the task rootfs ready will be undone regardless
	// on how the shim dies.
	//
	// NOTE: This should only be used in kernel older than 3.18 to avoid shims
	// from causing a DoS in their parent namespace due to having a copy of
	// mounts previously there which would prevent unlink, rename and remove
	// operations on those mountpoints.
	ShimNoMountNS bool `toml:"shim_no_newns"`
}

Config options for the runtime

type Process

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

Process implements a linux process

func (*Process) CloseIO

func (p *Process) CloseIO(ctx context.Context) error

CloseIO closes the provided IO pipe for the process

func (*Process) ID

func (p *Process) ID() string

ID of the process

func (*Process) Kill

func (p *Process) Kill(ctx context.Context, signal uint32, _ bool) error

Kill sends the provided signal to the underlying process

Unable to kill all processes in the task using this method on a process

func (*Process) ResizePty

func (p *Process) ResizePty(ctx context.Context, size runtime.ConsoleSize) error

ResizePty changes the side of the process's PTY to the provided width and height

func (*Process) Start

func (p *Process) Start(ctx context.Context) error

Start the process

func (*Process) State

func (p *Process) State(ctx context.Context) (runtime.State, error)

State of process

func (*Process) Wait

func (p *Process) Wait(ctx context.Context) (*runtime.Exit, error)

Wait on the process to exit and return the exit status and timestamp

type Runtime

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

Runtime for a linux based system

func (*Runtime) Create

func (r *Runtime) Create(ctx context.Context, id string, opts runtime.CreateOpts) (_ runtime.Task, err error)

Create a new task

func (*Runtime) Delete

func (r *Runtime) Delete(ctx context.Context, c runtime.Task) (*runtime.Exit, error)

Delete a task removing all on disk state

func (*Runtime) Get

func (r *Runtime) Get(ctx context.Context, id string) (runtime.Task, error)

Get a specific task by task id

func (*Runtime) ID

func (r *Runtime) ID() string

ID of the runtime

func (*Runtime) Tasks

func (r *Runtime) Tasks(ctx context.Context) ([]runtime.Task, error)

Tasks returns all tasks known to the runtime

type Task

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

Task on a linux based system

func (*Task) Cgroup

func (t *Task) Cgroup() (cgroups.Cgroup, error)

Cgroup returns the underlying cgroup for a linux task

func (*Task) Checkpoint

func (t *Task) Checkpoint(ctx context.Context, path string, options *types.Any) error

Checkpoint creates a system level dump of the task and process information that can be later restored

func (*Task) CloseIO

func (t *Task) CloseIO(ctx context.Context) error

CloseIO closes the provided IO on the task

func (*Task) DeleteProcess

func (t *Task) DeleteProcess(ctx context.Context, id string) (*runtime.Exit, error)

DeleteProcess removes the provided process from the task and deletes all on disk state

func (*Task) Exec

func (t *Task) Exec(ctx context.Context, id string, opts runtime.ExecOpts) (runtime.Process, error)

Exec creates a new process inside the task

func (*Task) ID

func (t *Task) ID() string

ID of the task

func (*Task) Info

func (t *Task) Info() runtime.TaskInfo

Info returns task information about the runtime and namespace

func (*Task) Kill

func (t *Task) Kill(ctx context.Context, signal uint32, all bool) error

Kill the task using the provided signal

Optionally send the signal to all processes that are a child of the task

func (*Task) Metrics

func (t *Task) Metrics(ctx context.Context) (interface{}, error)

Metrics returns runtime specific system level metric information for the task

func (*Task) Pause

func (t *Task) Pause(ctx context.Context) error

Pause the task and all processes

func (*Task) Pids

func (t *Task) Pids(ctx context.Context) ([]runtime.ProcessInfo, error)

Pids returns all system level process ids running inside the task

func (*Task) Process

func (t *Task) Process(ctx context.Context, id string) (runtime.Process, error)

Process returns a specific process inside the task by the process id

func (*Task) ResizePty

func (t *Task) ResizePty(ctx context.Context, size runtime.ConsoleSize) error

ResizePty changes the side of the task's PTY to the provided width and height

func (*Task) Resume

func (t *Task) Resume(ctx context.Context) error

Resume the task and all processes

func (*Task) Start

func (t *Task) Start(ctx context.Context) error

Start the task

func (*Task) State

func (t *Task) State(ctx context.Context) (runtime.State, error)

State returns runtime information for the task

func (*Task) Update

func (t *Task) Update(ctx context.Context, resources *types.Any) error

Update changes runtime information of a running task

func (*Task) Wait

func (t *Task) Wait(ctx context.Context) (*runtime.Exit, error)

Wait for the task to exit returning the status and timestamp