// Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT license. using Microsoft.Win32.SafeHandles; using System; using System.Collections.Concurrent; using System.Collections.Generic; using System.Diagnostics; using System.IO; using System.Runtime.InteropServices; using System.Threading; namespace FASTER.core { /// /// Local storage device /// public class LocalStorageDevice : StorageDeviceBase { private readonly bool preallocateFile; private readonly bool deleteOnClose; private readonly bool disableFileBuffering; private readonly SafeConcurrentDictionary logHandles; /// /// Constructor /// /// File name (or prefix) with path /// /// /// /// The maximum number of bytes this storage device can accommondate, or CAPACITY_UNSPECIFIED if there is no such limit /// Whether to recover device metadata from existing files public LocalStorageDevice(string filename, bool preallocateFile = false, bool deleteOnClose = false, bool disableFileBuffering = true, long capacity = Devices.CAPACITY_UNSPECIFIED, bool recoverDevice = false) : base(filename, GetSectorSize(filename), capacity) { Native32.EnableProcessPrivileges(); this.preallocateFile = preallocateFile; this.deleteOnClose = deleteOnClose; this.disableFileBuffering = disableFileBuffering; logHandles = new SafeConcurrentDictionary(); if (recoverDevice) RecoverFiles(); } private void RecoverFiles() { FileInfo fi = new FileInfo(FileName); // may not exist DirectoryInfo di = fi.Directory; if (!di.Exists) return; string bareName = fi.Name; List segids = new List(); foreach (FileInfo item in di.GetFiles(bareName + "*")) { segids.Add(Int32.Parse(item.Name.Replace(bareName, "").Replace(".", ""))); } segids.Sort(); int prevSegmentId = -1; foreach (int segmentId in segids) { if (segmentId != prevSegmentId + 1) { startSegment = segmentId; } else { endSegment = segmentId; } prevSegmentId = segmentId; } // No need to populate map because logHandles use Open or create on files. } /// /// /// /// /// /// /// /// /// public override unsafe void ReadAsync(int segmentId, ulong sourceAddress, IntPtr destinationAddress, uint readLength, IOCompletionCallback callback, IAsyncResult asyncResult) { var logHandle = GetOrAddHandle(segmentId); Overlapped ov = new Overlapped(0, 0, IntPtr.Zero, asyncResult); NativeOverlapped* ovNative = ov.UnsafePack(callback, IntPtr.Zero); ovNative->OffsetLow = unchecked((int)((ulong)sourceAddress & 0xFFFFFFFF)); ovNative->OffsetHigh = unchecked((int)(((ulong)sourceAddress >> 32) & 0xFFFFFFFF)); bool result = Native32.ReadFile(logHandle, destinationAddress, readLength, out uint bytesRead, ovNative); if (!result) { int error = Marshal.GetLastWin32Error(); if (error != Native32.ERROR_IO_PENDING) { Overlapped.Unpack(ovNative); Overlapped.Free(ovNative); throw new Exception("Error reading from log file: " + error); } } } /// /// /// /// /// /// /// /// /// public override unsafe void WriteAsync(IntPtr sourceAddress, int segmentId, ulong destinationAddress, uint numBytesToWrite, IOCompletionCallback callback, IAsyncResult asyncResult) { var logHandle = GetOrAddHandle(segmentId); Overlapped ov = new Overlapped(0, 0, IntPtr.Zero, asyncResult); NativeOverlapped* ovNative = ov.UnsafePack(callback, IntPtr.Zero); ovNative->OffsetLow = unchecked((int)(destinationAddress & 0xFFFFFFFF)); ovNative->OffsetHigh = unchecked((int)((destinationAddress >> 32) & 0xFFFFFFFF)); bool result = Native32.WriteFile(logHandle, sourceAddress, numBytesToWrite, out uint bytesWritten, ovNative); if (!result) { int error = Marshal.GetLastWin32Error(); if (error != Native32.ERROR_IO_PENDING) { Overlapped.Unpack(ovNative); Overlapped.Free(ovNative); throw new Exception("Error writing to log file: " + error); } } } /// /// /// /// public override void RemoveSegment(int segment) { if (logHandles.TryRemove(segment, out SafeFileHandle logHandle)) { logHandle.Dispose(); Native32.DeleteFileW(GetSegmentName(segment)); } } /// /// /// /// /// /// public override void RemoveSegmentAsync(int segment, AsyncCallback callback, IAsyncResult result) { RemoveSegment(segment); callback(result); } // It may be somewhat inefficient to use the default async calls from the base class when the underlying // method is inherently synchronous. But just for delete (which is called infrequently and off the // critical path) such inefficiency is probably negligible. /// /// Close device /// public override void Close() { foreach (var logHandle in logHandles.Values) logHandle.Dispose(); } /// /// /// /// /// protected string GetSegmentName(int segmentId) { return FileName + "." + segmentId; } /// /// /// /// /// // Can be used to pre-load handles, e.g., after a checkpoint protected SafeFileHandle GetOrAddHandle(int _segmentId) { return logHandles.GetOrAdd(_segmentId, segmentId => CreateHandle(segmentId)); } private static uint GetSectorSize(string filename) { if (!Native32.GetDiskFreeSpace(filename.Substring(0, 3), out uint lpSectorsPerCluster, out uint _sectorSize, out uint lpNumberOfFreeClusters, out uint lpTotalNumberOfClusters)) { Debug.WriteLine("Unable to retrieve information for disk " + filename.Substring(0, 3) + " - check if the disk is available and you have specified the full path with drive name. Assuming sector size of 512 bytes."); _sectorSize = 512; } return _sectorSize; } private SafeFileHandle CreateHandle(int segmentId) { uint fileAccess = Native32.GENERIC_READ | Native32.GENERIC_WRITE; uint fileShare = unchecked(((uint)FileShare.ReadWrite & ~(uint)FileShare.Inheritable)); uint fileCreation = unchecked((uint)FileMode.OpenOrCreate); uint fileFlags = Native32.FILE_FLAG_OVERLAPPED; if (this.disableFileBuffering) { fileFlags = fileFlags | Native32.FILE_FLAG_NO_BUFFERING; } if (deleteOnClose) { fileFlags = fileFlags | Native32.FILE_FLAG_DELETE_ON_CLOSE; // FILE_SHARE_DELETE allows multiple FASTER instances to share a single log directory and each can specify deleteOnClose. // This will allow the files to persist until all handles across all instances have been closed. fileShare = fileShare | Native32.FILE_SHARE_DELETE; } var logHandle = Native32.CreateFileW( GetSegmentName(segmentId), fileAccess, fileShare, IntPtr.Zero, fileCreation, fileFlags, IntPtr.Zero); if (logHandle.IsInvalid) { var error = Marshal.GetLastWin32Error(); throw new IOException($"Error creating log file for {GetSegmentName(segmentId)}, error: {error}", Native32.MakeHRFromErrorCode(error)); } if (preallocateFile) SetFileSize(FileName, logHandle, segmentSize); try { ThreadPool.BindHandle(logHandle); } catch (Exception e) { throw new Exception("Error binding log handle for " + GetSegmentName(segmentId) + ": " + e.ToString()); } return logHandle; } /// Sets file size to the specified value. /// Does not reset file seek pointer to original location. private bool SetFileSize(string filename, SafeFileHandle logHandle, long size) { if (segmentSize <= 0) return false; if (Native32.EnableVolumePrivileges(filename, logHandle)) { return Native32.SetFileSize(logHandle, size); } int lodist = (int)size; int hidist = (int)(size >> 32); Native32.SetFilePointer(logHandle, lodist, ref hidist, Native32.EMoveMethod.Begin); if (!Native32.SetEndOfFile(logHandle)) return false; return true; } } }