// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// which accompanies this distribution, and is available

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// Symbian_OS.hrh

// Configuration options for Symbian OS

// This file is managed by the Master Codeline Forum

// SYMBIAN_JAVA_NOT_INCLUDED

// build.  

// 

//

/**

 @publishedPartner

*/

#define SYMBIAN_JAVA_NOT_INCLUDED

/**

@publishedAll

__WATCHER_API_V2__

If __WATCHER_API_V2__ is defined then the 

watcher framework supports ECOM watcher plugins.

*/

#define __WATCHER_API_V2__

/**

@publishedAll

__HIDE_WATCHER_API_V1__

Hides support APIs for loading non-ECOM watcher plugins. Non-ECOM watcher 

plugins are still loaded. The associated define __REMOVE_WATCHER_API_V1__

removes the implementation of the support APIs.

Assumes that __WATCHER_API_V2__ has been defined.

*/

#define __HIDE_WATCHER_API_V1__

#define __REMOVE_WATCHER_API_V1__

/**

SYMBIAN_TIMEZONE_SUPPORT_V1

@publishedAll

When SYMBIAN_TIMEZONE_SUPPORT_V1 is defined the App-services TzClient.dll 

module (and accompanying import library) is made available for client 

application use.

This #define supports PREQ663

*/

#define SYMBIAN_TIMEZONE_SUPPORT_V1

/** 

@publishedAll

SYMBIAN_ENABLE_MMF_MULTISCREEN_SUPPORT

If SYMBIAN_ENABLE_MMF_MULTISCREEN_SUPPORT is defined then 

the Multimedia Framework (MMF) can support video playback on 

a secondary display. The default screen will be the screen 

number in the cone environment.

@see CVideoPlayerUtility

*/

#define SYMBIAN_ENABLE_MMF_MULTISCREEN_SUPPORT

/**

@publishedAll

SYMBIAN_EXTENDED_COMPOSITE_FILESYSTEM

If  SYMBIAN_EXTENDED_COMPOSITE_FILESYSTEM is defined, the Composite

File System allows more than one ROFS partition to be included in

the composite Z: drive.

This #define supports PREQ1085

*/

#define SYMBIAN_EXTENDED_COMPOSITE_FILESYSTEM

/**

@publishedPartner

__SECURE_BIN__

When __SECURE_BIN__ is defined, executable files stored as

"data" in the XIP ROM are assumed to be in their data-caged 

locations. The presence of this #define does not imply that 

data-caging is enforced, and does not imply that binaries have 

been relocated to sys\bin.

This #define supports PREQ537 "Platform security - file system layout".

*/

#define __SECURE_BIN__

/**

@publishedAll

SYMBIAN_COREAPPS_API_V2

If SYMBIAN_COREAPPS_API_V2 is defined then new functionality is available within 

the Core Apps sub-system (Contacts Model, Agenda Model and World Server) to 

support a platform secured OS.

*/

#define SYMBIAN_COREAPPS_API_V2

/**

@publishedPartner

SYMBIAN_APPARC_APPINFO_CACHE

If SYMBIAN_APPARC_APPINFO_CACHE is defined then apparc creates 

a file of application information on the first boot, which is 

used during subsequent boots for application information.

*/

#define SYMBIAN_APPARC_APPINFO_CACHE

/**

@publishedPartner

SYMBIAN_NETWORKING_IPSEC_IKE_V2

If SYMBIAN_NETWORKING_IPSEC_IKE_V2 is defined, IPSEC will 

be able to support Internet Key Exchange version 2 in 

addition to IKE v1. This involves a change in the size of 

the TPfkeyMsgBase class - see BR1736.1.

Actual support for IKE v2 will depend on the provision 

of a suitable plugin to the Key Management Daemon.

This #define supports PREQ1223.

*/

#define SYMBIAN_NETWORKING_IPSEC_IKE_V2

/**

@publishedPartner

SYMBIAN_UIKON_UNIFICATION

When SYMBIAN_UIKON_UNIFICATION is defined, the existing 

CEikSrvAppUiBase class is replaced with a customisable class

provided by the System GUI. 

This #define supports PREQ819 and PREQ826

*/

#define SYMBIAN_UIKON_UNIFICATION

/**

@publishedAll

__SECURITY_PLATSEC_ARCH__

If this macro is defined, then platform security aware security services 

APIs will be present.  This includes architectural changes to several 

components.

If this macro is not defined, the original version (since 8.0) of the 

security services APIs will be present. 

The following components are affected:

  cryptotokens

  certman

  filetokens

*/

#define __SECURITY_PLATSEC_ARCH__

/**

SYMBIAN_ECAM_CHUNKAPI

@publishedAll

@released

Specifies that an extended API will be used in the multimedia 

camera interface. This has a v2 observer which allows camera data 

to be returned without buffer copy, and also allows clients to set 

camera access priority

@see CCamera

@see MCameraObserver2

This #define supports PREQ799.

*/

#define SYMBIAN_ECAM_CHUNKAPI

/**

@publishedAll

SYMBIAN_SECURE_ECOM

When SYMBIAN_SECURE_ECOM is not defined, ECOM plugins are discovered by 

searching for DLLs in System\libs\plugins, and inferring the name of 

the resource file from the UID3 of the DLL.

When SYMBIAN_SECURE_ECOM is defined, ECOM plugins will also be discovered

by searching for resource files in \Resource\Plugins, and inferring the

name of the DLL from the name of the resource file. When platform security

is fully enforced, only this new style of discovery will work.

*/

#define SYMBIAN_SECURE_ECOM

/**

@publishedAll

SYMBIAN_INETPROTUTILS_RFC3986

Description:

If SYMBIAN_INETPROTUTILS_RFC3986 is defined, the Internet 

Protocol Utility Library supports RFC 3986, which increases 

the set of reserved characters.

@see EscapeUtils::IsExcludedChar

This #define implements BR2009.

*/

#define SYMBIAN_INETPROTUTILS_RFC3986

/**

@publishedPartner

SYMBIAN_FONT_METRICS_V2 

If this is defined, then classes which derive from COpenFont (usually 

these are part of a font rasterizer implementation) must set the 

protected member variables:

iFontAscentOfCapitals

iFontAscentIncAccents

iFontDescent

iFontLineGap

to appropriate values during the creation of a font. 

If this macro is not defined then these member variables do not exist.

@see COpenFont

*/

#define SYMBIAN_FONT_METRICS_V2

/**

@publishedAll

__OBEX_USER_DEFINED_HEADERS__

If __OBEX_USER_DEFINED_HEADERS__ is defined then the new API support for extended Headers will be available.

This new support includes USER DEFINED HEADERS and the COUNT header.

If this functionality is compiled out then the old API is available as before.

For more information on see documents shown below.

@see SGL.GT171.097 - Obex Header Extension how to

@see SGL.GT171.095 - Obex Extension Design Document

*/

#define __OBEX_USER_DEFINED_HEADERS__

/**

@publishedPartner

SYMBIAN_CENTREP_NOC

If SYMBIAN_CENTREP_NOC is defined, the Central Repository 

includes Notify-Only Client Optimization. This will cause 

repositories to be unloaded after a timeout even if the 

connection is still open.

This #define supports PREQ1228. 

*/

#define SYMBIAN_CENTREP_NOC

/**

@publishedPartner

@since 8.1

SYMBIAN_BLUETOOTH_REQUIRES_HCI_FLUSH_COMPLETE_EVENT 

If this is defined, the MHCIEventObserver class must implement

the FlushCompleteEvent virtual function, which will be used by 

the link manager to send Flush Complete events up to the stack. 

If this macro is not defined, Flush Complete events will be discarded.

@see MHCIEventObserver

@see CHCIFacade

*/

#define SYMBIAN_BLUETOOTH_REQUIRES_HCI_FLUSH_COMPLETE_EVENT

/**

@publishedAll

SYMBIAN_MULTIMEDIA_CODEC_API

If SYMBIAN_MULTIMEDIA_CODEC_API is defined then support is 

available for PREQ1024 delivered Processing Unit or 

OpenMAX based codecs and Multimedia hardware devices.

*/

#define SYMBIAN_MULTIMEDIA_CODEC_API

/**

@publishedAll

__MESSAGING_API_V2__

If __MESSAGING_API_V2__ is defined then new functionality 

is available within the Messaging sub-system to support a 

platform secured OS, e.g. the Attachment API.

*/

#define __MESSAGING_API_V2__

#define __HIDE_MESSAGING_API_V1__

#define __REMOVE_MESSAGING_API_V1__

/**

@publishedPartner

SYMBIAN_BOOKMARK_DATABASE

The Bookmark Database is an API used to provide system-wide 

storage and management functionality for URI bookmarks. 

If defined, this macro indicates that the Bookmark Database 

API is present in the platform.

*/

#define SYMBIAN_BOOKMARK_DATABASE

/**

@publishedPartner

SYMBIAN_NETWORKING_UMTSR5

If SYMBIAN_NETWORKING_UMTSR5 is defined support for the QoS 

and IMS parameters introduced by Release 5 of the 3GPP 

specification will be enabled. This involves a BC break in 

TContextConfig - see BR1582.1 for details.

@see TContextConfig

This #define supports PREQ192 and PREQ635.

*/

#define SYMBIAN_NETWORKING_UMTSR5

/**

@publishedPartner

SYMBIAN_NETWORKING_3GPPDEFAULTQOS

If SYMBIAN_NETWORKING_3GPPDEFAULTQOS is defined, support 

for QoS modification on the default PDP context will be 

enabled via the RSubconnection API.

This #define supports PREQ870.

*/

#define SYMBIAN_NETWORKING_3GPPDEFAULTQOS

/**

SYMBIAN_STAGED_SYSTEM_STARTUP

@publishedPartner

When SYMBIAN_STAGED_SYSTEM_STARTUP is defined, the staged 

start-up architecture has been introduced into the OS and 

'Start-up State Aware' components can make use of the 

architecture.

This #define supports PREQ 810.

*/

#define SYMBIAN_STAGED_SYSTEM_STARTUP

/**

@publishedAll

__HIDE_IPC_V1__

If __HIDE_IPC_V1__ is defined then the deprecated insecure IPC APIs will be removed from various Symbian OS header files. Classes affected include CSession, CServer, RMessage and RMessageptr.

For more information see the document listed below.

@see SMG.SM0005.004 - Platform Security Development for Zephyr

@see CSession

@see CServer

@see RMessage

@see RMessagePtr

*/

#define __HIDE_IPC_V1__

/**

@publishedPartner

SYMBIAN_NETWORKING_DHCPSERVER

If SYMBIAN_NETWORKING_DHCPSERVER is defined, Symbian OS includes a

simplified DHCPv4 server capable of dealing with single client.

This #define provides functionality to support PREQ749.

*/

#define SYMBIAN_NETWORKING_DHCPSERVER

/**  

@publishedAll 

SYMBIAN_REMOVE_TRIVIAL_ENCRYPTION

This macro removes the trivial encryption APIs that are exported by EUSER. 

See BR1320 for more details

*/

#define SYMBIAN_REMOVE_TRIVIAL_ENCRYPTION

/**

@internalTechnology

SYMBIAN_WAPPUSH_WHITELIST_BLACKLIST