.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "__GET_NR_FREE_MFT_RECORDS" "9" "09 October 2005" "" ""

.SH NAME
__get_nr_free_mft_records \- return the number of free inodes on a volume
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
unsigned long __get_nr_free_mft_records  (ntfs_volume * \fIvol\fB, s64 \fInr_free\fB, const pgoff_t \fImax_index\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIvol\fB\fR
ntfs volume for which to obtain free inode count
.TP
\fB\fInr_free\fB\fR
number of mft records in filesystem
.TP
\fB\fImax_index\fB\fR
maximum number of pages containing set bits
.SH "DESCRIPTION"
.PP
Calculate the number of free mft records (inodes) on the mounted NTFS
volume \fIvol\fR\&. We actually calculate the number of mft records in use instead
because this allows us to not care about partial pages as these will be just
zero filled and hence not be counted as allocated mft record.
.PP
If any pages cannot be read we assume all mft records in the erroring pages
are in use. This means we return an underestimate on errors which is better
than an overestimate.
.SH "NOTE"
.PP
Caller must hold mftbmp_lock rw_semaphore for reading or writing.