Net::DN...Private(3)

✨ NAME ✨

okay bestie, meet Net::DNS::SEC::Private(3) — the DNSSEC Private key object — from the User Contributed Perl Documentation collection. this page is literally about that class, and yes it is iconic. 💅

---

🌸 SYNOPSIS 🌸

               use Net::DNS::SEC::Private;

               $private = Net::DNS::SEC::Private->new( $keypath );

               $private = Net::DNS::SEC::Private->new(
                       'algorithm'  => '13',
                       'keytag'     => '26512',
                       'privatekey' => 'h/mc+iq9VDUbNAjQgi8S8JzlEX29IALchwJmNM3QYKk=',
                       'signame'    => 'example.com.'
                       );

---

🦋 DESCRIPTION 🦋

so this class is representing private keys as read from a keyfile generated by BIND dnssec-keygen. that's the whole assignment. ✨

and listen: the class is written to be used only in the context of the Net::DNS::RR::RRSIG create method. it is not designed to interact with any other system. so no cap, do not try to make it do side quests. it's giving very specific main character energy, and that's fine. 🎀

---

🔑 METHODS 🔑

🔐 new (from private keyfile) 🔐

               $keypath = '/home/foo/Kexample.com.+013+26512.private';
               $private = Net::DNS::SEC::Private->new( $keypath );

the argument is the full path to a private key file generated by the BIND dnssec-keygen tool. and note — the filename contains information about the algorithm and keytag. the filename is lowkey doing a little extra, and we respect it. 💖

🧚 new (from private key parameters) 🧚

               $private = Net::DNS::SEC::Private->new(
                       'algorithm'  => '13',
                       'keytag'     => '26512',
                       'privatekey' => 'h/mc+iq9VDUbNAjQgi8S8JzlEX29IALchwJmNM3QYKk=',
                       'signame'    => 'example.com.'
                       );

the arguments define the private key parameters as (name,value) pairs. the name and data representation are identical to that used in a BIND private keyfile. same vibe, same format, no weird little changes. 🫶

🎀 private_key_format 🎀

               $format = $private->private_key_format;

returns a string which identifies the format of the private key file. cute little format check, no drama. ✨

🗝️ algorithm, keytag, signame 🗝️

               $algorithm = $private->algorithm;
               $keytag    = $private->keytag;
               $signame   = $private->signame;

returns the corresponding attribute determined from the filename. the filename really said "i contain lore" and these methods are here to retrieve it. 👑

💜 Private key attributes 💜

               $attribute = $private->attribute;

returns the value as it appears in the private key file. the attribute names correspond to the tag in the key file, modified to form an acceptable Perl subroutine name. so it's the same info, just dressed appropriately for Perl. periodt. 💅

🌈 created, publish, activate 🌈

               $created  = $private->created;
               $publish  = $private->publish;
               $activate = $private->activate;

returns a string which represents a date in the form 20141212123456. returns an undefined value for key formats older than v1.3. so if you're on an older format and get nothing, that's literally the documented behavior, bestie — not a glitch. 😭

---

📝 COPYRIGHT 📝

Copyright (c)2014,2018 Dick Franks

All Rights Reserved

---

⚖️ LICENSE ⚖️

okay the legal text has entered the chat, and we are keeping it word for word because that's how licenses work. 🫡

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.

---

👀 SEE ALSO 👀

the squad:

• perl
• Net::DNS
• Net::DNS::SEC
• Net::DNS::RR::DNSKEY
• Net::DNS::RR::RRSIG

---

mwah 💋 — this page is from perl v5.44.0, dated 2026-10-17. Net::DN...Private(3) out. 🫶✨