CCmManagerImpl Class Reference
class CCmManagerImpl : public CBase |
Implementation of connection method manager
cmmanager.lib
- Since
- S60 v3.2
Public Member Functions |
---|
| ~CCmManagerImpl() |
void | AddResourceFileL(TFileName &) |
IMPORT_C void | AllDestinationsL(RArray< TUint32 > &) |
CommsDat::CMDBRecordSet< CommsDat::CCDIAPRecord > * | AllIapsL() |
CommsDat::CMDBRecordSet< CCDDataMobilitySelectionPolicyRecord > * | AllSNAPRecordsL(TUint32) |
HBufC * | AllocReadL(TInt) |
void | AppendCmListFromUidsL(RArray< TUint32 > &, RPointerArray< CCmPluginBase > &) |
void | AppendCmListL(TUint32, RPointerArray< CCmPluginBase > &) |
void | AppendCmListLC(TUint32, RPointerArray< CCmPluginBase > &) |
void | AppendUncatCmListL(RPointerArray< CCmPluginBase > &, TBool, TBool, TBool, TBool) |
void | AppendUncatCmListLC(RPointerArray< CCmPluginBase > &, TBool, TBool, TBool, TBool) |
void | BearerPriorityArrayL(RArray< TBearerPriority > &) |
TUint32
| BearerTypeFromCmIdL(TUint32) |
TUint32
| BearerTypeFromIapRecordL(CommsDat::CCDIAPRecord *) |
CommsDat::TMDBElementId
| BearerTypePriorizationTableId() |
void | CleanupGlobalPriorityArray(RArray< TBearerPriority > &) |
void | CleanupResetAndDestroyPushL(TArrayToCleanup &) |
void | CommitTransactionL(TInt) |
void | ConnMethodUpdatedL(CCmPluginBaseEng *) |
IMPORT_C CCmPluginBaseEng * | ConnectionMethodL(TUint32) |
IMPORT_C void | ConnectionMethodL(RArray< TUint32 > &, TBool, TBool, TBool, TBool) |
TInt
| CopyConnectionMethodL(CCmDestinationImpl &, CCmPluginBase &) |
CCmPluginBase * | CreateConnectionMethodL(TUint32, CCmDestinationImpl *) |
CCmPluginBase * | CreateConnectionMethodL(TUint32, TUint32, CCmDestinationImpl *) |
CCmPluginBase * | CreateConnectionMethodL(CCmPluginBaseEng *) |
CCmDestinationImpl * | CreateDestinationL(const TDesC &) |
CCmDestinationImpl * | CreateDestinationL(const TDesC &, TUint32) |
IMPORT_C void | CreateFlatCMListL(TUint32, RPointerArray< CCmPluginBase > &) |
IMPORT_C void | CreateFlatCMListLC(TUint32, RPointerArray< CCmPluginBase > &) |
CCDSnapRecord * | CreateSNAPRecordL(TUint32) |
TUint
| DestinationCountL() |
IMPORT_C CCmDestinationImpl * | DestinationL(TUint32) |
IMPORT_C TBool | DestinationStillExistedL(CCmDestinationImpl *) |
CommsDat::TMDBElementId
| DestinationTableId() |
void | DestinationUpdated(CCmDestinationImpl *) |
CCmPluginBaseEng * | DoCreateConnectionMethodL(TUint32, TCmPluginInitParam &) |
CCmPluginBaseEng * | DoCreateConnectionMethodL(TUint32, TCmPluginInitParam &, TUint32) |
IMPORT_C TUint32 | EasyWlanIdL() |
TBool
| FeatureSupported(TInt) |
IMPORT_C void | FilterOutVirtualsL(RPointerArray< CCmPluginBase > &) |
IMPORT_C TBool | GetBearerInfoBoolL(TUint32, TUint32) |
IMPORT_C TUint32 | GetBearerInfoIntL(TUint32, TUint32) |
IMPORT_C HBufC8 * | GetBearerInfoString8L(TUint32, TUint32) |
IMPORT_C HBufC * | GetBearerInfoStringL(TUint32, TUint32) |
IMPORT_C TBool | GetConnectionMethodInfoBoolL(TUint32, TUint32) |
IMPORT_C TUint32 | GetConnectionMethodInfoIntL(TUint32, TUint32) |
IMPORT_C HBufC8 * | GetConnectionMethodInfoString8L(TUint32, TUint32) |
IMPORT_C HBufC * | GetConnectionMethodInfoStringL(TUint32, TUint32) |
IMPORT_C CCmPluginBase * | GetConnectionMethodL(TUint32) |
TUint32
| GetInternetDestinationIdL() |
TInt
| GlobalBearerPriority(TBool, const TDesC &) |
void | HandleDefConnDeletedL(TCmDefConnValue &) |
void | HasCapabilityL(TCapability) |
TBool
| HasUnprotectedDestinationsL() |
IMPORT_C TBool | IapStillExistedL(const CCmPluginBaseEng &) |
CommsDat::TMDBElementId
| IconTableId() |
void | InsertConnectionMethodL(CCmPluginBaseEng *) |
TBool
| IsDefConnSupported() |
TBool
| IsHelpOn() |
TBool
| IsIapLinkedL(const CCmPluginBaseEng &) |
IMPORT_C TBool | IsIapStillInDestL(CCmDestinationImpl *, const CCmPluginBaseEng &) |
TBool
| IsMemoryLow() |
TInt
| MoveConnectionMethodL(CCmDestinationImpl &, CCmDestinationImpl &, CCmPluginBase &) |
CCmManagerImpl * | NewL(TBool) |
TUint32
| NumOfConnMethodReferencesL(TUint32, CommsDat::CMDBRecordSet< CCDDataMobilitySelectionPolicyRecord > *) |
void | OpenTransactionLC(TBool) |
void | ReadDefConnL(TCmDefConnValue &) |
void | ReadDefConnWoTransL(TCmDefConnValue &) |
void | ReadGenConnSettingsL(TCmGenConnSettings &) |
void | RemoveAllReferencesL(const CCmPluginBaseEng &) |
void | RemoveAllReferencesWoTransL(const CCmPluginBaseEng &) |
void | RemoveCMFromPoolL(CCmPluginBaseEng *) |
void | RemoveCMFromPoolL(CCmPluginBase *) |
void | RemoveConnectionMethodL(CCmDestinationImpl &, CCmPluginBase &) |
IMPORT_C void | RemoveDestFromPool(CCmDestinationImpl *) |
void | RemoveDestFromPool(CCmDestinationData *) |
void | RemoveResourceFile(TFileName &) |
void | ReplaceGenConnSettingsL(const TCmGenConnSettings &) |
void | RollbackTransaction() |
CCDSnapRecord * | SNAPRecordL(TUint32) |
CommsDat::TMDBElementId
| SeamlessnessTableId() |
CommsDat::CMDBSession & | Session() |
void | StartCommsDatNotifierL() |
void | SupportedBearersL(RArray< TUint32 > &) |
CGulIcon * | UncategorizedIconL() |
void | UpdateBearerPriorityArrayL(const RArray< TBearerPriority > &) |
IMPORT_C void | WatcherRegisterL(MCmCommsDatWatcher *) |
IMPORT_C void | WatcherUnRegister() |
IMPORT_C void | WrapCmManager(RCmManagerExt &) |
void | WriteDefConnL(const TCmDefConnValue &) |
void | WriteDefConnWoTransL(const TCmDefConnValue &) |
void | WriteGenConnSettingsL(const TCmGenConnSettings &) |
Constructor & Destructor Documentation
CCmManagerImpl()
CCmManagerImpl | ( | ) | [protected] |
~CCmManagerImpl()
~CCmManagerImpl | ( | ) | [virtual] |
Member Functions Documentation
AddResourceFileL(TFileName &)
AllDestinationsL(RArray< TUint32 > &)
Return an array of all destinations
Parameters
RArray< TUint32 > & aDestArray | on return it returns an array of destination ids |
AllIapsL()
Return an array of all IAP records.
AllSNAPRecordsL(TUint32)
Return all the SNAP record. Filtering can be made on passed SNAP elemented id.
AllocReadL(TInt)
Read string from resource
Parameters
TInt aResourceId | resource id of the localized string |
AppendCmListFromUidsL(RArray< TUint32 > &, RPointerArray< CCmPluginBase > &)
Returns a list of references to the connection methods in the supported uid list .
AppendCmListL(TUint32, RPointerArray< CCmPluginBase > &)
Returns a list of references to the connection methods in the destination.
AppendCmListLC(TUint32, RPointerArray< CCmPluginBase > &)
Returns a list of references to the connection methods in the destination.
AppendUncatCmListL(RPointerArray< CCmPluginBase > &, TBool, TBool, TBool, TBool)
Get a list of uncategorised connection methods in an RPointerArray contains the parameters passed to ConnectionMethodL
Parameters
RPointerArray< CCmPluginBase > & aCmArray | the returned list of uncategorised connection methods |
TBool aCheckBearerType = ETrue | see ConnectionMethodL |
TBool aLegacyOnly = ETrue | see ConnectionMethodL |
TBool aEasyWlan = EFalse | see ConnectionMethodL |
TBool aSortByBearer = EFalse | see ConnectionMethodL |
AppendUncatCmListLC(RPointerArray< CCmPluginBase > &, TBool, TBool, TBool, TBool)
Get a list of uncategorised connection methods in an RPointerArray contains the parameters passed to ConnectionMethodL LC version
Parameters
RPointerArray< CCmPluginBase > & aCmArray | the returned list of uncategorised connection methods |
TBool aCheckBearerType = ETrue | see ConnectionMethodL |
TBool aLegacyOnly = ETrue | see ConnectionMethodL |
TBool aEasyWlan = EFalse | see ConnectionMethodL |
TBool aSortByBearer = EFalse | see ConnectionMethodL |
BearerPriorityArrayL(RArray< TBearerPriority > &)
Return the copy of the bearer priority array. Ownership is passed.
BearerTypeFromCmIdL(TUint32)
Return the bearer type of connection method.
BearerTypeFromIapRecordL(CommsDat::CCDIAPRecord *)
Return the bearer type of connection method.
BearerTypePriorizationTableId()
Return Global Bearer Type Priorization Table ID
BuildPluginArrayL()
void | BuildPluginArrayL | ( | ) | [private] |
Build an array of all bearer specific plugins.
CheckAvailableSpaceL()
void | CheckAvailableSpaceL | ( | ) | [private] |
Leaves if no sufficient is available for creation operations
CheckTablesL()
void | CheckTablesL | ( | ) | [private] |
Check the existence of tables we need. Creates if it is not exist, get the table id otherwise
CleanupGlobalPriorityArray(RArray< TBearerPriority > &)
Clean up passed global bearer priority array. Delete the elements and calls Reset and Close on the array.
CleanupResetAndDestroyPushL(TArrayToCleanup &)
void | CleanupResetAndDestroyPushL | ( | TArrayToCleanup & | aPtr | ) | [static, inline] |
CombineArraysForPriorityOrderL(RPointerArray< CCmPluginBase > &, RPointerArray< CCmPluginBase > &)
Combines two lists of CCmPluginBase pointers into one, according to default priority order
CommitTransactionL(TInt)
void | CommitTransactionL | ( | TInt | aError | ) | |
ConnMethodUpdatedL(CCmPluginBaseEng *)
The cm have been updated if it was a new cm than the zero id must be changed to the new one
ConnectionMethodL(TUint32)
ConnectionMethodL(RArray< TUint32 > &, TBool, TBool, TBool, TBool)
IMPORT_C void | ConnectionMethodL | ( | RArray< TUint32 > & | aCMArray, |
| TBool | aCheckBearerType = ETrue, |
| TBool | aLegacyOnly = ETrue, |
| TBool | aEasyWlan = EFalse, |
| TBool | aSortByBearer = EFalse |
| ) | |
Return the list of connection methods do not belongs to any destination
Parameters
RArray< TUint32 > & aCMArray | on return it is the array of IAP ids. |
TBool aCheckBearerType = ETrue | If ETrue only connection methods with supported bearer types are returned |
TBool aLegacyOnly = ETrue | when set to ETrue only Legacy IAP ids will be returned |
TBool aEasyWlan = EFalse | when set to ETrue EasyWlan id is returned, too |
TBool aSortByBearer = EFalse | if ETrue the CMs will be ordered according to global bearer priority |
ConstructL()
void | ConstructL | ( | ) | [protected] |
CopyBearerPriorityArrayL(RArray< TBearerPriority > &)
Return the copy of the bearer priority array. Ownership is passed.
CopyConnectionMethodL(CCmDestinationImpl &, CCmPluginBase &)
Copie a connection method belonging to one destination to another. The connection method becomes shared.
CreateBearerPriorityArrayL()
void | CreateBearerPriorityArrayL | ( | ) | [private] |
Creates bearer priority array
CreateConnectionMethodL(TUint32, CCmDestinationImpl *)
Creates a connection method does not belong to any destination
Parameters
TUint32 aBearerType | |
CCmDestinationImpl * aParentDestination = NULL | - the destination which holds the connection method, NULL means there is no parent |
CreateConnectionMethodL(TUint32, TUint32, CCmDestinationImpl *)
Creates a connection method does not belong to any destination
Parameters
TUint32 aBearerType | |
TUint32 aConnMethodId | Predefined id for the connection method |
CCmDestinationImpl * aParentDestination = NULL | - the destination which holds the connection method, NULL means there is no parent |
CreateConnectionMethodL(CCmPluginBaseEng *)
Creates a connection method does not belong to any destination
CreateDestinationL(const TDesC &)
Creates a Destination by the given name
Parameters
const TDesC & aName | the name of the new destination |
CreateDestinationL(const TDesC &, TUint32)
Creates a Destination by the given name
Parameters
const TDesC & aName | the name of the new destination |
TUint32 aDestId | Predefined id for the destination |
CreateFlatCMListL(TUint32, RPointerArray< CCmPluginBase > &)
Create a 'flat list' of connection methods of a given destination ( connection methods inside embedded destinations which are in the destination, are also present in the list ) and order them according to the bearer type prioritisation rules and return the result in aCmArray.
Parameters
TUint32 aDestination | destination that contains the connection methods for uncategorised connection methods, use KDestItemUncategorized |
RPointerArray< CCmPluginBase > & aCmArray | array to return the result |
CreateFlatCMListLC(TUint32, RPointerArray< CCmPluginBase > &)
Create a 'flat list' of connection methods of a given destination ( connection methods inside embedded destinations which are in the destination, are also present in the list ) and order them according to the bearer type prioritisation rules and return the result in aCmArray. LC version
Parameters
TUint32 aDestination | destination that contains the connection methods for uncategorised connection methods, use KDestItemUncategorized |
RPointerArray< CCmPluginBase > & aCmArray | array to return the result |
CreateSNAPRecordL(TUint32)
DestinationCountL()
TUint
| DestinationCountL | ( | ) | [inline] |
Return the number of destinations
DestinationL(TUint32)
Return the destination implementation to which a specified connection method belongs, search is by destination ID ( the id which is made by RECORD_FROM_ELEMENT_ID from the elementID) If the destination implementation is allready in the object pool returns it. If it is not in the pool than puts it in the pool using the GetDestinationL funciton.
DestinationStillExistedL(CCmDestinationImpl *)
DestinationTableId()
Return the destination network table ID
DestinationUpdated(CCmDestinationImpl *)
The destination have been updated if it was a new destination than the zero id must be changed to the new one
DoCreateConnectionMethodL(TUint32, TCmPluginInitParam &)
Creates a connection method does not belong to any destination
Parameters
TUint32 aBearerType | - implementation uid of the connection method |
TCmPluginInitParam & aParams | - the destination which holds the connection method, NULL means there is no parent |
DoCreateConnectionMethodL(TUint32, TCmPluginInitParam &, TUint32)
Creates a connection method does not belong to any destination
Parameters
TUint32 aBearerType | Implementation uid of the connection method |
TCmPluginInitParam & aParams | Initialization params for the plugin. |
TUint32 aConnMethodId | Predefined id for the connection method. |
DoFindConnMethL(TUint32, CCmDestinationImpl *)
Find and create a connection method.
Parameters
TUint32 aCmId | id of the connection method parent destination of the connection method. Can be NULL. |
CCmDestinationImpl * aParentDest | |
DoFindConnMethodL(TUint32, CCmDestinationImpl *)
Find and create a connection method.
Parameters
TUint32 aCmId | id of the connection method parent destination of the connection method. Can be NULL. |
CCmDestinationImpl * aParentDest | |
EasyWlanIdL()
Returns the id of the EasyWlan connection method.
FilterOutVirtualsL(RPointerArray< CCmPluginBase > &)
Remove the virtual methods from the passed list
FindResourceFile(TFileName &)
Look for the given resource file in the resource file array and return the index value of it.
Parameters
TFileName & aName | resource file name, not localized |
GetBearerInfoBoolL(TUint32, TUint32)
GetBearerInfoIntL(TUint32, TUint32)
GetBearerInfoXXX function can be used to query bearer informantion that doesn't belong to a specific connection method, such as ECmCoverage or ECmDefaultPriority etc. HBuf ownership is passed to the caller
GetBearerInfoString8L(TUint32, TUint32)
GetBearerInfoStringL(TUint32, TUint32)
GetConnectionMethodInfoBoolL(TUint32, TUint32)
GetConnectionMethodInfoIntL(TUint32, TUint32)
GetConnectionMethodInfoXXX function can be used to query any, non-bearer specific information about a given connection method. This can be e.g. ECmBearerType, ECmName, ECmStartPage etc. HBuf ownership is passed to the caller
GetConnectionMethodInfoString8L(TUint32, TUint32)
GetConnectionMethodInfoStringL(TUint32, TUint32)
GetConnectionMethodL(TUint32)
Return the connection method queried by it's ID
GetInternetDestinationIdL()
TUint32
| GetInternetDestinationIdL | ( | ) | |
Returns internet destination id. If internety destination is not found then -1 is returned.
GetSnapTableIdL()
Get Snap Table ID from CommsDat
GlobalBearerPriority(TBool, const TDesC &)
TInt
| GlobalBearerPriority | ( | TBool | aUiPriority, |
| const TDesC & | aServiceType |
| ) | const |
Search service type in the global priority table and Return its priority.
Parameters
TBool aUiPriority | ETrue if UI priority is requested |
const TDesC & aServiceType | serched service type |
HandleDefConnDeletedL(TCmDefConnValue &)
Tells the CmManager that the given default connection is deleted, and it sets Default Connection to Always Ask (default value).
HasCapabilityL(TCapability)
Checks if the current environment has the given capability. Leaves with KErrPermissionDenied if capability is missing.
HasUnprotectedDestinationsL()
TBool
| HasUnprotectedDestinationsL | ( | ) | |
Indicates is at least one non-"level 1 protected" destinations
IapStillExistedL(const CCmPluginBaseEng &)
IconTableId()
Return the Destination network - Icon table ID
InsertConnectionMethodL(CCmPluginBaseEng *)
Insert a connection method does not belong to any destination API doesn't use CCmPluginBase. So, nothing returns
IsBearerSpecific(TUint32)
Check if the attribute is bearerspecific
Parameters
TUint32 aAttribute | attribute-id to be checked |
IsDefConnSupported()
TBool
| IsDefConnSupported | ( | ) | |
Returs ETrue if Default Connection feature is supported.
IsEasyWLanL(CommsDat::CCDIAPRecord *)
Return if the IAP record points to an EasyWLan service record.
IsHelpOn()
TBool
| IsHelpOn | ( | ) | const [inline] |
IsIapLinkedL(const CCmPluginBaseEng &)
Walks through every connection methods to find out if the passed connection method is linked to any of them.
IsIapStillInDestL(CCmDestinationImpl *, const CCmPluginBaseEng &)
IsMemoryLow()
Check if memory low so that process can continue
MoveConnectionMethodL(CCmDestinationImpl &, CCmDestinationImpl &, CCmPluginBase &)
Move a connection method belonging to one destination to another. The connection method is removed from the source destination
NewL(TBool)
Parameters
TBool aCreateTables = ETrue | |
NumOfConnMethodReferencesL(TUint32, CommsDat::CMDBRecordSet< CCDDataMobilitySelectionPolicyRecord > *)
Return the number of references to the given connection method id in the DN_IAP table
OpenTransactionLC(TBool)
void | OpenTransactionLC | ( | TBool | aSetAttribs = ETrue | ) | |
Parameters
TBool aSetAttribs = ETrue | |
ParentDestinationL(TUint32)
Gets the destination for the given element ID
Parameters
TUint32 aCmId | The element ID of the destination |
ReadDefConnL(TCmDefConnValue &)
Returns the default connection method/SNAP.
ReadDefConnWoTransL(TCmDefConnValue &)
Returns the default connection method/SNAP.
ReadGenConnSettingsL(TCmGenConnSettings &)
Returns the general connection settings.
RemoveAllReferencesL(const CCmPluginBaseEng &)
Removes all references to this CM from SNAP table.
RemoveAllReferencesWoTransL(const CCmPluginBaseEng &)
Removes all references to this CM from SNAP table without transaction to commsdat.
RemoveCMFromPoolL(CCmPluginBaseEng *)
Removes the cm from the object pool
RemoveCMFromPoolL(CCmPluginBase *)
Removes the cm from the object pool
RemoveConnectionMethodL(CCmDestinationImpl &, CCmPluginBase &)
Remove connection method from the destination
RemoveDestFromPool(CCmDestinationImpl *)
Removes the destination implementation from the object pool
RemoveDestFromPool(CCmDestinationData *)
Removes the destination implementation from the object pool
RemoveResourceFile(TFileName &)
Remove resource file from array only if the reference count is zero.
Parameters
TFileName & aName | name of the resource file to be removed |
ReplaceDefConnRecordL(const TCmDefConnValue)
Replaces the Default Connection record with the new one.
ReplaceGenConnSettingsL(const TCmGenConnSettings &)
Replaces the general connection settings.
ResetAndDestroy(TAny *)
void | ResetAndDestroy | ( | TAny * | aPtr | ) | [private, static, inline] |
RollbackTransaction()
void | RollbackTransaction | ( | ) | |
SNAPRecordL(TUint32)
Create a SNAP record object and load it if record id not 0.
Parameters
TUint32 aRecordId | record Id. 0 means create only |
SeamlessnessTableId()
Return the Seamlessness table ID
SetGenConnSettingsToDefault(TCmGenConnSettings &)
Returns the default general connection values.
StartCommsDatNotifierL()
void | StartCommsDatNotifierL | ( | ) | |
SupportedBearersL(RArray< TUint32 > &)
UpdateBearerPriorityArrayL(const RArray< TBearerPriority > &)
WatcherRegisterL(MCmCommsDatWatcher *)
Register aWatcher as watcher for change of CommsDat
WatcherUnRegister()
IMPORT_C void | WatcherUnRegister | ( | ) | |
UnRegister current watcher
WrapCmManager(RCmManagerExt &)
IMPORT_C void | WrapCmManager | ( | RCmManagerExt & | aCmManagerExt | ) | |
Wraps this implementation to an RCmManagerExt. OWNERSHIP IS NOT PASSED , SO NEVER CLOSE aCmManagerExt!!!
Parameters
RCmManagerExt & aCmManagerExt | class to wrap implementation into |
WriteDefConnL(const TCmDefConnValue &)
Stores the default connection method/SNAP.
WriteDefConnWoTransL(const TCmDefConnValue &)
Stores the default connection method/SNAP.
WriteGenConnSettingsL(const TCmGenConnSettings &)
Writes the general connection settings.
Member Data Documentation
RArray< TBearerPriority > * iBearerPriorityArray
CommsDat::TMDBElementId
iBearerTypePriorizationTableId
CCmCommsDatNotifier * iCommsDatIapNotifier
CCmCommsDatNotifier * | iCommsDatIapNotifier | [private] |
CCmCommsDatNotifier * iCommsDatSnapNotifier
CCmCommsDatNotifier * | iCommsDatSnapNotifier | [private] |
TBool
iCreateTables
TBool
| iCreateTables | [private] |
TBool
iDefConnSupported
TBool
| iDefConnSupported | [private] |
CommsDat::TMDBElementId
iDefConnTableId
TUint
iDestinationCount
TUint
| iDestinationCount | [private] |
CommsDat::TMDBElementId
iDestinationTableId
CommsDat::TMDBElementId
iIconTableId
TBool
iIsFeatureManagerInitialised
TBool
| iIsFeatureManagerInitialised | [private] |
CCMObjectPool * iObjectPool
CCmConnectionMethodInfo * iPluginImpl
CArrayPtrFlat< const CCmPluginBaseEng > * iPlugins
CArrayPtrFlat< TResourceFiles > * iResourceFiles
CommsDat::TMDBElementId
iSeamlessnessTableId
CCmTransactionHandler * iTrans
CCmTransactionHandler * | iTrans | [private] |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.