WWW::RobotRules::AnyDBM_File(3)            User Contributed Perl Documentation


NAME
       WWW::RobotRules::AnyDBM_File - Persistent RobotRules

SYNOPSIS
           require WWW::RobotRules::AnyDBM_File;
           require LWP::RobotUA;

           # Create a robot useragent that uses a diskcaching RobotRules
           my $rules = WWW::RobotRules::AnyDBM_File->new( 'my-robot/1.0', 'cachefile' );
           my $ua = WWW::RobotUA->new( 'my-robot/1.0', 'me@foo.com', $rules );

           # Then just use $ua as usual
           $res = $ua->request($req);

DESCRIPTION
       This is a subclass of WWW::RobotRules that uses the AnyDBM_File package
       to implement persistent diskcaching of robots.txt and host visit
       information.

       The constructor (the new() method) takes an extra argument specifying
       the name of the DBM file to use.  If the DBM file already exists, then
       you can specify undef as agent name as the name can be obtained from
       the DBM database.

SECURITY CONSIDERATIONS
       The caller-supplied DBM filename must reside in a directory writable
       only by the same user that runs this code. The underlying "AnyDBM_File"
       backends open the file via the C open(2) syscall without "O_NOFOLLOW",
       so a symlink at the cache path (or at its ".dir"/".pag"/".db" siblings)
       will be followed and the linked target may be overwritten with DBM page
       data. The cache file is created with mode 0600; callers that need
       different permissions can "chmod" after construction.

SEE ALSO
       WWW::RobotRules, LWP::RobotUA

AUTHORS
       Hakan Ardo <hakan@munin.ub2.lu.se>, Gisle Aas <aas@sn.no>

perl v5.42.2                      2026-05-23   WWW::RobotRules::AnyDBM_File(3)