| Index: tools/on_demand_service_tool.ad
|
| diff --git a/tools/on_demand_service_tool.ad b/tools/on_demand_service_tool.ad
|
| deleted file mode 100644
|
| index 421f17b14d3e3c8a68b2965ac36beb4812b33bd5..0000000000000000000000000000000000000000
|
| --- a/tools/on_demand_service_tool.ad
|
| +++ /dev/null
|
| @@ -1,102 +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
|
| -
|
| -= on_demand_service_tool(1)
|
| -
|
| -== Name
|
| -
|
| -on_demand_service_tool - Load and unload on-demand Mach services registered with
|
| -launchd(8)
|
| -
|
| -== Synopsis
|
| -
|
| -[verse]
|
| -*on_demand_service_tool* *-L* *-l* 'LABEL' ['OPTION…'] 'COMMAND' ['ARG…']
|
| -*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) when a
|
| -Mach message is sent to a Mach port obtained from the bootstrap server by
|
| -looking up the name +svc+:
|
| -[subs="quotes"]
|
| -----
|
| -$ *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:
|
| -[subs="quotes"]
|
| -----
|
| -$ *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
|
| -
|
| -exception_port_tool(1),
|
| -launchctl(1)
|
| -on_demand_service_tool(1)
|
| -
|
| -include::man_footer.ad[]
|
|
|