CVS commit: src/lib/libc/db/man
Module Name:src Committed By: jruoho Date: Thu Dec 16 11:49:35 UTC 2010 Modified Files: src/lib/libc/db/man: mpool.3 Log Message: Use .Fn. To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/lib/libc/db/man/mpool.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libc/db/man/mpool.3 diff -u src/lib/libc/db/man/mpool.3:1.9 src/lib/libc/db/man/mpool.3:1.10 --- src/lib/libc/db/man/mpool.3:1.9 Thu Aug 7 16:42:43 2003 +++ src/lib/libc/db/man/mpool.3 Thu Dec 16 11:49:35 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: mpool.3,v 1.9 2003/08/07 16:42:43 agc Exp $ +.\ $NetBSD: mpool.3,v 1.10 2010/12/16 11:49:35 jruoho Exp $ .\ .\ Copyright (c) 1990, 1993 .\ The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\ .\ @(#)mpool.3 8.1 (Berkeley) 6/4/93 .\ -.Dd April 17, 2003 +.Dd December 16, 2010 .Dt MPOOL 3 .Os .Sh NAME @@ -67,7 +67,7 @@ The buffers may be shared between processes. .Pp The function -.Nm mpool_open +.Fn mpool_open initializes a memory pool. The .Fa key @@ -105,7 +105,7 @@ processes sharing the file. .Pp The -.Nm mpool_filter +.Fn mpool_filter function is intended to make transparent input and output processing of the pages possible. If the @@ -122,7 +122,7 @@ written. .Pp The function -.Nm mpool_new +.Fn mpool_new takes an MPOOL pointer and an address as arguments. If a new page can be allocated, a pointer to the page is returned and the page number is stored into the @@ -133,7 +133,7 @@ is returned and errno is set. .Pp The function -.Nm mpool_get +.Fn mpool_get takes a MPOOL pointer and a page number as arguments. If the page exists, a pointer to the page is returned. Otherwise, @@ -142,14 +142,14 @@ The flags parameter is not currently used. .Pp The function -.Nm mpool_put +.Fn mpool_put unpins the page referenced by .Fa pgaddr . .Fa pgaddr must be an address previously returned by -.Nm mpool_get +.Fn mpool_get or -.Nm mpool_new . +.Fn mpool_new . The flag value is specified by or'ing any of the following values: .Bl -tag -width MPOOL_DIRTYX -offset indent .It Dv MPOOL_DIRTY @@ -157,35 +157,35 @@ file. .El .Pp -.Nm mpool_put +.Fn mpool_put returns 0 on success and \-1 if an error occurs. .Pp The function -.Nm mpool_sync +.Fn mpool_sync writes all modified pages associated with the MPOOL pointer to the backing file. -.Nm mpool_sync +.Fn mpool_sync returns 0 on success and \-1 if an error occurs. .Pp The -.Nm mpool_close +.Fn mpool_close function frees up any allocated memory associated with the memory pool cookie. Modified pages are .Em not written to the backing file. -.Nm mpool_close +.Fn mpool_close returns 0 on success and \-1 if an error occurs. .Sh ERRORS The -.Nm mpool_open +.Fn mpool_open function may fail and set .Va errno for any of the errors specified for the library routine .Xr malloc 3 . .Pp The -.Nm mpool_get +.Fn mpool_get function may fail and set .Va errno for the following: @@ -195,9 +195,9 @@ .El .Pp The -.Nm mpool_new +.Fn mpool_new and -.Nm mpool_get +.Fn mpool_get functions may fail and set .Va errno for any of the errors specified for the library routines @@ -207,14 +207,14 @@ .Xr malloc 3 . .Pp The -.Nm mpool_sync +.Fn mpool_sync function may fail and set .Va errno for any of the errors specified for the library routine .Xr write 2 . .Pp The -.Nm mpool_close +.Fn mpool_close function may fail and set .Va errno for any of the errors specified for the library routine
CVS commit: src/lib/libc/db/man
Module Name:src
Committed By: jruoho
Date: Thu Dec 16 11:57:20 UTC 2010
Modified Files:
src/lib/libc/db/man: hash.3
Log Message:
Fix the references and -offset indent.
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/lib/libc/db/man/hash.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/db/man/hash.3
diff -u src/lib/libc/db/man/hash.3:1.13 src/lib/libc/db/man/hash.3:1.14
--- src/lib/libc/db/man/hash.3:1.13 Mon Mar 22 19:30:53 2010
+++ src/lib/libc/db/man/hash.3 Thu Dec 16 11:57:20 2010
@@ -1,4 +1,4 @@
-.\ $NetBSD: hash.3,v 1.13 2010/03/22 19:30:53 joerg Exp $
+.\ $NetBSD: hash.3,v 1.14 2010/12/16 11:57:20 jruoho Exp $
.\
.\ Copyright (c) 1990, 1993
.\ The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\
.\ @(#)hash.3 8.6 (Berkeley) 8/18/94
.\
-.Dd September 5, 2008
+.Dd December 16, 2010
.Dt HASH 3
.Os
.Sh NAME
@@ -53,8 +53,8 @@
.Fn dbopen
is defined in the
.In db.h
-include file as follows:
-.Bd -literal
+header as follows:
+.Bd -literal -offset indent
typedef struct {
u_int bsize;
u_int ffactor;
@@ -152,16 +152,21 @@
.Xr recno 3
.Pp
.Rs
-.%T Dynamic Hash Tables
+.%T Dynamic Hash Tables
.%A Per-Ake Larson
.%J Communications of the ACM
.%D April 1988
+.%N Issue 4
+.%V Volume 31
.Re
.Rs
-.%T A New Hash Package for UNIX
+.%T A New Hash Package for UNIX
.%A Margo Seltzer
-.%J USENIX Proceedings
-.%D Winter 1991
+.%I USENIX Association
+.%B Proceedings of the 1991 Winter USENIX Technical Conference
+.%D January 1991
+.%P 173-184
+.%U http://www.usenix.org/publications/library/proceedings/seltzer2.pdf
.Re
.Sh BUGS
Only big and little endian byte order is supported.
CVS commit: src/lib/libc/db/man
Module Name:src
Committed By: jruoho
Date: Thu Dec 16 12:08:16 UTC 2010
Modified Files:
src/lib/libc/db/man: dbopen.3
Log Message:
.Fn, offset indent, complete reference.
To generate a diff of this commit:
cvs rdiff -u -r1.18 -r1.19 src/lib/libc/db/man/dbopen.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/db/man/dbopen.3
diff -u src/lib/libc/db/man/dbopen.3:1.18 src/lib/libc/db/man/dbopen.3:1.19
--- src/lib/libc/db/man/dbopen.3:1.18 Mon Mar 22 19:30:53 2010
+++ src/lib/libc/db/man/dbopen.3 Thu Dec 16 12:08:16 2010
@@ -1,4 +1,4 @@
-.\ $NetBSD: dbopen.3,v 1.18 2010/03/22 19:30:53 joerg Exp $
+.\ $NetBSD: dbopen.3,v 1.19 2010/12/16 12:08:16 jruoho Exp $
.\
.\ Copyright (c) 1990, 1993
.\ The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\
.\ @(#)dbopen.3 8.5 (Berkeley) 1/2/94
.\
-.Dd April 17, 2003
+.Dd December 16, 2010
.Dt DBOPEN 3
.Os
.Sh NAME
@@ -60,8 +60,9 @@
and
.Xr recno 3 .
.Pp
-.Nm
-opens
+The
+.Fn dbopen
+function opens
.Fa file
for reading and/or writing.
Files never intended to be preserved on disk may be created by setting
@@ -134,15 +135,16 @@
.Dv NULL ,
each access method will use defaults appropriate for the system and
the access method.
-.Pp
-.Nm
-returns a pointer to a DB structure on success and
+.Ss The DB Structure
+The
+.Fn dbopen
+function returns a pointer to a DB structure on success and
.Dv NULL
on error.
The DB structure is defined in the
.In db.h
include file, and contains at least the following fields:
-.Bd -literal
+.Bd -literal -offset indent
typedef struct {
DBTYPE type;
int (*close)(const DB *db);
@@ -162,7 +164,7 @@
.Nm ,
and sometimes one or more pointers to key/data structures and a flag
value.
-.Bl -tag -width closex
+.Bl -tag -width closex -offset indent
.It Fa type
The type of the underlying access method (and file format).
.It Fa close
@@ -420,10 +422,10 @@
.Va errno )
and 0 on success.
.El
-.Ss KEY/DATA PAIRS
+.Ss Key/data Pairs
Access to all file types is based on key/data pairs.
Both keys and data are represented by the following data structure:
-.Bd -literal
+.Bd -literal -offset indent
typedef struct {
void *data;
size_t size;
@@ -431,7 +433,7 @@
.Ed
.Pp
The elements of the DBT structure are defined as follows:
-.Bl -tag -width datax
+.Bl -tag -width datax -offset indent
.It Fa data
A pointer to a byte string.
.It Fa size
@@ -515,11 +517,13 @@
.Xr recno 3
.Pp
.Rs
-.%T LIBTP: Portable, Modular Transactions for UNIX
+.%T LIBTP: Portable, Modular Transactions for UNIX
.%A Margo Seltzer
.%A Michael Olson
-.%J USENIX proceedings
-.%D Winter 1992
+.%I USENIX Association
+.%B Proceedings of the 1992 Winter USENIX Technical Conference
+.%D 1992
+.%P 9-25
.Re
.Sh BUGS
The typedef DBT is a mnemonic for
CVS commit: src/lib/libc/db/man
Module Name:src Committed By: jruoho Date: Wed May 5 06:55:57 UTC 2010 Modified Files: src/lib/libc/db/man: dbm_clearerr.3 Log Message: Note the POSIX compliance (already since SUSv2, '97). To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/lib/libc/db/man/dbm_clearerr.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libc/db/man/dbm_clearerr.3 diff -u src/lib/libc/db/man/dbm_clearerr.3:1.4 src/lib/libc/db/man/dbm_clearerr.3:1.5 --- src/lib/libc/db/man/dbm_clearerr.3:1.4 Wed Apr 30 13:10:50 2008 +++ src/lib/libc/db/man/dbm_clearerr.3 Wed May 5 06:55:57 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: dbm_clearerr.3,v 1.4 2008/04/30 13:10:50 martin Exp $ +.\ $NetBSD: dbm_clearerr.3,v 1.5 2010/05/05 06:55:57 jruoho Exp $ .\ .\ Copyright (c) 2004 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -27,7 +27,7 @@ .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\ POSSIBILITY OF SUCH DAMAGE. .\ -.Dd April 30, 2004 +.Dd May 5, 2010 .Dt DBM_CLEARERR 3 .Os .Sh NAME @@ -298,7 +298,9 @@ and .Fn dbm_store functions conform to -.St -xpg4.2 . +.St -xpg4.2 +and +.St -susv2 . The .Fn dbm_dirfno function is an extension.
CVS commit: src/lib/libc/db/man
Module Name:src Committed By: joerg Date: Sat Apr 11 20:39:15 UTC 2009 Modified Files: src/lib/libc/db/man: dbopen.3 Log Message: -width needs an argument, so provide one. To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/lib/libc/db/man/dbopen.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libc/db/man/dbopen.3 diff -u src/lib/libc/db/man/dbopen.3:1.16 src/lib/libc/db/man/dbopen.3:1.17 --- src/lib/libc/db/man/dbopen.3:1.16 Tue Aug 31 17:11:33 2004 +++ src/lib/libc/db/man/dbopen.3 Sat Apr 11 20:39:15 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: dbopen.3,v 1.16 2004/08/31 17:11:33 uwe Exp $ +.\ $NetBSD: dbopen.3,v 1.17 2009/04/11 20:39:15 joerg Exp $ .\ .\ Copyright (c) 1990, 1993 .\ The Regents of the University of California. All rights reserved. @@ -401,7 +401,7 @@ routine has no effect and will always succeed. .Pp The flag value may be set to the following value: -.Bl -tag -width +.Bl -tag -width .Dv R_RECNOSYNC .It Dv R_RECNOSYNC If the .Dv DB_RECNO
