1 .TH lfs-df 1 "2016 Dec 7" Lustre "user utilities"
3 lfs df \- report Lustre filesystem disk usage
5 .BR "lfs df" " [" -i "] [" -h "] [" --lazy "] [" --pool | -p
6 .IR <fsname> [. <pool> ]]
11 displays filesystem usage information by default for each Lustre
12 filesystem currently mounted on that node, or for the filesystem
15 if given. It displaying current usage and totals for each MDT and
16 OST separately, as well as a per-filesystem summary that matches
18 output for each filesystem.
20 The various options supported by
22 are listed and explained below:
24 .BR -h ", " --human-readable
25 Print output in a human readable format (e.g. 16.3T, 4.25P).
26 Suffixes are SI base-2 units (i.e. 1 GiB = 1024 MiB).
29 Print information about the inode usage and totals for the MDTs and
30 OSTs rather than space usage.
33 Do not attempt to contact any OST or MDT not currently connected to
34 the client. This avoids blocking the
36 output if an OST is down, and only returns the space on the OSTs that
37 can currently be accessed.
39 .BR -p ", " --pool=\fR[\fIfsname\fR.]\fIpool
40 Show only OSTs that are in the specified
42 If multiple filesystems are mounted, list OSTs in
44 for every filesystem, or limit the display to only a pool for a
45 specific filesystem if
47 is given. Specifying both the fsname and pool like:
49 .BI "lfs df --pool=" fsname.pool
51 is equivalent to specifying the mountpoint for the given
54 .BI "lfs df --pool=" "pool /mnt/fsname"
57 Show deactivated MDTs and OSTs in the listing. By default, any
58 MDTs and OSTs that are deactivated by the administrator are not shown.
59 However, targets that are only temporarily inaccessible are still shown.
62 .B $ lfs df -h /mnt/testfs
63 Lists space usage per OST and MDT for the
65 filesystem in human readable format.
68 List inode usage per OST and MDT for all mounted Lustre filesystems.
70 .B $ lfs df --pool ssd /mnt/testfs
71 List space usage for only the
77 .B $ lfs df -v /mnt/testfs
78 List all MDTs and OSTs for the
80 filesystem, even if not currently connected.