src/peer/peercon.h

   1 /*****************************************************************************
   2  * Copyright 2005 Daniel Ferullo                                             *
   3  *                                                                           *
   4  * Licensed under the Apache License, Version 2.0 (the "License");           *
   5  * you may not use this file except in compliance with the License.          *
   6  * You may obtain a copy of the License at                                   *
   7  *                                                                           *
   8  *    http://www.apache.org/licenses/LICENSE-2.0                             *
   9  *                                                                           *
  10  * Unless required by applicable law or agreed to in writing, software       *
  11  * distributed under the License is distributed on an "AS IS" BASIS,         *
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  *
  13  * See the License for the specific language governing permissions and       *
  14  * limitations under the License.                                            *
  15  *                                                                           *
  16  *****************************************************************************/
  17
  18 /**
  19  * @file peercon.h
  20  * @author Daniel Ferullo (ferullo@cmu.edu)
  21  *
  22  * @brief functions to help the peer make a direct connection
  23  */
  24
  25 #ifndef __PEERCON_H__
  26 #define __PEERCON_H__
  27
  28 #include "errorcodes.h"
  29 #include "def.h"
  30 #include "peerdef.h"
  31
  32 /**
  33  * @brief waits until the direct connection flag is set to FLAG_SUCCESS or
  34   *       FLAG_FAILED
  35   *
  36   * @param check_flag pointer to the flag to wait on
  37   *
  38   * @return SUCCESS, errorcode on failure
  39   */
  40 errorcode wait_for_direct_conn(flag_t *check_flag);
  41
  42 /**
  43  * @brief finds a network devide (requires root privledge)
  44  *
  45  * this is basically a wrapper for pcap_lookupdev.  I assume pcap_lookupdev
  46  * uses malloc to allocate the memory for the returned pointer, but I am
  47  * not sure.  This needs to be checked.
  48  *
  49  * @param dev a pointer to a pointer.  When finished, will point to a string
  50  *        with the network device to use.
  51  *
  52  * @return SUCCESS, neg value on failure
  53  */
  54 errorcode findDevice(char **dev);
  55
  56 /**
  57  * @brief function to do the SYN flooding to buddy
  58  *
  59  * @param tcp_skeleton a skeleton tcp_packet_info_t to base SYN's on.  The
  60  *         d_addr, d_port, s_addr, and seq_num fields will be inspected.
  61  *
  62  * @param device the device to forge SYNs on
  63  *
  64  * @return SUCCESS, errorcode on failure
  65  */
  66 errorcode flood_syns(tcp_packet_info_t tcp_skeleton, char *device);
  67
  68 /**
  69  * @brief a function to spawn a thread to look for a SYN/ACK with
  70  *
  71  * @param info pointer to the peer's information structure
  72  *
  73  * @return SUCCESS, errorcode on failure
  74  */
  75 errorcode start_find_synack(peer_conn_info_t *info);
  76
  77 /** @brief the entry point for the thread that looks for the SYN/ACK in a
  78  *  bday flood
  79  *
  80  * @param arg the single pthread arg (should be a pointer to the peer
  81  * information structure)
  82  *
  83  * @return SUCCESS, errorcode on failure
  84  */
  85 void *run_find_synack(void* arg);
  86
  87 /**
  88  * @brief waits for the find syn ack to finish, within a timeout, and then
  89  *        joins on the thread.
  90  *
  91  * @param info a pointer to the peer_conn_info_t structure
  92  *
  93  * @return SUCCESS, errorcode on failure
  94  */
  95 errorcode wait_and_join_find_synack(peer_conn_info_t *info);
  96
  97 /**
  98  * @brief sends a bday flood of synacks to the peer
  99  *
 100  * @param info pointer to the peer_conn_info_t structure
 101  * @param seq_num the sequence number used in the SYNs in the other bday flood
 102  *
 103  * @return SUCCESS, errorcode on failure
 104  */
 105 errorcode synack_flood(peer_conn_info_t *info, seq_num_t seq_num);
 106
 107 #endif /* __PEERCON_H__ */
 108