| Linux sh00002.bigrock.com 5.14.0-687.29.1.el9_8.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jul 23 16:18:48 EDT 2026 x86_64 Path : /scripts/ |
| Current File : //scripts/cpdig |
#!/usr/local/cpanel/3rdparty/bin/perl
# cpanel - scripts/cpdig Copyright 2022 cPanel, L.L.C.
# All rights reserved.
# copyright@cpanel.net http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited
package scripts::cpdig;
use cPstrict;
=encoding utf-8
=head1 NAME
cpdig
=head1 USAGE
cpdig <name> <type> [--verbose]
=head1 DESCRIPTION
This script performs a DNS query using cPanel’s DNS resolver.
Its output should yield the same end results as C<dig +trace $name $type>.
cPanel provides this script solely for diagnostic purposes; no cPanel
& WHM feature requires its use.
=cut
use parent qw( Cpanel::HelpfulScript );
use Cpanel::DNS::Unbound ();
use Cpanel::NameServers ();
use constant _OPTIONS => ('verbose');
use constant _ACCEPT_UNNAMED => 1;
exit( __PACKAGE__->new(@ARGV)->run() // 0 ) unless caller;
sub run {
my ($self) = @_;
my ( $name, $type ) = $self->getopt_unnamed();
die $self->help() if grep { !$_ } $name, $type;
$type = uc($type);
if ( $type eq 'NS' ) {
# requesting DNS::Unbound is not complete when the NS are not setup correctly
my $list = Cpanel::NameServers::get_nameservers_for_domain($name) // [];
say $_ for @$list;
return;
}
my $dns = Cpanel::DNS::Unbound->new();
my $ret = $dns->recursive_queries( [ [ $name, $type ] ] )->[0];
if ( $self->getopt('verbose') ) {
print STDERR $ret->{debug};
}
my $data_ar = $ret->{'decoded_data'} || $ret->{result}{data};
my %FORMATTERS = (
'ARRAY' => sub { "@{$_[0]}" },
'HASH' => sub {
join ' ', map { "$_=$_[0]->{$_}" } sort keys %{ $_[0] };
}
);
foreach my $item ( @{$data_ar} ) {
my $type = ref $item;
if ( $type ne '' && defined $FORMATTERS{$type} ) {
$self->_print( $FORMATTERS{$type}->($item) . "\n" );
}
else {
$self->_print("$item\n");
}
}
return;
}
1;