Re: [GNU Crypto] Documentation

[Raif S. Naffah]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

On Sat, 24 May 2003 01:41 pm, Casey Marshall wrote:
> On Fri, May 23, 2003 at 10:27:28PM +0100, baz wrote:
> > ...
> > Can someone tell me if there exists some basic design documentation
> > for gnu-crypto?...
> >
> > Documentation is limited to the source code/javadoc and the
> > references on the home page to the details of the algorithms, but
> > nothing on the basics of going about using the library.
>
> See
> <http://metastatic.org/text/Documentation/gnu-crypto/manual.html>, or
> <http://metastatic.org/text/Documentation/gnu-crypto/manual.pdf>.
>
> This documentation is not complete, and really isn't official yet,
> but may still give some insight even as a rough draft. I haven't had
> time to work on it lately, but may try to get working on it again
> soon.
>
> The basic usage of GNU Crypto objects is typically:
>
>    1. Create an object with a factory method.
>    2. Initialize the object with an attributes Map.
>    3. Use the object.
>    4. Reset the object and go to step 2.
>
> Also note that many algorithms are low-level, e.g. with block ciphers
> it is up to you to break the input data into block-sized chunks
> before you feed them to the {en,de}cryptBlock methods...

it is worth adding at this point, that with the recent additions to the 
library of the gnu.crypto.assembly packages, you can do things similar 
to what the JCE allows you to by using an "cipher/mod/padding" name 
construction, and more.  have a look at the two test (example) classes:

gnu.testlet.gnu.crypto.assembly.TestOfAssembly, and
gnu.testlet.gnu.crypto.assembly.TestOfCascade.

the first one demonstrates how one can build a 3-des cipher from 3 
separate des ciphers, while the second demonstrates how to build a 
construction that (a) encrypts/decrypts, (b) in a given mode, (c) with 
padding/unpadding, and (d) with compression/decompression.


cheers;
rsn
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)
Comment: Que du magnifique

iD8DBQE+0ByS+e1AKnsTRiERAwiHAJ4mNjMwDplXPxlF9H3eXeoVn86GwgCg+NnN
Qwg6Nct35LPPMKJ8wKag2Lg=
=cc7p
-----END PGP SIGNATURE-----