Public bug reported:

>From "man systemd-system.conf":

When packages need to customize the configuration, they can install
configuration snippets in /usr/lib/systemd/*.conf.d/ or
/usr/local/lib/systemd/*.conf.d/. The main configuration file is read
before any of the configuration directories, and has the lowest
precedence; entries in a file in any configuration directory override
entries in the single configuration file. Files in the *.conf.d/
configuration subdirectories are sorted by their filename in
lexicographic order, regardless of in which of the subdirectories they
reside. When multiple files specify the same option, for options which
accept just a single value, the entry in the file with the
lexicographically latest name takes precedence. For options which accept
a list of values, entries are collected as they occur in files sorted
lexicographically.


However from "man SYSTEMD":

DIRECTORIES
       System unit directories
           The systemd system manager reads unit configuration from various 
directories. Packages that want to install unit files shall place them in the 
directory returned by pkg-config systemd
           --variable=systemdsystemunitdir. Other directories checked are 
/usr/local/lib/systemd/system and /lib/systemd/system. User configuration 
always takes precedence.  pkg-config systemd
           --variable=systemdsystemconfdir returns the path of the system 
configuration directory. Packages should alter the content of these directories 
only with the enable and disable commands of
           the systemctl(1) tool. Full list of directories is provided in 
systemd.unit(5).

       User unit directories
           Similar rules apply for the user unit directories. However, here the 
XDG Base Directory specification[6] is followed to find units. Applications 
should place their unit files in the
           directory returned by pkg-config systemd 
--variable=systemduserunitdir. Global configuration is done in the directory 
reported by pkg-config systemd --variable=systemduserconfdir. The
           enable and disable commands of the systemctl(1) tool can handle both 
global (i.e. for all users) and private (for one user) enabling/disabling of 
units. Full list of directories is provided
           in systemd.unit(5).


Obviously, the 2nd one is more precise about directories for
configuration files and therefore should be used in all cases. 1st
paragraph of doc should link there

** Affects: openssh (Ubuntu)
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Ubuntu
Touch seeded packages, which is subscribed to openssh in Ubuntu.
https://bugs.launchpad.net/bugs/1908814

Title:
  systemd : inconsistencies in man pages

Status in openssh package in Ubuntu:
  New

Bug description:
  From "man systemd-system.conf":

  When packages need to customize the configuration, they can install
  configuration snippets in /usr/lib/systemd/*.conf.d/ or
  /usr/local/lib/systemd/*.conf.d/. The main configuration file is read
  before any of the configuration directories, and has the lowest
  precedence; entries in a file in any configuration directory override
  entries in the single configuration file. Files in the *.conf.d/
  configuration subdirectories are sorted by their filename in
  lexicographic order, regardless of in which of the subdirectories they
  reside. When multiple files specify the same option, for options which
  accept just a single value, the entry in the file with the
  lexicographically latest name takes precedence. For options which
  accept a list of values, entries are collected as they occur in files
  sorted lexicographically.

  
  However from "man SYSTEMD":

  DIRECTORIES
         System unit directories
             The systemd system manager reads unit configuration from various 
directories. Packages that want to install unit files shall place them in the 
directory returned by pkg-config systemd
             --variable=systemdsystemunitdir. Other directories checked are 
/usr/local/lib/systemd/system and /lib/systemd/system. User configuration 
always takes precedence.  pkg-config systemd
             --variable=systemdsystemconfdir returns the path of the system 
configuration directory. Packages should alter the content of these directories 
only with the enable and disable commands of
             the systemctl(1) tool. Full list of directories is provided in 
systemd.unit(5).

         User unit directories
             Similar rules apply for the user unit directories. However, here 
the XDG Base Directory specification[6] is followed to find units. Applications 
should place their unit files in the
             directory returned by pkg-config systemd 
--variable=systemduserunitdir. Global configuration is done in the directory 
reported by pkg-config systemd --variable=systemduserconfdir. The
             enable and disable commands of the systemctl(1) tool can handle 
both global (i.e. for all users) and private (for one user) enabling/disabling 
of units. Full list of directories is provided
             in systemd.unit(5).


  Obviously, the 2nd one is more precise about directories for
  configuration files and therefore should be used in all cases. 1st
  paragraph of doc should link there

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/openssh/+bug/1908814/+subscriptions

-- 
Mailing list: https://launchpad.net/~touch-packages
Post to     : touch-packages@lists.launchpad.net
Unsubscribe : https://launchpad.net/~touch-packages
More help   : https://help.launchpad.net/ListHelp

Reply via email to