Ask the peer at ADDRESS for connection reversal, using the local address for the target address of the reversal.
.B
-.IP "\-p PORT, \-\-port=PORT"
-Use PORT as our external port for advertising for incoming requests.
+.IP "\-p ADDRESS, \-\-punch=ADDRESS"
+A hole was punched manually through the NAT. We should use ADDRESS as our external hostname and port for advertising for incoming requests. The special hostname 'AUTO' can be used to indicate that GNUnet should determine the external IP address by other means (such as upnpc), and just take the port number from ADDRESS.
.B
.IP "\-s, \-\-stun"
# gnunet-nat FIXME
+\fBManual hole punching:\fR
+
+Assume manually punched NAT, but determine external IP automatically:
+
+ # gnunet-nat -t -p AUTO:8080
+
\fBSTUN-based XXX:\fR
XXX:
*
* @param cfg configuration to use
* @param proto protocol this is about, IPPROTO_TCP or IPPROTO_UDP
- * @param adv_port advertised port (port we are either bound to or that our OS
- * locally performs redirection from to our bound port).
+ * @param hole_external hostname and port of manually punched hole in NAT, otherwise NULL (or empty string)
* @param num_addrs number of addresses in @a addrs
* @param addrs list of local addresses packets should be redirected to
* @param addrlens actual lengths of the addresses in @a addrs
struct GNUNET_NAT_Handle *
GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg,
uint8_t proto,
- uint16_t adv_port,
+ const char *hole_external,
unsigned int num_addrs,
const struct sockaddr **addrs,
const socklen_t *addrlens,
static struct GNUNET_NAT_AutoHandle *ah;
/**
- * Port we advertise.
+ * External hostname and port, if user manually punched
+ * the NAT.
*/
-static unsigned int adv_port;
+static char *hole_external;
/**
* Flag set to 1 if we use IPPROTO_UDP.
{
nh = GNUNET_NAT_register (c,
proto,
- (uint16_t) adv_port,
+ hole_external,
1,
(const struct sockaddr **) &local_sa,
&local_len,
{'r', "remote", "ADDRESS",
gettext_noop ("which remote IP and port should be asked for connection reversal"),
GNUNET_YES, &GNUNET_GETOPT_set_string, &remote_addr },
- {'p', "port", NULL,
- gettext_noop ("port to use to advertise"),
- GNUNET_YES, &GNUNET_GETOPT_set_uint, &adv_port },
+ {'p', "punched", NULL,
+ gettext_noop ("external hostname and port of NAT, if punched manually; use AUTO for hostname for automatic determination of the external IP"),
+ GNUNET_YES, &GNUNET_GETOPT_set_string, &hole_external },
{'s', "stun", NULL,
gettext_noop ("enable STUN processing"),
GNUNET_NO, &GNUNET_GETOPT_set_one, &do_stun },
* knowledge about the local network topology.
*
* TODO:
- * - test ICMP based NAT traversal
+ * - test and document (!) ICMP based NAT traversal
+ * - implement manual hole punching support (incl. DNS
+ * lookup for DynDNS setups!)
* - implement "more" autoconfig:
* re-work gnunet-nat-server & integrate!
+ * + test manually punched NAT (how?)
* - implement & test STUN processing to classify NAT;
* basically, open port & try different methods.
* - implement NEW logic for external IP detection
* Array of addresses used by the service.
*/
struct ClientAddress *caddrs;
+
+ /**
+ * External DNS name and port given by user due to manual
+ * hole punching. Special DNS name 'AUTO' is used to indicate
+ * desire for automatic determination of the external IP
+ * (instead of DNS or manual configuration, i.e. to be used
+ * if the IP keeps changing and we have no DynDNS, but we do
+ * have a hole punched).
+ */
+ char *hole_external;
/**
* What does this client care about?
*/
int natted_address;
- /**
- * Port we would like as we are configured to use this one for
- * advertising (in addition to the one we are binding to).
- */
- uint16_t adv_port;
-
/**
* Number of addresses that this service is bound to.
* Length of the @e caddrs array.
GNUNET_break (0);
return GNUNET_SYSERR;
}
- }
+ off += alen;
+ left -= alen;
+ }
+ if (left != ntohs (message->hole_external_len))
+ {
+ GNUNET_break (0);
+ return GNUNET_SYSERR;
+ }
return GNUNET_OK;
}
int add)
{
struct sockaddr_in sa;
- uint16_t port;
- uint16_t bport;
+ int have_v4;
/* (1) check if client cares. */
if (! ch->natted_address)
return;
if (0 == (GNUNET_NAT_RF_ADDRESSES & ch->flags))
return;
- bport = 0;
+ have_v4 = GNUNET_NO;
for (unsigned int i=0;i<ch->num_caddrs;i++)
{
const struct sockaddr_storage *ss = &ch->caddrs[i].ss;
if (AF_INET != ss->ss_family)
continue;
- bport = ntohs (((const struct sockaddr_in *) ss)->sin_port);
+ have_v4 = GNUNET_YES;
+ break;
}
- if (0 == bport)
+ if (GNUNET_NO == have_v4)
return; /* IPv6-only */
-
- /* (2) figure out external port, build sockaddr */
- port = ch->adv_port;
- if (0 == port)
- port = bport;
+
+ /* build address info */
memset (&sa,
0,
sizeof (sa));
sa.sin_family = AF_INET;
sa.sin_addr = *v4;
- sa.sin_port = htons (port);
+ sa.sin_port = htons (0);
/* (3) notify client of change */
notify_client (is_nat_v4 (v4)
"Received REGISTER message from client\n");
ch->flags = message->flags;
ch->proto = message->proto;
- ch->adv_port = ntohs (message->adv_port);
ch->num_caddrs = ntohs (message->num_addrs);
ch->caddrs = GNUNET_new_array (ch->num_caddrs,
struct ClientAddress);
off += alen;
}
+
+ ch->hole_external
+ = GNUNET_strndup (off,
+ ntohs (message->hole_external_len));
+
/* Actually send IP address list to client */
for (struct LocalAddressList *lal = lal_head;
NULL != lal;
if (! ch->natted_address)
continue;
v4 = *ip;
- v4.sin_port = htons (ch->adv_port);
+ v4.sin_port = htons (0);
env = GNUNET_MQ_msg_extra (msg,
sizeof (v4),
GNUNET_MESSAGE_TYPE_NAT_ADDRESS_CHANGE);
}
}
GNUNET_free_non_null (ch->caddrs);
+ GNUNET_free (ch->hole_external);
GNUNET_free (ch);
}
uint8_t proto;
/**
- * Port we would like as we are configured to use this one for
- * advertising (in addition to the one we are binding to).
+ * Number of bytes in the string that follow which
+ * specify the hostname and port of a manually punched
+ * hole for this client.
*/
- uint16_t adv_port GNUNET_PACKED;
+ uint16_t hole_external_len GNUNET_PACKED;
/**
* Number of addresses that this service is bound to that follow.
/* Followed by @e num_addrs addresses of type 'struct
sockaddr' */
+
+ /* Followed by @e hole_external_len bytes giving a hostname
+ and port */
};
*
* @param cfg configuration to use
* @param proto protocol this is about, IPPROTO_TCP or IPPROTO_UDP
- * @param adv_port advertised port (port we are either bound to or that our OS
- * locally performs redirection from to our bound port).
+ * @param hole_external hostname and port of manually punched hole in NAT, otherwise NULL (or empty string)
* @param num_addrs number of addresses in @a addrs
* @param addrs list of local addresses packets should be redirected to
* @param addrlens actual lengths of the addresses in @a addrs
struct GNUNET_NAT_Handle *
GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg,
uint8_t proto,
- uint16_t adv_port,
+ const char *hole_external,
unsigned int num_addrs,
const struct sockaddr **addrs,
const socklen_t *addrlens,
struct GNUNET_NAT_Handle *nh;
struct GNUNET_NAT_RegisterMessage *rm;
size_t len;
+ size_t hole_external_len;
char *off;
len = 0;
for (unsigned int i=0;i<num_addrs;i++)
len += addrlens[i];
+ hole_external_len
+ = (NULL == hole_external)
+ ? 0
+ : strlen (hole_external);
+ len += hole_external_len;
if ( (len > GNUNET_SERVER_MAX_MESSAGE_SIZE - sizeof (*rm)) ||
(num_addrs > UINT16_MAX) )
{
if (NULL != reversal_callback)
rm->flags |= GNUNET_NAT_RF_REVERSAL;
rm->proto = proto;
- rm->adv_port = htons (adv_port);
+ rm->hole_external_len = htons (hole_external_len);
rm->num_addrs = htons ((uint16_t) num_addrs);
off = (char *) &rm[1];
for (unsigned int i=0;i<num_addrs;i++)
addrlens[i]);
off += addrlens[i];
}
+ GNUNET_memcpy (off,
+ hole_external,
+ hole_external_len);
nh = GNUNET_new (struct GNUNET_NAT_Handle);
nh->reg = &rm->header;
projects / oweals / gnunet.git / commitdiff