summaryrefslogtreecommitdiffstats
path: root/man/systemd-coredump.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: drop whitespace from final <programlisting> linesZbigniew Jędrzejewski-Szmek2024-11-081-2/+2
| | | | | | In the troff output, this doesn't seem to make any difference. But in the html output, the whitespace is sometimes preserved, creating an additional gap before the following content. Drop it everywhere to avoid this.
* 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-10/+10
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* man: fix typoYu Watanabe2023-11-081-1/+1
| | | | Follow-up for a9d54de66d62b1180aef845fae2eabde4968dda5.
* man: update COREDUMP_xyz journal fields docsLennart Poettering2023-11-081-13/+32
| | | | | | | | | | | | This completes/corrects the documentation for the following fields: COREDUMP_CGROUP= - doc where wrong, actually covered COREDUMP_PROC_CGROUP= COREDUMP_CMDLINE= → undocumented so far COREDUMP_PROC_CGROUP= → docs where there but incorrectly assigned to COREDUMP_CGROUP= COREDUMP_PROC_AUXV= → undocumented so far COREDUMP_SESSION= → undocumented so far Fixes: #29832
* treewide: split commandline into command lineJoerg Behrmann2023-09-201-1/+1
|
* man: add version infoAbderrahim Kitouni2023-08-291-8/+46
| | | | | | | | 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.
* tree-wide: when in doubt use greek small letter mu rather than micro symbolLennart Poettering2023-06-141-1/+1
| | | | | | | | Doesn't really matter since the two unicode symbols are supposedly equivalent, but let's better follow the unicode recommendations to prefer greek small letter mu, as per: https://www.unicode.org/reports/tr25
* man: link up new online coredump docs from man pageLennart Poettering2023-03-301-1/+5
|
* man: restore example formatting in systemd-coredump(8)Zbigniew Jędrzejewski-Szmek2023-01-101-1/+2
| | | | Fixup for 4f57f77267610388139272d9ab9ee64dd78e9720.
* man+docs: adjust links to the new pageZbigniew Jędrzejewski-Szmek2022-01-121-1/+1
|
* tree-wide: fix "the the" and "a a"Yu Watanabe2021-06-301-1/+1
|
* man: fix typoYu Watanabe2021-04-131-1/+1
|
* coredump: rename COREDUMP_PKGMETA_ fields to COREDUMP_PACKAGE_Luca Boccassi2021-04-071-3/+3
| | | | Follow-up for c546154a4448ddf9
* coredump: parse and append package metadata to journal messageLuca Boccassi2021-04-071-0/+14
| | | | | | Append 'package' and 'packageVersion' to the journal as discrete fields COREDUMP_PKGMETA_PACKAGE and COREDUMP_PKGMETA_PACKAGEVERSION respectively, and the full json blurb as COREDUMP_PKGMETA_JSON.
* Merge pull request #18841 from keszybz/a-bunch-of-man-page-updatesLennart Poettering2021-03-021-5/+10
|\ | | | | Two minor small man page updates
| * man: reword sentence about lone coredumpsZbigniew Jędrzejewski-Szmek2021-03-021-3/+2
| | | | | | | | Let's make it clear that they are not as useful as the full thing.
| * man: add note about "SIG" prefixZbigniew Jędrzejewski-Szmek2021-03-021-2/+8
| |
* | tree-wide: fix typoYu Watanabe2021-03-021-1/+1
|/
* man: clarify what is inside/outside the container in coredump infoZbigniew Jędrzejewski-Szmek2021-03-011-5/+36
|
* man: update link to systemd-coredump-pythonZbigniew Jędrzejewski-Szmek2021-03-011-1/+1
| | | | | | This got moved under the systemd umbrella a long time ago. Github redirects from the old path, so the link worked, but it's nicer to use the real location.
* man: describe coredump fieldsZbigniew Jędrzejewski-Szmek2021-03-011-7/+229
| | | | | We save a wealth of information about the process, but this might not be immediately obvious.
* man: make systemd-coredump and coredumpctl descriptions more accessibleZbigniew Jędrzejewski-Szmek2021-02-281-38/+51
| | | | | | | | | | | Fixes #17910: we didn't clearly explain that coredumps may exist without journal entries, and vice versa. Also, make the examples more concrete, and use '$' instead of '#' to avoid suggesting that running as root is required. The text is extended a bit in various places. In the description of systemd-coredump, the details of executor separation are split out to a separate subsection, since they are rather detailed and not necessary to understand for normal use.
* man: clarify that coredumps are gc'd after 3 daysAJ Jordan2021-01-071-2/+4
|
* man: Fix misspelling of directive and typos in systemd-coredump man pagevanou2020-11-231-4/+4
| | | | | | | This commit fixes * misspelling of LimitCORE directive of systemd.exec * typos in systemd-coredump man page.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-2/+2
| | | | | | | 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: drop mode line in file headersZbigniew Jędrzejewski-Szmek2018-07-031-1/+1
| | | | | This is already included in .dir-locals, so we don't need it in the files themselves.
* Merge pull request #9301 from keszybz/man-drop-authorgroupLennart Poettering2018-06-141-9/+0
|\ | | | | man: drop unused <authorgroup> tags from man sources
| * 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
* | Drop my copyright headersZbigniew Jędrzejewski-Szmek2018-06-141-2/+0
|/ | | | | | | perl -i -0pe 's/\s*Copyright © .... Zbigniew Jędrzejewski.*?\n/\n/gms' man/*xml git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/(#\n)?# +Copyright © [0-9, -]+ Zbigniew Jędrzejewski.*?\n//gms' git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/\s*\/\*\*\*\s+Copyright © [0-9, -]+ Zbigniew Jędrzejewski[^\n]*?\s*\*\*\*\/\s*/\n\n/gms' git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/\s+Copyright © [0-9, -]+ Zbigniew Jędrzejewski[^\n]*//gms'
* tree-wide: beautify remaining copyright statementsLennart Poettering2018-06-141-1/+1
| | | | | | Let's unify an beautify our remaining copyright statements, with a unicode ©. This means our copyright statements are now always formatted the same way. Yay.
* 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.
* man: fix ProcessSizeMax= description, describe how to disable coredumpsZbigniew Jędrzejewski-Szmek2018-05-171-0/+10
| | | | | | | | | | | | | | | | | | What the man page said was different than what the code did. save_external_coredump() will store the core temporarily for backtrace generation, and will delete if afterwards if it is too large. So to disable processing, it's necessary to both set Storage=none/Storage=journal+JournalSizeMax=0/Storage=external+ExternalSizeMax=0 and ProcessSizeMax=0. This updates the man page to reflect the code. The man pages are extended to describe that Storage=none + ProcessSizeMax=0 is the simplest way to disable coredump processing. All the storage and processing options make this quite complicated, so let's add a copy-and-pasteable example of how to disable coredump. Doing it through coredump.conf has the advantage that we still log, and the effect is immediate, unlike masking the sysconf file. Fixes #8788.
* 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: "systemd" is to be written in all lower-case, even at beginnings of ↵Lennart Poettering2017-12-131-1/+1
| | | | | | sentences This very important commit is very important.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: fix links to external man pagesZbigniew Jędrzejewski-Szmek2017-05-071-1/+1
| | | | linkchecker ftw!
* man: use https:// in URLsAsciiWolf2017-02-211-1/+1
|
* man: describe systemd-coredump --backtraceZbigniew Jędrzejewski-Szmek2017-02-151-13/+34
|
* man: typo fixesThomas Hindoe Paaboel Andersen2016-10-121-1/+1
| | | | A mix of fixes for typos and UK english
* coredump: Improve man pagesPeter Mattern2016-05-181-40/+58
|
* man: also mention systemd-coredump@.service and systemd-coredump.socketZbigniew Jędrzejewski-Szmek2016-04-061-0/+11
| | | | Added in 3c171f0b1e.
* man: describe how to reload sysctl configurationZbigniew Jędrzejewski-Szmek2016-04-021-0/+9
| | | | Also fixes option name (s/--path/--prefix/).
* man: add more cross-references to coredump.conf(5) and systemd-coredump(8)Zbigniew Jędrzejewski-Szmek2016-04-021-16/+18
| | | | Fixes #2901.
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-1/+1
|
* man: typo fixesThomas Hindoe Paaboel Andersen2015-07-251-2/+2
|
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-5/+2
| | | | | | | | | | | | | | | | | | | | | | | 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-2/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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.