lxi_discover(3)

💖 lxi_discover(3) — C Library Functions 💖

okay bestie, so you wanna know about lxi_discover? it's the "search for LXI devices on network" one, and honestly it's giving main character energy. it lives in the C Library Functions section, so pull up a chair and let's get into it ✨

---

✨ SYNOPSIS ✨

#include <lxi.h>

int lxi_discover(lxi_info_t *info, int timeout, lxi_discover_t type);

---

🦋 DESCRIPTION 🦋

so what does lxi_discover() actually do? it searches for LXI devices or services on the local network — using VXI-11 or mDNS/DNS-SD respectively. which discover type you get is decided like this, no cap:

typedef enum
{
    DISCOVER_VXI11,
    DISCOVER_MDNS
} lxi_discover_t;

during the discover operation, events and results get returned by callbacks that you register through the info structure. and that struct is literally:

typedef struct
{
    void (*broadcast)(char *address, char *interface);
    void (*device)(char *address, char *id);
    void (*service)(char *address, char *id, char *service, int port);
} lxi_info_t;

okay so the callbacks, one by one:

• the broadcast callback fires whenever a new network interface is searched (DISCOVER_VXI11 only).
• the device callback fires whenever a new LXI device is found (DISCOVER_VXI11 only).
• the service callback fires whenever a new LXI service is found (DISCOVER_MDNS only).

and the timeout? it's in milliseconds, bestie. so plan accordingly 🫶

---

🌈 RETURN VALUE 🌈

when everything goes slay, lxi_discover() returns LXI_OK. if an error happened, it returns LXI_ERROR. that's it, that's the whole vibe check 💅

---

🎀 EXAMPLE 🎀

this example searches for LXI devices using VXI-11 and prints the ID and IP addresses of found devices. iconic behaviour, truly:

#include <stdio.h>
#include <lxi.h>

void broadcast(char *address, char *interface)
{
    printf("Broadcasting on interface %s\n", interface);
}

void device(char *address, char *id)
{
    printf(" Found %s on address %s\n", id, address);
}

int main()
{
    lxi_info_t info;

    // Initialize LXI library
    lxi_init();

    // Set up search information callbacks
    info.broadcast = &broadcast;
    info.device = &device;

    printf("Searching for LXI devices - please wait...\n");

    // Search for LXI devices, 1 second timeout
    lxi_discover(&info, 1000, DISCOVER_VXI11);

    return 0;
}

---

👑 SEE ALSO 👑

• lxi_discover_if(3)
• lxi_init(3)
• lxi_open(3)
• lxi_close(3)
• lxi_receive(3)
• lxi_disconnect(3)

---

and that's the whole page, bestie!! 🧚‍♀️✨

this lil masterpiece is from liblxi 1.22, dated 2024-11-08 — go forth and discover some devices, you've got this 💜🌸