NAME

Net::Whois::RIPE::Syncupdates - Perl Syncupdates client interface

SYNOPSIS

  use Net::Whois::RIPE::Syncupdates;

  Net::Whois::RIPE::Syncupdates::Message::Auth
    ->defaultPassword('myPassword');

  my $sup = Net::Whois::Syncupdates->new(
      url => 'http://backend.server.com/syncupdates',
  );

  my $message = $sup->message;

  $message->setOption(ORIGIN, 'client_ID');
  $message->setOption(NEW, 1);

  $message->setDBObject(<<END_OBJ);

  inetnum:      192.168.0.0 - 192.168.255.255
  netname:      IANA-CBLK-RESERVED1
  descr:        Class C address space for private internets
  descr:        See http://www.ripe.net/db/rfc1918.html for details
  country:      NL
  admin-c:      RFC1918-RIPE
  tech-c:       RFC1918-RIPE
  status:       ALLOCATED UNSPECIFIED
  mnt-by:       RIPE-NCC-HM-MNT
  changed:      rfc1918@ripe.net 20020129
  source:       RIPE
  END_OBJ

  $sup->execute($message);

DESCRIPTION

Net::Whois::RIPE::Syncupdates is a Perl interface to the RIPE NCC synchronous updates service.

METHODS

new ( [ url => BACKEND_URL ] )

Connects to the RIPE TEST database syncupdates server by default. DB people, please let me know if this is a bad idea.

execute ( [ MESSAGE ] )

Send update to backend. If no argument specified, sends $self->message by default. This internal Message object can be directly populated with data by using the message() accessor.

execute() returns the server's response as a Net::Whois::RIPE::Syncupdates::Response object. See the manpage of that class for details.

ping ( )

Sends a HELP query to the backend. The primary use of this is to check if the backend is alive and well. Returns the help text from the server in case of success.

message ( )

Accessor method for the internal Net::Whois::RIPE::Syncupdates::Message object. This object gets created "lazily", ie it's instantiated upon the first call to message() .

response ( )

Accessor method to a Net::Whois::RIPE::Syncupdates::Response object, which represents the result of the last execute()'d syncupdates query.

For more information on the Response class, see the Net::Whois::RIPE::Syncupdates::Response manpage.

PREREQUISITES

HTTP::Request::Common

LWP::UserAgent

AUTHOR

Peter Banik <peter@ripe.net>, Ziya Suzen <peter@ripe.net>

SEE ALSO

Net::Whois::RIPE::Syncupdates::Message

Net::Whois::RIPE::Syncupdates::Response

VERSION

$Id: Syncupdates.pm,v 1.16 2003/08/01 14:50:35 peter Exp $

BUGS

Please report bugs to <swbugs@ripe.net>.

COPYRIGHT

Copyright (c) 1993 - 2003 RIPE NCC

All Rights Reserved

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that 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 AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.