/ Hex Artifact Content
Login

Artifact 78d3cecfbe28230a3a9a1793e2ead609f469be43e8f486ca996006be551857ab:


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 2f 0a 23 69 6e 63 6c 75 64  ures..*/.#includ
01f0: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
0200: 23 69 6e 63 6c 75 64 65 20 22 62 74 72 65 65 49  #include "btreeI
0210: 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 53 74 72  nt.h"../*.** Str
0220: 75 63 74 75 72 65 20 61 6c 6c 6f 63 61 74 65 64  ucture allocated
0230: 20 66 6f 72 20 65 61 63 68 20 62 61 63 6b 75 70   for each backup
0240: 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 2a 2f 0a 73   operation..*/.s
0250: 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 62 61  truct sqlite3_ba
0260: 63 6b 75 70 20 7b 0a 20 20 73 71 6c 69 74 65 33  ckup {.  sqlite3
0270: 2a 20 70 44 65 73 74 44 62 3b 20 20 20 20 20 20  * pDestDb;      
0280: 20 20 2f 2a 20 44 65 73 74 69 6e 61 74 69 6f 6e    /* Destination
0290: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
02a0: 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 44 65   */.  Btree *pDe
02b0: 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  st;            /
02c0: 2a 20 44 65 73 74 69 6e 61 74 69 6f 6e 20 62 2d  * Destination b-
02d0: 74 72 65 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75  tree file */.  u
02e0: 33 32 20 69 44 65 73 74 53 63 68 65 6d 61 3b 20  32 iDestSchema; 
02f0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 67 69          /* Origi
0300: 6e 61 6c 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69  nal schema cooki
0310: 65 20 69 6e 20 64 65 73 74 69 6e 61 74 69 6f 6e  e in destination
0320: 20 2a 2f 0a 20 20 69 6e 74 20 62 44 65 73 74 4c   */.  int bDestL
0330: 6f 63 6b 65 64 3b 20 20 20 20 20 20 20 20 20 2f  ocked;         /
0340: 2a 20 54 72 75 65 20 6f 6e 63 65 20 61 20 77 72  * True once a wr
0350: 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20  ite-transaction 
0360: 69 73 20 6f 70 65 6e 20 6f 6e 20 70 44 65 73 74  is open on pDest
0370: 20 2a 2f 0a 0a 20 20 50 67 6e 6f 20 69 4e 65 78   */..  Pgno iNex
0380: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
0390: 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f  /* Page number o
03a0: 66 20 74 68 65 20 6e 65 78 74 20 73 6f 75 72 63  f the next sourc
03b0: 65 20 70 61 67 65 20 74 6f 20 63 6f 70 79 20 2a  e page to copy *
03c0: 2f 0a 20 20 73 71 6c 69 74 65 33 2a 20 70 53 72  /.  sqlite3* pSr
03d0: 63 44 62 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  cDb;         /* 
03e0: 53 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 20  Source database 
03f0: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65  handle */.  Btre
0400: 65 20 2a 70 53 72 63 3b 20 20 20 20 20 20 20 20  e *pSrc;        
0410: 20 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 62       /* Source b
0420: 2d 74 72 65 65 20 66 69 6c 65 20 2a 2f 0a 0a 20  -tree file */.. 
0430: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20   int rc;        
0440: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 61 63            /* Bac
0450: 6b 75 70 20 70 72 6f 63 65 73 73 20 65 72 72 6f  kup process erro
0460: 72 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 2f 2a 20  r code */..  /* 
0470: 54 68 65 73 65 20 74 77 6f 20 76 61 72 69 61 62  These two variab
0480: 6c 65 73 20 61 72 65 20 73 65 74 20 62 79 20 65  les are set by e
0490: 76 65 72 79 20 63 61 6c 6c 20 74 6f 20 62 61 63  very call to bac
04a0: 6b 75 70 5f 73 74 65 70 28 29 2e 20 54 68 65 79  kup_step(). They
04b0: 20 61 72 65 0a 20 20 2a 2a 20 72 65 61 64 20 62   are.  ** read b
04c0: 79 20 63 61 6c 6c 73 20 74 6f 20 62 61 63 6b 75  y calls to backu
04d0: 70 5f 72 65 6d 61 69 6e 69 6e 67 28 29 20 61 6e  p_remaining() an
04e0: 64 20 62 61 63 6b 75 70 5f 70 61 67 65 63 6f 75  d backup_pagecou
04f0: 6e 74 28 29 2e 0a 20 20 2a 2f 0a 20 20 50 67 6e  nt()..  */.  Pgn
0500: 6f 20 6e 52 65 6d 61 69 6e 69 6e 67 3b 20 20 20  o nRemaining;   
0510: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
0520: 6f 66 20 70 61 67 65 73 20 6c 65 66 74 20 74 6f  of pages left to
0530: 20 63 6f 70 79 20 2a 2f 0a 20 20 50 67 6e 6f 20   copy */.  Pgno 
0540: 6e 50 61 67 65 63 6f 75 6e 74 3b 20 20 20 20 20  nPagecount;     
0550: 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d      /* Total num
0560: 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20  ber of pages to 
0570: 63 6f 70 79 20 2a 2f 0a 0a 20 20 69 6e 74 20 69  copy */..  int i
0580: 73 41 74 74 61 63 68 65 64 3b 20 20 20 20 20 20  sAttached;      
0590: 20 20 20 20 2f 2a 20 54 72 75 65 20 6f 6e 63 65      /* True once
05a0: 20 62 61 63 6b 75 70 20 68 61 73 20 62 65 65 6e   backup has been
05b0: 20 72 65 67 69 73 74 65 72 65 64 20 77 69 74 68   registered with
05c0: 20 70 61 67 65 72 20 2a 2f 0a 20 20 73 71 6c 69   pager */.  sqli
05d0: 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 4e 65 78  te3_backup *pNex
05e0: 74 3b 20 20 20 2f 2a 20 4e 65 78 74 20 62 61 63  t;   /* Next bac
05f0: 6b 75 70 20 61 73 73 6f 63 69 61 74 65 64 20 77  kup associated w
0600: 69 74 68 20 73 6f 75 72 63 65 20 70 61 67 65 72  ith source pager
0610: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 48   */.};../*.** TH
0620: 52 45 41 44 20 53 41 46 45 54 59 20 4e 4f 54 45  READ SAFETY NOTE
0630: 53 3a 0a 2a 2a 0a 2a 2a 20 20 20 4f 6e 63 65 20  S:.**.**   Once 
0640: 69 74 20 68 61 73 20 62 65 65 6e 20 63 72 65 61  it has been crea
0650: 74 65 64 20 75 73 69 6e 67 20 62 61 63 6b 75 70  ted using backup
0660: 5f 69 6e 69 74 28 29 2c 20 61 20 73 69 6e 67 6c  _init(), a singl
0670: 65 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70  e sqlite3_backup
0680: 0a 2a 2a 20 20 20 73 74 72 75 63 74 75 72 65 20  .**   structure 
0690: 6d 61 79 20 62 65 20 61 63 63 65 73 73 65 64 20  may be accessed 
06a0: 76 69 61 20 74 77 6f 20 67 72 6f 75 70 73 20 6f  via two groups o
06b0: 66 20 74 68 72 65 61 64 2d 73 61 66 65 20 65 6e  f thread-safe en
06c0: 74 72 79 20 70 6f 69 6e 74 73 3a 0a 2a 2a 0a 2a  try points:.**.*
06d0: 2a 20 20 20 20 20 2a 20 56 69 61 20 74 68 65 20  *     * Via the 
06e0: 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f 58  sqlite3_backup_X
06f0: 58 58 28 29 20 41 50 49 20 66 75 6e 63 74 69 6f  XX() API functio
0700: 6e 20 62 61 63 6b 75 70 5f 73 74 65 70 28 29 20  n backup_step() 
0710: 61 6e 64 20 0a 2a 2a 20 20 20 20 20 20 20 62 61  and .**       ba
0720: 63 6b 75 70 5f 66 69 6e 69 73 68 28 29 2e 20 42  ckup_finish(). B
0730: 6f 74 68 20 74 68 65 73 65 20 66 75 6e 63 74 69  oth these functi
0740: 6f 6e 73 20 6f 62 74 61 69 6e 20 74 68 65 20 73  ons obtain the s
0750: 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 0a 2a  ource database.*
0760: 2a 20 20 20 20 20 20 20 68 61 6e 64 6c 65 20 6d  *       handle m
0770: 75 74 65 78 20 61 6e 64 20 74 68 65 20 6d 75 74  utex and the mut
0780: 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  ex associated wi
0790: 74 68 20 74 68 65 20 73 6f 75 72 63 65 20 42 74  th the source Bt
07a0: 53 68 61 72 65 64 20 0a 2a 2a 20 20 20 20 20 20  Shared .**      
07b0: 20 73 74 72 75 63 74 75 72 65 2c 20 69 6e 20 74   structure, in t
07c0: 68 61 74 20 6f 72 64 65 72 2e 0a 2a 2a 0a 2a 2a  hat order..**.**
07d0: 20 20 20 20 20 2a 20 56 69 61 20 74 68 65 20 42       * Via the B
07e0: 61 63 6b 75 70 55 70 64 61 74 65 28 29 20 61 6e  ackupUpdate() an
07f0: 64 20 42 61 63 6b 75 70 52 65 73 74 61 72 74 28  d BackupRestart(
0800: 29 20 66 75 6e 63 74 69 6f 6e 73 2c 20 77 68 69  ) functions, whi
0810: 63 68 20 61 72 65 0a 2a 2a 20 20 20 20 20 20 20  ch are.**       
0820: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 70  invoked by the p
0830: 61 67 65 72 20 6c 61 79 65 72 20 74 6f 20 72 65  ager layer to re
0840: 70 6f 72 74 20 76 61 72 69 6f 75 73 20 73 74 61  port various sta
0850: 74 65 20 63 68 61 6e 67 65 73 20 69 6e 0a 2a 2a  te changes in.**
0860: 20 20 20 20 20 20 20 74 68 65 20 70 61 67 65 20         the page 
0870: 63 61 63 68 65 20 61 73 73 6f 63 69 61 74 65 64  cache associated
0880: 20 77 69 74 68 20 74 68 65 20 73 6f 75 72 63 65   with the source
0890: 20 64 61 74 61 62 61 73 65 2e 20 54 68 65 20 6d   database. The m
08a0: 75 74 65 78 0a 2a 2a 20 20 20 20 20 20 20 61 73  utex.**       as
08b0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68  sociated with th
08c0: 65 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73  e source databas
08d0: 65 20 42 74 53 68 61 72 65 64 20 73 74 72 75 63  e BtShared struc
08e0: 74 75 72 65 20 77 69 6c 6c 20 61 6c 77 61 79 73  ture will always
08f0: 20 0a 2a 2a 20 20 20 20 20 20 20 62 65 20 68 65   .**       be he
0900: 6c 64 20 77 68 65 6e 20 65 69 74 68 65 72 20 6f  ld when either o
0910: 66 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e  f these function
0920: 73 20 61 72 65 20 69 6e 76 6f 6b 65 64 2e 0a 2a  s are invoked..*
0930: 2a 0a 2a 2a 20 20 20 54 68 65 20 6f 74 68 65 72  *.**   The other
0940: 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f   sqlite3_backup_
0950: 58 58 58 28 29 20 41 50 49 20 66 75 6e 63 74 69  XXX() API functi
0960: 6f 6e 73 2c 20 62 61 63 6b 75 70 5f 72 65 6d 61  ons, backup_rema
0970: 69 6e 69 6e 67 28 29 20 61 6e 64 0a 2a 2a 20 20  ining() and.**  
0980: 20 62 61 63 6b 75 70 5f 70 61 67 65 63 6f 75 6e   backup_pagecoun
0990: 74 28 29 20 61 72 65 20 6e 6f 74 20 74 68 72 65  t() are not thre
09a0: 61 64 2d 73 61 66 65 20 66 75 6e 63 74 69 6f 6e  ad-safe function
09b0: 73 2e 20 49 66 20 74 68 65 79 20 61 72 65 20 63  s. If they are c
09c0: 61 6c 6c 65 64 0a 2a 2a 20 20 20 77 68 69 6c 65  alled.**   while
09d0: 20 73 6f 6d 65 20 6f 74 68 65 72 20 74 68 72 65   some other thre
09e0: 61 64 20 69 73 20 63 61 6c 6c 69 6e 67 20 62 61  ad is calling ba
09f0: 63 6b 75 70 5f 73 74 65 70 28 29 20 6f 72 20 62  ckup_step() or b
0a00: 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 29 2c 0a  ackup_finish(),.
0a10: 2a 2a 20 20 20 74 68 65 20 76 61 6c 75 65 73 20  **   the values 
0a20: 72 65 74 75 72 6e 65 64 20 6d 61 79 20 62 65 20  returned may be 
0a30: 69 6e 76 61 6c 69 64 2e 20 54 68 65 72 65 20 69  invalid. There i
0a40: 73 20 6e 6f 20 77 61 79 20 66 6f 72 20 61 20 63  s no way for a c
0a50: 61 6c 6c 20 74 6f 0a 2a 2a 20 20 20 42 61 63 6b  all to.**   Back
0a60: 75 70 55 70 64 61 74 65 28 29 20 6f 72 20 42 61  upUpdate() or Ba
0a70: 63 6b 75 70 52 65 73 74 61 72 74 28 29 20 74 6f  ckupRestart() to
0a80: 20 69 6e 74 65 72 66 65 72 65 20 77 69 74 68 20   interfere with 
0a90: 62 61 63 6b 75 70 5f 72 65 6d 61 69 6e 69 6e 67  backup_remaining
0aa0: 28 29 0a 2a 2a 20 20 20 6f 72 20 62 61 63 6b 75  ().**   or backu
0ab0: 70 5f 70 61 67 65 63 6f 75 6e 74 28 29 2e 0a 2a  p_pagecount()..*
0ac0: 2a 0a 2a 2a 20 20 20 44 65 70 65 6e 64 69 6e 67  *.**   Depending
0ad0: 20 6f 6e 20 74 68 65 20 53 51 4c 69 74 65 20 63   on the SQLite c
0ae0: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 74 68  onfiguration, th
0af0: 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  e database handl
0b00: 65 73 20 61 6e 64 2f 6f 72 0a 2a 2a 20 20 20 74  es and/or.**   t
0b10: 68 65 20 42 74 72 65 65 20 6f 62 6a 65 63 74 73  he Btree objects
0b20: 20 6d 61 79 20 68 61 76 65 20 74 68 65 69 72 20   may have their 
0b30: 6f 77 6e 20 6d 75 74 65 78 65 73 20 74 68 61 74  own mutexes that
0b40: 20 72 65 71 75 69 72 65 20 6c 6f 63 6b 69 6e 67   require locking
0b50: 2e 0a 2a 2a 20 20 20 4e 6f 6e 2d 73 68 61 72 61  ..**   Non-shara
0b60: 62 6c 65 20 42 74 72 65 65 73 20 28 69 6e 2d 6d  ble Btrees (in-m
0b70: 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 73 20  emory databases 
0b80: 66 6f 72 20 65 78 61 6d 70 6c 65 29 2c 20 64 6f  for example), do
0b90: 20 6e 6f 74 20 68 61 76 65 0a 2a 2a 20 20 20 61   not have.**   a
0ba0: 73 73 6f 63 69 61 74 65 64 20 6d 75 74 65 78 65  ssociated mutexe
0bb0: 73 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  s..*/../*.** Ret
0bc0: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 63 6f  urn a pointer co
0bd0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 64  rresponding to d
0be0: 61 74 61 62 61 73 65 20 7a 44 62 20 28 69 2e 65  atabase zDb (i.e
0bf0: 2e 20 22 6d 61 69 6e 22 2c 20 22 74 65 6d 70 22  . "main", "temp"
0c00: 29 0a 2a 2a 20 69 6e 20 63 6f 6e 6e 65 63 74 69  ).** in connecti
0c10: 6f 6e 20 68 61 6e 64 6c 65 20 70 44 62 2e 20 49  on handle pDb. I
0c20: 66 20 73 75 63 68 20 61 20 64 61 74 61 62 61 73  f such a databas
0c30: 65 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e  e cannot be foun
0c40: 64 2c 20 72 65 74 75 72 6e 0a 2a 2a 20 61 20 4e  d, return.** a N
0c50: 55 4c 4c 20 70 6f 69 6e 74 65 72 20 61 6e 64 20  ULL pointer and 
0c60: 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d  write an error m
0c70: 65 73 73 61 67 65 20 74 6f 20 70 45 72 72 6f 72  essage to pError
0c80: 44 62 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  Db..**.** If the
0c90: 20 22 74 65 6d 70 22 20 64 61 74 61 62 61 73 65   "temp" database
0ca0: 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 69   is requested, i
0cb0: 74 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65  t may need to be
0cc0: 20 6f 70 65 6e 65 64 20 62 79 20 74 68 69 73 20   opened by this 
0cd0: 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 49 66  .** function. If
0ce0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
0cf0: 20 77 68 69 6c 65 20 64 6f 69 6e 67 20 73 6f 2c   while doing so,
0d00: 20 72 65 74 75 72 6e 20 30 20 61 6e 64 20 77 72   return 0 and wr
0d10: 69 74 65 20 61 6e 20 0a 2a 2a 20 65 72 72 6f 72  ite an .** error
0d20: 20 6d 65 73 73 61 67 65 20 74 6f 20 70 45 72 72   message to pErr
0d30: 6f 72 44 62 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  orDb..*/.static 
0d40: 42 74 72 65 65 20 2a 66 69 6e 64 42 74 72 65 65  Btree *findBtree
0d50: 28 73 71 6c 69 74 65 33 20 2a 70 45 72 72 6f 72  (sqlite3 *pError
0d60: 44 62 2c 20 73 71 6c 69 74 65 33 20 2a 70 44 62  Db, sqlite3 *pDb
0d70: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44  , const char *zD
0d80: 62 29 7b 0a 20 20 69 6e 74 20 69 20 3d 20 73 71  b){.  int i = sq
0d90: 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 28  lite3FindDbName(
0da0: 70 44 62 2c 20 7a 44 62 29 3b 0a 0a 20 20 69 66  pDb, zDb);..  if
0db0: 28 20 69 3d 3d 31 20 29 7b 0a 20 20 20 20 50 61  ( i==1 ){.    Pa
0dc0: 72 73 65 20 73 50 61 72 73 65 3b 0a 20 20 20 20  rse sParse;.    
0dd0: 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 20 20  int rc = 0;.    
0de0: 6d 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20  memset(&sParse, 
0df0: 30 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65  0, sizeof(sParse
0e00: 29 29 3b 0a 20 20 20 20 73 50 61 72 73 65 2e 64  ));.    sParse.d
0e10: 62 20 3d 20 70 44 62 3b 0a 20 20 20 20 69 66 28  b = pDb;.    if(
0e20: 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 65 6d 70   sqlite3OpenTemp
0e30: 44 61 74 61 62 61 73 65 28 26 73 50 61 72 73 65  Database(&sParse
0e40: 29 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ) ){.      sqlit
0e50: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 70  e3ErrorWithMsg(p
0e60: 45 72 72 6f 72 44 62 2c 20 73 50 61 72 73 65 2e  ErrorDb, sParse.
0e70: 72 63 2c 20 22 25 73 22 2c 20 73 50 61 72 73 65  rc, "%s", sParse
0e80: 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20  .zErrMsg);.     
0e90: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
0ea0: 4f 52 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  OR;.    }.    sq
0eb0: 6c 69 74 65 33 44 62 46 72 65 65 28 70 45 72 72  lite3DbFree(pErr
0ec0: 6f 72 44 62 2c 20 73 50 61 72 73 65 2e 7a 45 72  orDb, sParse.zEr
0ed0: 72 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74  rMsg);.    sqlit
0ee0: 65 33 50 61 72 73 65 72 52 65 73 65 74 28 26 73  e3ParserReset(&s
0ef0: 50 61 72 73 65 29 3b 0a 20 20 20 20 69 66 28 20  Parse);.    if( 
0f00: 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75  rc ){.      retu
0f10: 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  rn 0;.    }.  }.
0f20: 0a 20 20 69 66 28 20 69 3c 30 20 29 7b 0a 20 20  .  if( i<0 ){.  
0f30: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69    sqlite3ErrorWi
0f40: 74 68 4d 73 67 28 70 45 72 72 6f 72 44 62 2c 20  thMsg(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 41 74 74 65 6d 70 74 20 74 6f 20 73 65 74 20   Attempt to set 
0fc0: 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 6f 66  the page size of
0fd0: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
0fe0: 20 74 6f 20 6d 61 74 63 68 20 74 68 65 20 70 61   to match the pa
0ff0: 67 65 20 73 69 7a 65 0a 2a 2a 20 6f 66 20 74 68  ge size.** of th
1000: 65 20 73 6f 75 72 63 65 2e 0a 2a 2f 0a 73 74 61  e source..*/.sta
1010: 74 69 63 20 69 6e 74 20 73 65 74 44 65 73 74 50  tic int setDestP
1020: 67 73 7a 28 73 71 6c 69 74 65 33 5f 62 61 63 6b  gsz(sqlite3_back
1030: 75 70 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63  up *p){.  int rc
1040: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
1050: 42 74 72 65 65 53 65 74 50 61 67 65 53 69 7a 65  BtreeSetPageSize
1060: 28 70 2d 3e 70 44 65 73 74 2c 73 71 6c 69 74 65  (p->pDest,sqlite
1070: 33 42 74 72 65 65 47 65 74 50 61 67 65 53 69 7a  3BtreeGetPageSiz
1080: 65 28 70 2d 3e 70 53 72 63 29 2c 2d 31 2c 30 29  e(p->pSrc),-1,0)
1090: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
10a0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68  ../*.** Check th
10b0: 61 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f  at there is no o
10c0: 70 65 6e 20 72 65 61 64 2d 74 72 61 6e 73 61 63  pen read-transac
10d0: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 62 2d 74 72  tion on the b-tr
10e0: 65 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65  ee passed as the
10f0: 0a 2a 2a 20 73 65 63 6f 6e 64 20 61 72 67 75 6d  .** second argum
1100: 65 6e 74 2e 20 49 66 20 74 68 65 72 65 20 69 73  ent. If there is
1110: 20 6e 6f 74 2c 20 72 65 74 75 72 6e 20 53 51 4c   not, return SQL
1120: 49 54 45 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73  ITE_OK. Otherwis
1130: 65 2c 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 69  e, if there.** i
1140: 73 20 61 6e 20 6f 70 65 6e 20 72 65 61 64 2d 74  s an open read-t
1150: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 72 65 74 75  ransaction, retu
1160: 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20  rn SQLITE_ERROR 
1170: 61 6e 64 20 6c 65 61 76 65 20 61 6e 20 65 72 72  and leave an err
1180: 6f 72 20 0a 2a 2a 20 6d 65 73 73 61 67 65 20 69  or .** message i
1190: 6e 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  n database handl
11a0: 65 20 64 62 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  e db..*/.static 
11b0: 69 6e 74 20 63 68 65 63 6b 52 65 61 64 54 72 61  int checkReadTra
11c0: 6e 73 61 63 74 69 6f 6e 28 73 71 6c 69 74 65 33  nsaction(sqlite3
11d0: 20 2a 64 62 2c 20 42 74 72 65 65 20 2a 70 29 7b   *db, Btree *p){
11e0: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 74  .  if( sqlite3Bt
11f0: 72 65 65 49 73 49 6e 52 65 61 64 54 72 61 6e 73  reeIsInReadTrans
1200: 28 70 29 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  (p) ){.    sqlit
1210: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64  e3ErrorWithMsg(d
1220: 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c  b, SQLITE_ERROR,
1230: 20 22 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61   "destination da
1240: 74 61 62 61 73 65 20 69 73 20 69 6e 20 75 73 65  tabase is in use
1250: 22 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  ");.    return S
1260: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
1270: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  .  return SQLITE
1280: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72  _OK;.}../*.** Cr
1290: 65 61 74 65 20 61 6e 20 73 71 6c 69 74 65 33 5f  eate an sqlite3_
12a0: 62 61 63 6b 75 70 20 70 72 6f 63 65 73 73 20 74  backup process t
12b0: 6f 20 63 6f 70 79 20 74 68 65 20 63 6f 6e 74 65  o copy the conte
12c0: 6e 74 73 20 6f 66 20 7a 53 72 63 44 62 20 66 72  nts of zSrcDb fr
12d0: 6f 6d 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e  om.** connection
12e0: 20 68 61 6e 64 6c 65 20 70 53 72 63 44 62 20 74   handle pSrcDb t
12f0: 6f 20 7a 44 65 73 74 44 62 20 69 6e 20 70 44 65  o zDestDb in pDe
1300: 73 74 44 62 2e 20 49 66 20 73 75 63 63 65 73 73  stDb. If success
1310: 66 75 6c 2c 20 72 65 74 75 72 6e 0a 2a 2a 20 61  ful, return.** a
1320: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
1330: 6e 65 77 20 73 71 6c 69 74 65 33 5f 62 61 63 6b  new sqlite3_back
1340: 75 70 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a  up object..**.**
1350: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   If an error occ
1360: 75 72 73 2c 20 4e 55 4c 4c 20 69 73 20 72 65 74  urs, NULL is ret
1370: 75 72 6e 65 64 20 61 6e 64 20 61 6e 20 65 72 72  urned and an err
1380: 6f 72 20 63 6f 64 65 20 61 6e 64 20 65 72 72 6f  or code and erro
1390: 72 20 6d 65 73 73 61 67 65 0a 2a 2a 20 73 74 6f  r message.** sto
13a0: 72 65 64 20 69 6e 20 64 61 74 61 62 61 73 65 20  red in database 
13b0: 68 61 6e 64 6c 65 20 70 44 65 73 74 44 62 2e 0a  handle pDestDb..
13c0: 2a 2f 0a 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  */.sqlite3_backu
13d0: 70 20 2a 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  p *sqlite3_backu
13e0: 70 5f 69 6e 69 74 28 0a 20 20 73 71 6c 69 74 65  p_init(.  sqlite
13f0: 33 2a 20 70 44 65 73 74 44 62 2c 20 20 20 20 20  3* pDestDb,     
1400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1410: 2f 2a 20 44 61 74 61 62 61 73 65 20 74 6f 20 77  /* Database to w
1420: 72 69 74 65 20 74 6f 20 2a 2f 0a 20 20 63 6f 6e  rite to */.  con
1430: 73 74 20 63 68 61 72 20 2a 7a 44 65 73 74 44 62  st char *zDestDb
1440: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
1450: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61     /* Name of da
1460: 74 61 62 61 73 65 20 77 69 74 68 69 6e 20 70 44  tabase within pD
1470: 65 73 74 44 62 20 2a 2f 0a 20 20 73 71 6c 69 74  estDb */.  sqlit
1480: 65 33 2a 20 70 53 72 63 44 62 2c 20 20 20 20 20  e3* pSrcDb,     
1490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14a0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e   /* Database con
14b0: 6e 65 63 74 69 6f 6e 20 74 6f 20 72 65 61 64 20  nection to read 
14c0: 66 72 6f 6d 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  from */.  const 
14d0: 63 68 61 72 20 2a 7a 53 72 63 44 62 20 20 20 20  char *zSrcDb    
14e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14f0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61 74 61 62  /* Name of datab
1500: 61 73 65 20 77 69 74 68 69 6e 20 70 53 72 63 44  ase within pSrcD
1510: 62 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65  b */.){.  sqlite
1520: 33 5f 62 61 63 6b 75 70 20 2a 70 3b 20 20 20 20  3_backup *p;    
1530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1540: 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 75  /* Value to retu
1550: 72 6e 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51  rn */..#ifdef SQ
1560: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f  LITE_ENABLE_API_
1570: 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c  ARMOR.  if( !sql
1580: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f  ite3SafetyCheckO
1590: 6b 28 70 53 72 63 44 62 29 7c 7c 21 73 71 6c 69  k(pSrcDb)||!sqli
15a0: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b  te3SafetyCheckOk
15b0: 28 70 44 65 73 74 44 62 29 20 29 7b 0a 20 20 20  (pDestDb) ){.   
15c0: 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49   (void)SQLITE_MI
15d0: 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72  SUSE_BKPT;.    r
15e0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e  eturn 0;.  }.#en
15f0: 64 69 66 0a 0a 20 20 2f 2a 20 4c 6f 63 6b 20 74  dif..  /* Lock t
1600: 68 65 20 73 6f 75 72 63 65 20 64 61 74 61 62 61  he source databa
1610: 73 65 20 68 61 6e 64 6c 65 2e 20 54 68 65 20 64  se handle. The d
1620: 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62  estination datab
1630: 61 73 65 0a 20 20 2a 2a 20 68 61 6e 64 6c 65 20  ase.  ** handle 
1640: 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64 20 69 6e  is not locked in
1650: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2c 20 62   this routine, b
1660: 75 74 20 69 74 20 69 73 20 6c 6f 63 6b 65 64 20  ut it is locked 
1670: 69 6e 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f  in.  ** sqlite3_
1680: 62 61 63 6b 75 70 5f 73 74 65 70 28 29 2e 20 54  backup_step(). T
1690: 68 65 20 75 73 65 72 20 69 73 20 72 65 71 75 69  he user is requi
16a0: 72 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68  red to ensure th
16b0: 61 74 20 6e 6f 0a 20 20 2a 2a 20 6f 74 68 65 72  at no.  ** other
16c0: 20 74 68 72 65 61 64 20 61 63 63 65 73 73 65 73   thread accesses
16d0: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
16e0: 20 68 61 6e 64 6c 65 20 66 6f 72 20 74 68 65 20   handle for the 
16f0: 64 75 72 61 74 69 6f 6e 0a 20 20 2a 2a 20 6f 66  duration.  ** of
1700: 20 74 68 65 20 62 61 63 6b 75 70 20 6f 70 65 72   the backup oper
1710: 61 74 69 6f 6e 2e 20 20 41 6e 79 20 61 74 74 65  ation.  Any atte
1720: 6d 70 74 20 74 6f 20 75 73 65 20 74 68 65 20 64  mpt to use the d
1730: 65 73 74 69 6e 61 74 69 6f 6e 0a 20 20 2a 2a 20  estination.  ** 
1740: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
1750: 69 6f 6e 20 77 68 69 6c 65 20 61 20 62 61 63 6b  ion while a back
1760: 75 70 20 69 73 20 69 6e 20 70 72 6f 67 72 65 73  up is in progres
1770: 73 20 6d 61 79 20 63 61 75 73 65 0a 20 20 2a 2a  s may cause.  **
1780: 20 61 20 6d 61 6c 66 75 6e 63 74 69 6f 6e 20 6f   a malfunction o
1790: 72 20 61 20 64 65 61 64 6c 6f 63 6b 2e 0a 20 20  r a deadlock..  
17a0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  */.  sqlite3_mut
17b0: 65 78 5f 65 6e 74 65 72 28 70 53 72 63 44 62 2d  ex_enter(pSrcDb-
17c0: 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74  >mutex);.  sqlit
17d0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
17e0: 44 65 73 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a  DestDb->mutex);.
17f0: 0a 20 20 69 66 28 20 70 53 72 63 44 62 3d 3d 70  .  if( pSrcDb==p
1800: 44 65 73 74 44 62 20 29 7b 0a 20 20 20 20 73 71  DestDb ){.    sq
1810: 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73  lite3ErrorWithMs
1820: 67 28 0a 20 20 20 20 20 20 20 20 70 44 65 73 74  g(.        pDest
1830: 44 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  Db, SQLITE_ERROR
1840: 2c 20 22 73 6f 75 72 63 65 20 61 6e 64 20 64 65  , "source and de
1850: 73 74 69 6e 61 74 69 6f 6e 20 6d 75 73 74 20 62  stination must b
1860: 65 20 64 69 73 74 69 6e 63 74 22 0a 20 20 20 20  e distinct".    
1870: 29 3b 0a 20 20 20 20 70 20 3d 20 30 3b 0a 20 20  );.    p = 0;.  
1880: 7d 65 6c 73 65 20 7b 0a 20 20 20 20 2f 2a 20 41  }else {.    /* A
1890: 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f  llocate space fo
18a0: 72 20 61 20 6e 65 77 20 73 71 6c 69 74 65 33 5f  r a new sqlite3_
18b0: 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 2e 2e 2e  backup object...
18c0: 0a 20 20 20 20 2a 2a 20 45 56 49 44 45 4e 43 45  .    ** EVIDENCE
18d0: 2d 4f 46 3a 20 52 2d 36 34 38 35 32 2d 32 31 35  -OF: R-64852-215
18e0: 39 31 20 54 68 65 20 73 71 6c 69 74 65 33 5f 62  91 The sqlite3_b
18f0: 61 63 6b 75 70 20 6f 62 6a 65 63 74 20 69 73 20  ackup object is 
1900: 63 72 65 61 74 65 64 20 62 79 20 61 0a 20 20 20  created by a.   
1910: 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69   ** call to sqli
1920: 74 65 33 5f 62 61 63 6b 75 70 5f 69 6e 69 74 28  te3_backup_init(
1930: 29 20 61 6e 64 20 69 73 20 64 65 73 74 72 6f 79  ) and is destroy
1940: 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 0a  ed by a call to.
1950: 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 62      ** sqlite3_b
1960: 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 29 2e 20  ackup_finish(). 
1970: 2a 2f 0a 20 20 20 20 70 20 3d 20 28 73 71 6c 69  */.    p = (sqli
1980: 74 65 33 5f 62 61 63 6b 75 70 20 2a 29 73 71 6c  te3_backup *)sql
1990: 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73  ite3MallocZero(s
19a0: 69 7a 65 6f 66 28 73 71 6c 69 74 65 33 5f 62 61  izeof(sqlite3_ba
19b0: 63 6b 75 70 29 29 3b 0a 20 20 20 20 69 66 28 20  ckup));.    if( 
19c0: 21 70 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  !p ){.      sqli
19d0: 74 65 33 45 72 72 6f 72 28 70 44 65 73 74 44 62  te3Error(pDestDb
19e0: 2c 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42  , SQLITE_NOMEM_B
19f0: 4b 50 54 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  KPT);.    }.  }.
1a00: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 61 6c 6c  .  /* If the all
1a10: 6f 63 61 74 69 6f 6e 20 73 75 63 63 65 65 64 65  ocation succeede
1a20: 64 2c 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20  d, populate the 
1a30: 6e 65 77 20 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20  new object. */. 
1a40: 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 70 2d   if( p ){.    p-
1a50: 3e 70 53 72 63 20 3d 20 66 69 6e 64 42 74 72 65  >pSrc = findBtre
1a60: 65 28 70 44 65 73 74 44 62 2c 20 70 53 72 63 44  e(pDestDb, pSrcD
1a70: 62 2c 20 7a 53 72 63 44 62 29 3b 0a 20 20 20 20  b, zSrcDb);.    
1a80: 70 2d 3e 70 44 65 73 74 20 3d 20 66 69 6e 64 42  p->pDest = findB
1a90: 74 72 65 65 28 70 44 65 73 74 44 62 2c 20 70 44  tree(pDestDb, pD
1aa0: 65 73 74 44 62 2c 20 7a 44 65 73 74 44 62 29 3b  estDb, zDestDb);
1ab0: 0a 20 20 20 20 70 2d 3e 70 44 65 73 74 44 62 20  .    p->pDestDb 
1ac0: 3d 20 70 44 65 73 74 44 62 3b 0a 20 20 20 20 70  = pDestDb;.    p
1ad0: 2d 3e 70 53 72 63 44 62 20 3d 20 70 53 72 63 44  ->pSrcDb = pSrcD
1ae0: 62 3b 0a 20 20 20 20 70 2d 3e 69 4e 65 78 74 20  b;.    p->iNext 
1af0: 3d 20 31 3b 0a 20 20 20 20 70 2d 3e 69 73 41 74  = 1;.    p->isAt
1b00: 74 61 63 68 65 64 20 3d 20 30 3b 0a 0a 20 20 20  tached = 0;..   
1b10: 20 69 66 28 20 30 3d 3d 70 2d 3e 70 53 72 63 20   if( 0==p->pSrc 
1b20: 7c 7c 20 30 3d 3d 70 2d 3e 70 44 65 73 74 20 0a  || 0==p->pDest .
1b30: 20 20 20 20 20 7c 7c 20 63 68 65 63 6b 52 65 61       || checkRea
1b40: 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 44 65  dTransaction(pDe
1b50: 73 74 44 62 2c 20 70 2d 3e 70 44 65 73 74 29 21  stDb, p->pDest)!
1b60: 3d 53 51 4c 49 54 45 5f 4f 4b 20 0a 20 20 20 20  =SQLITE_OK .    
1b70: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 4f 6e 65   ){.      /* One
1b80: 20 28 6f 72 20 62 6f 74 68 29 20 6f 66 20 74 68   (or both) of th
1b90: 65 20 6e 61 6d 65 64 20 64 61 74 61 62 61 73 65  e named database
1ba0: 73 20 64 69 64 20 6e 6f 74 20 65 78 69 73 74 20  s did not exist 
1bb0: 6f 72 20 61 6e 20 4f 4f 4d 0a 20 20 20 20 20 20  or an OOM.      
1bc0: 2a 2a 20 65 72 72 6f 72 20 77 61 73 20 68 69 74  ** error was hit
1bd0: 2e 20 4f 72 20 74 68 65 72 65 20 69 73 20 61 20  . Or there is a 
1be0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e  transaction open
1bf0: 20 6f 6e 20 74 68 65 20 64 65 73 74 69 6e 61 74   on the destinat
1c00: 69 6f 6e 0a 20 20 20 20 20 20 2a 2a 20 64 61 74  ion.      ** dat
1c10: 61 62 61 73 65 2e 20 54 68 65 20 65 72 72 6f 72  abase. The error
1c20: 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65   has already bee
1c30: 6e 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74  n written into t
1c40: 68 65 20 70 44 65 73 74 44 62 20 0a 20 20 20 20  he pDestDb .    
1c50: 20 20 2a 2a 20 68 61 6e 64 6c 65 2e 20 41 6c 6c    ** handle. All
1c60: 20 74 68 61 74 20 69 73 20 6c 65 66 74 20 74 6f   that is left to
1c70: 20 64 6f 20 68 65 72 65 20 69 73 20 66 72 65 65   do here is free
1c80: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 62 61 63   the sqlite3_bac
1c90: 6b 75 70 20 0a 20 20 20 20 20 20 2a 2a 20 73 74  kup .      ** st
1ca0: 72 75 63 74 75 72 65 2e 20 20 2a 2f 0a 20 20 20  ructure.  */.   
1cb0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28     sqlite3_free(
1cc0: 70 29 3b 0a 20 20 20 20 20 20 70 20 3d 20 30 3b  p);.      p = 0;
1cd0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28  .    }.  }.  if(
1ce0: 20 70 20 29 7b 0a 20 20 20 20 70 2d 3e 70 53 72   p ){.    p->pSr
1cf0: 63 2d 3e 6e 42 61 63 6b 75 70 2b 2b 3b 0a 20 20  c->nBackup++;.  
1d00: 7d 0a 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  }..  sqlite3_mut
1d10: 65 78 5f 6c 65 61 76 65 28 70 44 65 73 74 44 62  ex_leave(pDestDb
1d20: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69  ->mutex);.  sqli
1d30: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
1d40: 70 53 72 63 44 62 2d 3e 6d 75 74 65 78 29 3b 0a  pSrcDb->mutex);.
1d50: 20 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f    return p;.}../
1d60: 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 72 63  *.** Argument rc
1d70: 20 69 73 20 61 6e 20 53 51 4c 69 74 65 20 65 72   is an SQLite er
1d80: 72 6f 72 20 63 6f 64 65 2e 20 52 65 74 75 72 6e  ror code. Return
1d90: 20 74 72 75 65 20 69 66 20 74 68 69 73 20 65 72   true if this er
1da0: 72 6f 72 20 69 73 20 0a 2a 2a 20 63 6f 6e 73 69  ror is .** consi
1db0: 64 65 72 65 64 20 66 61 74 61 6c 20 69 66 20 65  dered fatal if e
1dc0: 6e 63 6f 75 6e 74 65 72 65 64 20 64 75 72 69 6e  ncountered durin
1dd0: 67 20 61 20 62 61 63 6b 75 70 20 6f 70 65 72 61  g a backup opera
1de0: 74 69 6f 6e 2e 20 41 6c 6c 20 65 72 72 6f 72 73  tion. All errors
1df0: 0a 2a 2a 20 61 72 65 20 63 6f 6e 73 69 64 65 72  .** are consider
1e00: 65 64 20 66 61 74 61 6c 20 65 78 63 65 70 74 20  ed fatal except 
1e10: 66 6f 72 20 53 51 4c 49 54 45 5f 42 55 53 59 20  for SQLITE_BUSY 
1e20: 61 6e 64 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45  and SQLITE_LOCKE
1e30: 44 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  D..*/.static int
1e40: 20 69 73 46 61 74 61 6c 45 72 72 6f 72 28 69 6e   isFatalError(in
1e50: 74 20 72 63 29 7b 0a 20 20 72 65 74 75 72 6e 20  t rc){.  return 
1e60: 28 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26  (rc!=SQLITE_OK &
1e70: 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 42 55 53  & rc!=SQLITE_BUS
1e80: 59 20 26 26 20 41 4c 57 41 59 53 28 72 63 21 3d  Y && ALWAYS(rc!=
1e90: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 29 29 3b  SQLITE_LOCKED));
1ea0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 72 61 6d 65  .}../*.** Parame
1eb0: 74 65 72 20 7a 53 72 63 44 61 74 61 20 70 6f 69  ter zSrcData poi
1ec0: 6e 74 73 20 74 6f 20 61 20 62 75 66 66 65 72 20  nts to a buffer 
1ed0: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 64  containing the d
1ee0: 61 74 61 20 66 6f 72 20 0a 2a 2a 20 70 61 67 65  ata for .** page
1ef0: 20 69 53 72 63 50 67 20 66 72 6f 6d 20 74 68 65   iSrcPg from the
1f00: 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65   source database
1f10: 2e 20 43 6f 70 79 20 74 68 69 73 20 64 61 74 61  . Copy this data
1f20: 20 69 6e 74 6f 20 74 68 65 20 0a 2a 2a 20 64 65   into the .** de
1f30: 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61  stination databa
1f40: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  se..*/.static in
1f50: 74 20 62 61 63 6b 75 70 4f 6e 65 50 61 67 65 28  t backupOnePage(
1f60: 0a 20 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75  .  sqlite3_backu
1f70: 70 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20  p *p,           
1f80: 20 20 20 2f 2a 20 42 61 63 6b 75 70 20 68 61 6e     /* Backup han
1f90: 64 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 53  dle */.  Pgno iS
1fa0: 72 63 50 67 2c 20 20 20 20 20 20 20 20 20 20 20  rcPg,           
1fb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f 75 72           /* Sour
1fc0: 63 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65  ce database page
1fd0: 20 74 6f 20 62 61 63 6b 75 70 20 2a 2f 0a 20 20   to backup */.  
1fe0: 63 6f 6e 73 74 20 75 38 20 2a 7a 53 72 63 44 61  const u8 *zSrcDa
1ff0: 74 61 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ta,             
2000: 2f 2a 20 53 6f 75 72 63 65 20 64 61 74 61 62 61  /* Source databa
2010: 73 65 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a  se page data */.
2020: 20 20 69 6e 74 20 62 55 70 64 61 74 65 20 20 20    int bUpdate   
2030: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2040: 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 6e    /* True for an
2050: 20 75 70 64 61 74 65 2c 20 66 61 6c 73 65 20 6f   update, false o
2060: 74 68 65 72 77 69 73 65 20 2a 2f 0a 29 7b 0a 20  therwise */.){. 
2070: 20 50 61 67 65 72 20 2a 20 63 6f 6e 73 74 20 70   Pager * const p
2080: 44 65 73 74 50 61 67 65 72 20 3d 20 73 71 6c 69  DestPager = sqli
2090: 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 2d  te3BtreePager(p-
20a0: 3e 70 44 65 73 74 29 3b 0a 20 20 63 6f 6e 73 74  >pDest);.  const
20b0: 20 69 6e 74 20 6e 53 72 63 50 67 73 7a 20 3d 20   int nSrcPgsz = 
20c0: 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50  sqlite3BtreeGetP
20d0: 61 67 65 53 69 7a 65 28 70 2d 3e 70 53 72 63 29  ageSize(p->pSrc)
20e0: 3b 0a 20 20 69 6e 74 20 6e 44 65 73 74 50 67 73  ;.  int nDestPgs
20f0: 7a 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  z = sqlite3Btree
2100: 47 65 74 50 61 67 65 53 69 7a 65 28 70 2d 3e 70  GetPageSize(p->p
2110: 44 65 73 74 29 3b 0a 20 20 63 6f 6e 73 74 20 69  Dest);.  const i
2120: 6e 74 20 6e 43 6f 70 79 20 3d 20 4d 49 4e 28 6e  nt nCopy = MIN(n
2130: 53 72 63 50 67 73 7a 2c 20 6e 44 65 73 74 50 67  SrcPgsz, nDestPg
2140: 73 7a 29 3b 0a 20 20 63 6f 6e 73 74 20 69 36 34  sz);.  const i64
2150: 20 69 45 6e 64 20 3d 20 28 69 36 34 29 69 53 72   iEnd = (i64)iSr
2160: 63 50 67 2a 28 69 36 34 29 6e 53 72 63 50 67 73  cPg*(i64)nSrcPgs
2170: 7a 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  z;.#ifdef SQLITE
2180: 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 2f 2a 20  _HAS_CODEC.  /* 
2190: 55 73 65 20 42 74 72 65 65 47 65 74 52 65 73 65  Use BtreeGetRese
21a0: 72 76 65 4e 6f 4d 75 74 65 78 28 29 20 66 6f 72  rveNoMutex() for
21b0: 20 74 68 65 20 73 6f 75 72 63 65 20 62 2d 74 72   the source b-tr
21c0: 65 65 2c 20 61 73 20 61 6c 74 68 6f 75 67 68 20  ee, as although 
21d0: 69 74 20 69 73 0a 20 20 2a 2a 20 67 75 61 72 61  it is.  ** guara
21e0: 6e 74 65 65 64 20 74 68 61 74 20 74 68 65 20 73  nteed that the s
21f0: 68 61 72 65 64 2d 6d 75 74 65 78 20 69 73 20 68  hared-mutex is h
2200: 65 6c 64 20 62 79 20 74 68 69 73 20 74 68 72 65  eld by this thre
2210: 61 64 2c 20 68 61 6e 64 6c 65 0a 20 20 2a 2a 20  ad, handle.  ** 
2220: 70 2d 3e 70 53 72 63 20 6d 61 79 20 6e 6f 74 20  p->pSrc may not 
2230: 61 63 74 75 61 6c 6c 79 20 62 65 20 74 68 65 20  actually be the 
2240: 6f 77 6e 65 72 2e 20 20 2a 2f 0a 20 20 69 6e 74  owner.  */.  int
2250: 20 6e 53 72 63 52 65 73 65 72 76 65 20 3d 20 73   nSrcReserve = s
2260: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 52 65  qlite3BtreeGetRe
2270: 73 65 72 76 65 4e 6f 4d 75 74 65 78 28 70 2d 3e  serveNoMutex(p->
2280: 70 53 72 63 29 3b 0a 20 20 69 6e 74 20 6e 44 65  pSrc);.  int nDe
2290: 73 74 52 65 73 65 72 76 65 20 3d 20 73 71 6c 69  stReserve = sqli
22a0: 74 65 33 42 74 72 65 65 47 65 74 4f 70 74 69 6d  te3BtreeGetOptim
22b0: 61 6c 52 65 73 65 72 76 65 28 70 2d 3e 70 44 65  alReserve(p->pDe
22c0: 73 74 29 3b 0a 23 65 6e 64 69 66 0a 20 20 69 6e  st);.#endif.  in
22d0: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
22e0: 3b 0a 20 20 69 36 34 20 69 4f 66 66 3b 0a 0a 20  ;.  i64 iOff;.. 
22f0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
2300: 42 74 72 65 65 47 65 74 52 65 73 65 72 76 65 4e  BtreeGetReserveN
2310: 6f 4d 75 74 65 78 28 70 2d 3e 70 53 72 63 29 3e  oMutex(p->pSrc)>
2320: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
2330: 70 2d 3e 62 44 65 73 74 4c 6f 63 6b 65 64 20 29  p->bDestLocked )
2340: 3b 0a 20 20 61 73 73 65 72 74 28 20 21 69 73 46  ;.  assert( !isF
2350: 61 74 61 6c 45 72 72 6f 72 28 70 2d 3e 72 63 29  atalError(p->rc)
2360: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53   );.  assert( iS
2370: 72 63 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42 59  rcPg!=PENDING_BY
2380: 54 45 5f 50 41 47 45 28 70 2d 3e 70 53 72 63 2d  TE_PAGE(p->pSrc-
2390: 3e 70 42 74 29 20 29 3b 0a 20 20 61 73 73 65 72  >pBt) );.  asser
23a0: 74 28 20 7a 53 72 63 44 61 74 61 20 29 3b 0a 0a  t( zSrcData );..
23b0: 20 20 2f 2a 20 43 61 74 63 68 20 74 68 65 20 63    /* Catch the c
23c0: 61 73 65 20 77 68 65 72 65 20 74 68 65 20 64 65  ase where the de
23d0: 73 74 69 6e 61 74 69 6f 6e 20 69 73 20 61 6e 20  stination is an 
23e0: 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61  in-memory databa
23f0: 73 65 20 61 6e 64 20 74 68 65 0a 20 20 2a 2a 20  se and the.  ** 
2400: 70 61 67 65 20 73 69 7a 65 73 20 6f 66 20 74 68  page sizes of th
2410: 65 20 73 6f 75 72 63 65 20 61 6e 64 20 64 65 73  e source and des
2420: 74 69 6e 61 74 69 6f 6e 20 64 69 66 66 65 72 2e  tination differ.
2430: 20 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e 53 72   .  */.  if( nSr
2440: 63 50 67 73 7a 21 3d 6e 44 65 73 74 50 67 73 7a  cPgsz!=nDestPgsz
2450: 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 72   && sqlite3Pager
2460: 49 73 4d 65 6d 64 62 28 70 44 65 73 74 50 61 67  IsMemdb(pDestPag
2470: 65 72 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  er) ){.    rc = 
2480: 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b  SQLITE_READONLY;
2490: 0a 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c  .  }..#ifdef SQL
24a0: 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20  ITE_HAS_CODEC.  
24b0: 2f 2a 20 42 61 63 6b 75 70 20 69 73 20 6e 6f 74  /* Backup is not
24c0: 20 70 6f 73 73 69 62 6c 65 20 69 66 20 74 68 65   possible if the
24d0: 20 70 61 67 65 20 73 69 7a 65 20 6f 66 20 74 68   page size of th
24e0: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 69 73  e destination is
24f0: 20 63 68 61 6e 67 69 6e 67 0a 20 20 2a 2a 20 61   changing.  ** a
2500: 6e 64 20 61 20 63 6f 64 65 63 20 69 73 20 69 6e  nd a codec is in
2510: 20 75 73 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28   use..  */.  if(
2520: 20 6e 53 72 63 50 67 73 7a 21 3d 6e 44 65 73 74   nSrcPgsz!=nDest
2530: 50 67 73 7a 20 26 26 20 73 71 6c 69 74 65 33 50  Pgsz && sqlite3P
2540: 61 67 65 72 47 65 74 43 6f 64 65 63 28 70 44 65  agerGetCodec(pDe
2550: 73 74 50 61 67 65 72 29 21 3d 30 20 29 7b 0a 20  stPager)!=0 ){. 
2560: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52     rc = SQLITE_R
2570: 45 41 44 4f 4e 4c 59 3b 0a 20 20 7d 0a 0a 20 20  EADONLY;.  }..  
2580: 2f 2a 20 42 61 63 6b 75 70 20 69 73 20 6e 6f 74  /* Backup is not
2590: 20 70 6f 73 73 69 62 6c 65 20 69 66 20 74 68 65   possible if the
25a0: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
25b0: 20 6f 66 20 72 65 73 65 72 76 65 20 73 70 61 63   of reserve spac
25c0: 65 20 64 69 66 66 65 72 0a 20 20 2a 2a 20 62 65  e differ.  ** be
25d0: 74 77 65 65 6e 20 73 6f 75 72 63 65 20 61 6e 64  tween source and
25e0: 20 64 65 73 74 69 6e 61 74 69 6f 6e 2e 20 20 49   destination.  I
25f0: 66 20 74 68 65 72 65 20 69 73 20 61 20 64 69 66  f there is a dif
2600: 66 65 72 65 6e 63 65 2c 20 74 72 79 20 74 6f 0a  ference, try to.
2610: 20 20 2a 2a 20 66 69 78 20 74 68 65 20 64 65 73    ** fix the des
2620: 74 69 6e 61 74 69 6f 6e 20 74 6f 20 61 67 72 65  tination to agre
2630: 65 20 77 69 74 68 20 74 68 65 20 73 6f 75 72 63  e with the sourc
2640: 65 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 6e  e.  If that is n
2650: 6f 74 20 70 6f 73 73 69 62 6c 65 2c 0a 20 20 2a  ot possible,.  *
2660: 2a 20 74 68 65 6e 20 74 68 65 20 62 61 63 6b 75  * then the backu
2670: 70 20 63 61 6e 6e 6f 74 20 70 72 6f 63 65 65 64  p cannot proceed
2680: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e 53 72  ..  */.  if( nSr
2690: 63 52 65 73 65 72 76 65 21 3d 6e 44 65 73 74 52  cReserve!=nDestR
26a0: 65 73 65 72 76 65 20 29 7b 0a 20 20 20 20 75 33  eserve ){.    u3
26b0: 32 20 6e 65 77 50 67 73 7a 20 3d 20 6e 53 72 63  2 newPgsz = nSrc
26c0: 50 67 73 7a 3b 0a 20 20 20 20 72 63 20 3d 20 73  Pgsz;.    rc = s
26d0: 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61  qlite3PagerSetPa
26e0: 67 65 73 69 7a 65 28 70 44 65 73 74 50 61 67 65  gesize(pDestPage
26f0: 72 2c 20 26 6e 65 77 50 67 73 7a 2c 20 6e 53 72  r, &newPgsz, nSr
2700: 63 52 65 73 65 72 76 65 29 3b 0a 20 20 20 20 69  cReserve);.    i
2710: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
2720: 20 26 26 20 6e 65 77 50 67 73 7a 21 3d 6e 53 72   && newPgsz!=nSr
2730: 63 50 67 73 7a 20 29 20 72 63 20 3d 20 53 51 4c  cPgsz ) rc = SQL
2740: 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20  ITE_READONLY;.  
2750: 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 54  }.#endif..  /* T
2760: 68 69 73 20 6c 6f 6f 70 20 72 75 6e 73 20 6f 6e  his loop runs on
2770: 63 65 20 66 6f 72 20 65 61 63 68 20 64 65 73 74  ce for each dest
2780: 69 6e 61 74 69 6f 6e 20 70 61 67 65 20 73 70 61  ination page spa
2790: 6e 6e 65 64 20 62 79 20 74 68 65 20 73 6f 75 72  nned by the sour
27a0: 63 65 20 0a 20 20 2a 2a 20 70 61 67 65 2e 20 46  ce .  ** page. F
27b0: 6f 72 20 65 61 63 68 20 69 74 65 72 61 74 69 6f  or each iteratio
27c0: 6e 2c 20 76 61 72 69 61 62 6c 65 20 69 4f 66 66  n, variable iOff
27d0: 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 62   is set to the b
27e0: 79 74 65 20 6f 66 66 73 65 74 0a 20 20 2a 2a 20  yte offset.  ** 
27f0: 6f 66 20 74 68 65 20 64 65 73 74 69 6e 61 74 69  of the destinati
2800: 6f 6e 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20  on page..  */.  
2810: 66 6f 72 28 69 4f 66 66 3d 69 45 6e 64 2d 28 69  for(iOff=iEnd-(i
2820: 36 34 29 6e 53 72 63 50 67 73 7a 3b 20 72 63 3d  64)nSrcPgsz; rc=
2830: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4f  =SQLITE_OK && iO
2840: 66 66 3c 69 45 6e 64 3b 20 69 4f 66 66 2b 3d 6e  ff<iEnd; iOff+=n
2850: 44 65 73 74 50 67 73 7a 29 7b 0a 20 20 20 20 44  DestPgsz){.    D
2860: 62 50 61 67 65 20 2a 70 44 65 73 74 50 67 20 3d  bPage *pDestPg =
2870: 20 30 3b 0a 20 20 20 20 50 67 6e 6f 20 69 44 65   0;.    Pgno iDe
2880: 73 74 20 3d 20 28 50 67 6e 6f 29 28 69 4f 66 66  st = (Pgno)(iOff
2890: 2f 6e 44 65 73 74 50 67 73 7a 29 2b 31 3b 0a 20  /nDestPgsz)+1;. 
28a0: 20 20 20 69 66 28 20 69 44 65 73 74 3d 3d 50 45     if( iDest==PE
28b0: 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28  NDING_BYTE_PAGE(
28c0: 70 2d 3e 70 44 65 73 74 2d 3e 70 42 74 29 20 29  p->pDest->pBt) )
28d0: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69   continue;.    i
28e0: 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72  f( SQLITE_OK==(r
28f0: 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72  c = sqlite3Pager
2900: 47 65 74 28 70 44 65 73 74 50 61 67 65 72 2c 20  Get(pDestPager, 
2910: 69 44 65 73 74 2c 20 26 70 44 65 73 74 50 67 2c  iDest, &pDestPg,
2920: 20 30 29 29 0a 20 20 20 20 20 26 26 20 53 51 4c   0)).     && SQL
2930: 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 73 71  ITE_OK==(rc = sq
2940: 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28  lite3PagerWrite(
2950: 70 44 65 73 74 50 67 29 29 0a 20 20 20 20 29 7b  pDestPg)).    ){
2960: 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 75 38 20  .      const u8 
2970: 2a 7a 49 6e 20 3d 20 26 7a 53 72 63 44 61 74 61  *zIn = &zSrcData
2980: 5b 69 4f 66 66 25 6e 53 72 63 50 67 73 7a 5d 3b  [iOff%nSrcPgsz];
2990: 0a 20 20 20 20 20 20 75 38 20 2a 7a 44 65 73 74  .      u8 *zDest
29a0: 44 61 74 61 20 3d 20 73 71 6c 69 74 65 33 50 61  Data = sqlite3Pa
29b0: 67 65 72 47 65 74 44 61 74 61 28 70 44 65 73 74  gerGetData(pDest
29c0: 50 67 29 3b 0a 20 20 20 20 20 20 75 38 20 2a 7a  Pg);.      u8 *z
29d0: 4f 75 74 20 3d 20 26 7a 44 65 73 74 44 61 74 61  Out = &zDestData
29e0: 5b 69 4f 66 66 25 6e 44 65 73 74 50 67 73 7a 5d  [iOff%nDestPgsz]
29f0: 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 43 6f 70 79  ;..      /* Copy
2a00: 20 74 68 65 20 64 61 74 61 20 66 72 6f 6d 20 74   the data from t
2a10: 68 65 20 73 6f 75 72 63 65 20 70 61 67 65 20 69  he source page i
2a20: 6e 74 6f 20 74 68 65 20 64 65 73 74 69 6e 61 74  nto the destinat
2a30: 69 6f 6e 20 70 61 67 65 2e 0a 20 20 20 20 20 20  ion page..      
2a40: 2a 2a 20 54 68 65 6e 20 63 6c 65 61 72 20 74 68  ** Then clear th
2a50: 65 20 42 74 72 65 65 20 6c 61 79 65 72 20 4d 65  e Btree layer Me
2a60: 6d 50 61 67 65 2e 69 73 49 6e 69 74 20 66 6c 61  mPage.isInit fla
2a70: 67 2e 20 42 6f 74 68 20 74 68 69 73 20 6d 6f 64  g. Both this mod
2a80: 75 6c 65 0a 20 20 20 20 20 20 2a 2a 20 61 6e 64  ule.      ** and
2a90: 20 74 68 65 20 70 61 67 65 72 20 63 6f 64 65 20   the pager code 
2aa0: 75 73 65 20 74 68 69 73 20 74 72 69 63 6b 20 28  use this trick (
2ab0: 63 6c 65 61 72 69 6e 67 20 74 68 65 20 66 69 72  clearing the fir
2ac0: 73 74 20 62 79 74 65 0a 20 20 20 20 20 20 2a 2a  st byte.      **
2ad0: 20 6f 66 20 74 68 65 20 70 61 67 65 20 27 65 78   of the page 'ex
2ae0: 74 72 61 27 20 73 70 61 63 65 20 74 6f 20 69 6e  tra' space to in
2af0: 76 61 6c 69 64 61 74 65 20 74 68 65 20 42 74 72  validate the Btr
2b00: 65 65 20 6c 61 79 65 72 73 0a 20 20 20 20 20 20  ee layers.      
2b10: 2a 2a 20 63 61 63 68 65 64 20 70 61 72 73 65 20  ** cached parse 
2b20: 6f 66 20 74 68 65 20 70 61 67 65 29 2e 20 4d 65  of the page). Me
2b30: 6d 50 61 67 65 2e 69 73 49 6e 69 74 20 69 73 20  mPage.isInit is 
2b40: 6d 61 72 6b 65 64 20 0a 20 20 20 20 20 20 2a 2a  marked .      **
2b50: 20 22 4d 55 53 54 20 42 45 20 46 49 52 53 54 22   "MUST BE FIRST"
2b60: 20 66 6f 72 20 74 68 69 73 20 70 75 72 70 6f 73   for this purpos
2b70: 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  e..      */.    
2b80: 20 20 6d 65 6d 63 70 79 28 7a 4f 75 74 2c 20 7a    memcpy(zOut, z
2b90: 49 6e 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20  In, nCopy);.    
2ba0: 20 20 28 28 75 38 20 2a 29 73 71 6c 69 74 65 33    ((u8 *)sqlite3
2bb0: 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 44  PagerGetExtra(pD
2bc0: 65 73 74 50 67 29 29 5b 30 5d 20 3d 20 30 3b 0a  estPg))[0] = 0;.
2bd0: 20 20 20 20 20 20 69 66 28 20 69 4f 66 66 3d 3d        if( iOff==
2be0: 30 20 26 26 20 62 55 70 64 61 74 65 3d 3d 30 20  0 && bUpdate==0 
2bf0: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
2c00: 65 33 50 75 74 34 62 79 74 65 28 26 7a 4f 75 74  e3Put4byte(&zOut
2c10: 5b 32 38 5d 2c 20 73 71 6c 69 74 65 33 42 74 72  [28], sqlite3Btr
2c20: 65 65 4c 61 73 74 50 61 67 65 28 70 2d 3e 70 53  eeLastPage(p->pS
2c30: 72 63 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  rc));.      }.  
2c40: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 50    }.    sqlite3P
2c50: 61 67 65 72 55 6e 72 65 66 28 70 44 65 73 74 50  agerUnref(pDestP
2c60: 67 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72  g);.  }..  retur
2c70: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49  n rc;.}../*.** I
2c80: 66 20 70 46 69 6c 65 20 69 73 20 63 75 72 72 65  f pFile is curre
2c90: 6e 74 6c 79 20 6c 61 72 67 65 72 20 74 68 61 6e  ntly larger than
2ca0: 20 69 53 69 7a 65 20 62 79 74 65 73 2c 20 74 68   iSize bytes, th
2cb0: 65 6e 20 74 72 75 6e 63 61 74 65 20 69 74 20 74  en truncate it t
2cc0: 6f 0a 2a 2a 20 65 78 61 63 74 6c 79 20 69 53 69  o.** exactly iSi
2cd0: 7a 65 20 62 79 74 65 73 2e 20 49 66 20 70 46 69  ze bytes. If pFi
2ce0: 6c 65 20 69 73 20 6e 6f 74 20 6c 61 72 67 65 72  le is not larger
2cf0: 20 74 68 61 6e 20 69 53 69 7a 65 20 62 79 74 65   than iSize byte
2d00: 73 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 20  s, then.** this 
2d10: 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f  function is a no
2d20: 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72  -op..**.** Retur
2d30: 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65  n SQLITE_OK if e
2d40: 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 63  verything is suc
2d50: 63 65 73 73 66 75 6c 2c 20 6f 72 20 61 6e 20 53  cessful, or an S
2d60: 51 4c 69 74 65 20 65 72 72 6f 72 20 0a 2a 2a 20  QLite error .** 
2d70: 63 6f 64 65 20 69 66 20 61 6e 20 65 72 72 6f 72  code if an error
2d80: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74   occurs..*/.stat
2d90: 69 63 20 69 6e 74 20 62 61 63 6b 75 70 54 72 75  ic int backupTru
2da0: 6e 63 61 74 65 46 69 6c 65 28 73 71 6c 69 74 65  ncateFile(sqlite
2db0: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 69  3_file *pFile, i
2dc0: 36 34 20 69 53 69 7a 65 29 7b 0a 20 20 69 36 34  64 iSize){.  i64
2dd0: 20 69 43 75 72 72 65 6e 74 3b 0a 20 20 69 6e 74   iCurrent;.  int
2de0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46   rc = sqlite3OsF
2df0: 69 6c 65 53 69 7a 65 28 70 46 69 6c 65 2c 20 26  ileSize(pFile, &
2e00: 69 43 75 72 72 65 6e 74 29 3b 0a 20 20 69 66 28  iCurrent);.  if(
2e10: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
2e20: 26 20 69 43 75 72 72 65 6e 74 3e 69 53 69 7a 65  & iCurrent>iSize
2e30: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
2e40: 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70  ite3OsTruncate(p
2e50: 46 69 6c 65 2c 20 69 53 69 7a 65 29 3b 0a 20 20  File, iSize);.  
2e60: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  }.  return rc;.}
2e70: 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 73 74 65 72  ../*.** Register
2e80: 20 74 68 69 73 20 62 61 63 6b 75 70 20 6f 62 6a   this backup obj
2e90: 65 63 74 20 77 69 74 68 20 74 68 65 20 61 73 73  ect with the ass
2ea0: 6f 63 69 61 74 65 64 20 73 6f 75 72 63 65 20 70  ociated source p
2eb0: 61 67 65 72 20 66 6f 72 0a 2a 2a 20 63 61 6c 6c  ager for.** call
2ec0: 62 61 63 6b 73 20 77 68 65 6e 20 70 61 67 65 73  backs when pages
2ed0: 20 61 72 65 20 63 68 61 6e 67 65 64 20 6f 72 20   are changed or 
2ee0: 74 68 65 20 63 61 63 68 65 20 69 6e 76 61 6c 69  the cache invali
2ef0: 64 61 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  dated..*/.static
2f00: 20 76 6f 69 64 20 61 74 74 61 63 68 42 61 63 6b   void attachBack
2f10: 75 70 4f 62 6a 65 63 74 28 73 71 6c 69 74 65 33  upObject(sqlite3
2f20: 5f 62 61 63 6b 75 70 20 2a 70 29 7b 0a 20 20 73  _backup *p){.  s
2f30: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 2a  qlite3_backup **
2f40: 70 70 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71  pp;.  assert( sq
2f50: 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d  lite3BtreeHoldsM
2f60: 75 74 65 78 28 70 2d 3e 70 53 72 63 29 20 29 3b  utex(p->pSrc) );
2f70: 0a 20 20 70 70 20 3d 20 73 71 6c 69 74 65 33 50  .  pp = sqlite3P
2f80: 61 67 65 72 42 61 63 6b 75 70 50 74 72 28 73 71  agerBackupPtr(sq
2f90: 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28  lite3BtreePager(
2fa0: 70 2d 3e 70 53 72 63 29 29 3b 0a 20 20 70 2d 3e  p->pSrc));.  p->
2fb0: 70 4e 65 78 74 20 3d 20 2a 70 70 3b 0a 20 20 2a  pNext = *pp;.  *
2fc0: 70 70 20 3d 20 70 3b 0a 20 20 70 2d 3e 69 73 41  pp = p;.  p->isA
2fd0: 74 74 61 63 68 65 64 20 3d 20 31 3b 0a 7d 0a 0a  ttached = 1;.}..
2fe0: 2f 2a 0a 2a 2a 20 43 6f 70 79 20 6e 50 61 67 65  /*.** Copy nPage
2ff0: 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 65 20   pages from the 
3000: 73 6f 75 72 63 65 20 62 2d 74 72 65 65 20 74 6f  source b-tree to
3010: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
3020: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
3030: 5f 62 61 63 6b 75 70 5f 73 74 65 70 28 73 71 6c  _backup_step(sql
3040: 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 2c 20  ite3_backup *p, 
3050: 69 6e 74 20 6e 50 61 67 65 29 7b 0a 20 20 69 6e  int nPage){.  in
3060: 74 20 72 63 3b 0a 20 20 69 6e 74 20 64 65 73 74  t rc;.  int dest
3070: 4d 6f 64 65 3b 20 20 20 20 20 20 20 2f 2a 20 44  Mode;       /* D
3080: 65 73 74 69 6e 61 74 69 6f 6e 20 6a 6f 75 72 6e  estination journ
3090: 61 6c 20 6d 6f 64 65 20 2a 2f 0a 20 20 69 6e 74  al mode */.  int
30a0: 20 70 67 73 7a 53 72 63 20 3d 20 30 3b 20 20 20   pgszSrc = 0;   
30b0: 20 2f 2a 20 53 6f 75 72 63 65 20 70 61 67 65 20   /* Source page 
30c0: 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 70 67  size */.  int pg
30d0: 73 7a 44 65 73 74 20 3d 20 30 3b 20 20 20 2f 2a  szDest = 0;   /*
30e0: 20 44 65 73 74 69 6e 61 74 69 6f 6e 20 70 61 67   Destination pag
30f0: 65 20 73 69 7a 65 20 2a 2f 0a 0a 23 69 66 64 65  e size */..#ifde
3100: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
3110: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20  API_ARMOR.  if( 
3120: 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51  p==0 ) return SQ
3130: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54  LITE_MISUSE_BKPT
3140: 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74  ;.#endif.  sqlit
3150: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70  e3_mutex_enter(p
3160: 2d 3e 70 53 72 63 44 62 2d 3e 6d 75 74 65 78 29  ->pSrcDb->mutex)
3170: 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  ;.  sqlite3Btree
3180: 45 6e 74 65 72 28 70 2d 3e 70 53 72 63 29 3b 0a  Enter(p->pSrc);.
3190: 20 20 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62    if( p->pDestDb
31a0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
31b0: 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 70  mutex_enter(p->p
31c0: 44 65 73 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a  DestDb->mutex);.
31d0: 20 20 7d 0a 0a 20 20 72 63 20 3d 20 70 2d 3e 72    }..  rc = p->r
31e0: 63 3b 0a 20 20 69 66 28 20 21 69 73 46 61 74 61  c;.  if( !isFata
31f0: 6c 45 72 72 6f 72 28 72 63 29 20 29 7b 0a 20 20  lError(rc) ){.  
3200: 20 20 50 61 67 65 72 20 2a 20 63 6f 6e 73 74 20    Pager * const 
3210: 70 53 72 63 50 61 67 65 72 20 3d 20 73 71 6c 69  pSrcPager = sqli
3220: 74 65 33 42 74 72 65 65 50 61 67 65 72 28 70 2d  te3BtreePager(p-
3230: 3e 70 53 72 63 29 3b 20 20 20 20 20 2f 2a 20 53  >pSrc);     /* S
3240: 6f 75 72 63 65 20 70 61 67 65 72 20 2a 2f 0a 20  ource pager */. 
3250: 20 20 20 50 61 67 65 72 20 2a 20 63 6f 6e 73 74     Pager * const
3260: 20 70 44 65 73 74 50 61 67 65 72 20 3d 20 73 71   pDestPager = sq
3270: 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72 28  lite3BtreePager(
3280: 70 2d 3e 70 44 65 73 74 29 3b 20 20 20 2f 2a 20  p->pDest);   /* 
3290: 44 65 73 74 20 70 61 67 65 72 20 2a 2f 0a 20 20  Dest pager */.  
32a0: 20 20 69 6e 74 20 69 69 3b 20 20 20 20 20 20 20    int ii;       
32b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
32c0: 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72       /* Iterator
32d0: 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 20   variable */.   
32e0: 20 69 6e 74 20 6e 53 72 63 50 61 67 65 20 3d 20   int nSrcPage = 
32f0: 2d 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  -1;             
3300: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 73      /* Size of s
3310: 6f 75 72 63 65 20 64 62 20 69 6e 20 70 61 67 65  ource db in page
3320: 73 20 2a 2f 0a 20 20 20 20 69 6e 74 20 62 43 6c  s */.    int bCl
3330: 6f 73 65 54 72 61 6e 73 20 3d 20 30 3b 20 20 20  oseTrans = 0;   
3340: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
3350: 72 75 65 20 69 66 20 73 72 63 20 64 62 20 72 65  rue if src db re
3360: 71 75 69 72 65 73 20 75 6e 6c 6f 63 6b 69 6e 67  quires unlocking
3370: 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74   */..    /* If t
3380: 68 65 20 73 6f 75 72 63 65 20 70 61 67 65 72 20  he source pager 
3390: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20  is currently in 
33a0: 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74  a write-transact
33b0: 69 6f 6e 2c 20 72 65 74 75 72 6e 0a 20 20 20 20  ion, return.    
33c0: 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69  ** SQLITE_BUSY i
33d0: 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 20 20 20 20  mmediately..    
33e0: 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 70 44  */.    if( p->pD
33f0: 65 73 74 44 62 20 26 26 20 70 2d 3e 70 53 72 63  estDb && p->pSrc
3400: 2d 3e 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63  ->pBt->inTransac
3410: 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54  tion==TRANS_WRIT
3420: 45 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20  E ){.      rc = 
3430: 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20  SQLITE_BUSY;.   
3440: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63   }else{.      rc
3450: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
3460: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74    }..    /* If t
3470: 68 65 72 65 20 69 73 20 6e 6f 20 6f 70 65 6e 20  here is no open 
3480: 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e  read-transaction
3490: 20 6f 6e 20 74 68 65 20 73 6f 75 72 63 65 20 64   on the source d
34a0: 61 74 61 62 61 73 65 2c 20 6f 70 65 6e 0a 20 20  atabase, open.  
34b0: 20 20 2a 2a 20 6f 6e 65 20 6e 6f 77 2e 20 49 66    ** one now. If
34c0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
34d0: 73 20 6f 70 65 6e 65 64 20 68 65 72 65 2c 20 74  s opened here, t
34e0: 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 65 20 63  hen it will be c
34f0: 6c 6f 73 65 64 0a 20 20 20 20 2a 2a 20 62 65 66  losed.    ** bef
3500: 6f 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f  ore this functio
3510: 6e 20 65 78 69 74 73 2e 0a 20 20 20 20 2a 2f 0a  n exits..    */.
3520: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
3530: 54 45 5f 4f 4b 20 26 26 20 30 3d 3d 73 71 6c 69  TE_OK && 0==sqli
3540: 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61 64  te3BtreeIsInRead
3550: 54 72 61 6e 73 28 70 2d 3e 70 53 72 63 29 20 29  Trans(p->pSrc) )
3560: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  {.      rc = sql
3570: 69 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72  ite3BtreeBeginTr
3580: 61 6e 73 28 70 2d 3e 70 53 72 63 2c 20 30 2c 20  ans(p->pSrc, 0, 
3590: 30 29 3b 0a 20 20 20 20 20 20 62 43 6c 6f 73 65  0);.      bClose
35a0: 54 72 61 6e 73 20 3d 20 31 3b 0a 20 20 20 20 7d  Trans = 1;.    }
35b0: 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20  ..    /* If the 
35c0: 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61  destination data
35d0: 62 61 73 65 20 68 61 73 20 6e 6f 74 20 79 65 74  base has not yet
35e0: 20 62 65 65 6e 20 6c 6f 63 6b 65 64 20 28 69 2e   been locked (i.
35f0: 65 2e 20 69 66 20 74 68 69 73 0a 20 20 20 20 2a  e. if this.    *
3600: 2a 20 69 73 20 74 68 65 20 66 69 72 73 74 20 63  * is the first c
3610: 61 6c 6c 20 74 6f 20 62 61 63 6b 75 70 5f 73 74  all to backup_st
3620: 65 70 28 29 20 66 6f 72 20 74 68 65 20 63 75 72  ep() for the cur
3630: 72 65 6e 74 20 62 61 63 6b 75 70 20 6f 70 65 72  rent backup oper
3640: 61 74 69 6f 6e 29 2c 0a 20 20 20 20 2a 2a 20 74  ation),.    ** t
3650: 72 79 20 74 6f 20 73 65 74 20 69 74 73 20 70 61  ry to set its pa
3660: 67 65 20 73 69 7a 65 20 74 6f 20 74 68 65 20 73  ge size to the s
3670: 61 6d 65 20 61 73 20 74 68 65 20 73 6f 75 72 63  ame as the sourc
3680: 65 20 64 61 74 61 62 61 73 65 2e 20 54 68 69 73  e database. This
3690: 0a 20 20 20 20 2a 2a 20 69 73 20 65 73 70 65 63  .    ** is espec
36a0: 69 61 6c 6c 79 20 69 6d 70 6f 72 74 61 6e 74 20  ially important 
36b0: 6f 6e 20 5a 69 70 56 46 53 20 73 79 73 74 65 6d  on ZipVFS system
36c0: 73 2c 20 61 73 20 69 6e 20 74 68 61 74 20 63 61  s, as in that ca
36d0: 73 65 20 69 74 20 69 73 0a 20 20 20 20 2a 2a 20  se it is.    ** 
36e0: 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20  not possible to 
36f0: 63 72 65 61 74 65 20 61 20 64 61 74 61 62 61 73  create a databas
3700: 65 20 66 69 6c 65 20 74 68 61 74 20 75 73 65 73  e file that uses
3710: 20 6f 6e 65 20 70 61 67 65 20 73 69 7a 65 20 62   one page size b
3720: 79 0a 20 20 20 20 2a 2a 20 77 72 69 74 69 6e 67  y.    ** writing
3730: 20 74 6f 20 69 74 20 77 69 74 68 20 61 6e 6f 74   to it with anot
3740: 68 65 72 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28  her.  */.    if(
3750: 20 70 2d 3e 62 44 65 73 74 4c 6f 63 6b 65 64 3d   p->bDestLocked=
3760: 3d 30 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45  =0 && rc==SQLITE
3770: 5f 4f 4b 20 26 26 20 73 65 74 44 65 73 74 50 67  _OK && setDestPg
3780: 73 7a 28 70 29 3d 3d 53 51 4c 49 54 45 5f 4e 4f  sz(p)==SQLITE_NO
3790: 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 72 63 20  MEM ){.      rc 
37a0: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  = SQLITE_NOMEM;.
37b0: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 4c 6f      }..    /* Lo
37c0: 63 6b 20 74 68 65 20 64 65 73 74 69 6e 61 74 69  ck the destinati
37d0: 6f 6e 20 64 61 74 61 62 61 73 65 2c 20 69 66 20  on database, if 
37e0: 69 74 20 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64  it is not locked
37f0: 20 61 6c 72 65 61 64 79 2e 20 2a 2f 0a 20 20 20   already. */.   
3800: 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d   if( SQLITE_OK==
3810: 72 63 20 26 26 20 70 2d 3e 62 44 65 73 74 4c 6f  rc && p->bDestLo
3820: 63 6b 65 64 3d 3d 30 0a 20 20 20 20 20 26 26 20  cked==0.     && 
3830: 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d  SQLITE_OK==(rc =
3840: 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 67   sqlite3BtreeBeg
3850: 69 6e 54 72 61 6e 73 28 70 2d 3e 70 44 65 73 74  inTrans(p->pDest
3860: 2c 20 32 2c 0a 20 20 20 20 20 20 20 20 20 20 20  , 2,.           
3870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3890: 20 20 20 20 20 28 69 6e 74 2a 29 26 70 2d 3e 69       (int*)&p->i
38a0: 44 65 73 74 53 63 68 65 6d 61 29 29 20 0a 20 20  DestSchema)) .  
38b0: 20 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 62 44    ){.      p->bD
38c0: 65 73 74 4c 6f 63 6b 65 64 20 3d 20 31 3b 0a 20  estLocked = 1;. 
38d0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20     }..    /* Do 
38e0: 6e 6f 74 20 61 6c 6c 6f 77 20 62 61 63 6b 75 70  not allow backup
38f0: 20 69 66 20 74 68 65 20 64 65 73 74 69 6e 61 74   if the destinat
3900: 69 6f 6e 20 64 61 74 61 62 61 73 65 20 69 73 20  ion database is 
3910: 69 6e 20 57 41 4c 20 6d 6f 64 65 0a 20 20 20 20  in WAL mode.    
3920: 2a 2a 20 61 6e 64 20 74 68 65 20 70 61 67 65 20  ** and the page 
3930: 73 69 7a 65 73 20 61 72 65 20 64 69 66 66 65 72  sizes are differ
3940: 65 6e 74 20 62 65 74 77 65 65 6e 20 73 6f 75 72  ent between sour
3950: 63 65 20 61 6e 64 20 64 65 73 74 69 6e 61 74 69  ce and destinati
3960: 6f 6e 20 2a 2f 0a 20 20 20 20 70 67 73 7a 53 72  on */.    pgszSr
3970: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
3980: 47 65 74 50 61 67 65 53 69 7a 65 28 70 2d 3e 70  GetPageSize(p->p
3990: 53 72 63 29 3b 0a 20 20 20 20 70 67 73 7a 44 65  Src);.    pgszDe
39a0: 73 74 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  st = sqlite3Btre
39b0: 65 47 65 74 50 61 67 65 53 69 7a 65 28 70 2d 3e  eGetPageSize(p->
39c0: 70 44 65 73 74 29 3b 0a 20 20 20 20 64 65 73 74  pDest);.    dest
39d0: 4d 6f 64 65 20 3d 20 73 71 6c 69 74 65 33 50 61  Mode = sqlite3Pa
39e0: 67 65 72 47 65 74 4a 6f 75 72 6e 61 6c 4d 6f 64  gerGetJournalMod
39f0: 65 28 73 71 6c 69 74 65 33 42 74 72 65 65 50 61  e(sqlite3BtreePa
3a00: 67 65 72 28 70 2d 3e 70 44 65 73 74 29 29 3b 0a  ger(p->pDest));.
3a10: 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f      if( SQLITE_O
3a20: 4b 3d 3d 72 63 20 26 26 20 64 65 73 74 4d 6f 64  K==rc && destMod
3a30: 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c  e==PAGER_JOURNAL
3a40: 4d 4f 44 45 5f 57 41 4c 20 26 26 20 70 67 73 7a  MODE_WAL && pgsz
3a50: 53 72 63 21 3d 70 67 73 7a 44 65 73 74 20 29 7b  Src!=pgszDest ){
3a60: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49  .      rc = SQLI
3a70: 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20  TE_READONLY;.   
3a80: 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 4e 6f 77   }.  .    /* Now
3a90: 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 61   that there is a
3aa0: 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 74 68   read-lock on th
3ab0: 65 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73  e source databas
3ac0: 65 2c 20 71 75 65 72 79 20 74 68 65 0a 20 20 20  e, query the.   
3ad0: 20 2a 2a 20 73 6f 75 72 63 65 20 70 61 67 65 72   ** source pager
3ae0: 20 66 6f 72 20 74 68 65 20 6e 75 6d 62 65 72 20   for the number 
3af0: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  of pages in the 
3b00: 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 2a 2f  database..    */
3b10: 0a 20 20 20 20 6e 53 72 63 50 61 67 65 20 3d 20  .    nSrcPage = 
3b20: 28 69 6e 74 29 73 71 6c 69 74 65 33 42 74 72 65  (int)sqlite3Btre
3b30: 65 4c 61 73 74 50 61 67 65 28 70 2d 3e 70 53 72  eLastPage(p->pSr
3b40: 63 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  c);.    assert( 
3b50: 6e 53 72 63 50 61 67 65 3e 3d 30 20 29 3b 0a 20  nSrcPage>=0 );. 
3b60: 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 28 6e 50     for(ii=0; (nP
3b70: 61 67 65 3c 30 20 7c 7c 20 69 69 3c 6e 50 61 67  age<0 || ii<nPag
3b80: 65 29 20 26 26 20 70 2d 3e 69 4e 65 78 74 3c 3d  e) && p->iNext<=
3b90: 28 50 67 6e 6f 29 6e 53 72 63 50 61 67 65 20 26  (Pgno)nSrcPage &
3ba0: 26 20 21 72 63 3b 20 69 69 2b 2b 29 7b 0a 20 20  & !rc; ii++){.  
3bb0: 20 20 20 20 63 6f 6e 73 74 20 50 67 6e 6f 20 69      const Pgno i
3bc0: 53 72 63 50 67 20 3d 20 70 2d 3e 69 4e 65 78 74  SrcPg = p->iNext
3bd0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
3be0: 20 20 2f 2a 20 53 6f 75 72 63 65 20 70 61 67 65    /* Source page
3bf0: 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 20 20 20   number */.     
3c00: 20 69 66 28 20 69 53 72 63 50 67 21 3d 50 45 4e   if( iSrcPg!=PEN
3c10: 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70  DING_BYTE_PAGE(p
3c20: 2d 3e 70 53 72 63 2d 3e 70 42 74 29 20 29 7b 0a  ->pSrc->pBt) ){.
3c30: 20 20 20 20 20 20 20 20 44 62 50 61 67 65 20 2a          DbPage *
3c40: 70 53 72 63 50 67 3b 20 20 20 20 20 20 20 20 20  pSrcPg;         
3c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3c60: 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 70 61      /* Source pa
3c70: 67 65 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 20  ge object */.   
3c80: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
3c90: 33 50 61 67 65 72 47 65 74 28 70 53 72 63 50 61  3PagerGet(pSrcPa
3ca0: 67 65 72 2c 20 69 53 72 63 50 67 2c 20 26 70 53  ger, iSrcPg, &pS
3cb0: 72 63 50 67 2c 50 41 47 45 52 5f 47 45 54 5f 52  rcPg,PAGER_GET_R
3cc0: 45 41 44 4f 4e 4c 59 29 3b 0a 20 20 20 20 20 20  EADONLY);.      
3cd0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
3ce0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20  _OK ){.         
3cf0: 20 72 63 20 3d 20 62 61 63 6b 75 70 4f 6e 65 50   rc = backupOneP
3d00: 61 67 65 28 70 2c 20 69 53 72 63 50 67 2c 20 73  age(p, iSrcPg, s
3d10: 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61  qlite3PagerGetDa
3d20: 74 61 28 70 53 72 63 50 67 29 2c 20 30 29 3b 0a  ta(pSrcPg), 0);.
3d30: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
3d40: 33 50 61 67 65 72 55 6e 72 65 66 28 70 53 72 63  3PagerUnref(pSrc
3d50: 50 67 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  Pg);.        }. 
3d60: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 2d 3e       }.      p->
3d70: 69 4e 65 78 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20  iNext++;.    }. 
3d80: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
3d90: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 2d  E_OK ){.      p-
3da0: 3e 6e 50 61 67 65 63 6f 75 6e 74 20 3d 20 6e 53  >nPagecount = nS
3db0: 72 63 50 61 67 65 3b 0a 20 20 20 20 20 20 70 2d  rcPage;.      p-
3dc0: 3e 6e 52 65 6d 61 69 6e 69 6e 67 20 3d 20 6e 53  >nRemaining = nS
3dd0: 72 63 50 61 67 65 2b 31 2d 70 2d 3e 69 4e 65 78  rcPage+1-p->iNex
3de0: 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e  t;.      if( p->
3df0: 69 4e 65 78 74 3e 28 50 67 6e 6f 29 6e 53 72 63  iNext>(Pgno)nSrc
3e00: 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20  Page ){.        
3e10: 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45  rc = SQLITE_DONE
3e20: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66  ;.      }else if
3e30: 28 20 21 70 2d 3e 69 73 41 74 74 61 63 68 65 64  ( !p->isAttached
3e40: 20 29 7b 0a 20 20 20 20 20 20 20 20 61 74 74 61   ){.        atta
3e50: 63 68 42 61 63 6b 75 70 4f 62 6a 65 63 74 28 70  chBackupObject(p
3e60: 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  );.      }.    }
3e70: 0a 20 20 0a 20 20 20 20 2f 2a 20 55 70 64 61 74  .  .    /* Updat
3e80: 65 20 74 68 65 20 73 63 68 65 6d 61 20 76 65 72  e the schema ver
3e90: 73 69 6f 6e 20 66 69 65 6c 64 20 69 6e 20 74 68  sion field in th
3ea0: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61  e destination da
3eb0: 74 61 62 61 73 65 2e 20 54 68 69 73 0a 20 20 20  tabase. This.   
3ec0: 20 2a 2a 20 69 73 20 74 6f 20 6d 61 6b 65 20 73   ** is to make s
3ed0: 75 72 65 20 74 68 61 74 20 74 68 65 20 73 63 68  ure that the sch
3ee0: 65 6d 61 2d 76 65 72 73 69 6f 6e 20 72 65 61 6c  ema-version real
3ef0: 6c 79 20 64 6f 65 73 20 63 68 61 6e 67 65 20 69  ly does change i
3f00: 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 61 73  n.    ** the cas
3f10: 65 20 77 68 65 72 65 20 74 68 65 20 73 6f 75 72  e where the sour
3f20: 63 65 20 61 6e 64 20 64 65 73 74 69 6e 61 74 69  ce and destinati
3f30: 6f 6e 20 64 61 74 61 62 61 73 65 73 20 68 61 76  on databases hav
3f40: 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 73 61 6d  e the.    ** sam
3f50: 65 20 73 63 68 65 6d 61 20 76 65 72 73 69 6f 6e  e schema version
3f60: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
3f70: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45   rc==SQLITE_DONE
3f80: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6e 53   ){.      if( nS
3f90: 72 63 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20  rcPage==0 ){.   
3fa0: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
3fb0: 33 42 74 72 65 65 4e 65 77 44 62 28 70 2d 3e 70  3BtreeNewDb(p->p
3fc0: 44 65 73 74 29 3b 0a 20 20 20 20 20 20 20 20 6e  Dest);.        n
3fd0: 53 72 63 50 61 67 65 20 3d 20 31 3b 0a 20 20 20  SrcPage = 1;.   
3fe0: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72     }.      if( r
3ff0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c==SQLITE_OK || 
4000: 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20  rc==SQLITE_DONE 
4010: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  ){.        rc = 
4020: 73 71 6c 69 74 65 33 42 74 72 65 65 55 70 64 61  sqlite3BtreeUpda
4030: 74 65 4d 65 74 61 28 70 2d 3e 70 44 65 73 74 2c  teMeta(p->pDest,
4040: 31 2c 70 2d 3e 69 44 65 73 74 53 63 68 65 6d 61  1,p->iDestSchema
4050: 2b 31 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  +1);.      }.   
4060: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
4070: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20  E_OK ){.        
4080: 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62 20 29  if( p->pDestDb )
4090: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
40a0: 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d  te3ResetAllSchem
40b0: 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 70  asOfConnection(p
40c0: 2d 3e 70 44 65 73 74 44 62 29 3b 0a 20 20 20 20  ->pDestDb);.    
40d0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66      }.        if
40e0: 28 20 64 65 73 74 4d 6f 64 65 3d 3d 50 41 47 45  ( destMode==PAGE
40f0: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41  R_JOURNALMODE_WA
4100: 4c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72  L ){.          r
4110: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
4120: 53 65 74 56 65 72 73 69 6f 6e 28 70 2d 3e 70 44  SetVersion(p->pD
4130: 65 73 74 2c 20 32 29 3b 0a 20 20 20 20 20 20 20  est, 2);.       
4140: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20   }.      }.     
4150: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
4160: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e  OK ){.        in
4170: 74 20 6e 44 65 73 74 54 72 75 6e 63 61 74 65 3b  t nDestTruncate;
4180: 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 65 74 20  .        /* Set 
4190: 6e 44 65 73 74 54 72 75 6e 63 61 74 65 20 74 6f  nDestTruncate to
41a0: 20 74 68 65 20 66 69 6e 61 6c 20 6e 75 6d 62 65   the final numbe
41b0: 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68  r of pages in th
41c0: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 0a 20 20  e destination.  
41d0: 20 20 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73        ** databas
41e0: 65 2e 20 54 68 65 20 63 6f 6d 70 6c 69 63 61 74  e. The complicat
41f0: 69 6f 6e 20 68 65 72 65 20 69 73 20 74 68 61 74  ion here is that
4200: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
4210: 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a 2a   page.        **
4220: 20 73 69 7a 65 20 6d 61 79 20 62 65 20 64 69 66   size may be dif
4230: 66 65 72 65 6e 74 20 74 6f 20 74 68 65 20 73 6f  ferent to the so
4240: 75 72 63 65 20 70 61 67 65 20 73 69 7a 65 2e 20  urce page size. 
4250: 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20  .        **.    
4260: 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20 73 6f      ** If the so
4270: 75 72 63 65 20 70 61 67 65 20 73 69 7a 65 20 69  urce page size i
4280: 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 74  s smaller than t
4290: 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 70  he destination p
42a0: 61 67 65 20 73 69 7a 65 2c 20 0a 20 20 20 20 20  age size, .     
42b0: 20 20 20 2a 2a 20 72 6f 75 6e 64 20 75 70 2e 20     ** round up. 
42c0: 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65  In this case the
42d0: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
42e0: 4f 73 54 72 75 6e 63 61 74 65 28 29 20 62 65 6c  OsTruncate() bel
42f0: 6f 77 20 77 69 6c 6c 0a 20 20 20 20 20 20 20 20  ow will.        
4300: 2a 2a 20 66 69 78 20 74 68 65 20 73 69 7a 65 20  ** fix the size 
4310: 6f 66 20 74 68 65 20 66 69 6c 65 2e 20 48 6f 77  of the file. How
4320: 65 76 65 72 20 69 74 20 69 73 20 69 6d 70 6f 72  ever it is impor
4330: 74 61 6e 74 20 74 6f 20 63 61 6c 6c 0a 20 20 20  tant to call.   
4340: 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 50       ** sqlite3P
4350: 61 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67  agerTruncateImag
4360: 65 28 29 20 68 65 72 65 20 73 6f 20 74 68 61 74  e() here so that
4370: 20 61 6e 79 20 70 61 67 65 73 20 69 6e 20 74 68   any pages in th
4380: 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 65  e .        ** de
4390: 73 74 69 6e 61 74 69 6f 6e 20 66 69 6c 65 20 74  stination file t
43a0: 68 61 74 20 6c 69 65 20 62 65 79 6f 6e 64 20 74  hat lie beyond t
43b0: 68 65 20 6e 44 65 73 74 54 72 75 6e 63 61 74 65  he nDestTruncate
43c0: 20 70 61 67 65 20 6d 61 72 6b 20 61 72 65 0a 20   page mark are. 
43d0: 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61         ** journa
43e0: 6c 6c 65 64 20 62 79 20 50 61 67 65 72 43 6f 6d  lled by PagerCom
43f0: 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 20 62 65  mitPhaseOne() be
4400: 66 6f 72 65 20 74 68 65 79 20 61 72 65 20 64 65  fore they are de
4410: 73 74 72 6f 79 65 64 0a 20 20 20 20 20 20 20 20  stroyed.        
4420: 2a 2a 20 62 79 20 74 68 65 20 66 69 6c 65 20 74  ** by the file t
4430: 72 75 6e 63 61 74 69 6f 6e 2e 0a 20 20 20 20 20  runcation..     
4440: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73     */.        as
4450: 73 65 72 74 28 20 70 67 73 7a 53 72 63 3d 3d 73  sert( pgszSrc==s
4460: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61  qlite3BtreeGetPa
4470: 67 65 53 69 7a 65 28 70 2d 3e 70 53 72 63 29 20  geSize(p->pSrc) 
4480: 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  );.        asser
4490: 74 28 20 70 67 73 7a 44 65 73 74 3d 3d 73 71 6c  t( pgszDest==sql
44a0: 69 74 65 33 42 74 72 65 65 47 65 74 50 61 67 65  ite3BtreeGetPage
44b0: 53 69 7a 65 28 70 2d 3e 70 44 65 73 74 29 20 29  Size(p->pDest) )
44c0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 67  ;.        if( pg
44d0: 73 7a 53 72 63 3c 70 67 73 7a 44 65 73 74 20 29  szSrc<pgszDest )
44e0: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20  {.          int 
44f0: 72 61 74 69 6f 20 3d 20 70 67 73 7a 44 65 73 74  ratio = pgszDest
4500: 2f 70 67 73 7a 53 72 63 3b 0a 20 20 20 20 20 20  /pgszSrc;.      
4510: 20 20 20 20 6e 44 65 73 74 54 72 75 6e 63 61 74      nDestTruncat
4520: 65 20 3d 20 28 6e 53 72 63 50 61 67 65 2b 72 61  e = (nSrcPage+ra
4530: 74 69 6f 2d 31 29 2f 72 61 74 69 6f 3b 0a 20 20  tio-1)/ratio;.  
4540: 20 20 20 20 20 20 20 20 69 66 28 20 6e 44 65 73          if( nDes
4550: 74 54 72 75 6e 63 61 74 65 3d 3d 28 69 6e 74 29  tTruncate==(int)
4560: 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47  PENDING_BYTE_PAG
4570: 45 28 70 2d 3e 70 44 65 73 74 2d 3e 70 42 74 29  E(p->pDest->pBt)
4580: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
4590: 6e 44 65 73 74 54 72 75 6e 63 61 74 65 2d 2d 3b  nDestTruncate--;
45a0: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20  .          }.   
45b0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
45c0: 20 20 20 20 20 20 6e 44 65 73 74 54 72 75 6e 63        nDestTrunc
45d0: 61 74 65 20 3d 20 6e 53 72 63 50 61 67 65 20 2a  ate = nSrcPage *
45e0: 20 28 70 67 73 7a 53 72 63 2f 70 67 73 7a 44 65   (pgszSrc/pgszDe
45f0: 73 74 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  st);.        }. 
4600: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e         assert( n
4610: 44 65 73 74 54 72 75 6e 63 61 74 65 3e 30 20 29  DestTruncate>0 )
4620: 3b 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  ;..        if( p
4630: 67 73 7a 53 72 63 3c 70 67 73 7a 44 65 73 74 20  gszSrc<pgszDest 
4640: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ){.          /* 
4650: 49 66 20 74 68 65 20 73 6f 75 72 63 65 20 70 61  If the source pa
4660: 67 65 2d 73 69 7a 65 20 69 73 20 73 6d 61 6c 6c  ge-size is small
4670: 65 72 20 74 68 61 6e 20 74 68 65 20 64 65 73 74  er than the dest
4680: 69 6e 61 74 69 6f 6e 20 70 61 67 65 2d 73 69 7a  ination page-siz
4690: 65 2c 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  e,.          ** 
46a0: 74 77 6f 20 65 78 74 72 61 20 74 68 69 6e 67 73  two extra things
46b0: 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 68 61 70   may need to hap
46c0: 70 65 6e 3a 0a 20 20 20 20 20 20 20 20 20 20 2a  pen:.          *
46d0: 2a 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 20  *.          **  
46e0: 20 2a 20 54 68 65 20 64 65 73 74 69 6e 61 74 69   * The destinati
46f0: 6f 6e 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62  on may need to b
4700: 65 20 74 72 75 6e 63 61 74 65 64 2c 20 61 6e 64  e truncated, and
4710: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 0a 20 20  .          **.  
4720: 20 20 20 20 20 20 20 20 2a 2a 20 20 20 2a 20 44          **   * D
4730: 61 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 74 68  ata stored on th
4740: 65 20 70 61 67 65 73 20 69 6d 6d 65 64 69 61 74  e pages immediat
4750: 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68  ely following th
4760: 65 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20  e .          ** 
4770: 20 20 20 20 70 65 6e 64 69 6e 67 2d 62 79 74 65      pending-byte
4780: 20 70 61 67 65 20 69 6e 20 74 68 65 20 73 6f 75   page in the sou
4790: 72 63 65 20 64 61 74 61 62 61 73 65 20 6d 61 79  rce database may
47a0: 20 6e 65 65 64 20 74 6f 20 62 65 0a 20 20 20 20   need to be.    
47b0: 20 20 20 20 20 20 2a 2a 20 20 20 20 20 63 6f 70        **     cop
47c0: 69 65 64 20 69 6e 74 6f 20 74 68 65 20 64 65 73  ied into the des
47d0: 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73  tination databas
47e0: 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f 0a  e..          */.
47f0: 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20            const 
4800: 69 36 34 20 69 53 69 7a 65 20 3d 20 28 69 36 34  i64 iSize = (i64
4810: 29 70 67 73 7a 53 72 63 20 2a 20 28 69 36 34 29  )pgszSrc * (i64)
4820: 6e 53 72 63 50 61 67 65 3b 0a 20 20 20 20 20 20  nSrcPage;.      
4830: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65      sqlite3_file
4840: 20 2a 20 63 6f 6e 73 74 20 70 46 69 6c 65 20 3d   * const pFile =
4850: 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 6c   sqlite3PagerFil
4860: 65 28 70 44 65 73 74 50 61 67 65 72 29 3b 0a 20  e(pDestPager);. 
4870: 20 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 50           Pgno iP
4880: 67 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74  g;.          int
4890: 20 6e 44 73 74 50 61 67 65 3b 0a 20 20 20 20 20   nDstPage;.     
48a0: 20 20 20 20 20 69 36 34 20 69 4f 66 66 3b 0a 20       i64 iOff;. 
48b0: 20 20 20 20 20 20 20 20 20 69 36 34 20 69 45 6e           i64 iEn
48c0: 64 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 61 73  d;..          as
48d0: 73 65 72 74 28 20 70 46 69 6c 65 20 29 3b 0a 20  sert( pFile );. 
48e0: 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28           assert(
48f0: 20 6e 44 65 73 74 54 72 75 6e 63 61 74 65 3d 3d   nDestTruncate==
4900: 30 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  0 .             
4910: 20 7c 7c 20 28 69 36 34 29 6e 44 65 73 74 54 72   || (i64)nDestTr
4920: 75 6e 63 61 74 65 2a 28 69 36 34 29 70 67 73 7a  uncate*(i64)pgsz
4930: 44 65 73 74 20 3e 3d 20 69 53 69 7a 65 20 7c 7c  Dest >= iSize ||
4940: 20 28 0a 20 20 20 20 20 20 20 20 20 20 20 20 20   (.             
4950: 20 20 20 6e 44 65 73 74 54 72 75 6e 63 61 74 65     nDestTruncate
4960: 3d 3d 28 69 6e 74 29 28 50 45 4e 44 49 4e 47 5f  ==(int)(PENDING_
4970: 42 59 54 45 5f 50 41 47 45 28 70 2d 3e 70 44 65  BYTE_PAGE(p->pDe
4980: 73 74 2d 3e 70 42 74 29 2d 31 29 0a 20 20 20 20  st->pBt)-1).    
4990: 20 20 20 20 20 20 20 20 20 26 26 20 69 53 69 7a           && iSiz
49a0: 65 3e 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 20  e>=PENDING_BYTE 
49b0: 26 26 20 69 53 69 7a 65 3c 3d 50 45 4e 44 49 4e  && iSize<=PENDIN
49c0: 47 5f 42 59 54 45 2b 70 67 73 7a 44 65 73 74 0a  G_BYTE+pgszDest.
49d0: 20 20 20 20 20 20 20 20 20 20 29 29 3b 0a 0a 20            ));.. 
49e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73           /* This
49f0: 20 62 6c 6f 63 6b 20 65 6e 73 75 72 65 73 20 74   block ensures t
4a00: 68 61 74 20 61 6c 6c 20 64 61 74 61 20 72 65 71  hat all data req
4a10: 75 69 72 65 64 20 74 6f 20 72 65 63 72 65 61 74  uired to recreat
4a20: 65 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 0a 20  e the original. 
4a30: 20 20 20 20 20 20 20 20 20 2a 2a 20 64 61 74 61           ** data
4a40: 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 73 74  base has been st
4a50: 6f 72 65 64 20 69 6e 20 74 68 65 20 6a 6f 75 72  ored in the jour
4a60: 6e 61 6c 20 66 6f 72 20 70 44 65 73 74 50 61 67  nal for pDestPag
4a70: 65 72 20 61 6e 64 20 74 68 65 0a 20 20 20 20 20  er and the.     
4a80: 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20       ** journal 
4a90: 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 20  synced to disk. 
4aa0: 53 6f 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74  So at this point
4ab0: 20 77 65 20 6d 61 79 20 73 61 66 65 6c 79 20 6d   we may safely m
4ac0: 6f 64 69 66 79 0a 20 20 20 20 20 20 20 20 20 20  odify.          
4ad0: 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ** the database 
4ae0: 66 69 6c 65 20 69 6e 20 61 6e 79 20 77 61 79 2c  file in any way,
4af0: 20 6b 6e 6f 77 69 6e 67 20 74 68 61 74 20 69 66   knowing that if
4b00: 20 61 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65   a power failure
4b10: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 6f 63  .          ** oc
4b20: 63 75 72 73 2c 20 74 68 65 20 6f 72 69 67 69 6e  curs, the origin
4b30: 61 6c 20 64 61 74 61 62 61 73 65 20 77 69 6c 6c  al database will
4b40: 20 62 65 20 72 65 63 6f 6e 73 74 72 75 63 74 65   be reconstructe
4b50: 64 20 66 72 6f 6d 20 74 68 65 20 0a 20 20 20 20  d from the .    
4b60: 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c        ** journal
4b70: 20 66 69 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 20   file.  */.     
4b80: 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65       sqlite3Page
4b90: 72 50 61 67 65 63 6f 75 6e 74 28 70 44 65 73 74  rPagecount(pDest
4ba0: 50 61 67 65 72 2c 20 26 6e 44 73 74 50 61 67 65  Pager, &nDstPage
4bb0: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72  );.          for
4bc0: 28 69 50 67 3d 6e 44 65 73 74 54 72 75 6e 63 61  (iPg=nDestTrunca
4bd0: 74 65 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  te; rc==SQLITE_O
4be0: 4b 20 26 26 20 69 50 67 3c 3d 28 50 67 6e 6f 29  K && iPg<=(Pgno)
4bf0: 6e 44 73 74 50 61 67 65 3b 20 69 50 67 2b 2b 29  nDstPage; iPg++)
4c00: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  {.            if
4c10: 28 20 69 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42  ( iPg!=PENDING_B
4c20: 59 54 45 5f 50 41 47 45 28 70 2d 3e 70 44 65 73  YTE_PAGE(p->pDes
4c30: 74 2d 3e 70 42 74 29 20 29 7b 0a 20 20 20 20 20  t->pBt) ){.     
4c40: 20 20 20 20 20 20 20 20 20 44 62 50 61 67 65 20           DbPage 
4c50: 2a 70 50 67 3b 0a 20 20 20 20 20 20 20 20 20 20  *pPg;.          
4c60: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
4c70: 50 61 67 65 72 47 65 74 28 70 44 65 73 74 50 61  PagerGet(pDestPa
4c80: 67 65 72 2c 20 69 50 67 2c 20 26 70 50 67 2c 20  ger, iPg, &pPg, 
4c90: 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  0);.            
4ca0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
4cb0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20  _OK ){.         
4cc0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
4cd0: 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50  te3PagerWrite(pP
4ce0: 67 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  g);.            
4cf0: 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72      sqlite3Pager
4d00: 55 6e 72 65 66 28 70 50 67 29 3b 0a 20 20 20 20  Unref(pPg);.    
4d10: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
4d20: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
4d30: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20      }.          
4d40: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
4d50: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  K ){.           
4d60: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67   rc = sqlite3Pag
4d70: 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65  erCommitPhaseOne
4d80: 28 70 44 65 73 74 50 61 67 65 72 2c 20 30 2c 20  (pDestPager, 0, 
4d90: 31 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  1);.          }.
4da0: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72  .          /* Wr
4db0: 69 74 65 20 74 68 65 20 65 78 74 72 61 20 70 61  ite the extra pa
4dc0: 67 65 73 20 61 6e 64 20 74 72 75 6e 63 61 74 65  ges and truncate
4dd0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
4de0: 6c 65 20 61 73 20 72 65 71 75 69 72 65 64 20 2a  le as required *
4df0: 2f 0a 20 20 20 20 20 20 20 20 20 20 69 45 6e 64  /.          iEnd
4e00: 20 3d 20 4d 49 4e 28 50 45 4e 44 49 4e 47 5f 42   = MIN(PENDING_B
4e10: 59 54 45 20 2b 20 70 67 73 7a 44 65 73 74 2c 20  YTE + pgszDest, 
4e20: 69 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 20  iSize);.        
4e30: 20 20 66 6f 72 28 0a 20 20 20 20 20 20 20 20 20    for(.         
4e40: 20 20 20 69 4f 66 66 3d 50 45 4e 44 49 4e 47 5f     iOff=PENDING_
4e50: 42 59 54 45 2b 70 67 73 7a 53 72 63 3b 20 0a 20  BYTE+pgszSrc; . 
4e60: 20 20 20 20 20 20 20 20 20 20 20 72 63 3d 3d 53             rc==S
4e70: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4f 66 66  QLITE_OK && iOff
4e80: 3c 69 45 6e 64 3b 20 0a 20 20 20 20 20 20 20 20  <iEnd; .        
4e90: 20 20 20 20 69 4f 66 66 2b 3d 70 67 73 7a 53 72      iOff+=pgszSr
4ea0: 63 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20  c.          ){. 
4eb0: 20 20 20 20 20 20 20 20 20 20 20 50 67 48 64 72             PgHdr
4ec0: 20 2a 70 53 72 63 50 67 20 3d 20 30 3b 0a 20 20   *pSrcPg = 0;.  
4ed0: 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20            const 
4ee0: 50 67 6e 6f 20 69 53 72 63 50 67 20 3d 20 28 50  Pgno iSrcPg = (P
4ef0: 67 6e 6f 29 28 28 69 4f 66 66 2f 70 67 73 7a 53  gno)((iOff/pgszS
4f00: 72 63 29 2b 31 29 3b 0a 20 20 20 20 20 20 20 20  rc)+1);.        
4f10: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
4f20: 50 61 67 65 72 47 65 74 28 70 53 72 63 50 61 67  PagerGet(pSrcPag
4f30: 65 72 2c 20 69 53 72 63 50 67 2c 20 26 70 53 72  er, iSrcPg, &pSr
4f40: 63 50 67 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  cPg, 0);.       
4f50: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
4f60: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20  ITE_OK ){.      
4f70: 20 20 20 20 20 20 20 20 75 38 20 2a 7a 44 61 74          u8 *zDat
4f80: 61 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72  a = sqlite3Pager
4f90: 47 65 74 44 61 74 61 28 70 53 72 63 50 67 29 3b  GetData(pSrcPg);
4fa0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72  .              r
4fb0: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69  c = sqlite3OsWri
4fc0: 74 65 28 70 46 69 6c 65 2c 20 7a 44 61 74 61 2c  te(pFile, zData,
4fd0: 20 70 67 73 7a 53 72 63 2c 20 69 4f 66 66 29 3b   pgszSrc, iOff);
4fe0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20  .            }. 
4ff0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
5000: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 53 72  e3PagerUnref(pSr
5010: 63 50 67 29 3b 0a 20 20 20 20 20 20 20 20 20 20  cPg);.          
5020: 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20  }.          if( 
5030: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
5040: 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20  .            rc 
5050: 3d 20 62 61 63 6b 75 70 54 72 75 6e 63 61 74 65  = backupTruncate
5060: 46 69 6c 65 28 70 46 69 6c 65 2c 20 69 53 69 7a  File(pFile, iSiz
5070: 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  e);.          }.
5080: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 79  .          /* Sy
5090: 6e 63 20 74 68 65 20 64 61 74 61 62 61 73 65 20  nc the database 
50a0: 66 69 6c 65 20 74 6f 20 64 69 73 6b 2e 20 2a 2f  file to disk. */
50b0: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72  .          if( r
50c0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
50d0: 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d              rc =
50e0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 79 6e   sqlite3PagerSyn
50f0: 63 28 70 44 65 73 74 50 61 67 65 72 2c 20 30 29  c(pDestPager, 0)
5100: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
5110: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
5120: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61         sqlite3Pa
5130: 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67 65  gerTruncateImage
5140: 28 70 44 65 73 74 50 61 67 65 72 2c 20 6e 44 65  (pDestPager, nDe
5150: 73 74 54 72 75 6e 63 61 74 65 29 3b 0a 20 20 20  stTruncate);.   
5160: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
5170: 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 68  te3PagerCommitPh
5180: 61 73 65 4f 6e 65 28 70 44 65 73 74 50 61 67 65  aseOne(pDestPage
5190: 72 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20  r, 0, 0);.      
51a0: 20 20 7d 0a 20 20 20 20 0a 20 20 20 20 20 20 20    }.    .       
51b0: 20 2f 2a 20 46 69 6e 69 73 68 20 63 6f 6d 6d 69   /* Finish commi
51c0: 74 74 69 6e 67 20 74 68 65 20 74 72 61 6e 73 61  tting the transa
51d0: 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 64 65 73  ction to the des
51e0: 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73  tination databas
51f0: 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66  e. */.        if
5200: 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 72 63 0a  ( SQLITE_OK==rc.
5210: 20 20 20 20 20 20 20 20 20 26 26 20 53 51 4c 49           && SQLI
5220: 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 73 71 6c  TE_OK==(rc = sql
5230: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50  ite3BtreeCommitP
5240: 68 61 73 65 54 77 6f 28 70 2d 3e 70 44 65 73 74  haseTwo(p->pDest
5250: 2c 20 30 29 29 0a 20 20 20 20 20 20 20 20 29 7b  , 0)).        ){
5260: 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20  .          rc = 
5270: 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20  SQLITE_DONE;.   
5280: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
5290: 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49     }.  .    /* I
52a0: 66 20 62 43 6c 6f 73 65 54 72 61 6e 73 20 69 73  f bCloseTrans is
52b0: 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 69 73   true, then this
52c0: 20 66 75 6e 63 74 69 6f 6e 20 6f 70 65 6e 65 64   function opened
52d0: 20 61 20 72 65 61 64 20 74 72 61 6e 73 61 63 74   a read transact
52e0: 69 6f 6e 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68  ion.    ** on th
52f0: 65 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73  e source databas
5300: 65 2e 20 43 6c 6f 73 65 20 74 68 65 20 72 65 61  e. Close the rea
5310: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 65  d transaction he
5320: 72 65 2e 20 54 68 65 72 65 20 69 73 0a 20 20 20  re. There is.   
5330: 20 2a 2a 20 6e 6f 20 6e 65 65 64 20 74 6f 20 63   ** no need to c
5340: 68 65 63 6b 20 74 68 65 20 72 65 74 75 72 6e 20  heck the return 
5350: 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 62 74  values of the bt
5360: 72 65 65 20 6d 65 74 68 6f 64 73 20 68 65 72 65  ree methods here
5370: 2c 20 61 73 0a 20 20 20 20 2a 2a 20 22 63 6f 6d  , as.    ** "com
5380: 6d 69 74 74 69 6e 67 22 20 61 20 72 65 61 64 2d  mitting" a read-
5390: 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e  only transaction
53a0: 20 63 61 6e 6e 6f 74 20 66 61 69 6c 2e 0a 20 20   cannot fail..  
53b0: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 62 43 6c    */.    if( bCl
53c0: 6f 73 65 54 72 61 6e 73 20 29 7b 0a 20 20 20 20  oseTrans ){.    
53d0: 20 20 54 45 53 54 4f 4e 4c 59 28 20 69 6e 74 20    TESTONLY( int 
53e0: 72 63 32 20 29 3b 0a 20 20 20 20 20 20 54 45 53  rc2 );.      TES
53f0: 54 4f 4e 4c 59 28 20 72 63 32 20 20 3d 20 29 20  TONLY( rc2  = ) 
5400: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
5410: 69 74 50 68 61 73 65 4f 6e 65 28 70 2d 3e 70 53  itPhaseOne(p->pS
5420: 72 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 54 45  rc, 0);.      TE
5430: 53 54 4f 4e 4c 59 28 20 72 63 32 20 7c 3d 20 29  STONLY( rc2 |= )
5440: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
5450: 6d 69 74 50 68 61 73 65 54 77 6f 28 70 2d 3e 70  mitPhaseTwo(p->p
5460: 53 72 63 2c 20 30 29 3b 0a 20 20 20 20 20 20 61  Src, 0);.      a
5470: 73 73 65 72 74 28 20 72 63 32 3d 3d 53 51 4c 49  ssert( rc2==SQLI
5480: 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 7d 0a 20  TE_OK );.    }. 
5490: 20 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51   .    if( rc==SQ
54a0: 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d  LITE_IOERR_NOMEM
54b0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53   ){.      rc = S
54c0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54  QLITE_NOMEM_BKPT
54d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 72  ;.    }.    p->r
54e0: 63 20 3d 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66  c = rc;.  }.  if
54f0: 28 20 70 2d 3e 70 44 65 73 74 44 62 20 29 7b 0a  ( p->pDestDb ){.
5500: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
5510: 78 5f 6c 65 61 76 65 28 70 2d 3e 70 44 65 73 74  x_leave(p->pDest
5520: 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a  Db->mutex);.  }.
5530: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65    sqlite3BtreeLe
5540: 61 76 65 28 70 2d 3e 70 53 72 63 29 3b 0a 20 20  ave(p->pSrc);.  
5550: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
5560: 61 76 65 28 70 2d 3e 70 53 72 63 44 62 2d 3e 6d  ave(p->pSrcDb->m
5570: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
5580: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c  rc;.}../*.** Rel
5590: 65 61 73 65 20 61 6c 6c 20 72 65 73 6f 75 72 63  ease all resourc
55a0: 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  es associated wi
55b0: 74 68 20 61 6e 20 73 71 6c 69 74 65 33 5f 62 61  th an sqlite3_ba
55c0: 63 6b 75 70 2a 20 68 61 6e 64 6c 65 2e 0a 2a 2f  ckup* handle..*/
55d0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 61 63  .int sqlite3_bac
55e0: 6b 75 70 5f 66 69 6e 69 73 68 28 73 71 6c 69 74  kup_finish(sqlit
55f0: 65 33 5f 62 61 63 6b 75 70 20 2a 70 29 7b 0a 20  e3_backup *p){. 
5600: 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20   sqlite3_backup 
5610: 2a 2a 70 70 3b 20 20 20 20 20 20 20 20 20 20 20  **pp;           
5620: 20 20 20 20 20 20 2f 2a 20 50 74 72 20 74 6f 20        /* Ptr to 
5630: 68 65 61 64 20 6f 66 20 70 61 67 65 72 73 20 62  head of pagers b
5640: 61 63 6b 75 70 20 6c 69 73 74 20 2a 2f 0a 20 20  ackup list */.  
5650: 73 71 6c 69 74 65 33 20 2a 70 53 72 63 44 62 3b  sqlite3 *pSrcDb;
5660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5670: 20 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 64       /* Source d
5680: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
5690: 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20  on */.  int rc; 
56a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
56b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
56c0: 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20  Value to return 
56d0: 2a 2f 0a 0a 20 20 2f 2a 20 45 6e 74 65 72 20 74  */..  /* Enter t
56e0: 68 65 20 6d 75 74 65 78 65 73 20 2a 2f 0a 20 20  he mutexes */.  
56f0: 69 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72  if( p==0 ) retur
5700: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70  n SQLITE_OK;.  p
5710: 53 72 63 44 62 20 3d 20 70 2d 3e 70 53 72 63 44  SrcDb = p->pSrcD
5720: 62 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  b;.  sqlite3_mut
5730: 65 78 5f 65 6e 74 65 72 28 70 53 72 63 44 62 2d  ex_enter(pSrcDb-
5740: 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74  >mutex);.  sqlit
5750: 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 2d 3e  e3BtreeEnter(p->
5760: 70 53 72 63 29 3b 0a 20 20 69 66 28 20 70 2d 3e  pSrc);.  if( p->
5770: 70 44 65 73 74 44 62 20 29 7b 0a 20 20 20 20 73  pDestDb ){.    s
5780: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
5790: 65 72 28 70 2d 3e 70 44 65 73 74 44 62 2d 3e 6d  er(p->pDestDb->m
57a0: 75 74 65 78 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  utex);.  }..  /*
57b0: 20 44 65 74 61 63 68 20 74 68 69 73 20 62 61 63   Detach this bac
57c0: 6b 75 70 20 66 72 6f 6d 20 74 68 65 20 73 6f 75  kup from the sou
57d0: 72 63 65 20 70 61 67 65 72 2e 20 2a 2f 0a 20 20  rce pager. */.  
57e0: 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62 20 29  if( p->pDestDb )
57f0: 7b 0a 20 20 20 20 70 2d 3e 70 53 72 63 2d 3e 6e  {.    p->pSrc->n
5800: 42 61 63 6b 75 70 2d 2d 3b 0a 20 20 7d 0a 20 20  Backup--;.  }.  
5810: 69 66 28 20 70 2d 3e 69 73 41 74 74 61 63 68 65  if( p->isAttache
5820: 64 20 29 7b 0a 20 20 20 20 70 70 20 3d 20 73 71  d ){.    pp = sq
5830: 6c 69 74 65 33 50 61 67 65 72 42 61 63 6b 75 70  lite3PagerBackup
5840: 50 74 72 28 73 71 6c 69 74 65 33 42 74 72 65 65  Ptr(sqlite3Btree
5850: 50 61 67 65 72 28 70 2d 3e 70 53 72 63 29 29 3b  Pager(p->pSrc));
5860: 0a 20 20 20 20 77 68 69 6c 65 28 20 2a 70 70 21  .    while( *pp!
5870: 3d 70 20 29 7b 0a 20 20 20 20 20 20 70 70 20 3d  =p ){.      pp =
5880: 20 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 3b 0a   &(*pp)->pNext;.
5890: 20 20 20 20 7d 0a 20 20 20 20 2a 70 70 20 3d 20      }.    *pp = 
58a0: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 0a 20  p->pNext;.  }.. 
58b0: 20 2f 2a 20 49 66 20 61 20 74 72 61 6e 73 61 63   /* If a transac
58c0: 74 69 6f 6e 20 69 73 20 73 74 69 6c 6c 20 6f 70  tion is still op
58d0: 65 6e 20 6f 6e 20 74 68 65 20 42 74 72 65 65 2c  en on the Btree,
58e0: 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 2a   roll it back. *
58f0: 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  /.  sqlite3Btree
5900: 52 6f 6c 6c 62 61 63 6b 28 70 2d 3e 70 44 65 73  Rollback(p->pDes
5910: 74 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29  t, SQLITE_OK, 0)
5920: 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20  ;..  /* Set the 
5930: 65 72 72 6f 72 20 63 6f 64 65 20 6f 66 20 74 68  error code of th
5940: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61  e destination da
5950: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a  tabase handle. *
5960: 2f 0a 20 20 72 63 20 3d 20 28 70 2d 3e 72 63 3d  /.  rc = (p->rc=
5970: 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 29 20 3f 20  =SQLITE_DONE) ? 
5980: 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 70 2d 3e 72  SQLITE_OK : p->r
5990: 63 3b 0a 20 20 69 66 28 20 70 2d 3e 70 44 65 73  c;.  if( p->pDes
59a0: 74 44 62 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  tDb ){.    sqlit
59b0: 65 33 45 72 72 6f 72 28 70 2d 3e 70 44 65 73 74  e3Error(p->pDest
59c0: 44 62 2c 20 72 63 29 3b 0a 0a 20 20 20 20 2f 2a  Db, rc);..    /*
59d0: 20 45 78 69 74 20 74 68 65 20 6d 75 74 65 78 65   Exit the mutexe
59e0: 73 20 61 6e 64 20 66 72 65 65 20 74 68 65 20 62  s and free the b
59f0: 61 63 6b 75 70 20 63 6f 6e 74 65 78 74 20 73 74  ackup context st
5a00: 72 75 63 74 75 72 65 2e 20 2a 2f 0a 20 20 20 20  ructure. */.    
5a10: 73 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65  sqlite3LeaveMute
5a20: 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28  xAndCloseZombie(
5a30: 70 2d 3e 70 44 65 73 74 44 62 29 3b 0a 20 20 7d  p->pDestDb);.  }
5a40: 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c  .  sqlite3BtreeL
5a50: 65 61 76 65 28 70 2d 3e 70 53 72 63 29 3b 0a 20  eave(p->pSrc);. 
5a60: 20 69 66 28 20 70 2d 3e 70 44 65 73 74 44 62 20   if( p->pDestDb 
5a70: 29 7b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e  ){.    /* EVIDEN
5a80: 43 45 2d 4f 46 3a 20 52 2d 36 34 38 35 32 2d 32  CE-OF: R-64852-2
5a90: 31 35 39 31 20 54 68 65 20 73 71 6c 69 74 65 33  1591 The sqlite3
5aa0: 5f 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 20 69  _backup object i
5ab0: 73 20 63 72 65 61 74 65 64 20 62 79 20 61 0a 20  s created by a. 
5ac0: 20 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 73 71     ** call to sq
5ad0: 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f 69 6e 69  lite3_backup_ini
5ae0: 74 28 29 20 61 6e 64 20 69 73 20 64 65 73 74 72  t() and is destr
5af0: 6f 79 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74  oyed by a call t
5b00: 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33  o.    ** sqlite3
5b10: 5f 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 29  _backup_finish()
5b20: 2e 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33  . */.    sqlite3
5b30: 5f 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 20 20  _free(p);.  }.  
5b40: 73 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65  sqlite3LeaveMute
5b50: 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28  xAndCloseZombie(
5b60: 70 53 72 63 44 62 29 3b 0a 20 20 72 65 74 75 72  pSrcDb);.  retur
5b70: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
5b80: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
5b90: 20 6f 66 20 70 61 67 65 73 20 73 74 69 6c 6c 20   of pages still 
5ba0: 74 6f 20 62 65 20 62 61 63 6b 65 64 20 75 70 20  to be backed up 
5bb0: 61 73 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72  as of the most r
5bc0: 65 63 65 6e 74 0a 2a 2a 20 63 61 6c 6c 20 74 6f  ecent.** call to
5bd0: 20 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f   sqlite3_backup_
5be0: 73 74 65 70 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73  step()..*/.int s
5bf0: 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f 72 65  qlite3_backup_re
5c00: 6d 61 69 6e 69 6e 67 28 73 71 6c 69 74 65 33 5f  maining(sqlite3_
5c10: 62 61 63 6b 75 70 20 2a 70 29 7b 0a 23 69 66 64  backup *p){.#ifd
5c20: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
5c30: 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28  _API_ARMOR.  if(
5c40: 20 70 3d 3d 30 20 29 7b 0a 20 20 20 20 28 76 6f   p==0 ){.    (vo
5c50: 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  id)SQLITE_MISUSE
5c60: 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72  _BKPT;.    retur
5c70: 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  n 0;.  }.#endif.
5c80: 20 20 72 65 74 75 72 6e 20 70 2d 3e 6e 52 65 6d    return p->nRem
5c90: 61 69 6e 69 6e 67 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  aining;.}../*.**
5ca0: 20 52 65 74 75 72 6e 20 74 68 65 20 74 6f 74 61   Return the tota
5cb0: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  l number of page
5cc0: 73 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20  s in the source 
5cd0: 64 61 74 61 62 61 73 65 20 61 73 20 6f 66 20 74  database as of t
5ce0: 68 65 20 6d 6f 73 74 20 0a 2a 2a 20 72 65 63 65  he most .** rece
5cf0: 6e 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74  nt call to sqlit
5d00: 65 33 5f 62 61 63 6b 75 70 5f 73 74 65 70 28 29  e3_backup_step()
5d10: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
5d20: 5f 62 61 63 6b 75 70 5f 70 61 67 65 63 6f 75 6e  _backup_pagecoun
5d30: 74 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70  t(sqlite3_backup
5d40: 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 4c   *p){.#ifdef SQL
5d50: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41  ITE_ENABLE_API_A
5d60: 52 4d 4f 52 0a 20 20 69 66 28 20 70 3d 3d 30 20  RMOR.  if( p==0 
5d70: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c  ){.    (void)SQL
5d80: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b  ITE_MISUSE_BKPT;
5d90: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
5da0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75   }.#endif.  retu
5db0: 72 6e 20 70 2d 3e 6e 50 61 67 65 63 6f 75 6e 74  rn p->nPagecount
5dc0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
5dd0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
5de0: 65 64 20 61 66 74 65 72 20 74 68 65 20 63 6f 6e  ed after the con
5df0: 74 65 6e 74 73 20 6f 66 20 70 61 67 65 20 69 50  tents of page iP
5e00: 61 67 65 20 6f 66 20 74 68 65 0a 2a 2a 20 73 6f  age of the.** so
5e10: 75 72 63 65 20 64 61 74 61 62 61 73 65 20 68 61  urce database ha
5e20: 76 65 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64  ve been modified
5e30: 2e 20 49 66 20 70 61 67 65 20 69 50 61 67 65 20  . If page iPage 
5e40: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e  has already been
5e50: 20 0a 2a 2a 20 63 6f 70 69 65 64 20 69 6e 74 6f   .** copied into
5e60: 20 74 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e   the destination
5e70: 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e 20   database, then 
5e80: 74 68 65 20 64 61 74 61 20 77 72 69 74 74 65 6e  the data written
5e90: 20 74 6f 20 74 68 65 0a 2a 2a 20 64 65 73 74 69   to the.** desti
5ea0: 6e 61 74 69 6f 6e 20 69 73 20 6e 6f 77 20 69 6e  nation is now in
5eb0: 76 61 6c 69 64 61 74 65 64 2e 20 54 68 65 20 64  validated. The d
5ec0: 65 73 74 69 6e 61 74 69 6f 6e 20 63 6f 70 79 20  estination copy 
5ed0: 6f 66 20 69 50 61 67 65 20 6e 65 65 64 73 0a 2a  of iPage needs.*
5ee0: 2a 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 20  * to be updated 
5ef0: 77 69 74 68 20 74 68 65 20 6e 65 77 20 64 61 74  with the new dat
5f00: 61 20 62 65 66 6f 72 65 20 74 68 65 20 62 61 63  a before the bac
5f10: 6b 75 70 20 6f 70 65 72 61 74 69 6f 6e 20 69 73  kup operation is
5f20: 0a 2a 2a 20 63 6f 6d 70 6c 65 74 65 2e 0a 2a 2a  .** complete..**
5f30: 0a 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65  .** It is assume
5f40: 64 20 74 68 61 74 20 74 68 65 20 6d 75 74 65 78  d that the mutex
5f50: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
5f60: 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6f 62   the BtShared ob
5f70: 6a 65 63 74 0a 2a 2a 20 63 6f 72 72 65 73 70 6f  ject.** correspo
5f80: 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73 6f 75  nding to the sou
5f90: 72 63 65 20 64 61 74 61 62 61 73 65 20 69 73 20  rce database is 
5fa0: 68 65 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66  held when this f
5fb0: 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63 61  unction is.** ca
5fc0: 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  lled..*/.static 
5fd0: 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20  SQLITE_NOINLINE 
5fe0: 76 6f 69 64 20 62 61 63 6b 75 70 55 70 64 61 74  void backupUpdat
5ff0: 65 28 0a 20 20 73 71 6c 69 74 65 33 5f 62 61 63  e(.  sqlite3_bac
6000: 6b 75 70 20 2a 70 2c 0a 20 20 50 67 6e 6f 20 69  kup *p,.  Pgno i
6010: 50 61 67 65 2c 0a 20 20 63 6f 6e 73 74 20 75 38  Page,.  const u8
6020: 20 2a 61 44 61 74 61 0a 29 7b 0a 20 20 61 73 73   *aData.){.  ass
6030: 65 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20 64  ert( p!=0 );.  d
6040: 6f 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73  o{.    assert( s
6050: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
6060: 64 28 70 2d 3e 70 53 72 63 2d 3e 70 42 74 2d 3e  d(p->pSrc->pBt->
6070: 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 69 66  mutex) );.    if
6080: 28 20 21 69 73 46 61 74 61 6c 45 72 72 6f 72 28  ( !isFatalError(
6090: 70 2d 3e 72 63 29 20 26 26 20 69 50 61 67 65 3c  p->rc) && iPage<
60a0: 70 2d 3e 69 4e 65 78 74 20 29 7b 0a 20 20 20 20  p->iNext ){.    
60b0: 20 20 2f 2a 20 54 68 65 20 62 61 63 6b 75 70 20    /* The backup 
60c0: 70 72 6f 63 65 73 73 20 70 20 68 61 73 20 61 6c  process p has al
60d0: 72 65 61 64 79 20 63 6f 70 69 65 64 20 70 61 67  ready copied pag
60e0: 65 20 69 50 61 67 65 2e 20 42 75 74 20 6e 6f 77  e iPage. But now
60f0: 20 69 74 0a 20 20 20 20 20 20 2a 2a 20 68 61 73   it.      ** has
6100: 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 62   been modified b
6110: 79 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  y a transaction 
6120: 6f 6e 20 74 68 65 20 73 6f 75 72 63 65 20 70 61  on the source pa
6130: 67 65 72 2e 20 43 6f 70 79 0a 20 20 20 20 20 20  ger. Copy.      
6140: 2a 2a 20 74 68 65 20 6e 65 77 20 64 61 74 61 20  ** the new data 
6150: 69 6e 74 6f 20 74 68 65 20 62 61 63 6b 75 70 2e  into the backup.
6160: 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20  .      */.      
6170: 69 6e 74 20 72 63 3b 0a 20 20 20 20 20 20 61 73  int rc;.      as
6180: 73 65 72 74 28 20 70 2d 3e 70 44 65 73 74 44 62  sert( p->pDestDb
6190: 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   );.      sqlite
61a0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 2d  3_mutex_enter(p-
61b0: 3e 70 44 65 73 74 44 62 2d 3e 6d 75 74 65 78 29  >pDestDb->mutex)
61c0: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 61 63  ;.      rc = bac
61d0: 6b 75 70 4f 6e 65 50 61 67 65 28 70 2c 20 69 50  kupOnePage(p, iP
61e0: 61 67 65 2c 20 61 44 61 74 61 2c 20 31 29 3b 0a  age, aData, 1);.
61f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75        sqlite3_mu
6200: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 70 44 65  tex_leave(p->pDe
6210: 73 74 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  stDb->mutex);.  
6220: 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d      assert( rc!=
6230: 53 51 4c 49 54 45 5f 42 55 53 59 20 26 26 20 72  SQLITE_BUSY && r
6240: 63 21 3d 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  c!=SQLITE_LOCKED
6250: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63   );.      if( rc
6260: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
6270: 20 20 20 20 20 20 20 70 2d 3e 72 63 20 3d 20 72         p->rc = r
6280: 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  c;.      }.    }
6290: 0a 20 20 7d 77 68 69 6c 65 28 20 28 70 20 3d 20  .  }while( (p = 
62a0: 70 2d 3e 70 4e 65 78 74 29 21 3d 30 20 29 3b 0a  p->pNext)!=0 );.
62b0: 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 61  }.void sqlite3Ba
62c0: 63 6b 75 70 55 70 64 61 74 65 28 73 71 6c 69 74  ckupUpdate(sqlit
62d0: 65 33 5f 62 61 63 6b 75 70 20 2a 70 42 61 63 6b  e3_backup *pBack
62e0: 75 70 2c 20 50 67 6e 6f 20 69 50 61 67 65 2c 20  up, Pgno iPage, 
62f0: 63 6f 6e 73 74 20 75 38 20 2a 61 44 61 74 61 29  const u8 *aData)
6300: 7b 0a 20 20 69 66 28 20 70 42 61 63 6b 75 70 20  {.  if( pBackup 
6310: 29 20 62 61 63 6b 75 70 55 70 64 61 74 65 28 70  ) backupUpdate(p
6320: 42 61 63 6b 75 70 2c 20 69 50 61 67 65 2c 20 61  Backup, iPage, a
6330: 44 61 74 61 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  Data);.}../*.** 
6340: 52 65 73 74 61 72 74 20 74 68 65 20 62 61 63 6b  Restart the back
6350: 75 70 20 70 72 6f 63 65 73 73 2e 20 54 68 69 73  up process. This
6360: 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20   is called when 
6370: 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 0a  the pager layer.
6380: 2a 2a 20 64 65 74 65 63 74 73 20 74 68 61 74 20  ** detects that 
6390: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 73  the database has
63a0: 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 62   been modified b
63b0: 79 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 64 61  y an external da
63c0: 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63  tabase.** connec
63d0: 74 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 63 61  tion. In this ca
63e0: 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77  se there is no w
63f0: 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 77 68  ay of knowing wh
6400: 69 63 68 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61  ich of the.** pa
6410: 67 65 73 20 74 68 61 74 20 68 61 76 65 20 62 65  ges that have be
6420: 65 6e 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 74  en copied into t
6430: 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64  he destination d
6440: 61 74 61 62 61 73 65 20 61 72 65 20 73 74 69 6c  atabase are stil
6450: 6c 20 0a 2a 2a 20 76 61 6c 69 64 20 61 6e 64 20  l .** valid and 
6460: 77 68 69 63 68 20 61 72 65 20 6e 6f 74 2c 20 73  which are not, s
6470: 6f 20 74 68 65 20 65 6e 74 69 72 65 20 70 72 6f  o the entire pro
6480: 63 65 73 73 20 6e 65 65 64 73 20 74 6f 20 62 65  cess needs to be
6490: 20 72 65 73 74 61 72 74 65 64 2e 0a 2a 2a 0a 2a   restarted..**.*
64a0: 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20  * It is assumed 
64b0: 74 68 61 74 20 74 68 65 20 6d 75 74 65 78 20 61  that the mutex a
64c0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74  ssociated with t
64d0: 68 65 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65  he BtShared obje
64e0: 63 74 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64  ct.** correspond
64f0: 69 6e 67 20 74 6f 20 74 68 65 20 73 6f 75 72 63  ing to the sourc
6500: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 68 65  e database is he
6510: 6c 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e  ld when this fun
6520: 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63 61 6c 6c  ction is.** call
6530: 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ed..*/.void sqli
6540: 74 65 33 42 61 63 6b 75 70 52 65 73 74 61 72 74  te3BackupRestart
6550: 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20  (sqlite3_backup 
6560: 2a 70 42 61 63 6b 75 70 29 7b 0a 20 20 73 71 6c  *pBackup){.  sql
6570: 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 3b 20  ite3_backup *p; 
6580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6590: 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76 61    /* Iterator va
65a0: 72 69 61 62 6c 65 20 2a 2f 0a 20 20 66 6f 72 28  riable */.  for(
65b0: 70 3d 70 42 61 63 6b 75 70 3b 20 70 3b 20 70 3d  p=pBackup; p; p=
65c0: 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 61  p->pNext){.    a
65d0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
65e0: 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 70 53 72  utex_held(p->pSr
65f0: 63 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29  c->pBt->mutex) )
6600: 3b 0a 20 20 20 20 70 2d 3e 69 4e 65 78 74 20 3d  ;.    p->iNext =
6610: 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64   1;.  }.}..#ifnd
6620: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56  ef SQLITE_OMIT_V
6630: 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 43 6f 70 79  ACUUM./*.** Copy
6640: 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 63 6f   the complete co
6650: 6e 74 65 6e 74 20 6f 66 20 70 42 74 46 72 6f 6d  ntent of pBtFrom
6660: 20 69 6e 74 6f 20 70 42 74 54 6f 2e 20 20 41 20   into pBtTo.  A 
6670: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 6d  transaction.** m
6680: 75 73 74 20 62 65 20 61 63 74 69 76 65 20 66 6f  ust be active fo
6690: 72 20 62 6f 74 68 20 66 69 6c 65 73 2e 0a 2a 2a  r both files..**
66a0: 0a 2a 2a 20 54 68 65 20 73 69 7a 65 20 6f 66 20  .** The size of 
66b0: 66 69 6c 65 20 70 54 6f 20 6d 61 79 20 62 65 20  file pTo may be 
66c0: 72 65 64 75 63 65 64 20 62 79 20 74 68 69 73 20  reduced by this 
66d0: 6f 70 65 72 61 74 69 6f 6e 2e 20 49 66 20 61 6e  operation. If an
66e0: 79 74 68 69 6e 67 20 0a 2a 2a 20 67 6f 65 73 20  ything .** goes 
66f0: 77 72 6f 6e 67 2c 20 74 68 65 20 74 72 61 6e 73  wrong, the trans
6700: 61 63 74 69 6f 6e 20 6f 6e 20 70 54 6f 20 69 73  action on pTo is
6710: 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 49 66   rolled back. If
6720: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 74 68 65   successful, the
6730: 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e   .** transaction
6740: 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 62 65   is committed be
6750: 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a  fore returning..
6760: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74  */.int sqlite3Bt
6770: 72 65 65 43 6f 70 79 46 69 6c 65 28 42 74 72 65  reeCopyFile(Btre
6780: 65 20 2a 70 54 6f 2c 20 42 74 72 65 65 20 2a 70  e *pTo, Btree *p
6790: 46 72 6f 6d 29 7b 0a 20 20 69 6e 74 20 72 63 3b  From){.  int rc;
67a0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  .  sqlite3_file 
67b0: 2a 70 46 64 3b 20 20 20 20 20 20 20 20 20 20 20  *pFd;           
67c0: 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 63 72     /* File descr
67d0: 69 70 74 6f 72 20 66 6f 72 20 64 61 74 61 62 61  iptor for databa
67e0: 73 65 20 70 54 6f 20 2a 2f 0a 20 20 73 71 6c 69  se pTo */.  sqli
67f0: 74 65 33 5f 62 61 63 6b 75 70 20 62 3b 0a 20 20  te3_backup b;.  
6800: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
6810: 72 28 70 54 6f 29 3b 0a 20 20 73 71 6c 69 74 65  r(pTo);.  sqlite
6820: 33 42 74 72 65 65 45 6e 74 65 72 28 70 46 72 6f  3BtreeEnter(pFro
6830: 6d 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73  m);..  assert( s
6840: 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54  qlite3BtreeIsInT
6850: 72 61 6e 73 28 70 54 6f 29 20 29 3b 0a 20 20 70  rans(pTo) );.  p
6860: 46 64 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65  Fd = sqlite3Page
6870: 72 46 69 6c 65 28 73 71 6c 69 74 65 33 42 74 72  rFile(sqlite3Btr
6880: 65 65 50 61 67 65 72 28 70 54 6f 29 29 3b 0a 20  eePager(pTo));. 
6890: 20 69 66 28 20 70 46 64 2d 3e 70 4d 65 74 68 6f   if( pFd->pMetho
68a0: 64 73 20 29 7b 0a 20 20 20 20 69 36 34 20 6e 42  ds ){.    i64 nB
68b0: 79 74 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72  yte = sqlite3Btr
68c0: 65 65 47 65 74 50 61 67 65 53 69 7a 65 28 70 46  eeGetPageSize(pF
68d0: 72 6f 6d 29 2a 28 69 36 34 29 73 71 6c 69 74 65  rom)*(i64)sqlite
68e0: 33 42 74 72 65 65 4c 61 73 74 50 61 67 65 28 70  3BtreeLastPage(p
68f0: 46 72 6f 6d 29 3b 0a 20 20 20 20 72 63 20 3d 20  From);.    rc = 
6900: 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e  sqlite3OsFileCon
6910: 74 72 6f 6c 28 70 46 64 2c 20 53 51 4c 49 54 45  trol(pFd, SQLITE
6920: 5f 46 43 4e 54 4c 5f 4f 56 45 52 57 52 49 54 45  _FCNTL_OVERWRITE
6930: 2c 20 26 6e 42 79 74 65 29 3b 0a 20 20 20 20 69  , &nByte);.    i
6940: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f  f( rc==SQLITE_NO
6950: 54 46 4f 55 4e 44 20 29 20 72 63 20 3d 20 53 51  TFOUND ) rc = SQ
6960: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 69 66 28  LITE_OK;.    if(
6970: 20 72 63 20 29 20 67 6f 74 6f 20 63 6f 70 79 5f   rc ) goto copy_
6980: 66 69 6e 69 73 68 65 64 3b 0a 20 20 7d 0a 0a 20  finished;.  }.. 
6990: 20 2f 2a 20 53 65 74 20 75 70 20 61 6e 20 73 71   /* Set up an sq
69a0: 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 6f 62 6a  lite3_backup obj
69b0: 65 63 74 2e 20 73 71 6c 69 74 65 33 5f 62 61 63  ect. sqlite3_bac
69c0: 6b 75 70 2e 70 44 65 73 74 44 62 20 6d 75 73 74  kup.pDestDb must
69d0: 20 62 65 20 73 65 74 0a 20 20 2a 2a 20 74 6f 20   be set.  ** to 
69e0: 30 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20  0. This is used 
69f0: 62 79 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74  by the implement
6a00: 61 74 69 6f 6e 73 20 6f 66 20 73 71 6c 69 74 65  ations of sqlite
6a10: 33 5f 62 61 63 6b 75 70 5f 73 74 65 70 28 29 0a  3_backup_step().
6a20: 20 20 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 33    ** and sqlite3
6a30: 5f 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 29  _backup_finish()
6a40: 20 74 6f 20 64 65 74 65 63 74 20 74 68 61 74 20   to detect that 
6a50: 74 68 65 79 20 61 72 65 20 62 65 69 6e 67 20 63  they are being c
6a60: 61 6c 6c 65 64 0a 20 20 2a 2a 20 66 72 6f 6d 20  alled.  ** from 
6a70: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 6e  this function, n
6a80: 6f 74 20 64 69 72 65 63 74 6c 79 20 62 79 20 74  ot directly by t
6a90: 68 65 20 75 73 65 72 2e 0a 20 20 2a 2f 0a 20 20  he user..  */.  
6aa0: 6d 65 6d 73 65 74 28 26 62 2c 20 30 2c 20 73 69  memset(&b, 0, si
6ab0: 7a 65 6f 66 28 62 29 29 3b 0a 20 20 62 2e 70 53  zeof(b));.  b.pS
6ac0: 72 63 44 62 20 3d 20 70 46 72 6f 6d 2d 3e 64 62  rcDb = pFrom->db
6ad0: 3b 0a 20 20 62 2e 70 53 72 63 20 3d 20 70 46 72  ;.  b.pSrc = pFr
6ae0: 6f 6d 3b 0a 20 20 62 2e 70 44 65 73 74 20 3d 20  om;.  b.pDest = 
6af0: 70 54 6f 3b 0a 20 20 62 2e 69 4e 65 78 74 20 3d  pTo;.  b.iNext =
6b00: 20 31 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49   1;..#ifdef SQLI
6b10: 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 73  TE_HAS_CODEC.  s
6b20: 71 6c 69 74 65 33 50 61 67 65 72 41 6c 69 67 6e  qlite3PagerAlign
6b30: 52 65 73 65 72 76 65 28 73 71 6c 69 74 65 33 42  Reserve(sqlite3B
6b40: 74 72 65 65 50 61 67 65 72 28 70 54 6f 29 2c 20  treePager(pTo), 
6b50: 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 65  sqlite3BtreePage
6b60: 72 28 70 46 72 6f 6d 29 29 3b 0a 23 65 6e 64 69  r(pFrom));.#endi
6b70: 66 0a 0a 20 20 2f 2a 20 30 78 37 46 46 46 46 46  f..  /* 0x7FFFFF
6b80: 46 46 20 69 73 20 74 68 65 20 68 61 72 64 20 6c  FF is the hard l
6b90: 69 6d 69 74 20 66 6f 72 20 74 68 65 20 6e 75 6d  imit for the num
6ba0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20  ber of pages in 
6bb0: 61 20 64 61 74 61 62 61 73 65 0a 20 20 2a 2a 20  a database.  ** 
6bc0: 66 69 6c 65 2e 20 42 79 20 70 61 73 73 69 6e 67  file. By passing
6bd0: 20 74 68 69 73 20 61 73 20 74 68 65 20 6e 75 6d   this as the num
6be0: 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20  ber of pages to 
6bf0: 63 6f 70 79 20 74 6f 0a 20 20 2a 2a 20 73 71 6c  copy to.  ** sql
6c00: 69 74 65 33 5f 62 61 63 6b 75 70 5f 73 74 65 70  ite3_backup_step
6c10: 28 29 2c 20 77 65 20 63 61 6e 20 67 75 61 72 61  (), we can guara
6c20: 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 63 6f  ntee that the co
6c30: 70 79 20 66 69 6e 69 73 68 65 73 20 0a 20 20 2a  py finishes .  *
6c40: 2a 20 77 69 74 68 69 6e 20 61 20 73 69 6e 67 6c  * within a singl
6c50: 65 20 63 61 6c 6c 20 28 75 6e 6c 65 73 73 20 61  e call (unless a
6c60: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 29 2e  n error occurs).
6c70: 20 54 68 65 20 61 73 73 65 72 74 28 29 20 73 74   The assert() st
6c80: 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 63 68 65  atement.  ** che
6c90: 63 6b 73 20 74 68 69 73 20 61 73 73 75 6d 70 74  cks this assumpt
6ca0: 69 6f 6e 20 2d 20 28 70 2d 3e 72 63 29 20 73 68  ion - (p->rc) sh
6cb0: 6f 75 6c 64 20 62 65 20 73 65 74 20 74 6f 20 65  ould be set to e
6cc0: 69 74 68 65 72 20 53 51 4c 49 54 45 5f 44 4f 4e  ither SQLITE_DON
6cd0: 45 20 0a 20 20 2a 2a 20 6f 72 20 61 6e 20 65 72  E .  ** or an er
6ce0: 72 6f 72 20 63 6f 64 65 2e 20 20 2a 2f 0a 20 20  ror code.  */.  
6cf0: 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 5f 73  sqlite3_backup_s
6d00: 74 65 70 28 26 62 2c 20 30 78 37 46 46 46 46 46  tep(&b, 0x7FFFFF
6d10: 46 46 29 3b 0a 20 20 61 73 73 65 72 74 28 20 62  FF);.  assert( b
6d20: 2e 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29  .rc!=SQLITE_OK )
6d30: 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  ;..  rc = sqlite
6d40: 33 5f 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28  3_backup_finish(
6d50: 26 62 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53  &b);.  if( rc==S
6d60: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
6d70: 70 54 6f 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61  pTo->pBt->btsFla
6d80: 67 73 20 26 3d 20 7e 42 54 53 5f 50 41 47 45 53  gs &= ~BTS_PAGES
6d90: 49 5a 45 5f 46 49 58 45 44 3b 0a 20 20 7d 65 6c  IZE_FIXED;.  }el
6da0: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 50  se{.    sqlite3P
6db0: 61 67 65 72 43 6c 65 61 72 43 61 63 68 65 28 73  agerClearCache(s
6dc0: 71 6c 69 74 65 33 42 74 72 65 65 50 61 67 65 72  qlite3BtreePager
6dd0: 28 62 2e 70 44 65 73 74 29 29 3b 0a 20 20 7d 0a  (b.pDest));.  }.
6de0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
6df0: 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73  e3BtreeIsInTrans
6e00: 28 70 54 6f 29 3d 3d 30 20 29 3b 0a 63 6f 70 79  (pTo)==0 );.copy
6e10: 5f 66 69 6e 69 73 68 65 64 3a 0a 20 20 73 71 6c  _finished:.  sql
6e20: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70  ite3BtreeLeave(p
6e30: 46 72 6f 6d 29 3b 0a 20 20 73 71 6c 69 74 65 33  From);.  sqlite3
6e40: 42 74 72 65 65 4c 65 61 76 65 28 70 54 6f 29 3b  BtreeLeave(pTo);
6e50: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
6e60: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
6e70: 5f 4f 4d 49 54 5f 56 41 43 55 55 4d 20 2a 2f 0a  _OMIT_VACUUM */.