Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

anyevent::xmpp::ext::version(3pm) [debian man page]

AnyEvent::XMPP::Ext::Version(3pm)			User Contributed Perl Documentation			 AnyEvent::XMPP::Ext::Version(3pm)

NAME

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

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

       new (%args)
	   Creates a new software version handle.

       set_name ($name)
	   This method sets the software $name string, the default is "AnyEvent::XMPP".

       set_version ($version)
	   This method sets the software $version string that is replied.

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

       set_os ($os)
	   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`);

       request_version ($con, $dest, $cb)
	   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.

perl v5.14.2							    2012-01-23					 AnyEvent::XMPP::Ext::Version(3pm)

Check Out this Related Man Page

AnyEvent::XMPP::Parser(3pm)				User Contributed Perl Documentation			       AnyEvent::XMPP::Parser(3pm)

NAME

       AnyEvent::XMPP::Parser - Parser for XML streams (helper for AnyEvent::XMPP)

SYNOPSIS

	  use AnyEvent::XMPP::Parser;
	  ...

DESCRIPTION

       This is a XMPP XML parser helper class, which helps me to cope with the XMPP XML.

       See also AnyEvent::XMPP::Writer for a discussion of the issues with XML in XMPP.

METHODS

       new This creates a new AnyEvent::XMPP::Parser and calls "init".

       set_stanza_cb ($cb)
	   Sets the 'XML stanza' callback.

	   $cb must be a code reference. The first argument to the callback will be this AnyEvent::XMPP::Parser instance and the second will be
	   the stanzas root AnyEvent::XMPP::Node as first argument.

	   If the second argument is undefined the end of the stream has been found.

       set_error_cb ($cb)
	   This sets the error callback that will be called when the parser encounters an syntax error. The first argument is the exception and
	   the second is the data which caused the error.

       set_stream_cb ($cb)
	   This method sets the stream tag callback. It is called when the <stream> tag from the server has been encountered.  The first argument
	   to the callback is the AnyEvent::XMPP::Node of the opening stream tag.

       init
	   This methods (re)initializes the parser.

       cleanup
	   This methods removes all handlers. Use it to avoid circular references.

       nseq ($namespace, $tagname, $cmptag)
	   This method checks whether the $cmptag matches the $tagname in the $namespace.

	   $cmptag needs to come from the XML::Parser::Expat as it has some magic attached that stores the namespace.

       feed ($data)
	   This method feeds a chunk of unparsed data to the parser.

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.

perl v5.14.2							    2012-03-19					       AnyEvent::XMPP::Parser(3pm)
Man Page