diff -r 000000000000 -r a41df078684a kerneltest/e32utils/demandpaging/dptest.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/kerneltest/e32utils/demandpaging/dptest.h Mon Oct 19 15:55:17 2009 +0100 @@ -0,0 +1,128 @@ +// Copyright (c) 2006-2009 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: +// +// Description: +// Functions for test and analysis of demand paging. +// +// + +/** + @file + @test + @publishedPartner + @publishedPartner + @test +*/ +class DPTest + { +public: + /** + The attributes of the demand paging system. + */ + enum TAttributes + { + /** + The ROM is being demand paged. + */ + ERomPaging = 1<<0, + + /** + Individual executable files can be demand paged. + */ + ECodePaging = 1<<1, + + /** + User RAM can be demand paged. + */ + EDataPaging = 1<<2 + }; + + /** + Return the attributes of the demand paging system. + This is a bitfield consisting of values from enum TAttributes + */ + IMPORT_C static TUint32 Attributes(); + + /** + Evict the contents of the virtual memory cache and reduce it to its minimum size. + + @return KErrNone, if successful; otherwise one of the other system wide error codes. + + @capability WriteDeviceData + */ + IMPORT_C static TInt FlushCache(); + + /** + Change the minimum and maximum RAM sizes used for the virtual memory cache. + + These values may be silently restricted to platforn specific limits. + If required, GetCacheSize can be used to verify sizes actually applied to the system. + + If there is not enough memory to set the specified cache size then KErrNoMemory is + returned, however the cache size may still have been modified in an attempt to + service the request. + + @param aMinSize Minimum size for cache in bytes. + @param aMaxSize Maximum size for cache in bytes. + Using zero for this value will restore cache sizes to the + initial values used after boot. + + @return KErrNone, if successful; + KErrNoMemory if the is not enough memory; + KErrArgument if aMinSize>aMaxSize + otherwise one of the other system wide error codes. + + @capability WriteDeviceData + */ + IMPORT_C static TInt SetCacheSize(TUint aMinSize,TUint aMaxSize); + + /** + Get the current values of the RAM sizes used for the virtual memory cache. + + @param[out] aMinSize Minimum size for cache in bytes. + @param[out] aMaxSize Maximum size for cache in bytes. + @param[out] aCurrentSize The current size for cache in bytes. + This may be greater than aMaxSize. + + @return KErrNone, if successful; otherwise one of the other system wide error codes. + */ + IMPORT_C static TInt CacheSize(TUint& aMinSize,TUint& aMaxSize,TUint& aCurrentSize); + + /** + Paging event information. + */ + struct TEventInfo + { + /** + The total number of page faults which have occurred. + */ + TUint64 iPageFaultCount; + + /** + The total number of page faults which resulted in reading a page + from storage media. + */ + TUint64 iPageInReadCount; + }; + + /** + Get paging event information. + + @param[out] aInfo A descriptor to hold the returned information. + The contents of the descriptor are in the form of a #TEventInfo object. + + @return KErrNone, if successful; otherwise one of the other system wide error codes. + */ + IMPORT_C static TInt EventInfo(TDes8& aInfo); + }; + +