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[] |