DC_DEVICE_OPEN(3)

💙 DC_DEVICE_OPEN(3) 💙

okay so bestie, welcome to a page from the Library Functions Manual — yes we're in libdivecomputer territory and it's giving very much "my dive watch has lore" energy 🫶

---

✨ NAME ✨

dc_device_open — open a dive computer device 🐠

like, actually open it. connect. say hi to the fish computer. you know the vibe.

---

📚 LIBRARY 📚

library “libdivecomputer” — that's the one, that's the icon 👑

---

🎀 SYNOPSIS 🎀

#include <libdivecomputer/device.h>

dc_status_t
dc_device_open(dc_device_t **device, dc_context_t *context,
    dc_descriptor_t *descriptor, dc_iostream_t *iostream);

no cap, that's the whole call. four arguments. you got this 💅

---

🌸 DESCRIPTION 🌸

So. You wanna open a dive computer device for processing? Say less. dc_device_open takes:

• a context — one you already opened with dc_context_new(3) 🌈
• a dive computer descriptor — usually found by searching through dc_descriptor_iterator_new(3) 🦋
• an iostream — opened with a transport-specific open function, like dc_usbhid_open(3), dc_irda_open(3), dc_serial_open(3), or dc_bluetooth_open(3) 🔥

basically: context + descriptor + iostream walk into a bar and this function introduces them. main character energy fr fr.

⚠️ okay this part is important, don't skip it: upon returning DC_STATUS_SUCCESS, the device pointer must be freed with dc_device_close(3). must. no "I'll do it later" bestie, we do not leak handles in this house 😭

---

⭐ RETURN VALUES ⭐

It returns DC_STATUS_SUCCESS on success 💖 or one of several error values on error 💀.

And on success, the device pointer gets filled in with an open handle — like, an actual usable thing. slay.

---

🧚 SEE ALSO 🧚

• dc_context_new(3)
• dc_descriptor_iterator_new(3)
• dc_device_close(3)

iykyk, read those next 🎀

---

👑 AUTHORS 👑

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org 🫶

The manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. and Vincent Hagen, vinnie@script4web.nl ✨

---

okay that's the page!! it's from Debian, dated June 5, 2020, and it lives at DC_DEVICE_OPEN(3) — go forth and open some dive computers, bestie, you're literally gonna ate 💅💖🌟