summaryrefslogtreecommitdiff
path: root/man/journald.conf.xml
Commit message (Collapse)AuthorAgeFilesLines
* journal: give the ability to enable/disable systemd-journald-audit.socketFranck Bui2023-01-111-6/+11
| | | | | | | | | | 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: Mention that journal file size is capped to 4G in compact modeDaan De Meyer2022-10-251-15/+10
|
* man: document that setting Storage= in namespaces journald menas ↵Lennart Poettering2022-09-261-0/+8
| | | | | | LogDirectory= in unit file needs setting too Replaces: #24789
* 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>
* journal: make namespace invocation also support drop-in configYu Watanabe2021-03-051-2/+6
|
* man: set constant tag to NUL or NULLYu Watanabe2020-11-121-1/+1
|
* 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-1/+1
|
* man: describe that changing Storage= does not move existing dataZbigniew Jędrzejewski-Szmek2020-08-031-6/+12
| | | | Fixes #16384.
* man: fix some manvolnumAnita Zhang2020-07-111-1/+1
|
* tree-wide: drop quotes from around [section]Zbigniew Jędrzejewski-Szmek2020-07-061-1/+1
| | | | | | | For users, the square brackets already serve as markup and clearly delineate the section name from surrounding text. Putting additional markup around that only adds clutter. Also, we were very inconsistent in using the quotes. Let's just drop them altogether.
* man: Fix typo "multiplied with" -> "multiplied by"Niklas Hambüchen2020-04-231-1/+1
|
* journald: add configuration option for enabling/disabling audit during ↵Lennart Poettering2020-04-171-0/+12
| | | | | | | | | | | | | journald startup Let's make it optional whether auditing is enabled at journald start-up or not. Note that this only controls whether audit is enabled/disabled in the kernel. Either way we'll still collect the audit data if it is generated, i.e. if some other tool enables it, we'll collect it. Fixes: #959
* tree-wide: drop printk.devkmsg=on setting in various placesZbigniew Jędrzejewski-Szmek2020-03-031-3/+3
| | | | Since 6123dfaa72 this should not be necessary anymore.
* man: document journald@NAMESPACE.confLennart Poettering2020-01-311-26/+24
|
* Clarify journald.conf MaxLevelStore documentationLuca Boccassi2020-01-161-3/+3
| | | | | | | 'stored on disk' gives the impression that this option affects only permanent storage, even though it affects everything the journal records, regardless of the storage type. Use 'stored in the journal' to avoid confusion.
* [man] note which UID ranges will get user journalsAnita Zhang2019-12-181-2/+5
| | | | Fixes #13926
* man: document journal rate limit burst multiplierCharles (Chas) Williams2019-12-041-0/+45
| | | | | | The actual burst limit is modified by the remaining disk space. This isn't mentioned anywhere in the available documentation and might be a source of surprise for an end user expecting certain behaviors.
* man: document the kernel command line options to use when logging to kmsgLennart Poettering2019-07-291-13/+17
| | | | | | Prompted by: https://lists.freedesktop.org/archives/systemd-devel/2019-July/043149.html
* 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: move all config file options to one sectionZbigniew Jędrzejewski-Szmek2019-02-131-1/+1
| | | | | | We had "SYSTEM MANAGER DIRECTIVES" which was a misnomer already, because it also listed user manager stuff. Let's make this a more general section and move the items for other services there too (from "MISCELANENOUS").
* Replace 'older then' with 'older than'Jani Uusitalo2018-12-281-1/+1
|
* core: implement per unit journal rate limitingAnita Zhang2018-10-181-1/+7
| | | | | | | | | Add LogRateLimitIntervalSec= and LogRateLimitBurst= options for services. If provided, these values get passed to the journald client context, and those values are used in the rate limiting function in the journal over the the journald.conf values. Part of #10230
* man: SystemMaxUse= clarification in journald.conf(5)Michal Koutný2018-06-251-1/+5
| | | | | | Similar semantics applies to {System,Runtime}MaxUse= as to {System,Runtime}MaxFiles=, i.e. active files aren't vacuumed and the limit is not thus strictly honored.
* 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 spurious newlines (#8764)Lennart Poettering2018-04-191-1/+0
| | | | | | | | Double newlines (i.e. one empty lines) are great to structure code. But let's avoid triple newlines (i.e. two empty lines), quadruple newlines, quintuple newlines, …, that's just spurious whitespace. It's an easy way to drop 121 lines of code, and keeps the coding style of our sources a bit tigther.
* man: add a new page with a general description of common syntaxZbigniew Jędrzejewski-Szmek2018-04-181-3/+5
| | | | | | | | We have a common parser, but for the user it might be completely unobvious that the same general rules apply to all those files. Let's add a page about the basic syntax so that the more specific pages don't have to repeat those details.
* 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.
* journald: bump rate limits (#8660)David Tardon2018-04-051-1/+1
| | | | Apparently, it is quite common to hit a problem, where systemd-journald would drop messages because service is logging too fast.
* journal: make the compression threshold tunableAlex Gartrell2018-03-201-4/+7
| | | | | Allow a user to set a number of bytes as Compress to use as the compression threshold.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: fix typos (#7029)Jakub Wilk2017-10-101-1/+1
|
* journald: make maximum size of stream log lines configurable and bump it to ↵Lennart Poettering2017-09-221-0/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* journald: make reading /dev/kmsg optional (#6362)Susant Sahani2017-07-151-0/+8
| | | Closes #6022
* man: use unicode ellipsis in more placesZbigniew Jędrzejewski-Szmek2016-12-111-1/+1
| | | | | | | | | | | | | | As requested in https://github.com/systemd/systemd/pull/4864#pullrequestreview-12372557. docbook will substitute triple dots for the ellipsis in man output, so this has no effect on the troff output, only on HTML, making it infinitesimally nicer. In some places we show output from programs, which use dots, and those places should not be changed. In some tables, the alignment would change if dots were changed to the ellipsis which is only one character. Since docbook replaces the ellipsis automatically, we should leave those be. This patch changes all other places.
* journald: convert journald to use parse_proc_cmdlineZbigniew Jędrzejewski-Szmek2016-10-221-16/+15
| | | | | | | | This makes journald use the common option parsing functionality. One behavioural change is implemented: "systemd.journald.forward_to_syslog" is now equivalent to "systemd.journald.forward_to_syslog=1". I think it's nicer to use this way.
* journald: systemd.journald.max_level_* kernel command line options (#4427)Umut Tezduyar Lindskog2016-10-211-1/+8
| | | The log forward levels can be configured through kernel command line.
* journald: deprecate SplitMode=login (#3805)Zbigniew Jędrzejewski-Szmek2016-07-261-17/+9
| | | | | | | | | | In this mode, messages from processes which are not part of the session land in the main journal file, and only output of processes which are properly part of the session land in the user's journal. This is confusing, in particular because systemd-coredump runs outside of the login session. "Deprecate" SplitMode=login by removing it from documentation, to discourage people from using it.
* man: extend documentation on the SplitMode= setting (#3801)Lennart Poettering2016-07-251-15/+16
| | | Adressing https://github.com/systemd/systemd/issues/3755#issuecomment-234214273
* core: rename StartLimitInterval= to StartLimitIntervalSec=Lennart Poettering2016-04-291-3/+3
| | | | | | | | | We generally follow the rule that for time settings we suffix the setting name with "Sec" to indicate the default unit if none is specified. The only exception was the rate limiting interval settings. Fix this, and keep the old names for compatibility. Do the same for journald's RateLimitInterval= setting
* doc: correct orthography, word forms and missing/extraneous wordsJan Engelhardt2015-11-061-7/+7
|
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-3/+3
|
* man: document that the automatic journal limits are capped to 4G by defaultLennart Poettering2015-10-031-2/+3
| | | | Fixes #1441.
* journal: rework vacuuming logicLennart Poettering2015-10-021-6/+17
| | | | | | | | | | | | | | | Implement a maximum limit on number of journal files to keep around. Enforcing a limit is useful on this since our performance when viewing pays a heavy penalty for each journal file to interleve. This setting is turned on now by default, and set to 100. Also, actully implement what 348ced909724a1331b85d57aede80a102a00e428 promised: use whatever we find on disk at startup as lower bound on how much disk space we can use. That commit introduced some provisions to implement this, but actually never did. This also adds "journalctl --vacuum-files=" to vacuum files on disk by their number explicitly.
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-7/+4
| | | | | | | | | | | | | | | | | | | | | | | 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.
* doc: improve readability in journald.conf.5Jan Synacek2015-06-171-6/+7
|