net::dbus::binding::message::methodcall(3pm) [debian man page]
Net::DBus::Binding::Message::MethodCall(3pm) User Contributed Perl Documentation Net::DBus::Binding::Message::MethodCall(3pm)NAME
Net::DBus::Binding::Message::MethodCall - a message encoding a method call
DESCRIPTION
This module is part of the low-level DBus binding APIs, and should not be used by application code. No guarentees are made about APIs under
the "Net::DBus::Binding::" namespace being stable across releases.
This module provides a convenience constructor for creating a message representing a method call.
METHODS
my $call = Net::DBus::Binding::Message::MethodCall->new( service_name => $service, object_path => $object, interface => $interface,
method_name => $name);
Create a message representing a call on the object located at the path "object_path" within the client owning the well-known name given
by "service_name". The method to be invoked has the name "method_name" within the interface specified by the "interface" parameter.
AUTHOR
Daniel P. Berrange.
COPYRIGHT
Copyright (C) 2004-2009 Daniel P. Berrange
SEE ALSO
Net::DBus::Binding::Message
perl v5.14.2 2011-06-30 Net::DBus::Binding::Message::MethodCall(3pm)
Check Out this Related Man Page
Net::DBus::Binding::Server(3pm) User Contributed Perl Documentation Net::DBus::Binding::Server(3pm)NAME
Net::DBus::Binding::Server - A server to accept incoming connections
SYNOPSIS
Creating a new server and accepting client connections
use Net::DBus::Binding::Server;
my $server = Net::DBus::Binding::Server->new(address => "unix:path=/path/to/socket");
$server->connection_callback(&new_connection);
sub new_connection {
my $connection = shift;
.. work with new connection...
}
Managing the server and new connections in an event loop
my $reactor = Net::DBus::Binding::Reactor->new();
$reactor->manage($server);
$reactor->run();
sub new_connection {
my $connection = shift;
$reactor->manage($connection);
}
DESCRIPTION
A server for receiving connection from client programs. The methods defined on this module have a close correspondance to the
dbus_server_XXX methods in the C API, so for further details on their behaviour, the C API documentation may be of use.
METHODS
my $server = Net::DBus::Binding::Server->new(address => "unix:path=/path/to/socket");
Creates a new server binding it to the socket specified by the "address" parameter.
$status = $server->is_connected();
Returns zero if the server has been disconnected, otherwise a positive value is returned.
$server->disconnect()
Closes this server to the remote host. This method is called automatically during garbage collection (ie in the DESTROY method) if the
programmer forgets to explicitly disconnect.
$server->set_watch_callbacks(&add_watch, &remove_watch, &toggle_watch);
Register a set of callbacks for adding, removing & updating watches in the application's event loop. Each parameter should be a code
reference, which on each invocation, will be supplied with two parameters, the server object and the watch object. If you are using a
"Net::DBus::Binding::Reactor" object as the application event loop, then the 'manage' method on that object will call this on your
behalf.
$server->set_timeout_callbacks(&add_timeout, &remove_timeout, &toggle_timeout);
Register a set of callbacks for adding, removing & updating timeouts in the application's event loop. Each parameter should be a code
reference, which on each invocation, will be supplied with two parameters, the server object and the timeout object. If you are using a
"Net::DBus::Binding::Reactor" object as the application event loop, then the 'manage' method on that object will call this on your
behalf.
$server->set_connection_callback(&handler)
Registers the handler to use for dealing with new incoming connections from clients. The code reference will be invoked each time a new
client connects and supplied with a single parameter which is the "Net::DBus::Binding::Connection" object representing the client.
AUTHOR
Daniel P. Berrange
COPYRIGHT
Copyright (C) 2004-2011 Daniel P. Berrange
SEE ALSO
Net::DBus::Binding::Connection, Net::DBus::Binding::Bus, Net::DBus::Binding::Message::Signal, Net::DBus::Binding::Message::MethodCall,
Net::DBus::Binding::Message::MethodReturn, Net::DBus::Binding::Message::Error
perl v5.14.2 2011-06-30 Net::DBus::Binding::Server(3pm)