---
name: "xfs_ncheck"
section: "8"
platform: "linux"
package: "xfsprogs"
version: "7.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xfs_ncheck"
---

# xfs\_ncheck(8)

generate pathnames from i-numbers for XFS

## NAME

xfs\_ncheck - generate pathnames from i-numbers for XFS

## SYNOPSIS

**xfs\_ncheck** \[ **-i** *ino* \] ... \[ **-f** \] \[ **-s** \] \[ **-l** *logdev* \] *device*\
 **xfs\_ncheck -V**

## DESCRIPTION

**xfs\_ncheck** with no **-i** arguments generates an inode number and pathname list of all files on the given filesystem. Names of directory files are followed by **/.**. The output is not sorted in any particular order. The filesystem to be examined is specified by the *device* argument, which should be the disk or volume device for the filesystem. Filesystems stored in files can also be checked, using the **-f** flag.

## OPTIONS

- **-f**

  Specifies that the filesystem image to be processed is stored in a regular file at *device* (see the **mkfs.xfs -d** *file* option). This might happen if an image copy of a filesystem has been made into an ordinary file.

- **-l** *logdev*

  Specifies the device where the filesystem's external log resides. Only for those filesystems which use an external log. See the **mkfs.xfs -l** option, and refer to [**xfs**(5)](/xfs/5.md) for a detailed description of the XFS log.

- **-s**

  Limits the report to special files and files with setuserid mode. This option may be used to detect violations of security policy.

- **-i** *ino*

  Limits the report to only those files whose inode numbers follow. May be given multiple times to select multiple inode numbers.

- **-V**

  Prints the version number and exits.

If the filesystem is seriously corrupted, or very busy and looks like it is corrupt, a message of the form that would be generated by the [**xfs\_db**(8)](/xfs_db/8.md) "check" command may appear.

**xfs\_ncheck** is only useful with XFS filesystems.

## SEE ALSO

[**mkfs.xfs**(8)](/mkfs.xfs/8.md), [**xfs**(5)](/xfs/5.md).