10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-39A8FBC9-5FD6-4F92-B71E-5C5438ECFD46" xml:lang="en"><title>OOM |
12 <concept id="GUID-39A8FBC9-5FD6-4F92-B71E-5C5438ECFD46" xml:lang="en"><title>OOM |
13 Monitor Overview</title><shortdesc>This section provides an overview of the functionality and the |
13 Monitor Overview</title><shortdesc>This section provides an overview of the functionality and the |
14 architecture of the OOM Monitor component.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 architecture of the OOM Monitor component.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
15 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-1"><title>Purpose</title><p>The |
15 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-1"><title>Purpose</title><p>The |
16 OOM Monitor Client API monitors the memory situations and handles out of memory |
16 OOM Monitor Client API monitors the memory situations and handles out of memory |
17 situations. OOM monitor is responsible to maintain good memory level in the |
17 situations. OOM monitor is responsible to maintain good memory level in the |
18 device. In case of low memory situation, OOM Monitor releases memory by closing |
18 device. In case of low memory situation, OOM Monitor releases memory by closing |
19 applications based on the priority defined. For information on priority, refer |
19 applications based on the priority defined. For information on priority, refer |
20 to <xref href="GUID-CE308C71-D8B2-43B3-97FD-B868285ED5FB.dita">OOM Monitor Priority</xref>.</p> |
20 to <xref href="GUID-CE308C71-D8B2-43B3-97FD-B868285ED5FB.dita">OOM Monitor Priority</xref>.</p> |
21 </section> |
21 </section> |
22 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-2"><title>Key concepts</title><dl> |
22 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-2"><title>Key concepts</title><dl> |
23 <dlentry> |
23 <dlentry> |
24 <dt>LOW_RAM_THRESHOLD</dt> |
24 <dt>LOW_RAM_THRESHOLD</dt> |
25 <dd><p>It is the minimum amount of free RAM that is specified for the device. |
25 <dd><p>It is the minimum amount of free RAM that is specified for the device. |
26 This value must be specified in the monitor configuration file. </p> </dd> |
26 This value must be specified in the monitor configuration file. </p> </dd> |
27 </dlentry> |
27 </dlentry> |
37 This process is called as normal RAM rotation.</p> </dd> |
37 This process is called as normal RAM rotation.</p> </dd> |
38 </dlentry> |
38 </dlentry> |
39 </dl><p>For information on OOM Monitor Priority and Optional RAM allocation, |
39 </dl><p>For information on OOM Monitor Priority and Optional RAM allocation, |
40 refer to <xref href="GUID-F6A33835-D677-41D0-86BB-812E3AFA5192.dita">OOM Monitor |
40 refer to <xref href="GUID-F6A33835-D677-41D0-86BB-812E3AFA5192.dita">OOM Monitor |
41 Concepts</xref></p> </section> |
41 Concepts</xref></p> </section> |
42 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-3"><title>Architecture</title> <p>The |
42 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-3"><title>Architecture</title> <p>The |
43 basic function of the OOM Monitor is to monitor the amount of free RAM in |
43 basic function of the OOM Monitor is to monitor the amount of free RAM in |
44 the mobile device. Whenever the amount of free RAM decreases below a defined <keyword>LOW_RAM_THRESHOLD</keyword> threshold |
44 the mobile device. Whenever the amount of free RAM decreases below a defined <keyword>LOW_RAM_THRESHOLD</keyword> threshold |
45 value, the OOM Monitor is triggered. The OOM Monitor then releases RAM by |
45 value, the OOM Monitor is triggered. The OOM Monitor then releases RAM by |
46 closing applications running on background in order to raise the amount of |
46 closing applications running on background in order to raise the amount of |
47 free RAM above the defined GOOD_RAM_THRESHOLD value.</p><fig id="GUID-1DD9B22F-1060-4AC9-899B-EC2D91E7B948"> |
47 free RAM above the defined GOOD_RAM_THRESHOLD value.</p><fig id="GUID-1DD9B22F-1060-4AC9-899B-EC2D91E7B948"> |
48 <image href="GUID-F4203C60-EB2A-4644-8B2D-291087724BA9_d0e184675_href.png" placement="inline"/> |
48 <image href="GUID-F4203C60-EB2A-4644-8B2D-291087724BA9_d0e190752_href.png" placement="inline"/> |
49 </fig><fig id="GUID-573E838C-50CD-4CE7-B608-6BBD18B29088"> |
49 </fig><fig id="GUID-573E838C-50CD-4CE7-B608-6BBD18B29088"> |
50 <image href="GUID-AA820231-5C46-46A1-A310-ABBA45593B1F_d0e184679_href.png" scale="100" placement="inline"/> |
50 <image href="GUID-AA820231-5C46-46A1-A310-ABBA45593B1F_d0e190756_href.png" scale="100" placement="inline"/> |
51 </fig> </section> |
51 </fig> </section> |
52 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-4"><title>APIs</title><p>The |
52 <section id="GUID-84DFAB24-BC7F-45B2-813D-6CD05EBCF34F-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-4"><title>APIs</title><p>The |
53 OOM Monitor Client API consists of <xref href="GUID-02D1911A-D2E5-3D28-9B05-75DA0A75DE73.dita"><apiname>ROomMonitorSession</apiname></xref> class. |
53 OOM Monitor Client API consists of <xref href="GUID-02D1911A-D2E5-3D28-9B05-75DA0A75DE73.dita"><apiname>ROomMonitorSession</apiname></xref> class. |
54 The main functions of this class are:</p><table id="GUID-CF94290C-7BE9-418F-9CF0-93DE74814097-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-4-3"> |
54 The main functions of this class are:</p><table id="GUID-CF94290C-7BE9-418F-9CF0-93DE74814097-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-4-3"> |
55 <tgroup cols="2"><colspec colname="col1" colwidth="0.70*"/><colspec colname="col2" colwidth="1.30*"/> |
55 <tgroup cols="2"><colspec colname="col1" colwidth="0.70*"/><colspec colname="col2" colwidth="1.30*"/> |
56 <tbody> |
56 <tbody> |
57 <row> |
57 <row> |
58 <entry><p><b>Function</b></p></entry> |
58 <entry><p><b>Function</b></p></entry> |
59 <entry><p><b>Description</b></p></entry> |
59 <entry><p><b>Description</b></p></entry> |
72 <entry><p>Requests the OOM monitor to allocate optional RAM.</p></entry> |
72 <entry><p>Requests the OOM monitor to allocate optional RAM.</p></entry> |
73 </row> |
73 </row> |
74 </tbody> |
74 </tbody> |
75 </tgroup> |
75 </tgroup> |
76 </table><p>The OOM Monitor Client API also consists of <xref href="GUID-ACE03F26-555A-363E-B220-44FCA7E8EACB.dita"><apiname>COomMonitorPlugin</apiname></xref> class. |
76 </table><p>The OOM Monitor Client API also consists of <xref href="GUID-ACE03F26-555A-363E-B220-44FCA7E8EACB.dita"><apiname>COomMonitorPlugin</apiname></xref> class. |
77 The main functions of this plug-in class are:</p><table id="GUID-CF94290C-7BE9-418F-9CF0-93DE74814097-GENID-1-12-1-12-1-1-9-1-5-1-4-1-3-4-5"> |
77 The main functions of this plug-in class are:</p><table id="GUID-CF94290C-7BE9-418F-9CF0-93DE74814097-GENID-1-12-1-13-1-1-9-1-5-1-4-1-3-4-5"> |
78 <tgroup cols="2"><colspec colname="col1" colwidth="0.70*"/><colspec colname="col2" colwidth="1.30*"/> |
78 <tgroup cols="2"><colspec colname="col1" colwidth="0.70*"/><colspec colname="col2" colwidth="1.30*"/> |
79 <tbody> |
79 <tbody> |
80 <row> |
80 <row> |
81 <entry><p><b>Function</b></p></entry> |
81 <entry><p><b>Function</b></p></entry> |
82 <entry><p><b>Description</b></p></entry> |
82 <entry><p><b>Description</b></p></entry> |