summaryrefslogtreecommitdiffstats
path: root/man/man8/zpool.8
diff options
context:
space:
mode:
authorRichard Laager <[email protected]>2016-05-11 13:19:31 -0500
committerBrian Behlendorf <[email protected]>2016-05-16 12:26:31 -0700
commit8fd888baa7be971233a72331f2ae7bc15087a4c8 (patch)
treecec94ca6e96dc72b92042c2a0b6fe1eecb86ad25 /man/man8/zpool.8
parent8e07f9a916c206833b94f047d834bc791661a3ed (diff)
zfs.8 & zpool.8: Various documentation edits
Signed-off-by: Richard Laager <[email protected]>
Diffstat (limited to 'man/man8/zpool.8')
-rw-r--r--man/man8/zpool.88
1 files changed, 5 insertions, 3 deletions
diff --git a/man/man8/zpool.8 b/man/man8/zpool.8
index b2a5d6cc4..841797569 100644
--- a/man/man8/zpool.8
+++ b/man/man8/zpool.8
@@ -614,11 +614,11 @@ The following property can be set at creation time:
.ne 2
.mk
.na
-\fB\fBashift\fR\fR
+\fB\fBashift\fR=\fIashift\fR\fR
.ad
.sp .6
.RS 4n
-Pool sector size exponent, to the power of 2 (internally referred to as "ashift"). I/O operations will be aligned to the specified size boundaries. Additionally, the minimum (disk) write size will be set to the specified size, so this represents a space vs. performance trade-off. The typical case for setting this property is when performance is important and the underlying disks use 4KiB sectors but report 512B sectors to the OS (for compatibility reasons); in that case, set \fBashift=12\fR (which is 1<<12 = 4096).
+Pool sector size exponent, to the power of 2 (internally referred to as "ashift"). Values from 9 to 13, inclusive, are valid; also, the special value 0 (the default) means to auto-detect using the kernel's block layer and a ZFS internal exception list. I/O operations will be aligned to the specified size boundaries. Additionally, the minimum (disk) write size will be set to the specified size, so this represents a space vs. performance trade-off. The typical case for setting this property is when performance is important and the underlying disks use 4KiB sectors but report 512B sectors to the OS (for compatibility reasons); in that case, set \fBashift=12\fR (which is 1<<12 = 4096).
.LP
For optimal performance, the pool sector size should be greater than or equal to the sector size of the underlying disks. Since the property cannot be changed after pool creation, if in a given pool, you \fIever\fR want to use drives that \fIreport\fR 4KiB sectors, you must set \fBashift=12\fR at pool creation time.
.LP
@@ -799,11 +799,13 @@ details on feature states.
.ne 2
.mk
.na
-\fB\fBlistsnaps\fR=on | off\fR
+\fB\fBlistsnapshots\fR=on | off\fR
.ad
.sp .6
.RS 4n
Controls whether information about snapshots associated with this pool is output when "\fBzfs list\fR" is run without the \fB-t\fR option. The default value is "off".
+.sp
+This property can also be referred to by its shortened name, \fBlistsnaps\fR.
.RE
.sp