Documentation ¶
Overview ¶
Package net contains common network utilities.
Index ¶
- Constants
- Variables
- type Address
- type AddressFamily
- type Destination
- type Endpoint
- func (v *Endpoint) AsDestination() Destination
- func (*Endpoint) Descriptor() ([]byte, []int)
- func (m *Endpoint) GetAddress() *IPOrDomain
- func (m *Endpoint) GetNetwork() Network
- func (m *Endpoint) GetPort() uint32
- func (*Endpoint) ProtoMessage()
- func (m *Endpoint) Reset()
- func (m *Endpoint) String() string
- type IPNet
- type IPOrDomain
- func (v *IPOrDomain) AsAddress() Address
- func (*IPOrDomain) Descriptor() ([]byte, []int)
- func (m *IPOrDomain) GetAddress() isIPOrDomain_Address
- func (m *IPOrDomain) GetDomain() string
- func (m *IPOrDomain) GetIp() []byte
- func (*IPOrDomain) ProtoMessage()
- func (m *IPOrDomain) Reset()
- func (m *IPOrDomain) String() string
- func (*IPOrDomain) XXX_OneofFuncs() (func(msg proto.Message, b *proto.Buffer) error, ...)
- type IPOrDomain_Domain
- type IPOrDomain_Ip
- type Network
- type NetworkList
- func (*NetworkList) Descriptor() ([]byte, []int)
- func (v NetworkList) Get(idx int) Network
- func (m *NetworkList) GetNetwork() []Network
- func (v NetworkList) HasNetwork(network Network) bool
- func (*NetworkList) ProtoMessage()
- func (m *NetworkList) Reset()
- func (v NetworkList) Size() int
- func (m *NetworkList) String() string
- type Port
- type PortRange
- func (v PortRange) Contains(port Port) bool
- func (*PortRange) Descriptor() ([]byte, []int)
- func (v PortRange) FromPort() Port
- func (m *PortRange) GetFrom() uint32
- func (m *PortRange) GetTo() uint32
- func (*PortRange) ProtoMessage()
- func (m *PortRange) Reset()
- func (m *PortRange) String() string
- func (v PortRange) ToPort() Port
Constants ¶
const ( // AddressFamilyIPv4 represents address as IPv4 AddressFamilyIPv4 = AddressFamily(0) // AddressFamilyIPv6 represents address as IPv6 AddressFamilyIPv6 = AddressFamily(1) // AddressFamilyDomain represents address as Domain AddressFamilyDomain = AddressFamily(2) )
Variables ¶
var ( // LocalHostIP is a constant value for localhost IP in IPv4. LocalHostIP = IPAddress([]byte{127, 0, 0, 1}) // AnyIP is a constant value for any IP in IPv4. AnyIP = IPAddress([]byte{0, 0, 0, 0}) // LocalHostDomain is a constant value for localhost domain. LocalHostDomain = DomainAddress("localhost") // LocalHostIPv6 is a constant value for localhost IP in IPv6. LocalHostIPv6 = IPAddress([]byte{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1}) )
var Network_name = map[int32]string{
0: "Unknown",
1: "RawTCP",
2: "TCP",
3: "UDP",
}
var Network_value = map[string]int32{
"Unknown": 0,
"RawTCP": 1,
"TCP": 2,
"UDP": 3,
}
Functions ¶
This section is empty.
Types ¶
type Address ¶
type Address interface { IP() net.IP // IP of this Address Domain() string // Domain of this Address Family() AddressFamily String() string // String representation of this Address }
Address represents a network address to be communicated with. It may be an IP address or domain address, not both. This interface doesn't resolve IP address for a given domain.
func DomainAddress ¶
DomainAddress creates an Address with given domain.
func ParseAddress ¶ added in v1.0.0
ParseAddress parses a string into an Address. The return value will be an IPAddress when the string is in the form of IPv4 or IPv6 address, or a DomainAddress otherwise.
type AddressFamily ¶ added in v1.0.0
type AddressFamily int
AddressFamily is the type of address.
func (AddressFamily) Either ¶ added in v1.24.4
func (v AddressFamily) Either(fs ...AddressFamily) bool
func (AddressFamily) IsDomain ¶ added in v1.0.0
func (v AddressFamily) IsDomain() bool
func (AddressFamily) IsIPv4 ¶ added in v1.0.0
func (v AddressFamily) IsIPv4() bool
func (AddressFamily) IsIPv6 ¶ added in v1.0.0
func (v AddressFamily) IsIPv6() bool
type Destination ¶
Destination represents a network destination including address and protocol (tcp / udp).
func DestinationFromAddr ¶ added in v1.0.0
func DestinationFromAddr(addr net.Addr) Destination
DestinationFromAddr generates a Destination from a net address.
func TCPDestination ¶
func TCPDestination(address Address, port Port) Destination
TCPDestination creates a TCP destination with given address
func UDPDestination ¶
func UDPDestination(address Address, port Port) Destination
UDPDestination creates a UDP destination with given address
func (Destination) IsValid ¶ added in v1.0.0
func (v Destination) IsValid() bool
func (Destination) NetAddr ¶ added in v1.0.0
func (v Destination) NetAddr() string
func (Destination) String ¶
func (v Destination) String() string
type Endpoint ¶ added in v1.0.0
type Endpoint struct { Network Network `protobuf:"varint,1,opt,name=network,enum=v2ray.core.common.net.Network" json:"network,omitempty"` Address *IPOrDomain `protobuf:"bytes,2,opt,name=address" json:"address,omitempty"` Port uint32 `protobuf:"varint,3,opt,name=port" json:"port,omitempty"` }
func (*Endpoint) AsDestination ¶ added in v1.0.0
func (v *Endpoint) AsDestination() Destination
AsDestination converts current Enpoint into Destination.
func (*Endpoint) Descriptor ¶ added in v1.0.0
func (*Endpoint) GetAddress ¶ added in v1.0.0
func (m *Endpoint) GetAddress() *IPOrDomain
func (*Endpoint) GetNetwork ¶ added in v1.0.0
func (*Endpoint) ProtoMessage ¶ added in v1.0.0
func (*Endpoint) ProtoMessage()
type IPOrDomain ¶ added in v1.0.0
type IPOrDomain struct { // Types that are valid to be assigned to Address: // *IPOrDomain_Ip // *IPOrDomain_Domain Address isIPOrDomain_Address `protobuf_oneof:"address"` }
func NewIPOrDomain ¶ added in v1.0.0
func NewIPOrDomain(addr Address) *IPOrDomain
func (*IPOrDomain) AsAddress ¶ added in v1.0.0
func (v *IPOrDomain) AsAddress() Address
func (*IPOrDomain) Descriptor ¶ added in v1.0.0
func (*IPOrDomain) Descriptor() ([]byte, []int)
func (*IPOrDomain) GetAddress ¶ added in v1.0.0
func (m *IPOrDomain) GetAddress() isIPOrDomain_Address
func (*IPOrDomain) GetDomain ¶ added in v1.0.0
func (m *IPOrDomain) GetDomain() string
func (*IPOrDomain) GetIp ¶ added in v1.0.0
func (m *IPOrDomain) GetIp() []byte
func (*IPOrDomain) ProtoMessage ¶ added in v1.0.0
func (*IPOrDomain) ProtoMessage()
func (*IPOrDomain) Reset ¶ added in v1.0.0
func (m *IPOrDomain) Reset()
func (*IPOrDomain) String ¶ added in v1.0.0
func (m *IPOrDomain) String() string
func (*IPOrDomain) XXX_OneofFuncs ¶
func (*IPOrDomain) XXX_OneofFuncs() (func(msg proto.Message, b *proto.Buffer) error, func(msg proto.Message, tag, wire int, b *proto.Buffer) (bool, error), func(msg proto.Message) (n int), []interface{})
XXX_OneofFuncs is for the internal use of the proto package.
type IPOrDomain_Domain ¶ added in v1.0.0
type IPOrDomain_Domain struct {
Domain string `protobuf:"bytes,2,opt,name=domain,oneof"`
}
type IPOrDomain_Ip ¶ added in v1.0.0
type IPOrDomain_Ip struct {
Ip []byte `protobuf:"bytes,1,opt,name=ip,proto3,oneof"`
}
type Network ¶
type Network int32
func ParseNetwork ¶ added in v1.0.0
func (Network) AsList ¶ added in v1.13.1
func (v Network) AsList() *NetworkList
func (Network) EnumDescriptor ¶ added in v1.0.0
func (Network) SystemString ¶ added in v1.0.0
type NetworkList ¶
type NetworkList struct {
Network []Network `protobuf:"varint,1,rep,packed,name=network,enum=v2ray.core.common.net.Network" json:"network,omitempty"`
}
func (*NetworkList) Descriptor ¶ added in v1.0.0
func (*NetworkList) Descriptor() ([]byte, []int)
func (NetworkList) Get ¶
func (v NetworkList) Get(idx int) Network
func (*NetworkList) GetNetwork ¶ added in v1.0.0
func (m *NetworkList) GetNetwork() []Network
func (NetworkList) HasNetwork ¶
func (v NetworkList) HasNetwork(network Network) bool
HasNetwork returns true if the given network is in v NetworkList.
func (*NetworkList) ProtoMessage ¶ added in v1.0.0
func (*NetworkList) ProtoMessage()
func (*NetworkList) Reset ¶ added in v1.0.0
func (m *NetworkList) Reset()
func (NetworkList) Size ¶
func (v NetworkList) Size() int
Size returns the number of networks in this network list.
func (*NetworkList) String ¶ added in v1.0.0
func (m *NetworkList) String() string
type Port ¶ added in v1.0.0
type Port uint16
Port represents a network port in TCP and UDP protocol.
func PortFromBytes ¶ added in v1.0.0
PortFromBytes converts a byte array to a Port, assuming bytes are in big endian order. @unsafe Caller must ensure that the byte array has at least 2 elements.
func PortFromInt ¶ added in v1.0.0
PortFromInt converts an integer to a Port. @error when the integer is not positive or larger then 65535
func PortFromString ¶ added in v1.0.0
PortFromString converts a string to a Port. @error when the string is not an integer or the integral value is a not a valid Port.
func (Port) Bytes ¶ added in v1.13.1
Bytes returns the correspoding bytes of v Port, in big endian order.
type PortRange ¶
type PortRange struct { From uint32 `protobuf:"varint,1,opt,name=From" json:"From,omitempty"` To uint32 `protobuf:"varint,2,opt,name=To" json:"To,omitempty"` }
PortRange represents a range of ports.
func SinglePortRange ¶ added in v1.0.0
SinglePortRange returns a PortRange contains a single port.
func (PortRange) Contains ¶ added in v1.0.0
Contains returns true if the given port is within the range of v PortRange.
func (*PortRange) Descriptor ¶ added in v1.0.0
func (*PortRange) ProtoMessage ¶ added in v1.0.0
func (*PortRange) ProtoMessage()