class Ulogger::RULogger : public RSessionBase |
Client-side session to the ULogger server. This class should be used to configure ULogger server.
Private Member Functions | |
---|---|
TInt | StartServer () |
Inherited Enumerations | |
---|---|
RHandleBase:TAttributes | |
RSessionBase:TAttachMode |
Private Attributes | |
---|---|
TUint32 | iReserved1 |
TUint32 | iReserved2 |
Inherited Attributes | |
---|---|
RHandleBase::iHandle |
IMPORT_C TInt | ActivateInputPlugin | ( | const TDesC8 & | aPluginName | ) |
Sets which input plug-in is to be used for sending messages to ULogger from a remote machine. This is only relevant for the remote control functionality of ULogger, which allows a remote machine to control the operation of ULogger, instead of a client on the device using RULogger . The plug-in that is passed to this method needs to be one of the plug-ins reported by GetInstalledInputPlugins.
const TDesC8 & aPluginName | The name of the input plug-in to be activated. |
IMPORT_C TInt | ActivateOutputPlugin | ( | const TDesC8 & | aPluginName | ) |
Sets which output plug-in is to be used for outputting trace packets. The plug-in that is passed to this method needs to be one of the plug-ins reported by InstalledOutputPlugins();
const TDesC8 & aPluginName | The name of the plug-in to be used, needs to be one of the names returned by InstalledOutputPlugins() |
IMPORT_C TInt | Connect | ( | ) |
Connects a client to the ULogger server. If the server isn't already running it will be started. To end the server session, use Close() .
IMPORT_C TInt | DeActivateInputPlugin | ( | ) |
Deactivates the currently active input plug-in.
IMPORT_C TInt | GetActiveInputPlugin | ( | TDes8 & | aPluginName | ) |
Gets the active input plug-in.
TDes8 & aPluginName | The 8-bit descriptor to be populated with the name of the active plug-in (max length: KMaxPath). |
IMPORT_C TInt | GetActiveOutputPlugin | ( | TDes8 & | aPluginName | ) |
Gets the active output plug-in.
TDes8 & aPluginName | The 8-bit descriptor to be populated with the name of the active output plug-in (max length: KMaxPath). |
IMPORT_C TInt | GetBufferMode | ( | TInt & | aMode | ) |
Gets the trace buffer mode.
TInt & aMode | The TInt to be populated with the buffer mode: 1 if Straight 0 if Circular |
IMPORT_C TInt | GetBufferSize | ( | TInt & | aSize | ) |
Gets the size of the trace buffer in KB. See SetBufferSize() for an explanation of the trace buffer size.
TInt & aSize | The TInt to be populated with the trace buffer size in KB. |
IMPORT_C TInt | GetInstalledInputPlugins | ( | CArrayPtrFlat < HBufC8 > & | aPluginNames | ) |
Gets all installed input plug-ins.
CArrayPtrFlat < HBufC8 > & aPluginNames | The array to be populated with the installed input plug-in names. |
IMPORT_C TInt | GetInstalledOutputPlugins | ( | CArrayPtrFlat < HBufC8 > & | aPluginNames | ) |
Gets all the installed output plug-ins.
CArrayPtrFlat < HBufC8 > & aPluginNames | The array to be populated with the installed plug-in filename and plug-in names. |
IMPORT_C TInt | GetNotificationSize | ( | TInt & | aSize | ) |
Gets the data notification size. See SetNotificationSize() for an explanation of the data notification size.
TInt & aSize | The TInt to be populated with the data notification size in KB. |
IMPORT_C TInt | GetPluginConfigurations | ( | const TDesC8 & | aPluginName, |
RPointerArray < TPluginConfiguration > & | aConfigurations | |||
) |
Gets all configurationas for the specified plug-in (output or input).
const TDesC8 & aPluginName | The name of the plug-in. This is mapped to the plug-in file name, it can be retrieved by calling GetInstalledOutputPlugins and GetInstalledInputPlugins |
RPointerArray < TPluginConfiguration > & aConfigurations | The array that is to be populated with plug-in configuration items. Ownership of any objects appended to this array is passed to the caller. |
IMPORT_C TInt | GetPrimaryFiltersEnabled | ( | CArrayFixFlat < TUint8 > & | aFilters | ) |
Gets all enabled primary filters.
CArrayFixFlat < TUint8 > & aFilters | The array to be populated with enabled filters |
IMPORT_C TInt | GetSecondaryFilteringEnabled | ( | TBool & | aEnabled | ) |
Gets secondary filtering enabled value.
TBool & aEnabled | The boolean to be populated with the secondary filtering enabled value |
IMPORT_C TInt | GetSecondaryFiltersEnabled | ( | RArray < TUint32 > & | aFilters | ) |
Gets all enabled secondary filters.
IMPORT_C TInt | RemovePluginConfigurations | ( | const TDesC8 & | aPluginName | ) |
Removes all the configurations of the specified plug-in
const TDesC8 & aPluginName | The plug-in name whose settings are to be removed |
IMPORT_C TInt | RunAsService | ( | TBool | aRunAsService | ) |
Not yet supported, does nothing and returns KErrNotSupported.
Starts/stops running ULogger as a service. Running ULogger as a service means that ULogger is always active in the background, which is necessary if the objective is to connect to ULogger from a remote machine, so that ULogger is then listening for remote connections. If ULogger is not running as a service, it is only active when it is handling a client request or it is currenty logging traces (i.e. the Start() function was called).
TBool aRunAsService | The flag to indicate whether the server should run as a service or not |
IMPORT_C TInt | SetBufferMode | ( | TInt | aMode | ) |
Sets the trace buffer mode.
TInt aMode | The buffer mode: 1 if Straight 0 if Circular |
IMPORT_C TInt | SetBufferSize | ( | TInt | aSize | ) |
Sets the size of the trace buffer, specified in KB (default: 1024KB). The trace buffer is the buffer that UTrace uses to hold the trace packets before they are output (using the currently active output plug-in). See also the documentation of SetNotificationSize() .
TInt aSize | The desired new trace buffer size in KB |
IMPORT_C TInt | SetNotificationSize | ( | TInt | aSize | ) |
Sets the data notification size, specified in KB (default: 512KB). The data notification size is a threshold on the trace buffer usage, above which the trace buffer is flushed, i.e. all the trace packets in the trace buffer are output using the active output plug-in. See also the documentation of SetBufferSize() .
TInt aSize | The desired new data notification size in KB |
IMPORT_C TInt | SetPluginConfigurations | ( | const TDesC8 & | aPluginName, |
const TPluginConfiguration & | aConfiguration | |||
) |
Adds a configuration to a plug-in (output or input). This is specific to the plug-in.
Example1: aPluginName="uloggerfileplugin", aConfiguration.SetKey("output_path"), aConfiguration.SetValue(_L("c:\\logs\\ulogger\\tracelogs.btl")) Example2: aPluginName="uloggerserialplugin", aConfiguration.SetKey("baudrate") , aConfiguration.SetValue("115200")
const TDesC8 & aPluginName | The plug-in name (without the .dll extension) |
const TPluginConfiguration & aConfiguration | TPluginConfiguration (key-value type configuration) |
IMPORT_C TInt | SetPrimaryFiltersEnabled | ( | const CArrayFixFlat < TUint8 > & | aFilters, |
TBool | aEnabled | |||
) |
Enables/disables the specified primary filters. This allows output of trace packets containing primary filter identifiers that match the enabled primary filters. Note: If a trace packet contains a secondary filter identifier, and secondary filtering is enabled, the matching secondary filter must also be enabled to allow this packet to be output.
const CArrayFixFlat < TUint8 > & aFilters | The primary filters to enable/disable |
TBool aEnabled | The boolean to specify the action. ETrue to enable and EFalse to disable. |
IMPORT_C TInt | SetSecondaryFilteringEnabled | ( | TBool | aEnabled | ) |
Enables/disables filtering on secondary filters. When secondary filtering is enabled, only those trace packets containing a secondary filter identifier matching an enabled secondary filter are output (see SetSecondaryFiltersEnabled() ). Note that trace packets must also contain a primary filter identifier matching an enabled primary filter in order to be output (see SetPrimaryFilterEnabled()).
TBool aEnabled | The boolean to specify the action. ETrue to enable and EFalse to disable. |
IMPORT_C TInt | SetSecondaryFiltersEnabled | ( | const RArray < TUint32 > & | aFilters, |
TBool | aEnabled | |||
) |
Enables/disables the specified secondary filters. This allows output of trace packets containing secondary filter identifiers that match the enabled secondary filters. Note1: Secondary filters are only relevant when secondary filtering is enabled (see SetSecondaryFilteringEnabled() ). If secondary filtering is disabled, trace packets are logged regardless of any secondary filter identifiers. Note2: Enabling secondary filters will automatically enable secondary filtering. Note3: Primary filtering is always enabled and therefore there is no equivalent method for enabling/disabling primary filtering.
IMPORT_C TInt | Start | ( | ) |
Starts outputting trace packets. Pre-requisite: This will only output trace packets containing filter identifers that match enabled filters. Use SetPrimaryFiltersEnabled() , SetSecondaryFiltersEnabled() and SetSecondaryFilteringEnabled() to enable the relevant filters.
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.