lfs-fid2path(1)

NAME

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

SYNOPSIS

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)