API_REF/Public_API: comparison epoc32/include/variant/symbian

equal deleted inserted replaced

-:e1b950c65cb4
+:837f303aceeb
 // 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
+// under the terms of "Eclipse Public License v1.0"
 // which accompanies this distribution, and is available
-// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+// 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 TB9.1 and later versions, J2ME will no longer be included in the
+// For Sphinx and later versions, J2ME will no longer be included in the
 // build.
-// This #define supports PREQ2545
+// This #define supports PREQ1791
 //
 //
-#include "platform_paths.hrh"
-#define SMPSAFE   /* SMPSAFE keyword removed */
 /**
 @publishedPartner
+@released
 */
 #define SYMBIAN_JAVA_NOT_INCLUDED
 /**
-@publishedAll
+@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__
 /**
 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.
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #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
 */
 #define SYMBIAN_SECURE_ECOM
 /**
 @publishedAll
+@released
 SYMBIAN_INETPROTUTILS_RFC3986
 Description:
 If SYMBIAN_INETPROTUTILS_RFC3986 is defined, the Internet
 */
 #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
 */
 #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.
 */
 #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
 */
 #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
 */
 #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
-@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
 #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.
 */
 #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
 */
 #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
 /**
 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.
 */
 #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.
 */
 #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.
 */
 #define SYMBIAN_NETWORKING_DHCPSERVER
 /**
 @publishedAll
+@released
 SYMBIAN_REMOVE_TRIVIAL_ENCRYPTION
 This macro removes the trivial encryption APIs that are exported by EUSER.
 */
 #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.
 */
 #define SYMBIAN_FLEXIBLE_ALARM
 /**
 @publishedPartner
+@released
 SYMBIAN_PKCS12
 If SYMBIAN_PKCS12 is defined, the PKCS#12 Key Derivation
 Algorithm is supplied.
 */
 #define SYMBIAN_PKCS12
 /**
 @publishedAll
+@released
 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
+@released
 __SECURE_BACKUP__
 If __SECURE_BACKUP__ is defined, the Secure Backup server replaces
 the use of SCRemFs for backup and restore, changing the backup protocol.
 */
 #define __SECURE_BACKUP__
 /**
 @publishedAll
+@released
 SYMBIAN_NETWORKING_REMOVE_RGENERIC
 If this macro is defined the deprecated APIs RGenericAgent,
 RNif, RNifMonitor and Nifman are removed. All of these APIs,
 */
 #define SYMBIAN_NETWORKING_RSUBCONNECTION
 /**
 @publishedAll
+@released
 SYMBIAN_HIDE_COREAPPS_API_V1
 If SYMBIAN_HIDE_COREAPPS_API_V1 is defined then the insecure CoreApps APIs
 will be removed from various Symbian OS header files. Components affected are
 #define SYMBIAN_HIDE_COREAPPS_API_V1
 #define SYMBIAN_REMOVE_COREAPPS_API_V1
 /**
 @publishedAll
+@released
 __UI_FRAMEWORKS_V2__
 If __UI_FRAMEWORKS_V2__ is defined then PlatSec aware UI Frameworks API's will be available.
 The following frameworks will be affected:
 */
 #define __BC_FUTURE_PROOFING__
 /**
 @publishedPartner
+@released
 SYMBIAN_TELEPHONY_USAT5
 If SYMBIAN_TELEPHONY_USAT5 is defined then support for 3GPP
 Release 5 (U)SAT will be enabled.
 /**
 SYMBIAN_GENERIC_SYSTEM_STARTUP
 @publishedPartner
+@released
 This #define enables the generic start-up architecture in
 which the System Starter process is responsible for the
 controlled startup of the system.
 */
 #define SYMBIAN_GENERIC_SYSTEM_STARTUP
 /**
 @publishedAll
+@released
 SYMBIAN_SECURE_PUBLISH_AND_SUBSCRIBE
 If this macro is defined, then the Bluetooth stack reconfigures to take
 advantage of security mechanisms in Publish and Subscribe. Any other
 */
 #define SYMBIAN_SECURE_PUBLISH_AND_SUBSCRIBE
 /**
 @publishedAll
+@released
 SYMBIAN_SECURITY_CAF_RFILE_HANDLE
 If SYMBIAN_SECURITY_CAF_RFILE_HANDLE is defined then it enables the Content Access
 Framework to read from files passed to it as an open RFile handles instead of CAF
 */
 #define SYMBIAN_SECURITY_CAF_RFILE_HANDLE
 /**
 @publishedAll
+@released
 __JAVACUSTOMINSTALL__
 If __JAVACUSTOMINSTALL__ is defined then an additional UI callback is made after MIDlet
 installation has succeeded or failed. This callback is intended for information only and the
 */
 #define __JAVACUSTOMINSTALL__
 /**
 @publishedAll
+@released
 SYMBIAN_MDF_API_V2
 This macro selects the Symbian OS 9.x phase of development in
 the Media Device Framework API, including changes to enable
 */
 #define SYMBIAN_MDF_API_V2
 /**
 @publishedPartner
+@released
 SYMBIAN_SMS_REL6_SUPPORT
 SMS Release 6 support is defined in the 3GPP specifications
 (3GPP TS 23.040 V6.5.0 and 3GPP TS 23.038 V6.1.0).
 */
 #define SYMBIAN_SMS_REL6_SUPPORT
 /**
 @publishedPartner
+@released
 SYMBIAN_SWI_POST_INSTALL_REVOCATION
 When SYMBIAN_SWI_POST_INSTALL_REVOCATION is defined,
 support for the SWI post install revocation service is enabled.
 */
 #define SYMBIAN_SWI_POST_INSTALL_REVOCATION
 /**
 @publishedPartner
+@released
 SYMBIAN_TELEPHONY_IMS
 If SYMBIAN_TELEPHONY_IMS is defined then IMS related APIs are included
 in Telephony components.
 */
 #define SYMBIAN_TELEPHONY_IMS
 /**
 @publishedPartner
+@released
 SYMBIAN_IGNORE_BIN_TARGETPATH
 When SYMBIAN_IGNORE_BIN_TARGETPATH is defined the TARGETPATH keyword in MMP files is ignored for executables.
 Executables for the emulator instead get built to the default location.
 */
 #define SYMBIAN_IGNORE_BIN_TARGETPATH
 /**
 @publishedAll
+@released
 SYMBIAN_COMMS_REPOSITORY
 Comms data is now stored in the Central Repository rather than the DBMS server.
 A new module, CommsDat.dll, replaces Commdb.dll as the interface for comms data stored on a device.
 */
 #define SYMBIAN_COMMS_REPOSITORY
 /**
 @publishedAll
+@released
 SYMBIAN_VARIABLE_BITRATE_CODEC
 If SYMBIAN_VARIABLE_BITRATE_CODEC is defined then
 CMMFSwCodecWrapper based audio hardware devices in the
 */
 #define SYMBIAN_VARIABLE_BITRATE_CODEC
 /**
 @publishedAll
+@released
 __SECURE_TELEPHONY__
 If __SECURE_TELEPHONY__ is defined, all Platform Security functionality
 within the Telephony subsystem will be enabled.
 */
 #define __SECURE_TELEPHONY__
 /**
 @publishedPartner
+@released
 SYMBIAN_CAF_V2
 The SYMBIAN_CAF_V2 flag indicates the CAF API v2 is present.
 CAF v2 supports files containing multiple content objects, which requires
 /**
 SYMBIAN_ROM_STATIC_PLUGIN_INFORMATION
 @publishedPartner
+@released
 This macro enables a consolidation phase in the ROM building
 process to generate additional metadata for each ROM drive.
 The metadata describes the content and structure of the ROM
 conveniently filtered for any component that requires it.
 */
 #define SYMBIAN_ROM_STATIC_PLUGIN_INFORMATION
 /**
 @publishedPartner
+@released
 SYMBIAN_BLUETOOTH_ESCO_ENABLED
 Enable support for Bluetooth eSCO synchronous links.
 Defining this macro extends the interface to CHCIBase to support
 */
 #define SYMBIAN_BLUETOOTH_ESCO_ENABLED
 /**
 @publishedPartner
+@released
 SYMBIAN_SECURE_MIDLET_INSTALL
 If SYMBIAN_SECURE_MIDLET_INSTALL is defined then the Java MIDlet
 Installer supports installation under Platform Security policies,
 */
 #define SYMBIAN_SECURE_MIDLET_INSTALL
 /**
 @publishedAll
+@released
 SYMBIAN_UI_FRAMEWORKS_CONTROL_API_V2
 If SYMBIAN_UI_FRAMEWORKS_CONTROL_API_V2 is defined then
 the following additional features will be available in CONE.
 */
 #define SYMBIAN_UI_FRAMEWORKS_CONTROL_API_V2
 /**
 @publishedAll
+@released
 SYMBIAN_CNTMODEL_V2
 If SYMBIAN_CNTMODEL_V2 is defined, clients of the
 Contacts Model can exploit the efficiency improvements
 */
 #define SYMBIAN_CNTMODEL_V2
 /**
 @publishedAll
+@released
 SYMBIAN_COREAPPS_PLUGIN_API_V2
 If SYMBIAN_COREAPPS_PLUGIN_API_V2 is defined then  Ecom solely is used as loading
 mechanism.The legacy plugin loading mechanism is used otherwise.
 #define DO_NOT_USE_THIS_MACRO
 #endif
 /**
 @publishedPartner
+@released
 SYMBIAN_C32ROOT_API_V2
 Strengthens the C32Root API and extends it to include
 configuration of queue length for bindings.
 */
 #define SYMBIAN_C32ROOT_API_V2
 /**
 @publishedAll
+@released
 __SECURE_API__
 Hides unsecure APIs. Many of these have been replaced by Secure variants
 but some are no longer available in a Secure platform.
 #define __SECURE_API__
 #define SYMBIAN_REMOVE_INSECURE_API
 /**
 @publishedAll
+@released
 __CNF_FORMAT_V2__
 If __CNF_FORMAT_V2__ is defined, assume that Epoccnf.pl generates
 files in version 2 of the CNF format, and that both versions 1
 */
 #define __CNF_FORMAT_V2__
 /**
 @publishedPartner
+@released
 SYMBIAN_SUPPORT_LINKED_FONTS
 If SYMBIAN_SUPPORT_LINKED_FONTS is defined then APIs are provided
 to create 'linked' font instances which combine glyph sets from
 */
 #define SYMBIAN_SUPPORT_LINKED_FONTS
 /**
 @publishedPartner
+@released
 SYMBIAN_SECURE_DBMS
 When SYMBIAN_SECURE_DBMS is defined, support for secure
 shared databases is enabled within DBMS.
 */
 #define SYMBIAN_SECURE_DBMS
 /**
 @publishedAll
+@released
 SYMBIAN_ASSUME_SECURE_DATA
 When this macro is defined, all data files are assumed to be in their secure
 locations, and all code which provided backward compatibility for the
 */
 #define __KEYSTORE_API_V2__
 /**
 @publishedAll
+@released
 __SECURE_DATA__
 When __SECURE_DATA__ is defined, public read-only files are
 assumed to be in their data-caged locations. The presence of
 */
 #define __SECURE_DATA__
 /**
 @publishedAll
+@released
 SYMBIAN_NETWORKING_PLATSEC
 If SYMBIAN_NETWORKING_PLATSEC is defined, additional platform security
 related functionality in enabled in the Comms-Infras and Networking
 */
 #define SYMBIAN_NETWORKING_PLATSEC
 /**
 @publishedAll
+@released
 __CONDITIONS_SCHEDULES_VALID__
 If __CONDITIONS_SCHEDULES_VALID__ is defined then the Task Scheduler component
 supports creating persistent schedules based on a set of conditions and a
 */
 #define __LEAVE_EQUALS_THROW__
 /**
 @publishedAll
+@released
 __BLUETOOTH_API_V2__
 If __BLUETOOTH_API_V2__ is defined assume that version 2 of the bluetooth
 subsystem will be built.  This is binary compatible with version 1 for all
 */
 #define __BLUETOOTH_API_V2__
 /**
 @publishedAll
+@released
 __BLUETOOTH_HCI_ALLOWS_AFH__
 If __BLUETOOTH_HCI_ALLOWS_AFH__ is defined the HCI interface will require the Adaptive Frequency Hopping CHCIBase pure virtual functions to be implemented in any derived class in Licensee produced host controller interface (HCI) code.
 If this is not defined no AFH commands may be sent to the host controller, and no AFH events will be received from the host controller.
 */
 #define __BLUETOOTH_HCI_ALLOWS_AFH__
 /**
 @publishedAll
+@released
 EKA2
 If EKA2 is defined, assume Kernel Architecture 2.
 If EKA2 is not defined, assume Kernel Architecture 1
 #define EKA2
 #endif
 /**
 @publishedPartner
+@released
 SYMBIAN_GRAPHICS_ALPHA_SUPPORT_V1
 When SYMBIAN_GRAPHICS_ALPHA_SUPPORT_V1 is defined a new EColor16MA
 display mode is available, having an alpha channel. The alpha support
 */
 #define SYMBIAN_GRAPHICS_ALPHA_SUPPORT_V1
 /**
 @publishedPartner
+@released
 __SECURE_SOFTWARE_INSTALL__
 When __SECURE_SOFTWARE_INSTALL__ is defined, the Software
 Install APIs are replaced with versions appropriate to
 */
 #define __SECURE_SOFTWARE_INSTALL__
 /**
 @publishedPartner
+@released
 SYMBIAN_ESOCK_V3
 If SYMBIAN_ESOCK_V3 is defined, the socket server allows protocol
 families to run in individual threads to protect one protocol family
 */
 #define SYMBIAN_ESOCK_V3
 /**
 @publishedAll
+@released
 SYMBIAN_CURB_SYSTEMSERVER_PRIORITIES
 If SYMBIAN_CURB_SYSTEMSERVER_PRIORITIES is defined, threads at
 priority SystemServer/More (i.e. process priorities EPriorityFileServer,
 SYMBIAN_CRYPTO
 */
 #define SYMBIAN_CRYPTO
+/**
-/**
+@internalAll
-@publishedPartner
+SYMBIAN_J2ME_USE_CALENDAR
-SYMBIAN_GRAPHICS_BUILD_WSERV2
+Internal macro - do not use outside Symbian code.
+*/
-If SYMBIAN_GRAPHICS_BUILD_WSERV2 is defined WServ2 binaries are built and can be used instead of WSERV1 versions
+#define SYMBIAN_J2ME_USE_CALENDAR
-*/
-#define SYMBIAN_GRAPHICS_BUILD_WSERV2
+/**
-/**
+@publishedPartner
-@publishedPartner
+@released
-SYMBIAN_HCI_API_V2
+SYMBIAN_CENREPNOTIFIERHANDLER
-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_CENREPNOTIFIERHANDLER is defined, the Central
+Repository notifier handler is present.
-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 CCenRepNotifyHandler
+@see MCenRepNotifyHandlerCallback
-See BR1613 for more information.
-*/
+This #define supports PREQ1802.
-#define SYMBIAN_HCI_API_V2
+*/
+#define SYMBIAN_CENREPNOTIFIERHANDLER
 /**
 @publishedAll
 @released
 SYMBIAN_BAFL_SYSUTIL
 If SYMBIAN_BAFL_SYSUTIL is defined, the bafl sysutil.dll is present,
 providing APIs for obtaining system version information and
 APIs for monitoring free disk space.
 @see SysUtil::GetSWVersion
 @see SysUtil::DiskSpaceBelowCriticalLevelL
 This #define supports PREQ1802.
 */
 #define SYMBIAN_BAFL_SYSUTIL
 /**
 @publishedPartner
 @released
 @see CUserActivityManager::Start
 This #define supports PREQ1802.
 */
 #define SYMBIAN_BAFL_ACTIVITYMGR
-/**
-@publishedPartner
+/**
+@publishedPartner
-SYMBIAN_CENREPNOTIFIERHANDLER
+@released
-If SYMBIAN_CENREPNOTIFIERHANDLER is defined, the Central
+SYMBIAN_CLIENTPROV_V2
-Repository notifier handler is present.
+If SYMBIAN_CLIENTPROV_V2 is defined then the client provisioning
-@see CCenRepNotifyHandler
+documents will be pushed to Inbox by default, and a new API is
-@see MCenRepNotifyHandlerCallback
+added to submit the documents from Inbox back to CPAgent.
-This #define supports PREQ1802.
+@see RCpMsvDocInputSession
-*/
-#define SYMBIAN_CENREPNOTIFIERHANDLER
+This is a source and binary compatibility break: see BR2092.
+This #define supports PREQ1664
+*/
+#define SYMBIAN_CLIENTPROV_V2
+/**
+@publishedPartner
+@released
+SYMBIAN_CRYPTOSPI
+The SYMBIAN_CRYPTOSPI flag indicates that the Crypto SPI is present.
+Crypto SPI (Service Provider Interface) supports licensee-pluggable
+cryptographic algorithms (e.g. for enabling hardware acceleration),
+and also allows for future extensibility of the cryptography
+interfaces (e.g. for supporting future hashes and ciphers and
+to support non-extractable private keys).
+This #define supports PREQ57.
+*/
+#define SYMBIAN_CRYPTOSPI
 /**
 @publishedPartner
+@released
 SYMBIAN_C32_SERCOMMS_V2
 Description:
 If SYMBIAN_C32_SERCOMMS_V2 is defined, the Comms Server allows grouped CSYs
 This #define supports PREQ890
 */
 #define SYMBIAN_C32_SERCOMMS_V2
-/**
-@internalAll
+/**
+@publishedPartner
-SYMBIAN_J2ME_USE_CALENDAR
+@released
-Internal macro - do not use outside Symbian code.
+SYMBIAN_DEVMAN_BEARER_CONFIGURABLE
-*/
-#define SYMBIAN_J2ME_USE_CALENDAR
+If SYMBIAN_DEVMAN_BEARER_CONFIGURABLE is defined then the
+device management support for network bearers can configured
+using the resource file 'dmnapddf.rss'
+This #define supports CR1011
+*/
+#define SYMBIAN_DEVMAN_BEARER_CONFIGURABLE
+/**
+@publishedPartner
+@released
+SYMBIAN_NETWORKING_DHCP_MSG_HEADERS
+If SYMBIAN_NETWORKING_DHCP_MSG_HEADERS is defined, the
+Symbian OS DHCPv4 daemon supports retrieval of
+DHCP message header fields and also 'Parameter Request List'
+in the DHCP request message to the remote DHCP server is
+configurable.
+This #define supports PREQ1647 and PREQ1648
+*/
+#define SYMBIAN_NETWORKING_DHCP_MSG_HEADERS
+/**
+@publishedAll
+@released
+SYMBIAN_DRM_3RD_PARTY_PLAYBACK
+If SYMBIAN_DRM_3RD_PARTY_PLAYBACK is defined, the Multimedia Framework
+supports the playback of DRM-protected content by processes which do not
+have the DRM capability.
+@see RMMFController
+This #define supports CR1058.
+*/
+#define SYMBIAN_DRM_3RD_PARTY_PLAYBACK
+/**
+@publishedAll
+@released
+SYMBIAN_USE_MMF_RUF_RECOGNIZER
+If SYMBIAN_USE_MMF_RUF_RECOGNIZER is defined, the MMF recognizer is able to
+recognize formats such as MPEG4, MPEG2, AAC and Divx.
+*/
+#define SYMBIAN_USE_MMF_RUF_RECOGNIZER
 /**
 @publishedPartner
+@released
+SYMBIAN_ENABLE_1630_JPEG_EXTENSIONS
+If SYMBIAN_ENABLE_1630_JPEG_EXTENSIONS is defined, the Symbian JPEG
+codec implements the PREQ1630 ICL API extensions.
+@see CImageDecoder::SetClippingRectL
+@see CImageDecoder::GetDestinationSize
+@see CImageDecoder::PrepareL
+@see CImageDecoder::OperationL
+@see CImageDecoder::ScalerL
+@see CImageDecoder::BlockStreamerL
+@see CImageEncoder::PrepareL
+@see CImageEncoder::OperationL
+@see CImageEncoder::BlockStreamerL
+This #define supports PREQ1630.
+*/
+#define SYMBIAN_ENABLE_1630_JPEG_EXTENSIONS
+/**
+@publishedPartner
+@released
+SYMBIAN_LFFS_SIBLEY_NORFLASH
+If SYMBIAN_LFFS_SIBLEY_NORFLASH is defined support for LFFS on
+Intel Sibley NOR flash is enabled.
+This #define supports PREQ912 and involves a BC break in the
+parameter list for DMediaDriverFlash::Caps() - see BR1680 for details.
+*/
+#define SYMBIAN_LFFS_SIBLEY_NORFLASH
+/**
+@publishedPartner
+@released
 SYMBIAN_LOCATION_PRIVACY_V2
 If SYMBIAN_LOCATION_PRIVACY_V2 is defined, the Symbian LBS sub-system
 includes support for the advanced privacy dialogs and standalone
 This #define supports PREQ1660.
 */
 #define SYMBIAN_LOCATION_PRIVACY_V2
 /**
 @publishedPartner
+@released
 SYMBIAN_MDF_SHAREDCHUNK_SOUNDDRIVER
 If SYMBIAN_MDF_SHAREDCHUNK_SOUNDDRIVER is defined, the Media Device
 Framework (MDF) will use the RSoundSc sound driver interface.
 If this macro is not defined, MDF will use the older RMdaDevSound interface.
 BR2079 gives further details of the migration needed by customers who
 @see RMdaDevSound
 @see RSoundSc
 */
 #define SYMBIAN_MDF_SHAREDCHUNK_SOUNDDRIVER
-/**
-@publishedPartnerProto
+/**
+@publishedPartner
+@released
+SYMBIAN_MESSAGESTORE_USING_SQLDB
+If SYMBIAN_MESSAGESTORE_USING_SQLDB is defined then messaging server
+uses the SQLite database to store message index data.
+*/
+#define SYMBIAN_MESSAGESTORE_USING_SQLDB
+/**
+@publishedAll
+@released
+SYMBIAN_WSERV_AND_CONE_MULTIPLE_SCREENS
+If SYMBIAN_WSERV_AND_CONE_MULTIPLE_SCREENS is defined, new
+APIs are provided in cone.lib and ws32.lib which allow
+applications to draw to multiple displays simultaneously and
+react to a change of the active display.
+This #define supports PREQ1227
+@see CCoeEnv::ScreenDevice
+@see CScreenItem
+*/
+#define SYMBIAN_WSERV_AND_CONE_MULTIPLE_SCREENS
+/**
+@publishedPartner
+@released
+SYMBIAN_POWER_RESOURCE_MANAGER_API
+If SYMBIAN_POWER_RESOURCE_MANAGER_API is defined, the Power Resource
+Manager is available.
+@see PowerResourceManager
+@see DPowerResourceController
+This #define supports PREQ1398.
+*/
+#define SYMBIAN_POWER_RESOURCE_MANAGER_API
+/**
+@publishedAll
+@released
+SYMBIAN_PROCESS_MONITORING_AND_STARTUP
+If defined, the System Startup architecture supports dynamic startup
+for after market applications, and provides the SysMon process to
+monitor critical system processes.
+@see DscStore::Connect
+@see ERestartOS
+This define supports PREQ871 and PREQ1089.
+*/
+#define SYMBIAN_PROCESS_MONITORING_AND_STARTUP
+/**
+@publishedAll
+@released
+SYMBIAN_TUNER_RDS_ANNOUNCEMENT
+If SYMBIAN_TUNER_RDS_ANNOUNCEMENT is defined, the RDS Tuner API
+is provided, allowing applications to be notified if the radio
+is retuned to another station in order to listen to an announcement.
+@see MMMRdsTunerUtilityImpl
+@see MMMRdsAnnouncementObserver2
+@see CMMRdsTunerUtility
+This #define supports CR1097.
+*/
+#define SYMBIAN_TUNER_RDS_ANNOUNCEMENT
+/**
+@publishedAll
+@released
+SYMBIAN_USER_PROMPT_SERVICE
+If SYMBIAN_USER_PROMPT_SERVICE is defined, the User Prompt
+Service is available, allowing system servers to prompt the
+user to make a security decision about a request from a client
+application, e.g. "Allow application X to send an SMS message?"
+@see RupSubsession::Authorise
+This #define is associated with PREQ1262.
+*/
+#define SYMBIAN_USER_PROMPT_SERVICE
+/**
+@publishedPartner
+@released
+SYMBIAN_MULTIMEDIA_MUF
+If SYMBIAN_MULTIMEDIA_MUF is defined, then the PREQ1823 Multimedia
+Metadata Utility Framework is delivered in to the OS.
+@see CMetaDataClientUtility
+@see CMUFParserType
+@see MMUFObserver
+@see CMetaDataFieldsArray
+@see CMetaDataFieldItem
+@see CMetaDataParser
+This #define supports PREQ1823.
+*/
+#define SYMBIAN_MULTIMEDIA_MUF
+/**
+@publishedAll
+@released
+SYMBIAN_MBUFMANAGER_V2
+SYMBIAN_MBUFMANAGER_V2 make several changes in
+the CMBufManager including multiple sized RMBuf's.
+This #define supports REQ7857, REQ7860, REQ7864, REQ8585, REQ8586
+developed as part of PREQ1248.
+These changes introduces a BR-2242.
+*/
+#define	SYMBIAN_MBUFMANAGER_V2
+/**
+@publishedPartner
+@released
+SYMBIAN_FEATURE_MANAGER
+If SYMBIAN_FEATURE_MANAGER is defined then the Feature Registry
+functionality is implemented via the Feature Manager, with
+corresponding changes in the ROM building tools.
+This #define supports PREQ1645
+*/
+#define SYMBIAN_FEATURE_MANAGER
+/**
+@publishedAll
+@released
+SYMBIAN_BUILD_GCE
+If SYMBIAN_BUILD_GCE is defined, the Surface Manager and Graphics
+Composition Engine APIs are available at build time.
+@see RWindowBase::SetBackgroundSurface
+@see RSurfaceManager
+@see RSurfaceUpdateSession
+Note that the Surface Manager and GCE executables are optional,
+and will not be present in the ROM or the emulator unless
+appropriately configured.
+This #define supports PREQ1007 and PREQ1019
+*/
+#define SYMBIAN_BUILD_GCE
+/**
+@publishedAll
+@released
+SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY
+If SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY is defined
+then the comms-infras framework supports the management plane
+with the RCommsManager API providing support for connection
+selection, bearer mobility and other functionality.
+This #define supports PREQ 1060 and PREQ 399.
+*/
+#define SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY
+/**
+@publishedPartner
+@released
+SYMBIAN_CAF_STREAMING
+If SYMBIAN_CAF_STREAMING is defined then CAF provides support for
+streamed broadcast protection standards, such as DVB-H or OMA DRM BCAST.
+This #define supports PREQ782
+*/
+#define SYMBIAN_CAF_STREAMING
+/**
+@publishedPartner
+@released
+SYMBIAN_ENABLE_USB_OTG_HOST
+If SYMBIAN_ENABLE_USB_OTG_HOST is defined, executables related
+to USB Host and USB OTG will be built in addition to the
+existing support for USB Client.
+These additional components are necessary to enable building a
+ROM incorporating USB Client, Host and OTG functionality.
+This #define supports PREQ1782
+*/
+#define SYMBIAN_ENABLE_USB_OTG_HOST
+/**
+@publishedPartner
+@released
 SYMBIAN_MULTIMEDIA_A3FDEVSOUND
 If SYMBIAN_MULTIMEDIA_A3FDEVSOUND is defined, the PREQ1540 DevSound API is
 present in the Advanced Audio Adaptation Framework
 This #define supports PREQ1540.
 */
 #define SYMBIAN_MULTIMEDIA_A3FDEVSOUND
+/**
+@publishedAll
+@released
+SYMBIAN_OS_EXCLUDE_DMCPDS
+When this macro is enabled, OMA dataSync, Device Management and Client Provisioning protocol
+implementations will be excluded.
+This #define supports PREQ2474.
+*/
+#define SYMBIAN_OS_EXCLUDE_DMCPDS
+/**
+@publishedPartner
+@released
+SYMBIAN_USB_RNDIS
+If SYMBIAN_USB_RNDIS is defined, SYMBIAN OS will provide USB Remote NDIS class (this affects Bluetooth PAN as well).
+This #define supports PREQ1872.
+*/
+#define SYMBIAN_USB_RNDIS
+/**
+@internalAll
+@released
+SYMBIAN_ALARM_REPEAT_EXTENSIONS
+If SYMBIAN_ALARM_REPEAT_EXTENSIONS is defined then the client APIs delivered by PREQ2069 will be avilable.
+These APIs introduce an additional alarm repeat definition and a new alarm expiry behaviour.
+#define supports PREQ2069.
+*/
+#define SYMBIAN_ALARM_REPEAT_EXTENSIONS
+/**
+@publishedPartner
+SYMBIAN_BAFL_MULTIPARTPARSER
+If SYMBIAN_BAFL_MULTIPARTPARSER is defined then the BAFL
+component provides the MultipartParser.dll functionality.
+This #define supports PREQ2051.
+*/
+#define SYMBIAN_BAFL_MULTIPARTPARSER
+/**
+@internalAll
+@released
+SYMBIAN_CENTREP_SUPPORT_MULTIROFS
+If SYMBIAN_CENTREP_SUPPORT_MULTIROFS is defined, centralrepository client
+will be able to define keyspaces that are composed of multiple files in different ROFS layers.
+This #define supports PREQ2112
+*/
+#define SYMBIAN_CENTREP_SUPPORT_MULTIROFS
+/**
+@publishedPartner
+@released
+SYMBIAN_DNS_PROXY
+If SYMBIAN_DNS_PROXY is defined, SYMBIAN OS will provide DNS Proxy Service.
+This define supports PREQ1684.
+*/
+#define SYMBIAN_DNS_PROXY
+/**
+@publishedPartner
+@released
+SYMBIAN_DNS_PUNYCODE
+If SYMBIAN_DNS_PUNYCODE is defined, this will enable punycode conversion
+functionality in the system. If SYMBIAN_DNS_PUNYCODE is enabled, then the DND
+can resolve the International Domain Names also. As per the requirement, application
+can use this punycode conversion.
+This define supports PREQ2296.
+*/
+#define SYMBIAN_DNS_PUNYCODE
+/**
+@publishedAll
+SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API
+Enables the File Server Client side API for large file access (file size greater than 2GB - 1).
+Enables the configurable part of File Server side to support large files.
+This #define supports PREQ1725
+*/
+#define SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API
+/**
+@publishedPartner
+@released
+SYMBIAN_ENABLE_FAT_DIRECTORY_OPT
+If SYMBIAN_ENABLE_FAT_DIRECTORY_OPT is defined, a size-configurable
+Leaf Directory Name Caching and optimisations to file creation operations
+is enabled to improve performance of locating leaf directories and
+file creation on FAT volumes.
+This #define supports PREQ1885.
+*/
+#define SYMBIAN_ENABLE_FAT_DIRECTORY_OPT
+/**
+@publishedAll
+@released
+SYMBIAN_EUSERHL
+EUserHl generic usability library
+This #define supports PREQ2177
+*/
+#define SYMBIAN_EUSERHL
+/**
+@publishedPartner
+SYMBIAN_LOCATION_BTGPSCONFIG
+Allows applications that use the LBS subsystem to automatically utilize the best Bluetooth GPS positioning source
+available (rather than be manually configured to a particular Bluetooth GPS device)
+*/
+#define SYMBIAN_LOCATION_BTGPSCONFIG
+/**
+@publishedAll
+@released
+SYMBIAN_MESSAGESTORE_ENHANCED_SEARCH
+If SYMBIAN_MESSAGESTORE_ENHANCED_SEARCH is defined then the client
+side of  messaging server provides enhanced search capabilities.
+*/
+#define SYMBIAN_MESSAGESTORE_ENHANCED_SEARCH
+/**
+@publishedPartner
+@released
+SYMBIAN_NETWORKING_ADDRESS_PROVISION
+If SYMBIAN_NETWORKING_ADDRESS_PROVISION is defined, this will enable
+the DHCP server to provide IP address to the client based on its
+hardware address, this hardware address is provisioned by the
+application which is loading the DHCP server. Also NAPT will
+forward any packets to the uplink only if the source address is
+provisioned.
+This define supports PREQ1872.
+*/
+#define SYMBIAN_NETWORKING_ADDRESS_PROVISION
+/**
+@internalComponent
+SYMBIAN_OE_LIBRT
+If SYMBIAN_OE_LIBRT is defined, the open environment component will be extended to include the
+Symbian OS port of the latest version of librt ("realtime") open source library.
+This #define supports PREQ1974
+*/
+#define SYMBIAN_OE_LIBRT
+/**
+@internalComponent
+SYMBIAN_OE_POSIX_SIGNALS
+If SYMBIAN_OE_POSIX_SIGNALS is enabled, the libc component will use POSIX signals emulation.
+This #define supports PREQ1579
+*/
+#define SYMBIAN_OE_POSIX_SIGNALS
+/**
+@publishedPartner
+SYMBIAN_SDP_IPSEC_VOIP_SUPPORT
+If SYMBIAN_SDP_IPSEC_VOIP_SUPPORT is defined, then PREQ1853 APIs enable use of the cipher based MAC evaluation
+and psuedo random generation algorithms (AES-XCBC-MAC-96 and AES-XCBC-PRF-128 respectively) through a new MAC
+interface introduced in the CryptoSpi framework.
+Tbis #define supports PREQ1853
+*/
+#define SYMBIAN_SDP_IPSEC_VOIP_SUPPORT
+/**
+@internalAll
+@released
+SYMBIAN_SKIPPED_CALENDAR_ALARMS
+If SYMBIAN_SKIPPED_CALENDAR_ALARMS is present then the alarm server shall
+persist details of missed calendar alarms and clients shall be able to
+retrieve the list of missed calendar alarms from the Alarm server client API.
+This supports PREQ2088.
+*/
+#define SYMBIAN_SKIPPED_CALENDAR_ALARMS
+/**
+@internalTechnology
+SYMBIAN_SSM_FLEXIBLE_MERGE
+When SYMBIAN_SSM_FLEXIBLE_MERGE is enabled then flexible merging
+of startup command lists based on priority is supported.
+This define supports PREQ1871.
+*/
+#define SYMBIAN_SSM_FLEXIBLE_MERGE
+/**
+@internalAll
+SYMBIAN_SSM_GRACEFUL_SHUTDOWN
+If SYMBIAN_SSM_GRACEFUL_SHUTDOWN is defined, this will enable
+Staged Shutdown of the device,	which allows definition of
+a policy to specify the order for notifying registered
+components of shutdown, allowing them to perform any necessary
+tasks before the device completes its shutdown.
+This define supports PREQ2326.
+*/
+#define SYMBIAN_SSM_GRACEFUL_SHUTDOWN
+/**
+@publishedPartner
+@released
+SYMBIAN_STRICT_EXPLICIT_SOCKET_BINDING
+If SYMBIAN_STRICT_EXPLICIT_SOCKET_BINDING is defined then
+the TCP/IP stack shall support explictly bound sockets.
+If a socket is explicitly bound and a packet arrives on an interface
+that the socket isn't bound to, then the packet should be dropped.
+This define supports PREQ2279.
+*/
+#define SYMBIAN_STRICT_EXPLICIT_SOCKET_BINDING
+/**
+@publishedAll
+SYMBIAN_SWI_RUN_ON_INSTALL_COMPLETE
+This new Macro will enable the support for new run option for SIS files . When executables/files inside
+SIS file marked with this new run option, they will be executed at the end of the successful installation.
+This #define supports PREQ2264, CR1544
+*/
+#define SYMBIAN_SWI_RUN_ON_INSTALL_COMPLETE
+/**
+@publishedPartner
+@released
+SYMBIAN_SYSTEM_STATE_MANAGEMENT
+If SYMBIAN_SYSTEM_STATE_MANAGEMENT is defined, this will enable
+the System State Management Architecture, which supports the
+concept of system states (including startup, normal operation,
+shutdown, and failure) and associated behaviour, and facilitates
+the transitioning between them according to licensee-defined
+policies and procedures.
+This define supports PREQ1871.
+*/
+#define SYMBIAN_SYSTEM_STATE_MANAGEMENT
+/**
+@internalAll
+SYMBIAN_WRITABLE_DATA_PAGING
+This System Wide Define will be used to issue a warning when a rom is built that enables data paging on a
+version of the OS for which data paging is not warranted.
+This #define supports PREQ1954
+*/
+#define SYMBIAN_WRITABLE_DATA_PAGING
+/**
+@publishedPartner
+@released
+SYMBIAN_ZERO_COPY_NETWORKING
+If SYMBIAN_ZERO_COPY_NETWORKING is defined the Comms Stack switches from using single memory pool overseen
+by MBufManager to multiple, HW specific pools. With SYMBIAN_ZERO_COPY_NETWORKING defined link-level flows
+can avoid copying data when communicating with the respective HW drivers.
+This #define supports PREQ2106.
+*/
+#define SYMBIAN_ZERO_COPY_NETWORKING
+/**
+@publishedPartner
+@released
+SYMBIAN_ENABLE_SPLIT_HEADERS
+When this is not defined, header files, that have been split, #include the extra header files to disable the source break. When this is defined, the headers have been fully split and the source break is enabled.
+This #define supports PREQ2740 and other splitting "mixed" header file PREQs.
+*/
+#define SYMBIAN_ENABLE_SPLIT_HEADERS
+/**
+@publishedAll
+@released
+SYMBIAN_OE_LIBSTDCPP
+If SYMBIAN_OE_LIBSTDCPP is defined, the open environment component will be extended to include the standard new and delete operators, and STDxxx targets will be linked against stdnew.lib for ARM builds, while other targets will be linked against scppnwdl.lib for Emulator builds.
+This #define supports PREQ1184
+*/
+#define SYMBIAN_OE_LIBSTDCPP
+/**
+@publishedPartner
+@released
+SYMBIAN_E32_ATOMIC_API
+If SYMBIAN_E32_ATOMIC_API is defined the header file e32atomics.h is available
+and should be used in preference to hand-coding ARM atomic instructions.
+*/
+#define SYMBIAN_E32_ATOMIC_API
+/**
+SYMBIAN_GRAPHICS_BUILD_OPENWF_WSERV
+If SYMBIAN_GRAPHICS_BUILD_OPENWF_WSERV, the windowserver component is built to use the OpenWF version of NGA.
+*/
+#define SYMBIAN_GRAPHICS_BUILD_OPENWF_WSERV

branch	Symbian3
changeset 4	837f303aceeb
parent 2	2fe1408b6811