util

Documentation

Index

• Variables
• func CheckRootlessUIDRange(uid int) error
• func DefaultContainerConfig() *config.Config
• func ExitCode(err error) int
• func FindDeviceNodes() (map[string]string, error)
• func GetContainerPidInformationDescriptors() ([]string, error)
• func GetKeepIDMapping() (*storage.IDMappingOptions, int, int, error)
• func GetRootlessConfigHomeDir() (string, error)
• func GetRootlessPauseProcessPidPath() (string, error)
• func GetRuntimeDir() (string, error)
• func HomeDir() (string, error)
• func OpenExclusiveFile(path string) (*os.File, error)
• func ParseIDMapping(mode namespaces.UsernsMode, uidMapSlice, gidMapSlice []string, ...) (*storage.IDMappingOptions, error)
• func ParseInputTime(inputTime string) (time.Time, error)
• func ParseRegistryCreds(creds string) (*types.DockerAuthConfig, error)
• func ParseSignal(rawSignal string) (syscall.Signal, error)
• func ProcessOptions(options []string, isTmpfs bool, sourcePath string) ([]string, error)
• func StringInSlice(s string, sl []string) bool
• func Tmpdir() string
• func ValidateSysctls(strSlice []string) (map[string]string, error)
• func WriteStorageConfigFile(storageOpts *storage.StoreOptions, storageConf string) error
• type ImageConfig
  • func GetImageConfig(changes []string) (ImageConfig, error)
• type PullType
  • func ValidatePullType(pullType string) (PullType, error)

Variables

var (
	// ErrBadMntOption indicates that an invalid mount option was passed.
	ErrBadMntOption = errors.Errorf("invalid mount option")
	// ErrDupeMntOption indicates that a duplicate mount option was passed.
	ErrDupeMntOption = errors.Errorf("duplicate mount option passed")
)

Functions

func CheckRootlessUIDRange

func CheckRootlessUIDRange(uid int) error

CheckRootlessUIDRange checks the uid within the rootless container is in the range from /etc/subuid

func DefaultContainerConfig

func DefaultContainerConfig() *config.Config

func ExitCode

func ExitCode(err error) int

ExitCode reads the error message when failing to executing container process and then returns 0 if no error, 126 if command does not exist, or 127 for all other errors

func FindDeviceNodes

func FindDeviceNodes() (map[string]string, error)

FindDeviceNodes parses /dev/ into a set of major:minor -> path, where [major:minor] is the device's major and minor numbers formatted as, for example, 2:0 and path is the path to the device node. Symlinks to nodes are ignored.

func GetContainerPidInformationDescriptors

func GetContainerPidInformationDescriptors() ([]string, error)

GetContainerPidInformationDescriptors returns a string slice of all supported format descriptors of GetContainerPidInformation.

func GetKeepIDMapping

func GetKeepIDMapping() (*storage.IDMappingOptions, int, int, error)

GetKeepIDMapping returns the mappings and the user to use when keep-id is used

func GetRootlessConfigHomeDir

func GetRootlessConfigHomeDir() (string, error)

GetRootlessConfigHomeDir returns the config home directory when running as non root

func GetRootlessPauseProcessPidPath

func GetRootlessPauseProcessPidPath() (string, error)

GetRootlessPauseProcessPidPath returns the path to the file that holds the pid for the pause process

func GetRuntimeDir

func GetRuntimeDir() (string, error)

GetRuntimeDir returns the runtime directory

func HomeDir

func HomeDir() (string, error)

HomeDir returns the home directory for the current user.

func OpenExclusiveFile

func OpenExclusiveFile(path string) (*os.File, error)

OpenExclusiveFile opens a file for writing and ensure it doesn't already exist

func ParseIDMapping

func ParseIDMapping(mode namespaces.UsernsMode, uidMapSlice, gidMapSlice []string, subUIDMap, subGIDMap string) (*storage.IDMappingOptions, error)

ParseIDMapping takes idmappings and subuid and subgid maps and returns a storage mapping

func ParseInputTime

func ParseInputTime(inputTime string) (time.Time, error)

ParseInputTime takes the users input and to determine if it is valid and returns a time format and error. The input is compared to known time formats or a duration which implies no-duration

func ParseRegistryCreds

func ParseRegistryCreds(creds string) (*types.DockerAuthConfig, error)

ParseRegistryCreds takes a credentials string in the form USERNAME:PASSWORD and returns a DockerAuthConfig

func ParseSignal

func ParseSignal(rawSignal string) (syscall.Signal, error)

ParseSignal parses and validates a signal name or number.

func ProcessOptions

func ProcessOptions(options []string, isTmpfs bool, sourcePath string) ([]string, error)

ProcessOptions parses the options for a bind or tmpfs mount and ensures that they are sensible and follow convention. The isTmpfs variable controls whether extra, tmpfs-specific options will be allowed. The sourcePath variable, if not empty, contains a bind mount source.

func StringInSlice

func StringInSlice(s string, sl []string) bool

StringInSlice determines if a string is in a string slice, returns bool

func Tmpdir

func Tmpdir() string

func ValidateSysctls

func ValidateSysctls(strSlice []string) (map[string]string, error)

ValidateSysctls validates a list of sysctl and returns it.

func WriteStorageConfigFile

func WriteStorageConfigFile(storageOpts *storage.StoreOptions, storageConf string) error

WriteStorageConfigFile writes the configuration to a file

Types

type ImageConfig

type ImageConfig struct {
	v1.ImageConfig
	OnBuild []string
}

ImageConfig is a wrapper around the OCIv1 Image Configuration struct exported by containers/image, but containing additional fields that are not supported by OCIv1 (but are by Docker v2) - notably OnBuild.

func GetImageConfig

func GetImageConfig(changes []string) (ImageConfig, error)

GetImageConfig produces a v1.ImageConfig from the --change flag that is accepted by several Podman commands. It accepts a (limited subset) of Dockerfile instructions.

type PullType

type PullType int

PullType whether to pull new image

const (
	// PullImageAlways always try to pull new image when create or run
	PullImageAlways PullType = iota
	// PullImageMissing pulls image if it is not locally
	PullImageMissing
	// PullImageNever will never pull new image
	PullImageNever
)

func ValidatePullType

func ValidatePullType(pullType string) (PullType, error)

ValidatePullType check if the pullType from CLI is valid and returns the valid enum type if the value from CLI is invalid returns the error