'\" t .\" Title: bio_add_pc_page .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: July 2017 .\" Manual: The Linux VFS .\" Source: Kernel Hackers Manual 4.12.2 .\" Language: English .\" .TH "BIO_ADD_PC_PAGE" "9" "July 2017" "Kernel Hackers Manual 4\&.12\&" "The Linux VFS" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" bio_add_pc_page \- attempt to add page to bio .SH "SYNOPSIS" .HP \w'int\ bio_add_pc_page('u .BI "int bio_add_pc_page(struct\ request_queue\ *\ " "q" ", struct\ bio\ *\ " "bio" ", struct\ page\ *\ " "page" ", unsigned\ int\ " "len" ", unsigned\ int\ " "offset" ");" .SH "ARGUMENTS" .PP \fIstruct request_queue * q\fR .RS 4 the target queue .RE .PP \fIstruct bio * bio\fR .RS 4 destination bio .RE .PP \fIstruct page * page\fR .RS 4 page to add .RE .PP \fIunsigned int len\fR .RS 4 vec entry length .RE .PP \fIunsigned int offset\fR .RS 4 vec entry offset .RE .SH "DESCRIPTION" .PP Attempt to add a page to the bio_vec maplist\&. This can fail for a number of reasons, such as the bio being full or target block device limitations\&. The target block device must allow bio\*(Aqs up to PAGE_SIZE, so it is always possible to add a single page to an empty bio\&. .PP This should only be used by REQ_PC bios\&. .SH "COPYRIGHT" .br