Lines Matching +full:access +full:- +full:ns

9 .\" or https://opensource.org/licenses/CDDL-1.0.
34 .\" Copyright (c) 2014-2015, The FreeBSD Foundation, All Rights Reserved.
38 .\" Copyright (c) 2019, Kjeld Schouten-Lebbing
47 .Nd native and user-defined properties of ZFS datasets
50 Properties are divided into two types, native properties and user-defined
56 In addition, native properties are either editable or read-only.
70 The values of numeric properties can be specified using human-readable suffixes
87 The values of non-numeric properties are case sensitive and must be lowercase,
94 The following native properties consist of read-only statistics about the
98 .Bl -tag -width "usedbyrefreservation"
109 For non-snapshots, the compression ratio achieved for the
122 .Nm zfs Cm set Sy compression Ns = Ns Sy on Ar dataset .
135 For snapshots, this property is a comma-separated list of filesystems or volumes
166 .Nm zfs Cm load-key
168 .Nm zfs Cm unload-key
175 .Xr zfs-load-key 8
191 .Nm zfs Cm load-key
193 .Nm zfs Cm unload-key .
258 For filesystems or volumes which have saved partially-completed state from
378 .It Sy userused Ns @ Ns Ar user
388 Unprivileged users can access only their own space usage.
393 can access everyone's usage.
396 .Sy userused Ns @ Ns Ar …
402 .Bl -bullet -compact -offset 4n
414 .Pq Qq S-1-123-456-789
418 .It Sy userobjused Ns @ Ns Ar user
429 .Sy xattr Ns = Ns Sy on
430 is set on a file system additional objects will be created per-file to store
437 .Sy xattr Ns = Ns Sy sa
444 .It Sy groupused Ns @ Ns Ar group
449 .Sy userused Ns @ Ns Ar user
452 Unprivileged users can only access their own groups' space usage.
457 can access all groups' usage.
458 .It Sy groupobjused Ns @ Ns Ar group
463 .Sy userobjused Ns @ Ns Ar user
466 Unprivileged users can only access their own groups' space usage.
471 can access all groups' usage.
472 .It Sy projectused Ns @ Ns Ar project
474 Project is identified via the project identifier (ID) that is object-based
493 .Sy userused Ns @ Ns Ar user
500 can access all projects' usage.
501 .It Sy projectobjused Ns @ Ns Ar project
508 .Sy xattr Ns = Ns Sy on
509 is set on a fileset, ZFS will create additional objects per-file to store
516 .Sy xattr Ns = Ns Sy sa
519 .Sy userobjused Ns @ Ns Ar user
526 can access all projects' objects usage.
555 .It Sy written Ns @ Ns Ar snapshot
571 .Pq Ar filesystem Ns @ Ns Ar snapshot ,
578 .Bl -tag -width ""
580 .Sy aclinherit Ns = Ns Sy discard Ns | Ns Sy noallow Ns | Ns
581 .Sy restricted Ns | Ns Sy passthrough Ns | Ns Sy passthrough-x
584 .Bl -tag -compact -offset 4n -width "passthrough-x"
599 .It Sy passthrough-x
618 .Sy aclmode Ns = Ns Sy discard Ns | Ns Sy groupmask Ns | Ns
619 .Sy passthrough Ns | Ns Sy restricted Ns
623 .Bl -tag -compact -offset 4n -width "passthrough"
644 a non-trivial ACL whose entries can not be represented by a mode.
650 on a file or directory with a non-trivial ACL when
656 .It Sy acltype Ns = Ns Sy off Ns | Ns Sy nfsv4 Ns | Ns Sy posix
661 .Bl -tag -compact -offset 4n -width "posixacl"
672 indicates that NFSv4-style ZFS ACLs should be used.
694 .Sy xattr Ns = Ns Sy sa
699 .Sy xattr Ns = Ns Sy sa
704 .It Sy atime Ns = Ns Sy on Ns | Ns Sy off
705 Controls whether the access time for files is updated when they are read.
723 .It Sy canmount Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy noauto
741 .Sy canmount Ns = Ns Sy off
759 .Sy checksum Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy fletcher2 Ns | Ns
760 .Sy fletcher4 Ns | Ns Sy sha256 Ns | Ns Sy noparity Ns | Ns
761 .Sy sha512 Ns | Ns Sy skein Ns | Ns Sy edonr Ns | Ns Sy blake3
777 This setting is used internally by a dump device residing on a RAID-Z pool and
792 .Xr zpool-features 7
795 Changing this property affects only newly-written data.
797 .Sy compression Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy gzip Ns | Ns
798 .Sy gzip- Ns Ar N Ns | Ns Sy lz4 Ns | Ns Sy lzjb Ns | Ns Sy zle Ns | Ns Sy zstd Ns | Ns
799 .Sy zstd- Ns Ar N Ns | Ns Sy zstd-fast Ns | Ns Sy zstd-fast- Ns Ar N
823 compression algorithm is a high-performance replacement for the
834 .Xr zpool-features 7
852 .Sy gzip- Ns Ar N ,
862 .Sy gzip-6
874 .Sy zstd- Ns Ar N ,
883 .Sy zstd-3 .
890 .Sy zstd-fast- Ns Ar N ,
894 .Bq Sy 1 Ns - Ns Sy 10 , 20 , 30 , No … , Sy 100 , 500 , 1000
901 .Sy zstd-fast
903 .Sy zstd-fast- Ns Ar 1 .
911 Changing this property affects only newly-written data.
917 When a zero-filled block is detected, it is stored as
921 .Pq chunks of 2^ Ns Sy ashift No bytes , e.g . Sy 512B No or Sy 4KB .
922 Compression may result in a non-sector-aligned size, which will be rounded up
929 .Sy recordsize Ns = Ns Sy 16K
939 .Sy context Ns = Ns Sy none Ns | Ns
940 .Ar SELinux-User : Ns Ar SELinux-Role : Ns Ar SELinux-Type : Ns Ar Sensitivity-Level
948 .Sy fscontext Ns = Ns Sy none Ns | Ns
949 .Ar SELinux-User : Ns Ar SELinux-Role : Ns Ar SELinux-Type : Ns Ar Sensitivity-Level
957 .Sy defcontext Ns = Ns Sy none Ns | Ns
958 .Ar SELinux-User : Ns Ar SELinux-Role : Ns Ar SELinux-Type : Ns Ar Sensitivity-Level
965 .Sy rootcontext Ns = Ns Sy none Ns | Ns
966 .Ar SELinux-User : Ns Ar SELinux-Role : Ns Ar SELinux-Type : Ns Ar Sensitivity-Level
972 .It Sy copies Ns = Ns Sy 1 Ns | Ns Sy 2 Ns | Ns Sy 3
975 example, mirroring or RAID-Z.
982 Changing this property only affects newly-written data.
984 .Fl o Sy copies Ns = Ns Ar N
987 Remember that ZFS will not import a pool with a missing top-level vdev.
990 create, for example a two-disk striped pool and set
991 .Sy copies Ns = Ns Ar 2
997 .Sy copies Ns = Ns Ar 3
1000 .It Sy devices Ns = Ns Sy on Ns | Ns Sy off
1014 .Sy dedup Ns = Ns Sy off Ns | Ns Sy on Ns | Ns Sy verify Ns | Ns
1015 .Sy sha256 Ns Oo , Ns Sy verify Oc Ns | Ns Sy sha512 Ns Oo , Ns Sy verify Oc Ns | Ns Sy skein Ns Oo , Ns Sy verify Oc Ns | Ns
1016 .Sy edonr , Ns Sy verify Ns | Ns Sy blake3 Ns Oo , Ns Sy verify Oc Ns
1032 .Sy sha256 , Ns Sy verify .
1036 ZFS will do a byte-to-byte comparison in case of two blocks having the same
1052 .Sy direct Ns = Ns Sy disabled Ns | Ns Sy standard Ns | Ns Sy always
1071 .Sy recordsize Ns
1072 -aligned, if not then the unaligned portion of the request will be silently
1077 All direct requests must use a page-aligned memory buffer and the request
1087 based file access then in order to maintain coherency all direct requests
1094 .Sy dnodesize Ns = Ns Sy legacy Ns | Ns Sy auto Ns | Ns Sy 1k Ns | Ns
1095 .Sy 2k Ns | Ns Sy 4k Ns | Ns Sy 8k Ns | Ns Sy 16k
1109 .Sy xattr Ns = Ns Sy sa
1112 may be applicable to SELinux-enabled systems, Lustre servers, and Samba
1130 .Sy encryption Ns = Ns Sy off Ns | Ns Sy on Ns | Ns Sy aes-128-ccm Ns | Ns
1131 .Sy aes-192-ccm Ns | Ns Sy aes-256-ccm Ns | Ns Sy aes-128-gcm Ns | Ns
1132 .Sy aes-192-gcm Ns | Ns Sy aes-256-gcm
1144 .Sy encryption Ns = Ns Sy on
1147 .Sy aes-256-gcm .
1154 .Xr zfs-load-key 8 .
1155 .It Sy keyformat Ns = Ns Sy raw Ns | Ns Sy hex Ns | Ns Sy passphrase
1162 .Dl # Nm dd Sy if=/dev/urandom bs=32 count=1 Sy of= Ns Pa /path/to/output/key
1170 .Nm zfs Cm change-key .
1172 .Sy keylocation Ns = Ns Sy prompt Ns | Ns Sy file:// Ns Ar /absolute/file/path Ns | Ns Sy https:// Ns Ar address Ns | Ns Sy http:// Ns Ar address
1176 .Nm zfs Cm load-key
1187 .Nm zfs Cm change-key .
1191 to access the encrypted data (see
1192 .Nm zfs Cm load-key
1202 libcurl, or nothing, depending on compile-time configuration and run-time
1218 .It Sy pbkdf2iters Ns = Ns Ar iterations
1238 .Nm zfs Cm change-key .
1239 .It Sy exec Ns = Ns Sy on Ns | Ns Sy off
1252 .It Sy volthreading Ns = Ns Sy on Ns | Ns Sy off
1264 .It Sy filesystem_limit Ns = Ns Ar count Ns | Ns Sy none
1279 .Xr zpool-features 7
1281 .It Sy special_small_blocks Ns = Ns Ar size
1296 .It Sy mountpoint Ns = Ns Pa path Ns | Ns Sy none Ns | Ns Sy legacy
1327 .It Sy nbmand Ns = Ns Sy on Ns | Ns Sy off
1330 .Pq Non-blocking mandatory locks .
1337 .It Sy overlay Ns = Ns Sy on Ns | Ns Sy off
1349 .It Sy primarycache Ns = Ns Sy all Ns | Ns Sy none Ns | Ns Sy metadata
1363 .It Sy quota Ns = Ns Ar size Ns | Ns Sy none
1374 .It Sy snapshot_limit Ns = Ns Ar count Ns | Ns Sy none
1389 .Xr zpool-features 7
1391 .It Sy userquota@ Ns Ar user Ns = Ns Ar size Ns | Ns Sy none
1394 .Sy userspace@ Ns Ar user
1406 Unprivileged users can only access their own groups' space usage.
1416 .Sy userquota@ Ns Ar …
1422 .Bl -bullet -compact -offset 4n
1434 .Pq Qq S-1-123-456-789
1438 .It Sy userobjquota@ Ns Ar user Ns = Ns Ar size Ns | Ns Sy none
1447 .It Sy groupquota@ Ns Ar group Ns = Ns Ar size Ns | Ns Sy none
1450 .Sy groupused@ Ns Ar group
1453 Unprivileged users can access only their own groups' space usage.
1459 .It Sy groupobjquota@ Ns Ar group Ns = Ns Ar size Ns | Ns Sy none
1468 .It Sy projectquota@ Ns Ar project Ns = Ns Ar size Ns | Ns Sy none
1471 .Sy projectused@ Ns Ar project
1481 can access all projects' quota.
1482 .It Sy projectobjquota@ Ns Ar project Ns = Ns Ar size Ns | Ns Sy none
1491 .It Sy readonly Ns = Ns Sy on Ns | Ns Sy off
1507 .It Sy recordsize Ns = Ns Ar size
1509 This property is designed solely for use with database workloads that access
1510 files in fixed-size records.
1512 for typical access patterns.
1514 For databases that create very large files but access them in small random
1532 .Xr zpool-features 7
1552 .It Sy redundant_metadata Ns = Ns Sy all Ns | Ns Sy most Ns | Ns Sy some Ns | Ns Sy none
1557 .Pq e.g. by mirroring or RAID-Z ,
1563 .Sy copies Ns = Ns 2 ,
1565 .Sy redundant_metadata Ns = Ns Sy most ,
1572 If a single on-disk block is corrupt, at worst a single block of user data
1589 of user data can be lost if a single on-disk block is corrupt.
1598 If a single on-disk block is corrupt, at worst a single user file can be lost.
1603 If a single on-disk block is corrupt, an entire dataset can be lost.
1607 .It Sy refquota Ns = Ns Ar size Ns | Ns Sy none
1612 .It Sy refreservation Ns = Ns Ar size Ns | Ns Sy none Ns | Ns Sy auto
1638 .Sy refreservation Ns = Ns Sy auto
1648 .It Sy relatime Ns = Ns Sy on Ns | Ns Sy off
1649 Controls the manner in which the access time is updated when
1650 .Sy atime Ns = Ns Sy on
1652 Turning this property on causes the access time to be updated relative
1654 Access time is only updated if the previous
1655 access time was earlier than the current modify or change time or if the
1656 existing access time hasn't been updated within the past 24 hours.
1668 .It Sy reservation Ns = Ns Ar size Ns | Ns Sy none
1677 .It Sy secondarycache Ns = Ns Sy all Ns | Ns Sy none Ns | Ns Sy metadata
1691 .It Sy prefetch Ns = Ns Sy all Ns | Ns Sy none Ns | Ns Sy metadata
1708 .It Sy setuid Ns = Ns Sy on Ns | Ns Sy off
1721 .It Sy sharesmb Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Ar opts
1749 The share is created with the ACL (Access Control List) "Everyone:F" ("F"
1751 access (which means Samba must be able to authenticate a real user \(em
1752 .Xr passwd 5 Ns / Ns Xr shadow 5 Ns - ,
1753 LDAP- or
1754 .Xr smbpasswd 5 Ns -based )
1756 This means that any additional access control
1757 (disallow specific user specific access etc) must be done on the underlying file
1766 .It Sy sharenfs Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Ar opts
1788 Please note that the options are comma-separated, unlike those found in
1815 property are re-shared with the new options, only if the property was previously
1828 .It Sy logbias Ns = Ns Sy latency Ns | Ns Sy throughput
1845 .It Sy snapdev Ns = Ns Sy hidden Ns | Ns Sy visible
1847 .Pa /dev/zvol/ Ns Aq Ar pool
1851 .It Sy snapdir Ns = Ns Sy disabled Ns | Ns Sy hidden Ns | Ns Sy visible
1861 .It Sy sync Ns = Ns Sy standard Ns | Ns Sy always Ns | Ns Sy disabled
1865 is the POSIX-specified behavior of ensuring all synchronous requests
1880 .It Sy version Ns = Ns Ar N Ns | Ns Sy current
1881 The on-disk version of this file system, which is independent of the pool
1887 .It Sy volsize Ns = Ns Ar size
1947 .It Sy volmode Ns = Ns Sy default Ns | Ns Sy full Ns | Ns Sy geom Ns | Ns Sy dev Ns | Ns Sy none
1967 means that volumes exposition is controlled by system-wide tunable
1977 .It Sy vscan Ns = Ns Sy on Ns | Ns Sy off
1985 .It Sy xattr Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy dir Ns | Ns Sy sa
1987 Two styles of extended attributes are supported: either directory-based
1988 or system-attribute-based.
1990 Directory-based extended attributes can be enabled by setting the value to
2003 System-attribute-based xattrs can be enabled by setting the value to
2013 of data may be stored per-file in the space reserved for system attributes.
2015 then it will be automatically written as a directory-based xattr.
2016 System-attribute-based extended attributes are not accessible
2018 .Sy xattr Ns = Ns Sy sa
2021 .Sy xattr Ns = Ns Sy sa
2026 The use of system-attribute-based xattrs is strongly encouraged for users of
2029 attributes and benefit significantly from the reduced access time.
2040 .It Sy jailed Ns = Ns Sy off Ns | Ns Sy on
2043 .Xr zfs-jail 8
2048 .It Sy zoned Ns = Ns Sy off Ns | Ns Sy on
2049 Controls whether the dataset is managed from a non-global zone or namespace.
2051 .Xr zfs-zone 8
2068 .Bl -tag -width ""
2070 .Sy casesensitivity Ns = Ns Sy sensitive Ns | Ns
2071 .Sy insensitive Ns | Ns Sy mixed
2074 should be case-sensitive, case-insensitive, or allow a combination of both
2082 and POSIX file systems have case-sensitive file names.
2089 case-sensitive and case-insensitive matching behavior.
2090 Currently, case-insensitive matching behavior on a file system that supports
2096 .Sy normalization Ns = Ns Sy none Ns | Ns Sy formC Ns | Ns
2097 .Sy formD Ns | Ns Sy formKC Ns | Ns Sy formKD
2118 .It Sy utf8only Ns = Ns Sy on Ns | Ns Sy off
2121 .Sy UTF-8
2139 properties are also new permissions that can be assigned to non-privileged users
2150 .Bl -tag -compact -offset Ds -width "rootcontext="
2169 .It Sy context Ns =
2171 .It Sy fscontext Ns =
2173 .It Sy defcontext Ns =
2175 .It Sy rootcontext Ns =
2179 In addition, these options can be set on a per-mount basis using the
2187 .Sy nodevices , Ns Sy nosetuid .
2210 .Pq Qq Sy - ,
2217 .Ar module : Ns Ar property ,
2220 .Pq Qq Sy - .
2226 independently-developed packages use the same property name for different