| Index: third_party/crashpad/crashpad/tools/generate_dump.ad
|
| diff --git a/third_party/crashpad/crashpad/tools/generate_dump.ad b/third_party/crashpad/crashpad/tools/generate_dump.ad
|
| deleted file mode 100644
|
| index d8a53c8d68b315ee53fc84c062ed39fd771afa19..0000000000000000000000000000000000000000
|
| --- a/third_party/crashpad/crashpad/tools/generate_dump.ad
|
| +++ /dev/null
|
| @@ -1,96 +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
|
| -
|
| -= generate_dump(1)
|
| -
|
| -== Name
|
| -
|
| -generate_dump - Generate a minidump file containing a snapshot of a running
|
| -process
|
| -
|
| -== Synopsis
|
| -
|
| -[verse]
|
| -*generate_dump* ['OPTION…'] 'PID'
|
| -
|
| -== Description
|
| -
|
| -Generates a minidump file containing a snapshot of a running process whose
|
| -process identifier is 'PID'. By default, the target process will be suspended
|
| -while the minidump is generated, and the minidump file will be written to
|
| -+minidump.PID+. After the minidump file is generated, the target process resumes
|
| -running.
|
| -
|
| -The minidump file will contain information about the process, its threads, its
|
| -modules, and the system. It will not contain any exception information because
|
| -it will be generated from a live running process, not as a result of an
|
| -exception occurring.
|
| -
|
| -This program uses +task_for_pid()+ to access the process’ task port. This
|
| -operation may be restricted to use by the superuser, executables signed by an
|
| -authority trusted by the system, and processes otherwise permitted by
|
| -taskgated(8). Consequently, this program must normally either be signed or be
|
| -invoked by root. It is possible to install this program as a setuid root
|
| -executable to overcome this limitation.
|
| -
|
| -This program is similar to the gcore(1) program available on some operating
|
| -systems.
|
| -
|
| -== Options
|
| -
|
| -*-r*, *--no-suspend*::
|
| -The target process will continue running while the minidump file is generated.
|
| -Normally, the target process is suspended during this operation, which
|
| -guarantees that the minidump file will contain an atomic snapshot of the
|
| -process.
|
| -+
|
| -This option may be useful when attempting to generate a minidump from a process
|
| -that dump generation has an interprocess dependency on, such as a system server
|
| -like launchd(8) or opendirectoryd(8). Deadlock could occur if any portion of the
|
| -dump generation operation blocks while waiting for a response from one of these
|
| -servers while they are suspended.
|
| -
|
| -*-o*, *--output*='FILE'::
|
| -The minidump will be written to 'FILE' instead of +minidump.PID+.
|
| -
|
| -*--help*::
|
| -Display help and exit.
|
| -
|
| -*--version*::
|
| -Output version information and exit.
|
| -
|
| -== Examples
|
| -
|
| -Generate a minidump file in +/tmp/minidump+ containing a snapshot of the process
|
| -with PID 1234.
|
| -[subs="quotes"]
|
| -----
|
| -$ *generate_dump --output=/tmp/minidump 1234*
|
| -----
|
| -
|
| -== Exit Status
|
| -
|
| -*0*::
|
| -Success.
|
| -
|
| -*1*::
|
| -Failure, with a message printed to the standard error stream.
|
| -
|
| -== See Also
|
| -
|
| -man_link:catch_exception_tool[1]
|
| -
|
| -include::../doc/support/man_footer.ad[]
|
|
|