Add crashpad_database_util and its man page

client/crash_report_database_test.cc

 // 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 354 matching lines @@
   pending.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetPendingReports(&pending));
   completed.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetCompletedReports(&completed));
 
   EXPECT_EQ(4u, pending.size());
   ASSERT_EQ(1u, completed.size());
 
-  for (const auto& report : pending)
+  for (const auto& report : pending) {
     EXPECT_NE(report_1_uuid, report.uuid);
+    EXPECT_FALSE(report.file_path.empty());
+  }
   EXPECT_EQ(report_1_uuid, completed[0].uuid);
   EXPECT_EQ("report1", completed[0].id);
   EXPECT_EQ(true, completed[0].uploaded);
   EXPECT_GT(completed[0].last_upload_attempt_time, 0);
   EXPECT_EQ(1, completed[0].upload_attempts);
 
   // Fail to upload one report.
   UploadReport(report_2_uuid, false, std::string());
 
   pending.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetPendingReports(&pending));
   completed.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetCompletedReports(&completed));
 
   EXPECT_EQ(4u, pending.size());
   ASSERT_EQ(1u, completed.size());
 
   for (const auto& report : pending) {
     if (report.upload_attempts != 0) {
       EXPECT_EQ(report_2_uuid, report.uuid);
       EXPECT_GT(report.last_upload_attempt_time, 0);
       EXPECT_FALSE(report.uploaded);
       EXPECT_TRUE(report.id.empty());
     }
+    EXPECT_FALSE(report.file_path.empty());
   }
 
   // Upload a second report.
   UploadReport(report_4_uuid, true, "report_4");
 
   pending.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetPendingReports(&pending));
   completed.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
@@ skipping 11 matching lines @@
   completed.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetCompletedReports(&completed));
 
   EXPECT_EQ(2u, pending.size());
   ASSERT_EQ(3u, completed.size());
 
   for (const auto& report : pending) {
     EXPECT_TRUE(report.uuid == report_0_uuid ||
                 report.uuid == report_3_uuid);
+    EXPECT_FALSE(report.file_path.empty());
   }
 
   // Skip upload for one report.
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->SkipReportUpload(report_3_uuid));
 
   pending.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetPendingReports(&pending));
   completed.clear();
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetCompletedReports(&completed));
 
   ASSERT_EQ(1u, pending.size());
   ASSERT_EQ(4u, completed.size());
 
   EXPECT_EQ(report_0_uuid, pending[0].uuid);
 
   for (const auto& report : completed) {
     if (report.uuid == report_3_uuid) {
       EXPECT_FALSE(report.uploaded);
       EXPECT_EQ(0, report.upload_attempts);
       EXPECT_EQ(0, report.last_upload_attempt_time);
     } else {
       EXPECT_TRUE(report.uploaded);
       EXPECT_GT(report.upload_attempts, 0);
       EXPECT_GT(report.last_upload_attempt_time, 0);
     }
+    EXPECT_FALSE(report.file_path.empty());
   }
 }
 
 TEST_F(CrashReportDatabaseTest, DuelingUploads) {
   CrashReportDatabase::Report report;
   CreateCrashReport(&report);
 
   const CrashReportDatabase::Report* upload_report;
   EXPECT_EQ(CrashReportDatabase::kNoError,
             db()->GetReportForUploading(report.uuid, &upload_report));
@@ skipping 45 matching lines @@
       << ErrnoMessage("unlink");
 #endif
 
   EXPECT_EQ(CrashReportDatabase::kReportNotFound,
             db()->LookUpCrashReport(uuid, &report));
 }
 
 }  // namespace
 }  // namespace test
 }  // namespace crashpad