package dynamic_modulesv3

import "github.com/envoyproxy/go-control-plane/envoy/extensions/dynamic_modules/v3"

Index ¶

• Variables
• type DynamicModuleConfig
• func (*DynamicModuleConfig) Descriptor() ([]byte, []int)
• func (x *DynamicModuleConfig) GetDoNotClose() bool
• func (x *DynamicModuleConfig) GetName() string
• func (*DynamicModuleConfig) ProtoMessage()
• func (x *DynamicModuleConfig) ProtoReflect() protoreflect.Message
• func (x *DynamicModuleConfig) Reset()
• func (x *DynamicModuleConfig) String() string
• func (m *DynamicModuleConfig) Validate() error
• func (m *DynamicModuleConfig) ValidateAll() error
• type DynamicModuleConfigMultiError
• func (m DynamicModuleConfigMultiError) AllErrors() []error
• func (m DynamicModuleConfigMultiError) Error() string
• type DynamicModuleConfigValidationError
• func (e DynamicModuleConfigValidationError) Cause() error
• func (e DynamicModuleConfigValidationError) Error() string
• func (e DynamicModuleConfigValidationError) ErrorName() string
• func (e DynamicModuleConfigValidationError) Field() string
• func (e DynamicModuleConfigValidationError) Key() bool
• func (e DynamicModuleConfigValidationError) Reason() string

Variables ¶

var File_envoy_extensions_dynamic_modules_v3_dynamic_modules_proto protoreflect.FileDescriptor

Types ¶

type DynamicModuleConfig ¶

type DynamicModuleConfig struct {

	// The name of the dynamic module. The client is expected to have some configuration indicating where to search for the module.
	// In Envoy, the search path can only be configured via the environment variable “ENVOY_DYNAMIC_MODULES_SEARCH_PATH“.
	// The actual search path is “${ENVOY_DYNAMIC_MODULES_SEARCH_PATH}/lib${name}.so“. TODO: make the search path configurable via
	// command line options.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Set true to prevent the module from being unloaded with dlclose.
	// This is useful for modules that have global state that should not be unloaded.
	// A module is closed when no more references to it exist in the process. For example,
	// no HTTP filters are using the module (e.g. after configuration update).
	DoNotClose bool `protobuf:"varint,3,opt,name=do_not_close,json=doNotClose,proto3" json:"do_not_close,omitempty"`
	// contains filtered or unexported fields
}

Configuration of a dynamic module. A dynamic module is a shared object file that can be loaded via dlopen by various Envoy extension points. Currently, only HTTP filter (envoy.filters.http.dynamic_modules) is supported.

How a module is loaded is determined by the extension point that uses it. For example, the HTTP filter loads the module with dlopen when Envoy receives a configuration that references the module at load time. If loading the module fails, the configuration will be rejected.

Whether or not the shared object is the same is determined by the file path as well as the file's inode depending on the platform. Notably, if the file path and the content of the file are the same, the shared object will be reused.

A module must be compatible with the ABI specified in :repo:`abi.h <source/extensions/dynamic_modules/abi.h>`. Currently, compatibility is only guaranteed by an exact version match between the Envoy codebase and the dynamic module SDKs. In the future, after the ABI is stabilized, we will revisit this restriction and hopefully provide a wider compatibility guarantee. Until then, Envoy checks the hash of the ABI header files to ensure that the dynamic modules are built against the same version of the ABI.

Currently, the implementation is work in progress and not usable.

func (*DynamicModuleConfig) Descriptor ¶

func (*DynamicModuleConfig) Descriptor() ([]byte, []int)

Deprecated: Use DynamicModuleConfig.ProtoReflect.Descriptor instead.

func (*DynamicModuleConfig) GetDoNotClose ¶

func (x *DynamicModuleConfig) GetDoNotClose() bool

func (*DynamicModuleConfig) GetName ¶

func (x *DynamicModuleConfig) GetName() string

func (*DynamicModuleConfig) ProtoMessage ¶

func (*DynamicModuleConfig) ProtoMessage()

func (*DynamicModuleConfig) ProtoReflect ¶

func (x *DynamicModuleConfig) ProtoReflect() protoreflect.Message

func (*DynamicModuleConfig) Reset ¶

func (x *DynamicModuleConfig) Reset()

func (*DynamicModuleConfig) String ¶

func (x *DynamicModuleConfig) String() string

func (*DynamicModuleConfig) Validate ¶

func (m *DynamicModuleConfig) Validate() error

Validate checks the field values on DynamicModuleConfig with the rules defined in the proto definition for this message. If any rules are violated, the first error encountered is returned, or nil if there are no violations.

func (*DynamicModuleConfig) ValidateAll ¶

func (m *DynamicModuleConfig) ValidateAll() error

ValidateAll checks the field values on DynamicModuleConfig with the rules defined in the proto definition for this message. If any rules are violated, the result is a list of violation errors wrapped in DynamicModuleConfigMultiError, or nil if none found.

type DynamicModuleConfigMultiError ¶

type DynamicModuleConfigMultiError []error

DynamicModuleConfigMultiError is an error wrapping multiple validation errors returned by DynamicModuleConfig.ValidateAll() if the designated constraints aren't met.

func (DynamicModuleConfigMultiError) AllErrors ¶

func (m DynamicModuleConfigMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (DynamicModuleConfigMultiError) Error ¶

func (m DynamicModuleConfigMultiError) Error() string

Error returns a concatenation of all the error messages it wraps.

type DynamicModuleConfigValidationError ¶

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

DynamicModuleConfigValidationError is the validation error returned by DynamicModuleConfig.Validate if the designated constraints aren't met.

func (DynamicModuleConfigValidationError) Cause ¶

func (e DynamicModuleConfigValidationError) Cause() error

Cause function returns cause value.

func (DynamicModuleConfigValidationError) Error ¶

func (e DynamicModuleConfigValidationError) Error() string

Error satisfies the builtin error interface

func (DynamicModuleConfigValidationError) ErrorName ¶

func (e DynamicModuleConfigValidationError) ErrorName() string

ErrorName returns error name.

func (DynamicModuleConfigValidationError) Field ¶

func (e DynamicModuleConfigValidationError) Field() string

Field function returns field value.

func (DynamicModuleConfigValidationError) Key ¶

func (e DynamicModuleConfigValidationError) Key() bool

Key function returns key value.

func (DynamicModuleConfigValidationError) Reason ¶

func (e DynamicModuleConfigValidationError) Reason() string

Reason function returns reason value.

Source Files ¶

dynamic_modules.pb.go dynamic_modules.pb.validate.go