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: Radim Kolar <hsn at netmag.cz>
Cc: bug-followup at 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 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
 If this sentence didn't exist, somebody would have invented it.