context-listen(1)

1context-listen(1)           General Commands Manual          context-listen(1)
2
3
4

NAME

6       context-listen  -  a simple test client to listen to changes in context
7       properties from different providers.
8

SYNOPSIS

10       context-listen [PROPERTY]...
11

DESCRIPTION

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

ENVIRONMENT VARIABLES

22       CONTEXT_CLI_DISABLE_TYPE_CHECK
23               when defined context-listen will not croak about type  mismatch
24               between the expected and actual type.
25
26       CONTEXT_CLI_IGNORE_COMMANDER
27               when  defined  context-listen will become immune to the comman‐
28               der, i.e. it will not be affected by context-commander at all.
29
30       CONTEXT_PROVIDERS
31               may define a directory containing the provider  descriptor  cdb
32               or  XML  files. If it is not set, a compiled-in registry prefix
33               path will be used (usually /usr/share/contextkit/providers).
34

ARGUMENTS

36       context-listen takes a list of properties as arguments.  Properties are
37       dot separated names, like Context.Location.Latitude.  Obviously a prop‐
38       erty have to be provided by some provider to be any useful.
39

COMMAND LINE INTERFACE

41       context-listen can be commanded on its standard  input,  the  available
42       commands  can  be  seen at startup on stderr.  All debugging/error mes‐
43       sages are directed to stderr.
44

EXAMPLES

46       context-provide my.test.provider int mun.testi.property 42
47               Creates a test provider with a single int property.  Keep  this
48               running.
49
50       context-listen mun.testi.property
51               starts  context-listen  listening  for  changes in the property
52               'mun.testi.property' from the provider 'my.test.provider'. This
53               should  be  running in the same directory (from an other termi‐
54               nal) or CONTEXT_PROVIDERS should be set accordingly.
55
56       set('mun.testi.property', 59)
57               The above command typed in the first terminal running  context-
58               provider  will change the property and the change will be visi‐
59               ble in the second terminal running context-listen.
60