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

.SH NAME
ntfs_rl_replace \- overwrite a run_list element with another run list
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
run_list_element * ntfs_rl_replace  (run_list_element * \fIdst\fB, int \fIdsize\fB, run_list_element * \fIsrc\fB, int \fIssize\fB, int \fIloc\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIdst\fB\fR
original run list to be worked on
.TP
\fB\fIdsize\fB\fR
number of elements in \fIdst\fR (including end marker)
.TP
\fB\fIsrc\fB\fR
new run list to be inserted
.TP
\fB\fIssize\fB\fR
number of elements in \fIsrc\fR (excluding end marker)
.TP
\fB\fIloc\fB\fR
index in run list \fIdst\fR to overwrite with \fIsrc\fR
.SH "DESCRIPTION"
.PP
Replace the run list element \fIdst\fR at \fIloc\fR with \fIsrc\fR\&. Merge the left and
right ends of the inserted run list, if necessary.
.PP
It is up to the caller to serialize access to the run lists \fIdst\fR and \fIsrc\fR\&.
.PP
On success, return a pointer to the new, combined, run list. Note, both
run lists \fIdst\fR and \fIsrc\fR are deallocated before returning so you cannot use
the pointers for anything any more. (Strictly speaking the returned run list
may be the same as \fIdst\fR but this is irrelevant.)
.PP
On error, return -errno. Both run lists are left unmodified. The following
.SH "ERROR CODES ARE DEFINED"
.PP
-ENOMEM - Not enough memory to allocate run list array.
-EINVAL - Invalid parameters were passed in.