crashpad_database_util: Don’t create a database unless explicitly asked

client/crash_report_database.h

 // Copyright 2015 The Crashpad Authors. All rights reserved.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 147 matching lines @@
     //! database-wide settings. Additional information will be logged.
     kDatabaseError,
 
     //! \brief The operation could not be completed because a concurrent
     //!     operation affecting the report is occurring.
     kBusyError,
   };
 
   virtual ~CrashReportDatabase() {}
 
-  //! \brief Initializes a database of crash reports.
+  //! \brief Opens a database of crash reports, possibly creating it.
   //!
-  //! \param[in] path A path to the database to be created or opened.
+  //! \param[in] path A path to the database to be created or opened. If the
+  //!     database does not yet exist, it will be created if possible. Note that
+  //!     for databases implemented as directory structures, existence refers
+  //!     solely to the outermost directory.
   //!
   //! \return A database object on success, `nullptr` on failure with an error
   //!     logged.
+  //!
+  //! \sa InitializeWithoutCreating
   static scoped_ptr<CrashReportDatabase> Initialize(const base::FilePath& path);
 
+  //! \brief Opens an existing database of crash reports.
+  //!
+  //! \param[in] path A path to the database to be opened. If the database does
+  //!     not yet exist, it will not be created. Note that for databases
+  //!     implemented as directory structures, existence refers solely to the
+  //!     outermost directory. On such databases, as long as the outermost
+  //!     directory is present, this method will create the inner structure.
+  //!
+  //! \return A database object on success, `nullptr` on failure with an error
+  //!     logged.
+  //!
+  //! \sa Initialize
+  static scoped_ptr<CrashReportDatabase> InitializeWithoutCreating(
+      const base::FilePath& path);
+
   //! \brief Returns the Settings object for this database.
   //!
   //! \return A weak pointer to the Settings object, which is owned by the
   //!     database.
   virtual Settings* GetSettings() = 0;
 
   //! \brief Creates a record of a new crash report.
   //!
   //! Callers can then write the crash report using the file handle provided.
   //! The caller does not own the new crash report record or its file handle,
@@ skipping 124 matching lines @@
  protected:
   CrashReportDatabase() {}
 
  private:
   DISALLOW_COPY_AND_ASSIGN(CrashReportDatabase);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_CLIENT_CRASH_REPORT_DATABASE_H_