1
0
mirror of https://github.com/systemd/systemd.git synced 2025-01-18 10:04:04 +03:00

1120 Commits

Author SHA1 Message Date
Luca Boccassi
42d32c0505 docs: remove 'v' prefix from meson.version
It is actually v-less

(cherry picked from commit 94a46c20dacd8859a6fa3f807b0d134f800a1e90)
2024-11-13 19:48:10 +00:00
Daan De Meyer
e22d571f6b docs: Align some comments in HACKING.md
(cherry picked from commit a33f453702e40f4b52226c6be1a01200aee69470)
2024-11-13 19:48:10 +00:00
Gaël PORTAY
6a288cd999 docs: add a missing : character
This adds the missing colon character to the section systemd-sysusers.

(cherry picked from commit 8ef5ea2bf6d8c9ef12b00ab3838b9af81e30bf5d)
2024-11-13 19:48:10 +00:00
Lennart Poettering
1f0d68c6e9 man: document preference for secure_getenv() in coding style
(cherry picked from commit c9b477415a6293b74df67c8118bafb0ef8662819)
2024-11-13 19:48:10 +00:00
David Rheinsberg
a9aa75145b docs/DESKTOP_ENVIRONMENTS: clarify name aliases
Add a note to the service-file naming scheme that reminds developers
that those names might be aliases. Hence, when parsing such unit names,
the entire name-array of a unit must be parsed, rather than just the
unit ID.

The service-name of existing applications might be already part of their
API. Hence, not all applications can switch the service ID to this new
naming scheme, but can provide suitable aliases. Document this behavior.

(cherry picked from commit b3b7cf8b7c35df14c6eb4f79da1a241dc0aa8c7e)
2024-11-13 19:48:10 +00:00
David Rheinsberg
361021a522 docs/DESKTOP_ENVIRONMENT: clarify <RANDOM> usage
The <RANDOM> part is optional in the naming scheme of application units.
However, this is only true for service files. Scope units must include
the <RANDOM> part, otherwise it would be impossible to parse:

The schema would be:

    `app[-<launcher>]-<ApplicationID>[-<RANDOM>].scope`

in which case a two-part name would be impossible to parse, since it is
unclear whether the launcher of the random bit where omitted.

(cherry picked from commit cbaebf811e6edb79279f72950b2d63189be314d3)
2024-11-13 19:48:10 +00:00
David Rheinsberg
3a0c77aeb9 docs/DESKTOP_ENVIRONMENTS: fix formatting
The annotation about omittance is meant to be about the `RANDOM` string.
However, the current formatting makes it look like the entire naming
scheme is optional. Fix this.

(cherry picked from commit 5697bce82b1b37602255ac12e4a8f4a12305dc03)
2024-11-13 19:48:10 +00:00
Lennart Poettering
ca9b0afd91 docs: don't mention split-usr path anymore
We don't support split /usr/ anymore. Hence fix the paths. This
apparently matters because of PK validating the binary path.

Fixes: #34712
(cherry picked from commit c28a13b5afcf021191494bfa565c55b784dc08fa)
2024-11-13 19:48:10 +00:00
Nils K
c1431b7eff Fix reference to FileDescriptorStoreMax= directive
(cherry picked from commit 543015a164c1fbf22c13c357efb180cf1adc5f03)
2024-10-08 16:39:12 +01:00
Daan De Meyer
1ade483044 mkosi: Add back support for running clangd within mkosi
This allows hacking on systemd without installing any build
dependencies except mkosi on the host machine.

(cherry picked from commit 6d862a9dc08285fffb9da29055235b5c9935dcf8)
2024-10-08 16:39:12 +01:00
Daan De Meyer
0eec580add Add $SYSTEMD_IN_CHROOT to override chroot detection
When running unprivileged, checking /proc/1/root doesn't work because
it requires privileges. Instead, let's add an environment variable so
the process that chroot's can tell (systemd) subprocesses whether
they're running in a chroot or not.

(cherry picked from commit 2701c2f67de592fe2565b084cfaec1667767dbaf)
2024-08-19 07:49:55 +02:00
Daan De Meyer
65eff444c4 docs: Mention the new mount API in the container interface doc
Let's mention that the new mount API may be used to establish new
mounts in a container without needing the /run/host/incoming directory.

(cherry picked from commit 74cc5e2041a2c32e1824b32316bd95f2c8a811f5)
2024-08-15 14:04:41 +01:00
Daan De Meyer
52897cf6a4 docs: Update upgrade commands in HACKING.md
- Add the required options to make the package managers non interactive
- Use apt-get instead of apt
- Remove --reinstall from apt-get command so we only install newer packages
- Add --needed to pacman command so we only install newer packages

(cherry picked from commit 5f5b6fa9017c7c5de1e8a3e6b8888fd71a1d3862)
2024-08-15 14:04:41 +01:00
Jeffrey Bosboom
bd8ba1dcd8 docs/CONTROL_GROUP_INTERFACE.md: document accounting information available via D-Bus
(cherry picked from commit f7fa6326820bbb75a2a7112072a7771944ad8ce3)
2024-08-15 11:07:24 +01:00
Daan De Meyer
cae58967a5 docs: Document how to do stable releases
(cherry picked from commit 518ea76ecdf4855a2db2c0d31ee45f4db48e3242)
2024-07-22 11:05:08 +01:00
Daan De Meyer
172ffeb813 TEST-06-SELINUX: Disable RuntimeBuildSources=
Otherwise fixfiles will try to relabel it which could potentially
lead to disaster. We also change the recommendation in HACKING.md
to set the default so that TEST-06-SELINUX can override it.

(cherry picked from commit 575f954b5d0e03d41fe08ce2a7d85b868e89b904)
2024-07-22 10:26:01 +01:00
Daan De Meyer
c54eab5dd0 mkosi: Streamline running the integration tests without building systemd
Let's document in detail how to build the integration test image and run
the integration tests without building systemd. To streamline the process,
we stop automatically using binaries from build/ when invoking mkosi directly
and don't automatically use a tools tree anymore if systemd on the host is too
old. Instead, we document these options in HACKING.md and change the mkosi meson
target to automatically use the current build directory as an extra binary search
path for mkosi.

(cherry picked from commit d279ec4a50d83ab44200ea410fa09d7ba2e5c824)
2024-07-18 21:14:03 +02:00
migleeson
fa7892a690 docs: update mkosi version mentioned in HACKING.md (#33723)
* fix: update docs since the default config uses a setting only available in v23

* fix: update docs to only refer to installing from the mkosi repo

(cherry picked from commit cb2d6214caa25b8297bde01bb8bb925957b04ba7)
2024-07-18 21:11:36 +02:00
Daan De Meyer
a63e82ca4a repart: Allow overriding fstype per partition designator
$SYSTEMD_REPART_OVERRIDE_FSTYPE is too invasive. Often you want to
override the fstype only for a specific designator, so let's support
that as well.

(cherry picked from commit 90a255779d1f8e6697e08e91918df88bb52274ad)
2024-07-16 15:35:36 +02:00
Daan De Meyer
0c7d634157 docs: Simplify update commands in HACKING.md
Let's make use of mkosi ssh to give everyone a one liner to run instead
of having to execute two commands (one outside the VM, one inside).

(cherry picked from commit 00acdb314768fac76b563857e2ab4a8e33b7be23)
2024-07-11 12:48:12 +02:00
Daan De Meyer
d0a9cf084d docs: Update HACKING
Let's mention the new way to install the latest changes without
rebuilding the image. Let's also remove the duplicate info about
distribution packages that is already mentioned in its own section.

(cherry picked from commit a2403af3293aef9fa5cf32f5ab9fa4eebe5406db)
2024-07-05 20:00:04 +02:00
Luca Boccassi
05dcd242dc docs: update RELEASE.md to use same repository for stable branches
(cherry picked from commit 62cc0aca1750e90dce20463fab03362c26d6df0f)
2024-07-05 20:00:04 +02:00
Daan De Meyer
0a97db8789 docs: Add section to HACKING.md on distribution packages
(cherry picked from commit 17ef81a764995dfd0f43daf34dcf2ab04806e760)
2024-07-05 20:00:04 +02:00
Mike Yuan
3c91ea49d2 docs/CODING_STYLE: document that we nowadays prefer (const char*) for func ret type
Addresses https://github.com/systemd/systemd/pull/33567#discussion_r1662818225

(cherry picked from commit 4b7249111a4c1d366f476bdbd6e03f7893eb9d42)
2024-07-05 20:00:04 +02:00
Mantas Mikulėnas
9cbb3aadd5 run: add environment variable to prevent the setting of terminal title
This goes together with the existing SYSTEMD_TINT_BACKGROUND.

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

(cherry picked from commit 27a2513013d3b3c6140de47e04b3042c5b4487e5)
2024-07-05 20:00:04 +02:00
Daan De Meyer
1eb122033f mkosi: Build a disk image by default again
Now that we have a way to rebuild and reinstall systemd without
having to rebuild the image, let's default to building a disk image
again.

(cherry picked from commit 96110261ee7716bf19a6920a4206365614ad3857)
2024-07-05 11:38:42 +02:00
Luca Boccassi
715d146a3a docs: fix dead link to GNOME documentation
(cherry picked from commit b22ee1010d4ba2e0049b162483c0f185c367d0bb)
2024-06-28 13:35:58 +01:00
Lennart Poettering
a61a83a22b CODING_STYLE: document "reterr_" return parameters
In some recent PRs (e.g. #32628) I started to systematically name return
parameters that shall only be initialized on failure (because they carry
additional error meta information, such as the line/column number of
parse failures or so). Let's make this official in the coding style.

(cherry picked from commit 7811864b08393eda5ff92145ea2776180d9b28ee)
2024-06-18 20:41:01 +02:00
Luca Boccassi
1c27c902ad
Create CNAME 2024-06-11 23:04:12 +01:00
Heran Yang
4762cf0b55 docs: fix escaped $ in CGroup Interface 2024-06-03 16:30:06 +01:00
Heran Yang
7f2ff8b312 docs: fix typo in CGroup Interface 2024-06-03 18:13:57 +09:00
Arian van Putten
30a15ce1d0 docs/DAEMON_SOCKET_ACTIVATION
Remove non-sensical network.target dependencies

There is no need to have these dependencies on socket units as far as I am aware.
2024-06-03 15:22:54 +09:00
Daan De Meyer
ba592dc715 mkosi: Replace submodules with our own thing
Unfortunately, git submodules break in all sorts of ways:

- Various github workflows (dependabot, github pages) try to do a shallow
clone of git submodules which does not work at all when the git repository
is hosted on pagure (https://pagure.io/pagure/issue/5453,
https://github.com/dependabot/dependabot-core/issues/9391).
- If the git forge hosting the git repository uses SHA256, then it breaks our
usage of it as a submodule as SHA256 repositories cannot be used as submodules
in SHA1 repositories (src.opensuse.org moved to SHA256 which broke our usage of
opensuse's systemd spec as a submodule).
- git submodules completely break usage of git worktrees.
- ...

Let's avoid all these issues by just doing our own home grown implementation of
git submodules. We lose the automatic dependabot updates this way but since dependabot
fails to run more often that not with submodules we don't really lose anything.
2024-05-30 19:31:32 +02:00
Luca Boccassi
78247be91d
Merge pull request #33063 from keszybz/wiki-links
Update wiki links
2024-05-28 16:21:45 +02:00
Zbigniew Jędrzejewski-Szmek
bdc965253c docs: drop link to obsolete multiseat page
We link to the man page which replaced this historical document right above,
so just drop the whole paragraph.
2024-05-28 14:48:56 +02:00
Zbigniew Jędrzejewski-Szmek
b346d72c79 man: update links to "Compatibility with SysV" 2024-05-28 14:46:44 +02:00
Mathias Lang
60d285a2b4 docs/CONTRIBUTING.md: Fix links in CONTRIBUTING
Get them to point to the rendered version, instead of
letting Github thinks they are absolute links in the
repository. The rendered version is much more user-friendly.
2024-05-28 12:53:18 +02:00
Luca Boccassi
742ee96dbe
Merge pull request #32784 from YHNdnzj/release-version
docs/RELEASE: use meson.version for tags
2024-05-15 20:25:59 +02:00
Luca Boccassi
93df5217b9 tree-wide: 'allows to' -> 'allows one to'
As flagged by Lintian
2024-05-14 18:33:27 +02:00
Mike Yuan
10fae6ac6e
docs/RELEASE: meson.version doesn't contain "v" prefix 2024-05-13 21:58:29 +08:00
Mike Yuan
efbe45e4ed
docs/RELEASE: use meson.version for tags 2024-05-13 21:58:29 +08:00
Colin Watson
566491c971 docs,man: Avoid some ambiguous uses of "may not"
Like much English text, the systemd documentation uses "may not" in the
sense of both "will possibly not" and "is forbidden to".  In many cases
this is OK because the context makes it clear, but in others I felt it
was possible to read the "is forbidden to" sense by mistake: in
particular, I tripped over "the target file may not exist" in
systemd.unit(5) before realizing the correct interpretation.

Use "might not" or "may choose not to" in these cases to make it clear
which sense we mean.
2024-05-08 17:14:32 +02:00
Luca Boccassi
cb7e3126b9 docs: add specification for ELF dlopen metadata
Tool to parse it and to use it for Debian packaging available at
https://github.com/systemd/package-notes

Add 3 levels of priority like Debian does, but using terminology
from RPM as it seems more apt.
We will very likely never use 'required', as we use this functionality
for optional features, but it is worth having it in the spec nonetheless
as we want it to be generalized.
2024-05-08 11:07:36 +01:00
Adrian Wannenmacher
3a1694803b docs: minor improvements to CREDENTIALS.md
This commit fixes two instances of a miscount. As the number is not important in either case, and seemingly subject to changes, it was removed entirely.

Another sentence was reworded to improve readability.
2024-05-07 11:02:31 +02:00
Daan De Meyer
f779fd1f8f meson: Set up git submodule update on post checkout as well 2024-05-05 14:49:21 +02:00
Lennart Poettering
d4ffb37bb1 nspawn, vmspawn, run0: add env var for turning off background tinting
Some people are just sad, sad lost souls who don't like even the tiniest
ray of color in their life. Let's add an env var knob for allowing them
to turn the background tinting off, to drive the last bit of color from
their life so that they can stay in their grey grey life.
2024-05-02 23:33:39 +02:00
Luca Boccassi
c8de1a8c56 docs: move information from AUTOPKGTEST.md to test/README.testsuite and delete it
This is not information that needs to be published on systemd.io as it's
purely internal, so the README is enough
2024-05-01 01:30:12 +01:00
Luca Boccassi
a8fa9f32e6 docs: drop outdated documents about os-release and cgroupsv1
cgroupv1 is deprecated, and os-release has a fully fledged manpage
2024-05-01 01:30:12 +01:00
Skia
ad23fca3ae docs: autopkgtest: refresh the docs with up-to-date information
@iainlane doesn't work on Ubuntu infrastructure anymore, and `bionic` is still ESM, but not really supported anymore either.  
`noble`, which is the latest Ubuntu, probably is better for testing `systemd` in 2024, and pinging `qa-help` on IRC is the current official way to contact the team behind Ubuntu's infrastructure.
2024-04-30 16:16:31 +02:00
nl6720
92ecff6098 docs/DEBUGGING.md: use an underscore in the kernel command line option
systemd-debug-generator(8) lists it as `systemd.debug_shell`.

According to 1d84ad944520fc3e062ef518c4db4e1d3a1866af, kernel command
line options should use an underscore instead of a dash.
2024-04-29 14:16:57 +02:00