From owner-freebsd-doc@FreeBSD.ORG Mon Sep 8 00:20:10 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EDE4416A4BF for ; Mon, 8 Sep 2003 00:20:09 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 747AF43FAF for ; Mon, 8 Sep 2003 00:20:08 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h887K8Up044726 for ; Mon, 8 Sep 2003 00:20:08 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h887K8fP044725; Mon, 8 Sep 2003 00:20:08 -0700 (PDT) Resent-Date: Mon, 8 Sep 2003 00:20:08 -0700 (PDT) Resent-Message-Id: <200309080720.h887K8fP044725@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Andrey Simonenko Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6C3E116A4BF for ; Mon, 8 Sep 2003 00:15:08 -0700 (PDT) Received: from relay1.ntu-kpi.kiev.ua (oberon.ntu-kpi.kiev.ua [195.245.194.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id E276143FE3 for ; Mon, 8 Sep 2003 00:15:05 -0700 (PDT) (envelope-from simon@comsys.ntu-kpi.kiev.ua) Received: from comsys.ntu-kpi.kiev.ua (eth0.comsys.ntu-kpi.kiev.ua [10.0.1.184]) by relay1.ntu-kpi.kiev.ua (Postfix) with ESMTP id 46F7219CEA for ; Mon, 8 Sep 2003 10:15:01 +0300 (EEST) Received: from pm514-9.comsys.ntu-kpi.kiev.ua (pm514-9.comsys.ntu-kpi.kiev.ua [10.18.54.109]) by comsys.ntu-kpi.kiev.ua (8.11.6/8.11.6) with ESMTP id h887Jc451118 for ; Mon, 8 Sep 2003 10:19:38 +0300 (EEST) Received: by pm514-9.comsys.ntu-kpi.kiev.ua (Postfix, from userid 1000) id 6136B225; Mon, 8 Sep 2003 10:14:58 +0300 (EEST) Message-Id: <20030908071458.GA197@pm514-9.comsys.ntu-kpi.kiev.ua> Date: Mon, 8 Sep 2003 10:14:58 +0300 From: Andrey Simonenko To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/56584: Updates for VOP_GETPAGES(9) and VOP_PUTPAGES(9) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Sep 2003 07:20:10 -0000 >Number: 56584 >Category: docs >Synopsis: Updates for VOP_GETPAGES(9) and VOP_PUTPAGES(9) >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Sep 08 00:20:07 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Andrey Simonenko >Release: FreeBSD 4.8-STABLE and 5.1-RELEASE >Organization: >Environment: >Description: I suppose that VOP_GETPAGES(9) and VOP_PUTPAGES(9) contain mistakes, also following patch adds descriptions for not described previously arguments. Comments? >How-To-Repeat: >Fix: --- VOP_GETPAGES.9.orig Thu Jun 5 04:56:16 2003 +++ VOP_GETPAGES.9 Sun Sep 7 23:04:59 2003 @@ -40,29 +40,33 @@ .In sys/vnode.h .In vm/vm.h .Ft int -.Fn VOP_GETPAGES "struct vnode *vp" "vm_page_t *m" "int count" "int reqpage" "vm_ooffset_t offset" +.Fn VOP_GETPAGES "struct vnode *vp" "vm_page_t *m" "int bytecount" "int reqpage" "vm_ooffset_t offset" .Ft int -.Fn VOP_PUTPAGES "struct vnode *vp" "vm_page_t *m" "int count" "int sync" "int *rtvals" "vm_ooffset_t offset" +.Fn VOP_PUTPAGES "struct vnode *vp" "vm_page_t *m" "int bytecount" "int sync" "int *rtvals" "vm_ooffset_t offset" .Sh DESCRIPTION +These entry points read and write VM pages from a file respectively. +.Pp The arguments are: .Bl -tag -width reqpage .It Ar vp The file to access. .It Ar m -A page ??? -.It Ar count -How many pages to access. +The array of vm_page_t. +.It Ar bytecount +How many bytes to access (multiple of the page size), should be +divided by the page size to get the number of elements in the array +.Ar m . .It Ar sync Nonzero if the write should be synchronous. .It Ar rtvals -??? +The array of return values for corresponding pages in the array +.Ar m . .It Ar reqpage -??? +The index of the requested page in the array +.Ar m . .It Ar offset Offset in the file to start accessing. .El -.Pp -Not quite sure about this one. .Sh RETURN VALUES Zero is returned on success, otherwise an error is returned. .Sh SEE ALSO >Release-Note: >Audit-Trail: >Unformatted: To: FreeBSD-gnats-submit@freebsd.org From: Andrey Simonenko Reply-To: Andrey Simonenko Cc: X-send-pr-version: 3.113 X-GNATS-Notify: