2 This file is part of GNUnet.
3 Copyright (C) 2009, 2010, 2011, 2016 GNUnet e.V.
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., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
22 * @file nat/gnunet-service-nat_helper.h
23 * @brief runs the gnunet-helper-nat-server
24 * @author Milan Bouchet-Valat
25 * @author Christian Grothoff
28 #include "gnunet_util_lib.h"
32 * Information we keep per NAT helper process.
38 * Function called whenever we get a connection reversal
39 * request from another peer.
42 * @param ra IP address of the peer who wants us to connect to it
45 (*GN_ReversalCallback) (void *cls,
46 const struct sockaddr_in *ra);
50 * Start the gnunet-helper-nat-server and process incoming
53 * @param internal_address
54 * @param cb function to call if we receive a request
55 * @param cb_cls closure for @a cb
56 * @return NULL on error
58 struct HelperContext *
59 GN_start_gnunet_nat_server_ (const struct in_addr *internal_address,
60 GN_ReversalCallback cb,
65 * Start the gnunet-helper-nat-server and process incoming
68 * @param h helper context to stop
71 GN_stop_gnunet_nat_server_ (struct HelperContext *h);
75 * We want to connect to a peer that is behind NAT. Run the
76 * gnunet-helper-nat-client to send dummy ICMP responses to cause
77 * that peer to connect to us (connection reversal).
79 * @param internal_address out internal address to use
80 * @param internal_port internal port to use
81 * @param remote_v4 the address of the peer (IPv4-only)
82 * @return #GNUNET_SYSERR on error,
83 * #GNUNET_OK otherwise
86 GN_request_connection_reversal (const struct in_addr *internal_address,
87 uint16_t internal_port,
88 const struct in_addr *sa);
91 /* end of gnunet-service-nat_helper.h */