/* Copyright 2015 Google Inc. All Rights Reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ==============================================================================*/ #include #include #include #include #include #include #undef StrCat #include #include #include #include #include "tensorflow/core/lib/core/error_codes.pb.h" #include "tensorflow/core/lib/strings/strcat.h" #include "tensorflow/core/platform/env.h" #include "tensorflow/core/platform/file_system_helper.h" #include "tensorflow/core/platform/logging.h" #include "tensorflow/core/platform/posix/error.h" #include "tensorflow/core/platform/windows/error.h" #include "tensorflow/core/platform/windows/wide_char.h" #include "tensorflow/core/platform/windows/windows_file_system.h" // TODO(mrry): Prevent this Windows.h #define from leaking out of our headers. #undef DeleteFile namespace tensorflow { namespace { // RAII helpers for HANDLEs const auto CloseHandleFunc = [](HANDLE h) { ::CloseHandle(h); }; typedef std::unique_ptr UniqueCloseHandlePtr; inline Status IOErrorFromWindowsError(const string& context, DWORD err) { return IOError( context + string(" : ") + internal::GetWindowsErrorMessage(err), err); } // PLEASE NOTE: hfile is expected to be an async handle // (i.e. opened with FILE_FLAG_OVERLAPPED) SSIZE_T pread(HANDLE hfile, char* src, size_t num_bytes, uint64_t offset) { assert(num_bytes <= std::numeric_limits::max()); OVERLAPPED overlapped = {0}; ULARGE_INTEGER offset_union; offset_union.QuadPart = offset; overlapped.Offset = offset_union.LowPart; overlapped.OffsetHigh = offset_union.HighPart; overlapped.hEvent = ::CreateEvent(NULL, TRUE, FALSE, NULL); if (NULL == overlapped.hEvent) { return -1; } SSIZE_T result = 0; unsigned long bytes_read = 0; DWORD last_error = ERROR_SUCCESS; BOOL read_result = ::ReadFile(hfile, src, static_cast(num_bytes), &bytes_read, &overlapped); if (TRUE == read_result) { result = bytes_read; } else if ((FALSE == read_result) && ((last_error = GetLastError()) != ERROR_IO_PENDING)) { result = (last_error == ERROR_HANDLE_EOF) ? 0 : -1; } else { if (ERROR_IO_PENDING == last_error) { // Otherwise bytes_read already has the result. BOOL overlapped_result = ::GetOverlappedResult(hfile, &overlapped, &bytes_read, TRUE); if (FALSE == overlapped_result) { result = (::GetLastError() == ERROR_HANDLE_EOF) ? 0 : -1; } else { result = bytes_read; } } } ::CloseHandle(overlapped.hEvent); return result; } // read() based random-access class WindowsRandomAccessFile : public RandomAccessFile { private: string filename_; HANDLE hfile_; public: WindowsRandomAccessFile(const string& fname, HANDLE hfile) : filename_(fname), hfile_(hfile) {} ~WindowsRandomAccessFile() override { if (hfile_ != NULL && hfile_ != INVALID_HANDLE_VALUE) { ::CloseHandle(hfile_); } } Status Read(uint64 offset, size_t n, StringPiece* result, char* scratch) const override { Status s; char* dst = scratch; while (n > 0 && s.ok()) { SSIZE_T r = pread(hfile_, dst, n, offset); if (r > 0) { offset += r; dst += r; n -= r; } else if (r == 0) { s = Status(error::OUT_OF_RANGE, "Read fewer bytes than requested"); } else if (errno == EINTR || errno == EAGAIN) { // Retry } else { s = IOError(filename_, errno); } } *result = StringPiece(scratch, dst - scratch); return s; } }; class WindowsWritableFile : public WritableFile { private: string filename_; HANDLE hfile_; public: WindowsWritableFile(const string& fname, HANDLE hFile) : filename_(fname), hfile_(hFile) {} ~WindowsWritableFile() override { if (hfile_ != NULL && hfile_ != INVALID_HANDLE_VALUE) { WindowsWritableFile::Close(); } } Status Append(StringPiece data) override { DWORD bytes_written = 0; DWORD data_size = static_cast(data.size()); BOOL write_result = ::WriteFile(hfile_, data.data(), data_size, &bytes_written, NULL); if (FALSE == write_result) { return IOErrorFromWindowsError("Failed to WriteFile: " + filename_, ::GetLastError()); } assert(size_t(bytes_written) == data.size()); return Status::OK(); } Status Close() override { assert(INVALID_HANDLE_VALUE != hfile_); Status result = Flush(); if (!result.ok()) { return result; } if (FALSE == ::CloseHandle(hfile_)) { return IOErrorFromWindowsError("CloseHandle failed for: " + filename_, ::GetLastError()); } hfile_ = INVALID_HANDLE_VALUE; return Status::OK(); } Status Flush() override { if (FALSE == ::FlushFileBuffers(hfile_)) { return IOErrorFromWindowsError( "FlushFileBuffers failed for: " + filename_, ::GetLastError()); } return Status::OK(); } Status Sync() override { return Flush(); } }; class WinReadOnlyMemoryRegion : public ReadOnlyMemoryRegion { private: const std::string filename_; HANDLE hfile_; HANDLE hmap_; const void* const address_; const uint64 length_; public: WinReadOnlyMemoryRegion(const std::string& filename, HANDLE hfile, HANDLE hmap, const void* address, uint64 length) : filename_(filename), hfile_(hfile), hmap_(hmap), address_(address), length_(length) {} ~WinReadOnlyMemoryRegion() { BOOL ret = ::UnmapViewOfFile(address_); assert(ret); ret = ::CloseHandle(hmap_); assert(ret); ret = ::CloseHandle(hfile_); assert(ret); } const void* data() override { return address_; } uint64 length() override { return length_; } }; } // namespace Status WindowsFileSystem::NewRandomAccessFile( const string& fname, std::unique_ptr* result) { string translated_fname = TranslateName(fname); std::wstring ws_translated_fname = Utf8ToWideChar(translated_fname); result->reset(); // Open the file for read-only random access // Open in async mode which makes Windows allow more parallelism even // if we need to do sync I/O on top of it. DWORD file_flags = FILE_ATTRIBUTE_READONLY | FILE_FLAG_OVERLAPPED; // Shared access is necessary for tests to pass // almost all tests would work with a possible exception of fault_injection. DWORD share_mode = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE; HANDLE hfile = ::CreateFileW(ws_translated_fname.c_str(), GENERIC_READ, share_mode, NULL, OPEN_EXISTING, file_flags, NULL); if (INVALID_HANDLE_VALUE == hfile) { string context = "NewRandomAccessFile failed to Create/Open: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } result->reset(new WindowsRandomAccessFile(translated_fname, hfile)); return Status::OK(); } Status WindowsFileSystem::NewWritableFile( const string& fname, std::unique_ptr* result) { string translated_fname = TranslateName(fname); std::wstring ws_translated_fname = Utf8ToWideChar(translated_fname); result->reset(); DWORD share_mode = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE; HANDLE hfile = ::CreateFileW(ws_translated_fname.c_str(), GENERIC_WRITE, share_mode, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); if (INVALID_HANDLE_VALUE == hfile) { string context = "Failed to create a NewWriteableFile: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } result->reset(new WindowsWritableFile(translated_fname, hfile)); return Status::OK(); } Status WindowsFileSystem::NewAppendableFile( const string& fname, std::unique_ptr* result) { string translated_fname = TranslateName(fname); std::wstring ws_translated_fname = Utf8ToWideChar(translated_fname); result->reset(); DWORD share_mode = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE; HANDLE hfile = ::CreateFileW(ws_translated_fname.c_str(), GENERIC_WRITE, share_mode, NULL, OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); if (INVALID_HANDLE_VALUE == hfile) { string context = "Failed to create a NewAppendableFile: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } UniqueCloseHandlePtr file_guard(hfile, CloseHandleFunc); DWORD file_ptr = ::SetFilePointer(hfile, NULL, NULL, FILE_END); if (INVALID_SET_FILE_POINTER == file_ptr) { string context = "Failed to create a NewAppendableFile: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } result->reset(new WindowsWritableFile(translated_fname, hfile)); file_guard.release(); return Status::OK(); } Status WindowsFileSystem::NewReadOnlyMemoryRegionFromFile( const string& fname, std::unique_ptr* result) { string translated_fname = TranslateName(fname); std::wstring ws_translated_fname = Utf8ToWideChar(translated_fname); result->reset(); Status s = Status::OK(); // Open the file for read-only DWORD file_flags = FILE_ATTRIBUTE_READONLY; // Open in async mode which makes Windows allow more parallelism even // if we need to do sync I/O on top of it. file_flags |= FILE_FLAG_OVERLAPPED; DWORD share_mode = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE; HANDLE hfile = ::CreateFileW(ws_translated_fname.c_str(), GENERIC_READ, share_mode, NULL, OPEN_EXISTING, file_flags, NULL); if (INVALID_HANDLE_VALUE == hfile) { return IOErrorFromWindowsError( "NewReadOnlyMemoryRegionFromFile failed to Create/Open: " + fname, ::GetLastError()); } UniqueCloseHandlePtr file_guard(hfile, CloseHandleFunc); // Use mmap when virtual address-space is plentiful. uint64_t file_size; s = GetFileSize(translated_fname, &file_size); if (s.ok()) { // Will not map empty files if (file_size == 0) { return IOError( "NewReadOnlyMemoryRegionFromFile failed to map empty file: " + fname, EINVAL); } HANDLE hmap = ::CreateFileMappingA(hfile, NULL, PAGE_READONLY, 0, // Whole file at its present length 0, NULL); // Mapping name if (!hmap) { string context = "Failed to create file mapping for " "NewReadOnlyMemoryRegionFromFile: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } UniqueCloseHandlePtr map_guard(hmap, CloseHandleFunc); const void* mapped_region = ::MapViewOfFileEx(hmap, FILE_MAP_READ, 0, // High DWORD of access start 0, // Low DWORD file_size, NULL); // Let the OS choose the mapping if (!mapped_region) { string context = "Failed to MapViewOfFile for " "NewReadOnlyMemoryRegionFromFile: " + fname; return IOErrorFromWindowsError(context, ::GetLastError()); } result->reset(new WinReadOnlyMemoryRegion(fname, hfile, hmap, mapped_region, file_size)); map_guard.release(); file_guard.release(); } return s; } Status WindowsFileSystem::FileExists(const string& fname) { constexpr int kOk = 0; std::wstring ws_translated_fname = Utf8ToWideChar(TranslateName(fname)); if (_waccess(ws_translated_fname.c_str(), kOk) == 0) { return Status::OK(); } return errors::NotFound(fname, " not found"); } Status WindowsFileSystem::GetChildren(const string& dir, std::vector* result) { string translated_dir = TranslateName(dir); std::wstring ws_translated_dir = Utf8ToWideChar(translated_dir); result->clear(); std::wstring pattern = ws_translated_dir; if (!pattern.empty() && pattern.back() != '\\' && pattern.back() != '/') { pattern += L"\\*"; } else { pattern += L'*'; } WIN32_FIND_DATAW find_data; HANDLE find_handle = ::FindFirstFileW(pattern.c_str(), &find_data); if (find_handle == INVALID_HANDLE_VALUE) { string context = "FindFirstFile failed for: " + translated_dir; return IOErrorFromWindowsError(context, ::GetLastError()); } do { string file_name = WideCharToUtf8(find_data.cFileName); const StringPiece basename = file_name; if (basename != "." && basename != "..") { result->push_back(file_name); } } while (::FindNextFileW(find_handle, &find_data)); if (!::FindClose(find_handle)) { string context = "FindClose failed for: " + translated_dir; return IOErrorFromWindowsError(context, ::GetLastError()); } return Status::OK(); } Status WindowsFileSystem::DeleteFile(const string& fname) { Status result; std::wstring file_name = Utf8ToWideChar(fname); if (_wunlink(file_name.c_str()) != 0) { result = IOError("Failed to delete a file: " + fname, errno); } return result; } Status WindowsFileSystem::CreateDir(const string& name) { Status result; std::wstring ws_name = Utf8ToWideChar(name); if (_wmkdir(ws_name.c_str()) != 0) { result = IOError("Failed to create a directory: " + name, errno); } return result; } Status WindowsFileSystem::DeleteDir(const string& name) { Status result; std::wstring ws_name = Utf8ToWideChar(name); if (_wrmdir(ws_name.c_str()) != 0) { result = IOError("Failed to remove a directory: " + name, errno); } return result; } Status WindowsFileSystem::GetFileSize(const string& fname, uint64* size) { string translated_fname = TranslateName(fname); std::wstring ws_translated_dir = Utf8ToWideChar(translated_fname); Status result; WIN32_FILE_ATTRIBUTE_DATA attrs; if (TRUE == ::GetFileAttributesExW(ws_translated_dir.c_str(), GetFileExInfoStandard, &attrs)) { ULARGE_INTEGER file_size; file_size.HighPart = attrs.nFileSizeHigh; file_size.LowPart = attrs.nFileSizeLow; *size = file_size.QuadPart; } else { string context = "Can not get size for: " + fname; result = IOErrorFromWindowsError(context, ::GetLastError()); } return result; } Status WindowsFileSystem::RenameFile(const string& src, const string& target) { Status result; // rename() is not capable of replacing the existing file as on Linux // so use OS API directly std::wstring ws_translated_src = Utf8ToWideChar(TranslateName(src)); std::wstring ws_translated_target = Utf8ToWideChar(TranslateName(target)); if (!::MoveFileExW(ws_translated_src.c_str(), ws_translated_target.c_str(), MOVEFILE_REPLACE_EXISTING)) { string context(strings::StrCat("Failed to rename: ", src, " to: ", target)); result = IOErrorFromWindowsError(context, ::GetLastError()); } return result; } Status WindowsFileSystem::GetMatchingPaths(const string& pattern, std::vector* results) { // NOTE(mrry): The existing implementation of FileSystem::GetMatchingPaths() // does not handle Windows paths containing backslashes correctly. Since // Windows APIs will accept forward and backslashes equivalently, we // convert the pattern to use forward slashes exclusively. Note that this // is not ideal, since the API expects backslash as an escape character, // but no code appears to rely on this behavior. string converted_pattern(pattern); std::replace(converted_pattern.begin(), converted_pattern.end(), '\\', '/'); TF_RETURN_IF_ERROR(internal::GetMatchingPaths(this, Env::Default(), converted_pattern, results)); for (string& result : *results) { std::replace(result.begin(), result.end(), '/', '\\'); } return Status::OK(); } Status WindowsFileSystem::Stat(const string& fname, FileStatistics* stat) { Status result; struct _stat sbuf; std::wstring ws_translated_fname = Utf8ToWideChar(TranslateName(fname)); if (_wstat(ws_translated_fname.c_str(), &sbuf) != 0) { result = IOError(fname, errno); } else { stat->mtime_nsec = sbuf.st_mtime * 1e9; stat->length = sbuf.st_size; stat->is_directory = PathIsDirectoryW(ws_translated_fname.c_str()); } return result; } } // namespace tensorflow