Add TaskForPID()

tools/exception_port_tool.ad

 // 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,
@@ skipping 70 matching lines @@
 
 *--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
 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
-with process id 'PID' instead of the current task associated with the tool. This
-option may be restricted to use by the superuser or processes permitted by
-taskgated(8) to use +task_for_pid()+. When this option is supplied, 'COMMAND'
-must not be specified.
+with process id 'PID' instead of the current task associated with the tool. When
+this option is supplied, 'COMMAND' must not be specified.
++
+This option uses +task_for_pid()+ to access the process’ task port. This
+operation may be restricted to use by the superuser or processes permitted by
+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*::
 Shows the original host exception ports before making any changes requested by
 *--set_handler*. This option is restricted to the superuser.
 
 *-t*, *--show_task*::
 Shows the original task exception ports before making any changes requested by
 *--set_handler*.
 
 *--show_thread*::
@@ skipping 65 matching lines @@
 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
 
-exception_port_tool(1),
+catch_exception_tool(1),
 on_demand_service_tool(1)
 
 include::man_footer.ad[]