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

.SH NAME
pagevec_lookup \- gang pagecache lookup
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
unsigned int pagevec_lookup  (struct pagevec * \fIpvec\fB, struct address_space * \fImapping\fB, pgoff_t \fIstart\fB, unsigned int \fInr_pages\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpvec\fB\fR
Where the resulting pages are placed
.TP
\fB\fImapping\fB\fR
The address_space to search
.TP
\fB\fIstart\fB\fR
The starting page index
.TP
\fB\fInr_pages\fB\fR
The maximum number of pages
.SH "DESCRIPTION"
.PP
\fBpagevec_lookup\fR will search for and return a group of up to \fInr_pages\fR pages
in the mapping.  The pages are placed in \fIpvec\fR\&.  \fBpagevec_lookup\fR takes a
reference against the pages in \fIpvec\fR\&.
.PP
The search returns a group of mapping-contiguous pages with ascending
indexes.  There may be holes in the indices due to not-present pages.
.PP
\fBpagevec_lookup\fR returns the number of pages which were found.