DC_DEVICE_SET_EVENTS(3) Library Functions Manual DC_DEVICE_SET_EVENTS(3)

dc_device_set_events
set events logged during device interaction

library “libdivecomputer”

#include <libdivecomputer/device.h>
typedef void
(*dc_event_callback_t)(dc_device_t *device, dc_event_type_t event, const void *data, void *userdata);
dc_status_t
dc_device_set_events(dc_device_t *device, unsigned int events, dc_event_callback_t callback, void *userdata);

Register a series of event callbacks on a device opened with dc_device_open(3). Event callbacks are informative messages during device processing passed to the callback function with an optional argument userdata.
The events value is a bit-field of events, one of which is passed to the callback as event. The data field will be cast to an event-specific type:
 
 
Indicate that the device is waiting for user input, such as activating the data transfer mode on the device. No data is set.
 
 
Progress metre of the parse. The data variable is set to a dc_event_progress_t, with the current and maximum progress values from which one can compute a percentage.
 
 
Sets the data value to a dc_event_devinfo_t, which can be used to acquire the model, firmware, and serial numbers of the underlying device.
 
 
Report the system (local machine) and device time in epoch seconds. Fills in data as a dc_event_clock_t, with devtime being the device and systime being the system time. See time(3).
 
 
A vendor-specific event filling data as a dc_event_vendor_t.

Returns DC_STATUS_SUCCESS on success or one of several error values on error.

dc_device_open(3)

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. These manpages were written by
Kristaps Dzonsons, kristaps@bsd.lv.
January 5, 2017 Debian