| Index: third_party/crashpad/crashpad/tools/mac/on_demand_service_tool.md
|
| diff --git a/third_party/crashpad/crashpad/tools/mac/on_demand_service_tool.md b/third_party/crashpad/crashpad/tools/mac/on_demand_service_tool.md
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..5a85035264499d151e7c6c4f06ccd186cef7da81
|
| --- /dev/null
|
| +++ b/third_party/crashpad/crashpad/tools/mac/on_demand_service_tool.md
|
| @@ -0,0 +1,133 @@
|
| +<!--
|
| +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.
|
| +-->
|
| +
|
| +# on_demand_service_tool(1)
|
| +
|
| +## Name
|
| +
|
| +on_demand_service_tool—Load and unload on-demand Mach services registered with
|
| +launchd(8)
|
| +
|
| +## Synopsis
|
| +
|
| +**on_demand_service_tool** **-L** **-l** _LABEL_ [_OPTION…_] _COMMAND_
|
| +[_ARG…_]<br/>
|
| +**on_demand_service_tool** **-U** **-l** _LABEL_
|
| +
|
| +## Description
|
| +
|
| +On-demand services may be registered with launchd(8) by using the **--load**
|
| +form. One or more service names may be registered with the bootstrap server by
|
| +specifying **--mach-service**. When a Mach message is sent to any of these
|
| +services, launchd(8) will invoke _COMMAND_ along with any arguments specified
|
| +(_ARG…_). _COMMAND_ must be an absolute pathname.
|
| +
|
| +The **--unload** form unregisters jobs registered with launchd(8).
|
| +
|
| +## Options
|
| +
|
| + * **-L**, **--load**
|
| +
|
| + Registers a job with launchd(8). **--label**=_LABEL_ and _COMMAND_ are
|
| + required. This operation may also be referred to as “load” or “submit”.
|
| +
|
| + * **-U**, **--unload**
|
| +
|
| + Unregisters a job with launchd(8). **--label**=_LABEL_ is required. This
|
| + operation may also be referred to as “unload” or “remove”.
|
| +
|
| + * **-l**, **--label**=_LABEL_
|
| +
|
| + _LABEL_ is used as the job label to identify the job to launchd(8). _LABEL_
|
| + must be unique within a launchd(8) context.
|
| +
|
| + * **-m**, **--mach-service**=_SERVICE_
|
| +
|
| + In conjunction with **--load**, registers _SERVICE_ with the bootstrap
|
| + server. Clients will be able to obtain a send right by looking up the
|
| + _SERVICE_ name with the bootstrap server. When a message is sent to such a
|
| + Mach port, launchd(8) will invoke _COMMAND_ along with any arguments
|
| + specified (_ARG…_) if it is not running. This forms the “on-demand” nature
|
| + referenced by this tool’s name. This option may appear zero, one, or more
|
| + times. _SERVICE_ must be unique within a bootstrap context.
|
| +
|
| + * **--help**
|
| +
|
| + Display help and exit.
|
| +
|
| + * **--version**
|
| +
|
| + Output version information and exit.
|
| +
|
| +## Examples
|
| +
|
| +Registers an on-demand server that will execute
|
| +[catch_exception_tool(1)](catch_exception_tool.md) when a Mach message is sent
|
| +to a Mach port obtained from the bootstrap server by looking up the name `svc`:
|
| +
|
| +```
|
| +$ on_demand_service_tool --load --label=catch_exception \
|
| + --mach-service=svc \
|
| + $(which catch_exception_tool) --mach-service=svc \
|
| + --file=/tmp/out --persistent --timeout=0
|
| +```
|
| +
|
| +Unregisters the on-demand server installed above:
|
| +
|
| +```
|
| +$ on_demand_service_tool --unload --label=catch_exception
|
| +```
|
| +
|
| +## Exit Status
|
| +
|
| + * **0**
|
| +
|
| + Success.
|
| +
|
| + * **1**
|
| +
|
| + Failure, with a message printed to the standard error stream.
|
| +
|
| +## See Also
|
| +
|
| +[catch_exception_tool(1)](catch_exception_tool.md),
|
| +[exception_port_tool(1)](exception_port_tool.md),
|
| +launchctl(1)
|
| +
|
| +## Resources
|
| +
|
| +Crashpad home page: https://crashpad.chromium.org/.
|
| +
|
| +Report bugs at https://crashpad.chromium.org/bug/new.
|
| +
|
| +## Copyright
|
| +
|
| +Copyright 2014 [The Crashpad
|
| +Authors](https://chromium.googlesource.com/crashpad/crashpad/+/master/AUTHORS).
|
| +
|
| +## License
|
| +
|
| +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.
|
|
|