From hsn@netmag.cz  Tue Aug 24 20:32:57 2004
Return-Path: <hsn@netmag.cz>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 85F5816A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 24 Aug 2004 20:32:57 +0000 (GMT)
Received: from smtp3.vol.cz (smtp3.vol.cz [195.250.128.83])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B361243D46
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 24 Aug 2004 20:32:56 +0000 (GMT)
	(envelope-from hsn@netmag.cz)
Received: from sanatana.dharma (volny-ipt-3-102.dialup.vol.cz [62.177.66.102])
	by smtp3.vol.cz (8.12.9p2/8.12.9) with ESMTP id i7OKWrxR015798
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 24 Aug 2004 22:32:54 +0200 (CEST)
	(envelope-from hsn@netmag.cz)
Received: from hsn@localhost
	by sanatana.dharma (Exim 4.34_0 FreeBSD) id 1Bzh8k-0005sU-Mh
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 24 Aug 2004 21:39:30 +0200
Message-Id: <E1Bzh8k-0005sU-Mh@sanatana.dharma>
Date: Tue, 24 Aug 2004 21:39:30 +0200
From: Radim Kolar <hsn@netmag.cz>
Reply-To: Radim Kolar <hsn@netmag.cz>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: msync.2 manpage update
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         70916
>Category:       docs
>Synopsis:       msync.2 manpage update
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    roam
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 24 20:40:22 GMT 2004
>Closed-Date:    Sat Sep 17 18:07:24 GMT 2005
>Last-Modified:  Sat Sep 17 18:07:24 GMT 2005
>Originator:     Radim Kolar
>Release:        FreeBSD 5.3-BETA1 i386
>Organization:
>Environment:
System: FreeBSD sanatana.dharma 5.3-BETA1 FreeBSD 5.3-BETA1 #1: Tue Aug 24 14:21:29 CEST 2004 root@sanatana.dharma:/usr/obj/usr/src/sys/UP i386
>Description:
Msync function is obsolete as noted in mmap manpage, but this information
is missing from msync manpage itself.
>How-To-Repeat:
>Fix:
Add following text to msync.2 BUGS section
/copied from mmap manpage/

The msync(2) system call is obsolete since
BSD implements a coherent file system buffer cache.
However, it may be used to associate dirty VM pages
with file system buffers and thus cause them to be
flushed to physical media sooner rather than later.
>Release-Note:
>Audit-Trail:

From: Peter Pentchev <roam@ringlet.net>
To: Radim Kolar <hsn@netmag.cz>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/70916: msync.2 manpage update
Date: Wed, 25 Aug 2004 11:44:15 +0300

 On Tue, Aug 24, 2004 at 09:39:30PM +0200, Radim Kolar wrote:
 > 
 > >Number:         70916
 > >Category:       docs
 > >Synopsis:       msync.2 manpage update
 > >Description:
 > Msync function is obsolete as noted in mmap manpage, but this information
 > is missing from msync manpage itself.
 
 What do people think about the following patch?
 
 G'luck,
 Peter
 
 Index: src/lib/libc/sys/msync.2
 ===================================================================
 RCS file: /home/ncvs/src/lib/libc/sys/msync.2,v
 retrieving revision 1.27
 diff -u -r1.27 msync.2
 --- src/lib/libc/sys/msync.2	30 Jun 2004 20:09:10 -0000	1.27
 +++ src/lib/libc/sys/msync.2	25 Aug 2004 08:43:05 -0000
 @@ -114,3 +114,12 @@
  .Fn msync
  system call first appeared in
  .Bx 4.4 .
 +.Sh BUGS
 +The
 +.Fn msync
 +system call is obsolete since
 +.Bx
 +implements a coherent file system buffer cache.
 +However, it may be
 +used to associate dirty VM pages with file system buffers and thus cause
 +them to be flushed to physical media sooner rather than later.
 
 -- 
 Peter Pentchev	roam@ringlet.net    roam@cnsys.bg    roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 If this sentence didn't exist, somebody would have invented it.

From: Peter Pentchev <roam@ringlet.net>
To: bug-followup@FreeBSD.org
Cc: Radim Kolar <hsn@netmag.cz>
Subject: Re: docs/70916: msync.2 manpage update
Date: Wed, 25 Aug 2004 11:56:07 +0300

 On Wed, Aug 25, 2004 at 08:50:26AM +0000, Peter Pentchev wrote:
 >  On Tue, Aug 24, 2004 at 09:39:30PM +0200, Radim Kolar wrote:
 >  > 
 >  > >Number:         70916
 >  > >Category:       docs
 >  > >Synopsis:       msync.2 manpage update
 >  > >Description:
 >  > Msync function is obsolete as noted in mmap manpage, but this information
 >  > is missing from msync manpage itself.
 >  
 >  What do people think about the following patch?
 [snip]
 >  +However, it may be
 >  +used to associate dirty VM pages with file system buffers and thus cause
 
 Or rather, how about this one, which re-wraps the text...
 
 G'luck,
 Peter
 
 Index: src/lib/libc/sys/msync.2
 ===================================================================
 RCS file: /home/ncvs/src/lib/libc/sys/msync.2,v
 retrieving revision 1.27
 diff -u -r1.27 msync.2
 --- src/lib/libc/sys/msync.2	30 Jun 2004 20:09:10 -0000	1.27
 +++ src/lib/libc/sys/msync.2	25 Aug 2004 08:54:23 -0000
 @@ -114,3 +114,12 @@
  .Fn msync
  system call first appeared in
  .Bx 4.4 .
 +.Sh BUGS
 +The
 +.Fn msync
 +system call is obsolete since
 +.Bx
 +implements a coherent file system buffer cache.
 +However, it may be used to associate dirty VM pages with file system
 +buffers and thus cause them to be flushed to physical media sooner
 +rather than later.
 
 -- 
 Peter Pentchev	roam@ringlet.net    roam@cnsys.bg    roam@FreeBSD.org
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
 What would this sentence be like if pi were 3?
Responsible-Changed-From-To: freebsd-doc->roam 
Responsible-Changed-By: delphij 
Responsible-Changed-When: Mon Feb 14 16:33:56 GMT 2005 
Responsible-Changed-Why:  
roam@ seems have a good patch for this but never committed it... 

http://www.freebsd.org/cgi/query-pr.cgi?pr=70916 
State-Changed-From-To: open->closed 
State-Changed-By: rodrigc 
State-Changed-When: Sat Sep 17 18:07:04 GMT 2005 
State-Changed-Why:  
Patch has been applied.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=70916 
>Unformatted:
