DC_BLUETOOTH_OPEN(3)

💖 DC_BLUETOOTH_OPEN(3) 💖

okay so this is a page from the Library Functions Manual, bestie, and it's literally all about opening a bluetooth iostream for a dive computer. yes, that libdivecomputer. slay.

---

✨ NAME ✨

dc_bluetooth_open — opens an iostream for a bluetooth device 🦋

---

📚 LIBRARY 📚

library “libdivecomputer”

---

🎀 SYNOPSIS 🎀

#include <libdivecomputer/bluetooth.h>

dc_status_t
dc_bluetooth_open(dc_iostream_t **iostream, dc_context_t *context,
    dc_bluetooth_address_t address, unsigned int port);

---

💅 DESCRIPTION 💅

So what it does: it opens an iostream for a bluetooth device. that's the whole vibe. 👑

What it wants from you:

• a context opened with dc_context_new(3) — like, you gotta have your context first, no cap
• a 48-bit bluetooth address, which you get from dc_bluetooth_iterator_new(3) together with dc_bluetooth_device_get_address(3) or dc_bluetooth_str2addr(3)
• a bluetooth rfcomm port number — and bestie, use 0 for autodetection 🫶

🚨 okay this part matters: once it returns DC_STATUS_SUCCESS, that iostream pointer must be freed with dc_iostream_close(3). like, must must. don't leave it hanging, that's not main character energy, that's a leak 😭

---

⭐ RETURN VALUES ⭐

Returns DC_STATUS_SUCCESS on success, or one of several error values on error. and on success, the iostream pointer gets filled in with an open handle — icon status honestly ✨

---

🌈 SEE ALSO 🌈

• dc_context_new(3)
• dc_iostream_close(3)
• dc_serial_open(3)
• dc_irda_open(3)
• dc_usbhid_open(3)
• dc_bluetooth_iterator_new(3)
• dc_bluetooth_device_get_address(3)
• dc_bluetooth_str2addr(3)

---

👑 AUTHORS 👑

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

This manpage is written by Vincent Hagen, vinnie@script4web.nl. 🎀

---

and that's the whole page, bestie — Debian, June 5, 2020, that's the source and date, we're done here 💖✨🍓