Create the crash key registration system and register some Mac-specific keys.

base/debug/crash_logging.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 BASE_DEBUG_CRASH_LOGGING_H_
 #define BASE_DEBUG_CRASH_LOGGING_H_
 
 #include <string>
 
 #include "base/base_export.h"
@@ skipping 33 matching lines @@
  public:
   ScopedCrashKey(const base::StringPiece& key, const base::StringPiece& value);
   ~ScopedCrashKey();
 
  private:
   std::string key_;
 
   DISALLOW_COPY_AND_ASSIGN(ScopedCrashKey);
 };
 
+// Before setting values for a key, all the keys must be registered.
+struct BASE_EXPORT CrashKey {
+  // The name of the crash key, used in the above functions.
+  const char* const key_name;
+
+  // For values longer than max_length, the value can be chunked into values
+  // named "key_name-1", "key_name-2", etc. This is the maximum number of
+  // numbered chunks to use before the value is truncated.
+  size_t num_chunks;
+
+  // The maximum length of a single chunk. Truncation happens if the value is
+  // greater than |num_chunks * max_length|.
+  size_t max_length;
+};
+
+// Before the crash key logging mechanism can be used, all crash keys must be
+// registered with this function. The crash reporting implementation should
+// allocate space for exactly |out_key_storage_size| crash keys.
+BASE_EXPORT void InitCrashKeys(const CrashKey* const keys, size_t count,
+                               size_t* out_key_storage_size);

[Scott Hess - ex-Googler, 2013/01/09 22:34:20]

I'm still -1 on having a size_t* out parameter when your return value is void. 
Might as well just return the value, the caller can ignore it.

[Robert Sesek, 2013/01/09 23:06:30]

OK, I don't feel strongly enough to argue ;). Done.

+
+// Returns the correspnding crash key object or NULL for a given key.
+BASE_EXPORT const CrashKey* LookupCrashKey(const base::StringPiece& key);
+
 typedef void (*SetCrashKeyValueFuncT)(const base::StringPiece&,
                                       const base::StringPiece&);
 typedef void (*ClearCrashKeyValueFuncT)(const base::StringPiece&);
 
 // Sets the function pointers that are used to integrate with the platform-
 // specific crash reporting libraries.
 BASE_EXPORT void SetCrashKeyReportingFunctions(
     SetCrashKeyValueFuncT set_key_func,
     ClearCrashKeyValueFuncT clear_key_func);
 
+// Helper function that breaks up a value according to the parameters
+// specified by the crash key object.
+BASE_EXPORT std::vector<std::string> ChunkCrashKeyValue(
+    const CrashKey& crash_key, const base::StringPiece& value);
+
+// Resets the crash key system so it can be reinitialized. For testing only.
+BASE_EXPORT void ResetCrashLoggingForTesting();
+
 }  // namespace debug
 }  // namespace base
 
 #endif  // BASE_DEBUG_CRASH_LOGGING_H_