summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/docs/specification23
1 files changed, 22 insertions, 1 deletions
diff --git a/noncore/net/wellenreiter/docs/specification b/noncore/net/wellenreiter/docs/specification
index d833451..0766ef4 100644
--- a/noncore/net/wellenreiter/docs/specification
+++ b/noncore/net/wellenreiter/docs/specification
@@ -42,12 +42,16 @@ of the daemon. That means that the daemon loads the config file on
42startup and sends the informations to the GUI. The GUI contains an option 42startup and sends the informations to the GUI. The GUI contains an option
43"configure" where the settings can be changed. They will be sent to the 43"configure" where the settings can be changed. They will be sent to the
44daemon which actually changes the configuration file. 44daemon which actually changes the configuration file.
45The configuration file is placed in /usr/local/etc/wellenreiter.conf. 45The configuration file is placed in /usr/local/etc/wellenreiter.conf.
46The whole content of this file cannot be specified yet. 46The whole content of this file cannot be specified yet.
47 47
48OPIE specific: Opie contains a bunch of high-level configuration classes,
49which are used by most Opie applications. It should be discussed whether
50to use this structure / API (preferred) or use a proprietary one.
51
48 52
49-[ Interaction GUI<->daemon 53-[ Interaction GUI<->daemon
50 54
51The GUI and the daemon will talk actively with eachother, meaning that 55The GUI and the daemon will talk actively with eachother, meaning that
52everyside who has informations for the other part will send it and not 56everyside who has informations for the other part will send it and not
53wait for the other part to poll. 57wait for the other part to poll.
@@ -55,13 +59,30 @@ For example the sniffing function of the daemon is startet when a
55"start_sniff" from the GUI arrived. And when the daemon found a network 59"start_sniff" from the GUI arrived. And when the daemon found a network
56it will be directly send to the GUI to be able to sniff in realtime. 60it will be directly send to the GUI to be able to sniff in realtime.
57 61
58 62
59-[ Communication GUI<->daemon 63-[ Communication GUI<->daemon
60 64
61Not yet specified. 65The GUI and the daemon run as threads within one process, where the GUI
66thread will be the main thread. Both the daemon and the GUI thread are
67(mostly) "free-running". Once the GUI thread is started and has finished
68its initializations, it jumps into the Qt event loop ( QApplication::exec() ).
69
70If the daemon thread is actively working and -
71for instance - has acquired interesting data for the GUI thread to display,
72it calls a special reentrant method of the GUI thread ( QApplication::postEvent )
73either transmitting the whole data structure or saying "Hey, there's interesting data
74for you", which the GUI thread then retrieves.
75To enable a free running daemon thread to actually receive messages from the
76GUI thread, it's useful to to include a non-blocking check-for-messages-function
77within the daemon main loop <since it is waiting for messages from a GUI thread,
78this function has not be called very often>. If applicable, the daemon thread must
79not call this function but only monitor some guarded variables from time to time
80which the GUI thread can modify to alter the behaviour of the daemon thread.
81
82IMHO this is a much more leightweight design than to use a proprietary udp-socket protocol.
62 83
63 84
64-[ Setting card modes 85-[ Setting card modes
65 86
66One of the most interesting parts is the switching of the wirelesscards to 87One of the most interesting parts is the switching of the wirelesscards to
67different channels, to monitor mode and so on. In the older versions this 88different channels, to monitor mode and so on. In the older versions this