// 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 Duplicati.Library.Common; using Duplicati.Library.Common.IO; using Duplicati.Library.Interface; using System; using System.Collections.Generic; using System.IO; using System.Runtime.InteropServices; using System.Threading; using System.Threading.Tasks; namespace Duplicati.Library.Backend { // ReSharper disable once UnusedMember.Global // This class is instantiated dynamically in the BackendLoader. public class File : IBackend, IStreamingBackend, IQuotaEnabledBackend, IRenameEnabledBackend { private const string OPTION_DESTINATION_MARKER = "alternate-destination-marker"; private const string OPTION_ALTERNATE_PATHS = "alternate-target-paths"; private const string OPTION_MOVE_FILE = "use-move-for-put"; private const string OPTION_FORCE_REAUTH = "force-smb-authentication"; private const string OPTION_DISABLE_LENGTH_VERIFICATION = "disable-length-verification"; private readonly string m_path; private string m_username; private string m_password; private readonly bool m_moveFile; private bool m_hasAutenticated; private readonly bool m_forceReauth; private readonly bool m_verifyDestinationLength; private readonly byte[] m_copybuffer = new byte[Utility.Utility.DEFAULT_BUFFER_SIZE]; private static readonly ISystemIO systemIO = SystemIO.IO_OS; public File() { } public File(string url, Dictionary options) { var uri = new Utility.Uri(url); m_path = uri.HostAndPath; if (options.ContainsKey("auth-username")) m_username = options["auth-username"]; if (options.ContainsKey("auth-password")) m_password = options["auth-password"]; if (!string.IsNullOrEmpty(uri.Username)) m_username = uri.Username; if (!string.IsNullOrEmpty(uri.Password)) m_password = uri.Password; if (!System.IO.Path.IsPathRooted(m_path)) m_path = systemIO.PathGetFullPath(m_path); if (options.ContainsKey(OPTION_ALTERNATE_PATHS)) { List paths = new List { m_path }; paths.AddRange(options[OPTION_ALTERNATE_PATHS].Split(new string[] { System.IO.Path.PathSeparator.ToString() }, StringSplitOptions.RemoveEmptyEntries)); //On windows we expand the drive letter * to all drives if (!Platform.IsClientPosix) { System.IO.DriveInfo[] drives = System.IO.DriveInfo.GetDrives(); for (int i = 0; i < paths.Count; i++) { if (paths[i].StartsWith("*:", StringComparison.Ordinal)) { string rpl_path = paths[i].Substring(1); paths.RemoveAt(i); i--; foreach (System.IO.DriveInfo di in drives) paths.Insert(++i, di.Name[0] + rpl_path); } } } string markerfile = null; //If there is a marker file, we do not allow the primary target path // to be accepted, unless it contains the marker file if (options.ContainsKey(OPTION_DESTINATION_MARKER)) { markerfile = options[OPTION_DESTINATION_MARKER]; m_path = null; } foreach (string p in paths) { try { if (systemIO.DirectoryExists(p) && (markerfile == null || systemIO.FileExists(systemIO.PathCombine(p, markerfile)))) { m_path = p; break; } } catch { } } if (m_path == null) throw new UserInformationException(Strings.FileBackend.NoDestinationWithMarkerFileError(markerfile, paths.ToArray()), "NoDestinationWithMarker"); } m_moveFile = Utility.Utility.ParseBoolOption(options, OPTION_MOVE_FILE); m_forceReauth = Utility.Utility.ParseBoolOption(options, OPTION_FORCE_REAUTH); m_verifyDestinationLength = Utility.Utility.ParseBoolOption(options, OPTION_DISABLE_LENGTH_VERIFICATION); m_hasAutenticated = false; } private void PreAuthenticate() { try { if (!string.IsNullOrEmpty(m_username) && m_password != null && !m_hasAutenticated) { Win32.PreAuthenticate(m_path, m_username, m_password, m_forceReauth); m_hasAutenticated = true; } } catch { } } private string GetRemoteName(string remotename) { PreAuthenticate(); if (!systemIO.DirectoryExists(m_path)) throw new FolderMissingException(Strings.FileBackend.FolderMissingError(m_path)); return systemIO.PathCombine(m_path, remotename); } #region IBackendInterface Members public string DisplayName { get { return Strings.FileBackend.DisplayName; } } public string ProtocolKey { get { return "file"; } } public IEnumerable List() { PreAuthenticate(); if (!systemIO.DirectoryExists(m_path)) throw new FolderMissingException(Strings.FileBackend.FolderMissingError(m_path)); return systemIO.EnumerateFileEntries(m_path); } #if DEBUG_RETRY private static Random random = new Random(); public async Task Put(string remotename, System.IO.Stream stream, CancellationToken cancelToken) { using(System.IO.FileStream writestream = systemIO.FileCreate(GetRemoteName(remotename))) { if (random.NextDouble() > 0.6666) throw new Exception("Random upload failure"); await Utility.Utility.CopyStreamAsync(stream, writestream, cancelToken); } } #else public async Task PutAsync(string targetFilename, Stream sourceStream, CancellationToken cancelToken) { string targetFilePath = GetRemoteName(targetFilename); long copiedBytes = 0; using (var targetStream = systemIO.FileCreate(targetFilePath)) copiedBytes = await Utility.Utility.CopyStreamAsync(sourceStream, targetStream, true, cancelToken, m_copybuffer); VerifyMatchingSize(targetFilePath, sourceStream, copiedBytes); } #endif public void Get(string remotename, System.IO.Stream stream) { // FileOpenRead has flags System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read using (System.IO.FileStream readstream = systemIO.FileOpenRead(GetRemoteName(remotename))) Utility.Utility.CopyStream(readstream, stream, true, m_copybuffer); } public Task PutAsync(string targetFilename, string sourceFilePath, CancellationToken cancelToken) { string targetFilePath = GetRemoteName(targetFilename); if (m_moveFile) { if (systemIO.FileExists(targetFilePath)) systemIO.FileDelete(targetFilePath); var sourceFileInfo = new FileInfo(sourceFilePath); var sourceFileLength = sourceFileInfo.Exists ? (long?)sourceFileInfo.Length : null; systemIO.FileMove(sourceFilePath, targetFilePath); if (m_verifyDestinationLength) VerifyMatchingSize(targetFilePath, null, sourceFileLength); } else { systemIO.FileCopy(sourceFilePath, targetFilePath, true); if (m_verifyDestinationLength) VerifyMatchingSize(targetFilePath, sourceFilePath); } return Task.FromResult(true); } public void Get(string remotename, string filename) { systemIO.FileCopy(GetRemoteName(remotename), filename, true); } public void Delete(string remotename) { systemIO.FileDelete(GetRemoteName(remotename)); } public IList SupportedCommands { get { return new List(new ICommandLineArgument[] { new CommandLineArgument("auth-password", CommandLineArgument.ArgumentType.Password, Strings.FileBackend.DescriptionAuthPasswordShort, Strings.FileBackend.DescriptionAuthPasswordLong), new CommandLineArgument("auth-username", CommandLineArgument.ArgumentType.String, Strings.FileBackend.DescriptionAuthUsernameShort, Strings.FileBackend.DescriptionAuthUsernameLong), new CommandLineArgument(OPTION_DESTINATION_MARKER, CommandLineArgument.ArgumentType.String, Strings.FileBackend.AlternateDestinationMarkerShort, Strings.FileBackend.AlternateDestinationMarkerLong(OPTION_ALTERNATE_PATHS)), new CommandLineArgument(OPTION_ALTERNATE_PATHS, CommandLineArgument.ArgumentType.Path, Strings.FileBackend.AlternateTargetPathsShort, Strings.FileBackend.AlternateTargetPathsLong(OPTION_DESTINATION_MARKER, System.IO.Path.PathSeparator)), new CommandLineArgument(OPTION_MOVE_FILE, CommandLineArgument.ArgumentType.Boolean, Strings.FileBackend.UseMoveForPutShort, Strings.FileBackend.UseMoveForPutLong), new CommandLineArgument(OPTION_FORCE_REAUTH, CommandLineArgument.ArgumentType.Boolean, Strings.FileBackend.ForceReauthShort, Strings.FileBackend.ForceReauthLong), new CommandLineArgument(OPTION_DISABLE_LENGTH_VERIFICATION, CommandLineArgument.ArgumentType.Boolean, Strings.FileBackend.DisableLengthVerificationShort, Strings.FileBackend.DisableLengthVerificationShort), }); } } public string Description { get { return Strings.FileBackend.Description; } } public void Test() { this.TestList(); } public void CreateFolder() { if (systemIO.DirectoryExists(m_path)) throw new FolderAreadyExistedException(); systemIO.DirectoryCreate(m_path); } #endregion #region IDisposable Members public void Dispose() { m_username = null; m_password = null; } #endregion private System.IO.DriveInfo GetDrive() { string root; if (Platform.IsClientPosix) { string path = Util.AppendDirSeparator(systemIO.PathGetFullPath(m_path)); root = "/"; //Find longest common prefix from mounted devices //TODO: Can trick this with symlinks, where the symlink is on one mounted volume, // and the actual storage is on another foreach (System.IO.DriveInfo di in System.IO.DriveInfo.GetDrives()) if (path.StartsWith(Util.AppendDirSeparator(di.Name), StringComparison.Ordinal) && di.Name.Length > root.Length) root = di.Name; } else { root = systemIO.GetPathRoot(m_path); } // On Windows, DriveInfo is only valid for lettered drives. (e.g., not for UNC paths and shares) // So only attempt to get it if we aren't on Windows or if the root starts with a letter. if (!Platform.IsClientWindows || (root.Length > 0 && char.IsLetter(root[0]))) { try { return new System.IO.DriveInfo(root); } catch (ArgumentException) { // If there was a problem, fall back to returning null } } return null; } public IQuotaInfo Quota { get { System.IO.DriveInfo driveInfo = this.GetDrive(); if (driveInfo != null) { return new QuotaInfo(driveInfo.TotalSize, driveInfo.AvailableFreeSpace); } if (Platform.IsClientWindows) { // If we can't get the DriveInfo on Windows, fallback to GetFreeDiskSpaceEx // https://stackoverflow.com/questions/2050343/programmatically-determining-space-available-from-unc-path return GetDiskFreeSpace(m_path); } return null; } } public string[] DNSName { get { return null; } } public void Rename(string oldname, string newname) { var source = GetRemoteName(oldname); var target = GetRemoteName(newname); if (systemIO.FileExists(target)) systemIO.FileDelete(target); systemIO.FileMove(source, target); } /// /// Get the disk free space using the Win32 API's GetDiskFreeSpaceEx function. /// /// Directory /// Quota info [System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.NoInlining)] public static QuotaInfo GetDiskFreeSpace(string directory) { ulong available; ulong total; if (WindowsDriveHelper.GetDiskFreeSpaceEx(directory, out available, out total, out _)) { return new QuotaInfo((long)total, (long)available); } else { return null; } } private static class WindowsDriveHelper { [DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Auto)] [return: MarshalAs(UnmanagedType.Bool)] public static extern bool GetDiskFreeSpaceEx( string lpDirectoryName, out ulong lpFreeBytesAvailable, out ulong lpTotalNumberOfBytes, out ulong lpTotalNumberOfFreeBytes); } private static void VerifyMatchingSize(string targetFilePath, string sourceFilePath) { try { var targetFileInfo = new FileInfo(targetFilePath); if (!targetFileInfo.Exists) throw new FileMissingException($"Target file does not exist. Target: {targetFilePath}"); var sourceFileInfo = new FileInfo(sourceFilePath); if (!sourceFileInfo.Exists) throw new FileMissingException($"Source file does not exist. Source: {sourceFilePath}"); if (targetFileInfo.Length != sourceFileInfo.Length) throw new FileMissingException($"Target file size ({targetFileInfo.Length:n0}) is different from source file size ({sourceFileInfo.Length:n0}). Target: {targetFilePath}"); } catch { try { System.IO.File.Delete(targetFilePath); } catch { } throw; } } private static void VerifyMatchingSize(string targetFilePath, Stream sourceStream, long? expectedLength) { try { var targetFileInfo = new FileInfo(targetFilePath); if (!targetFileInfo.Exists) throw new FileMissingException($"Target file does not exist. Target: {targetFilePath}"); bool isStreamPostion = false; long? sourceStreamLength = sourceStream == null ? null : Utility.Utility.GetStreamLength(sourceStream, out isStreamPostion); if (sourceStreamLength.HasValue && targetFileInfo.Length != sourceStreamLength.Value) throw new FileMissingException($"Target file size ({targetFileInfo.Length:n0}) is different from the source length ({sourceStreamLength.Value:n0}){(isStreamPostion ? " - ending stream position)" : "")}. Target: {targetFilePath}"); if (expectedLength.HasValue && targetFileInfo.Length != expectedLength.Value) throw new FileMissingException($"Target file size ({targetFileInfo.Length:n0}) is different from the expected length ({expectedLength.Value:n0}). Target: {targetFilePath}"); } catch { try { System.IO.File.Delete(targetFilePath); } catch { } throw; } } } }