loader.h

Go to the documentation of this file.

/*
 * Copyright 2021-present dogtopus
 * SPDX-License-Identifier: MIT
 */

 
#ifndef __MUTEKI_LOADER_H__
#define __MUTEKI_LOADER_H__
 
#include "common.h"
 
#ifdef __cplusplus
extern "C" {
#endif

enum applet_subroutine_e {
    APPLET_SUBROUTINE_MAIN = 0,
    APPLET_SUBROUTINE_RESET_STATES = 5,
};

typedef struct applet_args_v4_s {
    char *dospath;
    int *subroutine;
    void **applet_arg1;
    void **applet_arg2;
} applet_args_v4_t;

typedef struct loader_cart_descriptor_s {
    unsigned int unk_0x0;
    unsigned int unk_0x4;
    size_t size_low_32;
    unsigned int unk_0xc;
    void *unk_0x10;
    unsigned char unk_0x14;
    unsigned char size_high_8;
    unsigned char unk_0x16;
    unsigned char unk_0x17;
    unsigned int unk_0x18;
    unsigned int unk_0x1c;
} loader_cart_descriptor_t; // 0x20

typedef struct loader_file_descriptor_s {
    loader_cart_descriptor_t *cart;
    void *parent_fd; /* Created by retype action */
    size_t subfile_base;
    size_t size;
    size_t subfile_offset;
    short unk_0x14; /* _OpenSubFile sets this to 1 */
    short unk_0x16;
    unsigned int unk_0x18;
    unsigned int unk_0x1c;
} loader_file_descriptor_t;

typedef struct loader_resource_descriptor_s {
    size_t mapped_size;
    size_t mapped_offset;
    size_t data_size;
    size_t data_offset;
    loader_file_descriptor_t *ldrfd;
} loader_resource_descriptor_t;

typedef struct loader_resource_subfile_request_s {
    size_t base;
    size_t size;
} loader_resource_subfile_request_t;

typedef struct loader_image_info_s {
    size_t bestape_code_size;
    size_t bestape_data_size;
    size_t bestape_bss_size;
    size_t bestape_total_raw_size; /* Size of headers and all raw section data */
    size_t bestape_total_size;
    size_t bestape_header_size;
    unsigned int bestape_checksum;
    unsigned int unk_0x1c;
    unsigned char unk_0x20[24];
} loader_image_info_t;
 
typedef union loader_symbol_id_u {
    const char *name;
    unsigned int ordinal;
} loader_symbol_id_t;

typedef struct loader_impl_s {
    void *(*load)(loader_file_descriptor_t *ldrfd);
    void *(*load_into)(loader_file_descriptor_t *ldrfd, void *load_address);
    void (*unload)(void *module);
    int (*exec)(void *module, int subroutine, void *arg1, void *arg2);
    int (*probe)(loader_file_descriptor_t *ldrfd);
    void *(*dlopen)(char *pathname);
    void (*dlclose)(void *module);
    void *(*dlsym)(void *module, loader_symbol_id_t symbol_or_ordinal);
    size_t (*get_module_filename)(void *module, char *out_filename, size_t size);
    void *(*get_module)(const char *pathname);
    loader_resource_descriptor_t *(*open_resource_descriptor)(loader_file_descriptor_t *ldrfd);
    void (*close_resource_descriptor)(loader_resource_descriptor_t *res);
    int (*get_resource)(
        loader_resource_descriptor_t *res,
        const UTF16 *res_type,
        const UTF16 *res_name,
        loader_resource_subfile_request_t *out_subfile
    );
    int (*collect_image_info)(loader_file_descriptor_t *ldrfd, loader_image_info_t *info);
} loader_impl_t;

typedef struct loader_loaded_s {
    char path[80];
    int id;
    int refcount;
    int active_refcount;
    unsigned char *mapped_executable;
    loader_impl_t *loader;
    short unk_0x64;
    short type;
    unsigned int rom_spec_offset_0xc;
    void *path_lfn;
    loader_file_descriptor_t *asset_file;
    loader_file_descriptor_t *ldrfd;
    unsigned char unk_0x78[28];
    void *posixfd_rom;
} loader_loaded_t;

typedef struct loader_applet_info_s {
    unsigned short rom_magic;
    unsigned short unused_0x2;
    unsigned short rom_type;
    unsigned short unused_0x4;
    unsigned int exe_checksum;
    size_t exe_raw_size;
    unsigned char unused_0x10[0x74];
} loader_applet_info_t;

extern loader_file_descriptor_t *_OpenFile(const char *pathname, const char *mode_or_subfile);

extern loader_file_descriptor_t *_OpenFileW(const UTF16 *pathname, const void *mode_or_subfile);

extern int _CloseFile(loader_file_descriptor_t *ldrfd);

extern size_t _ReadFile(loader_file_descriptor_t *ldrfd, void *buf, size_t size);

extern int _FseekFile(loader_file_descriptor_t *ldrfd, size_t offset, int whence);

extern ssize_t _FileSize(loader_file_descriptor_t *ldrfd);

extern loader_file_descriptor_t *_OpenSubFile(loader_file_descriptor_t *parent, size_t base, size_t max_size);

extern ssize_t _TellFile(loader_file_descriptor_t *ldrfd);

extern int RunApplicationA(const char *pathname,int subroutine,void *applet_arg1,void *applet_arg2);

extern size_t GetApplicationNameA(const char *pathname, UTF16 *out_name, size_t max_size);

extern loader_loaded_t *LoadProgramA(const char *pathname);

extern int FreeProgram(loader_loaded_t *applet);

extern int ExecuteProgram(loader_loaded_t *applet, int subroutine, void *applet_arg1, void *applet_arg2);

extern const char *GetCurrentPathA(void);

extern loader_loaded_t *ProgramIsRunningA(const char *pathname);

extern int RunApplicationW(const UTF16 *pathname, int subroutine, void *applet_arg1, void *applet_arg2);

extern size_t GetApplicationNameW(const UTF16 *pathname, UTF16 *out_name, size_t max_size);

extern loader_loaded_t *LoadProgramW(const UTF16 *pathname);

extern const UTF16 *GetCurrentPathW(void);

extern loader_loaded_t *ProgramIsRunningW(const UTF16 *pathname);

extern loader_loaded_t *LoadHFileProgramW(loader_file_descriptor_t *ldrfd, const UTF16 *pathname);

extern loader_loaded_t *LoadHFileProgramA(loader_file_descriptor_t *ldrfd, const char *pathname);

extern loader_loaded_t *GetApplicationProcA(const char *pathname);

extern int StayResidentProgramA(const char *pathname);

extern int UnStayResidentProgramA(const char *pathname);

extern int CheckProgramIsStayResident(loader_loaded_t *applet);

extern loader_loaded_t *GetApplicationProcW(const UTF16 *pathname);

extern int StayResidentProgramW(const UTF16 *pathname);

extern int UnStayResidentProgramW(const UTF16 *pathname);

extern int GetApplicationHeadInfoA(const char *pathname,loader_applet_info_t *info);

extern int GetApplicationHeadInfoW(const UTF16 *pathname, loader_applet_info_t *info);
 
#ifdef __cplusplus
} // extern "C"
#endif
 
#endif // __MUTEKI_LOADER_H__