// 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 db import ( "bytes" "github.com/syncthing/syncthing/lib/db/backend" "github.com/syncthing/syncthing/lib/protocol" ) // A readOnlyTransaction represents a database snapshot. type readOnlyTransaction struct { backend.ReadTransaction keyer keyer } func (db *Lowlevel) newReadOnlyTransaction() (readOnlyTransaction, error) { tran, err := db.NewReadTransaction() if err != nil { return readOnlyTransaction{}, err } return readOnlyTransaction{ ReadTransaction: tran, keyer: db.keyer, }, nil } func (t readOnlyTransaction) close() { t.Release() } func (t readOnlyTransaction) getFile(folder, device, file []byte) (protocol.FileInfo, bool, error) { key, err := t.keyer.GenerateDeviceFileKey(nil, folder, device, file) if err != nil { return protocol.FileInfo{}, false, err } return t.getFileByKey(key) } func (t readOnlyTransaction) getFileByKey(key []byte) (protocol.FileInfo, bool, error) { f, ok, err := t.getFileTrunc(key, false) if err != nil || !ok { return protocol.FileInfo{}, false, err } return f.(protocol.FileInfo), true, nil } func (t readOnlyTransaction) getFileTrunc(key []byte, trunc bool) (FileIntf, bool, error) { bs, err := t.Get(key) if backend.IsNotFound(err) { return nil, false, nil } if err != nil { return nil, false, err } f, err := t.unmarshalTrunc(bs, trunc) if backend.IsNotFound(err) { return nil, false, nil } if err != nil { return nil, false, err } return f, true, nil } func (t readOnlyTransaction) unmarshalTrunc(bs []byte, trunc bool) (FileIntf, error) { if trunc { var tf FileInfoTruncated err := tf.Unmarshal(bs) if err != nil { return nil, err } return tf, nil } var fi protocol.FileInfo if err := fi.Unmarshal(bs); err != nil { return nil, err } if err := t.fillFileInfo(&fi); err != nil { return nil, err } return fi, nil } // fillFileInfo follows the (possible) indirection of blocks and fills it out. func (t readOnlyTransaction) fillFileInfo(fi *protocol.FileInfo) error { var key []byte if len(fi.Blocks) == 0 && len(fi.BlocksHash) != 0 { // The blocks list is indirected and we need to load it. key = t.keyer.GenerateBlockListKey(key, fi.BlocksHash) bs, err := t.Get(key) if err != nil { return err } var bl BlockList if err := bl.Unmarshal(bs); err != nil { return err } fi.Blocks = bl.Blocks } return nil } func (t readOnlyTransaction) getGlobal(keyBuf, folder, file []byte, truncate bool) ([]byte, FileIntf, bool, error) { var err error keyBuf, err = t.keyer.GenerateGlobalVersionKey(keyBuf, folder, file) if err != nil { return nil, nil, false, err } bs, err := t.Get(keyBuf) if backend.IsNotFound(err) { return keyBuf, nil, false, nil } if err != nil { return nil, nil, false, err } vl, ok := unmarshalVersionList(bs) if !ok { return keyBuf, nil, false, nil } keyBuf, err = t.keyer.GenerateDeviceFileKey(keyBuf, folder, vl.Versions[0].Device, file) if err != nil { return nil, nil, false, err } fi, ok, err := t.getFileTrunc(keyBuf, truncate) if err != nil || !ok { return keyBuf, nil, false, err } return keyBuf, fi, true, nil } func (t *readOnlyTransaction) withHave(folder, device, prefix []byte, truncate bool, fn Iterator) error { if len(prefix) > 0 { unslashedPrefix := prefix if bytes.HasSuffix(prefix, []byte{'/'}) { unslashedPrefix = unslashedPrefix[:len(unslashedPrefix)-1] } else { prefix = append(prefix, '/') } key, err := t.keyer.GenerateDeviceFileKey(nil, folder, device, unslashedPrefix) if err != nil { return err } if f, ok, err := t.getFileTrunc(key, true); err != nil { return err } else if ok && !fn(f) { return nil } } key, err := t.keyer.GenerateDeviceFileKey(nil, folder, device, prefix) if err != nil { return err } dbi, err := t.NewPrefixIterator(key) if err != nil { return err } defer dbi.Release() for dbi.Next() { name := t.keyer.NameFromDeviceFileKey(dbi.Key()) if len(prefix) > 0 && !bytes.HasPrefix(name, prefix) { return nil } f, err := t.unmarshalTrunc(dbi.Value(), truncate) if err != nil { l.Debugln("unmarshal error:", err) continue } if !fn(f) { return nil } } return dbi.Error() } func (t *readOnlyTransaction) withHaveSequence(folder []byte, startSeq int64, fn Iterator) error { first, err := t.keyer.GenerateSequenceKey(nil, folder, startSeq) if err != nil { return err } last, err := t.keyer.GenerateSequenceKey(nil, folder, maxInt64) if err != nil { return err } dbi, err := t.NewRangeIterator(first, last) if err != nil { return err } defer dbi.Release() for dbi.Next() { f, ok, err := t.getFileByKey(dbi.Value()) if err != nil { return err } if !ok { l.Debugln("missing file for sequence number", t.keyer.SequenceFromSequenceKey(dbi.Key())) continue } if shouldDebug() { if seq := t.keyer.SequenceFromSequenceKey(dbi.Key()); f.Sequence != seq { l.Warnf("Sequence index corruption (folder %v, file %v): sequence %d != expected %d", string(folder), f.Name, f.Sequence, seq) panic("sequence index corruption") } } if !fn(f) { return nil } } return dbi.Error() } func (t *readOnlyTransaction) withGlobal(folder, prefix []byte, truncate bool, fn Iterator) error { if len(prefix) > 0 { unslashedPrefix := prefix if bytes.HasSuffix(prefix, []byte{'/'}) { unslashedPrefix = unslashedPrefix[:len(unslashedPrefix)-1] } else { prefix = append(prefix, '/') } if _, f, ok, err := t.getGlobal(nil, folder, unslashedPrefix, truncate); err != nil { return err } else if ok && !fn(f) { return nil } } key, err := t.keyer.GenerateGlobalVersionKey(nil, folder, prefix) if err != nil { return err } dbi, err := t.NewPrefixIterator(key) if err != nil { return err } defer dbi.Release() var dk []byte for dbi.Next() { name := t.keyer.NameFromGlobalVersionKey(dbi.Key()) if len(prefix) > 0 && !bytes.HasPrefix(name, prefix) { return nil } vl, ok := unmarshalVersionList(dbi.Value()) if !ok { continue } dk, err = t.keyer.GenerateDeviceFileKey(dk, folder, vl.Versions[0].Device, name) if err != nil { return err } f, ok, err := t.getFileTrunc(dk, truncate) if err != nil { return err } if !ok { continue } if !fn(f) { return nil } } if err != nil { return err } return dbi.Error() } func (t *readOnlyTransaction) availability(folder, file []byte) ([]protocol.DeviceID, error) { k, err := t.keyer.GenerateGlobalVersionKey(nil, folder, file) if err != nil { return nil, err } bs, err := t.Get(k) if backend.IsNotFound(err) { return nil, nil } if err != nil { return nil, err } vl, ok := unmarshalVersionList(bs) if !ok { return nil, nil } var devices []protocol.DeviceID for _, v := range vl.Versions { if !v.Version.Equal(vl.Versions[0].Version) { break } if v.Invalid { continue } n := protocol.DeviceIDFromBytes(v.Device) devices = append(devices, n) } return devices, nil } func (t *readOnlyTransaction) withNeed(folder, device []byte, truncate bool, fn Iterator) error { if bytes.Equal(device, protocol.LocalDeviceID[:]) { return t.withNeedLocal(folder, truncate, fn) } key, err := t.keyer.GenerateGlobalVersionKey(nil, folder, nil) if err != nil { return err } dbi, err := t.NewPrefixIterator(key.WithoutName()) if err != nil { return err } defer dbi.Release() var dk []byte devID := protocol.DeviceIDFromBytes(device) for dbi.Next() { vl, ok := unmarshalVersionList(dbi.Value()) if !ok { continue } haveFV, have := vl.Get(device) // XXX: This marks Concurrent (i.e. conflicting) changes as // needs. Maybe we should do that, but it needs special // handling in the puller. if have && haveFV.Version.GreaterEqual(vl.Versions[0].Version) { continue } name := t.keyer.NameFromGlobalVersionKey(dbi.Key()) needVersion := vl.Versions[0].Version needDevice := protocol.DeviceIDFromBytes(vl.Versions[0].Device) for i := range vl.Versions { if !vl.Versions[i].Version.Equal(needVersion) { // We haven't found a valid copy of the file with the needed version. break } if vl.Versions[i].Invalid { // The file is marked invalid, don't use it. continue } dk, err = t.keyer.GenerateDeviceFileKey(dk, folder, vl.Versions[i].Device, name) if err != nil { return err } gf, ok, err := t.getFileTrunc(dk, truncate) if err != nil { return err } if !ok { continue } if gf.IsDeleted() && !have { // We don't need deleted files that we don't have break } l.Debugf("need folder=%q device=%v name=%q have=%v invalid=%v haveV=%v globalV=%v globalDev=%v", folder, devID, name, have, haveFV.Invalid, haveFV.Version, needVersion, needDevice) if !fn(gf) { return nil } // This file is handled, no need to look further in the version list break } } return dbi.Error() } func (t *readOnlyTransaction) withNeedLocal(folder []byte, truncate bool, fn Iterator) error { key, err := t.keyer.GenerateNeedFileKey(nil, folder, nil) if err != nil { return err } dbi, err := t.NewPrefixIterator(key.WithoutName()) if err != nil { return err } defer dbi.Release() var keyBuf []byte var f FileIntf var ok bool for dbi.Next() { keyBuf, f, ok, err = t.getGlobal(keyBuf, folder, t.keyer.NameFromGlobalVersionKey(dbi.Key()), truncate) if err != nil { return err } if !ok { continue } if !fn(f) { return nil } } return dbi.Error() } // A readWriteTransaction is a readOnlyTransaction plus a batch for writes. // The batch will be committed on close() or by checkFlush() if it exceeds the // batch size. type readWriteTransaction struct { backend.WriteTransaction readOnlyTransaction } func (db *Lowlevel) newReadWriteTransaction() (readWriteTransaction, error) { tran, err := db.NewWriteTransaction() if err != nil { return readWriteTransaction{}, err } return readWriteTransaction{ WriteTransaction: tran, readOnlyTransaction: readOnlyTransaction{ ReadTransaction: tran, keyer: db.keyer, }, }, nil } func (t readWriteTransaction) Commit() error { t.readOnlyTransaction.close() return t.WriteTransaction.Commit() } func (t readWriteTransaction) close() { t.readOnlyTransaction.close() t.WriteTransaction.Release() } func (t readWriteTransaction) putFile(fkey []byte, fi protocol.FileInfo) error { var bkey []byte // Always set the blocks hash when there are blocks. if len(fi.Blocks) > 0 { fi.BlocksHash = protocol.BlocksHash(fi.Blocks) } else { fi.BlocksHash = nil } // Indirect the blocks if the block list is large enough. if len(fi.Blocks) > blocksIndirectionCutoff { bkey = t.keyer.GenerateBlockListKey(bkey, fi.BlocksHash) if _, err := t.Get(bkey); backend.IsNotFound(err) { // Marshal the block list and save it blocksBs := mustMarshal(&BlockList{Blocks: fi.Blocks}) if err := t.Put(bkey, blocksBs); err != nil { return err } } else if err != nil { return err } fi.Blocks = nil } fiBs := mustMarshal(&fi) return t.Put(fkey, fiBs) } // updateGlobal adds this device+version to the version list for the given // file. If the device is already present in the list, the version is updated. // If the file does not have an entry in the global list, it is created. func (t readWriteTransaction) updateGlobal(gk, keyBuf, folder, device []byte, file protocol.FileInfo, meta *metadataTracker) ([]byte, bool, error) { l.Debugf("update global; folder=%q device=%v file=%q version=%v invalid=%v", folder, protocol.DeviceIDFromBytes(device), file.Name, file.Version, file.IsInvalid()) var fl VersionList svl, err := t.Get(gk) if err == nil { _ = fl.Unmarshal(svl) // Ignore error, continue with empty fl } else if !backend.IsNotFound(err) { return nil, false, err } fl, removedFV, removedAt, insertedAt, err := fl.update(folder, device, file, t.readOnlyTransaction) if err != nil { return nil, false, err } if insertedAt == -1 { l.Debugln("update global; same version, global unchanged") return keyBuf, false, nil } name := []byte(file.Name) var global protocol.FileInfo if insertedAt == 0 { // Inserted a new newest version global = file } else { keyBuf, err = t.keyer.GenerateDeviceFileKey(keyBuf, folder, fl.Versions[0].Device, name) if err != nil { return nil, false, err } new, ok, err := t.getFileByKey(keyBuf) if err != nil || !ok { return keyBuf, false, err } global = new } // Fixup the list of files we need. keyBuf, err = t.updateLocalNeed(keyBuf, folder, name, fl, global) if err != nil { return nil, false, err } if removedAt != 0 && insertedAt != 0 { l.Debugf(`new global for "%v" after update: %v`, file.Name, fl) if err := t.Put(gk, mustMarshal(&fl)); err != nil { return nil, false, err } return keyBuf, true, nil } // Remove the old global from the global size counter var oldGlobalFV FileVersion if removedAt == 0 { oldGlobalFV = removedFV } else if len(fl.Versions) > 1 { // The previous newest version is now at index 1 oldGlobalFV = fl.Versions[1] } keyBuf, err = t.keyer.GenerateDeviceFileKey(keyBuf, folder, oldGlobalFV.Device, name) if err != nil { return nil, false, err } oldFile, ok, err := t.getFileByKey(keyBuf) if err != nil { return nil, false, err } if ok { // A failure to get the file here is surprising and our // global size data will be incorrect until a restart... meta.removeFile(protocol.GlobalDeviceID, oldFile) } // Add the new global to the global size counter meta.addFile(protocol.GlobalDeviceID, global) l.Debugf(`new global for "%v" after update: %v`, file.Name, fl) if err := t.Put(gk, mustMarshal(&fl)); err != nil { return nil, false, err } return keyBuf, true, nil } // updateLocalNeed checks whether the given file is still needed on the local // device according to the version list and global FileInfo given and updates // the db accordingly. func (t readWriteTransaction) updateLocalNeed(keyBuf, folder, name []byte, fl VersionList, global protocol.FileInfo) ([]byte, error) { var err error keyBuf, err = t.keyer.GenerateNeedFileKey(keyBuf, folder, name) if err != nil { return nil, err } _, err = t.Get(keyBuf) if err != nil && !backend.IsNotFound(err) { return nil, err } hasNeeded := err == nil if localFV, haveLocalFV := fl.Get(protocol.LocalDeviceID[:]); need(global, haveLocalFV, localFV.Version) { if !hasNeeded { l.Debugf("local need insert; folder=%q, name=%q", folder, name) if err := t.Put(keyBuf, nil); err != nil { return nil, err } } } else if hasNeeded { l.Debugf("local need delete; folder=%q, name=%q", folder, name) if err := t.Delete(keyBuf); err != nil { return nil, err } } return keyBuf, nil } func need(global FileIntf, haveLocal bool, localVersion protocol.Vector) bool { // We never need an invalid file. if global.IsInvalid() { return false } // We don't need a deleted file if we don't have it. if global.IsDeleted() && !haveLocal { return false } // We don't need the global file if we already have the same version. if haveLocal && localVersion.GreaterEqual(global.FileVersion()) { return false } return true } // removeFromGlobal removes the device from the global version list for the // given file. If the version list is empty after this, the file entry is // removed entirely. func (t readWriteTransaction) removeFromGlobal(gk, keyBuf, folder, device []byte, file []byte, meta *metadataTracker) ([]byte, error) { l.Debugf("remove from global; folder=%q device=%v file=%q", folder, protocol.DeviceIDFromBytes(device), file) svl, err := t.Get(gk) if backend.IsNotFound(err) { // We might be called to "remove" a global version that doesn't exist // if the first update for the file is already marked invalid. return keyBuf, nil } else if err != nil { return nil, err } var fl VersionList err = fl.Unmarshal(svl) if err != nil { return nil, err } fl, _, removedAt := fl.pop(device) if removedAt == -1 { // There is no version for the given device return keyBuf, nil } if removedAt == 0 { // A failure to get the file here is surprising and our // global size data will be incorrect until a restart... keyBuf, err = t.keyer.GenerateDeviceFileKey(keyBuf, folder, device, file) if err != nil { return nil, err } if f, ok, err := t.getFileByKey(keyBuf); err != nil { return keyBuf, nil } else if ok { meta.removeFile(protocol.GlobalDeviceID, f) } } if len(fl.Versions) == 0 { keyBuf, err = t.keyer.GenerateNeedFileKey(keyBuf, folder, file) if err != nil { return nil, err } if err := t.Delete(keyBuf); err != nil { return nil, err } if err := t.Delete(gk); err != nil { return nil, err } return keyBuf, nil } if removedAt == 0 { keyBuf, err = t.keyer.GenerateDeviceFileKey(keyBuf, folder, fl.Versions[0].Device, file) if err != nil { return nil, err } global, ok, err := t.getFileByKey(keyBuf) if err != nil || !ok { return keyBuf, err } keyBuf, err = t.updateLocalNeed(keyBuf, folder, file, fl, global) if err != nil { return nil, err } meta.addFile(protocol.GlobalDeviceID, global) } l.Debugf("new global after remove: %v", fl) if err := t.Put(gk, mustMarshal(&fl)); err != nil { return nil, err } return keyBuf, nil } func (t readWriteTransaction) deleteKeyPrefix(prefix []byte) error { dbi, err := t.NewPrefixIterator(prefix) if err != nil { return err } defer dbi.Release() for dbi.Next() { if err := t.Delete(dbi.Key()); err != nil { return err } } return dbi.Error() } func (t *readWriteTransaction) withAllFolderTruncated(folder []byte, fn func(device []byte, f FileInfoTruncated) bool) error { key, err := t.keyer.GenerateDeviceFileKey(nil, folder, nil, nil) if err != nil { return err } dbi, err := t.NewPrefixIterator(key.WithoutNameAndDevice()) if err != nil { return err } defer dbi.Release() var gk, keyBuf []byte for dbi.Next() { device, ok := t.keyer.DeviceFromDeviceFileKey(dbi.Key()) if !ok { // Not having the device in the index is bad. Clear it. if err := t.Delete(dbi.Key()); err != nil { return err } continue } intf, err := t.unmarshalTrunc(dbi.Value(), true) if err != nil { return err } f := intf.(FileInfoTruncated) switch f.Name { case "", ".", "..", "/": // A few obviously invalid filenames l.Infof("Dropping invalid filename %q from database", f.Name) name := []byte(f.Name) gk, err = t.keyer.GenerateGlobalVersionKey(gk, folder, name) if err != nil { return err } keyBuf, err = t.removeFromGlobal(gk, keyBuf, folder, device, name, nil) if err != nil { return err } if err := t.Delete(dbi.Key()); err != nil { return err } continue } if !fn(device, f) { return nil } } return dbi.Error() } type marshaller interface { Marshal() ([]byte, error) } func mustMarshal(f marshaller) []byte { bs, err := f.Marshal() if err != nil { panic(err) } return bs }