| Index: third_party/crashpad/crashpad/tools/mac/run_with_crashpad.ad
|
| diff --git a/third_party/crashpad/crashpad/tools/mac/run_with_crashpad.ad b/third_party/crashpad/crashpad/tools/mac/run_with_crashpad.ad
|
| deleted file mode 100644
|
| index 129488a31130ab9ed701bd5d13c5f1e5621ae9bd..0000000000000000000000000000000000000000
|
| --- a/third_party/crashpad/crashpad/tools/mac/run_with_crashpad.ad
|
| +++ /dev/null
|
| @@ -1,112 +0,0 @@
|
| -// 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
|
| -
|
| -= run_with_crashpad(1)
|
| -
|
| -== Name
|
| -
|
| -run_with_crashpad - Run a program with a Crashpad exception handler
|
| -
|
| -== Synopsis
|
| -
|
| -[verse]
|
| -*run_with_crashpad* ['OPTION…'] 'COMMAND' ['ARG…']
|
| -
|
| -== Description
|
| -
|
| -Starts a Crashpad exception handler server such as crashpad_handler(8) and
|
| -becomes its client, setting an exception port referencing the handler. Then,
|
| -executes 'COMMAND' along with any arguments specified ('ARG…') with the new
|
| -exception port in effect.
|
| -
|
| -The exception port is configured to receive exceptions of type +EXC_CRASH+,
|
| -+EXC_RESOURCE+, and +EXC_GUARD+. The exception behavior is configured as
|
| -+EXCEPTION_STATE_IDENTITY | MACH_EXCEPTION_CODES+. The thread state flavor is
|
| -set to +MACHINE_THREAD_STATE+.
|
| -
|
| -Programs that use the Crashpad client library directly will not normally use
|
| -this tool. This tool exists to allow programs that are unaware of Crashpad to be
|
| -run with a Crashpad exception handler.
|
| -
|
| -== Options
|
| -*-h*, *--handler*='HANDLER'::
|
| -Invoke 'HANDLER' as the Crashpad handler program instead of the default,
|
| -*crashpad_handler*.
|
| -
|
| -*--annotation*='KEY=VALUE'::
|
| -Passed to the Crashpad handler program as an *--annotation* argument.
|
| -
|
| -*--database*='PATH'::
|
| -Passed to the Crashpad handler program as its *--database* argument.
|
| -
|
| -*--url*='URL'::
|
| -Passed to the Crashpad handler program as its *--url* argument.
|
| -
|
| -*-a*, *--argument*='ARGUMENT'::
|
| -Invokes the Crashpad handler program with 'ARGUMENT' as one of its arguments.
|
| -This option may appear zero, one, or more times. If this program has a specific
|
| -option such as *--database* matching the desired Crashpad handler program
|
| -option, the specific option should be used in preference to *--argument*.
|
| -Regardless of this option’s presence, the handler will always be invoked with
|
| -the necessary arguments to perform a handshake.
|
| -
|
| -*--help*::
|
| -Display help and exit.
|
| -
|
| -*--version*::
|
| -Output version information and exit.
|
| -
|
| -== Examples
|
| -
|
| -Starts a Crashpad exception handler server by its default name,
|
| -*crashpad_handler*, and runs a program with this handler in effect.
|
| -[subs="quotes"]
|
| -----
|
| -$ *run_with_crashpad --database=/tmp/crashpad_database crash*
|
| -Illegal instruction: 4
|
| -----
|
| -
|
| -Starts a Crashpad exception handler server at a nonstandard path, and runs
|
| -man_link:exception_port_tool[1] to show the task-level exception ports.
|
| -[subs="quotes"]
|
| -----
|
| -$ *run_with_crashpad --handler=/tmp/crashpad_handler \
|
| - --database=/tmp/crashpad_database exception_port_tool \
|
| - --show-task*
|
| -task exception port 0, mask 0x1c00 (CRASH|RESOURCE|GUARD), port
|
| -0x30b, behavior 0x80000003 (STATE_IDENTITY|MACH), flavor 7 (THREAD)
|
| -----
|
| -
|
| -== Exit Status
|
| -
|
| -*0*::
|
| -Success.
|
| -
|
| -*125*::
|
| -Failure, with a message printed to the standard error stream.
|
| -
|
| -*126*::
|
| -The program specified by 'COMMAND' was found, but could not be invoked.
|
| -
|
| -*127*::
|
| -The program specified by 'COMMAND' could not be found.
|
| -
|
| -== See Also
|
| -
|
| -man_link:crashpad_handler[8],
|
| -man_link:exception_port_tool[1]
|
| -
|
| -include::../../doc/support/man_footer.ad[]
|
|
|