ACPR/android_system_core
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

init: add warning that start is not synchronous

Browse source 
Bug: 36571736
Bug: 37481363
Change-Id: I5d360cbb3635f00453a492ee4e3650fb80f390f5
This commit is contained in:
Tom Cherry 2017-04-18 17:07:57 -07:00
parent 0bdf6539d6
commit 19866bf19f
1 changed files with 12 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
init/README.md
View file

@ -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.