+.TH lfs-fid2path 1 "2018-11-24" Lustre "user utilities"
+.SH NAME
+lfs fid2path \- print the pathname(s) for a file identifier
+.SH SYNOPSIS
+.BR "lfs fid2path " [ --current | -c "] [" --link | -l
+.RI < linkno ">] <" fsname | rootpath "> <" fid "> ...
+.SH DESCRIPTION
+.B 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
+.I rootpath
+specified, or relative to the filesystem mountpoint if
+.I fsname
+is provided.
+.SH OPTIONS
+.TP
+.BR --current | -c
+Print the current link number with each pathname or parent directory.
+.TP
+.BR --link | -l
+If a file has multiple hard links, then print only the specified link number,
+starting at link 0. If multiple FIDs are given, but only one
+pathname is needed for each file, use
+.BR "--link 0" .
+.SH EXAMPLES
+.TP
+.B $ lfs fid2path /mnt/testfs [0x200000403:0x11f:0x0]
+/mnt/testfs/etc/hosts
+.SH SEE ALSO
+.BR lfs (1),
+.BR lfs-getstripe (1),
+.BR lfs-path2fid (1),
+.BR llapi_fid2path (3),
+.BR lustre (7)