no explanation for the events in the networkd-dispatcher manpage

Bug #1787495 reported by Steve Langasek
10
This bug affects 2 people
Affects Status Importance Assigned to Milestone
networkd-dispatcher (Ubuntu)
Fix Released
Undecided
Unassigned
Bionic
In Progress
Undecided
Unassigned
Cosmic
In Progress
Undecided
Unassigned
systemd (Ubuntu)
Fix Released
Undecided
Unassigned
Bionic
Triaged
Undecided
Unassigned
Cosmic
Fix Released
Undecided
Unassigned

Bug Description

[Impact]
networkd-dispatcher supports four hook directories:

$ ls /usr/lib/networkd-dispatcher/
dormant.d no-carrier.d off.d routable.d
$

The manpage does not define what these hooks mean. 'routable' and 'no-carrier' are self-explanatory, but it's not at all clear what 'dormant' vs 'off' mean. It's not at all clear what events one should expect to see as part of device bring-up.

This needs to be better documented.

[Test case]
Check that it networkd-dispatcher(8) it's documented in networkctl(1), and that networkctl(1) documents it

[Regression potential]
If user updates networkd-dispatcher before systemd, they get the reference to networkctl(1) in networkd-dispatcher(8), but won't find any related text in there...

tags: added: id-5b76028cae42945920e85c44
Revision history for this message
Julian Andres Klode (juliank) wrote :

From systemd:

/* Get operational state from ifindex.
 * Possible states:
 * off: the device is powered down
 * no-carrier: the device is powered up, but it does not yet have a carrier
 * dormant: the device has a carrier, but is not yet ready for normal traffic
 * carrier: the link has a carrier
 * degraded: the link has carrier and addresses valid on the local link configured
 * routable: the link has carrier and routable address configured

We don't have dirs for degraded and carrier. Not sure if they get exposed or not.

I'm not sure if they shouldn't be documented in systemd somewhere, though.

Revision history for this message
Julian Andres Klode (juliank) wrote :
Changed in networkd-dispatcher (Ubuntu):
status: New → In Progress
Revision history for this message
Julian Andres Klode (juliank) wrote :

systemd also does not document the states itself, only in the source code. it should be in networkctl(1) IMO.

Revision history for this message
Julian Andres Klode (juliank) wrote :
Revision history for this message
Julian Andres Klode (juliank) wrote :
Changed in systemd (Ubuntu):
status: New → In Progress
Revision history for this message
Julian Andres Klode (juliank) wrote :

Fixed in

systemd (239-7ubuntu8) cosmic; urgency=medium

  [ Dimitri John Ledkov ]
  * Cherrypick many bugfixes from master.
  * systemctl: correctly proceed to immediate shutdown if scheduling fails
    (LP: #1670291)

  [ Julian Andres Klode ]
  * Improve networkd states documentation.

 -- Dimitri John Ledkov <email address hidden> Wed, 12 Sep 2018 16:03:08 +0100

Changed in systemd (Ubuntu):
status: In Progress → Fix Released
Changed in networkd-dispatcher (Ubuntu):
status: In Progress → Fix Committed
Changed in systemd (Ubuntu Cosmic):
status: New → Fix Released
Changed in networkd-dispatcher (Ubuntu Cosmic):
status: New → In Progress
Changed in networkd-dispatcher (Ubuntu Bionic):
status: New → In Progress
Changed in systemd (Ubuntu Bionic):
status: New → Triaged
description: updated
Revision history for this message
Launchpad Janitor (janitor) wrote :

This bug was fixed in the package networkd-dispatcher - 2.0-2

---------------
networkd-dispatcher (2.0-2) unstable; urgency=medium

  * Refer to networkctl(1) in networkd-dispatcher(8) text (LP: #1787495)

 -- Julian Andres Klode <email address hidden> Wed, 30 Jan 2019 16:01:34 +0100

Changed in networkd-dispatcher (Ubuntu):
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.