dbus-transport.c File Reference

Printing coordinator. More...

Functions
static void	notify_dbus_error (const char *status, const DBusError *error)
static void	notify_error (const char *status, int error_code)
static void	unregister_dbus_msg_handler (DBusConnection *connection, void *user_data)
void *	dbus_coordinator_allocate (DBusBusType dbus, void *data)
void	dbus_coordinator_loop (void *handle, volatile sig_atomic_t *quit)
void	dbus_coordinator_exit (void *handle)

Detailed Description

Copyright

GNU Lesser General Public License 2.1

Author

Jürgen Borleis

Warning

Use as experimental

DBUS specific setup for the printing coordinator.

Function Documentation

notify_dbus_error()

static void notify_dbus_error ( const char *  status, const DBusError *  error  )

static

Report status message and a DBUS error to systemd

Parameters

[in]	status	A status message to explain the error
[in]	error	DBUS generated error info

The message can be seen by running the command

$ systemctl status caps-printing-coordinator.service

notify_error()

static void notify_error ( const char *  status, int  error_code  )

static

Report status message and error code to systemd

Parameters

[in]	status	A status message to explain the error
[in]	error_code	A value from the errno variable

The message can be seen by running the command

$ systemctl status caps-printing-coordinator.service

unregister_dbus_msg_handler()

static void unregister_dbus_msg_handler ( DBusConnection *  connection, void *  user_data  )

static

It is still unclear for what it is good for

Parameters

[in]	connection	DBUS connection
[in]	user_data	TODO

dbus_coordinator_allocate()

void * dbus_coordinator_allocate	(	DBusBusType	dbus,
		void *	data
	)

Prepare the DBUS interface for a full featured communication

Parameters

[in]	dbus	Type of DBUS to connect to
[in]	data	Pointer to use in all DBUS callbacks (here: the main coordinator structure)

Return values

Pointer	A DBUS connection (transparent)
NULL	Connection impossible

dbus_coordinator_loop()

void dbus_coordinator_loop	(	void *	handle,
		volatile sig_atomic_t *	quit
	)

Todo:

If 10 seconds no printing provider is connected, terminate this loop

dbus_coordinator_exit()

void dbus_coordinator_exit

(

void *

handle

)