[Bug 1787495] Re: no explanation for the events in the networkd-dispatcher manpage

[Julian Andres Klode]

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

** Also affects: systemd (Ubuntu)
   Importance: Undecided
       Status: New

** Bug watch added: github.com/systemd/systemd/issues #575
   https://github.com/systemd/systemd/issues/575

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to systemd in Ubuntu.
https://bugs.launchpad.net/bugs/1787495

Title:
  no explanation for the events in the networkd-dispatcher manpage

Status in networkd-dispatcher package in Ubuntu:
  In Progress
Status in systemd package in Ubuntu:
  New

Bug description:
  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.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/networkd-dispatcher/+bug/1787495/+subscriptions