context-listen man page

context-listen — a simple test client to listen to changes in context properties from different providers.


context-listen [PROPERTY]...


context-listen will listen for changes in the properties and notify the user about them. At least one property has to be given. In order to find the appropriate provider for each of the properties context-listen reads the ./cache.cdb or if it doesn't exist then all the XML files in the present directory.  Check libcontextprovider documentation for the format of these XML files and how to convert them to a cdb cache. Send EOF on stdin to terminate the running context-listen.

Environment Variables


when defined context-listen will not croak about type mismatch between the expected and actual type.


when defined context-listen will become immune to the commander, i.e. it will not be affected by context-commander at all.


may define a directory containing the provider descriptor cdb or XML files. If it is not set, a compiled-in registry prefix path will be used (usually /usr/share/contextkit/providers).


context-listen takes a list of properties as arguments. Properties are dot separated names, like Context.Location.Latitude. Obviously a property have to be provided by some provider to be any useful.

Command Line Interface

context-listen can be commanded on its standard input, the available commands can be seen at startup on stderr.  All debugging/error messages are directed to stderr.


context-provide my.test.provider int 42

Creates a test provider with a single int property. Keep this running.


starts context-listen listening for changes in the property '' from the provider 'my.test.provider'. This should be running in the same directory (from an other terminal) or CONTEXT_PROVIDERS should be set accordingly.

set('', 59)

The above command typed in the first terminal running context-provider will change the property and the change will be visible in the second terminal running context-listen.

See Also


Referenced By