proto

package
v1.4.0 Latest Latest
Warning

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

 Go to latest Published: Oct 6, 2019 License: MIT Imports: 9 Imported by: 0

Documentation

Overview

Package proto implements RFC 5766 Traversal Using Relays around NAT.

Merged from gortc/turn v0.80.

Index

Examples

Constants

View Source 
const (
	MinChannelNumber = 0x4000
	MaxChannelNumber = 0x7FFF
)

See https://tools.ietf.org/html/rfc5766#section-11:

0x4000 through 0x7FFF: These values are the allowed channel numbers (16,383 possible values).

View Source 
const (
	// DefaultPort for TURN is same as STUN.
	DefaultPort = stun.DefaultPort
	// DefaultTLSPort is for TURN over TLS and is same as STUN.
	DefaultTLSPort = stun.DefaultTLSPort
)

Default ports for TURN from RFC 5766 Section 4.

View Source 
const DefaultLifetime = time.Minute * 10

DefaultLifetime in RFC 5766 is 10 minutes.

RFC 5766 Section 2.2

Variables

View Source 
var (
	// AllocateRequest is shorthand for allocation request message type.
	AllocateRequest = stun.NewType(stun.MethodAllocate, stun.ClassRequest)
	// CreatePermissionRequest is shorthand for create permission request type.
	CreatePermissionRequest = stun.NewType(stun.MethodCreatePermission, stun.ClassRequest)
	// SendIndication is shorthand for send indication message type.
	SendIndication = stun.NewType(stun.MethodSend, stun.ClassIndication)
	// RefreshRequest is shorthand for refresh request message type.
	RefreshRequest = stun.NewType(stun.MethodRefresh, stun.ClassRequest)
)
View Source 
var ErrBadChannelDataLength = errors.New("channelData length != len(Data)")

ErrBadChannelDataLength means that channel data length is not equal to actual data length.

View Source 
var ErrInvalidChannelNumber = errors.New("channel number not in [0x4000, 0x7FFF]")

ErrInvalidChannelNumber means that channel number is not valid as by RFC 5766 Section 11.

View Source 
var RequestedTransportUDP stun.Setter = RequestedTransport{
	Protocol: ProtoUDP,
}

RequestedTransportUDP is setter for requested transport attribute with value ProtoUDP (17).

View Source 
var ZeroLifetime stun.Setter = Lifetime{}

ZeroLifetime is shorthand for setting zero lifetime that indicates to close allocation.

Functions

func IsChannelData 

func IsChannelData(buf []byte) bool

IsChannelData returns true if buf looks like the ChannelData Message.

Types

type Addr 

type Addr struct {
	IP   net.IP
	Port int
}

Addr is ip:port.

func (Addr) Equal 

func (a Addr) Equal(b Addr) bool

Equal returns true if b == a.

func (Addr) EqualIP 

func (a Addr) EqualIP(b Addr) bool

EqualIP returns true if a and b have equal IP addresses.

func (*Addr) FromUDPAddr 

func (a *Addr) FromUDPAddr(n *net.UDPAddr)

FromUDPAddr sets addr to UDPAddr.

func (Addr) Network 

func (Addr) Network() string

Network implements net.Addr.

func (Addr) String 

func (a Addr) String() string

type ChannelData 

type ChannelData struct {
	Data   []byte // can be subslice of Raw
	Length int    // ignored while encoding, len(Data) is used
	Number ChannelNumber
	Raw    []byte
}

ChannelData represents The ChannelData Message.

See RFC 5766 Section 11.4

func (*ChannelData) Decode 

func (c *ChannelData) Decode() error

Decode decodes The ChannelData Message from Raw.

func (*ChannelData) Encode 

func (c *ChannelData) Encode()

Encode encodes ChannelData Message to Raw.

func (*ChannelData) Equal 

func (c *ChannelData) Equal(b *ChannelData) bool

Equal returns true if b == c.

func (*ChannelData) Reset 

func (c *ChannelData) Reset()

Reset resets Length, Data and Raw length.

func (*ChannelData) WriteHeader 

func (c *ChannelData) WriteHeader()

WriteHeader writes channel number and length.

type ChannelNumber 

type ChannelNumber uint16 // encoded as uint16

ChannelNumber represents CHANNEL-NUMBER attribute.

The CHANNEL-NUMBER attribute contains the number of the channel.

RFC 5766 Section 14.1

func (ChannelNumber) AddTo 

func (n ChannelNumber) AddTo(m *stun.Message) error

AddTo adds CHANNEL-NUMBER to message.

func (*ChannelNumber) GetFrom 

func (n *ChannelNumber) GetFrom(m *stun.Message) error

GetFrom decodes CHANNEL-NUMBER from message.

func (ChannelNumber) String 

func (n ChannelNumber) String() string

func (ChannelNumber) Valid 

func (n ChannelNumber) Valid() bool

Valid returns true if channel number has correct value that complies RFC 5766 Section 11 range.

type Data 

type Data []byte

Data represents DATA attribute.

The DATA attribute is present in all Send and Data indications. The value portion of this attribute is variable length and consists of the application data (that is, the data that would immediately follow the UDP header if the data was been sent directly between the client and the peer).

RFC 5766 Section 14.4

func (Data) AddTo 

func (d Data) AddTo(m *stun.Message) error

AddTo adds DATA to message.

func (*Data) GetFrom 

func (d *Data) GetFrom(m *stun.Message) error

GetFrom decodes DATA from message.

type DontFragmentAttr 

type DontFragmentAttr struct{}

DontFragmentAttr represents DONT-FRAGMENT attribute. 

var DontFragment DontFragmentAttr

DontFragment is shorthand for DontFragmentAttr.

func (DontFragmentAttr) AddTo 

func (DontFragmentAttr) AddTo(m *stun.Message) error

AddTo adds DONT-FRAGMENT attribute to message.

func (DontFragmentAttr) IsSet 

func (DontFragmentAttr) IsSet(m *stun.Message) bool

IsSet returns true if DONT-FRAGMENT attribute is set.

type EvenPort 

type EvenPort struct {
	// ReservePort means that the server is requested to reserve
	// the next-higher port number (on the same IP address)
	// for a subsequent allocation.
	ReservePort bool
}

EvenPort represents EVEN-PORT attribute.

This attribute allows the client to request that the port in the relayed transport address be even, and (optionally) that the server reserve the next-higher port number.

RFC 5766 Section 14.6

func (EvenPort) AddTo 

func (p EvenPort) AddTo(m *stun.Message) error

AddTo adds EVEN-PORT to message.

func (*EvenPort) GetFrom 

func (p *EvenPort) GetFrom(m *stun.Message) error

GetFrom decodes EVEN-PORT from message.

func (EvenPort) String 

func (p EvenPort) String() string

type FiveTuple 

type FiveTuple struct {
	Client Addr
	Server Addr
	Proto  Protocol
}

FiveTuple represents 5-TUPLE value.

func (FiveTuple) Equal 

func (t FiveTuple) Equal(b FiveTuple) bool

Equal returns true if b == t.

func (FiveTuple) String 

func (t FiveTuple) String() string

type Lifetime 

type Lifetime struct {
	time.Duration
}

Lifetime represents LIFETIME attribute.

The LIFETIME attribute represents the duration for which the server will maintain an allocation in the absence of a refresh. The value portion of this attribute is 4-bytes long and consists of a 32-bit unsigned integral value representing the number of seconds remaining until expiration.

RFC 5766 Section 14.2

Example 
// Encoding lifetime to message.
m := new(stun.Message)
Lifetime{time.Minute}.AddTo(m)
m.WriteHeader()

// Decoding message.
mDec := new(stun.Message)
if _, err := m.WriteTo(mDec); err != nil {
	panic(err)
}
// Decoding lifetime from message.
l := Lifetime{}
l.GetFrom(m)
fmt.Println("Decoded:", l)

Output:

Decoded: 1m0s

func (Lifetime) AddTo 

func (l Lifetime) AddTo(m *stun.Message) error

AddTo adds LIFETIME to message.

func (*Lifetime) GetFrom 

func (l *Lifetime) GetFrom(m *stun.Message) error

GetFrom decodes LIFETIME from message.

type PeerAddress 

type PeerAddress struct {
	IP   net.IP
	Port int
}

PeerAddress implements XOR-PEER-ADDRESS attribute.

The XOR-PEER-ADDRESS specifies the address and port of the peer as seen from the TURN server. (For example, the peer's server-reflexive transport address if the peer is behind a NAT.)

RFC 5766 Section 14.3

func (PeerAddress) AddTo 

func (a PeerAddress) AddTo(m *stun.Message) error

AddTo adds XOR-PEER-ADDRESS to message.

func (*PeerAddress) GetFrom 

func (a *PeerAddress) GetFrom(m *stun.Message) error

GetFrom decodes XOR-PEER-ADDRESS from message.

func (PeerAddress) String 

func (a PeerAddress) String() string

type Protocol 

type Protocol byte

Protocol is IANA assigned protocol number. 

const (
	// ProtoUDP is IANA assigned protocol number for UDP.
	ProtoUDP Protocol = 17
)

func (Protocol) String 

func (p Protocol) String() string

type RelayedAddress 

type RelayedAddress struct {
	IP   net.IP
	Port int
}

RelayedAddress implements XOR-RELAYED-ADDRESS attribute.

It specifies the address and port that the server allocated to the client. It is encoded in the same way as XOR-MAPPED-ADDRESS.

RFC 5766 Section 14.5

func (RelayedAddress) AddTo 

func (a RelayedAddress) AddTo(m *stun.Message) error

AddTo adds XOR-PEER-ADDRESS to message.

func (*RelayedAddress) GetFrom 

func (a *RelayedAddress) GetFrom(m *stun.Message) error

GetFrom decodes XOR-PEER-ADDRESS from message.

func (RelayedAddress) String 

func (a RelayedAddress) String() string

type RequestedAddressFamily 

type RequestedAddressFamily byte

RequestedAddressFamily represents the REQUESTED-ADDRESS-FAMILY Attribute as defined in RFC 6156 Section 4.1.1. 

const (
	RequestedFamilyIPv4 RequestedAddressFamily = 0x01
	RequestedFamilyIPv6 RequestedAddressFamily = 0x02
)

Values for RequestedAddressFamily as defined in RFC 6156 Section 4.1.1.

func (RequestedAddressFamily) AddTo 

func (f RequestedAddressFamily) AddTo(m *stun.Message) error

AddTo adds REQUESTED-ADDRESS-FAMILY to message.

func (*RequestedAddressFamily) GetFrom 

func (f *RequestedAddressFamily) GetFrom(m *stun.Message) error

GetFrom decodes REQUESTED-ADDRESS-FAMILY from message.

func (RequestedAddressFamily) String 

func (f RequestedAddressFamily) String() string

type RequestedTransport 

type RequestedTransport struct {
	Protocol Protocol
}

RequestedTransport represents REQUESTED-TRANSPORT attribute.

This attribute is used by the client to request a specific transport protocol for the allocated transport address. RFC 5766 only allows the use of codepoint 17 (User Datagram Protocol).

RFC 5766 Section 14.7

func (RequestedTransport) AddTo 

func (t RequestedTransport) AddTo(m *stun.Message) error

AddTo adds REQUESTED-TRANSPORT to message.

func (*RequestedTransport) GetFrom 

func (t *RequestedTransport) GetFrom(m *stun.Message) error

GetFrom decodes REQUESTED-TRANSPORT from message.

func (RequestedTransport) String 

func (t RequestedTransport) String() string

type ReservationToken 

type ReservationToken []byte

ReservationToken represents RESERVATION-TOKEN attribute.

The RESERVATION-TOKEN attribute contains a token that uniquely identifies a relayed transport address being held in reserve by the server. The server includes this attribute in a success response to tell the client about the token, and the client includes this attribute in a subsequent Allocate request to request the server use that relayed transport address for the allocation.

RFC 5766 Section 14.9

func (ReservationToken) AddTo 

func (t ReservationToken) AddTo(m *stun.Message) error

AddTo adds RESERVATION-TOKEN to message.

func (*ReservationToken) GetFrom 

func (t *ReservationToken) GetFrom(m *stun.Message) error

GetFrom decodes RESERVATION-TOKEN from message.

type XORPeerAddress 

type XORPeerAddress = PeerAddress

XORPeerAddress implements XOR-PEER-ADDRESS attribute.

The XOR-PEER-ADDRESS specifies the address and port of the peer as seen from the TURN server. (For example, the peer's server-reflexive transport address if the peer is behind a NAT.)

RFC 5766 Section 14.3

type XORRelayedAddress 

type XORRelayedAddress = RelayedAddress

XORRelayedAddress implements XOR-RELAYED-ADDRESS attribute.

It specifies the address and port that the server allocated to the client. It is encoded in the same way as XOR-MAPPED-ADDRESS.

RFC 5766 Section 14.5

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.