Current File : //usr/lib64/perl5/vendor_perl/Net/DNS/RR/SRV.pm

package Net::DNS::RR::SRV;

#
# $Id: SRV.pm 1096 2012-12-28 13:35:15Z willem $
#
use vars qw($VERSION);
$VERSION = (qw$LastChangedRevision: 1096 $)[1]; # Unchanged since 1037

use base Net::DNS::RR;

=head1 NAME

Net::DNS::RR::SRV - DNS SRV resource record

=cut


use strict;
use integer;

use Net::DNS::DomainName;


sub decode_rdata {			## decode rdata from wire-format octet string
	my $self = shift;
	my ( $data, $offset, @opaque ) = @_;

	@{$self}{qw(priority weight port)} = unpack( "\@$offset n3", $$data );

	$self->{target} = decode Net::DNS::DomainName2535($data,$offset+6,@opaque);
}


sub encode_rdata {			## encode rdata as wire-format octet string
	my $self = shift;
	my ( $offset, @opaque ) = @_;

	return '' unless $self->{target};
	my $rdata = pack 'n3', map $self->$_, qw(priority weight port target);
	$rdata .= $self->{target}->encode( $offset + length($rdata), @opaque );
}


sub format_rdata {			## format rdata portion of RR string.
	my $self = shift;

	return '' unless $self->{target};
	join ' ', map( $self->$_, qw(priority weight port) ), $self->{target}->string;
}


sub parse_rdata {			## populate RR from rdata in argument list
	my $self = shift;

	$self->$_(shift) for qw(priority weight port target);
}


sub priority {
	my $self = shift;

	$self->{priority} = shift if @_;
	return 0 + ( $self->{priority} || 0 );
}

sub weight {
	my $self = shift;

	$self->{weight} = shift if @_;
	return 0 + ( $self->{weight} || 0 );
}

sub port {
	my $self = shift;

	$self->{port} = shift if @_;
	return 0 + ( $self->{port} || 0 );
}

sub target {
	my $self = shift;

	$self->{target} = new Net::DNS::DomainName2535(shift) if @_;
	$self->{target}->name if defined wantarray;
}


__PACKAGE__->set_rrsort_func(
	'priority',
	sub {
		my ( $a, $b ) = ( $Net::DNS::a, $Net::DNS::b );
		$a->{priority} <=> $b->{priority}
				|| $b->{weight} <=> $a->{weight};
	} );


__PACKAGE__->set_rrsort_func(
	'weight',
	sub {
		my ( $a, $b ) = ( $Net::DNS::a, $Net::DNS::b );
		$b->{weight} <=> $a->{weight}
				|| $a->{priority} <=> $b->{priority};
	} );


__PACKAGE__->set_rrsort_func(
	'default_sort',
	__PACKAGE__->get_rrsort_func('priority')

	);

1;
__END__


=head1 SYNOPSIS

    use Net::DNS;
    $rr = new Net::DNS::RR('name SRV priority weight port target');

=head1 DESCRIPTION

Class for DNS Service (SRV) resource records.

=head1 METHODS

The available methods are those inherited from the base class augmented
by the type-specific methods defined in this package.

Use of undocumented package features or direct access to internal data
structures is discouraged and could result in program termination or
other unpredictable behaviour.


=head2 priority

    $priority = $rr->priority;

Returns the priority for this target host.

=head2 weight

    $weight = $rr->weight;

Returns the weight for this target host.

=head2 port

    $port = $rr->port;

Returns the port number for the service on this target host.

=head2 target

    $target = $rr->target;

Returns the domain name of the target host.


=head1 COPYRIGHT

Copyright (c)1997-2002 Michael Fuhr.

Portions Copyright (c)2005 Olaf Kolkman, NLnet Labs.

Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.

All rights reserved.

This program is free software; you may redistribute it and/or
modify it under the same terms as Perl itself.


=head1 SEE ALSO

L<perl>, L<Net::DNS>, L<Net::DNS::RR>, RFC2782

=cut