Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/vnode_pager_purge_range.9
- This file was added.
.\" | ||||||||||
.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD | ||||||||||
.\" | ||||||||||
.\" Copyright (c) 2021 The FreeBSD Foundation | ||||||||||
.\" | ||||||||||
.\" Redistribution and use in source and binary forms, with or without | ||||||||||
.\" modification, are permitted provided that the following conditions | ||||||||||
.\" are met: | ||||||||||
.\" 1. Redistributions of source code must retain the above copyright | ||||||||||
.\" notice, this list of conditions and the following disclaimer. | ||||||||||
.\" 2. Redistributions in binary form must reproduce the above copyright | ||||||||||
.\" notice, this list of conditions and the following disclaimer in the | ||||||||||
.\" documentation and/or other materials provided with the distribution. | ||||||||||
.\" | ||||||||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND | ||||||||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | ||||||||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | ||||||||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | ||||||||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | ||||||||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | ||||||||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||||||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||||||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||||||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||||||||
.\" SUCH DAMAGE. | ||||||||||
.\" | ||||||||||
.Dd January 26, 2021 | ||||||||||
.Dt VNODE_PAGER_PURGE_RANGE 9 | ||||||||||
.Os | ||||||||||
.Sh NAME | ||||||||||
.Nm vnode_pager_purge_range | ||||||||||
.Nd "invalidate the content of the given range in bytes from cache" | ||||||||||
.Sh SYNOPSIS | ||||||||||
.In vm/vm_extern.h | ||||||||||
.Ft void | ||||||||||
.Fn vnode_pager_purge_range "struct vnode *vp" "vm_ooffset_t startoff" "vm_ooffset_t endoff" | ||||||||||
alc: I would suggest "invalidate the cached contents within the given byte range" here and below. | ||||||||||
Done Inline ActionsThat sounds better to me. khng: That sounds better to me. | ||||||||||
.Sh DESCRIPTION | ||||||||||
.Nm | ||||||||||
invalidates content of the cache covered by the given range from the | ||||||||||
Done Inline Actions.Nm invalidates contents of the cache ... rpokala: ```
.Nm
invalidates contents of the cache ...
``` | ||||||||||
specified vnode | ||||||||||
.Fa vp . | ||||||||||
The range to be purged is | ||||||||||
.Eo [ | ||||||||||
.Fa startoff , endoff | ||||||||||
.Ec ) . | ||||||||||
Affected pages within the specified range will be tossed away. | ||||||||||
Done Inline Actions"Affected" rpokala: "Affected" | ||||||||||
.Sh IMPLEMENTATION NOTES | ||||||||||
Within the specified range, | ||||||||||
in case | ||||||||||
.Fa startoff | ||||||||||
or | ||||||||||
.Fa endoff | ||||||||||
is not aligned to page boundaries, | ||||||||||
partial-page area will be zeroed. | ||||||||||
In partial-page area, | ||||||||||
for content occupying whole blocks within block | ||||||||||
Done Inline Actionsfor content occupying whole blocks within block rpokala: ```
for content occupying whole blocks within block
``` | ||||||||||
boundaries, | ||||||||||
the dirty bits for the corresponding blocks will be cleared. | ||||||||||
Done Inline ActionsReplace "operation" by "affected". alc: Replace "operation" by "affected". | ||||||||||
.Sh LOCKING | ||||||||||
Writer lock of the VM object of | ||||||||||
Done Inline Actions
alc: | ||||||||||
.Fa vp | ||||||||||
Done Inline Actions
alc: | ||||||||||
will be held within the function. | ||||||||||
.Sh SEE ALSO | ||||||||||
.Xr vnode 9 | ||||||||||
.Sh HISTORY | ||||||||||
The | ||||||||||
Done Inline Actions
alc: | ||||||||||
.Nm | ||||||||||
Done Inline Actions
alc: | ||||||||||
manual page first appeared in | ||||||||||
.Fx 14 . | ||||||||||
.Sh AUTHORS | ||||||||||
This | ||||||||||
Done Inline Actions
alc: | ||||||||||
manual page was written by | ||||||||||
.An Ka Ho Ng Aq Mt khng@freebsdfoundation.org . |
I would suggest "invalidate the cached contents within the given byte range" here and below.