mirror of
https://github.com/octoleo/syncthing.git
synced 2025-01-13 03:11:41 +00:00
76af9ba53d
This implements a new debug/trace infrastructure based on a slightly hacked up logger. Instead of the traditional "if debug { ... }" I've rewritten the logger to have no-op Debugln and Debugf, unless debugging has been enabled for a given "facility". The "facility" is just a string, typically a package name. This will be slightly slower than before; but not that much as it's mostly a function call that returns immediately. For the cases where it matters (the Debugln takes a hex.Dump() of something for example, and it's not in a very occasional "if err != nil" branch) there is an l.ShouldDebug(facility) that is fast enough to be used like the old "if debug". The point of all this is that we can now toggle debugging for the various packages on and off at runtime. There's a new method /rest/system/debug that can be POSTed a set of facilities to enable and disable debug for, or GET from to get a list of facilities with descriptions and their current debug status. Similarly a /rest/system/log?since=... can grab the latest log entries, up to 250 of them (hardcoded constant in main.go) plus the initial few. Not implemented in this commit (but planned) is a simple debug GUI available on /debug that shows the current log in an easily pasteable format and has checkboxes to enable the various debug facilities. The debug instructions to a user then becomes "visit this URL, check these boxes, reproduce your problem, copy and paste the log". The actual log viewer on the hypothetical /debug URL can poll regularly for new log entries and this bypass the 250 line limit. The existing STTRACE=foo variable is still obeyed and just sets the start state of the system.
283 lines
5.5 KiB
Go
283 lines
5.5 KiB
Go
// Copyright (C) 2015 Audrius Butkevicius and Contributors (see the CONTRIBUTORS file).
|
|
|
|
package client
|
|
|
|
import (
|
|
"crypto/tls"
|
|
"fmt"
|
|
"log"
|
|
"net"
|
|
"net/url"
|
|
"time"
|
|
|
|
syncthingprotocol "github.com/syncthing/syncthing/lib/protocol"
|
|
"github.com/syncthing/syncthing/lib/relay/protocol"
|
|
"github.com/syncthing/syncthing/lib/sync"
|
|
)
|
|
|
|
type ProtocolClient struct {
|
|
URI *url.URL
|
|
Invitations chan protocol.SessionInvitation
|
|
|
|
closeInvitationsOnFinish bool
|
|
|
|
config *tls.Config
|
|
|
|
timeout time.Duration
|
|
|
|
stop chan struct{}
|
|
stopped chan struct{}
|
|
|
|
conn *tls.Conn
|
|
|
|
mut sync.RWMutex
|
|
connected bool
|
|
latency time.Duration
|
|
}
|
|
|
|
func NewProtocolClient(uri *url.URL, certs []tls.Certificate, invitations chan protocol.SessionInvitation) *ProtocolClient {
|
|
closeInvitationsOnFinish := false
|
|
if invitations == nil {
|
|
closeInvitationsOnFinish = true
|
|
invitations = make(chan protocol.SessionInvitation)
|
|
}
|
|
|
|
return &ProtocolClient{
|
|
URI: uri,
|
|
Invitations: invitations,
|
|
|
|
closeInvitationsOnFinish: closeInvitationsOnFinish,
|
|
|
|
config: configForCerts(certs),
|
|
|
|
timeout: time.Minute * 2,
|
|
|
|
stop: make(chan struct{}),
|
|
stopped: make(chan struct{}),
|
|
|
|
mut: sync.NewRWMutex(),
|
|
connected: false,
|
|
}
|
|
}
|
|
|
|
func (c *ProtocolClient) Serve() {
|
|
c.stop = make(chan struct{})
|
|
c.stopped = make(chan struct{})
|
|
defer close(c.stopped)
|
|
|
|
if err := c.connect(); err != nil {
|
|
l.Debugln("Relay connect:", err)
|
|
return
|
|
}
|
|
|
|
l.Debugln(c, "connected", c.conn.RemoteAddr())
|
|
|
|
if err := c.join(); err != nil {
|
|
c.conn.Close()
|
|
l.Infoln("Relay join:", err)
|
|
return
|
|
}
|
|
|
|
if err := c.conn.SetDeadline(time.Time{}); err != nil {
|
|
l.Infoln("Relay set deadline:", err)
|
|
return
|
|
}
|
|
|
|
l.Debugln(c, "joined", c.conn.RemoteAddr(), "via", c.conn.LocalAddr())
|
|
|
|
defer c.cleanup()
|
|
c.mut.Lock()
|
|
c.connected = true
|
|
c.mut.Unlock()
|
|
|
|
messages := make(chan interface{})
|
|
errors := make(chan error, 1)
|
|
|
|
go messageReader(c.conn, messages, errors)
|
|
|
|
timeout := time.NewTimer(c.timeout)
|
|
|
|
for {
|
|
select {
|
|
case message := <-messages:
|
|
timeout.Reset(c.timeout)
|
|
log.Printf("%s received message %T", c, message)
|
|
|
|
switch msg := message.(type) {
|
|
case protocol.Ping:
|
|
if err := protocol.WriteMessage(c.conn, protocol.Pong{}); err != nil {
|
|
l.Infoln("Relay write:", err)
|
|
return
|
|
|
|
}
|
|
l.Debugln(c, "sent pong")
|
|
|
|
case protocol.SessionInvitation:
|
|
ip := net.IP(msg.Address)
|
|
if len(ip) == 0 || ip.IsUnspecified() {
|
|
msg.Address = c.conn.RemoteAddr().(*net.TCPAddr).IP[:]
|
|
}
|
|
c.Invitations <- msg
|
|
|
|
default:
|
|
l.Infoln("Relay: protocol error: unexpected message %v", msg)
|
|
return
|
|
}
|
|
|
|
case <-c.stop:
|
|
l.Debugln(c, "stopping")
|
|
return
|
|
|
|
case err := <-errors:
|
|
l.Infoln("Relay received:", err)
|
|
return
|
|
|
|
case <-timeout.C:
|
|
l.Debugln(c, "timed out")
|
|
return
|
|
}
|
|
}
|
|
}
|
|
|
|
func (c *ProtocolClient) Stop() {
|
|
if c.stop == nil {
|
|
return
|
|
}
|
|
|
|
close(c.stop)
|
|
<-c.stopped
|
|
}
|
|
|
|
func (c *ProtocolClient) StatusOK() bool {
|
|
c.mut.RLock()
|
|
con := c.connected
|
|
c.mut.RUnlock()
|
|
return con
|
|
}
|
|
|
|
func (c *ProtocolClient) Latency() time.Duration {
|
|
c.mut.RLock()
|
|
lat := c.latency
|
|
c.mut.RUnlock()
|
|
return lat
|
|
}
|
|
|
|
func (c *ProtocolClient) String() string {
|
|
return fmt.Sprintf("ProtocolClient@%p", c)
|
|
}
|
|
|
|
func (c *ProtocolClient) connect() error {
|
|
if c.URI.Scheme != "relay" {
|
|
return fmt.Errorf("Unsupported relay schema: %v", c.URI.Scheme)
|
|
}
|
|
|
|
t0 := time.Now()
|
|
tcpConn, err := net.Dial("tcp", c.URI.Host)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
c.mut.Lock()
|
|
c.latency = time.Since(t0)
|
|
c.mut.Unlock()
|
|
|
|
conn := tls.Client(tcpConn, c.config)
|
|
if err = conn.Handshake(); err != nil {
|
|
return err
|
|
}
|
|
|
|
if err := conn.SetDeadline(time.Now().Add(10 * time.Second)); err != nil {
|
|
conn.Close()
|
|
return err
|
|
}
|
|
|
|
if err := performHandshakeAndValidation(conn, c.URI); err != nil {
|
|
conn.Close()
|
|
return err
|
|
}
|
|
|
|
c.conn = conn
|
|
return nil
|
|
}
|
|
|
|
func (c *ProtocolClient) cleanup() {
|
|
if c.closeInvitationsOnFinish {
|
|
close(c.Invitations)
|
|
c.Invitations = make(chan protocol.SessionInvitation)
|
|
}
|
|
|
|
l.Debugln(c, "cleaning up")
|
|
|
|
c.mut.Lock()
|
|
c.connected = false
|
|
c.mut.Unlock()
|
|
|
|
c.conn.Close()
|
|
}
|
|
|
|
func (c *ProtocolClient) join() error {
|
|
if err := protocol.WriteMessage(c.conn, protocol.JoinRelayRequest{}); err != nil {
|
|
return err
|
|
}
|
|
|
|
message, err := protocol.ReadMessage(c.conn)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
switch msg := message.(type) {
|
|
case protocol.Response:
|
|
if msg.Code != 0 {
|
|
return fmt.Errorf("Incorrect response code %d: %s", msg.Code, msg.Message)
|
|
}
|
|
|
|
default:
|
|
return fmt.Errorf("protocol error: expecting response got %v", msg)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func performHandshakeAndValidation(conn *tls.Conn, uri *url.URL) error {
|
|
if err := conn.Handshake(); err != nil {
|
|
return err
|
|
}
|
|
|
|
cs := conn.ConnectionState()
|
|
if !cs.NegotiatedProtocolIsMutual || cs.NegotiatedProtocol != protocol.ProtocolName {
|
|
return fmt.Errorf("protocol negotiation error")
|
|
}
|
|
|
|
q := uri.Query()
|
|
relayIDs := q.Get("id")
|
|
if relayIDs != "" {
|
|
relayID, err := syncthingprotocol.DeviceIDFromString(relayIDs)
|
|
if err != nil {
|
|
return fmt.Errorf("relay address contains invalid verification id: %s", err)
|
|
}
|
|
|
|
certs := cs.PeerCertificates
|
|
if cl := len(certs); cl != 1 {
|
|
return fmt.Errorf("unexpected certificate count: %d", cl)
|
|
}
|
|
|
|
remoteID := syncthingprotocol.NewDeviceID(certs[0].Raw)
|
|
if remoteID != relayID {
|
|
return fmt.Errorf("relay id does not match. Expected %v got %v", relayID, remoteID)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func messageReader(conn net.Conn, messages chan<- interface{}, errors chan<- error) {
|
|
for {
|
|
msg, err := protocol.ReadMessage(conn)
|
|
if err != nil {
|
|
errors <- err
|
|
return
|
|
}
|
|
messages <- msg
|
|
}
|
|
}
|