Filipe Brandenburger c3e270f4ee docs: add a "front matter" snippet to our markdown pages

It turns out Jekyll (the engine behind GitHub Pages) requires that pages
include a "Front Matter" snippet of YAML at the top for proper rendering.

Omitting it will still render the pages, but including it opens up new
possibilities, such as using a {% for %} loop to generate index.md instead of
requiring a separate script.

I'm hoping this will also fix the issue with some of the pages (notably
CODE_OF_CONDUCT.html) not being available under systemd.io

Tested locally by rendering the website with Jekyll. Before this change, the
*.md files were kept unchanged (so not sure how that even works?!), after this
commit, proper *.html files were generated from it.

2019-01-02 14:16:34 -08:00

2.5 KiB

Raw Blame History

title
Porting systemd To New Distributions

Porting systemd To New Distributions

HOWTO

You need to make the follow changes to adapt systemd to your distribution:

Find the right configure parameters for:
- -Drootprefix=
- -Dsysvinit-path=
- -Dsysvrcnd-path=
- -Drc-local=
- -Dhalt-local=
- -Dloadkeys-path=
- -Dsetfont-path=
- -Dtty-gid=
- -Dntp-servers=
- -Ddns-servers=
- -Dsupport-url=
Try it out.

Play around (as an ordinary user) with /usr/lib/systemd/systemd --test --system for a test run of systemd without booting. This will read the unit files and print the initial transaction it would execute during boot-up. This will also inform you about ordering loops and suchlike.

NTP Pool

By default, systemd-timesyncd uses the Google Public NTP servers time[1-4].google.com, if no other NTP configuration is available. They serve time that uses a leap second smear and can be up to .5s off from servers that use stepped leap seconds.

If you prefer to use leap second steps, please register your own vendor pool at ntp.org and make it the built-in default by passing -Dntp-servers= to meson. Registering vendor pools is free.

Use -Dntp-servers= to direct systemd-timesyncd to different fallback NTP servers.

DNS Servers

By default, systemd-resolved uses the Google Public DNS servers 8.8.8.8, 8.8.4.4, 2001:4860:4860::8888, 2001:4860:4860::8844 as fallback, if no other DNS configuration is available.

Use -Ddns-servers= to direct systemd-resolved to different fallback DNS servers.

PAM

The default PAM config shipped by systemd is really bare bones. It does not include many modules your distro might want to enable to provide a more seamless experience. For example, limits set in /etc/security/limits.conf will not be read unless you load pam_limits. Make sure you add modules your distro expects from user services.

Pass -Dpamconfdir=no to meson to avoid installing this file and instead install your own.

Contributing Upstream

We generally do no longer accept distribution-specific patches to systemd upstream. If you have to make changes to systemd's source code to make it work on your distribution, unless your code is generic enough to be generally useful, we are unlikely to merge it. Please always consider adopting the upstream defaults. If that is not possible, please maintain the relevant patches downstream.

Thank you for understanding.

2.5 KiB Raw Blame History