1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7    <style type="text/css"><!--
8      span.static_style
9      {
10        font-size			: 8pt;
11        color				: white;
12        font-weight			: bold;
13        background			: #44f;
14        border-left			: solid 1px #aaf;
15        border-top			: solid 1px #aaf;
16        border-right		: solid 1px #00c;
17        border-bottom		: solid 1px #00c;
18        padding-left		: 2px;
19        padding-right		: 2px;
20      }
21
22      span.virtual_style
23      {
24        font-size			 : 8pt;
25        color				 : white;
26        font-weight			: bold;
27        background			: #0a0;
28        border-left			: solid 1px #0f0;
29        border-top			: solid 1px #0f0;
30        border-right		: solid 1px #060;
31        border-bottom		: solid 1px #060;
32        padding-left		: 2px;
33        padding-right		: 2px;
34      }
35
36      span.protected_style
37      {
38        font-size			 : 8pt;
39        color				 : white;
40        font-weight			: bold;
41        background			: #444;
42        border-left			: solid 1px #ccc;
43        border-top			: solid 1px #ccc;
44        border-right		: solid 1px #222;
45        border-bottom		: solid 1px #222;
46        padding-left		: 2px;
47        padding-right		: 2px;
48      }
49        --></style>
50<title>nn::ndm</title>
51  </head>
52  <body>
53<h1><CODE>nn::ndm</CODE> Namespace</h1>
54<h2>Description</h2>
55    <div class="section">
56<p>Namespace for the network daemon control library.</p><p>
57A daemon is a static module that processes autonomously in the background of the application. CTR has a number of daemons for network processes.<br /><CODE>ndm (Network Daemon Manager)</CODE> is a special daemon that manages the daemons performing network processes. The <CODE>ndm</CODE> library is a library for controlling this special daemon.
58</p><h3>The Need for Daemon Control</h3><p>
59The application runs on the CPU's application core, while the daemons run in parallel on the CPU's system core. Accordingly, the daemons do not directly take away from the application's CPU time. <br />On the other hand, the application and the daemons share the network and NAND. For this reason, the activities of the daemons can in some cases impact the performance of the application.
60          </p><p>
61If a decline in network or NAND performance is fatal to the application, the <CODE>ndm</CODE> library can halt the operations of the various communication modules.<br />(For example, when a network multiplayer mode requiring low latency is started or when the scene switches to a scene that loads a large volume of data from NAND.)
62          </p><p>
63When switching to local communications or another communications mode, the various communications libraries control the daemons automatically via the <CODE>ndm</CODE> library.<br />The application developer does not have to worry about anything other than performance.
64</p><h3>Daemons Under Control of the <CODE>ndm </CODE>Library</h3><p>
65Daemons can be freely stopped, but the different daemons all have their roles to play, so there are various restrictions on the stopping of daemons. It is therefore important to understand how the stopping of any given daemon will impact the system.
66          </p><p>
67A document will be prepared in the future, providing details about the various daemons.<br />For this current release, please do not use the functions that control individual daemons (<CODE><a href="../../nn/ndm/Suspend.html">nn::ndm::Suspend</a></CODE> and <CODE><a href="../../nn/ndm/Resume.html">nn::ndm::Resume</a></CODE>); instead, use the functions that control all of the daemons (<CODE><a href="../../nn/ndm/SuspendScheduler.html">nn::ndm::SuspendScheduler</a></CODE>, <CODE><a href="../../nn/ndm/ResumeScheduler.html">nn::ndm::ResumeScheduler</a></CODE>, and the like).
68</p><table><caption><B>Reference</B> Predicted Impacts of Daemons on Applications</caption><thead><tr><th>
69Daemon<br />(<span>nn::ndm::DaemonName</span>)
70</th><th>Impact on Network</th><th>Impact on NAND</th></tr></thead><tbody><tr><th><span>nn::ndm::DN_CEC</span></th><td>
71None<br />(Infrastructure communications not used)
72                </td><td>
73Moderate<br />(NAND access of some 10KB to 10MB occurs when Streetpass is being established)
74</td></tr><tr><th><span>nn::ndm::DN_BOSS</span></th><td>
75High <br />(HTTP communications occur when task executes)
76                </td><td>
77High<br />(NAND write occurs when task executes)
78</td></tr><tr><th><span>nn::ndm::DN_NIM</span></th><td>
79Low <br />(HTTP communications occur when connecting to access point)
80                </td><td>
81Low
82</td></tr><tr><th><span>nn::ndm::DN_FRIENDS</span></th><td>
83Low<br />(UDP communications occur when disconnecting)
84                </td><td>
85Low
86                </td></tr></tbody></table></div>
87    <a name="function" id="function">
88<h2>Functions</h2>
89      <div class="section">
90        <table class="members">
91          <tr>
92            <td width="100">  </td>
93            <th>
94<a href="../../nn/ndm/Initialize.html"><CODE>Initialize</CODE></a>
95            </th>
96<td>Initializes the network daemon control library.</td>
97          </tr>
98          <tr>
99            <td width="100">  </td>
100            <th>
101<a href="../../nn/ndm/Finalize.html"><CODE>Finalize</CODE></a>
102            </th>
103<td>Finalizes the network daemon control library.</td>
104          </tr>
105          <tr>
106            <td width="100">  </td>
107            <th>
108<a href="../../nn/ndm/SuspendDaemons.html"><CODE>SuspendDaemons</CODE></a>
109            </th>
110<td>Suspends autonomous operation of all network daemons.</td>
111          </tr>
112          <tr>
113            <td width="100">  </td>
114            <th>
115<a href="../../nn/ndm/ResumeDaemons.html"><CODE>ResumeDaemons</CODE></a>
116            </th>
117<td>Resumes autonomous operation of all network daemons.</td>
118          </tr>
119          <tr>
120            <td width="100">  </td>
121            <th>
122<a href="../../nn/ndm/Suspend.html"><CODE>Suspend</CODE></a>
123            </th>
124<td>Suspends autonomous operation of the network daemon.</td>
125          </tr>
126          <tr>
127            <td width="100">  </td>
128            <th>
129<a href="../../nn/ndm/Resume.html"><CODE>Resume</CODE></a>
130            </th>
131<td>Resumes autonomous operation of the network daemon.</td>
132          </tr>
133          <tr>
134            <td width="100">  </td>
135            <th>
136<a href="../../nn/ndm/SuspendScheduler.html"><CODE>SuspendScheduler</CODE></a>
137            </th>
138<td>Suspends the daemon manager that handles scheduling for all network daemons.</td>
139          </tr>
140          <tr>
141            <td width="100">  </td>
142            <th>
143<a href="../../nn/ndm/ResumeScheduler.html"><CODE>ResumeScheduler</CODE></a>
144            </th>
145<td>Resumes daemon scheduling.</td>
146          </tr>
147          <tr>
148            <td width="100">  </td>
149            <th>
150<a href="../../nn/ndm/SetupDaemonsDefault.html"><CODE>SetupDaemonsDefault</CODE></a>
151            </th>
152<td>Reverts network daemon operating permissions to the SDK defaults.</td>
153          </tr> </table>
154      </div>
155    </a>
156<h2>Revision History</h2>
157    <div class="section">
158      <dl class="history">
159        <dt>2010/09/17</dt>
160<dd>Initial version.<br />
161        </dd>
162      </dl>
163    </div>
164  <hr><p>CONFIDENTIAL</p></body>
165</html>