]> git.ipfire.org Git - thirdparty/systemd.git/blob - DISTRO_PORTING
Merge pull request #4362 from poettering/journalbootlistfix
[thirdparty/systemd.git] / DISTRO_PORTING
1 Porting systemd To New Distributions
2
3 HOWTO:
4 You need to make the follow changes to adapt systemd to your
5 distribution:
6
7 1) Find the right configure parameters for:
8
9 --with-rootprefix=
10 --with-sysvinit-path=
11 --with-sysvrcnd-path=
12 --with-rc-local-script-path-start=
13 --with-rc-local-script-path-stop=
14 --with-kbd-loadkeys=
15 --with-kbd-setfont=
16 --with-tty-gid=
17 --with-ntp-servers=
18 --with-support-url=
19
20 2) Try it out. Play around (as an ordinary user) with
21 '/usr/lib/systemd/systemd --test --system' for a test run
22 of systemd without booting. This will read the unit files and
23 print the initial transaction it would execute during boot-up.
24 This will also inform you about ordering loops and suchlike
25
26 NTP POOL:
27
28 By default, timesyncd uses the Google NTP servers
29 time[1-4].google.com. They serve time that is not standards
30 compliant, and can be up to .5s off. Google does not
31 officially support these servers for the broader
32 audience. Distributions and vendors really should not ship
33 OSes or devices with these NTP servers configured. Instead,
34 please register your own vendor pool at ntp.org and make it
35 the built-in default by passing --with-ntp-servers= to
36 configure. Registering vendor pools is free:
37
38 http://www.pool.ntp.org/en/vendors.html
39
40 Again, if you ship your software or device with the default
41 NTP servers, then you will get served wrong time, and will
42 rely on services that might not be supported for long.
43
44 PAM:
45 The default PAM config shipped by systemd is really bare bones.
46 It does not include many modules your distro might want to enable
47 to provide a more seamless experience. For example, limits set in
48 /etc/security/limits.conf will not be read unless you load pam_limits.
49 Make sure you add modules your distro expects from user services.
50
51 Pass --with-pamconfdir=no to ./configure to avoid installing this file
52 and instead install your own.
53
54 CONTRIBUTING UPSTREAM:
55
56 We generally do no longer accept distribution-specific
57 patches to systemd upstream. If you have to make changes to
58 systemd's source code to make it work on your distribution,
59 unless your code is generic enough to be generally useful, we
60 are unlikely to merge it. Please always consider adopting the
61 upstream defaults. If that is not possible, please maintain
62 the relevant patches downstream.
63
64 Thank you for understanding.