Scroll to navigation

lxi_discover(3) Library Functions Manual lxi_discover(3)

NAME

lxi_discover - search for LXI devices on network

SYNOPSIS

#include <lxi.h>

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

DESCRIPTION

The lxi_discover() function searches for LXI devices or services on the local network using VXI-11 or mDNS/DNS-SD respectively. Which discover type is used is defined as follows: 

typedef enum
{
    DISCOVER_VXI11,
    DISCOVER_MDNS
} lxi_discover_t;

During the discover operation events and results are returned by callbacks registered via the info structure, defined as follows:

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;

The broadcast callback is called whenever a new network interface is searched (DISCOVER_VXI11 only).

The device callback is called whenever a new LXI device is found (DISCOVER_VXI11 only).

The service callback is called whenever a new LXI service is found (DISCOVER_MDNS only).

The timeout is in milliseconds.

RETURN VALUE

Upon successful completion lxi_discover() returns LXI_OK , or LXI_ERROR if an error occurred.

EXAMPLE

The following example searches for LXI devices using VXI-11 and prints the ID and IP addresses of found devices: 

#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_init(3) lxi_open(3), lxi_close(3) lxi_receive(3), lxi_disconnect(3),
October 2017