Hex Artifact Content
Not logged in
Home Timeline Files Branches Tags Tickets Wiki Login
Download

Artifact 48e2b09f2c80a7e1534e44be784fa274b46f04a2:

0000: 3b 3b 0a 3b 3b 20 43 6f 70 79 72 69 67 68 74 20  ;;.;; Copyright 
0010: 32 30 31 36 20 41 6c 64 6f 20 4e 69 63 6f 6c 61  2016 Aldo Nicola
0020: 73 20 42 72 75 6e 6f 0a 3b 3b 0a 3b 3b 20 4c 69  s Bruno.;;.;; Li
0030: 63 65 6e 73 65 64 20 75 6e 64 65 72 20 74 68 65  censed under the
0040: 20 41 70 61 63 68 65 20 4c 69 63 65 6e 73 65 2c   Apache License,
0050: 20 56 65 72 73 69 6f 6e 20 32 2e 30 20 28 74 68   Version 2.0 (th
0060: 65 20 22 4c 69 63 65 6e 73 65 22 29 3b 0a 3b 3b  e "License");.;;
0070: 20 79 6f 75 20 6d 61 79 20 6e 6f 74 20 75 73 65   you may not use
0080: 20 74 68 69 73 20 66 69 6c 65 20 65 78 63 65 70   this file excep
0090: 74 20 69 6e 20 63 6f 6d 70 6c 69 61 6e 63 65 20  t in compliance 
00a0: 77 69 74 68 20 74 68 65 20 4c 69 63 65 6e 73 65  with the License
00b0: 2e 0a 3b 3b 20 59 6f 75 20 6d 61 79 20 6f 62 74  ..;; You may obt
00c0: 61 69 6e 20 61 20 63 6f 70 79 20 6f 66 20 74 68  ain a copy of th
00d0: 65 20 4c 69 63 65 6e 73 65 20 61 74 0a 3b 3b 0a  e License at.;;.
00e0: 3b 3b 20 20 20 20 20 68 74 74 70 3a 2f 2f 77 77  ;;     http://ww
00f0: 77 2e 61 70 61 63 68 65 2e 6f 72 67 2f 6c 69 63  w.apache.org/lic
0100: 65 6e 73 65 73 2f 4c 49 43 45 4e 53 45 2d 32 2e  enses/LICENSE-2.
0110: 30 0a 3b 3b 0a 3b 3b 20 55 6e 6c 65 73 73 20 72  0.;;.;; Unless r
0120: 65 71 75 69 72 65 64 20 62 79 20 61 70 70 6c 69  equired by appli
0130: 63 61 62 6c 65 20 6c 61 77 20 6f 72 20 61 67 72  cable law or agr
0140: 65 65 64 20 74 6f 20 69 6e 20 77 72 69 74 69 6e  eed to in writin
0150: 67 2c 20 73 6f 66 74 77 61 72 65 0a 3b 3b 20 64  g, software.;; d
0160: 69 73 74 72 69 62 75 74 65 64 20 75 6e 64 65 72  istributed under
0170: 20 74 68 65 20 4c 69 63 65 6e 73 65 20 69 73 20   the License is 
0180: 64 69 73 74 72 69 62 75 74 65 64 20 6f 6e 20 61  distributed on a
0190: 6e 20 22 41 53 20 49 53 22 20 42 41 53 49 53 2c  n "AS IS" BASIS,
01a0: 0a 3b 3b 20 57 49 54 48 4f 55 54 20 57 41 52 52  .;; WITHOUT WARR
01b0: 41 4e 54 49 45 53 20 4f 52 20 43 4f 4e 44 49 54  ANTIES OR CONDIT
01c0: 49 4f 4e 53 20 4f 46 20 41 4e 59 20 4b 49 4e 44  IONS OF ANY KIND
01d0: 2c 20 65 69 74 68 65 72 20 65 78 70 72 65 73 73  , either express
01e0: 20 6f 72 20 69 6d 70 6c 69 65 64 2e 0a 3b 3b 20   or implied..;; 
01f0: 53 65 65 20 74 68 65 20 4c 69 63 65 6e 73 65 20  See the License 
0200: 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 63  for the specific
0210: 20 6c 61 6e 67 75 61 67 65 20 67 6f 76 65 72 6e   language govern
0220: 69 6e 67 20 70 65 72 6d 69 73 73 69 6f 6e 73 20  ing permissions 
0230: 61 6e 64 0a 3b 3b 20 6c 69 6d 69 74 61 74 69 6f  and.;; limitatio
0240: 6e 73 20 75 6e 64 65 72 20 74 68 65 20 4c 69 63  ns under the Lic
0250: 65 6e 73 65 2e 0a 0a 20 28 64 65 66 69 6e 65 2d  ense... (define-
0260: 73 79 6e 74 61 78 20 6d 64 62 2d 64 65 66 69 6e  syntax mdb-defin
0270: 65 0a 20 20 20 28 73 79 6e 74 61 78 2d 72 75 6c  e.   (syntax-rul
0280: 65 73 20 28 29 0a 20 20 20 20 20 28 28 5f 20 6e  es ().     ((_ n
0290: 61 6d 65 20 6e 29 20 0a 20 20 20 20 20 20 28 64  ame n) .      (d
02a0: 65 66 69 6e 65 2d 73 79 6e 74 61 78 20 6e 61 6d  efine-syntax nam
02b0: 65 20 28 69 64 65 6e 74 69 66 69 65 72 2d 73 79  e (identifier-sy
02c0: 6e 74 61 78 20 6e 29 29 29 29 29 0a 0a 28 6d 64  ntax n)))))..(md
02d0: 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 53 55 43  b-define MDB_SUC
02e0: 43 45 53 53 09 20 30 29 0a 09 3b 3b 20 6b 65 79  CESS. 0)..;; key
02f0: 2f 64 61 74 61 20 70 61 69 72 20 61 6c 72 65 61  /data pair alrea
0300: 64 79 20 65 78 69 73 74 73 20 0a 28 6d 64 62 2d  dy exists .(mdb-
0310: 64 65 66 69 6e 65 20 4d 44 42 5f 4b 45 59 45 58  define MDB_KEYEX
0320: 49 53 54 09 2d 33 30 37 39 39 29 0a 09 3b 3b 20  IST.-30799)..;; 
0330: 6b 65 79 2f 64 61 74 61 20 70 61 69 72 20 6e 6f  key/data pair no
0340: 74 20 66 6f 75 6e 64 20 28 45 4f 46 29 20 0a 28  t found (EOF) .(
0350: 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 4e  mdb-define MDB_N
0360: 4f 54 46 4f 55 4e 44 09 2d 33 30 37 39 38 29 0a  OTFOUND.-30798).
0370: 09 3b 3b 20 52 65 71 75 65 73 74 65 64 20 70 61  .;; Requested pa
0380: 67 65 20 6e 6f 74 20 66 6f 75 6e 64 20 2d 20 74  ge not found - t
0390: 68 69 73 20 75 73 75 61 6c 6c 79 20 69 6e 64 69  his usually indi
03a0: 63 61 74 65 73 20 63 6f 72 72 75 70 74 69 6f 6e  cates corruption
03b0: 20 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44   .(mdb-define MD
03c0: 42 5f 50 41 47 45 5f 4e 4f 54 46 4f 55 4e 44 09  B_PAGE_NOTFOUND.
03d0: 2d 33 30 37 39 37 29 0a 09 3b 3b 20 4c 6f 63 61  -30797)..;; Loca
03e0: 74 65 64 20 70 61 67 65 20 77 61 73 20 77 72 6f  ted page was wro
03f0: 6e 67 20 74 79 70 65 20 0a 28 6d 64 62 2d 64 65  ng type .(mdb-de
0400: 66 69 6e 65 20 4d 44 42 5f 43 4f 52 52 55 50 54  fine MDB_CORRUPT
0410: 45 44 09 2d 33 30 37 39 36 29 0a 09 3b 3b 20 55  ED.-30796)..;; U
0420: 70 64 61 74 65 20 6f 66 20 6d 65 74 61 20 70 61  pdate of meta pa
0430: 67 65 20 66 61 69 6c 65 64 20 6f 72 20 65 6e 76  ge failed or env
0440: 69 72 6f 6e 6d 65 6e 74 20 68 61 64 20 66 61 74  ironment had fat
0450: 61 6c 20 65 72 72 6f 72 20 0a 28 6d 64 62 2d 64  al error .(mdb-d
0460: 65 66 69 6e 65 20 4d 44 42 5f 50 41 4e 49 43 09  efine MDB_PANIC.
0470: 09 2d 33 30 37 39 35 29 0a 09 3b 3b 20 45 6e 76  .-30795)..;; Env
0480: 69 72 6f 6e 6d 65 6e 74 20 76 65 72 73 69 6f 6e  ironment version
0490: 20 6d 69 73 6d 61 74 63 68 20 0a 28 6d 64 62 2d   mismatch .(mdb-
04a0: 64 65 66 69 6e 65 20 4d 44 42 5f 56 45 52 53 49  define MDB_VERSI
04b0: 4f 4e 5f 4d 49 53 4d 41 54 43 48 09 2d 33 30 37  ON_MISMATCH.-307
04c0: 39 34 29 0a 09 3b 3b 20 46 69 6c 65 20 69 73 20  94)..;; File is 
04d0: 6e 6f 74 20 61 20 76 61 6c 69 64 20 4c 4d 44 42  not a valid LMDB
04e0: 20 66 69 6c 65 20 0a 28 6d 64 62 2d 64 65 66 69   file .(mdb-defi
04f0: 6e 65 20 4d 44 42 5f 49 4e 56 41 4c 49 44 09 2d  ne MDB_INVALID.-
0500: 33 30 37 39 33 29 0a 09 3b 3b 20 45 6e 76 69 72  30793)..;; Envir
0510: 6f 6e 6d 65 6e 74 20 6d 61 70 73 69 7a 65 20 72  onment mapsize r
0520: 65 61 63 68 65 64 20 0a 28 6d 64 62 2d 64 65 66  eached .(mdb-def
0530: 69 6e 65 20 4d 44 42 5f 4d 41 50 5f 46 55 4c 4c  ine MDB_MAP_FULL
0540: 09 2d 33 30 37 39 32 29 0a 09 3b 3b 20 45 6e 76  .-30792)..;; Env
0550: 69 72 6f 6e 6d 65 6e 74 20 6d 61 78 64 62 73 20  ironment maxdbs 
0560: 72 65 61 63 68 65 64 20 0a 28 6d 64 62 2d 64 65  reached .(mdb-de
0570: 66 69 6e 65 20 4d 44 42 5f 44 42 53 5f 46 55 4c  fine MDB_DBS_FUL
0580: 4c 09 2d 33 30 37 39 31 29 0a 09 3b 3b 20 45 6e  L.-30791)..;; En
0590: 76 69 72 6f 6e 6d 65 6e 74 20 6d 61 78 72 65 61  vironment maxrea
05a0: 64 65 72 73 20 72 65 61 63 68 65 64 20 0a 28 6d  ders reached .(m
05b0: 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 52 45  db-define MDB_RE
05c0: 41 44 45 52 53 5f 46 55 4c 4c 09 2d 33 30 37 39  ADERS_FULL.-3079
05d0: 30 29 0a 09 3b 3b 20 54 6f 6f 20 6d 61 6e 79 20  0)..;; Too many 
05e0: 54 4c 53 20 6b 65 79 73 20 69 6e 20 75 73 65 20  TLS keys in use 
05f0: 2d 20 57 69 6e 64 6f 77 73 20 6f 6e 6c 79 20 0a  - Windows only .
0600: 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f  (mdb-define MDB_
0610: 54 4c 53 5f 46 55 4c 4c 09 2d 33 30 37 38 39 29  TLS_FULL.-30789)
0620: 0a 09 3b 3b 20 54 78 6e 20 68 61 73 20 74 6f 6f  ..;; Txn has too
0630: 20 6d 61 6e 79 20 64 69 72 74 79 20 70 61 67 65   many dirty page
0640: 73 20 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d  s .(mdb-define M
0650: 44 42 5f 54 58 4e 5f 46 55 4c 4c 09 2d 33 30 37  DB_TXN_FULL.-307
0660: 38 38 29 0a 09 3b 3b 20 43 75 72 73 6f 72 20 73  88)..;; Cursor s
0670: 74 61 63 6b 20 74 6f 6f 20 64 65 65 70 20 2d 20  tack too deep - 
0680: 69 6e 74 65 72 6e 61 6c 20 65 72 72 6f 72 20 0a  internal error .
0690: 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f  (mdb-define MDB_
06a0: 43 55 52 53 4f 52 5f 46 55 4c 4c 09 2d 33 30 37  CURSOR_FULL.-307
06b0: 38 37 29 0a 09 3b 3b 20 50 61 67 65 20 68 61 73  87)..;; Page has
06c0: 20 6e 6f 74 20 65 6e 6f 75 67 68 20 73 70 61 63   not enough spac
06d0: 65 20 2d 20 69 6e 74 65 72 6e 61 6c 20 65 72 72  e - internal err
06e0: 6f 72 20 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20  or .(mdb-define 
06f0: 4d 44 42 5f 50 41 47 45 5f 46 55 4c 4c 09 2d 33  MDB_PAGE_FULL.-3
0700: 30 37 38 36 29 0a 09 3b 3b 20 44 61 74 61 62 61  0786)..;; Databa
0710: 73 65 20 63 6f 6e 74 65 6e 74 73 20 67 72 65 77  se contents grew
0720: 20 62 65 79 6f 6e 64 20 65 6e 76 69 72 6f 6e 6d   beyond environm
0730: 65 6e 74 20 6d 61 70 73 69 7a 65 20 0a 28 6d 64  ent mapsize .(md
0740: 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 4d 41 50  b-define MDB_MAP
0750: 5f 52 45 53 49 5a 45 44 09 2d 33 30 37 38 35 29  _RESIZED.-30785)
0760: 0a 09 3b 3b 20 4f 70 65 72 61 74 69 6f 6e 20 61  ..;; Operation a
0770: 6e 64 20 44 42 20 69 6e 63 6f 6d 70 61 74 69 62  nd DB incompatib
0780: 6c 65 2c 20 6f 72 20 44 42 20 74 79 70 65 20 63  le, or DB type c
0790: 68 61 6e 67 65 64 2e 20 54 68 69 73 20 63 61 6e  hanged. This can
07a0: 20 6d 65 61 6e 3a 0a 09 3b 3b 20 2a 09 3c 75 6c   mean:..;; *.<ul
07b0: 3e 0a 09 3b 3b 20 2a 09 3c 6c 69 3e 54 68 65 20  >..;; *.<li>The 
07c0: 6f 70 65 72 61 74 69 6f 6e 20 65 78 70 65 63 74  operation expect
07d0: 73 20 61 6e 20 23 4d 44 42 5f 44 55 50 53 4f 52  s an #MDB_DUPSOR
07e0: 54 20 2f 20 23 4d 44 42 5f 44 55 50 46 49 58 45  T / #MDB_DUPFIXE
07f0: 44 20 64 61 74 61 62 61 73 65 2e 0a 09 3b 3b 20  D database...;; 
0800: 2a 09 3c 6c 69 3e 4f 70 65 6e 69 6e 67 20 61 20  *.<li>Opening a 
0810: 6e 61 6d 65 64 20 44 42 20 77 68 65 6e 20 74 68  named DB when th
0820: 65 20 75 6e 6e 61 6d 65 64 20 44 42 20 68 61 73  e unnamed DB has
0830: 20 23 4d 44 42 5f 44 55 50 53 4f 52 54 20 2f 20   #MDB_DUPSORT / 
0840: 23 4d 44 42 5f 49 4e 54 45 47 45 52 4b 45 59 2e  #MDB_INTEGERKEY.
0850: 0a 09 3b 3b 20 2a 09 3c 6c 69 3e 41 63 63 65 73  ..;; *.<li>Acces
0860: 73 69 6e 67 20 61 20 64 61 74 61 20 72 65 63 6f  sing a data reco
0870: 72 64 20 61 73 20 61 20 64 61 74 61 62 61 73 65  rd as a database
0880: 2c 20 6f 72 20 76 69 63 65 20 76 65 72 73 61 2e  , or vice versa.
0890: 0a 09 3b 3b 20 2a 09 3c 6c 69 3e 54 68 65 20 64  ..;; *.<li>The d
08a0: 61 74 61 62 61 73 65 20 77 61 73 20 64 72 6f 70  atabase was drop
08b0: 70 65 64 20 61 6e 64 20 72 65 63 72 65 61 74 65  ped and recreate
08c0: 64 20 77 69 74 68 20 64 69 66 66 65 72 65 6e 74  d with different
08d0: 20 66 6c 61 67 73 2e 0a 09 3b 3b 20 2a 09 3c 2f   flags...;; *.</
08e0: 75 6c 3e 0a 09 20 0a 28 6d 64 62 2d 64 65 66 69  ul>.. .(mdb-defi
08f0: 6e 65 20 4d 44 42 5f 49 4e 43 4f 4d 50 41 54 49  ne MDB_INCOMPATI
0900: 42 4c 45 09 2d 33 30 37 38 34 29 0a 09 3b 3b 20  BLE.-30784)..;; 
0910: 49 6e 76 61 6c 69 64 20 72 65 75 73 65 20 6f 66  Invalid reuse of
0920: 20 72 65 61 64 65 72 20 6c 6f 63 6b 74 61 62 6c   reader locktabl
0930: 65 20 73 6c 6f 74 20 0a 28 6d 64 62 2d 64 65 66  e slot .(mdb-def
0940: 69 6e 65 20 4d 44 42 5f 42 41 44 5f 52 53 4c 4f  ine MDB_BAD_RSLO
0950: 54 09 09 2d 33 30 37 38 33 29 0a 09 3b 3b 20 54  T..-30783)..;; T
0960: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20  ransaction must 
0970: 61 62 6f 72 74 2c 20 68 61 73 20 61 20 63 68 69  abort, has a chi
0980: 6c 64 2c 20 6f 72 20 69 73 20 69 6e 76 61 6c 69  ld, or is invali
0990: 64 20 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d  d .(mdb-define M
09a0: 44 42 5f 42 41 44 5f 54 58 4e 09 09 09 2d 33 30  DB_BAD_TXN...-30
09b0: 37 38 32 29 0a 09 3b 3b 20 55 6e 73 75 70 70 6f  782)..;; Unsuppo
09c0: 72 74 65 64 20 73 69 7a 65 20 6f 66 20 6b 65 79  rted size of key
09d0: 2f 44 42 20 6e 61 6d 65 2f 64 61 74 61 2c 20 6f  /DB name/data, o
09e0: 72 20 77 72 6f 6e 67 20 44 55 50 46 49 58 45 44  r wrong DUPFIXED
09f0: 20 73 69 7a 65 20 0a 28 6d 64 62 2d 64 65 66 69   size .(mdb-defi
0a00: 6e 65 20 4d 44 42 5f 42 41 44 5f 56 41 4c 53 49  ne MDB_BAD_VALSI
0a10: 5a 45 09 09 2d 33 30 37 38 31 29 0a 09 3b 3b 20  ZE..-30781)..;; 
0a20: 54 68 65 20 73 70 65 63 69 66 69 65 64 20 44 42  The specified DB
0a30: 49 20 77 61 73 20 63 68 61 6e 67 65 64 20 75 6e  I was changed un
0a40: 65 78 70 65 63 74 65 64 6c 79 20 0a 28 6d 64 62  expectedly .(mdb
0a50: 2d 64 65 66 69 6e 65 20 4d 44 42 5f 42 41 44 5f  -define MDB_BAD_
0a60: 44 42 49 09 09 2d 33 30 37 38 30 29 0a 09 3b 3b  DBI..-30780)..;;
0a70: 20 55 6e 65 78 70 65 63 74 65 64 20 70 72 6f 62   Unexpected prob
0a80: 6c 65 6d 20 2d 20 74 78 6e 20 73 68 6f 75 6c 64  lem - txn should
0a90: 20 61 62 6f 72 74 20 0a 28 6d 64 62 2d 64 65 66   abort .(mdb-def
0aa0: 69 6e 65 20 4d 44 42 5f 50 52 4f 42 4c 45 4d 09  ine MDB_PROBLEM.
0ab0: 09 2d 33 30 37 37 39 29 0a 09 3b 3b 20 54 68 65  .-30779)..;; The
0ac0: 20 6c 61 73 74 20 64 65 66 69 6e 65 64 20 65 72   last defined er
0ad0: 72 6f 72 20 63 6f 64 65 20 0a 28 6d 64 62 2d 64  ror code .(mdb-d
0ae0: 65 66 69 6e 65 20 4d 44 42 5f 4c 41 53 54 5f 45  efine MDB_LAST_E
0af0: 52 52 43 4f 44 45 09 4d 44 42 5f 50 52 4f 42 4c  RRCODE.MDB_PROBL
0b00: 45 4d 29 0a 0a 0a 0a 0a 09 3b 3b 20 6d 6d 61 70  EM)......;; mmap
0b10: 20 61 74 20 61 20 66 69 78 65 64 20 61 64 64 72   at a fixed addr
0b20: 65 73 73 20 28 65 78 70 65 72 69 6d 65 6e 74 61  ess (experimenta
0b30: 6c 29 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e  l) */.(mdb-defin
0b40: 65 20 20 4d 44 42 5f 46 49 58 45 44 4d 41 50 09  e  MDB_FIXEDMAP.
0b50: 23 78 30 31 29 0a 09 3b 3b 20 6e 6f 20 65 6e 76  #x01)..;; no env
0b60: 69 72 6f 6e 6d 65 6e 74 20 64 69 72 65 63 74 6f  ironment directo
0b70: 72 79 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e  ry */.(mdb-defin
0b80: 65 20 20 4d 44 42 5f 4e 4f 53 55 42 44 49 52 09  e  MDB_NOSUBDIR.
0b90: 23 78 34 30 30 30 29 0a 09 3b 3b 20 64 6f 6e 27  #x4000)..;; don'
0ba0: 74 20 66 73 79 6e 63 20 61 66 74 65 72 20 63 6f  t fsync after co
0bb0: 6d 6d 69 74 20 2a 2f 0a 28 6d 64 62 2d 64 65 66  mmit */.(mdb-def
0bc0: 69 6e 65 20 20 4d 44 42 5f 4e 4f 53 59 4e 43 09  ine  MDB_NOSYNC.
0bd0: 09 23 78 31 30 30 30 30 29 0a 09 3b 3b 20 72 65  .#x10000)..;; re
0be0: 61 64 20 6f 6e 6c 79 20 2a 2f 0a 28 6d 64 62 2d  ad only */.(mdb-
0bf0: 64 65 66 69 6e 65 20 20 4d 44 42 5f 52 44 4f 4e  define  MDB_RDON
0c00: 4c 59 09 09 23 78 32 30 30 30 30 29 0a 09 3b 3b  LY..#x20000)..;;
0c10: 20 64 6f 6e 27 74 20 66 73 79 6e 63 20 6d 65 74   don't fsync met
0c20: 61 70 61 67 65 20 61 66 74 65 72 20 63 6f 6d 6d  apage after comm
0c30: 69 74 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e  it */.(mdb-defin
0c40: 65 20 20 4d 44 42 5f 4e 4f 4d 45 54 41 53 59 4e  e  MDB_NOMETASYN
0c50: 43 09 09 23 78 34 30 30 30 30 29 0a 09 3b 3b 20  C..#x40000)..;; 
0c60: 75 73 65 20 77 72 69 74 61 62 6c 65 20 6d 6d 61  use writable mma
0c70: 70 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65  p */.(mdb-define
0c80: 20 20 4d 44 42 5f 57 52 49 54 45 4d 41 50 09 09    MDB_WRITEMAP..
0c90: 23 78 38 30 30 30 30 29 0a 09 3b 3b 20 75 73 65  #x80000)..;; use
0ca0: 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 6d 73   asynchronous ms
0cb0: 79 6e 63 20 77 68 65 6e 20 23 4d 44 42 5f 57 52  ync when #MDB_WR
0cc0: 49 54 45 4d 41 50 20 69 73 20 75 73 65 64 20 2a  ITEMAP is used *
0cd0: 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 20 4d  /.(mdb-define  M
0ce0: 44 42 5f 4d 41 50 41 53 59 4e 43 09 09 23 78 31  DB_MAPASYNC..#x1
0cf0: 30 30 30 30 30 29 0a 09 3b 3b 20 74 69 65 20 72  00000)..;; tie r
0d00: 65 61 64 65 72 20 6c 6f 63 6b 74 61 62 6c 65 20  eader locktable 
0d10: 73 6c 6f 74 73 20 74 6f 20 23 4d 44 42 5f 74 78  slots to #MDB_tx
0d20: 6e 20 6f 62 6a 65 63 74 73 20 69 6e 73 74 65 61  n objects instea
0d30: 64 20 6f 66 20 74 6f 20 74 68 72 65 61 64 73 20  d of to threads 
0d40: 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 20  */.(mdb-define  
0d50: 4d 44 42 5f 4e 4f 54 4c 53 09 09 23 78 32 30 30  MDB_NOTLS..#x200
0d60: 30 30 30 29 0a 09 3b 3b 20 64 6f 6e 27 74 20 64  000)..;; don't d
0d70: 6f 20 61 6e 79 20 6c 6f 63 6b 69 6e 67 2c 20 63  o any locking, c
0d80: 61 6c 6c 65 72 20 6d 75 73 74 20 6d 61 6e 61 67  aller must manag
0d90: 65 20 74 68 65 69 72 20 6f 77 6e 20 6c 6f 63 6b  e their own lock
0da0: 73 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65  s */.(mdb-define
0db0: 20 20 4d 44 42 5f 4e 4f 4c 4f 43 4b 09 09 23 78    MDB_NOLOCK..#x
0dc0: 34 30 30 30 30 30 29 0a 09 3b 3b 20 64 6f 6e 27  400000)..;; don'
0dd0: 74 20 64 6f 20 72 65 61 64 61 68 65 61 64 20 28  t do readahead (
0de0: 6e 6f 20 65 66 66 65 63 74 20 6f 6e 20 57 69 6e  no effect on Win
0df0: 64 6f 77 73 29 20 2a 2f 0a 28 6d 64 62 2d 64 65  dows) */.(mdb-de
0e00: 66 69 6e 65 20 20 4d 44 42 5f 4e 4f 52 44 41 48  fine  MDB_NORDAH
0e10: 45 41 44 09 23 78 38 30 30 30 30 30 29 0a 09 3b  EAD.#x800000)..;
0e20: 3b 20 64 6f 6e 27 74 20 69 6e 69 74 69 61 6c 69  ; don't initiali
0e30: 7a 65 20 6d 61 6c 6c 6f 63 27 64 20 6d 65 6d 6f  ze malloc'd memo
0e40: 72 79 20 62 65 66 6f 72 65 20 77 72 69 74 69 6e  ry before writin
0e50: 67 20 74 6f 20 64 61 74 61 66 69 6c 65 20 2a 2f  g to datafile */
0e60: 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 20 4d 44  .(mdb-define  MD
0e70: 42 5f 4e 4f 4d 45 4d 49 4e 49 54 09 23 78 31 30  B_NOMEMINIT.#x10
0e80: 30 30 30 30 30 29 0a 3b 3b 20 40 7d 20 2a 2f 0a  00000).;; @} */.
0e90: 0a 3b 3b 09 40 64 65 66 67 72 6f 75 70 09 6d 64  .;;.@defgroup.md
0ea0: 62 5f 64 62 69 5f 6f 70 65 6e 09 44 61 74 61 62  b_dbi_open.Datab
0eb0: 61 73 65 20 46 6c 61 67 73 0a 3b 3b 20 2a 09 40  ase Flags.;; *.@
0ec0: 7b 0a 3b 3b 20 2a 2f 0a 09 3b 3b 20 75 73 65 20  {.;; */..;; use 
0ed0: 72 65 76 65 72 73 65 20 73 74 72 69 6e 67 20 6b  reverse string k
0ee0: 65 79 73 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69  eys */.(mdb-defi
0ef0: 6e 65 20 20 4d 44 42 5f 52 45 56 45 52 53 45 4b  ne  MDB_REVERSEK
0f00: 45 59 09 23 78 30 32 29 0a 09 3b 3b 20 75 73 65  EY.#x02)..;; use
0f10: 20 73 6f 72 74 65 64 20 64 75 70 6c 69 63 61 74   sorted duplicat
0f20: 65 73 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e  es */.(mdb-defin
0f30: 65 20 20 4d 44 42 5f 44 55 50 53 4f 52 54 09 09  e  MDB_DUPSORT..
0f40: 23 78 30 34 29 0a 09 3b 3b 20 6e 75 6d 65 72 69  #x04)..;; numeri
0f50: 63 20 6b 65 79 73 20 69 6e 20 6e 61 74 69 76 65  c keys in native
0f60: 20 62 79 74 65 20 6f 72 64 65 72 2c 20 65 69 74   byte order, eit
0f70: 68 65 72 20 75 6e 73 69 67 6e 65 64 20 69 6e 74  her unsigned int
0f80: 20 6f 72 20 23 6d 64 62 5f 73 69 7a 65 5f 74 2e   or #mdb_size_t.
0f90: 0a 09 20 3b 3b 2a 09 28 6c 6d 64 62 20 65 78 70  .. ;;*.(lmdb exp
0fa0: 65 63 74 73 20 33 32 2d 62 69 74 20 69 6e 74 20  ects 32-bit int 
0fb0: 3c 3d 20 73 69 7a 65 5f 74 20 3c 3d 20 33 32 2f  <= size_t <= 32/
0fc0: 36 34 2d 62 69 74 20 6d 64 62 5f 73 69 7a 65 5f  64-bit mdb_size_
0fd0: 74 2e 29 0a 09 3b 3b 20 2a 20 20 54 68 65 20 6b  t.)..;; *  The k
0fe0: 65 79 73 20 6d 75 73 74 20 61 6c 6c 20 62 65 20  eys must all be 
0ff0: 6f 66 20 74 68 65 20 73 61 6d 65 20 73 69 7a 65  of the same size
1000: 2e 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65  . */.(mdb-define
1010: 20 20 4d 44 42 5f 49 4e 54 45 47 45 52 4b 45 59    MDB_INTEGERKEY
1020: 09 23 78 30 38 29 0a 09 3b 3b 20 77 69 74 68 20  .#x08)..;; with 
1030: 23 4d 44 42 5f 44 55 50 53 4f 52 54 2c 20 73 6f  #MDB_DUPSORT, so
1040: 72 74 65 64 20 64 75 70 20 69 74 65 6d 73 20 68  rted dup items h
1050: 61 76 65 20 66 69 78 65 64 20 73 69 7a 65 20 2a  ave fixed size *
1060: 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 20 4d  /.(mdb-define  M
1070: 44 42 5f 44 55 50 46 49 58 45 44 09 23 78 31 30  DB_DUPFIXED.#x10
1080: 29 0a 09 3b 3b 20 77 69 74 68 20 23 4d 44 42 5f  )..;; with #MDB_
1090: 44 55 50 53 4f 52 54 2c 20 64 75 70 73 20 61 72  DUPSORT, dups ar
10a0: 65 20 23 4d 44 42 5f 49 4e 54 45 47 45 52 4b 45  e #MDB_INTEGERKE
10b0: 59 2d 73 74 79 6c 65 20 69 6e 74 65 67 65 72 73  Y-style integers
10c0: 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20   */.(mdb-define 
10d0: 20 4d 44 42 5f 49 4e 54 45 47 45 52 44 55 50 09   MDB_INTEGERDUP.
10e0: 23 78 32 30 29 0a 09 3b 3b 20 77 69 74 68 20 23  #x20)..;; with #
10f0: 4d 44 42 5f 44 55 50 53 4f 52 54 2c 20 75 73 65  MDB_DUPSORT, use
1100: 20 72 65 76 65 72 73 65 20 73 74 72 69 6e 67 20   reverse string 
1110: 64 75 70 73 20 2a 2f 0a 28 6d 64 62 2d 64 65 66  dups */.(mdb-def
1120: 69 6e 65 20 20 4d 44 42 5f 52 45 56 45 52 53 45  ine  MDB_REVERSE
1130: 44 55 50 09 23 78 34 30 29 0a 09 3b 3b 20 63 72  DUP.#x40)..;; cr
1140: 65 61 74 65 20 44 42 20 69 66 20 6e 6f 74 20 61  eate DB if not a
1150: 6c 72 65 61 64 79 20 65 78 69 73 74 69 6e 67 20  lready existing 
1160: 2a 2f 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 20  */.(mdb-define  
1170: 4d 44 42 5f 43 52 45 41 54 45 09 09 23 78 34 30  MDB_CREATE..#x40
1180: 30 30 30 29 0a 0a 0a 3b 3b 09 40 64 65 66 67 72  000)...;;.@defgr
1190: 6f 75 70 20 6d 64 62 5f 70 75 74 09 57 72 69 74  oup mdb_put.Writ
11a0: 65 20 46 6c 61 67 73 0a 3b 3b 20 2a 09 40 7b 0a  e Flags.;; *.@{.
11b0: 3b 3b 20 2a 2f 0a 3b 3b 20 46 6f 72 20 70 75 74  ;; */.;; For put
11c0: 3a 20 44 6f 6e 27 74 20 77 72 69 74 65 20 69 66  : Don't write if
11d0: 20 74 68 65 20 6b 65 79 20 61 6c 72 65 61 64 79   the key already
11e0: 20 65 78 69 73 74 73 2e 20 2a 2f 0a 28 6d 64 62   exists. */.(mdb
11f0: 2d 64 65 66 69 6e 65 20 4d 44 42 5f 4e 4f 4f 56  -define MDB_NOOV
1200: 45 52 57 52 49 54 45 09 23 78 31 30 29 0a 3b 3b  ERWRITE.#x10).;;
1210: 20 4f 6e 6c 79 20 66 6f 72 20 23 4d 44 42 5f 44   Only for #MDB_D
1220: 55 50 53 4f 52 54 3c 62 72 3e 0a 3b 3b 20 2a 20  UPSORT<br>.;; * 
1230: 46 6f 72 20 70 75 74 3a 20 64 6f 6e 27 74 20 77  For put: don't w
1240: 72 69 74 65 20 69 66 20 74 68 65 20 6b 65 79 20  rite if the key 
1250: 61 6e 64 20 64 61 74 61 20 70 61 69 72 20 61 6c  and data pair al
1260: 72 65 61 64 79 20 65 78 69 73 74 2e 3c 62 72 3e  ready exist.<br>
1270: 0a 3b 3b 20 2a 20 46 6f 72 20 6d 64 62 5f 63 75  .;; * For mdb_cu
1280: 72 73 6f 72 5f 64 65 6c 3a 20 72 65 6d 6f 76 65  rsor_del: remove
1290: 20 61 6c 6c 20 64 75 70 6c 69 63 61 74 65 20 64   all duplicate d
12a0: 61 74 61 20 69 74 65 6d 73 2e 0a 3b 3b 20 2a 2f  ata items..;; */
12b0: 0a 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42  .(mdb-define MDB
12c0: 5f 4e 4f 44 55 50 44 41 54 41 09 23 78 32 30 29  _NODUPDATA.#x20)
12d0: 0a 3b 3b 20 46 6f 72 20 6d 64 62 5f 63 75 72 73  .;; For mdb_curs
12e0: 6f 72 5f 70 75 74 3a 20 6f 76 65 72 77 72 69 74  or_put: overwrit
12f0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 6b 65  e the current ke
1300: 79 2f 64 61 74 61 20 70 61 69 72 20 2a 2f 0a 28  y/data pair */.(
1310: 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 43  mdb-define MDB_C
1320: 55 52 52 45 4e 54 09 23 78 34 30 29 0a 3b 3b 20  URRENT.#x40).;; 
1330: 46 6f 72 20 70 75 74 3a 20 4a 75 73 74 20 72 65  For put: Just re
1340: 73 65 72 76 65 20 73 70 61 63 65 20 66 6f 72 20  serve space for 
1350: 64 61 74 61 2c 20 64 6f 6e 27 74 20 63 6f 70 79  data, don't copy
1360: 20 69 74 2e 20 52 65 74 75 72 6e 20 61 0a 3b 3b   it. Return a.;;
1370: 20 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68   * pointer to th
1380: 65 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65  e reserved space
1390: 2e 0a 3b 3b 20 2a 2f 0a 28 6d 64 62 2d 64 65 66  ..;; */.(mdb-def
13a0: 69 6e 65 20 4d 44 42 5f 52 45 53 45 52 56 45 09  ine MDB_RESERVE.
13b0: 23 78 31 30 30 30 30 29 0a 3b 3b 20 44 61 74 61  #x10000).;; Data
13c0: 20 69 73 20 62 65 69 6e 67 20 61 70 70 65 6e 64   is being append
13d0: 65 64 2c 20 64 6f 6e 27 74 20 73 70 6c 69 74 20  ed, don't split 
13e0: 66 75 6c 6c 20 70 61 67 65 73 2e 20 2a 2f 0a 28  full pages. */.(
13f0: 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 41  mdb-define MDB_A
1400: 50 50 45 4e 44 09 23 78 32 30 30 30 30 29 0a 3b  PPEND.#x20000).;
1410: 3b 20 44 75 70 6c 69 63 61 74 65 20 64 61 74 61  ; Duplicate data
1420: 20 69 73 20 62 65 69 6e 67 20 61 70 70 65 6e 64   is being append
1430: 65 64 2c 20 64 6f 6e 27 74 20 73 70 6c 69 74 20  ed, don't split 
1440: 66 75 6c 6c 20 70 61 67 65 73 2e 20 2a 2f 0a 28  full pages. */.(
1450: 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 41  mdb-define MDB_A
1460: 50 50 45 4e 44 44 55 50 09 23 78 34 30 30 30 30  PPENDDUP.#x40000
1470: 29 0a 3b 3b 20 53 74 6f 72 65 20 6d 75 6c 74 69  ).;; Store multi
1480: 70 6c 65 20 64 61 74 61 20 69 74 65 6d 73 20 69  ple data items i
1490: 6e 20 6f 6e 65 20 63 61 6c 6c 2e 20 4f 6e 6c 79  n one call. Only
14a0: 20 66 6f 72 20 23 4d 44 42 5f 44 55 50 46 49 58   for #MDB_DUPFIX
14b0: 45 44 2e 20 2a 2f 0a 28 6d 64 62 2d 64 65 66 69  ED. */.(mdb-defi
14c0: 6e 65 20 4d 44 42 5f 4d 55 4c 54 49 50 4c 45 09  ne MDB_MULTIPLE.
14d0: 23 78 38 30 30 30 30 29 0a 3b 3b 2f 2a 09 40 7d  #x80000).;;/*.@}
14e0: 20 2a 2f 0a 0a 28 6d 64 62 2d 64 65 66 69 6e 65   */..(mdb-define
14f0: 20 4d 44 42 5f 56 45 52 53 49 4f 4e 5f 4d 41 4a   MDB_VERSION_MAJ
1500: 4f 52 20 30 29 0a 28 6d 64 62 2d 64 65 66 69 6e  OR 0).(mdb-defin
1510: 65 20 4d 44 42 5f 56 45 52 53 49 4f 4e 5f 4d 49  e MDB_VERSION_MI
1520: 4e 4f 52 20 39 29 0a 28 6d 64 62 2d 64 65 66 69  NOR 9).(mdb-defi
1530: 6e 65 20 4d 44 42 5f 56 45 52 53 49 4f 4e 5f 50  ne MDB_VERSION_P
1540: 41 54 43 48 20 37 30 29 0a 0a 3b 3b 09 40 64 65  ATCH 70)..;;.@de
1550: 66 67 72 6f 75 70 20 6d 64 62 5f 63 6f 70 79 09  fgroup mdb_copy.
1560: 43 6f 70 79 20 46 6c 61 67 73 0a 3b 3b 20 2a 09  Copy Flags.;; *.
1570: 40 7b 0a 3b 3b 20 2a 2f 0a 3b 3b 20 43 6f 6d 70  @{.;; */.;; Comp
1580: 61 63 74 69 6e 67 20 63 6f 70 79 3a 20 4f 6d 69  acting copy: Omi
1590: 74 20 66 72 65 65 20 73 70 61 63 65 20 66 72 6f  t free space fro
15a0: 6d 20 63 6f 70 79 2c 20 61 6e 64 20 72 65 6e 75  m copy, and renu
15b0: 6d 62 65 72 20 61 6c 6c 0a 3b 3b 20 2a 20 70 61  mber all.;; * pa
15c0: 67 65 73 20 73 65 71 75 65 6e 74 69 61 6c 6c 79  ges sequentially
15d0: 2e 0a 3b 3b 20 2a 2f 0a 28 6d 64 62 2d 64 65 66  ..;; */.(mdb-def
15e0: 69 6e 65 20 4d 44 42 5f 43 50 5f 43 4f 4d 50 41  ine MDB_CP_COMPA
15f0: 43 54 09 23 78 30 31 29 0a 3b 3b 2f 2a 09 40 7d  CT.#x01).;;/*.@}
1600: 20 2a 2f 0a 0a 3b 3b 20 46 49 58 4d 45 20 23 69   */..;; FIXME #i
1610: 66 64 65 66 20 5f 57 49 4e 33 32 0a 20 3b 28 6d  fdef _WIN32. ;(m
1620: 64 62 2d 64 65 66 69 6e 65 20 4d 44 42 5f 46 4d  db-define MDB_FM
1630: 54 5f 5a 20 22 49 22 29 0a 20 3b 23 65 6c 73 65  T_Z "I"). ;#else
1640: 0a 20 28 6d 64 62 2d 64 65 66 69 6e 65 20 4d 44  . (mdb-define MD
1650: 42 5f 46 4d 54 5f 5a 20 22 5a 22 29 0a 20 3b 23  B_FMT_Z "Z"). ;#
1660: 65 6e 64 69 66 0a 0a 0a                          endif...
Fossil 2.9 [0fd79a3e09] 2019-07-13 13:05:19