// Copyright (C) 2024, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using System; using System.Collections.Generic; using System.Linq; using Duplicati.Library.Common.IO; namespace Duplicati.Library.Snapshots { /// /// Handler for providing a snapshot like access to files and folders /// public sealed class NoSnapshotWindows : SnapshotBase { /// /// Returns the symlink target if the entry is a symlink, and null otherwise /// /// The file or folder to examine /// The symlink target public override string GetSymlinkTarget(string localPath) { return SystemIO.IO_WIN.GetSymlinkTarget(localPath); } /// /// Gets the attributes for the given file or folder /// /// The file attributes /// The file or folder to examine public override System.IO.FileAttributes GetAttributes (string localPath) { return SystemIO.IO_WIN.GetFileAttributes(localPath); } /// /// Returns the size of a file /// /// The full path to the file in non-snapshot format /// The length of the file public override long GetFileSize (string localPath) { return SystemIO.IO_WIN.FileLength(localPath); } /// /// Enumerates all files and folders in the snapshot, restricted to sources /// /// Sources to enumerate /// The callback to invoke with each found path /// The callback used to report errors public override IEnumerable EnumerateFilesAndFolders(IEnumerable sources, Utility.Utility.EnumerationFilterDelegate callback, Utility.Utility.ReportAccessError errorCallback) { // For Windows, ensure we don't store paths with extended device path prefixes (i.e., @"\\?\" or @"\\?\UNC\") return base.EnumerateFilesAndFolders(sources.Select(SystemIOWindows.RemoveExtendedDevicePathPrefix), callback, errorCallback); } /// /// Gets the last write time of a given file in UTC /// /// The full path to the file in non-snapshot format /// The last write time of the file public override DateTime GetLastWriteTimeUtc (string localPath) { return SystemIO.IO_WIN.FileGetLastWriteTimeUtc(localPath); } /// /// Gets the last write time of a given file in UTC /// /// The full path to the file in non-snapshot format /// The last write time of the file public override DateTime GetCreationTimeUtc (string localPath) { return SystemIO.IO_WIN.FileGetCreationTimeUtc(localPath); } /// /// Opens a file for reading /// /// The full path to the file in non-snapshot format /// An open filestream that can be read public override System.IO.Stream OpenRead (string localPath) { return SystemIO.IO_WIN.FileOpenRead(localPath); } /// /// Lists all files in the given folder /// /// All folders found in the folder /// The folder to examinate protected override string[] ListFiles (string localFolderPath) { string[] tmp = SystemIO.IO_WIN.GetFiles(localFolderPath); string[] res = new string[tmp.Length]; for(int i = 0; i < tmp.Length; i++) res[i] = SystemIOWindows.RemoveExtendedDevicePathPrefix(tmp[i]); return res; } /// /// Lists all folders in the given folder /// /// All folders found in the folder /// The folder to examinate protected override string[] ListFolders (string localFolderPath) { string[] tmp = SystemIO.IO_WIN.GetDirectories(SystemIOWindows.AddExtendedDevicePathPrefix(localFolderPath)); string[] res = new string[tmp.Length]; for (int i = 0; i < tmp.Length; i++) res[i] = SystemIOWindows.RemoveExtendedDevicePathPrefix(tmp[i]); return res; } /// /// Gets the metadata for the given file or folder /// /// The metadata for the given file or folder /// The file or folder to examine /// A flag indicating if the target is a symlink /// A flag indicating if a symlink should be followed public override Dictionary GetMetadata(string localPath, bool isSymlink, bool followSymlink) { return SystemIO.IO_WIN.GetMetadata(localPath, isSymlink, followSymlink); } /// public override string ConvertToLocalPath(string snapshotPath) { return snapshotPath; } /// public override string ConvertToSnapshotPath(string localPath) { // For Windows, ensure we don't store paths with extended device path prefixes (i.e., @"\\?\" or @"\\?\UNC\") return SystemIOWindows.RemoveExtendedDevicePathPrefix(localPath); } } }