.\"
.\" @(#)recno.3 8.5 (Berkeley) 8/18/94
.\"
-.TH RECNO 3 2012-04-23 "" "Linux Programmer's Manual"
+.TH RECNO 3 2017-09-15 "" "Linux Programmer's Manual"
.UC 7
.SH NAME
recno \- record number database access method
Probably, you are looking for the APIs provided by the
.I libdb
library instead.
-
+.PP
The routine
.BR dbopen (3)
is the library interface to database files.
One of the supported file formats is record number files.
The general description of the database access methods is in
.BR dbopen (3),
-this manual page describes only the recno specific information.
+this manual page describes only the recno-specific information.
.PP
The record number data structure is either variable or fixed-length
records stored in a flat-file format, accessed by the logical record
as the cursor, if positioned after record number one, to shift down
one record.
.PP
-The recno access method specific data structure provided to
+The recno access-method-specific data structure provided to
.BR dbopen (3)
is defined in the
.I <db.h>
include file as follows:
.PP
.in +4n
-.nf
+.EX
typedef struct {
unsigned long flags;
unsigned int cachesize;
unsigned char bval;
char *bfname;
} RECNOINFO;
-.fi
+.EE
.in
.PP
The elements of this structure are defined as follows:
.TP
-flags
+.I flags
The flag value is specified by ORing
any of the following values:
.RS
advisory, and the access method will allocate more memory rather than fail.
If
.I cachesize
-is 0 (no size is specified) a default cache is used.
+is 0 (no size is specified), a default cache is used.
.TP
.I psize
The recno access method stores the in-memory copies of its records
This value is the size (in bytes) of the pages used for nodes in that tree.
If
.I psize
-is 0 (no page size is specified) a page size is chosen based on the
-underlying file system I/O block size.
+is 0 (no page size is specified), a page size is chosen based on the
+underlying filesystem I/O block size.
See
.BR btree (3)
for more information.
big endian order would be the number 4,321.
If
.I lorder
-is 0 (no order is specified) the current host order is used.
+is 0 (no order is specified), the current host order is used.
.TP
.I reclen
The length of a fixed-length record.
.I data
field of the key should be a pointer to a memory location of type
.IR recno_t ,
-as defined in th
+as defined in the
.I <db.h>
include file.
This type is normally the largest unsigned integral type available to
.BR dbopen (3),
.BR hash (3),
.BR mpool (3)
-
+.PP
.IR "Document Processing in a Relational Database System" ,
Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman,
Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982.