diff --git a/cmd/zpool/zpool_main.c b/cmd/zpool/zpool_main.c index 8eb7e35cf..aaf4a352b 100644 --- a/cmd/zpool/zpool_main.c +++ b/cmd/zpool/zpool_main.c @@ -521,11 +521,11 @@ get_usage(zpool_help_t idx) return (gettext("\ttrim [-dw] [-r ] [-c | -s] " "[ ...]\n")); case HELP_STATUS: - return (gettext("\tstatus [--power] [-j [--json-int, " - "--json-flat-vdevs, ...\n" - "\t --json-pool-key-guid]] [-c [script1,script2,...]] " + return (gettext("\tstatus [-c script1[,script2,...]] " "[-dDegiLpPstvx] ...\n" - "\t [-T d|u] [pool] [interval [count]]\n")); + "\t [-j [--json-int] [--json-flat-vdevs] " + "[--json-pool-key-guid]] ...\n" + "\t [--power] [-T d|u] [pool] [interval [count]]\n")); case HELP_UPGRADE: return (gettext("\tupgrade\n" "\tupgrade -v\n" @@ -10980,8 +10980,10 @@ status_callback(zpool_handle_t *zhp, void *data) } /* - * zpool status [-c [script1,script2,...]] [-dDegiLpPstvx] [--power] ... - * [-T d|u] [pool] [interval [count]] + * zpool status [-c [script1,script2,...]] [-dDegiLpPstvx] ... + * [-j [--json-int] [--json-flat-vdevs] ... + * [--json-pool-key-guid]] [--power] [-T d|u] ... + * [pool] [interval [count]] * * -c CMD For each vdev, run command CMD * -d Display Direct I/O write verify errors @@ -10989,19 +10991,19 @@ status_callback(zpool_handle_t *zhp, void *data) * -e Display only unhealthy vdevs * -g Display guid for individual vdev name. * -i Display vdev initialization status. + * -j [...] Display output in JSON format + * --json-int Display numbers in inteeger format instead of string + * --json-flat-vdevs Display vdevs in flat hierarchy + * --json-pool-key-guid Use pool GUID as key for pool objects * -L Follow links when resolving vdev path name. * -p Display values in parsable (exact) format. * -P Display full path for vdev name. + * --power Display vdev enclosure slot power status * -s Display slow IOs column. * -t Display vdev TRIM status. * -T Display a timestamp in date(1) or Unix format * -v Display complete error logs * -x Display only pools with potential problems - * -j Display output in JSON format - * --power Display vdev enclosure slot power status - * --json-int Display numbers in inteeger format instead of string - * --json-flat-vdevs Display vdevs in flat hierarchy - * --json-pool-key-guid Use pool GUID as key for pool objects * * Describes the health status of all pools or some subset. */ diff --git a/man/man8/zpool-status.8 b/man/man8/zpool-status.8 index 10d7ff973..ca489e7be 100644 --- a/man/man8/zpool-status.8 +++ b/man/man8/zpool-status.8 @@ -37,12 +37,17 @@ .Sh SYNOPSIS .Nm zpool .Cm status +.Op Fl c Ar script1 Ns Oo , Ns Ar script2 Ns ,… Oc .Op Fl dDegiLpPstvx -.Op Fl T Sy u Ns | Ns Sy d -.Op Fl c Op Ar SCRIPT1 Ns Oo , Ns Ar SCRIPT2 Oc Ns … -.Oo Ar pool Oc Ns … +.Oo Fl j +.Oo Ns Fl Fl json-int Oc +.Oo Ns Fl Fl json-flat-vdevs Oc +.Oo Ns Fl Fl json-pool-key-guid Oc +.Oc +.Op Fl Fl power +.Op Fl T Ar d|u +.Op Ar pool .Op Ar interval Op Ar count -.Op Fl j Op Ar --json-int, --json-flat-vdevs, --json-pool-key-guid . .Sh DESCRIPTION Displays the detailed health status for the given pools. @@ -59,9 +64,7 @@ and the estimated time to completion. Both of these are only approximate, because the amount of data in the pool and the other workloads on the system can change. .Bl -tag -width Ds -.It Fl -power -Display vdev enclosure slot power status (on or off). -.It Fl c Op Ar SCRIPT1 Ns Oo , Ns Ar SCRIPT2 Oc Ns … +.It Fl c Ar script1 Ns Oo , Ns Ar script2 Ns ,… Oc Run a script (or scripts) on each vdev and include the output as a new column in the .Nm zpool Cm status @@ -71,17 +74,6 @@ See the option of .Nm zpool Cm iostat for complete details. -.It Fl j , -json Op Ar --json-int, --json-flat-vdevs, --json-pool-key-guid -Display the status for ZFS pools in JSON format. -Specify -.Sy --json-int -to display numbers in integer format instead of strings. -Specify -.Sy --json-flat-vdevs -to display vdevs in flat hierarchy instead of nested vdev objects. -Specify -.Sy --json-pool-key-guid -to set pool GUID as key for pool objects instead of pool names. .It Fl d Display the number of Direct I/O read/write checksum verify errors that have occurred on a top-level VDEV. @@ -111,6 +103,18 @@ These GUIDs can be used in place of device names for the zpool detach/offline/remove/replace commands. .It Fl i Display vdev initialization status. +.It Fl j , -json Oo Ns Fl Fl json-int Oc Oo Ns Fl Fl json-flat-vdevs Oc \ +Oo Ns Fl Fl json-pool-key-guid Oc +Display the status for ZFS pools in JSON format. +Specify +.Sy --json-int +to display numbers in integer format instead of strings. +Specify +.Sy --json-flat-vdevs +to display vdevs in flat hierarchy instead of nested vdev objects. +Specify +.Sy --json-pool-key-guid +to set pool GUID as key for pool objects instead of pool names. .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 @@ -124,6 +128,8 @@ the path. This can be used in conjunction with the .Fl L flag. +.It Fl -power +Display vdev enclosure slot power status (on or off). .It Fl s Display the number of leaf vdev slow I/O operations. This is the number of I/O operations that didn't complete in @@ -136,18 +142,18 @@ unreasonably long amount of time. This may indicate a problem with the underlying storage. .It Fl t Display vdev TRIM status. -.It Fl T Sy u Ns | Ns Sy d +.It Fl T Sy d Ns | Ns Sy u 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 . +Specify +.Sy u +for a printed representation of the internal representation of time. +See +.Xr time 1 . .It Fl v Displays verbose data error information, printing out a complete list of all data errors since the last complete pool scrub.