Print this page 
9286 want refreservation=auto
Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/zfs.1m
          +++ new/usr/src/man/man1m/zfs.1m
↓ open down ↓ 1337 lines elided ↑ open up ↑ 
1338 1338  The exact behavior of which metadata blocks are stored redundantly may change in
1339 1339  future releases.
1340 1340  .Pp
1341 1341  The default value is
1342 1342  .Sy all .
1343 1343  .It Sy refquota Ns = Ns Em size Ns | Ns Sy none
1344 1344  Limits the amount of space a dataset can consume.
1345 1345  This property enforces a hard limit on the amount of space used.
1346 1346  This hard limit does not include space used by descendents, including file
1347 1347  systems and snapshots.
1348      -.It Sy refreservation Ns = Ns Em size Ns | Ns Sy none
     1348 +.It Sy refreservation Ns = Ns Em size Ns | Ns Sy none Ns | Ns Sy auto
1349 1349  The minimum amount of space guaranteed to a dataset, not including its
1350 1350  descendents.
1351 1351  When the amount of space used is below this value, the dataset is treated as if
1352 1352  it were taking up the amount of space specified by
1353 1353  .Sy refreservation .
1354 1354  The
1355 1355  .Sy refreservation
1356 1356  reservation is accounted for in the parent datasets' space used, and counts
1357 1357  against the parent datasets' quotas and reservations.
1358 1358  .Pp
1359 1359  If
1360 1360  .Sy refreservation
1361 1361  is set, a snapshot is only allowed if there is enough free pool space outside of
1362 1362  this reservation to accommodate the current number of
1363 1363  .Qq referenced
1364 1364  bytes in the dataset.
1365 1365  .Pp
     1366 +If
     1367 +.Sy refreservation
     1368 +is set to
     1369 +.Sy auto ,
     1370 +a volume is made dense
     1371 +.Po or
     1372 +.Qq not sparse
     1373 +.Pc .
     1374 +.Sy refreservation Ns = Ns Sy auto
     1375 +is only supported on volumes. See
     1376 +.Sy volsize
     1377 +in the
     1378 +.Sx Native Properties
     1379 +section for more information about sparse volumes.
     1380 +.Pp
1366 1381  This property can also be referred to by its shortened column name,
1367 1382  .Sy refreserv .
1368      -.It Sy reservation Ns = Ns Em size Ns | Ns Sy none
     1383 +.It Sy reservation Ns = Ns Em size Ns | Ns Sy none Ns | Ns Sy auto
1369 1384  The minimum amount of space guaranteed to a dataset and its descendants.
1370 1385  When the amount of space used is below this value, the dataset is treated as if
1371 1386  it were taking up the amount of space specified by its reservation.
1372 1387  Reservations are accounted for in the parent datasets' space used, and count
1373 1388  against the parent datasets' quotas and reservations.
1374 1389  .Pp
     1390 +See
     1391 +.Sy refreservation Ns = Ns Sy auto
     1392 +above for a description of the behavior of setting
     1393 +.Sy reservation
     1394 +to
     1395 +.Sy auto .
     1396 +If the pool is at version 9 or later,
     1397 +.Sy refreservation Ns = Ns Sy auto
     1398 +should be used instead.
     1399 +.Pp
1375 1400  This property can also be referred to by its shortened column name,
1376 1401  .Sy reserv .
1377 1402  .It Sy secondarycache Ns = Ns Sy all Ns | Ns Sy none Ns | Ns Sy metadata
1378 1403  Controls what is cached in the secondary cache
1379 1404  .Pq L2ARC .
1380 1405  If this property is set to
1381 1406  .Sy all ,
1382 1407  then both user data and metadata is cached.
1383 1408  If this property is set to
1384 1409  .Sy none ,
↓ open down ↓ 194 lines elided ↑ open up ↑ 
1579 1604  .Po also known as
1580 1605  .Qq thin provisioning
1581 1606  .Pc
1582 1607  can be created by specifying the
1583 1608  .Fl s
1584 1609  option to the
1585 1610  .Nm zfs Cm create Fl V
1586 1611  command, or by changing the reservation after the volume has been created.
1587 1612  A
1588 1613  .Qq sparse volume
1589      -is a volume where the reservation is less then the volume size.
     1614 +is a volume where the reservation is less than the size of the volume plus the
     1615 +space required to store its metadata.
1590 1616  Consequently, writes to a sparse volume can fail with
1591 1617  .Er ENOSPC
1592 1618  when the pool is low on space.
1593 1619  For a sparse volume, changes to
1594 1620  .Sy volsize
1595      -are not reflected in the reservation.
     1621 +are not reflected in the reservation.  A sparse volume can be made dense
     1622 +.Po or
     1623 +.Qq not sparse
     1624 +.Pc
     1625 +by setting the reservation to
     1626 +.Sy auto .
1596 1627  .It Sy vscan Ns = Ns Sy on Ns | Ns Sy off
1597 1628  Controls whether regular files should be scanned for viruses when a file is
1598 1629  opened and closed.
1599 1630  In addition to enabling this property, the virus scan service must also be
1600 1631  enabled for virus scanning to occur.
1601 1632  The default value is
1602 1633  .Sy off .
1603 1634  .It Sy xattr Ns = Ns Sy on Ns | Ns Sy off
1604 1635  Controls whether extended attributes are enabled for this file system.
1605 1636  The default value is
↓ open down ↓ 2272 lines elided ↑ open up ↑ 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX