#include <revolution/os.h> void OSExecl(const char* dolfile, const char* arg0, .../*, (char*)NULL */); void OSExecv(const char* dolfile, char* const argv[]);
| dolfile | Path name of the file to be executed. If a null string is specified, the default dol file (the one booted by IPL) is executed. |
|---|---|
| arg0,... | ( A list of pointers to zero or more null-terminated strings that make up an argument list that can be used by the dol file to be executed (OSExecl function only). The list of arguments must be terminated by a NULL pointer. |
| argv | ( An array of pointers to zero or more null-terminated strings that make up an argument list that can be used by new programs (OSExecv function only). The array of pointers must be terminated by a NULL pointer. |
None.
OSExecl/OSExecv execute a new dol file. If successful, the functions never return.
The initial argument for these functions is the full pathname of the dol file to execute. If the null string is specified, the default dol file that the IPL boots is executed.
If the specified dol file does not exist, an assertion error occurs when using the debug library. In this same case, the function returns immediately when using the release library.
Arguments for OSExecl are in the order of arg0, arg1, ..., argn. Together they describe a list of pointers to zero or more null-terminated strings that represent the argument list available to the new dol file. The list of arguments must be terminated by a NULL pointer.
OSExecv provides an array of pointers to zero or more null-terminated strings that represent the argument list available to the new dol file. The array of pointers must be terminated by a NULL pointer.
The controllers will not be recalibrated during an execution sequence.
If the Game Disc cannot be read during an execution sequence for any reason (including no disc, retry error, fatal error, wrong error), OSExecl/OSExecv will return execution to the system menu. So if there is data not saved to the memory card, please make sure to save it before calling OSExecl/OSExecv (rather than passing the data using the save region feature).
An elf file can be converted to a dol file using makedol.
Note: Data in memory is not guaranteed to remain unchanged after the OSExecl or OSExecv function is run. Use the OSSetSaveRegion function to avoid data loss in a specified region.
OSSetSaveRegion, OSIsRestart, makedol
2008/05/12 Revised the description of OSSetSaveRegion.
2006/10/25 Revised explanation.
2006/08/30 Re-released.
2006/06/19 Temporarily deleted the release.
2006/03/01 Initial version.
CONFIDENTIAL