man/df.x

'\" Copyright (C) 1998-2023 Free Software Foundation, Inc.
'\"
'\" This is free software.  You may redistribute copies of it under the terms
'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>.
'\" There is NO WARRANTY, to the extent permitted by law.
[NAME]
df \- report file system space usage
[DESCRIPTION]
This manual page
documents the GNU version of
.BR df .
.B df
displays the amount of space available on the file system
containing each file name argument.  If no file name is given, the
space available on all currently mounted file systems is shown.
Space is shown in 1K blocks by default, unless the environment
variable POSIXLY_CORRECT is set, in which case 512-byte blocks are
used.
.PP
If an argument is the absolute file name of a device node containing a
mounted file system,
.B df
shows the space available on that file system rather than on the
file system containing the device node.  This version of
.B df
cannot show the space available on unmounted file systems, because on
most kinds of systems doing so requires very nonportable intimate
knowledge of file system structures.
.SH OPTIONS
maint: update all copyright year number ranges Update to latest gnulib with new copyright year. Run "make update-copyright" and then... * tests/init.sh: Sync with gnulib to pick up copyright year. * bootstrap: Manually update copyright year, until we fully sync with gnulib at a later stage. * tests/sample-test: Adjust to use the single most recent year. 2023-01-01 14:50:15 +00:00			`'\" Copyright (C) 1998-2023 Free Software Foundation, Inc.`
Add/fix copyright notices and adjust to latest GNU FDL. 2006-08-17 19:58:17 +00:00			`'\"`
			`'\" This is free software. You may redistribute copies of it under the terms`
all: prefer HTTPS in URLs 2017-09-19 01:13:23 -07:00			`'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>.`
Add/fix copyright notices and adjust to latest GNU FDL. 2006-08-17 19:58:17 +00:00			`'\" There is NO WARRANTY, to the extent permitted by law.`
include summary in [NAME] section 1999-11-02 13:51:42 +00:00			`[NAME]`
doc: modernize usage of “disk” and “core” In documentation and comments, don’t assume that secondary storage devices are disk devices. Similarly, don’t assume that main memory uses magnetic cores, which became obsolete in the 1970s. * src/du.c (usage): * src/ls.c (usage): * src/shred.c (usage): Reword to avoid “disk” in usage messages. 2021-07-28 12:22:11 -07:00			`df \- report file system space usage`
. 1998-09-12 20:12:55 +00:00			`[DESCRIPTION]`
			`This manual page`
			`documents the GNU version of`
			`.BR df .`
			`.B df`
doc: modernize usage of “disk” and “core” In documentation and comments, don’t assume that secondary storage devices are disk devices. Similarly, don’t assume that main memory uses magnetic cores, which became obsolete in the 1970s. * src/du.c (usage): * src/ls.c (usage): * src/shred.c (usage): Reword to avoid “disk” in usage messages. 2021-07-28 12:22:11 -07:00			`displays the amount of space available on the file system`
. 1998-09-12 20:12:55 +00:00			`containing each file name argument. If no file name is given, the`
doc: modernize usage of “disk” and “core” In documentation and comments, don’t assume that secondary storage devices are disk devices. Similarly, don’t assume that main memory uses magnetic cores, which became obsolete in the 1970s. * src/du.c (usage): * src/ls.c (usage): * src/shred.c (usage): Reword to avoid “disk” in usage messages. 2021-07-28 12:22:11 -07:00			`space available on all currently mounted file systems is shown.`
			`Space is shown in 1K blocks by default, unless the environment`
. 1998-09-12 20:12:55 +00:00			`variable POSIXLY_CORRECT is set, in which case 512-byte blocks are`
			`used.`
			`.PP`
doc: modernize usage of “disk” and “core” In documentation and comments, don’t assume that secondary storage devices are disk devices. Similarly, don’t assume that main memory uses magnetic cores, which became obsolete in the 1970s. * src/du.c (usage): * src/ls.c (usage): * src/shred.c (usage): Reword to avoid “disk” in usage messages. 2021-07-28 12:22:11 -07:00			`If an argument is the absolute file name of a device node containing a`
Use "file system" rather than "filesystem". 2004-06-30 22:15:59 +00:00			`mounted file system,`
. 1998-09-12 20:12:55 +00:00			`.B df`
Use "file system" rather than "filesystem". 2004-06-30 22:15:59 +00:00			`shows the space available on that file system rather than on the`
doc: fix details on the interaction of df with device nodes * man/df.x: Don't say that a dev node is always on the root file system. * doc/coreutils.texi (df invocation): Likewise. Also state that the device node to mounted file system interpretation is only done when passed absolute paths to device nodes. 2013-06-27 12:32:45 +01:00			`file system containing the device node. This version of`
. 1998-09-12 20:12:55 +00:00			`.B df`
Use "file system" rather than "filesystem". 2004-06-30 22:15:59 +00:00			`cannot show the space available on unmounted file systems, because on`
. 1998-09-12 20:12:55 +00:00			`most kinds of systems doing so requires very nonportable intimate`
Use "file system" rather than "filesystem". 2004-06-30 22:15:59 +00:00			`knowledge of file system structures.`
. 1998-09-12 20:12:55 +00:00			`.SH OPTIONS`