discover

package
v0.11.22 Latest Latest
Warning

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

 Go to latest Published: Aug 24, 2015 License: MPL-2.0 Imports: 17 Imported by: 0

Documentation

Overview

Package discover implements the device discovery protocol.

Index

Constants

View Source 
const (
	AnnouncementMagic = 0x9D79BC39
	QueryMagic        = 0x2CA856F5
)

Variables

View Source 
var (
	DefaultErrorRetryInternval     = 60 * time.Second
	DefaultGlobalBroadcastInterval = 1800 * time.Second
)
View Source 
var (
	ErrIncorrectMagic = errors.New("incorrect magic number")
)

Functions

func Register 

func Register(proto string, factory Factory)

Types

type Address 

type Address struct {
	IP   []byte // max:16
	Port uint16
}

func (Address) AppendXDR 

func (o Address) AppendXDR(bs []byte) ([]byte, error)

func (*Address) DecodeXDR 

func (o *Address) DecodeXDR(r io.Reader) error

func (*Address) DecodeXDRFrom 

func (o *Address) DecodeXDRFrom(xr *xdr.Reader) error

func (Address) EncodeXDR 

func (o Address) EncodeXDR(w io.Writer) (int, error)

func (Address) EncodeXDRInto 

func (o Address) EncodeXDRInto(xw *xdr.Writer) (int, error)

func (Address) MarshalXDR 

func (o Address) MarshalXDR() ([]byte, error)

func (Address) MustMarshalXDR 

func (o Address) MustMarshalXDR() []byte

func (*Address) UnmarshalXDR 

func (o *Address) UnmarshalXDR(bs []byte) error

type Announce 

type Announce struct {
	Magic uint32
	This  Device
	Extra []Device // max:16
}

func (Announce) AppendXDR 

func (o Announce) AppendXDR(bs []byte) ([]byte, error)

func (*Announce) DecodeXDR 

func (o *Announce) DecodeXDR(r io.Reader) error

func (*Announce) DecodeXDRFrom 

func (o *Announce) DecodeXDRFrom(xr *xdr.Reader) error

func (Announce) EncodeXDR 

func (o Announce) EncodeXDR(w io.Writer) (int, error)

func (Announce) EncodeXDRInto 

func (o Announce) EncodeXDRInto(xw *xdr.Writer) (int, error)

func (Announce) MarshalXDR 

func (o Announce) MarshalXDR() ([]byte, error)

func (Announce) MustMarshalXDR 

func (o Announce) MustMarshalXDR() []byte

func (*Announce) UnmarshalXDR 

func (o *Announce) UnmarshalXDR(bs []byte) error

type CacheEntry 

type CacheEntry struct {
	Address string
	Seen    time.Time
}

type Client 

type Client interface {
	Lookup(device protocol.DeviceID) []string
	StatusOK() bool
	Address() string
	Stop()
}

func New 

func New(addr string, pkt *Announce) (Client, error)

type Device 

type Device struct {
	ID        []byte    // max:32
	Addresses []Address // max:16
}

func (Device) AppendXDR 

func (o Device) AppendXDR(bs []byte) ([]byte, error)

func (*Device) DecodeXDR 

func (o *Device) DecodeXDR(r io.Reader) error

func (*Device) DecodeXDRFrom 

func (o *Device) DecodeXDRFrom(xr *xdr.Reader) error

func (Device) EncodeXDR 

func (o Device) EncodeXDR(w io.Writer) (int, error)

func (Device) EncodeXDRInto 

func (o Device) EncodeXDRInto(xw *xdr.Writer) (int, error)

func (Device) MarshalXDR 

func (o Device) MarshalXDR() ([]byte, error)

func (Device) MustMarshalXDR 

func (o Device) MustMarshalXDR() []byte

func (*Device) UnmarshalXDR 

func (o *Device) UnmarshalXDR(bs []byte) error

type Discoverer 

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

func NewDiscoverer 

func NewDiscoverer(id protocol.DeviceID, addresses []string) *Discoverer

func (*Discoverer) All 

func (d *Discoverer) All() map[protocol.DeviceID][]CacheEntry

func (*Discoverer) ExtAnnounceOK 

func (d *Discoverer) ExtAnnounceOK() map[string]bool

func (*Discoverer) Hint 

func (d *Discoverer) Hint(device string, addrs []string)

func (*Discoverer) Lookup 

func (d *Discoverer) Lookup(device protocol.DeviceID) []string

func (*Discoverer) StartGlobal 

func (d *Discoverer) StartGlobal(servers []string, extPort uint16)

func (*Discoverer) StartLocal 

func (d *Discoverer) StartLocal(localPort int, localMCAddr string)

func (*Discoverer) StopGlobal 

func (d *Discoverer) StopGlobal()

type Factory 

type Factory func(*url.URL, *Announce) (Client, error)

type Query 

type Query struct {
	Magic    uint32
	DeviceID []byte // max:32
}

func (Query) AppendXDR 

func (o Query) AppendXDR(bs []byte) ([]byte, error)

func (*Query) DecodeXDR 

func (o *Query) DecodeXDR(r io.Reader) error

func (*Query) DecodeXDRFrom 

func (o *Query) DecodeXDRFrom(xr *xdr.Reader) error

func (Query) EncodeXDR 

func (o Query) EncodeXDR(w io.Writer) (int, error)

func (Query) EncodeXDRInto 

func (o Query) EncodeXDRInto(xw *xdr.Writer) (int, error)

func (Query) MarshalXDR 

func (o Query) MarshalXDR() ([]byte, error)

func (Query) MustMarshalXDR 

func (o Query) MustMarshalXDR() []byte

func (*Query) UnmarshalXDR 

func (o *Query) UnmarshalXDR(bs []byte) error

type UDPClient 

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

func (*UDPClient) Address 

func (d *UDPClient) Address() string

func (*UDPClient) Lookup 

func (d *UDPClient) Lookup(device protocol.DeviceID) []string

func (*UDPClient) Start 

func (d *UDPClient) Start(uri *url.URL, pkt *Announce) error

func (*UDPClient) StatusOK 

func (d *UDPClient) StatusOK() bool

func (*UDPClient) Stop 

func (d *UDPClient) Stop()

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.