Artifact
5f8f9aa18a17e728e604dc48bc435111ce7d4f73:
- File
src/dbbe.c
— part of check-in
[979ef5d5]
at
2000-10-19 01:49:02
on branch trunk
— Break out DBBE drivers into separate files. (CVS 157)
(user:
drh
size: 2657)
0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20 /*.** Copyright
0010: 28 63 29 20 31 39 39 39 2c 20 32 30 30 30 20 44 (c) 1999, 2000 D
0020: 2e 20 52 69 63 68 61 72 64 20 48 69 70 70 0a 2a . Richard Hipp.*
0030: 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61 *.** This progra
0040: 6d 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 m is free softwa
0050: 72 65 3b 20 79 6f 75 20 63 61 6e 20 72 65 64 69 re; you can redi
0060: 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f stribute it and/
0070: 6f 72 0a 2a 2a 20 6d 6f 64 69 66 79 20 69 74 20 or.** modify it
0080: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 under the terms
0090: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 of the GNU Gener
00a0: 61 6c 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63 al Public.** Lic
00b0: 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 65 ense as publishe
00c0: 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f d by the Free So
00d0: 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f ftware Foundatio
00e0: 6e 3b 20 65 69 74 68 65 72 0a 2a 2a 20 76 65 72 n; either.** ver
00f0: 73 69 6f 6e 20 32 20 6f 66 20 74 68 65 20 4c 69 sion 2 of the Li
0100: 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20 79 6f cense, or (at yo
0110: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c ur option) any l
0120: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2a 2a ater version..**
0130: 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61 6d .** This program
0140: 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 is distributed
0150: 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74 in the hope that
0160: 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66 it will be usef
0170: 75 6c 2c 0a 2a 2a 20 62 75 74 20 57 49 54 48 4f ul,.** but WITHO
0180: 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b UT ANY WARRANTY;
0190: 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68 without even th
01a0: 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e e implied warran
01b0: 74 79 20 6f 66 0a 2a 2a 20 4d 45 52 43 48 41 4e ty of.** MERCHAN
01c0: 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e TABILITY or FITN
01d0: 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43 ESS FOR A PARTIC
01e0: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53 ULAR PURPOSE. S
01f0: 65 65 20 74 68 65 20 47 4e 55 0a 2a 2a 20 47 65 ee the GNU.** Ge
0200: 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 neral Public Lic
0210: 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65 ense for more de
0220: 74 61 69 6c 73 2e 0a 2a 2a 20 0a 2a 2a 20 59 6f tails..** .** Yo
0230: 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 u should have re
0240: 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66 ceived a copy of
0250: 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c the GNU General
0260: 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e Public.** Licen
0270: 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 se along with th
0280: 69 73 20 6c 69 62 72 61 72 79 3b 20 69 66 20 6e is library; if n
0290: 6f 74 2c 20 77 72 69 74 65 20 74 6f 20 74 68 65 ot, write to the
02a0: 0a 2a 2a 20 46 72 65 65 20 53 6f 66 74 77 61 72 .** Free Softwar
02b0: 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e e Foundation, In
02c0: 63 2e 2c 20 35 39 20 54 65 6d 70 6c 65 20 50 6c c., 59 Temple Pl
02d0: 61 63 65 20 2d 20 53 75 69 74 65 20 33 33 30 2c ace - Suite 330,
02e0: 0a 2a 2a 20 42 6f 73 74 6f 6e 2c 20 4d 41 20 20 .** Boston, MA
02f0: 30 32 31 31 31 2d 31 33 30 37 2c 20 55 53 41 2e 02111-1307, USA.
0300: 0a 2a 2a 0a 2a 2a 20 41 75 74 68 6f 72 20 63 6f .**.** Author co
0310: 6e 74 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f ntact informatio
0320: 6e 3a 0a 2a 2a 20 20 20 64 72 68 40 68 77 61 63 n:.** drh@hwac
0330: 69 2e 63 6f 6d 0a 2a 2a 20 20 20 68 74 74 70 3a i.com.** http:
0340: 2f 2f 77 77 77 2e 68 77 61 63 69 2e 63 6f 6d 2f //www.hwaci.com/
0350: 64 72 68 2f 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a drh/.**.********
0360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
03a0: 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 *.** This file c
03b0: 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 74 6f 20 ontains code to
03c0: 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 64 61 implement the da
03d0: 74 61 62 61 73 65 20 62 61 63 6b 65 6e 64 20 28 tabase backend (
03e0: 44 42 42 45 29 0a 2a 2a 20 66 6f 72 20 73 71 6c DBBE).** for sql
03f0: 69 74 65 2e 20 20 54 68 65 20 64 61 74 61 62 61 ite. The databa
0400: 73 65 20 62 61 63 6b 65 6e 64 20 69 73 20 74 68 se backend is th
0410: 65 20 69 6e 74 65 72 66 61 63 65 20 62 65 74 77 e interface betw
0420: 65 65 6e 0a 2a 2a 20 73 71 6c 69 74 65 20 61 6e een.** sqlite an
0430: 64 20 74 68 65 20 63 6f 64 65 20 74 68 61 74 20 d the code that
0440: 64 6f 65 73 20 74 68 65 20 61 63 74 75 61 6c 6c does the actuall
0450: 79 20 72 65 61 64 69 6e 67 20 61 6e 64 20 77 72 y reading and wr
0460: 69 74 69 6e 67 0a 2a 2a 20 6f 66 20 69 6e 66 6f iting.** of info
0470: 72 6d 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 64 rmation to the d
0480: 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 isk..**.** This
0490: 66 69 6c 65 20 75 73 65 73 20 47 44 42 4d 20 61 file uses GDBM a
04a0: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 s the database b
04b0: 61 63 6b 65 6e 64 2e 20 20 49 74 20 73 68 6f 75 ackend. It shou
04c0: 6c 64 20 62 65 0a 2a 2a 20 72 65 6c 61 74 69 76 ld be.** relativ
04d0: 65 6c 79 20 73 69 6d 70 6c 65 20 74 6f 20 63 6f ely simple to co
04e0: 6e 76 65 72 74 20 74 6f 20 61 20 64 69 66 66 65 nvert to a diffe
04f0: 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 73 75 rent database su
0500: 63 68 0a 2a 2a 20 61 73 20 4e 44 42 4d 2c 20 53 ch.** as NDBM, S
0510: 44 42 4d 2c 20 6f 72 20 42 65 72 6b 65 6c 65 79 DBM, or Berkeley
0520: 44 42 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 64 DB..**.** $Id: d
0530: 62 62 65 2e 63 2c 76 20 31 2e 32 30 20 32 30 30 bbe.c,v 1.20 200
0540: 30 2f 31 30 2f 31 39 20 30 31 3a 34 39 3a 30 32 0/10/19 01:49:02
0550: 20 64 72 68 20 45 78 70 20 24 0a 2a 2f 0a 23 69 drh Exp $.*/.#i
0560: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e nclude "sqliteIn
0570: 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 t.h"../*.** This
0580: 20 72 6f 75 74 69 6e 65 20 6f 70 65 6e 73 20 61 routine opens a
0590: 20 6e 65 77 20 64 61 74 61 62 61 73 65 2e 20 20 new database.
05a0: 49 74 20 6c 6f 6f 6b 73 20 61 74 20 74 68 65 20 It looks at the
05b0: 66 69 72 73 74 0a 2a 2a 20 66 65 77 20 63 68 61 first.** few cha
05c0: 72 61 63 74 65 72 73 20 6f 66 20 74 68 65 20 64 racters of the d
05d0: 61 74 61 62 61 73 65 20 6e 61 6d 65 20 74 6f 20 atabase name to
05e0: 74 72 79 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 try to determine
05f0: 20 77 68 61 74 0a 2a 2a 20 6b 69 6e 64 20 6f 66 what.** kind of
0600: 20 64 61 74 61 62 61 73 65 20 74 6f 20 6f 70 65 database to ope
0610: 6e 2e 20 20 49 66 20 74 68 65 20 66 69 72 73 74 n. If the first
0620: 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 characters are
0630: 22 67 64 62 6d 3a 22 2c 0a 2a 2a 20 74 68 65 6e "gdbm:",.** then
0640: 20 69 74 20 75 73 65 73 20 74 68 65 20 47 44 42 it uses the GDB
0650: 4d 20 64 72 69 76 65 72 2e 20 20 49 66 20 74 68 M driver. If th
0660: 65 20 66 69 72 73 74 20 66 65 77 20 63 68 61 72 e first few char
0670: 61 63 74 65 72 73 20 61 72 65 0a 2a 2a 20 22 6d acters are.** "m
0680: 65 6d 6f 72 79 3a 22 20 74 68 65 6e 20 69 74 20 emory:" then it
0690: 75 73 65 73 20 74 68 65 20 69 6e 2d 6d 65 6d 6f uses the in-memo
06a0: 72 79 20 64 72 69 76 65 72 2e 20 20 49 66 20 74 ry driver. If t
06b0: 68 65 72 65 20 69 73 20 6e 6f 0a 2a 2a 20 6d 61 here is no.** ma
06c0: 74 63 68 2c 20 74 68 65 20 64 65 66 61 75 6c 74 tch, the default
06d0: 20 74 6f 20 74 68 65 20 47 44 42 4d 20 64 72 69 to the GDBM dri
06e0: 76 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 ver..**.** If su
06f0: 63 63 65 73 73 66 75 6c 2c 20 61 20 70 6f 69 6e ccessful, a poin
0700: 74 65 72 20 74 6f 20 74 68 65 20 44 62 62 65 20 ter to the Dbbe
0710: 73 74 72 75 63 74 75 72 65 20 69 73 20 72 65 74 structure is ret
0720: 75 72 6e 65 64 2e 0a 2a 2a 20 49 66 20 74 68 65 urned..** If the
0730: 72 65 20 61 72 65 20 65 72 72 6f 72 73 2c 20 61 re are errors, a
0740: 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 n appropriate er
0750: 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20 6c ror message is l
0760: 65 66 74 0a 2a 2a 20 69 6e 20 2a 70 7a 45 72 72 eft.** in *pzErr
0770: 4d 73 67 20 61 6e 64 20 4e 55 4c 4c 20 69 73 20 Msg and NULL is
0780: 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 44 62 62 returned..*/.Dbb
0790: 65 20 2a 73 71 6c 69 74 65 44 62 62 65 4f 70 65 e *sqliteDbbeOpe
07a0: 6e 28 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 n(. const char
07b0: 2a 7a 4e 61 6d 65 2c 20 20 20 20 20 2f 2a 20 54 *zName, /* T
07c0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 he name of the d
07d0: 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 atabase */. int
07e0: 20 77 72 69 74 65 46 6c 61 67 2c 20 20 20 20 20 writeFlag,
07f0: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 77 /* True if w
0800: 65 20 77 69 6c 6c 20 62 65 20 77 72 69 74 69 6e e will be writin
0810: 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 g to the databas
0820: 65 20 2a 2f 0a 20 20 69 6e 74 20 63 72 65 61 74 e */. int creat
0830: 65 46 6c 61 67 2c 20 20 20 20 20 20 20 20 2f 2a eFlag, /*
0840: 20 54 72 75 65 20 74 6f 20 63 72 65 61 74 65 20 True to create
0850: 64 61 74 61 62 61 73 65 20 69 66 20 69 74 20 64 database if it d
0860: 6f 65 73 6e 27 74 20 65 78 69 73 74 20 2a 2f 0a oesn't exist */.
0870: 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 char **pzErrMs
0880: 67 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 g /* Writ
0890: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 e error messages
08a0: 20 28 69 66 20 61 6e 79 29 20 68 65 72 65 20 2a (if any) here *
08b0: 2f 0a 29 7b 0a 20 20 65 78 74 65 72 6e 20 44 62 /.){. extern Db
08c0: 62 65 20 2a 73 71 6c 69 74 65 47 64 62 6d 4f 70 be *sqliteGdbmOp
08d0: 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 en(const char*,i
08e0: 6e 74 2c 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a nt,int,char**);.
08f0: 20 20 69 66 28 20 73 74 72 6e 63 6d 70 28 7a 4e if( strncmp(zN
0900: 61 6d 65 2c 20 22 67 64 62 6d 3a 22 2c 20 35 29 ame, "gdbm:", 5)
0910: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
0920: 6e 20 73 71 6c 69 74 65 47 64 62 6d 4f 70 65 6e n sqliteGdbmOpen
0930: 28 26 7a 4e 61 6d 65 5b 35 5d 2c 20 77 72 69 74 (&zName[5], writ
0940: 65 46 6c 61 67 2c 20 63 72 65 61 74 65 46 6c 61 eFlag, createFla
0950: 67 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 g, pzErrMsg);.
0960: 7d 0a 23 69 66 20 30 0a 20 20 69 66 28 20 73 74 }.#if 0. if( st
0970: 72 6e 63 6d 70 28 7a 4e 61 6d 65 2c 20 22 6d 65 rncmp(zName, "me
0980: 6d 6f 72 79 3a 22 2c 20 37 29 3d 3d 30 20 29 7b mory:", 7)==0 ){
0990: 0a 20 20 20 20 65 78 74 65 72 6e 20 44 62 62 65 . extern Dbbe
09a0: 20 2a 73 71 6c 69 74 65 4d 65 6d 4f 70 65 6e 28 *sqliteMemOpen(
09b0: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 2c const char*,int,
09c0: 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a 20 20 20 int,char**);.
09d0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 4d 65 return sqliteMe
09e0: 6d 4f 70 65 6e 28 26 7a 4e 61 6d 65 5b 37 5d 2c mOpen(&zName[7],
09f0: 20 77 72 69 74 65 46 6c 61 67 2c 20 63 72 65 61 writeFlag, crea
0a00: 74 65 46 6c 61 67 2c 20 70 7a 45 72 72 4d 73 67 teFlag, pzErrMsg
0a10: 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 );. }.#endif.
0a20: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 47 64 62 return sqliteGdb
0a30: 6d 4f 70 65 6e 28 7a 4e 61 6d 65 2c 20 77 72 69 mOpen(zName, wri
0a40: 74 65 46 6c 61 67 2c 20 63 72 65 61 74 65 46 6c teFlag, createFl
0a50: 61 67 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 7d ag, pzErrMsg);.}
0a60: 0a .