lustre/doc/lfs-project.1

   1 .TH LFS-PROJECT 1 2017-10-26 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs project \- Change or list project attribute for specified file or directory.
   4 .SH SYNOPSIS
   5 .BR "lfs project" " [" -d | -r ] " "< \fI file | directory...\fR>
   6 .br
   7 .BR "lfs project" " {" -p " "\fIID " |" -s } " "[ -r ] " "<\fI file | directory...\fR>
   8 .br
   9 .BR "lfs project" " -c" " [" -d | -r " [" -p " "\fIID ] " [" -0 ] ] " <" file | directory...>
  10 .br
  11 .BR "lfs project" " -C" " [" -r | -k ] " <" file | directory...>
  12 .br
  13 .SH DESCRIPTION
  14 .TP
  15 .BR "lfs project" " [" -d | -r ]
  16 .RI < file | directory...>
  17 .TP
  18 List project ID and flags on file(s) or directories.
  19 .TP
  20 .B -d
  21 Show the directory's own project ID and flags, override \fB-r\fR option.
  22 .TP
  23 .B -r
  24 Recursively list all descendants'(of the directory) project attribute.
  25 .TP
  26 .BR "lfs project" " {" -p " "\fIID " |" -s } " "[ -r ]
  27 .RI < file | directory...>
  28 .TP
  29 Set project ID and/or inherit flag for specified file(s) or directories.
  30 .TP
  31 .B -p <\fIID\fR>
  32 Set project \fIID\fR with given value for the specified file or directory
  33 .TP
  34 .B -s
  35 Set the
  36 .B PROJID_INHERIT
  37 attribute on directories, so that new files and subdirectories created
  38 therein will inherit the project ID and attribute from the parent.
  39 .TP
  40 .B -r
  41 Set project \fIID\fR with the directory's project ID for all
  42 its descendants (with \fB-p\fR specified). For descendant directories, also set
  43 inherit flag (if \fI-s\fR specified).
  44 .TP
  45 .BR "lfs project" " -c" " [" -d|-r " [" -p " "\fIID ] " [" -0 ] ]
  46 .RI < file | directory...>
  47 .TP
  48 Check project ID and flags on file(s) or directories, print outliers.
  49 .TP
  50 .B -c
  51 Check project ID and inherit flag on specified file(s) or directory. If
  52 .B -p
  53 is not given, then use the project ID on the top-level directory
  54 , otherwise use the ID specified with
  55 .BR -p .
  56 if checking a directory and or recursively, print only files that do not match.
  57 .TP
  58 .B -0
  59 Print pathnames found by -c with a trailing NUL for use by
  60 .BR \' xargs "(1) " -0 \'.
  61 .TP
  62 .BR "lfs project" " -C [" -r | -k ]
  63 .RI < file | directory...>
  64 .TP
  65 Clear the project inherit flag and ID on the file(s) or directories
  66 .TP
  67 .B -C
  68 Clear inherit attribute, project ID will be reset to be 0 in default
  69 .TP
  70 .B -k
  71 keep the project ID unchanged.
  72 .TP
  73 .SH EXAMPLES
  74 .TP
  75 .B $ lfs project -srp 1000 /mnt/lustre/dir1
  76 set directory quota on
  77 .BR /mnt/lustre/dir1,
  78 all descendants' project ID and inherit attribute are set.
  79 .TP
  80 .B $ lfs project -cr -p 1000 /mnt/lustre/dir1
  81 check directory
  82 .BR /mnt/lustre/dir1,
  83 whether all files and directories ID are 1000, inherit attribute
  84 is properly set for all directories, print mismatch
  85 if any are found.
  86 .SH SEE ALSO
  87 .BR lfs (1)
  88 .BR xargs (1)