workspace/solid/networking/README

   1 *) Network Status kded module implements two interfaces under
   2 /modules/networkstatus
   3
   4  *) Client provides network status info and signals to network aware
   5  apps
   6  *) Service allows apps providing or monitoring network status to
   7  register their networks and change their status
   8
   9   Service changes are aggregated and signalled over the Client interface
  10   to listening apps.
  11
  12 *) Add a KConnectionManager class to make using the Client interface
  13 stupidly easy.  This caches status, preventing unnecessary dbus calls,
  14 allows control over connect/disconnect policy and can call registered
  15 slots on connect/disconnect.
  16
  17 *) Add a NetworkStatusIndicator class which is a simple widget shown
  18 when offline, which automatically hides() itself when online
  19
  20 *) Add a pair of GUI test programs 'client' and 'service' which allow
  21 the curious to simulate network changes and their effects on a client.
  22
  23 To use:
  24
  25 1) make install
  26 2) qdbus org.kde.kded /kded loadModule networkstatus,
  27    qdbus org.kde.kded /modules/networkstatus status
  28    qdbus org.kde.kded /modules/networkstatus networks
  29 3) in builddir/tests ./service
  30 4) likewise, ./client
  31 5) Change the service's status and observe the changes in the client.
  32    Set the client to Start Connect while the service is offline, then
  33    connect the service and see how the client responds.
  34 6) Use KConnectionManager in your own code.
  35