2014-04-08 16:15:46 -07:00
|
|
|
// Copyright 2014 Citra Emulator Project
|
2014-12-16 21:38:14 -08:00
|
|
|
// Licensed under GPLv2 or any later version
|
2014-04-08 16:15:46 -07:00
|
|
|
// Refer to the license.txt file included.
|
2013-09-19 20:21:22 -07:00
|
|
|
|
2014-04-08 16:15:46 -07:00
|
|
|
#pragma once
|
2013-09-19 20:21:22 -07:00
|
|
|
|
2015-06-21 06:58:59 -07:00
|
|
|
#include <algorithm>
|
|
|
|
#include <initializer_list>
|
2015-06-21 05:40:28 -07:00
|
|
|
#include <memory>
|
2015-06-21 06:58:59 -07:00
|
|
|
#include <string>
|
2014-06-18 15:58:09 -07:00
|
|
|
#include <vector>
|
|
|
|
|
2016-04-13 14:04:05 -07:00
|
|
|
#include "common/common_funcs.h"
|
2015-05-06 00:06:12 -07:00
|
|
|
#include "common/common_types.h"
|
2015-01-06 13:30:40 -08:00
|
|
|
#include "common/file_util.h"
|
2016-04-13 14:04:05 -07:00
|
|
|
#include "common/swap.h"
|
2013-09-19 20:21:22 -07:00
|
|
|
|
2015-06-21 06:58:59 -07:00
|
|
|
namespace Kernel {
|
|
|
|
struct AddressMapping;
|
|
|
|
}
|
2015-05-03 20:01:16 -07:00
|
|
|
|
2013-09-19 20:21:22 -07:00
|
|
|
////////////////////////////////////////////////////////////////////////////////////////////////////
|
2014-06-16 20:18:10 -07:00
|
|
|
// Loader namespace
|
2013-09-19 20:21:22 -07:00
|
|
|
|
|
|
|
namespace Loader {
|
|
|
|
|
2014-06-18 15:58:09 -07:00
|
|
|
/// File types supported by CTR
|
|
|
|
enum class FileType {
|
|
|
|
Error,
|
|
|
|
Unknown,
|
|
|
|
CCI,
|
|
|
|
CXI,
|
|
|
|
CIA,
|
|
|
|
ELF,
|
2014-12-07 12:47:06 -08:00
|
|
|
THREEDSX, //3DSX
|
2014-06-18 15:58:09 -07:00
|
|
|
};
|
|
|
|
|
2015-08-31 18:28:37 -07:00
|
|
|
/**
|
|
|
|
* Identifies the type of a bootable file based on the magic value in its header.
|
|
|
|
* @param file open file
|
|
|
|
* @return FileType of file
|
|
|
|
*/
|
|
|
|
FileType IdentifyFile(FileUtil::IOFile& file);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Identifies the type of a bootable file based on the magic value in its header.
|
|
|
|
* @param file_name path to file
|
|
|
|
* @return FileType of file. Note: this will return FileType::Unknown if it is unable to determine
|
|
|
|
* a filetype, and will never return FileType::Error.
|
|
|
|
*/
|
|
|
|
FileType IdentifyFile(const std::string& file_name);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Guess the type of a bootable file from its extension
|
|
|
|
* @param extension String extension of bootable file
|
|
|
|
* @return FileType of file. Note: this will return FileType::Unknown if it is unable to determine
|
|
|
|
* a filetype, and will never return FileType::Error.
|
|
|
|
*/
|
|
|
|
FileType GuessFromExtension(const std::string& extension_);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Convert a FileType into a string which can be displayed to the user.
|
|
|
|
*/
|
|
|
|
const char* GetFileTypeString(FileType type);
|
|
|
|
|
2014-06-18 15:58:09 -07:00
|
|
|
/// Return type for functions in Loader namespace
|
|
|
|
enum class ResultStatus {
|
|
|
|
Success,
|
|
|
|
Error,
|
|
|
|
ErrorInvalidFormat,
|
|
|
|
ErrorNotImplemented,
|
|
|
|
ErrorNotLoaded,
|
2014-06-18 20:53:22 -07:00
|
|
|
ErrorNotUsed,
|
2014-06-18 15:58:09 -07:00
|
|
|
ErrorAlreadyLoaded,
|
2014-07-04 17:32:06 -07:00
|
|
|
ErrorMemoryAllocationFailed,
|
2015-10-10 18:50:10 -07:00
|
|
|
ErrorEncrypted,
|
2014-06-18 15:58:09 -07:00
|
|
|
};
|
|
|
|
|
2016-03-21 00:28:22 -07:00
|
|
|
constexpr u32 MakeMagic(char a, char b, char c, char d) {
|
2015-01-06 15:10:13 -08:00
|
|
|
return a | b << 8 | c << 16 | d << 24;
|
|
|
|
}
|
|
|
|
|
2016-04-13 14:04:05 -07:00
|
|
|
/// SMDH data structure that contains titles, icons etc. See https://www.3dbrew.org/wiki/SMDH
|
|
|
|
struct SMDH {
|
|
|
|
u32_le magic;
|
|
|
|
u16_le version;
|
|
|
|
INSERT_PADDING_BYTES(2);
|
|
|
|
|
|
|
|
struct Title {
|
|
|
|
std::array<u16, 0x40> short_title;
|
|
|
|
std::array<u16, 0x80> long_title;
|
|
|
|
std::array<u16, 0x40> publisher;
|
|
|
|
};
|
|
|
|
std::array<Title, 16> titles;
|
|
|
|
|
|
|
|
std::array<u8, 16> ratings;
|
|
|
|
u32_le region_lockout;
|
|
|
|
u32_le match_maker_id;
|
|
|
|
u64_le match_maker_bit_id;
|
|
|
|
u32_le flags;
|
|
|
|
u16_le eula_version;
|
|
|
|
INSERT_PADDING_BYTES(2);
|
|
|
|
float_le banner_animation_frame;
|
|
|
|
u32_le cec_id;
|
|
|
|
INSERT_PADDING_BYTES(8);
|
|
|
|
|
|
|
|
std::array<u8, 0x480> small_icon;
|
|
|
|
std::array<u8, 0x1200> large_icon;
|
|
|
|
|
|
|
|
/// indicates the language used for each title entry
|
|
|
|
enum class TitleLanguage {
|
|
|
|
Japanese = 0,
|
|
|
|
English = 1,
|
|
|
|
French = 2,
|
|
|
|
German = 3,
|
|
|
|
Italian = 4,
|
|
|
|
Spanish = 5,
|
|
|
|
SimplifiedChinese = 6,
|
|
|
|
Korean= 7,
|
|
|
|
Dutch = 8,
|
|
|
|
Portuguese = 9,
|
|
|
|
Russian = 10,
|
|
|
|
TraditionalChinese = 11
|
|
|
|
};
|
|
|
|
};
|
|
|
|
static_assert(sizeof(SMDH) == 0x36C0, "SMDH structure size is wrong");
|
|
|
|
|
2014-06-18 15:58:09 -07:00
|
|
|
/// Interface for loading an application
|
|
|
|
class AppLoader : NonCopyable {
|
|
|
|
public:
|
2015-07-11 15:16:33 -07:00
|
|
|
AppLoader(FileUtil::IOFile&& file) : file(std::move(file)) { }
|
2014-06-18 15:58:09 -07:00
|
|
|
virtual ~AppLoader() { }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Load the application
|
|
|
|
* @return ResultStatus result of function
|
|
|
|
*/
|
2014-06-19 14:46:05 -07:00
|
|
|
virtual ResultStatus Load() = 0;
|
2014-06-18 15:58:09 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the code (typically .code section) of the application
|
2014-06-27 12:33:23 -07:00
|
|
|
* @param buffer Reference to buffer to store data
|
|
|
|
* @return ResultStatus result of function
|
2014-06-18 15:58:09 -07:00
|
|
|
*/
|
2015-07-11 15:16:33 -07:00
|
|
|
virtual ResultStatus ReadCode(std::vector<u8>& buffer) {
|
2014-06-27 12:33:23 -07:00
|
|
|
return ResultStatus::ErrorNotImplemented;
|
2014-06-18 15:58:09 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-06-22 12:40:21 -07:00
|
|
|
* Get the icon (typically icon section) of the application
|
2014-06-27 12:33:23 -07:00
|
|
|
* @param buffer Reference to buffer to store data
|
|
|
|
* @return ResultStatus result of function
|
2014-06-18 15:58:09 -07:00
|
|
|
*/
|
2015-07-11 15:16:33 -07:00
|
|
|
virtual ResultStatus ReadIcon(std::vector<u8>& buffer) {
|
2014-06-27 12:33:23 -07:00
|
|
|
return ResultStatus::ErrorNotImplemented;
|
2014-06-18 15:58:09 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-06-22 12:40:21 -07:00
|
|
|
* Get the banner (typically banner section) of the application
|
2014-06-27 12:33:23 -07:00
|
|
|
* @param buffer Reference to buffer to store data
|
|
|
|
* @return ResultStatus result of function
|
2014-06-18 15:58:09 -07:00
|
|
|
*/
|
2015-07-11 15:16:33 -07:00
|
|
|
virtual ResultStatus ReadBanner(std::vector<u8>& buffer) {
|
2014-06-27 12:33:23 -07:00
|
|
|
return ResultStatus::ErrorNotImplemented;
|
2014-06-18 15:58:09 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2014-06-22 12:40:21 -07:00
|
|
|
* Get the logo (typically logo section) of the application
|
2014-06-27 12:33:23 -07:00
|
|
|
* @param buffer Reference to buffer to store data
|
|
|
|
* @return ResultStatus result of function
|
2014-06-18 15:58:09 -07:00
|
|
|
*/
|
2015-07-11 15:16:33 -07:00
|
|
|
virtual ResultStatus ReadLogo(std::vector<u8>& buffer) {
|
2014-06-27 12:33:23 -07:00
|
|
|
return ResultStatus::ErrorNotImplemented;
|
2014-06-18 15:58:09 -07:00
|
|
|
}
|
2013-09-19 20:21:22 -07:00
|
|
|
|
2014-06-18 15:58:09 -07:00
|
|
|
/**
|
2014-06-27 12:33:23 -07:00
|
|
|
* Get the RomFS of the application
|
2015-07-09 14:55:23 -07:00
|
|
|
* Since the RomFS can be huge, we return a file reference instead of copying to a buffer
|
|
|
|
* @param romfs_file The file containing the RomFS
|
|
|
|
* @param offset The offset the romfs begins on
|
|
|
|
* @param size The size of the romfs
|
2014-06-27 12:33:23 -07:00
|
|
|
* @return ResultStatus result of function
|
2014-06-18 15:58:09 -07:00
|
|
|
*/
|
2015-07-11 15:16:33 -07:00
|
|
|
virtual ResultStatus ReadRomFS(std::shared_ptr<FileUtil::IOFile>& romfs_file, u64& offset, u64& size) {
|
2014-06-27 12:33:23 -07:00
|
|
|
return ResultStatus::ErrorNotImplemented;
|
2014-06-18 15:58:09 -07:00
|
|
|
}
|
2015-01-06 13:30:40 -08:00
|
|
|
|
|
|
|
protected:
|
2015-07-11 15:16:33 -07:00
|
|
|
FileUtil::IOFile file;
|
|
|
|
bool is_loaded = false;
|
2013-09-19 20:21:22 -07:00
|
|
|
};
|
|
|
|
|
2015-05-03 20:01:16 -07:00
|
|
|
/**
|
|
|
|
* Common address mappings found in most games, used for binary formats that don't have this
|
|
|
|
* information.
|
|
|
|
*/
|
2015-05-08 14:12:25 -07:00
|
|
|
extern const std::initializer_list<Kernel::AddressMapping> default_address_mappings;
|
2015-05-03 20:01:16 -07:00
|
|
|
|
2016-04-13 14:04:05 -07:00
|
|
|
/**
|
|
|
|
* Get a loader for a file with a specific type
|
|
|
|
* @param file The file to load
|
|
|
|
* @param type The type of the file
|
|
|
|
* @param filename the file name (without path)
|
|
|
|
* @param filepath the file full path (with name)
|
|
|
|
* @return std::unique_ptr<AppLoader> a pointer to a loader object; nullptr for unsupported type
|
|
|
|
*/
|
|
|
|
std::unique_ptr<AppLoader> GetLoader(FileUtil::IOFile&& file, FileType type, const std::string& filename, const std::string& filepath);
|
|
|
|
|
2013-09-19 20:21:22 -07:00
|
|
|
/**
|
2016-05-17 15:06:33 -07:00
|
|
|
* Identifies a bootable file and return a suitable loader
|
2013-09-19 20:21:22 -07:00
|
|
|
* @param filename String filename of bootable file
|
2016-05-17 15:06:33 -07:00
|
|
|
* @return best loader for this file
|
2013-09-19 20:21:22 -07:00
|
|
|
*/
|
2016-05-17 15:06:33 -07:00
|
|
|
std::unique_ptr<AppLoader> GetFileLoader(const std::string& filename);
|
2013-09-19 20:21:22 -07:00
|
|
|
|
|
|
|
} // namespace
|