NLINLINE(3)

NAME
nlinline_if_nametoindex, nlinline_linksetupdown, nlinline_ipaddr_add, nlinline_ipaddr_del, nlinline_iproute_add, nlinline_iproute_del, nlinline_iplink_add, nlinline_iplink_del, nlinline_linksetaddr, nlinline_linkgetaddr - configure network interfaces

SYNOPSIS
#include <nlinline.h>

int nlinline_if_nametoindex(const char *ifname);

int nlinline_linksetupdown(unsigned int ifindex, int updown);

int nlinline_ipaddr_add(int family, void *addr, int prefixlen, unsigned int ifindex);

int nlinline_ipaddr_del(int family, void *addr, int prefixlen, unsigned int ifindex);

int nlinline_iproute_add(int family, void *dst_addr, int dst_prefixlen, void *gw_addr, unsigned int ifindex);

int nlinline_iproute_del(int family, void *dst_addr, int dst_prefixlen, void *gw_addr, unsigned int ifindex);

int nlinline_iplink_add(const char *ifname, unsigned int ifindex, const char *type, const char *data);

int nlinline_iplink_del(const char *ifname, unsigned int ifindex);

int nlinline_linksetaddr(unsigned int ifindex, void *macaddr);

int nlinline_linkgetaddr(unsigned int ifindex, void *macaddr);

int nlinline_linksetmtu(unsigned int ifindex, unsigned int mtu);

DESCRIPTION
NLINLINE (netlink inline) is a library of inline functions providing C programmers with very handy functions to configure network stacks. NLINLINE is entirely implemented in a header file, nlinline.h.

nlinline_if_nametoindex
    This function returns the index of the network interface whose name is ifname.

nlinline_linksetupdown
    This function turns the interface ifindex up (updown == 1) or down (updown == 0).

nlinline_ipaddr_add
    This function adds an IP address to the interface ifindex. It supports IPv4 (family == AF_INET) and IPv6 (family == AF_INET6).

nlinline_ipaddr_del
    This function removes the IP address from the interface ifindex. It supports IPv4 (family == AF_INET) and IPv6 (family == AF_INET6).

nlinline_iproute_add
    This function adds a static route to dst_addr/dst_prefixlen network through the gateway gw_addr. If dst_addr == NULL it adds a default route. ifindex must be specified when gw_addr is an IPv6 link local address.

nlinline_iproute_del
    This function removes the static route to dst_addr/dst_prefixlen network through the gateway gw_addr.

nlinline_iplink_add
    This function adds a new link of type type, named ifname. The value of data depends on the type of link and can be NULL. A default interface name is assigned if name == NULL. The link is created with a given index when ifindex is positive.

nlinline_iplink_del
    This function removes a link. The link to be deleted can be identified by its name (ifname) or by its index (ifindex). Either ifindex can be zero or ifname can be NULL. It is possible to use both ifindex and ifname to identify the link. An error may occur if the parameters are inconsistent.

nlinline_linksetaddr
    This functions sets the mac address of the interface ifindex.

nlinline_linkgetaddr
    This functions gets the mac address of the interface ifindex.

nlinline_linksetmtu
    This functions sets the MTU (Maximum Transfer Unit) of the interface ifindex.

IP addresses are void * arguments, any sequence of 4 or 16 bytes (in network byte order) is a legal IPv4 or IPv6 address respectively.

nlinline functions do not add dependencies at run-time. This is useful for security critical applications (like PAM modules) These inline functions use netlink only, they do not depend on the obsolete netdevice (ioctl) API. Only the code of referenced inline functions enters in the object and executable code.

RETURN VALUE
nlinline_if_nametoindex returns the interface index or -1 if an error occurred (in which case, errno is set appropriately)

All the other functions return zero in case of success. On error, -1 is returned, and errno is set appropriately.

(nlinline_iplink_add can return the (positive) ifindex of the newly created link when the argument ifindex is -1 and the stack supports this feature.)

EXAMPLE
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <nlinline.h>
int main(int argc, char *argv[]) {
  uint8_t ipv4addr[] = {192,168,2,2};
  uint8_t ipv4gw[] = {192,168,2,1};
  uint8_t ipv6addr[16] = {0x20, 0x01, 0x07, 0x60, [15] = 0x02};
  uint8_t ipv6gw[16] = {0x20, 0x01, 0x07, 0x60, [15] = 0x01};
  int ifindex = nlinline_if_nametoindex(argv[1]);
  if (ifindex > 0)
    printf("%d\n", ifindex);
  else {
    perror("nametoindex");
    return 1;
  }
  if (nlinline_linksetupdown(ifindex, 1) < 0)
    perror("link up");
  if (nlinline_ipaddr_add(AF_INET, ipv4addr, 24, ifindex) < 0)
    perror("addr ipv4");
  if (nlinline_iproute_add(AF_INET, NULL, 0, ipv4gw, 0) < 0)
    perror("addr ipv6");
  if (nlinline_ipaddr_add(AF_INET6, ipv6addr, 64, ifindex) < 0)
    perror("route ipv4");
  if (nlinline_iproute_add(AF_INET6, NULL, 0, ipv6gw, 0) < 0)
    perror("route ipv6");
  return 0;
}

This program takes the name of an interface from the command line. It turns that interface up and sets the interface IPv4 and IPv6 addresses and default routes.

AUTHOR
VirtualSquare. Project leader: Renzo Davoli