.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)ndbm.3 6.3 (Berkeley) %G%
+.\" @(#)ndbm.3 6.6 (Berkeley) %G%
.\"
-.TH NDBM 3X ""
+.TH NDBM 3 ""
.UC 6
.SH NAME
dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr \- data base subroutines
These functions maintain key/content pairs in a data base.
The functions will handle very large (a billion blocks)
databases and will access a keyed item in one or two file system accesses.
+This package replaces the earlier
+.IR dbm (3x)
+library, which managed only a single database.
.PP
.IR Key s
and
(key = dbm_firstkey(db); key.dptr != NULL; key = dbm_nextkey(db))
.PP
.I Dbm_error
-returns non-zero when an error has occured reading or writing the database.
+returns non-zero when an error has occurred reading or writing the database.
.I Dbm_clearerr
resets the error condition on the named database.
.SH DIAGNOSTICS
.I datum
indicate errors with a null (0)
.I dptr.
+If
+.IR dbm_store
+called with a
+.I flags
+value of
+.B DBM_INSERT
+finds an existing entry with the same key
+it returns 1.
.SH BUGS
The `.pag' file will contain holes so that its apparent size is about
four times its actual content. Older UNIX systems may create real
and
.I dbm_nextkey
depends on a hashing function, not on anything interesting.
+.SH SEE ALSO
+dbm(3X)