logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git

df.1 (1985B)


  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .Dd 2024-03-31
  5. .Dt DF 1
  6. .Os
  7. .Sh NAME
  8. .Nm df
  9. .Nd display mounted filesystems usage
  10. .Sh SYNOPSIS
  11. .Nm
  12. .Op Fl ahilPkT
  13. .Op Fl t Ar mnt_type
  14. .Op Fl x Ar mnt_type
  15. .Op Ar file...
  16. .Sh DESCRIPTION
  17. .Nm
  18. displays the current usage and mountpoints of mounted filesystems in a space-separated list containing:
  19. Filesystem, Total, Used, Available, Use percentage, Mountpoint.
  20. If
  21. .Ar file
  22. is given
  23. .Nm
  24. filters to the first filesystem containing each
  25. .Ar file .
  26. .Pp
  27. Unlike some implementations the table formatting isn't perfect, you might want to use
  28. .Xr column 1
  29. to get more readable output.
  30. Also padding is disabled when output isn't a TTY so you can more easily use tools like
  31. .Xr cut 1 .
  32. .Sh OPTIONS
  33. .Bl -tag -width Ds
  34. .It Fl a
  35. Display all mounted filesystems, otherwise
  36. .Nm
  37. deduplicates filesystems and skips ones with a blocksize of zero.
  38. .It Fl h
  39. Print human readable sizes.
  40. .It Fl i
  41. Print inode usage statistics.
  42. .It Fl l
  43. Exclude known remote filesystems.
  44. .It Fl P
  45. POSIX Formatting, prints in blocks of 512 when
  46. .It Fl k
  47. Forces printing in blocks of 1024.
  48. .Fl k
  49. is also passed, disables
  50. .Fl h .
  51. .It Fl T
  52. Print filesystem type right after the Filesystem column.
  53. .It Fl t Ar mnt_type
  54. Include only selected filesystems matching
  55. .Ar mnt_type .
  56. For example
  57. .Qq nfs4 .
  58. Option can be passed multiple times to include multiple types.
  59. .It Fl x Ar mnt_type
  60. Exclude filesystems types matching
  61. .Ar mnt_type .
  62. For example
  63. .Qq nfs4 .
  64. Option can be passed multiple times to exclude multiple types.
  65. .El
  66. .Sh EXIT STATUS
  67. .Ex -std
  68. .Sh SEE ALSO
  69. .Xr statvfs 3
  70. .Sh STANDARDS
  71. .Nm
  72. should be compliant with the
  73. IEEE Std 1003.1-2024 (“POSIX.1”)
  74. specification.
  75. .Pp
  76. .Fl i ,
  77. .Fl l ,
  78. .Fl t
  79. and
  80. .Fl x
  81. are extensions inspired by other implementations such as FreeBSD and GNU.
  82. .Sh AUTHORS
  83. .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me