refactor: Update SceModule definition

src/kernel/psploadcore.h

@@ -26,32 +26,178 @@ extern "C" {
 /** @addtogroup LoadCore Interface to the LoadCoreForKernel library. */
 /**@{*/
 
-/** Describes a module.  This structure could change in future firmware revisions. */
+#ifndef __THREADMAN_H__
+typedef int (*SceKernelThreadEntry)(SceSize args, void *argp);
+#endif
+
+
+/** Reboot preparation functions */
+typedef s32 (*SceKernelRebootBeforeForKernel)(void *arg1, s32 arg2, s32 arg3, s32 arg4);
+typedef s32 (*SceKernelRebootPhaseForKernel)(s32 arg1, void *arg2, s32 arg3, s32 arg4);
+
+/** Module type attributes. */
+enum SceModuleAttribute {
+    /** No module attributes. */
+    SCE_MODULE_ATTR_NONE             = 0x0000,
+    /** Resident module - stays in memory. You cannot unload such a module. */
+    SCE_MODULE_ATTR_CANT_STOP        = 0x0001,
+    /**
+     * Only one instance of the module (one version) can be loaded into the system. If you want to load another
+     * version of that module, you have to delete the loaded version first.
+     */
+    SCE_MODULE_ATTR_EXCLUSIVE_LOAD   = 0x0002,
+    /**
+     * Only one instance of the module (one version) can be started. If you want to start another
+     * version of that module, you have to stop the currently running version first.
+     */
+    SCE_MODULE_ATTR_EXCLUSIVE_START  = 0x0004,
+};
+
+/**
+ * Module Privilege Levels - These levels define the permissions a
+ * module can have.
+ */
+enum SceModulePrivilegeLevel {
+    /** Lowest permission. */
+    SCE_MODULE_USER                 = 0x0000,
+    /** POPS/Demo. */
+    SCE_MODULE_MS                   = 0x0200,
+    /** Module Gamesharing. */
+    SCE_MODULE_USB_WLAN             = 0x0400,
+    /** Application module. */
+    SCE_MODULE_APP                  = 0x0600,
+    /** VSH module. */
+    SCE_MODULE_VSH                  = 0x0800,
+    /** Highest permission. */
+    SCE_MODULE_KERNEL               = 0x1000,
+    /** The module uses KIRK's memlmd resident library. */
+    SCE_MODULE_KIRK_MEMLMD_LIB      = 0x2000,
+    /** The module uses KIRK's semaphore resident library. */
+    SCE_MODULE_KIRK_SEMAPHORE_LIB   = 0x4000,
+};
+
+/** Describes a loaded module in memory.  This structure could change in future firmware revisions. */
 typedef struct SceModule {
-	struct SceModule	*next;
+	/** Pointer to the next registered module. Modules are connected via a linked list. */
-	unsigned short		attribute;
+	struct SceModule *next;
-	unsigned char		version[2];
+	/** The attributes of a module. One or more of ::SceModuleAttribute and ::SceModulePrivilegeLevel. */
-	char				modname[27];
+	u16			attribute;
-	char				terminal;
+	/**
-	unsigned int		unknown1;
+	 * The version of the module. Consists of a major and minor part. There can be several modules
-	unsigned int		unknown2;
+	 * loaded with the same name and version.
-	SceUID				modid;
+	*/
-	unsigned int		unknown3[4];
+	u8			version[2];
-	void *				ent_top;
+	/** The module's name. There can be several modules loaded with the same name. */
-	unsigned int		ent_size;
+	char		modname[27];
-	void *				stub_top;
+	/** String terminator (always '\0'). */
-	unsigned int		stub_size;
+	char		terminal;
-	unsigned int		unknown4[4];
+	/**
-	unsigned int		entry_addr;
+	 * The status of the module. Contains information whether the module has been started, stopped,
-	unsigned int		gp_value;
+	 * is a user module, etc.
-	unsigned int		text_addr;
+	 */
-	unsigned int		text_size;
+	u16 		mod_state;
-	unsigned int		data_size;
+	char 		padding[2];
-	unsigned int		bss_size;
+	/** A secondary ID for the module. */
-	unsigned int		nsegment;
+	SceUID 		sec_id;
-	unsigned int		segmentaddr[4];
+	/** The module's UID. */
-	unsigned int		segmentsize[4];
+	SceUID		modid;
-} __attribute__((packed)) SceModule;
+	/** The thread ID of a user module. */
+	SceUID 		user_mod_thid;
+	/** The ID of the memory block belonging to the module. */
+	SceUID 		mem_id;
+	/** The ID of the TEXT segment's memory partition. */
+	u32			mpid_text;
+	/** The ID of the DATA segment's memory partition. */
+	u32			mpid_data;
+	/** Pointer to the first resident library entry table of the module. */
+	void *		ent_top;
+	/** The size of all resident library entry tables of the module. */
+	SceSize		ent_size;
+	/** Pointer to the first stub library entry table of the module. */
+	void *		stub_top;
+	/** The size of all stub library entry tables of the module. */
+	SceSize		stub_size;
+	/**
+	 * A pointer to the (required) module's start entry function. This function is executed during
+	 * the module's startup.
+	 */
+	SceKernelThreadEntry module_start;
+	/**
+	 * A pointer to the (required) module's stop entry function. This function is executed during
+	 * the module's stopping phase.
+	 */
+	SceKernelThreadEntry module_stop;
+	/**
+	 * A pointer to a module's Bootstart entry function. This function is probably executed after
+	 * a reboot.
+	 */
+	SceKernelThreadEntry module_bootstart;
+	/**
+	 * A pointer to a module's rebootBefore entry function. This function is probably executed
+	 * before a reboot.
+	 */
+	SceKernelRebootBeforeForKernel module_reboot_before;
+	/**
+	 * A pointer to a module's rebootPhase entry function. This function is probably executed
+	 * during a reboot.
+	 */
+	SceKernelRebootPhaseForKernel module_reboot_phase;
+	/**
+	 * The entry address of the module. It is the offset from the start of the TEXT segment to the
+	 * program's entry point.
+	 */
+	u32		entry_addr;
+	/** Contains the offset from the start of the TEXT segment of the program's GP register value. */
+	u32		gp_value;
+	/** The start address of the TEXT segment. */
+	u32		text_addr;
+	/** The size of the TEXT segment. */
+	u32		text_size;
+	/** The size of the DATA segment. */
+	u32		data_size;
+	/** The size of the BSS segment. */
+	u32		bss_size;
+	/** The number of segments the module consists of. */
+	u8		nsegment;
+	/** Reserved. */
+	u8		padding2[3];
+	/** An array containing the start address of each segment. */
+	u32		segmentaddr[4];
+	/** An array containing the size of each segment. */
+	SceSize	segmentsize[4];
+	/** An array containing the alignment information of each segment. */
+	u32 	segmentalign[4];
+	/** The priority of the module start thread. */
+	s32 	module_start_thread_priority;
+	/** The stack size of the module start thread. */
+	SceSize module_start_thread_stacksize;
+	/** The attributes of the module start thread. */
+	SceUInt module_start_thread_attr;
+	/** The priority of the module stop thread. */
+	s32 	module_stop_thread_priority;
+	/** The stack size of the module stop thread. */
+	SceSize module_stop_thread_stacksize;
+	/** The attributes of the module stop thread. */
+	SceUInt module_stop_thread_attr;
+	/** The priority of the module reboot before thread. */
+	s32 	module_reboot_before_thread_priority;
+	/** The stack size of the module reboot before thread. */
+	SceSize module_reboot_before_thread_stacksize;
+	/** The attributes of the module reboot before thread. */
+	SceUInt module_reboot_before_thread_attr;
+	/** The value of the coprocessor 0's count register when the module is created. */
+	u32 	count_reg_val;
+	/** The segment checksum of the module's segments. */
+	u32 	segment_checksum;
+	/** TEXT segment checksum of the module. */
+	u32 	text_segment_checksum;
+	/**
+	 * Whether to compute the text segment checksum before starting the module (see prologue).
+	 * If non-zero, the text segment checksum will be computed after the module's resident libraries
+	 * have been registered, and its stub libraries have been linked.
+	 */
+	u32 	compute_text_segment_checksum;
+} SceModule;
 
 /** Defines a library and its exported functions and variables.  Use the len
     member to determine the real size of the table (size = len * 4). */