/ Hex Artifact Content
Login

Artifact 12cd9a55b9188c21ae2dd466436e1f2b78b71fa2:


0000: 2f 2a 0a 2a 2a 20 32 30 30 39 20 4a 61 6e 75 61  /*.** 2009 Janua
0010: 72 79 20 32 38 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ry 28.**.** The 
0020: 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d 73  author disclaims
0030: 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 68   copyright to th
0040: 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20  is source code. 
0050: 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20   In place of.** 
0060: 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20  a legal notice, 
0070: 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 69  here is a blessi
0080: 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79  ng:.**.**    May
0090: 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64   you do good and
00a0: 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20   not evil..**   
00b0: 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 6f   May you find fo
00c0: 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 6f  rgiveness for yo
00d0: 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 69  urself and forgi
00e0: 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20  ve others..**   
00f0: 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 66   May you share f
0100: 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b  reely, never tak
0110: 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f  ing more than yo
0120: 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a  u give..**.*****
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c  ****.** This fil
0180: 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 69  e contains the i
0190: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
01a0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 62 61 63   the sqlite3_bac
01b0: 6b 75 70 5f 58 58 58 28 29 20 0a 2a 2a 20 41 50  kup_XXX() .** AP
01c0: 49 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20  I functions and 
01d0: 74 68 65 20 72 65 6c 61 74 65 64 20 66 65 61 74  the related feat
01e0: 75 72 65 73 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a  ures..**.** $Id:
01f0: 20 62 61 63 6b 75 70 2e 63 2c 76 20 31 2e 37 20   backup.c,v 1.7 
0200: 32 30 30 39 2f 30 32 2f 30 34 20 31 37 3a 34 30  2009/02/04 17:40
0210: 3a 35 38 20 64 72 68 20 45 78 70 20 24 0a 2a 2f  :58 drh Exp $.*/
0220: 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74  .#include "sqlit
0230: 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65  eInt.h".#include
0240: 20 22 62 74 72 65 65 49 6e 74 2e 68 22 0a 0a 2f   "btreeInt.h"../
0250: 2a 20 4d 61 63 72 6f 20 74 6f 20 66 69 6e 64 20  * Macro to find 
0260: 74 68 65 20 6d 69 6e 69 6d 75 6d 20 6f 66 20 74  the minimum of t
0270: 77 6f 20 6e 75 6d 65 72 69 63 20 76 61 6c 75 65  wo numeric value
0280: 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4d 49  s..*/.#ifndef MI
0290: 4e 0a 23 20 64 65 66 69 6e 65 20 4d 49 4e 28 78  N.# define MIN(x
02a0: 2c 79 29 20 28 28 78 29 3c 28 79 29 3f 28 78 29  ,y) ((x)<(y)?(x)
02b0: 3a 28 79 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a  :(y)).#endif../*
02c0: 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 20 61 6c  .** Structure al
02d0: 6c 6f 63 61 74 65 64 20 66 6f 72 20 65 61 63 68  located for each
02e0: 20 62 61 63 6b 75 70 20 6f 70 65 72 61 74 69 6f   backup operatio
02f0: 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 71 6c  n..*/.struct sql
0300: 69 74 65 33 5f 62 61 63 6b 75 70 20 7b 0a 20 20  ite3_backup {.  
0310: 73 71 6c 69 74 65 33 2a 20 70 44 65 73 74 44 62  sqlite3* pDestDb
0320: 3b 20 20 20 20 20 20 20 20 2f 2a 20 44 65 73 74  ;        /* Dest
0330: 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65  ination database
0340: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72   handle */.  Btr
0350: 65 65 20 2a 70 44 65 73 74 3b 20 20 20 20 20 20  ee *pDest;      
0360: 20 20 20 20 20 20 2f 2a 20 44 65 73 74 69 6e 61        /* Destina
0370: 74 69 6f 6e 20 62 2d 74 72 65 65 20 66 69 6c 65  tion b-tree file
0380: 20 2a 2f 0a 20 20 75 33 32 20 69 44 65 73 74 53   */.  u32 iDestS
0390: 63 68 65 6d 61 3b 20 20 20 20 20 20 20 20 20 2f  chema;         /
03a0: 2a 20 4f 72 69 67 69 6e 61 6c 20 73 63 68 65 6d  * Original schem
03b0: 61 20 63 6f 6f 6b 69 65 20 69 6e 20 64 65 73 74  a cookie in dest
03c0: 69 6e 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74  ination */.  int
03d0: 20 62 44 65 73 74 4c 6f 63 6b 65 64 3b 20 20 20   bDestLocked;   
03e0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 6f 6e        /* True on
03f0: 63 65 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73  ce a write-trans
0400: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 6f  action is open o
0410: 6e 20 70 44 65 73 74 20 2a 2f 0a 0a 20 20 50 67  n pDest */..  Pg
0420: 6e 6f 20 69 4e 65 78 74 3b 20 20 20 20 20 20 20  no iNext;       
0430: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 6e         /* Page n
0440: 75 6d 62 65 72 20 6f 66 20 74 68 65 20 6e 65 78  umber of the nex
0450: 74 20 73 6f 75 72 63 65 20 70 61 67 65 20 74 6f  t source page to
0460: 20 63 6f 70 79 20 2a 2f 0a 20 20 73 71 6c 69 74   copy */.  sqlit
0470: 65 33 2a 20 70 53 72 63 44 62 3b 20 20 20 20 20  e3* pSrcDb;     
0480: 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 64 61      /* Source da
0490: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f  tabase handle */
04a0: 0a 20 20 42 74 72 65 65 20 2a 70 53 72 63 3b 20  .  Btree *pSrc; 
04b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
04c0: 6f 75 72 63 65 20 62 2d 74 72 65 65 20 66 69 6c  ource b-tree fil
04d0: 65 20 2a 2f 0a 0a 20 20 69 6e 74 20 72 63 3b 20  e */..  int rc; 
04e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
04f0: 20 2f 2a 20 42 61 63 6b 75 70 20 70 72 6f 63 65   /* Backup proce
0500: 73 73 20 65 72 72 6f 72 20 63 6f 64 65 20 2a 2f  ss error code */
0510: 0a 0a 20 20 2f 2a 20 54 68 65 73 65 20 74 77 6f  ..  /* These two
0520: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 73   variables are s
0530: 65 74 20 62 79 20 65 76 65 72 79 20 63 61 6c 6c  et by every call
0540: 20 74 6f 20 62 61 63 6b 75 70 5f 73 74 65 70 28   to backup_step(
0550: 29 2e 20 54 68 65 79 20 61 72 65 0a 20 20 2a 2a  ). They are.  **
0560: 20 72 65 61 64 20 62 79 20 63 61 6c 6c 73 20 74   read by calls t
0570: 6f 20 62 61 63 6b 75 70 5f 72 65 6d 61 69 6e 69  o backup_remaini
0580: 6e 67 28 29 20 61 6e 64 20 62 61 63 6b 75 70 5f  ng() and backup_
0590: 70 61 67 65 63 6f 75 6e 74 28 29 2e 0a 20 20 2a  pagecount()..  *
05a0: 2f 0a 20 20 50 67 6e 6f 20 6e 52 65 6d 61 69 6e  /.  Pgno nRemain
05b0: 69 6e 67 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  ing;         /* 
05c0: 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  Number of pages 
05d0: 6c 65 66 74 20 74 6f 20 63 6f 70 79 20 2a 2f 0a  left to copy */.
05e0: 20 20 50 67 6e 6f 20 6e 50 61 67 65 63 6f 75 6e    Pgno nPagecoun
05f0: 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f  t;         /* To
0600: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  tal number of pa
0610: 67 65 73 20 74 6f 20 63 6f 70 79 20 2a 2f 0a 0a  ges to copy */..
0620: 20 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70    sqlite3_backup
0630: 20 2a 70 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65   *pNext;   /* Ne
0640: 78 74 20 62 61 63 6b 75 70 20 61 73 73 6f 63 69  xt backup associ
0650: 61 74 65 64 20 77 69 74 68 20 73 6f 75 72 63 65  ated with source
0660: 20 70 61 67 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a   pager */.};../*
0670: 0a 2a 2a 20 54 48 52 45 41 44 20 53 41 46 45 54  .** THREAD SAFET
0680: 59 20 4e 4f 54 45 53 3a 0a 2a 2a 0a 2a 2a 20 20  Y NOTES:.**.**  
0690: 20 4f 6e 63 65 20 69 74 20 68 61 73 20 62 65 65   Once it has bee
06a0: 6e 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20  n created using 
06b0: 62 61 63 6b 75 70 5f 69 6e 69 74 28 29 2c 20 61  backup_init(), a
06c0: 20 73 69 6e 67 6c 65 20 73 71 6c 69 74 65 33 5f   single sqlite3_
06d0: 62 61 63 6b 75 70 0a 2a 2a 20 20 20 73 74 72 75  backup.**   stru
06e0: 63 74 75 72 65 20 6d 61 79 20 62 65 20 61 63 63  cture may be acc
06f0: 65 73 73 65 64 20 76 69 61 20 74 77 6f 20 67 72  essed via two gr
0700: 6f 75 70 73 20 6f 66 20 74 68 72 65 61 64 2d 73  oups of thread-s
0710: 61 66 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 73  afe entry points
0720: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 20 56 69  :.**.**     * Vi
0730: 61 20 74 68 65 20 73 71 6c 69 74 65 33 5f 62 61  a the sqlite3_ba
0740: 63 6b 75 70 5f 58 58 58 28 29 20 41 50 49 20 66  ckup_XXX() API f
0750: 75 6e 63 74 69 6f 6e 20 62 61 63 6b 75 70 5f 73  unction backup_s
0760: 74 65 70 28 29 20 61 6e 64 20 0a 2a 2a 20 20 20  tep() and .**   
0770: 20 20 20 20 62 61 63 6b 75 70 5f 66 69 6e 69 73      backup_finis
0780: 68 28 29 2e 20 42 6f 74 68 20 74 68 65 73 65 20  h(). Both these 
0790: 66 75 6e 63 74 69 6f 6e 73 20 6f 62 74 61 69 6e  functions obtain
07a0: 20 74 68 65 20 73 6f 75 72 63 65 20 64 61 74 61   the source data
07b0: 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 20 68 61  base.**       ha
07c0: 6e 64 6c 65 20 6d 75 74 65 78 20 61 6e 64 20 74  ndle mutex and t
07d0: 68 65 20 6d 75 74 65 78 20 61 73 73 6f 63 69 61  he mutex associa
07e0: 74 65 64 20 77 69 74 68 20 74 68 65 20 73 6f 75  ted with the sou
07f0: 72 63 65 20 42 74 53 68 61 72 65 64 20 0a 2a 2a  rce BtShared .**
0800: 20 20 20 20 20 20 20 73 74 72 75 63 74 75 72 65         structure
0810: 2c 20 69 6e 20 74 68 61 74 20 6f 72 64 65 72 2e  , in that order.
0820: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 20 56 69 61  .**.**     * Via
0830: 20 74 68 65 20 42 61 63 6b 75 70 55 70 64 61 74   the BackupUpdat
0840: 65 28 29 20 61 6e 64 20 42 61 63 6b 75 70 52 65  e() and BackupRe
0850: 73 74 61 72 74 28 29 20 66 75 6e 63 74 69 6f 6e  start() function
0860: 73 2c 20 77 68 69 63 68 20 61 72 65 0a 2a 2a 20  s, which are.** 
0870: 20 20 20 20 20 20 69 6e 76 6f 6b 65 64 20 62 79        invoked by
0880: 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72   the pager layer
0890: 20 74 6f 20 72 65 70 6f 72 74 20 76 61 72 69 6f   to report vario
08a0: 75 73 20 73 74 61 74 65 20 63 68 61 6e 67 65 73  us state changes
08b0: 20 69 6e 0a 2a 2a 20 20 20 20 20 20 20 74 68 65   in.**       the
08c0: 20 70 61 67 65 20 63 61 63 68 65 20 61 73 73 6f   page cache asso
08d0: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20  ciated with the 
08e0: 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 2e  source database.
08f0: 20 54 68 65 20 6d 75 74 65 78 0a 2a 2a 20 20 20   The mutex.**   
0900: 20 20 20 20 61 73 73 6f 63 69 61 74 65 64 20 77      associated w
0910: 69 74 68 20 74 68 65 20 73 6f 75 72 63 65 20 64  ith the source d
0920: 61 74 61 62 61 73 65 20 42 74 53 68 61 72 65 64  atabase BtShared
0930: 20 73 74 72 75 63 74 75 72 65 20 77 69 6c 6c 20   structure will 
0940: 61 6c 77 61 79 73 20 0a 2a 2a 20 20 20 20 20 20  always .**      
0950: 20 62 65 20 68 65 6c 64 20 77 68 65 6e 20 65 69   be held when ei
0960: 74 68 65 72 20 6f 66 20 74 68 65 73 65 20 66 75  ther of these fu
0970: 6e 63 74 69 6f 6e 73 20 61 72 65 20 69 6e 76 6f  nctions are invo
0980: 6b 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65  ked..**.**   The
0990: 20 6f 74 68 65 72 20 73 71 6c 69 74 65 33 5f 62   other sqlite3_b
09a0: 61 63 6b 75 70 5f 58 58 58 28 29 20 41 50 49 20  ackup_XXX() API 
09b0: 66 75 6e 63 74 69 6f 6e 73 2c 20 62 61 63 6b 75  functions, backu
09c0: 70 5f 72 65 6d 61 69 6e 69 6e 67 28 29 20 61 6e  p_remaining() an
09d0: 64 0a 2a 2a 20 20 20 62 61 63 6b 75 70 5f 70 61  d.**   backup_pa
09e0: 67 65 63 6f 75 6e 74 28 29 20 61 72 65 20 6e 6f  gecount() are no
09f0: 74 20 74 68 72 65 61 64 2d 73 61 66 65 20 66 75  t thread-safe fu
0a00: 6e 63 74 69 6f 6e 73 2e 20 49 66 20 74 68 65 79  nctions. If they
0a10: 20 61 72 65 20 63 61 6c 6c 65 64 0a 2a 2a 20 20   are called.**  
0a20: 20 77 68 69 6c 65 20 73 6f 6d 65 20 6f 74 68 65   while some othe
0a30: 72 20 74 68 72 65 61 64 20 69 73 20 63 61 6c 6c  r thread is call
0a40: 69 6e 67 20 62 61 63 6b 75 70 5f 73 74 65 70 28  ing backup_step(
0a50: 29 20 6f 72 20 62 61 63 6b 75 70 5f 66 69 6e 69  ) or backup_fini
0a60: 73 68 28 29 2c 0a 2a 2a 20 20 20 74 68 65 20 76  sh(),.**   the v
0a70: 61 6c 75 65 73 20 72 65 74 75 72 6e 65 64 20 6d  alues returned m
0a80: 61 79 20 62 65 20 69 6e 76 61 6c 69 64 2e 20 54  ay be invalid. T
0a90: 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 66  here is no way f
0aa0: 6f 72 20 61 20 63 61 6c 6c 20 74 6f 0a 2a 2a 20  or a call to.** 
0ab0: 20 20 42 61 63 6b 75 70 55 70 64 61 74 65 28 29    BackupUpdate()
0ac0: 20 6f 72 20 42 61 63 6b 75 70 52 65 73 74 61 72   or BackupRestar
0ad0: 74 28 29 20 74 6f 20 69 6e 74 65 72 66 65 72 65  t() to interfere
0ae0: 20 77 69 74 68 20 62 61 63 6b 75 70 5f 72 65 6d   with backup_rem
0af0: 61 69 6e 69 6e 67 28 29 0a 2a 2a 20 20 20 6f 72  aining().**   or
0b00: 20 62 61 63 6b 75 70 5f 70 61 67 65 63 6f 75 6e   backup_pagecoun
0b10: 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 65 70  t()..**.**   Dep
0b20: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 53 51  ending on the SQ
0b30: 4c 69 74 65 20 63 6f 6e 66 69 67 75 72 61 74 69  Lite configurati
0b40: 6f 6e 2c 20 74 68 65 20 64 61 74 61 62 61 73 65  on, the database
0b50: 20 68 61 6e 64 6c 65 73 20 61 6e 64 2f 6f 72 0a   handles and/or.
0b60: 2a 2a 20 20 20 74 68 65 20 42 74 72 65 65 20 6f  **   the Btree o
0b70: 62 6a 65 63 74 73 20 6d 61 79 20 68 61 76 65 20  bjects may have 
0b80: 74 68 65 69 72 20 6f 77 6e 20 6d 75 74 65 78 65  their own mutexe
0b90: 73 20 74 68 61 74 20 72 65 71 75 69 72 65 20 6c  s that require l
0ba0: 6f 63 6b 69 6e 67 2e 0a 2a 2a 20 20 20 4e 6f 6e  ocking..**   Non
0bb0: 2d 73 68 61 72 61 62 6c 65 20 42 74 72 65 65 73  -sharable Btrees
0bc0: 20 28 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61   (in-memory data
0bd0: 62 61 73 65 73 20 66 6f 72 20 65 78 61 6d 70 6c  bases for exampl
0be0: 65 29 2c 20 64 6f 20 6e 6f 74 20 68 61 76 65 0a  e), do not have.
0bf0: 2a 2a 20 20 20 61 73 73 6f 63 69 61 74 65 64 20  **   associated 
0c00: 6d 75 74 65 78 65 73 2e 0a 2a 2f 0a 0a 2f 2a 0a  mutexes..*/../*.
0c10: 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e  ** Return a poin
0c20: 74 65 72 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  ter correspondin
0c30: 67 20 74 6f 20 64 61 74 61 62 61 73 65 20 7a 44  g to database zD
0c40: 62 20 28 69 2e 65 2e 20 22 6d 61 69 6e 22 2c 20  b (i.e. "main", 
0c50: 22 74 65 6d 70 22 29 0a 2a 2a 20 69 6e 20 63 6f  "temp").** in co
0c60: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20  nnection handle 
0c70: 70 44 62 2e 20 49 66 20 73 75 63 68 20 61 20 64  pDb. If such a d
0c80: 61 74 61 62 61 73 65 20 63 61 6e 6e 6f 74 20 62  atabase cannot b
0c90: 65 20 66 6f 75 6e 64 2c 20 72 65 74 75 72 6e 0a  e found, return.
0ca0: 2a 2a 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65  ** a NULL pointe
0cb0: 72 20 61 6e 64 20 77 72 69 74 65 20 61 6e 20 65  r and write an e
0cc0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 6f 20  rror message to 
0cd0: 70 45 72 72 6f 72 44 62 2e 0a 2a 2a 0a 2a 2a 20  pErrorDb..**.** 
0ce0: 49 66 20 74 68 65 20 22 74 65 6d 70 22 20 64 61  If the "temp" da
0cf0: 74 61 62 61 73 65 20 69 73 20 72 65 71 75 65 73  tabase is reques
0d00: 74 65 64 2c 20 69 74 20 6d 61 79 20 6e 65 65 64  ted, it may need
0d10: 20 74 6f 20 62 65 20 6f 70 65 6e 65 64 20 62 79   to be opened by
0d20: 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 74 69   this .** functi
0d30: 6f 6e 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20  on. If an error 
0d40: 6f 63 63 75 72 73 20 77 68 69 6c 65 20 64 6f 69  occurs while doi
0d50: 6e 67 20 73 6f 2c 20 72 65 74 75 72 6e 20 30 20  ng so, return 0 
0d60: 61 6e 64 20 77 72 69 74 65 20 61 6e 20 0a 2a 2a  and write an .**
0d70: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74   error message t
0d80: 6f 20 70 45 72 72 6f 72 44 62 2e 0a 2a 2f 0a 73  o pErrorDb..*/.s
0d90: 74 61 74 69 63 20 42 74 72 65 65 20 2a 66 69 6e  tatic Btree *fin
0da0: 64 42 74 72 65 65 28 73 71 6c 69 74 65 33 20 2a  dBtree(sqlite3 *
0db0: 70 45 72 72 6f 72 44 62 2c 20 73 71 6c 69 74 65  pErrorDb, sqlite
0dc0: 33 20 2a 70 44 62 2c 20 63 6f 6e 73 74 20 63 68  3 *pDb, const ch
0dd0: 61 72 20 2a 7a 44 62 29 7b 0a 20 20 69 6e 74 20  ar *zDb){.  int 
0de0: 69 20 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 44  i = sqlite3FindD
0df0: 62 4e 61 6d 65 28 70 44 62 2c 20 7a 44 62 29 3b  bName(pDb, zDb);
0e00: 0a 0a 20 20 69 66 28 20 69 3d 3d 31 20 29 7b 0a  ..  if( i==1 ){.
0e10: 20 20 20 20 50 61 72 73 65 20 73 50 61 72 73 65      Parse sParse
0e20: 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 73 50  ;.    memset(&sP
0e30: 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28  arse, 0, sizeof(
0e40: 73 50 61 72 73 65 29 29 3b 0a 20 20 20 20 73 50  sParse));.    sP
0e50: 61 72 73 65 2e 64 62 20 3d 20 70 44 62 3b 0a 20  arse.db = pDb;. 
0e60: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 4f 70     if( sqlite3Op
0e70: 65 6e 54 65 6d 70 44 61 74 61 62 61 73 65 28 26  enTempDatabase(&
0e80: 73 50 61 72 73 65 29 20 29 7b 0a 20 20 20 20 20  sParse) ){.     
0e90: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 43 6c 65   sqlite3ErrorCle
0ea0: 61 72 28 26 73 50 61 72 73 65 29 3b 0a 20 20 20  ar(&sParse);.   
0eb0: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
0ec0: 70 45 72 72 6f 72 44 62 2c 20 73 50 61 72 73 65  pErrorDb, sParse
0ed0: 2e 72 63 2c 20 22 25 73 22 2c 20 73 50 61 72 73  .rc, "%s", sPars
0ee0: 65 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  e.zErrMsg);.    
0ef0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20    return 0;.    
0f00: 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 50  }.    assert( sP
0f10: 61 72 73 65 2e 7a 45 72 72 4d 73 67 3d 3d 30 20  arse.zErrMsg==0 
0f20: 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 69 3c  );.  }..  if( i<
0f30: 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  0 ){.    sqlite3
0f40: 45 72 72 6f 72 28 70 45 72 72 6f 72 44 62 2c 20  Error(pErrorDb, 
0f50: 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20 22 75  SQLITE_ERROR, "u
0f60: 6e 6b 6e 6f 77 6e 20 64 61 74 61 62 61 73 65 20  nknown database 
0f70: 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20 20 20 72  %s", zDb);.    r
0f80: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20  eturn 0;.  }..  
0f90: 72 65 74 75 72 6e 20 70 44 62 2d 3e 61 44 62 5b  return pDb->aDb[
0fa0: 69 5d 2e 70 42 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  i].pBt;.}../*.**
0fb0: 20 43 72 65 61 74 65 20 61 6e 20 73 71 6c 69 74   Create an sqlit
0fc0: 65 33 5f 62 61 63 6b 75 70 20 70 72 6f 63 65 73  e3_backup proces
0fd0: 73 20 74 6f 20 63 6f 70 79 20 74 68 65 20 63 6f  s to copy the co
0fe0: 6e 74 65 6e 74 73 20 6f 66 20 7a 53 72 63 44 62  ntents of zSrcDb
0ff0: 20 66 72 6f 6d 0a 2a 2a 20 63 6f 6e 6e 65 63 74   from.** connect
1000: 69 6f 6e 20 68 61 6e 64 6c 65 20 70 53 72 63 44  ion handle pSrcD
1010: 62 20 74 6f 20 7a 44 65 73 74 44 62 20 69 6e 20  b to zDestDb in 
1020: 70 44 65 73 74 44 62 2e 20 49 66 20 73 75 63 63  pDestDb. If succ
1030: 65 73 73 66 75 6c 2c 20 72 65 74 75 72 6e 0a 2a  essful, return.*
1040: 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  * a pointer to t
1050: 68 65 20 6e 65 77 20 73 71 6c 69 74 65 33 5f 62  he new sqlite3_b
1060: 61 63 6b 75 70 20 6f 62 6a 65 63 74 2e 0a 2a 2a  ackup object..**
1070: 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20  .** If an error 
1080: 6f 63 63 75 72 73 2c 20 4e 55 4c 4c 20 69 73 20  occurs, NULL is 
1090: 72 65 74 75 72 6e 65 64 20 61 6e 64 20 61 6e 20  returned and an 
10a0: 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 65  error code and e
10b0: 72 72 6f 72 20 6d 65 73 73 61 67 65 0a 2a 2a 20  rror message.** 
10c0: 73 74 6f 72 65 64 20 69 6e 20 64 61 74 61 62 61  stored in databa
10d0: 73 65 20 68 61 6e 64 6c 65 20 70 44 65 73 74 44  se handle pDestD
10e0: 62 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 62 61  b..*/.sqlite3_ba
10f0: 63 6b 75 70 20 2a 73 71 6c 69 74 65 33 5f 62 61  ckup *sqlite3_ba
1100: 63 6b 75 70 5f 69 6e 69 74 28 0a 20 20 73 71 6c  ckup_init(.  sql
1110: 69 74 65 33 2a 20 70 44 65 73 74 44 62 2c 20 20  ite3* pDestDb,  
1120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1130: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 74     /* Database t
1140: 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a 20 20  o write to */.  
1150: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 65 73  const char *zDes
1160: 74 44 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  tDb,            
1170: 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66        /* Name of
1180: 20 64 61 74 61 62 61 73 65 20 77 69 74 68 69 6e   database within
1190: 20 70 44 65 73 74 44 62 20 2a 2f 0a 20 20 73 71   pDestDb */.  sq
11a0: 6c 69 74 65 33 2a 20 70 53 72 63 44 62 2c 20 20  lite3* pSrcDb,  
11b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
11c0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
11d0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 72 65  connection to re
11e0: 61 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 63 6f 6e  ad from */.  con
11f0: 73 74 20 63 68 61 72 20 2a 7a 53 72 63 44 62 20  st char *zSrcDb 
1200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1210: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61     /* Name of da
1220: 74 61 62 61 73 65 20 77 69 74 68 69 6e 20 70 53  tabase within pS
1230: 72 63 44 62 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c  rcDb */.){.  sql
1240: 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 3b 20  ite3_backup *p; 
1250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1260: 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72     /* Value to r
1270: 65 74 75 72 6e 20 2a 2f 0a 0a 20 20 2f 2a 20 4c  eturn */..  /* L
1280: 6f 63 6b 20 74 68 65 20 73 6f 75 72 63 65 20 64  ock the source d
1290: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20  atabase handle. 
12a0: 54 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20  The destination 
12b0: 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20 68 61  database.  ** ha
12c0: 6e 64 6c 65 20 69 73 20 6e 6f 74 20 6c 6f 63 6b  ndle is not lock
12d0: 65 64 20 69 6e 20 74 68 69 73 20 72 6f 75 74 69  ed in this routi
12e0: 6e 65 2c 20 62 75 74 20 69 74 20 69 73 20 6c 6f  ne, but it is lo
12f0: 63 6b 65 64 20 69 6e 0a 20 20 2a 2a 20 73 71 6c  cked in.  ** sql
1300: 69 74 65 33 5f 62 61 63 6b 75 70 5f 73 74 65 70  ite3_backup_step
1310: 28 29 2e 20 54 68 65 20 75 73 65 72 20 69 73 20  (). The user is 
1320: 72 65 71 75 69 72 65 64 20 74 6f 20 65 6e 73 75  required to ensu
1330: 72 65 20 74 68 61 74 20 6e 6f 0a 20 20 2a 2a 20  re that no.  ** 
1340: 6f 74 68 65 72 20 74 68 72 65 61 64 20 61 63 63  other thread acc
1350: 65 73 73 65 73 20 74 68 65 20 64 65 73 74 69 6e  esses the destin
1360: 61 74 69 6f 6e 20 68 61 6e 64 6c 65 20 66 6f 72  ation handle for
1370: 20 74 68 65 20 64 75 72 61 74 69 6f 6e 0a 20 20   the duration.  
1380: 2a 2a 20 6f 66 20 74 68 65 20 62 61 63 6b 75 70  ** of the backup
1390: 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 41 6e 79   operation.  Any
13a0: 20 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 20   attempt to use 
13b0: 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 0a  the destination.
13c0: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f    ** database co
13d0: 6e 6e 65 63 74 69 6f 6e 20 77 68 69 6c 65 20 61  nnection while a
13e0: 20 62 61 63 6b 75 70 20 69 73 20 69 6e 20 70 72   backup is in pr
13f0: 6f 67 72 65 73 73 20 6d 61 79 20 63 61 75 73 65  ogress may cause
1400: 0a 20 20 2a 2a 20 61 20 6d 61 6c 66 75 6e 63 74  .  ** a malfunct
1410: 69 6f 6e 20 6f 72 20 61 20 64 65 61 64 6c 6f 63  ion or a deadloc
1420: 6b 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65  k..  */.  sqlite
1430: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 53  3_mutex_enter(pS
1440: 72 63 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  rcDb->mutex);.  
1450: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
1460: 74 65 72 28 70 44 65 73 74 44 62 2d 3e 6d 75 74  ter(pDestDb->mut
1470: 65 78 29 3b 0a 0a 20 20 69 66 28 20 70 53 72 63  ex);..  if( pSrc
1480: 44 62 3d 3d 70 44 65 73 74 44 62 20 29 7b 0a 20  Db==pDestDb ){. 
1490: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
14a0: 0a 20 20 20 20 20 20 20 20 70 44 65 73 74 44 62  .        pDestDb
14b0: 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 20  , SQLITE_ERROR, 
14c0: 22 73 6f 75 72 63 65 20 61 6e 64 20 64 65 73 74  "source and dest
14d0: 69 6e 61 74 69 6f 6e 20 6d 75 73 74 20 62 65 20  ination must be 
14e0: 64 69 73 74 69 6e 63 74 22 0a 20 20 20 20 29 3b  distinct".    );
14f0: 0a 20 20 20 20 70 20 3d 20 30 3b 0a 20 20 7d 65  .    p = 0;.  }e
1500: 6c 73 65 20 7b 0a 20 20 20 20 2f 2a 20 41 6c 6c  lse {.    /* All
1510: 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f 72 20  ocate space for 
1520: 61 20 6e 65 77 20 73 71 6c 69 74 65 33 5f 62 61  a new sqlite3_ba
1530: 63 6b 75 70 20 6f 62 6a 65 63 74 20 2a 2f 0a 20  ckup object */. 
1540: 20 20 20 70 20 3d 20 28 73 71 6c 69 74 65 33 5f     p = (sqlite3_
1550: 62 61 63 6b 75 70 20 2a 29 73 71 6c 69 74 65 33  backup *)sqlite3
1560: 5f 6d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 73  _malloc(sizeof(s
1570: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 29 29 3b  qlite3_backup));
1580: 0a 20 20 20 20 69 66 28 20 21 70 20 29 7b 0a 20  .    if( !p ){. 
1590: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f       sqlite3Erro
15a0: 72 28 70 44 65 73 74 44 62 2c 20 53 51 4c 49 54  r(pDestDb, SQLIT
15b0: 45 5f 4e 4f 4d 45 4d 2c 20 30 29 3b 0a 20 20 20  E_NOMEM, 0);.   
15c0: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20   }.  }..  /* If 
15d0: 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73  the allocation s
15e0: 75 63 63 65 65 64 65 64 2c 20 70 6f 70 75 6c 61  ucceeded, popula
15f0: 74 65 20 74 68 65 20 6e 65 77 20 6f 62 6a 65 63  te the new objec
1600: 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70 20 29 7b  t. */.  if( p ){
1610: 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 2c 20 30  .    memset(p, 0
1620: 2c 20 73 69 7a 65 6f 66 28 73 71 6c 69 74 65 33  , sizeof(sqlite3
1630: 5f 62 61 63 6b 75 70 29 29 3b 0a 20 20 20 20 70  _backup));.    p
1640: 2d 3e 70 53 72 63 20 3d 20 66 69 6e 64 42 74 72  ->pSrc = findBtr
1650: 65 65 28 70 44 65 73 74 44 62 2c 20 70 53 72 63  ee(pDestDb, pSrc
1660: 44 62 2c 20 7a 53 72 63 44 62 29 3b 0a 20 20 20  Db, zSrcDb);.   
1670: 20 70 2d 3e 70 44 65 73 74 20 3d 20 66 69 6e 64   p->pDest = find
1680: 42 74 72 65 65 28 70 44 65 73 74 44 62 2c 20 70  Btree(pDestDb, p
1690: 44 65 73 74 44 62 2c 20 7a 44 65 73 74 44 62 29  DestDb, zDestDb)
16a0: 3b 0a 20 20 20 20 70 2d 3e 70 44 65 73 74 44 62  ;.    p->pDestDb
16b0: 20 3d 20 70 44 65 73 74 44 62 3b 0a 20 20 20 20   = pDestDb;.    
16c0: 70 2d 3e 70 53 72 63 44 62 20 3d 20 70 53 72 63  p->pSrcDb = pSrc
16d0: 44 62 3b 0a 20 20 20 20 70 2d 3e 69 4e 65 78 74  Db;.    p->iNext
16e0: 20 3d 20 31 3b 0a 0a 20 20 20 20 69 66 28 20 30   = 1;..    if( 0
16f0: 3d 3d 70 2d 3e 70 53 72 63 20 7c 7c 20 30 3d 3d  ==p->pSrc || 0==
1700: 70 2d 3e 70 44 65 73 74 20 29 7b 0a 20 20 20 20  p->pDest ){.    
1710: 20 20 2f 2a 20 4f 6e 65 20 28 6f 72 20 62 6f 74    /* One (or bot
1720: 68 29 20 6f 66 20 74 68 65 20 6e 61 6d 65 64 20  h) of the named 
1730: 64 61 74 61 62 61 73 65 73 20 64 69 64 20 6e 6f  databases did no
1740: 74 20 65 78 69 73 74 2e 20 41 6e 20 65 72 72 6f  t exist. An erro
1750: 72 20 68 61 73 0a 20 20 20 20 20 20 2a 2a 20 61  r has.      ** a
1760: 6c 72 65 61 64 79 20 62 65 65 6e 20 77 72 69 74  lready been writ
1770: 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 70 44 65  ten into the pDe
1780: 73 74 44 62 20 68 61 6e 64 6c 65 2e 20 41 6c 6c  stDb handle. All
1790: 20 74 68 61 74 20 69 73 20 6c 65 66 74 0a 20 20   that is left.  
17a0: 20 20 20 20 2a 2a 20 74 6f 20 64 6f 20 68 65 72      ** to do her
17b0: 65 20 69 73 20 66 72 65 65 20 74 68 65 20 73 71  e is free the sq
17c0: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 73 74 72  lite3_backup str
17d0: 75 63 74 75 72 65 2e 0a 20 20 20 20 20 20 2a 2f  ucture..      */
17e0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66  .      sqlite3_f
17f0: 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 70 20  ree(p);.      p 
1800: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  = 0;.    }.  }..
1810: 20 20 2f 2a 20 49 66 20 65 76 65 72 79 74 68 69    /* If everythi
1820: 6e 67 20 68 61 73 20 67 6f 6e 65 20 61 73 20 70  ng has gone as p
1830: 6c 61 6e 6e 65 64 2c 20 61 74 74 61 63 68 20 74  lanned, attach t
1840: 68 65 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74  he backup object
1850: 20 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73 6f 75   to the.  ** sou
1860: 72 63 65 20 70 61 67 65 72 2e 20 54 68 65 20 73  rce pager. The s
1870: 6f 75 72 63 65 20 70 61 67 65 72 20 63 61 6c 6c  ource pager call
1880: 73 20 42 61 63 6b 75 70 55 70 64 61 74 65 28 29  s BackupUpdate()
1890: 20 61 6e 64 20 42 61 63 6b 75 70 52 65 73 74 61   and BackupResta
18a0: 72 74 28 29 0a 20 20 2a 2a 20 74 6f 20 6e 6f 74  rt().  ** to not
18b0: 69 66 79 20 74 68 69 73 20 6d 6f 64 75 6c 65 20  ify this module 
18c0: 69 66 20 74 68 65 20 73 6f 75 72 63 65 20 66 69  if the source fi
18d0: 6c 65 20 69 73 20 6d 6f 64 69 66 69 65 64 20 6d  le is modified m
18e0: 69 64 2d 62 61 63 6b 75 70 2e 0a 20 20 2a 2f 0a  id-backup..  */.
18f0: 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 73    if( p ){.    s
1900: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 2a  qlite3_backup **
1910: 70 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  pp;             
1920: 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 68 65  /* Pointer to he
1930: 61 64 20 6f 66 20 70 61 67 65 72 73 20 62 61 63  ad of pagers bac
1940: 6b 75 70 20 6c 69 73 74 20 2a 2f 0a 20 20 20 20  kup list */.    
1950: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
1960: 72 28 70 2d 3e 70 53 72 63 29 3b 0a 20 20 20 20  r(p->pSrc);.    
1970: 70 70 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65  pp = sqlite3Page
1980: 72 42 61 63 6b 75 70 50 74 72 28 73 71 6c 69 74  rBackupPtr(sqlit
1990: 65 33 42 74 72 65 65 50 61 67 65 72 28 70 2d 3e  e3BtreePager(p->
19a0: 70 53 72 63 29 29 3b 0a 20 20 20 20 70 2d 3e 70  pSrc));.    p->p
19b0: 4e 65 78 74 20 3d 20 2a 70 70 3b 0a 20 20 20 20  Next = *pp;.    
19c0: 2a 70 70 20 3d 20 70 3b 0a 20 20 20 20 73 71 6c  *pp = p;.    sql
19d0: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70  ite3BtreeLeave(p
19e0: 2d 3e 70 53 72 63 29 3b 0a 20 20 20 20 70 2d 3e  ->pSrc);.    p->
19f0: 70 53 72 63 2d 3e 6e 42 61 63 6b 75 70 2b 2b 3b  pSrc->nBackup++;
1a00: 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33 5f  .  }..  sqlite3_
1a10: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 44 65 73  mutex_leave(pDes
1a20: 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73  tDb->mutex);.  s
1a30: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
1a40: 76 65 28 70 53 72 63 44 62 2d 3e 6d 75 74 65 78  ve(pSrcDb->mutex
1a50: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d  );.  return p;.}
1a60: 0a 0a 2f 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65  ../*.** Paramete
1a70: 72 20 7a 53 72 63 44 61 74 61 20 70 6f 69 6e 74  r zSrcData point
1a80: 73 20 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f  s to a buffer co
1a90: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 64 61 74  ntaining the dat
1aa0: 61 20 66 6f 72 20 0a 2a 2a 20 70 61 67 65 20 69  a for .** page i
1ab0: 53 72 63 50 67 20 66 72 6f 6d 20 74 68 65 20 73  SrcPg from the s
1ac0: 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 2e 20  ource database. 
1ad0: 43 6f 70 79 20 74 68 69 73 20 64 61 74 61 20 69  Copy this data i
1ae0: 6e 74 6f 20 74 68 65 20 0a 2a 2a 20 64 65 73 74  nto the .** dest
1af0: 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65  ination database
1b00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
1b10: 62 61 63 6b 75 70 4f 6e 65 50 61 67 65 28 73 71  backupOnePage(sq
1b20: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 2c  lite3_backup *p,
1b30: 20 50 67 6e 6f 20 69 53 72 63 50 67 2c 20 63 6f   Pgno iSrcPg, co
1b40: 6e 73 74 20 75 38 20 2a 7a 53 72 63 44 61 74 61  nst u8 *zSrcData
1b50: 29 7b 0a 20 20 50 61 67 65 72 20 2a 20 63 6f 6e  ){.  Pager * con
1b60: 73 74 20 70 44 65 73 74 50 61 67 65 72 20 3d 20  st pDestPager = 
1b70: 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 65  sqlite3BtreePage
1b80: 72 28 70 2d 3e 70 44 65 73 74 29 3b 0a 20 20 63  r(p->pDest);.  c
1b90: 6f 6e 73 74 20 69 6e 74 20 6e 53 72 63 50 67 73  onst int nSrcPgs
1ba0: 7a 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  z = sqlite3Btree
1bb0: 47 65 74 50 61 67 65 53 69 7a 65 28 70 2d 3e 70  GetPageSize(p->p
1bc0: 53 72 63 29 3b 0a 20 20 69 6e 74 20 6e 44 65 73  Src);.  int nDes
1bd0: 74 50 67 73 7a 20 3d 20 73 71 6c 69 74 65 33 42  tPgsz = sqlite3B
1be0: 74 72 65 65 47 65 74 50 61 67 65 53 69 7a 65 28  treeGetPageSize(
1bf0: 70 2d 3e 70 44 65 73 74 29 3b 0a 20 20 63 6f 6e  p->pDest);.  con
1c00: 73 74 20 69 6e 74 20 6e 43 6f 70 79 20 3d 20 4d  st int nCopy = M
1c10: 49 4e 28 6e 53 72 63 50 67 73 7a 2c 20 6e 44 65  IN(nSrcPgsz, nDe
1c20: 73 74 50 67 73 7a 29 3b 0a 20 20 63 6f 6e 73 74  stPgsz);.  const
1c30: 20 69 36 34 20 69 45 6e 64 20 3d 20 28 69 36 34   i64 iEnd = (i64
1c40: 29 69 53 72 63 50 67 2a 28 69 36 34 29 6e 53 72  )iSrcPg*(i64)nSr
1c50: 63 50 67 73 7a 3b 0a 0a 20 20 69 6e 74 20 72 63  cPgsz;..  int rc
1c60: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
1c70: 69 36 34 20 69 4f 66 66 3b 0a 0a 20 20 61 73 73  i64 iOff;..  ass
1c80: 65 72 74 28 20 70 2d 3e 62 44 65 73 74 4c 6f 63  ert( p->bDestLoc
1c90: 6b 65 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ked );.  assert(
1ca0: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f   p->rc==SQLITE_O
1cb0: 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69  K );.  assert( i
1cc0: 53 72 63 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42  SrcPg!=PENDING_B
1cd0: 59 54 45 5f 50 41 47 45 28 70 2d 3e 70 53 72 63  YTE_PAGE(p->pSrc
1ce0: 2d 3e 70 42 74 29 20 29 3b 0a 20 20 61 73 73 65  ->pBt) );.  asse
1cf0: 72 74 28 20 7a 53 72 63 44 61 74 61 20 29 3b 0a  rt( zSrcData );.
1d00: 0a 20 20 2f 2a 20 43 61 74 63 68 20 74 68 65 20  .  /* Catch the 
1d10: 63 61 73 65 20 77 68 65 72 65 20 74 68 65 20 64  case where the d
1d20: 65 73 74 69 6e 61 74 69 6f 6e 20 69 73 20 61 6e  estination is an
1d30: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62   in-memory datab
1d40: 61 73 65 20 61 6e 64 20 74 68 65 0a 20 20 2a 2a  ase and the.  **
1d50: 20 70 61 67 65 20 73 69 7a 65 73 20 6f 66 20 74   page sizes of t
1d60: 68 65 20 73 6f 75 72 63 65 20 61 6e 64 20 64 65  he source and de
1d70: 73 74 69 6e 61 74 69 6f 6e 20 64 69 66 66 65 72  stination differ
1d80: 2e 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e 53  . .  */.  if( nS
1d90: 72 63 50 67 73 7a 21 3d 6e 44 65 73 74 50 67 73  rcPgsz!=nDestPgs
1da0: 7a 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65  z && sqlite3Page
1db0: 72 49 73 4d 65 6d 64 62 28 73 71 6c 69 74 65 33  rIsMemdb(sqlite3
1dc0: 42 74 72 65 65 50 61 67 65 72 28 70 2d 3e 70 44  BtreePager(p->pD
1dd0: 65 73 74 29 29 20 29 7b 0a 20 20 20 20 72 63 20  est)) ){.    rc 
1de0: 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c  = SQLITE_READONL
1df0: 59 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 69  Y;.  }..  /* Thi
1e00: 73 20 6c 6f 6f 70 20 72 75 6e 73 20 6f 6e 63 65  s loop runs once
1e10: 20 66 6f 72 20 65 61 63 68 20 64 65 73 74 69 6e   for each destin
1e20: 61 74 69 6f 6e 20 70 61 67 65 20 73 70 61 6e 6e  ation page spann
1e30: 65 64 20 62 79 20 74 68 65 20 73 6f 75 72 63 65  ed by the source
1e40: 20 0a 20 20 2a 2a 20 70 61 67 65 2e 20 46 6f 72   .  ** page. For
1e50: 20 65 61 63 68 20 69 74 65 72 61 74 69 6f 6e 2c   each iteration,
1e60: 20 76 61 72 69 61 62 6c 65 20 69 4f 66 66 20 69   variable iOff i
1e70: 73 20 73 65 74 20 74 6f 20 74 68 65 20 62 79 74  s set to the byt
1e80: 65 20 6f 66 66 73 65 74 0a 20 20 2a 2a 20 6f 66  e offset.  ** of
1e90: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
1ea0: 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 66 6f   page..  */.  fo
1eb0: 72 28 69 4f 66 66 3d 69 45 6e 64 2d 28 69 36 34  r(iOff=iEnd-(i64
1ec0: 29 6e 53 72 63 50 67 73 7a 3b 20 72 63 3d 3d 53  )nSrcPgsz; rc==S
1ed0: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4f 66 66  QLITE_OK && iOff
1ee0: 3c 69 45 6e 64 3b 20 69 4f 66 66 2b 3d 6e 44 65  <iEnd; iOff+=nDe
1ef0: 73 74 50 67 73 7a 29 7b 0a 20 20 20 20 44 62 50  stPgsz){.    DbP
1f00: 61 67 65 20 2a 70 44 65 73 74 50 67 20 3d 20 30  age *pDestPg = 0
1f10: 3b 0a 20 20 20 20 50 67 6e 6f 20 69 44 65 73 74  ;.    Pgno iDest
1f20: 20 3d 20 28 50 67 6e 6f 29 28 69 4f 66 66 2f 6e   = (Pgno)(iOff/n
1f30: 44 65 73 74 50 67 73 7a 29 2b 31 3b 0a 20 20 20  DestPgsz)+1;.   
1f40: 20 69 66 28 20 69 44 65 73 74 3d 3d 50 45 4e 44   if( iDest==PEND
1f50: 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 2d  ING_BYTE_PAGE(p-
1f60: 3e 70 44 65 73 74 2d 3e 70 42 74 29 20 29 20 63  >pDest->pBt) ) c
1f70: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28  ontinue;.    if(
1f80: 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20   SQLITE_OK==(rc 
1f90: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65  = sqlite3PagerGe
1fa0: 74 28 70 44 65 73 74 50 61 67 65 72 2c 20 69 44  t(pDestPager, iD
1fb0: 65 73 74 2c 20 26 70 44 65 73 74 50 67 29 29 0a  est, &pDestPg)).
1fc0: 20 20 20 20 20 26 26 20 53 51 4c 49 54 45 5f 4f       && SQLITE_O
1fd0: 4b 3d 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33  K==(rc = sqlite3
1fe0: 50 61 67 65 72 57 72 69 74 65 28 70 44 65 73 74  PagerWrite(pDest
1ff0: 50 67 29 29 0a 20 20 20 20 29 7b 0a 20 20 20 20  Pg)).    ){.    
2000: 20 20 63 6f 6e 73 74 20 75 38 20 2a 7a 49 6e 20    const u8 *zIn 
2010: 3d 20 26 7a 53 72 63 44 61 74 61 5b 69 4f 66 66  = &zSrcData[iOff
2020: 25 6e 53 72 63 50 67 73 7a 5d 3b 0a 20 20 20 20  %nSrcPgsz];.    
2030: 20 20 75 38 20 2a 7a 44 65 73 74 44 61 74 61 20    u8 *zDestData 
2040: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65  = sqlite3PagerGe
2050: 74 44 61 74 61 28 70 44 65 73 74 50 67 29 3b 0a  tData(pDestPg);.
2060: 20 20 20 20 20 20 75 38 20 2a 7a 4f 75 74 20 3d        u8 *zOut =
2070: 20 26 7a 44 65 73 74 44 61 74 61 5b 69 4f 66 66   &zDestData[iOff
2080: 25 6e 44 65 73 74 50 67 73 7a 5d 3b 0a 0a 20 20  %nDestPgsz];..  
2090: 20 20 20 20 2f 2a 20 43 6f 70 79 20 74 68 65 20      /* Copy the 
20a0: 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 73 6f  data from the so
20b0: 75 72 63 65 20 70 61 67 65 20 69 6e 74 6f 20 74  urce page into t
20c0: 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 70  he destination p
20d0: 61 67 65 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68  age..      ** Th
20e0: 65 6e 20 63 6c 65 61 72 20 74 68 65 20 42 74 72  en clear the Btr
20f0: 65 65 20 6c 61 79 65 72 20 4d 65 6d 50 61 67 65  ee layer MemPage
2100: 2e 69 73 49 6e 69 74 20 66 6c 61 67 2e 20 42 6f  .isInit flag. Bo
2110: 74 68 20 74 68 69 73 20 6d 6f 64 75 6c 65 0a 20  th this module. 
2120: 20 20 20 20 20 2a 2a 20 61 6e 64 20 74 68 65 20       ** and the 
2130: 70 61 67 65 72 20 63 6f 64 65 20 75 73 65 20 74  pager code use t
2140: 68 69 73 20 74 72 69 63 6b 20 28 63 6c 65 61 72  his trick (clear
2150: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 62 79  ing the first by
2160: 74 65 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 74  te.      ** of t
2170: 68 65 20 70 61 67 65 20 27 65 78 74 72 61 27 20  he page 'extra' 
2180: 73 70 61 63 65 20 74 6f 20 69 6e 76 61 6c 69 64  space to invalid
2190: 61 74 65 20 74 68 65 20 42 74 72 65 65 20 6c 61  ate the Btree la
21a0: 79 65 72 73 0a 20 20 20 20 20 20 2a 2a 20 63 61  yers.      ** ca
21b0: 63 68 65 64 20 70 61 72 73 65 20 6f 66 20 74 68  ched parse of th
21c0: 65 20 70 61 67 65 29 2e 20 4d 65 6d 50 61 67 65  e page). MemPage
21d0: 2e 69 73 49 6e 69 74 20 69 73 20 6d 61 72 6b 65  .isInit is marke
21e0: 64 20 0a 20 20 20 20 20 20 2a 2a 20 22 4d 55 53  d .      ** "MUS
21f0: 54 20 42 45 20 46 49 52 53 54 22 20 66 6f 72 20  T BE FIRST" for 
2200: 74 68 69 73 20 70 75 72 70 6f 73 65 2e 0a 20 20  this purpose..  
2210: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 6d 65 6d      */.      mem
2220: 63 70 79 28 7a 4f 75 74 2c 20 7a 49 6e 2c 20 6e  cpy(zOut, zIn, n
2230: 43 6f 70 79 29 3b 0a 20 20 20 20 20 20 28 28 75  Copy);.      ((u
2240: 38 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72  8 *)sqlite3Pager
2250: 47 65 74 45 78 74 72 61 28 70 44 65 73 74 50 67  GetExtra(pDestPg
2260: 29 29 5b 30 5d 20 3d 20 30 3b 0a 20 20 20 20 7d  ))[0] = 0;.    }
2270: 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65  .    sqlite3Page
2280: 72 55 6e 72 65 66 28 70 44 65 73 74 50 67 29 3b  rUnref(pDestPg);
2290: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72  .  }..  return r
22a0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 70 79  c;.}../*.** Copy
22b0: 20 6e 50 61 67 65 20 70 61 67 65 73 20 66 72 6f   nPage pages fro
22c0: 6d 20 74 68 65 20 73 6f 75 72 63 65 20 62 2d 74  m the source b-t
22d0: 72 65 65 20 74 6f 20 74 68 65 20 64 65 73 74 69  ree to the desti
22e0: 6e 61 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73  nation..*/.int s
22f0: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f 73 74  qlite3_backup_st
2300: 65 70 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  ep(sqlite3_backu
2310: 70 20 2a 70 2c 20 69 6e 74 20 6e 50 61 67 65 29  p *p, int nPage)
2320: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 73  {.  int rc;..  s
2330: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
2340: 65 72 28 70 2d 3e 70 53 72 63 44 62 2d 3e 6d 75  er(p->pSrcDb->mu
2350: 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 33 42  tex);.  sqlite3B
2360: 74 72 65 65 45 6e 74 65 72 28 70 2d 3e 70 53 72  treeEnter(p->pSr
2370: 63 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 44 65  c);.  if( p->pDe
2380: 73 74 44 62 20 29 7b 0a 20 20 20 20 73 71 6c 69  stDb ){.    sqli
2390: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
23a0: 70 2d 3e 70 44 65 73 74 44 62 2d 3e 6d 75 74 65  p->pDestDb->mute
23b0: 78 29 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20  x);.  }..  rc = 
23c0: 70 2d 3e 72 63 3b 0a 20 20 69 66 28 20 72 63 3d  p->rc;.  if( rc=
23d0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
23e0: 20 20 50 61 67 65 72 20 2a 20 63 6f 6e 73 74 20    Pager * const 
23f0: 70 53 72 63 50 61 67 65 72 20 3d 20 73 71 6c 69  pSrcPager = sqli
2400: 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 2d  te3BtreePager(p-
2410: 3e 70 53 72 63 29 3b 20 20 20 20 20 2f 2a 20 53  >pSrc);     /* S
2420: 6f 75 72 63 65 20 70 61 67 65 72 20 2a 2f 0a 20  ource pager */. 
2430: 20 20 20 50 61 67 65 72 20 2a 20 63 6f 6e 73 74     Pager * const
2440: 20 70 44 65 73 74 50 61 67 65 72 20 3d 20 73 71   pDestPager = sq
2450: 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28  lite3BtreePager(
2460: 70 2d 3e 70 44 65 73 74 29 3b 20 20 20 2f 2a 20  p->pDest);   /* 
2470: 44 65 73 74 20 70 61 67 65 72 20 2a 2f 0a 20 20  Dest pager */.  
2480: 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 20 20    int ii;       
2490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
24a0: 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72       /* Iterator
24b0: 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 20   variable */.   
24c0: 20 69 6e 74 20 6e 53 72 63 50 61 67 65 20 3d 20   int nSrcPage = 
24d0: 2d 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  -1;             
24e0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 73      /* Size of s
24f0: 6f 75 72 63 65 20 64 62 20 69 6e 20 70 61 67 65  ource db in page
2500: 73 20 2a 2f 0a 20 20 20 20 69 6e 74 20 62 43 6c  s */.    int bCl
2510: 6f 73 65 54 72 61 6e 73 20 3d 20 30 3b 20 20 20  oseTrans = 0;   
2520: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
2530: 72 75 65 20 69 66 20 73 72 63 20 64 62 20 72 65  rue if src db re
2540: 71 75 69 72 65 73 20 75 6e 6c 6f 63 6b 69 6e 67  quires unlocking
2550: 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74   */..    /* If t
2560: 68 65 20 73 6f 75 72 63 65 20 70 61 67 65 72 20  he source pager 
2570: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20  is currently in 
2580: 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74  a write-transact
2590: 69 6f 6e 2c 20 72 65 74 75 72 6e 0a 20 20 20 20  ion, return.    
25a0: 2a 2a 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  ** SQLITE_LOCKED
25b0: 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 20 20   immediately..  
25c0: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e    */.    if( p->
25d0: 70 44 65 73 74 44 62 20 26 26 20 70 2d 3e 70 53  pDestDb && p->pS
25e0: 72 63 2d 3e 70 42 74 2d 3e 69 6e 54 72 61 6e 73  rc->pBt->inTrans
25f0: 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52  action==TRANS_WR
2600: 49 54 45 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ITE ){.      rc 
2610: 3d 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 3b  = SQLITE_LOCKED;
2620: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 4c  .    }..    /* L
2630: 6f 63 6b 20 74 68 65 20 64 65 73 74 69 6e 61 74  ock the destinat
2640: 69 6f 6e 20 64 61 74 61 62 61 73 65 2c 20 69 66  ion database, if
2650: 20 69 74 20 69 73 20 6e 6f 74 20 6c 6f 63 6b 65   it is not locke
2660: 64 20 61 6c 72 65 61 64 79 2e 20 2a 2f 0a 20 20  d already. */.  
2670: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d    if( SQLITE_OK=
2680: 3d 72 63 20 26 26 20 70 2d 3e 62 44 65 73 74 4c  =rc && p->bDestL
2690: 6f 63 6b 65 64 3d 3d 30 0a 20 20 20 20 20 26 26  ocked==0.     &&
26a0: 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20   SQLITE_OK==(rc 
26b0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65  = sqlite3BtreeBe
26c0: 67 69 6e 54 72 61 6e 73 28 70 2d 3e 70 44 65 73  ginTrans(p->pDes
26d0: 74 2c 20 32 29 29 20 0a 20 20 20 20 29 7b 0a 20  t, 2)) .    ){. 
26e0: 20 20 20 20 20 70 2d 3e 62 44 65 73 74 4c 6f 63       p->bDestLoc
26f0: 6b 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20 72  ked = 1;.      r
2700: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
2710: 47 65 74 4d 65 74 61 28 70 2d 3e 70 44 65 73 74  GetMeta(p->pDest
2720: 2c 20 31 2c 20 26 70 2d 3e 69 44 65 73 74 53 63  , 1, &p->iDestSc
2730: 68 65 6d 61 29 3b 0a 20 20 20 20 7d 0a 0a 20 20  hema);.    }..  
2740: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73    /* If there is
2750: 20 6e 6f 20 6f 70 65 6e 20 72 65 61 64 2d 74 72   no open read-tr
2760: 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65  ansaction on the
2770: 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65   source database
2780: 2c 20 6f 70 65 6e 0a 20 20 20 20 2a 2a 20 6f 6e  , open.    ** on
2790: 65 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 61 6e  e now. If a tran
27a0: 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65  saction is opene
27b0: 64 20 68 65 72 65 2c 20 74 68 65 6e 20 69 74 20  d here, then it 
27c0: 77 69 6c 6c 20 62 65 20 63 6c 6f 73 65 64 0a 20  will be closed. 
27d0: 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 74 68 69     ** before thi
27e0: 73 20 66 75 6e 63 74 69 6f 6e 20 65 78 69 74 73  s function exits
27f0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
2800: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
2810: 26 20 30 3d 3d 73 71 6c 69 74 65 33 42 74 72 65  & 0==sqlite3Btre
2820: 65 49 73 49 6e 52 65 61 64 54 72 61 6e 73 28 70  eIsInReadTrans(p
2830: 2d 3e 70 53 72 63 29 20 29 7b 0a 20 20 20 20 20  ->pSrc) ){.     
2840: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
2850: 65 65 42 65 67 69 6e 54 72 61 6e 73 28 70 2d 3e  eeBeginTrans(p->
2860: 70 53 72 63 2c 20 30 29 3b 0a 20 20 20 20 20 20  pSrc, 0);.      
2870: 62 43 6c 6f 73 65 54 72 61 6e 73 20 3d 20 31 3b  bCloseTrans = 1;
2880: 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a  .    }.  .    /*
2890: 20 4e 6f 77 20 74 68 61 74 20 74 68 65 72 65 20   Now that there 
28a0: 69 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 6f  is a read-lock o
28b0: 6e 20 74 68 65 20 73 6f 75 72 63 65 20 64 61 74  n the source dat
28c0: 61 62 61 73 65 2c 20 71 75 65 72 79 20 74 68 65  abase, query the
28d0: 0a 20 20 20 20 2a 2a 20 73 6f 75 72 63 65 20 70  .    ** source p
28e0: 61 67 65 72 20 66 6f 72 20 74 68 65 20 6e 75 6d  ager for the num
28f0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20  ber of pages in 
2900: 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20  the database..  
2910: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 63 3d    */.    if( rc=
2920: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
2930: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
2940: 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70  PagerPagecount(p
2950: 53 72 63 50 61 67 65 72 2c 20 26 6e 53 72 63 50  SrcPager, &nSrcP
2960: 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  age);.    }.    
2970: 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 6e 50 61  for(ii=0; ii<nPa
2980: 67 65 20 26 26 20 70 2d 3e 69 4e 65 78 74 3c 3d  ge && p->iNext<=
2990: 28 50 67 6e 6f 29 6e 53 72 63 50 61 67 65 20 26  (Pgno)nSrcPage &
29a0: 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b  & rc==SQLITE_OK;
29b0: 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 63 6f   ii++){.      co
29c0: 6e 73 74 20 50 67 6e 6f 20 69 53 72 63 50 67 20  nst Pgno iSrcPg 
29d0: 3d 20 70 2d 3e 69 4e 65 78 74 3b 20 20 20 20 20  = p->iNext;     
29e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
29f0: 6f 75 72 63 65 20 70 61 67 65 20 6e 75 6d 62 65  ource page numbe
2a00: 72 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 69  r */.      if( i
2a10: 53 72 63 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42  SrcPg!=PENDING_B
2a20: 59 54 45 5f 50 41 47 45 28 70 2d 3e 70 53 72 63  YTE_PAGE(p->pSrc
2a30: 2d 3e 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20  ->pBt) ){.      
2a40: 20 20 44 62 50 61 67 65 20 2a 70 53 72 63 50 67    DbPage *pSrcPg
2a50: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
2a70: 20 53 6f 75 72 63 65 20 70 61 67 65 20 6f 62 6a   Source page obj
2a80: 65 63 74 20 2a 2f 0a 20 20 20 20 20 20 20 20 72  ect */.        r
2a90: 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72  c = sqlite3Pager
2aa0: 47 65 74 28 70 53 72 63 50 61 67 65 72 2c 20 69  Get(pSrcPager, i
2ab0: 53 72 63 50 67 2c 20 26 70 53 72 63 50 67 29 3b  SrcPg, &pSrcPg);
2ac0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d  .        if( rc=
2ad0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
2ae0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 61 63          rc = bac
2af0: 6b 75 70 4f 6e 65 50 61 67 65 28 70 2c 20 69 53  kupOnePage(p, iS
2b00: 72 63 50 67 2c 20 73 71 6c 69 74 65 33 50 61 67  rcPg, sqlite3Pag
2b10: 65 72 47 65 74 44 61 74 61 28 70 53 72 63 50 67  erGetData(pSrcPg
2b20: 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71  ));.          sq
2b30: 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28  lite3PagerUnref(
2b40: 70 53 72 63 50 67 29 3b 0a 20 20 20 20 20 20 20  pSrcPg);.       
2b50: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20   }.      }.     
2b60: 20 70 2d 3e 69 4e 65 78 74 2b 2b 3b 0a 20 20 20   p->iNext++;.   
2b70: 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53   }.    if( rc==S
2b80: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
2b90: 20 20 70 2d 3e 6e 50 61 67 65 63 6f 75 6e 74 20    p->nPagecount 
2ba0: 3d 20 6e 53 72 63 50 61 67 65 3b 0a 20 20 20 20  = nSrcPage;.    
2bb0: 20 20 70 2d 3e 6e 52 65 6d 61 69 6e 69 6e 67 20    p->nRemaining 
2bc0: 3d 20 6e 53 72 63 50 61 67 65 2b 31 2d 70 2d 3e  = nSrcPage+1-p->
2bd0: 69 4e 65 78 74 3b 0a 20 20 20 20 20 20 69 66 28  iNext;.      if(
2be0: 20 70 2d 3e 69 4e 65 78 74 3e 28 50 67 6e 6f 29   p->iNext>(Pgno)
2bf0: 6e 53 72 63 50 61 67 65 20 29 7b 0a 20 20 20 20  nSrcPage ){.    
2c00: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2c10: 44 4f 4e 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20  DONE;.      }.  
2c20: 20 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 72    }.  .    if( r
2c30: 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29  c==SQLITE_DONE )
2c40: 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 69 6e  {.      const in
2c50: 74 20 6e 53 72 63 50 61 67 65 73 69 7a 65 20 3d  t nSrcPagesize =
2c60: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
2c70: 50 61 67 65 53 69 7a 65 28 70 2d 3e 70 53 72 63  PageSize(p->pSrc
2c80: 29 3b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 69  );.      const i
2c90: 6e 74 20 6e 44 65 73 74 50 61 67 65 73 69 7a 65  nt nDestPagesize
2ca0: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 47   = sqlite3BtreeG
2cb0: 65 74 50 61 67 65 53 69 7a 65 28 70 2d 3e 70 44  etPageSize(p->pD
2cc0: 65 73 74 29 3b 0a 20 20 20 20 20 20 69 6e 74 20  est);.      int 
2cd0: 6e 44 65 73 74 54 72 75 6e 63 61 74 65 3b 0a 20  nDestTruncate;. 
2ce0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c       sqlite3_fil
2cf0: 65 20 2a 70 46 69 6c 65 20 3d 20 30 3b 0a 20 20  e *pFile = 0;.  
2d00: 20 20 20 20 69 36 34 20 69 53 69 7a 65 3b 0a 20      i64 iSize;. 
2d10: 20 0a 20 20 20 20 20 20 2f 2a 20 55 70 64 61 74   .      /* Updat
2d20: 65 20 74 68 65 20 73 63 68 65 6d 61 20 76 65 72  e the schema ver
2d30: 73 69 6f 6e 20 66 69 65 6c 64 20 69 6e 20 74 68  sion field in th
2d40: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61  e destination da
2d50: 74 61 62 61 73 65 2e 20 54 68 69 73 0a 20 20 20  tabase. This.   
2d60: 20 20 20 2a 2a 20 69 73 20 74 6f 20 6d 61 6b 65     ** is to make
2d70: 20 73 75 72 65 20 74 68 61 74 20 74 68 65 20 73   sure that the s
2d80: 63 68 65 6d 61 2d 76 65 72 73 69 6f 6e 20 72 65  chema-version re
2d90: 61 6c 6c 79 20 64 6f 65 73 20 63 68 61 6e 67 65  ally does change
2da0: 20 69 6e 0a 20 20 20 20 20 20 2a 2a 20 74 68 65   in.      ** the
2db0: 20 63 61 73 65 20 77 68 65 72 65 20 74 68 65 20   case where the 
2dc0: 73 6f 75 72 63 65 20 61 6e 64 20 64 65 73 74 69  source and desti
2dd0: 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65 73  nation databases
2de0: 20 68 61 76 65 20 74 68 65 0a 20 20 20 20 20 20   have the.      
2df0: 2a 2a 20 73 61 6d 65 20 73 63 68 65 6d 61 20 76  ** same schema v
2e00: 65 72 73 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f  ersion..      */
2e10: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74  .      sqlite3Bt
2e20: 72 65 65 55 70 64 61 74 65 4d 65 74 61 28 70 2d  reeUpdateMeta(p-
2e30: 3e 70 44 65 73 74 2c 20 31 2c 20 70 2d 3e 69 44  >pDest, 1, p->iD
2e40: 65 73 74 53 63 68 65 6d 61 2b 31 29 3b 0a 20 20  estSchema+1);.  
2e50: 20 20 20 20 69 66 28 20 70 2d 3e 70 44 65 73 74      if( p->pDest
2e60: 44 62 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71  Db ){.        sq
2e70: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
2e80: 61 6c 53 63 68 65 6d 61 28 70 2d 3e 70 44 65 73  alSchema(p->pDes
2e90: 74 44 62 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d  tDb, 0);.      }
2ea0: 0a 0a 20 20 20 20 20 20 2f 2a 20 53 65 74 20 6e  ..      /* Set n
2eb0: 44 65 73 74 54 72 75 6e 63 61 74 65 20 74 6f 20  DestTruncate to 
2ec0: 74 68 65 20 66 69 6e 61 6c 20 6e 75 6d 62 65 72  the final number
2ed0: 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65   of pages in the
2ee0: 20 64 65 73 74 69 6e 61 74 69 6f 6e 0a 20 20 20   destination.   
2ef0: 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 2e 20     ** database. 
2f00: 54 68 65 20 63 6f 6d 70 6c 69 63 61 74 69 6f 6e  The complication
2f10: 20 68 65 72 65 20 69 73 20 74 68 61 74 20 74 68   here is that th
2f20: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 70 61  e destination pa
2f30: 67 65 0a 20 20 20 20 20 20 2a 2a 20 73 69 7a 65  ge.      ** size
2f40: 20 6d 61 79 20 62 65 20 64 69 66 66 65 72 65 6e   may be differen
2f50: 74 20 74 6f 20 74 68 65 20 73 6f 75 72 63 65 20  t to the source 
2f60: 70 61 67 65 20 73 69 7a 65 2e 20 0a 20 20 20 20  page size. .    
2f70: 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49 66    **.      ** If
2f80: 20 74 68 65 20 73 6f 75 72 63 65 20 70 61 67 65   the source page
2f90: 20 73 69 7a 65 20 69 73 20 73 6d 61 6c 6c 65 72   size is smaller
2fa0: 20 74 68 61 6e 20 74 68 65 20 64 65 73 74 69 6e   than the destin
2fb0: 61 74 69 6f 6e 20 70 61 67 65 20 73 69 7a 65 2c  ation page size,
2fc0: 20 0a 20 20 20 20 20 20 2a 2a 20 72 6f 75 6e 64   .      ** round
2fd0: 20 75 70 2e 20 49 6e 20 74 68 69 73 20 63 61 73   up. In this cas
2fe0: 65 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71  e the call to sq
2ff0: 6c 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28  lite3OsTruncate(
3000: 29 20 62 65 6c 6f 77 20 77 69 6c 6c 0a 20 20 20  ) below will.   
3010: 20 20 20 2a 2a 20 66 69 78 20 74 68 65 20 73 69     ** fix the si
3020: 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 20  ze of the file. 
3030: 48 6f 77 65 76 65 72 20 69 74 20 69 73 20 69 6d  However it is im
3040: 70 6f 72 74 61 6e 74 20 74 6f 20 63 61 6c 6c 0a  portant to call.
3050: 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33        ** sqlite3
3060: 50 61 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61  PagerTruncateIma
3070: 67 65 28 29 20 68 65 72 65 20 73 6f 20 74 68 61  ge() here so tha
3080: 74 20 61 6e 79 20 70 61 67 65 73 20 69 6e 20 74  t any pages in t
3090: 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 64 65 73  he .      ** des
30a0: 74 69 6e 61 74 69 6f 6e 20 66 69 6c 65 20 74 68  tination file th
30b0: 61 74 20 6c 69 65 20 62 65 79 6f 6e 64 20 74 68  at lie beyond th
30c0: 65 20 6e 44 65 73 74 54 72 75 6e 63 61 74 65 20  e nDestTruncate 
30d0: 70 61 67 65 20 6d 61 72 6b 20 61 72 65 0a 20 20  page mark are.  
30e0: 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 6c 65      ** journalle
30f0: 64 20 62 79 20 50 61 67 65 72 43 6f 6d 6d 69 74  d by PagerCommit
3100: 50 68 61 73 65 4f 6e 65 28 29 20 62 65 66 6f 72  PhaseOne() befor
3110: 65 20 74 68 65 79 20 61 72 65 20 64 65 73 74 72  e they are destr
3120: 6f 79 65 64 0a 20 20 20 20 20 20 2a 2a 20 62 79  oyed.      ** by
3130: 20 74 68 65 20 66 69 6c 65 20 74 72 75 6e 63 61   the file trunca
3140: 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  tion..      */. 
3150: 20 20 20 20 20 69 66 28 20 6e 53 72 63 50 61 67       if( nSrcPag
3160: 65 73 69 7a 65 3c 6e 44 65 73 74 50 61 67 65 73  esize<nDestPages
3170: 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 69  ize ){.        i
3180: 6e 74 20 72 61 74 69 6f 20 3d 20 6e 44 65 73 74  nt ratio = nDest
3190: 50 61 67 65 73 69 7a 65 2f 6e 53 72 63 50 61 67  Pagesize/nSrcPag
31a0: 65 73 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 6e  esize;.        n
31b0: 44 65 73 74 54 72 75 6e 63 61 74 65 20 3d 20 28  DestTruncate = (
31c0: 6e 53 72 63 50 61 67 65 2b 72 61 74 69 6f 2d 31  nSrcPage+ratio-1
31d0: 29 2f 72 61 74 69 6f 3b 0a 20 20 20 20 20 20 7d  )/ratio;.      }
31e0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 6e 44  else{.        nD
31f0: 65 73 74 54 72 75 6e 63 61 74 65 20 3d 20 6e 53  estTruncate = nS
3200: 72 63 50 61 67 65 20 2a 20 28 6e 53 72 63 50 61  rcPage * (nSrcPa
3210: 67 65 73 69 7a 65 2f 6e 44 65 73 74 50 61 67 65  gesize/nDestPage
3220: 73 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20  size);.      }. 
3230: 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65       sqlite3Page
3240: 72 54 72 75 6e 63 61 74 65 49 6d 61 67 65 28 70  rTruncateImage(p
3250: 44 65 73 74 50 61 67 65 72 2c 20 6e 44 65 73 74  DestPager, nDest
3260: 54 72 75 6e 63 61 74 65 29 3b 0a 0a 20 20 20 20  Truncate);..    
3270: 20 20 69 66 28 20 6e 53 72 63 50 61 67 65 73 69    if( nSrcPagesi
3280: 7a 65 3c 6e 44 65 73 74 50 61 67 65 73 69 7a 65  ze<nDestPagesize
3290: 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49   ){.        /* I
32a0: 66 20 74 68 65 20 73 6f 75 72 63 65 20 70 61 67  f the source pag
32b0: 65 2d 73 69 7a 65 20 69 73 20 73 6d 61 6c 6c 65  e-size is smalle
32c0: 72 20 74 68 61 6e 20 74 68 65 20 64 65 73 74 69  r than the desti
32d0: 6e 61 74 69 6f 6e 20 70 61 67 65 2d 73 69 7a 65  nation page-size
32e0: 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 77 6f  ,.        ** two
32f0: 20 65 78 74 72 61 20 74 68 69 6e 67 73 20 6d 61   extra things ma
3300: 79 20 6e 65 65 64 20 74 6f 20 68 61 70 70 65 6e  y need to happen
3310: 3a 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20  :.        **.   
3320: 20 20 20 20 20 2a 2a 20 20 20 2a 20 54 68 65 20       **   * The 
3330: 64 65 73 74 69 6e 61 74 69 6f 6e 20 6d 61 79 20  destination may 
3340: 6e 65 65 64 20 74 6f 20 62 65 20 74 72 75 6e 63  need to be trunc
3350: 61 74 65 64 2c 20 61 6e 64 0a 20 20 20 20 20 20  ated, and.      
3360: 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20    **.        ** 
3370: 20 20 2a 20 44 61 74 61 20 73 74 6f 72 65 64 20    * Data stored 
3380: 6f 6e 20 74 68 65 20 70 61 67 65 73 20 69 6d 6d  on the pages imm
3390: 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 69  ediately followi
33a0: 6e 67 20 74 68 65 20 0a 20 20 20 20 20 20 20 20  ng the .        
33b0: 2a 2a 20 20 20 20 20 70 65 6e 64 69 6e 67 2d 62  **     pending-b
33c0: 79 74 65 20 70 61 67 65 20 69 6e 20 74 68 65 20  yte page in the 
33d0: 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 20  source database 
33e0: 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 0a 20  may need to be. 
33f0: 20 20 20 20 20 20 20 2a 2a 20 20 20 20 20 63 6f         **     co
3400: 70 69 65 64 20 69 6e 74 6f 20 74 68 65 20 64 65  pied into the de
3410: 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61  stination databa
3420: 73 65 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20  se..        */. 
3430: 20 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 28         iSize = (
3440: 69 36 34 29 6e 53 72 63 50 61 67 65 73 69 7a 65  i64)nSrcPagesize
3450: 20 2a 20 28 69 36 34 29 6e 53 72 63 50 61 67 65   * (i64)nSrcPage
3460: 3b 0a 20 20 20 20 20 20 20 20 70 46 69 6c 65 20  ;.        pFile 
3470: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69  = sqlite3PagerFi
3480: 6c 65 28 70 44 65 73 74 50 61 67 65 72 29 3b 0a  le(pDestPager);.
3490: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
34a0: 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 20  pFile );.       
34b0: 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d   if( SQLITE_OK==
34c0: 28 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67  (rc = sqlite3Pag
34d0: 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65  erCommitPhaseOne
34e0: 28 70 44 65 73 74 50 61 67 65 72 2c 20 30 2c 20  (pDestPager, 0, 
34f0: 31 29 29 0a 20 20 20 20 20 20 20 20 20 26 26 20  1)).         && 
3500: 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d  SQLITE_OK==(rc =
3510: 20 73 71 6c 69 74 65 33 4f 73 54 72 75 6e 63 61   sqlite3OsTrunca
3520: 74 65 28 70 46 69 6c 65 2c 20 69 53 69 7a 65 29  te(pFile, iSize)
3530: 29 0a 20 20 20 20 20 20 20 20 20 26 26 20 53 51  ).         && SQ
3540: 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 73  LITE_OK==(rc = s
3550: 71 6c 69 74 65 33 50 61 67 65 72 53 79 6e 63 28  qlite3PagerSync(
3560: 70 44 65 73 74 50 61 67 65 72 29 29 0a 20 20 20  pDestPager)).   
3570: 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20       ){.        
3580: 20 20 69 36 34 20 69 4f 66 66 3b 0a 20 20 20 20    i64 iOff;.    
3590: 20 20 20 20 20 20 69 36 34 20 69 45 6e 64 20 3d        i64 iEnd =
35a0: 20 4d 49 4e 28 50 45 4e 44 49 4e 47 5f 42 59 54   MIN(PENDING_BYT
35b0: 45 20 2b 20 6e 44 65 73 74 50 61 67 65 73 69 7a  E + nDestPagesiz
35c0: 65 2c 20 69 53 69 7a 65 29 3b 0a 20 20 20 20 20  e, iSize);.     
35d0: 20 20 20 20 20 66 6f 72 28 0a 20 20 20 20 20 20       for(.      
35e0: 20 20 20 20 20 20 69 4f 66 66 3d 50 45 4e 44 49        iOff=PENDI
35f0: 4e 47 5f 42 59 54 45 2b 6e 53 72 63 50 61 67 65  NG_BYTE+nSrcPage
3600: 73 69 7a 65 3b 20 0a 20 20 20 20 20 20 20 20 20  size; .         
3610: 20 20 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b     rc==SQLITE_OK
3620: 20 26 26 20 69 4f 66 66 3c 69 45 6e 64 3b 20 0a   && iOff<iEnd; .
3630: 20 20 20 20 20 20 20 20 20 20 20 20 69 4f 66 66              iOff
3640: 2b 3d 6e 53 72 63 50 61 67 65 73 69 7a 65 0a 20  +=nSrcPagesize. 
3650: 20 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20           ){.    
3660: 20 20 20 20 20 20 20 20 50 67 48 64 72 20 2a 70          PgHdr *p
3670: 53 72 63 50 67 20 3d 20 30 3b 0a 20 20 20 20 20  SrcPg = 0;.     
3680: 20 20 20 20 20 20 20 63 6f 6e 73 74 20 50 67 6e         const Pgn
3690: 6f 20 69 53 72 63 50 67 20 3d 20 28 50 67 6e 6f  o iSrcPg = (Pgno
36a0: 29 28 28 69 4f 66 66 2f 6e 53 72 63 50 61 67 65  )((iOff/nSrcPage
36b0: 73 69 7a 65 29 2b 31 29 3b 0a 20 20 20 20 20 20  size)+1);.      
36c0: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
36d0: 65 33 50 61 67 65 72 47 65 74 28 70 53 72 63 50  e3PagerGet(pSrcP
36e0: 61 67 65 72 2c 20 69 53 72 63 50 67 2c 20 26 70  ager, iSrcPg, &p
36f0: 53 72 63 50 67 29 3b 0a 20 20 20 20 20 20 20 20  SrcPg);.        
3700: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
3710: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20  TE_OK ){.       
3720: 20 20 20 20 20 20 20 75 38 20 2a 7a 44 61 74 61         u8 *zData
3730: 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 47   = sqlite3PagerG
3740: 65 74 44 61 74 61 28 70 53 72 63 50 67 29 3b 0a  etData(pSrcPg);.
3750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 63                rc
3760: 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74   = sqlite3OsWrit
3770: 65 28 70 46 69 6c 65 2c 20 7a 44 61 74 61 2c 20  e(pFile, zData, 
3780: 6e 53 72 63 50 61 67 65 73 69 7a 65 2c 20 69 4f  nSrcPagesize, iO
3790: 66 66 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  ff);.           
37a0: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73   }.            s
37b0: 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66  qlite3PagerUnref
37c0: 28 70 53 72 63 50 67 29 3b 0a 20 20 20 20 20 20  (pSrcPg);.      
37d0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a      }.        }.
37e0: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
37f0: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
3800: 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73  3PagerCommitPhas
3810: 65 4f 6e 65 28 70 44 65 73 74 50 61 67 65 72 2c  eOne(pDestPager,
3820: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a   0, 0);.      }.
3830: 20 20 0a 20 20 20 20 20 20 2f 2a 20 46 69 6e 69    .      /* Fini
3840: 73 68 20 63 6f 6d 6d 69 74 74 69 6e 67 20 74 68  sh committing th
3850: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 6f  e transaction to
3860: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
3870: 20 64 61 74 61 62 61 73 65 2e 20 2a 2f 0a 20 20   database. */.  
3880: 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f      if( SQLITE_O
3890: 4b 3d 3d 72 63 0a 20 20 20 20 20 20 20 26 26 20  K==rc.       && 
38a0: 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d  SQLITE_OK==(rc =
38b0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
38c0: 6d 69 74 50 68 61 73 65 54 77 6f 28 70 2d 3e 70  mitPhaseTwo(p->p
38d0: 44 65 73 74 29 29 0a 20 20 20 20 20 20 29 7b 0a  Dest)).      ){.
38e0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c          rc = SQL
38f0: 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 20 20  ITE_DONE;.      
3900: 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f  }.    }.  .    /
3910: 2a 20 49 66 20 62 43 6c 6f 73 65 54 72 61 6e 73  * If bCloseTrans
3920: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74   is true, then t
3930: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6f 70 65  his function ope
3940: 6e 65 64 20 61 20 72 65 61 64 20 74 72 61 6e 73  ned a read trans
3950: 61 63 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 6f 6e  action.    ** on
3960: 20 74 68 65 20 73 6f 75 72 63 65 20 64 61 74 61   the source data
3970: 62 61 73 65 2e 20 43 6c 6f 73 65 20 74 68 65 20  base. Close the 
3980: 72 65 61 64 20 74 72 61 6e 73 61 63 74 69 6f 6e  read transaction
3990: 20 68 65 72 65 2e 20 54 68 65 72 65 20 69 73 0a   here. There is.
39a0: 20 20 20 20 2a 2a 20 6e 6f 20 6e 65 65 64 20 74      ** no need t
39b0: 6f 20 63 68 65 63 6b 20 74 68 65 20 72 65 74 75  o check the retu
39c0: 72 6e 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65  rn values of the
39d0: 20 62 74 72 65 65 20 6d 65 74 68 6f 64 73 20 68   btree methods h
39e0: 65 72 65 2c 20 61 73 0a 20 20 20 20 2a 2a 20 22  ere, as.    ** "
39f0: 63 6f 6d 6d 69 74 74 69 6e 67 22 20 61 20 72 65  committing" a re
3a00: 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74  ad-only transact
3a10: 69 6f 6e 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e  ion cannot fail.
3a20: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20  .    */.    if( 
3a30: 62 43 6c 6f 73 65 54 72 61 6e 73 20 29 7b 0a 20  bCloseTrans ){. 
3a40: 20 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 69       TESTONLY( i
3a50: 6e 74 20 72 63 32 20 29 3b 0a 20 20 20 20 20 20  nt rc2 );.      
3a60: 54 45 53 54 4f 4e 4c 59 28 20 72 63 32 20 20 3d  TESTONLY( rc2  =
3a70: 20 29 20 73 71 6c 69 74 65 33 42 74 72 65 65 43   ) sqlite3BtreeC
3a80: 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 2d  ommitPhaseOne(p-
3a90: 3e 70 53 72 63 2c 20 30 29 3b 0a 20 20 20 20 20  >pSrc, 0);.     
3aa0: 20 54 45 53 54 4f 4e 4c 59 28 20 72 63 32 20 7c   TESTONLY( rc2 |
3ab0: 3d 20 29 20 73 71 6c 69 74 65 33 42 74 72 65 65  = ) sqlite3Btree
3ac0: 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70  CommitPhaseTwo(p
3ad0: 2d 3e 70 53 72 63 29 3b 0a 20 20 20 20 20 20 61  ->pSrc);.      a
3ae0: 73 73 65 72 74 28 20 72 63 32 3d 3d 53 51 4c 49  ssert( rc2==SQLI
3af0: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 7d 0a 20  TE_OK );.    }. 
3b00: 20 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51   .    if( rc!=SQ
3b10: 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 26 26 20 72  LITE_LOCKED && r
3b20: 63 21 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29  c!=SQLITE_BUSY )
3b30: 7b 0a 20 20 20 20 20 20 70 2d 3e 72 63 20 3d 20  {.      p->rc = 
3b40: 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20  rc;.    }.  }.  
3b50: 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62 20 29  if( p->pDestDb )
3b60: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  {.    sqlite3_mu
3b70: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 70 44 65  tex_leave(p->pDe
3b80: 73 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  stDb->mutex);.  
3b90: 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  }.  sqlite3Btree
3ba0: 4c 65 61 76 65 28 70 2d 3e 70 53 72 63 29 3b 0a  Leave(p->pSrc);.
3bb0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
3bc0: 6c 65 61 76 65 28 70 2d 3e 70 53 72 63 44 62 2d  leave(p->pSrcDb-
3bd0: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72  >mutex);.  retur
3be0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
3bf0: 65 6c 65 61 73 65 20 61 6c 6c 20 72 65 73 6f 75  elease all resou
3c00: 72 63 65 73 20 61 73 73 6f 63 69 61 74 65 64 20  rces associated 
3c10: 77 69 74 68 20 61 6e 20 73 71 6c 69 74 65 33 5f  with an sqlite3_
3c20: 62 61 63 6b 75 70 2a 20 68 61 6e 64 6c 65 2e 0a  backup* handle..
3c30: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  */.int sqlite3_b
3c40: 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 73 71 6c  ackup_finish(sql
3c50: 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 29 7b  ite3_backup *p){
3c60: 0a 20 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  .  sqlite3_backu
3c70: 70 20 2a 2a 70 70 3b 20 20 20 20 20 20 20 20 20  p **pp;         
3c80: 20 20 20 20 20 20 20 20 2f 2a 20 50 74 72 20 74          /* Ptr t
3c90: 6f 20 68 65 61 64 20 6f 66 20 70 61 67 65 72 73  o head of pagers
3ca0: 20 62 61 63 6b 75 70 20 6c 69 73 74 20 2a 2f 0a   backup list */.
3cb0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
3cc0: 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20  *mutex;         
3cd0: 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 20         /* Mutex 
3ce0: 74 6f 20 70 72 6f 74 65 63 74 20 73 6f 75 72 63  to protect sourc
3cf0: 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20  e database */.  
3d00: 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20  int rc;         
3d10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3d20: 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f       /* Value to
3d30: 20 72 65 74 75 72 6e 20 2a 2f 0a 0a 20 20 2f 2a   return */..  /*
3d40: 20 45 6e 74 65 72 20 74 68 65 20 6d 75 74 65 78   Enter the mutex
3d50: 65 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  es */.  sqlite3_
3d60: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 70  mutex_enter(p->p
3d70: 53 72 63 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  SrcDb->mutex);. 
3d80: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74   sqlite3BtreeEnt
3d90: 65 72 28 70 2d 3e 70 53 72 63 29 3b 0a 20 20 6d  er(p->pSrc);.  m
3da0: 75 74 65 78 20 3d 20 70 2d 3e 70 53 72 63 44 62  utex = p->pSrcDb
3db0: 2d 3e 6d 75 74 65 78 3b 0a 20 20 69 66 28 20 70  ->mutex;.  if( p
3dc0: 2d 3e 70 44 65 73 74 44 62 20 29 7b 0a 20 20 20  ->pDestDb ){.   
3dd0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
3de0: 6e 74 65 72 28 70 2d 3e 70 44 65 73 74 44 62 2d  nter(p->pDestDb-
3df0: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 0a 20 20  >mutex);.  }..  
3e00: 2f 2a 20 44 65 74 61 63 68 20 74 68 69 73 20 62  /* Detach this b
3e10: 61 63 6b 75 70 20 66 72 6f 6d 20 74 68 65 20 73  ackup from the s
3e20: 6f 75 72 63 65 20 70 61 67 65 72 2e 20 2a 2f 0a  ource pager. */.
3e30: 20 20 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62    if( p->pDestDb
3e40: 20 29 7b 0a 20 20 20 20 70 70 20 3d 20 73 71 6c   ){.    pp = sql
3e50: 69 74 65 33 50 61 67 65 72 42 61 63 6b 75 70 50  ite3PagerBackupP
3e60: 74 72 28 73 71 6c 69 74 65 33 42 74 72 65 65 50  tr(sqlite3BtreeP
3e70: 61 67 65 72 28 70 2d 3e 70 53 72 63 29 29 3b 0a  ager(p->pSrc));.
3e80: 20 20 20 20 77 68 69 6c 65 28 20 2a 70 70 21 3d      while( *pp!=
3e90: 70 20 29 7b 0a 20 20 20 20 20 20 70 70 20 3d 20  p ){.      pp = 
3ea0: 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a 20  &(*pp)->pNext;. 
3eb0: 20 20 20 7d 0a 20 20 20 20 2a 70 70 20 3d 20 70     }.    *pp = p
3ec0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 70 2d 3e  ->pNext;.    p->
3ed0: 70 53 72 63 2d 3e 6e 42 61 63 6b 75 70 2d 2d 3b  pSrc->nBackup--;
3ee0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 61 20  .  }..  /* If a 
3ef0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73  transaction is s
3f00: 74 69 6c 6c 20 6f 70 65 6e 20 6f 6e 20 74 68 65  till open on the
3f10: 20 42 74 72 65 65 2c 20 72 6f 6c 6c 20 69 74 20   Btree, roll it 
3f20: 62 61 63 6b 2e 20 2a 2f 0a 20 20 73 71 6c 69 74  back. */.  sqlit
3f30: 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28  e3BtreeRollback(
3f40: 70 2d 3e 70 44 65 73 74 29 3b 0a 0a 20 20 2f 2a  p->pDest);..  /*
3f50: 20 53 65 74 20 74 68 65 20 65 72 72 6f 72 20 63   Set the error c
3f60: 6f 64 65 20 6f 66 20 74 68 65 20 64 65 73 74 69  ode of the desti
3f70: 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65 20  nation database 
3f80: 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 72 63 20  handle. */.  rc 
3f90: 3d 20 28 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  = (p->rc==SQLITE
3fa0: 5f 44 4f 4e 45 29 20 3f 20 53 51 4c 49 54 45 5f  _DONE) ? SQLITE_
3fb0: 4f 4b 20 3a 20 70 2d 3e 72 63 3b 0a 20 20 73 71  OK : p->rc;.  sq
3fc0: 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 70 44  lite3Error(p->pD
3fd0: 65 73 74 44 62 2c 20 72 63 2c 20 30 29 3b 0a 0a  estDb, rc, 0);..
3fe0: 20 20 2f 2a 20 45 78 69 74 20 74 68 65 20 6d 75    /* Exit the mu
3ff0: 74 65 78 65 73 20 61 6e 64 20 66 72 65 65 20 74  texes and free t
4000: 68 65 20 62 61 63 6b 75 70 20 63 6f 6e 74 65 78  he backup contex
4010: 74 20 73 74 72 75 63 74 75 72 65 2e 20 2a 2f 0a  t structure. */.
4020: 20 20 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62    if( p->pDestDb
4030: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
4040: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 70  mutex_leave(p->p
4050: 44 65 73 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a  DestDb->mutex);.
4060: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72    }.  sqlite3Btr
4070: 65 65 4c 65 61 76 65 28 70 2d 3e 70 53 72 63 29  eeLeave(p->pSrc)
4080: 3b 0a 20 20 69 66 28 20 70 2d 3e 70 44 65 73 74  ;.  if( p->pDest
4090: 44 62 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  Db ){.    sqlite
40a0: 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 20  3_free(p);.  }. 
40b0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
40c0: 65 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 72  eave(mutex);.  r
40d0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
40e0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
40f0: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 73 74  mber of pages st
4100: 69 6c 6c 20 74 6f 20 62 65 20 62 61 63 6b 65 64  ill to be backed
4110: 20 75 70 20 61 73 20 6f 66 20 74 68 65 20 6d 6f   up as of the mo
4120: 73 74 20 72 65 63 65 6e 74 0a 2a 2a 20 63 61 6c  st recent.** cal
4130: 6c 20 74 6f 20 73 71 6c 69 74 65 33 5f 62 61 63  l to sqlite3_bac
4140: 6b 75 70 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 69  kup_step()..*/.i
4150: 6e 74 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  nt sqlite3_backu
4160: 70 5f 72 65 6d 61 69 6e 69 6e 67 28 73 71 6c 69  p_remaining(sqli
4170: 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 29 7b 0a  te3_backup *p){.
4180: 20 20 72 65 74 75 72 6e 20 70 2d 3e 6e 52 65 6d    return p->nRem
4190: 61 69 6e 69 6e 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  aining;.}../*.**
41a0: 20 52 65 74 75 72 6e 20 74 68 65 20 74 6f 74 61   Return the tota
41b0: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  l number of page
41c0: 73 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20  s in the source 
41d0: 64 61 74 61 62 61 73 65 20 61 73 20 6f 66 20 74  database as of t
41e0: 68 65 20 6d 6f 73 74 20 0a 2a 2a 20 72 65 63 65  he most .** rece
41f0: 6e 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74  nt call to sqlit
4200: 65 33 5f 62 61 63 6b 75 70 5f 73 74 65 70 28 29  e3_backup_step()
4210: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
4220: 5f 62 61 63 6b 75 70 5f 70 61 67 65 63 6f 75 6e  _backup_pagecoun
4230: 74 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70  t(sqlite3_backup
4240: 20 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70   *p){.  return p
4250: 2d 3e 6e 50 61 67 65 63 6f 75 6e 74 3b 0a 7d 0a  ->nPagecount;.}.
4260: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
4270: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61  tion is called a
4280: 66 74 65 72 20 74 68 65 20 63 6f 6e 74 65 6e 74  fter the content
4290: 73 20 6f 66 20 70 61 67 65 20 69 50 61 67 65 20  s of page iPage 
42a0: 6f 66 20 74 68 65 0a 2a 2a 20 73 6f 75 72 63 65  of the.** source
42b0: 20 64 61 74 61 62 61 73 65 20 68 61 76 65 20 62   database have b
42c0: 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e 20 49 66  een modified. If
42d0: 20 70 61 67 65 20 69 50 61 67 65 20 68 61 73 20   page iPage has 
42e0: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 0a 2a 2a  already been .**
42f0: 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 74 68 65   copied into the
4300: 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74   destination dat
4310: 61 62 61 73 65 2c 20 74 68 65 6e 20 74 68 65 20  abase, then the 
4320: 64 61 74 61 20 77 72 69 74 74 65 6e 20 74 6f 20  data written to 
4330: 74 68 65 0a 2a 2a 20 64 65 73 74 69 6e 61 74 69  the.** destinati
4340: 6f 6e 20 69 73 20 6e 6f 77 20 69 6e 76 61 6c 69  on is now invali
4350: 64 61 74 65 64 2e 20 54 68 65 20 64 65 73 74 69  dated. The desti
4360: 6e 61 74 69 6f 6e 20 63 6f 70 79 20 6f 66 20 69  nation copy of i
4370: 50 61 67 65 20 6e 65 65 64 73 0a 2a 2a 20 74 6f  Page needs.** to
4380: 20 62 65 20 75 70 64 61 74 65 64 20 77 69 74 68   be updated with
4390: 20 74 68 65 20 6e 65 77 20 64 61 74 61 20 62 65   the new data be
43a0: 66 6f 72 65 20 74 68 65 20 62 61 63 6b 75 70 20  fore the backup 
43b0: 6f 70 65 72 61 74 69 6f 6e 20 69 73 0a 2a 2a 20  operation is.** 
43c0: 63 6f 6d 70 6c 65 74 65 2e 0a 2a 2a 0a 2a 2a 20  complete..**.** 
43d0: 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68  It is assumed th
43e0: 61 74 20 74 68 65 20 6d 75 74 65 78 20 61 73 73  at the mutex ass
43f0: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65  ociated with the
4400: 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74   BtShared object
4410: 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  .** correspondin
4420: 67 20 74 6f 20 74 68 65 20 73 6f 75 72 63 65 20  g to the source 
4430: 64 61 74 61 62 61 73 65 20 69 73 20 68 65 6c 64  database is held
4440: 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74   when this funct
4450: 69 6f 6e 20 69 73 0a 2a 2a 20 63 61 6c 6c 65 64  ion is.** called
4460: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
4470: 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 73 71  3BackupUpdate(sq
4480: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 42  lite3_backup *pB
4490: 61 63 6b 75 70 2c 20 50 67 6e 6f 20 69 50 61 67  ackup, Pgno iPag
44a0: 65 2c 20 63 6f 6e 73 74 20 75 38 20 2a 61 44 61  e, const u8 *aDa
44b0: 74 61 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 62  ta){.  sqlite3_b
44c0: 61 63 6b 75 70 20 2a 70 3b 20 20 20 20 20 20 20  ackup *p;       
44d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
44e0: 74 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65  terator variable
44f0: 20 2a 2f 0a 20 20 66 6f 72 28 70 3d 70 42 61 63   */.  for(p=pBac
4500: 6b 75 70 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  kup; p; p=p->pNe
4510: 78 74 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28  xt){.    assert(
4520: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
4530: 65 6c 64 28 70 2d 3e 70 53 72 63 2d 3e 70 42 74  eld(p->pSrc->pBt
4540: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20  ->mutex) );.    
4550: 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54  if( p->rc==SQLIT
4560: 45 5f 4f 4b 20 26 26 20 69 50 61 67 65 3c 70 2d  E_OK && iPage<p-
4570: 3e 69 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20  >iNext ){.      
4580: 2f 2a 20 54 68 65 20 62 61 63 6b 75 70 20 70 72  /* The backup pr
4590: 6f 63 65 73 73 20 70 20 68 61 73 20 61 6c 72 65  ocess p has alre
45a0: 61 64 79 20 63 6f 70 69 65 64 20 70 61 67 65 20  ady copied page 
45b0: 69 50 61 67 65 2e 20 42 75 74 20 6e 6f 77 20 69  iPage. But now i
45c0: 74 0a 20 20 20 20 20 20 2a 2a 20 68 61 73 20 62  t.      ** has b
45d0: 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 62 79 20  een modified by 
45e0: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e  a transaction on
45f0: 20 74 68 65 20 73 6f 75 72 63 65 20 70 61 67 65   the source page
4600: 72 2e 20 43 6f 70 79 0a 20 20 20 20 20 20 2a 2a  r. Copy.      **
4610: 20 74 68 65 20 6e 65 77 20 64 61 74 61 20 69 6e   the new data in
4620: 74 6f 20 74 68 65 20 62 61 63 6b 75 70 2e 0a 20  to the backup.. 
4630: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e       */.      in
4640: 74 20 72 63 20 3d 20 62 61 63 6b 75 70 4f 6e 65  t rc = backupOne
4650: 50 61 67 65 28 70 2c 20 69 50 61 67 65 2c 20 61  Page(p, iPage, a
4660: 44 61 74 61 29 3b 0a 20 20 20 20 20 20 69 66 28  Data);.      if(
4670: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
4680: 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 72 63 20  {.        p->rc 
4690: 3d 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20  = rc;.      }.  
46a0: 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a    }.  }.}../*.**
46b0: 20 52 65 73 74 61 72 74 20 74 68 65 20 62 61 63   Restart the bac
46c0: 6b 75 70 20 70 72 6f 63 65 73 73 2e 20 54 68 69  kup process. Thi
46d0: 73 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e  s is called when
46e0: 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72   the pager layer
46f0: 0a 2a 2a 20 64 65 74 65 63 74 73 20 74 68 61 74  .** detects that
4700: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
4710: 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20  s been modified 
4720: 62 79 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 64  by an external d
4730: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65  atabase.** conne
4740: 63 74 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 63  ction. In this c
4750: 61 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20  ase there is no 
4760: 77 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 77  way of knowing w
4770: 68 69 63 68 20 6f 66 20 74 68 65 0a 2a 2a 20 70  hich of the.** p
4780: 61 67 65 73 20 74 68 61 74 20 68 61 76 65 20 62  ages that have b
4790: 65 65 6e 20 63 6f 70 69 65 64 20 69 6e 74 6f 20  een copied into 
47a0: 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20  the destination 
47b0: 64 61 74 61 62 61 73 65 20 61 72 65 20 73 74 69  database are sti
47c0: 6c 6c 20 0a 2a 2a 20 76 61 6c 69 64 20 61 6e 64  ll .** valid and
47d0: 20 77 68 69 63 68 20 61 72 65 20 6e 6f 74 2c 20   which are not, 
47e0: 73 6f 20 74 68 65 20 65 6e 74 69 72 65 20 70 72  so the entire pr
47f0: 6f 63 65 73 73 20 6e 65 65 64 73 20 74 6f 20 62  ocess needs to b
4800: 65 20 72 65 73 74 61 72 74 65 64 2e 0a 2a 2a 0a  e restarted..**.
4810: 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64  ** It is assumed
4820: 20 74 68 61 74 20 74 68 65 20 6d 75 74 65 78 20   that the mutex 
4830: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
4840: 74 68 65 20 42 74 53 68 61 72 65 64 20 6f 62 6a  the BtShared obj
4850: 65 63 74 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e  ect.** correspon
4860: 64 69 6e 67 20 74 6f 20 74 68 65 20 73 6f 75 72  ding to the sour
4870: 63 65 20 64 61 74 61 62 61 73 65 20 69 73 20 68  ce database is h
4880: 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66 75  eld when this fu
4890: 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63 61 6c  nction is.** cal
48a0: 6c 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  led..*/.void sql
48b0: 69 74 65 33 42 61 63 6b 75 70 52 65 73 74 61 72  ite3BackupRestar
48c0: 74 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70  t(sqlite3_backup
48d0: 20 2a 70 42 61 63 6b 75 70 29 7b 0a 20 20 73 71   *pBackup){.  sq
48e0: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 3b  lite3_backup *p;
48f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4900: 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76     /* Iterator v
4910: 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 66 6f 72  ariable */.  for
4920: 28 70 3d 70 42 61 63 6b 75 70 3b 20 70 3b 20 70  (p=pBackup; p; p
4930: 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20  =p->pNext){.    
4940: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
4950: 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 53  mutex_held(p->pS
4960: 72 63 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20  rc->pBt->mutex) 
4970: 29 3b 0a 20 20 20 20 70 2d 3e 69 4e 65 78 74 20  );.    p->iNext 
4980: 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e  = 1;.  }.}..#ifn
4990: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
49a0: 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 43 6f 70  VACUUM./*.** Cop
49b0: 79 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 63  y the complete c
49c0: 6f 6e 74 65 6e 74 20 6f 66 20 70 42 74 46 72 6f  ontent of pBtFro
49d0: 6d 20 69 6e 74 6f 20 70 42 74 54 6f 2e 20 20 41  m into pBtTo.  A
49e0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20   transaction.** 
49f0: 6d 75 73 74 20 62 65 20 61 63 74 69 76 65 20 66  must be active f
4a00: 6f 72 20 62 6f 74 68 20 66 69 6c 65 73 2e 0a 2a  or both files..*
4a10: 2a 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20 6f 66  *.** The size of
4a20: 20 66 69 6c 65 20 70 54 6f 20 6d 61 79 20 62 65   file pTo may be
4a30: 20 72 65 64 75 63 65 64 20 62 79 20 74 68 69 73   reduced by this
4a40: 20 6f 70 65 72 61 74 69 6f 6e 2e 20 49 66 20 61   operation. If a
4a50: 6e 79 74 68 69 6e 67 20 0a 2a 2a 20 67 6f 65 73  nything .** goes
4a60: 20 77 72 6f 6e 67 2c 20 74 68 65 20 74 72 61 6e   wrong, the tran
4a70: 73 61 63 74 69 6f 6e 20 6f 6e 20 70 54 6f 20 69  saction on pTo i
4a80: 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 49  s rolled back. I
4a90: 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68  f successful, th
4aa0: 65 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f  e .** transactio
4ab0: 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 62  n is committed b
4ac0: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e  efore returning.
4ad0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42  .*/.int sqlite3B
4ae0: 74 72 65 65 43 6f 70 79 46 69 6c 65 28 42 74 72  treeCopyFile(Btr
4af0: 65 65 20 2a 70 54 6f 2c 20 42 74 72 65 65 20 2a  ee *pTo, Btree *
4b00: 70 46 72 6f 6d 29 7b 0a 20 20 69 6e 74 20 72 63  pFrom){.  int rc
4b10: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 62 61 63 6b  ;.  sqlite3_back
4b20: 75 70 20 62 3b 0a 20 20 73 71 6c 69 74 65 33 42  up b;.  sqlite3B
4b30: 74 72 65 65 45 6e 74 65 72 28 70 54 6f 29 3b 0a  treeEnter(pTo);.
4b40: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e    sqlite3BtreeEn
4b50: 74 65 72 28 70 46 72 6f 6d 29 3b 0a 0a 20 20 2f  ter(pFrom);..  /
4b60: 2a 20 53 65 74 20 75 70 20 61 6e 20 73 71 6c 69  * Set up an sqli
4b70: 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63  te3_backup objec
4b80: 74 2e 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  t. sqlite3_backu
4b90: 70 2e 70 44 65 73 74 44 62 20 6d 75 73 74 20 62  p.pDestDb must b
4ba0: 65 20 73 65 74 0a 20 20 2a 2a 20 74 6f 20 30 2e  e set.  ** to 0.
4bb0: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 79   This is used by
4bc0: 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74   the implementat
4bd0: 69 6f 6e 73 20 6f 66 20 73 71 6c 69 74 65 33 5f  ions of sqlite3_
4be0: 62 61 63 6b 75 70 5f 73 74 65 70 28 29 0a 20 20  backup_step().  
4bf0: 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 62  ** and sqlite3_b
4c00: 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 29 20 74  ackup_finish() t
4c10: 6f 20 64 65 74 65 63 74 20 74 68 61 74 20 74 68  o detect that th
4c20: 65 79 20 61 72 65 20 62 65 69 6e 67 20 63 61 6c  ey are being cal
4c30: 6c 65 64 0a 20 20 2a 2a 20 66 72 6f 6d 20 74 68  led.  ** from th
4c40: 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 6e 6f 74  is function, not
4c50: 20 64 69 72 65 63 74 6c 79 20 62 79 20 74 68 65   directly by the
4c60: 20 75 73 65 72 2e 0a 20 20 2a 2f 0a 20 20 6d 65   user..  */.  me
4c70: 6d 73 65 74 28 26 62 2c 20 30 2c 20 73 69 7a 65  mset(&b, 0, size
4c80: 6f 66 28 62 29 29 3b 0a 20 20 62 2e 70 53 72 63  of(b));.  b.pSrc
4c90: 44 62 20 3d 20 70 46 72 6f 6d 2d 3e 64 62 3b 0a  Db = pFrom->db;.
4ca0: 20 20 62 2e 70 53 72 63 20 3d 20 70 46 72 6f 6d    b.pSrc = pFrom
4cb0: 3b 0a 20 20 62 2e 70 44 65 73 74 20 3d 20 70 54  ;.  b.pDest = pT
4cc0: 6f 3b 0a 20 20 62 2e 69 4e 65 78 74 20 3d 20 31  o;.  b.iNext = 1
4cd0: 3b 0a 0a 20 20 2f 2a 20 30 78 37 46 46 46 46 46  ;..  /* 0x7FFFFF
4ce0: 46 46 20 69 73 20 74 68 65 20 68 61 72 64 20 6c  FF is the hard l
4cf0: 69 6d 69 74 20 66 6f 72 20 74 68 65 20 6e 75 6d  imit for the num
4d00: 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20  ber of pages in 
4d10: 61 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20  a database.  ** 
4d20: 66 69 6c 65 2e 20 42 79 20 70 61 73 73 69 6e 67  file. By passing
4d30: 20 74 68 69 73 20 61 73 20 74 68 65 20 6e 75 6d   this as the num
4d40: 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20  ber of pages to 
4d50: 63 6f 70 79 20 74 6f 0a 20 20 2a 2a 20 73 71 6c  copy to.  ** sql
4d60: 69 74 65 33 5f 62 61 63 6b 75 70 5f 73 74 65 70  ite3_backup_step
4d70: 28 29 2c 20 77 65 20 63 61 6e 20 67 75 61 72 61  (), we can guara
4d80: 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 63 6f  ntee that the co
4d90: 70 79 20 66 69 6e 69 73 68 65 73 20 0a 20 20 2a  py finishes .  *
4da0: 2a 20 77 69 74 68 69 6e 20 61 20 73 69 6e 67 6c  * within a singl
4db0: 65 20 63 61 6c 6c 20 28 75 6e 6c 65 73 73 20 61  e call (unless a
4dc0: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 29 2e  n error occurs).
4dd0: 20 54 68 65 20 61 73 73 65 72 74 28 29 20 73 74   The assert() st
4de0: 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 63 68 65  atement.  ** che
4df0: 63 6b 73 20 74 68 69 73 20 61 73 73 75 6d 70 74  cks this assumpt
4e00: 69 6f 6e 20 2d 20 28 70 2d 3e 72 63 29 20 73 68  ion - (p->rc) sh
4e10: 6f 75 6c 64 20 62 65 20 73 65 74 20 74 6f 20 65  ould be set to e
4e20: 69 74 68 65 72 20 53 51 4c 49 54 45 5f 44 4f 4e  ither SQLITE_DON
4e30: 45 20 0a 20 20 2a 2a 20 6f 72 20 61 6e 20 65 72  E .  ** or an er
4e40: 72 6f 72 20 63 6f 64 65 2e 0a 20 20 2a 2f 0a 20  ror code..  */. 
4e50: 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f   sqlite3_backup_
4e60: 73 74 65 70 28 26 62 2c 20 30 78 37 46 46 46 46  step(&b, 0x7FFFF
4e70: 46 46 46 29 3b 0a 20 20 61 73 73 65 72 74 28 20  FFF);.  assert( 
4e80: 62 2e 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  b.rc!=SQLITE_OK 
4e90: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  );.  rc = sqlite
4ea0: 33 5f 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28  3_backup_finish(
4eb0: 26 62 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53  &b);.  if( rc==S
4ec0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4ed0: 70 54 6f 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69  pTo->pBt->pageSi
4ee0: 7a 65 46 69 78 65 64 20 3d 20 30 3b 0a 20 20 7d  zeFixed = 0;.  }
4ef0: 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  ..  sqlite3Btree
4f00: 4c 65 61 76 65 28 70 46 72 6f 6d 29 3b 0a 20 20  Leave(pFrom);.  
4f10: 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76  sqlite3BtreeLeav
4f20: 65 28 70 54 6f 29 3b 0a 20 20 72 65 74 75 72 6e  e(pTo);.  return
4f30: 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a   rc;.}.#endif /*
4f40: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43   SQLITE_OMIT_VAC
4f50: 55 55 4d 20 2a 2f 0a                             UUM */.