diff options
Diffstat (limited to 'man/man8/zfs-project.8')
| -rw-r--r-- | man/man8/zfs-project.8 | 98 |
1 files changed, 43 insertions, 55 deletions
diff --git a/man/man8/zfs-project.8 b/man/man8/zfs-project.8 index 21c300f83..f264a110f 100644 --- a/man/man8/zfs-project.8 +++ b/man/man8/zfs-project.8 @@ -18,7 +18,6 @@ .\" .\" CDDL HEADER END .\" -.\" .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 2011 Joshua M. Clulow <[email protected]> .\" Copyright (c) 2011, 2019 by Delphix. All rights reserved. @@ -30,68 +29,65 @@ .\" Copyright 2018 Nexenta Systems, Inc. .\" Copyright 2019 Joyent, Inc. .\" -.Dd June 30, 2019 +.Dd May 27, 2021 .Dt ZFS-PROJECT 8 .Os +. .Sh NAME .Nm zfs-project -.Nd List, set, or clear project ID and/or inherit flag on the file(s) or directories. +.Nd manage projects in ZFS filesystem .Sh SYNOPSIS .Nm zfs .Cm project .Oo Fl d Ns | Ns Fl r Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Nm zfs .Cm project .Fl C .Oo Fl kr Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Nm zfs .Cm project .Fl c .Oo Fl 0 Ns Oc .Oo Fl d Ns | Ns Fl r Ns Oc .Op Fl p Ar id -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Nm zfs .Cm project .Op Fl p Ar id .Oo Fl rs Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … +. .Sh DESCRIPTION .Bl -tag -width "" .It Xo .Nm zfs .Cm project .Oo Fl d Ns | Ns Fl r Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Xc -List project identifier (ID) and inherit flag of file(s) or directories. +List project identifier (ID) and inherit flag of files and directories. .Bl -tag -width "-d" .It Fl d -Show the directory project ID and inherit flag, not its children. It will -overwrite the former specified -.Fl r -option. +Show the directory project ID and inherit flag, not its children. .It Fl r -Show on subdirectories recursively. It will overwrite the former specified -.Fl d -option. +List subdirectories recursively. .El .It Xo .Nm zfs .Cm project .Fl C .Oo Fl kr Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Xc -Clear project inherit flag and/or ID on the file(s) or directories. +Clear project inherit flag and/or ID on the files and directories. .Bl -tag -width "-k" .It Fl k -Keep the project ID unchanged. If not specified, the project ID will be reset -as zero. +Keep the project ID unchanged. +If not specified, the project ID will be reset to zero. .It Fl r -Clear on subdirectories recursively. +Clear subdirectories' flags recursively. .El .It Xo .Nm zfs @@ -100,54 +96,46 @@ Clear on subdirectories recursively. .Oo Fl 0 Ns Oc .Oo Fl d Ns | Ns Fl r Ns Oc .Op Fl p Ar id -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Xc -Check project ID and inherit flag on the file(s) or directories, report the -entries without project inherit flag or with different project IDs from the -specified (via -.Fl p -option) value or the target directory's project ID. -.Bl -tag -width "-0" +Check project ID and inherit flag on the files and directories: +report entries without the project inherit flag, or with project IDs different from the +target directory's project ID or the one specified with +.Fl p . +.Bl -tag -width "-p id" .It Fl 0 -Print file name with a trailing NUL instead of newline (by default), like -"find -print0". +Delimit filenames with a NUL byte instead of newline. .It Fl d -Check the directory project ID and inherit flag, not its children. It will -overwrite the former specified -.Fl r -option. -.It Fl p -Specify the referenced ID for comparing with the target file(s) or directories' -project IDs. If not specified, the target (top) directory's project ID will be -used as the referenced one. +Check the directory project ID and inherit flag, not its children. +.It Fl p Ar id +Compare to +.Ar id +instead of the target files and directories' project IDs. .It Fl r -Check on subdirectories recursively. It will overwrite the former specified -.Fl d -option. +Check subdirectories recursively. .El .It Xo .Nm zfs .Cm project -.Op Fl p Ar id +.Fl p Ar id .Oo Fl rs Ns Oc -.Ar file Ns | Ns Ar directory Ns ... +.Ar file Ns | Ns Ar directory Ns … .Xc -Set project ID and/or inherit flag on the file(s) or directories. -.Bl -tag -width "-p" -.It Fl p -Set the file(s)' or directories' project ID with the given value. +Set project ID and/or inherit flag on the files and directories. +.Bl -tag -width "-p id" +.It Fl p Ar id +Set the project ID to the given value. .It Fl r Set on subdirectories recursively. .It Fl s -Set project inherit flag on the given file(s) or directories. It is usually used -for setup tree quota on the directory target with -.Fl r -option specified together. When setup tree quota, by default the directory's -project ID will be set to all its descendants unless you specify the project -ID via -.Fl p -option explicitly. +Set project inherit flag on the given files and directories. +This is usually used for setting up tree quotas with +.Fl r . +In that case, the directory's project ID +will be set for all its descendants, unless specified explicitly with +.Fl p . .El .El +. .Sh SEE ALSO .Xr zfs-projectspace 8 |