ericonr
/
util-linux
mirror of https://github.com/ericonr/util-linux.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
10,292 Commits 31 Branches 178 Tags 180 MiB
C 85.6%
Shell 9.2%
M4 1.9%
Meson 1.8%
Yacc 0.7%
Other 0.7%
Go to file
Richard Yao 1d01d13eda swapon: fix discard=pages docs 
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>
 		2016-03-14 12:26:28 +01:00
Documentation docs: update v2.28-ReleaseNotes 2016-03-11 11:39:28 +01:00
bash-completion bash-completion: fstrim: use mountpoint, not device 2015-11-13 09:52:14 +01:00
config build-sys: inform gtk-doc about __ul_attribute__ 2013-03-15 14:58:08 +01:00
disk-utils misc: remove duplicate includes 2016-03-10 14:30:32 +01:00
include Merge branch 'port-osx' of https://github.com/rudimeier/util-linux 2016-03-09 13:12:50 +01:00
lib lib/linux_version: avoid major and minor shadowing 2016-03-09 11:49:42 +01:00
libblkid build-sys: fix if..endif for *_la_LDFLAGS 2016-03-10 13:54:15 +01:00
libfdisk build-sys: fix if..endif for *_la_LDFLAGS 2016-03-10 13:54:15 +01:00
libmount build-sys: fix if..endif for *_la_LDFLAGS 2016-03-10 13:54:15 +01:00
libsmartcols build-sys: fix if..endif for *_la_LDFLAGS 2016-03-10 13:54:15 +01:00
libuuid build-sys: fix if..endif for *_la_LDFLAGS 2016-03-10 13:54:15 +01:00
login-utils include: move sys/sysmacros.h to c.h 2016-03-08 14:29:45 +01:00
m4 build-sys: check linker support for version scripts 2016-02-18 12:53:48 +01:00
misc-utils logger: keep man page consistent and use \- everywhere 2016-03-10 14:36:22 +01:00
po po: merge changes 2016-03-10 15:19:25 +01:00
schedutils taskset: fix description of `-c` option in the man page 2016-03-07 15:11:06 +01:00
sys-utils swapon: fix discard=pages docs 2016-03-14 12:26:28 +01:00
term-utils agetty: tweak formatting and some wordings in the man page 2016-03-08 14:21:55 +01:00
tests tests: update build-sys tests 2016-03-10 14:28:30 +01:00
text-utils misc: never cast void* from malloc(3) and friends 2016-03-07 23:29:27 +01:00
tools build-sys: portable usage of find command 2016-02-18 12:53:47 +01:00
.editorconfig add .editorconfig 2016-01-25 00:12:14 +01:00
.gitignore libsmartcols: fix samples build, add title.c 2016-01-25 13:42:51 +01:00
.travis-functions.sh tests: add option --parsable 2016-03-05 22:19:24 +01:00
.travis.yml travis: minor cleanup 2016-02-18 12:53:03 +01:00
AUTHORS docs: update AUTHORS file 2016-03-10 15:28:28 +01:00
COPYING docs: corrections to FSF license files, and postal address 2012-02-24 14:13:35 +01:00
ChangeLog build-sys: use AUTOMAKE_OPTIONS = gnu 2011-05-26 15:04:01 +02:00
Makefile.am build-sys: Properly order install dependencies of pylibmount 2016-02-05 11:03:09 -08:00
NEWS build-sys: release++ (v2.28-rc1) 2016-03-11 11:41:05 +01:00
README docs: update links to http://git.kernel.org/ web repository views 2013-11-12 11:47:57 +01:00
README.licensing COPYING: fix grammar of referring phrase, and indicate location better 2013-10-08 15:38:39 +02:00
autogen.sh build-sys: fix [g]libtoolize version for OSX 2016-02-18 12:53:48 +01:00
configure.ac build-sys: release++ (v2.28-rc1) 2016-03-11 11:41:05 +01:00
util-linux.doap doap: fix download URL 2016-01-25 15:42:53 +01:00

README 

                                  util-linux

              util-linux is a random collection of Linux utilities

     Note that in years 2006-2010 this project used the name "util-linux-ng".

MAILING LIST:

      E-MAIL: util-linux@vger.kernel.org
      URL:    http://vger.kernel.org/vger-lists.html#util-linux


DOWNLOAD:

      ftp://ftp.kernel.org/pub/linux/utils/util-linux/


SOURCE CODE:

      Web interface:
          http://git.kernel.org/cgit/utils/util-linux/util-linux.git
          https://github.com/karelzak/util-linux
      Checkout:
          git clone git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git util-linux


NLS (PO TRANSLATIONS):

      PO files are maintained by:
          http://translationproject.org/domain/util-linux.html


VERSION SCHEMA:

      Standard releases:

          <major>.<minor>[.<maint>[.<bugfix>]]

             major = fatal and deep changes
             minor = typical release with new features
             maint = maintenance releases; bug fixes only
             bugfix = unplanned releases for critical/security bugs

      Development releases:

         <major>.<minor>-rc<N>