xref: /aosp_15_r20/external/cronet/net/http/alternate_protocol_usage.h (revision 6777b5387eb2ff775bb5750e3f5d96f37fb7352b)
1*6777b538SAndroid Build Coastguard Worker // Copyright 2022 The Chromium Authors
2*6777b538SAndroid Build Coastguard Worker // Use of this source code is governed by a BSD-style license that can be
3*6777b538SAndroid Build Coastguard Worker // found in the LICENSE file.
4*6777b538SAndroid Build Coastguard Worker 
5*6777b538SAndroid Build Coastguard Worker #ifndef NET_HTTP_ALTERNATE_PROTOCOL_USAGE_H_
6*6777b538SAndroid Build Coastguard Worker #define NET_HTTP_ALTERNATE_PROTOCOL_USAGE_H_
7*6777b538SAndroid Build Coastguard Worker 
8*6777b538SAndroid Build Coastguard Worker namespace net {
9*6777b538SAndroid Build Coastguard Worker 
10*6777b538SAndroid Build Coastguard Worker // The reason why Chrome uses a specific transport protocol for HTTP semantics.
11*6777b538SAndroid Build Coastguard Worker enum AlternateProtocolUsage {
12*6777b538SAndroid Build Coastguard Worker   // Alternate Protocol was used without racing a normal connection.
13*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_NO_RACE = 0,
14*6777b538SAndroid Build Coastguard Worker   // Alternate Protocol was used by winning a race with a normal connection.
15*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_WON_RACE = 1,
16*6777b538SAndroid Build Coastguard Worker   // Alternate Protocol was not used by losing a race with a normal connection.
17*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_MAIN_JOB_WON_RACE = 2,
18*6777b538SAndroid Build Coastguard Worker   // Alternate Protocol was not used because no Alternate-Protocol information
19*6777b538SAndroid Build Coastguard Worker   // was available when the request was issued, but an Alternate-Protocol header
20*6777b538SAndroid Build Coastguard Worker   // was present in the response.
21*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_MAPPING_MISSING = 3,
22*6777b538SAndroid Build Coastguard Worker   // Alternate Protocol was not used because it was marked broken.
23*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_BROKEN = 4,
24*6777b538SAndroid Build Coastguard Worker   // HTTPS DNS protocol upgrade job was used without racing with a normal
25*6777b538SAndroid Build Coastguard Worker   // connection and an Alternate Protocol job.
26*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_DNS_ALPN_H3_JOB_WON_WITHOUT_RACE = 5,
27*6777b538SAndroid Build Coastguard Worker   // HTTPS DNS protocol upgrade job won a race with a normal connection and
28*6777b538SAndroid Build Coastguard Worker   // an Alternate Protocol job.
29*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_DNS_ALPN_H3_JOB_WON_RACE = 6,
30*6777b538SAndroid Build Coastguard Worker   // This value is used when the reason is unknown and also used as the default
31*6777b538SAndroid Build Coastguard Worker   // value.
32*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_UNSPECIFIED_REASON = 7,
33*6777b538SAndroid Build Coastguard Worker   // Maximum value for the enum.
34*6777b538SAndroid Build Coastguard Worker   ALTERNATE_PROTOCOL_USAGE_MAX,
35*6777b538SAndroid Build Coastguard Worker };
36*6777b538SAndroid Build Coastguard Worker 
37*6777b538SAndroid Build Coastguard Worker }  // namespace net
38*6777b538SAndroid Build Coastguard Worker 
39*6777b538SAndroid Build Coastguard Worker #endif  // NET_HTTP_ALTERNATE_PROTOCOL_USAGE_H_
40