| Index: tools/exception_port_tool.ad
|
| diff --git a/tools/exception_port_tool.ad b/tools/exception_port_tool.ad
|
| index 5a09323de9f0478dc99ec62098c592d59148e016..f1814d52930be0d682c418deac7b64f6e63f5fe0 100644
|
| --- a/tools/exception_port_tool.ad
|
| +++ b/tools/exception_port_tool.ad
|
| @@ -28,12 +28,12 @@ exception_port_tool - Show and change Mach exception ports
|
| == Description
|
|
|
| Shows Mach exception ports registered for a thread, task, or host target with a
|
| -*--show_** option, changes Mach exception ports with *--set_handler*, shows
|
| -changes with a *--show_new_** option, and executes 'COMMAND' along with any
|
| +*--show-** option, changes Mach exception ports with *--set-handler*, shows
|
| +changes with a *--show-new-** option, and executes 'COMMAND' along with any
|
| arguments specified ('ARG…') with the changed exception ports in effect.
|
|
|
| == Options
|
| -*-s*, *--set_handler*='DESCRIPTION'::
|
| +*-s*, *--set-handler*='DESCRIPTION'::
|
| Set an exception port to 'DESCRIPTION'. This option may appear zero, one, or
|
| more times.
|
| +
|
| @@ -79,15 +79,15 @@ exception port should be cleared. 'HANDLER' may also take the form
|
| and set that service as the exception handler. The default value of 'HANDLER' is
|
| *NULL*.
|
|
|
| -*--show_bootstrap*='SERVICE'::
|
| +*--show-bootstrap*='SERVICE'::
|
| Looks up 'SERVICE' with the bootstrap server and shows it. Normally, the handler
|
| -port values displayed by the other *--show_** options are meaningless
|
| +port values displayed by the other *--show-** options are meaningless
|
| handles, but by comparing them to the port values for known bootstrap services,
|
| it is possible to verify that they are set as intended.
|
|
|
| *-p*, *--pid*='PID'::
|
| -For operations on the task target, including *--set_handler* with 'TARGET' set
|
| -to *task*, *--show_task*, and *--show_new_task*, operates on the task associated
|
| +For operations on the task target, including *--set-handler* with 'TARGET' set
|
| +to *task*, *--show-task*, and *--show-new-task*, operates on the task associated
|
| with process id 'PID' instead of the current task associated with the tool. When
|
| this option is supplied, 'COMMAND' must not be specified.
|
| +
|
| @@ -97,32 +97,32 @@ taskgated(8). Consequently, this program must normally be invoked by root to use
|
| this option. It is possible to install this program as a setuid root executable
|
| to overcome this limitation.
|
|
|
| -*-h*, *--show_host*::
|
| +*-h*, *--show-host*::
|
| Shows the original host exception ports before making any changes requested by
|
| -*--set_handler*. This option is restricted to the superuser.
|
| +*--set-handler*. This option is restricted to the superuser.
|
|
|
| -*-t*, *--show_task*::
|
| +*-t*, *--show-task*::
|
| Shows the original task exception ports before making any changes requested by
|
| -*--set_handler*.
|
| +*--set-handler*.
|
|
|
| -*--show_thread*::
|
| +*--show-thread*::
|
| Shows the original thread exception ports before making any changes requested by
|
| -*--set_handler*.
|
| +*--set-handler*.
|
|
|
| -*-H*, *--show_new_host*::
|
| +*-H*, *--show-new-host*::
|
| Shows the modified host exception ports after making any changes requested by
|
| -*--set_handler*. This option is restricted to the superuser.
|
| +*--set-handler*. This option is restricted to the superuser.
|
|
|
| -*-T*, *--show_new_task*::
|
| +*-T*, *--show-new-task*::
|
| Shows the modified task exception ports after making any changes requested by
|
| -*--set_handler*.
|
| +*--set-handler*.
|
|
|
| -*--show_new_thread*::
|
| +*--show-new-thread*::
|
| Shows the modified thread exception ports after making any changes requested by
|
| -*--set_handler*.
|
| +*--set-handler*.
|
|
|
| *-n*, *--numeric*::
|
| -For *--show_** options, all values will be displayed numerically only. The
|
| +For *--show-** options, all values will be displayed numerically only. The
|
| default is to decode numeric values and display them symbolically as well.
|
|
|
| *--help*::
|
| @@ -140,9 +140,9 @@ are verified by their service names as registered with the bootstrap server.
|
| With the new task-level exception ports in effect, a program is run.
|
| [subs="quotes"]
|
| ----
|
| -$ *exception_port_tool --show_task --show_new_task \
|
| - --show_bootstrap=com.apple.ReportCrash --show_bootstrap=svc \
|
| - --set_handler=behavior=DEFAULT,handler=bootstrap:svc crash*
|
| +$ *exception_port_tool --show-task --show-new-task \
|
| + --show-bootstrap=com.apple.ReportCrash --show-bootstrap=svc \
|
| + --set-handler=behavior=DEFAULT,handler=bootstrap:svc crash*
|
| service com.apple.ReportCrash 0xe03
|
| service svc 0x1003
|
| task exception port 0, mask 0x400 (CRASH), port 0xe03,
|
| @@ -156,7 +156,7 @@ Shows the task-level exception ports for the process with PID 1234. This
|
| requires superuser permissions or the approval of taskgated(8).
|
| [subs="quotes"]
|
| ----
|
| -# *exception_port_tool --pid=1234 --show_task*
|
| +# *exception_port_tool --pid=1234 --show-task*
|
| task exception port 0, mask 0x4e
|
| (BAD_ACCESS|BAD_INSTRUCTION|ARITHMETIC|BREAKPOINT), port 0x1503,
|
| behavior 0x1 (DEFAULT), flavor 13 (NONE)
|
|
|