diff options
author | Pádraig Brady <P@draigBrady.com> | 2014-10-29 02:49:17 +0000 |
---|---|---|
committer | Pádraig Brady <P@draigBrady.com> | 2014-11-24 09:04:54 +0000 |
commit | 2e81e62243409c5c574b899f52b08c000e4d99fd (patch) | |
tree | fc5f35aeb4f13cb23d94e0364f01e5c066205a2f /doc | |
parent | 3ab3c7bb24b86ef2d2fede9fe26e3ee585db5411 (diff) | |
download | coreutils-2e81e62243409c5c574b899f52b08c000e4d99fd.tar.xz |
df: only suppress remote mounts of separate exports with --total
* src/df.c (filter_mount_list): Separate remote locations are
generally explicitly mounted, so list each even if they share
the same remote device and thus storage. However with --total
keep the suppression to give a more accurate value for the
total storage available.
(usage): Expand on the new implications of --total and move
it in the options list according to alphabetic order.
doc/coreutils.texi (df invocation): Mention that --total impacts
on deduplication of remote file systems and also move location
according to alphabetic order.
* tests/df/skip-duplicates.sh: Add remote test cases.
* NEWS: Mention the change in behavior.
Reported in http://bugs.debian.org/737399
Reported in http://bugzilla.redhat.com/920806
Reported in http://bugzilla.opensuse.org/866010
Reported in http://bugzilla.opensuse.org/901905
Diffstat (limited to 'doc')
-rw-r--r-- | doc/coreutils.texi | 31 |
1 files changed, 16 insertions, 15 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index db24a75dd..e9008c018 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -11205,8 +11205,7 @@ Non-integer quantities are rounded up to the next higher unit. For bind mounts and without arguments, @command{df} only outputs the statistics for that device with the shortest mount point name in the list of file systems (@var{mtab}), i.e., it hides duplicate entries, unless the @option{-a} option is -specified. Remote file systems, such as NFS, are treated the same way as local -ones; only one mount entry per remote file system is shown by default. +specified. With the same logic, @command{df} elides a mount entry of a dummy pseudo device if there is another mount entry of a real block device for that mount point with @@ -11248,19 +11247,6 @@ due to permissions of the mount point etc. Scale sizes by @var{size} before printing them (@pxref{Block size}). For example, @option{-BG} prints sizes in units of 1,073,741,824 bytes. -@item --total -@opindex --total -@cindex grand total of disk size, usage and available space -Print a grand total of all arguments after all arguments have -been processed. This can be used to find out the total disk size, usage -and available space of all listed devices. - -For the grand total line, @command{df} prints @samp{"total"} into the -@var{source} column, and @samp{"-"} into the @var{target} column. -If there is no @var{source} column (see @option{--output}), then -@command{df} prints @samp{"total"} into the @var{target} column, -if present. - @optHumanReadable @item -H @@ -11401,6 +11387,21 @@ some systems (notably SunOS), doing this yields more up to date results, but in general this option makes @command{df} much slower, especially when there are many or very busy file systems. +@item --total +@opindex --total +@cindex grand total of disk size, usage and available space +Print a grand total of all arguments after all arguments have +been processed. This can be used to find out the total disk size, usage +and available space of all listed devices. If no arguments are specified +df will try harder to elide file systems insignificant to the total +available space, by suppressing duplicate remote file systems. + +For the grand total line, @command{df} prints @samp{"total"} into the +@var{source} column, and @samp{"-"} into the @var{target} column. +If there is no @var{source} column (see @option{--output}), then +@command{df} prints @samp{"total"} into the @var{target} column, +if present. + @item -t @var{fstype} @itemx --type=@var{fstype} @opindex -t |