Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0a4ff0fb authored by Tom Cherry's avatar Tom Cherry Committed by android-build-merger
Browse files

Merge "init: add warning that `start` is not synchronous" am: 06039e58

am: 2b78f9c0

Change-Id: Ifbbfc587a926ec343e166018c2a0f9fa914ed591
parents 7536c043 2b78f9c0
Loading
Loading
Loading
Loading
+12 −1
Original line number Diff line number Diff line
@@ -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.