NAME
Net::WDNS::Msg - Perl interface for WDNS messages
SYNOPSIS
use Net::WDNS qw(:func);
... # get raw DNS packet
my $msg = parse_message($pkt); print $msg->as_str, "\n";
DESCRIPTION
Net::WDNS::Msg is an object interface to libwdns messages that allows introspection and rendering as human-readable strings.
CONSTRUCTOR
- new($pkt)
-
Creates a new Net::WDNS::Msg object from a raw (wire-format) DNS packet. A slightly faster way to get message objects is to use the
parse_message()function provided by Net::WDNS.
METHODS
- id()
-
Return the numeric id of this message.
- flags()
-
Return a hash of flags and their statuses (0 or 1) for this message. Flags include qr, aa, tc, rd, ra, ad, and cd.
- flags_raw()
-
Return the raw bit-encoded integer reprenting the flags.
- rcode()
-
Return the string version of the rcode.
- rcode_num()
-
Return the numeric rcode.
- opcode()
-
Return the string version of the rcode.
- opcode_num()
-
Return the numeric opcode.
- question()
-
Return the QUESTION section of this message as an array (array ref in scalar context) containing Net::WDNS::Question objects.
- answer()
-
Return the ANSWER section of this message as an array (array ref in scalar context) containing Net::WDNS::RR objects.
-
Return the AUTHORITY section of this message as an array (array ref in scalar context) containing Net::WDNS::RR objects.
- additional()
-
Return the ADDITIONAL section of this message as an array (array ref in scalar context) containing Net::WDNS::RR objects.
- as_str()
-
Return a human-readable string representing this message. Message objects are also overloaded to render as strings when double-quoted.
- msg()
-
Return the underlying raw message structure, suitable for passing to some utility functions provided by Net::WDNS.
SEE ALSO
Net::WDNS, Net::WDNS::Question, Net::WDNS::RR, Net::Nmsg
The wdns library can be downloaded from: https://github.com/farsightsec/wdns
AUTHOR
Matthew Sisk, <sisk@cert.org>
COPYRIGHT AND LICENSE
Copyright (C) 2014 by Carnegie Mellon University
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, as published by the Free Software Foundation, under the terms pursuant to Version 2, June 1991.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.