IO::Adapter Overview

All IO of fml8 should use IO::Adapter class like vfs/vnode framework. For example, read/write member list, add/remove a user. The usage is like this:

use IO::Adapter;
$obj = new IO::Adapter $map, $map_params;
$obj->open || croak("cannot open $map");
while ($x = $obj->get_next_key()) { ... }
$obj->close;

$map is map:identifier. file: can be omitted. Currently available maps follow:

file:/var/spool/ml/elena/recipients
unix.group:root
nis.group:root
mysql:id
postgresql:id
ldap:id      

"file:" map is a normal file (text file). "unix.group:root" map is to read root entry in /etc/group file. "nis.group:root" map is to read root entry in NIS (YP). "mysql:id" map implies the use of MySQL. Parameters for MySQL access is defined in "mysql:id" entry. These paraemeters should be specified before calling "new IO::Adapter".