| recno.3 (1573) | recno.3 (14272) |
|---|---|
| 1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 15 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" | 1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 15 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" |
| 32.\" @(#)recno.3 8.3 (Berkeley) 2/21/94 | 32.\" @(#)recno.3 8.5 (Berkeley) 8/18/94 |
| 33.\" | 33.\" |
| 34.TH RECNO 3 "February 21, 1994" | 34.TH RECNO 3 "August 18, 1994" |
| 35.UC 7 36.SH NAME 37recno \- record number database access method 38.SH SYNOPSIS 39.nf 40.ft B 41#include <sys/types.h> 42#include <db.h> --- 49 unchanged lines hidden (view full) --- 92.TP 93R_FIXEDLEN 94The records are fixed-length, not byte delimited. 95The structure element 96.I reclen 97specifies the length of the record, and the structure element 98.I bval 99is used as the pad character. | 35.UC 7 36.SH NAME 37recno \- record number database access method 38.SH SYNOPSIS 39.nf 40.ft B 41#include <sys/types.h> 42#include <db.h> --- 49 unchanged lines hidden (view full) --- 92.TP 93R_FIXEDLEN 94The records are fixed-length, not byte delimited. 95The structure element 96.I reclen 97specifies the length of the record, and the structure element 98.I bval 99is used as the pad character. |
| 100Any records, inserted into the database, that are less than 101.I reclen 102bytes long are automatically padded. |
|
| 100.TP 101R_NOKEY 102In the interface specified by 103.IR dbopen , 104the sequential record retrieval fills in both the caller's key and 105data structures. 106If the R_NOKEY flag is specified, the 107.I cursor --- 63 unchanged lines hidden (view full) --- 171.IR recno_t , 172as defined in the <db.h> include file. 173This type is normally the largest unsigned integral type available to 174the implementation. 175The 176.I size 177field of the key should be the size of that type. 178.PP | 103.TP 104R_NOKEY 105In the interface specified by 106.IR dbopen , 107the sequential record retrieval fills in both the caller's key and 108data structures. 109If the R_NOKEY flag is specified, the 110.I cursor --- 63 unchanged lines hidden (view full) --- 174.IR recno_t , 175as defined in the <db.h> include file. 176This type is normally the largest unsigned integral type available to 177the implementation. 178The 179.I size 180field of the key should be the size of that type. 181.PP |
| 182Because there can be no meta-data associated with the underlying 183recno access method files, any changes made to the default values 184(e.g. fixed record length or byte separator value) must be explicitly 185specified each time the file is opened. 186.PP |
|
| 179In the interface specified by 180.IR dbopen , 181using the 182.I put 183interface to create a new record will cause the creation of multiple, 184empty records if the record number is more than one greater than the 185largest record currently in the database. | 187In the interface specified by 188.IR dbopen , 189using the 190.I put 191interface to create a new record will cause the creation of multiple, 192empty records if the record number is more than one greater than the 193largest record currently in the database. |
| 194.SH ERRORS 195The 196.I recno 197access method routines may fail and set 198.I errno 199for any of the errors specified for the library routine 200.IR dbopen (3) 201or the following: 202.TP 203[EINVAL] 204An attempt was made to add a record to a fixed-length database that 205was too large to fit. |
|
| 186.SH "SEE ALSO" | 206.SH "SEE ALSO" |
| 207.IR btree (3) |
|
| 187.IR dbopen (3), 188.IR hash (3), 189.IR mpool (3), | 208.IR dbopen (3), 209.IR hash (3), 210.IR mpool (3), |
| 190.IR recno (3) | |
| 191.sp 192.IR "Document Processing in a Relational Database System" , 193Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, 194Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. 195.SH BUGS 196Only big and little endian byte order is supported. | 211.sp 212.IR "Document Processing in a Relational Database System" , 213Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, 214Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. 215.SH BUGS 216Only big and little endian byte order is supported. |