// Copyright (C) 2015 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 versioner import ( "context" "fmt" "strconv" "time" "github.com/syncthing/syncthing/lib/config" "github.com/syncthing/syncthing/lib/fs" ) func init() { // Register the constructor for this type of versioner factories["trashcan"] = newTrashcan } type trashcan struct { folderFs fs.Filesystem versionsFs fs.Filesystem cleanoutDays int copyRangeMethod fs.CopyRangeMethod } func newTrashcan(cfg config.FolderConfiguration) Versioner { cleanoutDays, _ := strconv.Atoi(cfg.Versioning.Params["cleanoutDays"]) // On error we default to 0, "do not clean out the trash can" s := &trashcan{ folderFs: cfg.Filesystem(nil), versionsFs: versionerFsFromFolderCfg(cfg), cleanoutDays: cleanoutDays, copyRangeMethod: cfg.CopyRangeMethod, } l.Debugf("instantiated %#v", s) return s } // Archive moves the named file away to a version archive. If this function // returns nil, the named file does not exist any more (has been archived). func (t *trashcan) Archive(filePath string) error { return archiveFile(t.copyRangeMethod, t.folderFs, t.versionsFs, filePath, func(name, tag string) string { return name }) } func (t *trashcan) String() string { return fmt.Sprintf("trashcan@%p", t) } func (t *trashcan) Clean(ctx context.Context) error { return cleanByDay(ctx, t.versionsFs, t.cleanoutDays) } func (t *trashcan) GetVersions() (map[string][]FileVersion, error) { return retrieveVersions(t.versionsFs) } func (t *trashcan) Restore(filepath string, versionTime time.Time) error { // If we have an untagged file A and want to restore it on top of existing file A, we can't first archive the // existing A as we'd overwrite the old A version, therefore when we archive existing file, we archive it with a // tag but when the restoration is finished, we rename it (untag it). This is only important if when restoring A, // there already exists a file at the same location taggedName := "" tagger := func(name, tag string) string { // We also abuse the fact that tagger gets called twice, once for tagging the restoration version, which // should just return the plain name, and second time by archive which archives existing file in the folder. // We can't use TagFilename here, as restoreFile would discover that as a valid version and restore that instead. if taggedName != "" { return taggedName } taggedName = fs.TempName(name) return name } err := restoreFile(t.copyRangeMethod, t.versionsFs, t.folderFs, filepath, versionTime, tagger) if taggedName == "" { return err } return t.versionsFs.Rename(taggedName, filepath) }