Update all headers in the "zpool list" examples in the ZFS chapter to display

all columns that are currently available.
In particular, CKPOINT, EXPANDSZ, and FRAG were added and set with sensible
defaults for the example.

Reviewed by:		sevan@
Differential Revision:	https://reviews.freebsd.org/D16834
This commit is contained in:
Benedict Reuschling 2018-08-24 15:49:37 +00:00
parent b04b79faaa
commit cfb95ceac0
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52171

View file

@ -1103,8 +1103,8 @@ config:
errors: No known data errors
&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
healer 960M 92.5K 960M 0% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
healer 960M 92.5K 960M - - 0% 0% 1.00x ONLINE -</screen>
<para>Some important data that to be protected from data errors
using the self-healing feature is copied to the pool. A
@ -2436,9 +2436,9 @@ usr/home/joe 1.3G 128k 1.3G 0% /usr/home/joe</screen>
replication with these two pools:</para>
<screen>&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
backup 960M 77K 896M 0% 1.00x ONLINE -
mypool 984M 43.7M 940M 4% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
backup 960M 77K 896M - - 0% 0% 1.00x ONLINE -
mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -</screen>
<para>The pool named <replaceable>mypool</replaceable> is the
primary pool where data is written to and read from on a
@ -2479,9 +2479,9 @@ You must redirect standard output.</screen>
<screen>&prompt.root; <userinput>zfs send <replaceable>mypool</replaceable>@<replaceable>backup1</replaceable> > <replaceable>/backup/backup1</replaceable></userinput>
&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
backup 960M 63.7M 896M 6% 1.00x ONLINE -
mypool 984M 43.7M 940M 4% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -
mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -</screen>
<para>The <command>zfs send</command> transferred all the data
in the snapshot called <replaceable>backup1</replaceable> to
@ -2508,9 +2508,9 @@ total estimated size is 50.1M
TIME SENT SNAPSHOT
&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
backup 960M 63.7M 896M 6% 1.00x ONLINE -
mypool 984M 43.7M 940M 4% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
backup 960M 63.7M 896M - - 0% 6% 1.00x ONLINE -
mypool 984M 43.7M 940M - - 0% 4% 1.00x ONLINE -</screen>
<sect3 xml:id="zfs-send-incremental">
<title>Incremental Backups</title>
@ -2526,9 +2526,9 @@ NAME USED AVAIL REFER MOUNTPOINT
mypool@replica1 5.72M - 43.6M -
mypool@replica2 0 - 44.1M -
&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
backup 960M 61.7M 898M 6% 1.00x ONLINE -
mypool 960M 50.2M 910M 5% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
backup 960M 61.7M 898M - - 0% 6% 1.00x ONLINE -
mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -</screen>
<para>A second snapshot called
<replaceable>replica2</replaceable> was created. This
@ -2547,9 +2547,9 @@ total estimated size is 5.02M
TIME SENT SNAPSHOT
&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
backup 960M 80.8M 879M 8% 1.00x ONLINE -
mypool 960M 50.2M 910M 5% 1.00x ONLINE -
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
backup 960M 80.8M 879M - - 0% 8% 1.00x ONLINE -
mypool 960M 50.2M 910M - - 0% 5% 1.00x ONLINE -
&prompt.root; <userinput>zfs list</userinput>
NAME USED AVAIL REFER MOUNTPOINT
@ -2929,8 +2929,8 @@ mypool/compressed_dataset logicalused 496G -</screen>
like this example:</para>
<screen>&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
pool 2.84G 2.19M 2.83G 0% 1.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
pool 2.84G 2.19M 2.83G - - 0% 0% 1.00x ONLINE -</screen>
<para>The <literal>DEDUP</literal> column shows the actual rate
of deduplication for the pool. A value of
@ -2946,8 +2946,8 @@ pool 2.84G 2.19M 2.83G 0% 1.00x ONLINE -</screen>
<para>Redundant data is detected and deduplicated:</para>
<screen>&prompt.root; <userinput>zpool list</userinput>
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT
pool 2.84G 20.9M 2.82G 0% 3.00x ONLINE -</screen>
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
pool 2.84G 20.9M 2.82G - - 0% 0% 3.00x ONLINE -</screen>
<para>The <literal>DEDUP</literal> column shows a factor of
<literal>3.00x</literal>. Multiple copies of the ports tree