Print this page
blah
2897 "zpool split" documentation missing from manpage
Reviewed by: Dan McDonald <danmcd@omniti.com>


  61 
  62 
  63        zpool reguid pool
  64 
  65 
  66        zpool reopen pool
  67 
  68 
  69        zpool remove pool device ...
  70 
  71 
  72        zpool replace [-f] pool device [new_device]
  73 
  74 
  75        zpool scrub [-s] pool ...
  76 
  77 
  78        zpool set property=value pool
  79 
  80 



  81        zpool status [-xvD] [-T u | d ] [pool] ... [interval [count]]
  82 
  83 
  84        zpool upgrade
  85 
  86 
  87        zpool upgrade -v
  88 
  89 
  90        zpool upgrade [-V version] -a | pool ...
  91 
  92 
  93 DESCRIPTION
  94        The zpool command configures ZFS storage pools. A storage pool is a
  95        collection of devices that provides physical storage and data
  96        replication for ZFS datasets.
  97 
  98 
  99        All datasets within a storage pool share the same space. See zfs(1M)
 100        for information on managing datasets.


1143            all data to discover silent errors due to hardware faults or disk
1144            failure.
1145 
1146            Because scrubbing and resilvering are I/O-intensive operations, ZFS
1147            only allows one at a time. If a scrub is already in progress, the
1148            "zpool scrub" command terminates it and starts a new scrub. If a
1149            resilver is in progress, ZFS does not allow a scrub to be started
1150            until the resilver completes.
1151 
1152            -s
1153                  Stop scrubbing.
1154 
1155 
1156 
1157        zpool set property=value pool
1158            Sets the given property on the specified pool. See the "Properties"
1159            section for more information on what properties can be set and
1160            acceptable values.
1161 
1162 













































1163        zpool status [-xvD] [-T u | d ] [pool] ... [interval [count]]
1164            Displays the detailed health status for the given pools. If no pool
1165            is specified, then the status of each pool in the system is
1166            displayed. For more information on pool and device health, see the
1167            "Device Failure and Recovery" section.
1168 
1169            If a scrub or resilver is in progress, this command reports the
1170            percentage done and the estimated time to completion. Both of these
1171            are only approximate, because the amount of data in the pool and
1172            the other workloads on the system can change.
1173 
1174            -x
1175                  Only display status for pools that are exhibiting errors or
1176                  are otherwise unavailable. Warnings about pools not using the
1177                  latest on-disk format will not be included.
1178 
1179 
1180            -v
1181                  Displays verbose data error information, printing out a
1182                  complete list of all data errors since the last complete pool




  61 
  62 
  63        zpool reguid pool
  64 
  65 
  66        zpool reopen pool
  67 
  68 
  69        zpool remove pool device ...
  70 
  71 
  72        zpool replace [-f] pool device [new_device]
  73 
  74 
  75        zpool scrub [-s] pool ...
  76 
  77 
  78        zpool set property=value pool
  79 
  80 
  81        zpool split [-n] [-R altroot] [-o mntopts] [-o property=value] pool newpool [device ... ]
  82 
  83 
  84        zpool status [-xvD] [-T u | d ] [pool] ... [interval [count]]
  85 
  86 
  87        zpool upgrade
  88 
  89 
  90        zpool upgrade -v
  91 
  92 
  93        zpool upgrade [-V version] -a | pool ...
  94 
  95 
  96 DESCRIPTION
  97        The zpool command configures ZFS storage pools. A storage pool is a
  98        collection of devices that provides physical storage and data
  99        replication for ZFS datasets.
 100 
 101 
 102        All datasets within a storage pool share the same space. See zfs(1M)
 103        for information on managing datasets.


1146            all data to discover silent errors due to hardware faults or disk
1147            failure.
1148 
1149            Because scrubbing and resilvering are I/O-intensive operations, ZFS
1150            only allows one at a time. If a scrub is already in progress, the
1151            "zpool scrub" command terminates it and starts a new scrub. If a
1152            resilver is in progress, ZFS does not allow a scrub to be started
1153            until the resilver completes.
1154 
1155            -s
1156                  Stop scrubbing.
1157 
1158 
1159 
1160        zpool set property=value pool
1161            Sets the given property on the specified pool. See the "Properties"
1162            section for more information on what properties can be set and
1163            acceptable values.
1164 
1165 
1166        zpool split [-n] [-R altroot] [-o mntopts] [-o property=value] pool newpool
1167        [device ... ]
1168 
1169            Splits off one disk from each mirrored top-level vdev in a pool and
1170            creates a new pool from the split-off disks. The original pool must
1171            be made up of one or more mirrors and must not be in the process of
1172            resilvering. The split subcommand chooses the last device in each
1173            mirror vdev unless overridden by a device specification on the
1174            command line.
1175 
1176            When using a device argument, split includes the specified
1177            device(s) in a new pool and, should any devices remain unspecified,
1178            assigns the last device in each mirror vdev to that pool, as it
1179            does normally. If you are uncertain about the outcome of a split
1180            command, use the -n ("dry-run") option to ensure your command will
1181            have the effect you intend.
1182 
1183 
1184            -n
1185                Displays the configuration that would be created without
1186                actually splitting the pool. The actual pool split could still
1187                fail due to insufficient privileges or device status.
1188 
1189 
1190            -R altroot
1191                Automatically import the newly created pool after splitting,
1192                using the specified altroot parameter for the new pool's
1193                alternate root. See the altroot description in the "Properties"
1194                section, above.
1195 
1196 
1197            -o mntopts
1198                Comma-separated list of mount options to use when mounting
1199                datasets within the pool. See zfs(1M) for a description of
1200                dataset properties and mount options. Valid only in conjunction
1201                with the -R option.
1202 
1203 
1204            -o property=value
1205                Sets the specified property on the new pool. See the
1206                "Properties" section, above, for more information on the
1207                available pool properties.
1208 
1209 
1210 
1211        zpool status [-xvD] [-T u | d ] [pool] ... [interval [count]]
1212            Displays the detailed health status for the given pools. If no pool
1213            is specified, then the status of each pool in the system is
1214            displayed. For more information on pool and device health, see the
1215            "Device Failure and Recovery" section.
1216 
1217            If a scrub or resilver is in progress, this command reports the
1218            percentage done and the estimated time to completion. Both of these
1219            are only approximate, because the amount of data in the pool and
1220            the other workloads on the system can change.
1221 
1222            -x
1223                  Only display status for pools that are exhibiting errors or
1224                  are otherwise unavailable. Warnings about pools not using the
1225                  latest on-disk format will not be included.
1226 
1227 
1228            -v
1229                  Displays verbose data error information, printing out a
1230                  complete list of all data errors since the last complete pool