shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2024-12-22 17:35:35 +03:00
Code
36ca0164ab
systemd/docs/index.md

99 lines
5.5 KiB
Markdown
Raw Normal View History

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-03 01:16:34 +03:00
---
docs: make it pretty Add custom Jekyll theme, logo, webfont and .gitignore FIXME: the markdown files have some H1 headers which need to be replaced with H2
2019-12-11 19:01:46 +03:00
layout: default
docs: add spdx tags to all .md files I have no idea if this is going to cause rendering problems, and it is fairly hard to check. So let's just merge this, and if it github markdown processor doesn't like it, revert.
2021-09-14 17:05:21 +03:00
SPDX-License-Identifier: LGPL-2.1-or-later
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-03 01:16:34 +03:00
---
docs: provide a first level headline for the frontpage * Provides a nice introduction to the intro paragraph * Ensures text of subpages start at the same position as the intro text on the homepage => less visual "jumps" while navigating
2022-05-17 18:05:22 +03:00
# System and Service Manager
docs: make it pretty Add custom Jekyll theme, logo, webfont and .gitignore FIXME: the markdown files have some H1 headers which need to be replaced with H2
2019-12-11 19:01:46 +03:00
systemd is a suite of basic building blocks for a Linux system. It provides a system and service manager that runs as PID 1 and starts the rest of the system.
docs: remove trailing space
2022-05-17 14:47:21 +03:00
systemd provides aggressive parallelization capabilities, uses socket and D-Bus activation for starting services, offers on-demand starting of daemons, keeps track of processes using Linux control groups, maintains mount and automount points, and implements an elaborate transactional dependency-based service control logic. systemd supports SysV and LSB init scripts and works as a replacement for sysvinit.
docs: make it pretty Add custom Jekyll theme, logo, webfont and .gitignore FIXME: the markdown files have some H1 headers which need to be replaced with H2
2019-12-11 19:01:46 +03:00
Other parts include a logging daemon, utilities to control basic system configuration like the hostname, date, locale, maintain a list of logged-in users and running containers and virtual machines, system accounts, runtime directories and settings, and daemons to manage simple network configuration, network time synchronization, log forwarding, and name resolution.
---
docs: add a simple, auto-generated index.md This is useful for the github pages feature
2018-10-02 10:53:05 +03:00
Revert "docs: use collections to structure the data" This reverts commit 5e8ff010a1436d33bbf3c108335af6e0b4ff7a2a. This broke all the URLs, we can't have that. (And actually, we probably don't _want_ to make the change either. It's nicer to have all the pages in one directory, so one doesn't have to figure out to which collection the page belongs.)
2024-02-23 11:48:47 +03:00
{% assign by_category = site.pages | group_by:"category" %}
{% assign extra_pages = site.data.extra_pages | group_by:"category" %}
{% assign merged = by_category | concat: extra_pages | sort:"name" %}
docs: beef up entrypoint documentation page Let's use the rough categorization of the markdown pages to add basic sections, via Jeykll templating. Also, add in a couple of additional links via a JSON array that lists them. So much web development, so much wow!
2019-12-11 12:49:59 +03:00
Revert "docs: use collections to structure the data" This reverts commit 5e8ff010a1436d33bbf3c108335af6e0b4ff7a2a. This broke all the URLs, we can't have that. (And actually, we probably don't _want_ to make the change either. It's nicer to have all the pages in one directory, so one doesn't have to figure out to which collection the page belongs.)
2024-02-23 11:48:47 +03:00
{% for pair in merged %}
{% if pair.name != "" %}
## {{ pair.name }}
{% assign sorted = pair.items | sort:"title" %}{% for page in sorted %}
docs: beef up entrypoint documentation page Let's use the rough categorization of the markdown pages to add basic sections, via Jeykll templating. Also, add in a couple of additional links via a JSON array that lists them. So much web development, so much wow!
2019-12-11 12:49:59 +03:00
* [{{ page.title }}]({{ page.url | relative_url }}){% endfor %}
Revert "docs: use collections to structure the data" This reverts commit 5e8ff010a1436d33bbf3c108335af6e0b4ff7a2a. This broke all the URLs, we can't have that. (And actually, we probably don't _want_ to make the change either. It's nicer to have all the pages in one directory, so one doesn't have to figure out to which collection the page belongs.)
2024-02-23 11:48:47 +03:00
{% endif %}
docs: generate index.md in Jekyll This uses a {% for %} loop in Jekyll to render the page, from the "title" information in the Front Matter of the actual page files. This also makes `make-index-md` build rule unnecessary, since generation is done by the template engine itself. Tested this by running Jekyll locally.
2019-01-03 01:20:39 +03:00
{% endfor %}
docs: make it pretty Add custom Jekyll theme, logo, webfont and .gitignore FIXME: the markdown files have some H1 headers which need to be replaced with H2
2019-12-11 19:01:46 +03:00
docs: update old para with links to the blog stories They are of historical interest, but without links not very useful.
2020-01-14 23:35:24 +03:00
## See also
tree-wide: use https for the 0pointer.de doc links
2023-06-23 14:08:57 +03:00
* [Introductory blog story](https://0pointer.de/blog/projects/systemd.html)
* [Three](https://0pointer.de/blog/projects/systemd-update.html) [status](https://0pointer.de/blog/projects/systemd-update-2.html) [updates](https://0pointer.de/blog/projects/systemd-update-3.html)
docs: shift console log on index page to the left
2020-01-15 13:55:49 +03:00
* The [Wikipedia article](https://en.wikipedia.org/wiki/systemd)
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
docs: shift console log on index page to the left
2020-01-15 13:55:49 +03:00
---
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
<pre class="intro-code-block">
Welcome to <span class="color-blue">Fedora 20 (Heisenbug)</span>!
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Reached target Remote File Systems.
[ <span class="color-green">OK</span> ] Listening on Delayed Shutdown Socket.
[ <span class="color-green">OK</span> ] Listening on /dev/initctl Compatibility Named Pipe.
[ <span class="color-green">OK</span> ] Reached target Paths.
[ <span class="color-green">OK</span> ] Reached target Encrypted Volumes.
[ <span class="color-green">OK</span> ] Listening on Journal Socket.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Mounting Huge Pages File System...
Mounting POSIX Message Queue File System...
Mounting Debug File System...
Starting Journal Service...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started Journal Service.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Mounting Configuration File System...
Mounting FUSE Control File System...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Created slice Root Slice.
[ <span class="color-green">OK</span> ] Created slice User and Session Slice.
[ <span class="color-green">OK</span> ] Created slice System Slice.
[ <span class="color-green">OK</span> ] Reached target Slices.
[ <span class="color-green">OK</span> ] Reached target Swap.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Mounting Temporary Directory...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Reached target Local File Systems (Pre).
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Starting Load Random Seed...
Starting Load/Save Random Seed...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Mounted Huge Pages File System.
[ <span class="color-green">OK</span> ] Mounted POSIX Message Queue File System.
[ <span class="color-green">OK</span> ] Mounted Debug File System.
[ <span class="color-green">OK</span> ] Mounted Configuration File System.
[ <span class="color-green">OK</span> ] Mounted FUSE Control File System.
[ <span class="color-green">OK</span> ] Mounted Temporary Directory.
[ <span class="color-green">OK</span> ] Started Load Random Seed.
[ <span class="color-green">OK</span> ] Started Load/Save Random Seed.
[ <span class="color-green">OK</span> ] Reached target Local File Systems.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Starting Recreate Volatile Files and Directories...
Starting Trigger Flushing of Journal to Persistent Storage...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started Recreate Volatile Files and Directories.
units: adjust description of systemd-update-utmp.service "Update about" is not gramatically correct. I also think saying "Record" makes this easier to understand for people who don't necessarilly know what UTMP is.
2021-06-30 14:20:27 +03:00
Starting Record System Reboot/Shutdown in UTMP...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started Trigger Flushing of Journal to Persistent Storage.
[ <span class="color-green">OK</span> ] Started Record System Reboot/Shutdown in UTMP.
[ <span class="color-green">OK</span> ] Reached target System Initialization.
[ <span class="color-green">OK</span> ] Reached target Timers.
[ <span class="color-green">OK</span> ] Listening on D-Bus System Message Bus Socket.
[ <span class="color-green">OK</span> ] Reached target Sockets.
[ <span class="color-green">OK</span> ] Reached target Basic System.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Starting Permit User Sessions...
Starting D-Bus System Message Bus...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started D-Bus System Message Bus.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Starting Login Service...
Starting Cleanup of Temporary Directories...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started Permit User Sessions.
[ <span class="color-green">OK</span> ] Started Cleanup of Temporary Directories.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Starting Console Getty...
docs: overhaul styling for example log messages on startpage * Use brand-green for demo log messages on the startpage instead of the default `green` color defined by the browser vendor (after all, the brand green color is intended to reflect the boot status output) * Add a matching blue intro color (mixed using HSL from brand-green by 55deg hue rotation and 4% lightness) * Use a defined font-size (to avoid blurry rendering at 13.33333px, due to font-size: smaller) * Add possibility for the browser to show horizontal scrollbar (avoid overflow in mobile view)
2022-05-17 14:48:27 +03:00
[ <span class="color-green">OK</span> ] Started Console Getty.
[ <span class="color-green">OK</span> ] Reached target Login Prompts.
[ <span class="color-green">OK</span> ] Started Login Service.
[ <span class="color-green">OK</span> ] Reached target Multi-User System.
docs: add the systemd output example It is still nice...
2020-01-14 23:35:44 +03:00
Fedora release 20 (Heisenbug)
Kernel 3.9.2-200.fc18.x86_64 on an x86_64 (console)
fedora login:
</pre>
Copy Permalink