net/socket/next_proto.h

   1 // Copyright (c) 2012 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 NET_SOCKET_NEXT_PROTO_H_
   6 #define NET_SOCKET_NEXT_PROTO_H_
   7
   8 #include <vector>
   9
  10 #include "net/base/net_export.h"
  11
  12 namespace net {
  13
  14 // Next Protocol Negotiation (NPN), if successful, results in agreement on an
  15 // application-level string that specifies the application level protocol to
  16 // use over the TLS connection. NextProto enumerates the application level
  17 // protocols that we recognize.  Do not change or reuse values, because they
  18 // are used to collect statistics on UMA.  Also, values must be in [0,499),
  19 // because of the way TLS protocol negotiation extension information is added to
  20 // UMA histogram.
  21 enum NextProto {
  22   kProtoUnknown = 0,
  23   kProtoHTTP11 = 1,
  24   kProtoMinimumVersion = kProtoHTTP11,
  25
  26   kProtoDeprecatedSPDY2 = 100,
  27   kProtoSPDYMinimumVersion = kProtoDeprecatedSPDY2,
  28   kProtoSPDYHistogramOffset = kProtoDeprecatedSPDY2,
  29   kProtoSPDY3 = 101,
  30   kProtoSPDY31 = 102,
  31   kProtoHTTP2_14 = 103,  // HTTP/2 draft-14, designated implementation draft.
  32   kProtoHTTP2MinimumVersion = kProtoHTTP2_14,
  33   // kProtoHTTP2_15 = 104,  // HTTP/2 draft-15
  34   // kProtoHTTP2_16 = 105,  // HTTP/2 draft-16
  35   // kProtoHTTP2_17 = 106,  // HTTP/2 draft-17
  36   kProtoHTTP2 = 107,  // HTTP/2, see https://tools.ietf.org/html/rfc7540.
  37   kProtoHTTP2MaximumVersion = kProtoHTTP2,
  38   kProtoSPDYMaximumVersion = kProtoHTTP2MaximumVersion,
  39
  40   kProtoQUIC1SPDY3 = 200,
  41
  42   kProtoMaximumVersion = kProtoQUIC1SPDY3,
  43 };
  44
  45 // List of protocols to use for NPN, used for configuring HttpNetworkSessions.
  46 typedef std::vector<NextProto> NextProtoVector;
  47
  48 // Convenience functions to create NextProtoVector.
  49
  50 // Default values, which are subject to change over time.
  51 NET_EXPORT NextProtoVector NextProtosDefaults();
  52
  53 // Enable SPDY/3.1 and QUIC, but not HTTP/2.
  54 NET_EXPORT NextProtoVector NextProtosSpdy31();
  55
  56 // Control SPDY/3.1 and HTTP/2 separately.
  57 NET_EXPORT NextProtoVector NextProtosWithSpdyAndQuic(bool spdy_enabled,
  58                                                      bool quic_enabled);
  59
  60 // Returns true if |next_proto| is a version of SPDY or HTTP/2.
  61 bool NextProtoIsSPDY(NextProto next_proto);
  62
  63 }  // namespace net
  64
  65 #endif  // NET_SOCKET_NEXT_PROTO_H_