Net::G...g2::DBI(3pm)

📦 version 1.07, in ubuntu jammy

💖 NAME 💖

Net::Google::SafeBrowsing2::DBI — the base class for all the DBI-based back-end storage for the Google Safe Browsing v2 database, bestie.

(Also, hi, you're on the Net::G...g2::DBI(3pm) page from User Contributed Perl Documentation — that's the truncated name up top, the module itself is the full Net::Google::SafeBrowsing2::DBI 💅)

✨ SYNOPSIS ✨

use Net::Google::SafeBrowsing2::MySQL;

my $storage = Net::Google::SafeBrowsing2::MySQL->new(host => '127.0.0.1', database => 'GoogleSafeBrowsingv2');
...
$storage->close();

okay so like, you don't really use this one on its own — you use one of its children (like the MySQL one right up there) and it inherits the whole drip. main character energy, honestly. 🫶

🌸 DESCRIPTION 🌸

This is a base implementation of Net::Google::SafeBrowsing2::Storage using DBI. That's the whole vibe. No cap.

🎀 CONSTRUCTOR 🎀

new()

This method should be overwritten. (not me being a base class and telling you to go write your own 💀 it's literally the assignment, girlies.)

Arguments

  • keep_all — Optional. Set it to 1 to keep old information (such as expiring full hashes) chilling in the database. Defaults to 0, which means delete. 🗑️

👑 PUBLIC FUNCTIONS 👑

See Net::Google::SafeBrowsing2::Storage for a complete list of public functions — the full menu is over there, go look, bestie.

close()

Cleans up old full hashes, and closes the connection to the database. It's giving graceful exit, honestly 🦋

$storage->close();

export()

Exports add chunks and sub chunks to a file. The file content looks like what Google sends in redirections. That file can be used with the "import_chunks" function from "Net::Google::SafeBrowsing2". This is useful when moving from one back-end storage to another — like a storage glow-up, iconic ✨

$storage->export(list => MALWARE);

Arguments

  • list — Required. The Google Safe Browsing list to export.
  • file — Optional. Filename to export to. Uses "$list.dat" by default.

💫 CHANGELOG 💫

  • 0.7 New "export()" function. Keep empty sub chunks. Fix index for sub chunks.
  • 0.6 Add option keep_all to keep expired full hashes. Useful for debugging.
  • 0.5 Return the hostkey in get_add_chunks.
  • 0.4 Fix duplicate insert of add chunks and sub chunks.
  • 0.3 Add reset function to reset all tables for a given list
  • 0.2 Replace "INSERT OR REPLACE" statements by DELETE + INSERT to work with all databases

🫶 SEE ALSO 🫶

🌈 AUTHOR 🌈

Julien Sobrier, <jsobrier@zscaler.com> or <julien@sobrier.net>

Copyright (C) 2011 by Julien Sobrier

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

and that's the whole page, bestie, we ate and left no crumbs 🍓🧚

written for perl v5.32.0, dated 2021-01-07 — mwah, go slay your Safe Browsing setup 💅💖
📦 where this page comes from