Commit Graph

1313 Commits

Author SHA1 Message Date
Philip Withnall
c624313e96 docs: Update memory pressure docs for latest GLib support for it
As of GLib 2.90.0 (not yet released), GLib will fully support the spec,
including the `MEMORY_PRESSURE_WATCH` and `MEMORY_PRESSURE_WRITE`
environment variables, which it did not support previously.

See https://gitlab.gnome.org/GNOME/glib/-/merge_requests/5046

(cherry picked from commit 075f74a19c)
(cherry picked from commit 97369d584a)
(cherry picked from commit 64d15be6f0)
(cherry picked from commit ce35320b5c)
2026-07-24 09:17:09 +01:00
Jordan Petridis
4bfe37e047 docs/INHIBITOR_LOCKS: Update sentence for the new mode added
804874d26a added a new mode but the
sentence wasn't updated and it was still stating that there are Two modes
instead.

(cherry picked from commit 84d10a9004)
(cherry picked from commit 3ff640df40)
(cherry picked from commit c2038aaa6a)
2026-06-26 20:52:16 +01:00
Luca Boccassi
78ba10d338 docs: specifically mention that braces in if blocks do not need to be symmetric
The claude bot keeps getting this wrong again and again:

  Claude: nit: systemd coding style requires braces on both branches of
               an if/else when one branch uses them. Here the if branch
               is a single statement without braces but the else branch
               uses braces

Specifically mention this is not the case in the coding style doc
to hopefully make it stop hallucinating this rule

(cherry picked from commit 36896a27b1)
(cherry picked from commit e0e731c653)
(cherry picked from commit ce4ffe001f)
2026-06-26 20:52:16 +01:00
roib
5c4701e107 docs: update footer to 2026
(cherry picked from commit db1ca20591)
(cherry picked from commit 2aa3e50692)
(cherry picked from commit 10824f7465)
2026-05-27 15:23:32 +01:00
rusty-snake
9f26143db8 docs: fix capability name, it's CAP_MKNOD not CAP_SYS_MKNOD (#41621)
(cherry picked from commit b40ed2067f)
(cherry picked from commit c36c8a31e6)
(cherry picked from commit 524adaec7d)
2026-05-27 15:23:31 +01:00
Kit Dallege
d7108f7857 docs: fix misleading VM/machined documentation
Fix two issues in WRITING_VM_AND_CONTAINER_MANAGERS.md:

1. The Host OS Integration section implied that -M switch and
   machinectl shell/login work for VMs, but they currently only
   work for containers. Add a note clarifying this limitation.

2. The Guest OS Integration section said "there's only one" VM
   integration API (SMBIOS Product UUID), but VM_INTERFACE.md
   documents five. Replace the outdated single-API description
   with a reference to VM_INTERFACE.md listing all five.

Fixes #40935

Co-developed-by: Claude Opus 4.6 <noreply@anthropic.com>
(cherry picked from commit adc4757b9e)
(cherry picked from commit 385dc8fb38)
(cherry picked from commit a256323c8e)
2026-05-27 15:23:31 +01:00
Adrian Wannenmacher
4b52d65856 fix list of inhibitor lock types
Markdown and HTML don't support mixing ordered and unordered items
within a single list. This means the previous syntax actually produced
three separate lists.

Also, markdown converters don't necesarrily respect the first number in
an ordered list, and may just overwrite it to one. This is the case for
the one that generates the systemd.io page. And even if that wasn't the
case, the numbering of the second ordered list would be off by one.

(cherry picked from commit f377be7081)
(cherry picked from commit 5665b14945)
(cherry picked from commit 656670df9d)
2026-05-27 14:34:09 +01:00
Rito Rhymes
6d94364009 docs: contain image sizing and prevent overflow on mobile
`max-width: 100%` keeps images from expanding beyond
their container and creating horizontal overflow scroll
on small screens.

`height: auto` ensures the image scales proportionally
when width is adjusted.

(cherry picked from commit e5a6cc3a6f)
(cherry picked from commit 6c6b635b8a)
2026-03-12 17:20:56 +00:00
Rito Rhymes
7375e31d06 docs: wrap bare enum constants in inline code in JOURNAL_FILE_FORMAT
(cherry picked from commit f18df62e71)
(cherry picked from commit b4e951c3de)
2026-03-12 17:20:56 +00:00
Rito Rhymes
55f1b0770f docs: allow long inline code to wrap to prevent overflow on mobile
(cherry picked from commit f9d4dce604)
(cherry picked from commit 45d9ecaa55)
2026-03-12 17:20:56 +00:00
Rito Rhymes
39677a7769 docs: allow long links to wrap to prevent overflow on mobile
(cherry picked from commit 4443626b16)
(cherry picked from commit ea5aad4518)
2026-03-12 17:20:56 +00:00
Lennart Poettering
17cb26408d CODING_STYLE: add a brief log msg style guide
(cherry picked from commit 83b4a5bb3d)
(cherry picked from commit a0981c8d3e)
2026-02-26 22:46:18 +00:00
Luca Boccassi
13dd43b83b journald: set a lower size limit for FDs from unpriv processes
Unprivileged processes can send 768M in a FD-based message to journald,
which will be malloc'ed in one go, likely causing memory issues.
Set the limit for unprivileged users to 24M.

Allow coredumps as an exception, since we always allowed storing
up to the 768M max core files in the journal.

Reported on yeswehack.com as #YWH-PGM9780-48

(cherry picked from commit e67b008fa3)
(cherry picked from commit d33dbbc613)
2026-02-26 22:46:18 +00:00
Philip Withnall
b14faca811 docs: Add a diagram for the internals of sysupdate
I had to sketch this out before I could get the internals of
systemd-sysupdate straight in my head, particularly around how an
`UpdateSet` points to one `Instance` from each of a set of `Resource`s,
and those `Instance`s are either all sources or all targets.

Hopefully this is useful to the next person to look at the code.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
(cherry picked from commit a05439097f)
(cherry picked from commit 877b9f9a0d)
2026-02-06 19:33:55 +00:00
DaanDeMeyer
59dbbbb71c docs: Document practice of using comments for argument names
(cherry picked from commit 90e80b9e8b)
(cherry picked from commit 9af7887104)
2026-02-06 19:33:55 +00:00
Ben Boeckel
b536ad10fc docs/PASSWORD_AGENTS: document the AcceptCached= field
(cherry picked from commit 0d15b2304b)
(cherry picked from commit 487ad1c9db)
2026-02-06 19:33:54 +00:00
Ben Boeckel
af93b676fc docs/PASSWORD_AGENTS: document the Silent= field
(cherry picked from commit 9f4606c361)
(cherry picked from commit 59d7895d48)
2026-02-06 19:33:54 +00:00
Ben Boeckel
a7f1811c6f docs/PASSWORD_AGENTS: clarify that Echo=0 may obscure
(cherry picked from commit dc08cb1eb8)
(cherry picked from commit f5a743ebe8)
2026-02-06 19:33:54 +00:00
Ben Boeckel
ee37bb2bf2 docs/PASSWORD_AGENTS: note that the user directory may be created
(cherry picked from commit 19d7ce2f7b)
(cherry picked from commit d526f7ce75)
2026-02-06 19:33:54 +00:00
DaanDeMeyer
176dbb299a docs: Add explicit reference to unprivileged userns docs of mkosi
Fixes #40216

(cherry picked from commit f3c67f7e16)
(cherry picked from commit 0c12b14d2c)
2026-02-06 19:33:54 +00:00
Lennart Poettering
2c995ad5ea docs: add redirection of the osc context to uapi website
(cherry picked from commit d91aed3b55)
(cherry picked from commit 36dd990ee2)
2026-02-06 19:33:54 +00:00
Yu Watanabe
26ce84e7c3 docs/MOUNT_REQUIREMENTS: fix typo
Follow-ups for 3e94ae6f1e.

(cherry picked from commit f01daa30f1)
2025-12-10 15:40:23 +00:00
Lennart Poettering
a5c54d338c docs: reference UAPI specs by their number when linked
(cherry picked from commit 81b52a013c)
2025-12-10 15:40:23 +00:00
Luca Boccassi
f41b420973 docs: elf metadata specs have moved to uapi-group
(cherry picked from commit 6d36d07599)
2025-12-10 15:40:23 +00:00
Zbigniew Jędrzejewski-Szmek
f5d90b360c docs/MOUNT_REQUIREMENTS: also link to LFHS
This document doesn't really without the basis of the other one.

(cherry picked from commit 720876d5c0)
2025-12-10 15:40:23 +00:00
Zbigniew Jędrzejewski-Szmek
9e488f8324 docs/MOUNT_REQUIREMENTS: describe nested mounts more carefully
I was looking into a question posed in one of the Fedora discussion threads:
is it OK for a package to assume that files in different directories under /usr
are always on the same mount point? rpmlint emits a warning if a package has
files that are hardlinked between directories, i.e. rpmlint thinks that this
is not the case. But in practice, our systems are like this and our tooling
generally doesn't expect a part of /usr to be separated out. I looked at the
MOUNT_REQUIREMENTS document, but it doesn't answer this question clearly.
It was clearly written with the assumption that e.g. "/usr/" or "/var/" are one
mount point, so when it is "mounted", all of it is available. But the document
also talks about submounts being pulled in through requirements on specific
units, which requires some mounts not to be mounted all at once, so the reader
is left without any direct answer to this question.

This rewrite makes the following changes:
- rename "generally three categories of requirements" to
  "three general categories of mount points" because we're categorizing
  mount points, not requirements.
- always repeat the category name in further mentions,
  e.g. "2/early" instead of just "2" so the reader doesn't have to jump
  back to the table when reading.
- mention that it is OK for a mount point to be not split out
- say that submount which is "conceptually separate" may be mounted
  later.
- say "ephemeral system" instead of "stateless system" and split out
  the description of those systems into a separate paragraph and clearly
  state that they are an exception that skips the requirements listed in
  this document.
- be consistent in specifying the boundary before which each category must
  have been mounted. Previously, cat. 1 was described as "before transisition"
  and cat. 2 was described as "during early boot", which created the additional
  problem that later we needed to contradict this saying that "must be mounted
  during early boot" doesn't actually mean that and this can be done ealier.
  If we say "before end of early boot", we avoid this awkwardness.

(cherry picked from commit 3e94ae6f1e)
2025-12-10 15:40:23 +00:00
Daan De Meyer
0c87b4cb7a Various documentation updates
(cherry picked from commit 7e5a07c24a)
2025-12-10 15:40:23 +00:00
Philip Withnall
c8855d5c7b docs: Update MEMORY_PRESSURE to mention recent improvements in GLib
See https://gitlab.gnome.org/GNOME/glib/-/issues/2931 for the changes in
GLib upstream. Using `GMemoryMonitor` is now more compliant with the
systemd recommended approach, but it needs further work to read the
recommended environment variables rather than unconditionally accessing
the per-cgroup PSI kernel file directly.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
(cherry picked from commit 69f1a1d5ed)
2025-12-10 15:40:23 +00:00
Ivan Kruglov
a0cdf165bc docs: initial version of varlink guideline
(cherry picked from commit b8ef90d6fd)
2025-12-10 15:40:23 +00:00
Zbigniew Jędrzejewski-Szmek
3ce367fd61 docs/BACKPORTS: update
We now keep stable branches in the main repo. Update the description
to match current practice.

Closes https://github.com/systemd/systemd/issues/35846.

(cherry picked from commit aff5c0af8b)
2025-12-10 15:40:23 +00:00
Septatrix
3ad1fced57 Remove dns0.eu from default DNS servers
The service has ceased operation.
Partially reverts 02527e95b5.

(cherry picked from commit 93b6d43253)
2025-11-06 21:26:42 +00:00
Lennart Poettering
b8da149ab8 docs: add comment about requiring the mount hierarchy to be mounted MS_SHARED
This has been tripping up container manager people. let's document this
explicitly.

(Note that the container interface could really use some updates, i.e.
it was written before a time where cgroup namespacing was a thing. But I
am too lazy to fix that now, so let's just add this once facet.)

(cherry picked from commit 32f4e30be5)
2025-11-06 14:13:33 +00:00
Marien Zwart
3fb23fcc4b docs: fix conversion / calculation errors
0x1770 is 6000, not 60000. It looks like 60000 is intended (the next
range starts at 60000 in both decimal and hex), so use that.

1000 to 60000 is 59001 users, as the range is inclusive on both sides.
Similar off-by-one for one of the "unused" ranges. After these changes,
the sizes of the ranges up to and including the "-1" ID sum up to 65536,
as expected.

I'm not sure where the size of the unused range after the container UID
range came from, but it is not correct (the "Container UID" and this
reserved range combined would be larger than the "HIC SVNT LEONES" 2^31
to 2^32-2 range...). Fix it.

It is unfortunate that the first half of this table makes more sense in
decimal while the second half makes more sense in hex (which would also
make the size in 65536 chunks easy to obtain): I'm tempted to add a
"sizes in hex" column...

(cherry picked from commit 1599b6fbe2)
2025-11-06 14:13:33 +00:00
Le_Futuriste
f9553d5d14 docs(boot): fix typo in code block
(cherry picked from commit 83b5dabb40)
2025-10-10 10:36:48 +02:00
Luca Boccassi
789dd1b672 docs: use '_' as separator for OSC page
Make it consistent with other pages

Fixes https://github.com/systemd/systemd/issues/39019

(cherry picked from commit 12ef7e0a2c)
2025-09-19 12:14:29 +01:00
Luca Boccassi
78620ad520 Create CNAME 2025-09-17 14:59:00 +01:00
Salim B
d92990c783 docs: fix typo 2025-08-18 04:43:44 +09:00
Yu Watanabe
ed9c82095a assert-util: introduce log_set_assert_return_is_critical_from_env()
It will be used for testing nss modules.
2025-08-17 00:14:42 +09:00
DaanDeMeyer
cb372a3ce4 docs: Add policy on AI generated code to contributing doc
Contributors making use of AI should clearly mention so in their
PR descriptions and include the prompt used to generate the pull
request.
2025-07-29 18:40:26 +02:00
Zbigniew Jędrzejewski-Szmek
b68b9f8f7f docs/ENVIRONMENT: fix typo and adjust grammar 2025-07-29 11:36:21 +02:00
Nick Owens
8acee7c35e docs: fix SurviveFinalKillSignal typo 2025-07-22 18:03:39 +01:00
Luca Boccassi
bfeaefebf2 docs: mention LoaderTpm2ActivePcrBanks in BLI
Follow-up for 6eab4cd44c
2025-07-22 17:05:21 +02:00
Philip Freeman
72775b7c89 Update USER_RECORD.md (#38283)
trailing comma here is invalid json.
2025-07-22 18:27:37 +09:00
Lennart Poettering
0fa8b51962 tree-wide: the env var is called $XDG_RUNTIME_DIR, not $XDG_RUNTIME_DIRECTORY 2025-07-15 12:49:08 +02:00
Yu Watanabe
e58ba80a40 units: drop runlevel[0-6].target 2025-07-13 05:49:09 +09:00
Yu Watanabe
af925f7eb3 systemctl: kill SysV compat 'runlevel' command 2025-07-13 05:38:13 +09:00
Yu Watanabe
1d81c3a74e docs: mention src/include/ directories 2025-07-11 13:05:46 +09:00
DaanDeMeyer
7f76ff2821 tree-wide: Use "mkosi box" instead of "mkosi sandbox"
The box verb was added as a synonym for sandbox. sandbox still works,
but let's switch to box as it's shorter.
2025-07-10 16:24:34 +02:00
Andres Beltran
26c6f3271a core: add quota support for State, Cache, and Log exec directories 2025-07-07 17:28:47 +00:00
Lennart Poettering
d03714e4e4 tree-wide: "human readable" → "human-readable"
Apparently, the spelling with a hyphen is better style in the English
language.

Suggested by: #36165
2025-07-07 11:21:25 +02:00