← Back to branch summary

~ubuntu-branches/ubuntu/vivid/wpasupplicant/vivid

« back to all changes in this revision

Viewing changes to l2_packet.h

  • Committer: Bazaar Package Importer
  • Author(s): Kel Modderman
  • Date: 2008-03-12 20:03:04 UTC
  • mfrom: (1.1.10 upstream)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20080312200304-4331y9wj46pdd34z
Tags: 0.6.3-1
http://bugs.debian.org/466910
* New upstream release.
* Drop patches applied upstream:
  - debian/patches/30_wpa_gui_qt4_eventhistoryui_rework.patch
  - debian/patches/31_wpa_gui_qt4_eventhistory_always_scrollbar.patch
  - debian/patches/32_wpa_gui_qt4_eventhistory_scroll_with_events.patch
  - debian/patches/40_dbus_ssid_data.patch
* Tidy up the clean target of debian/rules. Now that the madwifi headers are
  handled differently we no longer need to do any cleanup.
* Fix formatting error in debian/ifupdown/wpa_action.8 to make lintian
  quieter.
* Add patch to fix formatting errors in manpages build from sgml source. Use
  <emphasis> tags to hightlight keywords instead of surrounding them in
  strong quotes.
  - debian/patches/41_manpage_format_fixes.patch
* wpasupplicant binary package no longer suggests pcscd, guessnet, iproute
  or wireless-tools, nor does it recommend dhcp3-client. These are not
  needed.
* Add debian/patches/10_silence_siocsiwauth_icotl_failure.patch to disable
  ioctl failure messages that occur under normal conditions.
* Cherry pick two upstream git commits concerning the dbus interface:
  - debian/patches/11_avoid_dbus_version_namespace.patch
  - debian/patches/12_fix_potential_use_after_free.patch
* Add debian/patches/42_manpage_explain_available_drivers.patch to explain
  that not all of the driver backends are available in the provided
  wpa_supplicant binary, and that the canonical list of supported driver
  backends can be retrieved from the wpa_supplicant -h (help) output.
  (Closes: #466910)
* Add debian/patches/20_wpa_gui_qt4_disable_link_prl.patch to remove
  link_prl CONFIG compile flag added by qmake-qt4 >= 4.3.4-2 to avoid excess
  linking.

Show diffs side-by-side

added added

removed removed

Lines of Context:
l2_packet.h
1
 
/*
2
 
 * WPA Supplicant - Layer2 packet interface definition
3
 
 * Copyright (c) 2003-2005, Jouni Malinen <j@w1.fi>
4
 
 *
5
 
 * This program is free software; you can redistribute it and/or modify
6
 
 * it under the terms of the GNU General Public License version 2 as
7
 
 * published by the Free Software Foundation.
8
 
 *
9
 
 * Alternatively, this software may be distributed under the terms of BSD
10
 
 * license.
11
 
 *
12
 
 * See README and COPYING for more details.
13
 
 *
14
 
 * This file defines an interface for layer 2 (link layer) packet sending and
15
 
 * receiving. l2_packet_linux.c is one implementation for such a layer 2
16
 
 * implementation using Linux packet sockets and l2_packet_pcap.c another one
17
 
 * using libpcap and libdnet. When porting %wpa_supplicant to other operating
18
 
 * systems, a new l2_packet implementation may need to be added.
19
 
 */
20
 
 
21
 
#ifndef L2_PACKET_H
22
 
#define L2_PACKET_H
23
 
 
24
 
#define MAC2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5]
25
 
#define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x"
26
 
 
27
 
#ifndef ETH_P_EAPOL
28
 
#define ETH_P_EAPOL 0x888e
29
 
#endif
30
 
 
31
 
#ifndef ETH_P_RSN_PREAUTH
32
 
#define ETH_P_RSN_PREAUTH 0x88c7
33
 
#endif
34
 
 
35
 
/**
36
 
 * struct l2_packet_data - Internal l2_packet data structure
37
 
 *
38
 
 * This structure is used by the l2_packet implementation to store its private
39
 
 * data. Other files use a pointer to this data when calling the l2_packet
40
 
 * functions, but the contents of this structure should not be used directly
41
 
 * outside l2_packet implementation.
42
 
 */
43
 
struct l2_packet_data;
44
 
 
45
 
#ifdef _MSC_VER
46
 
#pragma pack(push, 1)
47
 
#endif /* _MSC_VER */
48
 
 
49
 
struct l2_ethhdr {
50
 
        u8 h_dest[ETH_ALEN];
51
 
        u8 h_source[ETH_ALEN];
52
 
        u16 h_proto;
53
 
} STRUCT_PACKED;
54
 
 
55
 
#ifdef _MSC_VER
56
 
#pragma pack(pop)
57
 
#endif /* _MSC_VER */
58
 
 
59
 
/**
60
 
 * l2_packet_init - Initialize l2_packet interface
61
 
 * @ifname: Interface name
62
 
 * @own_addr: Optional own MAC address if available from driver interface or
63
 
 *      %NULL if not available
64
 
 * @protocol: Ethernet protocol number in host byte order
65
 
 * @rx_callback: Callback function that will be called for each received packet
66
 
 * @rx_callback_ctx: Callback data (ctx) for calls to rx_callback()
67
 
 * @l2_hdr: 1 = include layer 2 header, 0 = do not include header
68
 
 * Returns: Pointer to internal data or %NULL on failure
69
 
 *
70
 
 * rx_callback function will be called with src_addr pointing to the source
71
 
 * address (MAC address) of the the packet. If l2_hdr is set to 0, buf
72
 
 * points to len bytes of the payload after the layer 2 header and similarly,
73
 
 * TX buffers start with payload. This behavior can be changed by setting
74
 
 * l2_hdr=1 to include the layer 2 header in the data buffer.
75
 
 */
76
 
struct l2_packet_data * l2_packet_init(
77
 
        const char *ifname, const u8 *own_addr, unsigned short protocol,
78
 
        void (*rx_callback)(void *ctx, const u8 *src_addr,
79
 
                            const u8 *buf, size_t len),
80
 
        void *rx_callback_ctx, int l2_hdr);
81
 
 
82
 
/**
83
 
 * l2_packet_deinit - Deinitialize l2_packet interface
84
 
 * @l2: Pointer to internal l2_packet data from l2_packet_init()
85
 
 */
86
 
void l2_packet_deinit(struct l2_packet_data *l2);
87
 
 
88
 
/**
89
 
 * l2_packet_get_own_addr - Get own layer 2 address
90
 
 * @l2: Pointer to internal l2_packet data from l2_packet_init()
91
 
 * @addr: Buffer for the own address (6 bytes)
92
 
 * Returns: 0 on success, -1 on failure
93
 
 */
94
 
int l2_packet_get_own_addr(struct l2_packet_data *l2, u8 *addr);
95
 
 
96
 
/**
97
 
 * l2_packet_send - Send a packet
98
 
 * @l2: Pointer to internal l2_packet data from l2_packet_init()
99
 
 * @dst_addr: Destination address for the packet (only used if l2_hdr == 0)
100
 
 * @proto: Protocol/ethertype for the packet in host byte order (only used if
101
 
 * l2_hdr == 0)
102
 
 * @buf: Packet contents to be sent; including layer 2 header if l2_hdr was
103
 
 * set to 1 in l2_packet_init() call. Otherwise, only the payload of the packet
104
 
 * is included.
105
 
 * @len: Length of the buffer (including l2 header only if l2_hdr == 1)
106
 
 * Returns: >=0 on success, <0 on failure
107
 
 */
108
 
int l2_packet_send(struct l2_packet_data *l2, const u8 *dst_addr, u16 proto,
109
 
                   const u8 *buf, size_t len);
110
 
 
111
 
/**
112
 
 * l2_packet_get_ip_addr - Get the current IP address from the interface
113
 
 * @l2: Pointer to internal l2_packet data from l2_packet_init()
114
 
 * @buf: Buffer for the IP address in text format
115
 
 * @len: Maximum buffer length
116
 
 * Returns: 0 on success, -1 on failure
117
 
 *
118
 
 * This function can be used to get the current IP address from the interface
119
 
 * bound to the l2_packet. This is mainly for status information and the IP
120
 
 * address will be stored as an ASCII string. This function is not essential
121
 
 * for %wpa_supplicant operation, so full implementation is not required.
122
 
 * l2_packet implementation will need to define the function, but it can return
123
 
 * -1 if the IP address information is not available.
124
 
 */
125
 
int l2_packet_get_ip_addr(struct l2_packet_data *l2, char *buf, size_t len);
126
 
 
127
 
 
128
 
/**
129
 
 * l2_packet_notify_auth_start - Notify l2_packet about start of authentication
130
 
 * @l2: Pointer to internal l2_packet data from l2_packet_init()
131
 
 *
132
 
 * This function is called when authentication is expected to start, e.g., when
133
 
 * association has been completed, in order to prepare l2_packet implementation
134
 
 * for EAPOL frames. This function is used mainly if the l2_packet code needs
135
 
 * to do polling in which case it can increasing polling frequency. This can
136
 
 * also be an empty function if the l2_packet implementation does not benefit
137
 
 * from knowing about the starting authentication.
138
 
 */
139
 
void l2_packet_notify_auth_start(struct l2_packet_data *l2);
140
 
 
141
 
#endif /* L2_PACKET_H */