summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/libwellenreiter/docs/quickintro46
1 files changed, 45 insertions, 1 deletions
diff --git a/noncore/net/wellenreiter/libwellenreiter/docs/quickintro b/noncore/net/wellenreiter/libwellenreiter/docs/quickintro
index e4978a1..a027a4e 100644
--- a/noncore/net/wellenreiter/libwellenreiter/docs/quickintro
+++ b/noncore/net/wellenreiter/libwellenreiter/docs/quickintro
@@ -1,35 +1,79 @@
1 1
2Name: libwellenreiter 2Name: libwellenreiter
3Author: Martin J. Muench 3Author: Martin J. Muench
4 4
5NOTE: This is just a very short summary of the functions included 5NOTE: This is just a very short summary of the functions included
6in libwellenreiter, written because a lack of time. The whole 6in libwellenreiter, written because a lack of time. The whole
7library will be rewritten with extended documentation and 7library will be rewritten with extended documentation and
8test programs. 8test programs.
9 9
10--
11Wellenreiter types:
12In proto.hh the following type (wl_network_t) is declared:
13
14typedef struct {
15 int net_type; /* 1 = Accesspoint ; 2 = Ad-Hoc */
16 int ssid_len; /* Length of SSID */
17 int channel; /* Channel */
18 int wep; /* 1 = WEP enabled ; 0 = disabled */
19 char mac[64]; /* MAC address of Accesspoint */
20 char bssid[128]; /* BSSID of Accesspoint */
21} wl_network_t;
22
23When a network is found, the structure has to be set and
24sent to the send_network_found() function.
25
26When the GUI receives a found network string it calls the
27get_network_found() function to get its own structure set.
28
29--
10Included functions: 30Included functions:
11 31
32--
33Protocol:
34
35Send a found network to GUI:
36int send_network_found (const char *, int, void *);
37
38The first two arguments are the guihost and the guiport.
39The third is the filled structure (wl_network_t), that will
40be send to the GUI.
41
42Setup structure for found network:
43int get_network_found (void *, const char *);
44
45When the GUI receives a new network found packet it calls
46this function and passes a wl_network_t structure and the
47received buffer. The function will strip the data from
48the buffer and set it to the structure.
49
50--
12Log to syslog/info: 51Log to syslog/info:
13void wl_loginfo(const char *, ...); 52void wl_loginfo(const char *, ...);
14 53
15Log to syslog/err: 54Log to syslog/err:
16void wl_logerr(const char *, ...); 55void wl_logerr(const char *, ...);
17 56
18Use like printf() function with format strings and so on. 57Use like printf() function with format strings and so on.
19 58
20 59--
21Setup udp socket for incoming commands: 60Setup udp socket for incoming commands:
22int commsock(const char *, int); 61int commsock(const char *, int);
23 62
24Fist argument is the host where it should listen and second 63Fist argument is the host where it should listen and second
25is the port. 64is the port.
26 65
27Return values: 66Return values:
28 67
29Send command to udp socket: 68Send command to udp socket:
30int sendcomm(const char *, int, const char *, ...); 69int sendcomm(const char *, int, const char *, ...);
31 70
32First two arguments are the host and port where the command should 71First two arguments are the host and port where the command should
33be send to, followed by buffer that should be send. 72be send to, followed by buffer that should be send.
34 73
74
75---
76
35Thats it for the moment. 77Thats it for the moment.
78
79mjm.