mirror of
https://git.proxmox.com/git/mirror_zfs.git
synced 2024-12-28 11:59:34 +03:00
4e6b3f7e1d
This commit adds support for zpool list command to output the list of ZFS pools in JSON format using '-j' option.. Information about available pools is collected in nvlist which is later printed to stdout in JSON format. Existing options for zfs list command work with '-j' flag. man page for zpool list is updated accordingly. Reviewed-by: Tony Hutter <hutter2@llnl.gov> Reviewed-by: Ameer Hamza <ahamza@ixsystems.com> Signed-off-by: Umer Saleem <usaleem@ixsystems.com> Closes #16217
254 lines
6.9 KiB
Groff
254 lines
6.9 KiB
Groff
.\"
|
|
.\" CDDL HEADER START
|
|
.\"
|
|
.\" The contents of this file are subject to the terms of the
|
|
.\" Common Development and Distribution License (the "License").
|
|
.\" You may not use this file except in compliance with the License.
|
|
.\"
|
|
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
|
|
.\" or https://opensource.org/licenses/CDDL-1.0.
|
|
.\" See the License for the specific language governing permissions
|
|
.\" and limitations under the License.
|
|
.\"
|
|
.\" When distributing Covered Code, include this CDDL HEADER in each
|
|
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
|
|
.\" If applicable, add the following below this CDDL HEADER, with the
|
|
.\" fields enclosed by brackets "[]" replaced with your own identifying
|
|
.\" information: Portions Copyright [yyyy] [name of copyright owner]
|
|
.\"
|
|
.\" CDDL HEADER END
|
|
.\"
|
|
.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
|
|
.\" Copyright (c) 2012, 2018 by Delphix. All rights reserved.
|
|
.\" Copyright (c) 2012 Cyril Plisko. All Rights Reserved.
|
|
.\" Copyright (c) 2017 Datto Inc.
|
|
.\" Copyright (c) 2018 George Melikov. All Rights Reserved.
|
|
.\" Copyright 2017 Nexenta Systems, Inc.
|
|
.\" Copyright (c) 2017 Open-E, Inc. All Rights Reserved.
|
|
.\"
|
|
.Dd March 16, 2022
|
|
.Dt ZPOOL-LIST 8
|
|
.Os
|
|
.
|
|
.Sh NAME
|
|
.Nm zpool-list
|
|
.Nd list information about ZFS storage pools
|
|
.Sh SYNOPSIS
|
|
.Nm zpool
|
|
.Cm list
|
|
.Op Fl HgLpPv
|
|
.Op Fl j Op Ar --json-int, --json-pool-key-guid
|
|
.Op Fl o Ar property Ns Oo , Ns Ar property Oc Ns …
|
|
.Op Fl T Sy u Ns | Ns Sy d
|
|
.Oo Ar pool Oc Ns …
|
|
.Op Ar interval Op Ar count
|
|
.
|
|
.Sh DESCRIPTION
|
|
Lists the given pools along with a health status and space usage.
|
|
If no
|
|
.Ar pool Ns s
|
|
are specified, all pools in the system are listed.
|
|
When given an
|
|
.Ar interval ,
|
|
the information is printed every
|
|
.Ar interval
|
|
seconds until killed.
|
|
If
|
|
.Ar count
|
|
is specified, the command exits after
|
|
.Ar count
|
|
reports are printed.
|
|
.Bl -tag -width Ds
|
|
.It Fl j Op Ar --json-int, --json-pool-key-guid
|
|
Display the list of pools in JSON format.
|
|
Specify
|
|
.Sy --json-int
|
|
to display the numbers in integer format instead of strings.
|
|
Specify
|
|
.Sy --json-pool-key-guid
|
|
to set pool GUID as key for pool objects instead of pool names.
|
|
.It Fl 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.
|
|
.It Fl H
|
|
Scripted mode.
|
|
Do not display headers, and separate fields by a single tab instead of arbitrary
|
|
space.
|
|
.It Fl o Ar property
|
|
Comma-separated list of properties to display.
|
|
See the
|
|
.Xr zpoolprops 7
|
|
manual page for a list of valid properties.
|
|
The default list is
|
|
.Sy name , size , allocated , free , checkpoint, expandsize , fragmentation ,
|
|
.Sy capacity , dedupratio , health , altroot .
|
|
.It Fl 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
|
|
.Pa /dev/disk
|
|
path used to open it.
|
|
.It Fl p
|
|
Display numbers in parsable
|
|
.Pq exact
|
|
values.
|
|
.It Fl P
|
|
Display full paths for vdevs instead of only the last component of
|
|
the path.
|
|
This can be used in conjunction with the
|
|
.Fl L
|
|
flag.
|
|
.It Fl T Sy u Ns | Ns Sy d
|
|
Display a time stamp.
|
|
Specify
|
|
.Sy u
|
|
for a printed representation of the internal representation of time.
|
|
See
|
|
.Xr time 1 .
|
|
Specify
|
|
.Sy d
|
|
for standard date format.
|
|
See
|
|
.Xr date 1 .
|
|
.It Fl v
|
|
Verbose statistics.
|
|
Reports usage statistics for individual vdevs within the pool, in addition to
|
|
the pool-wide statistics.
|
|
.El
|
|
.
|
|
.Sh EXAMPLES
|
|
.\" These are, respectively, examples 6, 15 from zpool.8
|
|
.\" Make sure to update them bidirectionally
|
|
.Ss Example 1 : No Listing Available ZFS Storage Pools
|
|
The following command lists all available pools on the system.
|
|
In this case, the pool
|
|
.Ar zion
|
|
is faulted due to a missing device.
|
|
The results from this command are similar to the following:
|
|
.Bd -literal -compact -offset Ds
|
|
.No # Nm zpool Cm 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 -
|
|
.Ed
|
|
.
|
|
.Ss Example 2 : No Displaying expanded space on a device
|
|
The following command displays the detailed information for the pool
|
|
.Ar 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.
|
|
.Bd -literal -compact -offset Ds
|
|
.No # Nm zpool Cm list Fl v Ar 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 - - - - -
|
|
.Ed
|
|
.
|
|
.Ss Example 3 : No Displaying expanded space on a device
|
|
The following command lists all available pools on the system in JSON
|
|
format.
|
|
.Bd -literal -compact -offset Ds
|
|
.No # Nm zpool Cm list Fl j | Nm jq
|
|
{
|
|
"output_version": {
|
|
"command": "zpool list",
|
|
"vers_major": 0,
|
|
"vers_minor": 1
|
|
},
|
|
"pools": {
|
|
"tank": {
|
|
"name": "tank",
|
|
"type": "POOL",
|
|
"state": "ONLINE",
|
|
"guid": "15220353080205405147",
|
|
"txg": "2671",
|
|
"spa_version": "5000",
|
|
"zpl_version": "5",
|
|
"properties": {
|
|
"size": {
|
|
"value": "111G",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"allocated": {
|
|
"value": "30.8G",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"free": {
|
|
"value": "80.2G",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"checkpoint": {
|
|
"value": "-",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"expandsize": {
|
|
"value": "-",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"fragmentation": {
|
|
"value": "0%",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"capacity": {
|
|
"value": "27%",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"dedupratio": {
|
|
"value": "1.00x",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"health": {
|
|
"value": "ONLINE",
|
|
"source": {
|
|
"type": "NONE",
|
|
"data": "-"
|
|
}
|
|
},
|
|
"altroot": {
|
|
"value": "-",
|
|
"source": {
|
|
"type": "DEFAULT",
|
|
"data": "-"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
.Ed
|
|
.
|
|
.Sh SEE ALSO
|
|
.Xr zpool-import 8 ,
|
|
.Xr zpool-status 8
|