README revision 19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91
d657c51f14601d0235434ffb78cf6ac0f27cc83cLennart Poetteringsystemd System and Service Manager
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringDETAILS:
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering http://0pointer.de/blog/projects/systemd.html
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringWEB SITE:
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering http://www.freedesktop.org/wiki/Software/systemd
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringGIT:
9fa2f41077b2d76685058836f602f38715b5eef3Kay Sievers git://anongit.freedesktop.org/systemd/systemd
9fa2f41077b2d76685058836f602f38715b5eef3Kay Sievers ssh://git.freedesktop.org/git/systemd/systemd
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringGITWEB:
9fa2f41077b2d76685058836f602f38715b5eef3Kay Sievers http://cgit.freedesktop.org/systemd/systemd
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringMAILING LIST:
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering http://lists.freedesktop.org/mailman/listinfo/systemd-devel
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering http://lists.freedesktop.org/mailman/listinfo/systemd-commits
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringIRC:
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering #systemd on irc.freenode.org
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringBUG REPORTS:
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering https://bugs.freedesktop.org/enter_bug.cgi?product=systemd
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringAUTHOR:
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lennart Poettering
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Kay Sievers
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering ...and many others
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart Poettering
673eab9bf0d2d79a72f3d7c430807b8786de7ee3Lennart PoetteringLICENSE:
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering LGPLv2.1+ for all code
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering - except sd-daemon.[ch] and sd-readahead.[ch] which are MIT
7c09aafd269bc04dcfc07d94c4ee583b7b0751e6Kay Sievers - except src/udev/ which is GPLv2.0+
673eab9bf0d2d79a72f3d7c430807b8786de7ee3Lennart Poettering
31cee6f634ce07aa2c3514a506f93830f91f14a5Lennart PoetteringREQUIREMENTS:
b7f44df59a7f76d2bd5302df2f5ec9be9b7fa2faLennart Poettering Linux kernel >= 2.6.39
b7f44df59a7f76d2bd5302df2f5ec9be9b7fa2faLennart Poettering with devtmpfs
b7f44df59a7f76d2bd5302df2f5ec9be9b7fa2faLennart Poettering with cgroups (but it's OK to disable all controllers)
b7f44df59a7f76d2bd5302df2f5ec9be9b7fa2faLennart Poettering optional but strongly recommended: autofs4, ipv6
c1c8ca815bb1ef040c0a84cccd51282e4ce8f4deKay Sievers dbus >= 1.4.0
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering libcap
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering PAM >= 1.1.2 (optional)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering libcryptsetup (optional)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering libaudit (optional)
19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91Zbigniew Jędrzejewski-Szmek libacl (optional)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering libselinux (optional)
19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91Zbigniew Jędrzejewski-Szmek liblzma (optional)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering tcpwrappers (optional)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering When you build from git you need the following additional dependencies:
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering docbook-xsl
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering xsltproc
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering automake
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering autoconf
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering libtool
19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91Zbigniew Jędrzejewski-Szmek intltool
b62cfcea00862ccbf0e5e297f8a339f70987edefMichael Biebl gperf
19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91Zbigniew Jędrzejewski-Szmek gtkdocize (optional)
19d5d4cb6a89c844e298eb65bce6ba0fa9d58b91Zbigniew Jędrzejewski-Szmek python (optional)
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering make, gcc, and similar tools
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering During runtime you need the following dependencies:
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering
c1c8ca815bb1ef040c0a84cccd51282e4ce8f4deKay Sievers util-linux > v2.18 (requires fsck -l, agetty -s)
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering sulogin (from sysvinit-tools, optional but recommended)
3ede835a0486f2ecc025dede0b33e9a1edc06d30Lennart Poettering dracut (optional)
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering When systemd-hostnamed is used it is strongly recommended to
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering install nss-myhostname to ensure that in a world of
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering dynamically changing hostnames the hostname stays resolveable
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering under all circumstances. In fact, systemd-hostnamed will warn
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering if nss-myhostname is not installed. Packagers are encouraged to
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering add a dependency on nss-myhostname to the package that
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering includes systemd-hostnamed.
fff2e5b58bab7a5ffbb7593742d462197b06728cLennart Poettering
6705c2df468a6afb4f8f834822780add123065e2Lennart Poettering Note that D-Bus can link against libsystemd-login.so, which
49f43d5f91a99b23f745726aa351d8f159774357Ville Skyttä results in a cyclic build dependency. To accommodate for this
6705c2df468a6afb4f8f834822780add123065e2Lennart Poettering please build D-Bus without systemd first, then build systemd,
6705c2df468a6afb4f8f834822780add123065e2Lennart Poettering then rebuild D-Bus with systemd support.
6705c2df468a6afb4f8f834822780add123065e2Lennart Poettering
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart PoetteringWARNINGS:
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering systemd will warn you during boot if /etc/mtab is not a
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering symlink to /proc/mounts. Please ensure that /etc/mtab is a
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering proper symlink.
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering systemd will warn you during boot if /usr is on a different
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering file system than /. While in systemd itself very little will
ed1c99fcc13f279eccf25fc20427eb92867da245Lennart Poettering break if /usr is on a separate partition many of its
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering dependencies very likely will break sooner or later in one
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering form or another. For example udev rules tend to refer to
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering binaries in /usr, binaries that link to libraries in /usr or
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering binaries that refer to data files in /usr. Since these
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering breakages are not always directly visible systemd will warn
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering about this, since this kind of file system setup is not really
21bc923aa35d455cdef1607eb7022608c705c9f3Lennart Poettering supported anymore by the basic set of Linux OS components.
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering
aa1671320df5bd8aa4108c0efb34a49fdedd0e5fLennart Poettering For more information on this issue consult
aa1671320df5bd8aa4108c0efb34a49fdedd0e5fLennart Poettering http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken
aa1671320df5bd8aa4108c0efb34a49fdedd0e5fLennart Poettering
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart PoetteringENGINEERING AND CONSULTING SERVICES:
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering ProFUSION <http://profusion.mobi> offers professional
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering engineering and consulting services for systemd for embedded
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering and other use. Please contact Gustavo Barbieri
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering <barbieri@profusion.mobi> for more information.
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering Disclaimer: This notice is not a recommendation or official
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering endorsement. However, ProFUSION's upstream work has been very
fc7a744cc44cdb80bf9bc6304fc3f80ca2cb65f9Lennart Poettering beneficial for the systemd project.