NAME

Tie::Dict - tie a hash to an RPC dict server

SYNOPSIS

use Tie::Dict;

tie %hash, Tie::Dict, $server, $dictionary;

$hash{'this'} = 'that';
$this = $hash{'this'};
delete $hash{'this'};

untie %foo;

DESCRIPTION

Tie::Dict is a module which allows Perl programs to tie a hash to an RPC server running the 'dict' service. This allows several processes (on the same machine or different machines) to share a dictionary without worrying about concurrency (RPC calls are serialized on the server).

The arguments to the tie call are the hostname of the server and the dictionary to tie to. If the tie fails for some reason (e.g. the server is down, the dictionary couldn't be opened, etc.), an exception is raised.

In the default implementation of the 'dict' service, the dictionary is the filename of an underlying DB_File. Other implementations could map names differently.

SEE ALSO

Tie::Hash(3), Dict.pl(1)

AUTHOR

Jake Donham <jake@organic.com>

THANKS

Thanks to Organic Online <http://www.organic.com/> for letting me hack at work.

BUGS

The full tied hash interface is not implemented.