notedb::general(3pm) [debian man page]

NOTEDB::general(3pm)					User Contributed Perl Documentation				      NOTEDB::general(3pm)

NAME

       NOTEDB::general - module lib for accessing a notedb from perl

SYNOPSIS

	       # include the module
	       use NOTEDB;

	       # create a new NOTEDB object
	       $db = new NOTEDB("text", "/home/tom/.notedb", 4096, 24);

	       # decide to use encryption
	       # $key is the cipher to use for encryption
	       # $method must be either Crypt::IDEA or Crypt::DES
	       # you need Crypt::CBC, Crypt::IDEA and Crypt::DES to have installed.
	       $db->use_crypt($key,$method);

	       # do not use encryption
	       # this is the default
	       $db->no_crypt;

	       # get a single note
	       ($note, $date) = $db->get_single(1);

	       # search for a certain note
	       %matching_notes = $db->get_search("somewhat");
	       # format of returned hash:
	       #$matching_notes{$numberofnote}->{'note' => 'something', 'date' => '23.12.2000 10:33:02'}

	       # get all existing notes
	       %all_notes = $db->get_all();
	       # format of returnes hash like the one from get_search above

	       # get the next noteid available
	       $next_num = $db->get_nextnum();

	       # modify a certain note
	       $db->set_edit(1, "any text", "23.12.2000 10:33:02");

	       # create a new note
	       $db->set_new(5, "any new text", "23.12.2000 10:33:02");

	       # delete a certain note
	       $db->set_del(5);

	       # turn on encryption. CryptMethod must be IDEA, DES or BLOWFISH
	       $db->use_crypt("passphrase", "CryptMethod");

	       # turn off encryption. This is the default.
	       $db->no_crypt();

DESCRIPTION

       You can use this module for accessing a note database. This backend uses a text file for storage and Config::General for accessing the
       file.

       Currently, NOTEDB module is only used by note itself. But feel free to use it within your own project! Perhaps someone want to implement a
       webinterface to note...

USAGE

       please see the section SYNOPSIS, it says it all.

AUTHOR

       Thomas Linden <tom@daemon.de>.

perl v5.10.1							    2008-11-17						      NOTEDB::general(3pm)

DES(3)							User Contributed Perl Documentation						    DES(3)

NAME

       Crypt::DES - Perl DES encryption module

SYNOPSIS

	   use Crypt::DES;

DESCRIPTION

       The module implements the Crypt::CBC interface, which has the following methods

       blocksize =item keysize =item encrypt =item decrypt

FUNCTIONS

       blocksize
	   Returns the size (in bytes) of the block cipher.

       keysize
	   Returns the size (in bytes) of the key. Optimal size is 8 bytes.

       new
		   my $cipher = new Crypt::DES $key;

	   This creates a new Crypt::DES BlockCipher object, using $key, where $key is a key of "keysize()" bytes.

       encrypt
		   my $cipher = new Crypt::DES $key;
		   my $ciphertext = $cipher->encrypt($plaintext);

	   This function encrypts $plaintext and returns the $ciphertext where $plaintext and $ciphertext should be of "blocksize()" bytes.

       decrypt
		   my $cipher = new Crypt::DES $key;
		   my $plaintext = $cipher->decrypt($ciphertext);

	   This function decrypts $ciphertext and returns the $plaintext where $plaintext and $ciphertext should be of "blocksize()" bytes.

EXAMPLE

	       my $key = pack("H16", "0123456789ABCDEF");
	       my $cipher = new Crypt::DES $key;
	       my $ciphertext = $cipher->encrypt("plaintex");  # NB - 8 bytes
	       print unpack("H16", $ciphertext), "
";

NOTES

       Do note that DES only uses 8 byte keys and only works on 8 byte data blocks.  If you're intending to encrypt larger blocks or entire files,
       please use Crypt::CBC in conjunction with this module.  See the Crypt::CBC documentation for proper syntax and use.

       Also note that the DES algorithm is, by today's standard, weak encryption.  Crypt::Blowfish is highly recommended if you're interested in
       using strong encryption and a faster algorithm.

SEE ALSO

       Crypt::Blowfish Crypt::IDEA

       Bruce Schneier, Applied Cryptography, 1995, Second Edition, published by John Wiley & Sons, Inc.

COPYRIGHT

       The implementation of the DES algorithm was developed by, and is copyright of, Eric Young (eay@mincom.oz.au).  Other parts of the perl
       extension and module are copyright of Systemics Ltd ( http://www.systemics.com/ ).  Cross-platform work and packaging for single algorithm
       distribution is copyright of W3Works, LLC.

MAINTAINER

       This single-algorithm package and cross-platform code is maintained by Dave Paris <amused@pobox.com>.

perl v5.16.3							    2005-12-08								    DES(3)