lustre/doc/lfs-df.1

   1 .TH lfs-df 1 "2016 Dec 7" Lustre "user utilities"
   2 .SH NAME
   3 lfs df \- report Lustre filesystem disk usage
   4 .SH SYNOPSIS
   5 .BR "lfs df" " [" -i "] [" -h "] [" --lazy "] [" --pool | -p
   6 .IR <fsname> [. <pool> ]]
   7 .RB [ -v ]
   8 .RI [ path ]
   9 .SH DESCRIPTION
  10 .B lfs df
  11 displays filesystem usage information by default for each Lustre
  12 filesystem currently mounted on that node, or for the filesystem
  13 that contains
  14 .I path
  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
  17 .BR df (1)
  18 output for each filesystem.
  19 .SH OPTIONS
  20 The various options supported by
  21 .B lfs df
  22 are listed and explained below:
  23 .TP
  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).
  27 .TP
  28 .BR -i ", " --inodes
  29 Print information about the inode usage and totals for the MDTs and
  30 OSTs rather than space usage.
  31 .TP
  32 .BR -l ", " --lazy
  33 Do not attempt to contact any OST or MDT not currently connected to
  34 the client.  This avoids blocking the
  35 .B lfs df
  36 output if an OST is down, and only returns the space on the OSTs that
  37 can currently be accessed.
  38 .TP
  39 .BR -p ", " --pool=\fR[\fIfsname\fR.]\fIpool
  40 Show only OSTs that are in the specified
  41 .IR pool .
  42 If multiple filesystems are mounted, list OSTs in
  43 .I pool
  44 for every filesystem, or limit the display to only a pool for a
  45 specific filesystem if
  46 .I fsname.pool
  47 is given.  Specifying both the fsname and pool like:
  48 .br
  49 .BI "lfs df --pool=" fsname.pool
  50 .br
  51 is equivalent to specifying the mountpoint for the given
  52 .IR fsname :
  53 .br
  54 .BI "lfs df --pool=" "pool /mnt/fsname"
  55 .TP
  56 .BR -v ", " --verbose
  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.
  60 .SH EXAMPLES
  61 .TP
  62 .B $ lfs df -h /mnt/testfs
  63 Lists space usage per OST and MDT for the
  64 .B testfs
  65 filesystem in human readable format.
  66 .TP
  67 .B $ lfs df -i
  68 List inode usage per OST and MDT for all mounted Lustre filesystems.
  69 .TP
  70 .B $ lfs df --pool ssd /mnt/testfs
  71 List space usage for only the
  72 .B ssd
  73 pool of the
  74 .B testfs
  75 filesystem.
  76 .TP
  77 .B $ lfs df -v /mnt/testfs
  78 List all MDTs and OSTs for the
  79 .B testfs
  80 filesystem, even if not currently connected.
  81 .SH SEE ALSO
  82 .BR lfs (1),
  83 .BR lustre (7)