Crypt::...derField(3)

📦
version 1.23~20220227git002b0f0 · 2 versions
, in fedora 43

💖 Crypt::PWSafe3::HeaderField — NAME ✨

okay so bestie, this is Crypt::PWSafe3::HeaderField from the User Contributed Perl Documentation (section 3 of the manual, iykyk) — it's the class that represents a passwordsafe v3 header field. tiny but mighty. 💅

🌸 SYNOPSIS 🌸

no thoughts, just code:

use Crypt::PWSafe3;
my $who = $vault->getheader('wholastsaved');
print $who->value;

my $h = Crypt::PWSafe3::HeaderField->new(name => 'savedonhost',
                                        value => 'localhost');
$vault->addheader($h);

like. look at her. iconic. 👑

🦋 DESCRIPTION 🦋

so Crypt::PWSafe3::HeaderField represents a header field. that's the whole vibe. BUT — and this is important — it's the raw implementation, which means you, a normal person, normally don't have to cope with it. it's giving internal plumbing. background character energy (affectionate).

However, if you ever do have to deal with it, you can add or replace any field type like this:

my $field = Crypt::PWSafe3::HeaderField->new(
                                       value => 'localhost',
                                       name  => 'savedonhost'
                                     );
$record->addheader($field);

and this is the preferred way to do it, fr fr — Crypt::PWSafe3 does it internaly exactly like this. (that's their spelling, not a typo of mine, we keep it 💖)

⚠️ if there already exists a field of this type, it will be overwritten. no warning, no "are you sure", no "bestie wait" — just gone. so, like, know that going in. 😭

🎀 HEADER FIELDS 🎀

a password safe v3 database supports the following header fields, and yes we are listing every single one because we don't skip:

  • version
  • uuid
  • preferences
  • treedisplaystatus
  • lastsavetime
  • wholastsaved
  • whatlastsaved
  • savedbyuser
  • savedonhost
  • databasename
  • databasedescr
  • databasefilters
  • eof

refer to Crypt::PWSafe3::Databaseformat for the details on those header fields. she's got the lore. 📖

💜 SEE ALSO 💜

  • Crypt::PWSafe3

⭐ AUTHOR ⭐

T.v.Dein <tlinden@cpan.org>

Copyright (c) 2011-2015 by T.v.Dein <tlinden@cpan.org>. All rights reserved.

🌈 LICENSE 🌈

This program is free software; you can redistribute it and/or modify it under the same terms of the Artistic License 2.0, see: <http://www.perlfoundation.org/artistic_license_2_0>

okay that's the whole page, no cap. this was perl v5.42.0, dated 2025-07-25, and the manpage you just read is Crypt::...derField(3). mwah. go forth and slay your header fields. 💅✨🎀🦋

📦 where this page comes from