Add pages for lib{assuan,ksba,gpg-error}, and pinentry.
authorWerner Koch <wk@gnupg.org>
Mon, 26 Aug 2013 14:57:23 +0000 (16:57 +0200)
committerWerner Koch <wk@gnupg.org>
Wed, 6 Nov 2013 11:55:06 +0000 (12:55 +0100)
web/related_software/libassuan/index.org [new file with mode: 0644]
web/related_software/libgpg-error/index.org [new file with mode: 0644]
web/related_software/libksba/index.org [new file with mode: 0644]
web/related_software/libraries.org
web/related_software/pinentry/index.org [new file with mode: 0644]
web/related_software/tools.org

diff --git a/web/related_software/libassuan/index.org b/web/related_software/libassuan/index.org
new file mode 100644 (file)
index 0000000..a660076
--- /dev/null
@@ -0,0 +1,45 @@
+#+STARTUP: showall
+#+SETUPFILE: "../../share/setup.inc"
+
+* Libassuan
+
+  /Libassuan/ is a small library implementing the so-called /Assuan
+  protocol/. This protocol is used for IPC between most newer GnuPG
+  components. Both, server and client side functions are provided.
+
+  In an ideal world, Assuan is irrelevant. Assuan's primary use is to
+  allow a client to interact with a non-persistent server. Using
+  Assuan, this is accomplished by forking a subprocess and
+  communicating with it via, for example, a pipe or unix domain
+  socket. This method is neither elegant nor efficient especially when
+  there is a lot of data spread across several transactions: not only
+  is there a penalty for an increased number of context switches, but
+  also a significant amount of data is memcpy-ed from the client to a
+  file descriptor and from the file descriptor to the server. Despite
+  these and other disadvantages, this type of client/server
+  communication can be useful: the client is completely separate from
+  the server; they are in different address spaces. This is especially
+  important in situations where the server must have a known degree of
+  reliability and data must be protected: as the Assuan protocol is
+  well defined and clients cannot corrupt the servers' address space,
+  auditing become much easier.
+
+  Assuan was developed for use by the GNU Privacy Guard, GnuPG, to
+  prevent potentially buggy clients from unwittingly corrupting
+  sensitive transactions or compromising data such as a secret
+  key. Assuan permits the servers, which do the actual work,
+  e.g. encryption and decryption of data using a secret key, to be
+  developed independently of the user interfaces, e.g. mail clients
+  and other encryption front ends. Like a shared library, the
+  interface is well defined and any number of front ends can use it;
+  however, unlike a shared library, the client cannot see or touch the
+  server's data. As with any modular system, Assuan helps keep the
+  servers small and understandable, and helps to make code more
+  understandable and less error prone.
+
+  Assuan is not, however, limited to use with GnuPG servers and
+  clients: it was design to be flexible enough to meet the demands of
+  almost any transaction based environment with non-persistent
+  servers.
+
+  See the [[file:~/s/gnupg-web/web/download/index.org::libassuan][download]] section for the latest tarball.
diff --git a/web/related_software/libgpg-error/index.org b/web/related_software/libgpg-error/index.org
new file mode 100644 (file)
index 0000000..78f14e3
--- /dev/null
@@ -0,0 +1,11 @@
+#+STARTUP: showall
+#+SETUPFILE: "../../share/setup.inc"
+
+* Libgpg-error
+
+  /Libgpg-error/ is a small library that defines common error values
+  for all GnuPG components. Among these are GPG, GPGSM, GPGME,
+  GPG-Agent, libgcrypt, Libksba, DirMngr, Pinentry, SmartCard Daemon
+  and possibly more in the future.
+
+  See the [[file:~/s/gnupg-web/web/download/index.org::libgpg-error][download]] section for the latest tarball.
diff --git a/web/related_software/libksba/index.org b/web/related_software/libksba/index.org
new file mode 100644 (file)
index 0000000..b25e6c4
--- /dev/null
@@ -0,0 +1,18 @@
+#+STARTUP: showall
+#+SETUPFILE: "../../share/setup.inc"
+
+* Libksba
+
+  /Libksba/ is a library to make the tasks of working with X.509
+  certificates, CMS data and related objects more easy. It provides a
+  highlevel interface to the implemented protocols and presents the
+  data in a consistent way. There is no more need to worry about all
+  the nasty details of the protocols. The API gives the C programmer
+  an easy way of interacting with the data. It copes with the version
+  details X.509 protocols tend to have as well as with the many
+  different versions and dialects. Applications must usually cope with
+  all of this and it has to be coded over and over again. /Libksba/
+  hides this by providing just one API which does the Right
+  Thing\trade. Support for new features will be added as needed.
+
+  See the [[file:~/s/gnupg-web/web/download/index.org::libksba][download]] section for the latest tarball.
index 54ed8c3..4b7fa32 100644 (file)
@@ -8,14 +8,14 @@
   If you feel wanting to improve this list, please, fill in a [[#gpgweb][Problem
    Report]] form.
 
-   -  [[http://www.lothar.com/tech/crypto/][EGD]] :: Unices without a /dev/random should [[../download/index.en.html#EGD][download]] and install
+   -  [[http://www.lothar.com/tech/crypto/][EGD]] :: Unices without a /dev/random should [[file:~/s/gnupg-web/web/download/index.org::egd][download]] and install
              this Entropy Gathering Daemon.
    -  [[http://github.com/smartrevolution/gnupg-for-java][gnupg-for-java]] :: This is a Java binding for GPGME library.
    -  [[http://www.gnu.org/software/gnutls/][GNUTLS]] :: A somewhat related project to GnuPG is GNUTLS which is
                 is a GPLed TLS/SSL implementation.
-   -  [[gpgme/index.en.html][GPGME]] :: GnuPG Made Easy is a library designed to make access to
+   -  [[file:gpgme/index.org][GPGME]] :: GnuPG Made Easy is a library designed to make access to
                GnuPG easier for applications.
-   -  [[libassuan/index.en.html][libassuan]] :: Libassuan is the IPC library used by some GnuPG
+   -  [[file:libassuan/index.org][libassuan]] :: Libassuan is the IPC library used by some GnuPG
                    related software.
    -  [[http://directory.fsf.org/wiki/Libgcrypt][libgcrypt]] :: Libgcrypt is a general purpose cryptographic
                    library based on the code from GnuPG. It provides
@@ -23,8 +23,8 @@
                    symmetric ciphers, hash algorithms, MACs, public
                    key algorithms, large integer functions, random
                    numbers and a lot of supporting functions.
-   -  [[libgpg-error/index.en.html][libgpg-error]] :: Libgpg-error is helper library used by a couple
+   -  [[file:libgpg-error/index.org][libgpg-error]] :: Libgpg-error is helper library used by a couple
                       of other projects to provide a common set of
                       error codes and descriptions.
-   -  [[libksba/index.en.html][libksba]] :: Libksba provides an easy API to create and parse
+   -  [[file:libksba/index.org][libksba]] :: Libksba provides an easy API to create and parse
                  X.509 and CMS related objects.
diff --git a/web/related_software/pinentry/index.org b/web/related_software/pinentry/index.org
new file mode 100644 (file)
index 0000000..0f258d3
--- /dev/null
@@ -0,0 +1,11 @@
+#+STARTUP: showall
+#+SETUPFILE: "../../share/setup.inc"
+
+* pinentry
+
+  /pinentry/ is a small collection of dialog programs that allow GnuPG
+  to read passphrases and PIN numbers in a secure manner. There are
+  versions for the common GTK and Qt toolkits as well as for the text
+  terminal (Curses).
+
+  See the [[file:~/s/gnupg-web/web/download/index.org::pinentry][download]] section for the latest tarball.
index e7c049e..39d5973 100644 (file)
@@ -16,5 +16,5 @@ Report]] form.
         (see Enigform).
    -  [[http://www.pgpdump.net/][PGPdump Web interface]] :: Can be used to analyze OpenPGP data
         formats.
-   -  [[pinentry/index.en.html][pinentry]] :: Secure PinEntry Dialog.
+   -  [[file:pinentry/index.org][pinentry]] :: Secure PinEntry Dialog.