GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ANYEVENT::XMPP::EXT::VERSION (3)

.ds Aq ’

NAME

AnyEvent::XMPP::Ext::Version - Software version

CONTENTS

SYNOPSIS



   use AnyEvent::XMPP::Ext::Version;

   my $version = AnyEvent::XMPP::Ext::Version->new;
   $version->set_name    ("My client");
   $version->set_version ("0.3");
   $version->set_os      (`uname -a`);

   $disco->enable_feature ($version->disco_feature);



DESCRIPTION

This module defines an extension to provide the abilities to answer to software version requests and to request software version from other entities.

See also XEP-0092

This class is derived from AnyEvent::XMPP::Ext and can be added as extension to objects that implement the AnyEvent::XMPP::Extendable interface or derive from it.

METHODS

<B>new (%args)B> Creates a new software version handle.
<B>set_name ($name)B> This method sets the software $name string, the default is AnyEvent::XMPP.
<B>set_version ($version)B> This method sets the software $version string that is replied.

The default is $AnyEvent::XMPP::VERSION.

<B>set_os ($os)B> This method sets the operating system string $os. If you pass undef the string will be removed.

The default is no operating system string at all.

You may want to pass something like this:



   $version->set_os (`uname -s -r -m -o`);



<B>request_version ($con, B>$dest<B>, B>$cb<B>)B> This method sends a version request to $dest on the connection $con.

$cb is the callback that will be called if either an error occured or the result was received. The callback will also be called after the default IQ timeout for the connection $con. The second argument for the callback will be either undef if no error occured or a AnyEvent::XMPP::Error::IQ error. The first argument will be a hash reference with the following fields:
jid The JID of the entity this version reply belongs to.
version The software version string of the entity.
name The software name of the entity.
os The operating system of the entity, which might be undefined if none was provided.

Here an example of the structure of the hash reference:



  {
     jid     => juliet@capulet.com/balcony,
     name    => Exodus,
     version => 0.7.0.4,
     os      => Windows-XP 5.01.2600,
  }



AUTHOR

Robin Redeker, <elmex at ta-sa.org>, JID: <elmex at jabber.org>

COPYRIGHT & LICENSE

Copyright 2007, 2008 Robin Redeker, all rights reserved.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 ANYEVENT::XMPP::EXT::VERSION (3) 2012-12-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.