plucky (3) nlinline_iproute_del.3.gz

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