lfs-project(1)

NAME

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

SYNOPSIS

DESCRIPTION

lfs project can list or change the numeric project ID and flags stored on individual FILE(s) or DIRECTORIES. Only one numeric project ID can be stored on each file, similar to the numeric User ID (UID) or Group ID (GID), but the ProjID does not affect Unix file access permissions as they do. The Project ID interface is compatible with existing tools like chattr(1) and lsattr(1) from e2fsprogs.

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 user:USERNAME or g:GROUPNAME or group:GROUPNAME respectively, though this name will not be shown in place of the numeric ID.

-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

chattr(1), lfs(1), lfs-quota(1), lsattr(1), xargs(1), mdt.enable_chprojid_gid(4), projid(5)