man/man8/zfs-project.8

   1 .\"
   2 .\" CDDL HEADER START
   3 .\"
   4 .\" The contents of this file are subject to the terms of the
   5 .\" Common Development and Distribution License (the "License").
   6 .\" You may not use this file except in compliance with the License.
   7 .\"
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9 .\" or https://opensource.org/licenses/CDDL-1.0.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
  22 .\" Copyright 2011 Joshua M. Clulow <josh@sysmgr.org>
  23 .\" Copyright (c) 2011, 2019 by Delphix. All rights reserved.
  24 .\" Copyright (c) 2013 by Saso Kiselkov. All rights reserved.
  25 .\" Copyright (c) 2014, Joyent, Inc. All rights reserved.
  26 .\" Copyright (c) 2014 by Adam Stevko. All rights reserved.
  27 .\" Copyright (c) 2014 Integros [integros.com]
  28 .\" Copyright 2019 Richard Laager. All rights reserved.
  29 .\" Copyright 2018 Nexenta Systems, Inc.
  30 .\" Copyright 2019 Joyent, Inc.
  31 .\"
  32 .Dd May 27, 2021
  33 .Dt ZFS-PROJECT 8
  34 .Os
  35 .
  36 .Sh NAME
  37 .Nm zfs-project
  38 .Nd manage projects in ZFS filesystem
  39 .Sh SYNOPSIS
  40 .Nm zfs
  41 .Cm project
  42 .Oo Fl d Ns | Ns Fl r Ns Oc
  43 .Ar file Ns | Ns Ar directory Ns …
  44 .Nm zfs
  45 .Cm project
  46 .Fl C
  47 .Oo Fl kr Ns Oc
  48 .Ar file Ns | Ns Ar directory Ns …
  49 .Nm zfs
  50 .Cm project
  51 .Fl c
  52 .Oo Fl 0 Ns Oc
  53 .Oo Fl d Ns | Ns Fl r Ns Oc
  54 .Op Fl p Ar id
  55 .Ar file Ns | Ns Ar directory Ns …
  56 .Nm zfs
  57 .Cm project
  58 .Op Fl p Ar id
  59 .Oo Fl rs Ns Oc
  60 .Ar file Ns | Ns Ar directory Ns …
  61 .
  62 .Sh DESCRIPTION
  63 .Bl -tag -width ""
  64 .It Xo
  65 .Nm zfs
  66 .Cm project
  67 .Oo Fl d Ns | Ns Fl r Ns Oc
  68 .Ar file Ns | Ns Ar directory Ns …
  69 .Xc
  70 List project identifier (ID) and inherit flag of files and directories.
  71 .Bl -tag -width "-d"
  72 .It Fl d
  73 Show the directory project ID and inherit flag, not its children.
  74 .It Fl r
  75 List subdirectories recursively.
  76 .El
  77 .It Xo
  78 .Nm zfs
  79 .Cm project
  80 .Fl C
  81 .Oo Fl kr Ns Oc
  82 .Ar file Ns | Ns Ar directory Ns …
  83 .Xc
  84 Clear project inherit flag and/or ID on the files and directories.
  85 .Bl -tag -width "-k"
  86 .It Fl k
  87 Keep the project ID unchanged.
  88 If not specified, the project ID will be reset to zero.
  89 .It Fl r
  90 Clear subdirectories' flags recursively.
  91 .El
  92 .It Xo
  93 .Nm zfs
  94 .Cm project
  95 .Fl c
  96 .Oo Fl 0 Ns Oc
  97 .Oo Fl d Ns | Ns Fl r Ns Oc
  98 .Op Fl p Ar id
  99 .Ar file Ns | Ns Ar directory Ns …
 100 .Xc
 101 Check project ID and inherit flag on the files and directories:
 102 report entries without the project inherit flag, or with project IDs different
 103 from the
 104 target directory's project ID or the one specified with
 105 .Fl p .
 106 .Bl -tag -width "-p id"
 107 .It Fl 0
 108 Delimit filenames with a NUL byte instead of newline, don't output diagnoses.
 109 .It Fl d
 110 Check the directory project ID and inherit flag, not its children.
 111 .It Fl p Ar id
 112 Compare to
 113 .Ar id
 114 instead of the target files and directories' project IDs.
 115 .It Fl r
 116 Check subdirectories recursively.
 117 .El
 118 .It Xo
 119 .Nm zfs
 120 .Cm project
 121 .Fl p Ar id
 122 .Oo Fl rs Ns Oc
 123 .Ar file Ns | Ns Ar directory Ns …
 124 .Xc
 125 Set project ID and/or inherit flag on the files and directories.
 126 .Bl -tag -width "-p id"
 127 .It Fl p Ar id
 128 Set the project ID to the given value.
 129 .It Fl r
 130 Set on subdirectories recursively.
 131 .It Fl s
 132 Set project inherit flag on the given files and directories.
 133 This is usually used for setting up tree quotas with
 134 .Fl r .
 135 In that case, the directory's project ID
 136 will be set for all its descendants, unless specified explicitly with
 137 .Fl p .
 138 .El
 139 .El
 140 .
 141 .Sh SEE ALSO
 142 .Xr zfs-projectspace 8