Files
pspsdk/src/kernel/psploadexec_kernel.h
Steam Deck User 78a1f9ac72 Guard _PSP_FW_VERSION macro to mitigate warnings with -Wundef
Fixes #123. Guards `_PSP_FW_VERSION` references with `#if defined()` to avoid the SDK headers returning warnings when compiling modules with the `-Wundef` cflag.
2023-04-24 23:28:33 -04:00

165 lines
4.9 KiB
C

/*
* PSP Software Development Kit - https://github.com/pspdev
* -----------------------------------------------------------------------
* Licensed under the BSD license, see LICENSE in PSPSDK root for details.
*
* psploadexec_kernel.h - Interface to LoadExecForKernel.
*
* Copyright (c) 2007 - DA (Taken from the 303oe SDK)
*
*/
#ifndef PSPLOADEXEC_KERNEL_H
#define PSPLOADEXEC_KERNEL_H
#include <pspkerneltypes.h>
#include <psploadexec.h>
/** @defgroup LoadExecKernel Interface to the LoadExecForKernel library.
*/
#ifdef __cplusplus
extern "C" {
#endif
/** @addtogroup LoadExecKernel Interface to the LoadExecForKernel library. */
/**@{*/
/** Structure for LoadExecVSH* functions */
struct SceKernelLoadExecVSHParam {
/** Size of the structure in bytes */
SceSize size;
/** Size of the arguments string */
SceSize args;
/** Pointer to the arguments strings */
void * argp;
/** The key, usually "game", "updater" or "vsh" */
const char * key;
/** The size of the vshmain arguments */
u32 vshmain_args_size;
/** vshmain arguments that will be passed to vshmain after the program has exited */
void *vshmain_args;
/** "/kd/pspbtcnf_game.txt" or "/kd/pspbtcnf.txt" if not supplied (max. 256 chars) */
char *configfile;
/** An unknown string (max. 256 chars) probably used in 2nd stage of loadexec */
u32 unk4;
/** unknown flag default value = 0x10000 */
u32 unk5;
};
#if defined(_PSP_FW_VERSION) && _PSP_FW_VERSION < 200
/**
* Executes a new executable from a buffer.
*
* @param bufsize - Size in bytes of the buffer pointed by buf.
* @param buf - Pointer to a buffer containing the module to execute.
* @param param - Pointer to a ::SceKernelLoadExecParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecBufferPlain(SceSize bufsize, void *buf, struct SceKernelLoadExecParam *param);
#endif
/**
* Restart the vsh.
*
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL
*
* @return < 0 on some errors.
*
* @note - when called in game mode it will have the same effect that sceKernelExitGame
*
*/
int sceKernelExitVSHVSH(struct SceKernelLoadExecVSHParam *param);
#if defined(_PSP_FW_VERSION) && _PSP_FW_VERSION >= 200
/**
* Restart the vsh (to be used by a kernel module)
*
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL
*
* @return < 0 on some errors.
*
* @note - when called in game mode it will have the same effect that sceKernelExitGame
* @note2: available since firmware 2.00.
*/
int sceKernelExitVSHKernel(struct SceKernelLoadExecVSHParam *param);
#endif
/**
* Executes a new executable from a disc.
* It is the function used by the firmware to execute the EBOOT.BIN from a disc.
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecVSHDisc(const char *file, struct SceKernelLoadExecVSHParam *param);
/**
* Executes a new executable from a disc.
* It is the function used by the firmware to execute an updater from a disc.
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecVSHDiscUpdater(const char *file, struct SceKernelLoadExecVSHParam *param);
/**
* Executes a new executable from a memory stick.
* It is the function used by the firmware to execute an updater from a memory stick.
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecVSHMs1(const char *file, struct SceKernelLoadExecVSHParam *param);
/**
* Executes a new executable from a memory stick.
* It is the function used by the firmware to execute games (and homebrew :P) from a memory stick.
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecVSHMs2(const char *file, struct SceKernelLoadExecVSHParam *param);
/**
* Executes a new executable from a memory stick.
* It is the function used by the firmware to execute ... ?
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
*/
int sceKernelLoadExecVSHMs3(const char *file, struct SceKernelLoadExecVSHParam *param);
#if defined(_PSP_FW_VERSION) && _PSP_FW_VERSION >= 300
/***
* Executes a new executable from a memory stick.
* It is the function used by the firmware to execute psx games
*
* @param file - The file to execute.
* @param param - Pointer to a ::SceKernelLoadExecVSHParam structure, or NULL.
*
* @return < 0 on some errors.
* @note - Available since firmware 3.00
*/
int sceKernelLoadExecVSHMs4(const char *file, struct SceKernelLoadExecVSHParam *param);
#endif
/**@}*/
#ifdef __cplusplus
}
#endif
#endif