Prep v226: Sync build files with upstream

[elogind.git] / README

diff --git a/README b/README
index 651aa983772549fe3966b5f5fb28baa73e5867ae..27cc9a01681829af75365e8c06272be4ffbe7dc9 100644 (file)
--- a/README
+++ b/README
@@ -36,8 +36,8 @@ LICENSE:
         - except src/udev/* which is (currently still) GPLv2, GPLv2+
 
 REQUIREMENTS:
         - except src/udev/* which is (currently still) GPLv2, GPLv2+
 
 REQUIREMENTS:

-        Linux kernel >= 3.7
-        Linux kernel >= 3.8 for Smack support
+        Linux kernel >= 3.11
+        Linux kernel >= 4.2 for unified cgroup hierarchy support

 
         Kernel Config Options:
           CONFIG_DEVTMPFS
 
         Kernel Config Options:
           CONFIG_DEVTMPFS


@@ -82,11 +82,11 @@ REQUIREMENTS:
           CONFIG_SECCOMP
           CONFIG_CHECKPOINT_RESTORE (for the kcmp() syscall)
 
           CONFIG_SECCOMP
           CONFIG_CHECKPOINT_RESTORE (for the kcmp() syscall)
 

-        Required for CPUShares in resource control unit settings
+        Required for CPUShares= in resource control unit settings

           CONFIG_CGROUP_SCHED
           CONFIG_FAIR_GROUP_SCHED
 
           CONFIG_CGROUP_SCHED
           CONFIG_FAIR_GROUP_SCHED
 

-        Required for CPUQuota in resource control unit settings
+        Required for CPUQuota= in resource control unit settings

           CONFIG_CFS_BANDWIDTH
 
         For systemd-bootchart, several proc debug interfaces are required:
           CONFIG_CFS_BANDWIDTH
 
         For systemd-bootchart, several proc debug interfaces are required:


@@ -97,6 +97,15 @@ REQUIREMENTS:
           CONFIG_EFIVAR_FS
           CONFIG_EFI_PARTITION
 
           CONFIG_EFIVAR_FS
           CONFIG_EFI_PARTITION
 

+        We recommend to turn off Real-Time group scheduling in the
+        kernel when using systemd. RT group scheduling effectively
+        makes RT scheduling unavailable for most userspace, since it
+        requires explicit assignment of RT budgets to each unit whose
+        processes making use of RT. As there's no sensible way to
+        assign these budgets automatically this cannot really be
+        fixed, and it's best to disable group scheduling hence.
+           CONFIG_RT_GROUP_SCHED=n
+

         Note that kernel auditing is broken when used with systemd's
         container code. When using systemd in conjunction with
         containers, please make sure to either turn off auditing at
         Note that kernel auditing is broken when used with systemd's
         container code. When using systemd in conjunction with
         containers, please make sure to either turn off auditing at


@@ -140,8 +149,7 @@ REQUIREMENTS:
         dracut (optional)
         PolicyKit (optional)
 
         dracut (optional)
         PolicyKit (optional)
 

-        When building from git, you need the following additional
-        dependencies:
+        When building from git, the following tools are needed:

 
         pkg-config
         docbook-xsl
 
         pkg-config
         docbook-xsl


@@ -155,6 +163,10 @@ REQUIREMENTS:
         python-lxml (optional, but required to build the indices)
         sphinx (optional)
 
         python-lxml (optional, but required to build the indices)
         sphinx (optional)
 

+        The build system is initialized with ./autogen.sh. A tar ball
+        can be created with:
+          git archive --format=tar --prefix=systemd-222/ v222 | xz > systemd-222.tar.xz
+

         When systemd-hostnamed is used, it is strongly recommended to
         install nss-myhostname to ensure that, in a world of
         dynamically changing hostnames, the hostname stays resolvable
         When systemd-hostnamed is used, it is strongly recommended to
         install nss-myhostname to ensure that, in a world of
         dynamically changing hostnames, the hostname stays resolvable


@@ -258,7 +270,7 @@ WARNINGS:
         false positives will be triggered by code which violates
         some rules but is actually safe.
 
         false positives will be triggered by code which violates
         some rules but is actually safe.
 

-ENGINEERING AND CONSULTING SERVICES:
-        ENDOCODE <https://endocode.com/> offers professional
-        engineering and consulting services for systemd. Please
-        contact Chris Kühl <chris@endocode.com> for more information.
+        Currently, systemd-timesyncd defaults to use the Google NTP
+        servers if not specified otherwise at configure time. You
+        really should not ship an OS or device with this default
+        setting. See DISTRO_PORTING for details.