Net::DN...:SMIMEA(3)

📦
version 1.570.0 · 18 versions
, in opensuse-leap 16.0

💜 NAME 💜

Net::DNS::RR::SMIMEA — the DNS SMIMEA resource record, bestie. That's it, that's the whole vibe. It lives in the Net::DNS::RR family (User Contributed Perl Documentation, iykyk) and it's here to hold your cert association data. Slay. ✨

🌸 SYNOPSIS 🌸

        use Net::DNS;
        $rr = Net::DNS::RR->new('name SMIMEA usage selector matchingtype certificate');

Literally just use Net::DNS and then spawn one of these with Net::DNS::RR->new(...), passing name SMIMEA usage selector matchingtype certificate in that order. That's the whole summoning ritual. 🎀

🦋 DESCRIPTION 🦋

Okay so the SMIMEA DNS resource record (RR) is the one that associates an end entity certificate or public key with the associated email address — and when you do that, you've formed what they call a "SMIMEA certificate association". Iconic. 👑

The semantics of how the SMIMEA RR is interpreted are described in RFC6698, so if you want the deep lore, that's where it lives.

🔥 METHODS 🔥

The available methods are those inherited from the base class, plus the type-specific methods defined in this package. Best of both worlds, fr fr.

Huge heads-up: use of undocumented package features or direct access to internal data structures is discouraged and could result in program termination or other unpredictable behaviour. Nobody wants that. Don't go poking around in the internals like a raccoon. 💀

✨ usage ✨

        $usage = $rr->usage;
        $rr->usage( $usage );

An 8-bit integer value which specifies the provided association that will be used to match the certificate. Small number, big job. 🫶

✨ selector ✨

        $selector = $rr->selector;
        $rr->selector( $selector );

An 8-bit integer value which specifies which part of the certificate presented by the server will be matched against the association data. It's giving "which piece are we comparing to." 🎯

✨ matchingtype ✨

        $matchingtype = $rr->matchingtype;
        $rr->matchingtype( $matchingtype );

An 8-bit integer value which specifies how the certificate association is presented. Short name, very specific mission. 💅

✨ certificate / cert ✨

        $cert = $rr->cert;
        $rr->cert( $cert );

Hexadecimal representation of the certificate data. Two names — certificate and cert — same energy, same method. ✨

✨ certbin ✨

        $certbin = $rr->certbin;
        $rr->certbin( $certbin );

Binary representation of the certificate data. For when hex just isn't your moment. 🍓

✨ babble ✨

        print $rr->babble;

The babble() method returns the 'BubbleBabble' representation of the digest if the Digest::BubbleBabble package is available — otherwise an empty string is returned. Noted. 🙈

BubbleBabble represents a message digest as a string of plausible words, to make the digest easier to verify. The "words" are not necessarily real words, but they look more like words than a string of hex characters. It's giving "english but make it off." 💖

The 'BubbleBabble' string is appended as a comment when the string method is called.

Copyright (c)2016 Dick Franks.

All rights reserved.

Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.

📜 LICENSE 📜

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the original copyright notices appear in all copies and that both copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific prior written permission.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

That footer paragraph is the legal version of "no refunds, no drama, use at your own risk." 💀 Keep it intact, bestie — it's load-bearing.

👑 SEE ALSO 👑

okay that's the whole page 🫶 this edition is from perl v5.42.0, dated 2026-09-02 — go forth and associate those certificates, bestie 💅✨

📦 where this page comes from