mirror of https://github.com/mkerrisk/man-pages
ffixes, grfixex
This commit is contained in:
parent
daa84982ed
commit
85467cb847
|
@ -163,10 +163,10 @@ These functions take a pointer to a structure as returned by
|
|||
.BR dbopen (),
|
||||
and sometimes one or more pointers to key/data structures and a flag value.
|
||||
.TP
|
||||
type
|
||||
.I type
|
||||
The type of the underlying access method (and file format).
|
||||
.TP
|
||||
close
|
||||
.I close
|
||||
A pointer to a routine to flush any cached information to disk, free any
|
||||
allocated resources, and close the underlying file(s).
|
||||
Since key/data pairs may be cached in memory, failing to sync the file
|
||||
|
@ -175,12 +175,12 @@ with a
|
|||
or
|
||||
.I sync
|
||||
function may result in inconsistent or lost information.
|
||||
.I Close
|
||||
.I close
|
||||
routines return \-1 on error (setting
|
||||
.IR errno )
|
||||
and 0 on success.
|
||||
.TP
|
||||
del
|
||||
.I del
|
||||
A pointer to a routine to remove key/data pairs from the database.
|
||||
.IP
|
||||
The parameter
|
||||
|
@ -193,14 +193,14 @@ Delete the record referenced by the cursor.
|
|||
The cursor must have previously been initialized.
|
||||
.RE
|
||||
.IP
|
||||
.I Delete
|
||||
.I delete
|
||||
routines return \-1 on error (setting
|
||||
.IR errno ),
|
||||
0 on success, and 1 if the specified
|
||||
.I key
|
||||
was not in the file.
|
||||
.TP
|
||||
fd
|
||||
.I fd
|
||||
A pointer to a routine which returns a file descriptor representative
|
||||
of the underlying database.
|
||||
A file descriptor referencing the same file will be returned to all
|
||||
|
@ -217,26 +217,26 @@ locking functions.
|
|||
The file descriptor is not necessarily associated with any of the
|
||||
underlying files used by the access method.
|
||||
No file descriptor is available for in memory databases.
|
||||
.I Fd
|
||||
.I fd
|
||||
routines return \-1 on error (setting
|
||||
.IR errno ),
|
||||
and the file descriptor on success.
|
||||
.TP
|
||||
get
|
||||
.I get
|
||||
A pointer to a routine which is the interface for keyed retrieval from
|
||||
the database.
|
||||
The address and length of the data associated with the specified
|
||||
.I key
|
||||
are returned in the structure referenced by
|
||||
.IR data .
|
||||
.I Get
|
||||
.I get
|
||||
routines return \-1 on error (setting
|
||||
.IR errno ),
|
||||
0 on success, and 1 if the
|
||||
.I key
|
||||
was not in the file.
|
||||
.TP
|
||||
put
|
||||
.I put
|
||||
A pointer to a routine to store key/data pairs in the database.
|
||||
.IP
|
||||
The parameter
|
||||
|
@ -307,7 +307,7 @@ The default behavior of the
|
|||
routines is to enter the new key/data pair, replacing any previously
|
||||
existing key.
|
||||
.IP
|
||||
.I Put
|
||||
.I put
|
||||
routines return \-1 on error (setting
|
||||
.IR errno ),
|
||||
0 on success, and 1 if the
|
||||
|
@ -315,7 +315,7 @@ routines return \-1 on error (setting
|
|||
.I flag
|
||||
was set and the key already exists in the file.
|
||||
.TP
|
||||
seq
|
||||
.I seq
|
||||
A pointer to a routine which is the interface for sequential
|
||||
retrieval from the database.
|
||||
The address and length of the key are returned in the structure
|
||||
|
@ -398,7 +398,7 @@ and
|
|||
access methods because they each imply that the keys have an inherent
|
||||
order which does not change.
|
||||
.IP
|
||||
.I Seq
|
||||
.I seq
|
||||
routines return \-1 on error (setting
|
||||
.IR errno ),
|
||||
0 on success and 1 if there are no key/data pairs less than or greater
|
||||
|
@ -411,7 +411,7 @@ available, the
|
|||
.I seq
|
||||
routines return 2.
|
||||
.TP
|
||||
sync
|
||||
.I sync
|
||||
A pointer to a routine to flush any cached information to disk.
|
||||
If the database is in memory only, the
|
||||
.I sync
|
||||
|
@ -433,7 +433,7 @@ field of the
|
|||
manual page for more information.)
|
||||
.RE
|
||||
.IP
|
||||
.I Sync
|
||||
.I sync
|
||||
routines return \-1 on error (setting
|
||||
.IR errno )
|
||||
and 0 on success.
|
||||
|
@ -454,10 +454,10 @@ The elements of the
|
|||
.I DBT
|
||||
structure are defined as follows:
|
||||
.TP
|
||||
data
|
||||
.I data
|
||||
A pointer to a byte string.
|
||||
.TP
|
||||
size
|
||||
.I size
|
||||
The length of the byte string.
|
||||
.PP
|
||||
Key and data byte strings may reference strings of essentially unlimited
|
||||
|
|
Loading…
Reference in New Issue