zfs.8 (332739) | zfs.8 (339103) |
---|---|
1'\" te 2.\" Copyright (c) 2013, 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.\" --- 14 unchanged lines hidden (view full) --- 23.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> 24.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org> 25.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved. 26.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. 27.\" Copyright (c) 2013, Steven Hartland <smh@FreeBSD.org> 28.\" Copyright (c) 2016 Nexenta Systems, Inc. All Rights Reserved. 29.\" Copyright (c) 2014, Xin LI <delphij@FreeBSD.org> 30.\" Copyright (c) 2014-2015, The FreeBSD Foundation, All Rights Reserved. | 1'\" te 2.\" Copyright (c) 2013, 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.\" --- 14 unchanged lines hidden (view full) --- 23.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> 24.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org> 25.\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved. 26.\" Copyright (c) 2014, Joyent, Inc. All rights reserved. 27.\" Copyright (c) 2013, Steven Hartland <smh@FreeBSD.org> 28.\" Copyright (c) 2016 Nexenta Systems, Inc. All Rights Reserved. 29.\" Copyright (c) 2014, Xin LI <delphij@FreeBSD.org> 30.\" Copyright (c) 2014-2015, The FreeBSD Foundation, All Rights Reserved. |
31.\" Copyright 2018 Joyent, Inc. |
|
31.\" | 32.\" |
32.\" $FreeBSD: stable/11/cddl/contrib/opensolaris/cmd/zfs/zfs.8 332739 2018-04-18 20:31:42Z mav $ | 33.\" $FreeBSD: stable/11/cddl/contrib/opensolaris/cmd/zfs/zfs.8 339103 2018-10-03 02:08:32Z mav $ |
33.\" 34.Dd December 6, 2017 35.Dt ZFS 8 36.Os 37.Sh NAME 38.Nm zfs 39.Nd configures ZFS file systems 40.Sh SYNOPSIS --- 1265 unchanged lines hidden (view full) --- 1306are stored redundantly may change in future releases. 1307.Pp 1308The default value is 1309.Cm all . 1310.It Sy refquota Ns = Ns Ar size | Cm none 1311Limits the amount of space a dataset can consume. This property enforces a hard 1312limit on the amount of space used. This hard limit does not include space used 1313by descendents, including file systems and snapshots. | 34.\" 35.Dd December 6, 2017 36.Dt ZFS 8 37.Os 38.Sh NAME 39.Nm zfs 40.Nd configures ZFS file systems 41.Sh SYNOPSIS --- 1265 unchanged lines hidden (view full) --- 1307are stored redundantly may change in future releases. 1308.Pp 1309The default value is 1310.Cm all . 1311.It Sy refquota Ns = Ns Ar size | Cm none 1312Limits the amount of space a dataset can consume. This property enforces a hard 1313limit on the amount of space used. This hard limit does not include space used 1314by descendents, including file systems and snapshots. |
1314.It Sy refreservation Ns = Ns Ar size | Cm none | 1315.It Sy refreservation Ns = Ns Ar size | Cm none | Cm auto |
1315The minimum amount of space guaranteed to a dataset, not including its 1316descendents. When the amount of space used is below this value, the dataset is 1317treated as if it were taking up the amount of space specified by 1318.Sy refreservation . 1319The 1320.Sy refreservation 1321reservation is accounted for in the parent datasets' space used, and counts 1322against the parent datasets' quotas and reservations. 1323.Pp 1324If 1325.Sy refreservation 1326is set, a snapshot is only allowed if there is enough free pool space outside 1327of this reservation to accommodate the current number of "referenced" bytes in 1328the dataset. 1329.Pp | 1316The minimum amount of space guaranteed to a dataset, not including its 1317descendents. When the amount of space used is below this value, the dataset is 1318treated as if it were taking up the amount of space specified by 1319.Sy refreservation . 1320The 1321.Sy refreservation 1322reservation is accounted for in the parent datasets' space used, and counts 1323against the parent datasets' quotas and reservations. 1324.Pp 1325If 1326.Sy refreservation 1327is set, a snapshot is only allowed if there is enough free pool space outside 1328of this reservation to accommodate the current number of "referenced" bytes in 1329the dataset. 1330.Pp |
1331If 1332.Sy refreservation 1333is set to 1334.Sy auto , 1335a volume is thick provisioned or not sparse. 1336.Sy refreservation Ns = Cm auto 1337is only supported on volumes. 1338See 1339.Sy volsize 1340in the Native Properties 1341section for more information about sparse volumes. 1342.Pp |
|
1330This property can also be referred to by its shortened column name, 1331.Sy refreserv . 1332.It Sy reservation Ns = Ns Ar size | Cm none 1333The minimum amount of space guaranteed to a dataset and its descendents. When 1334the amount of space used is below this value, the dataset is treated as if it 1335were taking up the amount of space specified by its reservation. Reservations 1336are accounted for in the parent datasets' space used, and count against the 1337parent datasets' quotas and reservations. --- 116 unchanged lines hidden (view full) --- 1454.Pp 1455The reservation is kept equal to the volume's logical size to prevent 1456unexpected behavior for consumers. Without the reservation, the volume could 1457run out of space, resulting in undefined behavior or data corruption, depending 1458on how the volume is used. These effects can also occur when the volume size is 1459changed while it is in use (particularly when shrinking the size). Extreme care 1460should be used when adjusting the volume size. 1461.Pp | 1343This property can also be referred to by its shortened column name, 1344.Sy refreserv . 1345.It Sy reservation Ns = Ns Ar size | Cm none 1346The minimum amount of space guaranteed to a dataset and its descendents. When 1347the amount of space used is below this value, the dataset is treated as if it 1348were taking up the amount of space specified by its reservation. Reservations 1349are accounted for in the parent datasets' space used, and count against the 1350parent datasets' quotas and reservations. --- 116 unchanged lines hidden (view full) --- 1467.Pp 1468The reservation is kept equal to the volume's logical size to prevent 1469unexpected behavior for consumers. Without the reservation, the volume could 1470run out of space, resulting in undefined behavior or data corruption, depending 1471on how the volume is used. These effects can also occur when the volume size is 1472changed while it is in use (particularly when shrinking the size). Extreme care 1473should be used when adjusting the volume size. 1474.Pp |
1462Though not recommended, a "sparse volume" (also known as "thin provisioning") | 1475Though not recommended, a "sparse volume" (also known as "thin provisioned") |
1463can be created by specifying the 1464.Fl s 1465option to the 1466.Qq Nm Cm create Fl V | 1476can be created by specifying the 1477.Fl s 1478option to the 1479.Qq Nm Cm create Fl V |
1467command, or by changing the reservation after the volume has been created. A 1468"sparse volume" is a volume where the reservation is less then the volume size. | 1480command, or by changing the value of the 1481.Sy refreservation 1482property, or 1483.Sy reservation 1484property on pool version 8 or earlier 1485.Pc 1486after the volume has been created. 1487A "sparse volume" is a volume where the value of 1488.Sy refreservation 1489is less then the size of the volume plus the space required to store its 1490metadata. |
1469Consequently, writes to a sparse volume can fail with 1470.Sy ENOSPC 1471when the pool is low on space. For a sparse volume, changes to 1472.Sy volsize | 1491Consequently, writes to a sparse volume can fail with 1492.Sy ENOSPC 1493when the pool is low on space. For a sparse volume, changes to 1494.Sy volsize |
1473are not reflected in the reservation. | 1495are not reflected in the 1496.Sy refreservation . 1497A volume that is not sparse is said to be "thick provisioned". 1498A sparse volume can become thick provisioned by setting 1499.Sy refreservation 1500to 1501.Sy auto . |
1474.It Sy volmode Ns = Ns Cm default | geom | dev | none 1475This property specifies how volumes should be exposed to the OS. 1476Setting it to 1477.Sy geom 1478exposes volumes as 1479.Xr geom 4 1480providers, providing maximal functionality. 1481Setting it to --- 2378 unchanged lines hidden --- | 1502.It Sy volmode Ns = Ns Cm default | geom | dev | none 1503This property specifies how volumes should be exposed to the OS. 1504Setting it to 1505.Sy geom 1506exposes volumes as 1507.Xr geom 4 1508providers, providing maximal functionality. 1509Setting it to --- 2378 unchanged lines hidden --- |