mirror of
https://github.com/systemd/systemd.git
synced 2024-11-01 17:51:22 +03:00
c3e270f4ee
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.
80 lines
2.5 KiB
Markdown
80 lines
2.5 KiB
Markdown
---
|
|
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:
|
|
|
|
1. 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=`
|
|
|
|
2. 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](https://developers.google.com/time/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](http://www.pool.ntp.org/en/vendors.html).
|
|
|
|
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.
|