net

package
v2.16.1+incompatible Latest Latest
Warning

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

Go to latest
Published: Jan 27, 2017 License: MIT Imports: 12 Imported by: 0

Documentation

Overview

Package net contains common network utilities.

Index

Constants

View Source
const (
	AddressFamilyIPv4   = AddressFamily(0)
	AddressFamilyIPv6   = AddressFamily(1)
	AddressFamilyDomain = AddressFamily(2)
)

Variables

View Source
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")
)
View Source
var (
	// ErrInvalidPortRage indicates an error during port range parsing.
	ErrInvalidPortRange = errors.New("Invalid port range.")
)
View Source
var Network_name = map[int32]string{
	0: "Unknown",
	1: "RawTCP",
	2: "TCP",
	3: "UDP",
}
View Source
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

func DomainAddress(domain string) Address

DomainAddress creates an Address with given domain.

func IPAddress

func IPAddress(ip []byte) Address

IPAddress creates an Address with given IP.

func ParseAddress

func ParseAddress(addr string) Address

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

type AddressFamily int

func (AddressFamily) Either added in v1.24.1

func (v AddressFamily) Either(fs ...AddressFamily) bool

func (AddressFamily) IsDomain

func (v AddressFamily) IsDomain() bool

func (AddressFamily) IsIPv4

func (v AddressFamily) IsIPv4() bool

func (AddressFamily) IsIPv6

func (v AddressFamily) IsIPv6() bool

type Destination

type Destination struct {
	Network Network
	Port    Port
	Address Address
}

Destination represents a network destination including address and protocol (tcp / udp).

func DestinationFromAddr

func DestinationFromAddr(addr net.Addr) Destination

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

func (v Destination) IsValid() bool

func (Destination) NetAddr

func (v Destination) NetAddr() string

func (Destination) String

func (v Destination) String() string

type Endpoint

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

func (v *Endpoint) AsDestination() Destination

func (*Endpoint) Descriptor

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

func (*Endpoint) GetAddress

func (m *Endpoint) GetAddress() *IPOrDomain

func (*Endpoint) GetNetwork

func (m *Endpoint) GetNetwork() Network

func (*Endpoint) GetPort

func (m *Endpoint) GetPort() uint32

func (*Endpoint) ProtoMessage

func (*Endpoint) ProtoMessage()

func (*Endpoint) Reset

func (m *Endpoint) Reset()

func (*Endpoint) String

func (m *Endpoint) String() string

type IPNet

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

func NewIPNet added in v1.1.1

func NewIPNet() *IPNet

func (*IPNet) Add added in v1.1.1

func (v *IPNet) Add(ipNet *net.IPNet)

func (*IPNet) AddIP

func (v *IPNet) AddIP(ip []byte, mask byte)

func (*IPNet) Contains added in v1.1.1

func (v *IPNet) Contains(ip net.IP) bool

func (*IPNet) IsEmpty

func (v *IPNet) IsEmpty() bool

type IPOrDomain

type IPOrDomain struct {
	// Types that are valid to be assigned to Address:
	//	*IPOrDomain_Ip
	//	*IPOrDomain_Domain
	Address isIPOrDomain_Address `protobuf_oneof:"address"`
}

func NewIPOrDomain

func NewIPOrDomain(addr Address) *IPOrDomain

func (*IPOrDomain) AsAddress

func (v *IPOrDomain) AsAddress() Address

func (*IPOrDomain) Descriptor

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

func (*IPOrDomain) GetAddress

func (m *IPOrDomain) GetAddress() isIPOrDomain_Address

func (*IPOrDomain) GetDomain

func (m *IPOrDomain) GetDomain() string

func (*IPOrDomain) GetIp

func (m *IPOrDomain) GetIp() []byte

func (*IPOrDomain) ProtoMessage

func (*IPOrDomain) ProtoMessage()

func (*IPOrDomain) Reset

func (m *IPOrDomain) Reset()

func (*IPOrDomain) String

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

type IPOrDomain_Domain struct {
	Domain string `protobuf:"bytes,2,opt,name=domain,oneof"`
}

type IPOrDomain_Ip

type IPOrDomain_Ip struct {
	Ip []byte `protobuf:"bytes,1,opt,name=ip,proto3,oneof"`
}

type Network

type Network int32
const (
	Network_Unknown Network = 0
	// Native TCP provided by system.
	Network_RawTCP Network = 1
	// V2Ray specific TCP.
	Network_TCP Network = 2
	Network_UDP Network = 3
)

func ParseNetwork

func ParseNetwork(nwStr string) Network

func (Network) AsList added in v1.9.1

func (v Network) AsList() *NetworkList

func (Network) EnumDescriptor

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

func (Network) String

func (x Network) String() string

func (Network) SystemString

func (v Network) SystemString() string

func (Network) URLPrefix

func (v Network) URLPrefix() string

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

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

func (NetworkList) Get

func (v NetworkList) Get(idx int) Network

func (*NetworkList) GetNetwork

func (m *NetworkList) GetNetwork() []Network

func (NetworkList) HasNetwork added in v0.14.1

func (v NetworkList) HasNetwork(network Network) bool

HashNetwork returns true if the given network is in v NetworkList.

func (*NetworkList) ProtoMessage

func (*NetworkList) ProtoMessage()

func (*NetworkList) Reset

func (m *NetworkList) Reset()

func (NetworkList) Size

func (v NetworkList) Size() int

func (*NetworkList) String

func (m *NetworkList) String() string

type Port

type Port uint16

Port represents a network port in TCP and UDP protocol.

func PortFromBytes

func PortFromBytes(port []byte) Port

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

func PortFromInt(val uint32) (Port, error)

PortFromInt converts an integer to a Port. @error when the integer is not positive or larger then 65535

func PortFromString

func PortFromString(s string) (Port, error)

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.1.1

func (v Port) Bytes(b []byte) []byte

Bytes returns the correspoding bytes of v Port, in big endian order.

func (Port) String

func (v Port) String() string

String returns the string presentation of v Port.

func (Port) Value

func (v Port) Value() uint16

Value return the correspoding uint16 value of v Port.

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

func SinglePortRange(v Port) *PortRange

func (PortRange) Contains

func (v PortRange) Contains(port Port) bool

Contains returns true if the given port is within the range of v PortRange.

func (*PortRange) Descriptor

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

func (PortRange) FromPort

func (v PortRange) FromPort() Port

func (*PortRange) GetFrom

func (m *PortRange) GetFrom() uint32

func (*PortRange) GetTo

func (m *PortRange) GetTo() uint32

func (*PortRange) ProtoMessage

func (*PortRange) ProtoMessage()

func (*PortRange) Reset

func (m *PortRange) Reset()

func (*PortRange) String

func (m *PortRange) String() string

func (PortRange) ToPort

func (v PortRange) ToPort() Port

type TimeOutReader added in v0.6.1

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

func NewTimeOutReader added in v0.6.1

func NewTimeOutReader(timeout uint32, connection net.Conn) *TimeOutReader

func (*TimeOutReader) GetTimeOut added in v0.9.1

func (reader *TimeOutReader) GetTimeOut() uint32

func (*TimeOutReader) Read added in v0.6.1

func (reader *TimeOutReader) Read(p []byte) (int, error)

func (*TimeOutReader) SetTimeOut added in v0.9.1

func (reader *TimeOutReader) SetTimeOut(value uint32)

Jump to

Keyboard shortcuts

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