| zpool.8 (263393) | zpool.8 (264334) |
|---|---|
| 1'\" te 2.\" Copyright (c) 2012, Martin Matuska <mm@FreeBSD.org>. 3.\" All Rights Reserved. 4.\" 5.\" The contents of this file are subject to the terms of the 6.\" Common Development and Distribution License (the "License"). 7.\" You may not use this file except in compliance with the License. 8.\" --- 9 unchanged lines hidden (view full) --- 18.\" information: Portions Copyright [yyyy] [name of copyright owner] 19.\" 20.\" Copyright (c) 2010, Sun Microsystems, Inc. All Rights Reserved. 21.\" Copyright 2011, Nexenta Systems, Inc. All Rights Reserved. 22.\" Copyright (c) 2011, Justin T. Gibbs <gibbs@FreeBSD.org> 23.\" Copyright (c) 2012 by Delphix. All Rights Reserved. 24.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> 25.\" | 1'\" te 2.\" Copyright (c) 2012, Martin Matuska <mm@FreeBSD.org>. 3.\" All Rights Reserved. 4.\" 5.\" The contents of this file are subject to the terms of the 6.\" Common Development and Distribution License (the "License"). 7.\" You may not use this file except in compliance with the License. 8.\" --- 9 unchanged lines hidden (view full) --- 18.\" information: Portions Copyright [yyyy] [name of copyright owner] 19.\" 20.\" Copyright (c) 2010, Sun Microsystems, Inc. All Rights Reserved. 21.\" Copyright 2011, Nexenta Systems, Inc. All Rights Reserved. 22.\" Copyright (c) 2011, Justin T. Gibbs <gibbs@FreeBSD.org> 23.\" Copyright (c) 2012 by Delphix. All Rights Reserved. 24.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> 25.\" |
| 26.\" $FreeBSD: stable/10/cddl/contrib/opensolaris/cmd/zpool/zpool.8 263393 2014-03-19 23:44:03Z delphij $ | 26.\" $FreeBSD: stable/10/cddl/contrib/opensolaris/cmd/zpool/zpool.8 264334 2014-04-11 01:23:46Z delphij $ |
| 27.\" | 27.\" |
| 28.Dd December 31, 2013 | 28.Dd March 20, 2014 |
| 29.Dt ZPOOL 8 30.Os 31.Sh NAME 32.Nm zpool 33.Nd configures ZFS storage pools 34.Sh SYNOPSIS 35.Nm 36.Op Fl \&? --- 582 unchanged lines hidden (view full) --- 619Synchronous data in the intent log will not be accessible 620.It 621Properties of the pool can not be changed 622.It 623Datasets of this pool can only be mounted read-only 624.It 625To write to a read-only pool, a export and import of the pool is required. 626.El | 29.Dt ZPOOL 8 30.Os 31.Sh NAME 32.Nm zpool 33.Nd configures ZFS storage pools 34.Sh SYNOPSIS 35.Nm 36.Op Fl \&? --- 582 unchanged lines hidden (view full) --- 619Synchronous data in the intent log will not be accessible 620.It 621Properties of the pool can not be changed 622.It 623Datasets of this pool can only be mounted read-only 624.It 625To write to a read-only pool, a export and import of the pool is required. 626.El |
| 627.Pp 628This property can also be referred to by its shortened column name, 629.Sy rdonly . |
|
| 627.El 628.Pp 629The following properties can be set at creation time and import time, and later 630changed with the 631.Ic zpool set 632command: 633.Bl -tag -width 2n 634.It Sy autoexpand Ns = Ns Cm on No | Cm off --- 42 unchanged lines hidden (view full) --- 677A text string consisting of printable ASCII characters that will be stored 678such that it is available even if the pool becomes faulted. 679An administrator can provide additional information about a pool using this 680property. 681.It Sy dedupditto Ns = Ns Ar number 682Threshold for the number of block ditto copies. If the reference count for a 683deduplicated block increases above this number, a new ditto copy of this block 684is automatically stored. Default setting is | 630.El 631.Pp 632The following properties can be set at creation time and import time, and later 633changed with the 634.Ic zpool set 635command: 636.Bl -tag -width 2n 637.It Sy autoexpand Ns = Ns Cm on No | Cm off --- 42 unchanged lines hidden (view full) --- 680A text string consisting of printable ASCII characters that will be stored 681such that it is available even if the pool becomes faulted. 682An administrator can provide additional information about a pool using this 683property. 684.It Sy dedupditto Ns = Ns Ar number 685Threshold for the number of block ditto copies. If the reference count for a 686deduplicated block increases above this number, a new ditto copy of this block 687is automatically stored. Default setting is |
| 685.Cm 0 . | 688.Cm 0 689which causes no ditto copies to be created for deduplicated blocks. 690The miniumum legal nonzero setting is 100. |
| 686.It Sy delegation Ns = Ns Cm on No | Cm off 687Controls whether a non-privileged user is granted access based on the dataset 688permissions defined on the dataset. See 689.Xr zfs 8 690for more information on 691.Tn ZFS 692delegated administration. 693.It Sy failmode Ns = Ns Cm wait No | Cm continue No | Cm panic --- 453 unchanged lines hidden (view full) --- 1147option. 1148.It Fl D 1149Imports destroyed pools only. The 1150.Fl f 1151option is also required. 1152.It Fl f 1153Forces import, even if the pool appears to be potentially active. 1154.It Fl m | 691.It Sy delegation Ns = Ns Cm on No | Cm off 692Controls whether a non-privileged user is granted access based on the dataset 693permissions defined on the dataset. See 694.Xr zfs 8 695for more information on 696.Tn ZFS 697delegated administration. 698.It Sy failmode Ns = Ns Cm wait No | Cm continue No | Cm panic --- 453 unchanged lines hidden (view full) --- 1152option. 1153.It Fl D 1154Imports destroyed pools only. The 1155.Fl f 1156option is also required. 1157.It Fl f 1158Forces import, even if the pool appears to be potentially active. 1159.It Fl m |
| 1155Enables import with missing log devices. | 1160Allows a pool to import when there is a missing log device. Recent transactions 1161can be lost because the log device will be discarded. |
| 1156.It Fl N | 1162.It Fl N |
| 1157Do not mount any filesystems from the imported pool. | 1163Import the pool without mounting any file systems. |
| 1158.It Fl R Ar root 1159Sets the 1160.Qq Sy cachefile 1161property to 1162.Qq Cm none 1163and the 1164.Qq Sy altroot 1165property to --- 74 unchanged lines hidden (view full) --- 1240option. 1241.It Fl D 1242Imports destroyed pools only. The 1243.Fl f 1244option is also required. 1245.It Fl f 1246Forces import, even if the pool appears to be potentially active. 1247.It Fl m | 1164.It Fl R Ar root 1165Sets the 1166.Qq Sy cachefile 1167property to 1168.Qq Cm none 1169and the 1170.Qq Sy altroot 1171property to --- 74 unchanged lines hidden (view full) --- 1246option. 1247.It Fl D 1248Imports destroyed pools only. The 1249.Fl f 1250option is also required. 1251.It Fl f 1252Forces import, even if the pool appears to be potentially active. 1253.It Fl m |
| 1248Enables import with missing log devices. | 1254Allows a pool to import when there is a missing log device. Recent transactions 1255can be lost because the log device will be discarded. |
| 1249.It Fl N | 1256.It Fl N |
| 1250Do not mount any filesystems from the imported pool. | 1257Import the pool without mounting any file systems. |
| 1251.It Fl R Ar root 1252Equivalent to 1253.Qq Fl o Cm cachefile=none,altroot= Ns Pa root 1254.It Fl F 1255Recovery mode for a non-importable pool. Attempt to return the pool to an 1256importable state by discarding the last few transactions. Not all damaged pools 1257can be recovered by using this option. If successful, the data from the 1258discarded transactions is irretrievably lost. This option is ignored if the --- 72 unchanged lines hidden (view full) --- 1331.Op Fl Hv 1332.Op Fl o Ar property Ns Op , Ns Ar ... 1333.Op Fl T Cm d Ns | Ns Cm u 1334.Op Ar pool 1335.Ar ... 1336.Op Ar inverval Op Ar count 1337.Xc 1338.Pp | 1258.It Fl R Ar root 1259Equivalent to 1260.Qq Fl o Cm cachefile=none,altroot= Ns Pa root 1261.It Fl F 1262Recovery mode for a non-importable pool. Attempt to return the pool to an 1263importable state by discarding the last few transactions. Not all damaged pools 1264can be recovered by using this option. If successful, the data from the 1265discarded transactions is irretrievably lost. This option is ignored if the --- 72 unchanged lines hidden (view full) --- 1338.Op Fl Hv 1339.Op Fl o Ar property Ns Op , Ns Ar ... 1340.Op Fl T Cm d Ns | Ns Cm u 1341.Op Ar pool 1342.Ar ... 1343.Op Ar inverval Op Ar count 1344.Xc 1345.Pp |
| 1339Lists the given pools along with a health status and space usage. When given no 1340arguments, all pools in the system are listed. | 1346Lists the given pools along with a health status and space usage. If no 1347.Ar pools 1348are specified, all pools in the system are listed. |
| 1341.Pp 1342When given an interval, the output is printed every 1343.Ar interval 1344seconds until 1345.Sy Ctrl-C 1346is pressed. If 1347.Ar count 1348is specified, the command exits after 1349.Ar count 1350reports are printed. 1351.Bl -tag -width indent | 1349.Pp 1350When given an interval, the output is printed every 1351.Ar interval 1352seconds until 1353.Sy Ctrl-C 1354is pressed. If 1355.Ar count 1356is specified, the command exits after 1357.Ar count 1358reports are printed. 1359.Bl -tag -width indent |
| 1360.It Fl T Cm d Ns | Ns Cm u 1361Print a timestamp. 1362.Pp 1363Use modifier 1364.Cm d 1365for standard date format. See 1366.Xr date 1 . 1367Use modifier 1368.Cm u 1369for unixtime 1370.Pq equals Qq Ic date +%s . |
|
| 1352.It Fl H 1353Scripted mode. Do not display headers, and separate fields by a single tab 1354instead of arbitrary space. 1355.It Fl v 1356Show more detailed information. 1357.It Fl o Ar property Ns Op , Ns Ar ... 1358Comma-separated list of properties to display. See the 1359.Qq Sx Properties --- 312 unchanged lines hidden (view full) --- 1672.Fl a | Ar pool ... 1673.Xc 1674.Pp 1675Enables all supported features on the given pool. 1676Once this is done, the pool will no longer be accessible on systems that do 1677not support feature flags. 1678See 1679.Xr zpool-features 7 | 1371.It Fl H 1372Scripted mode. Do not display headers, and separate fields by a single tab 1373instead of arbitrary space. 1374.It Fl v 1375Show more detailed information. 1376.It Fl o Ar property Ns Op , Ns Ar ... 1377Comma-separated list of properties to display. See the 1378.Qq Sx Properties --- 312 unchanged lines hidden (view full) --- 1691.Fl a | Ar pool ... 1692.Xc 1693.Pp 1694Enables all supported features on the given pool. 1695Once this is done, the pool will no longer be accessible on systems that do 1696not support feature flags. 1697See 1698.Xr zpool-features 7 |
| 1680for details on compatability with system sthat support feature flags, but do | 1699for details on compatibility with systems that support feature flags, but do |
| 1681not support all features enabled on the pool. 1682.Bl -tag -width indent 1683.It Fl a 1684Enables all supported features on all pools. 1685.It Fl V Ar version 1686Upgrade to the specified legacy version. If the 1687.Fl V 1688flag is specified, no features will be enabled on the pool. --- 276 unchanged lines hidden --- | 1700not support all features enabled on the pool. 1701.Bl -tag -width indent 1702.It Fl a 1703Enables all supported features on all pools. 1704.It Fl V Ar version 1705Upgrade to the specified legacy version. If the 1706.Fl V 1707flag is specified, no features will be enabled on the pool. --- 276 unchanged lines hidden --- |