net::dbus::binding::server(3pm) [debian 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)

Check Out this Related Man Page

Net::DBus::Binding::Bus(3pm)				User Contributed Perl Documentation			      Net::DBus::Binding::Bus(3pm)

NAME

       Net::DBus::Binding::Bus - Handle to a well-known message bus instance

SYNOPSIS

	 use Net::DBus::Binding::Bus;

	 # Get a handle to the system bus
	 my $bus = Net::DBus::Binding::Bus->new(type => &Net::DBus::Binding::Bus::SYSTEM);

DESCRIPTION

       This is a specialization of the Net::DBus::Binding::Connection module providing convenience constructor for connecting to one of the well-
       known bus types. There is no reason to use this module directly, instead get a handle to the bus with the "session" or "system" methods in
       Net::DBus.

METHODS

       my $bus = Net::DBus::Binding::Bus->new(type => $type);
       my $bus = Net::DBus::Binding::Bus->new(address => $addr);
	   Open a connection to a message bus, either a well known bus type specified using the "type" parameter, or an arbitrary bus specified
	   using the "address" parameter. If the "private" parameter is set to a true value, then a private connection to the bus is obtained.
	   The caller must explicitly disconnect this bus instance before releasing the last instance of the object.

       $bus->request_name($service_name)
	   Send a request to the bus registering the well known name specified in the $service_name parameter. If another client already owns the
	   name, registration will be queued up, pending the exit of the other client.

       my $name = $bus->get_unique_name
	   Returns the unique name by which this processes' connection to the bus is known. Unique names are never re-used for the entire lifetime
	   of the bus daemon.

       $bus->add_match($rule)
	   Register a signal match rule with the bus controller, allowing matching broadcast signals to routed to this client.

       $bus->remove_match($rule)
	   Unregister a signal match rule with the bus controller, preventing further broadcast signals being routed to this client

AUTHOR

       Daniel P. Berrange

COPYRIGHT

       Copyright (C) 2004-2011 Daniel P. Berrange

SEE ALSO

       Net::DBus::Binding::Connection, Net::DBus

perl v5.14.2							    2011-06-30					      Net::DBus::Binding::Bus(3pm)

Linux and UNIX Man Pages

net::dbus::binding::server(3pm) [debian man page]

Check Out this Related Man Page