api

package
v0.1.0-do.not.use Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 1, 2026 License: Apache-2.0 Imports: 6 Imported by: 2

Documentation

Index

Constants

View Source
const (
	// PluginLaunchedByEngineVar is used to inform engine-launched plugins about their name.
	PluginLaunchedByEngineVar = "DOCKER_SECRETS_ENGINE_PLUGIN_LAUNCH_CFG"
	// DefaultPluginRegistrationTimeout is the default timeout for plugin registration.
	DefaultPluginRegistrationTimeout = 5 * time.Second
	// DefaultClientRequestTimeout is the default timeout for clients to handle a request.
	DefaultClientRequestTimeout = time.Duration(0) // 0 means no limit
	// DefaultClientResponseHeaderTimeout is the default timeout for clients to handle
	// header responses, this does not include the response body and usually should
	// be short.
	DefaultClientResponseHeaderTimeout = time.Second
	// DefaultClientTLSHandshakeTimeout is the default timeout for clients to handle
	// tls handshakes. It should usually be short.
	DefaultClientTLSHandshakeTimeout = time.Second
	// DefaultClientIdleConnTimeout is the time a connection may stay alive for.
	// Clients that are long-lived take advantage of re-using the same connection
	// when making subsequent requests. This reduces latency.
	DefaultClientIdleConnTimeout = 90 * time.Second
	// DefaultClientMaxConnsPerHost is the maximum number of open connections
	// to the same host.
	DefaultClientMaxConnsPerHost = 100
	// DefaultClientMaxIdleConnsPerHost is the maximum number of idle connections
	// to the same host. Long-lived clients can re-use a connection from the
	// connection pool.
	DefaultClientMaxIdleConnsPerHost = 10
)

Variables

View Source
var (
	ErrEmptyVersion = errors.New("empty version")
	ErrVPrefix      = errors.New("missing version prefix")
)
View Source
var ErrEmptyName = errors.New("empty name")

Functions

func Compare

func Compare(a, b Version) int

Compare returns an integer comparing two versions according to semantic versioning. The result will be 0 if a == b, -1 if a < b, or +1 if a > b. An invalid semver string is considered less than a valid one.

func DaemonSocketPath

func DaemonSocketPath() string

DaemonSocketPath returns the address of the daemon's listening socket.

On Linux it is an abstract Unix domain socket: the address has a leading "@", which Go's net package maps to a NUL byte, placing the socket in the abstract namespace instead of on the filesystem.

The address is namespaced by the user's UID so daemons run by different users on the same host do not collide (the abstract namespace is shared per network namespace, not per user as a filesystem path would be).

func DefaultSecretsEngineDirectory

func DefaultSecretsEngineDirectory() (string, error)

func DefaultSocketPath

func DefaultSocketPath() string

Types

type DaemonVersion

type DaemonVersion struct {
	Version    Version
	Date       string
	CommitHash string
}

DaemonVersion holds version information reported by the daemon.

type Name

type Name interface {
	String() string
}

func MustNewName

func MustNewName(s string) Name

MustNewName creates a new Name as NewName does, but panics when a validation error occurs.

func NewName

func NewName(s string) (Name, error)

NewName creates a new Name from a string If a validation error occurs, it returns nil and the error.

type Version

type Version interface {
	String() string
}

func MustNewVersion

func MustNewVersion(s string) Version

MustNewVersion creates a new Version as NewVersion does, but panics when a validation error occurs.

func NewVersion

func NewVersion(s string) (Version, error)

NewVersion creates a new Version from a string If a validation error occurs, it returns nil and the error.

Directories

Path Synopsis
health
v1
plugins
v1
v1

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL