// Copyright 2014 Citra Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #include #include #include #include "common/common_types.h" #include "common/file_util.h" #include "common/logging/log.h" #include "common/string_util.h" #include "core/file_sys/archive_extsavedata.h" #include "core/file_sys/disk_archive.h" #include "core/file_sys/errors.h" #include "core/file_sys/path_parser.h" #include "core/file_sys/savedata_archive.h" #include "core/hle/service/fs/archive.h" //////////////////////////////////////////////////////////////////////////////////////////////////// // FileSys namespace namespace FileSys { /** * A modified version of DiskFile for fixed-size file used by ExtSaveData * The file size can't be changed by SetSize or Write. */ class FixSizeDiskFile : public DiskFile { public: FixSizeDiskFile(FileUtil::IOFile&& file, const Mode& mode, std::unique_ptr delay_generator_) : DiskFile(std::move(file), mode, std::move(delay_generator_)) { size = GetSize(); } bool SetSize(u64 size) const override { return false; } ResultVal Write(u64 offset, size_t length, bool flush, const u8* buffer) override { if (offset > size) { return ERR_WRITE_BEYOND_END; } else if (offset == size) { return MakeResult(0); } if (offset + length > size) { length = size - offset; } return DiskFile::Write(offset, length, flush, buffer); } private: u64 size{}; }; class ExtSaveDataDelayGenerator : public DelayGenerator { public: u64 GetReadDelayNs(size_t length) override { // This is the delay measured for a savedate read, // not for extsaveData // For now we will take that static constexpr u64 slope(183); static constexpr u64 offset(524879); static constexpr u64 minimum(631826); u64 ipc_delay_nanoseconds = std::max(static_cast(length) * slope + offset, minimum); return ipc_delay_nanoseconds; } }; /** * Archive backend for general extsave data archive type. * The behaviour of ExtSaveDataArchive is almost the same as SaveDataArchive, except for * - file size can't be changed once created (thus creating zero-size file and openning with create * flag are prohibited); * - always open a file with read+write permission. */ class ExtSaveDataArchive : public SaveDataArchive { public: explicit ExtSaveDataArchive(const std::string& mount_point) : SaveDataArchive(mount_point) {} std::string GetName() const override { return "ExtSaveDataArchive: " + mount_point; } ResultVal> OpenFile(const Path& path, const Mode& mode) const override { LOG_DEBUG(Service_FS, "called path={} mode={:01X}", path.DebugStr(), mode.hex); const PathParser path_parser(path); if (!path_parser.IsValid()) { LOG_ERROR(Service_FS, "Invalid path {}", path.DebugStr()); return ERROR_INVALID_PATH; } if (mode.hex == 0) { LOG_ERROR(Service_FS, "Empty open mode"); return ERROR_UNSUPPORTED_OPEN_FLAGS; } if (mode.create_flag) { LOG_ERROR(Service_FS, "Create flag is not supported"); return ERROR_UNSUPPORTED_OPEN_FLAGS; } const auto full_path = path_parser.BuildHostPath(mount_point); switch (path_parser.GetHostStatus(mount_point)) { case PathParser::InvalidMountPoint: LOG_CRITICAL(Service_FS, "(unreachable) Invalid mount point {}", mount_point); return ERROR_FILE_NOT_FOUND; case PathParser::PathNotFound: LOG_ERROR(Service_FS, "Path not found {}", full_path); return ERROR_PATH_NOT_FOUND; case PathParser::FileInPath: case PathParser::DirectoryFound: LOG_ERROR(Service_FS, "Unexpected file or directory in {}", full_path); return ERROR_UNEXPECTED_FILE_OR_DIRECTORY; case PathParser::NotFound: LOG_ERROR(Service_FS, "{} not found", full_path); return ERROR_FILE_NOT_FOUND; case PathParser::FileFound: break; // Expected 'success' case } FileUtil::IOFile file(full_path, "r+b"); if (!file.IsOpen()) { LOG_CRITICAL(Service_FS, "(unreachable) Unknown error opening {}", full_path); return ERROR_FILE_NOT_FOUND; } Mode rwmode; rwmode.write_flag.Assign(1); rwmode.read_flag.Assign(1); std::unique_ptr delay_generator = std::make_unique(); auto disk_file = std::make_unique(std::move(file), rwmode, std::move(delay_generator)); return MakeResult>(std::move(disk_file)); } ResultCode CreateFile(const Path& path, u64 size) const override { if (size == 0) { LOG_ERROR(Service_FS, "Zero-size file is not supported"); return ERROR_UNSUPPORTED_OPEN_FLAGS; } return SaveDataArchive::CreateFile(path, size); } }; struct ExtSaveDataArchivePath { u32_le media_type; u32_le save_low; u32_le save_high; }; static_assert(sizeof(ExtSaveDataArchivePath) == 12, "Incorrect path size"); std::string GetExtSaveDataPath(const std::string& mount_point, const Path& path) { std::vector vec_data = path.AsBinary(); ExtSaveDataArchivePath path_data; std::memcpy(&path_data, vec_data.data(), sizeof(path_data)); return Common::StringFromFormat("%s%08X/%08X/", mount_point.c_str(), path_data.save_high, path_data.save_low); } std::string GetExtDataContainerPath(const std::string& mount_point, bool shared) { if (shared) return Common::StringFromFormat("%sdata/%s/extdata/", mount_point.c_str(), SYSTEM_ID); return Common::StringFromFormat("%sNintendo 3DS/%s/%s/extdata/", mount_point.c_str(), SYSTEM_ID, SDCARD_ID); } Path ConstructExtDataBinaryPath(u32 media_type, u32 high, u32 low) { ExtSaveDataArchivePath path; path.media_type = media_type; path.save_high = high; path.save_low = low; std::vector binary_path(sizeof(path)); std::memcpy(binary_path.data(), &path, binary_path.size()); return {binary_path}; } ArchiveFactory_ExtSaveData::ArchiveFactory_ExtSaveData(const std::string& mount_location, bool shared) : shared(shared), mount_point(GetExtDataContainerPath(mount_location, shared)) { LOG_DEBUG(Service_FS, "Directory {} set as base for ExtSaveData.", mount_point); } bool ArchiveFactory_ExtSaveData::Initialize() { if (!FileUtil::CreateFullPath(mount_point)) { LOG_ERROR(Service_FS, "Unable to create ExtSaveData base path."); return false; } return true; } Path ArchiveFactory_ExtSaveData::GetCorrectedPath(const Path& path) { if (!shared) return path; static constexpr u32 SharedExtDataHigh = 0x48000; ExtSaveDataArchivePath new_path; std::memcpy(&new_path, path.AsBinary().data(), sizeof(new_path)); // The FS module overwrites the high value of the saveid when dealing with the SharedExtSaveData // archive. new_path.save_high = SharedExtDataHigh; std::vector binary_data(sizeof(new_path)); std::memcpy(binary_data.data(), &new_path, binary_data.size()); return {binary_data}; } ResultVal> ArchiveFactory_ExtSaveData::Open(const Path& path) { std::string fullpath = GetExtSaveDataPath(mount_point, GetCorrectedPath(path)) + "user/"; if (!FileUtil::Exists(fullpath)) { // TODO(Subv): Verify the archive behavior of SharedExtSaveData compared to ExtSaveData. // ExtSaveData seems to return FS_NotFound (120) when the archive doesn't exist. if (!shared) { return ERR_NOT_FOUND_INVALID_STATE; } else { return ERR_NOT_FORMATTED; } } auto archive = std::make_unique(fullpath); return MakeResult>(std::move(archive)); } ResultCode ArchiveFactory_ExtSaveData::Format(const Path& path, const FileSys::ArchiveFormatInfo& format_info) { auto corrected_path = GetCorrectedPath(path); // These folders are always created with the ExtSaveData std::string user_path = GetExtSaveDataPath(mount_point, corrected_path) + "user/"; std::string boss_path = GetExtSaveDataPath(mount_point, corrected_path) + "boss/"; FileUtil::CreateFullPath(user_path); FileUtil::CreateFullPath(boss_path); // Write the format metadata std::string metadata_path = GetExtSaveDataPath(mount_point, corrected_path) + "metadata"; FileUtil::IOFile file(metadata_path, "wb"); if (!file.IsOpen()) { // TODO(Subv): Find the correct error code return ResultCode(-1); } file.WriteBytes(&format_info, sizeof(format_info)); return RESULT_SUCCESS; } ResultVal ArchiveFactory_ExtSaveData::GetFormatInfo(const Path& path) const { std::string metadata_path = GetExtSaveDataPath(mount_point, path) + "metadata"; FileUtil::IOFile file(metadata_path, "rb"); if (!file.IsOpen()) { LOG_ERROR(Service_FS, "Could not open metadata information for archive"); // TODO(Subv): Verify error code return ERR_NOT_FORMATTED; } ArchiveFormatInfo info = {}; file.ReadBytes(&info, sizeof(info)); return MakeResult(info); } void ArchiveFactory_ExtSaveData::WriteIcon(const Path& path, const u8* icon_data, size_t icon_size) { std::string game_path = FileSys::GetExtSaveDataPath(GetMountPoint(), path); FileUtil::IOFile icon_file(game_path + "icon", "wb"); icon_file.WriteBytes(icon_data, icon_size); } } // namespace FileSys