Print this page
OS-1566 dataset quota for ZFS datasets

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/zfs.1m
          +++ new/usr/src/man/man1m/zfs.1m
↓ open down ↓ 393 lines elided ↑ open up ↑
 394  394  .LP
 395  395  The physical properties of an added file system are controlled by the global
 396  396  administrator. However, the zone administrator can create, modify, or destroy
 397  397  files within the added file system, depending on how the file system is
 398  398  mounted.
 399  399  .sp
 400  400  .LP
 401  401  A dataset can also be delegated to a non-global zone by using the \fBzonecfg\fR
 402  402  \fBadd dataset\fR subcommand. You cannot delegate a dataset to one zone and the
 403  403  children of the same dataset to another zone. The zone administrator can change
 404      -properties of the dataset or any of its children. However, the \fBquota\fR
 405      -property is controlled by the global administrator.
      404 +properties of the dataset or any of its children. However, the \fBquota\fR,
      405 +\fBdataset_quota\fR and \fBsnapshot_quota\fR properties are controlled by the
      406 +global administrator.
 406  407  .sp
 407  408  .LP
 408  409  A \fBZFS\fR volume can be added as a device to a non-global zone by using the
 409  410  \fBzonecfg\fR \fBadd device\fR subcommand. However, its physical properties can
 410  411  be modified only by the global administrator.
 411  412  .sp
 412  413  .LP
 413  414  For more information about \fBzonecfg\fR syntax, see \fBzonecfg\fR(1M).
 414  415  .sp
 415  416  .LP
↓ open down ↓ 523 lines elided ↑ open up ↑
 939  940  \fBused\fR property and counting against quotas and reservations.
 940  941  .sp
 941  942  Changing this property only affects newly-written data. Therefore, set this
 942  943  property at file system creation time by using the \fB-o\fR
 943  944  \fBcopies=\fR\fIN\fR option.
 944  945  .RE
 945  946  
 946  947  .sp
 947  948  .ne 2
 948  949  .na
      950 +\fB\fBdataset_quota\fR=\fIcount\fR | \fBnone\fR\fR
      951 +.ad
      952 +.sp .6
      953 +.RS 4n
      954 +Limits the number of datasets that can be created within a dataset and its
      955 +descendents. This property enforces a hard limit on the number of datasets
      956 +below the given dataset.  Setting a dataset_quota on a descendent of a dataset
      957 +that already has a dataset_quota does not override the ancestor's dataset_quota,
      958 +but rather imposes an additional limit. This feature must be enabled to be
      959 +used (see \fBzpool-features\fR(5)).
      960 +.RE
      961 +
      962 +.sp
      963 +.ne 2
      964 +.na
 949  965  \fB\fBdevices\fR=\fBon\fR | \fBoff\fR\fR
 950  966  .ad
 951  967  .sp .6
 952  968  .RS 4n
 953  969  Controls whether device nodes can be opened on this file system. The default
 954  970  value is \fBon\fR.
 955  971  .RE
 956  972  
 957  973  .sp
 958  974  .ne 2
↓ open down ↓ 65 lines elided ↑ open up ↑
1024 1040  quota on a descendent of a dataset that already has a quota does not override
1025 1041  the ancestor's quota, but rather imposes an additional limit.
1026 1042  .sp
1027 1043  Quotas cannot be set on volumes, as the \fBvolsize\fR property acts as an
1028 1044  implicit quota.
1029 1045  .RE
1030 1046  
1031 1047  .sp
1032 1048  .ne 2
1033 1049  .na
     1050 +\fB\fBsnapshot_quota\fR=\fIcount\fR | \fBnone\fR\fR
     1051 +.ad
     1052 +.sp .6
     1053 +.RS 4n
     1054 +Limits the number of snapshots that can be created on a dataset and its
     1055 +descendents. This property enforces a hard limit on the number of snapshots
     1056 +below the given dataset.  Setting a snapshot_quota on a descendent of a dataset
     1057 +that already has a snapshot_quota does not override the ancestor's
     1058 +snapshot_quota, but rather imposes an additional limit. The quota is not
     1059 +enforced for recursive snapshots taken from above the dataset with the quota,
     1060 +but that snapshot will be counted against the quota if the dataset is
     1061 +snapshotted directly.  This feature must be enabled to be used (see
     1062 +\fBzpool-features\fR(5)).
     1063 +.RE
     1064 +
     1065 +.sp
     1066 +.ne 2
     1067 +.na
1034 1068  \fB\fBuserquota@\fR\fIuser\fR=\fIsize\fR | \fBnone\fR\fR
1035 1069  .ad
1036 1070  .sp .6
1037 1071  .RS 4n
1038 1072  Limits the amount of space consumed by the specified user. User space
1039 1073  consumption is identified by the \fBuserspace@\fR\fIuser\fR property.
1040 1074  .sp
1041 1075  Enforcement of user quotas may be delayed by several seconds. This delay means
1042 1076  that a user might exceed their quota before the system notices that they are
1043 1077  over quota and begins to refuse additional writes with the \fBEDQUOT\fR error
↓ open down ↓ 2074 lines elided ↑ open up ↑
3118 3152  userused         other          Allows reading any userused@... property
3119 3153  
3120 3154  aclinherit       property
3121 3155  aclmode          property
3122 3156  atime            property
3123 3157  canmount         property
3124 3158  casesensitivity  property
3125 3159  checksum         property
3126 3160  compression      property
3127 3161  copies           property
     3162 +dataset_quota    property
3128 3163  devices          property
3129 3164  exec             property
3130 3165  mountpoint       property
3131 3166  nbmand           property
3132 3167  normalization    property
3133 3168  primarycache     property
3134 3169  quota            property
3135 3170  readonly         property
3136 3171  recordsize       property
3137 3172  refquota         property
3138 3173  refreservation   property
3139 3174  reservation      property
3140 3175  secondarycache   property
3141 3176  setuid           property
3142 3177  shareiscsi       property
3143 3178  sharenfs         property
3144 3179  sharesmb         property
3145 3180  snapdir          property
     3181 +snapshot_quota   property
3146 3182  utf8only         property
3147 3183  version          property
3148 3184  volblocksize     property
3149 3185  volsize          property
3150 3186  vscan            property
3151 3187  xattr            property
3152 3188  zoned            property
3153 3189  .fi
3154 3190  .in -2
3155 3191  .sp
↓ open down ↓ 834 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX