shepherd: list-actions not implemented

  • Done
  • quality assurance status badge
Details
3 participants
  • Brice Waegeneire
  • Jesse Gibbons
  • Leo Famulari
Owner
unassigned
Submitted by
Jesse Gibbons
Severity
normal
J
J
Jesse Gibbons wrote on 16 Jul 2019 23:26
(address . bug-guix@gnu.org)
20190716152611.016f4ca4@gmail.com
I am curious about what actions are implemented in the system services
on my GuixSD install. I try something like the following for the
different system services and get an error:

jesse@piranhaplant ~$ sudo herd list-actions term-tty6
Password:
herd: service 'term-tty6' does not have an action 'list-actions'


Based on what the manual says[1], the 'list-actions' action should be a
special action of every service, so I would expect it to at least either
list the default actions status, start, stop, enable, disable, etc. or
display a message that there are no custom actions defined for the
named service.

Surprisingly I could not find anything related to this in the archives.

B
B
Brice Waegeneire wrote on 31 Mar 2020 21:43
(address . 36698@debbugs.gnu.org)
7687ae32f92bba7b61b53b09ad2124c0@waegenei.re
Toggle quote (8 lines)
> I am curious about what actions are implemented in the system services
> on my GuixSD install. I try something like the following for the
> different system services and get an error:
>
> jesse@piranhaplant ~$ sudo herd list-actions term-tty6
> Password:
> herd: service 'term-tty6' does not have an action 'list-actions'

The documentation has been updated in
d5da712a5605a0cdaa4cf3bd64621a95a54520c0
to clarify the use of 'list-actions' and there is an example on how to
use it.

# herd doc term-tty6 list-actions
term-tty6 ()
# herd doc root list-actions
root (help status halt power-off load eval unload reload daemonize
persistency no-persistency cd restart)

This bug should be closed.
L
L
Leo Famulari wrote on 31 Mar 2020 22:09
(name . Brice Waegeneire)(address . brice@waegenei.re)(address . 36698@debbugs.gnu.org)
20200331200919.GA20401@jasmine.lan
On Tue, Mar 31, 2020 at 07:43:36PM +0000, Brice Waegeneire wrote:
Toggle quote (21 lines)
> > I am curious about what actions are implemented in the system services
> > on my GuixSD install. I try something like the following for the
> > different system services and get an error:
> >
> > jesse@piranhaplant ~$ sudo herd list-actions term-tty6
> > Password:
> > herd: service 'term-tty6' does not have an action 'list-actions'
>
> The documentation has been updated in
> d5da712a5605a0cdaa4cf3bd64621a95a54520c0
> to clarify the use of 'list-actions' and there is an example on how to use
> it.
>
> # herd doc term-tty6 list-actions
> term-tty6 ()
> # herd doc root list-actions
> root (help status halt power-off load eval unload reload daemonize
> persistency no-persistency cd restart)
>
> This bug should be closed.

Here is a patch to fix a small typo in that commit.
From 2b4785716abf2655d5be35679d5e2dfed62d27d7 Mon Sep 17 00:00:00 2001
From: Leo Famulari <leo@famulari.name>
Date: Tue, 31 Mar 2020 16:07:46 -0400
Subject: [PATCH] doc: Fix typo in Jump start.

* doc/shepherd.texi (Jump start): Fix typo in documentation of special action
'doc'.
---
doc/shepherd.texi | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)

Toggle diff (23 lines)
diff --git a/doc/shepherd.texi b/doc/shepherd.texi
index 9ecd2ab..39454ba 100644
--- a/doc/shepherd.texi
+++ b/doc/shepherd.texi
@@ -289,11 +289,11 @@ to load arbitrary code into the Shepherd at runtime, like this:
herd load shepherd ~/additional-services.scm
@end example
-In the same vein the special action @code{doc} describes it service when
-called without an argument or describes a service-specific action when
-called with the action as the additional arguments. You can even get
-the list of the service-specific actions a service provides when using
-with the additional argument @code{list-actions}.
+In the same vein the special action @code{doc} describes its service
+when called without an argument or describes a service-specific action
+when called with the action as the additional arguments. You can even
+get the list of the service-specific actions a service provides when
+using with the additional argument @code{list-actions}.
@example
$ herd doc root
The root service is used to operate on shepherd itself.
--
2.26.0
L
L
Leo Famulari wrote on 1 Apr 2020 00:34
(name . Brice Waegeneire)(address . brice@waegenei.re)(address . 36698-done@debbugs.gnu.org)
20200331223400.GA25261@jasmine.lan
On Tue, Mar 31, 2020 at 04:09:19PM -0400, Leo Famulari wrote:
Toggle quote (10 lines)
> Here is a patch to fix a small typo in that commit.

> From 2b4785716abf2655d5be35679d5e2dfed62d27d7 Mon Sep 17 00:00:00 2001
> From: Leo Famulari <leo@famulari.name>
> Date: Tue, 31 Mar 2020 16:07:46 -0400
> Subject: [PATCH] doc: Fix typo in Jump start.
>
> * doc/shepherd.texi (Jump start): Fix typo in documentation of special action
> 'doc'.

Pushed as e9f3560414ed9c6ee9afe3a9ab85fd8e114f97cb
Closed
?