Documentation
¶
Index ¶
- Constants
- type Address
- type AddressAssignCapsule
- type AddressRequestCapsule
- type Capsule
- type CapsuleCreated
- type CapsuleParsed
- type DNSAssignCapsule
- type DNSConfiguration
- type DNSNameserver
- type DNSServiceParameter
- type Endpoint
- type ICMP
- type ICMPResponse
- type IPAddressRange
- type IPHeader
- type IPv4Header
- type IPv6Header
- type PREF64Capsule
- type Packet
- type PacketDropReason
- type PacketOutcome
- type PacketProcessed
- type RawInfo
- type RouteAdvertisementCapsule
- type UnknownCapsule
Constants ¶
const ( // EventSchemaHTTP is the qlog event schema for the HTTP Capsule Protocol, // defined in draft-ietf-quic-qlog-h3-events-14. // It defines the http:capsule_created and http:capsule_parsed events. EventSchemaHTTP = "urn:ietf:params:qlog:events:http-14" // EventSchemaConnectIP is the qlog event schema for CONNECT-IP, // defined in draft-seemann-masque-connect-ip-qlog-00. EventSchemaConnectIP = "urn:ietf:params:qlog:events:http#connect-ip-00" // EventSchemaConnectIPDNS is the qlog event schema for the DNS_ASSIGN and PREF64 capsules, // defined in draft-seemann-masque-connect-ip-qlog-00. EventSchemaConnectIPDNS = "urn:ietf:params:qlog:events:http#connect-ip-dns-00" )
const OmitLength = -1
OmitLength indicates that a length should not be logged.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Address ¶
An Address is an address contained in an ADDRESS_ASSIGN or an ADDRESS_REQUEST capsule.
type AddressAssignCapsule ¶
An AddressAssignCapsule is an ADDRESS_ASSIGN capsule.
type AddressRequestCapsule ¶
An AddressRequestCapsule is an ADDRESS_REQUEST capsule.
type Capsule ¶
type Capsule struct {
Capsule any
}
Capsule represents a capsule sent or received on the CONNECT-IP request stream.
type CapsuleCreated ¶
func (CapsuleCreated) Name ¶
func (e CapsuleCreated) Name() string
type CapsuleParsed ¶
func (CapsuleParsed) Name ¶
func (e CapsuleParsed) Name() string
type DNSAssignCapsule ¶
type DNSAssignCapsule struct {
DNSConfigurations []DNSConfiguration
Raw RawInfo
}
A DNSAssignCapsule is a DNS_ASSIGN capsule.
type DNSConfiguration ¶
type DNSConfiguration struct {
Nameservers []DNSNameserver
InternalDomains []string
SearchDomains []string
}
A DNSConfiguration is a DNS configuration contained in a DNS_ASSIGN capsule.
type DNSNameserver ¶
type DNSNameserver struct {
ServicePriority uint16
IPv4Addresses []netip.Addr
IPv6Addresses []netip.Addr
AuthenticationDomainName string
// ServiceParameters are sorted by key.
ServiceParameters []DNSServiceParameter
}
A DNSNameserver is a nameserver contained in a DNS configuration.
type DNSServiceParameter ¶
A DNSServiceParameter is an SVCB service parameter of a DNS nameserver.
type ICMPResponse ¶
An ICMPResponse is an ICMP message generated in response to a packet.
type IPAddressRange ¶
An IPAddressRange is an IP address range contained in a ROUTE_ADVERTISEMENT capsule.
type IPHeader ¶
type IPHeader interface {
// contains filtered or unexported methods
}
An IPHeader is an IPv4Header or an IPv6Header.
type IPv4Header ¶
type IPv4Header struct {
TotalLength uint16
TTL uint8
Protocol uint8
SourceAddress netip.Addr
DestinationAddress netip.Addr
}
An IPv4Header is the header of an IPv4 packet.
type IPv6Header ¶
type IPv6Header struct {
PayloadLength uint16
NextHeader uint8
HopLimit uint8
SourceAddress netip.Addr
DestinationAddress netip.Addr
}
An IPv6Header is the fixed header of an IPv6 packet.
type PREF64Capsule ¶
A PREF64Capsule is a PREF64 capsule.
type PacketDropReason ¶
type PacketDropReason string
PacketDropReason is the reason why a packet was dropped.
const ( PacketDropInvalid PacketDropReason = "invalid" PacketDropSourceAddressNotAllowed PacketDropReason = "source_address_not_allowed" PacketDropDestinationAddressNotAllowed PacketDropReason = "destination_address_not_allowed" PacketDropProtocolNotAllowed PacketDropReason = "protocol_not_allowed" PacketDropHopLimitExceeded PacketDropReason = "hop_limit_exceeded" PacketDropTooLarge PacketDropReason = "packet_too_large" PacketDropSendError PacketDropReason = "send_error" )
type PacketOutcome ¶
type PacketOutcome string
PacketOutcome is the forwarding decision for a packet.
const ( PacketForwarded PacketOutcome = "forwarded" PacketDropped PacketOutcome = "dropped" )
type PacketProcessed ¶
type PacketProcessed struct {
StreamID quic.StreamID
Source Endpoint
Packet Packet
Outcome PacketOutcome
Reason PacketDropReason
ICMPResponse *ICMPResponse
}
func (PacketProcessed) Name ¶
func (e PacketProcessed) Name() string
type RawInfo ¶
type RawInfo struct {
Length int // full length of the capsule or packet
PayloadLength int // length of the capsule value or packet payload
}
RawInfo contains capsule or packet lengths. Zero lengths are logged. Set a field to OmitLength to omit it.
type RouteAdvertisementCapsule ¶
type RouteAdvertisementCapsule struct {
IPAddressRanges []IPAddressRange
Raw RawInfo
}
A RouteAdvertisementCapsule is a ROUTE_ADVERTISEMENT capsule.
type UnknownCapsule ¶
An UnknownCapsule is a capsule of a type that connect-ip-go doesn't process.