listenerv3

package
v0.13.0 Latest Latest
Warning

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

Go to latest
Published: Aug 9, 2024 License: Apache-2.0 Imports: 27 Imported by: 287

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	Listener_DrainType_name = map[int32]string{
		0: "DEFAULT",
		1: "MODIFY_ONLY",
	}
	Listener_DrainType_value = map[string]int32{
		"DEFAULT":     0,
		"MODIFY_ONLY": 1,
	}
)

Enum value maps for Listener_DrainType.

View Source
var (
	FilterChainMatch_ConnectionSourceType_name = map[int32]string{
		0: "ANY",
		1: "SAME_IP_OR_LOOPBACK",
		2: "EXTERNAL",
	}
	FilterChainMatch_ConnectionSourceType_value = map[string]int32{
		"ANY":                 0,
		"SAME_IP_OR_LOOPBACK": 1,
		"EXTERNAL":            2,
	}
)

Enum value maps for FilterChainMatch_ConnectionSourceType.

View Source
var File_envoy_config_listener_v3_api_listener_proto protoreflect.FileDescriptor
View Source
var File_envoy_config_listener_v3_listener_components_proto protoreflect.FileDescriptor
View Source
var File_envoy_config_listener_v3_listener_proto protoreflect.FileDescriptor
View Source
var File_envoy_config_listener_v3_quic_config_proto protoreflect.FileDescriptor
View Source
var File_envoy_config_listener_v3_udp_listener_config_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type ActiveRawUdpListenerConfig

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

func (*ActiveRawUdpListenerConfig) Descriptor deprecated

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

Deprecated: Use ActiveRawUdpListenerConfig.ProtoReflect.Descriptor instead.

func (*ActiveRawUdpListenerConfig) ProtoMessage

func (*ActiveRawUdpListenerConfig) ProtoMessage()

func (*ActiveRawUdpListenerConfig) ProtoReflect added in v0.9.6

func (*ActiveRawUdpListenerConfig) Reset

func (x *ActiveRawUdpListenerConfig) Reset()

func (*ActiveRawUdpListenerConfig) String

func (x *ActiveRawUdpListenerConfig) String() string

func (*ActiveRawUdpListenerConfig) Validate

func (m *ActiveRawUdpListenerConfig) Validate() error

Validate checks the field values on ActiveRawUdpListenerConfig 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 (*ActiveRawUdpListenerConfig) ValidateAll added in v0.10.0

func (m *ActiveRawUdpListenerConfig) ValidateAll() error

ValidateAll checks the field values on ActiveRawUdpListenerConfig 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 ActiveRawUdpListenerConfigMultiError, or nil if none found.

type ActiveRawUdpListenerConfigMultiError added in v0.10.0

type ActiveRawUdpListenerConfigMultiError []error

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

func (ActiveRawUdpListenerConfigMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (ActiveRawUdpListenerConfigMultiError) Error added in v0.10.0

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

type ActiveRawUdpListenerConfigValidationError

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

ActiveRawUdpListenerConfigValidationError is the validation error returned by ActiveRawUdpListenerConfig.Validate if the designated constraints aren't met.

func (ActiveRawUdpListenerConfigValidationError) Cause

Cause function returns cause value.

func (ActiveRawUdpListenerConfigValidationError) Error

Error satisfies the builtin error interface

func (ActiveRawUdpListenerConfigValidationError) ErrorName

ErrorName returns error name.

func (ActiveRawUdpListenerConfigValidationError) Field

Field function returns field value.

func (ActiveRawUdpListenerConfigValidationError) Key

Key function returns key value.

func (ActiveRawUdpListenerConfigValidationError) Reason

Reason function returns reason value.

type AdditionalAddress added in v0.10.2

type AdditionalAddress struct {
	Address *v3.Address `protobuf:"bytes,1,opt,name=address,proto3" json:"address,omitempty"`
	// Additional socket options that may not be present in Envoy source code or
	// precompiled binaries. If specified, this will override the
	// :ref:`socket_options <envoy_v3_api_field_config.listener.v3.Listener.socket_options>`
	// in the listener. If specified with no
	// :ref:`socket_options <envoy_v3_api_field_config.core.v3.SocketOptionsOverride.socket_options>`
	// or an empty list of :ref:`socket_options <envoy_v3_api_field_config.core.v3.SocketOptionsOverride.socket_options>`,
	// it means no socket option will apply.
	SocketOptions *v3.SocketOptionsOverride `protobuf:"bytes,2,opt,name=socket_options,json=socketOptions,proto3" json:"socket_options,omitempty"`
	// contains filtered or unexported fields
}

The additional address the listener is listening on.

func (*AdditionalAddress) Descriptor deprecated added in v0.10.2

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

Deprecated: Use AdditionalAddress.ProtoReflect.Descriptor instead.

func (*AdditionalAddress) GetAddress added in v0.10.2

func (x *AdditionalAddress) GetAddress() *v3.Address

func (*AdditionalAddress) GetSocketOptions added in v0.11.0

func (x *AdditionalAddress) GetSocketOptions() *v3.SocketOptionsOverride

func (*AdditionalAddress) ProtoMessage added in v0.10.2

func (*AdditionalAddress) ProtoMessage()

func (*AdditionalAddress) ProtoReflect added in v0.10.2

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

func (*AdditionalAddress) Reset added in v0.10.2

func (x *AdditionalAddress) Reset()

func (*AdditionalAddress) String added in v0.10.2

func (x *AdditionalAddress) String() string

func (*AdditionalAddress) Validate added in v0.10.2

func (m *AdditionalAddress) Validate() error

Validate checks the field values on AdditionalAddress 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 (*AdditionalAddress) ValidateAll added in v0.10.2

func (m *AdditionalAddress) ValidateAll() error

ValidateAll checks the field values on AdditionalAddress 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 AdditionalAddressMultiError, or nil if none found.

type AdditionalAddressMultiError added in v0.10.2

type AdditionalAddressMultiError []error

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

func (AdditionalAddressMultiError) AllErrors added in v0.10.2

func (m AdditionalAddressMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (AdditionalAddressMultiError) Error added in v0.10.2

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

type AdditionalAddressValidationError added in v0.10.2

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

AdditionalAddressValidationError is the validation error returned by AdditionalAddress.Validate if the designated constraints aren't met.

func (AdditionalAddressValidationError) Cause added in v0.10.2

Cause function returns cause value.

func (AdditionalAddressValidationError) Error added in v0.10.2

Error satisfies the builtin error interface

func (AdditionalAddressValidationError) ErrorName added in v0.10.2

ErrorName returns error name.

func (AdditionalAddressValidationError) Field added in v0.10.2

Field function returns field value.

func (AdditionalAddressValidationError) Key added in v0.10.2

Key function returns key value.

func (AdditionalAddressValidationError) Reason added in v0.10.2

Reason function returns reason value.

type ApiListener

type ApiListener struct {

	// The type in this field determines the type of API listener. At present, the following
	// types are supported:
	// envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager (HTTP)
	// envoy.extensions.filters.network.http_connection_manager.v3.EnvoyMobileHttpConnectionManager (HTTP)
	// [#next-major-version: In the v3 API, replace this Any field with a oneof containing the
	// specific config message for each type of API listener. We could not do this in v2 because
	// it would have caused circular dependencies for go protos: lds.proto depends on this file,
	// and http_connection_manager.proto depends on rds.proto, which is in the same directory as
	// lds.proto, so lds.proto cannot depend on this file.]
	ApiListener *anypb.Any `protobuf:"bytes,1,opt,name=api_listener,json=apiListener,proto3" json:"api_listener,omitempty"`
	// contains filtered or unexported fields
}

Describes a type of API listener, which is used in non-proxy clients. The type of API exposed to the non-proxy application depends on the type of API listener.

func (*ApiListener) Descriptor deprecated

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

Deprecated: Use ApiListener.ProtoReflect.Descriptor instead.

func (*ApiListener) GetApiListener

func (x *ApiListener) GetApiListener() *anypb.Any

func (*ApiListener) ProtoMessage

func (*ApiListener) ProtoMessage()

func (*ApiListener) ProtoReflect added in v0.9.6

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

func (*ApiListener) Reset

func (x *ApiListener) Reset()

func (*ApiListener) String

func (x *ApiListener) String() string

func (*ApiListener) Validate

func (m *ApiListener) Validate() error

Validate checks the field values on ApiListener 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 (*ApiListener) ValidateAll added in v0.10.0

func (m *ApiListener) ValidateAll() error

ValidateAll checks the field values on ApiListener 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 ApiListenerMultiError, or nil if none found.

type ApiListenerManager added in v0.11.0

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

A placeholder proto so that users can explicitly configure the API Listener Manager via the bootstrap's :ref:`listener_manager <envoy_v3_api_field_config.bootstrap.v3.Bootstrap.listener_manager>`. [#not-implemented-hide:]

func (*ApiListenerManager) Descriptor deprecated added in v0.11.0

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

Deprecated: Use ApiListenerManager.ProtoReflect.Descriptor instead.

func (*ApiListenerManager) ProtoMessage added in v0.11.0

func (*ApiListenerManager) ProtoMessage()

func (*ApiListenerManager) ProtoReflect added in v0.11.0

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

func (*ApiListenerManager) Reset added in v0.11.0

func (x *ApiListenerManager) Reset()

func (*ApiListenerManager) String added in v0.11.0

func (x *ApiListenerManager) String() string

func (*ApiListenerManager) Validate added in v0.11.0

func (m *ApiListenerManager) Validate() error

Validate checks the field values on ApiListenerManager 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 (*ApiListenerManager) ValidateAll added in v0.11.0

func (m *ApiListenerManager) ValidateAll() error

ValidateAll checks the field values on ApiListenerManager 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 ApiListenerManagerMultiError, or nil if none found.

type ApiListenerManagerMultiError added in v0.11.0

type ApiListenerManagerMultiError []error

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

func (ApiListenerManagerMultiError) AllErrors added in v0.11.0

func (m ApiListenerManagerMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ApiListenerManagerMultiError) Error added in v0.11.0

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

type ApiListenerManagerValidationError added in v0.11.0

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

ApiListenerManagerValidationError is the validation error returned by ApiListenerManager.Validate if the designated constraints aren't met.

func (ApiListenerManagerValidationError) Cause added in v0.11.0

Cause function returns cause value.

func (ApiListenerManagerValidationError) Error added in v0.11.0

Error satisfies the builtin error interface

func (ApiListenerManagerValidationError) ErrorName added in v0.11.0

ErrorName returns error name.

func (ApiListenerManagerValidationError) Field added in v0.11.0

Field function returns field value.

func (ApiListenerManagerValidationError) Key added in v0.11.0

Key function returns key value.

func (ApiListenerManagerValidationError) Reason added in v0.11.0

Reason function returns reason value.

type ApiListenerMultiError added in v0.10.0

type ApiListenerMultiError []error

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

func (ApiListenerMultiError) AllErrors added in v0.10.0

func (m ApiListenerMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ApiListenerMultiError) Error added in v0.10.0

func (m ApiListenerMultiError) Error() string

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

type ApiListenerValidationError

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

ApiListenerValidationError is the validation error returned by ApiListener.Validate if the designated constraints aren't met.

func (ApiListenerValidationError) Cause

Cause function returns cause value.

func (ApiListenerValidationError) Error

Error satisfies the builtin error interface

func (ApiListenerValidationError) ErrorName

func (e ApiListenerValidationError) ErrorName() string

ErrorName returns error name.

func (ApiListenerValidationError) Field

Field function returns field value.

func (ApiListenerValidationError) Key

Key function returns key value.

func (ApiListenerValidationError) Reason

Reason function returns reason value.

type Filter

type Filter struct {

	// The name of the filter configuration.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Types that are assignable to ConfigType:
	//
	//	*Filter_TypedConfig
	//	*Filter_ConfigDiscovery
	ConfigType isFilter_ConfigType `protobuf_oneof:"config_type"`
	// contains filtered or unexported fields
}

[#next-free-field: 6]

func (*Filter) Descriptor deprecated

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

Deprecated: Use Filter.ProtoReflect.Descriptor instead.

func (*Filter) GetConfigDiscovery added in v0.9.9

func (x *Filter) GetConfigDiscovery() *v3.ExtensionConfigSource

func (*Filter) GetConfigType

func (m *Filter) GetConfigType() isFilter_ConfigType

func (*Filter) GetName

func (x *Filter) GetName() string

func (*Filter) GetTypedConfig

func (x *Filter) GetTypedConfig() *anypb.Any

func (*Filter) ProtoMessage

func (*Filter) ProtoMessage()

func (*Filter) ProtoReflect added in v0.9.6

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

func (*Filter) Reset

func (x *Filter) Reset()

func (*Filter) String

func (x *Filter) String() string

func (*Filter) Validate

func (m *Filter) Validate() error

Validate checks the field values on Filter 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 (*Filter) ValidateAll added in v0.10.0

func (m *Filter) ValidateAll() error

ValidateAll checks the field values on Filter 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 FilterMultiError, or nil if none found.

type FilterChain

type FilterChain struct {

	// The criteria to use when matching a connection to this filter chain.
	FilterChainMatch *FilterChainMatch `protobuf:"bytes,1,opt,name=filter_chain_match,json=filterChainMatch,proto3" json:"filter_chain_match,omitempty"`
	// A list of individual network filters that make up the filter chain for
	// connections established with the listener. Order matters as the filters are
	// processed sequentially as connection events happen. Note: If the filter
	// list is empty, the connection will close by default.
	//
	// For QUIC listeners, network filters other than HTTP Connection Manager (HCM)
	// can be created, but due to differences in the connection implementation compared
	// to TCP, the onData() method will never be called. Therefore, network filters
	// for QUIC listeners should only expect to do work at the start of a new connection
	// (i.e. in onNewConnection()). HCM must be the last (or only) filter in the chain.
	Filters []*Filter `protobuf:"bytes,3,rep,name=filters,proto3" json:"filters,omitempty"`
	// Whether the listener should expect a PROXY protocol V1 header on new
	// connections. If this option is enabled, the listener will assume that that
	// remote address of the connection is the one specified in the header. Some
	// load balancers including the AWS ELB support this option. If the option is
	// absent or set to false, Envoy will use the physical peer address of the
	// connection as the remote address.
	//
	// This field is deprecated. Add a
	// :ref:`PROXY protocol listener filter <config_listener_filters_proxy_protocol>`
	// explicitly instead.
	//
	// Deprecated: Marked as deprecated in envoy/config/listener/v3/listener_components.proto.
	UseProxyProto *wrapperspb.BoolValue `protobuf:"bytes,4,opt,name=use_proxy_proto,json=useProxyProto,proto3" json:"use_proxy_proto,omitempty"`
	// [#not-implemented-hide:] filter chain metadata.
	Metadata *v3.Metadata `protobuf:"bytes,5,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// Optional custom transport socket implementation to use for downstream connections.
	// To setup TLS, set a transport socket with name “envoy.transport_sockets.tls“ and
	// :ref:`DownstreamTlsContext <envoy_v3_api_msg_extensions.transport_sockets.tls.v3.DownstreamTlsContext>` in the “typed_config“.
	// If no transport socket configuration is specified, new connections
	// will be set up with plaintext.
	// [#extension-category: envoy.transport_sockets.downstream]
	TransportSocket *v3.TransportSocket `protobuf:"bytes,6,opt,name=transport_socket,json=transportSocket,proto3" json:"transport_socket,omitempty"`
	// If present and nonzero, the amount of time to allow incoming connections to complete any
	// transport socket negotiations. If this expires before the transport reports connection
	// establishment, the connection is summarily closed.
	TransportSocketConnectTimeout *durationpb.Duration `` /* 152-byte string literal not displayed */
	// The unique name (or empty) by which this filter chain is known.
	// Note: :ref:`filter_chain_matcher
	// <envoy_v3_api_field_config.listener.v3.Listener.filter_chain_matcher>`
	// requires that filter chains are uniquely named within a listener.
	Name string `protobuf:"bytes,7,opt,name=name,proto3" json:"name,omitempty"`
	// [#not-implemented-hide:] The configuration to specify whether the filter chain will be built on-demand.
	// If this field is not empty, the filter chain will be built on-demand.
	// Otherwise, the filter chain will be built normally and block listener warming.
	OnDemandConfiguration *FilterChain_OnDemandConfiguration `` /* 126-byte string literal not displayed */
	// contains filtered or unexported fields
}

A filter chain wraps a set of match criteria, an option TLS context, a set of filters, and various other parameters. [#next-free-field: 10]

func (*FilterChain) Descriptor deprecated

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

Deprecated: Use FilterChain.ProtoReflect.Descriptor instead.

func (*FilterChain) GetFilterChainMatch

func (x *FilterChain) GetFilterChainMatch() *FilterChainMatch

func (*FilterChain) GetFilters

func (x *FilterChain) GetFilters() []*Filter

func (*FilterChain) GetMetadata

func (x *FilterChain) GetMetadata() *v3.Metadata

func (*FilterChain) GetName

func (x *FilterChain) GetName() string

func (*FilterChain) GetOnDemandConfiguration added in v0.9.7

func (x *FilterChain) GetOnDemandConfiguration() *FilterChain_OnDemandConfiguration

func (*FilterChain) GetTransportSocket

func (x *FilterChain) GetTransportSocket() *v3.TransportSocket

func (*FilterChain) GetTransportSocketConnectTimeout added in v0.9.8

func (x *FilterChain) GetTransportSocketConnectTimeout() *durationpb.Duration

func (*FilterChain) GetUseProxyProto deprecated

func (x *FilterChain) GetUseProxyProto() *wrapperspb.BoolValue

Deprecated: Marked as deprecated in envoy/config/listener/v3/listener_components.proto.

func (*FilterChain) ProtoMessage

func (*FilterChain) ProtoMessage()

func (*FilterChain) ProtoReflect added in v0.9.6

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

func (*FilterChain) Reset

func (x *FilterChain) Reset()

func (*FilterChain) String

func (x *FilterChain) String() string

func (*FilterChain) Validate

func (m *FilterChain) Validate() error

Validate checks the field values on FilterChain 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 (*FilterChain) ValidateAll added in v0.10.0

func (m *FilterChain) ValidateAll() error

ValidateAll checks the field values on FilterChain 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 FilterChainMultiError, or nil if none found.

type FilterChainMatch

type FilterChainMatch struct {

	// Optional destination port to consider when use_original_dst is set on the
	// listener in determining a filter chain match.
	DestinationPort *wrapperspb.UInt32Value `protobuf:"bytes,8,opt,name=destination_port,json=destinationPort,proto3" json:"destination_port,omitempty"`
	// If non-empty, an IP address and prefix length to match addresses when the
	// listener is bound to 0.0.0.0/:: or when use_original_dst is specified.
	PrefixRanges []*v3.CidrRange `protobuf:"bytes,3,rep,name=prefix_ranges,json=prefixRanges,proto3" json:"prefix_ranges,omitempty"`
	// If non-empty, an IP address and suffix length to match addresses when the
	// listener is bound to 0.0.0.0/:: or when use_original_dst is specified.
	// [#not-implemented-hide:]
	AddressSuffix string `protobuf:"bytes,4,opt,name=address_suffix,json=addressSuffix,proto3" json:"address_suffix,omitempty"`
	// [#not-implemented-hide:]
	SuffixLen *wrapperspb.UInt32Value `protobuf:"bytes,5,opt,name=suffix_len,json=suffixLen,proto3" json:"suffix_len,omitempty"`
	// The criteria is satisfied if the directly connected source IP address of the downstream
	// connection is contained in at least one of the specified subnets. If the parameter is not
	// specified or the list is empty, the directly connected source IP address is ignored.
	DirectSourcePrefixRanges []*v3.CidrRange `` /* 138-byte string literal not displayed */
	// Specifies the connection source IP match type. Can be any, local or external network.
	SourceType FilterChainMatch_ConnectionSourceType `` /* 161-byte string literal not displayed */
	// The criteria is satisfied if the source IP address of the downstream
	// connection is contained in at least one of the specified subnets. If the
	// parameter is not specified or the list is empty, the source IP address is
	// ignored.
	SourcePrefixRanges []*v3.CidrRange `protobuf:"bytes,6,rep,name=source_prefix_ranges,json=sourcePrefixRanges,proto3" json:"source_prefix_ranges,omitempty"`
	// The criteria is satisfied if the source port of the downstream connection
	// is contained in at least one of the specified ports. If the parameter is
	// not specified, the source port is ignored.
	SourcePorts []uint32 `protobuf:"varint,7,rep,packed,name=source_ports,json=sourcePorts,proto3" json:"source_ports,omitempty"`
	// If non-empty, a list of server names (e.g. SNI for TLS protocol) to consider when determining
	// a filter chain match. Those values will be compared against the server names of a new
	// connection, when detected by one of the listener filters.
	//
	// The server name will be matched against all wildcard domains, i.e. “www.example.com“
	// will be first matched against “www.example.com“, then “*.example.com“, then “*.com“.
	//
	// Note that partial wildcards are not supported, and values like “*w.example.com“ are invalid.
	// The value “*“ is also not supported, and “server_names“ should be omitted instead.
	//
	// .. attention::
	//
	//	See the :ref:`FAQ entry <faq_how_to_setup_sni>` on how to configure SNI for more
	//	information.
	ServerNames []string `protobuf:"bytes,11,rep,name=server_names,json=serverNames,proto3" json:"server_names,omitempty"`
	// If non-empty, a transport protocol to consider when determining a filter chain match.
	// This value will be compared against the transport protocol of a new connection, when
	// it's detected by one of the listener filters.
	//
	// Suggested values include:
	//
	//   - “raw_buffer“ - default, used when no transport protocol is detected,
	//   - “tls“ - set by :ref:`envoy.filters.listener.tls_inspector <config_listener_filters_tls_inspector>`
	//     when TLS protocol is detected.
	TransportProtocol string `protobuf:"bytes,9,opt,name=transport_protocol,json=transportProtocol,proto3" json:"transport_protocol,omitempty"`
	// If non-empty, a list of application protocols (e.g. ALPN for TLS protocol) to consider when
	// determining a filter chain match. Those values will be compared against the application
	// protocols of a new connection, when detected by one of the listener filters.
	//
	// Suggested values include:
	//
	//   - “http/1.1“ - set by :ref:`envoy.filters.listener.tls_inspector
	//     <config_listener_filters_tls_inspector>`,
	//   - “h2“ - set by :ref:`envoy.filters.listener.tls_inspector <config_listener_filters_tls_inspector>`
	//
	// .. attention::
	//
	//	Currently, only :ref:`TLS Inspector <config_listener_filters_tls_inspector>` provides
	//	application protocol detection based on the requested
	//	`ALPN <https://en.wikipedia.org/wiki/Application-Layer_Protocol_Negotiation>`_ values.
	//
	//	However, the use of ALPN is pretty much limited to the HTTP/2 traffic on the Internet,
	//	and matching on values other than “h2“ is going to lead to a lot of false negatives,
	//	unless all connecting clients are known to use ALPN.
	ApplicationProtocols []string `protobuf:"bytes,10,rep,name=application_protocols,json=applicationProtocols,proto3" json:"application_protocols,omitempty"`
	// contains filtered or unexported fields
}

Specifies the match criteria for selecting a specific filter chain for a listener.

In order for a filter chain to be selected, *ALL* of its criteria must be fulfilled by the incoming connection, properties of which are set by the networking stack and/or listener filters.

The following order applies:

  1. Destination port.
  2. Destination IP address.
  3. Server name (e.g. SNI for TLS protocol),
  4. Transport protocol.
  5. Application protocols (e.g. ALPN for TLS protocol).
  6. Directly connected source IP address (this will only be different from the source IP address when using a listener filter that overrides the source address, such as the :ref:`Proxy Protocol listener filter <config_listener_filters_proxy_protocol>`).
  7. Source type (e.g. any, local or external network).
  8. Source IP address.
  9. Source port.

For criteria that allow ranges or wildcards, the most specific value in any of the configured filter chains that matches the incoming connection is going to be used (e.g. for SNI “www.example.com“ the most specific match would be “www.example.com“, then “*.example.com“, then “*.com“, then any filter chain without “server_names“ requirements).

A different way to reason about the filter chain matches: Suppose there exists N filter chains. Prune the filter chain set using the above 8 steps. In each step, filter chains which most specifically matches the attributes continue to the next step. The listener guarantees at most 1 filter chain is left after all of the steps.

Example:

For destination port, filter chains specifying the destination port of incoming traffic are the most specific match. If none of the filter chains specifies the exact destination port, the filter chains which do not specify ports are the most specific match. Filter chains specifying the wrong port can never be the most specific match.

[#comment: Implemented rules are kept in the preference order, with deprecated fields listed at the end, because that's how we want to list them in the docs.

[#comment:TODO(PiotrSikora): Add support for configurable precedence of the rules] [#next-free-field: 14]

func (*FilterChainMatch) Descriptor deprecated

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

Deprecated: Use FilterChainMatch.ProtoReflect.Descriptor instead.

func (*FilterChainMatch) GetAddressSuffix

func (x *FilterChainMatch) GetAddressSuffix() string

func (*FilterChainMatch) GetApplicationProtocols

func (x *FilterChainMatch) GetApplicationProtocols() []string

func (*FilterChainMatch) GetDestinationPort

func (x *FilterChainMatch) GetDestinationPort() *wrapperspb.UInt32Value

func (*FilterChainMatch) GetDirectSourcePrefixRanges added in v0.10.0

func (x *FilterChainMatch) GetDirectSourcePrefixRanges() []*v3.CidrRange

func (*FilterChainMatch) GetPrefixRanges

func (x *FilterChainMatch) GetPrefixRanges() []*v3.CidrRange

func (*FilterChainMatch) GetServerNames

func (x *FilterChainMatch) GetServerNames() []string

func (*FilterChainMatch) GetSourcePorts

func (x *FilterChainMatch) GetSourcePorts() []uint32

func (*FilterChainMatch) GetSourcePrefixRanges

func (x *FilterChainMatch) GetSourcePrefixRanges() []*v3.CidrRange

func (*FilterChainMatch) GetSourceType

func (*FilterChainMatch) GetSuffixLen

func (x *FilterChainMatch) GetSuffixLen() *wrapperspb.UInt32Value

func (*FilterChainMatch) GetTransportProtocol

func (x *FilterChainMatch) GetTransportProtocol() string

func (*FilterChainMatch) ProtoMessage

func (*FilterChainMatch) ProtoMessage()

func (*FilterChainMatch) ProtoReflect added in v0.9.6

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

func (*FilterChainMatch) Reset

func (x *FilterChainMatch) Reset()

func (*FilterChainMatch) String

func (x *FilterChainMatch) String() string

func (*FilterChainMatch) Validate

func (m *FilterChainMatch) Validate() error

Validate checks the field values on FilterChainMatch 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 (*FilterChainMatch) ValidateAll added in v0.10.0

func (m *FilterChainMatch) ValidateAll() error

ValidateAll checks the field values on FilterChainMatch 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 FilterChainMatchMultiError, or nil if none found.

type FilterChainMatchMultiError added in v0.10.0

type FilterChainMatchMultiError []error

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

func (FilterChainMatchMultiError) AllErrors added in v0.10.0

func (m FilterChainMatchMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (FilterChainMatchMultiError) Error added in v0.10.0

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

type FilterChainMatchValidationError

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

FilterChainMatchValidationError is the validation error returned by FilterChainMatch.Validate if the designated constraints aren't met.

func (FilterChainMatchValidationError) Cause

Cause function returns cause value.

func (FilterChainMatchValidationError) Error

Error satisfies the builtin error interface

func (FilterChainMatchValidationError) ErrorName

ErrorName returns error name.

func (FilterChainMatchValidationError) Field

Field function returns field value.

func (FilterChainMatchValidationError) Key

Key function returns key value.

func (FilterChainMatchValidationError) Reason

Reason function returns reason value.

type FilterChainMatch_ConnectionSourceType

type FilterChainMatch_ConnectionSourceType int32
const (
	// Any connection source matches.
	FilterChainMatch_ANY FilterChainMatch_ConnectionSourceType = 0
	// Match a connection originating from the same host.
	FilterChainMatch_SAME_IP_OR_LOOPBACK FilterChainMatch_ConnectionSourceType = 1
	// Match a connection originating from a different host.
	FilterChainMatch_EXTERNAL FilterChainMatch_ConnectionSourceType = 2
)

func (FilterChainMatch_ConnectionSourceType) Descriptor added in v0.9.6

func (FilterChainMatch_ConnectionSourceType) Enum added in v0.9.6

func (FilterChainMatch_ConnectionSourceType) EnumDescriptor deprecated

func (FilterChainMatch_ConnectionSourceType) EnumDescriptor() ([]byte, []int)

Deprecated: Use FilterChainMatch_ConnectionSourceType.Descriptor instead.

func (FilterChainMatch_ConnectionSourceType) Number added in v0.9.6

func (FilterChainMatch_ConnectionSourceType) String

func (FilterChainMatch_ConnectionSourceType) Type added in v0.9.6

type FilterChainMultiError added in v0.10.0

type FilterChainMultiError []error

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

func (FilterChainMultiError) AllErrors added in v0.10.0

func (m FilterChainMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (FilterChainMultiError) Error added in v0.10.0

func (m FilterChainMultiError) Error() string

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

type FilterChainValidationError

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

FilterChainValidationError is the validation error returned by FilterChain.Validate if the designated constraints aren't met.

func (FilterChainValidationError) Cause

Cause function returns cause value.

func (FilterChainValidationError) Error

Error satisfies the builtin error interface

func (FilterChainValidationError) ErrorName

func (e FilterChainValidationError) ErrorName() string

ErrorName returns error name.

func (FilterChainValidationError) Field

Field function returns field value.

func (FilterChainValidationError) Key

Key function returns key value.

func (FilterChainValidationError) Reason

Reason function returns reason value.

type FilterChain_OnDemandConfiguration added in v0.9.7

type FilterChain_OnDemandConfiguration struct {

	// The timeout to wait for filter chain placeholders to complete rebuilding.
	// 1. If this field is set to 0, timeout is disabled.
	// 2. If not specified, a default timeout of 15s is used.
	// Rebuilding will wait until dependencies are ready, have failed, or this timeout is reached.
	// Upon failure or timeout, all connections related to this filter chain will be closed.
	// Rebuilding will start again on the next new connection.
	RebuildTimeout *durationpb.Duration `protobuf:"bytes,1,opt,name=rebuild_timeout,json=rebuildTimeout,proto3" json:"rebuild_timeout,omitempty"`
	// contains filtered or unexported fields
}

The configuration for on-demand filter chain. If this field is not empty in FilterChain message, a filter chain will be built on-demand. On-demand filter chains help speedup the warming up of listeners since the building and initialization of an on-demand filter chain will be postponed to the arrival of new connection requests that require this filter chain. Filter chains that are not often used can be set as on-demand.

func (*FilterChain_OnDemandConfiguration) Descriptor deprecated added in v0.9.7

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

Deprecated: Use FilterChain_OnDemandConfiguration.ProtoReflect.Descriptor instead.

func (*FilterChain_OnDemandConfiguration) GetRebuildTimeout added in v0.9.7

func (x *FilterChain_OnDemandConfiguration) GetRebuildTimeout() *durationpb.Duration

func (*FilterChain_OnDemandConfiguration) ProtoMessage added in v0.9.7

func (*FilterChain_OnDemandConfiguration) ProtoMessage()

func (*FilterChain_OnDemandConfiguration) ProtoReflect added in v0.9.7

func (*FilterChain_OnDemandConfiguration) Reset added in v0.9.7

func (*FilterChain_OnDemandConfiguration) String added in v0.9.7

func (*FilterChain_OnDemandConfiguration) Validate added in v0.9.7

Validate checks the field values on FilterChain_OnDemandConfiguration 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 (*FilterChain_OnDemandConfiguration) ValidateAll added in v0.10.0

func (m *FilterChain_OnDemandConfiguration) ValidateAll() error

ValidateAll checks the field values on FilterChain_OnDemandConfiguration 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 FilterChain_OnDemandConfigurationMultiError, or nil if none found.

type FilterChain_OnDemandConfigurationMultiError added in v0.10.0

type FilterChain_OnDemandConfigurationMultiError []error

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

func (FilterChain_OnDemandConfigurationMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (FilterChain_OnDemandConfigurationMultiError) Error added in v0.10.0

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

type FilterChain_OnDemandConfigurationValidationError added in v0.9.7

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

FilterChain_OnDemandConfigurationValidationError is the validation error returned by FilterChain_OnDemandConfiguration.Validate if the designated constraints aren't met.

func (FilterChain_OnDemandConfigurationValidationError) Cause added in v0.9.7

Cause function returns cause value.

func (FilterChain_OnDemandConfigurationValidationError) Error added in v0.9.7

Error satisfies the builtin error interface

func (FilterChain_OnDemandConfigurationValidationError) ErrorName added in v0.9.7

ErrorName returns error name.

func (FilterChain_OnDemandConfigurationValidationError) Field added in v0.9.7

Field function returns field value.

func (FilterChain_OnDemandConfigurationValidationError) Key added in v0.9.7

Key function returns key value.

func (FilterChain_OnDemandConfigurationValidationError) Reason added in v0.9.7

Reason function returns reason value.

type FilterMultiError added in v0.10.0

type FilterMultiError []error

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

func (FilterMultiError) AllErrors added in v0.10.0

func (m FilterMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (FilterMultiError) Error added in v0.10.0

func (m FilterMultiError) Error() string

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

type FilterValidationError

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

FilterValidationError is the validation error returned by Filter.Validate if the designated constraints aren't met.

func (FilterValidationError) Cause

func (e FilterValidationError) Cause() error

Cause function returns cause value.

func (FilterValidationError) Error

func (e FilterValidationError) Error() string

Error satisfies the builtin error interface

func (FilterValidationError) ErrorName

func (e FilterValidationError) ErrorName() string

ErrorName returns error name.

func (FilterValidationError) Field

func (e FilterValidationError) Field() string

Field function returns field value.

func (FilterValidationError) Key

func (e FilterValidationError) Key() bool

Key function returns key value.

func (FilterValidationError) Reason

func (e FilterValidationError) Reason() string

Reason function returns reason value.

type Filter_ConfigDiscovery added in v0.9.9

type Filter_ConfigDiscovery struct {
	// Configuration source specifier for an extension configuration discovery
	// service. In case of a failure and without the default configuration, the
	// listener closes the connections.
	ConfigDiscovery *v3.ExtensionConfigSource `protobuf:"bytes,5,opt,name=config_discovery,json=configDiscovery,proto3,oneof"`
}

type Filter_TypedConfig

type Filter_TypedConfig struct {
	// Filter specific configuration which depends on the filter being
	// instantiated. See the supported filters for further documentation.
	// [#extension-category: envoy.filters.network]
	TypedConfig *anypb.Any `protobuf:"bytes,4,opt,name=typed_config,json=typedConfig,proto3,oneof"`
}

type Listener

type Listener struct {

	// The unique name by which this listener is known. If no name is provided,
	// Envoy will allocate an internal UUID for the listener. If the listener is to be dynamically
	// updated or removed via :ref:`LDS <config_listeners_lds>` a unique name must be provided.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The address that the listener should listen on. In general, the address must be unique, though
	// that is governed by the bind rules of the OS. E.g., multiple listeners can listen on port 0 on
	// Linux as the actual port will be allocated by the OS.
	// Required unless “api_listener“ or “listener_specifier“ is populated.
	Address *v3.Address `protobuf:"bytes,2,opt,name=address,proto3" json:"address,omitempty"`
	// The additional addresses the listener should listen on. The addresses must be unique across all
	// listeners. Multiple addresses with port 0 can be supplied. When using multiple addresses in a single listener,
	// all addresses use the same protocol, and multiple internal addresses are not supported.
	AdditionalAddresses []*AdditionalAddress `protobuf:"bytes,33,rep,name=additional_addresses,json=additionalAddresses,proto3" json:"additional_addresses,omitempty"`
	// Optional prefix to use on listener stats. If empty, the stats will be rooted at
	// “listener.<address as string>.“. If non-empty, stats will be rooted at
	// “listener.<stat_prefix>.“.
	StatPrefix string `protobuf:"bytes,28,opt,name=stat_prefix,json=statPrefix,proto3" json:"stat_prefix,omitempty"`
	// A list of filter chains to consider for this listener. The
	// :ref:`FilterChain <envoy_v3_api_msg_config.listener.v3.FilterChain>` with the most specific
	// :ref:`FilterChainMatch <envoy_v3_api_msg_config.listener.v3.FilterChainMatch>` criteria is used on a
	// connection.
	//
	// Example using SNI for filter chain selection can be found in the
	// :ref:`FAQ entry <faq_how_to_setup_sni>`.
	FilterChains []*FilterChain `protobuf:"bytes,3,rep,name=filter_chains,json=filterChains,proto3" json:"filter_chains,omitempty"`
	// :ref:`Matcher API <arch_overview_matching_listener>` resolving the filter chain name from the
	// network properties. This matcher is used as a replacement for the filter chain match condition
	// :ref:`filter_chain_match
	// <envoy_v3_api_field_config.listener.v3.FilterChain.filter_chain_match>`. If specified, all
	// :ref:`filter_chains <envoy_v3_api_field_config.listener.v3.Listener.filter_chains>` must have a
	// non-empty and unique :ref:`name <envoy_v3_api_field_config.listener.v3.FilterChain.name>` field
	// and not specify :ref:`filter_chain_match
	// <envoy_v3_api_field_config.listener.v3.FilterChain.filter_chain_match>` field.
	//
	// .. note::
	//
	//	Once matched, each connection is permanently bound to its filter chain.
	//	If the matcher changes but the filter chain remains the same, the
	//	connections bound to the filter chain are not drained. If, however, the
	//	filter chain is removed or structurally modified, then the drain for its
	//	connections is initiated.
	FilterChainMatcher *v32.Matcher `protobuf:"bytes,32,opt,name=filter_chain_matcher,json=filterChainMatcher,proto3" json:"filter_chain_matcher,omitempty"`
	// If a connection is redirected using “iptables“, the port on which the proxy
	// receives it might be different from the original destination address. When this flag is set to
	// true, the listener hands off redirected connections to the listener associated with the
	// original destination address. If there is no listener associated with the original destination
	// address, the connection is handled by the listener that receives it. Defaults to false.
	UseOriginalDst *wrapperspb.BoolValue `protobuf:"bytes,4,opt,name=use_original_dst,json=useOriginalDst,proto3" json:"use_original_dst,omitempty"`
	// The default filter chain if none of the filter chain matches. If no default filter chain is supplied,
	// the connection will be closed. The filter chain match is ignored in this field.
	DefaultFilterChain *FilterChain `protobuf:"bytes,25,opt,name=default_filter_chain,json=defaultFilterChain,proto3" json:"default_filter_chain,omitempty"`
	// Soft limit on size of the listener’s new connection read and write buffers.
	// If unspecified, an implementation defined default is applied (1MiB).
	PerConnectionBufferLimitBytes *wrapperspb.UInt32Value `` /* 154-byte string literal not displayed */
	// Listener metadata.
	Metadata *v3.Metadata `protobuf:"bytes,6,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// [#not-implemented-hide:]
	//
	// Deprecated: Marked as deprecated in envoy/config/listener/v3/listener.proto.
	DeprecatedV1 *Listener_DeprecatedV1 `protobuf:"bytes,7,opt,name=deprecated_v1,json=deprecatedV1,proto3" json:"deprecated_v1,omitempty"`
	// The type of draining to perform at a listener-wide level.
	DrainType Listener_DrainType `` /* 138-byte string literal not displayed */
	// Listener filters have the opportunity to manipulate and augment the connection metadata that
	// is used in connection filter chain matching, for example. These filters are run before any in
	// :ref:`filter_chains <envoy_v3_api_field_config.listener.v3.Listener.filter_chains>`. Order matters as the
	// filters are processed sequentially right after a socket has been accepted by the listener, and
	// before a connection is created.
	// UDP Listener filters can be specified when the protocol in the listener socket address in
	// :ref:`protocol <envoy_v3_api_field_config.core.v3.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_v3_api_enum_value_config.core.v3.SocketAddress.Protocol.UDP>` and no
	// :ref:`quic_options <envoy_v3_api_field_config.listener.v3.UdpListenerConfig.quic_options>` is specified in :ref:`udp_listener_config <envoy_v3_api_field_config.listener.v3.Listener.udp_listener_config>`.
	// QUIC listener filters can be specified when :ref:`quic_options
	// <envoy_v3_api_field_config.listener.v3.UdpListenerConfig.quic_options>` is
	// specified in :ref:`udp_listener_config <envoy_v3_api_field_config.listener.v3.Listener.udp_listener_config>`.
	// They are processed sequentially right before connection creation. And like TCP Listener filters, they can be used to manipulate the connection metadata and socket. But the difference is that they can't be used to pause connection creation.
	ListenerFilters []*ListenerFilter `protobuf:"bytes,9,rep,name=listener_filters,json=listenerFilters,proto3" json:"listener_filters,omitempty"`
	// The timeout to wait for all listener filters to complete operation. If the timeout is reached,
	// the accepted socket is closed without a connection being created unless
	// “continue_on_listener_filters_timeout“ is set to true. Specify 0 to disable the
	// timeout. If not specified, a default timeout of 15s is used.
	ListenerFiltersTimeout *durationpb.Duration `` /* 130-byte string literal not displayed */
	// Whether a connection should be created when listener filters timeout. Default is false.
	//
	// .. attention::
	//
	//	Some listener filters, such as :ref:`Proxy Protocol filter
	//	<config_listener_filters_proxy_protocol>`, should not be used with this option. It will cause
	//	unexpected behavior when a connection is created.
	ContinueOnListenerFiltersTimeout bool `` /* 165-byte string literal not displayed */
	// Whether the listener should be set as a transparent socket.
	// When this flag is set to true, connections can be redirected to the listener using an
	// “iptables“ “TPROXY“ target, in which case the original source and destination addresses and
	// ports are preserved on accepted connections. This flag should be used in combination with
	// :ref:`an original_dst <config_listener_filters_original_dst>` :ref:`listener filter
	// <envoy_v3_api_field_config.listener.v3.Listener.listener_filters>` to mark the connections' local addresses as
	// "restored." This can be used to hand off each redirected connection to another listener
	// associated with the connection's destination address. Direct connections to the socket without
	// using “TPROXY“ cannot be distinguished from connections redirected using “TPROXY“ and are
	// therefore treated as if they were redirected.
	// When this flag is set to false, the listener's socket is explicitly reset as non-transparent.
	// Setting this flag requires Envoy to run with the “CAP_NET_ADMIN“ capability.
	// When this flag is not set (default), the socket is not modified, i.e. the transparent option
	// is neither set nor reset.
	Transparent *wrapperspb.BoolValue `protobuf:"bytes,10,opt,name=transparent,proto3" json:"transparent,omitempty"`
	// Whether the listener should set the “IP_FREEBIND“ socket option. When this
	// flag is set to true, listeners can be bound to an IP address that is not
	// configured on the system running Envoy. When this flag is set to false, the
	// option “IP_FREEBIND“ is disabled on the socket. When this flag is not set
	// (default), the socket is not modified, i.e. the option is neither enabled
	// nor disabled.
	Freebind *wrapperspb.BoolValue `protobuf:"bytes,11,opt,name=freebind,proto3" json:"freebind,omitempty"`
	// Additional socket options that may not be present in Envoy source code or
	// precompiled binaries. The socket options can be updated for a listener when
	// :ref:`enable_reuse_port <envoy_v3_api_field_config.listener.v3.Listener.enable_reuse_port>`
	// is “true“. Otherwise, if socket options change during a listener update the update will be rejected
	// to make it clear that the options were not updated.
	SocketOptions []*v3.SocketOption `protobuf:"bytes,13,rep,name=socket_options,json=socketOptions,proto3" json:"socket_options,omitempty"`
	// Whether the listener should accept TCP Fast Open (TFO) connections.
	// When this flag is set to a value greater than 0, the option TCP_FASTOPEN is enabled on
	// the socket, with a queue length of the specified size
	// (see `details in RFC7413 <https://tools.ietf.org/html/rfc7413#section-5.1>`_).
	// When this flag is set to 0, the option TCP_FASTOPEN is disabled on the socket.
	// When this flag is not set (default), the socket is not modified,
	// i.e. the option is neither enabled nor disabled.
	//
	// On Linux, the net.ipv4.tcp_fastopen kernel parameter must include flag 0x2 to enable
	// TCP_FASTOPEN.
	// See `ip-sysctl.txt <https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt>`_.
	//
	// On macOS, only values of 0, 1, and unset are valid; other values may result in an error.
	// To set the queue length on macOS, set the net.inet.tcp.fastopen_backlog kernel parameter.
	TcpFastOpenQueueLength *wrapperspb.UInt32Value `` /* 134-byte string literal not displayed */
	// Specifies the intended direction of the traffic relative to the local Envoy.
	// This property is required on Windows for listeners using the original destination filter,
	// see :ref:`Original Destination <config_listener_filters_original_dst>`.
	TrafficDirection v3.TrafficDirection `` /* 154-byte string literal not displayed */
	// If the protocol in the listener socket address in :ref:`protocol
	// <envoy_v3_api_field_config.core.v3.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_v3_api_enum_value_config.core.v3.SocketAddress.Protocol.UDP>`, this field specifies UDP
	// listener specific configuration.
	UdpListenerConfig *UdpListenerConfig `protobuf:"bytes,18,opt,name=udp_listener_config,json=udpListenerConfig,proto3" json:"udp_listener_config,omitempty"`
	// Used to represent an API listener, which is used in non-proxy clients. The type of API
	// exposed to the non-proxy application depends on the type of API listener.
	// When this field is set, no other field except for :ref:`name<envoy_v3_api_field_config.listener.v3.Listener.name>`
	// should be set.
	//
	// .. note::
	//
	//	Currently only one ApiListener can be installed; and it can only be done via bootstrap config,
	//	not LDS.
	//
	// [#next-major-version: In the v3 API, instead of this messy approach where the socket
	// listener fields are directly in the top-level Listener message and the API listener types
	// are in the ApiListener message, the socket listener messages should be in their own message,
	// and the top-level Listener should essentially be a oneof that selects between the
	// socket listener and the various types of API listener. That way, a given Listener message
	// can structurally only contain the fields of the relevant type.]
	ApiListener *ApiListener `protobuf:"bytes,19,opt,name=api_listener,json=apiListener,proto3" json:"api_listener,omitempty"`
	// The listener's connection balancer configuration, currently only applicable to TCP listeners.
	// If no configuration is specified, Envoy will not attempt to balance active connections between
	// worker threads.
	//
	// In the scenario that the listener X redirects all the connections to the listeners Y1 and Y2
	// by setting :ref:`use_original_dst <envoy_v3_api_field_config.listener.v3.Listener.use_original_dst>` in X
	// and :ref:`bind_to_port <envoy_v3_api_field_config.listener.v3.Listener.bind_to_port>` to false in Y1 and Y2,
	// it is recommended to disable the balance config in listener X to avoid the cost of balancing, and
	// enable the balance config in Y1 and Y2 to balance the connections among the workers.
	ConnectionBalanceConfig *Listener_ConnectionBalanceConfig `` /* 133-byte string literal not displayed */
	// Deprecated. Use “enable_reuse_port“ instead.
	//
	// Deprecated: Marked as deprecated in envoy/config/listener/v3/listener.proto.
	ReusePort bool `protobuf:"varint,21,opt,name=reuse_port,json=reusePort,proto3" json:"reuse_port,omitempty"`
	// When this flag is set to true, listeners set the “SO_REUSEPORT“ socket option and
	// create one socket for each worker thread. This makes inbound connections
	// distribute among worker threads roughly evenly in cases where there are a high number
	// of connections. When this flag is set to false, all worker threads share one socket. This field
	// defaults to true. The change of field will be rejected during an listener update when the
	// runtime flag “envoy.reloadable_features.enable_update_listener_socket_options“ is enabled.
	// Otherwise, the update of this field will be ignored quietly.
	//
	// .. attention::
	//
	//	Although this field defaults to true, it has different behavior on different platforms. See
	//	the following text for more information.
	//
	//   - On Linux, reuse_port is respected for both TCP and UDP listeners. It also works correctly
	//     with hot restart.
	//   - On macOS, reuse_port for TCP does not do what it does on Linux. Instead of load balancing,
	//     the last socket wins and receives all connections/packets. For TCP, reuse_port is force
	//     disabled and the user is warned. For UDP, it is enabled, but only one worker will receive
	//     packets. For QUIC/H3, SW routing will send packets to other workers. For "raw" UDP, only
	//     a single worker will currently receive packets.
	//   - On Windows, reuse_port for TCP has undefined behavior. It is force disabled and the user
	//     is warned similar to macOS. It is left enabled for UDP with undefined behavior currently.
	EnableReusePort *wrapperspb.BoolValue `protobuf:"bytes,29,opt,name=enable_reuse_port,json=enableReusePort,proto3" json:"enable_reuse_port,omitempty"`
	// Configuration for :ref:`access logs <arch_overview_access_logs>`
	// emitted by this listener.
	AccessLog []*v33.AccessLog `protobuf:"bytes,22,rep,name=access_log,json=accessLog,proto3" json:"access_log,omitempty"`
	// The maximum length a tcp listener's pending connections queue can grow to. If no value is
	// provided net.core.somaxconn will be used on Linux and 128 otherwise.
	TcpBacklogSize *wrapperspb.UInt32Value `protobuf:"bytes,24,opt,name=tcp_backlog_size,json=tcpBacklogSize,proto3" json:"tcp_backlog_size,omitempty"`
	// The maximum number of connections to accept from the kernel per socket
	// event. Envoy may decide to close these connections after accepting them
	// from the kernel e.g. due to load shedding, or other policies.
	// If there are more than max_connections_to_accept_per_socket_event
	// connections pending accept, connections over this threshold will be
	// accepted in later event loop iterations.
	// If no value is provided Envoy will accept all connections pending accept
	// from the kernel.
	MaxConnectionsToAcceptPerSocketEvent *wrapperspb.UInt32Value `` /* 180-byte string literal not displayed */
	// Whether the listener should bind to the port. A listener that doesn't
	// bind can only receive connections redirected from other listeners that set
	// :ref:`use_original_dst <envoy_v3_api_field_config.listener.v3.Listener.use_original_dst>`
	// to true. Default is true.
	BindToPort *wrapperspb.BoolValue `protobuf:"bytes,26,opt,name=bind_to_port,json=bindToPort,proto3" json:"bind_to_port,omitempty"`
	// The exclusive listener type and the corresponding config.
	//
	// Types that are assignable to ListenerSpecifier:
	//
	//	*Listener_InternalListener
	ListenerSpecifier isListener_ListenerSpecifier `protobuf_oneof:"listener_specifier"`
	// Enable MPTCP (multi-path TCP) on this listener. Clients will be allowed to establish
	// MPTCP connections. Non-MPTCP clients will fall back to regular TCP.
	EnableMptcp bool `protobuf:"varint,30,opt,name=enable_mptcp,json=enableMptcp,proto3" json:"enable_mptcp,omitempty"`
	// Whether the listener should limit connections based upon the value of
	// :ref:`global_downstream_max_connections <config_overload_manager_limiting_connections>`.
	IgnoreGlobalConnLimit bool `` /* 130-byte string literal not displayed */
	// Whether the listener bypasses configured overload manager actions.
	BypassOverloadManager bool `` /* 128-byte string literal not displayed */
	// contains filtered or unexported fields
}

[#next-free-field: 36]

func (*Listener) Descriptor deprecated

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

Deprecated: Use Listener.ProtoReflect.Descriptor instead.

func (*Listener) GetAccessLog added in v0.9.5

func (x *Listener) GetAccessLog() []*v33.AccessLog

func (*Listener) GetAdditionalAddresses added in v0.10.2

func (x *Listener) GetAdditionalAddresses() []*AdditionalAddress

func (*Listener) GetAddress

func (x *Listener) GetAddress() *v3.Address

func (*Listener) GetApiListener

func (x *Listener) GetApiListener() *ApiListener

func (*Listener) GetBindToPort added in v0.9.9

func (x *Listener) GetBindToPort() *wrapperspb.BoolValue

func (*Listener) GetBypassOverloadManager added in v0.13.0

func (x *Listener) GetBypassOverloadManager() bool

func (*Listener) GetConnectionBalanceConfig

func (x *Listener) GetConnectionBalanceConfig() *Listener_ConnectionBalanceConfig

func (*Listener) GetContinueOnListenerFiltersTimeout

func (x *Listener) GetContinueOnListenerFiltersTimeout() bool

func (*Listener) GetDefaultFilterChain added in v0.9.8

func (x *Listener) GetDefaultFilterChain() *FilterChain

func (*Listener) GetDeprecatedV1 deprecated

func (x *Listener) GetDeprecatedV1() *Listener_DeprecatedV1

Deprecated: Marked as deprecated in envoy/config/listener/v3/listener.proto.

func (*Listener) GetDrainType

func (x *Listener) GetDrainType() Listener_DrainType

func (*Listener) GetEnableMptcp added in v0.10.1

func (x *Listener) GetEnableMptcp() bool

func (*Listener) GetEnableReusePort added in v0.10.0

func (x *Listener) GetEnableReusePort() *wrapperspb.BoolValue

func (*Listener) GetFilterChainMatcher added in v0.10.2

func (x *Listener) GetFilterChainMatcher() *v32.Matcher

func (*Listener) GetFilterChains

func (x *Listener) GetFilterChains() []*FilterChain

func (*Listener) GetFreebind

func (x *Listener) GetFreebind() *wrapperspb.BoolValue

func (*Listener) GetIgnoreGlobalConnLimit added in v0.10.2

func (x *Listener) GetIgnoreGlobalConnLimit() bool

func (*Listener) GetInternalListener added in v0.9.9

func (x *Listener) GetInternalListener() *Listener_InternalListenerConfig

func (*Listener) GetListenerFilters

func (x *Listener) GetListenerFilters() []*ListenerFilter

func (*Listener) GetListenerFiltersTimeout

func (x *Listener) GetListenerFiltersTimeout() *durationpb.Duration

func (*Listener) GetListenerSpecifier added in v0.9.9

func (m *Listener) GetListenerSpecifier() isListener_ListenerSpecifier

func (*Listener) GetMaxConnectionsToAcceptPerSocketEvent added in v0.12.0

func (x *Listener) GetMaxConnectionsToAcceptPerSocketEvent() *wrapperspb.UInt32Value

func (*Listener) GetMetadata

func (x *Listener) GetMetadata() *v3.Metadata

func (*Listener) GetName

func (x *Listener) GetName() string

func (*Listener) GetPerConnectionBufferLimitBytes

func (x *Listener) GetPerConnectionBufferLimitBytes() *wrapperspb.UInt32Value

func (*Listener) GetReusePort deprecated

func (x *Listener) GetReusePort() bool

Deprecated: Marked as deprecated in envoy/config/listener/v3/listener.proto.

func (*Listener) GetSocketOptions

func (x *Listener) GetSocketOptions() []*v3.SocketOption

func (*Listener) GetStatPrefix added in v0.9.9

func (x *Listener) GetStatPrefix() string

func (*Listener) GetTcpBacklogSize added in v0.9.7

func (x *Listener) GetTcpBacklogSize() *wrapperspb.UInt32Value

func (*Listener) GetTcpFastOpenQueueLength

func (x *Listener) GetTcpFastOpenQueueLength() *wrapperspb.UInt32Value

func (*Listener) GetTrafficDirection

func (x *Listener) GetTrafficDirection() v3.TrafficDirection

func (*Listener) GetTransparent

func (x *Listener) GetTransparent() *wrapperspb.BoolValue

func (*Listener) GetUdpListenerConfig

func (x *Listener) GetUdpListenerConfig() *UdpListenerConfig

func (*Listener) GetUseOriginalDst added in v0.9.9

func (x *Listener) GetUseOriginalDst() *wrapperspb.BoolValue

func (*Listener) ProtoMessage

func (*Listener) ProtoMessage()

func (*Listener) ProtoReflect added in v0.9.6

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

func (*Listener) Reset

func (x *Listener) Reset()

func (*Listener) String

func (x *Listener) String() string

func (*Listener) Validate

func (m *Listener) Validate() error

Validate checks the field values on Listener 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 (*Listener) ValidateAll added in v0.10.0

func (m *Listener) ValidateAll() error

ValidateAll checks the field values on Listener 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 ListenerMultiError, or nil if none found.

type ListenerCollection added in v0.9.6

type ListenerCollection struct {
	Entries []*v31.CollectionEntry `protobuf:"bytes,1,rep,name=entries,proto3" json:"entries,omitempty"`
	// contains filtered or unexported fields
}

Listener list collections. Entries are “Listener“ resources or references. [#not-implemented-hide:]

func (*ListenerCollection) Descriptor deprecated added in v0.9.6

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

Deprecated: Use ListenerCollection.ProtoReflect.Descriptor instead.

func (*ListenerCollection) GetEntries added in v0.9.6

func (x *ListenerCollection) GetEntries() []*v31.CollectionEntry

func (*ListenerCollection) ProtoMessage added in v0.9.6

func (*ListenerCollection) ProtoMessage()

func (*ListenerCollection) ProtoReflect added in v0.9.6

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

func (*ListenerCollection) Reset added in v0.9.6

func (x *ListenerCollection) Reset()

func (*ListenerCollection) String added in v0.9.6

func (x *ListenerCollection) String() string

func (*ListenerCollection) Validate added in v0.9.6

func (m *ListenerCollection) Validate() error

Validate checks the field values on ListenerCollection 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 (*ListenerCollection) ValidateAll added in v0.10.0

func (m *ListenerCollection) ValidateAll() error

ValidateAll checks the field values on ListenerCollection 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 ListenerCollectionMultiError, or nil if none found.

type ListenerCollectionMultiError added in v0.10.0

type ListenerCollectionMultiError []error

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

func (ListenerCollectionMultiError) AllErrors added in v0.10.0

func (m ListenerCollectionMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ListenerCollectionMultiError) Error added in v0.10.0

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

type ListenerCollectionValidationError added in v0.9.6

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

ListenerCollectionValidationError is the validation error returned by ListenerCollection.Validate if the designated constraints aren't met.

func (ListenerCollectionValidationError) Cause added in v0.9.6

Cause function returns cause value.

func (ListenerCollectionValidationError) Error added in v0.9.6

Error satisfies the builtin error interface

func (ListenerCollectionValidationError) ErrorName added in v0.9.6

ErrorName returns error name.

func (ListenerCollectionValidationError) Field added in v0.9.6

Field function returns field value.

func (ListenerCollectionValidationError) Key added in v0.9.6

Key function returns key value.

func (ListenerCollectionValidationError) Reason added in v0.9.6

Reason function returns reason value.

type ListenerFilter

type ListenerFilter struct {

	// The name of the filter configuration.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Types that are assignable to ConfigType:
	//
	//	*ListenerFilter_TypedConfig
	//	*ListenerFilter_ConfigDiscovery
	ConfigType isListenerFilter_ConfigType `protobuf_oneof:"config_type"`
	// Optional match predicate used to disable the filter. The filter is enabled when this field is empty.
	// See :ref:`ListenerFilterChainMatchPredicate <envoy_v3_api_msg_config.listener.v3.ListenerFilterChainMatchPredicate>`
	// for further examples.
	FilterDisabled *ListenerFilterChainMatchPredicate `protobuf:"bytes,4,opt,name=filter_disabled,json=filterDisabled,proto3" json:"filter_disabled,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 6]

func (*ListenerFilter) Descriptor deprecated

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

Deprecated: Use ListenerFilter.ProtoReflect.Descriptor instead.

func (*ListenerFilter) GetConfigDiscovery added in v0.10.2

func (x *ListenerFilter) GetConfigDiscovery() *v3.ExtensionConfigSource

func (*ListenerFilter) GetConfigType

func (m *ListenerFilter) GetConfigType() isListenerFilter_ConfigType

func (*ListenerFilter) GetFilterDisabled

func (x *ListenerFilter) GetFilterDisabled() *ListenerFilterChainMatchPredicate

func (*ListenerFilter) GetName

func (x *ListenerFilter) GetName() string

func (*ListenerFilter) GetTypedConfig

func (x *ListenerFilter) GetTypedConfig() *anypb.Any

func (*ListenerFilter) ProtoMessage

func (*ListenerFilter) ProtoMessage()

func (*ListenerFilter) ProtoReflect added in v0.9.6

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

func (*ListenerFilter) Reset

func (x *ListenerFilter) Reset()

func (*ListenerFilter) String

func (x *ListenerFilter) String() string

func (*ListenerFilter) Validate

func (m *ListenerFilter) Validate() error

Validate checks the field values on ListenerFilter 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 (*ListenerFilter) ValidateAll added in v0.10.0

func (m *ListenerFilter) ValidateAll() error

ValidateAll checks the field values on ListenerFilter 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 ListenerFilterMultiError, or nil if none found.

type ListenerFilterChainMatchPredicate

type ListenerFilterChainMatchPredicate struct {

	// Types that are assignable to Rule:
	//
	//	*ListenerFilterChainMatchPredicate_OrMatch
	//	*ListenerFilterChainMatchPredicate_AndMatch
	//	*ListenerFilterChainMatchPredicate_NotMatch
	//	*ListenerFilterChainMatchPredicate_AnyMatch
	//	*ListenerFilterChainMatchPredicate_DestinationPortRange
	Rule isListenerFilterChainMatchPredicate_Rule `protobuf_oneof:"rule"`
	// contains filtered or unexported fields
}

Listener filter chain match configuration. This is a recursive structure which allows complex nested match configurations to be built using various logical operators.

Examples:

* Matches if the destination port is 3306.

.. code-block:: yaml

destination_port_range:
 start: 3306
 end: 3307

* Matches if the destination port is 3306 or 15000.

.. code-block:: yaml

or_match:
  rules:
    - destination_port_range:
        start: 3306
        end: 3307
    - destination_port_range:
        start: 15000
        end: 15001

[#next-free-field: 6]

func (*ListenerFilterChainMatchPredicate) Descriptor deprecated

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

Deprecated: Use ListenerFilterChainMatchPredicate.ProtoReflect.Descriptor instead.

func (*ListenerFilterChainMatchPredicate) GetAndMatch

func (*ListenerFilterChainMatchPredicate) GetAnyMatch

func (x *ListenerFilterChainMatchPredicate) GetAnyMatch() bool

func (*ListenerFilterChainMatchPredicate) GetDestinationPortRange

func (x *ListenerFilterChainMatchPredicate) GetDestinationPortRange() *v31.Int32Range

func (*ListenerFilterChainMatchPredicate) GetNotMatch

func (*ListenerFilterChainMatchPredicate) GetOrMatch

func (*ListenerFilterChainMatchPredicate) GetRule

func (m *ListenerFilterChainMatchPredicate) GetRule() isListenerFilterChainMatchPredicate_Rule

func (*ListenerFilterChainMatchPredicate) ProtoMessage

func (*ListenerFilterChainMatchPredicate) ProtoMessage()

func (*ListenerFilterChainMatchPredicate) ProtoReflect added in v0.9.6

func (*ListenerFilterChainMatchPredicate) Reset

func (*ListenerFilterChainMatchPredicate) String

func (*ListenerFilterChainMatchPredicate) Validate

Validate checks the field values on ListenerFilterChainMatchPredicate 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 (*ListenerFilterChainMatchPredicate) ValidateAll added in v0.10.0

func (m *ListenerFilterChainMatchPredicate) ValidateAll() error

ValidateAll checks the field values on ListenerFilterChainMatchPredicate 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 ListenerFilterChainMatchPredicateMultiError, or nil if none found.

type ListenerFilterChainMatchPredicateMultiError added in v0.10.0

type ListenerFilterChainMatchPredicateMultiError []error

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

func (ListenerFilterChainMatchPredicateMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (ListenerFilterChainMatchPredicateMultiError) Error added in v0.10.0

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

type ListenerFilterChainMatchPredicateValidationError

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

ListenerFilterChainMatchPredicateValidationError is the validation error returned by ListenerFilterChainMatchPredicate.Validate if the designated constraints aren't met.

func (ListenerFilterChainMatchPredicateValidationError) Cause

Cause function returns cause value.

func (ListenerFilterChainMatchPredicateValidationError) Error

Error satisfies the builtin error interface

func (ListenerFilterChainMatchPredicateValidationError) ErrorName

ErrorName returns error name.

func (ListenerFilterChainMatchPredicateValidationError) Field

Field function returns field value.

func (ListenerFilterChainMatchPredicateValidationError) Key

Key function returns key value.

func (ListenerFilterChainMatchPredicateValidationError) Reason

Reason function returns reason value.

type ListenerFilterChainMatchPredicate_AndMatch

type ListenerFilterChainMatchPredicate_AndMatch struct {
	// A set that describes a logical AND. If all members of the set match, the match configuration
	// matches.
	AndMatch *ListenerFilterChainMatchPredicate_MatchSet `protobuf:"bytes,2,opt,name=and_match,json=andMatch,proto3,oneof"`
}

type ListenerFilterChainMatchPredicate_AnyMatch

type ListenerFilterChainMatchPredicate_AnyMatch struct {
	// The match configuration will always match.
	AnyMatch bool `protobuf:"varint,4,opt,name=any_match,json=anyMatch,proto3,oneof"`
}

type ListenerFilterChainMatchPredicate_DestinationPortRange

type ListenerFilterChainMatchPredicate_DestinationPortRange struct {
	// Match destination port. Particularly, the match evaluation must use the recovered local port if
	// the owning listener filter is after :ref:`an original_dst listener filter <config_listener_filters_original_dst>`.
	DestinationPortRange *v31.Int32Range `protobuf:"bytes,5,opt,name=destination_port_range,json=destinationPortRange,proto3,oneof"`
}

type ListenerFilterChainMatchPredicate_MatchSet

type ListenerFilterChainMatchPredicate_MatchSet struct {

	// The list of rules that make up the set.
	Rules []*ListenerFilterChainMatchPredicate `protobuf:"bytes,1,rep,name=rules,proto3" json:"rules,omitempty"`
	// contains filtered or unexported fields
}

A set of match configurations used for logical operations.

func (*ListenerFilterChainMatchPredicate_MatchSet) Descriptor deprecated

Deprecated: Use ListenerFilterChainMatchPredicate_MatchSet.ProtoReflect.Descriptor instead.

func (*ListenerFilterChainMatchPredicate_MatchSet) GetRules

func (*ListenerFilterChainMatchPredicate_MatchSet) ProtoMessage

func (*ListenerFilterChainMatchPredicate_MatchSet) ProtoReflect added in v0.9.6

func (*ListenerFilterChainMatchPredicate_MatchSet) Reset

func (*ListenerFilterChainMatchPredicate_MatchSet) String

func (*ListenerFilterChainMatchPredicate_MatchSet) Validate

Validate checks the field values on ListenerFilterChainMatchPredicate_MatchSet 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 (*ListenerFilterChainMatchPredicate_MatchSet) ValidateAll added in v0.10.0

ValidateAll checks the field values on ListenerFilterChainMatchPredicate_MatchSet 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 ListenerFilterChainMatchPredicate_MatchSetMultiError, or nil if none found.

type ListenerFilterChainMatchPredicate_MatchSetMultiError added in v0.10.0

type ListenerFilterChainMatchPredicate_MatchSetMultiError []error

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

func (ListenerFilterChainMatchPredicate_MatchSetMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (ListenerFilterChainMatchPredicate_MatchSetMultiError) Error added in v0.10.0

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

type ListenerFilterChainMatchPredicate_MatchSetValidationError

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

ListenerFilterChainMatchPredicate_MatchSetValidationError is the validation error returned by ListenerFilterChainMatchPredicate_MatchSet.Validate if the designated constraints aren't met.

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) Cause

Cause function returns cause value.

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) Error

Error satisfies the builtin error interface

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) ErrorName

ErrorName returns error name.

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) Field

Field function returns field value.

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) Key

Key function returns key value.

func (ListenerFilterChainMatchPredicate_MatchSetValidationError) Reason

Reason function returns reason value.

type ListenerFilterChainMatchPredicate_NotMatch

type ListenerFilterChainMatchPredicate_NotMatch struct {
	// A negation match. The match configuration will match if the negated match condition matches.
	NotMatch *ListenerFilterChainMatchPredicate `protobuf:"bytes,3,opt,name=not_match,json=notMatch,proto3,oneof"`
}

type ListenerFilterChainMatchPredicate_OrMatch

type ListenerFilterChainMatchPredicate_OrMatch struct {
	// A set that describes a logical OR. If any member of the set matches, the match configuration
	// matches.
	OrMatch *ListenerFilterChainMatchPredicate_MatchSet `protobuf:"bytes,1,opt,name=or_match,json=orMatch,proto3,oneof"`
}

type ListenerFilterMultiError added in v0.10.0

type ListenerFilterMultiError []error

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

func (ListenerFilterMultiError) AllErrors added in v0.10.0

func (m ListenerFilterMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ListenerFilterMultiError) Error added in v0.10.0

func (m ListenerFilterMultiError) Error() string

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

type ListenerFilterValidationError

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

ListenerFilterValidationError is the validation error returned by ListenerFilter.Validate if the designated constraints aren't met.

func (ListenerFilterValidationError) Cause

Cause function returns cause value.

func (ListenerFilterValidationError) Error

Error satisfies the builtin error interface

func (ListenerFilterValidationError) ErrorName

func (e ListenerFilterValidationError) ErrorName() string

ErrorName returns error name.

func (ListenerFilterValidationError) Field

Field function returns field value.

func (ListenerFilterValidationError) Key

Key function returns key value.

func (ListenerFilterValidationError) Reason

Reason function returns reason value.

type ListenerFilter_ConfigDiscovery added in v0.10.2

type ListenerFilter_ConfigDiscovery struct {
	// Configuration source specifier for an extension configuration discovery
	// service. In case of a failure and without the default configuration, the
	// listener closes the connections.
	ConfigDiscovery *v3.ExtensionConfigSource `protobuf:"bytes,5,opt,name=config_discovery,json=configDiscovery,proto3,oneof"`
}

type ListenerFilter_TypedConfig

type ListenerFilter_TypedConfig struct {
	// Filter specific configuration which depends on the filter being
	// instantiated. See the supported filters for further documentation.
	// [#extension-category: envoy.filters.listener,envoy.filters.udp_listener]
	TypedConfig *anypb.Any `protobuf:"bytes,3,opt,name=typed_config,json=typedConfig,proto3,oneof"`
}

type ListenerManager added in v0.11.0

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

A placeholder proto so that users can explicitly configure the standard Listener Manager via the bootstrap's :ref:`listener_manager <envoy_v3_api_field_config.bootstrap.v3.Bootstrap.listener_manager>`. [#not-implemented-hide:]

func (*ListenerManager) Descriptor deprecated added in v0.11.0

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

Deprecated: Use ListenerManager.ProtoReflect.Descriptor instead.

func (*ListenerManager) ProtoMessage added in v0.11.0

func (*ListenerManager) ProtoMessage()

func (*ListenerManager) ProtoReflect added in v0.11.0

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

func (*ListenerManager) Reset added in v0.11.0

func (x *ListenerManager) Reset()

func (*ListenerManager) String added in v0.11.0

func (x *ListenerManager) String() string

func (*ListenerManager) Validate added in v0.11.0

func (m *ListenerManager) Validate() error

Validate checks the field values on ListenerManager 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 (*ListenerManager) ValidateAll added in v0.11.0

func (m *ListenerManager) ValidateAll() error

ValidateAll checks the field values on ListenerManager 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 ListenerManagerMultiError, or nil if none found.

type ListenerManagerMultiError added in v0.11.0

type ListenerManagerMultiError []error

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

func (ListenerManagerMultiError) AllErrors added in v0.11.0

func (m ListenerManagerMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ListenerManagerMultiError) Error added in v0.11.0

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

type ListenerManagerValidationError added in v0.11.0

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

ListenerManagerValidationError is the validation error returned by ListenerManager.Validate if the designated constraints aren't met.

func (ListenerManagerValidationError) Cause added in v0.11.0

Cause function returns cause value.

func (ListenerManagerValidationError) Error added in v0.11.0

Error satisfies the builtin error interface

func (ListenerManagerValidationError) ErrorName added in v0.11.0

func (e ListenerManagerValidationError) ErrorName() string

ErrorName returns error name.

func (ListenerManagerValidationError) Field added in v0.11.0

Field function returns field value.

func (ListenerManagerValidationError) Key added in v0.11.0

Key function returns key value.

func (ListenerManagerValidationError) Reason added in v0.11.0

Reason function returns reason value.

type ListenerMultiError added in v0.10.0

type ListenerMultiError []error

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

func (ListenerMultiError) AllErrors added in v0.10.0

func (m ListenerMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (ListenerMultiError) Error added in v0.10.0

func (m ListenerMultiError) Error() string

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

type ListenerValidationError

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

ListenerValidationError is the validation error returned by Listener.Validate if the designated constraints aren't met.

func (ListenerValidationError) Cause

func (e ListenerValidationError) Cause() error

Cause function returns cause value.

func (ListenerValidationError) Error

func (e ListenerValidationError) Error() string

Error satisfies the builtin error interface

func (ListenerValidationError) ErrorName

func (e ListenerValidationError) ErrorName() string

ErrorName returns error name.

func (ListenerValidationError) Field

func (e ListenerValidationError) Field() string

Field function returns field value.

func (ListenerValidationError) Key

func (e ListenerValidationError) Key() bool

Key function returns key value.

func (ListenerValidationError) Reason

func (e ListenerValidationError) Reason() string

Reason function returns reason value.

type Listener_ConnectionBalanceConfig

type Listener_ConnectionBalanceConfig struct {

	// Types that are assignable to BalanceType:
	//
	//	*Listener_ConnectionBalanceConfig_ExactBalance_
	//	*Listener_ConnectionBalanceConfig_ExtendBalance
	BalanceType isListener_ConnectionBalanceConfig_BalanceType `protobuf_oneof:"balance_type"`
	// contains filtered or unexported fields
}

Configuration for listener connection balancing.

func (*Listener_ConnectionBalanceConfig) Descriptor deprecated

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

Deprecated: Use Listener_ConnectionBalanceConfig.ProtoReflect.Descriptor instead.

func (*Listener_ConnectionBalanceConfig) GetBalanceType

func (m *Listener_ConnectionBalanceConfig) GetBalanceType() isListener_ConnectionBalanceConfig_BalanceType

func (*Listener_ConnectionBalanceConfig) GetExactBalance

func (*Listener_ConnectionBalanceConfig) GetExtendBalance added in v0.10.2

func (*Listener_ConnectionBalanceConfig) ProtoMessage

func (*Listener_ConnectionBalanceConfig) ProtoMessage()

func (*Listener_ConnectionBalanceConfig) ProtoReflect added in v0.9.6

func (*Listener_ConnectionBalanceConfig) Reset

func (*Listener_ConnectionBalanceConfig) String

func (*Listener_ConnectionBalanceConfig) Validate

Validate checks the field values on Listener_ConnectionBalanceConfig 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 (*Listener_ConnectionBalanceConfig) ValidateAll added in v0.10.0

func (m *Listener_ConnectionBalanceConfig) ValidateAll() error

ValidateAll checks the field values on Listener_ConnectionBalanceConfig 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 Listener_ConnectionBalanceConfigMultiError, or nil if none found.

type Listener_ConnectionBalanceConfigMultiError added in v0.10.0

type Listener_ConnectionBalanceConfigMultiError []error

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

func (Listener_ConnectionBalanceConfigMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (Listener_ConnectionBalanceConfigMultiError) Error added in v0.10.0

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

type Listener_ConnectionBalanceConfigValidationError

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

Listener_ConnectionBalanceConfigValidationError is the validation error returned by Listener_ConnectionBalanceConfig.Validate if the designated constraints aren't met.

func (Listener_ConnectionBalanceConfigValidationError) Cause

Cause function returns cause value.

func (Listener_ConnectionBalanceConfigValidationError) Error

Error satisfies the builtin error interface

func (Listener_ConnectionBalanceConfigValidationError) ErrorName

ErrorName returns error name.

func (Listener_ConnectionBalanceConfigValidationError) Field

Field function returns field value.

func (Listener_ConnectionBalanceConfigValidationError) Key

Key function returns key value.

func (Listener_ConnectionBalanceConfigValidationError) Reason

Reason function returns reason value.

type Listener_ConnectionBalanceConfig_ExactBalance

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

A connection balancer implementation that does exact balancing. This means that a lock is held during balancing so that connection counts are nearly exactly balanced between worker threads. This is "nearly" exact in the sense that a connection might close in parallel thus making the counts incorrect, but this should be rectified on the next accept. This balancer sacrifices accept throughput for accuracy and should be used when there are a small number of connections that rarely cycle (e.g., service mesh gRPC egress).

func (*Listener_ConnectionBalanceConfig_ExactBalance) Descriptor deprecated

Deprecated: Use Listener_ConnectionBalanceConfig_ExactBalance.ProtoReflect.Descriptor instead.

func (*Listener_ConnectionBalanceConfig_ExactBalance) ProtoMessage

func (*Listener_ConnectionBalanceConfig_ExactBalance) ProtoReflect added in v0.9.6

func (*Listener_ConnectionBalanceConfig_ExactBalance) Reset

func (*Listener_ConnectionBalanceConfig_ExactBalance) String

func (*Listener_ConnectionBalanceConfig_ExactBalance) Validate

Validate checks the field values on Listener_ConnectionBalanceConfig_ExactBalance 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 (*Listener_ConnectionBalanceConfig_ExactBalance) ValidateAll added in v0.10.0

ValidateAll checks the field values on Listener_ConnectionBalanceConfig_ExactBalance 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 Listener_ConnectionBalanceConfig_ExactBalanceMultiError, or nil if none found.

type Listener_ConnectionBalanceConfig_ExactBalanceMultiError added in v0.10.0

type Listener_ConnectionBalanceConfig_ExactBalanceMultiError []error

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

func (Listener_ConnectionBalanceConfig_ExactBalanceMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (Listener_ConnectionBalanceConfig_ExactBalanceMultiError) Error added in v0.10.0

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

type Listener_ConnectionBalanceConfig_ExactBalanceValidationError

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

Listener_ConnectionBalanceConfig_ExactBalanceValidationError is the validation error returned by Listener_ConnectionBalanceConfig_ExactBalance.Validate if the designated constraints aren't met.

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) Cause

Cause function returns cause value.

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) Error

Error satisfies the builtin error interface

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) ErrorName

ErrorName returns error name.

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) Field

Field function returns field value.

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) Key

Key function returns key value.

func (Listener_ConnectionBalanceConfig_ExactBalanceValidationError) Reason

Reason function returns reason value.

type Listener_ConnectionBalanceConfig_ExactBalance_

type Listener_ConnectionBalanceConfig_ExactBalance_ struct {
	// If specified, the listener will use the exact connection balancer.
	ExactBalance *Listener_ConnectionBalanceConfig_ExactBalance `protobuf:"bytes,1,opt,name=exact_balance,json=exactBalance,proto3,oneof"`
}

type Listener_ConnectionBalanceConfig_ExtendBalance added in v0.10.2

type Listener_ConnectionBalanceConfig_ExtendBalance struct {
	// The listener will use the connection balancer according to “type_url“. If “type_url“ is invalid,
	// Envoy will not attempt to balance active connections between worker threads.
	// [#extension-category: envoy.network.connection_balance]
	ExtendBalance *v3.TypedExtensionConfig `protobuf:"bytes,2,opt,name=extend_balance,json=extendBalance,proto3,oneof"`
}

type Listener_DeprecatedV1

type Listener_DeprecatedV1 struct {

	// Whether the listener should bind to the port. A listener that doesn't
	// bind can only receive connections redirected from other listeners that
	// set use_original_dst parameter to true. Default is true.
	//
	// This is deprecated. Use :ref:`Listener.bind_to_port
	// <envoy_v3_api_field_config.listener.v3.Listener.bind_to_port>`
	BindToPort *wrapperspb.BoolValue `protobuf:"bytes,1,opt,name=bind_to_port,json=bindToPort,proto3" json:"bind_to_port,omitempty"`
	// contains filtered or unexported fields
}

[#not-implemented-hide:]

func (*Listener_DeprecatedV1) Descriptor deprecated

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

Deprecated: Use Listener_DeprecatedV1.ProtoReflect.Descriptor instead.

func (*Listener_DeprecatedV1) GetBindToPort

func (x *Listener_DeprecatedV1) GetBindToPort() *wrapperspb.BoolValue

func (*Listener_DeprecatedV1) ProtoMessage

func (*Listener_DeprecatedV1) ProtoMessage()

func (*Listener_DeprecatedV1) ProtoReflect added in v0.9.6

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

func (*Listener_DeprecatedV1) Reset

func (x *Listener_DeprecatedV1) Reset()

func (*Listener_DeprecatedV1) String

func (x *Listener_DeprecatedV1) String() string

func (*Listener_DeprecatedV1) Validate

func (m *Listener_DeprecatedV1) Validate() error

Validate checks the field values on Listener_DeprecatedV1 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 (*Listener_DeprecatedV1) ValidateAll added in v0.10.0

func (m *Listener_DeprecatedV1) ValidateAll() error

ValidateAll checks the field values on Listener_DeprecatedV1 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 Listener_DeprecatedV1MultiError, or nil if none found.

type Listener_DeprecatedV1MultiError added in v0.10.0

type Listener_DeprecatedV1MultiError []error

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

func (Listener_DeprecatedV1MultiError) AllErrors added in v0.10.0

func (m Listener_DeprecatedV1MultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (Listener_DeprecatedV1MultiError) Error added in v0.10.0

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

type Listener_DeprecatedV1ValidationError

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

Listener_DeprecatedV1ValidationError is the validation error returned by Listener_DeprecatedV1.Validate if the designated constraints aren't met.

func (Listener_DeprecatedV1ValidationError) Cause

Cause function returns cause value.

func (Listener_DeprecatedV1ValidationError) Error

Error satisfies the builtin error interface

func (Listener_DeprecatedV1ValidationError) ErrorName

ErrorName returns error name.

func (Listener_DeprecatedV1ValidationError) Field

Field function returns field value.

func (Listener_DeprecatedV1ValidationError) Key

Key function returns key value.

func (Listener_DeprecatedV1ValidationError) Reason

Reason function returns reason value.

type Listener_DrainType

type Listener_DrainType int32
const (
	// Drain in response to calling /healthcheck/fail admin endpoint (along with the health check
	// filter), listener removal/modification, and hot restart.
	Listener_DEFAULT Listener_DrainType = 0
	// Drain in response to listener removal/modification and hot restart. This setting does not
	// include /healthcheck/fail. This setting may be desirable if Envoy is hosting both ingress
	// and egress listeners.
	Listener_MODIFY_ONLY Listener_DrainType = 1
)

func (Listener_DrainType) Descriptor added in v0.9.6

func (Listener_DrainType) Enum added in v0.9.6

func (Listener_DrainType) EnumDescriptor deprecated

func (Listener_DrainType) EnumDescriptor() ([]byte, []int)

Deprecated: Use Listener_DrainType.Descriptor instead.

func (Listener_DrainType) Number added in v0.9.6

func (Listener_DrainType) String

func (x Listener_DrainType) String() string

func (Listener_DrainType) Type added in v0.9.6

type Listener_InternalListener added in v0.9.9

type Listener_InternalListener struct {
	// Used to represent an internal listener which does not listen on OSI L4 address but can be used by the
	// :ref:`envoy cluster <envoy_v3_api_msg_config.cluster.v3.Cluster>` to create a user space connection to.
	// The internal listener acts as a TCP listener. It supports listener filters and network filter chains.
	// Upstream clusters refer to the internal listeners by their :ref:`name
	// <envoy_v3_api_field_config.listener.v3.Listener.name>`. :ref:`Address
	// <envoy_v3_api_field_config.listener.v3.Listener.address>` must not be set on the internal listeners.
	//
	// There are some limitations that are derived from the implementation. The known limitations include:
	//
	//   - :ref:`ConnectionBalanceConfig <envoy_v3_api_msg_config.listener.v3.Listener.ConnectionBalanceConfig>` is not
	//     allowed because both the cluster connection and the listener connection must be owned by the same dispatcher.
	//   - :ref:`tcp_backlog_size <envoy_v3_api_field_config.listener.v3.Listener.tcp_backlog_size>`
	//   - :ref:`freebind <envoy_v3_api_field_config.listener.v3.Listener.freebind>`
	//   - :ref:`transparent <envoy_v3_api_field_config.listener.v3.Listener.transparent>`
	InternalListener *Listener_InternalListenerConfig `protobuf:"bytes,27,opt,name=internal_listener,json=internalListener,proto3,oneof"`
}

type Listener_InternalListenerConfig added in v0.9.9

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

Configuration for envoy internal listener. All the future internal listener features should be added here.

func (*Listener_InternalListenerConfig) Descriptor deprecated added in v0.9.9

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

Deprecated: Use Listener_InternalListenerConfig.ProtoReflect.Descriptor instead.

func (*Listener_InternalListenerConfig) ProtoMessage added in v0.9.9

func (*Listener_InternalListenerConfig) ProtoMessage()

func (*Listener_InternalListenerConfig) ProtoReflect added in v0.9.9

func (*Listener_InternalListenerConfig) Reset added in v0.9.9

func (*Listener_InternalListenerConfig) String added in v0.9.9

func (*Listener_InternalListenerConfig) Validate added in v0.9.9

func (m *Listener_InternalListenerConfig) Validate() error

Validate checks the field values on Listener_InternalListenerConfig 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 (*Listener_InternalListenerConfig) ValidateAll added in v0.10.0

func (m *Listener_InternalListenerConfig) ValidateAll() error

ValidateAll checks the field values on Listener_InternalListenerConfig 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 Listener_InternalListenerConfigMultiError, or nil if none found.

type Listener_InternalListenerConfigMultiError added in v0.10.0

type Listener_InternalListenerConfigMultiError []error

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

func (Listener_InternalListenerConfigMultiError) AllErrors added in v0.10.0

AllErrors returns a list of validation violation errors.

func (Listener_InternalListenerConfigMultiError) Error added in v0.10.0

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

type Listener_InternalListenerConfigValidationError added in v0.9.9

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

Listener_InternalListenerConfigValidationError is the validation error returned by Listener_InternalListenerConfig.Validate if the designated constraints aren't met.

func (Listener_InternalListenerConfigValidationError) Cause added in v0.9.9

Cause function returns cause value.

func (Listener_InternalListenerConfigValidationError) Error added in v0.9.9

Error satisfies the builtin error interface

func (Listener_InternalListenerConfigValidationError) ErrorName added in v0.9.9

ErrorName returns error name.

func (Listener_InternalListenerConfigValidationError) Field added in v0.9.9

Field function returns field value.

func (Listener_InternalListenerConfigValidationError) Key added in v0.9.9

Key function returns key value.

func (Listener_InternalListenerConfigValidationError) Reason added in v0.9.9

Reason function returns reason value.

type QuicProtocolOptions

type QuicProtocolOptions struct {
	QuicProtocolOptions *v3.QuicProtocolOptions `protobuf:"bytes,1,opt,name=quic_protocol_options,json=quicProtocolOptions,proto3" json:"quic_protocol_options,omitempty"`
	// Maximum number of milliseconds that connection will be alive when there is
	// no network activity.
	//
	// If it is less than 1ms, Envoy will use 1ms. 300000ms if not specified.
	IdleTimeout *durationpb.Duration `protobuf:"bytes,2,opt,name=idle_timeout,json=idleTimeout,proto3" json:"idle_timeout,omitempty"`
	// Connection timeout in milliseconds before the crypto handshake is finished.
	//
	// If it is less than 5000ms, Envoy will use 5000ms. 20000ms if not specified.
	CryptoHandshakeTimeout *durationpb.Duration `` /* 129-byte string literal not displayed */
	// Runtime flag that controls whether the listener is enabled or not. If not specified, defaults
	// to enabled.
	Enabled *v3.RuntimeFeatureFlag `protobuf:"bytes,4,opt,name=enabled,proto3" json:"enabled,omitempty"`
	// A multiplier to number of connections which is used to determine how many packets to read per
	// event loop. A reasonable number should allow the listener to process enough payload but not
	// starve TCP and other UDP sockets and also prevent long event loop duration.
	// The default value is 32. This means if there are N QUIC connections, the total number of
	// packets to read in each read event will be 32 * N.
	// The actual number of packets to read in total by the UDP listener is also
	// bound by 6000, regardless of this field or how many connections there are.
	PacketsToReadToConnectionCountRatio *wrapperspb.UInt32Value `` /* 176-byte string literal not displayed */
	// Configure which implementation of “quic::QuicCryptoClientStreamBase“ to be used for this listener.
	// If not specified the :ref:`QUICHE default one configured by <envoy_v3_api_msg_extensions.quic.crypto_stream.v3.CryptoServerStreamConfig>` will be used.
	// [#extension-category: envoy.quic.server.crypto_stream]
	CryptoStreamConfig *v3.TypedExtensionConfig `protobuf:"bytes,6,opt,name=crypto_stream_config,json=cryptoStreamConfig,proto3" json:"crypto_stream_config,omitempty"`
	// Configure which implementation of “quic::ProofSource“ to be used for this listener.
	// If not specified the :ref:`default one configured by <envoy_v3_api_msg_extensions.quic.proof_source.v3.ProofSourceConfig>` will be used.
	// [#extension-category: envoy.quic.proof_source]
	ProofSourceConfig *v3.TypedExtensionConfig `protobuf:"bytes,7,opt,name=proof_source_config,json=proofSourceConfig,proto3" json:"proof_source_config,omitempty"`
	// Config which implementation of “quic::ConnectionIdGeneratorInterface“ to be used for this listener.
	// If not specified the :ref:`default one configured by <envoy_v3_api_msg_extensions.quic.connection_id_generator.v3.DeterministicConnectionIdGeneratorConfig>` will be used.
	// [#extension-category: envoy.quic.connection_id_generator]
	ConnectionIdGeneratorConfig *v3.TypedExtensionConfig `` /* 146-byte string literal not displayed */
	// Configure the server's preferred address to advertise so that client can migrate to it. See :ref:`example <envoy_v3_api_msg_extensions.quic.server_preferred_address.v3.FixedServerPreferredAddressConfig>` which configures a pair of v4 and v6 preferred addresses.
	// The current QUICHE implementation will advertise only one of the preferred IPv4 and IPv6 addresses based on the address family the client initially connects with.
	// If not specified, Envoy will not advertise any server's preferred address.
	// [#extension-category: envoy.quic.server_preferred_address]
	ServerPreferredAddressConfig *v3.TypedExtensionConfig `` /* 149-byte string literal not displayed */
	// Configure the server to send transport parameter `disable_active_migration <https://www.rfc-editor.org/rfc/rfc9000#section-18.2-4.30.1>`_.
	// Defaults to false (do not send this transport parameter).
	SendDisableActiveMigration *wrapperspb.BoolValue `` /* 144-byte string literal not displayed */
	// Configure which implementation of “quic::QuicConnectionDebugVisitor“ to be used for this listener.
	// If not specified, no debug visitor will be attached to connections.
	// [#extension-category: envoy.quic.connection_debug_visitor]
	ConnectionDebugVisitorConfig *v3.TypedExtensionConfig `` /* 150-byte string literal not displayed */
	// contains filtered or unexported fields
}

Configuration specific to the UDP QUIC listener. [#next-free-field: 12]

func (*QuicProtocolOptions) Descriptor deprecated

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

Deprecated: Use QuicProtocolOptions.ProtoReflect.Descriptor instead.

func (*QuicProtocolOptions) GetConnectionDebugVisitorConfig added in v0.13.0

func (x *QuicProtocolOptions) GetConnectionDebugVisitorConfig() *v3.TypedExtensionConfig

func (*QuicProtocolOptions) GetConnectionIdGeneratorConfig added in v0.11.0

func (x *QuicProtocolOptions) GetConnectionIdGeneratorConfig() *v3.TypedExtensionConfig

func (*QuicProtocolOptions) GetCryptoHandshakeTimeout

func (x *QuicProtocolOptions) GetCryptoHandshakeTimeout() *durationpb.Duration

func (*QuicProtocolOptions) GetCryptoStreamConfig added in v0.10.0

func (x *QuicProtocolOptions) GetCryptoStreamConfig() *v3.TypedExtensionConfig

func (*QuicProtocolOptions) GetEnabled added in v0.9.6

func (x *QuicProtocolOptions) GetEnabled() *v3.RuntimeFeatureFlag

func (*QuicProtocolOptions) GetIdleTimeout

func (x *QuicProtocolOptions) GetIdleTimeout() *durationpb.Duration

func (*QuicProtocolOptions) GetPacketsToReadToConnectionCountRatio added in v0.10.0

func (x *QuicProtocolOptions) GetPacketsToReadToConnectionCountRatio() *wrapperspb.UInt32Value

func (*QuicProtocolOptions) GetProofSourceConfig added in v0.10.0

func (x *QuicProtocolOptions) GetProofSourceConfig() *v3.TypedExtensionConfig

func (*QuicProtocolOptions) GetQuicProtocolOptions added in v0.9.9

func (x *QuicProtocolOptions) GetQuicProtocolOptions() *v3.QuicProtocolOptions

func (*QuicProtocolOptions) GetSendDisableActiveMigration added in v0.13.0

func (x *QuicProtocolOptions) GetSendDisableActiveMigration() *wrapperspb.BoolValue

func (*QuicProtocolOptions) GetServerPreferredAddressConfig added in v0.11.1

func (x *QuicProtocolOptions) GetServerPreferredAddressConfig() *v3.TypedExtensionConfig

func (*QuicProtocolOptions) ProtoMessage

func (*QuicProtocolOptions) ProtoMessage()

func (*QuicProtocolOptions) ProtoReflect added in v0.9.6

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

func (*QuicProtocolOptions) Reset

func (x *QuicProtocolOptions) Reset()

func (*QuicProtocolOptions) String

func (x *QuicProtocolOptions) String() string

func (*QuicProtocolOptions) Validate

func (m *QuicProtocolOptions) Validate() error

Validate checks the field values on QuicProtocolOptions 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 (*QuicProtocolOptions) ValidateAll added in v0.10.0

func (m *QuicProtocolOptions) ValidateAll() error

ValidateAll checks the field values on QuicProtocolOptions 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 QuicProtocolOptionsMultiError, or nil if none found.

type QuicProtocolOptionsMultiError added in v0.10.0

type QuicProtocolOptionsMultiError []error

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

func (QuicProtocolOptionsMultiError) AllErrors added in v0.10.0

func (m QuicProtocolOptionsMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (QuicProtocolOptionsMultiError) Error added in v0.10.0

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

type QuicProtocolOptionsValidationError

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

QuicProtocolOptionsValidationError is the validation error returned by QuicProtocolOptions.Validate if the designated constraints aren't met.

func (QuicProtocolOptionsValidationError) Cause

Cause function returns cause value.

func (QuicProtocolOptionsValidationError) Error

Error satisfies the builtin error interface

func (QuicProtocolOptionsValidationError) ErrorName

ErrorName returns error name.

func (QuicProtocolOptionsValidationError) Field

Field function returns field value.

func (QuicProtocolOptionsValidationError) Key

Key function returns key value.

func (QuicProtocolOptionsValidationError) Reason

Reason function returns reason value.

type UdpListenerConfig

type UdpListenerConfig struct {

	// UDP socket configuration for the listener. The default for
	// :ref:`prefer_gro <envoy_v3_api_field_config.core.v3.UdpSocketConfig.prefer_gro>` is false for
	// listener sockets. If receiving a large amount of datagrams from a small number of sources, it
	// may be worthwhile to enable this option after performance testing.
	DownstreamSocketConfig *v3.UdpSocketConfig `` /* 129-byte string literal not displayed */
	// Configuration for QUIC protocol. If empty, QUIC will not be enabled on this listener. Set
	// to the default object to enable QUIC without modifying any additional options.
	QuicOptions *QuicProtocolOptions `protobuf:"bytes,7,opt,name=quic_options,json=quicOptions,proto3" json:"quic_options,omitempty"`
	// Configuration for the UDP packet writer. If empty, HTTP/3 will use GSO if available
	// (:ref:`UdpDefaultWriterFactory <envoy_v3_api_msg_extensions.udp_packet_writer.v3.UdpGsoBatchWriterFactory>`)
	// or the default kernel sendmsg if not,
	// (:ref:`UdpDefaultWriterFactory <envoy_v3_api_msg_extensions.udp_packet_writer.v3.UdpDefaultWriterFactory>`)
	// and raw UDP will use kernel sendmsg.
	// [#extension-category: envoy.udp_packet_writer]
	UdpPacketPacketWriterConfig *v3.TypedExtensionConfig `` /* 148-byte string literal not displayed */
	// contains filtered or unexported fields
}

[#next-free-field: 9]

func (*UdpListenerConfig) Descriptor deprecated

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

Deprecated: Use UdpListenerConfig.ProtoReflect.Descriptor instead.

func (*UdpListenerConfig) GetDownstreamSocketConfig added in v0.9.9

func (x *UdpListenerConfig) GetDownstreamSocketConfig() *v3.UdpSocketConfig

func (*UdpListenerConfig) GetQuicOptions added in v0.9.9

func (x *UdpListenerConfig) GetQuicOptions() *QuicProtocolOptions

func (*UdpListenerConfig) GetUdpPacketPacketWriterConfig added in v0.10.2

func (x *UdpListenerConfig) GetUdpPacketPacketWriterConfig() *v3.TypedExtensionConfig

func (*UdpListenerConfig) ProtoMessage

func (*UdpListenerConfig) ProtoMessage()

func (*UdpListenerConfig) ProtoReflect added in v0.9.6

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

func (*UdpListenerConfig) Reset

func (x *UdpListenerConfig) Reset()

func (*UdpListenerConfig) String

func (x *UdpListenerConfig) String() string

func (*UdpListenerConfig) Validate

func (m *UdpListenerConfig) Validate() error

Validate checks the field values on UdpListenerConfig 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 (*UdpListenerConfig) ValidateAll added in v0.10.0

func (m *UdpListenerConfig) ValidateAll() error

ValidateAll checks the field values on UdpListenerConfig 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 UdpListenerConfigMultiError, or nil if none found.

type UdpListenerConfigMultiError added in v0.10.0

type UdpListenerConfigMultiError []error

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

func (UdpListenerConfigMultiError) AllErrors added in v0.10.0

func (m UdpListenerConfigMultiError) AllErrors() []error

AllErrors returns a list of validation violation errors.

func (UdpListenerConfigMultiError) Error added in v0.10.0

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

type UdpListenerConfigValidationError

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

UdpListenerConfigValidationError is the validation error returned by UdpListenerConfig.Validate if the designated constraints aren't met.

func (UdpListenerConfigValidationError) Cause

Cause function returns cause value.

func (UdpListenerConfigValidationError) Error

Error satisfies the builtin error interface

func (UdpListenerConfigValidationError) ErrorName

ErrorName returns error name.

func (UdpListenerConfigValidationError) Field

Field function returns field value.

func (UdpListenerConfigValidationError) Key

Key function returns key value.

func (UdpListenerConfigValidationError) Reason

Reason function returns reason value.

type ValidationListenerManager added in v0.11.0

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

A placeholder proto so that users can explicitly configure the standard Validation Listener Manager via the bootstrap's :ref:`listener_manager <envoy_v3_api_field_config.bootstrap.v3.Bootstrap.listener_manager>`. [#not-implemented-hide:]

func (*ValidationListenerManager) Descriptor deprecated added in v0.11.0

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

Deprecated: Use ValidationListenerManager.ProtoReflect.Descriptor instead.

func (*ValidationListenerManager) ProtoMessage added in v0.11.0

func (*ValidationListenerManager) ProtoMessage()

func (*ValidationListenerManager) ProtoReflect added in v0.11.0

func (*ValidationListenerManager) Reset added in v0.11.0

func (x *ValidationListenerManager) Reset()

func (*ValidationListenerManager) String added in v0.11.0

func (x *ValidationListenerManager) String() string

func (*ValidationListenerManager) Validate added in v0.11.0

func (m *ValidationListenerManager) Validate() error

Validate checks the field values on ValidationListenerManager 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 (*ValidationListenerManager) ValidateAll added in v0.11.0

func (m *ValidationListenerManager) ValidateAll() error

ValidateAll checks the field values on ValidationListenerManager 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 ValidationListenerManagerMultiError, or nil if none found.

type ValidationListenerManagerMultiError added in v0.11.0

type ValidationListenerManagerMultiError []error

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

func (ValidationListenerManagerMultiError) AllErrors added in v0.11.0

AllErrors returns a list of validation violation errors.

func (ValidationListenerManagerMultiError) Error added in v0.11.0

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

type ValidationListenerManagerValidationError added in v0.11.0

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

ValidationListenerManagerValidationError is the validation error returned by ValidationListenerManager.Validate if the designated constraints aren't met.

func (ValidationListenerManagerValidationError) Cause added in v0.11.0

Cause function returns cause value.

func (ValidationListenerManagerValidationError) Error added in v0.11.0

Error satisfies the builtin error interface

func (ValidationListenerManagerValidationError) ErrorName added in v0.11.0

ErrorName returns error name.

func (ValidationListenerManagerValidationError) Field added in v0.11.0

Field function returns field value.

func (ValidationListenerManagerValidationError) Key added in v0.11.0

Key function returns key value.

func (ValidationListenerManagerValidationError) Reason added in v0.11.0

Reason function returns reason value.

Jump to

Keyboard shortcuts

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