Remove support for specifying version on command line.
[chromium-blink-merge.git] / gpu / config / gpu_control_list_format.txt
blobe9522c34504d68ef866f4b03b51ba09b4b02eacd
1 // Copyright (c) 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.
5 // A valid gpu control list json file is in the format of
6 // {
7 //   "version": "x.y",
8 //   "entries": [
9 //     { // entry 1
10 //     },
11 //     ...
12 //     { // entry n
13 //     }
14 //   ]
15 // }
17 // Each entry contains the following fields (fields are optional unless
18 // specifically described as mandatory below):
19 // 1. "id" is an integer.  0 is reserved.  This field is mandatory.
20 // 2. "os" contains "type" and an optional "version". "type" could be "macosx",
21 //    "linux", "win", "chromeos", or "any".  "any" is the same as not specifying
22 //    "os".
23 //    "version" is a VERSION structure (defined below).
24 // 3. "vendor_id" is a string.  0 is reserved.
25 // 4. "device_id" is an array of strings.  0 is reserved.
26 // 5. "multi_gpu_style" is a string, valid values include "optimus", and
27 //    "amd_switchable".
28 // 6. "multi_gpu_category" is a string, valid values include "any", "primary",
29 //    and "secondary".  If unspecified, the default value is "primary".
30 // 7. "driver_vendor" is a STRING structure (defined below).
31 // 8. "driver_version" is a VERSION structure (defined below).
32 // 9. "driver_date" is a VERSION structure (defined below).
33 //    The version is interpreted as "year.month.day".
34 // 10. "gl_vendor" is a STRING structure (defined below).
35 // 11. "gl_renderer" is a STRING structure (defined below).
36 // 12. "gl_extensions" is a STRING structure (defined below).
37 // 13. "perf_graphics" is a FLOAT structure (defined below).
38 // 14. "perf_gaming" is a FLOAT structure (defined below).
39 // 15. "perf_overall" is a FLOAT structure (defined below).
40 // 16. "machine_model" contais "name" and an optional "version".  "name" is a
41 //     STRING structure and "version" is a VERSION structure (defined below).
42 // 17. "gpu_count" is a INT structure (defined below).
43 // 18  "cpu_info" is a STRING structure (defined below).
44 // 19. "exceptions" is a list of entries.
45 // 20. "features" is a list of gpu control list options, which can be
46 //     configured by a specific list. See its *_json.cc file for a list of
47 //     supported features. This field is mandatory.
48 // 21. "description" has the description of the entry.
49 // 22. "webkit_bugs" is an array of associated webkit bug numbers.
50 // 23. "cr_bugs" is an array of associated webkit bug numbers.
51 // 24. "disabled" is a boolean. If it is present, the entry will be skipped.
52 //     This can not be used in exceptions.
54 // VERSION includes "op", "style", "value", and "value2".  "op" can be any of
55 // the following values: "=", "<", "<=", ">", ">=", "any", "between".  "style"
56 // is optional and can be "lexical" or "numerical"; if it's not specified, it
57 // defaults to "numerical".  "value2" is only used if "op" is "between".
58 // "between" is "value <= * <= value2".
59 // "value" is used for all "op" values except "any". "value" and "value2"
60 // are in the format of x, x.x, x.x.x, etc.
61 // Only "driver_version" supports lexical style if the format is major.minor;
62 // in that case, major is still numerical, but minor is lexical. 
64 // STRING includes "op" and "value".  "op" can be any of the following values:
65 // "contains", "beginwith", "endwith", "=".  "value" is a string.
67 // FLOAT includes "op" "value", and "value2".  "op" can be any of the
68 // following values: "=", "<", "<=", ">", ">=", "any", "between".  "value2" is
69 // only used if "op" is "between".  "value" is used for all "op" values except
70 // "any". "value" and "value2" are valid float numbers.
71 // INT is very much like FLOAT, except that the values need to be integers.