aboutsummaryrefslogtreecommitdiffstats
path: root/src/contrib/sqlite/readme.txt
blob: 4971fd44b2815611c6dc0e618907e2842447da25 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
Build instructions for BotanSqlite3
---

Requirements:
  1. Botan 1.9.0 or later
  2. SQLite3 amalgamation source, version 3.7.12.1 or later (previous versions may work, some will need minor changes)


Building:

1. Extract sqlite3 amalgamation to a directory and add BotanSqlite3 source files

   If desired, codec.h can be modified to tweak the encryption algothrithms and parameters. (Defaults to Twofish/XTS with 256 bit key)

2. Apply the patch "sqlite3.diff":
    $ patch -p0 < sqlite3-amalgamation.patch

   If the patching fails for some reason (ie, changes in SQLite3), it should be trivial to do it manually.

3. Compile the sqlite3 library with Botan encryption support:
    $ gcc -c sqlite3.c -o botansqlite3.o && gcc -c codec.cpp -o codec.o `pkg-config --cflags botan-1.10` && ar rcs libbotansqlite3.a botansqlite3.o codec.o
    
    (replace "botan-1.10" with appropriate version)

Testing:

1. Build the test:
      $ g++ test_sqlite.cpp -o test_sqlite `botan-config-1.10 --libs` ./libbotansqlite3.a
      
      (replace botan-config-1.10 w/ appropriate version)

2. Run the test
      $ ./test_sqlite

3. Look for "All seems good"