summaryrefslogtreecommitdiff
path: root/noncore/net/wellenreiter/libwellenreiter/docs/quickintro
blob: a027a4e9ff41dbe160546c9d4438983b8d9e6b51 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

Name:   libwellenreiter
Author: Martin J. Muench

NOTE: This is just a very short summary of the functions included 
in libwellenreiter, written because a lack of time. The whole 
library will be rewritten with extended documentation and 
test programs.

-- 
Wellenreiter types:
In proto.hh the following type (wl_network_t) is declared:

typedef struct {
  int net_type;    /* 1 = Accesspoint ; 2 = Ad-Hoc   */
  int ssid_len;    /* Length of SSID                 */
  int channel;     /* Channel                        */
  int wep;         /* 1 = WEP enabled ; 0 = disabled */
  char mac[64];    /* MAC address of Accesspoint     */
  char bssid[128]; /* BSSID of Accesspoint           */
} wl_network_t;

When a network is found, the structure has to be set and 
sent to the send_network_found() function.

When the GUI receives a found network string it calls the 
get_network_found() function to get its own structure set.

--
Included functions:

--
Protocol:

Send a found network to GUI:
int send_network_found (const char *, int, void *);

The first two arguments are the guihost and the guiport.
The third is the filled structure (wl_network_t), that will 
be send to the GUI.

Setup structure for found network:
int get_network_found (void *, const char *);

When the GUI receives a new network found packet it calls
this function and passes a wl_network_t structure and the
received buffer. The function will strip the data from
the buffer and set it to the structure.

--
Log to syslog/info:
void wl_loginfo(const char *, ...);

Log to syslog/err:
void wl_logerr(const char *, ...);

Use like printf() function with format strings and so on.

--
Setup udp socket for incoming commands:
int commsock(const char *, int);

Fist argument is the host where it should listen and second
is the port.

Return values: 

Send command to udp socket:
int sendcomm(const char *, int, const char *, ...);

First two arguments are the host and port where the command should
be send to, followed by buffer that should be send.


---

Thats it for the moment.

mjm.