X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Ftransport%2Fplugin_transport_wlan.h;h=926e16e6fec36980ccd87cdac43eb0a864bbebc3;hb=609e4becfe496ed62c2007db18d04fbc8d523476;hp=c870e4d657f9372eeb7cf40c4027707e21facd4d;hpb=3a6ea963dcdb17dd1ef9088d628cb602b437ac1d;p=oweals%2Fgnunet.git diff --git a/src/transport/plugin_transport_wlan.h b/src/transport/plugin_transport_wlan.h index c870e4d65..926e16e6f 100644 --- a/src/transport/plugin_transport_wlan.h +++ b/src/transport/plugin_transport_wlan.h @@ -1,146 +1,287 @@ /* - This file is part of GNUnet - (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors) + This file is part of GNUnet + Copyright (C) 2010, 2011 GNUnet e.V. - GNUnet is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published - by the Free Software Foundation; either version 3, or (at your - option) any later version. + GNUnet is free software: you can redistribute it and/or modify it + under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, + or (at your option) any later version. - GNUnet is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + GNUnet is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Affero General Public License for more details. - You should have received a copy of the GNU General Public License - along with GNUnet; see the file COPYING. If not, write to the - Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. -*/ + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + + SPDX-License-Identifier: AGPL3.0-or-later + */ /** * @file transport/plugin_transport_wlan.h * @brief header for transport plugin and the helper for wlan * @author David Brodski */ +#ifndef PLUGIN_TRANSPORT_WLAN +#define PLUGIN_TRANSPORT_WLAN +#include "gnunet_crypto_lib.h" #include "gnunet_common.h" -typedef unsigned int uint32_t; -typedef unsigned short uint16_t; +/** + * Number fo bytes in a mac address. + */ +#ifdef MINGW + #define MAC_ADDR_SIZE 8 + typedef uint8_t u_int8_t; +#else + #define MAC_ADDR_SIZE 6 +#endif -/* Wlan IEEE80211 header default */ -static const uint8_t u8aIeeeHeader[] = { - 0x08, 0x01, 0x00, 0x00, - 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, - 0x13, 0x22, 0x33, 0x44, 0x55, 0x66, - 0x13, 0x22, 0x33, 0x44, 0x55, 0x66, - 0x10, 0x86, -}; +/** + * Value for "Management" in the 'frame_control' field of the + * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame. + */ +#define IEEE80211_FC0_TYPE_MGT 0x00 + +/** + * Value for "Control" in the 'frame_control' field of the + * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame. + */ +#define IEEE80211_FC0_TYPE_CTL 0x04 /** - * Wlan header + * Value for DATA in the 'frame_control' field of the + * struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame. */ +#define IEEE80211_FC0_TYPE_DATA 0x08 -struct IeeeHeader + +GNUNET_NETWORK_STRUCT_BEGIN + +/** + * A MAC Address. + */ +struct GNUNET_TRANSPORT_WLAN_MacAddress { - /** - * Wlan flags - */ - uint8_t flags[4] GNUNET_PACKED; - - /** - * first mac - */ - uint8_t mac1[6] GNUNET_PACKED; - - /** - * second mac - */ - uint8_t mac2[6] GNUNET_PACKED; - - /** - * third mac - */ - uint8_t mac3[6] GNUNET_PACKED; - - /** - * Wlan flags2 - */ - uint8_t flags2[2] GNUNET_PACKED; + uint8_t mac[MAC_ADDR_SIZE]; }; -/* this is the template radiotap header we send packets out with */ +/** + * Format of a WLAN Control Message. + */ +struct GNUNET_TRANSPORT_WLAN_HelperControlMessage +{ + /** + * Message header. Type is + * GNUNET_MESSAGE_TYPE_WLAN_HELPER_CONTROL + */ + struct GNUNET_MessageHeader hdr; -static const uint8_t u8aRadiotapHeader[] = { + /** + * MAC Address of the local WLAN interface. + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress mac; +}; - 0x00, 0x00, // <-- radiotap version - 0x19, 0x00, // <- radiotap header length - 0x6f, 0x08, 0x00, 0x00, // <-- bitmap - 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // <-- timestamp - 0x00, // <-- flags (Offset +0x10) - 0x6c, // <-- rate (0ffset +0x11) - 0x71, 0x09, 0xc0, 0x00, // <-- channel - 0xde, // <-- antsignal - 0x00, // <-- antnoise - 0x01, // <-- antenna +/** + * generic definitions for IEEE 802.3 frames + */ +struct GNUNET_TRANSPORT_WLAN_Ieee8023Frame +{ + + /** + * Address 1: destination address in ad-hoc mode or AP, BSSID if station, + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress dst; + + /** + * Address 2: source address if in ad-hoc-mode or station, BSSID if AP + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress src; + + /** + * Packet type ID. + */ + uint16_t type; }; + /** - * Radiotap Header + * generic definitions for IEEE 802.11 frames */ +struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame +{ + /** + * 802.11 Frame Control field. A bitmask. The overall field is a + * 16-bit mask of the respecitve fields. The lowest two bits should + * be 0, then comes the "type" (2 bits, see IEEE80211_FC0_TYPE_* + * constants), followed by 4-bit subtype (all zeros for ad-hoc), + * followed by various flags (to DS, from DS, more frag, retry, + * power management, more data, WEP, strict), all of which we also + * keep at zero. + */ + uint16_t frame_control GNUNET_PACKED; + + /** + * Microseconds to reserve link (duration), 0 by default + */ + uint16_t duration GNUNET_PACKED; + + /** + * Address 1: destination address in ad-hoc mode or AP, BSSID if station, + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr1; -struct RadiotapHeader + /** + * Address 2: source address if in ad-hoc-mode or station, BSSID if AP + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr2; + + /** + * Address 3: BSSID in ad-hoc mode, Destination if station, source if AP + */ + struct GNUNET_TRANSPORT_WLAN_MacAddress addr3; + + /** + * 802.11 sequence control field; contains fragment number an sequence + * number (we set this to all zeros). + */ + uint16_t sequence_control GNUNET_PACKED; + + /** + * Link layer control (LLC). Set to a GNUnet-specific value. + */ + u_int8_t llc[4]; + + /* payload */ + +} GNUNET_PACKED; + + + +/** + * Message from the plugin to the WLAN helper: send the given message with the + * given connection parameters. + */ +struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage +{ + + /** + * Type is 'GNUNET_MESSAGE_TYPE_WLAN_DATA_TO_HELPER'. + */ + struct GNUNET_MessageHeader header; + + /** + * wlan send rate + */ + uint8_t rate; + + /** + * Antenna; the first antenna is 0. + */ + uint8_t antenna; + + /** + * Transmit power expressed as unitless distance from max power set at factory calibration. + * 0 is max power. Monotonically nondecreasing with lower power levels. + */ + uint16_t tx_power GNUNET_PACKED; + + /** + * IEEE Frame to transmit (the sender MAC address will be overwritten by the helper as it does not + * trust the plugin to set it correctly). + */ + struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame frame; + + /* actual payload follows */ +}; + + +/** + * Message from the WLAN helper to the plugin: we have received the given message with the + * given performance characteristics. + */ +/** + * struct to represent infos gathered form the radiotap fields, see RadiotapHeader for more Infos + */ +struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage { - /** - * radiotap version - */ - uint8_t version[2] GNUNET_PACKED; - - /** - * radiotap header length - */ - uint8_t lenght[2] GNUNET_PACKED; - - /** - * bitmap - */ - uint8_t bitmap[4] GNUNET_PACKED; - - /** - * timestamp - */ - uint8_t timestamp[8] GNUNET_PACKED; - - /** - * radiotap flags - */ - uint8_t flags GNUNET_PACKED; - - /** - * wlan send rate - */ - uint8_t rate GNUNET_PACKED; - - /** - * Wlan channel - */ - uint8_t channel[4] GNUNET_PACKED; - - /** - * antsignal - */ - uint8_t antsignal GNUNET_PACKED; - - /** - * antnoise - */ - uint8_t antnoise GNUNET_PACKED; - - /** - * antenna - */ - uint8_t antenna GNUNET_PACKED; + + /** + * Type is 'GNUNET_MESSAGE_TYPE_WLAN_DATA_FROM_HELPER'. + */ + struct GNUNET_MessageHeader header; + + /** + * Information about which of the fields below are actually valid. + * 0 for none. FIXME: not properly initialized so far (always zero). + */ + uint32_t ri_present GNUNET_PACKED; + + /** + * IEEE80211_RADIOTAP_TSFT, 0 if unknown. + */ + uint64_t ri_mactime GNUNET_PACKED; + + /** + * from radiotap + * either IEEE80211_RADIOTAP_DBM_ANTSIGNAL + * or IEEE80211_RADIOTAP_DB_ANTSIGNAL, 0 if unknown. + */ + int32_t ri_power GNUNET_PACKED; + + /** + * either IEEE80211_RADIOTAP_DBM_ANTNOISE + * or IEEE80211_RADIOTAP_DB_ANTNOISE, 0 if unknown. + */ + int32_t ri_noise GNUNET_PACKED; + + /** + * IEEE80211_RADIOTAP_CHANNEL, 0 if unknown. + */ + uint32_t ri_channel GNUNET_PACKED; + + /** + * Frequency we use. 0 if unknown. + */ + uint32_t ri_freq GNUNET_PACKED; + + /** + * IEEE80211_RADIOTAP_RATE * 50000, 0 if unknown. + */ + uint32_t ri_rate GNUNET_PACKED; + + /** + * IEEE80211_RADIOTAP_ANTENNA, 0 if unknown. + */ + uint32_t ri_antenna GNUNET_PACKED; + + /** + * IEEE Frame. + */ + struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame frame; + + /* followed by payload */ +}; + +GNUNET_NETWORK_STRUCT_END + +/** + * GNUnet bssid + */ +static const struct GNUNET_TRANSPORT_WLAN_MacAddress mac_bssid_gnunet = { + {0x13, 0x22, 0x33, 0x44, 0x55, 0x66} +}; + + +/** + * Broadcast MAC + */ +static const struct GNUNET_TRANSPORT_WLAN_MacAddress bc_all_mac = { + {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF} }; +#endif