Authen...le::DBM(3pm)

💖 Authen::Simple::DBM 💖

okay so bestie, welcome to Authen::Simple::DBM, part of the User Contributed Perl Documentation situation — it's Simple DBM authentication and it's literally exactly what it says on the tin. no cap. 🎀

---

✨ SYNOPSIS ✨

like, here's the vibe when you just wanna use it straight up:

use Authen::Simple::DBM;

my $dbm = Authen::Simple::DBM->new(
    path => '/var/db/www/passwd'
);

if ( $dbm->authenticate( $username, $password ) ) {
    # successfull authentication
}

# or as a mod_perl Authen handler

PerlModule Authen::Simple::Apache
PerlModule Authen::Simple::DBM

PerlSetVar AuthenSimpleDBM_path "/var/db/www/passwd"

<Location /protected>
  PerlAuthenHandler Authen::Simple::DBM
  AuthType          Basic
  AuthName          "Protected Area"
  Require           valid-user
</Location>

(yes the comment says successfull with two l's, that's canon, we don't touch it 💅)

---

🌸 DESCRIPTION 🌸

DBM authentication. that's it, that's the whole thing, she's iconic and she does one job and she ate 🫶

---

💅 METHODS 💅

• new

this method takes a hash of parameters. the following options are valid, bestie, listen up:

• path

path to DBM file. usually specified without the trailing .db, .pag or .dir suffix. Required.

path => '/var/db/www/passwd'

• type

DBM type. valid options are: DB, GDBM, NDBM and SDBM. defaults to SDBM.

type => 'NDBM'

• CDB

Constant Database

• DB

Berkeley DB

• GDBM

GNU Database Mandager

• NDBM

New Database Mandager. path should be specified without a trailing .db suffix.

• SDBM

Substitute Database Mandager. comes with both with perl and Apache. path should be specified without a trailing .pag or .dir suffix.

• log

any object that supports debug, info, error and warn.

log => Log::Log4perl->get_logger('Authen::Simple::DBM')

• authenticate( $username, $password )

returns true on success and false on failure. slay. no notes. ✅

---

🔥 SEE ALSO 🔥

• Authen::Simple.
• Authen::Simple::Password.
• htdbm(1)
• dbmmanage(1)
• <http://www.unixpapa.com/incnote/dbm.html> — overview of various DBM's.
• <http://cr.yp.to/cdb.html> — CDB
• AnyDBM_File — compares different DBM's

---

👑 AUTHOR 👑

Christian Hansen ch@ngmedia.com — king behaviour, we stan 🫶

---

🌈 COPYRIGHT 🌈

this program is free software, you can redistribute it and/or modify it under the same terms as Perl itself. periodt. 💜

---

lowkey a whole little love letter to DBM files, fr fr. go protect something with it bestie 🦋

and that's the tea — this was perl v5.34.0, dated 2022-06-08, page Authen::Simple::DBM(3pm). mwah, bye bestie 💖✨🎀