.\" 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 "NTFS_RL_VCN_TO_LCN" "9" "09 October 2005" "" ""

.SH NAME
ntfs_rl_vcn_to_lcn \- convert a vcn into a lcn given a runlist
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
LCN ntfs_rl_vcn_to_lcn  (const runlist_element * \fIrl\fB, const VCN \fIvcn\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIrl\fB\fR
runlist to use for conversion
.TP
\fB\fIvcn\fB\fR
vcn to convert
.SH "DESCRIPTION"
.PP
Convert the virtual cluster number \fIvcn\fR of an attribute into a logical
cluster number (lcn) of a device using the runlist \fIrl\fR to map vcns to their
corresponding lcns.
.PP
It is up to the caller to serialize access to the runlist \fIrl\fR\&.
.PP
Since lcns must be >= 0, we use negative return codes with special meaning:
.PP
Return code  Meaning / Description
==================================================
LCN_HOLE  Hole / not allocated on disk.
LCN_RL_NOT_MAPPED This is part of the runlist which has not been
inserted into the runlist yet.
LCN_ENOENT  There is no such vcn in the attribute.
.SH "LOCKING"
.PP
- The caller must have locked the runlist (for reading or writing).
- This function does not touch the lock, nor does it modify the
runlist.