LFS-PROJECT(1)

NAME
lfs-project - Change or list project attribute for specified file or directory.

SYNOPSIS
lfs project [-p|--proj-inherit|--inherit ID] [-d|--directory] [-r|--recursive] [-s|--set-inherit] FILE|DIRECTORY...
lfs project -c|--check [-0|--print0]] [-d|--directory] [-p|--proj-inherit|--inherit ID] [-r|--recursive] FILE|DIRECTORY...
lfs project -C|--clear [-d|--directory] [-k|--keep] [-r|--recursive] FILE|DIRECTORY...

DESCRIPTION
lfs project lists the project ID and flags on FILE(s) or DIRECTORIES.

OPTIONS

-0, --print0
    Print pathnames returned by -c with a trailing NUL, suitable for use by 'xargs -0 lfs project -p'.

-c, --check
    Check project ID and inherit flag on specified FILE(s) or DIRECTORY. If -p|--proj-inherit|--inherit is not given, then use the project ID on the top-level directory, otherwise use the specified ID. If checking a directory and/or recursively, print only files that do not match ID.

-C, --clear
    Clear inherit attribute and reset project ID to 0 for FILE or DIRECTORY. If the -d|--directory option is set, then clear only the directory itself.

-d, --directory
    Show the directory's own project ID and flags, override -r|--recursive option.

-k, --keep
    Keep the project ID unchanged. Can only be specified with -C|--clear.

-p, --proj-inherit|--inherit
    Set project ID and inherit flag on the FILE(s) or DIRECTORIES. Set project ID with given value for the specified FILE or DIRECTORY.

-r, --recursive
    Recursively apply lfs project on all descendants of the DIRECTORY.

-p, --proj-inherit"ID"
    Set project ID with given value for the specified file or directory. The project ID is a 32-bit integer (excluding 4294967295) or a project name as listed in the /etc/projid(5) file. A username or group name can be used in place of a project name by specifying u:USERNAME or g:GROUPNAME respectively.

-s, --set-inherit
    Set the PROJID_INHERIT attribute on directories, so that new files and subdirectories created therein will inherit the project ID and attribute from the parent.

EXAMPLES
set directory quota on /mnt/lustre/dir1, all descendants' project ID and inherit attribute are set:
    $ lfs project -srp 1000 /mnt/lustre/dir1

Check directory /mnt/lustre/dir1, whether all files and directories ID are 1000, inherit attribute is properly set for all directories, print mismatch if any are found:
    $ lfs project -cr -p 1000 /mnt/lustre/dir1

AVAILABILITY
lfs project is part of the lustre(7) filesystem package since release 2.11.0.

SEE ALSO
lfs(1), xargs(1), projid(5)