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

1179 Commits

Author SHA1 Message Date
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
spdfnet
7fee8faa60 docs: update link for SUSE whitepaper
Signed-off-by: spdfnet <32593931+spdfnet@users.noreply.github.com>
2024-04-28 12:44:21 +02:00
Dmitry V. Levin
c309b9e9c3 treewide: fix a few typos in NEWS, docs, comments, and log messages 2024-04-27 12:11:13 +02:00
Frantisek Sumsal
7248912d10 docs: PrepareForSuspend() is not a valid signal name 2024-04-26 14:57:22 +02:00
Frantisek Sumsal
3f1c304803 docs: drop invalid links 2024-04-26 14:57:22 +02:00
Lennart Poettering
6f9a1adf6d vmspawn: add env var that can extend the qemu cmdline
This is a bit hackish, but really useful sometimes to play around with
some qemu switches.
2024-04-20 12:10:42 +02:00
Luca Boccassi
4d3d187493
Merge pull request #32324 from mrc0mmand/more-website-fixes
docs: use absolute links for our pages
2024-04-18 10:55:01 +02:00
Lennart Poettering
778abdbfa1 doc: fix .ssh credential examples
Let's create the .ssh dir with the right perms first.

Suggested by @gcb.

Fixes: #28172
2024-04-18 10:53:20 +02:00
Daan De Meyer
9fede461ca docs: Add note on packages produced by mkosi builds 2024-04-18 09:58:50 +02:00
Yu Watanabe
d2a0ef6073
Merge pull request #32249 from CodethinkLabs/vmspawn/predicatable_tap_names
vmspawn: generate predicatable TAP device names and MAC addresses
2024-04-18 10:26:07 +09:00
Frantisek Sumsal
0d592a5e17 docs: use absolute links for our pages
Since 56b2970 has proven to be a no-go for us, as it breaks existing
links, let's embrace the trailing slash and use absolute links
everywhere for our pages. This way we'll get around browser cleverly
appending the relative link to the current location (since it ends with
a slash), and given our docs/ layout is flat it's not much of a hassle
either.

Converted using this beauty:
  $ sed -ri 's/(\[.+\]\()([A-Z_]+\))/\1\/\2/g' *.md

Resolves: #32088 (again) and #32310
2024-04-17 21:21:23 +02:00
Frantisek Sumsal
87c22d4377 Revert "docs: don't suffix page permalink with a slash"
This breaks existing links with a trailing slash, so it's a no-go.

This reverts commit d1a7e030c5daa4a09ee93b8af6b28ecaac5d34d0.
2024-04-17 20:53:49 +02:00
Zbigniew Jędrzejewski-Szmek
9f74901a1e Merge pull request #31648 from neighbourhoodie/review-content
I did the merge manually to resolve a trivial conflict.
2024-04-17 17:41:07 +02:00
Daan De Meyer
9d98617c1a Update debugging with vscode section
- We have ssh-generator now, so need for mkosi's Ssh= option anymore.
- By enabling RuntimeBuildSources= by default, we don't need the gdb
  config file in the image anymore, since the build and source
  directories will be mounted at the expected locations.
2024-04-16 15:25:34 +02:00
Sam Leonard
c3dd4e20fe
vmspawn: generate predicatable TAP device names and MAC addresses 2024-04-15 11:42:06 +01:00
Frantisek Sumsal
d1a7e030c5 docs: don't suffix page permalink with a slash
As it breaks relative links to other pages. For example, the
BOOT_LOADER_INTERFACE page has a relative link to
AUTOMATIC_BOOT_ASSESSMENT. With a slash in the page's permalink, that
link leads to:

http://127.0.0.1:4000/BOOT_LOADER_INTERFACE/AUTOMATIC_BOOT_ASSESSMENT

which is incorrect. Dropping the trailing slash makes the link link to
the correct place:

http://127.0.0.1:4000/AUTOMATIC_BOOT_ASSESSMENT

Resolves: #32088
2024-04-15 10:54:33 +02:00
Yu Watanabe
1ae891037e
Merge pull request #32202 from DaanDeMeyer/assert
tests: Improve assertion error messages
2024-04-11 09:51:49 +09:00
Daan De Meyer
5c041971eb docs: Add Tests section to coding style doc 2024-04-10 18:24:29 +02:00
Daan De Meyer
f1e9e8041c git: Add post-rewrite hook that invokes git submodule update
git rebase does not support a --recurse-submodules switch to automatically
check out the submodules at their registered commits during or after a rebase.

Instead, let's use the post-rewrite git hook to do this ourselves.
2024-04-10 14:39:49 +02:00
Daan De Meyer
957dc5f190 docs: Suggest soft-reboot to restart pid1 and all daemons in mkosi VM 2024-04-08 22:21:51 +01:00
Daan De Meyer
e71b40fd00 docs: Add note on RuntimeBuildSources= to hacking guide 2024-04-08 11:37:34 +01:00
Lennart Poettering
702a52f4b5 mountfsd: add new systemd-mountfsd component 2024-04-06 16:08:24 +02:00
Luca Boccassi
485bb19d55 docs: notify example was moved to sd_notify manpage
Reference in the portability doc was forgot

Follow-up for 383917ac67570e2dccd558bcde3910a686b9f077
2024-04-02 22:24:38 +01:00
Luca Boccassi
383917ac67 man: add self-contained example of notify protocol
We are saying in public that the protocl is stable and can be easily
reimplemented, so provide an example doing so in the documentation,
license as MIT-0 so that it can be copied and pasted at will.
2024-04-02 14:53:31 +01:00
hulkoba
6d0612f6e6
docs/RANDOM_SEEDS: update NetBSD link 2024-03-27 07:31:56 +01:00
hulkoba
997a84b2e1
chore(docs): change permalink at the Jekyll config
Some of the internal links didn't work.
To make them work we had two options:

1. Keep the trailing slash at the jecyll config:
The built structure of the html files is one directory for each file, including a html file.
This is why a relative link including the `../` is required to get out of the built folder and make it work.
e.g.
config: permalink: /:title/
HACKING.md: [Coding Style](../CODING_STYLE)

2. Remove the trailing slash, the built structure is like the structure in dev: one html file for each markdown file.
In this case, the links as they are implemented just work.
e.g.
config: permalink: /:title
HACKING.md: [Coding Style](CODING_STYLE)

We use option 2 :)
2024-03-27 07:31:55 +01:00
hulkoba
a738c6d9b8
docs/JOURNAL_FILE_FORMAT: format text 2024-03-27 07:31:55 +01:00
hulkoba
e73a7d03a9
docs/COREDUMP: use internal link
for ELF_PACKAGE_METADATA
2024-03-27 07:31:55 +01:00
hulkoba
e217e1eda4
docs/WRITING_DESKTOP_ENVIRONMENTS: format text 2024-03-27 07:31:54 +01:00
hulkoba
d571416acc
docs/WRITING_NETWORK_CONFIG_MANAGERS: format text 2024-03-27 07:31:54 +01:00
hulkoba
90e48c8b98
docs/WRITING_VM_AND_CONTAINER_MANAGERS: format text 2024-03-27 07:31:35 +01:00
hulkoba
68b4b4cf27
docs/RANDOM_SEEDS: format text 2024-03-27 07:26:58 +01:00
hulkoba
d85c8335ea
docs/USERDB_AND_DESKTOPS: format text 2024-03-27 07:26:57 +01:00
hulkoba
a4fd4d9cd5
docs/WRITING_DISPLAY_MANAGER: format text 2024-03-27 07:26:57 +01:00
hulkoba
8af6cde31d
docs/USER_GROUP_API: format text 2024-03-27 07:26:57 +01:00
hulkoba
9ed6cf02b2
docs/PREDICTABLE_INTERACES: format text 2024-03-27 07:26:56 +01:00
hulkoba
b0b8830fa6
docs/MY_SERVICE_CANT_GET_REALTIME: format text 2024-03-27 07:26:56 +01:00
hulkoba
0dd403d187
docs/VIRTUALIZED_TESTING: format text 2024-03-27 07:26:55 +01:00
hulkoba
d6f9d00723
docs/SEPARATE_USR_IS_BROKEN: format text 2024-03-27 07:26:47 +01:00
hulkoba
5a431a1618
docs/SYSTEMD_FILE_HIERARCHY: format text 2024-03-27 07:17:08 +01:00
hulkoba
ca219b008e
docs/PORTABLE_SERVICES: format text 2024-03-27 07:12:06 +01:00
hulkoba
6c46f0e23c
docs/USER_RECORD: format text 2024-03-27 07:12:05 +01:00