README.txt
author Volker Birk <vb@pep-project.org>
Tue, 16 Feb 2016 15:31:24 +0100
changeset 447 6190f1ed4466
parent 37 7928e0e6eee9
child 448 a614a8dcf250
permissions -rw-r--r--
adapting README
     1 p≡p Engine
     2 ==========
     3 
     4 0. What it is and building it
     5 -----------------------------
     6 
     7 The p≡p engine is a Free Software library encapsulating implementations of:
     8 
     9 - Key Management
    10 
    11   Key Management in p≡p engine is based on GnuPG key chains (NetPGP on iOS).
    12   Keys are stored in an OpenPGP compatbile format and can be used for different
    13   crypto implementations.
    14 
    15 - Trust Rating
    16 
    17   p≡p engine is sporting a two phase trust rating system. In phase one there is
    18   a rating based on channel, crypto and key security named “comm_types”. In
    19   phase 2 these are mapped to user representable values which have attached
    20   colors to present them in traffic light semantics.
    21 
    22 - Abstract Crypto API
    23 
    24   The Abstract Crypto API is providing functions to encrypt and decrypt data or
    25   full messages without requiring an application programmer to understand the
    26   different formats and standards.
    27 
    28 - Message Transports
    29 
    30   p≡p engine will sport a growing list of Message Transports to support any
    31   widespread text messaging system including E-Mail, SMS, XMPP and many more.
    32 
    33 p≡p engine is written in C99. It is not meant to be used in application code
    34 directly. Instead, p≡p engine is coming together with a list of software
    35 adapters for a variety of programming languages and development environments.
    36 
    37 p≡p engine is under Gnu General Public License v3. If you want to use it under
    38 a different license, please contact mailto:council@pep.foundation.
    39 
    40 p≡p engine has an old style Makefile for building it.
    41 
    42 The build is configured in Makefile.conf
    43 
    44 It supports the common targets
    45 
    46 $ make all
    47 $ make install
    48 $ make clean
    49 
    50 and additionally
    51 
    52 $ make package # for building a .tar.bz2 with the source distribution
    53 
    54 On Windows, use Visual Studio.
    55 
    56 1. How to cross-build
    57 ---------------------
    58 
    59 For cross-building, BUILD_FOR is being used. I.e.:
    60 
    61 $ BUILD_FOR=yourOS make -e windist
    62 
    63 2. How to build the databases
    64 -----------------------------
    65 
    66 p≡p Engine uses two databases: ~/.pEp_management (on *NIX) or
    67 %LOCALAPPDATA%\pEp\management.db on Windoze respectively, and
    68 /usr/local/share/system.db on *NIX or %ALLUSERSPROFILE%\pEp\system.db
    69 respectively. The latter contains the Trustwords dbs.
    70 
    71 The managment db is being created by the first call of init() of p≡p Engine. It
    72 does not need to be created manually. system.db is being created by using the
    73 DDL in db/create_system_db.sql – the content is created by db/dic2csv.py
    74 out of hunspell's dictionary packages (or something similar) and then being
    75 imported using sqlite3's .import command.
    76 
    77 You can test the Trustwords in system.db using db/trustwords.py
    78 Both Python tools have a switch --help
    79