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, |
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 | |
37 // Initializes DLL pre-reading options from the registry. | |
38 // |product_registry_path| is the registry path under which the registry key for | |
39 // this field trial resides. | |
40 void InitializePreReadOptions(const base::string16& product_registry_path); | |
41 | |
42 // Returns the DLL pre-reading options to use for the current process. | |
gab
2016/01/20 20:09:40
Returns the bitfield of the DLL pre-reading option
fdoray
2016/01/20 21:58:53
Done.
| |
43 // InitializePreReadOptions() must have been called before this. | |
44 int GetPreReadOptions(); | |
35 | 45 |
36 // Updates DLL pre-reading options in the registry with the latest info for the | 46 // 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 | 47 // next startup. |product_registry_path| is the registry path under which the |
38 // registry key for this field trial resides. | 48 // registry key for this field trial resides. |
39 void UpdatePreReadOptions(const base::string16& product_registry_path); | 49 void UpdatePreReadOptions(const base::string16& product_registry_path); |
40 | 50 |
41 // Registers a synthetic field trial with the PreRead group currently stored in | 51 // Registers a synthetic field trial with the PreRead group currently stored in |
42 // the registry. This must be done before the first metric log | 52 // the registry. This must be done before the first metric log |
43 // (metrics::MetricsLog) is created. Otherwise, UMA metrics generated during | 53 // (metrics::MetricsLog) is created. Otherwise, UMA metrics generated during |
44 // startup won't be correctly annotated. |product_registry_path| is the registry | 54 // startup won't be correctly annotated. |product_registry_path| is the registry |
45 // path under which the key for this field trial resides. | 55 // path under which the key for this field trial resides. |
46 void RegisterPreReadSyntheticFieldTrial( | 56 void RegisterPreReadSyntheticFieldTrial( |
47 const base::string16& product_registry_path, | 57 const base::string16& product_registry_path, |
48 const RegisterPreReadSyntheticFieldTrialCallback& | 58 const RegisterPreReadSyntheticFieldTrialCallback& |
49 register_synthetic_field_trial); | 59 register_synthetic_field_trial); |
50 | 60 |
51 } // namespace startup_metric_utils | 61 } // namespace startup_metric_utils |
52 | 62 |
53 #endif // COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN _H_ | 63 #endif // COMPONENTS_STARTUP_METRIC_UTILS_COMMON_PRE_READ_FIELD_TRIAL_UTILS_WIN _H_ |
OLD | NEW |