// Copyright 2014 Citra Emulator Project // Licensed under GPLv2 // Refer to the license.txt file included. #include "common/file_util.h" #include "core/loader/ncch.h" #include "core/hle/kernel/kernel.h" #include "core/mem_map.h" //////////////////////////////////////////////////////////////////////////////////////////////////// /// NCCH header (Note: "NCCH" appears to be a publically unknown acronym) struct NCCH_Header { u8 signature[0x100]; char magic[4]; u32 content_size; u8 partition_id[8]; u16 maker_code; u16 version; u8 reserved_0[4]; u8 program_id[8]; u8 temp_flag; u8 reserved_1[0x2f]; u8 product_code[0x10]; u8 extended_header_hash[0x20]; u32 extended_header_size; u8 reserved_2[4]; u8 flags[8]; u32 plain_region_offset; u32 plain_region_size; u8 reserved_3[8]; u32 exefs_offset; u32 exefs_size; u32 exefs_hash_region_size; u8 reserved_4[4]; u32 romfs_offset; u32 romfs_size; u32 romfs_hash_region_size; u8 reserved_5[4]; u8 exefs_super_block_hash[0x20]; u8 romfs_super_block_hash[0x20]; }; //////////////////////////////////////////////////////////////////////////////////////////////////// // ExeFS (executable file system) headers typedef struct { char name[8]; u32 offset; u32 size; } ExeFs_SectionHeader; typedef struct { ExeFs_SectionHeader section[8]; u8 reserved[0x80]; u8 hashes[8][0x20]; } ExeFs_Header; //////////////////////////////////////////////////////////////////////////////////////////////////// // ExHeader (executable file system header) headers struct ExHeader_SystemInfoFlags{ u8 reserved[5]; u8 flag; u8 remaster_version[2]; } exheader_systeminfoflags; struct ExHeader_CodeSegmentInfo{ u32 address; u32 num_max_pages; u32 code_size; } exheader_codesegmentinfo; struct ExHeader_CodeSetInfo { u8 name[8]; ExHeader_SystemInfoFlags flags; ExHeader_CodeSegmentInfo text; u8 stacksize[4]; ExHeader_CodeSegmentInfo ro; u8 reserved[4]; ExHeader_CodeSegmentInfo data; u8 bsssize[4]; }; struct ExHeader_DependencyList{ u8 program_id[0x30][8]; }; struct ExHeader_SystemInfo{ u32 save_data_size; u8 reserved[4]; u8 jump_id[8]; u8 reserved_2[0x30]; }; struct ExHeader_StorageInfo{ u8 ext_save_data_id[8]; u8 system_save_data_id[8]; u8 reserved[8]; u8 access_info[7]; u8 other_attributes; }; struct ExHeader_ARM11_SystemLocalCaps{ u8 program_id[8]; u8 flags[8]; u8 resource_limit_descriptor[0x10][2]; ExHeader_StorageInfo storage_info; u8 service_access_control[0x20][8]; u8 reserved[0x1f]; u8 resource_limit_category; }; struct ExHeader_ARM11_KernelCaps{ u8 descriptors[28][4]; u8 reserved[0x10]; }; struct ExHeader_ARM9_AccessControl{ u8 descriptors[15]; u8 descversion; }; struct ExHeader_Header{ ExHeader_CodeSetInfo codeset_info; ExHeader_DependencyList dependency_list; ExHeader_SystemInfo system_info; ExHeader_ARM11_SystemLocalCaps arm11_system_local_caps; ExHeader_ARM11_KernelCaps arm11_kernel_caps; ExHeader_ARM9_AccessControl arm9_access_control; struct { u8 signature[0x100]; u8 ncch_public_key_modulus[0x100]; ExHeader_ARM11_SystemLocalCaps arm11_system_local_caps; ExHeader_ARM11_KernelCaps arm11_kernel_caps; ExHeader_ARM9_AccessControl arm9_access_control; } access_desc; }; //////////////////////////////////////////////////////////////////////////////////////////////////// // Loader namespace namespace Loader { const int kExeFs_MaxSections = 8; ///< Maximum number of sections (files) in an ExeFs const int kExeFs_BlockSize = 0x200; ///< Size of ExeFS blocks (in bytes) /** * Get the decompressed size of an LZSS compressed ExeFS file * @param buffer Buffer of compressed file * @param size Size of compressed buffer * @return Size of decompressed buffer */ u32 LZSS_GetDecompressedSize(u8* buffer, u32 size) { u32 offset_size = *(u32*)(buffer + size - 4); return offset_size + size; } /** * Decompress ExeFS file (compressed with LZSS) * @param compressed Compressed buffer * @param compressed_size Size of compressed buffer * @param decompressed Decompressed buffer * @param decompressed_size Size of decompressed buffer * @param error_string String populated with error message on failure * @return True on success, otherwise false */ bool LZSS_Decompress(u8* compressed, u32 compressed_size, u8* decompressed, u32 decompressed_size, std::string* error_string) { u8* footer = compressed + compressed_size - 8; u32 buffer_top_and_bottom = *(u32*)footer; u32 i, j; u32 out = decompressed_size; u32 index = compressed_size - ((buffer_top_and_bottom >> 24) & 0xFF); u8 control; u32 stop_index = compressed_size - (buffer_top_and_bottom & 0xFFFFFF); memset(decompressed, 0, decompressed_size); memcpy(decompressed, compressed, compressed_size); while(index > stop_index) { control = compressed[--index]; for(i = 0; i < 8; i++) { if(index <= stop_index) break; if(index <= 0) break; if(out <= 0) break; if(control & 0x80) { if(index < 2) { *error_string = "Compression out of bounds"; return false; } index -= 2; u32 segment_offset = compressed[index] | (compressed[index + 1] << 8); u32 segment_size = ((segment_offset >> 12) & 15) + 3; segment_offset &= 0x0FFF; segment_offset += 2; if(out < segment_size) { *error_string = "Compression out of bounds"; return false; } for(j = 0; j < segment_size; j++) { u8 data; if(out + segment_offset >= decompressed_size) { *error_string = "Compression out of bounds"; return false; } data = decompressed[out + segment_offset]; decompressed[--out] = data; } } else { if(out < 1) { *error_string = "Compression out of bounds"; return false; } decompressed[--out] = compressed[--index]; } control <<= 1; } } return true; } /** * Load a data buffer into memory at the specified address * @param addr Address to load memory into * @param buffer Buffer of data to load into memory * @param size Size of data to load into memory * @todo Perhaps move this code somewhere more generic? */ void LoadBuffer(const u32 addr, const u8* const buffer, const int size) { u32 *dst = (u32*)Memory::GetPointer(addr); u32 *src = (u32*)buffer; int size_aligned = (size + 3) / 4; for (int j = 0; j < size_aligned; j++) { *dst++ = (*src++); } return; } /** * Loads an NCCH file (e.g. from a CCI, or the first NCCH in a CXI) * @param filename String filename of NCCH file * @param error_string Pointer to string to put error message if an error has occurred * @todo Move NCSD parsing out of here and create a separate function for loading these * @return True on success, otherwise false */ bool Load_NCCH(std::string& filename, std::string* error_string) { INFO_LOG(LOADER, "Loading NCCH file %s...", filename.c_str()); File::IOFile file(filename, "rb"); if (file.IsOpen()) { NCCH_Header ncch_header; file.ReadBytes(&ncch_header, sizeof(NCCH_Header)); // Skip NCSD header and load first NCCH (NCSD is just a container of NCCH files)... int ncch_off = 0; // Offset to NCCH header, can be 0 or after NCSD header if (memcmp(&ncch_header.magic, "NCSD", 4) == 0) { WARN_LOG(LOADER, "Only loading the first (bootable) NCCH within the NCSD file!"); ncch_off = 0x4000; file.Seek(ncch_off, 0); file.ReadBytes(&ncch_header, sizeof(NCCH_Header)); } // Verify we are loading the correct file type... if (memcmp(&ncch_header.magic, "NCCH", 4) != 0) { *error_string = "Invalid NCCH magic number (likely incorrect file type)"; return false; } // Read ExHeader ExHeader_Header exheader_header; file.ReadBytes(&exheader_header, sizeof(ExHeader_Header)); bool is_compressed = (exheader_header.codeset_info.flags.flag & 1) == 1; INFO_LOG(LOADER, "Name: %s", exheader_header.codeset_info.name); INFO_LOG(LOADER, "Code compressed: %s", is_compressed ? "yes" : "no"); // Read ExeFS u32 exefs_offset = ncch_header.exefs_offset * kExeFs_BlockSize; u32 exefs_size = ncch_header.exefs_size * kExeFs_BlockSize; INFO_LOG(LOADER, "ExeFS offset: 0x%08X", exefs_offset); INFO_LOG(LOADER, "ExeFS size: 0x%08X", exefs_size); ExeFs_Header exefs_header; file.Seek(exefs_offset + ncch_off, 0); file.ReadBytes(&exefs_header, sizeof(ExeFs_Header)); // Iterate through the ExeFs archive until we find the .code file... for (int i = 0; i < kExeFs_MaxSections; i++) { INFO_LOG(LOADER, "ExeFS section %d:", i); INFO_LOG(LOADER, " name: %s", exefs_header.section[i].name); INFO_LOG(LOADER, " offset: 0x%08X", exefs_header.section[i].offset); INFO_LOG(LOADER, " size: 0x%08X", exefs_header.section[i].size); // Load the .code section (executable code)... if (strcmp((char*) exefs_header.section[i].name, ".code") == 0) { file.Seek(exefs_header.section[i].offset + exefs_offset + sizeof(ExeFs_Header) + ncch_off, 0); u8* buffer = new u8[exefs_header.section[i].size]; file.ReadBytes(buffer, exefs_header.section[i].size); // Load compressed executable... if (i == 0 && is_compressed) { u32 decompressed_size = LZSS_GetDecompressedSize(buffer, exefs_header.section[i].size); u8* decompressed_buffer = new u8[decompressed_size]; if (!LZSS_Decompress(buffer, exefs_header.section[i].size, decompressed_buffer, decompressed_size, error_string)) { return false; } // Load .code section into memory... LoadBuffer(exheader_header.codeset_info.text.address, decompressed_buffer, decompressed_size); delete[] decompressed_buffer; // Load uncompressed executable... } else { // Load .code section into memory... LoadBuffer(exheader_header.codeset_info.text.address, buffer, exefs_header.section[i].size); } delete[] buffer; // Setup kernel emulation to boot .code section... Kernel::LoadExec(exheader_header.codeset_info.text.address); // No need to load the other files from ExeFS until we do something with them... return true; } } } return false; } } // namespace Loader