split port_util.h off of net_util.h

net/base/port_util.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-#ifndef NET_URL_REQUEST_HTTP_USER_AGENT_SETTINGS_H_
-#define NET_URL_REQUEST_HTTP_USER_AGENT_SETTINGS_H_
+#ifndef NET_BASE_NET_PORT_UTIL_
+#define NET_BASE_NET_PORT_UTIL_
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "net/base/net_export.h"
 
-class GURL;
-
 namespace net {
 
-// The interface used by HTTP jobs to retrieve HTTP Accept-Language
-// and User-Agent header values.
-class NET_EXPORT HttpUserAgentSettings {
+// Checks if |port| is in the valid range (0 to 65535, though 0 is technically
+// reserved).  Should be used before casting a port to a uint16_t.
+NET_EXPORT bool IsPortValid(int port);
+
+// Returns true if the port is in the range [0, 1023]. These ports are
+// registered by IANA and typically need root access to listen on.
+bool IsWellKnownPort(int port);
+
+// Checks if the port is allowed for the specified scheme.  Ports set as allowed
+// with SetExplicitlyAllowedPorts() or by using ScopedPortException() will be
+// considered allowed for any scheme.
+NET_EXPORT bool IsPortAllowedForScheme(int port, const std::string& url_scheme);
+
+// Returns the number of explicitly allowed ports; for testing.
+NET_EXPORT_PRIVATE size_t GetCountOfExplicitlyAllowedPorts();
+
+NET_EXPORT void SetExplicitlyAllowedPorts(const std::string& allowed_ports);
+
+class NET_EXPORT ScopedPortException {
  public:
-  HttpUserAgentSettings() {}
-  virtual ~HttpUserAgentSettings() {}
-
-  // Gets the value of 'Accept-Language' header field.
-  virtual std::string GetAcceptLanguage() const = 0;
-
-  // Gets the UA string.
-  virtual std::string GetUserAgent() const = 0;
+  explicit ScopedPortException(int port);
+  ~ScopedPortException();
 
  private:
-  DISALLOW_COPY_AND_ASSIGN(HttpUserAgentSettings);
+  int port_;
+
+  DISALLOW_COPY_AND_ASSIGN(ScopedPortException);
 };
 
 }  // namespace net
 
-#endif  // NET_URL_REQUEST_HTTP_USER_AGENT_SETTINGS_H_
-
+#endif  // NET_BASE_NET_PORT_UTIL_