2015-09-20 15:30:25 +02:00
|
|
|
// Copyright (C) 2015 The Syncthing Authors.
|
2014-09-29 21:43:32 +02:00
|
|
|
//
|
2015-03-07 21:36:35 +01:00
|
|
|
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
|
|
// License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
|
|
// You can obtain one at http://mozilla.org/MPL/2.0/.
|
2014-06-01 22:50:14 +02:00
|
|
|
|
2013-12-15 11:43:31 +01:00
|
|
|
package discover
|
|
|
|
|
|
|
|
import (
|
|
|
|
"time"
|
2013-12-24 17:10:49 +01:00
|
|
|
|
2015-09-22 19:38:46 +02:00
|
|
|
"github.com/syncthing/syncthing/lib/protocol"
|
2015-09-20 15:30:25 +02:00
|
|
|
"github.com/thejerf/suture"
|
2013-12-15 11:43:31 +01:00
|
|
|
)
|
|
|
|
|
2015-09-20 15:30:25 +02:00
|
|
|
// A Finder provides lookup services of some kind.
|
|
|
|
type Finder interface {
|
2016-05-04 21:38:12 +02:00
|
|
|
Lookup(deviceID protocol.DeviceID) (address []string, err error)
|
2015-09-20 15:30:25 +02:00
|
|
|
Error() error
|
|
|
|
String() string
|
|
|
|
Cache() map[protocol.DeviceID]CacheEntry
|
2015-09-12 21:59:15 +02:00
|
|
|
}
|
|
|
|
|
2014-10-15 22:52:06 +02:00
|
|
|
type CacheEntry struct {
|
2016-05-04 21:38:12 +02:00
|
|
|
Addresses []string `json:"addresses"`
|
2015-12-01 09:57:53 +01:00
|
|
|
when time.Time // When did we get the result
|
|
|
|
found bool // Is it a success (cacheTime applies) or a failure (negCacheTime applies)?
|
|
|
|
validUntil time.Time // Validity time, overrides normal calculation
|
2014-08-14 12:44:49 +02:00
|
|
|
}
|
|
|
|
|
2015-09-20 15:30:25 +02:00
|
|
|
// A FinderService is a Finder that has background activity and must be run as
|
|
|
|
// a suture.Service.
|
|
|
|
type FinderService interface {
|
|
|
|
Finder
|
|
|
|
suture.Service
|
2014-05-02 08:53:19 +02:00
|
|
|
}
|
|
|
|
|
2015-09-20 15:30:25 +02:00
|
|
|
type FinderMux interface {
|
|
|
|
Finder
|
|
|
|
ChildStatus() map[string]error
|
2014-05-13 02:50:54 +02:00
|
|
|
}
|
|
|
|
|
2015-09-20 15:30:25 +02:00
|
|
|
// The AddressLister answers questions about what addresses we are listening
|
|
|
|
// on.
|
|
|
|
type AddressLister interface {
|
|
|
|
ExternalAddresses() []string
|
|
|
|
AllAddresses() []string
|
2015-06-23 14:55:30 +02:00
|
|
|
}
|