// 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 config import ( "fmt" "os" "path/filepath" "runtime" "strings" "github.com/syncthing/syncthing/lib/osutil" "github.com/syncthing/syncthing/lib/protocol" ) type FolderConfiguration struct { ID string `xml:"id,attr" json:"id"` Label string `xml:"label,attr" json:"label"` RawPath string `xml:"path,attr" json:"path"` Type FolderType `xml:"type,attr" json:"type"` Devices []FolderDeviceConfiguration `xml:"device" json:"devices"` RescanIntervalS int `xml:"rescanIntervalS,attr" json:"rescanIntervalS"` IgnorePerms bool `xml:"ignorePerms,attr" json:"ignorePerms"` AutoNormalize bool `xml:"autoNormalize,attr" json:"autoNormalize"` MinDiskFree Size `xml:"minDiskFree" json:"minDiskFree"` Versioning VersioningConfiguration `xml:"versioning" json:"versioning"` Copiers int `xml:"copiers" json:"copiers"` // This defines how many files are handled concurrently. Pullers int `xml:"pullers" json:"pullers"` // Defines how many blocks are fetched at the same time, possibly between separate copier routines. Hashers int `xml:"hashers" json:"hashers"` // Less than one sets the value to the number of cores. These are CPU bound due to hashing. Order PullOrder `xml:"order" json:"order"` IgnoreDelete bool `xml:"ignoreDelete" json:"ignoreDelete"` ScanProgressIntervalS int `xml:"scanProgressIntervalS" json:"scanProgressIntervalS"` // Set to a negative value to disable. Value of 0 will get replaced with value of 2 (default value) PullerSleepS int `xml:"pullerSleepS" json:"pullerSleepS"` PullerPauseS int `xml:"pullerPauseS" json:"pullerPauseS"` MaxConflicts int `xml:"maxConflicts" json:"maxConflicts"` DisableSparseFiles bool `xml:"disableSparseFiles" json:"disableSparseFiles"` DisableTempIndexes bool `xml:"disableTempIndexes" json:"disableTempIndexes"` Fsync bool `xml:"fsync" json:"fsync"` Paused bool `xml:"paused" json:"paused"` WeakHashThresholdPct int `xml:"weakHashThresholdPct" json:"weakHashThresholdPct"` // Use weak hash if more than X percent of the file has changed. Set to -1 to always use weak hash. cachedPath string DeprecatedReadOnly bool `xml:"ro,attr,omitempty" json:"-"` DeprecatedMinDiskFreePct float64 `xml:"minDiskFreePct,omitempty" json:"-"` } type FolderDeviceConfiguration struct { DeviceID protocol.DeviceID `xml:"id,attr" json:"deviceID"` IntroducedBy protocol.DeviceID `xml:"introducedBy,attr" json:"introducedBy"` } func NewFolderConfiguration(id, path string) FolderConfiguration { f := FolderConfiguration{ ID: id, RawPath: path, } f.prepare() return f } func (f FolderConfiguration) Copy() FolderConfiguration { c := f c.Devices = make([]FolderDeviceConfiguration, len(f.Devices)) copy(c.Devices, f.Devices) c.Versioning = f.Versioning.Copy() return c } func (f FolderConfiguration) Path() string { // This is intentionally not a pointer method, because things like // cfg.Folders["default"].Path() should be valid. if f.cachedPath == "" && f.RawPath != "" { l.Infoln("bug: uncached path call (should only happen in tests)") return f.cleanedPath() } return f.cachedPath } func (f *FolderConfiguration) CreateMarker() error { if !f.HasMarker() { marker := filepath.Join(f.Path(), ".stfolder") fd, err := os.Create(marker) if err != nil { return err } fd.Close() if err := osutil.SyncDir(filepath.Dir(marker)); err != nil { l.Infof("fsync %q failed: %v", filepath.Dir(marker), err) } osutil.HideFile(marker) } return nil } func (f *FolderConfiguration) HasMarker() bool { _, err := os.Stat(filepath.Join(f.Path(), ".stfolder")) return err == nil } func (f *FolderConfiguration) CreateRoot() (err error) { // Directory permission bits. Will be filtered down to something // sane by umask on Unixes. permBits := os.FileMode(0777) if runtime.GOOS == "windows" { // Windows has no umask so we must chose a safer set of bits to // begin with. permBits = 0700 } if _, err = os.Stat(f.Path()); os.IsNotExist(err) { if err = osutil.MkdirAll(f.Path(), permBits); err != nil { l.Warnf("Creating directory for %v: %v", f.Description(), err) } } return err } func (f FolderConfiguration) Description() string { if f.Label == "" { return f.ID } return fmt.Sprintf("%q (%s)", f.Label, f.ID) } func (f *FolderConfiguration) DeviceIDs() []protocol.DeviceID { deviceIDs := make([]protocol.DeviceID, len(f.Devices)) for i, n := range f.Devices { deviceIDs[i] = n.DeviceID } return deviceIDs } func (f *FolderConfiguration) prepare() { if f.RawPath != "" { // The reason it's done like this: // C: -> C:\ -> C:\ (issue that this is trying to fix) // C:\somedir -> C:\somedir\ -> C:\somedir // C:\somedir\ -> C:\somedir\\ -> C:\somedir // This way in the tests, we get away without OS specific separators // in the test configs. f.RawPath = filepath.Dir(f.RawPath + string(filepath.Separator)) // If we're not on Windows, we want the path to end with a slash to // penetrate symlinks. On Windows, paths must not end with a slash. if runtime.GOOS != "windows" && f.RawPath[len(f.RawPath)-1] != filepath.Separator { f.RawPath = f.RawPath + string(filepath.Separator) } } f.cachedPath = f.cleanedPath() if f.RescanIntervalS > MaxRescanIntervalS { f.RescanIntervalS = MaxRescanIntervalS } else if f.RescanIntervalS < 0 { f.RescanIntervalS = 0 } if f.Versioning.Params == nil { f.Versioning.Params = make(map[string]string) } if f.WeakHashThresholdPct == 0 { f.WeakHashThresholdPct = 25 } } func (f *FolderConfiguration) cleanedPath() string { if f.RawPath == "" { return "" } cleaned := f.RawPath // Attempt tilde expansion; leave unchanged in case of error if path, err := osutil.ExpandTilde(cleaned); err == nil { cleaned = path } // Attempt absolutification; leave unchanged in case of error if !filepath.IsAbs(cleaned) { // Abs() looks like a fairly expensive syscall on Windows, while // IsAbs() is a whole bunch of string mangling. I think IsAbs() may be // somewhat faster in the general case, hence the outer if... if path, err := filepath.Abs(cleaned); err == nil { cleaned = path } } // Attempt to enable long filename support on Windows. We may still not // have an absolute path here if the previous steps failed. if runtime.GOOS == "windows" && filepath.IsAbs(cleaned) && !strings.HasPrefix(f.RawPath, `\\`) { return `\\?\` + cleaned } // If we're not on Windows, we want the path to end with a slash to // penetrate symlinks. On Windows, paths must not end with a slash. if runtime.GOOS != "windows" && cleaned[len(cleaned)-1] != filepath.Separator { cleaned = cleaned + string(filepath.Separator) } return cleaned } type FolderDeviceConfigurationList []FolderDeviceConfiguration func (l FolderDeviceConfigurationList) Less(a, b int) bool { return l[a].DeviceID.Compare(l[b].DeviceID) == -1 } func (l FolderDeviceConfigurationList) Swap(a, b int) { l[a], l[b] = l[b], l[a] } func (l FolderDeviceConfigurationList) Len() int { return len(l) }