136 lines
15 KiB
HTML
136 lines
15 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.9.1"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<title>libctru: include/3ds/services/loader.h Source File</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectalign" style="padding-left: 0.5em;">
|
|
<div id="projectname">libctru
|
|
 <span id="projectnumber">v2.4.1</span>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.9.1 -->
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript" src="menudata.js"></script>
|
|
<script type="text/javascript" src="menu.js"></script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
$(function() {
|
|
initMenu('',true,false,'search.php','Search');
|
|
$(document).ready(function() { init_search(); });
|
|
});
|
|
/* @license-end */</script>
|
|
<div id="main-nav"></div>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
<div id="nav-path" class="navpath">
|
|
<ul>
|
|
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_d475325f6a9fe3bfc3a495c72a9e475e.html">3ds</a></li><li class="navelem"><a class="el" href="dir_0e005207343684f6967052d1f51a7e66.html">services</a></li> </ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="headertitle">
|
|
<div class="title">loader.h</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<a href="loader_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/**</span></div>
|
|
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> * @file loader.h</span></div>
|
|
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> * @brief LOADER Service</span></div>
|
|
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> */</span></div>
|
|
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>  </div>
|
|
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="preprocessor">#pragma once</span></div>
|
|
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span>  </div>
|
|
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="preprocessor">#include <<a class="code" href="exheader_8h.html">3ds/exheader.h</a>></span></div>
|
|
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="preprocessor">#include <<a class="code" href="fs_8h.html">3ds/services/fs.h</a>></span></div>
|
|
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">/// Initializes LOADER.</span></div>
|
|
<div class="line"><a name="l00012"></a><span class="lineno"><a class="line" href="loader_8h.html#a8a4ba25f161b1784615c95ce07b99993"> 12</a></span> <span class="comment"></span><a class="code" href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a> <a class="code" href="loader_8h.html#a8a4ba25f161b1784615c95ce07b99993">loaderInit</a>(<span class="keywordtype">void</span>);</div>
|
|
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">/// Exits LOADER.</span></div>
|
|
<div class="line"><a name="l00015"></a><span class="lineno"><a class="line" href="loader_8h.html#a7265d2b7f9f9bb34110650c207549ffc"> 15</a></span> <span class="comment"></span><span class="keywordtype">void</span> <a class="code" href="loader_8h.html#a7265d2b7f9f9bb34110650c207549ffc">loaderExit</a>(<span class="keywordtype">void</span>);</div>
|
|
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">/**</span></div>
|
|
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> * @brief Loads a program and returns a process handle to the newly created process.</span></div>
|
|
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> * @param[out] process Pointer to output the process handle to.</span></div>
|
|
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> * @param programHandle The handle of the program to load.</span></div>
|
|
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"> */</span></div>
|
|
<div class="line"><a name="l00022"></a><span class="lineno"><a class="line" href="loader_8h.html#a201c006d0bd37577563e228e1ab7166f"> 22</a></span> <a class="code" href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a> <a class="code" href="loader_8h.html#a201c006d0bd37577563e228e1ab7166f">LOADER_LoadProcess</a>(<a class="code" href="types_8h.html#ab6d744c6b5de129f12937e482dc674fb">Handle</a>* process, <a class="code" href="types_8h.html#a3f7e2bcbb0b4c338f3c4f6c937cd4234">u64</a> programHandle);</div>
|
|
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">/**</span></div>
|
|
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment"> * @brief Registers a program (along with its update).</span></div>
|
|
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment"> * @param[out] programHandle Pointer to output the program handle to.</span></div>
|
|
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment"> * @param programInfo The program info.</span></div>
|
|
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment"> * @param programInfo The program update info.</span></div>
|
|
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment"> */</span></div>
|
|
<div class="line"><a name="l00030"></a><span class="lineno"><a class="line" href="loader_8h.html#a88f34584ea1e64478a8e19ff0cc1cc84"> 30</a></span> <a class="code" href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a> <a class="code" href="loader_8h.html#a88f34584ea1e64478a8e19ff0cc1cc84">LOADER_RegisterProgram</a>(<a class="code" href="types_8h.html#a3f7e2bcbb0b4c338f3c4f6c937cd4234">u64</a>* programHandle, <span class="keyword">const</span> <a class="code" href="structFS__ProgramInfo.html">FS_ProgramInfo</a> *programInfo, <span class="keyword">const</span> <a class="code" href="structFS__ProgramInfo.html">FS_ProgramInfo</a> *programInfoUpdate);</div>
|
|
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="comment">/**</span></div>
|
|
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="comment"> * @brief Unregisters a program (along with its update).</span></div>
|
|
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment"> * @param programHandle The handle of the program to unregister.</span></div>
|
|
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment"> */</span></div>
|
|
<div class="line"><a name="l00036"></a><span class="lineno"><a class="line" href="loader_8h.html#a92acb8ea4312f21ef0c591f883ef48bc"> 36</a></span> <a class="code" href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a> <a class="code" href="loader_8h.html#a92acb8ea4312f21ef0c591f883ef48bc">LOADER_UnregisterProgram</a>(<a class="code" href="types_8h.html#a3f7e2bcbb0b4c338f3c4f6c937cd4234">u64</a> programHandle);</div>
|
|
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"></span> </div>
|
|
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">/**</span></div>
|
|
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> * @brief Retrives a program's main NCCH extended header info (SCI + ACI, see @ref ExHeader_Info).</span></div>
|
|
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment"> * @param[out] exheaderInfo Pointer to output the main NCCH extended header info.</span></div>
|
|
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment"> * @param programHandle The handle of the program to unregister</span></div>
|
|
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment"> */</span></div>
|
|
<div class="line"><a name="l00043"></a><span class="lineno"><a class="line" href="loader_8h.html#a681745c9fd51ef6f2339dfec753555f4"> 43</a></span> <a class="code" href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a> <a class="code" href="loader_8h.html#a681745c9fd51ef6f2339dfec753555f4">LOADER_GetProgramInfo</a>(<a class="code" href="structExHeader__Info.html">ExHeader_Info</a>* exheaderInfo, <a class="code" href="types_8h.html#a3f7e2bcbb0b4c338f3c4f6c937cd4234">u64</a> programHandle);</div>
|
|
<div class="ttc" id="aexheader_8h_html"><div class="ttname"><a href="exheader_8h.html">exheader.h</a></div><div class="ttdoc">NCCH extended header definitions.</div></div>
|
|
<div class="ttc" id="afs_8h_html"><div class="ttname"><a href="fs_8h.html">fs.h</a></div><div class="ttdoc">Filesystem Services.</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a201c006d0bd37577563e228e1ab7166f"><div class="ttname"><a href="loader_8h.html#a201c006d0bd37577563e228e1ab7166f">LOADER_LoadProcess</a></div><div class="ttdeci">Result LOADER_LoadProcess(Handle *process, u64 programHandle)</div><div class="ttdoc">Loads a program and returns a process handle to the newly created process.</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a681745c9fd51ef6f2339dfec753555f4"><div class="ttname"><a href="loader_8h.html#a681745c9fd51ef6f2339dfec753555f4">LOADER_GetProgramInfo</a></div><div class="ttdeci">Result LOADER_GetProgramInfo(ExHeader_Info *exheaderInfo, u64 programHandle)</div><div class="ttdoc">Retrives a program's main NCCH extended header info (SCI + ACI, see ExHeader_Info).</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a7265d2b7f9f9bb34110650c207549ffc"><div class="ttname"><a href="loader_8h.html#a7265d2b7f9f9bb34110650c207549ffc">loaderExit</a></div><div class="ttdeci">void loaderExit(void)</div><div class="ttdoc">Exits LOADER.</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a88f34584ea1e64478a8e19ff0cc1cc84"><div class="ttname"><a href="loader_8h.html#a88f34584ea1e64478a8e19ff0cc1cc84">LOADER_RegisterProgram</a></div><div class="ttdeci">Result LOADER_RegisterProgram(u64 *programHandle, const FS_ProgramInfo *programInfo, const FS_ProgramInfo *programInfoUpdate)</div><div class="ttdoc">Registers a program (along with its update).</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a8a4ba25f161b1784615c95ce07b99993"><div class="ttname"><a href="loader_8h.html#a8a4ba25f161b1784615c95ce07b99993">loaderInit</a></div><div class="ttdeci">Result loaderInit(void)</div><div class="ttdoc">Initializes LOADER.</div></div>
|
|
<div class="ttc" id="aloader_8h_html_a92acb8ea4312f21ef0c591f883ef48bc"><div class="ttname"><a href="loader_8h.html#a92acb8ea4312f21ef0c591f883ef48bc">LOADER_UnregisterProgram</a></div><div class="ttdeci">Result LOADER_UnregisterProgram(u64 programHandle)</div><div class="ttdoc">Unregisters a program (along with its update).</div></div>
|
|
<div class="ttc" id="astructExHeader__Info_html"><div class="ttname"><a href="structExHeader__Info.html">ExHeader_Info</a></div><div class="ttdoc">Main extended header data, as returned by PXIPM, Loader and FSREG service commands.</div><div class="ttdef"><b>Definition:</b> exheader.h:181</div></div>
|
|
<div class="ttc" id="astructFS__ProgramInfo_html"><div class="ttname"><a href="structFS__ProgramInfo.html">FS_ProgramInfo</a></div><div class="ttdoc">Program information.</div><div class="ttdef"><b>Definition:</b> fs.h:183</div></div>
|
|
<div class="ttc" id="atypes_8h_html_a3f7e2bcbb0b4c338f3c4f6c937cd4234"><div class="ttname"><a href="types_8h.html#a3f7e2bcbb0b4c338f3c4f6c937cd4234">u64</a></div><div class="ttdeci">uint64_t u64</div><div class="ttdoc">64-bit unsigned integer</div><div class="ttdef"><b>Definition:</b> types.h:24</div></div>
|
|
<div class="ttc" id="atypes_8h_html_ab6d744c6b5de129f12937e482dc674fb"><div class="ttname"><a href="types_8h.html#ab6d744c6b5de129f12937e482dc674fb">Handle</a></div><div class="ttdeci">u32 Handle</div><div class="ttdoc">Resource handle.</div><div class="ttdef"><b>Definition:</b> types.h:41</div></div>
|
|
<div class="ttc" id="atypes_8h_html_ac830bf5a4f2cf8273f61ab99a46cf163"><div class="ttname"><a href="types_8h.html#ac830bf5a4f2cf8273f61ab99a46cf163">Result</a></div><div class="ttdeci">s32 Result</div><div class="ttdoc">Function result.</div><div class="ttdef"><b>Definition:</b> types.h:42</div></div>
|
|
</div><!-- fragment --></div><!-- contents -->
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
|
|
</small></address>
|
|
</body>
|
|
</html>
|