summaryrefslogtreecommitdiff
path: root/man/systemd-udevd.service.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: split out a paragraph and shorten the text about sd-network-generatorZbigniew Jędrzejewski-Szmek2021-12-161-7/+8
| | | | | | The ordering of the service wrt. to udevd is enforced by unit configuration, so no need to tell the user about this. From users' POV, the only thing that counts is that the unit is enabled and then the right thing happens.
* network-generator: support to set NamePolicy= through kernel command line ↵Yu Watanabe2021-12-161-0/+39
| | | | | | argument Closes #16296.
* man: fix discriptions for --exec-delaygaoyi2021-04-121-3/+3
| | | | | | There are two ambiguity in the original description: 1. It will delay all RUN instructions, include builtin. 2. It will delay before running RUN, not each of RUN{program} instructions.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* udev: rename kernel option 'log_priority' into 'log_level'Franck Bui2020-09-221-2/+2
| | | | | | Let's be consistent with the rest of the project. 'log_priority' is still supported for backward compatibility.
* tree-wide: spellcheck fixesFrantisek Sumsal2020-06-261-1/+1
| | | | Most of them were reported by Fossies.org
* man: single-char parameters take no '='Lennart Poettering2020-06-081-4/+4
| | | | The suggested syntax is simply not valid and results in an error.
* udev: optionally mark all block devices read-only as they pop upLennart Poettering2020-06-081-2/+18
|
* udev: make signal that we use to kill workers on timeout configurableMichal Sekletár2020-06-051-0/+24
|
* man: describe naming schemes in a new man pageZbigniew Jędrzejewski-Szmek2019-05-101-12/+8
| | | | | | | | | | I decided to make this a separate man page because it is freakin' long. This content could equally well go in systemd-udevd.service(8), systemd.link(5), or a new man page for the net_id builtin. v2: - rename to systemd.net-naming-scheme - add udevadm test-builtin net_id example
* 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
* meson: make net.naming-scheme= default configurableZbigniew Jędrzejewski-Szmek2018-12-121-10/+14
| | | | | | | | | | | | | | | | This is useful for distributions, where the stability of interface names should be preseved after an upgrade of systemd. So when some specific release of the distro is made available, systemd defaults to the latest & greatest naming scheme, and subsequent updates set the same default. This default may still be overriden through the kernel and env var options. A special value "latest" is also allowed. Without a specific name, it is harder to verride from meson. In case of 'combo' options, meson reads the default during the initial configuration, and "remembers" this choice. When systemd is updated, old build/ directories could keep the old default, which would be annoying. Hence, "latest" is introduced to make it explicit, yet follow the upstream. This is actually useful for the user too, because it may be used as an override, without having to actually specify a version.
* udev: introduce udev net_id "naming schemes"Lennart Poettering2018-12-111-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | With this we can stabilize how naming works for network interfaces. A user can request through a kernel cmdline option or an env var which scheme to follow. The idea is that installers use this to set into stone (a very soft stone though) the scheme used during installation so that interface naming doesn't change afterwards anymore. Why use env vars and kernel cmdline options, and not a config file of its own? Well, first of all there's no obvious existing one to use. But more importantly: I have the feeling that this logic is kind of an incomplete hack, and I simply don't want to do advertise this as a perfectly working solution. So far we used env vars for the non-so-official options and proper config files for the official stuff. Given how incomplete this logic is (i.e. the big variable for naming remains the kernel, which might expose sysfs attributes in newer versions that we check for and didn't exist in older versions — and other problems like this), I am simply not confident in giving this first-class exposure in a primary configuration file. Fixes: #10448
* 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.
* tree-wide: drop copyright headers from frequent contributorsZbigniew Jędrzejewski-Szmek2018-06-201-2/+0
| | | | | | | | Fixes #9320. for p in Shapovalov Chevalier Rozhkov Sievers Mack Herrmann Schmidt Rudenberg Sahani Landden Andersen Watanabe; do git grep -e 'Copyright.*'$p -l|xargs perl -i -0pe 's|/([*][*])?[*]\s+([*#]\s+)?Copyright[^\n]*'$p'[^\n]*\s*[*]([*][*])?/\n*|\n|gms; s|\s+([*#]\s+)?Copyright[^\n]*'$p'[^\n]*\n*|\n|gms' done
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-8/+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: 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.
* 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: lists short options in systemd-udevd.service(8)Yu Watanabe2017-12-041-5/+7
| | | | Follow-up for 2d19c17e8eafbe6c460c3cd76cf65aecd80ead87.
* Add missing headers and SPDX identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+21
|
* util-lib: various improvements to kernel command line parsingLennart Poettering2016-12-211-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This improves kernel command line parsing in a number of ways: a) An kernel option "foo_bar=xyz" is now considered equivalent to "foo-bar-xyz", i.e. when comparing kernel command line option names "-" and "_" are now considered equivalent (this only applies to the option names though, not the option values!). Most of our kernel options used "-" as word separator in kernel command line options so far, but some used "_". With this change, which was a source of confusion for users (well, at least of one user: myself, I just couldn't remember that it's systemd.debug-shell, not systemd.debug_shell). Considering both as equivalent is inspired how modern kernel module loading normalizes all kernel module names to use underscores now too. b) All options previously using a dash for separating words in kernel command line options now use an underscore instead, in all documentation and in code. Since a) has been implemented this should not create any compatibility problems, but normalizes our documentation and our code. c) All kernel command line options which take booleans (or are boolean-like) have been reworked so that "foobar" (without argument) is now equivalent to "foobar=1" (but not "foobar=0"), thus normalizing the handling of our boolean arguments. Specifically this means systemd.debug-shell and systemd_debug_shell=1 are now entirely equivalent. d) All kernel command line options which take an argument, and where no argument is specified will now result in a log message. e.g. passing just "systemd.unit" will no result in a complain that it needs an argument. This is implemented in the proc_cmdline_missing_value() function. e) There's now a call proc_cmdline_get_bool() similar to proc_cmdline_get_key() that parses booleans (following the logic explained in c). f) The proc_cmdline_parse() call's boolean argument has been replaced by a new flags argument that takes a common set of bits with proc_cmdline_get_key(). g) All kernel command line APIs now begin with the same "proc_cmdline_" prefix. h) There are now tests for much of this. Yay!
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-1/+1
|
* 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: udevd - correct default event timeoutTom Gundersen2015-06-101-1/+1
| | | | This was changed from 30 to 180 seconds quite some time ago.
* 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.
* man: boilerplate unificationZbigniew Jędrzejewski-Szmek2015-02-101-1/+0
|
* man: add emacs header to get correct indention in nxml-mode for the manpage ↵Lennart Poettering2014-11-211-1/+1
| | | | | | | | XML files that use 2ch indenting In the long run we really should figure out if we want to stick with 8ch or 2ch indenting, and not continue with half-and-half. For now, just make emacs aware of the files that use 2ch indenting.
* udev: switch to systemd logging functionsKay Sievers2014-11-131-11/+0
|
* s/command-line/command line/gLennart Poettering2014-11-061-2/+2
| | | | | | | | | | A follow-up to: commit 3f85ef0f05ffc51e19f86fb83a1c51e8e3cd6817 Author: Harald Hoyer <harald@redhat.com> Date: Thu Nov 6 15:33:48 2014 +0100 s/commandline/command line/g
* Use log "level" instead of "priority"Zbigniew Jędrzejewski-Szmek2014-11-011-2/+2
| | | | | | | | | | | | The term "priority" is misleading because higher levels have lower priority. "Level" is clearer and shorter. This commit touches only the textual descriptions, not function and variable names themselves. "Priority" is used in various command-line switches and protocol constants, so completly getting rid of "priority" is hard. I also left "priority" in various places where the clarity suffered when it was removed.
* man: make udev.event-timeout more visibleZbigniew Jędrzejewski-Szmek2014-10-231-4/+5
| | | | Evidently some people had trouble finding it in the documentation.
* man: add udev.conf(5)Zbigniew Jędrzejewski-Szmek2014-07-311-29/+15
| | | | | | | We generally have separate man pages for all configuration files. In this case udev.conf was already described in systemd-udevd.service(8), but it was hard to find. Docbook makes it hard to add a .so link from a different section, so describe udev.conf in its own page.
* udev: unify event timeout handlingKay Sievers2014-07-291-4/+3
|
* udevd: add --event-timeout commandline optionHannes Reinecke2014-07-291-0/+19
| | | | | | | Some events take longer than the default 30 seconds. Killing those events will leave the machine halfway configured. Add a commandline option '--event-timeout' to handle these cases.
* man: xinclude --help/--version/--no-pagerZbigniew Jędrzejewski-Szmek2014-02-201-10/+11
|
* doc: utilize the DocBook markup for some literalsJan Engelhardt2014-02-171-1/+1
|
* doc: resolve missing/extraneous words or inappropriate formsJan Engelhardt2014-02-171-2/+2
| | | | | | | | Issues fixed: * missing words required by grammar * duplicated or extraneous words * inappropriate forms (e.g. singular/plural), and declinations * orthographic misspellings
* doc: update punctuationJan Engelhardt2014-02-171-3/+3
| | | | Resolve spotted issues related to missing or extraneous commas, dashes.
* man: replace STDOUT with standard output, etc.Zbigniew Jędrzejewski-Szmek2014-02-141-5/+6
| | | | | | | | | Actually 'STDOUT' is something that doesn't appear anywhere: in the stdlib we have 'stdin', and there's only the constant STDOUT_FILENO, so there's no reason to use capitals. When refering to code, STDOUT/STDOUT/STDERR are replaced with stdin/stdout/stderr, and in other places they are replaced with normal phrases like standard output, etc.
* man: fix grammatical errors and other formatting issuesJason St. John2014-02-141-3/+2
| | | | | | | * standardize capitalization of STDIN, STDOUT, and STDERR * reword some sentences for clarity * reflow some very long lines to be shorter than ~80 characters * add some missing <literal>, <constant>, <varname>, <option>, and <filename> tags
* man: mention net.ifnames in kernel-command-line(3)Zbigniew Jędrzejewski-Szmek2013-05-221-0/+2
|
* udev: rename kernel command line option to net.ifnames=Kay Sievers2013-03-181-4/+3
|
* udev: net-name-slot - disable by kernel command line switchTom Gundersen2013-03-181-0/+8
| | | | | | The properties will still be set in the udev database, but they will not be used for setting the interface names. As for the other kernel commandline switches, we allow it to be prefixed by 'rd.' to only apply in the initrd.
* man: udev - move documentation of configuration fileTom Gundersen2013-03-181-0/+17
| | | | | Moved from udev(7) to systemd-udevd.service(8), where the rest of the documentation of the configuration of the daemon lives.
* man: extend systemd.directives(7) to all manual pagesZbigniew Jędrzejewski-Szmek2013-01-261-2/+2
| | | | | | | | | | New sections are added: PAM options, crypttab options, commandline options, miscellaneous. The last category will be used for all untagged <varname> elements. Commandline options sections is meant to be a developer tool: when adding an option it is sometimes useful to be able to check if similarly named options exist elsewhere.
* man: docbook consitency fixesZbigniew Jędrzejewski-Szmek2013-01-261-1/+1
| | | | | Use proper (or at least more proper) docbook tags for various fields. This should help with automatic parsing of the documentation.
* man: typo fixesThomas Hindoe Paaboel Andersen2012-10-261-2/+2
| | | | | | | | | https://bugs.freedesktop.org/show_bug.cgi?id=55890 Fixed typos, serial comma, and removed "either" as there were more than two options. Also did an extra rename of "system-shutdown" to "systemd-shutdown" that was forgotten in commit 8bd3b8620c80d0f2383f2fb04315411fc8077ca1
* Revert "man: ship systemd-udevd as the real manpage"Lennart Poettering2012-07-291-0/+168
| | | | | | | | | We want to keep things uniform, and hence treat udevd's man page like any other in the repo. What matters is how users primarily interface with a service, and that is not the binary path in /usr/lib/systemd but the service name. This reverts commit 6c1f3ba54ac1f42598c543b86daaf294b29294b1.