summaryrefslogtreecommitdiffstats
path: root/sys-utils/swapon.8
Commit message (Collapse)AuthorAgeFilesLines
* swapon.8: mention btrfs(5)Marcos Mello2019-03-111-15/+14Star
| | | | | | See: https://github.com/kdave/btrfs-progs/commit/5c880c82c2044b0abae5c838c733a2e6522ed122
* swapon: be more explicit about BTRFSKarel Zak2019-01-221-3/+4
| | | | | | | | It seems nocow and nodatasum attributes are required. See btrfs_swap_activate() in https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=ed46ff3d423780fa5173b38a844bf0fdb210a2a7 Addresses: https://github.com/karelzak/util-linux/issues/633 Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: rewrite section about swapfilesKarel Zak2019-01-221-24/+21Star
| | | | | | | | | | | | * don't duplicate info on two places -- let's keep only small note in mkswap(8) man page, suggest to read swapon(8) man page * add info about kernel versions for XFS and Btrfs swapfiles support * use subsection in the NOTES Addresses: https://github.com/karelzak/util-linux/issues/633 Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: (man) cleanup note about holesKarel Zak2019-01-211-11/+9Star
| | | | | Addresses: https://github.com/karelzak/util-linux/issues/633 Signed-off-by: Karel Zak <kzak@redhat.com>
* Fix man page typosJakub Wilk2018-08-161-1/+1
| | | | Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
* man: Use the correct macro for a font change of one argumentBjarni Ingi Gislason2018-05-231-3/+3
| | | | | | | | Use the correct macro (I, B) for the font change of one argument, not those that are used for alternating two fonts, like "BR", "IR", "RB", or "RI". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
* swapon: add --output-all optionSami Kerola2018-05-031-0/+3
| | | | Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: remove some old history from manpagesRuediger Meier2017-06-291-1/+1
| | | | | | | | We assume that users will have a kernel >= 2.6.0 and removel references to earlier kernels. There are still a few ones left. Signed-off-by: Ruediger Meier <ruediger.meier@ga-group.nl>
* docs: replace FTP by HTTPS in kernel.org URLsSébastien Helleu2016-12-191-1/+1
| | | | | | | The links to ftp://ftp.kernel.org/ are replaced by https://www.kernel.org/. Signed-off-by: Karel Zak <kzak@redhat.com>
* Place SEE ALSO entries in orderMichael Kerrisk (man-pages)2016-11-291-3/+3
| | | | | | | | | | | | This patch does only the following: * Order SEE ALSO entries first by section name, then alphabetically within section * Adds one or two missing commas in SEE ALSO lists * Removes one or two periods that were (inconsistently) used at the end of SEE ALSO lists. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* docs: Fix various typosSebastian Rasmussen2016-05-311-1/+1
| | | | Signed-off-by: Sebastian Rasmussen <sebras@gmail.com>
* swapon: rewrite control struct usageKarel Zak2016-03-181-1/+1
| | | | | | | | | | | | | | | | | | | | | | | The old version has been pretty broken... the most important is to keep swap options specified on command line as read-only template. For example if we call "swapon --all" then we cannot modify the global options for each fstab swap entry. The another story has been control struct modification due to device reinitialization etc. This patch splits all to: * struct swapon_control; top-level struct with command line options * struct swap_device; this is device specific and never globally maintained by swapon_control. * struct swap_prop; used as global read-only template swap options and per device swap options (when parse fstab). Addresses: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=818252 Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: fix discard=pages docsRichard Yao2016-03-141-1/+1
| | | | | | | | | | | | | | | | | | | | | | | The documentation for discard=pages is ambiguous in that it could be interpreted to mean either that the pages are discarded immediately after being freed or that the pages are discarded immediately before being reused by a write. Both implementations would satisfy the statement "discard freed swap pages before they are avaliable for reuse", but the kernel does the former. Doing a discard operation (which is non-queued on SATA drives before SATA 3.1) before a write operation to the same sector is pointless unless using, pre-SATA 3.1 drives, where discard is detrimental because ATA TRIM is a non-queued command. Anyone who wants discard operations on swap and interprets the man page as describing the incorrect behavior would opt for discard=once over discard, when discard provides the behavior of both discard=once and discard=pages, which is what they likely want. Lets make a small change to the documentation to clarify the behavior. Signed-off-by: Richard Yao <ryao@gentoo.org>
* swapon: search for mkswap via PATHMike Frysinger2015-04-271-1/+1
| | | | | | | | Rather than hardcode /sbin/mkswap all the time, use a normal PATH search. This matches the normal behavior of other tools, and makes local testing easier. Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* docs: remove obsolete and unneeded comments from man-page filesBenno Schulenberg2015-01-121-7/+0Star
| | | | | | | Transform some of them into copyright lines. Also fix three header lines and snip some trailing whitespace. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* docs: fix some wording, grammar and formatting in man page of swaponBenno Schulenberg2014-11-071-13/+13
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* docs: update info about env debug variablesKarel Zak2014-11-031-0/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: improve man page notes about holesKarel Zak2014-11-031-16/+32
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: fix some wording and formatting in man page of swaponBenno Schulenberg2014-10-311-8/+9
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* swapon: add -o <list> for compatibility with mountKarel Zak2014-10-201-4/+14
| | | | | | | | | | | | | The new option allows to specify swap options by fstab compatible string. The concept is the same as for mount(8). swapon -o pri=1,discard=pages,nofail /dev/sda2 The advantage is that tools (like systmed) that parses fstab can call swapon without translation from fstab options to swapon(8) command line options. Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: improve formatting and wording of a few man pagesBenno Schulenberg2014-07-141-35/+37
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* swapon: mark --sumarry as deprecatedKarel Zak2014-06-301-1/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: standardize the phrases for --help and --version in all man pagesBenno Schulenberg2013-10-151-2/+2
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* swapon: cleanup man pageKarel Zak2013-08-231-33/+5Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: allow a more flexible swap discard policyRafael Aquini2013-08-231-7/+17
| | | | | | | | | | | | | | | | | | | | Introduce the necessary changes to swapon(8) allowing a sysadmin to leverage the new changes introduced to sys_swapon by "swap: discard while swapping only if SWAP_FLAG_DISCARD_PAGES", therefore allowing a more flexible set of choices when selection the discard policy for mounted swap areas. This patch introduces the following optional arguments to the already existent swapon(8) "--discard" option, in order to allow a discard type to be selected at swapon time: * once : only single-time area discards are issued. (swapon) * pages : discard freed pages before they are reused. If no policy is selected both discard types are enabled. (default) [kzak@redhat.com: - support <policy> argument for short -d option too, - add errx() on unsupported policy name] Signed-off-by: Rafael Aquini <aquini@redhat.com> Acked-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: remove repeated wordsKarel Zak2013-04-051-1/+1
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: swapon.8 option name fixSami Kerola2012-12-191-1/+1
| | | | | | | The commit 7ae8b469adda598fda28e4ea647d47905b43e172 added option --bytes, not the initial proposal which was changed after maillist discussion. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* swapon: clarify swapon.8 priority optionSami Kerola2012-10-151-2/+3
| | | | | | | Value -1 is valid argument for -p, even though it might not make much sense as the -1 is in use when priority is not specified at all. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* fix bold style of man page referencesMike Frysinger2012-10-091-1/+1
| | | | Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* libmount: document LIBMOUNT_DEBUG usersDavidlohr Bueso2012-09-041-0/+4
| | | | | | | Update the manpages of programs that use this environment variable for extra debugging information. Signed-off-by: Davidlohr Bueso <dave@gnu.org>
* swapon: make --show size to be human readable by defaultSami Kerola2012-07-101-0/+4
| | | | | | | Cc: Bernhard Voelker <mail@bernhard-voelker.de> Signed-off-by: Sami Kerola <kerolasa@iki.fi> Signed-off-by: Karel Zak <kzak@redhat.com>
* swapon: add --show optionSami Kerola2012-07-101-0/+17
| | | | | | | | | | | | The --show uses lib/tt.c, which allows user to specify columns he is interested of, and avoids using hard coded field sizes which may be problematic when system has large enough swap. [kzak@redhat.com: - improve usage(), remove unused code] Cc: Bernhard Voelker <mail@bernhard-voelker.de> Signed-off-by: Sami Kerola <kerolasa@iki.fi> Signed-off-by: Karel Zak <kzak@redhat.com>
* build-sys: move swapon from mount/ to sys-utils/Karel Zak2012-01-111-0/+220
... to make it independent on mount stuff. Signed-off-by: Karel Zak <kzak@redhat.com>