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.\"
--- 8 unchanged lines hidden (view full) ---
17.\" fields enclosed by brackets "[]" replaced with your own identifying
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.\"
25.\" $FreeBSD: head/cddl/contrib/opensolaris/cmd/zpool/zpool.8 236960 2012-06-12 14:40:19Z mm $
26.\"
27.Dd November 28, 2011
28.Dt ZPOOL 8
29.Os
30.Sh NAME
31.Nm zpool
32.Nd configures ZFS storage pools
33.Sh SYNOPSIS
--- 1597 unchanged lines hidden (view full) ---
1631.Pq equals Qq Ic date +%s .
1632.El
1633.It Xo
1634.Nm
1635.Cm upgrade
1636.Op Fl v
1637.Xc
1638.Pp
1639Displays all pools formatted using a different
1640.Tn ZFS
1641pool on-disk version. Older versions can continue to be used, but some
1642features may not be available. These pools can be upgraded using
1643.Qq Nm Cm upgrade Fl a .
1644Pools that are formatted with a more recent version are also displayed,
1645although these pools will be inaccessible on the system.
1646.Bl -tag -width indent
1647.It Fl v
1648Displays
1649.Tn ZFS
1650pool versions supported by the current software. The current
1651.Tn ZFS
1652pool version and all previous supported versions are displayed, along
1653with an explanation of the features provided with each version.
1654.El
1655.It Xo
1656.Nm
1657.Cm upgrade
1658.Op Fl V Ar version
1659.Fl a | Ar pool ...
1660.Xc
1661.Pp
1662Upgrades the given pool to the latest on-disk pool version. Once this is done,
1663the pool will no longer be accessible on systems running older versions of the
1664software.
1665.Bl -tag -width indent
1666.It Fl a
1667Upgrades all pools.
1668.It Fl V Ar version
1669Upgrade to the specified version. If the
1670.Fl V
1671flag is not specified, the pool is upgraded to the most recent version. This
1672option can only be used to increase the version number, and only up to the most
1673recent version supported by this software.
1674.El
1675.El
1676.Sh EXAMPLES
1677.Bl -tag -width 0n
1678.It Sy Example 1 No Creating a RAID-Z Storage Pool
1679.Pp
1680The following command creates a pool with a single
1681.No raidz
--- 260 unchanged lines hidden ---
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.\"
--- 8 unchanged lines hidden (view full) ---
17.\" fields enclosed by brackets "[]" replaced with your own identifying
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.\"
25.\" $FreeBSD: head/cddl/contrib/opensolaris/cmd/zpool/zpool.8 236960 2012-06-12 14:40:19Z mm $
26.\"
27.Dd November 28, 2011
28.Dt ZPOOL 8
29.Os
30.Sh NAME
31.Nm zpool
32.Nd configures ZFS storage pools
33.Sh SYNOPSIS
--- 1597 unchanged lines hidden (view full) ---
1631.Pq equals Qq Ic date +%s .
1632.El
1633.It Xo
1634.Nm
1635.Cm upgrade
1636.Op Fl v
1637.Xc
1638.Pp
1639Displays all pools formatted using a different
1640.Tn ZFS
1641pool on-disk version. Older versions can continue to be used, but some
1642features may not be available. These pools can be upgraded using
1643.Qq Nm Cm upgrade Fl a .
1644Pools that are formatted with a more recent version are also displayed,
1645although these pools will be inaccessible on the system.
1646.Bl -tag -width indent
1647.It Fl v
1648Displays
1649.Tn ZFS
1650pool versions supported by the current software. The current
1651.Tn ZFS
1652pool version and all previous supported versions are displayed, along
1653with an explanation of the features provided with each version.
1654.El
1655.It Xo
1656.Nm
1657.Cm upgrade
1658.Op Fl V Ar version
1659.Fl a | Ar pool ...
1660.Xc
1661.Pp
1662Upgrades the given pool to the latest on-disk pool version. Once this is done,
1663the pool will no longer be accessible on systems running older versions of the
1664software.
1665.Bl -tag -width indent
1666.It Fl a
1667Upgrades all pools.
1668.It Fl V Ar version
1669Upgrade to the specified version. If the
1670.Fl V
1671flag is not specified, the pool is upgraded to the most recent version. This
1672option can only be used to increase the version number, and only up to the most
1673recent version supported by this software.
1674.El
1675.El
1676.Sh EXAMPLES
1677.Bl -tag -width 0n
1678.It Sy Example 1 No Creating a RAID-Z Storage Pool
1679.Pp
1680The following command creates a pool with a single
1681.No raidz
--- 260 unchanged lines hidden ---