// 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);
}
}
}