docs/70916: msync.2 manpage update

[Peter Pentchev]

The following reply was made to PR docs/70916; it has been noted by GNATS.

From: Peter Pentchev <roam at ringlet.net>
To: bug-followup at FreeBSD.org
Cc: Radim Kolar <hsn at 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 at ringlet.net    roam at cnsys.bg    roam at 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?