Net::DN...C3PARAM(3)

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

💖 Net::DNS::RR::NSEC3PARAM(3) 💖

okay so bestie, this is the manual page for Net::DNS::RR::NSEC3PARAM — yes that's a mouthful, the header up top literally truncates it to Net::DN...C3PARAM(3) 💀 — from the User Contributed Perl Documentation. Sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

Net::DNS::RR::NSEC3PARAM — the DNS NSEC3PARAM resource record. that's it, that's the name 🎀

🦋 SYNOPSIS 🦋

use Net::DNS;
$rr = Net::DNS::RR->new('name NSEC3PARAM algorithm flags iterations salt');

literally two lines and you're in. iconic.

🌸 DESCRIPTION 🌸

so this is the class for DNSSEC NSEC3PARAM resource records. DNSSEC, yeah, the whole signing-your-zone thing. slay.

The NSEC3PARAM RR holds the NSEC3 parameters — that's the hash algorithm, the flags, the iterations, and the salt — the exact set of things you need to calculate hashed ownernames. it's giving recipe card for hashing 🔥

The way that an NSEC3PARAM RR sitting at a zone apex works: its presence means hey, these parameters may be used by authoritative servers to pick an appropriate set of NSEC3 records for negative responses. so it's like a little signpost at the top of the zone. lowkey important. 👑

ngl bestie, hear me on this one: the NSEC3PARAM RR is not used by validators or resolvers. like, at all. it's an authoritative-server thing. don't @ me, that's just what the page says 💅

💅 METHODS 💅

The available methods are the ones inherited from the base class, plus the type-specific ones defined right here in this package. best of both worlds fr fr 🫶

⚠️ warning bestie: using undocumented package features or reaching directly into internal data structures is discouraged — and could legitimately result in program termination or other unpredictable behaviour. so like... don't. 🙈

🧚 algorithm

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

the 8-bit algorithm field, represented as an unsigned decimal integer. cute, simple, decimal. ✨

🎀 flags

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

the Flags field is an unsigned decimal integer that's interpreted as eight concatenated Boolean values. so it looks like a number but it's secretly eight lil yes/nos wearing a trench coat. iykyk 😭

⭐ iterations

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

the Iterations field, represented as an unsigned decimal integer. the value is between 0 and 65535, inclusive. so like, 0 through 65535, no in-betweens beyond that, periodt. 🔥

🌈 salt

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

the Salt field, represented as a contiguous sequence of hexadecimal digits. and here's the vibe check: in string format, a "-" (unquoted) is used to signal that the salt field is absent. so dash means "no salt, we're going in dry" 💀

🦋 saltbin

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

the Salt field, but as a sequence of octets. same salt, raw-bytes era. main character formatting energy. 💜

Copyright (c)2007,2008 NLnet Labs. Author Olaf M. Kolkman.

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.

so yeah bestie, free to use, just keep the copyright notices and don't pretend you wrote it. and it comes with absolutely no warranty — if it breaks, it breaks 😭

🔗 SEE ALSO 🔗

okay that's the whole page! 🎀 this was perl v5.42.0, dated 2026-09-02 — so like, mark your calendar bestie, and go forth and hash responsibly. mwah 💖✨🦋

📦 where this page comes from