Net::DNS::RR::CAA(3)

πŸ’… Net::DNS::RR::CAA β€” like, the DNS CAA record, bestie

okay so this is the Net::DNS::RR::CAA page from the perl manual, and honestly? it's giving "small but mighty" ✨ it's the class for Certification Authority Authorization (CAA) DNS resource records β€” yes, the ones that tell certificate authorities who's allowed to issue certs for your domain πŸ‘‘


🌸 SYNOPSIS 🌸

like, the whole vibe in two lines:

use Net::DNS;
$rr = Net::DNS::RR->new('name IN CAA flags tag value');

that's it. that's the whole entrance. slay πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

Class for Certification Authority Authorization (CAA) DNS resource records. no cap, that's the whole description β€” she's concise, she's iconic, she doesn't overexplain πŸŽ€


✨ METHODS ✨

The available methods are those inherited from the base class, plus the type-specific methods defined in this package. so you get the family inheritance AND the extra sparkle 🧚

⚠️ real talk: use of undocumented package features or direct access to internal data structures is discouraged and could result in program termination or other unpredictable behaviour. like, don't go poking around in her internals, bestie, it's not cute 😭

πŸŽ€ flags πŸŽ€

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

Unsigned 8-bit number representing Boolean flags. eight whole bits of yes/no energy 🫢

πŸ’œ critical πŸ’œ

$rr->critical(1);

if ( $rr->critical ) {
        ...
}

That's the Issuer critical flag. she's the main character of the flags byte πŸ‘‘

🌈 tag 🌈

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

Property identifier which may contain the characters a-z, A-Z, and 0-9. The tag field must not contain any other characters. Matching of tags is not case sensitive. periodt πŸ’€ like, letters and digits only, no exceptions, and don't come at her with case-sensitivity drama.

πŸ“ value πŸ“

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

A sequence of octets representing the property value. Property values are encoded as binary values and may employ sub-formats. so yeah, it's raw octets β€” she contains multitudes πŸ’–


Copyright (c)2013,2015 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, written prior 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.

🫢 yes bestie, the all-caps part is supposed to be shouty β€” that's just how licenses are. no warranty, fr fr.

πŸ”₯ SEE ALSO πŸ”₯


🌸 okay that's the whole page!! this one shipped as perl v5.42.0, dated 2026-09-02, under the Net::DNS::RR::CAA(3) name β€” go forth and authorize some certificates, icon πŸ’…βœ¨

πŸ“¦ where this page comes from