crashpad_database_util: add --new-report

tools/crashpad_database_util.ad

 // 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 31 matching lines @@
 
 == Options
 *-d*, *--database*='PATH'::
 Use 'PATH' as the path to the Crashpad crash report database. This option is
 required. If the database does not exist, it will be created, provided that the
 parent directory of 'PATH' exists.
 
 *--show-client-id*::
 Show the client ID stored in the database’s settings. The client ID is formatted
 as a UUID. The client ID is set when the database is created.
+man_link:crashpad_handler[8] retrieves the client ID and stores it in crash
+reports as they are written.
 
 *--show-uploads-enabled*::
 Show the status of the uploads-enabled bit stored in the database’s settings.
 man_link:crashpad_handler[8] does not upload reports when this bit is false.
 This bit is false when a database is created, and is under an application’s
 control via the Crashpad client library interface.
 +
 See also *--set-uploads-enabled*.
 
 *--show-last-upload-attempt-time*::
@@ skipping 17 matching lines @@
 *--show-all-report-info*::
 With *--show-pending-reports* or *--show-completed-reports*, show all metadata
 for each report displayed. Without this option, only report IDs will be shown.
 
 *--show-report*='UUID'::
 Show a report from the database looked up by its identifier, 'UUID', which must
 be formatted in string representation per RFC 4122 §3. All metadata for each
 report found via a *--show-report* option will be shown. If 'UUID' is not found,
 the string +"not found"+ will be printed. If this program is only requested to
 show a single report and it is not found, it will treat this as a failure for
-the purposes of determining its exit status.
+the purposes of determining its exit status. This option may appear multiple
+times.
 
 *--set-report-uploads-enabled*='BOOL'::
 Enable or disable report upload in the database’s settings. 'BOOL' is a string
 representation of a boolean value, such as +"0"+ or +"true"+.
 +
 See also *--show-uploads-enabled*.
 
 *--set-last-upload-attempt-time*='TIME'::
 Set the last-upload-attempt time in the database’s settings. 'TIME' is a string
 representation of a time, which may be in 'yyyy-mm-dd hh:mm:ss' format, a
 numeric +time_t+ value, or the special string +"never"+.
 +
 See also *--show-last-upload-attempt-time*.
 
+*--new-report*='PATH'::
+Submit a new report located at 'PATH' to the database. The new report will be in
+the “pending” state. The UUID assigned to the new report will be printed. This
+option may appear multiple times.
+
 *--utc*::
 When showing times, do so in UTC as opposed to the local time zone. When setting
 times, interpret ambiguous time strings in UTC as opposed to the local time
 zone.
 
 *--help*::
 Display help and exit.
 
 *--version*::
 Output version information and exit.
@@ skipping 28 matching lines @@
 Success.
 
 *1*::
 Failure, with a message printed to the standard error stream.
 
 == See Also
 
 man_link:crashpad_handler[8]
 
 include::../../doc/man_footer.ad[]