bin/70929: [patch] mpool(3): ignored function argument documented to work

[dada at sbox.tugraz.at]

>Number:         70929
>Category:       bin
>Synopsis:       mpool(3): ignored function argument documented to work
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 25 07:10:35 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Martin Kammerhofer
>Release:        FreeBSD 4.10-RELEASE-p2 i386
>Organization:
Graz Uni
>Environment:
System: FreeBSD Martin.liebt.Susi 4.10-RELEASE-p2 FreeBSD 4.10-RELEASE-p2 #1: Mon Aug 16 14:26:52 CEST 2004 toor at Martin.liebt.Susi:/mnt/redhat/freebsd/usr/src/sys/compile/GEIDORF4 i386
>Description:
The mpool(3) manpage explains an unimplemented feature of
mpool_open(). The `key' argument is unused by the code.  BTW, the
mpool(3) interface has been dropped in later versions of db(3);
i.e. Berkeley DB >= 2.0 does not have it any more. See also the last
sentence of the dbopen(3) manpage.
>How-To-Repeat:
gcc -W -Wunused /usr/src/lib/libc/db/mpool/mpool.c 2>&1 | grep key
>Fix:
--- /usr/src/lib/libc/db/man/mpool.3.orig	Sun Feb 23 20:45:52 2003
+++ /usr/src/lib/libc/db/man/mpool.3	Sun Aug 22 17:18:36 2004
@@ -65,32 +65,16 @@
 .Nm mpool
 library interface is intended to provide page oriented buffer management
 of files.
-The buffers may be shared between processes.
 .Pp
 The
 .Fn mpool_open
 function initializes a memory pool.
 The
 .Fa key
-argument is the byte string used to negotiate between multiple
-processes wishing to share buffers.
-If the file buffers are mapped in shared memory, all processes using
-the same key will share the buffers.
-If
-.Fa key
-is
-.Dv NULL ,
-the buffers are mapped into private memory.
+argument is currently ignored.
 The
 .Fa fd
 argument is a file descriptor for the underlying file, which must be seekable.
-If
-.Fa key
-is
-.No non\- Ns Dv NULL
-and matches a file already being mapped, the
-.Fa fd
-argument is ignored.
 .Pp
 The
 .Fa pagesize

--=_2ubyz9a36hwk--

>Release-Note:
>Audit-Trail:
>Unformatted:
 This message is in MIME format.
 
 --=_2ubyz9a36hwk
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Disposition: inline
 Content-Transfer-Encoding: 7bit
 
 
 --=_2ubyz9a36hwk
 Content-Type: text/plain; charset=UTF-8; name="mpool.pr"
 Content-Disposition: inline; filename="mpool.pr"
 Content-Transfer-Encoding: 7bit