aboutsummaryrefslogtreecommitdiff
path: root/bin/df/df.1
Commit message (Collapse)AuthorAgeFilesLines
* manpages: prefer linking to xo_options.7 over xo_parse_args.3Alan Somers2025-07-161-3/+3
| | | | | | | | | | | | | | | Most libxo-enabled utilities link to xo_parse_args.3. But that man page doesn't actually describe how to format command-line arguments. Rather, xo_options.7 does. I suspect that these utilities link to the former because the latter man page did not exist until libxo-0.7.2 (8a6eceff3ce). And newer utilities have probably been copy/pasting the same text from older ones. But the superior man page does exist now, so we should link to it instead. MFC after: 2 weeks Sponsored by: ConnectWise Reviewed by: emaste Differential Revision: https://reviews.freebsd.org/D51354
* df(1): Fix grammarChia-Jung Chang2024-02-131-1/+1
| | | | | Event: Advance UNIX programming course (Fall'23) at NTHU Pull Request: https://github.com/freebsd/freebsd-src/pull/1027
* df(1): fix a typoPin-Yi Kuo2023-12-261-1/+1
| | | | | | | | | On the manpage of df(1), "according" is mistyped into "acccording" Event: Advanced UNIX Programming Course (Fall'23) at NTHU. Signed-off-by: Pin-Yi Kuo <kuokuoyiyi@gapp.nthu.edu.tw> Reviewed by: imp, zlei, Mina Galić Pull Request: https://github.com/freebsd/freebsd-src/pull/944
* bin: Remove ancient SCCS tags.Warner Losh2023-11-271-2/+0
| | | | | | | | Remove ancient SCCS tags from the tree, automated scripting, with two minor fixup to keep things compiling. All the common forms in the tree were removed with a perl script. Sponsored by: Netflix
* Remove $FreeBSD$: one-line nroff patternWarner Losh2023-08-161-1/+0
| | | | Remove /^\.\\"\s*\$FreeBSD\$$\n/
* fs/msdosfs: add tracking of free root directory entriesStefan Eßer2023-03-291-1/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This update implements tallying of free directory entries during create, delete, or rename operations on FAT12 and FAT16 file systems. Prior to this change, the total number of root directory entries was reported as number of inodes, but 0 as the number of free inodes, causing system health monitoring software to warn about a suspected disk full issue. The FAT12 and FAT16 file systems provide a limited number of root directory entries, e.g. 512 on typical hard disk formats. The valid range of values is 1 to 65535, but the msdosfs code will effectively round up "odd" values to the next multiple of 16 (e.g. 513 would allow for 528 root directory entries). This update implements tracking of directory entries during create, delete, or rename operations, with initial values determined by scanning the directory when the file system is mounted. Total and free directory entries are reported in the f_files and f_ffree elements of struct statfs, despite differences in semantics of these values: - There is no limit on the number of files and directories that can be created on a FAT file system. Only the root directory of FAT12 and FAT16 file systems is limited, any number of files can still be created in sub-directories, even when 0 free "inodes" are reported. - A single file can require 1 to 21 directory entries, depending on the character set, structure, and length of the name. The DOS 8.3 style file name takes up 1 entry, and if the name does not comply with the syntax of a DOS 8.3 file name, 1 additional entry is used for each 13 characters of the file name. Since all these entries have to be contiguous, it is possible that a file or directory with a long name can not be created, despite a sufficient total number of free directory entries. - Renaming a file can require more directory entries than currently allocated to store its long name, which may prevent an in-place update of the name if more entries are needed. This may cause a rename operation to fail if no contiguous range of free entries for the new name can be found. - The volume label is stored in a directory entry. An empty FAT file system with a volume label will therefore show 1 used "inode" in df. - The perceentage of free inodes shown in df or monitoring tools does only represent the state of the root directory of a FAT12 or FAT16 file system. Neither does a reported value of 0% free inodes does prevent files from being created in sub-directories, nor does a value of 50% free inodes guarantee that even a single file with a "long" name can be created in the root directory (if every other directory entry is occupied and there are no 2 contiguous entries). The statfs(2) and df(1) man pages have been updated with a notice regarding the possibly different semantics of values reported as total and free inodes for non-Unix file systems. PR: 270053 Reported by: Ben Woods <woodsb02@freebsd.org> Approved by: mckusick MFC after: 1 month Differential Revision: https://reviews.freebsd.org/D38987
* df: do not report a 100% full inode usage on fs without inodesBaptiste Daroussin2022-03-111-1/+4
| | | | | | | | | | | | | | | | Before: devfs 2 2 0 100% 0 0 100% /dev After: devfs 2 2 0 100% 0 0 - /dev The previous behaviour was confusing for end users and many monitoring tools Note the linux df tools is also using the same syntax '-' for such filesystem MFC After: 2 weeks Reviewed by: manu, emaste, imp Differential Revision: https://reviews.freebsd.org/D34515
* bin/df: allow -t option to be used together with -lStefan Eßer2022-02-101-3/+13
| | | | | | | | | | | | | | | | | | | | The df command provides a -l option to exclude all non-local file systems and a -t option with a (positive or negative) list of file system types to display. This commit adds support for a combination of -l and -t. If both are specified, the parameter list of the -t option is applied on top of the selection of öocal file systems (independently of the order of the -l and -t options). E.g., "df -t noprocfs,sysfs -l" will select all local file systems except those of type procfs and sysfs. PR: 260921 Approved by: imp Relnotes: yes MFC after: 1 month Differential Revision: https://reviews.freebsd.org/D33748
* Remove the unnecessary space before the colonMateusz Piotrowski2021-01-201-2/+1
| | | | MFC after: 3 days
* df: Remove support for mounting devicesMark Johnston2020-11-131-0/+1
| | | | | | | | | | | | This was marked deprecated in r329092, over two and a half years ago. This functionality is also buggy per PR 237368. PR: 237368 Reviewed by: brooks, cem, emaste, imp Differential Revision: https://reviews.freebsd.org/D27197 Notes: svn path=/head/; revision=367642
* df(1): Add EXAMPLES section to man pageFernando Apesteguía2020-10-051-11/+51
| | | | | | | | | | | | | * Add EXAMPLES section with four simple examples. * Simplify -H flag description. This makes easy to see the difference between this flag and -h * While here, fix .Tn deprecated macro. Approved by: manpages (bcr@) Differential Revision: https://reviews.freebsd.org/D26662 Notes: svn path=/head/; revision=366445
* df(1): Add --si as an alias for -HKyle Evans2017-08-091-2/+2
| | | | | | | | | Reviewed by: cem (earlier version), emaste Approved by: emaste (mentor) Differential Revision: https://reviews.freebsd.org/D11749 Notes: svn path=/head/; revision=322293
* Renumber copyright clause 4Warner Losh2017-02-281-1/+1
| | | | | | | | | | | | Renumber cluase 4 to 3, per what everybody else did when BSD granted them permission to remove clause 3. My insistance on keeping the same numbering for legal reasons is too pedantic, so give up on that point. Submitted by: Jan Schaumann <jschauma@stevens.edu> Pull Request: https://github.com/freebsd/freebsd/pull/96 Notes: svn path=/head/; revision=314436
* Add more text to explain --libxo flag.Craig Rodrigues2015-12-011-1/+8
| | | | Notes: svn path=/head/; revision=291607
* Document that df(1) supports libxo(3).Marcel Moolenaar2014-11-071-1/+4
| | | | Notes: svn path=/head/; revision=274214
* -h and -H options backwards in manual page.Warren Block2014-01-161-3/+3
| | | | | | | | | PR: bin/183681 docs/183681 Submitted by: Robin Hahling <robin.hahling@gw-computing.net> MFC after: 3 days Notes: svn path=/head/; revision=260782
* Clean up a spurious "." in SEE ALSO.Christian Brueffer2013-10-281-1/+1
| | | | | | | MFC after: 3 days Notes: svn path=/head/; revision=257288
* Complete revision 243104.Greg Lehey2013-05-171-1/+3
| | | | Notes: svn path=/head/; revision=250732
* Don't time travel back and use a present date.Xin LI2013-01-251-1/+1
| | | | | | | Noticed by: mckusick Notes: svn path=/head/; revision=245912
* - Wrap long line;Xin LI2013-01-241-1/+2
| | | | | | | | | - Add -, to SYNOPSIS section. MFC after: 2 weeks Notes: svn path=/head/; revision=245871
* Update man pages and clarify a number of options.Greg Lehey2012-11-161-29/+58
| | | | | | | | | Rework block count calculations to work correctly with small "block" sizes. MFC after: 14 days Notes: svn path=/head/; revision=243129
* Fix section number for pstat and swapinfo cross references.Sergey Kandaurov2012-11-151-3/+3
| | | | | | | MFC after: 3 days Notes: svn path=/head/; revision=243104
* Add , (comma) option to print sizes grouped and separated by thousandsGreg Lehey2012-11-151-10/+30
| | | | | | | | | | using the non-monetary separator returned by localeconv(3), typically a comma or period. MFC after: 14 days Notes: svn path=/head/; revision=243049
* Bump date to today (since I modified it)Eitan Adler2012-03-031-1/+1
| | | | | | | | | PR: bin/165321 Approved by: gjb MFC after: 3 days Notes: svn path=/head/; revision=232469
* Direct users to swapinfo and pstat from dfEitan Adler2012-03-031-0/+2
| | | | | | | | | | PR: bin/165321 Submitted by: jhs Approved by: bcr MFC after: 3 days Notes: svn path=/head/; revision=232466
* Minor clarificationDag-Erling Smørgrav2011-10-181-1/+2
| | | | | | | MFC after: 3 weeks Notes: svn path=/head/; revision=226503
* Make "human-readable" (-H/-h) output also "humanize" inode counts.Simon L. B. Nielsen2009-06-071-2/+7
| | | | | | | | | | | | Base 10 is always used for the inode counts as I could not think of any reason base 2 inode counts would be useful. Minor mdoc markup fix to df(1) while here anyway. MFC after: 3 weeks Notes: svn path=/head/; revision=193629
* Implement -T option as found in Linux df(1). When given, file system typePawel Jakub Dawidek2008-11-231-2/+4
| | | | | | | | | | will be included in output. Reviewed and tested by: keramida MFC after: 2 weeks Notes: svn path=/head/; revision=185200
* Fix markup.Ruslan Ermilov2007-02-281-2/+3
| | | | Notes: svn path=/head/; revision=167105
* Add the new standard EXIT STATUS section where appropriate.Ruslan Ermilov2005-01-161-7/+7
| | | | | | | Sort standard sections in the (documented) preferred order. Notes: svn path=/head/; revision=140353
* /*- or .\"- or #- to begin license clauses.Warner Losh2005-01-101-0/+1
| | | | Notes: svn path=/head/; revision=139969
* Scheduled mdoc(7) sweep.Ruslan Ermilov2005-01-091-1/+2
| | | | Notes: svn path=/head/; revision=139943
* Currently if a mount point is not accessible by the calling user,Christian S.J. Peron2004-07-201-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | invalid information will be printed if the -t flag is specified. $ df -t ufs Filesystem 1K-blocks Used Avail Capacity Mounted on /dev/ad0s1a 495726 139944 316124 31% / /dev/ad0s1e 253678 6438 226946 3% /tmp /dev/ad0s1f 56206340 13594248 38115586 26% /usr /dev/ad0s1d 694126 19812 618784 3% /var /dev/ad0s1d 694126 19812 618784 3% /var $ Note that the mount point which is not accessible shows up as the previous file system that was printed. The reason for this is that df -t will call statfs(2) on the pathname supplied by getfsstat(2). This is done to refresh the file system statistics in the event that a previous file system had a long delay in providing its stats. This change affects the df utility in the following ways: o Teach df has to deal with statfs(2) failing. If statfs(2) fails, fall back on the possibly stale stats provided by the initial call to getfsstat(2). o Print a warning that the fs stats could possibly be stale o Modify the man page and document this new behavior as a bug. Approved by: bmilekic (mentor) PR: 68165 Notes: svn path=/head/; revision=132465
* Mechanically kill hard sentence breaks.Ruslan Ermilov2004-07-021-6/+12
| | | | Notes: svn path=/head/; revision=131484
* Bump document date for the latest functional change.Ruslan Ermilov2004-05-161-5/+2
| | | | | | | Minor markup tweaks. Notes: svn path=/head/; revision=129295
* Add 'g' to SYNOPSIS.David E. O'Brien2004-04-221-1/+1
| | | | Notes: svn path=/head/; revision=128554
* Add -c option simular to du(1).David E. O'Brien2004-04-181-1/+3
| | | | | | | | PR: 19635 Submitted by: cyrille.lefevre@laposte.net Notes: svn path=/head/; revision=128410
* Remove clause 3 from the UCB licenses.Mark Murray2004-04-061-4/+0
| | | | | | | OK'ed by: imp, core Notes: svn path=/head/; revision=127958
* Catch up with revs 1.49-1.50 of df.c: don't mention -t in the BUGS sectionBruce Evans2003-06-031-3/+1
| | | | | | | since it has been fixed. Notes: svn path=/head/; revision=115770
* df(1) and ls(1) print units in 'four or fewer' not 'three or less'.Tom Rhodes2003-05-061-2/+2
| | | | | | | | PR: 35523 Submitted by: Tomas Svensson <tsn@gbdev.net> Notes: svn path=/head/; revision=114791
* Fix 'SYNOPSIS' and 'usage'Tom Rhodes2002-08-261-1/+1
| | | | Notes: svn path=/head/; revision=102432
* s/filesystem/file system/ as discussed on -developersTom Rhodes2002-08-211-15/+15
| | | | Notes: svn path=/head/; revision=102230
* Use `The .Nm utility'Philippe Charnier2002-04-161-1/+3
| | | | Notes: svn path=/head/; revision=94869
* mdoc(7) police: removed HISTORY info from the .Os call.Ruslan Ermilov2001-07-101-1/+1
| | | | Notes: svn path=/head/; revision=79526
* Added the -l option to df, so to be compatable with other unicies.Jim Pirzyk2001-06-041-2/+4
| | | | | | | | | PR: bin/27240 Reviewed by: GAWollman MFC after: 2 weeks Notes: svn path=/head/; revision=77734
* Remove vestiges of MFS.Ruslan Ermilov2001-06-011-2/+2
| | | | Notes: svn path=/head/; revision=77575
* mdoc(7) police: split punctuation characters + misc fixes.Ruslan Ermilov2001-02-011-1/+1
| | | | Notes: svn path=/head/; revision=71895
* mdoc(7) police: use the new features of the Nm macro.Ruslan Ermilov2000-11-201-1/+1
| | | | Notes: svn path=/head/; revision=68935
* Add -g for gigabyte sizes.John W. De Boskey2000-06-031-0/+5
| | | | | | | Approved by: jkh Notes: svn path=/head/; revision=61227
* Fix miscellaneous mdoc macro argument limit infringements.Sheldon Hearn2000-05-091-1/+4
| | | | | | | | PR: 18465 Reported by: Kazu TAKAMUNE <takamune@avrl.mei.co.jp> Notes: svn path=/head/; revision=60258
generated by cgit v1.3 (git 2.53.0) at 2026-10-07 14:15:14 +0000