--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-EC7DE823-BFAC-47E5-B7CC-154B11FE5D77.dita	Fri Jul 16 17:23:46 2010 +0100
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-EC7DE823-BFAC-47E5-B7CC-154B11FE5D77" xml:lang="en"><title>Obsolete
+NKern Interrupt Methods</title><shortdesc>This document specifies two obsolete interrupt handling methods
+and describes their replacement.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-5AE312EB-D12B-4836-AAEA-9A54E179DE5C"><title>Description
+of the obsolete interrupt methods</title><p>The obsolete <codeph>NKern</codeph> interrupt
+methods are: </p><ul>
+<li><p><xref href="GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02.dita#GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02/GUID-CA1C36B7-02EE-31D5-B700-27DE4769ECCF"><apiname>NKern::DisableInterrupts()</apiname></xref> and</p></li>
+<li><p><xref href="GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02.dita#GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02/GUID-8C251C65-FDE7-3161-8D2B-61401FB6487F"><apiname>NKern::DisableAllInterrupts()</apiname></xref></p></li>
+</ul><p>These methods are used (with other methods in the <codeph>NKern</codeph> class)
+to protect shared data between an ISR (Interrupt Service Request) and a thread
+(or a DFC (Delayed Function Call )). </p><p>The steps involved in disabling/enabling
+an interrupt are:</p><ol>
+<li id="GUID-68D7CCE7-6855-4817-BC0C-D5B70E485450"><p>Disable the interrupts</p></li>
+<li id="GUID-81CB8BE3-8663-4CF6-A0CA-E2A43B0ADB74"><p>Process the data</p></li>
+<li id="GUID-8D5DBB24-4FB7-4E9B-8714-AFFBDE060346"><p>Re-enable the interrupts</p></li>
+</ol><note>The time spent processing the data must be as short as possible,
+otherwise performance problems could occur.</note> </section>
+<section id="GUID-E58BC240-4388-4BD8-A5CB-A79C3502AD07"><title>The reason
+why these methods are obsolete</title><p>These methods only affect the core
+that the thread is running on instead of all the cores on the system.</p></section>
+<section id="GUID-9F89D474-D2AB-4DE9-92F3-7B1A1677EDB7"><title>The replacement
+for these methods</title><p>These methods have been replaced by the following:</p><ul>
+<li><p><xref href="GUID-16AB388A-ED3E-4901-857D-834072437D25.dita">Spin Lock</xref> macros</p><p>These
+macros automatically carry out the required interrupt operations.</p></li>
+<li><p><xref href="GUID-1F280171-A3F3-4129-8DBE-3B1C4D629C68.dita">Atomic Operations</xref></p></li>
+</ul></section>
+<section id="GUID-B6EEC990-2DBF-4858-8B40-7D0BC489C6DE"><title>Areas that
+could be affected</title><p>These obsolete methods are used within drivers
+and the following points should be considered when removing them:</p><ul>
+<li><p>Could the same functionality be accomplished by disabling the interrupts
+in hardware?</p></li>
+<li><p>Are these methods required at all?</p><p>If memory is not accessible
+in ISR (Interrupt Service Request) routines, then use spin locks or atomic
+operations.</p></li>
+<li><p>Explore the use of DFC (Delayed Function Call) signalling.</p></li>
+</ul></section>
+</conbody><related-links>
+<link href="GUID-734588CA-5644-438A-9CC9-77ECBE0C1EEA.dita"><linktext>Obsolete
+Mechanisms</linktext></link>
+<link href="GUID-16AB388A-ED3E-4901-857D-834072437D25.dita"><linktext>Spin Locks</linktext>
+</link>
+<link href="GUID-1F280171-A3F3-4129-8DBE-3B1C4D629C68.dita"><linktext> Atomic Operations</linktext>
+</link>
+</related-links></concept>
\ No newline at end of file