SQLite Archiver

Hex Artifact Content
Login

Artifact 11699f8b34959fed93cc07ee39486f7416230007:


0000: 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65  <h1 align="cente
0010: 72 22 3e 53 51 4c 41 52 20 2d 20 53 51 4c 69 74  r">SQLAR - SQLit
0020: 65 20 41 72 63 68 69 76 65 72 3c 2f 68 31 3e 0a  e Archiver</h1>.
0030: 0a 54 68 69 73 20 72 65 70 6f 73 69 74 6f 72 79  .This repository
0040: 20 63 6f 6e 74 61 69 6e 73 20 73 6f 75 72 63 65   contains source
0050: 73 20 66 6f 72 20 74 68 65 20 22 53 51 4c 69 74  s for the "SQLit
0060: 65 20 41 72 63 68 69 76 65 72 22 0a 70 72 6f 67  e Archiver".prog
0070: 72 61 6d 2e 20 20 54 68 69 73 20 70 72 6f 67 72  ram.  This progr
0080: 61 6d 20 28 6e 61 6d 65 64 20 22 73 71 6c 61 72  am (named "sqlar
0090: 22 29 20 6f 70 65 72 61 74 65 73 20 6d 75 63 68  ") operates much
00a0: 20 6c 69 6b 65 20 22 7a 69 70 22 2c 20 65 78 63   like "zip", exc
00b0: 65 70 74 20 74 68 61 74 0a 74 68 65 20 63 6f 6d  ept that.the com
00c0: 70 72 65 73 73 65 64 20 61 72 63 68 69 76 65 20  pressed archive 
00d0: 69 74 20 62 75 69 6c 64 73 20 69 73 20 73 74 6f  it builds is sto
00e0: 72 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65  red in an SQLite
00f0: 20 64 61 74 61 62 61 73 65 20 69 6e 73 74 65 61   database instea
0100: 64 0a 6f 66 20 61 20 5a 49 50 20 61 72 63 68 69  d.of a ZIP archi
0110: 76 65 2e 0a 0a 54 68 65 20 6d 6f 74 69 76 61 74  ve...The motivat
0120: 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 69 73 20  ion for this is 
0130: 74 6f 20 73 65 65 20 68 6f 77 20 6d 75 63 68 20  to see how much 
0140: 6c 61 72 67 65 72 20 61 6e 20 53 51 4c 69 74 65  larger an SQLite
0150: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 69   database file.i
0160: 73 20 63 6f 6d 70 61 72 65 64 20 74 6f 20 61 20  s compared to a 
0170: 5a 49 50 20 61 72 63 68 69 76 65 20 63 6f 6e 74  ZIP archive cont
0180: 61 69 6e 69 6e 67 20 74 68 65 20 73 61 6d 65 20  aining the same 
0190: 63 6f 6e 74 65 6e 74 2e 20 20 54 68 65 20 61 6e  content.  The an
01a0: 73 77 65 72 20 64 65 70 65 6e 64 73 0a 6f 6e 20  swer depends.on 
01b0: 74 68 65 20 66 69 6c 65 6e 61 6d 65 73 2c 20 62  the filenames, b
01c0: 75 74 20 32 25 20 73 65 65 6d 73 20 74 6f 20 62  ut 2% seems to b
01d0: 65 20 61 20 72 65 61 73 6f 6e 61 62 6c 65 20 67  e a reasonable g
01e0: 75 65 73 73 2e 20 20 49 6e 20 6f 74 68 65 72 20  uess.  In other 
01f0: 77 6f 72 64 73 2c 0a 73 74 6f 72 69 6e 67 20 66  words,.storing f
0200: 69 6c 65 73 20 61 73 20 63 6f 6d 70 72 65 73 73  iles as compress
0210: 65 64 20 62 6c 6f 62 73 20 69 6e 20 61 6e 20 53  ed blobs in an S
0220: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 66  QLite database f
0230: 69 6c 65 20 72 65 73 75 6c 74 73 20 69 6e 20 61  ile results in a
0240: 20 0a 66 69 6c 65 20 74 68 61 74 20 69 73 20 6f   .file that is o
0250: 6e 6c 79 20 61 62 6f 75 74 20 32 25 20 6c 61 72  nly about 2% lar
0260: 67 65 72 20 74 68 61 6e 20 73 74 6f 72 69 6e 67  ger than storing
0270: 20 74 68 6f 73 65 20 73 61 6d 65 20 66 69 6c 65   those same file
0280: 73 20 69 6e 20 61 20 5a 49 50 0a 61 72 63 68 69  s in a ZIP.archi
0290: 76 65 20 75 73 69 6e 67 20 74 68 65 20 73 61 6d  ve using the sam
02a0: 65 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2e 0a 0a  e compression...
02b0: 23 23 20 43 6f 6d 70 69 6c 69 6e 67 0a 0a 4f 6e  ## Compiling..On
02c0: 20 75 6e 69 78 2c 20 6a 75 73 74 20 74 79 70 65   unix, just type
02d0: 20 22 6d 61 6b 65 22 2e 20 20 54 68 65 20 53 51   "make".  The SQ
02e0: 4c 69 74 65 20 73 6f 75 72 63 65 73 20 61 72 65  Lite sources are
02f0: 20 69 6e 63 6c 75 64 65 64 2e 20 20 54 68 65 20   included.  The 
0300: 7a 6c 69 62 0a 63 6f 6d 70 72 65 73 73 69 6f 6e  zlib.compression
0310: 20 6c 69 62 72 61 72 79 20 69 73 20 6e 65 65 64   library is need
0320: 65 64 20 74 6f 20 62 75 69 6c 64 2e 0a 0a 23 23  ed to build...##
0330: 20 55 73 61 67 65 0a 0a 54 6f 20 63 72 65 61 74   Usage..To creat
0340: 65 20 61 6e 20 61 72 63 68 69 76 65 3a 0a 0a 20  e an archive:.. 
0350: 20 20 20 20 20 20 20 73 71 6c 61 72 20 41 52 43         sqlar ARC
0360: 48 49 56 45 20 46 49 4c 45 53 2e 2e 2e 0a 0a 41  HIVE FILES.....A
0370: 6c 6c 20 66 69 6c 65 73 20 6e 61 6d 65 64 20 69  ll files named i
0380: 6e 20 46 49 4c 45 53 2e 2e 2e 20 77 69 6c 6c 20  n FILES... will 
0390: 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20  be added to the 
03a0: 61 72 63 68 69 76 65 2e 20 20 49 66 20 61 6e 6f  archive.  If ano
03b0: 74 68 65 72 20 66 69 6c 65 0a 77 69 74 68 20 74  ther file.with t
03c0: 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 6c 72  he same name alr
03d0: 65 61 64 79 20 65 78 69 73 74 73 20 69 6e 20 74  eady exists in t
03e0: 68 65 20 61 72 63 68 69 76 65 2c 20 69 74 20 69  he archive, it i
03f0: 73 20 72 65 70 6c 61 63 65 64 2e 20 20 49 66 20  s replaced.  If 
0400: 61 6e 79 0a 6f 66 20 74 68 65 20 6e 61 6d 65 64  any.of the named
0410: 20 46 49 4c 45 53 20 69 73 20 61 20 64 69 72 65   FILES is a dire
0420: 63 74 6f 72 79 2c 20 74 68 61 74 20 64 69 72 65  ctory, that dire
0430: 63 74 6f 72 79 20 69 73 20 73 63 61 6e 6e 65 64  ctory is scanned
0440: 20 72 65 63 75 72 73 69 76 65 6c 79 2e 0a 0a 54   recursively...T
0450: 6f 20 73 65 65 20 74 68 65 20 63 6f 6e 74 65 6e  o see the conten
0460: 74 73 20 6f 66 20 61 6e 20 61 72 63 68 69 76 65  ts of an archive
0470: 3a 0a 0a 20 20 20 20 20 20 20 20 73 71 6c 61 72  :..        sqlar
0480: 20 2d 6c 20 41 52 43 48 49 56 45 0a 0a 54 6f 20   -l ARCHIVE..To 
0490: 65 78 74 72 61 63 74 20 74 68 65 20 63 6f 6e 74  extract the cont
04a0: 65 6e 74 73 20 6f 66 20 61 6e 20 61 72 63 68 69  ents of an archi
04b0: 76 65 3a 0a 0a 20 20 20 20 20 20 20 20 73 71 6c  ve:..        sql
04c0: 61 72 20 2d 78 20 41 52 43 48 49 56 45 20 5b 46  ar -x ARCHIVE [F
04d0: 49 4c 45 53 2e 2e 2e 5d 0a 0a 49 66 20 61 20 46  ILES...]..If a F
04e0: 49 4c 45 53 20 61 72 67 75 6d 65 6e 74 20 69 73  ILES argument is
04f0: 20 70 72 6f 76 69 64 65 64 2c 20 74 68 65 6e 20   provided, then 
0500: 6f 6e 6c 79 20 74 68 65 20 6e 61 6d 65 64 20 66  only the named f
0510: 69 6c 65 73 20 61 72 65 20 65 78 74 72 61 63 74  iles are extract
0520: 65 64 2e 0a 57 69 74 68 6f 75 74 20 61 20 46 49  ed..Without a FI
0530: 4c 45 53 20 61 72 67 75 6d 65 6e 74 2c 20 61 6c  LES argument, al
0540: 6c 20 66 69 6c 65 73 20 61 72 65 20 65 78 74 72  l files are extr
0550: 61 63 74 65 64 2e 0a 0a 41 6c 6c 20 63 6f 6d 6d  acted...All comm
0560: 61 6e 64 73 20 63 61 6e 20 62 65 20 73 75 70 70  ands can be supp
0570: 6c 65 6d 65 6e 74 65 64 20 77 69 74 68 20 2d 76  lemented with -v
0580: 20 66 6f 72 20 76 65 72 62 6f 73 65 20 6f 75 74   for verbose out
0590: 70 75 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65  put. For example
05a0: 3a 0a 0a 20 20 20 20 20 20 20 20 73 71 6c 61 72  :..        sqlar
05b0: 20 2d 76 20 41 52 43 48 49 56 45 20 46 49 4c 45   -v ARCHIVE FILE
05c0: 53 2e 2e 0a 20 20 20 20 20 20 20 20 73 71 6c 61  S...        sqla
05d0: 72 20 2d 6c 76 20 41 52 43 48 49 56 45 0a 20 20  r -lv ARCHIVE.  
05e0: 20 20 20 20 20 20 73 71 6c 61 72 20 2d 78 76 20        sqlar -xv 
05f0: 41 52 43 48 49 56 45 0a 0a 46 69 6c 65 20 61 72  ARCHIVE..File ar
0600: 65 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6d 70 72  e normally compr
0610: 65 73 73 65 64 20 75 73 69 6e 67 20 7a 6c 69 62  essed using zlib
0620: 20 70 72 69 6f 72 20 74 6f 20 62 65 69 6e 67 20   prior to being 
0630: 73 74 6f 72 65 64 20 61 73 20 42 4c 4f 42 73 20  stored as BLOBs 
0640: 69 6e 0a 74 68 65 20 64 61 74 61 62 61 73 65 2e  in.the database.
0650: 20 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68    However, if th
0660: 65 20 66 69 6c 65 20 69 73 20 69 6e 63 6f 6d 70  e file is incomp
0670: 72 65 73 73 69 62 6c 65 20 6f 72 20 69 66 20 74  ressible or if t
0680: 68 65 20 2d 6e 20 6f 70 74 69 6f 6e 0a 69 73 20  he -n option.is 
0690: 75 73 65 64 20 6f 6e 20 74 68 65 20 63 6f 6d 6d  used on the comm
06a0: 61 6e 64 2d 6c 69 6e 65 2c 20 74 68 65 6e 20 74  and-line, then t
06b0: 68 65 20 66 69 6c 65 20 69 73 20 73 74 6f 72 65  he file is store
06c0: 64 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  d in the databas
06d0: 65 20 65 78 61 63 74 6c 79 0a 61 73 20 69 74 20  e exactly.as it 
06e0: 61 70 70 65 61 72 73 20 6f 6e 20 64 69 73 6b 2c  appears on disk,
06f0: 20 77 69 74 68 6f 75 74 20 63 6f 6d 70 72 65 73   without compres
0700: 73 69 6f 6e 2e 0a 20 20 20 20 0a 23 23 20 53 74  sion..    .## St
0710: 6f 72 61 67 65 0a 0a 54 68 65 20 64 61 74 61 62  orage..The datab
0720: 61 73 65 20 73 63 68 65 6d 61 20 6c 6f 6f 6b 73  ase schema looks
0730: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 20 20 20   like this:..   
0740: 20 20 20 20 20 43 52 45 41 54 45 20 54 41 42 4c       CREATE TABL
0750: 45 20 73 71 6c 61 72 28 0a 20 20 20 20 20 20 20  E sqlar(.       
0760: 20 20 20 6e 61 6d 65 20 54 45 58 54 20 50 52 49     name TEXT PRI
0770: 4d 41 52 59 20 4b 45 59 2c 20 20 2d 2d 20 6e 61  MARY KEY,  -- na
0780: 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 0a 20  me of the file. 
0790: 20 20 20 20 20 20 20 20 20 6d 6f 64 65 20 49 4e           mode IN
07a0: 54 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  T,              
07b0: 20 2d 2d 20 61 63 63 65 73 73 20 70 65 72 6d 69   -- access permi
07c0: 73 73 69 6f 6e 73 0a 20 20 20 20 20 20 20 20 20  ssions.         
07d0: 20 6d 74 69 6d 65 20 49 4e 54 2c 20 20 20 20 20   mtime INT,     
07e0: 20 20 20 20 20 20 20 20 20 2d 2d 20 6c 61 73 74           -- last
07f0: 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 74 69   modification ti
0800: 6d 65 0a 20 20 20 20 20 20 20 20 20 20 73 7a 20  me.          sz 
0810: 49 4e 54 2c 20 20 20 20 20 20 20 20 20 20 20 20  INT,            
0820: 20 20 20 20 20 2d 2d 20 6f 72 69 67 69 6e 61 6c       -- original
0830: 20 66 69 6c 65 20 73 69 7a 65 0a 20 20 20 20 20   file size.     
0840: 20 20 20 20 20 64 61 74 61 20 42 4c 4f 42 20 20       data BLOB  
0850: 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 20               -- 
0860: 63 6f 6d 70 72 65 73 73 65 64 20 63 6f 6e 74 65  compressed conte
0870: 6e 74 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20  nt.        );.  
0880: 20 20 20 20 20 20 0a 42 6f 74 68 20 64 69 72 65        .Both dire
0890: 63 74 6f 72 69 65 73 20 61 6e 64 20 65 6d 70 74  ctories and empt
08a0: 79 20 66 69 6c 65 73 20 68 61 76 65 20 73 71 6c  y files have sql
08b0: 61 72 2e 73 7a 3d 3d 30 2e 20 20 44 69 72 65 63  ar.sz==0.  Direc
08c0: 74 6f 72 69 65 73 20 63 61 6e 20 62 65 0a 64 69  tories can be.di
08d0: 73 74 69 6e 67 75 69 73 68 65 64 20 66 72 6f 6d  stinguished from
08e0: 20 65 6d 70 74 79 20 66 69 6c 65 73 20 62 65 63   empty files bec
08f0: 61 75 73 65 20 64 69 72 65 63 74 6f 72 69 65 73  ause directories
0900: 20 68 61 76 65 20 73 71 6c 61 72 2e 64 61 74 61   have sqlar.data
0910: 20 49 53 20 4e 55 4c 4c 2e 0a 54 68 65 20 66 69   IS NULL..The fi
0920: 6c 65 20 69 73 20 63 6f 6d 70 72 65 73 73 65 64  le is compressed
0930: 20 69 66 20 6c 65 6e 67 74 68 28 73 71 6c 61 72   if length(sqlar
0940: 2e 62 6c 6f 62 29 3c 73 71 6c 61 72 2e 73 7a 20  .blob)<sqlar.sz 
0950: 61 6e 64 20 69 73 20 73 74 6f 72 65 64 0a 61 73  and is stored.as
0960: 20 70 6c 61 69 6e 74 65 78 74 20 69 66 20 6c 65   plaintext if le
0970: 6e 67 74 68 28 73 71 6c 61 72 2e 62 6c 6f 62 29  ngth(sqlar.blob)
0980: 3d 3d 73 71 6c 61 72 2e 73 7a 2e 0a 0a 53 79 6d  ==sqlar.sz...Sym
0990: 62 6f 6c 69 63 20 6c 69 6e 6b 73 20 68 61 76 65  bolic links have
09a0: 20 73 71 6c 61 72 2e 73 7a 20 73 65 74 20 74 6f   sqlar.sz set to
09b0: 20 2d 31 2c 20 61 6e 64 20 74 68 65 20 6c 69 6e   -1, and the lin
09c0: 6b 20 74 61 72 67 65 74 20 73 74 6f 72 65 64 20  k target stored 
09d0: 61 73 0a 61 20 74 65 78 74 20 76 61 6c 75 65 20  as.a text value 
09e0: 69 6e 20 74 68 65 20 73 71 6c 61 72 2e 64 61 74  in the sqlar.dat
09f0: 61 20 66 69 65 6c 64 2e 0a 0a 53 51 4c 41 52 20  a field...SQLAR 
0a00: 75 73 65 73 20 74 68 65 20 22 7a 6c 69 62 20 66  uses the "zlib f
0a10: 6f 72 6d 61 74 22 20 66 6f 72 20 63 6f 6d 70 72  ormat" for compr
0a20: 65 73 73 69 6f 6e 2e 20 20 5a 49 50 20 75 73 65  ession.  ZIP use
0a30: 73 20 74 68 65 20 72 61 77 20 64 65 66 6c 61 74  s the raw deflat
0a40: 65 20 66 6f 72 6d 61 74 2e 0a 54 68 65 20 64 69  e format..The di
0a50: 66 66 65 72 65 6e 63 65 20 69 73 20 74 68 61 74  fference is that
0a60: 20 74 68 65 20 7a 6c 69 62 20 66 6f 72 6d 61 74   the zlib format
0a70: 20 63 6f 6e 74 61 69 6e 73 20 61 20 74 77 6f 20   contains a two 
0a80: 62 79 74 65 20 63 6f 6d 70 72 65 73 73 69 6f 6e  byte compression
0a90: 2d 74 79 70 65 0a 69 6e 64 65 6e 74 69 66 69 63  -type.indentific
0aa0: 61 74 69 6f 6e 20 68 65 61 64 65 72 20 28 30 78  ation header (0x
0ab0: 37 38 20 30 78 39 63 29 20 61 6e 64 20 61 20 34  78 0x9c) and a 4
0ac0: 2d 62 79 74 65 20 63 68 65 63 6b 73 75 6d 20 61  -byte checksum a
0ad0: 74 20 74 68 65 20 65 6e 64 2e 20 20 54 68 75 73  t the end.  Thus
0ae0: 0a 74 68 65 20 22 64 61 74 61 22 20 66 6f 72 20  .the "data" for 
0af0: 53 51 4c 41 52 20 69 73 20 61 6c 77 61 79 73 20  SQLAR is always 
0b00: 36 20 62 79 74 65 73 20 6c 61 72 67 65 72 20 74  6 bytes larger t
0b10: 68 61 6e 20 74 68 65 20 65 71 75 69 76 61 6c 65  han the equivale
0b20: 6e 74 20 64 61 74 61 20 66 6f 72 0a 5a 49 50 2e  nt data for.ZIP.
0b30: 20 20 54 68 65 20 53 51 4c 41 52 20 70 72 6f 67    The SQLAR prog
0b40: 72 61 6d 20 75 73 65 73 20 74 68 65 20 7a 6c 69  ram uses the zli
0b50: 62 20 66 6f 72 6d 61 74 20 72 61 74 68 65 72 20  b format rather 
0b60: 74 68 61 6e 20 74 68 65 20 73 6c 69 67 68 74 6c  than the slightl
0b70: 79 20 73 6d 61 6c 6c 65 72 0a 72 61 77 20 64 65  y smaller.raw de
0b80: 66 6c 61 74 65 20 66 6f 72 6d 61 74 20 62 65 63  flate format bec
0b90: 61 75 73 65 20 74 68 61 74 20 69 73 20 77 68 61  ause that is wha
0ba0: 74 20 74 68 65 20 0a 5b 7a 6c 69 62 20 64 6f 63  t the .[zlib doc
0bb0: 75 6d 65 6e 74 61 74 69 6f 6e 5d 28 68 74 74 70  umentation](http
0bc0: 73 3a 2f 2f 77 77 77 2e 7a 6c 69 62 2e 6e 65 74  s://www.zlib.net
0bd0: 2f 6d 61 6e 75 61 6c 2e 68 74 6d 6c 29 20 72 65  /manual.html) re
0be0: 63 6f 6d 6d 65 6e 64 73 2e 0a 0a 53 51 4c 41 52  commends...SQLAR
0bf0: 20 6d 69 67 68 74 20 73 6f 6d 65 64 61 79 20 62   might someday b
0c00: 65 20 65 78 74 65 6e 64 65 64 20 74 6f 20 73 75  e extended to su
0c10: 70 70 6f 72 74 20 61 64 64 69 74 69 6f 6e 61 6c  pport additional
0c20: 20 63 6f 6d 70 72 65 73 73 69 6f 6e 20 66 6f 72   compression for
0c30: 6d 61 74 73 0a 6f 74 68 65 72 20 74 68 61 6e 20  mats.other than 
0c40: 64 65 66 6c 61 74 65 2e 20 20 49 66 20 73 6f 2c  deflate.  If so,
0c50: 20 74 68 65 20 64 61 74 61 20 66 69 65 6c 64 20   the data field 
0c60: 77 69 6c 6c 20 63 6f 6e 74 61 69 6e 20 6e 65 77  will contain new
0c70: 20 68 65 61 64 65 72 20 76 61 6c 75 65 73 20 74   header values t
0c80: 6f 0a 69 64 65 6e 74 69 66 79 20 65 6e 74 72 69  o.identify entri
0c90: 65 73 20 63 6f 6d 70 72 65 73 73 65 64 20 75 73  es compressed us
0ca0: 69 6e 67 20 74 68 65 20 6e 65 77 20 66 6f 72 6d  ing the new form
0cb0: 61 74 73 2e 0a 0a 23 23 20 46 75 73 65 20 46 69  ats...## Fuse Fi
0cc0: 6c 65 73 79 73 74 65 6d 0a 0a 41 6e 20 53 51 4c  lesystem..An SQL
0cd0: 69 74 65 20 41 72 63 68 69 76 65 20 66 69 6c 65  ite Archive file
0ce0: 20 63 61 6e 20 62 65 20 6d 6f 75 6e 74 65 64 20   can be mounted 
0cf0: 61 73 20 61 20 0a 5b 46 75 73 65 20 46 69 6c 65  as a .[Fuse File
0d00: 73 79 73 74 65 6d 5d 28 68 74 74 70 3a 2f 2f 66  system](http://f
0d10: 75 73 65 2e 73 6f 75 72 63 65 66 6f 72 67 65 2e  use.sourceforge.
0d20: 6e 65 74 29 20 75 73 69 6e 67 20 74 68 65 20 22  net) using the "
0d30: 73 71 6c 61 72 66 73 22 0a 75 74 69 6c 69 74 79  sqlarfs".utility
0d40: 2c 20 69 6e 63 6c 75 64 69 6e 67 20 77 69 74 68  , including with
0d50: 20 74 68 69 73 20 70 72 6f 6a 65 63 74 2e 0a 0a   this project...
0d60: 54 6f 20 62 75 69 6c 64 20 74 68 65 20 22 73 71  To build the "sq
0d70: 6c 61 72 66 73 22 20 75 74 69 6c 69 74 79 2c 20  larfs" utility, 
0d80: 72 75 6e 3a 0a 0a 20 20 20 20 20 20 20 20 6d 61  run:..        ma
0d90: 6b 65 20 73 71 6c 61 72 66 73 0a 0a 54 68 65 6e  ke sqlarfs..Then
0da0: 20 74 6f 20 6d 6f 75 6e 74 20 61 6e 20 53 51 4c   to mount an SQL
0db0: 69 74 65 20 61 72 63 68 69 76 65 20 61 73 20 61  ite archive as a
0dc0: 20 66 69 6c 65 73 79 73 74 65 6d 2c 20 72 75 6e   filesystem, run
0dd0: 3a 0a 0a 20 20 20 20 20 20 20 20 6d 6b 64 69 72  :..        mkdir
0de0: 20 7e 2f 66 75 73 65 0a 20 20 20 20 20 20 20 20   ~/fuse.        
0df0: 2e 2f 73 71 6c 61 72 66 73 20 41 52 43 48 49 56  ./sqlarfs ARCHIV
0e00: 45 5f 4e 41 4d 45 20 2d 66 20 7e 2f 66 75 73 65  E_NAME -f ~/fuse
0e10: 0a 0a 52 65 70 6c 61 63 65 20 41 52 43 48 49 56  ..Replace ARCHIV
0e20: 45 5f 4e 41 4d 45 20 77 69 74 68 20 74 68 65 20  E_NAME with the 
0e30: 66 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65 20  filename of the 
0e40: 53 51 4c 69 74 65 20 61 72 63 68 69 76 65 20 66  SQLite archive f
0e50: 69 6c 65 20 74 6f 0a 62 65 20 6d 6f 75 6e 74 65  ile to.be mounte
0e60: 64 2c 20 6f 66 20 63 6f 75 72 73 65 2e 0a 54 68  d, of course..Th
0e70: 65 20 2d 66 20 6f 70 74 69 6f 6e 20 6b 65 65 70  e -f option keep
0e80: 73 20 73 71 6c 61 72 66 73 20 72 75 6e 6e 69 6e  s sqlarfs runnin
0e90: 67 20 69 6e 20 74 68 65 20 66 6f 72 65 67 72 6f  g in the foregro
0ea0: 75 6e 64 2c 20 73 6f 20 74 68 61 74 20 79 6f 75  und, so that you
0eb0: 20 63 61 6e 0a 75 6e 6d 6f 75 6e 74 20 74 68 65   can.unmount the
0ec0: 20 66 69 6c 65 73 79 73 74 65 6d 20 62 79 20 73   filesystem by s
0ed0: 69 6d 70 6c 79 20 70 72 65 73 73 69 6e 67 20 74  imply pressing t
0ee0: 68 65 20 69 6e 74 65 72 72 75 70 74 20 6b 65 79  he interrupt key
0ef0: 20 28 75 73 75 61 6c 6c 79 0a 43 74 72 6c 2d 43   (usually.Ctrl-C
0f00: 29 2e 0a                                         )..