.. _envoy_api_file_envoy/api/v2/core/socket_option.proto: Socket Option ============== .. _envoy_api_msg_core.SocketOption: core.SocketOption ----------------- `[core.SocketOption proto] `_ Generic socket option message. This would be used to set socket options that might not exist in upstream kernels or precompiled Envoy binaries. .. code-block:: json { "description": "...", "level": "...", "name": "...", "int_value": "...", "buf_value": "...", "state": "..." } .. _envoy_api_field_core.SocketOption.description: description (`string `_) An optional name to give this socket option for debugging, etc. Uniqueness is not required and no special meaning is assumed. .. _envoy_api_field_core.SocketOption.level: level (`int64 `_) Corresponding to the level value passed to setsockopt, such as IPPROTO_TCP .. _envoy_api_field_core.SocketOption.name: name (`int64 `_) The numeric name as passed to setsockopt .. _envoy_api_field_core.SocketOption.int_value: int_value (`int64 `_) Because many sockopts take an int value. Precisely one of :ref:`int_value `, :ref:`buf_value ` must be set. .. _envoy_api_field_core.SocketOption.buf_value: buf_value (`bytes `_) Otherwise it's a byte buffer. Precisely one of :ref:`int_value `, :ref:`buf_value ` must be set. .. _envoy_api_field_core.SocketOption.state: state (:ref:`core.SocketOption.SocketState `) The state in which the option will be applied. When used in BindConfig STATE_PREBIND is currently the only valid value. .. _envoy_api_enum_core.SocketOption.SocketState: Enum core.SocketOption.SocketState ---------------------------------- `[core.SocketOption.SocketState proto] `_ .. _envoy_api_enum_value_core.SocketOption.SocketState.STATE_PREBIND: STATE_PREBIND *(DEFAULT)* ⁣Socket options are applied after socket creation but before binding the socket to a port .. _envoy_api_enum_value_core.SocketOption.SocketState.STATE_BOUND: STATE_BOUND ⁣Socket options are applied after binding the socket to a port but before calling listen() .. _envoy_api_enum_value_core.SocketOption.SocketState.STATE_LISTENING: STATE_LISTENING ⁣Socket options are applied after calling listen()