ONC: add support for non-utf-8 SSIDs

chromeos/network/onc/onc_normalizer.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROMEOS_NETWORK_ONC_ONC_NORMALIZER_H_
 #define CHROMEOS_NETWORK_ONC_ONC_NORMALIZER_H_
 
 #include "base/memory/scoped_ptr.h"
 #include "chromeos/chromeos_export.h"
 #include "chromeos/network/onc/onc_mapper.h"
 
 namespace chromeos {
 namespace onc {
 
 struct OncValueSignature;
 
 class CHROMEOS_EXPORT Normalizer : public Mapper {
  public:
   explicit Normalizer(bool remove_recommended_fields);
   virtual ~Normalizer();
 
   // Removes all fields that are ignored/irrelevant because of the value of
   // other fields. E.g. the "WiFi" field is irrelevant if the configurations
   // type is "Ethernet". If |remove_recommended_fields| is true, kRecommended
   // arrays are removed (the array itself and not the field names listed
   // there). |object_signature| must point to one of the signatures in
-  // |onc_signature.h|.
+  // |onc_signature.h|. For configurations of type "WiFi", if the "SSID" field
+  // is set, but the field "HexSSID" is not, the contents of the "SSID" field is
+  // converted to UTF-8 encoding, a hex representation of the byte sequence is
+  // created and stored in the field "HexSSID".
   scoped_ptr<base::DictionaryValue> NormalizeObject(
       const OncValueSignature* object_signature,
       const base::DictionaryValue& onc_object);
 
  private:
   // Dispatch to the right normalization function according to |signature|.
   virtual scoped_ptr<base::DictionaryValue> MapObject(
       const OncValueSignature& signature,
       const base::DictionaryValue& onc_object,
       bool* error) override;
@@ skipping 10 matching lines @@
 
   const bool remove_recommended_fields_;
 
   DISALLOW_COPY_AND_ASSIGN(Normalizer);
 };
 
 }  // namespace onc
 }  // namespace chromeos
 
 #endif  // CHROMEOS_NETWORK_ONC_ONC_NORMALIZER_H_