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

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

// Symbian_OS.hrh

// Configuration options for Symbian OS

// This file is managed by the Master Codeline Forum

/** This include is for PREQ2621 */

#include "platform_paths.hrh"

// SYMBIAN_JAVA_NOT_INCLUDED

// For Sphinx and later versions, J2ME will no longer be included in the 

// build.  

// This #define supports PREQ1791

// 

//

/**

 @publishedPartner

 @released

*/

#define SYMBIAN_JAVA_NOT_INCLUDED

/**

@publishedPartner

@released

SYMBIAN_HCI_API_V2

If SYMBIAN_HCI_API_V2 is defined then the HCI APIs provided in PREQ750 

(Bluetooth HCI improvements) will be required for use by a version 2 

Bluetooth Stack and a version 2 HCI. These APIs are neither binary nor 

source compatible with the previous version 1 HCI APIs. Both the original 

version 1  Bluetooth stack and HCI, and the new version 2 Bluetooth stack 

and HCI will be built, but both rombuild and the emulator will be 

configured to use the version 2 binaries. The version 2 HCI will support 

all commands and events listed in Bluetooth v2.0 specification.

If SYMBIAN_HCI_API_V2 is not defined then only the version 1 Bluetooth 

stack and HCI will be built and used by rombuild and the emulator.

The version 1 HCI supports most but NOT all commands and events listed 

in Bluetooth v2.0 specification.

See BR1613 for more information.

*/

#define SYMBIAN_HCI_API_V2

/**

@publishedAll

@released

__WATCHER_API_V2__

If __WATCHER_API_V2__ is defined then the 

watcher framework supports ECOM watcher plugins.

*/

#define __WATCHER_API_V2__

/**

@publishedAll

@released

__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

@released

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

@released

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

@released

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

@released

__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

@released

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

@released

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

@released

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

@released

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

@released

__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

@released

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

@released

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

@released

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

@released

__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

@released

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

@released

@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

@released

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

@released

SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT 

Provides support control the presentation of subtitle and closed captioning text

from video playback controllers in the Multimedia Framework as part of @see CVideoPlayerUtility2.

Note that this support is dependent on the following being present in ROM: 

- GCE version of Graphics (migration component)

- GCE version of Videorender (optional component).

- The Subtitle plugin (optional component). 

This #define supports PREQ1939 

*/ 

#define SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT

/**

@publishedAll

@released

__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

@released

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

@released

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

@released

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

@released

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

@released

__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

@released

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 

@released

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

Description:

If SYMBIAN_WAPPUSH_WHITELIST_BLACKLIST is defined, the WAP Push

watcher compares the origin of Push messages against URIs in a

"White list" and "Black list".

This #define supports PREQ1505

*/

#define SYMBIAN_WAPPUSH_WHITELIST_BLACKLIST

/**

@publishedPartner

@released

SYMBIAN_FLEXIBLE_ALARM

When this macro is defined, Calendar Interim API, Alarm server and UIKON 

Alert Server will support additional functionality.

- Extra data can be attached to calendar alarm and allow UI app 

to retrieve the associated data.

- The Alarm server can send multiple expired alarms to Alert Server without 

waiting for the previous alarm acknowledged first

- A Resource file can be used to configure alarm play intervals and durations, 

or to disable alarm sound control.

This #define supports PREQ1118

*/

#define SYMBIAN_FLEXIBLE_ALARM

/**

@publishedPartner

@released

SYMBIAN_PKCS12

If SYMBIAN_PKCS12 is defined, the PKCS#12 Key Derivation 

Algorithm is supplied.