summaryrefslogtreecommitdiff
path: root/man/kernel-command-line.xml
Commit message (Collapse)AuthorAgeFilesLines
* documentation: add description for watchdog device pathEdward A. James2017-12-081-0/+9
| | | | | Document the command line parameter and the system configuration file setting.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* Mention mount.usr* in kernel-command-line man page (#6743)Tobias Hunger2017-09-051-0/+12
|
* man: fix URL for kernel-parameters docZbigniew Jędrzejewski-Szmek2017-05-051-2/+2
| | | | | With the move to sphinx-generated docs, the old URL seems to have stopped working and returns 404.
* man: update descriptions of argument-less kernel cmdline argsZbigniew Jędrzejewski-Szmek2017-02-221-7/+7
| | | | | | | | | | | This updates the man page for the changes introduced in 1d84ad944520fc3e062ef518c4db4e1d3a1866af. "=" is kep if the option is predominantly used with an argument, and dropped otherwise. v2: - update also description of log_color - drop '=' in all cases where it is optional (previous rule of dropping it only in some cases was just too arbitrary.)
* man: describe the cgroup hierarchy kernel commandline optionsZbigniew Jędrzejewski-Szmek2017-02-221-0/+2
| | | | | | | Fixes #4827. v2: - update for the inverted interpration of systemd.legacy_systemd_cgroup_controller
* verity: add support for setting up verity-protected root disks in the initrdLennart Poettering2016-12-211-0/+14
| | | | | | | | | This adds a generator and a small service that will look for "roothash=" on the kernel command line and use it for setting up a very partition for the root device. This provides similar functionality to nspawn's existing --roothash= switch.
* fstab-generator: add support for volatile bootsLennart Poettering2016-12-211-0/+23
| | | | | | | | | | | | | | | | | | | | This adds support for a new kernel command line option "systemd.volatile=" that provides the same functionality that systemd-nspawn's --volatile= switch provides, but for host systems (i.e. systems booting with a kernel). It takes the same parameter and has the same effect. In order to implement systemd.volatile=yes a new service systemd-volatile-root.service is introduced that only runs in the initrd and rearranges the root directory as needed to become a tmpfs instance. Note that systemd.volatile=state is implemented different: it simply generates a var.mount unit file that is part of the normal boot and has no effect on the initrd execution. The way this is implemented ensures that other explicit configuration for /var can always override the effect of these options. Specifically, the var.mount unit is generated in the "late" generator directory, so that it only is in effect if nothing else overrides it.
* util-lib: various improvements to kernel command line parsingLennart Poettering2016-12-211-11/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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!
* firstboot: add kernel cmdline option to disable firstboot wizardLennart Poettering2016-12-201-1/+11
| | | | If booting with systemd.firstboot=0 the wizard will be skipped.
* man: move description of kernel vconsole.conf overrides to vconsole.conf(5)Zbigniew Jędrzejewski-Szmek2016-07-311-6/+5
| | | | | | They were outdated, and this way it's less likely that they'll get out of sync again. Anyway, it's easier for the reader to have the kernel and config file options next to one another.
* core: parse `rd.rescue` and `rd.emergency` as initrd-specific shorthands (#3488)Ivan Shapovalov2016-06-131-1/+3
| | | Typing `rd.rescue` is easier than `rd.systemd.unit=rescue.target`.
* core: set start job timeout from the kernel commandline (#3112)tblume2016-04-261-0/+9
| | | | Add the boot parameter: systemd.default_timeout_start_sec to allow modification of the default start job timeout at boot time.
* core: Add machine-id settingNils Carlson2016-01-121-0/+1
| | | | | | | | | | Allow for overriding all other machine-ids which may be present on the system using a kernel command line systemd.machine_id or --machine-id= option. This is especially useful for network booted systems where the machine-id needs to be static, or for containers where a specific machine-id is wanted.
* Fixed kernel-command-line linkskayrus2015-11-061-4/+4
|
* core: rework crash handlingLennart Poettering2015-09-291-1/+2
| | | | | | | | | | | | | | | | | | | This introduces a new systemd.crash_reboot=1 kernel command line option that triggers a reboot after crashing. This also cleans up crash VT handling. Specifically, it cleans up the configuration setting, to be between 1..63 or a boolean. This is to replace the previous logic where "-1" meant disabled. We continue to accept that setting, but only document the boolean syntax instead. This also brings the documentation of the default settings in sync with what actually happens. The CrashChVT= configuration file setting is renamed to CrashChangeVT=, following our usual logic of not abbreviating unnecessarily. The old setting stays support for compat reasons. Fixes #1300
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-4/+1
| | | | | | | | | | | | | | | | | | | | | | | 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-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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: remove 'fs' from 'rootfsflags'Zbigniew Jędrzejewski-Szmek2015-04-081-1/+1
| | | | rootfsflags does not appear anywhere else.
* man: fix a bunch of linksZbigniew Jędrzejewski-Szmek2015-03-131-1/+1
| | | | All hail linkchecker!
* Reindent man pages to 2chZbigniew Jędrzejewski-Szmek2015-02-031-371/+345
|
* cryptsetup-generator: Add support for naming luks devices on kernel cmdlineJan Janssen2014-12-051-0/+2
|
* man: make udev.event-timeout more visibleZbigniew Jędrzejewski-Szmek2014-10-231-0/+2
| | | | Evidently some people had trouble finding it in the documentation.
* man: document the new "rescue" kernel command line optionLennart Poettering2014-10-091-0/+1
|
* Fix a few more typosRuben Kerkhof2014-08-301-1/+1
|
* hibernate-resume-generator: add a generator for instantiating the resume unit.Ivan Shapovalov2014-08-261-1/+13
| | | | | | | | | | | | | hibernate-resume-generator understands resume= kernel command line parameter and instantiates the systemd-resume@.service accordingly if it is passed. This enables resume from hibernation using device specified on the kernel command line, and it may be specified either as "/dev/disk/by-foo/bar" or "FOO=bar", not only "/dev/sdXY" which is understood by the in-kernel implementation. So now resume= is brought on par with root= in terms of possible ways to specify a device.
* man: add a mapping for external manpagesZbigniew Jędrzejewski-Szmek2014-07-071-6/+6
| | | | | | | | | | | | | | | | | | | | | | | | 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?
* debug-generator: add new kernel cmdline option systemd.wants= to add units ↵Lennart Poettering2014-06-201-3/+4
| | | | to the initial transaction
* man: add new kernel command line switches to kernel-command-line(7)Lennart Poettering2014-06-191-13/+50
|
* fsck: Allow to specify the fsck repair option in the cmdlineHolger Hans Peter Freyther2014-05-161-0/+11
| | | | | | | | | | Some unattended systems do not have a console attached and entering the default rescue mode will not be too helpful. Allow to specify the "-y" option to attempt to fix all filesystem errors. Manually verified by downloading an image.gz of e2fsprogs, using losetup and running systemd-fsck on the loop device and varying the fsck.repair=preen|yes|no option.
* journald: add support for wall forwardingSebastian Thorarensen2014-03-141-0/+1
| | | | | | | | | | | | | | This will let journald forward logs as messages sent to all logged in users (like wall). Two options are added: * ForwardToWall (default yes) * MaxLevelWall (default emerg) 'ForwardToWall' is overridable by kernel command line option 'systemd.journald.forward_to_wall'. This is used to emulate the traditional syslogd behaviour of sending emergency messages to all logged in users.
* man: wording and grammar updatesJan Engelhardt2013-10-211-1/+1
| | | | | This is a recurring submission and includes corrections to various issue spotted.
* kerne-command-line: introduce option 'systemd.restore_state'Tom Gundersen2013-10-191-0/+17
| | | | | | | | When set to 0 this will stop tools like the backlight and rfkill tools to restore state from previous boot. This is useful in case the stored state is bogus to the extent that it is preventing you from resetting it (e.g., the backlight settings cause the screen to be off on boot on a system where the backlight can not be adjusted directly from the keyboard).
* man: document the -b special boot optionJan Engelhardt2013-10-151-0/+1
|
* man: document luks.options kernel commandlineTom Gundersen2013-09-131-0/+2
| | | | This should have been part of commit 7ab064a6d
* man: more grammar improvementsJan Engelhardt2013-07-031-15/+15
| | | | | | - place commas - expand contractions (this is written prose :) - add some missing words
* core: read "debug" from kernel commandline and set log levelLukas Nykryn2013-05-301-0/+12
|
* man: mention net.ifnames in kernel-command-line(3)Zbigniew Jędrzejewski-Szmek2013-05-221-0/+1
|
* cryptsetup-generator: add support for rd.luks.key=Harald Hoyer2013-04-181-0/+2
| | | | | | Also clarify rd.luks.uuid and luks.uuid in the manual. https://bugzilla.redhat.com/show_bug.cgi?id=905683
* man: extend systemd.directives(7) to all manual pagesZbigniew Jędrzejewski-Szmek2013-01-261-1/+1
| | | | | | | | | | 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: fix some spelling mistakesRamkumar Ramachandra2012-11-301-1/+1
|
* man: fix a bunch of typos in docsThomas Hindoe Paaboel Andersen2012-09-131-1/+1
| | | | https://bugs.freedesktop.org/show_bug.cgi?id=54501
* man: typoShawn Landden2012-07-221-1/+1
|
* man: reword man page titlesLennart Poettering2012-07-161-1/+1
| | | | | Make sure the man page titles are similar in style and capitalization so that our man page index looks pretty.
* man: update man pages to reflect the driver= to load-modules= renameLennart Poettering2012-07-041-2/+2
|
* man: document systemd-fsckLennart Poettering2012-06-271-2/+2
|
* units: rename fsck@.service to systemd-fsck@.serviceLennart Poettering2012-06-251-4/+4
| | | | | | | | | | | The rule is that units that encapsulate our own code are prefixed with "systemd-". Since the fsck units invoke our own code, hence add the missing prefix. Since a long long time the fsck units didn't invoke the naked fsck binaries anymore, and it is unlikely that this well ever change. On the opposite: the code in systemd-fsck will probably get more complex over time to handle fsck progress to plymouth forwarding. Same for quotacheck (but not quotaon!)
* man: add more references to k-c-l(7)Lennart Poettering2012-06-221-1/+4
|
* man: fix references to udev man pageLennart Poettering2012-06-221-2/+2
|
* man: add reference to bootparam(7) even though it is terribly out of dateLennart Poettering2012-06-221-2/+3
|