summaryrefslogtreecommitdiffstats
path: root/man/systemd-journald.service.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: asorted fixesYu Watanabe10 days1-5/+9
| | | | Closes #35307.
* journal: Add journal.storage credentialDaan De Meyer2024-04-301-0/+31
| | | | | | In mkosi CI, we want persistent journals when running interactively and runtime journals when running in CI, so let's add a credential that allows us to configure which one to use.
* man: explicitly document the various systemd.journald.max_level_*= kernel ↵Lennart Poettering2024-04-221-0/+18
| | | | | | cmdline options Fixes: #31327
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: use <simplelist> for 'See also' sectionsDavid Tardon2023-12-231-11/+11
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* man: use <simplelist> for file lists in synopsisZbigniew Jędrzejewski-Szmek2023-12-151-8/+10
| | | | | | | | | | | | | | | | | | With <para><filename>…</filename></para>, we get a separate "paragraph" for each line, i.e. entries separated by empty lines. This uses up a lot of space and was only done because docbook makes it hard to insert a newline. In some other places, <literallayout> was used, but then we cannot indent the source text (because the whitespace would end up in the final page). We can get the desired result with <simplelist>. With <simplelist> the items are indented in roff output, but not in html output. In some places this looks better then no indentation, and in others it would probably be better to have no indent. But this is a minor issue and we cannot control that. (I didn't convert all spots. There's a bunch of other man pages which have two lines, e.g. an executable and service file, and it doesn't matter there so much.)
* man: update version informationAbderrahim Kitouni2023-09-191-0/+2
| | | | | | | | As I noticed a lot of missing information when trying to implement checking for missing info. I reimplemented the version information script to be more robust, and here is the result. Follow up to ec07c3c80b2b1bfa6788500202006ff85f5ae4f4
* man: add version infoAbderrahim Kitouni2023-08-291-6/+18
| | | | | | | | This tries to add information about when each option was added. It goes back to version 183. The version info is included from a separate file to allow generating it, which would allow more control on the formatting of the final output.
* man: Add xinclude namespaceAbderrahim Kitouni2023-08-281-1/+2
| | | | | This will be used by the next commit to add version information to the nodes.
* journal: give the ability to enable/disable systemd-journald-audit.socketFranck Bui2023-01-111-1/+3
| | | | | | | | | | Before this patch the only way to prevent journald from reading the audit messages was to mask systemd-journald-audit.socket. However this had main drawback that downstream couldn't ship the socket disabled by default (beside the fact that masking units is not supposed to be the usual way to disable them). Fixes #15777
* man: use unicode superscripts to indicate the exponentZbigniew Jędrzejewski-Szmek2021-12-171-1/+1
|
* man: remove some trailing whitespaceLennart Poettering2021-05-101-2/+2
|
* Document the need to do journalctl --flush for persistent logging (#19481)Luca Adrian L2021-05-031-0/+5
| | | | | Document the need to do journalctl --flush for persistent logging. (fixes #19480) Co-authored-by: Luca Lindhorst <l.lindhorst@wut.de>
* man: link up new journal protocol docsLennart Poettering2021-04-081-3/+4
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-3/+3
|
* man: fix links to various external man pagesZbigniew Jędrzejewski-Szmek2020-06-251-11/+12
| | | | | In cases where we used both die-net and man-pages for the same reference, I switched to use man-pages everywhere.
* man: document journald namespacesLennart Poettering2020-01-311-5/+50
|
* [man] note which UID ranges will get user journalsAnita Zhang2019-12-191-2/+5
| | | | Fixes #13926
* man: don't claim journalctl would still use signalsLennart Poettering2019-11-281-19/+13
| | | | It's using the varlink interface these days.
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* man: fix reference to sd_journal_print(3)Filipe Brandenburger2018-12-071-2/+2
| | | | | | | | The reference in systemd-journald.service(8) was incorrectly pointing to man volume 4 instead of 3. This commit should fix the broken link at https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html
* man: use singular “they”Lucas Werkmeister2018-08-241-2/+2
| | | | | | | | | | | | For an example where we already use it, see man:sd-login(3): > A session is defined by the time a user is logged in until they log out. As far as I can tell, this removes the only remaining occurrences of referring to users by gendered pronouns in our documentation (though some still survive in code comments and the NEWS and TODO files): git grep '\b\(he\|him\|his\|she\|her\|hers\)\b' man/
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* man: mention that oldest journal files are removedZbigniew Jędrzejewski-Szmek2018-03-241-1/+6
| | | | Fixes #7225.
* man: add a note about "archived" journal files and when files can be copiedZbigniew Jędrzejewski-Szmek2018-03-241-6/+15
| | | | | | | | | Issue #6673 requests advice on backup strategy. But the right backup strategy depends on many factors, too many to describe in a man page. So let's just provide some general information which files are mutable and that it is always safe to use/copy files. Closes #6673.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: rework the discussion of Storage= a bitLennart Poettering2017-11-161-11/+13
| | | | | Most distributions default to persistent storage these days, hence don't claim otherwise.
* man: fix typos (#7029)Jakub Wilk2017-10-101-3/+3
|
* journald: make maximum size of stream log lines configurable and bump it to ↵Lennart Poettering2017-09-221-2/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 48K (#6838) This adds a new setting LineMax= to journald.conf, and sets it by default to 48K. When we convert stream-based stdout/stderr logging into record-based log entries, read up to the specified amount of bytes before forcing a line-break. This also makes three related changes: - When a NUL byte is read we'll not recognize this as alternative line break, instead of silently dropping everything after it. (see #4863) - The reason for a line-break is now encoded in the log record, if it wasn't a plain newline. Specifically, we distuingish "nul", "line-max" and "eof", for line breaks due to NUL byte, due to the maximum line length as configured with LineMax= or due to end of stream. This data is stored in the new implicit _LINE_BREAK= field. It's not synthesized for plain \n line breaks. - A randomized 128bit ID is assigned to each log stream. With these three changes in place it's (mostly) possible to reconstruct the original byte streams from log data, as (most) of the context of the conversion from the byte stream to log records is saved now. (So, the only bits we still drop are empty lines. Which might be something to look into in a future change, and which is outside of the scope of this work) Fixes: https://bugs.freedesktop.org/show_bug.cgi?id=86465 See: #4863 Replaces: #4875
* man: add a whole section detailing journal stdout/stderr stream loggingLennart Poettering2017-09-151-6/+48
| | | | | | Details about EPIPE/SIGPIPE handling, metadata and more. Fixes: #6620
* man: remove section about syslog forwardingEvgeny Vereshchagin2015-11-181-7/+0
| | | | | | | | journald: turn ForwardToSyslog= off by default After all, rsyslog and friends nowadays read their data directly from the journal, hence the forwarding is unnecessary in most cases. see 46b131574fdd7d77c15a0919ca9010c
* journalctl: add new --sync switch for syncing the journal to diskLennart Poettering2015-11-111-4/+19
| | | | | | | | | | With this new "--sync" switch we add a synchronous way to sync everything queued to disk, and return only after that's complete. This command gives the guarantee that anything queued before has hit the disk before the command returns. While we are at it, also improve the man pages and help text for journalctl a bit.
* doc: correct orthography, word forms and missing/extraneous wordsJan Engelhardt2015-11-061-1/+1
|
* man: /dev/kmsg is not a socketZbigniew Jędrzejewski-Szmek2015-10-131-1/+1
| | | | Fixup for #1542.
* Merge pull request #1542 from keszybz/journal-audit-optionalLennart Poettering2015-10-131-1/+16
|\ | | | | Make journald audit socket maskable
| * Document journald sockets paths a bit moreZbigniew Jędrzejewski-Szmek2015-10-121-1/+16
| | | | | | | | | | | | Adding them to the documentation makes it easier to find the right man page for people who are trying to understand where some socket in the filesystem is coming from.
* | man: journald: add commands for /var/log/journal creatingEvgeny Vereshchagin2015-09-281-1/+4
|/ | | | See https://github.com/systemd/systemd/issues/1397
* man: typo fixesThomas Hindoe Paaboel Andersen2015-07-251-1/+1
|
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-6/+3
| | | | | | | | | | | | | | | | | | | | | | | This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.
* man: generate configured paths in manpagesFilipe Brandenburger2015-05-281-3/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.
* man: fix a bunch of linksZbigniew Jędrzejewski-Szmek2015-03-141-1/+1
| | | | All hail linkchecker!
* Reindent man pages to 2chZbigniew Jędrzejewski-Szmek2015-02-041-249/+224
|
* man: document audit input for journaldLennart Poettering2014-11-031-9/+27
|
* man: add systemd-coredump(8) and a bunch of linksZbigniew Jędrzejewski-Szmek2014-07-141-0/+1
|
* man: add a mapping for external manpagesZbigniew Jędrzejewski-Szmek2014-07-081-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | It is annoying when we have dead links on fd.o. Add project='man-pages|die-net|archlinux' to <citerefentry>-ies. In generated html, add external links to http://man7.org/linux/man-pages/man, http://linux.die.net/man/, https://www.archlinux.org/. By default, pages in sections 2 and 4 go to man7, since Michael Kerrisk is the autorative source on kernel related stuff. The rest of links goes to linux.die.net, because they have the manpages. Except for the pacman stuff, since it seems to be only available from archlinux.org. Poor gummiboot gets no link, because gummitboot(8) ain't to be found on the net. According to common wisdom, that would mean that it does not exist. But I have seen Kay using it, so I know it does, and deserves to be found. Can somebody be nice and put it up somewhere?