add more spacing
[personal-kdebase.git] / workspace / solid / networking / README
blobfeba93935356813b47d1d27032b9dd3a70d51e0a
1 *) Network Status kded module implements two interfaces under
2 /modules/networkstatus
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
9   Service changes are aggregated and signalled over the Client interface
10   to listening apps.
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.
17 *) Add a NetworkStatusIndicator class which is a simple widget shown
18 when offline, which automatically hides() itself when online
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.
23 To use:
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.