/* * program_info.h * * Copyright (c) 2020, DarkMatterCore . * * This file is part of nxdumptool (https://github.com/DarkMatterCore/nxdumptool). * * nxdumptool is free software; you can redistribute it and/or modify it * under the terms and conditions of the GNU General Public License, * version 2, as published by the Free Software Foundation. * * nxdumptool is distributed in the hope it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #pragma once #ifndef __PROGRAM_INFO_H__ #define __PROGRAM_INFO_H__ #include "npdm.h" #include "nso.h" typedef struct { NcaContext *nca_ctx; ///< Pointer to the NCA context for the Program NCA from which program data (NPDM / NSO) is retrieved. PartitionFileSystemContext pfs_ctx; ///< PartitionFileSystemContext for the Program NCA ExeFS, which is where program data (NPDM / NSO) is stored. NpdmContext npdm_ctx; ///< NpdmContext for the NPDM stored in Program NCA ExeFS. Holds its own NcaHierarchicalSha256Patch that may be applied to the Program NCA if needed. u32 nso_count; ///< Number of NSOs stored in Program NCA FS section #0. NsoContext *nso_ctx; ///< Pointer to a dynamically allocated buffer that holds 'nso_count' NSO contexts. char *authoring_tool_xml; ///< Pointer to a dynamically allocated, NULL-terminated buffer that holds AuthoringTool-like XML data. ///< This is always NULL unless programInfoGenerateAuthoringToolXml() is used on this ProgramInfoContext. u64 authoring_tool_xml_size; ///< Size for the AuthoringTool-like XML. This is essentially the same as using strlen() on 'authoring_tool_xml'. ///< This is always 0 unless programInfoGenerateAuthoringToolXml() is used on this ProgramInfoContext. } ProgramInfoContext; /// Initializes a ProgramInfoContext using a previously initialized NcaContext (which must belong to a Program NCA). bool programInfoInitializeContext(ProgramInfoContext *out, NcaContext *nca_ctx); /// Generates an AuthoringTool-like XML using information from a previously initialized ProgramInfoContext. /// If the function succeeds, XML data and size will get saved to the 'authoring_tool_xml' and 'authoring_tool_xml_size' members from the ProgramInfoContext. bool programInfoGenerateAuthoringToolXml(ProgramInfoContext *program_info_ctx); /// Helper inline functions. NX_INLINE void programInfoFreeContext(ProgramInfoContext *program_info_ctx) { if (!program_info_ctx) return; pfsFreeContext(&(program_info_ctx->pfs_ctx)); npdmFreeContext(&(program_info_ctx->npdm_ctx)); if (program_info_ctx->nso_ctx) { for(u32 i = 0; i < program_info_ctx->nso_count; i++) nsoFreeContext(&(program_info_ctx->nso_ctx[i])); free(program_info_ctx->nso_ctx); } if (program_info_ctx->authoring_tool_xml) free(program_info_ctx->authoring_tool_xml); memset(program_info_ctx, 0, sizeof(ProgramInfoContext)); } NX_INLINE bool programInfoIsValidContext(ProgramInfoContext *program_info_ctx) { return (program_info_ctx && program_info_ctx->nca_ctx && npdmIsValidContext(&(program_info_ctx->npdm_ctx)) && program_info_ctx->npdm_ctx.pfs_ctx == &(program_info_ctx->pfs_ctx) && \ program_info_ctx->nso_count && program_info_ctx->nso_ctx); } NX_INLINE bool programInfoGenerateNcaPatch(ProgramInfoContext *program_info_ctx) { return (programInfoIsValidContext(program_info_ctx) && npdmGenerateNcaPatch(&(program_info_ctx->npdm_ctx))); } NX_INLINE void programInfoWriteNcaPatch(ProgramInfoContext *program_info_ctx, void *buf, u64 buf_size, u64 buf_offset) { if (program_info_ctx) npdmWriteNcaPatch(&(program_info_ctx->npdm_ctx), buf, buf_size, buf_offset); } #endif /* __PROGRAM_INFO_H__ */