A few documentation updates.
[libpwmd.git] / README
blobdfff705d9dc46132273e2c60fbea7040e4821c60
1 This is a library making it easy to patch applications to send commands to
2 PWMD. Features include:
4         * Thread safe (POSIX and libpth2 (optional) supported)
5         * Asynchronous pinentry when threading isn't possible
6         * Secure remote connections over SSH using libssh2
7         * Secure memory functions which applications may also use
9 Read libpwmd.h or libpwmd(3) for all the details. There is an included
10 command line client 'pwmc' that reads protocol commands from stdin and sends
11 them to the pwmd server.
14 Requirements:
15     C99 compiler - http://www.gnu.org/software/gcc/
16                    Is a good choice.
18     libgpg-error - http://www.gnupg.org/
19                    libassuan (and pwmd) returns gpg error codes.
21     libpth2      - http://www.gnu.org/software/pth/pth.html
22                    Portable multi-threading library. Optional.
23     
24     pwmd         - http://bjk.sourceforge.net/pwmd/
25                    Version 1.11 or later.
27 If you want to do remote SSH connections to a pwmd server:
29     libssh2      - http://libssh2.org/
30                    Version 1.0 has been tested to work.
32     libc-ares    - http://c-ares.haxx.se/
33                    For asynchronous DNS lookups. Version 1.5.2 has been tested
34                    to work.
36 For functions that use a local pinentry (and not pwmd's pinentry) and if
37 --disable-pinentry is not passed to configure, then you'll need:
39     pinentry     - ftp://ftp.gnupg.org/gcrypt/pinentry/
40                    There are various interfaces for passphrase entry:
41                    console/curses, X11/GTK2, X11/QT. The X11 versions also
42                    support console/curses. Version 0.7.5 or later is required.
44     cracklib2    - http://sourceforge.net/projects/cracklib
45                    If --enable-quality is passed to ./configure then a
46                    passphrase quality meter is used with the local pinentry.
47                    Optional.
50 GIT Repository
51 --------------
52 There is a public GIT repository available at repo.or.cz. Anonymous checkouts
53 can be done by:
55     git clone git://repo.or.cz/libpwmd.git
57 The gitweb interface can be viewed at http://repo.or.cz/w/libpwmd.git.
59 Ben Kibbey <bjk@luxsci.net>
60 http://bjk.sourceforge.net/pwmd/.