LFS-PROJECT(1) Lustre User Utilities LFS-PROJECT(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#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](#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)](/man/enterprise-packages/lustre/chattr.1) and [**lsattr**(1)](/man/enterprise-packages/lustre/lsattr.1) from **e2fsprogs**.

# [OPTIONS](#OPTIONS)

**-0**, **--print0**

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

[**-c**, **--check**](#c)

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**](#C)

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**](#d)

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

[**-k**, **--keep**](#k)

Keep the project ID unchanged. Can only be specified with **-C**|**--clear**.

[**-p**, **--proj-inherit**|**--inherit**](#p)

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**](#r)

Recursively apply lfs project on all descendants of the *DIRECTORY*.

[**-p**, **--proj-inherit"*ID"***](#p~2)

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**](#s)

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](#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](#AVAILABILITY)

**lfs project** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.11.0.

# [SEE ALSO](#SEE_ALSO)

[**chattr**(1)](/man/enterprise-packages/lustre/chattr.1), [**lfs**(1)](/man/enterprise-packages/lustre/lfs.1), [**lfs-quota**(1)](/man/enterprise-packages/lustre/lfs-quota.1), [**lsattr**(1)](/man/enterprise-packages/lustre/lsattr.1), [**xargs**(1)](/man/enterprise-packages/lustre/xargs.1), [**mdt.enable\_chprojid\_gid**(4)](/man/enterprise-packages/lustre/mdt.enable_chprojid_gid.4), [**projid**(5)](/man/enterprise-packages/lustre/projid.5)

2026-03-19 Lustre

---

Document: lfs-project(1) from lustre 2.17.60-r0 (Chainguard OS)
Source: https://github.com/lustre/lustre-release