'\" t .\" Title: vm_insert_pfn_prot .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: March 2017 .\" Manual: Memory Management in Linux .\" Source: Kernel Hackers Manual 4.10.7 .\" Language: English .\" .TH "VM_INSERT_PFN_PROT" "9" "March 2017" "Kernel Hackers Manual 4\&.10\&" "Memory Management in Linux" .\" ----------------------------------------------------------------- .\" * 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" vm_insert_pfn_prot \- insert single pfn into user vma with specified pgprot .SH "SYNOPSIS" .HP \w'int\ vm_insert_pfn_prot('u .BI "int vm_insert_pfn_prot(struct\ vm_area_struct\ *\ " "vma" ", unsigned\ long\ " "addr" ", unsigned\ long\ " "pfn" ", pgprot_t\ " "pgprot" ");" .SH "ARGUMENTS" .PP \fIvma\fR .RS 4 user vma to map to .RE .PP \fIaddr\fR .RS 4 target user address of this page .RE .PP \fIpfn\fR .RS 4 source kernel pfn .RE .PP \fIpgprot\fR .RS 4 pgprot flags for the inserted page .RE .SH "DESCRIPTION" .PP This is exactly like vm_insert_pfn, except that it allows drivers to to override pgprot on a per\-page basis\&. .PP This only makes sense for IO mappings, and it makes no sense for cow mappings\&. In general, using multiple vmas is preferable; vm_insert_pfn_prot should only be used if using multiple VMAs is impractical\&. .SH "COPYRIGHT" .br