OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
(...skipping 13 matching lines...) Expand all Loading... |
24 == Synopsis | 24 == Synopsis |
25 | 25 |
26 [verse] | 26 [verse] |
27 *on_demand_service_tool* *-L* *-l* 'LABEL' ['OPTION…'] 'COMMAND' ['ARG…'] | 27 *on_demand_service_tool* *-L* *-l* 'LABEL' ['OPTION…'] 'COMMAND' ['ARG…'] |
28 *on_demand_service_tool* *-U* *-l* 'LABEL' | 28 *on_demand_service_tool* *-U* *-l* 'LABEL' |
29 | 29 |
30 == Description | 30 == Description |
31 | 31 |
32 On-demand services may be registered with launchd(8) by using the *--load* form. | 32 On-demand services may be registered with launchd(8) by using the *--load* form. |
33 One or more service names may be registered with the bootstrap server by | 33 One or more service names may be registered with the bootstrap server by |
34 specifying *--mach_service*. When a Mach message is sent to any of these | 34 specifying *--mach-service*. When a Mach message is sent to any of these |
35 services, launchd(8) will invoke 'COMMAND' along with any arguments specified | 35 services, launchd(8) will invoke 'COMMAND' along with any arguments specified |
36 ('ARG…'). 'COMMAND' must be an absolute pathname. | 36 ('ARG…'). 'COMMAND' must be an absolute pathname. |
37 | 37 |
38 The *--unload* form unregisters jobs registered with launchd(8). | 38 The *--unload* form unregisters jobs registered with launchd(8). |
39 | 39 |
40 == Options | 40 == Options |
41 | 41 |
42 *-L*, *--load*:: | 42 *-L*, *--load*:: |
43 Registers a job with launchd(8). *--label*='LABEL' and 'COMMAND' are required. | 43 Registers a job with launchd(8). *--label*='LABEL' and 'COMMAND' are required. |
44 This operation may also be referred to as “load” or “submit”. | 44 This operation may also be referred to as “load” or “submit”. |
45 | 45 |
46 *-U*, *--unload*:: | 46 *-U*, *--unload*:: |
47 Unregisters a job with launchd(8). *--label*='LABEL' is required. This operation | 47 Unregisters a job with launchd(8). *--label*='LABEL' is required. This operation |
48 may also be referred to as “unload” or “remove”. | 48 may also be referred to as “unload” or “remove”. |
49 | 49 |
50 *-l*, *--label*='LABEL':: | 50 *-l*, *--label*='LABEL':: |
51 'LABEL' is used as the job label to identify the job to launchd(8). 'LABEL' must | 51 'LABEL' is used as the job label to identify the job to launchd(8). 'LABEL' must |
52 be unique within a launchd(8) context. | 52 be unique within a launchd(8) context. |
53 | 53 |
54 *-m*, *--mach_service*='SERVICE':: | 54 *-m*, *--mach-service*='SERVICE':: |
55 In conjunction with *--load*, registers 'SERVICE' with the bootstrap server. | 55 In conjunction with *--load*, registers 'SERVICE' with the bootstrap server. |
56 Clients will be able to obtain a send right by looking up the 'SERVICE' name | 56 Clients will be able to obtain a send right by looking up the 'SERVICE' name |
57 with the bootstrap server. When a message is sent to such a Mach port, | 57 with the bootstrap server. When a message is sent to such a Mach port, |
58 launchd(8) will invoke 'COMMAND' along with any arguments specified ('ARG…') if | 58 launchd(8) will invoke 'COMMAND' along with any arguments specified ('ARG…') if |
59 it is not running. This forms the “on-demand” nature referenced by this tool’s | 59 it is not running. This forms the “on-demand” nature referenced by this tool’s |
60 name. This option may appear zero, one, or more times. 'SERVICE' must be unique | 60 name. This option may appear zero, one, or more times. 'SERVICE' must be unique |
61 within a bootstrap context. | 61 within a bootstrap context. |
62 | 62 |
63 *--help*:: | 63 *--help*:: |
64 Display help and exit. | 64 Display help and exit. |
65 | 65 |
66 *--version*:: | 66 *--version*:: |
67 Output version information and exit. | 67 Output version information and exit. |
68 | 68 |
69 == Examples | 69 == Examples |
70 | 70 |
71 Registers an on-demand server that will execute catch_exception_tool(1) when a | 71 Registers an on-demand server that will execute catch_exception_tool(1) when a |
72 Mach message is sent to a Mach port obtained from the bootstrap server by | 72 Mach message is sent to a Mach port obtained from the bootstrap server by |
73 looking up the name +svc+: | 73 looking up the name +svc+: |
74 [subs="quotes"] | 74 [subs="quotes"] |
75 ---- | 75 ---- |
76 $ *on_demand_service_tool --load --label=catch_exception \ | 76 $ *on_demand_service_tool --load --label=catch_exception \ |
77 --mach_service=svc \ | 77 --mach-service=svc \ |
78 $(which catch_exception_tool) --mach_service=svc \ | 78 $(which catch_exception_tool) --mach-service=svc \ |
79 --file=/tmp/out --nonblocking --persistent* | 79 --file=/tmp/out --nonblocking --persistent* |
80 ---- | 80 ---- |
81 | 81 |
82 Unregisters the on-demand server installed above: | 82 Unregisters the on-demand server installed above: |
83 [subs="quotes"] | 83 [subs="quotes"] |
84 ---- | 84 ---- |
85 $ *on_demand_service_tool --unload --label=catch_exception* | 85 $ *on_demand_service_tool --unload --label=catch_exception* |
86 ---- | 86 ---- |
87 | 87 |
88 == Exit Status | 88 == Exit Status |
89 | 89 |
90 *0*:: | 90 *0*:: |
91 Success. | 91 Success. |
92 | 92 |
93 *1*:: | 93 *1*:: |
94 Failure, with a message printed to the standard error stream. | 94 Failure, with a message printed to the standard error stream. |
95 | 95 |
96 == See Also | 96 == See Also |
97 | 97 |
98 exception_port_tool(1), | 98 exception_port_tool(1), |
99 launchctl(1) | 99 launchctl(1) |
100 on_demand_service_tool(1) | 100 on_demand_service_tool(1) |
101 | 101 |
102 include::man_footer.ad[] | 102 include::man_footer.ad[] |
OLD | NEW |