[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

02/03: doc: Give example uses of 'deco'.

From: Ludovic Courtès
Subject: 02/03: doc: Give example uses of 'deco'.
Date: Sun, 07 Dec 2014 22:42:14 +0000

civodul pushed a commit to branch master
in repository guix.

commit d8b94dbd76101f9090d2ffc60125dbcca6ff029b
Author: Ludovic Courtès <address@hidden>
Date:   Sun Dec 7 22:55:06 2014 +0100

    doc: Give example uses of 'deco'.
    Suggested by Sleep_Walker on #guix.
    * doc/guix.texi (Services): Add 'deco' examples.
 doc/guix.texi |   37 ++++++++++++++++++++++++++++++++++---
 1 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 1d4a012..22f2484 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4078,11 +4078,42 @@ An important part of preparing an 
@code{operating-system} declaration is
 listing @dfn{system services} and their configuration (@pxref{Using the
 Configuration System}).  System services are typically daemons launched
 when the system boots, or other actions needed at that time---e.g.,
-configuring network access.  They are managed by address@hidden
-(@pxref{Introduction,,, dmd, GNU dmd Manual}).
+configuring network access.
+Services are managed by address@hidden (@pxref{Introduction,,, dmd, GNU
+dmd Manual}).  On a running system, the @command{deco} command allows
+you to list the available services, show their status, start and stop
+them, or do other specific operations (@pxref{Jump Start,,, dmd, GNU dmd
+Manual}).  For example:
+# deco status dmd
address@hidden example
+The above command, run as @code{root}, lists the currently defined
+services.  The @command{deco doc} command shows a synopsis of the given
+# deco doc nscd
+Run libc's name service cache daemon (nscd).
address@hidden example
+The @command{start}, @command{stop}, and @command{restart} sub-commands
+have the effect you would expect.  For instance, the commands below stop
+the nscd service and restart the Xorg display server:
+# deco stop nscd
+Service nscd has been stopped.
+# deco restart xorg-server
+Service xorg-server has been stopped.
+Service xorg-server has been started.
address@hidden example
 The following sections document the available services, starting with
-the core services.
+the core services, that may be used in an @code{operating-system}
 * Base Services::               Essential system services.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]