Merge "init: add warning that start
is not synchronous"
am: 06039e58d8
Change-Id: Ie90e08c41d22c4fcb2e6f98150b1331467423709
This commit is contained in:
commit
2b78f9c0a9
1 changed files with 12 additions and 1 deletions
|
@ -276,7 +276,8 @@ Commands
|
|||
|
||||
`class_start <serviceclass>`
|
||||
> Start all services of the specified class if they are
|
||||
not already running.
|
||||
not already running. See the start entry for more information on
|
||||
starting services.
|
||||
|
||||
`class_stop <serviceclass>`
|
||||
> Stop and disable all services of the specified class if they are
|
||||
|
@ -401,6 +402,16 @@ Commands
|
|||
|
||||
`start <service>`
|
||||
> Start a service running if it is not already running.
|
||||
Note that this is _not_ synchronous, and even if it were, there is
|
||||
no guarantee that the operating system's scheduler will execute the
|
||||
service sufficiently to guarantee anything about the service's status.
|
||||
|
||||
> This creates an important consequence that if the service offers
|
||||
functionality to other services, such as providing a
|
||||
communication channel, simply starting this service before those
|
||||
services is _not_ sufficient to guarantee that the channel has
|
||||
been set up before those services ask for it. There must be a
|
||||
separate mechanism to make any such guarantees.
|
||||
|
||||
`stop <service>`
|
||||
> Stop a service from running if it is currently running.
|
||||
|
|
Loading…
Reference in a new issue