| 1 |
.TH xfs_ncheck 8 |
| 2 |
.SH NAME |
| 3 |
xfs_ncheck \- generate pathnames from i-numbers for XFS |
| 4 |
.SH SYNOPSIS |
| 5 |
.B xfs_ncheck |
| 6 |
[ |
| 7 |
.B \-i |
| 8 |
.I ino |
| 9 |
] ... [ |
| 10 |
.B \-f |
| 11 |
] [ |
| 12 |
.B \-s |
| 13 |
] [ |
| 14 |
.B \-l |
| 15 |
.I logdev |
| 16 |
] |
| 17 |
.I device |
| 18 |
.br |
| 19 |
.B xfs_ncheck \-V |
| 20 |
.SH DESCRIPTION |
| 21 |
.B xfs_ncheck |
| 22 |
with no |
| 23 |
.B \-i |
| 24 |
arguments generates an inode number and pathname list of all |
| 25 |
files on the given filesystem. Names of directory files are followed by |
| 26 |
.BR /. . |
| 27 |
The output is not sorted in any particular order. |
| 28 |
The filesystem to be examined is specified by the |
| 29 |
.I device |
| 30 |
argument, which should be the disk or volume device for the filesystem. |
| 31 |
Filesystems stored in files can also be checked, using the |
| 32 |
.B \-f |
| 33 |
flag. |
| 34 |
.SH OPTIONS |
| 35 |
.TP 0.9i |
| 36 |
.B \-f |
| 37 |
Specifies that the filesystem image to be processed is stored in a |
| 38 |
regular file at |
| 39 |
.I device |
| 40 |
(see the |
| 41 |
.B mkfs.xfs \-d |
| 42 |
.I \f2file\f1 |
| 43 |
option). This might happen if an image copy |
| 44 |
of a filesystem has been made into an ordinary file. |
| 45 |
.TP |
| 46 |
.BI \-l " logdev" |
| 47 |
Specifies the device where the filesystem's external log resides. |
| 48 |
Only for those filesystems which use an external log. See the |
| 49 |
.B mkfs.xfs \-l |
| 50 |
option, and refer to |
| 51 |
.BR xfs (5) |
| 52 |
for a detailed description of the XFS log. |
| 53 |
.TP |
| 54 |
.B \-s |
| 55 |
Limits the report to special files and files with setuserid mode. |
| 56 |
This option may be used to detect violations of security policy. |
| 57 |
.TP |
| 58 |
.BI \-i " ino" |
| 59 |
Limits the report to only those files whose inode numbers follow. |
| 60 |
May be given multiple times to select multiple inode numbers. |
| 61 |
.TP |
| 62 |
.B \-V |
| 63 |
Prints the version number and exits. |
| 64 |
.PP |
| 65 |
If the filesystem is seriously corrupted, or very busy and looks |
| 66 |
like it is corrupt, a message of the form that would be generated by the |
| 67 |
.BR xfs_db (8) |
| 68 |
"check" command may appear. |
| 69 |
.PP |
| 70 |
.B xfs_ncheck |
| 71 |
is only useful with XFS filesystems. |
| 72 |
.SH SEE ALSO |
| 73 |
.BR mkfs.xfs (8), |
| 74 |
.BR xfs (5). |