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

# [NAME](#NAME)

lfs-fid2path - print the pathname(s) for a file identifier

# [SYNOPSIS](#SYNOPSIS)

`lfs fid2path` \[*OPTION*]... *FSNAME*|*MOUNT\_POINT* *FID*...

# [DESCRIPTION](#DESCRIPTION)

**lfs fid2path** maps a numeric Lustre File IDentifier (FID) to one or more pathnames that have hard links to that file. This allows resolving filenames for FIDs used in console error messages, and resolving all of the pathnames for a file that has multiple hard links. Pathnames are resolved relative to the *MOUNT\_POINT* specified, or relative to the filesystem mount point if *FSNAME* is provided.

# [OPTIONS](#OPTIONS)

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

Print the full pathname, followed by a NUL character instead of the newline character.

[**-f**, **--print-fid**](#f)

Print the FID with the path.

[**-c**, **--print-link**](#c)

Print the current link number with each pathname or parent directory.

[**-l**, **--link=*LINK\_NUM***](#l)

If a file has multiple hard links, then print only the specified *LINK\_NUM*, starting at link 0. If multiple FIDs are given, but only one pathname is needed for each file, use **--link=0**.

[**-n**, **--name**](#n)

Print only the filename instead of whole pathname

# [EXAMPLES](#EXAMPLES)

```
# lfs fid2path /mnt/testfs [0x200000403:0x11f:0x0]
/mnt/testfs/etc/hosts
# lfs fid2path -0 /mnt/lustre 0x200000401:0x6:0x0 | xargs --null
/mnt/lustre/Test_
file /mnt/lustre/Link_
file
# lfs fid2path -n /mnt/testfs [0x200000403:0x11f:0x0]
hosts
```

# [AVAILABILITY](#AVAILABILITY)

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

# [SEE ALSO](#SEE_ALSO)

[**lfs**(1)](/man/enterprise-packages/lustre/lfs.1), [**lfs-getstripe**(1)](/man/enterprise-packages/lustre/lfs-getstripe.1), [**lfs-path2fid**(1)](/man/enterprise-packages/lustre/lfs-path2fid.1), [**llapi\_fid2path**(3)](/man/enterprise-packages/lustre/llapi_fid2path.3), [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7)

2024-08-15 Lustre

---

Document: lfs-fid2path(1) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release
