LFS-FID2PATH(1)

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

SYNOPSIS
lfs fid2path [OPTION]... FSNAME|MOUNT_POINT FID...

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

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

-f, --print-fid
    Print the FID with the path.

-c, --print-link
    Print the current link number with each pathname or parent directory.

-l, --link=LINK_NUM
    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
    Print only the filename instead of whole pathname

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
lfs fid2path is part of the lustre(7) filesystem package since release 2.0.0

SEE ALSO
lfs(1), lfs-getstripe(1), lfs-path2fid(1), llapi_fid2path(3), lustre(7)