WWW::RobotRules::AnyDBM_File(3pm)

WWW::RobotRules::AnyDBM_File3pm

Persistent robotrules

Usage

    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', '[email protected]', $rules );
    # Then just use $ua as usual
    $res = $ua->request($req);

Overview

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.

Releases

18 releases since Debian 1.2 (Rex); the text changed 12 times.

  1. 1.2
  2. 1.3
  3. 2.0
  4. 2.1
  5. 2.2
  6. 3.0
  7. 3.1
  8. 4.0
  9. 5.0
  10. 6.0
  11. 7–9
  12. 10–13
  13. Arch