<?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 xml:lang="en" id="GUID-04F076C4-AFFF-571C-8B73-B8589B58EC56"><title>Limitations of Clocks and Timers</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>The following are some of the limitations of the clocks and timers feature supported on Symbian platform: </p> <ul><li id="GUID-5998F7A9-741F-51C8-8942-5B7BB05BE1C9"><p>The clock and timer APIs of the Librt library provide the same level of resolution as that of the Symbian platform APIs, such as <xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita#GUID-8A423EA2-4264-30C9-9579-0466994E6E88/GUID-3F302410-5CC2-3CCB-82F4-47E953E7A29B"><apiname>RTimer::At()</apiname></xref>, <xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita#GUID-8A423EA2-4264-30C9-9579-0466994E6E88/GUID-C2BD996C-81E3-3309-917A-731B0BD2C450"><apiname>RTimer::After()</apiname></xref> and <xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita#GUID-8A423EA2-4264-30C9-9579-0466994E6E88/GUID-EB3B05D9-5EEF-34A2-99F9-9FEA31EF3005"><apiname>RTimer::HighRes()</apiname></xref>. Any requests beyond the functionality provided by these APIs will be considered as invalid. </p> </li> <li id="GUID-91D21D58-8590-5498-9F1E-C8720AAC96DB"><p>Symbian platform does not support process level clocks and therefore all clock and timer solutions are based on the clock available to the user level process. The clock has a <codeph>clock_id</codeph> of <codeph>CLOCK_REALTIME</codeph>, and can be retrieved using <xref href="GUID-D4D30F8D-82D9-3919-9711-DFEE78946DBE.dita"><apiname>clock_getcpuclockid()</apiname></xref> by passing <b>0</b> in the <codeph>pid_t</codeph> parameter. </p> </li> <li id="GUID-F4E57415-4006-520A-9FA1-71BBE7EBFC06"><p>An application or library that uses the Librt library clock functions must link to <filepath>librt.dll</filepath> prior to all other libraries in the link order. This is because both <filepath>libc.dll</filepath> and <filepath>librt.dll</filepath> provide similar clock interfaces but only the Librt library is modified to behave according to the LSB 3.1 specification. </p> </li> </ul> </conbody><related-links><link href="GUID-9AC6774A-41E9-5298-8696-0A317A09E1E9.dita"><linktext>Librt Overview</linktext> </link> <link href="GUID-29AE56A8-DA08-5FB3-89F1-26B4308336BC.dita"><linktext>Modifying a Clock Time</linktext> </link> <link href="GUID-B4039418-6499-555D-AC24-9B49161299F2.dita"><linktext>Raising a Periodic Timer

                Request</linktext> </link> <link href="GUID-21740D07-5F49-5D9C-9FEA-92958AF3805B.dita"><linktext>Raising an Absolute Timer