From 7cbc505de4f06896617c24fcf54855b8790ac75e Mon Sep 17 00:00:00 2001 From: "A. Wilcox" Date: Mon, 21 Sep 2020 18:48:05 -0500 Subject: doc: Add reload and restart to service mgmt spec --- doc/service.rst | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) (limited to 'doc/service.rst') diff --git a/doc/service.rst b/doc/service.rst index b567366..194b9c9 100644 --- a/doc/service.rst +++ b/doc/service.rst @@ -170,7 +170,8 @@ under the ``status`` property in the `Data model definition`_ section. This method starts the service associated with the Service object. -This method has no effect if the status of the service is ``started``. +This method has no effect if the status of the service is ``starting`` or +``started``. This method returns immediately with no value. To determine if a service started successfully, you must query the service's status. @@ -181,13 +182,42 @@ started successfully, you must query the service's status. This method stops the service associated with the Service object. -This method has no effect if the status of the service is ``stopped`` or -``crashed``. +This method has no effect if the status of the service is ``stopping``, +``stopped`` or ``crashed``. This method returns immediately with no value. To determine if a service stopped successfully, you must query the service's status. +``reload()`` +~~~~~~~~~~~~ + +This method reloads the service associated with the Service object. + +This method has no effect unless the status of the service is ``started``. + +This method returns immediately with no value. + + +``restart(full)`` +~~~~~~~~~~~~~~~~~ + +This method restarts the service associated with the Service object. + +This method has no effect if the status of the service is ``stopping`` or +``starting``. + +If the status of the service is not ``started``, the service will be +started without a stop attempt. + +The argument ``full`` determines if the restart is a full restart or not. +The meaning of a full restart is implementation-defined. The argument +defaults to ``True`` if it is not specified. + +This method returns immediately with no value. To determine if a service +restarted successfully, you must query the service's status. + + YANG Model -- cgit v1.2.3-70-g09d2