2 This file is part of GNUnet
3 (C) 2010, 2011, 2012 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file transport/plugin_transport_wlan.c
23 * @brief transport plugin for wlan
24 * @author David Brodski
25 * @author Christian Grothoff
28 #include "gnunet_hello_lib.h"
29 #include "gnunet_protocols.h"
30 #include "gnunet_util_lib.h"
31 #include "gnunet_statistics_service.h"
32 #include "gnunet_transport_service.h"
33 #include "gnunet_transport_plugin.h"
34 #include "plugin_transport_wlan.h"
35 #include "gnunet_common.h"
36 #include "gnunet_crypto_lib.h"
37 #include "gnunet_fragmentation_lib.h"
38 #include "gnunet_constants.h"
40 #define LOG(kind,...) GNUNET_log_from (kind, "transport-wlan",__VA_ARGS__)
43 * Max size of packet (that we give to the WLAN driver for transmission)
48 * time out of a mac endpoint
50 #define MACENDPOINT_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, 2)
53 * We reduce the frequence of HELLO beacons in relation to
54 * the number of MAC addresses currently visible to us.
55 * This is the multiplication factor.
57 #define HELLO_BEACON_SCALING_FACTOR GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 2)
60 * Maximum number of messages in defragmentation queue per MAC
62 #define MESSAGES_IN_DEFRAG_QUEUE_PER_MAC 2
65 * Link layer control fields for better compatibility
66 * (i.e. GNUnet over WLAN is not IP-over-WLAN).
68 #define WLAN_LLC_DSAP_FIELD 0x1f
69 #define WLAN_LLC_SSAP_FIELD 0x1f
72 GNUNET_NETWORK_STRUCT_BEGIN
74 * Header for messages which need fragmentation. This is the format of
75 * a message we obtain AFTER defragmentation. We then need to check
76 * the CRC and then tokenize the payload and pass it to the
83 * Message type is GNUNET_MESSAGE_TYPE_WLAN_DATA.
85 struct GNUNET_MessageHeader header;
88 * CRC32 checksum (only over the payload), in NBO.
90 uint32_t crc GNUNET_PACKED;
93 * Sender of the message.
95 struct GNUNET_PeerIdentity sender;
98 * Target of the message.
100 struct GNUNET_PeerIdentity target;
102 /* followed by payload, possibly including
103 multiple messages! */
106 GNUNET_NETWORK_STRUCT_END
110 * Information kept for each message that is yet to be fragmented and
113 struct PendingMessage
116 * next entry in the DLL
118 struct PendingMessage *next;
121 * previous entry in the DLL
123 struct PendingMessage *prev;
126 * The pending message
128 struct WlanHeader *msg;
131 * Continuation function to call once the message
132 * has been sent. Can be NULL if there is no
133 * continuation to call.
135 GNUNET_TRANSPORT_TransmitContinuation transmit_cont;
138 * Cls for transmit_cont
140 void *transmit_cont_cls;
143 * Timeout task (for this message).
145 GNUNET_SCHEDULER_TaskIdentifier timeout_task;
151 * Session handle for connections with other peers.
156 * To whom are we talking to (set to our identity
157 * if we are still waiting for the welcome message)
159 struct GNUNET_PeerIdentity target;
162 * API requirement (must be first).
164 struct SessionHeader header;
167 * We keep all sessions in a DLL at their respective
168 * 'struct MACEndpoint'.
170 struct Session *next;
173 * We keep all sessions in a DLL at their respective
174 * 'struct MACEndpoint'.
176 struct Session *prev;
179 * MAC endpoint with the address of this peer.
181 struct MacEndpoint *mac;
184 * Head of messages currently pending for transmission to this peer.
186 struct PendingMessage *pending_message_head;
189 * Tail of messages currently pending for transmission to this peer.
191 struct PendingMessage *pending_message_tail;
194 * When should this session time out?
196 struct GNUNET_TIME_Absolute timeout;
199 * Timeout task (for the session).
201 GNUNET_SCHEDULER_TaskIdentifier timeout_task;
207 * Struct for messages that are being fragmented in a MAC's transmission queue.
209 struct FragmentMessage
213 * This is a doubly-linked list.
215 struct FragmentMessage *next;
218 * This is a doubly-linked list.
220 struct FragmentMessage *prev;
223 * MAC endpoint this message belongs to
225 struct MacEndpoint *macendpoint;
228 * Fragmentation context
230 struct GNUNET_FRAGMENT_Context *fragcontext;
233 * Transmission handle to helper (to cancel if the frag context
234 * is destroyed early for some reason).
236 struct GNUNET_HELPER_SendHandle *sh;
239 * Intended recipient.
241 struct GNUNET_PeerIdentity target;
244 * Timeout value for the message.
246 struct GNUNET_TIME_Absolute timeout;
251 GNUNET_SCHEDULER_TaskIdentifier timeout_task;
254 * Continuation to call when we're done with this message.
256 GNUNET_TRANSPORT_TransmitContinuation cont;
264 * Size of original message
269 * Number of bytes used to transmit message
277 * Struct to represent one network card connection
283 * We keep all MACs in a DLL in the plugin.
285 struct MacEndpoint *next;
288 * We keep all MACs in a DLL in the plugin.
290 struct MacEndpoint *prev;
293 * Pointer to the global plugin struct.
295 struct Plugin *plugin;
298 * Head of sessions that use this MAC.
300 struct Session *sessions_head;
303 * Tail of sessions that use this MAC.
305 struct Session *sessions_tail;
308 * Head of messages we are currently sending to this MAC.
310 struct FragmentMessage *sending_messages_head;
313 * Tail of messages we are currently sending to this MAC.
315 struct FragmentMessage *sending_messages_tail;
318 * Defrag context for this MAC
320 struct GNUNET_DEFRAGMENT_Context *defrag;
323 * When should this endpoint time out?
325 struct GNUNET_TIME_Absolute timeout;
330 GNUNET_SCHEDULER_TaskIdentifier timeout_task;
333 * count of messages in the fragment out queue for this mac endpoint
335 unsigned int fragment_messages_out_count;
340 struct GNUNET_TRANSPORT_WLAN_MacAddress addr;
343 * Message delay for fragmentation context
345 struct GNUNET_TIME_Relative msg_delay;
348 * ACK delay for fragmentation context
350 struct GNUNET_TIME_Relative ack_delay;
353 * Desired transmission power for this MAC
358 * Desired transmission rate for this MAC
363 * Antenna we should use for this MAC
371 * Encapsulation of all of the state of the plugin.
378 struct GNUNET_TRANSPORT_PluginEnvironment *env;
381 * Handle to helper process for priviledged operations.
383 struct GNUNET_HELPER_Handle *suid_helper;
386 * ARGV-vector for the helper (all helpers take only the binary
387 * name, one actual argument, plus the NULL terminator for 'argv').
389 char * helper_argv[3];
392 * The interface of the wlan card given to us by the user.
397 * Tokenizer for demultiplexing of data packets resulting from defragmentation.
399 struct GNUNET_SERVER_MessageStreamTokenizer *fragment_data_tokenizer;
402 * Tokenizer for demultiplexing of data packets received from the suid helper
404 struct GNUNET_SERVER_MessageStreamTokenizer *helper_payload_tokenizer;
407 * Tokenizer for demultiplexing of data packets that follow the WLAN Header
409 struct GNUNET_SERVER_MessageStreamTokenizer *wlan_header_payload_tokenizer;
412 * Head of list of open connections.
414 struct MacEndpoint *mac_head;
417 * Tail of list of open connections.
419 struct MacEndpoint *mac_tail;
422 * Number of connections
424 unsigned int mac_count;
427 * Task that periodically sends a HELLO beacon via the helper.
429 GNUNET_SCHEDULER_TaskIdentifier beacon_task;
432 * Tracker for bandwidth limit
434 struct GNUNET_BANDWIDTH_Tracker tracker;
437 * The mac_address of the wlan card given to us by the helper.
439 struct GNUNET_TRANSPORT_WLAN_MacAddress mac_address;
442 * Have we received a control message with our MAC address yet?
451 * Information associated with a message. Can contain
452 * the session or the MAC endpoint associated with the
458 * NULL if the identity of the other peer is not known.
460 struct Session *session;
463 * MAC address of the other peer, NULL if not known.
465 struct MacEndpoint *endpoint;
470 * Print MAC addresses nicely.
472 * @param mac the mac address
473 * @return string to a static buffer with the human-readable mac, will be overwritten during the next call to this function
476 mac_to_string (const struct GNUNET_TRANSPORT_WLAN_MacAddress * mac)
478 static char macstr[20];
480 GNUNET_snprintf (macstr, sizeof (macstr), "%.2X:%.2X:%.2X:%.2X:%.2X:%.2X", mac->mac[0], mac->mac[1],
481 mac->mac[2], mac->mac[3], mac->mac[4], mac->mac[5]);
487 * Fill the radiotap header
489 * @param endpoint pointer to the endpoint, can be NULL
490 * @param header pointer to the radiotap header
491 * @param size total message size
494 get_radiotap_header (struct MacEndpoint *endpoint,
495 struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *header,
498 header->header.type = ntohs (GNUNET_MESSAGE_TYPE_WLAN_DATA_TO_HELPER);
499 header->header.size = ntohs (size);
500 if (NULL != endpoint)
502 header->rate = endpoint->rate;
503 header->tx_power = endpoint->tx_power;
504 header->antenna = endpoint->antenna;
509 header->tx_power = 0;
516 * Generate the WLAN hardware header for one packet
518 * @param plugin the plugin handle
519 * @param header address to write the header to
520 * @param to_mac_addr address of the recipient
521 * @param size size of the whole packet, needed to calculate the time to send the packet
524 get_wlan_header (struct Plugin *plugin,
525 struct GNUNET_TRANSPORT_WLAN_Ieee80211Frame *header,
526 const struct GNUNET_TRANSPORT_WLAN_MacAddress *to_mac_addr,
529 const int rate = 11000000;
531 header->frame_control = htons (IEEE80211_FC0_TYPE_DATA);
532 header->addr1 = *to_mac_addr;
533 header->addr2 = plugin->mac_address;
534 header->addr3 = mac_bssid_gnunet;
535 header->duration = GNUNET_htole16 ((size * 1000000) / rate + 290);
536 header->sequence_control = 0; // FIXME?
537 header->llc[0] = WLAN_LLC_DSAP_FIELD;
538 header->llc[1] = WLAN_LLC_SSAP_FIELD;
539 header->llc[2] = 0; // FIXME?
540 header->llc[3] = 0; // FIXME?
545 * Send an ACK for a fragment we received.
547 * @param cls the 'struct MacEndpoint' the ACK must be sent to
548 * @param msg_id id of the message
549 * @param hdr pointer to the hdr where the ack is stored
552 send_ack (void *cls, uint32_t msg_id,
553 const struct GNUNET_MessageHeader *hdr)
555 struct MacEndpoint *endpoint = cls;
556 struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage* radio_header;
557 uint16_t msize = ntohs (hdr->size);
558 size_t size = sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage) + msize;
561 if (size >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
566 LOG (GNUNET_ERROR_TYPE_DEBUG,
567 "Sending ACK to helper\n");
568 radio_header = (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *) buf;
569 get_radiotap_header (endpoint, radio_header, size);
570 get_wlan_header (endpoint->plugin,
571 &radio_header->frame,
574 memcpy (&radio_header[1], hdr, msize);
576 GNUNET_HELPER_send (endpoint->plugin->suid_helper,
577 &radio_header->header,
578 GNUNET_NO /* dropping ACKs is bad */,
580 GNUNET_STATISTICS_update (endpoint->plugin->env->stats, _("# WLAN ACKs sent"),
586 * Handles the data after all fragments are put together
588 * @param cls macendpoint this messages belongs to
589 * @param hdr pointer to the data
592 wlan_data_message_handler (void *cls, const struct GNUNET_MessageHeader *hdr)
594 struct MacEndpoint *endpoint = cls;
595 struct Plugin *plugin = endpoint->plugin;
596 struct MacAndSession mas;
598 GNUNET_STATISTICS_update (plugin->env->stats,
599 _("# WLAN messages defragmented"), 1,
602 mas.endpoint = endpoint;
603 (void) GNUNET_SERVER_mst_receive (plugin->fragment_data_tokenizer,
607 GNUNET_YES, GNUNET_NO);
614 * @param session the session free
617 free_session (struct Session *session)
619 struct MacEndpoint *endpoint = session->mac;
620 struct PendingMessage *pm;
622 endpoint->plugin->env->session_end (endpoint->plugin->env->cls,
625 while (NULL != (pm = session->pending_message_head))
627 GNUNET_CONTAINER_DLL_remove (session->pending_message_head,
628 session->pending_message_tail, pm);
629 if (GNUNET_SCHEDULER_NO_TASK != pm->timeout_task)
631 GNUNET_SCHEDULER_cancel (pm->timeout_task);
632 pm->timeout_task = GNUNET_SCHEDULER_NO_TASK;
634 GNUNET_free (pm->msg);
637 GNUNET_CONTAINER_DLL_remove (endpoint->sessions_head,
638 endpoint->sessions_tail,
640 if (session->timeout_task != GNUNET_SCHEDULER_NO_TASK)
642 GNUNET_SCHEDULER_cancel (session->timeout_task);
643 session->timeout_task = GNUNET_SCHEDULER_NO_TASK;
645 GNUNET_STATISTICS_update (endpoint->plugin->env->stats, _("# WLAN sessions allocated"), -1,
647 GNUNET_free (session);
652 * A session is timing out. Clean up.
654 * @param cls pointer to the Session
655 * @param tc pointer to the GNUNET_SCHEDULER_TaskContext
658 session_timeout (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
660 struct Session * session = cls;
661 struct GNUNET_TIME_Relative timeout;
663 session->timeout_task = GNUNET_SCHEDULER_NO_TASK;
664 timeout = GNUNET_TIME_absolute_get_remaining (session->timeout);
665 if (0 == timeout.rel_value)
667 free_session (session);
670 session->timeout_task =
671 GNUNET_SCHEDULER_add_delayed (timeout, &session_timeout, session);
676 * Create a new session
678 * @param endpoint pointer to the mac endpoint of the peer
679 * @param peer peer identity to use for this session
680 * @return returns the session
682 static struct Session *
683 create_session (struct MacEndpoint *endpoint,
684 const struct GNUNET_PeerIdentity *peer)
686 struct Session *session;
688 for (session = endpoint->sessions_head; NULL != session; session = session->next)
689 if (0 == memcmp (peer, &session->target,
690 sizeof (struct GNUNET_PeerIdentity)))
692 session->timeout = GNUNET_TIME_relative_to_absolute (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT);
695 GNUNET_STATISTICS_update (endpoint->plugin->env->stats, _("# WLAN sessions allocated"), 1,
697 session = GNUNET_malloc (sizeof (struct Session));
698 GNUNET_CONTAINER_DLL_insert_tail (endpoint->sessions_head,
699 endpoint->sessions_tail,
701 session->mac = endpoint;
702 session->target = *peer;
703 session->timeout = GNUNET_TIME_relative_to_absolute (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT);
704 session->timeout_task =
705 GNUNET_SCHEDULER_add_delayed (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, &session_timeout, session);
706 LOG (GNUNET_ERROR_TYPE_DEBUG,
707 "Created new session for peer `%s' with endpoint %s\n",
709 mac_to_string (&endpoint->addr));
715 * Function called once we have successfully given the fragment
716 * message to the SUID helper process and we are thus ready for
719 * @param cls the 'struct FragmentMessage'
720 * @param result result of the operation (GNUNET_OK on success, GNUNET_NO if the helper died, GNUNET_SYSERR
721 * if the helper was stopped)
724 fragment_transmission_done (void *cls,
727 struct FragmentMessage *fm = cls;
731 GNUNET_FRAGMENT_context_transmission_done (fm->fragcontext);
736 * Transmit a fragment of a message.
738 * @param cls 'struct FragmentMessage' this fragment message belongs to
739 * @param hdr pointer to the start of the fragment message
742 transmit_fragment (void *cls,
743 const struct GNUNET_MessageHeader *hdr)
745 struct FragmentMessage *fm = cls;
746 struct MacEndpoint *endpoint = fm->macendpoint;
750 msize = ntohs (hdr->size);
751 size = sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage) + msize;
754 struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *radio_header;
756 radio_header = (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *) buf;
757 get_radiotap_header (endpoint, radio_header, size);
758 get_wlan_header (endpoint->plugin,
759 &radio_header->frame,
762 memcpy (&radio_header[1], hdr, msize);
763 GNUNET_assert (NULL == fm->sh);
764 fm->sh = GNUNET_HELPER_send (endpoint->plugin->suid_helper,
765 &radio_header->header,
767 &fragment_transmission_done, fm);
768 fm->size_on_wire += size;
770 GNUNET_STATISTICS_update (endpoint->plugin->env->stats, _("# WLAN message fragments sent"),
773 GNUNET_FRAGMENT_context_transmission_done (fm->fragcontext);
774 GNUNET_STATISTICS_update (endpoint->plugin->env->stats,
775 "# bytes currently in WLAN buffers",
777 GNUNET_STATISTICS_update (endpoint->plugin->env->stats,
778 "# bytes transmitted via WLAN",
785 * Frees the space of a message in the fragment queue (send queue)
787 * @param fm message to free
790 free_fragment_message (struct FragmentMessage *fm)
792 struct MacEndpoint *endpoint = fm->macendpoint;
794 GNUNET_STATISTICS_update (endpoint->plugin->env->stats, _("# WLAN messages pending (with fragmentation)"),
796 GNUNET_CONTAINER_DLL_remove (endpoint->sending_messages_head,
797 endpoint->sending_messages_tail, fm);
800 GNUNET_HELPER_send_cancel (fm->sh);
803 GNUNET_FRAGMENT_context_destroy (fm->fragcontext,
804 &endpoint->msg_delay,
805 &endpoint->ack_delay);
806 if (fm->timeout_task != GNUNET_SCHEDULER_NO_TASK)
808 GNUNET_SCHEDULER_cancel (fm->timeout_task);
809 fm->timeout_task = GNUNET_SCHEDULER_NO_TASK;
816 * A FragmentMessage has timed out. Remove it.
818 * @param cls pointer to the 'struct FragmentMessage'
819 * @param tc pointer to the GNUNET_SCHEDULER_TaskContext
822 fragmentmessage_timeout (void *cls,
823 const struct GNUNET_SCHEDULER_TaskContext *tc)
825 struct FragmentMessage *fm = cls;
827 fm->timeout_task = GNUNET_SCHEDULER_NO_TASK;
828 if (NULL != fm->cont)
830 fm->cont (fm->cont_cls, &fm->target, GNUNET_SYSERR, fm->size_payload, fm->size_on_wire);
833 free_fragment_message (fm);
838 * Transmit a message to the given destination with fragmentation.
840 * @param endpoint desired destination
841 * @param timeout how long can the message wait?
842 * @param target peer that should receive the message
843 * @param msg message to transmit
844 * @param payload_size bytes of payload
845 * @param cont continuation to call once the message has
846 * been transmitted (or if the transport is ready
847 * for the next transmission call; or if the
848 * peer disconnected...); can be NULL
849 * @param cont_cls closure for cont
852 send_with_fragmentation (struct MacEndpoint *endpoint,
853 struct GNUNET_TIME_Relative timeout,
854 const struct GNUNET_PeerIdentity *target,
855 const struct GNUNET_MessageHeader *msg,
857 GNUNET_TRANSPORT_TransmitContinuation cont, void *cont_cls)
860 struct FragmentMessage *fm;
861 struct Plugin *plugin;
863 plugin = endpoint->plugin;
864 fm = GNUNET_malloc (sizeof (struct FragmentMessage));
865 fm->macendpoint = endpoint;
866 fm->target = *target;
867 fm->size_payload = payload_size;
868 fm->size_on_wire = 0;
869 fm->timeout = GNUNET_TIME_relative_to_absolute (timeout);
871 fm->cont_cls = cont_cls;
872 /* 1 MBit/s typical data rate, 1430 byte fragments => ~100 ms per message */
874 GNUNET_FRAGMENT_context_create (plugin->env->stats, WLAN_MTU,
879 &transmit_fragment, fm);
881 GNUNET_SCHEDULER_add_delayed (timeout,
882 &fragmentmessage_timeout, fm);
883 GNUNET_CONTAINER_DLL_insert_tail (endpoint->sending_messages_head,
884 endpoint->sending_messages_tail,
890 * Free a MAC endpoint.
892 * @param endpoint pointer to the MacEndpoint to free
895 free_macendpoint (struct MacEndpoint *endpoint)
897 struct Plugin *plugin = endpoint->plugin;
898 struct FragmentMessage *fm;
899 struct Session *session;
901 GNUNET_STATISTICS_update (plugin->env->stats,
902 _("# WLAN MAC endpoints allocated"), -1, GNUNET_NO);
903 while (NULL != (session = endpoint->sessions_head))
904 free_session (session);
905 while (NULL != (fm = endpoint->sending_messages_head))
906 free_fragment_message (fm);
907 GNUNET_CONTAINER_DLL_remove (plugin->mac_head,
911 if (NULL != endpoint->defrag)
913 GNUNET_DEFRAGMENT_context_destroy(endpoint->defrag);
914 endpoint->defrag = NULL;
918 if (GNUNET_SCHEDULER_NO_TASK != endpoint->timeout_task)
920 GNUNET_SCHEDULER_cancel (endpoint->timeout_task);
921 endpoint->timeout_task = GNUNET_SCHEDULER_NO_TASK;
923 GNUNET_free (endpoint);
928 * A MAC endpoint is timing out. Clean up.
930 * @param cls pointer to the MacEndpoint
931 * @param tc pointer to the GNUNET_SCHEDULER_TaskContext
934 macendpoint_timeout (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
936 struct MacEndpoint *endpoint = cls;
937 struct GNUNET_TIME_Relative timeout;
939 endpoint->timeout_task = GNUNET_SCHEDULER_NO_TASK;
940 timeout = GNUNET_TIME_absolute_get_remaining (endpoint->timeout);
941 if (0 == timeout.rel_value)
943 free_macendpoint (endpoint);
946 endpoint->timeout_task =
947 GNUNET_SCHEDULER_add_delayed (timeout, &macendpoint_timeout,
953 * Find (or create) a MacEndpoint with a specific MAC address
955 * @param plugin pointer to the plugin struct
956 * @param addr the MAC address of the endpoint
957 * @return handle to our data structure for this MAC
959 static struct MacEndpoint *
960 create_macendpoint (struct Plugin *plugin,
961 const struct GNUNET_TRANSPORT_WLAN_MacAddress *addr)
963 struct MacEndpoint *pos;
965 for (pos = plugin->mac_head; NULL != pos; pos = pos->next)
966 if (0 == memcmp (addr, &pos->addr, sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
968 pos = GNUNET_malloc (sizeof (struct MacEndpoint));
970 pos->plugin = plugin;
972 GNUNET_DEFRAGMENT_context_create (plugin->env->stats, WLAN_MTU,
973 MESSAGES_IN_DEFRAG_QUEUE_PER_MAC,
975 &wlan_data_message_handler,
978 pos->msg_delay = GNUNET_TIME_UNIT_MILLISECONDS;
979 pos->ack_delay = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS,
981 pos->timeout = GNUNET_TIME_relative_to_absolute (MACENDPOINT_TIMEOUT);
983 GNUNET_SCHEDULER_add_delayed (MACENDPOINT_TIMEOUT, &macendpoint_timeout,
985 GNUNET_CONTAINER_DLL_insert (plugin->mac_head, plugin->mac_tail, pos);
987 GNUNET_STATISTICS_update (plugin->env->stats, _("# WLAN MAC endpoints allocated"),
989 LOG (GNUNET_ERROR_TYPE_DEBUG,
990 "New MAC endpoint `%s'\n",
991 mac_to_string (addr));
997 * Creates a new outbound session the transport service will use to send data to the
1000 * @param cls the plugin
1001 * @param address the address
1002 * @return the session or NULL of max connections exceeded
1004 static struct Session *
1005 wlan_plugin_get_session (void *cls,
1006 const struct GNUNET_HELLO_Address *address)
1008 struct Plugin *plugin = cls;
1009 struct MacEndpoint *endpoint;
1011 if (NULL == address)
1013 if (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress) != address->address_length)
1018 LOG (GNUNET_ERROR_TYPE_DEBUG,
1019 "Service asked to create session for peer `%s' with MAC `%s'\n",
1020 GNUNET_i2s (&address->peer),
1021 mac_to_string (address->address));
1022 endpoint = create_macendpoint (plugin, address->address);
1023 return create_session (endpoint, &address->peer);
1028 * Function that can be used to force the plugin to disconnect
1029 * from the given peer and cancel all previous transmissions
1030 * (and their continuation).
1032 * @param cls closure
1033 * @param target peer from which to disconnect
1036 wlan_plugin_disconnect (void *cls, const struct GNUNET_PeerIdentity *target)
1038 struct Plugin *plugin = cls;
1039 struct Session *session;
1040 struct MacEndpoint *endpoint;
1042 for (endpoint = plugin->mac_head; NULL != endpoint; endpoint = endpoint->next)
1043 for (session = endpoint->sessions_head; NULL != session; session = session->next)
1044 if (0 == memcmp (target, &session->target,
1045 sizeof (struct GNUNET_PeerIdentity)))
1047 free_session (session);
1048 break; /* inner-loop only (in case peer has another MAC as well!) */
1054 * Function that can be used by the transport service to transmit
1055 * a message using the plugin. Note that in the case of a
1056 * peer disconnecting, the continuation MUST be called
1057 * prior to the disconnect notification itself. This function
1058 * will be called with this peer's HELLO message to initiate
1059 * a fresh connection to another peer.
1061 * @param cls closure
1062 * @param session which session must be used
1063 * @param msgbuf the message to transmit
1064 * @param msgbuf_size number of bytes in 'msgbuf'
1065 * @param priority how important is the message (most plugins will
1066 * ignore message priority and just FIFO)
1067 * @param to how long to wait at most for the transmission (does not
1068 * require plugins to discard the message after the timeout,
1069 * just advisory for the desired delay; most plugins will ignore
1071 * @param cont continuation to call once the message has
1072 * been transmitted (or if the transport is ready
1073 * for the next transmission call; or if the
1074 * peer disconnected...); can be NULL
1075 * @param cont_cls closure for cont
1076 * @return number of bytes used (on the physical network, with overheads);
1077 * -1 on hard errors (i.e. address invalid); 0 is a legal value
1078 * and does NOT mean that the message was not transmitted (DV)
1081 wlan_plugin_send (void *cls,
1082 struct Session *session,
1083 const char *msgbuf, size_t msgbuf_size,
1084 unsigned int priority,
1085 struct GNUNET_TIME_Relative to,
1086 GNUNET_TRANSPORT_TransmitContinuation cont, void *cont_cls)
1088 struct Plugin *plugin = cls;
1089 struct WlanHeader *wlanheader;
1090 size_t size = msgbuf_size + sizeof (struct WlanHeader);
1091 char buf[size] GNUNET_ALIGN;
1093 LOG (GNUNET_ERROR_TYPE_DEBUG,
1094 "Transmitting %u bytes of payload to peer `%s' (starting with %u byte message of type %u)\n",
1096 GNUNET_i2s (&session->target),
1097 (unsigned int) ntohs (((struct GNUNET_MessageHeader*)msgbuf)->size),
1098 (unsigned int) ntohs (((struct GNUNET_MessageHeader*)msgbuf)->type));
1099 wlanheader = (struct WlanHeader *) buf;
1100 wlanheader->header.size = htons (msgbuf_size + sizeof (struct WlanHeader));
1101 wlanheader->header.type = htons (GNUNET_MESSAGE_TYPE_WLAN_DATA);
1102 wlanheader->sender = *plugin->env->my_identity;
1103 wlanheader->target = session->target;
1104 wlanheader->crc = htonl (GNUNET_CRYPTO_crc32_n (msgbuf, msgbuf_size));
1105 memcpy (&wlanheader[1], msgbuf, msgbuf_size);
1107 GNUNET_STATISTICS_update (plugin->env->stats,
1108 "# bytes currently in WLAN buffers",
1109 msgbuf_size, GNUNET_NO);
1111 send_with_fragmentation (session->mac,
1114 &wlanheader->header,
1122 * We have received data from the WLAN via some session. Process depending
1123 * on the message type (HELLO, DATA, FRAGMENTATION or FRAGMENTATION-ACK).
1125 * @param cls pointer to the plugin
1126 * @param client pointer to the session this message belongs to
1127 * @param hdr start of the message
1130 process_data (void *cls, void *client, const struct GNUNET_MessageHeader *hdr)
1132 struct Plugin *plugin = cls;
1133 struct MacAndSession *mas = client;
1134 struct MacAndSession xmas;
1136 struct GNUNET_ATS_Information ats[NUM_ATS]; /* FIXME: do better here */
1137 struct FragmentMessage *fm;
1138 struct GNUNET_PeerIdentity tmpsource;
1139 const struct WlanHeader *wlanheader;
1143 ats[0].type = htonl (GNUNET_ATS_QUALITY_NET_DISTANCE);
1144 ats[0].value = htonl (1);
1145 ats[1].type = htonl (GNUNET_ATS_NETWORK_TYPE);
1146 ats[1].value = htonl (GNUNET_ATS_NET_WLAN);
1147 msize = ntohs (hdr->size);
1149 GNUNET_STATISTICS_update (plugin->env->stats,
1150 "# bytes received via WLAN",
1153 switch (ntohs (hdr->type))
1155 case GNUNET_MESSAGE_TYPE_HELLO:
1157 GNUNET_HELLO_get_id ((const struct GNUNET_HELLO_Message *) hdr, &tmpsource))
1159 GNUNET_break_op (0);
1162 LOG (GNUNET_ERROR_TYPE_DEBUG,
1163 "Processing %u bytes of HELLO from peer `%s' at MAC %s\n",
1164 (unsigned int) msize,
1165 GNUNET_i2s (&tmpsource),
1166 mac_to_string (&mas->endpoint->addr));
1168 GNUNET_STATISTICS_update (plugin->env->stats,
1169 _("# HELLO messages received via WLAN"), 1,
1171 plugin->env->receive (plugin->env->cls,
1175 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1176 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1177 plugin->env->update_address_metrics (plugin->env->cls,
1179 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1180 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1182 (struct GNUNET_ATS_Information *) &ats, NUM_ATS);
1184 case GNUNET_MESSAGE_TYPE_FRAGMENT:
1185 if (NULL == mas->endpoint)
1190 LOG (GNUNET_ERROR_TYPE_DEBUG,
1191 "Processing %u bytes of FRAGMENT from MAC %s\n",
1192 (unsigned int) msize,
1193 mac_to_string (&mas->endpoint->addr));
1194 GNUNET_STATISTICS_update (plugin->env->stats,
1195 _("# fragments received via WLAN"), 1, GNUNET_NO);
1196 (void) GNUNET_DEFRAGMENT_process_fragment (mas->endpoint->defrag,
1199 case GNUNET_MESSAGE_TYPE_FRAGMENT_ACK:
1200 if (NULL == mas->endpoint)
1205 GNUNET_STATISTICS_update (plugin->env->stats, _("# ACKs received via WLAN"),
1207 for (fm = mas->endpoint->sending_messages_head; NULL != fm; fm = fm->next)
1209 ret = GNUNET_FRAGMENT_process_ack (fm->fragcontext, hdr);
1210 if (GNUNET_OK == ret)
1212 LOG (GNUNET_ERROR_TYPE_DEBUG,
1213 "Got last ACK, finished message transmission to `%s' (%p)\n",
1214 mac_to_string (&mas->endpoint->addr),
1216 mas->endpoint->timeout = GNUNET_TIME_relative_to_absolute (MACENDPOINT_TIMEOUT);
1217 if (NULL != fm->cont)
1219 fm->cont (fm->cont_cls, &fm->target, GNUNET_OK, fm->size_payload, fm->size_on_wire);
1222 free_fragment_message (fm);
1225 if (GNUNET_NO == ret)
1227 LOG (GNUNET_ERROR_TYPE_DEBUG,
1228 "Got an ACK, message transmission to `%s' not yet finished\n",
1229 mac_to_string (&mas->endpoint->addr));
1233 LOG (GNUNET_ERROR_TYPE_DEBUG,
1234 "ACK not matched against any active fragmentation with MAC `%s'\n",
1235 mac_to_string (&mas->endpoint->addr));
1237 case GNUNET_MESSAGE_TYPE_WLAN_DATA:
1238 if (NULL == mas->endpoint)
1243 if (msize < sizeof (struct WlanHeader))
1248 wlanheader = (const struct WlanHeader *) hdr;
1249 if (0 != memcmp (&wlanheader->target,
1250 plugin->env->my_identity,
1251 sizeof (struct GNUNET_PeerIdentity)))
1253 LOG (GNUNET_ERROR_TYPE_DEBUG,
1254 "WLAN data for `%s', not for me, ignoring\n",
1255 GNUNET_i2s (&wlanheader->target));
1258 if (ntohl (wlanheader->crc) !=
1259 GNUNET_CRYPTO_crc32_n (&wlanheader[1], msize - sizeof (struct WlanHeader)))
1261 GNUNET_STATISTICS_update (plugin->env->stats,
1262 _("# WLAN DATA messages discarded due to CRC32 error"), 1,
1266 xmas.endpoint = mas->endpoint;
1267 xmas.session = create_session (mas->endpoint, &wlanheader->sender);
1268 LOG (GNUNET_ERROR_TYPE_DEBUG,
1269 "Processing %u bytes of WLAN DATA from peer `%s'\n",
1270 (unsigned int) msize,
1271 GNUNET_i2s (&wlanheader->sender));
1272 (void) GNUNET_SERVER_mst_receive (plugin->wlan_header_payload_tokenizer,
1274 (const char *) &wlanheader[1],
1275 msize - sizeof (struct WlanHeader),
1276 GNUNET_YES, GNUNET_NO);
1279 if (NULL == mas->endpoint)
1284 if (NULL == mas->session)
1289 LOG (GNUNET_ERROR_TYPE_DEBUG,
1290 "Received packet with %u bytes of type %u from peer %s\n",
1291 (unsigned int) msize,
1292 (unsigned int) ntohs (hdr->type),
1293 GNUNET_i2s (&mas->session->target));
1294 plugin->env->receive (plugin->env->cls,
1295 &mas->session->target,
1298 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1299 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1300 plugin->env->update_address_metrics (plugin->env->cls,
1301 &mas->session->target,
1302 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1303 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1305 (struct GNUNET_ATS_Information *) &ats, NUM_ATS);
1314 * Function used for to process the data from the suid process
1316 * @param cls the plugin handle
1317 * @param client client that send the data (not used)
1318 * @param hdr header of the GNUNET_MessageHeader
1321 handle_helper_message (void *cls, void *client,
1322 const struct GNUNET_MessageHeader *hdr)
1324 struct Plugin *plugin = cls;
1325 const struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage *rxinfo;
1326 const struct GNUNET_TRANSPORT_WLAN_HelperControlMessage *cm;
1327 struct MacAndSession mas;
1330 msize = ntohs (hdr->size);
1331 switch (ntohs (hdr->type))
1333 case GNUNET_MESSAGE_TYPE_WLAN_HELPER_CONTROL:
1334 if (msize != sizeof (struct GNUNET_TRANSPORT_WLAN_HelperControlMessage))
1339 cm = (const struct GNUNET_TRANSPORT_WLAN_HelperControlMessage *) hdr;
1340 if (GNUNET_YES == plugin->have_mac)
1342 if (0 == memcmp (&plugin->mac_address,
1344 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1345 break; /* no change */
1346 /* remove old address */
1347 plugin->env->notify_address (plugin->env->cls, GNUNET_NO,
1348 &plugin->mac_address,
1349 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1352 plugin->mac_address = cm->mac;
1353 plugin->have_mac = GNUNET_YES;
1354 LOG (GNUNET_ERROR_TYPE_DEBUG,
1355 "Received WLAN_HELPER_CONTROL message with MAC address `%s' for peer `%s'\n",
1356 mac_to_string (&cm->mac),
1357 GNUNET_i2s (plugin->env->my_identity));
1358 plugin->env->notify_address (plugin->env->cls, GNUNET_YES,
1359 &plugin->mac_address,
1360 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1363 case GNUNET_MESSAGE_TYPE_WLAN_DATA_FROM_HELPER:
1364 LOG (GNUNET_ERROR_TYPE_DEBUG,
1365 "Got data message from helper with %u bytes\n",
1367 GNUNET_STATISTICS_update (plugin->env->stats,
1368 _("# DATA messages received via WLAN"), 1,
1370 if (msize < sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage))
1373 LOG (GNUNET_ERROR_TYPE_DEBUG,
1374 "Size of packet is too small (%u bytes)\n",
1378 rxinfo = (const struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage *) hdr;
1380 /* check if message is actually for us */
1381 if (0 != memcmp (&rxinfo->frame.addr3, &mac_bssid_gnunet,
1382 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1384 /* Not the GNUnet BSSID */
1387 if ( (0 != memcmp (&rxinfo->frame.addr1, &bc_all_mac,
1388 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))) &&
1389 (0 != memcmp (&rxinfo->frame.addr1, &plugin->mac_address,
1390 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))) )
1392 /* Neither broadcast nor specifically for us */
1395 if (0 == memcmp (&rxinfo->frame.addr2, &plugin->mac_address,
1396 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1398 /* packet is FROM us, thus not FOR us */
1402 GNUNET_STATISTICS_update (plugin->env->stats,
1403 _("# WLAN DATA messages processed"),
1405 LOG (GNUNET_ERROR_TYPE_DEBUG,
1406 "Receiving %u bytes of data from MAC `%s'\n",
1407 (unsigned int) (msize - sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage)),
1408 mac_to_string (&rxinfo->frame.addr2));
1409 mas.endpoint = create_macendpoint (plugin, &rxinfo->frame.addr2);
1411 (void) GNUNET_SERVER_mst_receive (plugin->helper_payload_tokenizer,
1413 (const char*) &rxinfo[1],
1414 msize - sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage),
1415 GNUNET_YES, GNUNET_NO);
1419 LOG (GNUNET_ERROR_TYPE_DEBUG,
1420 "Unexpected message of type %u (%u bytes)",
1421 ntohs (hdr->type), ntohs (hdr->size));
1430 * Task to (periodically) send a HELLO beacon
1432 * @param cls pointer to the plugin struct
1433 * @param tc scheduler context
1436 send_hello_beacon (void *cls,
1437 const struct GNUNET_SCHEDULER_TaskContext *tc)
1439 struct Plugin *plugin = cls;
1441 uint16_t hello_size;
1442 struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *radioHeader;
1443 const struct GNUNET_MessageHeader *hello;
1445 hello = plugin->env->get_our_hello ();
1446 hello_size = GNUNET_HELLO_size ((struct GNUNET_HELLO_Message *) hello);
1447 GNUNET_assert (sizeof (struct WlanHeader) + hello_size <= WLAN_MTU);
1448 size = sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage) + hello_size;
1450 char buf[size] GNUNET_ALIGN;
1452 LOG (GNUNET_ERROR_TYPE_DEBUG,
1453 "Sending %u byte HELLO beacon\n",
1454 (unsigned int) size);
1455 radioHeader = (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage*) buf;
1456 get_radiotap_header (NULL, radioHeader, size);
1457 get_wlan_header (plugin, &radioHeader->frame, &bc_all_mac, size);
1458 memcpy (&radioHeader[1], hello, hello_size);
1460 GNUNET_HELPER_send (plugin->suid_helper,
1461 &radioHeader->header,
1462 GNUNET_YES /* can drop */,
1464 GNUNET_STATISTICS_update (plugin->env->stats, _("# HELLO beacons sent via WLAN"),
1467 plugin->beacon_task =
1468 GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_relative_multiply
1469 (HELLO_BEACON_SCALING_FACTOR,
1470 plugin->mac_count + 1),
1478 * Another peer has suggested an address for this
1479 * peer and transport plugin. Check that this could be a valid
1480 * address. If so, consider adding it to the list
1483 * @param cls closure
1484 * @param addr pointer to the address
1485 * @param addrlen length of addr
1486 * @return GNUNET_OK if this is a plausible address for this peer
1490 wlan_plugin_address_suggested (void *cls, const void *addr, size_t addrlen)
1492 struct Plugin *plugin = cls;
1494 if (addrlen != sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))
1496 GNUNET_break_op (0);
1497 return GNUNET_SYSERR;
1499 if (GNUNET_YES != plugin->have_mac)
1501 LOG (GNUNET_ERROR_TYPE_DEBUG,
1502 "Rejecting MAC `%s': I don't know my MAC!\n",
1503 mac_to_string (addr));
1504 return GNUNET_NO; /* don't know my MAC */
1506 if (0 != memcmp (addr,
1507 &plugin->mac_address,
1510 LOG (GNUNET_ERROR_TYPE_DEBUG,
1511 "Rejecting MAC `%s': not my MAC!\n",
1512 mac_to_string (addr));
1513 return GNUNET_NO; /* not my MAC */
1520 * Function called for a quick conversion of the binary address to
1521 * a numeric address. Note that the caller must not free the
1522 * address and that the next call to this function is allowed
1523 * to override the address again.
1525 * @param cls closure
1526 * @param addr binary address
1527 * @param addrlen length of the address
1528 * @return string representing the same address
1531 wlan_plugin_address_to_string (void *cls, const void *addr, size_t addrlen)
1533 const struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1535 if (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress) != addrlen)
1541 return mac_to_string (mac);
1546 * Convert the transports address to a nice, human-readable format.
1548 * @param cls closure
1549 * @param type name of the transport that generated the address
1550 * @param addr one of the addresses of the host, NULL for the last address
1551 * the specific address format depends on the transport
1552 * @param addrlen length of the address
1553 * @param numeric should (IP) addresses be displayed in numeric form?
1554 * @param timeout after how long should we give up?
1555 * @param asc function to call on each string
1556 * @param asc_cls closure for asc
1559 wlan_plugin_address_pretty_printer (void *cls, const char *type,
1560 const void *addr, size_t addrlen,
1562 struct GNUNET_TIME_Relative timeout,
1563 GNUNET_TRANSPORT_AddressStringCallback asc,
1566 const struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1569 if (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress) != addrlen)
1571 /* invalid address */
1572 LOG (GNUNET_ERROR_TYPE_WARNING,
1573 _("WLAN address with invalid size encountered\n"));
1574 asc (asc_cls, NULL);
1578 ret = GNUNET_strdup (mac_to_string (mac));
1581 asc (asc_cls, NULL);
1586 * Exit point from the plugin.
1588 * @param cls pointer to the api struct
1591 libgnunet_plugin_transport_wlan_done (void *cls)
1593 struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
1594 struct Plugin *plugin = api->cls;
1595 struct MacEndpoint *endpoint;
1596 struct MacEndpoint *endpoint_next;
1604 if (GNUNET_YES == plugin->have_mac)
1606 plugin->env->notify_address (plugin->env->cls, GNUNET_NO,
1607 &plugin->mac_address,
1608 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1610 plugin->have_mac = GNUNET_NO;
1613 if (GNUNET_SCHEDULER_NO_TASK != plugin->beacon_task)
1615 GNUNET_SCHEDULER_cancel (plugin->beacon_task);
1616 plugin->beacon_task = GNUNET_SCHEDULER_NO_TASK;
1618 if (NULL != plugin->suid_helper)
1620 GNUNET_HELPER_stop (plugin->suid_helper);
1621 plugin->suid_helper = NULL;
1623 endpoint_next = plugin->mac_head;
1624 while (NULL != (endpoint = endpoint_next))
1626 endpoint_next = endpoint->next;
1627 free_macendpoint (endpoint);
1629 if (NULL != plugin->fragment_data_tokenizer)
1631 GNUNET_SERVER_mst_destroy (plugin->fragment_data_tokenizer);
1632 plugin->fragment_data_tokenizer = NULL;
1634 if (NULL != plugin->wlan_header_payload_tokenizer)
1636 GNUNET_SERVER_mst_destroy (plugin->wlan_header_payload_tokenizer);
1637 plugin->wlan_header_payload_tokenizer = NULL;
1639 if (NULL != plugin->helper_payload_tokenizer)
1641 GNUNET_SERVER_mst_destroy (plugin->helper_payload_tokenizer);
1642 plugin->helper_payload_tokenizer = NULL;
1644 GNUNET_free_non_null (plugin->interface);
1645 GNUNET_free (plugin);
1652 * Function called to convert a string address to
1655 * @param cls closure ('struct Plugin*')
1656 * @param addr string address
1657 * @param addrlen length of the address
1658 * @param buf location to store the buffer
1659 * @param added location to store the number of bytes in the buffer.
1660 * If the function returns GNUNET_SYSERR, its contents are undefined.
1661 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
1664 wlan_string_to_address (void *cls, const char *addr, uint16_t addrlen,
1665 void **buf, size_t *added)
1667 struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1671 if ((NULL == addr) || (addrlen == 0))
1674 return GNUNET_SYSERR;
1676 if ('\0' != addr[addrlen - 1])
1679 return GNUNET_SYSERR;
1681 if (strlen (addr) != addrlen - 1)
1684 return GNUNET_SYSERR;
1686 if (6 != SSCANF (addr,
1687 "%X:%X:%X:%X:%X:%X",
1688 &a[0], &a[1], &a[2], &a[3], &a[4], &a[5]))
1691 return GNUNET_SYSERR;
1693 mac = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1697 *added = sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress);
1703 * Entry point for the plugin.
1705 * @param cls closure, the 'struct GNUNET_TRANSPORT_PluginEnvironment*'
1706 * @return the 'struct GNUNET_TRANSPORT_PluginFunctions*' or NULL on error
1709 libgnunet_plugin_transport_wlan_init (void *cls)
1711 struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
1712 struct GNUNET_TRANSPORT_PluginFunctions *api;
1713 struct Plugin *plugin;
1715 unsigned long long testmode;
1718 /* check for 'special' mode */
1719 if (NULL == env->receive)
1721 /* run in 'stub' mode (i.e. as part of gnunet-peerinfo), don't fully
1722 initialze the plugin or the API */
1723 api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
1725 api->address_pretty_printer = &wlan_plugin_address_pretty_printer;
1726 api->address_to_string = &wlan_plugin_address_to_string;
1727 api->string_to_address = &wlan_string_to_address;
1732 /* check configuration */
1734 GNUNET_CONFIGURATION_have_value (env->cfg, "transport-wlan", "TESTMODE")) &&
1736 GNUNET_CONFIGURATION_get_value_number (env->cfg, "transport-wlan",
1737 "TESTMODE", &testmode)) ||
1740 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR,
1741 "transport-wlan", "TESTMODE");
1744 binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-transport-wlan");
1745 if ( (0 == testmode) &&
1746 (GNUNET_YES != GNUNET_OS_check_helper_binary (binary)) )
1748 LOG (GNUNET_ERROR_TYPE_ERROR,
1749 _("Helper binary `%s' not SUID, cannot run WLAN transport\n"),
1750 "gnunet-helper-transport-wlan");
1751 GNUNET_free (binary);
1754 GNUNET_free (binary);
1756 GNUNET_CONFIGURATION_get_value_string
1757 (env->cfg, "transport-wlan", "INTERFACE",
1760 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR,
1761 "transport-wlan", "INTERFACE");
1765 plugin = GNUNET_malloc (sizeof (struct Plugin));
1766 plugin->interface = interface;
1768 GNUNET_STATISTICS_set (plugin->env->stats, _("# WLAN sessions allocated"),
1770 GNUNET_STATISTICS_set (plugin->env->stats, _("# WLAN MAC endpoints allocated"),
1772 GNUNET_BANDWIDTH_tracker_init (&plugin->tracker,
1773 GNUNET_BANDWIDTH_value_init (100 * 1024 *
1775 plugin->fragment_data_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1776 plugin->wlan_header_payload_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1777 plugin->helper_payload_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1778 plugin->beacon_task = GNUNET_SCHEDULER_add_now (&send_hello_beacon,
1780 /* some compilers do not like switch on 'long long'... */
1781 switch ((unsigned int) testmode)
1783 case 0: /* normal */
1784 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan";
1785 plugin->helper_argv[1] = interface;
1786 plugin->helper_argv[2] = NULL;
1787 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1788 "gnunet-helper-transport-wlan",
1789 plugin->helper_argv,
1790 &handle_helper_message,
1794 case 1: /* testmode, peer 1 */
1795 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan-dummy";
1796 plugin->helper_argv[1] = (char *) "1";
1797 plugin->helper_argv[2] = NULL;
1798 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1799 "gnunet-helper-transport-wlan-dummy",
1800 plugin->helper_argv,
1801 &handle_helper_message,
1805 case 2: /* testmode, peer 2 */
1806 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan-dummy";
1807 plugin->helper_argv[1] = (char *) "2";
1808 plugin->helper_argv[2] = NULL;
1809 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1810 "gnunet-helper-transport-wlan-dummy",
1811 plugin->helper_argv,
1812 &handle_helper_message,
1820 api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
1822 api->send = &wlan_plugin_send;
1823 api->get_session = &wlan_plugin_get_session;
1824 api->disconnect = &wlan_plugin_disconnect;
1825 api->address_pretty_printer = &wlan_plugin_address_pretty_printer;
1826 api->check_address = &wlan_plugin_address_suggested;
1827 api->address_to_string = &wlan_plugin_address_to_string;
1828 api->string_to_address = &wlan_string_to_address;
1833 /* end of plugin_transport_wlan.c */