source: README @ 8bece4

Cache-Memcached-Fast version 0.19
=================================

Cache::Memcahced::Fast is a Perl client for memcached, a memory cache
daemon (http://www.danga.com/memcached/).  Module core is implemented
in C and tries hard to minimize number of system calls and to avoid
any key/value copying for speed.  As a result, it has very low CPU
consumption.

API is largely compatible with Cache::Memcached, original pure Perl
client, most users of the original module may start using this module
by installing it and adding "::Fast" to the old name in their scripts
(see "Compatibility with Cache::Memcached" section in the module
documentation for full details).

The module does not depend on any external library, it contains custom
memcached client implementation in C designed for efficient
interaction with Perl (actually client code has well defined generic
API and may be used by itself).

The module should compile and work on any Unix-derived system.  Win32
support is based on the patch by Yasuhiro Matsumoto---thanks!, and is
(expected to be) supported by community.  Note: on Win32 below Windows
Vista max number of memcached servers is 64.  See comment on
FD_SETSIZE in src/socket_win32.h to learn how to increase this value
if you need to connect to more than 64 servers.

Despite the low version number (which mainly reflects release history)
the module is considered to be beta (see BUGS below on how to report
bugs).  See "Compatibility with Cache::Memcached" section in the
module documentation for the description of what is missing compared
to Cache::Memcached.


INSTALLATION

Latest release of this module is available from CPAN:

  http://search.cpan.org/dist/Cache-Memcached-Fast/

Latest development tree is available from project home:

  http://openhack.ru/Cache-Memcached-Fast


To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

Don't forget to start memcahced daemon on local host port 11211 (the
default) before running 'make test'.


DEPENDENCIES

This module requires these other modules and software:

  ANSI C compiler to compile module core

  Test::More (required only to run tests)


SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Cache::Memcached::Fast

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Cache-Memcached-Fast

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Cache-Memcached-Fast

    CPAN Ratings
        http://cpanratings.perl.org/d/Cache-Memcached-Fast

    Search CPAN
        http://search.cpan.org/dist/Cache-Memcached-Fast


BUGS

Please report any bugs or feature requests to bug-cache-memcached-fast
at rt.cpan.org, or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Cache-Memcached-Fast.
I will be notified, and then you'll automatically be notified of
progress on your bug as I make changes.


COPYRIGHT AND LICENCE

Copyright (C) 2007-2010 Tomash Brechko.  All rights reserved.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.

When C client is used as a standalone library:

This library is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.