Add diclaimer of copyright to _osname() manual page.
[unix-history] / lib / libc / db / doc / recno.3.ps
index 6ea5344..3f39b47 100644 (file)
@@ -197,13 +197,13 @@ grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL
 %%BeginPageSetup
 BP
 %%EndPageSetup
 %%BeginPageSetup
 BP
 %%EndPageSetup
-/F0 10/Times-Roman@0 SF 175.95(RECNO\(3\) 1993 RECNO\(3\))72 48 R/F1 9
-/Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0
-(recno \255 record number database access method)108 96 Q F1(SYNOPSIS)72 112.8
-Q/F2 10/Times-Bold@0 SF(#include <sys/types.h>)108 124.8 Q(#include <db)108
-136.8 Q(.h>)-.4 E F1(DESCRIPTION)72 153.6 Q F0 1.158(The routine)108 165.6 R/F3
-10/Times-Italic@0 SF(dbopen)3.658 E F0 1.158(is the library interf)3.658 F
-1.158(ace to database \214les.)-.1 F 1.157
+/F0 10/Times-Roman@0 SF 130.12(RECNO\(3\) BSD)72 48 R(Programmer')2.5 E 2.5(sM)
+-.55 G 130.12(anual RECNO\(3\))340.17 48 R/F1 9/Times-Bold@0 SF -.18(NA)72 84 S
+(ME).18 E F0(recno \255 record number database access method)108 96 Q F1
+(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(#include <sys/types.h>)108 124.8 Q
+(#include <db)108 136.8 Q(.h>)-.4 E F1(DESCRIPTION)72 153.6 Q F0 1.158
+(The routine)108 165.6 R/F3 10/Times-Italic@0 SF(dbopen)3.658 E F0 1.158
+(is the library interf)3.658 F 1.158(ace to database \214les.)-.1 F 1.157
 (One of the supported \214le formats is record)6.158 F 1.159(number \214les.)
 108 177.6 R 1.159(The general description of the database access methods is in)
 6.159 F F3(dbopen)3.66 E F0 1.16(\(3\), this manual page).24 F
 (One of the supported \214le formats is record)6.158 F 1.159(number \214les.)
 108 177.6 R 1.159(The general description of the database access methods is in)
 6.159 F F3(dbopen)3.66 E F0 1.16(\(3\), this manual page).24 F
@@ -238,80 +238,87 @@ R .809(ed-length records.)-.15 F .809(If no v)5.809 F .809
 (ed-length records are padded with spaces.)-.15 E(cachesize)108 470.4 Q 3.159
 (As)144 482.4 S .659(uggested maximum size, in bytes, of the memory cache.)
 158.269 482.4 R .66(This v)5.659 F .66(alue is)-.25 F F2(only)3.16 E F0
 (ed-length records are padded with spaces.)-.15 E(cachesize)108 470.4 Q 3.159
 (As)144 482.4 S .659(uggested maximum size, in bytes, of the memory cache.)
 158.269 482.4 R .66(This v)5.659 F .66(alue is)-.25 F F2(only)3.16 E F0
-(advisory)3.16 E 3.16(,a)-.65 G .66(nd the)514.62 482.4 R
-(access method will allocate more memory rather than f)144 494.4 Q(ail.)-.1 E
-12.95(psize The)108 511.2 R .715
+(advisory)3.16 E 3.16(,a)-.65 G .66(nd the)514.62 482.4 R .046
+(access method will allocate more memory rather than f)144 494.4 R 2.546
+(ail. If)-.1 F F3(cac)2.546 E(hesize)-.15 E F0 2.546(is 0)2.546 F .046
+(\(no size is speci\214ed\) a)2.546 F(def)144 506.4 Q(ault cache is used.)-.1 E
+12.95(psize The)108 523.2 R .715
 (recno access method stores the in-memory copies of its records in a btree.)
 (recno access method stores the in-memory copies of its records in a btree.)
-3.216 F .715(This v)5.715 F .715(alue is the)-.25 F
-(size \(in bytes\) of the pages used for nodes in that tree.)144 523.2 Q(See)5
-E F3(btr)2.5 E(ee)-.37 E F0(\(3\) for more information.).18 E 3.51(bfname The)
-108 540 R .505
+3.215 F .716(This v)5.716 F .716(alue is the)-.25 F .805
+(size \(in bytes\) of the pages used for nodes in that tree.)144 535.2 R(If)
+5.805 E F3(psize)3.305 E F0 .805(is 0 \(no page size is speci\214ed\) a)3.305 F
+1.467
+(page size is chosen based on the underlying \214le system I/O block size.)144
+547.2 R(See)6.468 E F3(btr)3.968 E(ee)-.37 E F0 1.468(\(3\) for more).18 F
+(information.)144 559.2 Q 3.51(bfname The)108 576 R .505
 (recno access method stores the in-memory copies of its records in a btree.)
 (recno access method stores the in-memory copies of its records in a btree.)
-3.005 F .506(If bfname is non-)5.506 F .065(NULL, it speci\214es the name of t\
+3.006 F .505(If bfname is non-)5.505 F .065(NULL, it speci\214es the name of t\
 he btree \214le, as if speci\214ed as the \214le name for a dbopen of a btree)
 he btree \214le, as if speci\214ed as the \214le name for a dbopen of a btree)
-144 552 R(\214le.)144 564 Q 14.61(\215ags The)108 580.8 R(\215ag v)2.5 E
+144 588 R(\214le.)144 600 Q 14.61(\215ags The)108 616.8 R(\215ag v)2.5 E
 (alue is speci\214ed by)-.25 E F3(or)2.5 E F0('ing an).73 E 2.5(yo)-.15 G 2.5
 (alue is speci\214ed by)-.25 E F3(or)2.5 E F0('ing an).73 E 2.5(yo)-.15 G 2.5
-(ft)313.2 580.8 S(he follo)321.81 580.8 Q(wing v)-.25 E(alues:)-.25 E
-(R_FIXEDLEN)144 597.6 Q .962(The records are \214x)180 609.6 R .963
+(ft)313.2 616.8 S(he follo)321.81 616.8 Q(wing v)-.25 E(alues:)-.25 E
+(R_FIXEDLEN)144 633.6 Q .963(The records are \214x)180 645.6 R .963
 (ed-length, not byte delimited.)-.15 F .963(The structure element)5.963 F F3
 (ed-length, not byte delimited.)-.15 F .963(The structure element)5.963 F F3
--.37(re)3.463 G(clen).37 E F0(speci\214es)3.463 E
-(the length of the record, and the structure element)180 621.6 Q F3(bval)2.5 E
-F0(is used as the pad character)2.5 E(.)-.55 E(R_NOKEY)144 638.4 Q 2.34
-(In the interf)180 650.4 R 2.34(ace speci\214ed by)-.1 F F3(dbopen)4.84 E F0
-4.84(,t).24 G 2.34(he sequential record retrie)344.98 650.4 R -.25(va)-.25 G
-4.84<6c8c>.25 G 2.34(lls in both the)478.25 650.4 R(caller')180 662.4 Q 3.556
-(sk)-.55 G 1.357 -.15(ey a)217.336 662.4 T 1.057(nd data structures.).15 F
-1.057(If the R_NOKEY \215ag is speci\214ed, the)6.057 F F3(cur)3.557 E(sor)-.1
-E F0(routines)3.557 E .029(are not required to \214ll in the k)180 674.4 R .329
--.15(ey s)-.1 H 2.529(tructure. This).15 F .028(permits applications to retrie)
-2.529 F .328 -.15(ve r)-.25 H .028(ecords at).15 F
-(the end of \214les without reading all of the interv)180 686.4 Q
-(ening records.)-.15 E(R_SN)144 703.2 Q(APSHO)-.35 E(T)-.4 E .964
-(This \215ag requires that a snapshot of the \214le be tak)180 715.2 R .965
-(en when)-.1 F F3(dbopen)3.465 E F0 .965(is called, instead of)3.465 F
-(permitting an)180 727.2 Q 2.5(yu)-.15 G
-(nmodi\214ed records to be read from the original \214le.)245.96 727.2 Q
-209.835(16, May)72 768 R(1)535 768 Q EP
+-.37(re)3.462 G(clen).37 E F0(speci\214es)3.462 E
+(the length of the record, and the structure element)180 657.6 Q F3(bval)2.5 E
+F0(is used as the pad character)2.5 E(.)-.55 E(4.4 Berk)72 732 Q(ele)-.1 E 2.5
+(yD)-.15 G(istrib)132.57 732 Q 104.595(ution June)-.2 F(4, 1993)2.5 E(1)535 732
+Q EP
 %%Page: 2 2
 %%BeginPageSetup
 BP
 %%EndPageSetup
 %%Page: 2 2
 %%BeginPageSetup
 BP
 %%EndPageSetup
-/F0 10/Times-Roman@0 SF 175.95(RECNO\(3\) 1993 RECNO\(3\))72 48 R 9.62
-(lorder The)108 84 R 1.597(byte order for inte)4.097 F 1.596
-(gers in the stored database metadata.)-.15 F 1.596
-(The number should represent the)6.596 F .688(order as an inte)144 96 R .689
+/F0 10/Times-Roman@0 SF 130.12(RECNO\(3\) BSD)72 48 R(Programmer')2.5 E 2.5(sM)
+-.55 G 130.12(anual RECNO\(3\))340.17 48 R(R_NOKEY)144 84 Q 2.34(In the interf)
+180 96 R 2.34(ace speci\214ed by)-.1 F/F1 10/Times-Italic@0 SF(dbopen)4.84 E F0
+4.84(,t).24 G 2.34(he sequential record retrie)344.98 96 R -.25(va)-.25 G 4.84
+<6c8c>.25 G 2.34(lls in both the)478.25 96 R(caller')180 108 Q 3.557(sk)-.55 G
+1.357 -.15(ey a)217.337 108 T 1.057(nd data structures.).15 F 1.057
+(If the R_NOKEY \215ag is speci\214ed, the)6.057 F F1(cur)3.557 E(sor)-.1 E F0
+(routines)3.556 E .028(are not required to \214ll in the k)180 120 R .329 -.15
+(ey s)-.1 H 2.529(tructure. This).15 F .029(permits applications to retrie)
+2.529 F .329 -.15(ve r)-.25 H .029(ecords at).15 F
+(the end of \214les without reading all of the interv)180 132 Q(ening records.)
+-.15 E(R_SN)144 148.8 Q(APSHO)-.35 E(T)-.4 E .965
+(This \215ag requires that a snapshot of the \214le be tak)180 160.8 R .964
+(en when)-.1 F F1(dbopen)3.464 E F0 .964(is called, instead of)3.464 F
+(permitting an)180 172.8 Q 2.5(yu)-.15 G
+(nmodi\214ed records to be read from the original \214le.)245.96 172.8 Q 9.62
+(lorder The)108 189.6 R 1.596(byte order for inte)4.096 F 1.596
+(gers in the stored database metadata.)-.15 F 1.597
+(The number should represent the)6.597 F .689(order as an inte)144 201.6 R .689
 (ger; for e)-.15 F .689(xample, big endian order w)-.15 F .689
 (ger; for e)-.15 F .689(xample, big endian order w)-.15 F .689
-(ould be the number 4,321.)-.1 F(If)5.689 E/F1 10/Times-Italic@0 SF(lor)3.189 E
-(der)-.37 E F0 .689(is 0 \(no)3.189 F
-(order is speci\214ed\) the current host order is used.)144 108 Q 9.07
-(reclen The)108 124.8 R(length of a \214x)2.5 E(ed-length record.)-.15 E .972
-(The data part of the k)108 141.6 R -.15(ey)-.1 G .971(/data pair used by the \
-recno access method is the same as other access methods.).15 F .198(The k)108
-153.6 R .498 -.15(ey i)-.1 H 2.698(sd).15 G(if)157.504 153.6 Q 2.698
-(ferent. The)-.25 F F1(data)2.698 E F0 .198(\214eld of the k)2.698 F .499 -.15
-(ey s)-.1 H .199(hould be a pointer to a memory location of type).15 F F1 -.37
-(re)2.699 G(cno_t).37 E F0 2.699(,a).68 G(s)536.11 153.6 Q .506
-(de\214ned in the <db)108 165.6 R .506(.h> include \214le.)-.4 F .506
+(ould be the number 4,321.)-.1 F(If)5.689 E F1(lor)3.189 E(der)-.37 E F0 .688
+(is 0 \(no)3.189 F(order is speci\214ed\) the current host order is used.)144
+213.6 Q 9.07(reclen The)108 230.4 R(length of a \214x)2.5 E(ed-length record.)
+-.15 E .971(The data part of the k)108 247.2 R -.15(ey)-.1 G .972(/data pair u\
+sed by the recno access method is the same as other access methods.).15 F .199
+(The k)108 259.2 R .499 -.15(ey i)-.1 H 2.699(sd).15 G(if)157.507 259.2 Q 2.699
+(ferent. The)-.25 F F1(data)2.699 E F0 .199(\214eld of the k)2.699 F .499 -.15
+(ey s)-.1 H .198(hould be a pointer to a memory location of type).15 F F1 -.37
+(re)2.698 G(cno_t).37 E F0 2.698(,a).68 G(s)536.11 259.2 Q .505
+(de\214ned in the <db)108 271.2 R .506(.h> include \214le.)-.4 F .506
 (This type is normally the lar)5.506 F .506(gest unsigned inte)-.18 F .506
 (This type is normally the lar)5.506 F .506(gest unsigned inte)-.18 F .506
-(gral type a)-.15 F -.25(va)-.2 G .505(ilable to the).25 F 2.5
-(implementation. The)108 177.6 R F1(size)2.5 E F0(\214eld of the k)2.5 E .3
--.15(ey s)-.1 H(hould be the size of that type.).15 E .064(In the interf)108
-194.4 R .064(ace speci\214ed by)-.1 F F1(dbopen)2.564 E F0 2.564(,u).24 G .064
-(sing the)261.544 194.4 R F1(put)2.564 E F0(interf)2.564 E .064
-(ace to create a ne)-.1 F 2.564(wr)-.25 G .065
-(ecord will cause the creation of)414.436 194.4 R .755(multiple, empty records\
- if the record number is more than one greater than the lar)108 206.4 R .754
-(gest record currently in)-.18 F(the database.)108 218.4 Q/F2 9/Times-Bold@0 SF
-(SEE ALSO)72 235.2 Q F1(dbopen)108 247.2 Q F0(\(3\),).24 E F1(hash)2.5 E F0
+(gral type a)-.15 F -.25(va)-.2 G .506(ilable to the).25 F 2.5
+(implementation. The)108 283.2 R F1(size)2.5 E F0(\214eld of the k)2.5 E .3
+-.15(ey s)-.1 H(hould be the size of that type.).15 E .065(In the interf)108
+300 R .065(ace speci\214ed by)-.1 F F1(dbopen)2.564 E F0 2.564(,u).24 G .064
+(sing the)261.548 300 R F1(put)2.564 E F0(interf)2.564 E .064
+(ace to create a ne)-.1 F 2.564(wr)-.25 G .064
+(ecord will cause the creation of)414.44 300 R .755(multiple, empty records if\
+ the record number is more than one greater than the lar)108 312 R .755
+(gest record currently in)-.18 F(the database.)108 324 Q/F2 9/Times-Bold@0 SF
+(SEE ALSO)72 340.8 Q F1(dbopen)108 352.8 Q F0(\(3\),).24 E F1(hash)2.5 E F0
 (\(3\),).28 E F1(mpool)2.5 E F0(\(3\),).51 E F1 -.37(re)2.5 G(cno).37 E F0
 (\(3\),).28 E F1(mpool)2.5 E F0(\(3\),).51 E F1 -.37(re)2.5 G(cno).37 E F0
-(\(3\)).18 E F1 2.754(Document Pr)108 271.2 R 2.754
-(ocessing in a Relational Database System)-.45 F F0 5.255(,M).32 G 2.755
-(ichael Stonebrak)362.13 271.2 R(er)-.1 E 5.255(,H)-.4 G 2.755(eidi Stettner)
-454.06 271.2 R 5.255(,J)-.4 G(oseph)516.67 271.2 Q
-(Kalash, Antonin Guttman, Nadene L)108 283.2 Q
-(ynn, Memorandum No. UCB/ERL M82/32, May 1982.)-.55 E F2 -.09(BU)72 300 S(GS)
-.09 E F0(Only big and little endian byte order is supported.)108 312 Q 209.835
-(16, May)72 768 R(2)535 768 Q EP
+(\(3\)).18 E F1 2.755(Document Pr)108 376.8 R 2.755
+(ocessing in a Relational Database System)-.45 F F0 5.254(,M).32 G 2.754
+(ichael Stonebrak)362.134 376.8 R(er)-.1 E 5.254(,H)-.4 G 2.754(eidi Stettner)
+454.062 376.8 R 5.254(,J)-.4 G(oseph)516.67 376.8 Q
+(Kalash, Antonin Guttman, Nadene L)108 388.8 Q
+(ynn, Memorandum No. UCB/ERL M82/32, May 1982.)-.55 E F2 -.09(BU)72 405.6 S(GS)
+.09 E F0(Only big and little endian byte order is supported.)108 417.6 Q
+(4.4 Berk)72 732 Q(ele)-.1 E 2.5(yD)-.15 G(istrib)132.57 732 Q 104.595
+(ution June)-.2 F(4, 1993)2.5 E(2)535 732 Q EP
 %%Trailer
 end
 %%EOF
 %%Trailer
 end
 %%EOF