Fix Coverity issue #101133.
[libpwmd.git] / README
blob4cfae1e5cac954af0096cac3536e26602a3c8f10
1 This is a library making it easy to patch applications to send commands to
2 PWMD.  There is an included command line client 'pwmc' that reads protocol
3 commands from stdin or in an interactive shell-like mode and sends them to the
4 pwmd server. Read libpwmd(3) or pwmc(1) for all the details. Read
5 doc/tutorial.html for an introduction to pwmd and pwmc usage (recommended).
8 Requirements:
9     C99 compiler - http://www.gnu.org/software/gcc/
10                    Is a good choice. Required.
12     libassuan    - http://www.gnupg.org/
13                    Protocol. Version 2.0.3 or later is required. Version 2.1.0
14                    or later is recommended.
16     libgpg-error - http://www.gnupg.org/
17                    libassuan (and pwmd) return gpg error codes. Required.
19     libreadline  - http://www.gnu.org/software/readline/
20                    For an interactive shell-like interface to pwmc. Optional.
21     
22     pwmd         - http://pwmd.sourceforge.net/
23                    Version 3.1 or later. Version 7.3.0 and later of libpwmd
24                    are backward compatible with pwmd version 3.0.x but the
25                    pwmc client included in libpwmd 7.3.0 is not and requires
26                    pwmd 3.1 or later.
28 If you want to do remote connections to a pwmd server:
30     libssh2      - http://libssh2.org/
31                    Version 1.2.9 or later is required for SSH connections.
33     gnutls       - http://www.gnu.org/software/gnutls/
34                    For remote connections over TLS.
37 For functions that use a local pinentry and when --disable-pinentry is not
38 passed to configure, then you'll need:
40     pinentry     - ftp://ftp.gnupg.org/gcrypt/pinentry/
41                    There are various interfaces for passphrase entry:
42                    console/curses, X11/GTK2, X11/QT. The X11 versions also
43                    support console/curses. Version 0.7.6 or later is required.
45     cracklib2    - http://sourceforge.net/projects/cracklib
46                    If --enable-quality is passed to ./configure then a
47                    passphrase quality meter is used with the local pinentry.
48                    Optional.
51 GIT Repository
52 --------------
53 There is a public GIT repository available at repo.or.cz. Anonymous checkouts
54 can be done by:
56     git clone git://repo.or.cz/libpwmd.git
58 The gitweb interface can be viewed at http://repo.or.cz/w/libpwmd.git.
61 Mailing lists
62 -------------
63 For libpwmd:
64 https://lists.sourceforge.net/lists/listinfo/libpwmd-users
65 https://lists.sourceforge.net/lists/listinfo/libpwmd-devel
67 And for pwmd:
68 https://lists.sourceforge.net/lists/listinfo/pwmd-users
69 https://lists.sourceforge.net/lists/listinfo/pwmd-devel
72 Ben Kibbey <bjk@luxsci.net>
73 http://libpwmd.sourceforge.net/