summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2010-05-17 01:39:51 +0200
committerLennart Poettering <lennart@poettering.net>2010-05-17 01:40:02 +0200
commiteb10a76494542fb560efd09c16b40826fc37bc5f (patch)
treef0a89464357c0dfaa2ecd72ac7d1c660f82056aa
parent5e6afdd3d359fc42de7ac432243e98673577e81f (diff)
docs: add terse distribution porting guide
-rw-r--r--DISTRO_PORTING36
-rw-r--r--Makefile.am3
2 files changed, 38 insertions, 1 deletions
diff --git a/DISTRO_PORTING b/DISTRO_PORTING
new file mode 100644
index 0000000000..419053832d
--- /dev/null
+++ b/DISTRO_PORTING
@@ -0,0 +1,36 @@
+Porting systemd To New Distributions
+
+ You need to make the follow changes to adapt systemd to your
+ distribution:
+
+ 0) Make your distribution recognized via the autoconf checks
+ in configure.ac. Grep for the word "fedora" (case
+ insensitively) and you should be able to find the places where
+ you need to add/change things.
+
+ 1) Patch src/hostname-setup.c so that systemd knows where to
+ read your host name from.
+
+ 2) Check the unit files in units/ if they match your
+ distribution. Most likely you will have to make additions to
+ units/*.m4 and create a copy of units/fedora/ with changes for
+ your distribution.
+
+ 3) Adjust Makefile.am to register the unit files you added in
+ step 2. Also you might need to update the m4 invocation in
+ Makefile.am. Grep for the word "fedora" (case insensitively)
+ and you should be able to find the places where you need to
+ add/change things.
+
+ 4) Try it out.
+
+CONTRIBUTING UPSTREAM:
+
+ We are interested in merging your changes upstream, if they
+ are for a big, and well-known distribution. Unfortunately we
+ don't have the time and resources to maintain
+ distribution-specific patches for all distributions on the
+ planet, hence please do not send us patches that adds systemd
+ support to non-mainstream or niche distributions.
+
+ Thank you for understanding.
diff --git a/Makefile.am b/Makefile.am
index 973c08e4ce..683a00bc0c 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -102,7 +102,8 @@ EXTRA_DIST = \
units/systemd-logger.service.in \
units/syslog.target.in \
LICENSE \
- README
+ README \
+ DISTRO_PORTING
if TARGET_FEDORA
dist_systemunit_DATA += \