---
name: "TM::ResourceAble::MemCached"
section: "3pm"
platform: "linux"
package: "libtm-perl"
version: "1.56-7"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/TM::ResourceAble::MemCached"
---

# TM::ResourceAble::MemCached(3pm)

Topic Maps, Memcached server backend

## NAME

TM::ResourceAble::MemCached - Topic Maps, Memcached server backend

## SYNOPSIS

```
    use TM::ResourceAble::MemCached;
    use Fcntl;
    # create/reset new map
    my $tm = new TM::ResourceAble::MemCached (
                baseuri => 'http://whereever/',
                servers => [ localhost:11211 ],
                mode    => O_TRUNC | O_CREAT,
             );
    # use TM interface

    # open existing map
    my $tm = new TM::ResourceAble::MemCached (
                 baseuri => 'http://whereever/',
                 servers => [ localhost:11211 ],
             );
```

## DESCRIPTION

This package implements TM using a memcached server farm as backend. You should be able (without much testing, mind you, so it is EXPERIMENTAL) to perform all operations according to the TM interface.

**NOTE**: The implementation is using the TIE technique (perltie via Tie::StdHash), so maybe there are problems lurking.

Of course, a set of memcacheds can store any number of maps. To keep them separate, the baseuri is used, so make sure every map gets its own baseuri.

## INTERFACE

### Constructor

The constructor expects a hash with the following keys:

- **servers** (default: none)

  The value must be a reference to an array of strings, each of the form *host*:*port*. If there is no such list, then the constructor will fail.

- **mode** (default: O\_CREAT)

  The value must be a value from Fcntl to control

  - •

    whether the map should be created (`"O_CREAT"`) when it does not exist, and/or

  - •

    whether the map should be cleared (`"O_TRUNC"`) when it existed before.

All other options are passed to the constructor chain of traits (TM::ResourceAble) and superclasses (TM).

## SEE ALSO

TM, TM::ResourceAble

## AUTHOR INFORMATION

Copyright 2010, Robert Barta \<drrho@cpan.org\>, All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  http://www.perl.com/perl/misc/Artistic.html