diff -r 5072524fcc79 -r 80ef3a206772 Symbian3/PDK/Source/GUID-746866CE-809A-5598-BA60-2947763E5EE9.dita --- a/Symbian3/PDK/Source/GUID-746866CE-809A-5598-BA60-2947763E5EE9.dita Fri Jul 02 12:51:36 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-746866CE-809A-5598-BA60-2947763E5EE9.dita Fri Jul 16 17:23:46 2010 +0100 @@ -11,38 +11,38 @@ PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> Network Privacy API ReferenceThis section describes the dynamic behaviour of the Network Privacy API using a set of sequence diagrams.
Sequence diagrams

The sequence diagrams in this section describe the behaviour of the Network Privacy API when a licensee has installed and configured a Privacy Controller, Privacy Notifiers or Privacy Q&N Notifiers.

Startup and shutdown sequences

The sequence diagrams in this section describe how the LBS subsystem starts up and shuts down when LBS is built to include a Privacy Protocol Module and privacy requests are received via the Network Privacy API.

Startup sequence

The first request sent into the LBS subsystem via the Network Privacy API starts the subsystem, as shown in figure 1.1 (which shows startup of a licensee Privacy Controller).

Figure 1.1. LBS startup. -

Shutdown sequence

The LBS subsystem is shutdown either:

  • When the licensee Network Privacy API client closes its connection and calls the CPosNetworkPrivacy destructor

  • When a timer expires after the last request is completed

Figure 1.2 shows LBS shutdown for the two cases.

+

Shutdown sequence

The LBS subsystem is shutdown either:

  • When the licensee Network Privacy API client closes its connection and calls the CPosNetworkPrivacy destructor

  • When a timer expires after the last request is completed

Figure 1.2 shows LBS shutdown for the two cases.

Figure 1.2. LBS shutdown -

Privacy Controller sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured a privacy controller.

Privacy verification with a Privacy Controller (request accepted, rejected or timeout)

Figure 2.1 shows privacy verification with a Privacy Controller.

+

Privacy Controller sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured a privacy controller.

Privacy verification with a Privacy Controller (request accepted, rejected or timeout)

Figure 2.1 shows privacy verification with a Privacy Controller.

Figure 2.1 Privacy verification with a Privacy Controller. -

Privacy notification with a Privacy Controller

Figure 2.2 shows location notification with a Privacy Controller.

+

Privacy notification with a Privacy Controller

Figure 2.2 shows location notification with a Privacy Controller.

Figure 2.2 Privacy notification with a Privacy Controller. -

Privacy verification cancelled with a Privacy Controller

Figure 2.3 shows a privacy verification cancelled with a Privacy Controller.

+

Privacy verification cancelled with a Privacy Controller

Figure 2.3 shows a privacy verification cancelled with a Privacy Controller.

Figure 2.3. Privacy verification cancelled with Privacy Controller. -

Timeout notification with a Privacy Controller

Figure 2.4 shows a timeout notification with a Privacy Controller.

+

Timeout notification with a Privacy Controller

Figure 2.4 shows a timeout notification with a Privacy Controller.

Figure 2.4. Timeout notification with a Privacy Controller. -

Privacy Notifier sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured privacy notifiers.

Privacy verification with a Privacy Notifier (request accepted, rejected or timeout)

Figure 3.1 shows verification of a privacy request with a Privacy Notifier.

+

Privacy Notifier sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured privacy notifiers.

Privacy verification with a Privacy Notifier (request accepted, rejected or timeout)

Figure 3.1 shows verification of a privacy request with a Privacy Notifier.

Figure 3.1. Privacy verification with a Privacy Notifier. -

Privacy notification with a Privacy Notifier

Figure 3.2 shows location notification with a Privacy Notifier.

+

Privacy notification with a Privacy Notifier

Figure 3.2 shows location notification with a Privacy Notifier.

Figure 3.2. Privacy notification with a Privacy Notifier. -

Privacy verification cancelled with Privacy Notifier

Figure 3.3 shows a privacy verification cancelled with a Privacy Notifier.

+

Privacy verification cancelled with Privacy Notifier

Figure 3.3 shows a privacy verification cancelled with a Privacy Notifier.

Figure 3.3. Privacy verification cancelled with Privacy Notifier. -

Timeout notification with Privacy Notifier

Figure 3.4 shows a timeout notification with a Privacy Notifier.

+

Timeout notification with Privacy Notifier

Figure 3.4 shows a timeout notification with a Privacy Notifier.

Figure 3.4. Timeout notification with a Privacy Notifier. -

Privacy Q&N Notifier sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured privacy Q&N notifiers.

Privacy verification with a Privacy Q&N notifier (request accepted, rejected or timeout)

Figure 4.1 shows verification of a privacy request with a Privacy Q&N notifier.

+

Privacy Q&N Notifier sequences

The sequence diagrams in this section illustrate the behaviour of the Network Privacy API when a licensee has installed and configured privacy Q&N notifiers.

Privacy verification with a Privacy Q&N notifier (request accepted, rejected or timeout)

Figure 4.1 shows verification of a privacy request with a Privacy Q&N notifier.

Figure 4.1. Privacy verification with a Q&N Privacy Notifier. -

Privacy notification with a Privacy Q&N notifier

Figure 4.2 shows a privacy notification with a Privacy Q&N notifier.

+

Privacy notification with a Privacy Q&N notifier

Figure 4.2 shows a privacy notification with a Privacy Q&N notifier.

Figure 4.2. Privacy notification with a Privacy Q&N Notifier. -

Privacy verification cancelled with Privacy Q&N notifier

Figure 4.3 shows a privacy verification cancelled with a Privacy Q&N notifier.

+

Privacy verification cancelled with Privacy Q&N notifier

Figure 4.3 shows a privacy verification cancelled with a Privacy Q&N notifier.

Figure 4.3. Privacy verification cancelled with Privacy Q&N Notifier. -

Timeout notification with Privacy Q&N notifier

Figure 4.4 shows a timeout notification with a Privacy Q&N notifier.

+

Timeout notification with Privacy Q&N notifier

Figure 4.4 shows a timeout notification with a Privacy Q&N notifier.

Figure 4.4. Timeout notification with a Privacy Q&N Notifier. -
Privacy + Privacy Protocol Module Overview Network Privacy API
\ No newline at end of file