mirror of
https://github.com/chromium/crashpad.git
synced 2024-12-31 01:43:03 +08:00
5de461e8c8
BUG=crashpad:1 R=mark@chromium.org Review URL: https://codereview.chromium.org/1314093002 .
114 lines
4.4 KiB
Plaintext
114 lines
4.4 KiB
Plaintext
// Copyright 2014 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,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
:doctype: manpage
|
||
|
||
= crashpad_handler(8)
|
||
|
||
== Name
|
||
|
||
crashpad_handler - Crashpad’s exception handler server
|
||
|
||
== Synopsis
|
||
|
||
[verse]
|
||
*crashpad_handler* ['OPTION…']
|
||
|
||
== Description
|
||
|
||
This program is Crashpad’s main exception-handling server. It is responsible for
|
||
catching exceptions, writing crash reports, and uploading them to a crash report
|
||
collection server. Uploads are disabled by default, and can only be enabled by a
|
||
Crashpad client using the Crashpad client library, typically in response to a
|
||
user requesting this behavior.
|
||
|
||
This server is normally started by its initial client, and it performs a
|
||
handshake with this client via a pipe established by the client that is
|
||
inherited by the server, referenced by the *--handshake-fd* argument. During the
|
||
handshake, the server furnishes the client with a send right that the client may
|
||
use as an exception port. The server retains the corresponding receive right,
|
||
which it monitors for exception messages. When the receive right loses all
|
||
senders, the server exits after allowing any upload in progress to complete.
|
||
|
||
It is not normally appropriate to invoke this program directly. Usually, it will
|
||
be invoked by a Crashpad client using the Crashpad client library. Arbitrary
|
||
programs may be run with a Crashpad handler by using
|
||
man_link:run_with_crashpad[1] to establish the Crashpad client environment
|
||
before running a program.
|
||
|
||
== Options
|
||
*--annotation*='KEY=VALUE'::
|
||
Sets a process-level annotation mapping 'KEY' to 'VALUE' in each crash report
|
||
that is written. This option may appear zero, one, or multiple times.
|
||
+
|
||
Most annotations should be provided by the Crashpad client as module-level
|
||
annotations instead of process-level annotations. Module-level annotations are
|
||
more flexible in that they can be modified and cleared during the client
|
||
program’s lifetime. Module-level annotations can be set via the Crashpad client
|
||
library. Process-level annotations are useful for annotations that the
|
||
collection server requires be present, that have fixed values, and for cases
|
||
where a program that does not use the Crashpad client library is being
|
||
monitored.
|
||
+
|
||
Breakpad-type collection servers only require the +"prod"+ and +"ver"+
|
||
annotations, which should be set to the product name or identifier and product
|
||
version, respectively. It is unusual to specify other annotations as
|
||
process-level annotations via this argument.
|
||
|
||
*--database*='PATH'::
|
||
Use 'PATH' as the path to the Crashpad crash report database. This option is
|
||
required. Crash reports are written to this database, and if uploads are
|
||
enabled, uploaded from this database to a crash report collection server. If the
|
||
database does not exist, it will be created, provided that the parent directory
|
||
of 'PATH' exists.
|
||
|
||
*--handshake-fd*='FD'::
|
||
Perform the handshake with the initial client on the file descriptor at 'FD'.
|
||
This option is required. This option is only valid on Mac OS X.
|
||
|
||
*--pipe-name*='PIPE'::
|
||
Listen on the given pipe name for connections from clients. 'PIPE' must be of
|
||
the form +\\.\pipe\<somename>+. This option is required. This option is only
|
||
valid on Windows.
|
||
|
||
*--url*='URL'::
|
||
If uploads are enabled, sends crash reports to the Breakpad-type crash report
|
||
collection server at 'URL'. Uploads are disabled by default, and can only be
|
||
enabled for a database by a Crashpad client using the Crashpad client library,
|
||
typically in response to a user requesting this behavior. If this option is not
|
||
specified, this program will behave as if uploads are disabled.
|
||
|
||
*--help*::
|
||
Display help and exit.
|
||
|
||
*--version*::
|
||
Output version information and exit.
|
||
|
||
== Exit Status
|
||
|
||
*0*::
|
||
Success.
|
||
|
||
*1*::
|
||
Failure, with a message printed to the standard error stream.
|
||
|
||
== See Also
|
||
|
||
man_link:catch_exception_tool[1],
|
||
man_link:crashpad_database_util[1],
|
||
man_link:generate_dump[1],
|
||
man_link:run_with_crashpad[1]
|
||
|
||
include::../../doc/support/man_footer.ad[]
|