gvisorgvisor.dev/gvisor/runsc/hostsettings Index | Files

package hostsettings

import "gvisor.dev/gvisor/runsc/hostsettings"

Package hostsettings provides suggestions or adjustments for host kernel settings to improve runsc performance, stability, or security.

Index

Functions

func Handle

func Handle(conf *config.Config) error

Handle deals with host settings according to the given config.

Types

type Delta

type Delta struct {
	// Name of the setting being changed.
	Name string

	// FromValue is the value of the setting before applying the delta.
	FromValue string

	// ToValue is the value of the setting after applying the delta.
	ToValue string

	// Mandatory indicates whether the delta *must* be applied.
	// This should be set in cases where `runsc` will fail completely
	// if the delta is not applied.
	Mandatory bool

	// Purpose achieved by applying the delta.
	Purpose string

	// Apply applies the delta.
	Apply func() error
}

Delta is a change to make to a host setting.

type Setting

type Setting interface {
	// Name is the name of the setting. In most cases this should be the
	// full path of the setting, either under /sys or /proc/sys.
	// This can be a non-path for settings that are not controlled via files,
	// such as kernel command-line parameters or SELinux labels.
	Name() string

	// Delta checks whether the current value of the setting is optimal.
	// If already optimal, it returns a nil Delta.
	Delta() (*Delta, error)
}

Setting is a host setting to check or adjust.

Source Files

hostsettings.go

Version
v0.0.0-20250605235530-a6711d1e1dc6 (latest)
Published
Jun 5, 2025
Platform
linux/amd64
Imports
7 packages
Last checked
4 hours ago

Tools for package owners.