utils

Documentation

Index

• Variables
• func BadRequest(w http.ResponseWriter, key string, value string, err error)
• func ContainerNotFound(w http.ResponseWriter, name string, err error)
• func ContainerNotRunning(w http.ResponseWriter, containerID string, err error)
• func Error(w http.ResponseWriter, code int, err error)
• func FilterMapToString(filters map[string][]string) (string, error)
• func GetImage(r *http.Request, name string) (*libimage.Image, error)
• func GetName(r *http.Request) string
• func GetVar(r *http.Request, k string) string
• func ImageNotFound(w http.ResponseWriter, name string, err error)
• func InternalServerError(w http.ResponseWriter, err error)
• func IsLibpodRequest(r *http.Request) bool
• func IsRegistryReference(name string) error
• func MarshalErrorJSON(ptr unsafe.Pointer, stream *jsoniter.Stream)
• func MarshalErrorJSONIsEmpty(ptr unsafe.Pointer) bool
• func MarshalErrorSliceJSON(ptr unsafe.Pointer, stream *jsoniter.Stream)
• func MarshalErrorSliceJSONIsEmpty(ptr unsafe.Pointer) bool
• func NetworkNotFound(w http.ResponseWriter, name string, err error)
• func NormalizeToDockerHub(r *http.Request, nameOrID string) (string, error)
• func ParseStorageReference(name string) (types.ImageReference, error)
• func PodNotFound(w http.ResponseWriter, name string, err error)
• func PossiblyEnforceDockerHub(r *http.Request, sys *types.SystemContext)
• func SecretNotFound(w http.ResponseWriter, nameOrID string, err error)
• func SessionNotFound(w http.ResponseWriter, name string, err error)
• func SupportedVersion(r *http.Request, condition string) (semver.Version, error)
• func SupportedVersionWithDefaults(r *http.Request) (semver.Version, error)
• func UnSupportedParameter(param string)
• func VolumeNotFound(w http.ResponseWriter, name string, err error)
• func WaitContainerDocker(w http.ResponseWriter, r *http.Request)
• func WaitContainerLibpod(w http.ResponseWriter, r *http.Request)
• func WriteJSON(w http.ResponseWriter, code int, value interface{})
• func WriteResponse(w http.ResponseWriter, code int, value interface{})

Variables

var (
	// ErrVersionNotGiven returned when version not given by client
	ErrVersionNotGiven = errors.New("version not given in URL path")
	// ErrVersionNotSupported returned when given version is too old
	ErrVersionNotSupported = errors.New("given version is not supported")
)

var (
	ErrLinkNotSupport = errors.New("link is not supported")
)

Functions

func BadRequest

func BadRequest(w http.ResponseWriter, key string, value string, err error)

func ContainerNotFound

func ContainerNotFound(w http.ResponseWriter, name string, err error)

func ContainerNotRunning

func ContainerNotRunning(w http.ResponseWriter, containerID string, err error)

func Error

func Error(w http.ResponseWriter, code int, err error)

Error formats an API response to an error

apiMessage and code must match the container API, and are sent to client err is logged on the system running the podman service

func FilterMapToString

func FilterMapToString(filters map[string][]string) (string, error)

func GetImage

func GetImage(r *http.Request, name string) (*libimage.Image, error)

func GetName

func GetName(r *http.Request) string

GetName extracts the name from the mux

func GetVar

func GetVar(r *http.Request, k string) string

func ImageNotFound

func ImageNotFound(w http.ResponseWriter, name string, err error)

func InternalServerError

func InternalServerError(w http.ResponseWriter, err error)

func IsLibpodRequest

func IsLibpodRequest(r *http.Request) bool

IsLibpodRequest returns true if the request related to a libpod endpoint (e.g., /v2/libpod/...).

func IsRegistryReference

func IsRegistryReference(name string) error

IsRegistryReference checks if the specified name points to the "docker://" transport. If it points to no supported transport, we'll assume a non-transport reference pointing to an image (e.g., "fedora:latest").

func MarshalErrorJSON

func MarshalErrorJSON(ptr unsafe.Pointer, stream *jsoniter.Stream)

MarshalErrorJSON writes error to stream as string

func MarshalErrorJSONIsEmpty

func MarshalErrorJSONIsEmpty(ptr unsafe.Pointer) bool

func MarshalErrorSliceJSON

func MarshalErrorSliceJSON(ptr unsafe.Pointer, stream *jsoniter.Stream)

MarshalErrorSliceJSON writes []error to stream as []string JSON blob

func MarshalErrorSliceJSONIsEmpty

func MarshalErrorSliceJSONIsEmpty(ptr unsafe.Pointer) bool

func NetworkNotFound

func NetworkNotFound(w http.ResponseWriter, name string, err error)

func NormalizeToDockerHub

func NormalizeToDockerHub(r *http.Request, nameOrID string) (string, error)

NormalizeToDockerHub normalizes the specified nameOrID to Docker Hub if the request is for the compat API and if containers.conf set the specific mode. If nameOrID is a (short) ID for a local image, the full ID will be returned.

func ParseStorageReference

func ParseStorageReference(name string) (types.ImageReference, error)

ParseStorageReference parses the specified image name to a `types.ImageReference` and enforces it to refer to a containers-storage-transport reference.

func PodNotFound

func PodNotFound(w http.ResponseWriter, name string, err error)

func PossiblyEnforceDockerHub

func PossiblyEnforceDockerHub(r *http.Request, sys *types.SystemContext)

PossiblyEnforceDockerHub sets fields in the system context to enforce resolving short names to Docker Hub if the request is for the compat API and if containers.conf set the specific mode.

func SecretNotFound

func SecretNotFound(w http.ResponseWriter, nameOrID string, err error)

func SessionNotFound

func SessionNotFound(w http.ResponseWriter, name string, err error)

func SupportedVersion

func SupportedVersion(r *http.Request, condition string) (semver.Version, error)

SupportedVersion validates that the version provided by client is included in the given condition https://github.com/blang/semver#ranges provides the details for writing conditions If a version is not given in URL path, ErrVersionNotGiven is returned

func SupportedVersionWithDefaults

func SupportedVersionWithDefaults(r *http.Request) (semver.Version, error)

SupportedVersionWithDefaults validates that the version provided by client valid is supported by server minimal API version <= client path version <= maximum API version focused on the endpoint tree from URL

func UnSupportedParameter

func UnSupportedParameter(param string)

UnsupportedParameter logs a given param by its string name as not supported.

func VolumeNotFound

func VolumeNotFound(w http.ResponseWriter, name string, err error)

func WaitContainerDocker

func WaitContainerDocker(w http.ResponseWriter, r *http.Request)

func WaitContainerLibpod

func WaitContainerLibpod(w http.ResponseWriter, r *http.Request)

func WriteJSON

func WriteJSON(w http.ResponseWriter, code int, value interface{})

WriteJSON writes an interface value encoded as JSON to w

func WriteResponse

func WriteResponse(w http.ResponseWriter, code int, value interface{})

WriteResponse encodes the given value as JSON or string and renders it for http client