You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Samba will need to listen to \'localhost\' (127.0.0.1) for the zfs utilities to communitate
462
-
with samba. This is the default behavior for most Linux distributions.<br />
463
-
<br />
464
-
* Samba must be able to authenticate a user. This can be done in a number of ways, depending
465
-
on if using the system password file, LDAP or the Samba specific smbpasswd file. How to do
466
-
this is outside the scope of this manual. Please refer to the smb.conf(5) manpage for more
467
-
information.<br />
468
-
<br />
469
-
* See the USERSHARE section of the smb.conf(5) man page for all configuration options in
470
-
case you need to modify any options to the share afterwards. Do note that any changes done
471
-
with the \'net\' command will be undone if the share is every unshared (such as at a reboot
472
-
etc). In the future, ZoL will be able to set specific options directly using
473
-
sharesmb=<option>.',
474
-
475
-
'size'=>'Total size of the storage pool.',
476
-
477
-
'snapdir'=>'Controls whether the ".zfs" directory is hidden or visible in the
478
-
root of the file system as discussed in the "Snapshots" section.
479
-
The default value is "hidden".',
480
-
481
-
'snapdev'=>'Controls whether the snapshots devices of zvol\'s are hidden or visible. The default value is hidden.',
482
-
483
-
'snapshot_count'=>'The total number of snapshots that exist under this location in the
484
-
dataset tree. This value is only available when a snapshot_limit
485
-
has been set somewhere in the tree under which the dataset resides.',
486
-
487
-
'snapshot_limit'=>' Limits the number of snapshots that can be created on a dataset and
488
-
its descendents. Setting a snapshot_limit on a descendent of a
489
-
dataset that already has a snapshot_limit does not override the
490
-
ancestor\'s snapshot_limit, but rather imposes an additional limit.
491
-
The limit is not enforced if the user is allowed to change the
492
-
limit. For example, this means that recursive snapshots taken from
493
-
the global zone are counted against each delegated dataset within a
494
-
zone. This feature must be enabled to be used (see zpool-fea‐
495
-
tures(5)).',
496
330
497
331
'setuid'=>'Controls whether the set-UID bit is respected for the file system.
498
332
The default value is "on".',
499
333
500
-
'sync'=>'Controls the behavior of synchronous requests (e.g. fsync(2),
501
-
O_DSYNC). This property accepts the following values:
502
-
503
-
standard This is the POSIX specified behavior of ensuring all
504
-
synchronous requests are written to stable storage and
505
-
all devices are flushed to ensure data is not cached by
506
-
device controllers (this is the default).
507
-
508
-
always All file system transactions are written and flushed
509
-
before their system calls return. This has a large per-
510
-
formance penalty.
511
-
512
-
disabled Disables synchronous requests. File system transactions
513
-
are only committed to stable storage periodically. This
514
-
option will give the highest performance. However, it
515
-
is very dangerous as ZFS would be ignoring the synchro-
516
-
nous transaction demands of applications such as data-
517
-
bases or NFS. Administrators should only use this
518
-
option when the risks are understood.',
519
-
520
-
'type'=>'The type of dataset: filesystem, volume, or snapshot.',
521
-
522
-
'used'=>'The amount of space consumed by this dataset and all its descendents.
523
-
This is the value that is checked against this dataset\'s quota and
524
-
reservation. The space used does not include this dataset\'s reserva-
525
-
tion, but does take into account the reservations of any descendent
526
-
datasets. The amount of space that a dataset consumes from its par-
527
-
ent, as well as the amount of space that are freed if this dataset is
528
-
recursively destroyed, is the greater of its space used and its
529
-
reservation.<br />
530
-
<br />
531
-
When snapshots (see the "Snapshots" section) are created, their space
532
-
is initially shared between the snapshot and the file system, and
533
-
possibly with previous snapshots. As the file system changes, space
534
-
that was previously shared becomes unique to the snapshot, and
535
-
counted in the snapshot\'s space used. Additionally, deleting snap-
536
-
shots can increase the amount of space unique to (and used by) other
537
-
snapshots.<br />
538
-
<br />
539
-
The amount of space used, available, or referenced does not take into
540
-
account pending changes. Pending changes are generally accounted for
541
-
within a few seconds. Committing a change to a disk using fsync(2) or
542
-
O_SYNC does not necessarily guarantee that the space usage informa-
543
-
tion is updated immediately.',
544
-
545
-
'usedbychildren'=>'The amount of space used by children of this dataset, which would be
546
-
freed if all the dataset\'s children were destroyed.',
547
-
548
-
'usedbydataset'=>'The amount of space used by this dataset itself, which would be freed
549
-
if the dataset were destroyed (after first removing any
550
-
refreservation and destroying any necessary snapshots or descen-
551
-
dents).',
552
-
553
-
'usedbysnapshots'=>'The amount of space consumed by snapshots of this dataset. In partic-
554
-
ular, it is the amount of space that would be freed if all of this
555
-
dataset\'s snapshots were destroyed. Note that this is not simply the
556
-
sum of the snapshots\' used properties because space can be shared by
557
-
multiple snapshots.',
558
-
559
-
'usedbyrefreservation'=>'The amount of space used by a refreservation set on this dataset,
560
-
which would be freed if the refreservation was removed.',
561
-
562
-
'userrefs'=>'This property is set to the number of user holds on this snapshot. User holds are set by using the zfs hold command.
563
-
groupused@group
564
-
The amount of space consumed by the specified group in this dataset. Space is charged to the group of each file, as displayed by ls -l. See the userused@user property for more information.
565
-
Unprivileged users can only access their own groups\' space usage. The root user, or a user who has been granted the groupused privilege with zfs allow, can access all groups\' usage.',
566
-
567
-
'utf8only'=>'Indicates whether the file system should reject file names that
568
-
include characters that are not present in the UTF-8 character code
569
-
set. If this property is explicitly set to off, the normalization
570
-
property must either not be explicitly set or be set to none. The
571
-
default value for the utf8only property is off. This property can-
572
-
not be changed after the file system is created.',
573
-
574
-
'version'=>'The current on-disk version of the pool. This can be increased, but
575
-
never decreased. The preferred method of updating pools is with the
576
-
"zpool upgrade" command, though this property can be used when a spe-
577
-
cific version is needed for backwards compatibility. Once feature
578
-
flags is enabled on a pool this property will no longer have a value.',
579
-
580
-
'volblocksize'=>'For volumes, specifies the block size of the volume. The blocksize
581
-
cannot be changed once the volume has been written, so it should be
582
-
set at volume creation time. The default blocksize for volumes is 8
583
-
Kbytes. Any power of 2 from 512 bytes to 128 Kbytes is valid.
584
-
585
-
This property can also be referred to by its shortened column name,
586
-
volblock.',
587
334
588
-
'volsize'=>'For volumes, specifies the logical size of the volume. By default,
589
-
creating a volume establishes a reservation of equal size. For storage
590
-
pools with a version number of 9 or higher, a refreservation is
591
-
set instead. Any changes to volsize are reflected in an equivalent
592
-
change to the reservation (or refreservation). The volsize can only
593
-
be set to a multiple of volblocksize, and cannot be zero.
594
-
595
-
The reservation is kept equal to the volume\'s logical size to prevent
596
-
unexpected behavior for consumers. Without the reservation, the volume
597
-
could run out of space, resulting in undefined behavior or data
598
-
corruption, depending on how the volume is used. These effects can
599
-
also occur when the volume size is changed while it is in use (particularly
600
-
when shrinking the size). Extreme care should be used when
601
-
adjusting the volume size.
602
-
603
-
Though not recommended, a "sparse volume" (also known as "thin provisioning")
604
-
can be created by specifying the -s option to the "zfs
605
-
create -V" command, or by changing the reservation after the volume
606
-
has been created. A "sparse volume" is a volume where the reservation
607
-
is less then the volume size. Consequently, writes to a sparse volume
608
-
can fail with ENOSPC when the pool is low on space. For a sparse
609
-
volume, changes to volsize are not reflected in the reservation.',
610
-
611
335
'vscan'=>'Controls whether regular files should be scanned for viruses when a
612
336
file is opened and closed. In addition to enabling this property,
613
337
the virus scan service must also be enabled for virus scanning to
614
338
occur. The default value is "off".',
615
339
616
-
'written'=>'The amount of referenced space written to this dataset since the previous snapshot.',
617
-
618
-
'xattr'=>'Controls whether extended attributes are enabled for this file system. The default value is on.',
619
-
620
-
'zoned'=>'Controls whether the dataset is managed from a non-global zone. See
621
-
the "Zones" section for more information. The default value is
622
-
"off".<br /><br />
623
-
624
-
<h4>Zones</h4>
625
-
A ZFS file system can be added to a non-global zone by using zonecfg\'\s
626
-
"add fs" subcommand. A ZFS file system that is added to a non-global
627
-
zone must have its mountpoint property set to legacy.
628
-
629
-
The physical properties of an added file system are controlled by the
630
-
global administrator. However, the zone administrator can create, mod-
631
-
ify, or destroy files within the added file system, depending on how
632
-
the file system is mounted.
633
-
634
-
A dataset can also be delegated to a non-global zone by using zonecfg\'\s
635
-
"add dataset" subcommand. You cannot delegate a dataset to one zone and
636
-
the children of the same dataset to another zone. The zone administra-
637
-
tor can change properties of the dataset or any of its children. How-
638
-
ever, the "quota" property is controlled by the global administrator.
639
-
640
-
A ZFS volume can be added as a device to a non-global zone by using
641
-
zonecfg\'\s "add device" subcommand. However, its physical properties can
642
-
only be modified by the global administrator.
643
-
644
-
For more information about zonecfg syntax, see zonecfg(1M).
645
-
646
-
After a dataset is delegated to a non-global zone, the "zoned" property
647
-
is automatically set. A zoned file system cannot be mounted in the
648
-
global zone, since the zone administrator might have to set the mount
649
-
point to an unacceptable value.
650
-
651
-
The global administrator can forcibly clear the "zoned" property,
652
-
though this should be done with extreme care. The global administrator
653
-
should verify that all the mount points are acceptable before clearing
0 commit comments