zfs.8 (241614) | zfs.8 (243674) |
---|---|
1'\" te 2.\" Copyright (c) 2012, 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.\" --- 9 unchanged lines hidden (view full) --- 18.\" information: Portions Copyright [yyyy] [name of copyright owner] 19.\" 20.\" Copyright (c) 2010, Sun Microsystems, Inc. All Rights Reserved. 21.\" Copyright (c) 2012 by Delphix. All rights reserved. 22.\" Copyright (c) 2012 Nexenta Systems, Inc. All Rights Reserved. 23.\" Copyright (c) 2012, Joyent, Inc. All rights reserved. 24.\" Copyright (c) 2011, Pawel Jakub Dawidek <pjd@FreeBSD.org> 25.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org> | 1'\" te 2.\" Copyright (c) 2012, 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.\" --- 9 unchanged lines hidden (view full) --- 18.\" information: Portions Copyright [yyyy] [name of copyright owner] 19.\" 20.\" Copyright (c) 2010, Sun Microsystems, Inc. All Rights Reserved. 21.\" Copyright (c) 2012 by Delphix. All rights reserved. 22.\" Copyright (c) 2012 Nexenta Systems, Inc. All Rights Reserved. 23.\" Copyright (c) 2012, Joyent, Inc. All rights reserved. 24.\" Copyright (c) 2011, Pawel Jakub Dawidek <pjd@FreeBSD.org> 25.\" Copyright (c) 2012, Bryan Drewery <bdrewery@FreeBSD.org> |
26.\" Copyright (c) 2012, Glen Barber <gjb@FreeBSD.org> |
|
26.\" | 27.\" |
27.\" $FreeBSD: stable/9/cddl/contrib/opensolaris/cmd/zfs/zfs.8 241614 2012-10-16 19:58:15Z mm $ | 28.\" $FreeBSD: stable/9/cddl/contrib/opensolaris/cmd/zfs/zfs.8 243674 2012-11-29 14:05:04Z mm $ |
28.\" 29.Dd September 5, 2012 30.Dt ZFS 8 31.Os 32.Sh NAME 33.Nm zfs 34.Nd configures ZFS file systems 35.Sh SYNOPSIS --- 16 unchanged lines hidden (view full) --- 52.Cm destroy 53.Op Fl fnpRrv 54.Ar filesystem Ns | Ns Ar volume 55.Nm 56.Cm destroy 57.Op Fl dnpRrv 58.Sm off 59.Ar snapshot | 29.\" 30.Dd September 5, 2012 31.Dt ZFS 8 32.Os 33.Sh NAME 34.Nm zfs 35.Nd configures ZFS file systems 36.Sh SYNOPSIS --- 16 unchanged lines hidden (view full) --- 53.Cm destroy 54.Op Fl fnpRrv 55.Ar filesystem Ns | Ns Ar volume 56.Nm 57.Cm destroy 58.Op Fl dnpRrv 59.Sm off 60.Ar snapshot |
60.Ns Op % Ns Ar snapname 61.Ns Op , Ns Ar ... | 61.Op % Ns Ar snapname 62.Op , Ns Ar ... |
62.Sm on 63.Nm 64.Cm snapshot 65.Op Fl r 66.Op Fl o Ar property Ns = Ns Ar value 67.Ar ... filesystem@snapname Ns | Ns Ar volume@snapname 68.Nm 69.Cm rollback --- 61 unchanged lines hidden (view full) --- 131.Op Fl v 132.Nm 133.Cm upgrade 134.Op Fl r 135.Op Fl V Ar version 136.Fl a | Ar filesystem 137.Nm 138.Cm userspace | 63.Sm on 64.Nm 65.Cm snapshot 66.Op Fl r 67.Op Fl o Ar property Ns = Ns Ar value 68.Ar ... filesystem@snapname Ns | Ns Ar volume@snapname 69.Nm 70.Cm rollback --- 61 unchanged lines hidden (view full) --- 132.Op Fl v 133.Nm 134.Cm upgrade 135.Op Fl r 136.Op Fl V Ar version 137.Fl a | Ar filesystem 138.Nm 139.Cm userspace |
139.Op Fl niHp | 140.Op Fl Hinp |
140.Op Fl o Ar field Ns Op , Ns Ar ... | 141.Op Fl o Ar field Ns Op , Ns Ar ... |
141.Op Fl sS Ar field | 142.Op Fl s Ar field |
142.Ar ... | 143.Ar ... |
144.Op Fl S Ar field 145.Ar ... |
|
143.Op Fl t Ar type Ns Op , Ns Ar ... 144.Ar filesystem Ns | Ns Ar snapshot 145.Nm 146.Cm groupspace | 146.Op Fl t Ar type Ns Op , Ns Ar ... 147.Ar filesystem Ns | Ns Ar snapshot 148.Nm 149.Cm groupspace |
147.Op Fl niHp | 150.Op Fl Hinp |
148.Op Fl o Ar field Ns Op , Ns Ar ... | 151.Op Fl o Ar field Ns Op , Ns Ar ... |
149.Op Fl sS Ar field | 152.Op Fl s Ar field |
150.Ar ... | 153.Ar ... |
154.Op Fl S Ar field 155.Ar ... |
|
151.Op Fl t Ar type Ns Op , Ns Ar ... 152.Ar filesystem Ns | Ns Ar snapshot 153.Nm 154.Cm mount 155.Nm 156.Cm mount 157.Op Fl vO 158.Op Fl o Ar property Ns Op , Ns Ar ... --- 455 unchanged lines hidden (view full) --- 614.Pp 615Unprivileged users can access only their own space usage. The root user, or a 616user who has been granted the 617.Sy userused 618privilege with 619.Qq Nm Cm allow , 620can access everyone's usage. 621.Pp | 156.Op Fl t Ar type Ns Op , Ns Ar ... 157.Ar filesystem Ns | Ns Ar snapshot 158.Nm 159.Cm mount 160.Nm 161.Cm mount 162.Op Fl vO 163.Op Fl o Ar property Ns Op , Ns Ar ... --- 455 unchanged lines hidden (view full) --- 619.Pp 620Unprivileged users can access only their own space usage. The root user, or a 621user who has been granted the 622.Sy userused 623privilege with 624.Qq Nm Cm allow , 625can access everyone's usage. 626.Pp |
622The | 627The |
623.Sy userused@ Ns ... 624properties are not displayed by 625.Qq Nm Cm get all . 626The user's name must be appended after the 627.Sy @ 628symbol, using one of the following forms: 629.Bl -bullet -offset 2n 630.It --- 183 unchanged lines hidden (view full) --- 814dataset is not mounted automatically when the dataset is created or imported, 815nor is it mounted by the 816.Qq Nm Cm mount Fl a 817command or unmounted by the 818.Qq Nm Cm umount Fl a 819command. 820.Pp 821This property is not inherited. | 628.Sy userused@ Ns ... 629properties are not displayed by 630.Qq Nm Cm get all . 631The user's name must be appended after the 632.Sy @ 633symbol, using one of the following forms: 634.Bl -bullet -offset 2n 635.It --- 183 unchanged lines hidden (view full) --- 819dataset is not mounted automatically when the dataset is created or imported, 820nor is it mounted by the 821.Qq Nm Cm mount Fl a 822command or unmounted by the 823.Qq Nm Cm umount Fl a 824command. 825.Pp 826This property is not inherited. |
822.It Sy checksum Ns = Ns Cm on | off | fletcher2 | fletcher4 | 827.It Sy checksum Ns = Ns Cm on | off | fletcher2 | fletcher4 | sha256 |
823Controls the checksum used to verify data integrity. The default value is 824.Cm on , 825which automatically selects an appropriate algorithm (currently, 826.Cm fletcher4 , 827but this may change in future releases). The value 828.Cm off 829disables integrity checking on user data. Disabling checksums is 830.Em NOT --- 293 unchanged lines hidden (view full) --- 1124is set to 1125.Cm throughput , 1126.Tn ZFS 1127will not use configured pool log devices. 1128.Tn ZFS 1129will instead optimize synchronous operations for global pool throughput and 1130efficient use of resources. 1131.It Sy snapdir Ns = Ns Cm hidden | visible | 828Controls the checksum used to verify data integrity. The default value is 829.Cm on , 830which automatically selects an appropriate algorithm (currently, 831.Cm fletcher4 , 832but this may change in future releases). The value 833.Cm off 834disables integrity checking on user data. Disabling checksums is 835.Em NOT --- 293 unchanged lines hidden (view full) --- 1129is set to 1130.Cm throughput , 1131.Tn ZFS 1132will not use configured pool log devices. 1133.Tn ZFS 1134will instead optimize synchronous operations for global pool throughput and 1135efficient use of resources. 1136.It Sy snapdir Ns = Ns Cm hidden | visible |
1132Controls whether the | 1137Controls whether the |
1133.Pa \&.zfs 1134directory is hidden or visible in the root of the file system as discussed in 1135the 1136.Qq Sx Snapshots 1137section. The default value is 1138.Cm hidden . 1139.It Sy sync Ns = Ns Cm standard | always | disabled 1140Controls the behavior of synchronous requests (e.g. --- 50 unchanged lines hidden (view full) --- 1191.Sy ENOSPC 1192when the pool is low on space. For a sparse volume, changes to 1193.Sy volsize 1194are not reflected in the reservation. 1195.It Sy vscan Ns = Ns Cm off | on 1196The 1197.Sy vscan 1198property is currently not supported on | 1138.Pa \&.zfs 1139directory is hidden or visible in the root of the file system as discussed in 1140the 1141.Qq Sx Snapshots 1142section. The default value is 1143.Cm hidden . 1144.It Sy sync Ns = Ns Cm standard | always | disabled 1145Controls the behavior of synchronous requests (e.g. --- 50 unchanged lines hidden (view full) --- 1196.Sy ENOSPC 1197when the pool is low on space. For a sparse volume, changes to 1198.Sy volsize 1199are not reflected in the reservation. 1200.It Sy vscan Ns = Ns Cm off | on 1201The 1202.Sy vscan 1203property is currently not supported on |
1199.Fx . | 1204.Fx . |
1200.It Sy xattr Ns = Ns Cm off | on 1201The 1202.Sy xattr 1203property is currently not supported on 1204.Fx . 1205.It Sy jailed Ns = Ns Cm off | on 1206Controls whether the dataset is managed from a jail. See the 1207.Qq Sx Jails --- 70 unchanged lines hidden (view full) --- 1278.It exec exec/noexec 1279.It readonly ro/rw 1280.It setuid suid/nosuid 1281.El 1282.Pp 1283In addition, these options can be set on a per-mount basis using the 1284.Fl o 1285option, without affecting the property that is stored on disk. The values | 1205.It Sy xattr Ns = Ns Cm off | on 1206The 1207.Sy xattr 1208property is currently not supported on 1209.Fx . 1210.It Sy jailed Ns = Ns Cm off | on 1211Controls whether the dataset is managed from a jail. See the 1212.Qq Sx Jails --- 70 unchanged lines hidden (view full) --- 1283.It exec exec/noexec 1284.It readonly ro/rw 1285.It setuid suid/nosuid 1286.El 1287.Pp 1288In addition, these options can be set on a per-mount basis using the 1289.Fl o 1290option, without affecting the property that is stored on disk. The values |
1286specified on the command line override the values stored in the dataset. These | 1291specified on the command line override the values stored in the dataset. These |
1287properties are reported as "temporary" by the 1288.Qq Nm Cm get 1289command. If the properties are changed while the dataset is mounted, the new 1290setting overrides any temporary settings. 1291.Ss User Properties 1292In addition to the standard native properties, 1293.Tn ZFS 1294supports arbitrary user properties. User properties have no effect on --- 22 unchanged lines hidden (view full) --- 1317.Pp 1318When making programmatic use of user properties, it is strongly suggested to 1319use a reversed 1320.Tn DNS 1321domain name for the 1322.Ar module 1323component of property names to reduce the chance that two 1324independently-developed packages use the same property name for different | 1292properties are reported as "temporary" by the 1293.Qq Nm Cm get 1294command. If the properties are changed while the dataset is mounted, the new 1295setting overrides any temporary settings. 1296.Ss User Properties 1297In addition to the standard native properties, 1298.Tn ZFS 1299supports arbitrary user properties. User properties have no effect on --- 22 unchanged lines hidden (view full) --- 1322.Pp 1323When making programmatic use of user properties, it is strongly suggested to 1324use a reversed 1325.Tn DNS 1326domain name for the 1327.Ar module 1328component of property names to reduce the chance that two 1329independently-developed packages use the same property name for different |
1325purposes. Property names beginning with | 1330purposes. Property names beginning with |
1326.Em com.sun 1327are reserved for use by Sun Microsystems. 1328.Pp 1329The values of user properties are arbitrary strings, are always inherited, and 1330are never validated. All of the commands that operate on properties 1331.Po 1332.Qq Nm Cm list , 1333.Qq Nm Cm get , --- 150 unchanged lines hidden (view full) --- 1484options, as they can destroy large portions of a pool and cause unexpected 1485behavior for mounted file systems in use. 1486.It Xo 1487.Nm 1488.Cm destroy 1489.Op Fl dnpRrv 1490.Sm off 1491.Ar snapshot | 1331.Em com.sun 1332are reserved for use by Sun Microsystems. 1333.Pp 1334The values of user properties are arbitrary strings, are always inherited, and 1335are never validated. All of the commands that operate on properties 1336.Po 1337.Qq Nm Cm list , 1338.Qq Nm Cm get , --- 150 unchanged lines hidden (view full) --- 1489options, as they can destroy large portions of a pool and cause unexpected 1490behavior for mounted file systems in use. 1491.It Xo 1492.Nm 1493.Cm destroy 1494.Op Fl dnpRrv 1495.Sm off 1496.Ar snapshot |
1492.Ns Op % Ns Ar snapname 1493.Ns Op , Ns Ar ... | 1497.Op % Ns Ar snapname 1498.Op , Ns Ar ... |
1494.Sm on 1495.Xc 1496.Pp 1497The given snapshots are destroyed immediately if and only if the 1498.Qq Nm Cm destroy 1499command without the 1500.Fl d 1501option would have destroyed it. Such immediate destruction would occur, for --- 471 unchanged lines hidden (view full) --- 1973.It Fl a 1974Upgrade all file systems on all imported pools. 1975.It Ar filesystem 1976Upgrade the specified file system. 1977.El 1978.It Xo 1979.Nm 1980.Cm userspace | 1499.Sm on 1500.Xc 1501.Pp 1502The given snapshots are destroyed immediately if and only if the 1503.Qq Nm Cm destroy 1504command without the 1505.Fl d 1506option would have destroyed it. Such immediate destruction would occur, for --- 471 unchanged lines hidden (view full) --- 1978.It Fl a 1979Upgrade all file systems on all imported pools. 1980.It Ar filesystem 1981Upgrade the specified file system. 1982.El 1983.It Xo 1984.Nm 1985.Cm userspace |
1981.Op Fl niHp | 1986.Op Fl Hinp |
1982.Op Fl o Ar field Ns Op , Ns Ar ... | 1987.Op Fl o Ar field Ns Op , Ns Ar ... |
1983.Op Fl sS Ar field | 1988.Op Fl s Ar field |
1984.Ar ... | 1989.Ar ... |
1990.Op Fl S Ar field 1991.Ar ... |
|
1985.Op Fl t Ar type Ns Op , Ns Ar ... 1986.Ar filesystem Ns | Ns Ar snapshot 1987.Xc 1988.Pp 1989Displays space consumed by, and quotas on, each user in the specified 1990filesystem or snapshot. This corresponds to the 1991.Sy userused@ Ns Ar user 1992and 1993.Sy userquota@ Ns Ar user 1994properties. 1995.Bl -tag -width indent 1996.It Fl n 1997Print numeric ID instead of user/group name. 1998.It Fl H 1999Do not print headers, use tab-delimited output. 2000.It Fl p | 1992.Op Fl t Ar type Ns Op , Ns Ar ... 1993.Ar filesystem Ns | Ns Ar snapshot 1994.Xc 1995.Pp 1996Displays space consumed by, and quotas on, each user in the specified 1997filesystem or snapshot. This corresponds to the 1998.Sy userused@ Ns Ar user 1999and 2000.Sy userquota@ Ns Ar user 2001properties. 2002.Bl -tag -width indent 2003.It Fl n 2004Print numeric ID instead of user/group name. 2005.It Fl H 2006Do not print headers, use tab-delimited output. 2007.It Fl p |
2001Use exact (parseable) numeric output. | 2008Use exact (parsable) numeric output. |
2002.It Fl o Ar field Ns Op , Ns Ar ... | 2009.It Fl o Ar field Ns Op , Ns Ar ... |
2003Display only the specified fields from the following set, | 2010Display only the specified fields from the following set: |
2004.Sy type,name,used,quota . 2005The default is to display all fields. 2006.It Fl s Ar field 2007Sort output by this field. The 2008.Fl s 2009and 2010.Fl S 2011flags may be specified multiple times to sort first by one field, then by 2012another. The default is 2013.Fl s Cm type Fl s Cm name . 2014.It Fl S Ar field 2015Sort by this field in reverse order. See 2016.Fl s . 2017.It Fl t Ar type Ns Op , Ns Ar ... | 2011.Sy type,name,used,quota . 2012The default is to display all fields. 2013.It Fl s Ar field 2014Sort output by this field. The 2015.Fl s 2016and 2017.Fl S 2018flags may be specified multiple times to sort first by one field, then by 2019another. The default is 2020.Fl s Cm type Fl s Cm name . 2021.It Fl S Ar field 2022Sort by this field in reverse order. See 2023.Fl s . 2024.It Fl t Ar type Ns Op , Ns Ar ... |
2018Print only the specified types from the following set, | 2025Print only the specified types from the following set: |
2019.Sy all,posixuser,smbuser,posixgroup,smbgroup . 2020.Pp 2021The default is 2022.Fl t Cm posixuser,smbuser . 2023.Pp 2024The default can be changed to include group types. 2025.It Fl i 2026Translate SID to POSIX ID. This flag currently has no effect on 2027.Fx . 2028.El 2029.It Xo 2030.Nm 2031.Cm groupspace | 2026.Sy all,posixuser,smbuser,posixgroup,smbgroup . 2027.Pp 2028The default is 2029.Fl t Cm posixuser,smbuser . 2030.Pp 2031The default can be changed to include group types. 2032.It Fl i 2033Translate SID to POSIX ID. This flag currently has no effect on 2034.Fx . 2035.El 2036.It Xo 2037.Nm 2038.Cm groupspace |
2032.Op Fl niHp | 2039.Op Fl Hinp |
2033.Op Fl o Ar field Ns Op , Ns Ar ... | 2040.Op Fl o Ar field Ns Op , Ns Ar ... |
2034.Op Fl sS Ar field | 2041.Op Fl s Ar field |
2035.Ar ... | 2042.Ar ... |
2043.Op Fl S Ar field 2044.Ar ... |
|
2036.Op Fl t Ar type Ns Op , Ns Ar ... 2037.Ar filesystem Ns | Ns Ar snapshot 2038.Xc 2039.Pp 2040Displays space consumed by, and quotas on, each group in the specified 2041filesystem or snapshot. This subcommand is identical to 2042.Qq Nm Cm userspace , 2043except that the default types to display are --- 160 unchanged lines hidden (view full) --- 2204.Fl i Ar snapshot ) 2205can be specified as the last component of the snapshot name (for example, the 2206part after the 2207.Sy @ ) , 2208and it is assumed to be from the same file system as the last 2209.Ar snapshot . 2210.Pp 2211If the destination is a clone, the source may be the origin snapshot, which | 2045.Op Fl t Ar type Ns Op , Ns Ar ... 2046.Ar filesystem Ns | Ns Ar snapshot 2047.Xc 2048.Pp 2049Displays space consumed by, and quotas on, each group in the specified 2050filesystem or snapshot. This subcommand is identical to 2051.Qq Nm Cm userspace , 2052except that the default types to display are --- 160 unchanged lines hidden (view full) --- 2213.Fl i Ar snapshot ) 2214can be specified as the last component of the snapshot name (for example, the 2215part after the 2216.Sy @ ) , 2217and it is assumed to be from the same file system as the last 2218.Ar snapshot . 2219.Pp 2220If the destination is a clone, the source may be the origin snapshot, which |
2212must be fully specified (for example, | 2221must be fully specified (for example, |
2213.Cm pool/fs@origin , 2214not just 2215.Cm @origin ) . 2216.It Fl I Ar snapshot 2217Generate a stream package that sends all intermediary snapshots from the 2218.Fl I Ar snapshot 2219to the last 2220.Ar snapshot . --- 232 unchanged lines hidden (view full) --- 2453.Pp 2454Permissions are generally the ability to use a 2455.Tn ZFS 2456subcommand or change a 2457.Tn ZFS 2458property. The following permissions are available: 2459.Bl -column -offset 4n "secondarycache" "subcommand" 2460.It NAME Ta TYPE Ta NOTES | 2222.Cm pool/fs@origin , 2223not just 2224.Cm @origin ) . 2225.It Fl I Ar snapshot 2226Generate a stream package that sends all intermediary snapshots from the 2227.Fl I Ar snapshot 2228to the last 2229.Ar snapshot . --- 232 unchanged lines hidden (view full) --- 2462.Pp 2463Permissions are generally the ability to use a 2464.Tn ZFS 2465subcommand or change a 2466.Tn ZFS 2467property. The following permissions are available: 2468.Bl -column -offset 4n "secondarycache" "subcommand" 2469.It NAME Ta TYPE Ta NOTES |
2461.It Xo allow Ta subcommand Ta Must | 2470.It allow Ta subcommand Ta Must Xo |
2462also have the permission that is being allowed 2463.Xc | 2471also have the permission that is being allowed 2472.Xc |
2464.It Xo clone Ta subcommand Ta Must | 2473.It clone Ta subcommand Ta Must Xo |
2465also have the 'create' ability and 'mount' ability in the origin file system 2466.Xc 2467.It create Ta subcommand Ta Must also have the 'mount' ability 2468.It destroy Ta subcommand Ta Must also have the 'mount' ability | 2474also have the 'create' ability and 'mount' ability in the origin file system 2475.Xc 2476.It create Ta subcommand Ta Must also have the 'mount' ability 2477.It destroy Ta subcommand Ta Must also have the 'mount' ability |
2478.It diff Ta subcommand Ta Allows lookup of paths within a dataset given an 2479object number, and the ability to create snapshots necessary to 'zfs diff' |
|
2469.It hold Ta subcommand Ta Allows adding a user hold to a snapshot 2470.It mount Ta subcommand Ta Allows mount/umount of Tn ZFS No datasets | 2480.It hold Ta subcommand Ta Allows adding a user hold to a snapshot 2481.It mount Ta subcommand Ta Allows mount/umount of Tn ZFS No datasets |
2471.It Xo promote Ta subcommand Ta Must | 2482.It promote Ta subcommand Ta Must Xo |
2472also have the 'mount' and 'promote' ability in the origin file system 2473.Xc 2474.It receive Ta subcommand Ta Must also have the 'mount' and 'create' ability | 2483also have the 'mount' and 'promote' ability in the origin file system 2484.Xc 2485.It receive Ta subcommand Ta Must also have the 'mount' and 'create' ability |
2475.It Xo release Ta subcommand Ta Allows | 2486.It release Ta subcommand Ta Allows Xo |
2476releasing a user hold which might destroy the snapshot 2477.Xc | 2487releasing a user hold which might destroy the snapshot 2488.Xc |
2478.It Xo rename Ta subcommand Ta Must | 2489.It rename Ta subcommand Ta Must Xo |
2479also have the 'mount' and 'create' ability in the new parent 2480.Xc 2481.It rollback Ta subcommand Ta Must also have the 'mount' ability 2482.It send Ta subcommand 2483.It share Ta subcommand Ta Allows Xo 2484sharing file systems over the 2485.Tn NFS 2486protocol 2487.Xc 2488.It snapshot Ta subcommand Ta Must also have the 'mount' ability 2489.It groupquota Ta other Ta Allows accessing any groupquota@... property 2490.It groupused Ta other Ta Allows reading any groupused@... property 2491.It userprop Ta other Ta Allows changing any user property 2492.It userquota Ta other Ta Allows accessing any userquota@... property 2493.It userused Ta other Ta Allows reading any userused@... property | 2490also have the 'mount' and 'create' ability in the new parent 2491.Xc 2492.It rollback Ta subcommand Ta Must also have the 'mount' ability 2493.It send Ta subcommand 2494.It share Ta subcommand Ta Allows Xo 2495sharing file systems over the 2496.Tn NFS 2497protocol 2498.Xc 2499.It snapshot Ta subcommand Ta Must also have the 'mount' ability 2500.It groupquota Ta other Ta Allows accessing any groupquota@... property 2501.It groupused Ta other Ta Allows reading any groupused@... property 2502.It userprop Ta other Ta Allows changing any user property 2503.It userquota Ta other Ta Allows accessing any userquota@... property 2504.It userused Ta other Ta Allows reading any userused@... property |
2494.It Ta | |
2495.It aclinherit Ta property 2496.It aclmode Ta property 2497.It atime Ta property 2498.It canmount Ta property 2499.It casesensitivity Ta property 2500.It checksum Ta property 2501.It compression Ta property 2502.It copies Ta property --- 161 unchanged lines hidden (view full) --- 2664.It Xo 2665.Nm 2666.Cm diff 2667.Op Fl FHt 2668.Ar snapshot 2669.Op Ar snapshot Ns | Ns Ar filesystem 2670.Xc 2671.Pp | 2505.It aclinherit Ta property 2506.It aclmode Ta property 2507.It atime Ta property 2508.It canmount Ta property 2509.It casesensitivity Ta property 2510.It checksum Ta property 2511.It compression Ta property 2512.It copies Ta property --- 161 unchanged lines hidden (view full) --- 2674.It Xo 2675.Nm 2676.Cm diff 2677.Op Fl FHt 2678.Ar snapshot 2679.Op Ar snapshot Ns | Ns Ar filesystem 2680.Xc 2681.Pp |
2672Describes differences between a snapshot and a successor dataset. The 2673successor dataset can be a later snapshot or the current filesystem. | 2682Display the difference between a snapshot of a given filesystem and another 2683snapshot of that filesystem from a later time or the current contents of the 2684filesystem. The first column is a character indicating the type of change, 2685the other columns indicate pathname, new pathname 2686.Pq in case of rename , 2687change in link count, and optionally file type and/or change time. |
2674.Pp | 2688.Pp |
2675The changed files are displayed including the change type. The change type 2676is displayed useing a single character. If a file or directory was renamed, 2677the old and the new names are displayed. 2678.Pp 2679The following change types can be displayed: 2680.Pp 2681.Bl -column -offset indent "CHARACTER" "CHANGE TYPE" 2682.It CHARACTER Ta CHANGE TYPE 2683.It \&+ Ta file was added 2684.It \&- Ta file was removed 2685.It \&M Ta file was modified 2686.It \&R Ta file was renamed | 2689The types of change are: 2690.Bl -column -offset 2n indent 2691.It \&- Ta path was removed 2692.It \&+ Ta path was added 2693.It \&M Ta path was modified 2694.It \&R Ta path was renamed |
2687.El 2688.Bl -tag -width indent 2689.It Fl F | 2695.El 2696.Bl -tag -width indent 2697.It Fl F |
2690Display a single letter for the file type in second to last column. 2691.Pp 2692The following file types can be displayed: 2693.Pp 2694.Bl -column -offset indent "CHARACTER" "FILE TYPE" 2695.It CHARACTER Ta FILE TYPE 2696.It \&F Ta file 2697.It \&/ Ta directory | 2698Display an indication of the type of file, in a manner similar to the 2699.Fl F 2700option of 2701.Xr ls 1 . 2702.Bl -column -offset 2n indent |
2698.It \&B Ta block device | 2703.It \&B Ta block device |
2704.It \&C Ta character device 2705.It \&F Ta regular file 2706.It \&/ Ta directory |
|
2699.It \&@ Ta symbolic link 2700.It \&= Ta socket 2701.It \&> Ta door (not supported on Fx ) | 2707.It \&@ Ta symbolic link 2708.It \&= Ta socket 2709.It \&> Ta door (not supported on Fx ) |
2702.It \&| Ta FIFO (not supported on Fx ) 2703.It \&P Ta event portal (not supported on Fx ) | 2710.It \&| Ta named pipe (not supported on Fx ) 2711.It \&P Ta event port (not supported on Fx ) |
2704.El 2705.It Fl H | 2712.El 2713.It Fl H |
2706Machine-parseable output, fields separated a tab character. | 2714Give more parseable tab-separated output, without header lines and without 2715arrows. |
2707.It Fl t | 2716.It Fl t |
2708Display a change timestamp in the first column. | 2717Display the path's inode change time as the first column of output. |
2709.El 2710.It Xo 2711.Nm 2712.Cm jail 2713.Ar jailid filesystem 2714.Xc 2715.Pp 2716Attaches the specified --- 20 unchanged lines hidden (view full) --- 2737.Ar jailid filesystem 2738.Xc 2739.Pp 2740Detaches the specified 2741.Ar filesystem 2742from the jail identified by JID 2743.Ar jailid . 2744.El | 2718.El 2719.It Xo 2720.Nm 2721.Cm jail 2722.Ar jailid filesystem 2723.Xc 2724.Pp 2725Attaches the specified --- 20 unchanged lines hidden (view full) --- 2746.Ar jailid filesystem 2747.Xc 2748.Pp 2749Detaches the specified 2750.Ar filesystem 2751from the jail identified by JID 2752.Ar jailid . 2753.El |
2754.Sh EXIT STATUS 2755The following exit values are returned: 2756.Bl -tag -offset 2n -width 2n 2757.It 0 2758Successful completion. 2759.It 1 2760An error occurred. 2761.It 2 2762Invalid command line options were specified. 2763.El |
|
2745.Sh EXAMPLES 2746.Bl -tag -width 0n 2747.It Sy Example 1 No Creating a Tn ZFS No File System Hierarchy 2748.Pp 2749The following commands create a file system named 2750.Em pool/home 2751and a file system named 2752.Em pool/home/bob . --- 49 unchanged lines hidden (view full) --- 2802.Ed 2803.It Sy Example 5 No Listing Tn ZFS No Datasets 2804.Pp 2805The following command lists all active file systems and volumes in the system. 2806Snapshots are displayed if the 2807.Sy listsnaps 2808property is 2809.Cm on . | 2764.Sh EXAMPLES 2765.Bl -tag -width 0n 2766.It Sy Example 1 No Creating a Tn ZFS No File System Hierarchy 2767.Pp 2768The following commands create a file system named 2769.Em pool/home 2770and a file system named 2771.Em pool/home/bob . --- 49 unchanged lines hidden (view full) --- 2821.Ed 2822.It Sy Example 5 No Listing Tn ZFS No Datasets 2823.Pp 2824The following command lists all active file systems and volumes in the system. 2825Snapshots are displayed if the 2826.Sy listsnaps 2827property is 2828.Cm on . |
2810The default is | 2829The default is |
2811.Cm off . 2812See 2813.Xr zpool 8 2814for more information on pool properties. 2815.Bd -literal -offset 2n 2816.Li # Ic zfs list 2817 NAME USED AVAIL REFER MOUNTPOINT 2818 pool 450K 457G 18K /pool --- 334 unchanged lines hidden (view full) --- 3153Permission sets on (tank/users) 3154 @pset create,destroy,mount,snapshot 3155Create time permissions on (tank/users) 3156 create,destroy 3157Local+Descendent permissions on (tank/users) 3158 group staff @pset,create,mount 3159------------------------------------------------------------- 3160.Ed | 2830.Cm off . 2831See 2832.Xr zpool 8 2833for more information on pool properties. 2834.Bd -literal -offset 2n 2835.Li # Ic zfs list 2836 NAME USED AVAIL REFER MOUNTPOINT 2837 pool 450K 457G 18K /pool --- 334 unchanged lines hidden (view full) --- 3172Permission sets on (tank/users) 3173 @pset create,destroy,mount,snapshot 3174Create time permissions on (tank/users) 3175 create,destroy 3176Local+Descendent permissions on (tank/users) 3177 group staff @pset,create,mount 3178------------------------------------------------------------- 3179.Ed |
3180.It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset 3181.Pp 3182The following example shows how to see what has changed between a prior 3183snapshot of a ZFS Dataset and its current state. The 3184.Fl F 3185option is used to indicate type information for the files affected. 3186.Bd -literal -offset 2n 3187.Li # Ic zfs diff tank/test@before tank/test 3188M / /tank/test/ 3189M F /tank/test/linked (+1) 3190R F /tank/test/oldname -> /tank/test/newname 3191- F /tank/test/deleted 3192+ F /tank/test/created 3193M F /tank/test/modified 3194.Ed |
|
3161.El | 3195.El |
3162.Sh EXIT STATUS 3163The following exit values are returned: 3164.Bl -tag -offset 2n -width 2n 3165.It 0 3166Successful completion. 3167.It 1 3168An error occurred. 3169.It 2 3170Invalid command line options were specified. 3171.El | |
3172.Sh SEE ALSO 3173.Xr chmod 2 , 3174.Xr fsync 2 , 3175.Xr exports 5 , 3176.Xr fstab 5 , 3177.Xr rc.conf 5 , 3178.Xr jail 8 , 3179.Xr mount 8 , --- 19 unchanged lines hidden --- | 3196.Sh SEE ALSO 3197.Xr chmod 2 , 3198.Xr fsync 2 , 3199.Xr exports 5 , 3200.Xr fstab 5 , 3201.Xr rc.conf 5 , 3202.Xr jail 8 , 3203.Xr mount 8 , --- 19 unchanged lines hidden --- |