Collapse all Symbian^3 Product Developer Library

User Prompt Service Configuration

This topic shows how to enable and disable the user prompt service to authorise the client application requests.

Introduction

The user prompt service can be disabled by a patchable constant.
The user prompt service can be configured to grant access to all network connection requests from applications running in a particular process, provided that the user has authorised the connection in a previous request from the same process.
The user prompt service can be configured for the duration of a network connection. All applications running within any given process are granted access, provided the user has authorised the connection in a previous request for the network duration.
The user prompt service can be configured to use either the techview notifier or the networking text notifier.

Emulator configuration example

When using an emulator the user prompt service can be configured in the epoc.ini file in the following way:


NETWORKING_UPS_DISABLE=0  #UPS functionality is enabled
NETWORKING_UPS_DISABLE=1  #UPS functionality is disabled
NETWORKING_UPS_DISABLE=2  #epoc32\winscw\c\private\101f7989\esock\netups.ini is parsed to determine 
                          # whether UPS functionality is enabled or not.


NETWORKING_UPS_SESSION=0  #netups component operates in process life time mode
NETWORKING_UPS_SESSION=1  #netups component operates in network life time mode
NETWORKING_UPS_SESSION=2  #epoc32\winscw\c\private\101f7989\esock\netups.ini is parsed to determine the   
                           netups operates on process or network life time mode.


NETWORKING_UPS_NOTIFIERUID = 0x10285887  #network text notifier will be used provided that "startupmode=1"
                                         #is also specified in epoc.ini.

NETWORKING_UPS_NOTIFIERUID = 0x1028369b  #default techview  notifier will be used.

Note: If NETWORKING_UPS_NOTIFIERUID is not defined and startup mode is '1', then the networking text notifier is used. For all other startup modes the default techview notifier is used.

To specify whether an application is authorised for process duration or network duration, the netups.ini file is configured as follows:

[upsIpMode]

NETWORKING_UPS_DISABLE= 0     # UPS functionality is enabled
NETWORKING_UPS_DISABLE= 1     # UPS functionality is disabled

NETWORKING_UPS_SESSION= 0     # process life time  mode
NETWORKING_UPS_SESSION= 1     # network  life time mode

If NETWORKING_UPS_DISABLED is not specified in either epoc.ini or netups.ini, then by default UPS prompting is enabled. If NETWORKING_UPS_SESSION is not configured in either file then the netups component works in process life time mode.

Hardware configuration example

When building the Symbian platform for targert hardware, the user prompt service can be configured through patchable constants.

Patchable constants are used to define the whether the UPS component is enabled or disabled, and whether the netups component is working in process or network lifetime mode. These constants are defined when the ROM is built using the following command line arguments:

buildrom.cmd -DNETWORKING_UPS_SESSION=1  (followed by other command line arguments)

where 0 = process life time, 1 = network life time, 2 = read from netups.ini, as described above

buildrom.cmd -DNETWORKING_UPS_DISABLED=1 (followed by other command line arguments)

where 0 = disabled, 1= disabled, 2 = read from netups.ini, as described above)

buildrom.cmd -DNETWORKING_UPS_NOTIFIERUID= 0x10285887 (followed by other command line arguments)

where -DNETWORKING_UPS_NOTIFIERUID=0x10285887 means the networking text notifier is used, otherwise the default techview notifier is used.

Parent topic: Comms User Prompt Manager