src/remoting/jingle_glue/network_settings.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef REMOTING_JINGLE_GLUE_NETWORK_SETTINGS_H_
   6 #define REMOTING_JINGLE_GLUE_NETWORK_SETTINGS_H_
   7
   8 #include <string>
   9
  10 #include "base/basictypes.h"
  11 #include "base/logging.h"
  12
  13 namespace remoting {
  14
  15 struct NetworkSettings {
  16
  17   // When hosts are configured with NAT traversal disabled they will
  18   // typically also limit their P2P ports to this range, so that
  19   // sessions may be blocked or un-blocked via firewall rules.
  20   static const int kDefaultMinPort = 12400;
  21   static const int kDefaultMaxPort = 12409;
  22
  23   enum Flags {
  24     // Don't use STUN or relay servers. Accept incoming P2P connection
  25     // attempts, but don't initiate any. This ensures that the peer is
  26     // on the same network. Note that connection will always fail if
  27     // both ends use this mode.
  28     NAT_TRAVERSAL_DISABLED = 0x0,
  29
  30     // Allow outgoing connections, even when STUN and RELAY are not enabled.
  31     NAT_TRAVERSAL_OUTGOING = 0x1,
  32
  33     // Active NAT traversal using STUN.
  34     NAT_TRAVERSAL_STUN = 0x2,
  35
  36     // Allow the use of relay servers when a direct connection is not available.
  37     NAT_TRAVERSAL_RELAY = 0x4,
  38
  39     // Active NAT traversal using STUN and relay servers.
  40     NAT_TRAVERSAL_FULL = NAT_TRAVERSAL_STUN | NAT_TRAVERSAL_RELAY |
  41         NAT_TRAVERSAL_OUTGOING
  42   };
  43
  44   NetworkSettings()
  45       : flags(NAT_TRAVERSAL_DISABLED),
  46         min_port(0),
  47         max_port(0) {
  48     DCHECK(!(flags & (NAT_TRAVERSAL_STUN | NAT_TRAVERSAL_RELAY)) ||
  49            (flags & NAT_TRAVERSAL_OUTGOING));
  50   }
  51
  52   explicit NetworkSettings(uint32 flags)
  53       : flags(flags),
  54         min_port(0),
  55         max_port(0) {
  56   }
  57
  58   // Parse string in the form "<min_port>-<max_port>". E.g. "12400-12409".
  59   // Returns true if string was parsed successfuly.
  60   static bool ParsePortRange(const std::string& port_range,
  61                              int* out_min_port,
  62                              int* out_max_port);
  63
  64   uint32 flags;
  65
  66   // |min_port| and |max_port| specify range (inclusive) of ports used by
  67   // P2P sessions. Any port can be used when both values are set to 0.
  68   int min_port;
  69   int max_port;
  70 };
  71
  72 }  // namespace remoting
  73
  74 #endif  // REMOTING_HOST_NETWORK_SETTINGS_H_