opts

Documentation

Index

• Constants
• Variables
• func ParseHost(defaultToTLS bool, val string) (string, error)
• func ValidateDNSSearch(val string) (string, error)
• func ValidateHost(val string) (string, error)
• func ValidateIPAddress(val string) (string, error)
• func ValidateLabel(val string) (string, error)
• type IPOpt
  • func NewIPOpt(ref *net.IP, defaultVal string) *IPOpt
  • func (o *IPOpt) Set(val string) error
  • func (o *IPOpt) String() string
• type ListOpts
  • func NewListOpts(validator ValidatorFctType) ListOpts
  • func NewListOptsRef(values *[]string, validator ValidatorFctType) *ListOpts
  • func (opts *ListOpts) Delete(key string)
  • func (opts *ListOpts) Get(key string) bool
  • func (opts *ListOpts) GetAll() []string
  • func (opts *ListOpts) GetAllOrEmpty() []string
  • func (opts *ListOpts) GetMap() map[string]struct{}
  • func (opts *ListOpts) Len() int
  • func (opts *ListOpts) Set(value string) error
  • func (opts *ListOpts) String() string
• type MapOpts
  • func NewMapOpts(values map[string]string, validator ValidatorFctType) *MapOpts
  • func (opts *MapOpts) GetAll() map[string]string
  • func (opts *MapOpts) Set(value string) error
  • func (opts *MapOpts) String() string
• type NamedListOpts
  • func NewNamedListOptsRef(name string, values *[]string, validator ValidatorFctType) *NamedListOpts
  • func (o *NamedListOpts) Name() string
• type NamedMapOpts
  • func NewNamedMapOpts(name string, values map[string]string, validator ValidatorFctType) *NamedMapOpts
  • func (o *NamedMapOpts) Name() string
• type NamedOption
• type ValidatorFctListType
• type ValidatorFctType

Constants

const DefaultHTTPHost = "localhost"

DefaultHTTPHost Default HTTP Host used if only port is provided to -H flag e.g. docker daemon -H tcp://:8080

Variables

var (
	// DefaultHTTPPort Default HTTP Port used if only the protocol is provided to -H flag e.g. docker daemon -H tcp://
	// These are the IANA registered port numbers for use with Docker
	// see http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=docker
	DefaultHTTPPort = 2375 // Default HTTP Port
	// DefaultTLSHTTPPort Default HTTP Port used when TLS enabled
	DefaultTLSHTTPPort = 2376 // Default TLS encrypted HTTP Port
	// DefaultUnixSocket Path for the unix socket.
	// Docker daemon by default always listens on the default unix socket
	DefaultUnixSocket = "/var/run/docker.sock"
	// DefaultTCPHost constant defines the default host string used by docker on Windows
	DefaultTCPHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultHTTPPort)
	// DefaultTLSHost constant defines the default host string used by docker for TLS sockets
	DefaultTLSHost = fmt.Sprintf("tcp://%s:%d", DefaultHTTPHost, DefaultTLSHTTPPort)
	// DefaultNamedPipe defines the default named pipe used by docker on Windows
	DefaultNamedPipe = `//./pipe/docker_engine`
)

var DefaultHost = fmt.Sprintf("unix://%s", DefaultUnixSocket)

DefaultHost constant defines the default host string used by docker on other hosts than Windows

Functions

func ParseHost

func ParseHost(defaultToTLS bool, val string) (string, error)

ParseHost and set defaults for a Daemon host string

func ValidateDNSSearch

func ValidateDNSSearch(val string) (string, error)

ValidateDNSSearch validates domain for resolvconf search configuration. A zero length domain is represented by a dot (.).

func ValidateHost

func ValidateHost(val string) (string, error)

ValidateHost validates that the specified string is a valid host and returns it.

func ValidateIPAddress

func ValidateIPAddress(val string) (string, error)

ValidateIPAddress validates an Ip address.

func ValidateLabel

func ValidateLabel(val string) (string, error)

ValidateLabel validates that the specified string is a valid label, and returns it. Labels are in the form on key=value.

Types

type IPOpt

type IPOpt struct {
	*net.IP
}

IPOpt holds an IP. It is used to store values from CLI flags.

func NewIPOpt

func NewIPOpt(ref *net.IP, defaultVal string) *IPOpt

NewIPOpt creates a new IPOpt from a reference net.IP and a string representation of an IP. If the string is not a valid IP it will fallback to the specified reference.

func (*IPOpt) Set

func (o *IPOpt) Set(val string) error

Set sets an IPv4 or IPv6 address from a given string. If the given string is not parseable as an IP address it returns an error.

func (*IPOpt) String

func (o *IPOpt) String() string

String returns the IP address stored in the IPOpt. If stored IP is a nil pointer, it returns an empty string.

type ListOpts

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

ListOpts holds a list of values and a validation function.

func NewListOpts

func NewListOpts(validator ValidatorFctType) ListOpts

NewListOpts creates a new ListOpts with the specified validator.

func NewListOptsRef

func NewListOptsRef(values *[]string, validator ValidatorFctType) *ListOpts

NewListOptsRef creates a new ListOpts with the specified values and validator.

func (*ListOpts) Delete

func (opts *ListOpts) Delete(key string)

Delete removes the specified element from the slice.

func (*ListOpts) Get

func (opts *ListOpts) Get(key string) bool

Get checks the existence of the specified key.

func (*ListOpts) GetAll

func (opts *ListOpts) GetAll() []string

GetAll returns the values of slice.

func (*ListOpts) GetAllOrEmpty

func (opts *ListOpts) GetAllOrEmpty() []string

GetAllOrEmpty returns the values of the slice or an empty slice when there are no values.

func (*ListOpts) GetMap

func (opts *ListOpts) GetMap() map[string]struct{}

GetMap returns the content of values in a map in order to avoid duplicates.

func (*ListOpts) Len

func (opts *ListOpts) Len() int

Len returns the amount of element in the slice.

func (*ListOpts) Set

func (opts *ListOpts) Set(value string) error

Set validates if needed the input value and add it to the internal slice.

func (*ListOpts) String

func (opts *ListOpts) String() string

type MapOpts

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

MapOpts holds a map of values and a validation function.

func NewMapOpts

func NewMapOpts(values map[string]string, validator ValidatorFctType) *MapOpts

NewMapOpts creates a new MapOpts with the specified map of values and a validator.

func (*MapOpts) GetAll

func (opts *MapOpts) GetAll() map[string]string

GetAll returns the values of MapOpts as a map.

func (*MapOpts) Set

func (opts *MapOpts) Set(value string) error

Set validates if needed the input value and add it to the internal map, by splitting on '='.

func (*MapOpts) String

func (opts *MapOpts) String() string

type NamedListOpts

type NamedListOpts struct {
	ListOpts
	// contains filtered or unexported fields
}

NamedListOpts is a ListOpts with a configuration name. This struct is useful to keep reference to the assigned field name in the internal configuration struct.

func NewNamedListOptsRef

func NewNamedListOptsRef(name string, values *[]string, validator ValidatorFctType) *NamedListOpts

NewNamedListOptsRef creates a reference to a new NamedListOpts struct.

func (*NamedListOpts) Name

func (o *NamedListOpts) Name() string

Name returns the name of the NamedListOpts in the configuration.

type NamedMapOpts

type NamedMapOpts struct {
	MapOpts
	// contains filtered or unexported fields
}

NamedMapOpts is a MapOpts struct with a configuration name. This struct is useful to keep reference to the assigned field name in the internal configuration struct.

func NewNamedMapOpts

func NewNamedMapOpts(name string, values map[string]string, validator ValidatorFctType) *NamedMapOpts

NewNamedMapOpts creates a reference to a new NamedMapOpts struct.

func (*NamedMapOpts) Name

func (o *NamedMapOpts) Name() string

Name returns the name of the NamedMapOpts in the configuration.

type NamedOption

type NamedOption interface {
	Name() string
}

NamedOption is an interface that list and map options with names implement.

type ValidatorFctListType

type ValidatorFctListType func(val string) ([]string, error)

ValidatorFctListType defines a validator function that returns a validated list of string and/or an error

type ValidatorFctType

type ValidatorFctType func(val string) (string, error)

ValidatorFctType defines a validator function that returns a validated string and/or an error.