/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / perl / mac-perl / gdbm15st.bin / gdbm / README

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 06 52 45 41 44 4d 45 | 00 00 00 00 00 00 00 00 |..README|........|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 4d 50 53 | 20 00 00 00 00 00 00 00 |.TEXTMPS| .......|
|00000050| 00 00 00 00 00 37 34 00 | 00 01 ac a6 04 40 68 a6 |.....74.|.....@h.|
|00000060| 04 40 68 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.@h.....|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 59 75 00 00 |........|....Yu..|
|00000080| 54 68 69 73 20 69 73 20 | 72 65 6c 65 61 73 65 20 |This is |release |
|00000090| 31 2e 35 20 6f 66 20 47 | 4e 55 20 64 62 6d 2e 20 |1.5 of G|NU dbm. |
|000000a0| 20 42 65 74 74 65 72 20 | 64 6f 63 75 6d 65 6e 74 | Better |document|
|000000b0| 61 74 69 6f 6e 20 77 69 | 6c 6c 20 62 65 20 77 72 |ation wi|ll be wr|
|000000c0| 69 74 74 65 6e 0d 73 6f | 6f 6e 2e 20 20 46 6f 72 |itten.so|on.  For|
|000000d0| 20 6e 6f 77 2c 20 74 68 | 69 73 20 66 69 6c 65 20 | now, th|is file |
|000000e0| 62 72 69 65 66 6c 79 20 | 64 65 73 63 72 69 62 65 |briefly |describe|
|000000f0| 73 20 74 68 65 20 63 6f | 6e 74 65 6e 74 73 20 6f |s the co|ntents o|
|00000100| 66 20 74 68 69 73 0d 72 | 65 6c 65 61 73 65 20 61 |f this.r|elease a|
|00000110| 6e 64 20 68 6f 77 20 74 | 6f 20 75 73 65 20 69 74 |nd how t|o use it|
|00000120| 2e 0d 0d 54 68 65 20 66 | 69 6c 65 73 20 61 72 65 |...The f|iles are|
|00000130| 3a 0d 0d 43 4f 50 59 49 | 4e 47 09 09 2d 20 43 6f |:..COPYI|NG..- Co|
|00000140| 70 79 69 6e 67 20 69 6e | 66 6f 72 6d 61 74 69 6f |pying in|formatio|
|00000150| 6e 2e 0d 52 45 41 44 4d | 45 09 09 2d 20 54 68 69 |n..READM|E..- Thi|
|00000160| 73 20 66 69 6c 65 2e 0d | 0d 62 75 63 6b 65 74 2e |s file..|.bucket.|
|00000170| 63 2c 20 65 78 74 65 72 | 6e 2e 68 2c 20 66 61 6c |c, exter|n.h, fal|
|00000180| 6c 6f 63 2e 63 2c 20 66 | 69 6e 64 6b 65 79 2e 63 |loc.c, f|indkey.c|
|00000190| 2c 20 67 64 62 6d 2e 70 | 72 6f 74 6f 2c 20 67 64 |, gdbm.p|roto, gd|
|000001a0| 62 6d 63 6c 6f 73 65 2e | 63 2c 0d 67 64 62 6d 63 |bmclose.|c,.gdbmc|
|000001b0| 6f 6e 73 74 2e 68 20 67 | 64 62 6d 64 65 66 73 2e |onst.h g|dbmdefs.|
|000001c0| 68 2c 20 67 64 62 6d 64 | 65 6c 65 74 65 2e 63 2c |h, gdbmd|elete.c,|
|000001d0| 20 67 64 62 6d 65 72 72 | 6e 6f 2e 68 2c 20 67 64 | gdbmerr|no.h, gd|
|000001e0| 62 6d 66 65 74 63 68 2e | 63 2c 0d 67 64 62 6d 6f |bmfetch.|c,.gdbmo|
|000001f0| 70 65 6e 2e 63 2c 20 67 | 64 62 6d 72 65 6f 72 67 |pen.c, g|dbmreorg|
|00000200| 2e 63 2c 20 67 64 62 6d | 73 65 71 2e 63 2c 20 67 |.c, gdbm|seq.c, g|
|00000210| 64 62 6d 73 74 6f 72 65 | 2e 63 2c 20 67 6c 6f 62 |dbmstore|.c, glob|
|00000220| 61 6c 2e 63 2c 20 67 6e | 64 62 6d 2e 68 2c 0d 68 |al.c, gn|dbm.h,.h|
|00000230| 61 73 68 2e 63 20 73 79 | 73 74 65 6d 73 2e 68 2c |ash.c sy|stems.h,|
|00000240| 20 75 70 64 61 74 65 2e | 63 2c 20 76 65 72 73 69 | update.|c, versi|
|00000250| 6f 6e 2e 63 20 2d 20 53 | 6f 75 72 63 65 20 66 6f |on.c - S|ource fo|
|00000260| 72 20 47 4e 55 20 64 62 | 6d 20 6c 69 62 72 61 72 |r GNU db|m librar|
|00000270| 79 2e 0d 0d 64 62 6d 2e | 68 20 64 62 6d 69 6e 69 |y...dbm.|h dbmini|
|00000280| 74 2e 63 2c 20 64 65 6c | 65 74 65 2e 63 2c 20 66 |t.c, del|ete.c, f|
|00000290| 65 74 63 68 2e 63 2c 20 | 73 65 71 2e 63 2c 20 73 |etch.c, |seq.c, s|
|000002a0| 74 6f 72 65 2e 63 20 2d | 20 53 6f 75 72 63 65 20 |tore.c -| Source |
|000002b0| 66 6f 72 20 74 68 65 0d | 44 42 4d 20 69 6e 74 65 |for the.|DBM inte|
|000002c0| 72 66 61 63 65 2e 0d 0d | 64 62 6d 63 6c 6f 73 65 |rface...|dbmclose|
|000002d0| 2e 63 2c 20 64 62 6d 64 | 65 6c 65 74 65 2e 63 2c |.c, dbmd|elete.c,|
|000002e0| 20 64 62 6d 64 69 72 66 | 6e 6f 2e 63 2c 20 64 62 | dbmdirf|no.c, db|
|000002f0| 6d 66 65 74 63 68 2e 63 | 2c 20 64 62 6d 6f 70 65 |mfetch.c|, dbmope|
|00000300| 6e 2e 63 2c 20 64 62 6d | 70 61 67 66 6e 6f 2e 63 |n.c, dbm|pagfno.c|
|00000310| 0d 64 62 6d 73 65 71 2e | 63 2c 20 64 62 6d 73 74 |.dbmseq.|c, dbmst|
|00000320| 6f 72 65 2e 63 2c 20 6e | 64 62 6d 2e 68 20 2d 20 |ore.c, n|dbm.h - |
|00000330| 53 6f 75 72 63 65 20 66 | 6f 72 20 74 68 65 20 4e |Source f|or the N|
|00000340| 44 42 4d 20 69 6e 74 65 | 72 66 61 63 65 2e 0d 0d |DBM inte|rface...|
|00000350| 4d 61 6b 65 66 69 6c 65 | 20 09 2d 20 4d 61 6b 65 |Makefile| .- Make|
|00000360| 66 69 6c 65 2c 20 77 69 | 6c 6c 20 6d 61 6b 65 20 |file, wi|ll make |
|00000370| 67 64 62 6d 2e 61 20 20 | 28 42 53 44 20 61 6e 64 |gdbm.a  |(BSD and|
|00000380| 20 53 59 53 56 29 0d 74 | 65 73 74 67 64 62 6d 2e | SYSV).t|estgdbm.|
|00000390| 63 09 2d 20 41 20 73 69 | 6d 70 6c 65 20 74 65 73 |c.- A si|mple tes|
|000003a0| 74 20 70 72 6f 67 72 61 | 6d 2e 0d 74 65 73 74 64 |t progra|m..testd|
|000003b0| 62 6d 2e 63 09 2d 20 41 | 20 73 69 6d 70 6c 65 20 |bm.c.- A| simple |
|000003c0| 74 65 73 74 20 70 72 6f | 67 72 61 6d 2e 0d 74 65 |test pro|gram..te|
|000003d0| 73 74 6e 64 62 6d 2e 63 | 09 2d 20 41 20 73 69 6d |stndbm.c|.- A sim|
|000003e0| 70 6c 65 20 74 65 73 74 | 20 70 72 6f 67 72 61 6d |ple test| program|
|000003f0| 2e 0d 63 6f 6e 76 32 67 | 64 62 6d 2e 63 09 2d 20 |..conv2g|dbm.c.- |
|00000400| 41 20 64 62 6d 20 64 61 | 74 61 62 61 73 65 20 63 |A dbm da|tabase c|
|00000410| 6f 6e 76 65 72 73 69 6f | 6e 20 70 72 6f 67 72 61 |onversio|n progra|
|00000420| 6d 2e 0d 0d 43 48 41 4e | 47 45 53 20 66 72 6f 6d |m...CHAN|GES from|
|00000430| 20 31 2e 34 20 74 6f 20 | 31 2e 35 3a 0d 20 20 31 | 1.4 to |1.5:.  1|
|00000440| 2e 20 20 4d 69 6e 6f 72 | 20 62 75 67 20 66 69 78 |.  Minor| bug fix|
|00000450| 65 73 2e 20 20 53 65 65 | 20 74 68 65 20 43 68 61 |es.  See| the Cha|
|00000460| 6e 67 65 4c 6f 67 2e 0d | 20 20 32 2e 20 20 41 64 |ngeLog..|  2.  Ad|
|00000470| 64 65 64 20 67 64 62 6d | 63 6f 6e 73 74 2e 68 20 |ded gdbm|const.h |
|00000480| 74 6f 20 61 6c 6c 6f 77 | 20 75 73 65 72 73 20 74 |to allow| users t|
|00000490| 6f 20 63 68 61 6e 67 65 | 20 74 68 65 20 73 69 7a |o change| the siz|
|000004a0| 65 20 6f 66 20 74 68 65 | 0d 20 20 20 20 20 20 62 |e of the|.      b|
|000004b0| 75 63 6b 65 74 20 63 61 | 63 68 65 20 69 6e 20 74 |ucket ca|che in t|
|000004c0| 68 65 20 73 79 73 74 65 | 6d 73 2e 68 20 66 69 6c |he syste|ms.h fil|
|000004d0| 65 2e 0d 0d 43 48 41 4e | 47 45 53 20 66 72 6f 6d |e...CHAN|GES from|
|000004e0| 20 31 2e 30 20 74 6f 20 | 31 2e 34 3a 0d 20 20 31 | 1.0 to |1.4:.  1|
|000004f0| 2e 20 20 4d 61 69 6e 6c | 79 20 62 75 67 20 66 69 |.  Mainl|y bug fi|
|00000500| 78 65 73 2e 0d 20 20 32 | 2e 20 20 41 20 64 65 66 |xes..  2|.  A def|
|00000510| 69 6e 65 20 66 6f 72 20 | 22 64 62 6d 63 6c 6f 73 |ine for |"dbmclos|
|00000520| 65 28 29 22 20 77 61 73 | 20 61 64 64 65 64 20 74 |e()" was| added t|
|00000530| 6f 20 64 62 6d 2e 68 20 | 66 6f 72 20 74 68 6f 73 |o dbm.h |for thos|
|00000540| 65 20 66 65 77 20 0d 20 | 20 20 20 20 20 69 6d 70 |e few . |     imp|
|00000550| 6c 65 6d 65 6e 74 61 69 | 6f 6e 73 20 74 68 61 74 |lementai|ons that|
|00000560| 20 6e 65 65 64 20 74 68 | 61 74 20 63 61 6c 6c 2e | need th|at call.|
|00000570| 0d 20 20 33 2e 20 20 46 | 6f 72 20 64 65 74 61 69 |.  3.  F|or detai|
|00000580| 6c 73 2c 20 73 65 65 20 | 74 68 65 20 43 68 61 6e |ls, see |the Chan|
|00000590| 67 65 4c 6f 67 2e 0d 0d | 43 48 41 4e 47 45 53 20 |geLog...|CHANGES |
|000005a0| 66 72 6f 6d 20 30 2e 39 | 20 74 6f 20 31 2e 30 3a |from 0.9| to 1.0:|
|000005b0| 0d 20 20 31 2e 20 20 4d | 61 6b 65 66 69 6c 65 73 |.  1.  M|akefiles|
|000005c0| 20 77 65 72 65 20 63 6f | 6d 62 69 6e 65 64 20 69 | were co|mbined i|
|000005d0| 6e 74 6f 20 6f 6e 65 20 | 61 6e 64 20 61 20 66 65 |nto one |and a fe|
|000005e0| 77 20 6e 65 77 20 74 68 | 69 6e 67 73 20 61 64 64 |w new th|ings add|
|000005f0| 65 64 20 74 6f 20 69 74 | 2e 0d 20 20 32 2e 20 20 |ed to it|..  2.  |
|00000600| 53 65 76 65 72 61 6c 20 | 6d 69 6e 6f 72 20 62 75 |Several |minor bu|
|00000610| 67 73 20 77 65 72 65 20 | 66 69 78 65 64 20 69 6e |gs were |fixed in|
|00000620| 63 6c 75 64 69 6e 67 20 | 61 20 63 61 63 68 65 20 |cluding |a cache |
|00000630| 62 75 67 2e 0d 20 20 33 | 2e 20 20 54 77 6f 20 6e |bug..  3|.  Two n|
|00000640| 65 77 20 63 61 6c 6c 73 | 20 28 64 62 6d 5f 70 61 |ew calls| (dbm_pa|
|00000650| 67 66 6e 6f 2c 20 64 62 | 6d 5f 64 69 72 66 6e 6f |gfno, db|m_dirfno|
|00000660| 29 20 77 65 72 65 20 61 | 64 64 65 64 20 74 6f 20 |) were a|dded to |
|00000670| 74 68 65 20 4e 44 42 4d | 20 69 6e 74 65 72 66 61 |the NDBM| interfa|
|00000680| 63 65 2e 0d 20 20 33 2e | 20 20 41 20 63 6f 6e 76 |ce..  3.|  A conv|
|00000690| 65 72 73 69 6f 6e 20 70 | 72 6f 67 72 61 6d 20 66 |ersion p|rogram f|
|000006a0| 72 6f 6d 20 64 62 6d 20 | 66 69 6c 65 73 20 74 6f |rom dbm |files to|
|000006b0| 20 67 64 62 6d 20 66 69 | 6c 65 73 20 77 61 73 20 | gdbm fi|les was |
|000006c0| 61 64 64 65 64 2e 0d 20 | 20 34 2e 20 20 52 65 6f |added.. | 4.  Reo|
|000006d0| 72 67 61 6e 69 7a 65 20 | 77 61 73 20 63 68 61 6e |rganize |was chan|
|000006e0| 67 65 64 20 74 6f 20 61 | 6c 6c 6f 77 20 63 6f 6d |ged to a|llow com|
|000006f0| 70 6c 65 78 20 66 69 6c | 65 20 6e 61 6d 65 73 2e |plex fil|e names.|
|00000700| 20 28 64 69 72 2f 66 69 | 6c 65 20 66 6f 72 6d 29 | (dir/fi|le form)|
|00000710| 0d 20 20 35 2e 20 20 74 | 65 73 74 67 64 62 6d 2c |.  5.  t|estgdbm,|
|00000720| 20 74 65 73 74 6e 64 62 | 6d 2c 20 61 6e 64 20 74 | testndb|m, and t|
|00000730| 65 73 74 64 62 6d 20 77 | 65 72 65 20 6d 6f 64 69 |estdbm w|ere modi|
|00000740| 66 69 65 64 20 74 6f 20 | 72 65 74 75 72 6e 20 6b |fied to |return k|
|00000750| 65 79 20 61 6e 64 20 64 | 61 74 61 0d 20 20 20 20 |ey and d|ata.    |
|00000760| 20 20 70 61 69 72 73 20 | 77 68 65 72 65 20 6e 65 |  pairs |where ne|
|00000770| 65 64 65 64 20 61 6e 64 | 20 74 6f 20 74 61 6b 65 |eded and| to take|
|00000780| 20 61 6e 20 6f 70 74 69 | 6f 6e 61 6c 20 66 69 6c | an opti|onal fil|
|00000790| 65 20 6e 61 6d 65 20 61 | 73 20 61 6e 20 61 72 67 |e name a|s an arg|
|000007a0| 75 6d 65 6e 74 2e 0d 20 | 20 20 20 20 20 74 65 73 |ument.. |     tes|
|000007b0| 74 67 64 62 6d 20 68 61 | 64 20 73 6f 6d 65 20 63 |tgdbm ha|d some c|
|000007c0| 6f 6d 6d 61 6e 64 20 63 | 68 61 72 61 63 74 65 72 |ommand c|haracter|
|000007d0| 73 20 63 68 61 6e 67 65 | 64 2e 0d 20 20 36 2e 20 |s change|d..  6. |
|000007e0| 20 54 68 65 20 44 42 4d | 20 61 6e 64 20 4e 44 42 | The DBM| and NDB|
|000007f0| 4d 20 69 6e 74 65 72 66 | 61 63 65 73 20 77 65 72 |M interf|aces wer|
|00000800| 65 20 73 65 70 61 72 61 | 74 65 64 2e 0d 20 20 37 |e separa|ted..  7|
|00000810| 2e 20 20 41 6e 20 69 6e | 63 6c 75 64 65 20 66 69 |.  An in|clude fi|
|00000820| 6c 65 20 66 6f 72 20 64 | 62 6d 20 75 73 65 72 73 |le for d|bm users|
|00000830| 20 77 61 73 20 61 64 64 | 65 64 2e 20 28 64 62 6d | was add|ed. (dbm|
|00000840| 2e 68 29 0d 20 20 38 2e | 20 20 54 68 65 20 69 6e |.h).  8.|  The in|
|00000850| 63 6c 75 64 65 20 66 69 | 6c 65 20 66 6f 72 20 6e |clude fi|le for n|
|00000860| 64 62 6d 20 75 73 65 72 | 73 20 77 61 73 20 72 65 |dbm user|s was re|
|00000870| 6e 61 6d 65 64 20 6e 64 | 62 6d 2e 68 2e 20 28 49 |named nd|bm.h. (I|
|00000880| 74 20 77 61 73 20 67 6e | 64 62 6d 2e 68 2e 29 0d |t was gn|dbm.h.).|
|00000890| 0d 43 48 41 4e 47 45 53 | 20 66 72 6f 6d 20 30 2e |.CHANGES| from 0.|
|000008a0| 38 20 74 6f 20 30 2e 39 | 3a 0d 20 20 31 2e 20 20 |8 to 0.9|:.  1.  |
|000008b0| 54 68 65 20 68 61 73 68 | 20 66 75 6e 63 74 69 6f |The hash| functio|
|000008c0| 6e 20 63 68 61 6e 67 65 | 64 2e 0d 20 20 32 2e 20 |n change|d..  2. |
|000008d0| 20 54 68 65 20 66 69 6c | 65 20 66 6f 72 6d 61 74 | The fil|e format|
|000008e0| 20 63 68 61 6e 67 65 64 | 2e 0d 20 20 33 2e 20 20 | changed|..  3.  |
|000008f0| 54 68 65 72 65 20 77 61 | 73 20 61 20 63 6f 6d 70 |There wa|s a comp|
|00000900| 6c 65 74 65 20 72 65 77 | 72 69 74 65 20 6f 66 20 |lete rew|rite of |
|00000910| 66 61 6c 6c 6f 63 2e 63 | 2e 0d 20 20 34 2e 20 20 |falloc.c|..  4.  |
|00000920| 54 68 65 72 65 20 77 65 | 72 65 20 61 64 64 65 64 |There we|re added|
|00000930| 20 63 6f 6d 70 61 74 69 | 62 6c 69 74 79 20 72 6f | compati|blity ro|
|00000940| 75 74 69 6e 65 73 20 66 | 6f 72 20 6e 64 62 6d 2e |utines f|or ndbm.|
|00000950| 0d 20 20 35 2e 20 20 54 | 68 65 20 66 69 6c 65 20 |.  5.  T|he file |
|00000960| 6e 61 6d 65 73 20 66 6f | 72 20 64 62 6d 20 63 6f |names fo|r dbm co|
|00000970| 6d 70 61 74 69 62 69 6c | 69 74 79 20 72 6f 75 74 |mpatibil|ity rout|
|00000980| 69 6e 65 73 20 77 65 72 | 65 20 6d 61 64 65 20 74 |ines wer|e made t|
|00000990| 6f 0d 20 20 20 20 20 20 | 6c 6f 6f 6b 20 6c 69 6b |o.      |look lik|
|000009a0| 65 20 64 62 6d 2e 0d 20 | 20 36 2e 20 20 54 65 73 |e dbm.. | 6.  Tes|
|000009b0| 74 20 70 72 6f 67 72 61 | 6d 73 20 63 68 61 6e 67 |t progra|ms chang|
|000009c0| 65 64 2e 0d 20 20 37 2e | 20 20 53 75 70 70 6f 72 |ed..  7.|  Suppor|
|000009d0| 74 20 66 6f 72 20 53 79 | 73 74 65 6d 20 56 2e 0d |t for Sy|stem V..|
|000009e0| 20 20 38 2e 20 20 56 61 | 72 69 6f 75 73 20 6f 74 |  8.  Va|rious ot|
|000009f0| 68 65 72 20 73 6d 61 6c | 6c 20 63 68 61 6e 67 65 |her smal|l change|
|00000a00| 73 2e 0d 20 20 39 2e 20 | 20 54 68 65 20 6e 65 65 |s..  9. | The nee|
|00000a10| 64 20 66 6f 72 20 72 65 | 63 6f 76 65 72 79 20 61 |d for re|covery a|
|00000a20| 6e 64 20 61 73 73 6f 63 | 69 61 74 65 64 20 63 6f |nd assoc|iated co|
|00000a30| 64 65 20 77 61 73 20 72 | 65 6d 6f 76 65 64 2e 0d |de was r|emoved..|
|00000a40| 0d 0d 47 4e 55 20 64 62 | 6d 20 69 73 20 61 20 73 |..GNU db|m is a s|
|00000a50| 65 74 20 6f 66 20 64 61 | 74 61 62 61 73 65 20 72 |et of da|tabase r|
|00000a60| 6f 75 74 69 6e 65 73 20 | 74 68 61 74 20 75 73 65 |outines |that use|
|00000a70| 20 65 78 74 65 6e 64 69 | 62 6c 65 20 68 61 73 68 | extendi|ble hash|
|00000a80| 69 6e 67 20 61 6e 64 0d | 77 6f 72 6b 73 20 73 69 |ing and.|works si|
|00000a90| 6d 69 6c 61 72 20 74 6f | 20 74 68 65 20 73 74 61 |milar to| the sta|
|00000aa0| 6e 64 61 72 64 20 55 4e | 49 58 20 64 62 6d 20 72 |ndard UN|IX dbm r|
|00000ab0| 6f 75 74 69 6e 65 73 2e | 20 20 54 68 65 20 62 61 |outines.|  The ba|
|00000ac0| 73 69 63 20 75 6e 69 74 | 20 6f 66 0d 64 61 74 61 |sic unit| of.data|
|00000ad0| 20 69 73 20 74 68 65 20 | 73 74 72 75 63 74 75 72 | is the |structur|
|00000ae0| 65 0d 0d 20 20 74 79 70 | 65 64 65 66 20 73 74 72 |e..  typ|edef str|
|00000af0| 75 63 74 20 7b 0d 20 20 | 20 20 20 20 20 20 20 20 |uct {.  |        |
|00000b00| 20 20 20 63 68 61 72 20 | 2a 64 70 74 72 3b 0d 20 |   char |*dptr;. |
|00000b10| 20 20 20 20 20 20 20 20 | 20 20 20 20 69 6e 74 20 |        |    int |
|00000b20| 20 20 64 73 69 7a 65 3b | 0d 20 20 20 20 20 20 20 |  dsize;|.       |
|00000b30| 20 20 20 7d 20 64 61 74 | 75 6d 3b 0d 0d 54 68 65 |   } dat|um;..The|
|00000b40| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 69 73 20 61 20 | followi|ng is a |
|00000b50| 71 75 69 63 6b 20 6c 69 | 73 74 20 6f 66 20 74 68 |quick li|st of th|
|00000b60| 65 20 72 6f 75 74 69 6e | 65 73 2e 20 20 41 66 74 |e routin|es.  Aft|
|00000b70| 65 72 20 74 68 69 73 20 | 6c 69 73 74 2c 20 61 0d |er this |list, a.|
|00000b80| 6c 6f 6e 67 65 72 20 64 | 65 73 63 72 69 70 74 69 |longer d|escripti|
|00000b90| 6f 6e 20 6f 66 20 65 61 | 63 68 20 72 6f 75 74 69 |on of ea|ch routi|
|00000ba0| 6e 65 20 77 69 6c 6c 20 | 62 65 20 67 69 76 65 6e |ne will |be given|
|00000bb0| 2e 20 20 41 6e 20 69 6e | 63 6c 75 64 65 20 66 69 |.  An in|clude fi|
|00000bc0| 6c 65 0d 77 69 6c 6c 20 | 62 65 20 70 72 6f 64 75 |le.will |be produ|
|00000bd0| 63 65 64 20 74 68 61 74 | 20 63 61 6e 20 62 65 20 |ced that| can be |
|00000be0| 69 6e 63 6c 75 64 65 64 | 20 62 79 20 74 68 65 20 |included| by the |
|00000bf0| 75 73 65 72 2e 20 54 68 | 65 20 66 69 6c 65 20 69 |user. Th|e file i|
|00000c00| 73 0d 22 67 64 62 6d 2e | 68 22 2e 20 20 54 68 65 |s."gdbm.|h".  The|
|00000c10| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 72 6f 75 74 69 | followi|ng routi|
|00000c20| 6e 65 73 20 61 72 65 20 | 64 65 66 69 6e 65 64 20 |nes are |defined |
|00000c30| 69 6e 20 74 65 72 6d 73 | 20 6f 66 20 67 64 62 6d |in terms| of gdbm|
|00000c40| 2e 68 3a 0d 0d 20 20 47 | 44 42 4d 5f 46 49 4c 45 |.h:..  G|DBM_FILE|
|00000c50| 20 67 64 62 6d 5f 6f 70 | 65 6e 20 28 20 6e 61 6d | gdbm_op|en ( nam|
|00000c60| 65 2c 20 62 6c 6f 63 6b | 5f 73 69 7a 65 2c 20 72 |e, block|_size, r|
|00000c70| 65 61 64 5f 77 72 69 74 | 65 2c 20 6d 6f 64 65 2c |ead_writ|e, mode,|
|00000c80| 20 66 61 74 61 6c 5f 66 | 75 6e 63 20 29 0d 0d 20 | fatal_f|unc ).. |
|00000c90| 20 76 6f 69 64 20 67 64 | 62 6d 5f 63 6c 6f 73 65 | void gd|bm_close|
|00000ca0| 20 28 20 64 62 66 20 29 | 0d 20 20 0d 20 20 69 6e | ( dbf )|.  .  in|
|00000cb0| 74 20 67 64 62 6d 5f 73 | 74 6f 72 65 20 28 20 64 |t gdbm_s|tore ( d|
|00000cc0| 62 66 2c 20 6b 65 79 2c | 20 63 6f 6e 74 65 6e 74 |bf, key,| content|
|00000cd0| 2c 20 66 6c 61 67 73 20 | 29 0d 0d 20 20 64 61 74 |, flags |)..  dat|
|00000ce0| 75 6d 20 67 64 62 6d 5f | 66 65 74 63 68 20 28 20 |um gdbm_|fetch ( |
|00000cf0| 64 62 66 2c 20 6b 65 79 | 20 29 0d 0d 20 20 69 6e |dbf, key| )..  in|
|00000d00| 74 20 67 64 62 6d 5f 64 | 65 6c 65 74 65 20 28 20 |t gdbm_d|elete ( |
|00000d10| 64 62 66 2c 20 6b 65 79 | 20 29 0d 0d 20 20 64 61 |dbf, key| )..  da|
|00000d20| 74 75 6d 20 67 64 62 6d | 5f 66 69 72 73 74 6b 65 |tum gdbm|_firstke|
|00000d30| 79 20 28 20 64 62 66 20 | 29 0d 0d 20 20 64 61 74 |y ( dbf |)..  dat|
|00000d40| 75 6d 20 67 64 62 6d 5f | 6e 65 78 74 6b 65 79 20 |um gdbm_|nextkey |
|00000d50| 28 20 64 62 66 2c 20 6b | 65 79 20 29 0d 0d 20 20 |( dbf, k|ey )..  |
|00000d60| 69 6e 74 20 67 64 62 6d | 5f 72 65 6f 72 67 61 6e |int gdbm|_reorgan|
|00000d70| 69 7a 65 20 28 20 64 62 | 66 20 29 0d 0d 0d 46 6f |ize ( db|f )...Fo|
|00000d80| 72 20 63 6f 6d 70 61 74 | 69 62 69 6c 69 74 79 20 |r compat|ibility |
|00000d90| 77 69 74 68 20 74 68 65 | 20 73 74 61 6e 64 61 72 |with the| standar|
|00000da0| 64 20 64 62 6d 2c 20 74 | 68 65 20 66 6f 6c 6c 6f |d dbm, t|he follo|
|00000db0| 77 69 6e 67 20 72 6f 75 | 74 69 6e 65 73 20 61 72 |wing rou|tines ar|
|00000dc0| 65 20 0d 64 65 66 69 6e | 65 64 2e 20 20 54 68 65 |e .defin|ed.  The|
|00000dd0| 72 65 20 69 73 20 61 6e | 20 69 6e 63 6c 75 64 65 |re is an| include|
|00000de0| 20 66 69 6c 65 20 66 6f | 72 20 64 62 6d 20 75 73 | file fo|r dbm us|
|00000df0| 65 72 73 20 63 61 6c 6c | 65 64 20 22 64 62 6d 2e |ers call|ed "dbm.|
|00000e00| 68 22 2e 0d 0d 20 20 69 | 6e 74 20 64 62 6d 69 6e |h"...  i|nt dbmin|
|00000e10| 69 74 20 28 20 6e 61 6d | 65 20 29 0d 0d 20 20 69 |it ( nam|e )..  i|
|00000e20| 6e 74 20 73 74 6f 72 65 | 20 28 20 6b 65 79 2c 20 |nt store| ( key, |
|00000e30| 63 6f 6e 74 65 6e 74 20 | 29 0d 0d 20 20 64 61 74 |content |)..  dat|
|00000e40| 75 6d 20 66 65 74 63 68 | 20 28 20 6b 65 79 20 29 |um fetch| ( key )|
|00000e50| 0d 0d 20 20 69 6e 74 20 | 64 65 6c 65 74 65 20 28 |..  int |delete (|
|00000e60| 20 6b 65 79 20 29 0d 0d | 20 20 64 61 74 75 6d 20 | key )..|  datum |
|00000e70| 66 69 72 73 74 6b 65 79 | 20 28 29 0d 0d 20 20 64 |firstkey| ()..  d|
|00000e80| 61 74 75 6d 20 6e 65 78 | 74 6b 65 79 20 28 20 6b |atum nex|tkey ( k|
|00000e90| 65 79 20 29 0d 0d 0d 54 | 68 65 72 65 20 61 72 65 |ey )...T|here are|
|00000ea0| 20 61 6c 73 6f 20 63 6f | 6d 70 61 74 69 62 69 6c | also co|mpatibil|
|00000eb0| 69 74 79 20 72 6f 75 74 | 69 6e 65 73 20 66 6f 72 |ity rout|ines for|
|00000ec0| 20 6e 64 62 6d 2e 20 20 | 46 6f 72 20 6e 64 62 6d | ndbm.  |For ndbm|
|00000ed0| 20 63 6f 6d 70 61 74 69 | 62 6c 69 74 79 0d 72 6f | compati|blity.ro|
|00000ee0| 75 74 69 6e 65 73 2c 20 | 79 6f 75 20 6e 65 65 64 |utines, |you need|
|00000ef0| 20 74 68 65 20 69 6e 63 | 6c 75 64 65 20 66 69 6c | the inc|lude fil|
|00000f00| 65 20 22 6e 64 62 6d 2e | 68 22 2e 20 20 54 68 65 |e "ndbm.|h".  The|
|00000f10| 20 72 6f 75 74 69 6e 65 | 73 20 61 72 65 3a 0d 0d | routine|s are:..|
|00000f20| 44 42 4d 20 2a 64 62 6d | 5f 6f 70 65 6e 20 28 6e |DBM *dbm|_open (n|
|00000f30| 61 6d 65 2c 20 66 6c 61 | 67 73 2c 20 6d 6f 64 65 |ame, fla|gs, mode|
|00000f40| 29 0d 0d 76 6f 69 64 20 | 64 62 6d 5f 63 6c 6f 73 |)..void |dbm_clos|
|00000f50| 65 20 28 66 69 6c 65 29 | 0d 0d 64 61 74 75 6d 20 |e (file)|..datum |
|00000f60| 64 62 6d 5f 66 65 74 63 | 68 20 28 66 69 6c 65 2c |dbm_fetc|h (file,|
|00000f70| 20 6b 65 79 29 0d 0d 69 | 6e 74 20 64 62 6d 5f 73 | key)..i|nt dbm_s|
|00000f80| 74 6f 72 65 20 28 66 69 | 6c 65 2c 20 6b 65 79 2c |tore (fi|le, key,|
|00000f90| 20 63 6f 6e 74 65 6e 74 | 2c 20 66 6c 61 67 73 29 | content|, flags)|
|00000fa0| 0d 0d 69 6e 74 20 64 62 | 6d 5f 64 65 6c 65 74 65 |..int db|m_delete|
|00000fb0| 20 28 66 69 6c 65 2c 20 | 6b 65 79 29 0d 0d 64 61 | (file, |key)..da|
|00000fc0| 74 75 6d 20 64 62 6d 5f | 66 69 72 73 74 6b 65 79 |tum dbm_|firstkey|
|00000fd0| 20 28 66 69 6c 65 29 0d | 0d 64 61 74 75 6d 20 64 | (file).|.datum d|
|00000fe0| 62 6d 5f 6e 65 78 74 6b | 65 79 20 28 66 69 6c 65 |bm_nextk|ey (file|
|00000ff0| 29 0d 0d 69 6e 74 20 64 | 62 6d 5f 65 72 72 6f 72 |)..int d|bm_error|
|00001000| 20 28 66 69 6c 65 29 0d | 0d 69 6e 74 20 64 62 6d | (file).|.int dbm|
|00001010| 5f 63 6c 65 61 72 65 72 | 72 20 28 66 69 6c 65 29 |_clearer|r (file)|
|00001020| 0d 0d 69 6e 74 20 64 62 | 6d 5f 70 61 67 66 6e 6f |..int db|m_pagfno|
|00001030| 20 28 66 69 6c 65 29 0d | 0d 69 6e 74 20 64 62 6d | (file).|.int dbm|
|00001040| 5f 64 69 72 66 6e 6f 20 | 28 66 69 6c 65 29 0d 0d |_dirfno |(file)..|
|00001050| 0d 44 65 73 63 72 69 70 | 74 69 6f 6e 20 6f 66 20 |.Descrip|tion of |
|00001060| 47 4e 55 20 64 62 6d 20 | 72 6f 75 74 69 6e 65 73 |GNU dbm |routines|
|00001070| 2e 0d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |..------|--------|
|00001080| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00001090| 2d 2d 0d 0d 47 4e 55 20 | 64 62 6d 20 61 6c 6c 6f |--..GNU |dbm allo|
|000010a0| 77 73 20 6d 75 6c 74 69 | 70 6c 65 20 64 61 74 61 |ws multi|ple data|
|000010b0| 20 66 69 6c 65 73 2e 20 | 20 41 20 72 6f 75 74 69 | files. | A routi|
|000010c0| 6e 65 20 74 68 61 74 20 | 6f 70 65 6e 73 20 61 20 |ne that |opens a |
|000010d0| 67 64 62 6d 20 66 69 6c | 65 0d 69 73 20 64 65 73 |gdbm fil|e.is des|
|000010e0| 69 67 6e 61 74 65 64 20 | 61 73 20 61 20 22 72 65 |ignated |as a "re|
|000010f0| 61 64 65 72 22 20 6f 72 | 20 61 20 22 77 72 69 74 |ader" or| a "writ|
|00001100| 65 72 22 2e 20 20 4f 6e | 6c 79 20 6f 6e 65 20 77 |er".  On|ly one w|
|00001110| 72 69 74 65 72 20 6d 61 | 79 20 6f 70 65 6e 20 61 |riter ma|y open a|
|00001120| 0d 67 64 62 6d 20 66 69 | 6c 65 20 61 6e 64 20 6d |.gdbm fi|le and m|
|00001130| 61 6e 79 20 72 65 61 64 | 65 72 73 20 6d 61 79 20 |any read|ers may |
|00001140| 6f 70 65 6e 20 74 68 65 | 20 66 69 6c 65 2e 20 20 |open the| file.  |
|00001150| 52 65 61 64 65 72 73 20 | 61 6e 64 20 77 72 69 74 |Readers |and writ|
|00001160| 65 72 73 20 63 61 6e 0d | 6e 6f 74 20 6f 70 65 6e |ers can.|not open|
|00001170| 20 74 68 65 20 67 64 62 | 6d 20 66 69 6c 65 20 61 | the gdb|m file a|
|00001180| 74 20 74 68 65 20 73 61 | 6d 65 20 74 69 6d 65 2e |t the sa|me time.|
|00001190| 20 54 68 65 20 70 72 6f | 63 65 64 75 72 65 20 66 | The pro|cedure f|
|000011a0| 6f 72 20 6f 70 65 6e 69 | 6e 67 20 61 0d 67 64 62 |or openi|ng a.gdb|
|000011b0| 6d 20 66 69 6c 65 20 69 | 73 3a 0d 0d 47 44 42 4d |m file i|s:..GDBM|
|000011c0| 5f 46 49 4c 45 20 64 62 | 66 3b 0d 0d 64 62 66 20 |_FILE db|f;..dbf |
|000011d0| 3d 20 67 64 62 6d 5f 6f | 70 65 6e 20 28 20 6e 61 |= gdbm_o|pen ( na|
|000011e0| 6d 65 2c 20 62 6c 6f 63 | 6b 5f 73 69 7a 65 2c 20 |me, bloc|k_size, |
|000011f0| 72 65 61 64 5f 77 72 69 | 74 65 2c 20 6d 6f 64 65 |read_wri|te, mode|
|00001200| 2c 20 66 61 74 61 6c 5f | 66 75 6e 63 20 29 0d 0d |, fatal_|func )..|
|00001210| 54 68 65 20 70 61 72 61 | 6d 65 74 65 72 73 20 61 |The para|meters a|
|00001220| 72 65 3a 0d 20 20 63 68 | 61 72 20 2a 6e 61 6d 65 |re:.  ch|ar *name|
|00001230| 20 2d 20 74 68 65 20 6e | 61 6d 65 20 6f 66 20 74 | - the n|ame of t|
|00001240| 68 65 20 66 69 6c 65 20 | 28 74 68 65 20 63 6f 6d |he file |(the com|
|00001250| 70 6c 65 74 65 20 6e 61 | 6d 65 2c 20 67 64 62 6d |plete na|me, gdbm|
|00001260| 20 64 6f 65 73 0d 09 20 | 20 6e 6f 74 20 61 70 70 | does.. | not app|
|00001270| 65 6e 64 20 61 6e 79 20 | 63 68 61 72 61 63 74 65 |end any |characte|
|00001280| 72 73 20 74 6f 20 74 68 | 69 73 20 6e 61 6d 65 29 |rs to th|is name)|
|00001290| 0d 20 20 69 6e 74 20 62 | 6c 6f 63 6b 5f 73 69 7a |.  int b|lock_siz|
|000012a0| 65 20 2d 20 74 68 65 20 | 73 69 7a 65 20 6f 66 20 |e - the |size of |
|000012b0| 61 20 73 69 6e 67 6c 65 | 20 74 72 61 6e 73 66 65 |a single| transfe|
|000012c0| 72 20 66 72 6f 6d 20 64 | 69 73 6b 20 74 6f 20 6d |r from d|isk to m|
|000012d0| 65 6d 6f 72 79 2e 0d 09 | 20 20 54 68 69 73 20 70 |emory...|  This p|
|000012e0| 61 72 61 6d 65 74 65 72 | 20 69 73 20 69 67 6e 6f |arameter| is igno|
|000012f0| 72 65 64 20 75 6e 6c 65 | 73 73 20 74 68 65 20 66 |red unle|ss the f|
|00001300| 69 6c 65 20 69 73 20 61 | 20 6e 65 77 20 66 69 6c |ile is a| new fil|
|00001310| 65 2e 0d 09 20 20 54 68 | 65 20 6d 69 6e 69 6d 75 |e...  Th|e minimu|
|00001320| 6d 20 73 69 7a 65 20 69 | 73 20 35 31 32 2e 20 20 |m size i|s 512.  |
|00001330| 49 66 20 69 74 20 69 73 | 20 6c 65 73 73 20 74 68 |If it is| less th|
|00001340| 61 6e 20 35 31 32 2c 20 | 64 62 6d 20 77 69 6c 6c |an 512, |dbm will|
|00001350| 0d 09 20 20 75 73 65 20 | 74 68 65 20 73 74 61 74 |..  use |the stat|
|00001360| 20 62 6c 6f 63 6b 20 73 | 69 7a 65 20 66 6f 72 20 | block s|ize for |
|00001370| 74 68 65 20 66 69 6c 65 | 20 73 79 73 74 65 6d 2e |the file| system.|
|00001380| 0d 20 20 69 6e 74 20 72 | 65 61 64 5f 77 72 69 74 |.  int r|ead_writ|
|00001390| 65 20 2d 20 30 20 3d 3e | 20 72 65 61 64 65 72 2c |e - 0 =>| reader,|
|000013a0| 20 31 20 3d 3e 20 77 72 | 69 74 65 72 2c 20 32 20 | 1 => wr|iter, 2 |
|000013b0| 3d 3e 20 77 72 69 74 65 | 72 20 28 69 66 20 74 68 |=> write|r (if th|
|000013c0| 65 20 64 61 74 61 62 61 | 73 65 0d 09 20 20 64 6f |e databa|se..  do|
|000013d0| 65 73 20 6e 6f 74 20 65 | 78 69 73 74 2c 20 63 72 |es not e|xist, cr|
|000013e0| 65 61 74 65 20 61 20 6e | 65 77 20 6f 6e 65 2c 20 |eate a n|ew one, |
|000013f0| 33 20 3d 3e 20 77 72 69 | 74 65 72 20 61 6e 64 20 |3 => wri|ter and |
|00001400| 63 72 65 61 74 65 20 61 | 20 6e 65 77 0d 09 20 20 |create a| new..  |
|00001410| 64 61 74 61 62 61 73 65 | 20 72 65 67 61 72 64 6c |database| regardl|
|00001420| 65 73 73 20 69 66 20 6f | 6e 65 20 65 78 69 73 74 |ess if o|ne exist|
|00001430| 73 2e 20 20 28 44 65 66 | 69 6e 65 64 20 69 6e 20 |s.  (Def|ined in |
|00001440| 67 64 62 6d 2e 68 20 61 | 73 0d 09 20 20 47 44 42 |gdbm.h a|s..  GDB|
|00001450| 4d 5f 52 45 41 44 45 52 | 2c 20 47 44 42 4d 5f 57 |M_READER|, GDBM_W|
|00001460| 52 49 54 45 52 2c 20 47 | 44 42 4d 5f 57 52 43 52 |RITER, G|DBM_WRCR|
|00001470| 45 41 54 2c 20 47 44 42 | 4d 5f 4e 45 57 44 42 2e |EAT, GDB|M_NEWDB.|
|00001480| 29 0d 20 20 69 6e 74 20 | 6d 6f 64 65 20 2d 20 66 |).  int |mode - f|
|00001490| 69 6c 65 20 6d 6f 64 65 | 20 28 73 65 65 20 63 68 |ile mode| (see ch|
|000014a0| 6d 6f 64 28 32 29 20 61 | 6e 64 20 6f 70 65 6e 28 |mod(2) a|nd open(|
|000014b0| 32 29 29 20 69 66 20 74 | 68 65 20 66 69 6c 65 20 |2)) if t|he file |
|000014c0| 69 73 20 63 72 65 61 74 | 65 64 2e 0d 20 20 76 6f |is creat|ed..  vo|
|000014d0| 69 64 20 28 2a 66 61 74 | 61 6c 5f 66 75 6e 63 29 |id (*fat|al_func)|
|000014e0| 20 28 29 20 2d 20 61 20 | 66 75 6e 63 74 69 6f 6e | () - a |function|
|000014f0| 20 66 6f 72 20 64 62 6d | 20 74 6f 20 63 61 6c 6c | for dbm| to call|
|00001500| 20 69 66 20 69 74 20 64 | 65 74 65 63 74 73 20 61 | if it d|etects a|
|00001510| 0d 09 20 20 66 61 74 61 | 6c 20 65 72 72 6f 72 2e |..  fata|l error.|
|00001520| 20 54 68 65 20 6f 6e 6c | 79 20 70 61 72 61 6d 65 | The onl|y parame|
|00001530| 74 65 72 20 6f 66 20 74 | 68 69 73 20 66 75 6e 63 |ter of t|his func|
|00001540| 74 69 6f 6e 20 69 73 20 | 61 20 73 74 72 69 6e 67 |tion is |a string|
|00001550| 2e 0d 09 20 20 49 66 20 | 74 68 65 20 76 61 6c 75 |...  If |the valu|
|00001560| 65 20 6f 66 20 30 20 69 | 73 20 70 72 6f 76 69 64 |e of 0 i|s provid|
|00001570| 65 64 2c 20 67 64 62 6d | 20 77 69 6c 6c 20 75 73 |ed, gdbm| will us|
|00001580| 65 20 61 20 64 65 66 61 | 75 6c 74 20 66 75 6e 63 |e a defa|ult func|
|00001590| 74 69 6f 6e 2e 0d 0d 54 | 68 65 20 72 65 74 75 72 |tion...T|he retur|
|000015a0| 6e 20 76 61 6c 75 65 2c | 20 64 62 66 2c 20 69 73 |n value,| dbf, is|
|000015b0| 20 74 68 65 20 70 6f 69 | 6e 74 65 72 20 6e 65 65 | the poi|nter nee|
|000015c0| 64 65 64 20 62 79 20 61 | 6c 6c 20 6f 74 68 65 72 |ded by a|ll other|
|000015d0| 20 72 6f 75 74 69 6e 65 | 73 20 74 6f 0d 61 63 63 | routine|s to.acc|
|000015e0| 65 73 73 20 74 68 61 74 | 20 67 64 62 6d 20 66 69 |ess that| gdbm fi|
|000015f0| 6c 65 2e 20 20 49 66 20 | 74 68 65 20 72 65 74 75 |le.  If |the retu|
|00001600| 72 6e 20 69 73 20 74 68 | 65 20 4e 55 4c 4c 20 70 |rn is th|e NULL p|
|00001610| 6f 69 6e 74 65 72 2c 20 | 67 64 62 6d 5f 6f 70 65 |ointer, |gdbm_ope|
|00001620| 6e 0d 77 61 73 20 6e 6f | 74 20 73 75 63 63 65 73 |n.was no|t succes|
|00001630| 73 66 75 6c 2e 20 20 54 | 68 65 20 65 72 72 6f 72 |sful.  T|he error|
|00001640| 73 20 63 61 6e 20 62 65 | 20 66 6f 75 6e 64 20 69 |s can be| found i|
|00001650| 6e 20 22 67 64 62 6d 5f | 65 72 72 6e 6f 22 20 66 |n "gdbm_|errno" f|
|00001660| 6f 72 20 67 64 62 6d 0d | 65 72 72 6f 72 73 20 61 |or gdbm.|errors a|
|00001670| 6e 64 20 69 6e 20 22 65 | 72 72 6e 6f 22 20 66 6f |nd in "e|rrno" fo|
|00001680| 72 20 66 69 6c 65 20 73 | 79 73 74 65 6d 20 65 72 |r file s|ystem er|
|00001690| 72 6f 72 73 2e 20 20 28 | 46 6f 72 20 65 72 72 6f |rors.  (|For erro|
|000016a0| 72 20 63 6f 64 65 73 2c | 20 73 65 65 0d 67 64 62 |r codes,| see.gdb|
|000016b0| 6d 65 72 72 6e 6f 2e 68 | 2e 29 0d 0d 49 6e 20 61 |merrno.h|.)..In a|
|000016c0| 6c 6c 20 6f 66 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |ll of th|e follow|
|000016d0| 69 6e 67 20 63 61 6c 6c | 73 2c 20 74 68 65 20 70 |ing call|s, the p|
|000016e0| 61 72 61 6d 65 74 65 72 | 20 22 64 62 66 22 20 72 |arameter| "dbf" r|
|000016f0| 65 66 65 72 73 20 74 6f | 20 74 68 65 20 70 6f 69 |efers to| the poi|
|00001700| 6e 74 65 72 0d 72 65 74 | 75 72 6e 65 64 20 66 72 |nter.ret|urned fr|
|00001710| 6f 6d 20 67 64 62 6d 5f | 6f 70 65 6e 2e 0d 0d 49 |om gdbm_|open...I|
|00001720| 74 20 69 73 20 69 6d 70 | 6f 72 74 61 6e 74 20 74 |t is imp|ortant t|
|00001730| 68 61 74 20 65 76 65 72 | 79 20 66 69 6c 65 20 6f |hat ever|y file o|
|00001740| 70 65 6e 65 64 20 69 73 | 20 61 6c 73 6f 20 63 6c |pened is| also cl|
|00001750| 6f 73 65 64 2e 20 20 54 | 68 69 73 20 69 73 20 6e |osed.  T|his is n|
|00001760| 65 65 64 65 64 20 74 6f | 0d 75 70 64 61 74 65 20 |eeded to|.update |
|00001770| 74 68 65 20 72 65 61 64 | 65 72 2f 77 72 69 74 65 |the read|er/write|
|00001780| 72 20 63 6f 75 6e 74 20 | 6f 6e 20 74 68 65 20 66 |r count |on the f|
|00001790| 69 6c 65 2e 20 20 54 68 | 69 73 20 69 73 20 64 6f |ile.  Th|is is do|
|000017a0| 6e 65 20 62 79 3a 0d 0d | 20 20 67 64 62 6d 5f 63 |ne by:..|  gdbm_c|
|000017b0| 6c 6f 73 65 28 64 62 66 | 29 3b 0d 0d 0d 54 68 65 |lose(dbf|);...The|
|000017c0| 20 64 61 74 61 62 61 73 | 65 20 69 73 20 75 73 65 | databas|e is use|
|000017d0| 64 20 62 79 20 33 20 70 | 72 69 6d 61 72 79 20 72 |d by 3 p|rimary r|
|000017e0| 6f 75 74 69 6e 65 73 2e | 20 20 54 68 65 20 66 69 |outines.|  The fi|
|000017f0| 72 73 74 20 73 74 6f 72 | 65 73 20 64 61 74 61 20 |rst stor|es data |
|00001800| 69 6e 20 74 68 65 0d 64 | 61 74 61 62 61 73 65 2e |in the.d|atabase.|
|00001810| 0d 0d 20 20 72 65 74 20 | 3d 20 67 64 62 6d 5f 73 |..  ret |= gdbm_s|
|00001820| 74 6f 72 65 20 28 20 64 | 62 66 2c 20 6b 65 79 2c |tore ( d|bf, key,|
|00001830| 20 63 6f 6e 74 65 6e 74 | 2c 20 66 6c 61 67 20 29 | content|, flag )|
|00001840| 0d 0d 20 20 54 68 65 20 | 70 61 72 61 6d 65 74 65 |..  The |paramete|
|00001850| 72 73 20 61 72 65 3a 0d | 20 20 20 20 20 63 68 61 |rs are:.|     cha|
|00001860| 72 20 2a 64 62 66 20 2d | 20 74 68 65 20 70 6f 69 |r *dbf -| the poi|
|00001870| 6e 74 65 72 20 72 65 74 | 75 72 6e 65 64 20 62 79 |nter ret|urned by|
|00001880| 20 67 64 62 6d 5f 6f 70 | 65 6e 0d 20 20 20 20 20 | gdbm_op|en.     |
|00001890| 64 61 74 75 6d 20 6b 65 | 79 20 2d 20 74 68 65 20 |datum ke|y - the |
|000018a0| 6b 65 79 20 64 61 74 61 | 0d 20 20 20 20 20 64 61 |key data|.     da|
|000018b0| 74 75 6d 20 63 6f 6e 74 | 65 6e 74 20 2d 20 74 68 |tum cont|ent - th|
|000018c0| 65 20 64 61 74 61 20 74 | 6f 20 62 65 20 61 73 73 |e data t|o be ass|
|000018d0| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 74 68 65 |ociated |with the|
|000018e0| 20 6b 65 79 0d 20 20 20 | 20 20 69 6e 74 20 20 20 | key.   |  int   |
|000018f0| 66 6c 61 67 20 2d 20 30 | 20 3d 3e 20 69 6e 73 65 |flag - 0| => inse|
|00001900| 72 74 20 6f 6e 6c 79 2c | 20 67 65 6e 65 72 61 74 |rt only,| generat|
|00001910| 65 20 61 6e 20 65 72 72 | 6f 72 20 69 66 20 6b 65 |e an err|or if ke|
|00001920| 79 20 65 78 69 73 74 73 | 2e 0d 09 20 20 20 20 20 |y exists|...     |
|00001930| 20 20 20 20 20 31 20 3d | 3e 20 72 65 70 6c 61 63 |     1 =|> replac|
|00001940| 65 20 63 6f 6e 74 65 6e | 74 73 20 69 66 20 6b 65 |e conten|ts if ke|
|00001950| 79 20 65 78 69 73 74 73 | 2e 20 20 28 44 65 66 69 |y exists|.  (Defi|
|00001960| 6e 65 64 20 69 6e 0d 09 | 20 20 20 20 20 20 20 20 |ned in..|        |
|00001970| 20 20 67 64 62 6d 2e 68 | 20 61 73 20 47 44 42 4d |  gdbm.h| as GDBM|
|00001980| 5f 49 4e 53 45 52 54 20 | 61 6e 64 20 47 44 42 4d |_INSERT |and GDBM|
|00001990| 5f 52 45 50 4c 41 43 45 | 2e 29 0d 0d 20 20 49 66 |_REPLACE|.)..  If|
|000019a0| 20 61 20 72 65 61 64 65 | 72 20 63 61 6c 6c 73 20 | a reade|r calls |
|000019b0| 73 74 6f 72 65 2c 20 72 | 65 74 20 67 65 74 73 20 |store, r|et gets |
|000019c0| 2d 31 2e 20 20 49 66 20 | 63 61 6c 6c 65 64 20 77 |-1.  If |called w|
|000019d0| 69 74 68 20 47 44 42 4d | 5f 49 4e 53 45 52 54 20 |ith GDBM|_INSERT |
|000019e0| 61 6e 64 0d 20 20 6b 65 | 79 20 69 73 20 69 6e 20 |and.  ke|y is in |
|000019f0| 74 68 65 20 64 61 74 61 | 62 61 73 65 2c 20 72 65 |the data|base, re|
|00001a00| 74 20 67 65 74 73 20 31 | 2e 20 20 4f 74 68 65 72 |t gets 1|.  Other|
|00001a10| 77 69 73 65 2c 20 72 65 | 74 20 69 73 20 30 2e 0d |wise, re|t is 0..|
|00001a20| 20 20 4e 4f 54 49 43 45 | 3a 20 49 66 20 79 6f 75 |  NOTICE|: If you|
|00001a30| 20 73 74 6f 72 65 20 64 | 61 74 61 20 66 6f 72 20 | store d|ata for |
|00001a40| 61 20 6b 65 79 20 74 68 | 61 74 20 69 73 20 61 6c |a key th|at is al|
|00001a50| 72 65 61 64 79 20 69 6e | 20 74 68 65 20 64 61 74 |ready in| the dat|
|00001a60| 61 20 62 61 73 65 2c 0d | 20 20 67 64 62 6d 20 72 |a base,.|  gdbm r|
|00001a70| 65 70 6c 61 63 65 73 20 | 74 68 65 20 6f 6c 64 20 |eplaces |the old |
|00001a80| 64 61 74 61 20 77 69 74 | 68 20 74 68 65 20 6e 65 |data wit|h the ne|
|00001a90| 77 20 64 61 74 61 20 69 | 66 20 63 61 6c 6c 65 64 |w data i|f called|
|00001aa0| 20 77 69 74 68 20 47 44 | 42 4d 5f 52 45 50 4c 41 | with GD|BM_REPLA|
|00001ab0| 43 45 2e 0d 20 20 59 6f | 75 20 64 6f 20 6e 6f 74 |CE..  Yo|u do not|
|00001ac0| 20 67 65 74 20 74 77 6f | 20 64 61 74 61 20 69 74 | get two| data it|
|00001ad0| 65 6d 73 20 66 6f 72 20 | 74 68 65 20 73 61 6d 65 |ems for |the same|
|00001ae0| 20 6b 65 79 20 61 6e 64 | 20 79 6f 75 20 64 6f 20 | key and| you do |
|00001af0| 6e 6f 74 20 67 65 74 20 | 61 6e 0d 20 20 65 72 72 |not get |an.  err|
|00001b00| 6f 72 20 66 72 6f 6d 20 | 67 64 62 6d 5f 73 74 6f |or from |gdbm_sto|
|00001b10| 72 65 2e 0d 20 20 4e 4f | 54 49 43 45 3a 20 54 68 |re..  NO|TICE: Th|
|00001b20| 65 20 73 69 7a 65 20 69 | 6e 20 67 64 62 6d 20 69 |e size i|n gdbm i|
|00001b30| 73 20 6e 6f 74 20 72 65 | 73 74 72 69 63 74 65 64 |s not re|stricted|
|00001b40| 20 6c 69 6b 65 20 64 62 | 6d 20 6f 72 20 6e 64 62 | like db|m or ndb|
|00001b50| 6d 2e 20 20 59 6f 75 72 | 20 64 61 74 61 0d 20 20 |m.  Your| data.  |
|00001b60| 63 61 6e 20 62 65 20 61 | 73 20 6c 61 72 67 65 20 |can be a|s large |
|00001b70| 61 73 20 79 6f 75 72 20 | 22 77 61 6e 74 22 2e 0d |as your |"want"..|
|00001b80| 20 20 4e 4f 54 49 43 45 | 3a 20 42 6f 74 68 20 6b |  NOTICE|: Both k|
|00001b90| 65 79 20 61 6e 64 20 63 | 6f 6e 74 65 6e 74 20 6d |ey and c|ontent m|
|00001ba0| 75 73 74 20 68 61 76 65 | 20 74 68 65 20 64 70 74 |ust have| the dpt|
|00001bb0| 72 20 66 69 65 6c 64 20 | 62 65 20 61 20 6e 6f 6e |r field |be a non|
|00001bc0| 2d 4e 55 4c 4c 0d 20 20 | 76 61 6c 75 65 2e 20 20 |-NULL.  |value.  |
|00001bd0| 53 69 6e 63 65 20 61 20 | 4e 55 4c 4c 20 64 70 74 |Since a |NULL dpt|
|00001be0| 72 20 66 69 65 6c 64 20 | 69 73 20 75 73 65 64 20 |r field |is used |
|00001bf0| 62 79 20 6f 74 68 65 72 | 20 72 6f 75 74 69 6e 65 |by other| routine|
|00001c00| 73 20 74 6f 20 69 6e 64 | 69 63 61 74 65 20 61 6e |s to ind|icate an|
|00001c10| 0d 20 20 65 72 72 6f 72 | 2c 20 61 20 4e 55 4c 4c |.  error|, a NULL|
|00001c20| 20 66 69 65 6c 64 20 63 | 61 6e 6e 6f 74 20 62 65 | field c|annot be|
|00001c30| 20 76 61 6c 69 64 20 64 | 61 74 61 2e 20 20 49 66 | valid d|ata.  If|
|00001c40| 20 65 69 74 68 65 72 20 | 6b 65 79 20 6f 72 20 63 | either |key or c|
|00001c50| 6f 6e 74 65 6e 74 20 68 | 61 76 65 0d 20 20 61 20 |ontent h|ave.  a |
|00001c60| 6e 75 6c 6c 20 64 70 74 | 72 20 66 69 65 6c 64 2c |null dpt|r field,|
|00001c70| 20 67 64 62 6d 5f 6f 70 | 65 6e 20 77 69 6c 6c 20 | gdbm_op|en will |
|00001c80| 72 65 74 75 72 6e 20 61 | 6e 20 65 72 72 6f 72 2e |return a|n error.|
|00001c90| 0d 0d 54 6f 20 73 65 61 | 72 63 68 20 66 6f 72 20 |..To sea|rch for |
|00001ca0| 73 6f 6d 65 20 64 61 74 | 61 3a 0d 0d 20 20 63 6f |some dat|a:..  co|
|00001cb0| 6e 74 65 6e 74 20 3d 20 | 67 64 62 6d 5f 66 65 74 |ntent = |gdbm_fet|
|00001cc0| 63 68 20 28 20 64 62 66 | 2c 20 6b 65 79 20 29 0d |ch ( dbf|, key ).|
|00001cd0| 0d 20 20 54 68 65 20 70 | 61 72 61 6d 65 74 65 72 |.  The p|arameter|
|00001ce0| 73 20 61 72 65 3a 0d 20 | 20 20 20 20 63 68 61 72 |s are:. |    char|
|00001cf0| 20 2a 64 62 66 20 2d 20 | 74 68 65 20 70 6f 69 6e | *dbf - |the poin|
|00001d00| 74 65 72 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |ter retu|rned by |
|00001d10| 67 64 62 6d 5f 6f 70 65 | 6e 0d 20 20 20 20 20 64 |gdbm_ope|n.     d|
|00001d20| 61 74 75 6d 20 6b 65 79 | 20 2d 20 74 68 65 20 6b |atum key| - the k|
|00001d30| 65 79 20 64 61 74 61 0d | 0d 20 20 54 68 65 20 22 |ey data.|.  The "|
|00001d40| 64 61 74 75 6d 22 20 72 | 65 74 75 72 6e 65 64 20 |datum" r|eturned |
|00001d50| 69 6e 20 63 6f 6e 74 65 | 6e 74 20 69 73 20 61 20 |in conte|nt is a |
|00001d60| 70 6f 69 6e 74 65 72 20 | 74 6f 20 74 68 65 20 64 |pointer |to the d|
|00001d70| 61 74 61 20 66 6f 75 6e | 64 2e 20 20 49 66 20 74 |ata foun|d.  If t|
|00001d80| 68 65 0d 20 20 64 70 74 | 72 20 69 73 20 4e 55 4c |he.  dpt|r is NUL|
|00001d90| 4c 2c 20 6e 6f 20 64 61 | 74 61 20 77 61 73 20 66 |L, no da|ta was f|
|00001da0| 6f 75 6e 64 2e 20 20 49 | 66 20 64 70 74 72 20 69 |ound.  I|f dptr i|
|00001db0| 73 20 6e 6f 74 20 4e 55 | 4c 4c 2c 20 74 68 65 6e |s not NU|LL, then|
|00001dc0| 20 69 74 20 70 6f 69 6e | 74 73 0d 20 20 74 6f 20 | it poin|ts.  to |
|00001dd0| 64 61 74 61 20 61 6c 6c | 6f 63 61 74 65 64 20 62 |data all|ocated b|
|00001de0| 79 20 6d 61 6c 6c 6f 63 | 2e 20 20 67 64 62 6d 20 |y malloc|.  gdbm |
|00001df0| 64 6f 65 73 20 6e 6f 74 | 20 61 75 74 6f 6d 61 74 |does not| automat|
|00001e00| 69 63 61 6c 6c 79 20 66 | 72 65 65 20 74 68 69 73 |ically f|ree this|
|00001e10| 20 64 61 74 61 2e 0d 20 | 20 54 68 65 20 75 73 65 | data.. | The use|
|00001e20| 72 20 6d 75 73 74 20 66 | 72 65 65 20 74 68 69 73 |r must f|ree this|
|00001e30| 20 73 74 6f 72 61 67 65 | 20 77 68 65 6e 20 64 6f | storage| when do|
|00001e40| 6e 65 20 75 73 69 6e 67 | 20 69 74 2e 20 20 54 68 |ne using| it.  Th|
|00001e50| 69 73 20 65 6c 69 6d 69 | 6e 61 74 65 73 20 74 68 |is elimi|nates th|
|00001e60| 65 0d 20 20 6e 65 65 64 | 20 74 6f 20 63 6f 70 79 |e.  need| to copy|
|00001e70| 20 74 68 65 20 72 65 73 | 75 6c 74 20 74 6f 20 73 | the res|ult to s|
|00001e80| 61 76 65 20 69 74 20 66 | 6f 72 20 6c 61 74 65 72 |ave it f|or later|
|00001e90| 20 75 73 65 2e 20 28 59 | 6f 75 20 6a 75 73 74 20 | use. (Y|ou just |
|00001ea0| 73 61 76 65 20 74 68 65 | 20 0d 20 20 70 6f 69 6e |save the| .  poin|
|00001eb0| 74 65 72 2e 29 0d 0d 54 | 6f 20 72 65 6d 6f 76 65 |ter.)..T|o remove|
|00001ec0| 20 73 6f 6d 65 20 64 61 | 74 61 20 66 72 6f 6d 20 | some da|ta from |
|00001ed0| 74 68 65 20 64 61 74 61 | 62 61 73 65 3a 0d 0d 20 |the data|base:.. |
|00001ee0| 20 72 65 74 20 3d 20 67 | 64 62 6d 5f 64 65 6c 65 | ret = g|dbm_dele|
|00001ef0| 74 65 20 28 20 64 62 66 | 2c 20 6b 65 79 20 29 0d |te ( dbf|, key ).|
|00001f00| 0d 20 20 54 68 65 20 70 | 61 72 61 6d 65 74 65 72 |.  The p|arameter|
|00001f10| 73 20 61 72 65 3a 0d 20 | 20 20 20 20 63 68 61 72 |s are:. |    char|
|00001f20| 20 2a 64 62 66 20 2d 20 | 74 68 65 20 70 6f 69 6e | *dbf - |the poin|
|00001f30| 74 65 72 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |ter retu|rned by |
|00001f40| 67 64 62 6d 5f 6f 70 65 | 6e 0d 20 20 20 20 20 64 |gdbm_ope|n.     d|
|00001f50| 61 74 75 6d 20 6b 65 79 | 20 2d 20 74 68 65 20 6b |atum key| - the k|
|00001f60| 65 79 20 64 61 74 61 0d | 0d 20 20 54 68 65 20 72 |ey data.|.  The r|
|00001f70| 65 74 20 76 61 6c 75 65 | 20 69 73 20 2d 31 20 69 |et value| is -1 i|
|00001f80| 66 20 74 68 65 20 69 74 | 65 6d 20 69 73 20 6e 6f |f the it|em is no|
|00001f90| 74 20 70 72 65 73 65 6e | 74 20 6f 72 20 74 68 65 |t presen|t or the|
|00001fa0| 20 72 65 71 75 65 73 74 | 65 72 20 69 73 20 61 20 | request|er is a |
|00001fb0| 72 65 61 64 65 72 2e 0d | 20 20 54 68 65 20 72 65 |reader..|  The re|
|00001fc0| 74 20 76 61 6c 75 65 20 | 69 73 20 30 20 69 66 20 |t value |is 0 if |
|00001fd0| 74 68 65 72 65 20 77 61 | 73 20 61 20 73 75 63 63 |there wa|s a succ|
|00001fe0| 65 73 73 66 75 6c 20 64 | 65 6c 65 74 65 2e 0d 0d |essful d|elete...|
|00001ff0| 0d 54 68 65 20 6e 65 78 | 74 20 74 77 6f 20 72 6f |.The nex|t two ro|
|00002000| 75 74 69 6e 65 73 20 61 | 6c 6c 6f 77 20 66 6f 72 |utines a|llow for|
|00002010| 20 61 63 63 65 73 73 69 | 6e 67 20 61 6c 6c 20 69 | accessi|ng all i|
|00002020| 74 65 6d 73 20 69 6e 20 | 74 68 65 20 64 61 74 61 |tems in |the data|
|00002030| 62 61 73 65 2e 20 20 54 | 68 69 73 20 0d 61 63 63 |base.  T|his .acc|
|00002040| 65 73 73 20 69 73 20 6e | 6f 74 20 6b 65 79 20 73 |ess is n|ot key s|
|00002050| 65 71 75 65 6e 74 69 61 | 6c 2c 20 62 75 74 20 69 |equentia|l, but i|
|00002060| 74 20 69 73 20 67 75 61 | 72 61 6e 74 65 65 64 20 |t is gua|ranteed |
|00002070| 74 6f 20 76 69 73 69 74 | 20 65 76 65 72 79 20 6b |to visit| every k|
|00002080| 65 79 20 69 6e 0d 74 68 | 65 20 64 61 74 61 62 61 |ey in.th|e databa|
|00002090| 73 65 20 6f 6e 63 65 2e | 20 20 28 54 68 65 20 6f |se once.|  (The o|
|000020a0| 72 64 65 72 20 68 61 73 | 20 74 6f 20 64 6f 20 77 |rder has| to do w|
|000020b0| 69 74 68 20 74 68 65 20 | 68 61 73 68 20 76 61 6c |ith the |hash val|
|000020c0| 75 65 73 2e 29 0d 0d 20 | 20 6b 65 79 20 3d 20 67 |ues.).. | key = g|
|000020d0| 64 62 6d 5f 66 69 72 73 | 74 6b 65 79 20 28 20 64 |dbm_firs|tkey ( d|
|000020e0| 62 66 20 29 0d 0d 20 20 | 6e 65 78 74 6b 65 79 20 |bf )..  |nextkey |
|000020f0| 3d 20 67 64 62 6d 5f 6e | 65 78 74 6b 65 79 20 28 |= gdbm_n|extkey (|
|00002100| 20 64 62 66 2c 20 6b 65 | 79 20 29 0d 0d 20 20 54 | dbf, ke|y )..  T|
|00002110| 68 65 20 70 61 72 61 6d | 65 74 65 72 73 20 61 72 |he param|eters ar|
|00002120| 65 3a 0d 20 20 20 20 20 | 63 68 61 72 20 2a 64 62 |e:.     |char *db|
|00002130| 66 20 2d 20 74 68 65 20 | 70 6f 69 6e 74 65 72 20 |f - the |pointer |
|00002140| 72 65 74 75 72 6e 65 64 | 20 62 79 20 67 64 62 6d |returned| by gdbm|
|00002150| 5f 6f 70 65 6e 0d 20 20 | 20 20 20 64 61 74 75 6d |_open.  |   datum|
|00002160| 20 6b 65 79 20 2d 20 74 | 68 65 20 6b 65 79 20 64 | key - t|he key d|
|00002170| 61 74 61 0d 0d 20 20 54 | 68 65 20 72 65 74 75 72 |ata..  T|he retur|
|00002180| 6e 20 76 61 6c 75 65 73 | 20 61 72 65 20 62 6f 74 |n values| are bot|
|00002190| 68 20 64 61 74 75 6d 2e | 20 20 49 66 20 6b 65 79 |h datum.|  If key|
|000021a0| 2e 64 70 74 72 20 6f 72 | 20 6e 65 78 74 6b 65 79 |.dptr or| nextkey|
|000021b0| 2e 64 70 74 72 20 69 73 | 20 4e 55 4c 4c 2c 0d 20 |.dptr is| NULL,. |
|000021c0| 20 74 68 65 72 65 20 69 | 73 20 6e 6f 20 66 69 72 | there i|s no fir|
|000021d0| 73 74 20 6b 65 79 20 6f | 72 20 6e 65 78 74 20 6b |st key o|r next k|
|000021e0| 65 79 2e 20 20 41 67 61 | 69 6e 20 6e 6f 74 69 63 |ey.  Aga|in notic|
|000021f0| 65 20 74 68 61 74 20 64 | 70 74 72 20 70 6f 69 6e |e that d|ptr poin|
|00002200| 74 73 20 74 6f 0d 20 20 | 64 61 74 61 20 61 6c 6c |ts to.  |data all|
|00002210| 6f 63 61 74 65 64 20 62 | 79 20 6d 61 6c 6c 6f 63 |ocated b|y malloc|
|00002220| 20 61 6e 64 20 67 64 62 | 6d 20 77 69 6c 6c 20 6e | and gdb|m will n|
|00002230| 6f 74 20 66 72 65 65 20 | 69 74 20 66 6f 72 20 79 |ot free |it for y|
|00002240| 6f 75 2e 20 0d 0d 54 68 | 65 20 66 6f 6c 6c 6f 77 |ou. ..Th|e follow|
|00002250| 69 6e 67 20 72 6f 75 74 | 69 6e 65 20 73 68 6f 75 |ing rout|ine shou|
|00002260| 6c 64 20 62 65 20 75 73 | 65 64 20 76 65 72 79 20 |ld be us|ed very |
|00002270| 73 65 6c 64 6f 6d 2e 20 | 20 0d 20 20 0d 20 20 72 |seldom. | .  .  r|
|00002280| 65 74 20 3d 20 67 64 62 | 6d 5f 72 65 6f 72 67 61 |et = gdb|m_reorga|
|00002290| 6e 69 7a 65 20 28 20 64 | 62 66 20 29 0d 0d 20 20 |nize ( d|bf )..  |
|000022a0| 49 66 20 79 6f 75 20 68 | 61 76 65 20 68 61 64 20 |If you h|ave had |
|000022b0| 61 20 6c 6f 74 20 6f 66 | 20 64 65 6c 65 74 69 6f |a lot of| deletio|
|000022c0| 6e 73 20 61 6e 64 20 77 | 6f 75 6c 64 20 6c 69 6b |ns and w|ould lik|
|000022d0| 65 20 74 6f 20 73 68 72 | 69 6e 6b 20 74 68 65 20 |e to shr|ink the |
|000022e0| 73 70 61 63 65 0d 20 20 | 75 73 65 64 20 62 79 20 |space.  |used by |
|000022f0| 74 68 65 20 67 64 62 6d | 20 66 69 6c 65 2c 20 74 |the gdbm| file, t|
|00002300| 68 65 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |he this |routine |
|00002310| 77 69 6c 6c 20 72 65 6f | 72 67 61 6e 69 7a 65 20 |will reo|rganize |
|00002320| 74 68 65 20 64 61 74 61 | 62 61 73 65 2e 0d 20 20 |the data|base..  |
|00002330| 67 64 62 6d 20 77 69 6c | 6c 20 6e 6f 74 20 73 68 |gdbm wil|l not sh|
|00002340| 6f 72 74 65 6e 20 74 68 | 65 20 6c 65 6e 67 74 68 |orten th|e length|
|00002350| 20 6f 66 20 61 20 67 64 | 62 6d 20 66 69 6c 65 20 | of a gd|bm file |
|00002360| 65 78 63 65 70 74 20 62 | 79 20 75 73 69 6e 67 20 |except b|y using |
|00002370| 74 68 69 73 0d 20 20 72 | 65 6f 72 67 61 6e 69 7a |this.  r|eorganiz|
|00002380| 61 74 69 6f 6e 2e 20 20 | 28 44 65 6c 65 74 65 64 |ation.  |(Deleted|
|00002390| 20 66 69 6c 65 20 73 70 | 61 63 65 20 77 69 6c 6c | file sp|ace will|
|000023a0| 20 62 65 20 72 65 75 73 | 65 64 2e 29 0d 0d 0d 54 | be reus|ed.)...T|
|000023b0| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 74 77 6f |he follo|wing two|
|000023c0| 20 61 72 65 20 76 61 72 | 69 61 62 6c 65 73 20 74 | are var|iables t|
|000023d0| 68 61 74 20 6d 61 79 20 | 6e 65 65 64 20 74 6f 20 |hat may |need to |
|000023e0| 62 65 20 75 73 65 64 3a | 0d 0d 20 20 67 64 62 6d |be used:|..  gdbm|
|000023f0| 5f 65 72 72 6f 72 20 67 | 64 62 6d 5f 65 72 72 6e |_error g|dbm_errn|
|00002400| 6f 20 20 20 2d 20 20 20 | 74 68 65 20 76 61 72 69 |o   -   |the vari|
|00002410| 61 62 6c 65 20 74 68 61 | 74 20 63 6f 6e 74 61 69 |able tha|t contai|
|00002420| 6e 73 20 6d 6f 72 65 20 | 69 6e 66 6f 72 6d 61 74 |ns more |informat|
|00002430| 69 6f 6e 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 |ion.    |        |
|00002440| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002450| 20 20 61 62 6f 75 74 20 | 67 64 62 6d 20 65 72 72 |  about |gdbm err|
|00002460| 6f 72 73 2e 20 20 28 20 | 67 64 62 6d 2e 68 20 68 |ors.  ( |gdbm.h h|
|00002470| 61 73 20 74 68 65 0d 09 | 09 09 20 20 20 20 20 20 |as the..|..      |
|00002480| 64 65 66 69 6e 69 74 69 | 6f 6e 73 20 6f 66 20 74 |definiti|ons of t|
|00002490| 68 65 20 65 72 72 6f 72 | 20 76 61 6c 75 65 73 2e |he error| values.|
|000024a0| 20 29 0d 0d 20 20 63 68 | 61 72 20 2a 20 67 64 62 | )..  ch|ar * gdb|
|000024b0| 6d 5f 76 65 72 73 69 6f | 6e 20 20 20 20 20 2d 20 |m_versio|n     - |
|000024c0| 20 20 74 68 65 20 73 74 | 72 69 6e 67 20 63 6f 6e |  the st|ring con|
|000024d0| 74 61 69 6e 69 6e 67 20 | 74 68 65 20 76 65 72 73 |taining |the vers|
|000024e0| 69 6f 6e 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 2e |ion info|rmation.|
|000024f0| 0d 0d 0d 54 68 65 72 65 | 20 61 72 65 20 61 20 66 |...There| are a f|
|00002500| 65 77 20 6d 6f 72 65 20 | 74 68 69 6e 67 73 20 6f |ew more |things o|
|00002510| 66 20 69 6e 74 65 72 65 | 73 74 2e 20 20 46 69 72 |f intere|st.  Fir|
|00002520| 73 74 2c 20 67 64 62 6d | 20 66 69 6c 65 73 20 61 |st, gdbm| files a|
|00002530| 72 65 20 6e 6f 74 0d 22 | 73 70 61 72 73 65 22 2e |re not."|sparse".|
|00002540| 20 20 59 6f 75 20 63 61 | 6e 20 63 6f 70 79 20 74 |  You ca|n copy t|
|00002550| 68 65 6d 20 77 69 74 68 | 20 74 68 65 20 55 4e 49 |hem with| the UNI|
|00002560| 58 20 63 70 20 63 6f 6d | 6d 61 6e 64 20 61 6e 64 |X cp com|mand and|
|00002570| 20 74 68 65 79 20 77 69 | 6c 6c 0d 6e 6f 74 20 65 | they wi|ll.not e|
|00002580| 78 70 61 6e 64 20 69 6e | 20 74 68 65 20 63 6f 70 |xpand in| the cop|
|00002590| 79 69 6e 67 20 70 72 6f | 63 65 73 73 2e 20 20 41 |ying pro|cess.  A|
|000025a0| 6c 73 6f 2c 20 74 68 65 | 72 65 20 69 73 20 61 20 |lso, the|re is a |
|000025b0| 63 6f 6d 70 61 74 69 62 | 69 6c 69 74 79 0d 6d 6f |compatib|ility.mo|
|000025c0| 64 65 20 66 6f 72 20 75 | 73 65 20 77 69 74 68 20 |de for u|se with |
|000025d0| 70 72 6f 67 72 61 6d 73 | 20 74 68 61 74 20 61 6c |programs| that al|
|000025e0| 72 65 61 64 79 20 75 73 | 65 20 55 4e 49 58 20 64 |ready us|e UNIX d|
|000025f0| 62 6d 2e 20 20 49 6e 20 | 74 68 69 73 0d 63 6f 6d |bm.  In |this.com|
|00002600| 70 61 74 69 62 69 6c 69 | 74 79 20 6d 6f 64 65 2c |patibili|ty mode,|
|00002610| 20 6e 6f 20 67 64 62 6d | 20 66 69 6c 65 20 70 6f | no gdbm| file po|
|00002620| 69 6e 74 65 72 20 69 73 | 20 72 65 71 75 69 72 65 |inter is| require|
|00002630| 64 20 62 79 20 74 68 65 | 20 75 73 65 72 2e 0d 4f |d by the| user..O|
|00002640| 6e 6c 79 20 6f 6e 65 20 | 66 69 6c 65 20 6d 61 79 |nly one |file may|
|00002650| 20 62 65 20 6f 70 65 6e | 65 64 20 61 74 20 61 20 | be open|ed at a |
|00002660| 74 69 6d 65 2e 20 20 41 | 6c 6c 20 75 73 65 72 73 |time.  A|ll users|
|00002670| 20 69 6e 20 63 6f 6d 70 | 61 74 69 62 69 6c 69 74 | in comp|atibilit|
|00002680| 79 0d 6d 6f 64 65 20 61 | 72 65 20 61 73 73 75 6d |y.mode a|re assum|
|00002690| 65 64 20 74 6f 20 62 65 | 20 77 72 69 74 65 72 73 |ed to be| writers|
|000026a0| 2e 20 20 49 66 20 74 68 | 65 20 67 64 62 6d 20 66 |.  If th|e gdbm f|
|000026b0| 69 6c 65 20 69 73 20 61 | 20 72 65 61 64 20 6f 6e |ile is a| read on|
|000026c0| 6c 79 2c 20 69 74 0d 77 | 69 6c 6c 20 66 61 69 6c |ly, it.w|ill fail|
|000026d0| 20 61 73 20 61 20 77 72 | 69 74 65 72 2c 20 62 75 | as a wr|iter, bu|
|000026e0| 74 20 77 69 6c 6c 20 61 | 6c 73 6f 20 74 72 79 20 |t will a|lso try |
|000026f0| 74 6f 20 6f 70 65 6e 20 | 69 74 20 61 73 20 61 20 |to open |it as a |
|00002700| 72 65 61 64 65 72 2e 20 | 20 41 6c 6c 0d 72 65 74 |reader. | All.ret|
|00002710| 75 72 6e 65 64 20 70 6f | 69 6e 74 65 72 73 20 69 |urned po|inters i|
|00002720| 6e 20 64 61 74 75 6d 20 | 73 74 72 75 63 74 75 72 |n datum |structur|
|00002730| 65 73 20 70 6f 69 6e 74 | 20 74 6f 20 64 61 74 61 |es point| to data|
|00002740| 20 74 68 61 74 20 67 64 | 62 6d 20 57 49 4c 4c 0d | that gd|bm WILL.|
|00002750| 66 72 65 65 2e 20 20 54 | 68 65 79 20 73 68 6f 75 |free.  T|hey shou|
|00002760| 6c 64 20 62 65 20 74 72 | 65 61 74 65 64 20 61 73 |ld be tr|eated as|
|00002770| 20 73 74 61 74 69 63 20 | 70 6f 69 6e 74 65 72 73 | static |pointers|
|00002780| 20 28 61 73 20 73 74 61 | 6e 64 61 72 64 20 55 4e | (as sta|ndard UN|
|00002790| 49 58 20 64 62 6d 0d 64 | 6f 65 73 29 2e 20 20 54 |IX dbm.d|oes).  T|
|000027a0| 68 65 20 63 6f 6d 70 61 | 74 69 62 69 6c 69 74 79 |he compa|tibility|
|000027b0| 20 72 6f 75 74 69 6e 65 | 20 6e 61 6d 65 73 20 61 | routine| names a|
|000027c0| 72 65 20 74 68 65 20 73 | 61 6d 65 20 61 73 20 74 |re the s|ame as t|
|000027d0| 68 65 20 55 4e 49 58 20 | 64 62 6d 0d 72 6f 75 74 |he UNIX |dbm.rout|
|000027e0| 69 6e 65 20 6e 61 6d 65 | 73 2e 20 20 54 68 65 69 |ine name|s.  Thei|
|000027f0| 72 20 64 65 66 69 6e 69 | 74 69 6f 6e 73 20 66 6f |r defini|tions fo|
|00002800| 6c 6c 6f 77 3a 0d 0d 20 | 20 69 6e 74 20 64 62 6d |llow:.. | int dbm|
|00002810| 69 6e 69 74 20 28 20 6e | 61 6d 65 20 29 0d 0d 20 |init ( n|ame ).. |
|00002820| 20 69 6e 74 20 73 74 6f | 72 65 20 28 20 6b 65 79 | int sto|re ( key|
|00002830| 2c 20 63 6f 6e 74 65 6e | 74 20 29 0d 0d 20 20 64 |, conten|t )..  d|
|00002840| 61 74 75 6d 20 66 65 74 | 63 68 20 28 20 6b 65 79 |atum fet|ch ( key|
|00002850| 20 29 0d 0d 20 20 69 6e | 74 20 64 65 6c 65 74 65 | )..  in|t delete|
|00002860| 20 28 20 6b 65 79 20 29 | 0d 0d 20 20 64 61 74 75 | ( key )|..  datu|
|00002870| 6d 20 66 69 72 73 74 6b | 65 79 20 28 29 0d 0d 20 |m firstk|ey ().. |
|00002880| 20 64 61 74 75 6d 20 6e | 65 78 74 6b 65 79 20 28 | datum n|extkey (|
|00002890| 20 6b 65 79 20 29 0d 0d | 4e 4f 54 45 3a 20 53 6f | key )..|NOTE: So|
|000028a0| 6d 65 20 69 6d 70 6c 65 | 6d 65 6e 74 61 74 69 6f |me imple|mentatio|
|000028b0| 6e 73 20 68 61 76 65 20 | 61 6e 20 69 6e 63 6c 75 |ns have |an inclu|
|000028c0| 64 65 20 66 69 6c 65 20 | 22 64 62 6d 2e 68 22 2e |de file |"dbm.h".|
|000028d0| 20 20 54 68 61 74 20 66 | 69 6c 65 20 69 73 20 6a |  That f|ile is j|
|000028e0| 75 73 74 0d 61 20 66 69 | 6c 65 20 74 68 61 74 20 |ust.a fi|le that |
|000028f0| 64 65 66 69 6e 65 73 20 | 64 61 74 75 6d 20 61 6e |defines |datum an|
|00002900| 64 20 74 68 65 20 61 62 | 6f 76 65 20 72 6f 75 74 |d the ab|ove rout|
|00002910| 69 6e 65 73 2e 20 20 4d | 61 6e 79 20 6f 72 69 67 |ines.  M|any orig|
|00002920| 69 6e 61 6c 20 64 62 6d | 20 0d 73 69 74 65 73 20 |inal dbm| .sites |
|00002930| 64 6f 20 6e 6f 74 20 68 | 61 76 65 20 61 20 22 64 |do not h|ave a "d|
|00002940| 62 6d 2e 68 22 20 66 69 | 6c 65 2e 20 20 4f 6e 65 |bm.h" fi|le.  One|
|00002950| 20 69 73 20 69 6e 63 6c | 75 64 65 64 20 68 65 72 | is incl|uded her|
|00002960| 65 20 66 6f 72 20 74 68 | 6f 73 65 20 77 68 6f 20 |e for th|ose who |
|00002970| 0d 77 61 6e 74 20 69 74 | 2e 0d 0d 57 41 52 4e 49 |.want it|...WARNI|
|00002980| 4e 47 3a 20 73 74 61 6e | 64 61 72 64 20 55 4e 49 |NG: stan|dard UNI|
|00002990| 58 20 64 62 6d 20 61 6e | 64 20 47 4e 55 20 64 62 |X dbm an|d GNU db|
|000029a0| 6d 20 64 6f 20 6e 6f 74 | 20 68 61 76 65 20 74 68 |m do not| have th|
|000029b0| 65 20 73 61 6d 65 20 64 | 61 74 61 20 66 6f 72 6d |e same d|ata form|
|000029c0| 61 74 20 69 6e 20 74 68 | 65 0d 66 69 6c 65 2e 20 |at in th|e.file. |
|000029d0| 20 59 6f 75 20 63 61 6e | 6e 6f 74 20 61 63 63 65 | You can|not acce|
|000029e0| 73 73 20 61 20 73 74 61 | 6e 64 61 72 64 20 55 4e |ss a sta|ndard UN|
|000029f0| 49 58 20 64 62 6d 20 66 | 69 6c 65 20 77 69 74 68 |IX dbm f|ile with|
|00002a00| 20 47 4e 55 20 64 62 6d | 21 20 20 49 66 20 79 6f | GNU dbm|!  If yo|
|00002a10| 75 20 77 61 6e 74 0d 74 | 6f 20 75 73 65 20 61 6e |u want.t|o use an|
|00002a20| 20 6f 6c 64 20 64 61 74 | 61 62 61 73 65 20 77 69 | old dat|abase wi|
|00002a30| 74 68 20 47 4e 55 20 64 | 62 6d 2c 20 79 6f 75 20 |th GNU d|bm, you |
|00002a40| 6d 75 73 74 20 75 73 65 | 20 74 68 65 20 63 6f 6e |must use| the con|
|00002a50| 76 65 72 74 20 70 72 6f | 67 72 61 6d 2e 0d 0d 41 |vert pro|gram...A|
|00002a60| 6c 73 6f 2c 20 47 4e 55 | 20 64 62 6d 20 68 61 73 |lso, GNU| dbm has|
|00002a70| 20 63 6f 6d 70 61 74 69 | 62 69 6c 69 74 79 20 72 | compati|bility r|
|00002a80| 6f 75 74 69 6e 65 73 20 | 66 6f 72 20 6e 64 62 6d |outines |for ndbm|
|00002a90| 2e 20 20 46 6f 72 20 6e | 64 62 6d 20 63 6f 6d 70 |.  For n|dbm comp|
|00002aa0| 61 74 69 62 6c 69 74 79 | 0d 72 6f 75 74 69 6e 65 |atiblity|.routine|
|00002ab0| 73 2c 20 79 6f 75 20 6e | 65 65 64 20 74 68 65 20 |s, you n|eed the |
|00002ac0| 69 6e 63 6c 75 64 65 20 | 66 69 6c 65 20 22 6e 64 |include |file "nd|
|00002ad0| 62 6d 2e 68 22 2e 20 20 | 0d 0d 57 41 52 4e 49 4e |bm.h".  |..WARNIN|
|00002ae0| 47 3a 20 49 66 20 79 6f | 75 20 68 61 76 65 20 6e |G: If yo|u have n|
|00002af0| 64 62 6d 20 61 6e 64 20 | 67 64 62 6d 2c 20 74 68 |dbm and |gdbm, th|
|00002b00| 65 72 65 20 69 73 20 61 | 20 63 6f 6e 66 6c 69 63 |ere is a| conflic|
|00002b10| 74 20 69 6e 20 74 68 65 | 20 6e 61 6d 65 73 20 6f |t in the| names o|
|00002b20| 66 20 74 68 65 0d 69 6e | 63 6c 75 64 65 20 66 69 |f the.in|clude fi|
|00002b30| 6c 65 20 66 6f 72 20 74 | 68 65 20 6e 64 62 6d 20 |le for t|he ndbm |
|00002b40| 69 6e 74 65 72 66 61 63 | 65 20 61 6e 64 20 74 68 |interfac|e and th|
|00002b50| 65 20 6f 72 69 67 69 6e | 61 6c 20 6e 64 62 6d 20 |e origin|al ndbm |
|00002b60| 70 61 63 6b 61 67 65 2e | 20 20 44 6f 20 6e 6f 74 |package.|  Do not|
|00002b70| 0d 62 6c 69 6e 64 6c 79 | 20 63 6f 70 79 20 22 6e |.blindly| copy "n|
|00002b80| 64 62 6d 2e 68 22 20 74 | 6f 20 79 6f 75 72 20 69 |dbm.h" t|o your i|
|00002b90| 6e 63 6c 75 64 65 20 64 | 69 72 65 63 74 6f 72 79 |nclude d|irectory|
|00002ba0| 2e 0d 0d 54 68 65 20 72 | 6f 75 74 69 6e 65 73 20 |...The r|outines |
|00002bb0| 61 72 65 3a 0d 0d 20 20 | 20 20 44 42 4d 20 2a 64 |are:..  |  DBM *d|
|00002bc0| 62 6d 5f 6f 70 65 6e 20 | 28 6e 61 6d 65 2c 20 66 |bm_open |(name, f|
|00002bd0| 6c 61 67 73 2c 20 6d 6f | 64 65 29 0d 0d 20 20 20 |lags, mo|de)..   |
|00002be0| 20 76 6f 69 64 20 64 62 | 6d 5f 63 6c 6f 73 65 20 | void db|m_close |
|00002bf0| 28 66 69 6c 65 29 0d 0d | 20 20 20 20 64 61 74 75 |(file)..|    datu|
|00002c00| 6d 20 64 62 6d 5f 66 65 | 74 63 68 20 28 66 69 6c |m dbm_fe|tch (fil|
|00002c10| 65 2c 20 6b 65 79 29 0d | 0d 20 20 20 20 69 6e 74 |e, key).|.    int|
|00002c20| 20 64 62 6d 5f 73 74 6f | 72 65 20 28 66 69 6c 65 | dbm_sto|re (file|
|00002c30| 2c 20 6b 65 79 2c 20 63 | 6f 6e 74 65 6e 74 2c 20 |, key, c|ontent, |
|00002c40| 66 6c 61 67 73 29 0d 0d | 20 20 20 20 69 6e 74 20 |flags)..|    int |
|00002c50| 64 62 6d 5f 64 65 6c 65 | 74 65 20 28 66 69 6c 65 |dbm_dele|te (file|
|00002c60| 2c 20 6b 65 79 29 0d 0d | 20 20 20 20 64 61 74 75 |, key)..|    datu|
|00002c70| 6d 20 64 62 6d 5f 66 69 | 72 73 74 6b 65 79 20 28 |m dbm_fi|rstkey (|
|00002c80| 66 69 6c 65 29 0d 0d 20 | 20 20 20 64 61 74 75 6d |file).. |   datum|
|00002c90| 20 64 62 6d 5f 6e 65 78 | 74 6b 65 79 20 28 66 69 | dbm_nex|tkey (fi|
|00002ca0| 6c 65 29 0d 0d 20 20 20 | 20 69 6e 74 20 64 62 6d |le)..   | int dbm|
|00002cb0| 5f 65 72 72 6f 72 20 28 | 66 69 6c 65 29 0d 0d 20 |_error (|file).. |
|00002cc0| 20 20 20 69 6e 74 20 64 | 62 6d 5f 63 6c 65 61 72 |   int d|bm_clear|
|00002cd0| 65 72 72 20 28 66 69 6c | 65 29 0d 0d 20 20 20 20 |err (fil|e)..    |
|00002ce0| 69 6e 74 20 64 62 6d 5f | 64 69 72 66 6e 6f 20 28 |int dbm_|dirfno (|
|00002cf0| 66 69 6c 65 29 0d 0d 20 | 20 20 20 69 6e 74 20 64 |file).. |   int d|
|00002d00| 62 6d 5f 70 61 67 66 6e | 6f 20 28 66 69 6c 65 29 |bm_pagfn|o (file)|
|00002d10| 0d 0d 41 67 61 69 6e 2c | 20 6a 75 73 74 20 6c 69 |..Again,| just li|
|00002d20| 6b 65 20 6e 64 62 6d 2c | 20 61 6e 79 20 72 65 74 |ke ndbm,| any ret|
|00002d30| 75 72 6e 65 64 20 64 61 | 74 75 6d 20 63 61 6e 20 |urned da|tum can |
|00002d40| 62 65 20 61 73 73 75 6d | 65 64 20 74 6f 20 62 65 |be assum|ed to be|
|00002d50| 20 73 74 61 74 69 63 0d | 73 74 6f 72 61 67 65 2e | static.|storage.|
|00002d60| 20 20 59 6f 75 20 64 6f | 20 6e 6f 74 20 68 61 76 |  You do| not hav|
|00002d70| 65 20 74 6f 20 66 72 65 | 65 20 74 68 61 74 20 6d |e to fre|e that m|
|00002d80| 65 6d 6f 72 79 2c 20 74 | 68 65 20 6e 64 62 6d 20 |emory, t|he ndbm |
|00002d90| 63 6f 6d 70 61 74 69 62 | 69 6c 69 74 79 0d 72 6f |compatib|ility.ro|
|00002da0| 75 74 69 6e 65 73 20 77 | 69 6c 6c 20 64 6f 20 69 |utines w|ill do i|
|00002db0| 74 20 66 6f 72 20 79 6f | 75 2e 0d 0d 0d 4e 6f 74 |t for yo|u....Not|
|00002dc0| 65 73 20 6f 6e 20 6d 61 | 6b 69 6e 67 20 47 4e 55 |es on ma|king GNU|
|00002dd0| 20 64 62 6d 2e 0d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d | dbm..--|--------|
|00002de0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0d 0d |--------|------..|
|00002df0| 54 68 65 20 22 4d 61 6b | 65 66 69 6c 65 22 20 77 |The "Mak|efile" w|
|00002e00| 69 6c 6c 20 6d 61 6b 65 | 20 62 6f 74 68 20 22 67 |ill make| both "g|
|00002e10| 64 62 6d 2e 61 22 2c 20 | 74 68 65 20 63 6f 6c 6c |dbm.a", |the coll|
|00002e20| 65 63 74 69 6f 6e 20 6f | 66 20 67 64 62 6d 20 72 |ection o|f gdbm r|
|00002e30| 6f 75 74 69 6e 65 73 20 | 61 6e 64 0d 74 68 72 65 |outines |and.thre|
|00002e40| 65 20 73 69 6d 70 6c 65 | 20 74 65 73 74 20 70 72 |e simple| test pr|
|00002e50| 6f 67 72 61 6d 73 20 74 | 68 61 74 20 75 73 65 73 |ograms t|hat uses|
|00002e60| 20 74 68 65 20 67 64 62 | 6d 20 72 6f 75 74 69 6e | the gdb|m routin|
|00002e70| 65 73 2e 20 20 54 77 6f | 20 74 65 73 74 20 70 72 |es.  Two| test pr|
|00002e80| 6f 67 72 61 6d 73 0d 74 | 65 73 74 20 74 68 65 20 |ograms.t|est the |
|00002e90| 64 62 6d 20 61 6e 64 20 | 74 68 65 20 6e 64 62 6d |dbm and |the ndbm|
|00002ea0| 20 69 6e 74 65 72 66 61 | 63 65 20 72 6f 75 74 69 | interfa|ce routi|
|00002eb0| 6e 65 73 2e 20 20 54 68 | 65 20 74 68 69 72 64 20 |nes.  Th|e third |
|00002ec0| 77 61 73 20 75 73 65 20 | 74 6f 20 68 65 6c 70 0d |was use |to help.|
|00002ed0| 64 65 62 75 67 20 67 64 | 62 6d 20 61 6e 64 20 63 |debug gd|bm and c|
|00002ee0| 6f 6e 74 61 69 6e 73 20 | 22 69 6e 73 69 64 65 20 |ontains |"inside |
|00002ef0| 6b 6e 6f 77 6c 65 64 67 | 65 2e 22 20 20 20 54 68 |knowledg|e."   Th|
|00002f00| 65 20 66 69 72 73 74 20 | 74 77 6f 20 63 61 6e 20 |e first |two can |
|00002f10| 62 65 20 6c 69 6e 6b 65 | 64 0d 75 73 69 6e 67 20 |be linke|d.using |
|00002f20| 74 68 65 20 6f 72 69 67 | 69 6e 61 6c 20 64 62 6d |the orig|inal dbm|
|00002f30| 20 61 6e 64 20 6e 64 62 | 6d 20 72 6f 75 74 69 6e | and ndb|m routin|
|00002f40| 65 73 2e 20 20 54 68 65 | 20 6d 61 6b 65 66 69 6c |es.  The| makefil|
|00002f50| 65 20 61 6c 73 6f 20 6d | 61 6b 65 73 20 74 68 65 |e also m|akes the|
|00002f60| 0d 63 6f 6e 76 65 72 73 | 69 6f 6e 20 70 72 6f 67 |.convers|ion prog|
|00002f70| 72 61 6d 2c 20 63 6f 6e | 76 32 67 64 62 6d 2e 20 |ram, con|v2gdbm. |
|00002f80| 20 20 54 68 65 20 6d 61 | 6b 65 20 63 6f 6d 6d 61 |  The ma|ke comma|
|00002f90| 6e 64 73 20 61 72 65 3a | 0d 0d 20 20 20 6d 61 6b |nds are:|..   mak|
|00002fa0| 65 20 67 64 62 6d 2e 61 | 09 09 6d 61 6b 65 73 20 |e gdbm.a|..makes |
|00002fb0| 74 68 65 20 67 64 62 6d | 2e 61 20 61 72 63 68 69 |the gdbm|.a archi|
|00002fc0| 76 65 2e 0d 20 20 20 6d | 61 6b 65 20 74 65 73 74 |ve..   m|ake test|
|00002fd0| 67 64 62 6d 09 6d 61 6b | 65 73 20 62 6f 74 68 20 |gdbm.mak|es both |
|00002fe0| 67 64 62 6d 2e 61 20 61 | 6e 64 20 74 68 65 20 67 |gdbm.a a|nd the g|
|00002ff0| 64 62 6d 20 74 65 73 74 | 20 70 72 6f 67 72 61 6d |dbm test| program|
|00003000| 2e 0d 20 20 20 6d 61 6b | 65 20 74 65 73 74 64 62 |..   mak|e testdb|
|00003010| 6d 20 09 6d 61 6b 65 73 | 20 62 6f 74 68 20 67 64 |m .makes| both gd|
|00003020| 62 6d 2e 61 20 61 6e 64 | 20 74 68 65 20 64 62 6d |bm.a and| the dbm|
|00003030| 20 74 65 73 74 20 70 72 | 6f 67 72 61 6d 20 77 69 | test pr|ogram wi|
|00003040| 74 68 20 67 64 62 6d 2e | 0d 20 20 20 6d 61 6b 65 |th gdbm.|.   make|
|00003050| 20 74 65 73 74 6e 64 62 | 6d 09 6d 61 6b 65 73 20 | testndb|m.makes |
|00003060| 62 6f 74 68 20 67 64 62 | 6d 2e 61 20 61 6e 64 20 |both gdb|m.a and |
|00003070| 74 68 65 20 6e 64 62 6d | 20 74 65 73 74 20 70 72 |the ndbm| test pr|
|00003080| 6f 67 72 61 6d 20 77 69 | 74 68 20 67 64 62 6d 2e |ogram wi|th gdbm.|
|00003090| 0d 20 20 20 6d 61 6b 65 | 20 61 6c 6c 67 64 62 6d |.   make| allgdbm|
|000030a0| 09 09 6d 61 6b 65 73 20 | 61 6c 6c 20 6f 66 20 74 |..makes |all of t|
|000030b0| 68 65 20 61 62 6f 76 65 | 2e 0d 20 20 20 6d 61 6b |he above|..   mak|
|000030c0| 65 20 74 64 62 6d 09 09 | 6d 61 6b 65 73 20 74 68 |e tdbm..|makes th|
|000030d0| 65 20 64 62 6d 20 74 65 | 73 74 20 70 72 6f 67 72 |e dbm te|st progr|
|000030e0| 61 6d 20 6c 69 6e 6b 65 | 64 20 77 69 74 68 20 64 |am linke|d with d|
|000030f0| 62 6d 2c 20 6e 6f 74 20 | 67 64 62 6d 2e 0d 20 20 |bm, not |gdbm..  |
|00003100| 20 6d 61 6b 65 20 74 6e | 64 62 6d 09 09 6d 61 6b | make tn|dbm..mak|
|00003110| 65 73 20 74 68 65 20 6e | 64 62 6d 20 74 65 73 74 |es the n|dbm test|
|00003120| 20 70 72 6f 67 72 61 6d | 20 6c 69 6e 6b 65 64 20 | program| linked |
|00003130| 77 69 74 68 20 6e 64 62 | 6d 2c 20 6e 6f 74 20 67 |with ndb|m, not g|
|00003140| 64 62 6d 2e 0d 20 20 20 | 6d 61 6b 65 20 61 6c 6c |dbm..   |make all|
|00003150| 64 62 6d 09 09 6d 61 6b | 65 73 20 74 68 65 20 74 |dbm..mak|es the t|
|00003160| 77 6f 20 70 72 65 76 69 | 6f 75 73 20 70 72 6f 67 |wo previ|ous prog|
|00003170| 72 61 6d 73 2e 0d 20 20 | 20 6d 61 6b 65 20 63 6f |rams..  | make co|
|00003180| 6e 76 32 67 64 62 6d 09 | 6d 61 6b 65 73 20 74 68 |nv2gdbm.|makes th|
|00003190| 65 20 63 6f 6e 76 65 72 | 73 69 6f 6e 20 70 72 6f |e conver|sion pro|
|000031a0| 67 72 61 6d 2e 0d 20 20 | 20 6d 61 6b 65 20 61 6c |gram..  | make al|
|000031b0| 6c 09 09 6d 61 6b 65 73 | 20 61 6c 6c 20 74 68 65 |l..makes| all the|
|000031c0| 20 61 62 6f 76 65 2e 0d | 20 20 20 6d 61 6b 65 20 | above..|   make |
|000031d0| 69 6e 73 74 61 6c 6c 09 | 09 69 6e 73 74 61 6c 6c |install.|.install|
|000031e0| 73 20 67 64 62 6d 2e 61 | 20 61 73 20 2f 75 73 72 |s gdbm.a| as /usr|
|000031f0| 2f 6c 69 62 2f 6c 69 62 | 67 64 62 6d 2e 61 20 61 |/lib/lib|gdbm.a a|
|00003200| 6e 64 20 67 64 62 6d 2e | 68 2e 0d 0d 0d 43 4f 4e |nd gdbm.|h....CON|
|00003210| 56 32 47 44 42 4d 0d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |V2GDBM.-|--------|
|00003220| 0d 0d 54 68 65 20 70 72 | 6f 67 72 61 6d 20 63 6f |..The pr|ogram co|
|00003230| 6e 76 32 67 64 62 6d 20 | 68 61 73 20 62 65 65 6e |nv2gdbm |has been|
|00003240| 20 70 72 6f 76 69 64 65 | 64 20 74 6f 20 68 65 6c | provide|d to hel|
|00003250| 70 20 79 6f 75 20 63 6f | 6e 76 65 72 74 20 66 72 |p you co|nvert fr|
|00003260| 6f 6d 20 64 62 6d 0d 64 | 61 74 61 62 61 73 65 73 |om dbm.d|atabases|
|00003270| 20 74 6f 20 67 64 62 6d | 2e 20 20 54 68 65 20 75 | to gdbm|.  The u|
|00003280| 73 61 67 65 20 69 73 3a | 0d 0d 20 20 20 63 6f 6e |sage is:|..   con|
|00003290| 76 32 67 64 62 6d 20 5b | 2d 71 5d 20 5b 2d 62 20 |v2gdbm [|-q] [-b |
|000032a0| 62 6c 6f 63 6b 5f 73 69 | 7a 65 5d 20 64 62 6d 5f |block_si|ze] dbm_|
|000032b0| 66 69 6c 65 20 5b 67 64 | 62 6d 5f 66 69 6c 65 5d |file [gd|bm_file]|
|000032c0| 0d 0d 54 68 65 20 6f 70 | 74 69 6f 6e 61 6c 20 22 |..The op|tional "|
|000032d0| 62 6c 6f 63 6b 5f 73 69 | 7a 65 22 20 69 73 20 74 |block_si|ze" is t|
|000032e0| 68 65 20 73 61 6d 65 20 | 61 73 20 69 6e 20 67 64 |he same |as in gd|
|000032f0| 62 6d 5f 6f 70 65 6e 2e | 20 20 54 68 65 20 64 62 |bm_open.|  The db|
|00003300| 6d 5f 66 69 6c 65 20 69 | 73 0d 74 68 65 20 6e 61 |m_file i|s.the na|
|00003310| 6d 65 20 6f 66 20 74 68 | 65 20 64 62 6d 20 66 69 |me of th|e dbm fi|
|00003320| 6c 65 20 77 69 74 68 6f | 75 74 20 74 68 65 20 2e |le witho|ut the .|
|00003330| 70 61 67 20 6f 72 20 2e | 64 69 72 20 65 78 74 65 |pag or .|dir exte|
|00003340| 6e 73 69 6f 6e 73 2e 20 | 20 54 68 65 0d 6f 70 74 |nsions. | The.opt|
|00003350| 69 6f 6e 61 6c 20 67 64 | 62 6d 5f 66 69 6c 65 20 |ional gd|bm_file |
|00003360| 69 73 20 74 68 65 20 63 | 6f 6d 70 6c 65 74 65 20 |is the c|omplete |
|00003370| 66 69 6c 65 20 6e 61 6d | 65 2e 20 20 49 66 20 6e |file nam|e.  If n|
|00003380| 6f 74 20 69 6e 63 6c 75 | 64 65 64 2c 20 74 68 65 |ot inclu|ded, the|
|00003390| 0d 67 64 62 6d 20 66 69 | 6c 65 20 6e 61 6d 65 20 |.gdbm fi|le name |
|000033a0| 69 73 20 74 68 65 20 73 | 61 6d 65 20 61 73 20 74 |is the s|ame as t|
|000033b0| 68 65 20 64 62 6d 20 66 | 69 6c 65 20 6e 61 6d 65 |he dbm f|ile name|
|000033c0| 20 77 69 74 68 6f 75 74 | 20 61 6e 79 20 65 78 74 | without| any ext|
|000033d0| 65 6e 73 69 6f 6e 73 2e | 0d 54 68 61 74 20 69 73 |ensions.|.That is|
|000033e0| 20 22 63 6f 6e 76 32 67 | 64 62 6d 20 64 62 6d 66 | "conv2g|dbm dbmf|
|000033f0| 69 6c 65 22 20 63 6f 6e | 76 65 72 74 73 20 74 68 |ile" con|verts th|
|00003400| 65 20 66 69 6c 65 73 20 | 22 64 62 6d 66 69 6c 65 |e files |"dbmfile|
|00003410| 2e 70 61 67 22 20 61 6e | 64 0d 22 64 62 6d 66 69 |.pag" an|d."dbmfi|
|00003420| 6c 65 2e 64 69 72 22 20 | 69 6e 74 6f 20 61 20 67 |le.dir" |into a g|
|00003430| 64 62 6d 20 66 69 6c 65 | 20 63 61 6c 6c 65 64 20 |dbm file| called |
|00003440| 22 64 62 6d 66 69 6c 65 | 22 2e 20 20 54 68 65 20 |"dbmfile|".  The |
|00003450| 2d 71 20 6f 70 74 69 6f | 6e 20 63 61 75 73 65 73 |-q optio|n causes|
|00003460| 0d 63 6f 6e 76 32 67 64 | 62 6d 20 74 6f 20 77 6f |.conv2gd|bm to wo|
|00003470| 72 6b 20 71 75 69 65 74 | 6c 79 2e 0d 0d 0d 53 79 |rk quiet|ly....Sy|
|00003480| 73 74 65 6d 20 56 20 73 | 75 70 70 6f 72 74 20 20 |stem V s|upport  |
|00003490| 28 41 6e 64 20 6f 74 68 | 65 72 20 73 79 73 74 65 |(And oth|er syste|
|000034a0| 6d 73 2e 29 0d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |ms.).---|--------|
|000034b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000034c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0d 0d 54 68 65 |--------|---..The|
|000034d0| 72 65 20 69 73 20 6e 6f | 77 20 73 75 70 70 6f 72 |re is no|w suppor|
|000034e0| 74 20 66 6f 72 20 53 79 | 73 74 65 6d 20 56 2e 20 |t for Sy|stem V. |
|000034f0| 20 54 68 69 73 20 64 6f | 6e 65 20 76 69 61 20 74 | This do|ne via t|
|00003500| 68 65 20 73 79 73 74 65 | 6d 73 2e 68 20 66 69 6c |he syste|ms.h fil|
|00003510| 65 2e 0d 54 68 69 73 20 | 69 73 20 74 68 65 20 70 |e..This |is the p|
|00003520| 6c 61 63 65 20 77 68 65 | 72 65 20 61 6c 6c 20 73 |lace whe|re all s|
|00003530| 79 73 74 65 6d 20 64 65 | 70 65 6e 64 65 6e 63 69 |ystem de|pendenci|
|00003540| 65 73 20 73 68 6f 75 6c | 64 20 67 6f 2e 20 20 54 |es shoul|d go.  T|
|00003550| 68 65 20 0d 6d 61 6b 65 | 66 69 6c 65 20 73 68 6f |he .make|file sho|
|00003560| 75 6c 64 20 6d 61 6b 65 | 20 67 64 62 6d 20 77 69 |uld make| gdbm wi|
|00003570| 74 68 20 61 20 66 65 77 | 20 63 68 61 6e 67 65 73 |th a few| changes|
|00003580| 2e 20 20 54 68 65 20 6d | 61 6b 65 66 69 6c 65 20 |.  The m|akefile |
|00003590| 64 65 73 63 72 69 62 65 | 73 0d 74 68 65 20 63 68 |describe|s.the ch|
|000035a0| 61 6e 67 65 73 20 6e 65 | 63 65 73 73 61 72 79 20 |anges ne|cessary |
|000035b0| 66 6f 72 20 75 73 65 20 | 77 69 74 68 20 53 79 73 |for use |with Sys|
|000035c0| 74 65 6d 20 56 2e 20 20 | 41 6c 73 6f 2c 20 72 65 |tem V.  |Also, re|
|000035d0| 61 64 20 74 68 65 20 6d | 61 6b 65 66 69 6c 65 0d |ad the m|akefile.|
|000035e0| 61 6e 64 20 65 64 69 74 | 20 69 74 20 69 66 20 79 |and edit| it if y|
|000035f0| 6f 75 20 75 73 65 20 67 | 63 63 2e 20 20 54 68 65 |ou use g|cc.  The|
|00003600| 72 65 20 61 72 65 20 73 | 65 76 65 72 61 6c 20 70 |re are s|everal p|
|00003610| 6c 61 63 65 73 20 77 68 | 65 72 65 20 63 68 61 6e |laces wh|ere chan|
|00003620| 67 65 73 0d 61 72 65 20 | 6e 65 65 64 65 64 20 74 |ges.are |needed t|
|00003630| 6f 20 75 73 65 20 67 63 | 63 2e 0d 20 20 31 29 20 |o use gc|c..  1) |
|00003640| 20 75 6e 63 6f 6d 6d 65 | 6e 74 3a 20 23 43 43 3d | uncomme|nt: #CC=|
|00003650| 67 63 63 0d 20 20 32 29 | 20 20 63 68 61 6e 67 65 |gcc.  2)|  change|
|00003660| 20 74 68 65 20 6c 69 6e | 65 73 20 74 6f 20 6d 61 | the lin|es to ma|
|00003670| 6b 65 20 74 68 65 20 74 | 65 73 74 20 70 72 6f 67 |ke the t|est prog|
|00003680| 72 61 6d 73 2e 20 28 53 | 65 65 20 74 68 65 20 63 |rams. (S|ee the c|
|00003690| 6f 6d 6d 65 6e 74 73 2e | 29 0d 0d 49 66 20 79 6f |omments.|)..If yo|
|000036a0| 75 20 70 6f 72 74 20 67 | 64 62 6d 20 74 6f 20 61 |u port g|dbm to a|
|000036b0| 6e 6f 74 68 65 72 20 73 | 79 73 74 65 6d 2c 20 74 |nother s|ystem, t|
|000036c0| 72 79 20 74 6f 20 66 6f | 6c 6c 6f 77 20 74 68 65 |ry to fo|llow the|
|000036d0| 20 63 68 61 6e 67 65 20 | 73 74 79 6c 65 20 75 73 | change |style us|
|000036e0| 65 64 20 66 6f 72 0d 53 | 79 73 74 65 6d 20 56 20 |ed for.S|ystem V |
|000036f0| 63 68 61 6e 67 65 73 2e | 20 20 50 6c 65 61 73 65 |changes.|  Please|
|00003700| 20 73 65 6e 64 20 79 6f | 75 72 20 63 68 61 6e 67 | send yo|ur chang|
|00003710| 65 73 20 74 6f 20 70 68 | 69 6c 40 63 73 2e 77 77 |es to ph|il@cs.ww|
|00003720| 75 2e 65 64 75 20 69 66 | 20 79 6f 75 20 77 6f 75 |u.edu if| you wou|
|00003730| 6c 64 0d 6c 69 6b 65 20 | 79 6f 75 72 20 63 68 61 |ld.like |your cha|
|00003740| 6e 67 65 73 20 69 6e 63 | 6c 75 64 65 64 20 69 6e |nges inc|luded in|
|00003750| 20 61 20 66 75 74 75 72 | 65 20 72 65 6c 65 61 73 | a futur|e releas|
|00003760| 65 20 6f 66 20 67 64 62 | 6d 2e 0d 0d 50 6c 65 61 |e of gdb|m...Plea|
|00003770| 73 65 20 73 65 6e 64 20 | 62 75 67 20 72 65 70 6f |se send |bug repo|
|00003780| 72 74 73 20 74 6f 20 62 | 75 67 2d 67 6e 75 2d 75 |rts to b|ug-gnu-u|
|00003790| 74 69 6c 73 40 70 72 65 | 70 2e 61 69 2e 6d 69 74 |tils@pre|p.ai.mit|
|000037a0| 2e 65 64 75 2e 0d 0d 54 | 68 61 6e 6b 20 79 6f 75 |.edu...T|hank you|
|000037b0| 2e 0d 0d 0d 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000037c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000037d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000037e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000037f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00003800| 00 00 01 00 00 00 01 6e | 00 00 00 6e 00 00 00 3e |.......n|...n...>|
|00003810| 00 00 02 e3 08 52 4f 4d | 20 4d 61 70 73 00 01 00 |.....ROM| Maps...|
|00003820| 00 00 00 10 00 00 05 26 | a4 31 e9 40 a6 b6 fe c3 |.......&|.1.@....|
|00003830| 06 52 45 41 44 4d 45 da | 02 00 00 00 54 45 58 54 |.README.|....TEXT|
|00003840| 4d 50 53 20 00 00 00 00 | 00 00 00 00 00 00 57 85 |MPS ....|......W.|
|00003850| 00 00 54 45 58 54 4d 50 | 53 20 00 00 00 00 00 00 |..TEXTMP|S ......|
|00003860| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00003870| 00 00 a6 04 08 27 00 00 | 37 34 00 00 01 ac e9 40 |.....'..|74.....@|
|00003880| a7 33 25 78 00 00 00 00 | 00 a2 00 40 01 5e 01 d4 |.3%x....|...@.^..|
|00003890| 01 00 01 04 01 00 01 00 | ff f8 ff f0 00 00 00 00 |........|........|
|000038a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000038b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000038c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000038d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000038e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000038f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00003900| 00 00 00 48 00 09 4d 6f | 6e 61 63 6f 00 00 00 00 |...H..Mo|naco....|
|00003910| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00003920| 00 00 00 00 00 00 00 06 | 00 03 00 3c 00 24 01 dd |........|...<.$..|
|00003930| 02 3d 00 3c 00 24 01 dd | 02 3d a6 04 08 28 00 00 |.=.<.$..|.=...(..|
|00003940| 00 00 00 00 00 00 00 00 | 1a 7b 01 00 00 00 00 1e |........|.{......|
|00003950| 00 3c 00 24 01 dd 02 3d | 00 3c 00 24 01 dd 02 3d |.<.$...=|.<.$...=|
|00003960| 00 00 1a 7b 00 00 00 00 | 00 00 00 00 00 00 00 00 |...{....|........|
|00003970| 01 00 00 00 01 6e 00 00 | 00 6e 00 00 00 3e 00 49 |.....n..|.n...>.I|
|00003980| aa 38 11 44 00 00 00 1c | 00 3e 00 00 4d 50 53 52 |.8.D....|.>..MPSR|
|00003990| 00 01 00 0a 03 ed ff ff | 00 00 00 00 00 00 00 00 |........|........|
|000039a0| 03 f0 ff ff 00 00 00 4c | 00 4f dd e4 00 00 00 00 |.......L|.O......|
|000039b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000039c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000039d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000039e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000039f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+