NAME

       zpool-list — list information about ZFS storage pools

SYNOPSIS

       zpool list [-HgLpPv] [-o property[,property]…] [-T u|d] [pool]… [interval [count]]

DESCRIPTION

       Lists  the  given pools along with a health status and space usage.  If no pools are specified, all pools
       in the system are listed.  When given an interval, the information  is  printed  every  interval  seconds
       until killed.  If count is specified, the command exits after count reports are printed.

       -g      Display  vdev  GUIDs  instead  of  the  normal device names.  These GUIDs can be used in place of
               device names for the zpool detach/offline/remove/replace commands.

       -H      Scripted mode.  Do not display headers, and separate fields by a single tab instead of  arbitrary
               space.

       -o property
               Comma-separated  list  of properties to display.  See the zpoolprops(7) manual page for a list of
               valid properties.  The default list is  name,  size,  allocated,  free,  checkpoint,  expandsize,
               fragmentation, capacity, dedupratio, health, altroot.

       -L      Display  real  paths  for  vdevs  resolving  all symbolic links.  This can be used to look up the
               current block device name regardless of the /dev/disk path used to open it.

       -p      Display numbers in parsable (exact) values.

       -P      Display full paths for vdevs instead of only the last component of the path.  This can be used in
               conjunction with the -L flag.

       -T u|d  Display a time stamp.  Specify u for a printed representation of the internal  representation  of
               time.  See time(2).  Specify d for standard date format.  See date(1).

       -v      Verbose  statistics.   Reports usage statistics for individual vdevs within the pool, in addition
               to the pool-wide statistics.

EXAMPLES

   Example 1: Listing Available ZFS Storage Pools
       The following command lists all available pools on the system.  In this case, the pool  zion  is  faulted
       due to a missing device.  The results from this command are similar to the following:
             # zpool list
             NAME    SIZE  ALLOC   FREE  EXPANDSZ   FRAG    CAP  DEDUP  HEALTH  ALTROOT
             rpool  19.9G  8.43G  11.4G         -    33%    42%  1.00x  ONLINE  -
             tank   61.5G  20.0G  41.5G         -    48%    32%  1.00x  ONLINE  -
             zion       -      -      -         -      -      -      -  FAULTED -

   Example 2: Displaying expanded space on a device
       The  following  command displays the detailed information for the pool data.  This pool is comprised of a
       single raidz vdev where one of its devices increased its capacity by 10 GiB.  In this example,  the  pool
       will  not  be  able  to  utilize this extra capacity until all the devices under the raidz vdev have been
       expanded.
             # zpool list -v data
             NAME         SIZE  ALLOC   FREE  EXPANDSZ   FRAG    CAP  DEDUP  HEALTH  ALTROOT
             data        23.9G  14.6G  9.30G         -    48%    61%  1.00x  ONLINE  -
               raidz1    23.9G  14.6G  9.30G         -    48%
                 sda         -      -      -         -      -
                 sdb         -      -      -       10G      -
                 sdc         -      -      -         -      -

SEE ALSO

       zpool-import(8), zpool-status(8)

OpenZFS                                          March 16, 2022                                    ZPOOL-LIST(8)