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 <muteki/common.h>
#include <muteki/file.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 struct loader_impl_s {
    void *load;
    void *load_into;
    void *unload;
    void *exec;
    void *probe;
    unsigned char *(*dlopen)(char *);
    void *unk_0x18;
    void *dlsym;
    void *unk_0x20;
    void *unk_0x24;
    loader_resource_descriptor_t * (*open_resource_descriptor)(loader_file_descriptor_t *);
    void (*close_resource_descriptor)(loader_resource_descriptor_t *);
    int (*get_resource)(loader_resource_descriptor_t *, UTF16 *, UTF16 *, loader_resource_subfile_request_t *);
    int (*collect_image_info)(loader_file_descriptor_t *, loader_image_info_t *);
} 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, const void *applet_arg1, const 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__