15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/metrics/field_trial.h" 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)#include <algorithm> 8d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/build_time.h" 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/logging.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/rand_util.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/sha1.h" 13868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/strings/string_util.h" 14868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/strings/stringprintf.h" 15868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/strings/utf_string_conversions.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/sys_byteorder.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base { 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace { 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Created a time value based on |year|, |month| and |day_of_month| parameters. 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Time CreateTimeFromParams(int year, int month, int day_of_month) { 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GT(year, 1970); 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GT(month, 0); 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LT(month, 13); 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GT(day_of_month, 0); 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LT(day_of_month, 32); 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Time::Exploded exploded; 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.year = year; 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.month = month; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.day_of_week = 0; // Should be unused. 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.day_of_month = day_of_month; 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.hour = 0; 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.minute = 0; 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.second = 0; 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) exploded.millisecond = 0; 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return Time::FromLocalExploded(exploded); 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 43d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)// Returns the boundary value for comparing against the FieldTrial's added 44d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)// groups for a given |divisor| (total probability) and |entropy_value|. 45d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)FieldTrial::Probability GetGroupBoundaryValue( 46d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) FieldTrial::Probability divisor, 47d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) double entropy_value) { 48d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // Add a tiny epsilon value to get consistent results when converting floating 49d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // points to int. Without it, boundary values have inconsistent results, e.g.: 50d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // 51d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // static_cast<FieldTrial::Probability>(100 * 0.56) == 56 52d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // static_cast<FieldTrial::Probability>(100 * 0.57) == 56 53d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // static_cast<FieldTrial::Probability>(100 * 0.58) == 57 54d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // static_cast<FieldTrial::Probability>(100 * 0.59) == 59 55d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) const double kEpsilon = 1e-8; 56d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) const FieldTrial::Probability result = 57d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) static_cast<FieldTrial::Probability>(divisor * entropy_value + kEpsilon); 58d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) // Ensure that adding the epsilon still results in a value < |divisor|. 59d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles) return std::min(result, divisor - 1); 60d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)} 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 62d0247b1b59f9c528cb6df88b4f2b9afaf80d181eTorne (Richard Coles)} // namespace 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// statics 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int FieldTrial::kNotFinalized = -1; 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const int FieldTrial::kDefaultGroupNumber = 0; 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool FieldTrial::enable_benchmarking_ = false; 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char FieldTrialList::kPersistentStringSeparator('/'); 702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)int FieldTrialList::kNoExpirationYear = 0; 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// FieldTrial methods and members. 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial::EntropyProvider::~EntropyProvider() { 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrial::Disable() { 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!group_reported_); 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enable_field_trial_ = false; 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In case we are disabled after initialization, we need to switch 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the trial to the default group. 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (group_ != kNotFinalized) { 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Only reset when not already the default group, because in case we were 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // forced to the default group, the group number may not be 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // kDefaultGroupNumber, so we should keep it as is. 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (group_name_ != default_group_name_) 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SetGroupChoice(default_group_name_, kDefaultGroupNumber); 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int FieldTrial::AppendGroup(const std::string& name, 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Probability group_probability) { 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // When the group choice was previously forced, we only need to return the 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the id of the chosen group, and anything can be returned for the others. 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (forced_) { 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!group_name_.empty()); 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (name == group_name_) { 1002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Note that while |group_| may be equal to |kDefaultGroupNumber| on the 1012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // forced trial, it will not have the same value as the default group 1022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // number returned from the non-forced |FactoryGetFieldTrial()| call, 1032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // which takes care to ensure that this does not happen. 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return group_; 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_NE(next_group_number_, group_); 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We still return different numbers each time, in case some caller need 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // them to be different. 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return next_group_number_++; 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LE(group_probability, divisor_); 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GE(group_probability, 0); 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (enable_benchmarking_ || !enable_field_trial_) 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) group_probability = 0; 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) accumulated_group_probability_ += group_probability; 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_LE(accumulated_group_probability_, divisor_); 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (group_ == kNotFinalized && accumulated_group_probability_ > random_) { 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This is the group that crossed the random line, so we do the assignment. 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SetGroupChoice(name, next_group_number_); 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return next_group_number_++; 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int FieldTrial::group() { 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FinalizeGroupChoice(); 1301e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) if (trial_registered_) 1311e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) FieldTrialList::NotifyFieldTrialGroupSelection(this); 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return group_; 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1352a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)const std::string& FieldTrial::group_name() { 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Call |group()| to ensure group gets assigned and observers are notified. 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) group(); 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!group_name_.empty()); 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return group_name_; 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrial::SetForced() { 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // We might have been forced before (e.g., by CreateFieldTrial) and it's 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // first come first served, e.g., command line switch has precedence. 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (forced_) 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // And we must finalize the group choice before we mark ourselves as forced. 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FinalizeGroupChoice(); 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) forced_ = true; 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1531e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// static 1541e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)void FieldTrial::EnableBenchmarking() { 1551e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK_EQ(0u, FieldTrialList::GetFieldTrialCount()); 1561e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) enable_benchmarking_ = true; 1571e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)} 1581e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 1591e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)// static 1601e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)FieldTrial* FieldTrial::CreateSimulatedFieldTrial( 1611e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const std::string& trial_name, 1621e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) Probability total_probability, 1631e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const std::string& default_group_name, 1641e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) double entropy_value) { 1651e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) return new FieldTrial(trial_name, total_probability, default_group_name, 1661e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) entropy_value); 1671e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)} 1681e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 1691e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)FieldTrial::FieldTrial(const std::string& trial_name, 1701e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const Probability total_probability, 1711e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) const std::string& default_group_name, 1721e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) double entropy_value) 1731e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) : trial_name_(trial_name), 1741e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) divisor_(total_probability), 1751e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) default_group_name_(default_group_name), 1761e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) random_(GetGroupBoundaryValue(total_probability, entropy_value)), 1771e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) accumulated_group_probability_(0), 1781e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) next_group_number_(kDefaultGroupNumber + 1), 1791e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) group_(kNotFinalized), 1801e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) enable_field_trial_(true), 1811e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) forced_(false), 1821e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) group_reported_(false), 1831e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) trial_registered_(false) { 1841e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK_GT(total_probability, 0); 1851e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK(!trial_name_.empty()); 1861e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK(!default_group_name_.empty()); 1871e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)} 1881e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial::~FieldTrial() {} 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1911e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)void FieldTrial::SetTrialRegistered() { 1921e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK_EQ(kNotFinalized, group_); 1931e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) DCHECK(!trial_registered_); 1941e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) trial_registered_ = true; 1951e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles)} 1961e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) 1972a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void FieldTrial::SetGroupChoice(const std::string& group_name, int number) { 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) group_ = number; 1992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) if (group_name.empty()) 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StringAppendF(&group_name_, "%d", group_); 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) else 2022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) group_name_ = group_name; 2032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DVLOG(1) << "Field trial: " << trial_name_ << " Group choice:" << group_name_; 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrial::FinalizeGroupChoice() { 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (group_ != kNotFinalized) 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 2095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) accumulated_group_probability_ = divisor_; 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Here it's OK to use |kDefaultGroupNumber| since we can't be forced and not 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // finalized. 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!forced_); 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SetGroupChoice(default_group_name_, kDefaultGroupNumber); 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool FieldTrial::GetActiveGroup(ActiveGroup* active_group) const { 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!group_reported_ || !enable_field_trial_) 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_NE(group_, kNotFinalized); 2202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) active_group->trial_name = trial_name_; 2212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) active_group->group_name = group_name_; 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return true; 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//------------------------------------------------------------------------------ 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// FieldTrialList methods and members. 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrialList* FieldTrialList::global_ = NULL; 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool FieldTrialList::used_without_global_ = false; 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrialList::Observer::~Observer() { 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrialList::FieldTrialList( 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const FieldTrial::EntropyProvider* entropy_provider) 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : entropy_provider_(entropy_provider), 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) observer_list_(new ObserverListThreadSafe<FieldTrialList::Observer>( 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ObserverListBase<FieldTrialList::Observer>::NOTIFY_EXISTING_ONLY)) { 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!global_); 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(!used_without_global_); 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) global_ = this; 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) Time two_years_from_build_time = GetBuildTime() + TimeDelta::FromDays(730); 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Time::Exploded exploded; 2482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) two_years_from_build_time.LocalExplode(&exploded); 2492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) kNoExpirationYear = exploded.year; 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrialList::~FieldTrialList() { 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AutoLock auto_lock(lock_); 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) while (!registered_.empty()) { 2555d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) RegistrationMap::iterator it = registered_.begin(); 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) it->second->Release(); 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) registered_.erase(it->first); 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_EQ(this, global_); 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) global_ = NULL; 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial* FieldTrialList::FactoryGetFieldTrial( 265d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const std::string& trial_name, 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial::Probability total_probability, 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& default_group_name, 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const int year, 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const int month, 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const int day_of_month, 271d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch FieldTrial::RandomizationType randomization_type, 272d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch int* default_group_number) { 273d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch return FactoryGetFieldTrialWithRandomizationSeed( 274d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch trial_name, total_probability, default_group_name, 275d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch year, month, day_of_month, randomization_type, 0, default_group_number); 276d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch} 277d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch 278d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch// static 279d3868032626d59662ff73b372b5d584c1d144c53Ben MurdochFieldTrial* FieldTrialList::FactoryGetFieldTrialWithRandomizationSeed( 280d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const std::string& trial_name, 281d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch FieldTrial::Probability total_probability, 282d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const std::string& default_group_name, 283d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const int year, 284d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const int month, 285d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch const int day_of_month, 286d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch FieldTrial::RandomizationType randomization_type, 287d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch uint32 randomization_seed, 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int* default_group_number) { 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (default_group_number) 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) *default_group_number = FieldTrial::kDefaultGroupNumber; 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Check if the field trial has already been created in some other way. 292d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch FieldTrial* existing_trial = Find(trial_name); 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (existing_trial) { 2945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECK(existing_trial->forced_); 2952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // If the default group name differs between the existing forced trial 2962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // and this trial, then use a different value for the default group number. 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (default_group_number && 2982a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) default_group_name != existing_trial->default_group_name()) { 2992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // If the new default group number corresponds to the group that was 3002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // chosen for the forced trial (which has been finalized when it was 3012a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // forced), then set the default group number to that. 3022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) if (default_group_name == existing_trial->group_name_internal()) { 3032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) *default_group_number = existing_trial->group_; 3042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } else { 3052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Otherwise, use |kNonConflictingGroupNumber| (-2) for the default 3062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // group number, so that it does not conflict with the |AppendGroup()| 3072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // result for the chosen group. 3082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const int kNonConflictingGroupNumber = -2; 3092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) COMPILE_ASSERT( 3102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) kNonConflictingGroupNumber != FieldTrial::kDefaultGroupNumber, 3112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) conflicting_default_group_number); 3122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) COMPILE_ASSERT( 3132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) kNonConflictingGroupNumber != FieldTrial::kNotFinalized, 3142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) conflicting_default_group_number); 3152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) *default_group_number = kNonConflictingGroupNumber; 3162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return existing_trial; 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 321d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch double entropy_value; 322d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch if (randomization_type == FieldTrial::ONE_TIME_RANDOMIZED) { 323d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch entropy_value = GetEntropyProviderForOneTimeRandomization()-> 324d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch GetEntropyForTrial(trial_name, randomization_seed); 325d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch } else { 326d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch DCHECK_EQ(FieldTrial::SESSION_RANDOMIZED, randomization_type); 327d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch DCHECK_EQ(0U, randomization_seed); 328d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch entropy_value = RandDouble(); 329d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch } 330d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch 331d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch FieldTrial* field_trial = new FieldTrial(trial_name, total_probability, 332d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch default_group_name, entropy_value); 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (GetBuildTime() > CreateTimeFromParams(year, month, day_of_month)) 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) field_trial->Disable(); 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrialList::Register(field_trial); 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return field_trial; 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial* FieldTrialList::Find(const std::string& name) { 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AutoLock auto_lock(global_->lock_); 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return global_->PreLockedFind(name); 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int FieldTrialList::FindValue(const std::string& name) { 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial* field_trial = Find(name); 3505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (field_trial) 3515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return field_trial->group(); 3525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return FieldTrial::kNotFinalized; 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)std::string FieldTrialList::FindFullName(const std::string& name) { 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial* field_trial = Find(name); 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (field_trial) 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return field_trial->group_name(); 360c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) return std::string(); 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)bool FieldTrialList::TrialExists(const std::string& name) { 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return Find(name) != NULL; 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrialList::StatesToString(std::string* output) { 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial::ActiveGroups active_groups; 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) GetActiveFieldTrialGroups(&active_groups); 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) for (FieldTrial::ActiveGroups::const_iterator it = active_groups.begin(); 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) it != active_groups.end(); ++it) { 3742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DCHECK_EQ(std::string::npos, 3752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) it->trial_name.find(kPersistentStringSeparator)); 3762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DCHECK_EQ(std::string::npos, 3772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) it->group_name.find(kPersistentStringSeparator)); 3782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) output->append(it->trial_name); 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) output->append(1, kPersistentStringSeparator); 3802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) output->append(it->group_name); 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) output->append(1, kPersistentStringSeparator); 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrialList::GetActiveFieldTrialGroups( 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial::ActiveGroups* active_groups) { 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(active_groups->empty()); 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AutoLock auto_lock(global_->lock_); 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3935d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) for (RegistrationMap::iterator it = global_->registered_.begin(); 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) it != global_->registered_.end(); ++it) { 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial::ActiveGroup active_group; 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (it->second->GetActiveGroup(&active_group)) 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) active_groups->push_back(active_group); 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 4025d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)bool FieldTrialList::CreateTrialsFromString( 4035d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) const std::string& trials_string, 4045d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) FieldTrialActivationMode mode, 4055d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) const std::set<std::string>& ignored_trial_names) { 4065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(global_); 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (trials_string.empty() || !global_) 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return true; 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t next_item = 0; 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) while (next_item < trials_string.length()) { 4125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t name_end = trials_string.find(kPersistentStringSeparator, next_item); 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (name_end == trials_string.npos || next_item == name_end) 4145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 4155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t group_name_end = trials_string.find(kPersistentStringSeparator, 4165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) name_end + 1); 4171320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci if (name_end + 1 == group_name_end) 4185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 4191320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci if (group_name_end == trials_string.npos) 4201320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci group_name_end = trials_string.length(); 4215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string name(trials_string, next_item, name_end - next_item); 4225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string group_name(trials_string, name_end + 1, 4235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) group_name_end - name_end - 1); 4245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) next_item = group_name_end + 1; 4255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4265d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) if (ignored_trial_names.find(name) != ignored_trial_names.end()) 4275d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) continue; 4285d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 4292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) FieldTrial* trial = CreateFieldTrial(name, group_name); 4302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) if (!trial) 4315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 432eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch if (mode == ACTIVATE_TRIALS) { 433eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch // Call |group()| to mark the trial as "used" and notify observers, if 434eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch // any. This is useful to ensure that field trials created in child 435eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch // processes are properly reported in crash reports. 436eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch trial->group(); 437eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch } 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 4395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return true; 4405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 4435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial* FieldTrialList::CreateFieldTrial( 4445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& name, 4455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& group_name) { 4465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(global_); 4475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GE(name.size(), 0u); 4485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK_GE(group_name.size(), 0u); 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (name.empty() || group_name.empty() || !global_) 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 4515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrial* field_trial = FieldTrialList::Find(name); 4535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (field_trial) { 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In single process mode, or when we force them from the command line, 4555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // we may have already created the field trial. 4565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (field_trial->group_name_internal() != group_name) 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 4585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return field_trial; 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 4605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const int kTotalProbability = 100; 461d3868032626d59662ff73b372b5d584c1d144c53Ben Murdoch field_trial = new FieldTrial(name, kTotalProbability, group_name, 0); 4621e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) FieldTrialList::Register(field_trial); 4632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Force the trial, which will also finalize the group choice. 4642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) field_trial->SetForced(); 4655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return field_trial; 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrialList::AddObserver(Observer* observer) { 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) global_->observer_list_->AddObserver(observer); 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 4765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrialList::RemoveObserver(Observer* observer) { 4775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 4785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) global_->observer_list_->RemoveObserver(observer); 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 4815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 4832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)void FieldTrialList::NotifyFieldTrialGroupSelection(FieldTrial* field_trial) { 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 4862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) { 4882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) AutoLock auto_lock(global_->lock_); 4892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) if (field_trial->group_reported_) 4902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return; 4912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) field_trial->group_reported_ = true; 4922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) } 4932a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) if (!field_trial->enable_field_trial_) 4952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) return; 4962a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) global_->observer_list_->Notify( 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) &FieldTrialList::Observer::OnFieldTrialGroupFinalized, 4992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) field_trial->trial_name(), 5002a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) field_trial->group_name_internal()); 5015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 5025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 5045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)size_t FieldTrialList::GetFieldTrialCount() { 5055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) 5065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return 0; 5075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AutoLock auto_lock(global_->lock_); 5085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return global_->registered_.size(); 5095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 5105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 5125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const FieldTrial::EntropyProvider* 5135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FieldTrialList::GetEntropyProviderForOneTimeRandomization() { 5145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) { 5155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) used_without_global_ = true; 5165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 5175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 5185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return global_->entropy_provider_.get(); 5205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 5215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)FieldTrial* FieldTrialList::PreLockedFind(const std::string& name) { 5235d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) RegistrationMap::iterator it = registered_.find(name); 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (registered_.end() == it) 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return NULL; 5265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return it->second; 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// static 5305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void FieldTrialList::Register(FieldTrial* trial) { 5315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!global_) { 5325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) used_without_global_ = true; 5335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return; 5345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AutoLock auto_lock(global_->lock_); 5362a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DCHECK(!global_->PreLockedFind(trial->trial_name())); 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) trial->AddRef(); 5381e9bf3e0803691d0a228da41fc608347b6db4340Torne (Richard Coles) trial->SetTrialRegistered(); 5392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) global_->registered_[trial->trial_name()] = trial; 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace base 543