Home · All Classes · Grouped Classes · Annotated · Functions

vsexplorer

Exploring the Value Space with vsexplorer

The vsexplorer tool is provided for diagnosing issues with the Qtopia Value Space. Many of Qtopia's services write values into the value space so that they are accessible to Qtopia libraries, applications, themes, etc.

The vsexplorer tool can be used to inspect the contents of the value space on a device, to make temporary modifications, and to watch for changes in specific value space items.

When run from the command-line normally, it launches an interpreter environment that can accept commands. The commands are very similar to using a Unix-style command-prompt, as shown in the current example:

    $ vsexplorer
    / > ls
    Hardware/
    Accessories/
    Documents/
    Network/
    UI/
    Telephony/
    MediaServer/
    System/
    AudioManager/
    Communications/
    / > cd Telephony
    /Telephony > ls
    Status/
    /Telephony > cd Status
    /Telephony/Status > ls
    CallDivert/                     'false' (bool)
    Roaming/                        'false' (bool)
    SimToolkitAvailable/            'false' (bool)
    RegistrationState/              'Home' (QString)
    OperatorCountry/                '' (QString)
    SMSMemoryFull/                  '0' (int)
    CellModemAvailable/             'true' (bool)
    ModemStatus/                    'Ready' (QString)
    PlaneModeAvailable/             'Yes' (QString)
    VoIP/
    CellLocation/                   '' (QString)
    NetworkRegistered/              'true' (bool)
    OperatorName/                   'Trolltech Comm' (QString)
    /Telephony > exit
    $ _

The tool prints the current value space directory, starting at the root. The user can use cd to change into a new directory, and ls to list the directory's contents. If the directory contains item values, their values will be listed. You can always return to the root of the value space by typing cd /. The exit command exits from the vsexplorer interpreter.

Commands

The following commands are available in vsexplorer:

CommandDescription
help, ?Print help on the available commands.
exit, quitExit from vsexplorer.
cd nameChange into the value space directory called name.
lsList the contents of the current value space directory.
ls nameList the contents of the value space directory called name.
set name valueSet the value space item called name to value. This can be used from vsexplorer to make temporary changes to the value space for testing other applications. The changes will be removed when vsexplorer exits.
clear nameClear the value space item called name. This will remove any previous values that were set on name using the set command. This cannot be used to clear values that were set by other applications.
subscribe, subSubscribe to change notifications on the current directory. Whenever a service in Qtopia makes a change to this directory or one of its subdirectories, a message Changed: name will be printed for the directory that was subscribed to. The user can then use ls to inspect the new values.
unsubscribe, unsubUnsubscribe from change notifications on the current directory.
subscriptionsPrint the current list of change notification subscriptions.
write name valueSend a request to the application that controls the value space item name to change it to value. This does not actually set the value, but asks the owning application to set it. The application is free to ignore the request. This feature is not used very often in Qtopia. The set command is more likely to be useful.
remove nameSend a request to the application that controls the value space item name to remove it from the value space. This does not actually remove the value, but asks the owning application to remove it. The application is free to ignore the request. This feature is not used very often in Qtopia. The clear command is more likely to be useful.
watch nameWatch for requests to change the value space item name. Requests that come from write and remove commands will activate such a watch. This feature is not used very often in Qtopia. The subscribe command is more likely to be useful.
unwatch nameRemove a watch for requests to change the value space item name. This feature is not used very often in Qtopia. The unsubscribe command is more likely to be useful.
watchersPrint the current list of watchers that were installed with the watch command.
suppressToggle the suppression state for messages printed by watchers that were installed with the watch command. The watchers will remain installed, but the normal messages that they print will be suppressed until another suppress command is seen.

Dump Mode

The vsexplorer tool can be run in a second mode where it dumps the entire contents of the value space instead of entering the interpreter. This dump mode is activated by typing vsexplorer -d. The following is an example of dumping all values under /Telephony/Status and writing it to the file status.out:

    $ vsexplorer -d | grep /Telephony/Status >status.out


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3