OLD | NEW |
---|---|
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN_H_ | 5 #ifndef COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN_H_ |
6 #define COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN_H_ | 6 #define COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/callback_forward.h" | 10 #include "base/callback_forward.h" |
11 #include "base/strings/string16.h" | 11 #include "base/strings/string16.h" |
12 | 12 |
13 // Utility functions to support the PreRead field trial. The PreRead field trial | 13 // Utility functions to support the PreRead field trial. The PreRead field trial |
14 // changes the way DLLs are pre-read during startup. | 14 // changes the way DLLs are pre-read during startup. |
15 | 15 |
16 namespace startup_metric_utils { | 16 namespace startup_metric_utils { |
17 | 17 |
18 // Callback to register a synthetic field trial. | 18 // Callback to register a synthetic field trial. |
19 using RegisterPreReadSyntheticFieldTrialCallback = | 19 using RegisterPreReadSyntheticFieldTrialCallback = |
20 const base::Callback<bool(const std::string&, const std::string&)>; | 20 const base::Callback<bool(const std::string&, const std::string&)>; |
21 | 21 |
22 // Get DLL pre-reading options. |product_registry_path| is the registry path | 22 // The options controlled by the PreRead field trial. |
23 // under which the registry key for this field trial resides. The |no_pre_read| | 23 enum PreReadOptions { |
24 // option is set if DLLs should not be pre-read. The |high_priority| option is | 24 // No explicit DLL pre-reading. |
25 // set if pre-reading should be done with a high thread priority. The | 25 PRE_READ_OPTION_NO_PRE_READ = 1 << 0, |
grt (UTC plus 2)
2016/01/21 04:24:00
use a series of "const uint32_t kFooTheBar = n;" v
fdoray
2016/01/21 16:04:16
Done (now using a struct).
| |
26 // |only_if_cold| option is set if only cold DLLs should be pre-read. The | 26 |
27 // |prefetch_virtual_memory| option is set if the | 27 // Pre-read DLLs with a high thread priority. |
28 // ::PrefetchVirtualMemory function should be used to pre-read DLLs, if | 28 PRE_READ_OPTION_HIGH_PRIORITY = 1 << 1, |
29 // available. | 29 |
30 void GetPreReadOptions(const base::string16& product_registry_path, | 30 // Pre-read DLLs only when they are cold. |
31 bool* no_pre_read, | 31 PRE_READ_OPTION_ONLY_IF_COLD = 1 << 2, |
32 bool* high_priority, | 32 |
33 bool* only_if_cold, | 33 // Pre-read DLLs using the ::PrefetchVirtualMemory function, if available. |
34 bool* prefetch_virtual_memory); | 34 PRE_READ_OPTION_PREFETCH_VIRTUAL_MEMORY = 1 << 3, |
35 | |
36 // Set when the pre-read options have not been initialized yet. | |
37 PRE_READ_OPTION_UNINITIALIZED = 1 << 4, | |
38 }; | |
39 | |
40 // Initializes DLL pre-reading options from the registry. | |
41 // |product_registry_path| is the registry path under which the registry key for | |
42 // this field trial resides. | |
43 void InitializePreReadOptions(const base::string16& product_registry_path); | |
44 | |
45 // Returns the bitfield of the DLL pre-reading options to use for the current | |
46 // process. InitializePreReadOptions() must have been called before this. | |
47 int GetPreReadOptions(); | |
grt (UTC plus 2)
2016/01/21 04:24:00
use uint32_t rather than int for the bitfield. bit
fdoray
2016/01/21 16:04:16
Done (now using a struct).
| |
35 | 48 |
36 // Updates DLL pre-reading options in the registry with the latest info for the | 49 // Updates DLL pre-reading options in the registry with the latest info for the |
37 // next startup. |product_registry_path| is the registry path under which the | 50 // next startup. |product_registry_path| is the registry path under which the |
38 // registry key for this field trial resides. | 51 // registry key for this field trial resides. |
39 void UpdatePreReadOptions(const base::string16& product_registry_path); | 52 void UpdatePreReadOptions(const base::string16& product_registry_path); |
40 | 53 |
41 // Registers a synthetic field trial with the PreRead group currently stored in | 54 // Registers a synthetic field trial with the PreRead group currently stored in |
42 // the registry. This must be done before the first metric log | 55 // the registry. This must be done before the first metric log |
43 // (metrics::MetricsLog) is created. Otherwise, UMA metrics generated during | 56 // (metrics::MetricsLog) is created. Otherwise, UMA metrics generated during |
44 // startup won't be correctly annotated. |product_registry_path| is the registry | 57 // startup won't be correctly annotated. |product_registry_path| is the registry |
45 // path under which the key for this field trial resides. | 58 // path under which the key for this field trial resides. |
46 void RegisterPreReadSyntheticFieldTrial( | 59 void RegisterPreReadSyntheticFieldTrial( |
47 const base::string16& product_registry_path, | 60 const base::string16& product_registry_path, |
48 const RegisterPreReadSyntheticFieldTrialCallback& | 61 const RegisterPreReadSyntheticFieldTrialCallback& |
49 register_synthetic_field_trial); | 62 register_synthetic_field_trial); |
50 | 63 |
51 } // namespace startup_metric_utils | 64 } // namespace startup_metric_utils |
52 | 65 |
53 #endif // COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN _H_ | 66 #endif // COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN _H_ |
OLD | NEW |