/ Hex Artifact Content
Login

Artifact 5f8f9aa18a17e728e604dc48bc435111ce7d4f73:


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                                               .