DC_DEVICE_SET_EVENTS(3)

💖 DC_DEVICE_SET_EVENTS(3) 💖

✨ NAME ✨

okay so dc_device_set_events — from the Library Functions Manual — is literally the function for setting events logged during device interaction. that's the whole assignment. 💅

🫶 LIBRARY 🫶

It comes from the library “libdivecomputer”. yup, that's the one. 🌸

🌸 SYNOPSIS 🌸

#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);

🦋 DESCRIPTION 🦋

So basically, you're registering a series of event callbacks on a device that was opened with dc_device_open(3). These event callbacks are informative messages during device processing, and they get passed to the callback function with an optional argument called userdata. cute, right? 😌

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, so here's the lineup:

• DC_EVENT_WAITING — Indicates that the device is waiting for user input, like activating the data transfer mode on the device. No data is set. just vibes and waiting. ⏳
• DC_EVENT_PROGRESS — 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. slay, math. 📊
• DC_EVENT_DEVINFO — 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. device lore unlocked. 🔍
• DC_EVENT_CLOCK — 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). clock check, bestie. ⏰
• DC_EVENT_VENDOR — A vendor-specific event filling data as a dc_event_vendor_t. vendor chaos, but make it official. 🏷️

💅 RETURN VALUES 💅

Returns DC_STATUS_SUCCESS on success or one of several error values on error. success is the main character; errors are the plot twists. periodt. ✨

🎀 SEE ALSO 🎀

• dc_device_open(3)

👑 AUTHORS 👑

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. These manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. iconic behavior, honestly. 🫶

This page is from Debian, dated January 5, 2017, and it's the DC_DEVICE_SET_EVENTS(3) manual page. byeee, bestie 💋🎀