// 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.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

// SYMBIAN_JAVA_NOT_INCLUDED

// For TB9.1 and later versions, J2ME will no longer be included in the 

// build.  

// This #define supports PREQ2545

// 

//

#include "platform_paths.hrh"

#define SMPSAFE   /* SMPSAFE keyword removed */

/**

 @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

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

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

SYMBIAN_PKCS12

If SYMBIAN_PKCS12 is defined, the PKCS#12 Key Derivation 

Algorithm is supplied.

This #define supports PREQ1054. 

*/

#define SYMBIAN_PKCS12

/**

@publishedAll

SYMBIAN_MMF_AUTOPAUSE_RESUME

This #define enables extra features in the MMF APIs for auto pause 

and resume of audio streams.

*/

#define SYMBIAN_MMF_AUTOPAUSE_RESUME

/**

@publishedAll

__SECURE_BACKUP__

If __SECURE_BACKUP__ is defined, the Secure Backup server replaces

the use of SCRemFs for backup and restore, changing the backup protocol.

Applications which have private data need to provide additional backup 

registration files, and may use Publish & Subscribe to receive 

notification of backup requests.

This #define supports PREQ716 - Provide support for secure backup and 

restore for licensee PC Connectivity software 

*/

#define __SECURE_BACKUP__

/** 

@publishedAll

SYMBIAN_NETWORKING_REMOVE_RGENERIC

If this macro is defined the deprecated APIs RGenericAgent, 

RNif, RNifMonitor and Nifman are removed. All of these APIs,