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,
1176 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1177 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1179 case GNUNET_MESSAGE_TYPE_FRAGMENT:
1180 if (NULL == mas->endpoint)
1185 LOG (GNUNET_ERROR_TYPE_DEBUG,
1186 "Processing %u bytes of FRAGMENT from MAC %s\n",
1187 (unsigned int) msize,
1188 mac_to_string (&mas->endpoint->addr));
1189 GNUNET_STATISTICS_update (plugin->env->stats,
1190 _("# fragments received via WLAN"), 1, GNUNET_NO);
1191 (void) GNUNET_DEFRAGMENT_process_fragment (mas->endpoint->defrag,
1194 case GNUNET_MESSAGE_TYPE_FRAGMENT_ACK:
1195 if (NULL == mas->endpoint)
1200 GNUNET_STATISTICS_update (plugin->env->stats, _("# ACKs received via WLAN"),
1202 for (fm = mas->endpoint->sending_messages_head; NULL != fm; fm = fm->next)
1204 ret = GNUNET_FRAGMENT_process_ack (fm->fragcontext, hdr);
1205 if (GNUNET_OK == ret)
1207 LOG (GNUNET_ERROR_TYPE_DEBUG,
1208 "Got last ACK, finished message transmission to `%s' (%p)\n",
1209 mac_to_string (&mas->endpoint->addr),
1211 mas->endpoint->timeout = GNUNET_TIME_relative_to_absolute (MACENDPOINT_TIMEOUT);
1212 if (NULL != fm->cont)
1214 fm->cont (fm->cont_cls, &fm->target, GNUNET_OK, fm->size_payload, fm->size_on_wire);
1217 free_fragment_message (fm);
1220 if (GNUNET_NO == ret)
1222 LOG (GNUNET_ERROR_TYPE_DEBUG,
1223 "Got an ACK, message transmission to `%s' not yet finished\n",
1224 mac_to_string (&mas->endpoint->addr));
1228 LOG (GNUNET_ERROR_TYPE_DEBUG,
1229 "ACK not matched against any active fragmentation with MAC `%s'\n",
1230 mac_to_string (&mas->endpoint->addr));
1232 case GNUNET_MESSAGE_TYPE_WLAN_DATA:
1233 if (NULL == mas->endpoint)
1238 if (msize < sizeof (struct WlanHeader))
1243 wlanheader = (const struct WlanHeader *) hdr;
1244 if (0 != memcmp (&wlanheader->target,
1245 plugin->env->my_identity,
1246 sizeof (struct GNUNET_PeerIdentity)))
1248 LOG (GNUNET_ERROR_TYPE_DEBUG,
1249 "WLAN data for `%s', not for me, ignoring\n",
1250 GNUNET_i2s (&wlanheader->target));
1253 if (ntohl (wlanheader->crc) !=
1254 GNUNET_CRYPTO_crc32_n (&wlanheader[1], msize - sizeof (struct WlanHeader)))
1256 GNUNET_STATISTICS_update (plugin->env->stats,
1257 _("# WLAN DATA messages discarded due to CRC32 error"), 1,
1261 xmas.endpoint = mas->endpoint;
1262 xmas.session = create_session (mas->endpoint, &wlanheader->sender);
1263 LOG (GNUNET_ERROR_TYPE_DEBUG,
1264 "Processing %u bytes of WLAN DATA from peer `%s'\n",
1265 (unsigned int) msize,
1266 GNUNET_i2s (&wlanheader->sender));
1267 (void) GNUNET_SERVER_mst_receive (plugin->wlan_header_payload_tokenizer,
1269 (const char *) &wlanheader[1],
1270 msize - sizeof (struct WlanHeader),
1271 GNUNET_YES, GNUNET_NO);
1274 if (NULL == mas->endpoint)
1279 if (NULL == mas->session)
1284 LOG (GNUNET_ERROR_TYPE_DEBUG,
1285 "Received packet with %u bytes of type %u from peer %s\n",
1286 (unsigned int) msize,
1287 (unsigned int) ntohs (hdr->type),
1288 GNUNET_i2s (&mas->session->target));
1289 plugin->env->receive (plugin->env->cls,
1290 &mas->session->target,
1294 (mas->endpoint == NULL) ? NULL : (const char *) &mas->endpoint->addr,
1295 (mas->endpoint == NULL) ? 0 : sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1304 * Function used for to process the data from the suid process
1306 * @param cls the plugin handle
1307 * @param client client that send the data (not used)
1308 * @param hdr header of the GNUNET_MessageHeader
1311 handle_helper_message (void *cls, void *client,
1312 const struct GNUNET_MessageHeader *hdr)
1314 struct Plugin *plugin = cls;
1315 const struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage *rxinfo;
1316 const struct GNUNET_TRANSPORT_WLAN_HelperControlMessage *cm;
1317 struct MacAndSession mas;
1320 msize = ntohs (hdr->size);
1321 switch (ntohs (hdr->type))
1323 case GNUNET_MESSAGE_TYPE_WLAN_HELPER_CONTROL:
1324 if (msize != sizeof (struct GNUNET_TRANSPORT_WLAN_HelperControlMessage))
1329 cm = (const struct GNUNET_TRANSPORT_WLAN_HelperControlMessage *) hdr;
1330 if (GNUNET_YES == plugin->have_mac)
1332 if (0 == memcmp (&plugin->mac_address,
1334 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1335 break; /* no change */
1336 /* remove old address */
1337 plugin->env->notify_address (plugin->env->cls, GNUNET_NO,
1338 &plugin->mac_address,
1339 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1342 plugin->mac_address = cm->mac;
1343 plugin->have_mac = GNUNET_YES;
1344 LOG (GNUNET_ERROR_TYPE_DEBUG,
1345 "Received WLAN_HELPER_CONTROL message with MAC address `%s' for peer `%s'\n",
1346 mac_to_string (&cm->mac),
1347 GNUNET_i2s (plugin->env->my_identity));
1348 plugin->env->notify_address (plugin->env->cls, GNUNET_YES,
1349 &plugin->mac_address,
1350 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1353 case GNUNET_MESSAGE_TYPE_WLAN_DATA_FROM_HELPER:
1354 LOG (GNUNET_ERROR_TYPE_DEBUG,
1355 "Got data message from helper with %u bytes\n",
1357 GNUNET_STATISTICS_update (plugin->env->stats,
1358 _("# DATA messages received via WLAN"), 1,
1360 if (msize < sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage))
1363 LOG (GNUNET_ERROR_TYPE_DEBUG,
1364 "Size of packet is too small (%u bytes)\n",
1368 rxinfo = (const struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage *) hdr;
1370 /* check if message is actually for us */
1371 if (0 != memcmp (&rxinfo->frame.addr3, &mac_bssid_gnunet,
1372 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1374 /* Not the GNUnet BSSID */
1377 if ( (0 != memcmp (&rxinfo->frame.addr1, &bc_all_mac,
1378 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))) &&
1379 (0 != memcmp (&rxinfo->frame.addr1, &plugin->mac_address,
1380 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))) )
1382 /* Neither broadcast nor specifically for us */
1385 if (0 == memcmp (&rxinfo->frame.addr2, &plugin->mac_address,
1386 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress)))
1388 /* packet is FROM us, thus not FOR us */
1392 GNUNET_STATISTICS_update (plugin->env->stats,
1393 _("# WLAN DATA messages processed"),
1395 LOG (GNUNET_ERROR_TYPE_DEBUG,
1396 "Receiving %u bytes of data from MAC `%s'\n",
1397 (unsigned int) (msize - sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage)),
1398 mac_to_string (&rxinfo->frame.addr2));
1399 mas.endpoint = create_macendpoint (plugin, &rxinfo->frame.addr2);
1401 (void) GNUNET_SERVER_mst_receive (plugin->helper_payload_tokenizer,
1403 (const char*) &rxinfo[1],
1404 msize - sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapReceiveMessage),
1405 GNUNET_YES, GNUNET_NO);
1409 LOG (GNUNET_ERROR_TYPE_DEBUG,
1410 "Unexpected message of type %u (%u bytes)",
1411 ntohs (hdr->type), ntohs (hdr->size));
1420 * Task to (periodically) send a HELLO beacon
1422 * @param cls pointer to the plugin struct
1423 * @param tc scheduler context
1426 send_hello_beacon (void *cls,
1427 const struct GNUNET_SCHEDULER_TaskContext *tc)
1429 struct Plugin *plugin = cls;
1431 uint16_t hello_size;
1432 struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage *radioHeader;
1433 const struct GNUNET_MessageHeader *hello;
1435 hello = plugin->env->get_our_hello ();
1436 hello_size = GNUNET_HELLO_size ((struct GNUNET_HELLO_Message *) hello);
1437 GNUNET_assert (sizeof (struct WlanHeader) + hello_size <= WLAN_MTU);
1438 size = sizeof (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage) + hello_size;
1440 char buf[size] GNUNET_ALIGN;
1442 LOG (GNUNET_ERROR_TYPE_DEBUG,
1443 "Sending %u byte HELLO beacon\n",
1444 (unsigned int) size);
1445 radioHeader = (struct GNUNET_TRANSPORT_WLAN_RadiotapSendMessage*) buf;
1446 get_radiotap_header (NULL, radioHeader, size);
1447 get_wlan_header (plugin, &radioHeader->frame, &bc_all_mac, size);
1448 memcpy (&radioHeader[1], hello, hello_size);
1450 GNUNET_HELPER_send (plugin->suid_helper,
1451 &radioHeader->header,
1452 GNUNET_YES /* can drop */,
1454 GNUNET_STATISTICS_update (plugin->env->stats, _("# HELLO beacons sent via WLAN"),
1457 plugin->beacon_task =
1458 GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_relative_multiply
1459 (HELLO_BEACON_SCALING_FACTOR,
1460 plugin->mac_count + 1),
1468 * Another peer has suggested an address for this
1469 * peer and transport plugin. Check that this could be a valid
1470 * address. If so, consider adding it to the list
1473 * @param cls closure
1474 * @param addr pointer to the address
1475 * @param addrlen length of addr
1476 * @return GNUNET_OK if this is a plausible address for this peer
1480 wlan_plugin_address_suggested (void *cls, const void *addr, size_t addrlen)
1482 struct Plugin *plugin = cls;
1484 if (addrlen != sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress))
1486 GNUNET_break_op (0);
1487 return GNUNET_SYSERR;
1489 if (GNUNET_YES != plugin->have_mac)
1491 LOG (GNUNET_ERROR_TYPE_DEBUG,
1492 "Rejecting MAC `%s': I don't know my MAC!\n",
1493 mac_to_string (addr));
1494 return GNUNET_NO; /* don't know my MAC */
1496 if (0 != memcmp (addr,
1497 &plugin->mac_address,
1500 LOG (GNUNET_ERROR_TYPE_DEBUG,
1501 "Rejecting MAC `%s': not my MAC!\n",
1502 mac_to_string (addr));
1503 return GNUNET_NO; /* not my MAC */
1510 * Function called for a quick conversion of the binary address to
1511 * a numeric address. Note that the caller must not free the
1512 * address and that the next call to this function is allowed
1513 * to override the address again.
1515 * @param cls closure
1516 * @param addr binary address
1517 * @param addrlen length of the address
1518 * @return string representing the same address
1521 wlan_plugin_address_to_string (void *cls, const void *addr, size_t addrlen)
1523 const struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1525 if (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress) != addrlen)
1531 return mac_to_string (mac);
1536 * Convert the transports address to a nice, human-readable format.
1538 * @param cls closure
1539 * @param type name of the transport that generated the address
1540 * @param addr one of the addresses of the host, NULL for the last address
1541 * the specific address format depends on the transport
1542 * @param addrlen length of the address
1543 * @param numeric should (IP) addresses be displayed in numeric form?
1544 * @param timeout after how long should we give up?
1545 * @param asc function to call on each string
1546 * @param asc_cls closure for asc
1549 wlan_plugin_address_pretty_printer (void *cls, const char *type,
1550 const void *addr, size_t addrlen,
1552 struct GNUNET_TIME_Relative timeout,
1553 GNUNET_TRANSPORT_AddressStringCallback asc,
1556 const struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1559 if (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress) != addrlen)
1561 /* invalid address */
1562 LOG (GNUNET_ERROR_TYPE_WARNING,
1563 _("WLAN address with invalid size encountered\n"));
1564 asc (asc_cls, NULL);
1568 ret = GNUNET_strdup (mac_to_string (mac));
1571 asc (asc_cls, NULL);
1576 * Exit point from the plugin.
1578 * @param cls pointer to the api struct
1581 libgnunet_plugin_transport_wlan_done (void *cls)
1583 struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
1584 struct Plugin *plugin = api->cls;
1585 struct MacEndpoint *endpoint;
1586 struct MacEndpoint *endpoint_next;
1594 if (GNUNET_YES == plugin->have_mac)
1596 plugin->env->notify_address (plugin->env->cls, GNUNET_NO,
1597 &plugin->mac_address,
1598 sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress),
1600 plugin->have_mac = GNUNET_NO;
1603 if (GNUNET_SCHEDULER_NO_TASK != plugin->beacon_task)
1605 GNUNET_SCHEDULER_cancel (plugin->beacon_task);
1606 plugin->beacon_task = GNUNET_SCHEDULER_NO_TASK;
1608 if (NULL != plugin->suid_helper)
1610 GNUNET_HELPER_stop (plugin->suid_helper);
1611 plugin->suid_helper = NULL;
1613 endpoint_next = plugin->mac_head;
1614 while (NULL != (endpoint = endpoint_next))
1616 endpoint_next = endpoint->next;
1617 free_macendpoint (endpoint);
1619 if (NULL != plugin->fragment_data_tokenizer)
1621 GNUNET_SERVER_mst_destroy (plugin->fragment_data_tokenizer);
1622 plugin->fragment_data_tokenizer = NULL;
1624 if (NULL != plugin->wlan_header_payload_tokenizer)
1626 GNUNET_SERVER_mst_destroy (plugin->wlan_header_payload_tokenizer);
1627 plugin->wlan_header_payload_tokenizer = NULL;
1629 if (NULL != plugin->helper_payload_tokenizer)
1631 GNUNET_SERVER_mst_destroy (plugin->helper_payload_tokenizer);
1632 plugin->helper_payload_tokenizer = NULL;
1634 GNUNET_free_non_null (plugin->interface);
1635 GNUNET_free (plugin);
1642 * Function called to convert a string address to
1645 * @param cls closure ('struct Plugin*')
1646 * @param addr string address
1647 * @param addrlen length of the address
1648 * @param buf location to store the buffer
1649 * @param added location to store the number of bytes in the buffer.
1650 * If the function returns GNUNET_SYSERR, its contents are undefined.
1651 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
1654 wlan_string_to_address (void *cls, const char *addr, uint16_t addrlen,
1655 void **buf, size_t *added)
1657 struct GNUNET_TRANSPORT_WLAN_MacAddress *mac;
1661 if ((NULL == addr) || (addrlen == 0))
1664 return GNUNET_SYSERR;
1666 if ('\0' != addr[addrlen - 1])
1669 return GNUNET_SYSERR;
1671 if (strlen (addr) != addrlen - 1)
1674 return GNUNET_SYSERR;
1676 if (6 != SSCANF (addr,
1677 "%X:%X:%X:%X:%X:%X",
1678 &a[0], &a[1], &a[2], &a[3], &a[4], &a[5]))
1681 return GNUNET_SYSERR;
1683 mac = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress));
1687 *added = sizeof (struct GNUNET_TRANSPORT_WLAN_MacAddress);
1693 * Entry point for the plugin.
1695 * @param cls closure, the 'struct GNUNET_TRANSPORT_PluginEnvironment*'
1696 * @return the 'struct GNUNET_TRANSPORT_PluginFunctions*' or NULL on error
1699 libgnunet_plugin_transport_wlan_init (void *cls)
1701 struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
1702 struct GNUNET_TRANSPORT_PluginFunctions *api;
1703 struct Plugin *plugin;
1705 unsigned long long testmode;
1708 /* check for 'special' mode */
1709 if (NULL == env->receive)
1711 /* run in 'stub' mode (i.e. as part of gnunet-peerinfo), don't fully
1712 initialze the plugin or the API */
1713 api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
1715 api->address_pretty_printer = &wlan_plugin_address_pretty_printer;
1716 api->address_to_string = &wlan_plugin_address_to_string;
1717 api->string_to_address = &wlan_string_to_address;
1722 /* check configuration */
1724 GNUNET_CONFIGURATION_have_value (env->cfg, "transport-wlan", "TESTMODE")) &&
1726 GNUNET_CONFIGURATION_get_value_number (env->cfg, "transport-wlan",
1727 "TESTMODE", &testmode)) ||
1730 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR,
1731 "transport-wlan", "TESTMODE");
1734 binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-transport-wlan");
1735 if ( (0 == testmode) &&
1736 (GNUNET_YES != GNUNET_OS_check_helper_binary (binary)) )
1738 LOG (GNUNET_ERROR_TYPE_ERROR,
1739 _("Helper binary `%s' not SUID, cannot run WLAN transport\n"),
1740 "gnunet-helper-transport-wlan");
1741 GNUNET_free (binary);
1744 GNUNET_free (binary);
1746 GNUNET_CONFIGURATION_get_value_string
1747 (env->cfg, "transport-wlan", "INTERFACE",
1750 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR,
1751 "transport-wlan", "INTERFACE");
1755 plugin = GNUNET_malloc (sizeof (struct Plugin));
1756 plugin->interface = interface;
1758 GNUNET_STATISTICS_set (plugin->env->stats, _("# WLAN sessions allocated"),
1760 GNUNET_STATISTICS_set (plugin->env->stats, _("# WLAN MAC endpoints allocated"),
1762 GNUNET_BANDWIDTH_tracker_init (&plugin->tracker,
1763 GNUNET_BANDWIDTH_value_init (100 * 1024 *
1765 plugin->fragment_data_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1766 plugin->wlan_header_payload_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1767 plugin->helper_payload_tokenizer = GNUNET_SERVER_mst_create (&process_data, plugin);
1768 plugin->beacon_task = GNUNET_SCHEDULER_add_now (&send_hello_beacon,
1770 /* some compilers do not like switch on 'long long'... */
1771 switch ((unsigned int) testmode)
1773 case 0: /* normal */
1774 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan";
1775 plugin->helper_argv[1] = interface;
1776 plugin->helper_argv[2] = NULL;
1777 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1778 "gnunet-helper-transport-wlan",
1779 plugin->helper_argv,
1780 &handle_helper_message,
1784 case 1: /* testmode, peer 1 */
1785 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan-dummy";
1786 plugin->helper_argv[1] = (char *) "1";
1787 plugin->helper_argv[2] = NULL;
1788 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1789 "gnunet-helper-transport-wlan-dummy",
1790 plugin->helper_argv,
1791 &handle_helper_message,
1795 case 2: /* testmode, peer 2 */
1796 plugin->helper_argv[0] = (char *) "gnunet-helper-transport-wlan-dummy";
1797 plugin->helper_argv[1] = (char *) "2";
1798 plugin->helper_argv[2] = NULL;
1799 plugin->suid_helper = GNUNET_HELPER_start (GNUNET_NO,
1800 "gnunet-helper-transport-wlan-dummy",
1801 plugin->helper_argv,
1802 &handle_helper_message,
1810 api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
1812 api->send = &wlan_plugin_send;
1813 api->get_session = &wlan_plugin_get_session;
1814 api->disconnect = &wlan_plugin_disconnect;
1815 api->address_pretty_printer = &wlan_plugin_address_pretty_printer;
1816 api->check_address = &wlan_plugin_address_suggested;
1817 api->address_to_string = &wlan_plugin_address_to_string;
1818 api->string_to_address = &wlan_string_to_address;
1823 /* end of plugin_transport_wlan.c */