## Network interfaces discovery

Network interfaces discovery — Utility functions to discover local network interfaces

## Synopsis

    #include <gst/farsight/fs-interfaces.h>

    gchar *             fs_interfaces_get_ip_for_interface  (gchar *interface_name);
    GList *             fs_interfaces_get_local_interfaces  (void);
    GList *             fs_interfaces_get_local_ips         (gboolean include_loopback);

## Description

These utility functions allow the discovery of local network interfaces in a portable manner, they also allow finding the local ip addresses or the address allocated to a network interface.

## Details

### fs_interfaces_get_ip_for_interface ()

    gchar *             fs_interfaces_get_ip_for_interface  (gchar *interface_name);

Retreives the IPv4 address of an interface by its name

`interface_name` : | name of local interface
Returns : | a newly-allocated string with the IP address

### fs_interfaces_get_local_interfaces ()

    GList *             fs_interfaces_get_local_interfaces  (void);

Get the list of local interfaces

Returns : | a newly-allocated GList of strings. The caller must free it.

### fs_interfaces_get_local_ips ()

    GList *             fs_interfaces_get_local_ips         (gboolean include_loopback);

Get a list of local ipv4 interface addresses

`include_loopback` : | Include any loopback devices
Returns : | a newly-allocated GList of strings. The caller must free it.