.\" 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 "VCN_TO_LCN" "" "06 October 2005" "" ""

.SH NAME
vcn_to_lcn \- convert a vcn into a lcn given a run list
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
LCN vcn_to_lcn  (const run_list_element * \fIrl\fB, const VCN \fIvcn\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIrl\fB\fR
run list 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 run list \fIrl\fR to map vcns to their
corresponding lcns.
.PP
It is up to the caller to serialize access to the run list \fIrl\fR\&.
.PP
Since lcns must be >= 0, we use negative return values with special meaning:
.PP
Return value   Meaning / Description
==================================================
-1 = LCN_HOLE  Hole / not allocated on disk.
-2 = LCN_RL_NOT_MAPPED This is part of the run list which has not been
inserted into the run list yet.
-3 = LCN_ENOENT  There is no such vcn in the attribute.
-4 = LCN_EINVAL  Input parameter error (if debug enabled).