Files
syncthing/lib/protocol/bep_clusterconfig.go
T
Jakob BorgandGitHub 95187bcc64 chore(protocol): minor cleanup of ClusterConfig messages; remove DisableTempIndexes option (#10202)
This makes a couple of backwards compatible changes to the
ClusterConfig:

- Remove the `ignore_permissions` and `ignore_delete` booleans which
we've never read or used for anything
- Remove the `disable_temp_indexes` boolean and option entirely. We did
use this one, and about 1% of users have set the option. The only thing
it does is inhibits sending of periodical DownloadProgress messages
while downloading data, which is a minuscule bandwidth optimisation
given that we're already sending data at the time.
- Change the `read_only` boolean (which indicated send-only folders) to
an enum `FolderType`, where the values zero and one match the existing
usage. Again, we don't actually use this value, but I can see that we
might want to and then it makes more sense for it to be more
comprehensive.
- Change the `paused` boolean to an enum `StopReason`, where zero
indicates not stopped and one indicates paused, exactly the same wire
representation as previously but leaves space for additional stop
reasons (errors etc).
2025-06-29 10:18:51 +02:00

164 lines
4.2 KiB
Go

// Copyright (C) 2014 The Syncthing Authors.
//
// 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 https://mozilla.org/MPL/2.0/.
package protocol
import (
"fmt"
"github.com/syncthing/syncthing/internal/gen/bep"
)
type Compression bep.Compression
const (
CompressionMetadata = Compression(bep.Compression_COMPRESSION_METADATA)
CompressionNever = Compression(bep.Compression_COMPRESSION_NEVER)
CompressionAlways = Compression(bep.Compression_COMPRESSION_ALWAYS)
)
type FolderType bep.FolderType
const (
FolderTypeSendReceive = FolderType(bep.FolderType_FOLDER_TYPE_SEND_RECEIVE)
FolderTypeSendOnly = FolderType(bep.FolderType_FOLDER_TYPE_SEND_ONLY)
FolderTypeReceiveOnly = FolderType(bep.FolderType_FOLDER_TYPE_RECEIVE_ONLY)
FolderTypeReceiveEncrypted = FolderType(bep.FolderType_FOLDER_TYPE_RECEIVE_ENCRYPTED)
)
type FolderStopReason bep.FolderStopReason
const (
FolderStopReasonRunning = FolderStopReason(bep.FolderStopReason_FOLDER_STOP_REASON_RUNNING)
FolderStopReasonPaused = FolderStopReason(bep.FolderStopReason_FOLDER_STOP_REASON_PAUSED)
)
type ClusterConfig struct {
Folders []Folder
Secondary bool
}
func (c *ClusterConfig) toWire() *bep.ClusterConfig {
folders := make([]*bep.Folder, len(c.Folders))
for i, f := range c.Folders {
folders[i] = f.toWire()
}
return &bep.ClusterConfig{
Folders: folders,
Secondary: c.Secondary,
}
}
func clusterConfigFromWire(w *bep.ClusterConfig) *ClusterConfig {
if w == nil {
return nil
}
c := &ClusterConfig{
Secondary: w.Secondary,
}
c.Folders = make([]Folder, len(w.Folders))
for i, f := range w.Folders {
c.Folders[i] = folderFromWire(f)
}
return c
}
type Folder struct {
ID string
Label string
Type FolderType
StopReason FolderStopReason
Devices []Device
}
func (f *Folder) toWire() *bep.Folder {
devices := make([]*bep.Device, len(f.Devices))
for i, d := range f.Devices {
devices[i] = d.toWire()
}
return &bep.Folder{
Id: f.ID,
Label: f.Label,
Type: bep.FolderType(f.Type),
StopReason: bep.FolderStopReason(f.StopReason),
Devices: devices,
}
}
func folderFromWire(w *bep.Folder) Folder {
devices := make([]Device, len(w.Devices))
for i, d := range w.Devices {
devices[i] = deviceFromWire(d)
}
return Folder{
ID: w.Id,
Label: w.Label,
Type: FolderType(w.Type),
StopReason: FolderStopReason(w.StopReason),
Devices: devices,
}
}
func (f Folder) Description() string {
// used by logging stuff
if f.Label == "" {
return f.ID
}
return fmt.Sprintf("%q (%s)", f.Label, f.ID)
}
func (f Folder) IsRunning() bool {
switch f.StopReason {
case FolderStopReasonPaused:
return false
default:
return true
}
}
type Device struct {
ID DeviceID
Name string
Addresses []string
Compression Compression
CertName string
MaxSequence int64
Introducer bool
IndexID IndexID
SkipIntroductionRemovals bool
EncryptionPasswordToken []byte
}
func (d *Device) toWire() *bep.Device {
return &bep.Device{
Id: d.ID[:],
Name: d.Name,
Addresses: d.Addresses,
Compression: bep.Compression(d.Compression),
CertName: d.CertName,
MaxSequence: d.MaxSequence,
Introducer: d.Introducer,
IndexId: uint64(d.IndexID),
SkipIntroductionRemovals: d.SkipIntroductionRemovals,
EncryptionPasswordToken: d.EncryptionPasswordToken,
}
}
func deviceFromWire(w *bep.Device) Device {
return Device{
ID: DeviceID(w.Id),
Name: w.Name,
Addresses: w.Addresses,
Compression: Compression(w.Compression),
CertName: w.CertName,
MaxSequence: w.MaxSequence,
Introducer: w.Introducer,
IndexID: IndexID(w.IndexId),
SkipIntroductionRemovals: w.SkipIntroductionRemovals,
EncryptionPasswordToken: w.EncryptionPasswordToken,
}
}